assist

type Decision struct {
	Route   Route
	Intent  shortcuts.Intent
	Utility UtilityDefinition
	Payload string
	Locale  string
}

type InMemorySkillContextStore struct {
	// contains filtered or unexported fields
}

type Pipeline struct {
	// contains filtered or unexported fields
}

type PipelineOption func(*Pipeline)

type ProcessOpts struct {
	Locale    string // "de", "en", etc.
	Selection string // Currently selected text
	Context   string // Additional context
	Target    any    // Host-specific target for insertion/execution

	// SessionKey identifies the user conversation for v0.38.0 multi-
	// turn follow-ups. Hosts derive this from the authenticated user
	// (e.g. Identity.UserID) or a per-wake-word session id. Empty
	// disables follow-ups for this call.
	SessionKey string
}

type Result struct {
	Text      string // Full response text (always present)
	SpeakText string // TTS-optimized text
	Audio     []byte // TTS audio bytes (present when TTS enabled)
	Format    string // Audio format ("mp3", "wav", etc.)
	Action    string // "respond", "execute", "silent", "shortcut"
	Locale    string // Response language
	Shortcut  string // Matched shortcut intent, if any
	Surface   ResultSurface
	Kind      ResultKind
}

type ResultKind string

type ResultSurface string

type Route string

type Router struct {
	// contains filtered or unexported fields
}

type RouterOption func(*Router)

type SkillContext struct {
	Intent    shortcuts.Intent
	State     map[string]string
	ExpiresAt time.Time
}

type SkillContextStore interface {
	// Get returns the active context for a key. The ok return is
	// false when no context exists or it has expired.
	Get(key string) (SkillContext, bool)

	// Set stores or replaces the context. ExpiresAt is set by the
	// store using its configured TTL — callers do not set it.
	Set(key string, intent shortcuts.Intent, state map[string]string)

	// Clear removes any active context for the key. Idempotent.
	Clear(key string)
}

type ToolCall struct {
	Intent     shortcuts.Intent
	Payload    string
	Transcript string
	Locale     string
	Selection  string
	Context    string
	Target     any
}

type ToolExecutor interface {
	Execute(context.Context, ToolCall) (ToolResult, error)
}

type ToolResult struct {
	Text      string
	SpeakText string
	Action    string
	Locale    string
	Surface   ResultSurface
	Kind      ResultKind

	// FollowupNeeded signals a multi-turn skill: the pipeline stores
	// the current Intent + FollowupState under the caller's session
	// key (see ProcessOpts.SessionKey) and the next transcript will
	// re-route to the same skill. When false, any prior follow-up
	// state for the same session is cleared. v0.38.0 (Phase 2).
	FollowupNeeded bool

	// FollowupState carries skill-private data across turns. The
	// pipeline echoes it back via ToolCall.Context on the next
	// invocation. Keep entries small — this is in-memory state, not
	// long-term persistence.
	FollowupState map[string]string
}

type UtilityDefinition struct {
	ID             UtilityID
	Intent         shortcuts.Intent
	Label          string
	Input          UtilityInputRequirement
	DefaultSurface ResultSurface
	DefaultKind    ResultKind
	RequiresModel  bool
	Enabled        bool
}

type UtilityID string

type UtilityInputRequirement string

type UtilityRegistry struct {
	// contains filtered or unexported fields
}