chatagent

type APIRunOptions struct {
	Publisher EventPublisher
	Confirm   *ConfirmGate
}

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

type AbilityInvoker func(ctx context.Context, capability hub.CapabilityType, operation string, params map[string]any) (*ability.InvokeResult, error)

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

type AgentInfo struct {
	Version       string         `json:"version"`
	ChatModel     string         `json:"chat_model"`
	ToolModel     string         `json:"tool_model"`
	Provider      string         `json:"provider"`
	Workspace     string         `json:"workspace"`
	Tools         []ToolInfo     `json:"tools"`
	Skills        []SkillInfo    `json:"skills"`
	Subagents     []SubagentInfo `json:"subagents"`
	ToolCount     int            `json:"tool_count"`
	SkillCount    int            `json:"skill_count"`
	SubagentCount int            `json:"subagent_count"`
}

type BufioSSEWriter struct {
	W *bufio.Writer
}

type BuildSystemPromptOptions struct {
	// CustomPrompt replaces the default prompt body when non-empty.
	CustomPrompt string
	// SelectedTools limits which tools appear in the Available tools section.
	SelectedTools []string
	// ToolSnippets provides one-line descriptions keyed by tool name.
	ToolSnippets map[string]string
	// PromptGuidelines adds extra guideline bullets after tool-specific defaults.
	PromptGuidelines []string
	// AppendSystemPrompt is appended after the main body and before project context.
	AppendSystemPrompt string
	// CWD is the sandbox workspace root shown to the model.
	CWD string
	// ContextFiles are pre-loaded project instruction files.
	ContextFiles []ContextFile
	// Skills are agent skills injected into the prompt; nil loads from the database.
	Skills []Skill
	// Subagents are delegation targets injected into the prompt for the task tool.
	Subagents []Subagent
	// Mode selects plan vs normal prompt behavior; empty means normal.
	Mode string
}

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

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

type ChatHookDeps struct {
	SessionID   string
	UID         types.Uid
	SessionMode string
	Kind        RunKind
}

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

type ConfirmMode string

type ConfirmReason string

type ConfirmResponse struct {
	Approved bool
	Reason   ConfirmReason
	Mode     ConfirmMode
	Pattern  string
}

type ContextCategoryInfo struct {
	ID      string  `json:"id"`
	Label   string  `json:"label"`
	Tokens  int     `json:"tokens"`
	Percent float64 `json:"percent"`
}

type ContextFile struct {
	Path    string
	Content string
}

type ContextSkillTokenInfo struct {
	Name   string `json:"name"`
	Tokens int    `json:"tokens"`
}

type ContextUsageReport struct {
	Model             string                  `json:"model"`
	ToolModel         string                  `json:"tool_model,omitempty"`
	ContextWindow     int                     `json:"context_window"`
	TotalTokens       int                     `json:"total_tokens"`
	TotalPercent      float64                 `json:"total_percent"`
	CompactionEnabled bool                    `json:"compaction_enabled"`
	Categories        []ContextCategoryInfo   `json:"categories"`
	Skills            []ContextSkillTokenInfo `json:"skills"`
}

type CreateScheduledTaskRequest struct {
	Name   string `json:"name"`
	Prompt string `json:"prompt"`
	Cron   string `json:"cron,omitempty"`
	RunAt  string `json:"run_at,omitempty"`
}

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

type EphemeralRunParams struct {
	UID         types.Uid
	Prompt      string
	Kind        RunKind
	Tools       []string
	Skills      []string
	MemoryScope string
}

type EphemeralRunResult struct {
	SessionID string
	Reply     string
}

type EventPublisher interface {
	Publish(event StreamEvent) error
}

type HistoryMessage struct {
	Role               string    `json:"role"`
	Kind               string    `json:"kind"`
	Text               string    `json:"text"`
	CreatedAt          time.Time `json:"created_at"`
	ToolName           string    `json:"tool_name,omitempty"`
	ToolStatus         string    `json:"tool_status,omitempty"`
	DurationMs         int64     `json:"duration_ms,omitempty"`
	TurnDurationMs     int64     `json:"turn_duration_ms,omitempty"`
	ThinkingDurationMs int64     `json:"thinking_duration_ms,omitempty"`
	RunDurationMs      int64     `json:"run_duration_ms,omitempty"`
	ThinkingText       string    `json:"thinking_text,omitempty"`
}

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

type ManualCompactionResult struct {
	Compacted    bool
	TokensBefore int
	TokensAfter  int
}

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

type PermissionsView struct {
	Defaults      permission.Config   `json:"defaults"`
	User          permission.Config   `json:"user"`
	Effective     permission.Config   `json:"effective"`
	SessionGrants map[string][]string `json:"session_grants,omitempty"`
}

type PipelineAgentRunner struct{}

type PlanSummary struct {
	PlanID    string    `json:"plan_id"`
	URI       string    `json:"uri"`
	Title     string    `json:"title"`
	CreatedAt time.Time `json:"created_at"`
}

type ProgressArtifact struct {
	// Goal is the primary user objective.
	Goal string
	// Done lists completed steps.
	Done []string
	// Next lists remaining steps.
	Next []string
}

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

type ResourceContent struct {
	URI         string
	Kind        string
	Title       string
	Content     string
	ContentType string
	Truncated   bool
}

type ResourceRef struct {
	URI   string `json:"uri"`
	Kind  string `json:"kind"`
	Title string `json:"title"`
}

type RunKind string

type RunRequest struct {
	SessionID    string
	Text         string
	API          *APIRunOptions
	Kind         RunKind
	RunStartedAt time.Time
	Tools        []string
	Skills       []string
	MemoryScope  string
}

