chatagent

type APIRunOptions struct {
	Publisher EventPublisher
	Confirm   *ConfirmGate
}

type APIRunState 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 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
}

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

type ChatHookDeps struct {
	SessionID string
	UID       types.Uid
}

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 DBStorage struct {
	// contains filtered or unexported fields
}

type EventPublisher interface {
	Publish(event StreamEvent) error
}

type HistoryMessage struct {
	Role      string    `json:"role"`
	Text      string    `json:"text"`
	CreatedAt time.Time `json:"created_at"`
}

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 ReadSkillTool struct{}

type RunRequest struct {
	SessionID string
	Text      string
	API       *APIRunOptions
}

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"`
	State     string    `json:"state"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
}

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

type SkillContent struct {
	Name    string
	Content string
	BaseDir string
}

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

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

	// delta / done
	Text string `json:"text,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"`

	// 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"`
}

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
	Model        string
}

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

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
}

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