agent

type EventType int

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

type LoopConfig struct {
	Model     string
	MaxTokens int
	System    []api.SystemBlock
	Metadata  map[string]any
	// MaxTurns caps the number of API calls (tool-use follow-ups each count
	// as one turn). 0 means no limit (use carefully).
	MaxTurns int
	// Cwd is the working directory for the session. Used for persisting
	// "always allow" rules to <cwd>/.claude/settings.local.json.
	Cwd string

	// Gate is the permission gate to consult before each tool call.
	// nil means no gate (all tools allowed).
	Gate *permissions.Gate

	// Hooks is the hooks configuration to run around tool calls.
	// nil means no hooks.
	Hooks *settings.HooksSettings

	// SessionID is used when invoking hooks (passed as session_id in hook input).
	SessionID string

	// AutoCompact enables automatic history compaction when input token usage
	// exceeds 80% of MaxTokens. Mirrors the auto-compact behavior in
	// src/services/compact/compact.ts and QueryEngine.ts.
	AutoCompact bool

	// ThinkingBudget, when > 0, sends thinking:{type:"enabled",budget_tokens:N}
	// in each API request. Requires the interleaved-thinking-2025-05-14 beta header.
	// Set via /effort command or CLAUDE_THINKING_BUDGET env var.
	ThinkingBudget int

	// NotifyOnComplete, when true, fires a desktop notification after each
	// end_turn (not after tool-use turns). Mirrors the notifs hook behavior.
	NotifyOnComplete bool

	// AskPermission is called when a tool needs interactive approval.
	// It blocks until the user responds. Returns (allow, alwaysAllow).
	// nil means DecisionAsk → allow through silently.
	AskPermission func(ctx context.Context, toolName, toolInput string) (allow, alwaysAllow bool)

	// OnFileAccess is called after each file tool execution with the operation
	// ("read" or "write") and the file path. Used to populate /files output.
	OnFileAccess func(op, path string)

	// OnEndTurn fires after each end_turn (no tool_use) with the up-to-date
	// message history. Mirrors CC's post-Stop extractMemories trigger. The
	// caller is expected to single-flight any background work — Loop fires
	// this synchronously before returning so the caller can choose between
	// blocking or detaching to a goroutine.
	OnEndTurn func(history []api.Message)

	// OnCompact fires when auto-compaction runs and provides the summary text.
	// Used by the TUI to persist the summary to the session transcript.
	OnCompact func(summary string)

	// MicroCompact, when true, runs time-based microcompaction before each
	// request (mirrors src/services/compact/microCompact.ts time-based path).
	// When the gap since the last assistant message exceeds MicroCompactGap,
	// older tool_results are replaced with a placeholder. The cache is
	// expired anyway past that gap, so this shrinks what gets re-cached
	// without changing functional context.
	MicroCompact     bool
	MicroCompactGap  time.Duration // default 60m if zero
	MicroCompactKeep int           // default 5 if zero
	// LastAssistantTime seeds the gap calculation on resume. If zero, the
	// loop initializes from the first assistant response.
	LastAssistantTime time.Time
}

type LoopEvent struct {
	Type EventType

	// EventText
	Text string

	// EventToolUse
	ToolName  string
	ToolID    string
	ToolInput json.RawMessage

	// EventToolResult
	ResultText string
	IsError    bool

	// EventRateLimit
	RateLimitWarning string // non-empty when quota is running low
	RateLimitInfo    ratelimit.Info

	// EventPartial — fired before a stream error bubbles up so callers
	// can persist whatever assistant content was streamed before the
	// failure. The blocks here are already filtered (empty text/truncated
	// tool_use dropped by buildContentBlocks).
	PartialBlocks []api.ContentBlock
	PartialErr    error
}

type SkillEntry struct {
	Name        string
	Description string
}