type SSEWriter interface {
	WriteEvent(event StreamEvent) (terminal bool)
}

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

type ScheduleToolDeps struct {
	UID       types.Uid
	SessionID string
}

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

type ScheduledDelivery struct {
	Platform   string `json:"platform,omitempty"`
	Topic      string `json:"topic,omitempty"`
	PlatformID int64  `json:"platform_id,omitempty"`
}

type ScheduledTaskRunView struct {
	RunID        string     `json:"run_id"`
	TaskID       string     `json:"task_id"`
	RunSessionID string     `json:"run_session_id"`
	State        string     `json:"state"`
	Reply        string     `json:"reply,omitempty"`
	Error        string     `json:"error,omitempty"`
	StartedAt    time.Time  `json:"started_at"`
	FinishedAt   *time.Time `json:"finished_at,omitempty"`
}

type ScheduledTaskView struct {
	TaskID          string     `json:"task_id"`
	Name            string     `json:"name"`
	ScheduleKind    string     `json:"schedule_kind"`
	Cron            string     `json:"cron,omitempty"`
	RunAt           *time.Time `json:"run_at,omitempty"`
	Prompt          string     `json:"prompt"`
	State           string     `json:"state"`
	SourceSessionID string     `json:"source_session_id,omitempty"`
	LastRunAt       *time.Time `json:"last_run_at,omitempty"`
	NextRunAt       *time.Time `json:"next_run_at,omitempty"`
	CreatedAt       time.Time  `json:"created_at"`
	UpdatedAt       time.Time  `json:"updated_at"`
}

type Service struct{}

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

type SessionExport struct {
	SessionID  string           `json:"session_id"`
	UID        string           `json:"uid"`
	LeafID     string           `json:"leaf_id"`
	State      string           `json:"state"`
	CreatedAt  time.Time        `json:"created_at"`
	UpdatedAt  time.Time        `json:"updated_at"`
	ExportedAt time.Time        `json:"exported_at"`
	EntryCount int              `json:"entry_count"`
	Entries    []map[string]any `json:"entries"`
}

type SessionSummary struct {
	SessionID string    `json:"session_id"`
	Title     string    `json:"title"`
	State     string    `json:"state"`
	Mode      string    `json:"mode"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

type Skill struct {
	Name                   string
	Description            string
	Location               string
	BaseDir                string
	Files                  []string
	DisableModelInvocation bool
}

type SkillContent struct {
	Name    string
	Content string
	BaseDir string
	Files   []string
}

type SkillInfo struct {
	Name        string `json:"name"`
	Description string `json:"description"`
}

type StreamEvent struct {
	Type string `json:"type"`

	// delta / done / thinking
	Text  string `json:"text,omitempty"`
	Title string `json:"title,omitempty"`

	// tool
	Name     string `json:"name,omitempty"`
	Subagent string `json:"subagent,omitempty"`
	Status   string `json:"status,omitempty"`
	Stdout   string `json:"stdout,omitempty"`
	Stderr   string `json:"stderr,omitempty"`

	// tool / turn timing
	DurationMs int64 `json:"duration_ms,omitempty"`
	Step       int   `json:"step,omitempty"`

	// usage
	PromptTokens     int     `json:"prompt_tokens,omitempty"`
	CompletionTokens int     `json:"completion_tokens,omitempty"`
	TotalTokens      int     `json:"total_tokens,omitempty"`
	ContextPercent   float64 `json:"context_percent,omitempty"`
	ContextWindow    int     `json:"context_window,omitempty"`

	// confirm / confirm_resolved
	ID               string `json:"id,omitempty"`
	Tool             string `json:"tool,omitempty"`
	Summary          string `json:"summary,omitempty"`
	Permission       string `json:"permission,omitempty"`
	Pattern          string `json:"pattern,omitempty"`
	SuggestedPattern string `json:"suggested_pattern,omitempty"`
	SuggestAlways    bool   `json:"suggest_always,omitempty"`
	Approved         bool   `json:"approved,omitempty"`
	Reason           string `json:"reason,omitempty"`
	Mode             string `json:"mode,omitempty"`
	Message          string `json:"message,omitempty"`

	// done
	Resources []ResourceRef `json:"resources,omitempty"`
}

type StreamSink interface {
	// OnDelta delivers throttled snapshot text for in-progress updates.
	OnDelta(ctx context.Context, text string) error
	// Flush writes the final reply text to the platform message.
	Flush(ctx context.Context, final string) error
}

type Subagent struct {
	Flag         string
	Name         string
	Description  string
	SystemPrompt string
	Tools        []string
	Skills       []string
	Model        string
}

type SubagentInfo struct {
	Name        string `json:"name"`
	Description string `json:"description"`
}

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

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

type TaskToolDeps struct {
	// SessionID is the owning chat session, used to reuse permission gates.
	SessionID string
	// UID is the session owner, used to evaluate tool permissions in the subagent.
	UID types.Uid
	// Depth is the delegation depth of the caller (0 for the primary agent).
	Depth int
	// Kind is the parent run kind propagated to subagent permission hooks.
	Kind RunKind
}

type ToolInfo struct {
	Name        string `json:"name"`
	Description string `json:"description"`
}

type ToolScopeInput struct {
	Mode      string
	Kind      RunKind
	UserText  string
	AllActive []string
}

type UpdateMemoryTool struct {
	Store *memory.FileStore
}

type UpdateScheduledTaskRequest struct {
	Name   *string `json:"name,omitempty"`
	Prompt *string `json:"prompt,omitempty"`
	Cron   *string `json:"cron,omitempty"`
	RunAt  *string `json:"run_at,omitempty"`
	State  *string `json:"state,omitempty"`
}

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