claude

type AgentConfig struct {
	Description     string         `json:"description"`
	Prompt          string         `json:"prompt"`
	Tools           []string       `json:"tools,omitempty"`
	DisallowedTools []string       `json:"disallowedTools,omitempty"`
	Model           string         `json:"model,omitempty"`
	PermissionMode  string         `json:"permissionMode,omitempty"`
	MaxTurns        int            `json:"maxTurns,omitempty"`
	Skills          []string       `json:"skills,omitempty"`
	McpServers      map[string]any `json:"mcpServers,omitempty"`
	Hooks           map[string]any `json:"hooks,omitempty"`
	Memory          string         `json:"memory,omitempty"`
}

type MessageSubtype string

type MessageSummary struct {
	Role       string         `json:"role"`
	Content    string         `json:"content"`
	ToolCalls  []ToolCallInfo `json:"tool_calls,omitempty"`
	ToolCallID string         `json:"tool_call_id,omitempty"`
	Timestamp  string         `json:"timestamp,omitempty"`
}

type MessageType string

type MessagesInfo struct {
	Status   ProcessStatus    `json:"status"`
	Messages []MessageSummary `json:"messages"`
}

type OpenAIFunction struct {
	Name      string `json:"name"`
	Arguments string `json:"arguments"`
}

type OpenAIHook struct {
	HookName string `json:"hook_name"`
	Output   string `json:"output,omitempty"`
	ExitCode int    `json:"exit_code,omitempty"`
}

type OpenAIMessage struct {
	Role             string           `json:"role"`
	Content          *string          `json:"content"`
	ToolCalls        []OpenAIToolCall `json:"tool_calls,omitempty"`
	ToolCallID       string           `json:"tool_call_id,omitempty"`
	ReasoningContent string           `json:"reasoning_content,omitempty"`
	ThinkingBlocks   []ThinkingBlock  `json:"thinking_blocks,omitempty"`
}

type OpenAIMessagesInfo struct {
	Messages []OpenAIMessage `json:"messages"`
	Metadata OpenAIMetadata  `json:"metadata"`
	Total    int             `json:"total"`
}

type OpenAIMetadata struct {
	SessionID         string           `json:"session_id,omitempty"`
	Model             string           `json:"model,omitempty"`
	ClaudeCodeVersion string           `json:"claude_code_version,omitempty"`
	Tools             []string         `json:"tools,omitempty"`
	Plugins           []OpenAIPlugin   `json:"plugins,omitempty"`
	Hooks             []OpenAIHook     `json:"hooks,omitempty"`
	Subagents         []OpenAISubagent `json:"subagents,omitempty"`
	CostUSD           float64          `json:"cost_usd,omitempty"`
	DurationMS        float64          `json:"duration_ms,omitempty"`
	NumTurns          int              `json:"num_turns,omitempty"`
	Usage             *TokenUsage      `json:"usage,omitempty"`
}

type OpenAIPlugin struct {
	Name string `json:"name"`
	Path string `json:"path,omitempty"`
}

type OpenAISubagent struct {
	TaskID      string `json:"task_id"`
	Description string `json:"description,omitempty"`
	TaskType    string `json:"task_type,omitempty"`
}

type OpenAIToolCall struct {
	ID       string         `json:"id"`
	Type     string         `json:"type"`
	Function OpenAIFunction `json:"function"`
}

type Options struct {
	// Model selects the Claude model (e.g. "claude-sonnet-4-20250514", "sonnet", "opus").
	Model string
	// SystemPrompt overrides the default system prompt entirely.
	SystemPrompt string
	// AppendSystemPrompt is appended to the default system prompt.
	AppendSystemPrompt string
	// AllowedTools restricts tool access; empty means all allowed.
	// Supports patterns like "Bash(git:*)" and "Edit".
	AllowedTools []string
	// DisallowedTools explicitly blocks specific tools.
	DisallowedTools []string
	// Tools controls the base set of built-in tools available.
	// Use "default" for all tools, "" to disable all, or specific names like "Bash,Edit,Read".
	Tools []string
	// MaxTurns limits agentic turns per prompt; 0 means unlimited.
	MaxTurns int
	// MCPConfigPath is a path to an MCP servers configuration file.
	MCPConfigPath string
	// StrictMCPConfig when true only uses MCP servers from MCPConfigPath,
	// ignoring user, project, and local MCP configurations.
	StrictMCPConfig bool
	// WorkDir is the working directory for the Claude subprocess.
	WorkDir string
	// PermissionMode controls how Claude handles tool permissions.
	// Valid values: "default", "acceptEdits", "bypassPermissions", "dontAsk", "plan", "delegate".
	PermissionMode string

	// MaxBudgetUSD caps the maximum dollar spend per invocation; 0 means no limit.
	MaxBudgetUSD float64
	// Effort controls the effort level: "low", "medium", "high"; empty means default.
	Effort string
	// FallbackModel specifies a model to use when the primary is overloaded.
	FallbackModel string

	// SessionID uses a specific UUID for the conversation.
	SessionID string
	// Resume resumes a previous conversation by session ID.
	Resume string
	// ContinueSession continues the most recent conversation in the working directory.
	ContinueSession bool
	// ForkSession creates a new session ID when resuming.
	ForkSession bool
	// NoSessionPersistence disables saving sessions to disk.
	NoSessionPersistence bool

	// Agents defines custom subagents that the main agent can delegate to via
	// the "Task" tool. Passed to the CLI as --agents JSON. Each subagent runs
	// in its own context with its own prompt, tools, and model.
	// See https://code.claude.com/docs/en/sub-agents
	Agents map[string]AgentConfig
	// ActiveAgent selects which agent runs as the top-level agent for the
	// session (--agent flag). This changes who handles the prompt, not which
	// subagents are available. The selected agent can still spawn subagents
	// defined in Agents or discovered via AddDirs.
	ActiveAgent string

	// JSONSchema constrains the output to conform to a JSON Schema.
	JSONSchema string

	// SettingsFile is a path to a settings JSON file or inline JSON string.
	SettingsFile string
	// SettingSources controls which setting sources are loaded (comma-separated: "user,project,local").
	SettingSources string

	// ResultDir overrides the directory where session results are persisted.
	// When empty, ResultStorePath determines the default location outside
	// the workspace (e.g. $HOME/.klaus/results/).
	ResultDir string

	// PluginDirs are directories to load plugins from.
	PluginDirs []string
	// AddDirs are directories to search for .claude/ subdirectories containing
	// skills (.claude/skills/) and subagent definitions (.claude/agents/).
	// Subagents found via AddDirs have lower priority than those in Agents (--agents).
	// See https://code.claude.com/docs/en/sub-agents#choose-the-subagent-scope
	AddDirs []string
}

type PersistedResult struct {
	ResultText    string          `json:"result_text"`
	Messages      []StreamMessage `json:"messages,omitempty"`
	MessageCount  int             `json:"message_count"`
	ToolCalls     map[string]int  `json:"tool_calls,omitempty"`
	SubagentCalls []SubagentCall  `json:"subagent_calls,omitempty"`
	ModelUsage    map[string]int  `json:"model_usage,omitempty"`
	PRURLs        []string        `json:"pr_urls,omitempty"`
	ErrorCount    int             `json:"error_count,omitempty"`
	TokenUsage    *TokenUsage     `json:"token_usage,omitempty"`
	TotalCost     *float64        `json:"total_cost_usd"`
	SessionID     string          `json:"session_id,omitempty"`
	Status        ProcessStatus   `json:"status"`
	ErrorMessage  string          `json:"error,omitempty"`
	StopReason    StopReason      `json:"stop_reason,omitempty"`
	Timestamp     time.Time       `json:"timestamp"`
}

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

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

type ProcessStatus string

type Prompter interface {
	// Run spawns or sends a prompt and returns a channel of stream-json messages.
	// The channel is closed when the response is complete.
	Run(ctx context.Context, prompt string) (<-chan StreamMessage, error)

	// RunWithOptions is like Run but accepts per-invocation overrides.
	RunWithOptions(ctx context.Context, prompt string, opts *RunOptions) (<-chan StreamMessage, error)

	// RunSyncWithOptions sends a prompt with per-run overrides and blocks until completion.
	RunSyncWithOptions(ctx context.Context, prompt string, opts *RunOptions) (string, []StreamMessage, error)

	// Submit starts a prompt non-blocking: it calls RunWithOptions, spawns a
	// background goroutine to drain the message channel and store results,
	// then returns immediately. The ctx should be a server-scoped context
	// (not an MCP request context) so the drain goroutine outlives the caller.
	// When the drain completes, the status transitions to "completed" and the
	// result is available via Status() and ResultDetail(). The result persists
	// until the next Submit call clears it.
	Submit(ctx context.Context, prompt string, opts *RunOptions) error

	// Status returns the current status information. When the status is
	// "completed" (after a non-blocking Submit finishes), the Result field
	// contains the agent's truncated output. Use ResultDetail() for the
	// full untruncated text.
	Status() StatusInfo

	// Stop stops the current operation or subprocess.
	Stop() error

	// Done returns a channel that is closed when the current run completes.
	Done() <-chan struct{}

	// ResultDetail returns the full untruncated result and detailed metadata
	// from the last completed run. Intended for debugging and troubleshooting.
	ResultDetail() ResultDetailInfo

	// Messages returns the current conversation messages. While the agent
	// is busy, it returns the live-accumulated messages; when completed,
	// it falls back to the stored result messages or persisted state.
	Messages() MessagesInfo

	// RawMessages returns the raw stream-json messages from the current or
	// last completed run. Unlike Messages(), it preserves the original JSON
	// bytes without lossy summarization. offset skips the first N messages;
	// types filters by message type (empty means all types).
	RawMessages(offset int, types []string) RawMessagesInfo

	// OpenAIMessages returns conversation messages in OpenAI Chat Completions
	// compatible format, with metadata extracted from system/result messages.
	// offset skips the first N converted messages (after consolidation).
	OpenAIMessages(offset int) OpenAIMessagesInfo

	// MarshalStatus returns the status as JSON.
	MarshalStatus() ([]byte, error)
}

type RawMessagesInfo struct {
	Status   ProcessStatus     `json:"status"`
	Total    int               `json:"total"`
	Messages []json.RawMessage `json:"messages"`
}

type ResultDetailInfo struct {
	ResultText    string          `json:"result_text"`
	Messages      []StreamMessage `json:"messages,omitempty"`
	MessageCount  int             `json:"message_count"`
	ToolCalls     map[string]int  `json:"tool_calls,omitempty"`
	SubagentCalls []SubagentCall  `json:"subagent_calls,omitempty"`
	ModelUsage    map[string]int  `json:"model_usage,omitempty"`
	PRURLs        []string        `json:"pr_urls,omitempty"`
	ErrorCount    int             `json:"error_count,omitempty"`
	TokenUsage    *TokenUsage     `json:"token_usage,omitempty"`
	TotalCost     *float64        `json:"total_cost_usd"`
	SessionID     string          `json:"session_id,omitempty"`
	Status        ProcessStatus   `json:"status"`
	ErrorMessage  string          `json:"error,omitempty"`
}

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

type RunOptions struct {
	// SessionID overrides Options.SessionID for this run.
	SessionID string
	// Resume overrides Options.Resume for this run.
	Resume string
	// ContinueSession overrides Options.ContinueSession for this run.
	ContinueSession bool
	// ForkSession overrides Options.ForkSession for this run.
	ForkSession bool
	// ActiveAgent overrides Options.ActiveAgent for this run.
	ActiveAgent string
	// JSONSchema overrides Options.JSONSchema for this run.
	JSONSchema string
	// MaxBudgetUSD overrides Options.MaxBudgetUSD for this run.
	MaxBudgetUSD float64
	// Effort overrides Options.Effort for this run.
	Effort string
}

type StatusInfo struct {
	Status        ProcessStatus  `json:"status"`
	SessionID     string         `json:"session_id,omitempty"`
	ErrorMessage  string         `json:"error,omitempty"`
	PreviousError string         `json:"previous_error,omitempty"`
	TotalCost     *float64       `json:"total_cost_usd"`
	MessageCount  int            `json:"message_count,omitempty"`
	ToolCallCount int            `json:"tool_call_count,omitempty"`
	ToolCalls     map[string]int `json:"tool_calls,omitempty"`
	TokenUsage    *TokenUsage    `json:"token_usage,omitempty"`
	LastMessage   string         `json:"last_message,omitempty"`
	LastToolName  string         `json:"last_tool_name,omitempty"`
	// SubagentCalls tracks subagent dispatches via the Task/Agent tool.
	SubagentCalls []SubagentCall `json:"subagent_calls,omitempty"`
	ModelUsage    map[string]int `json:"model_usage,omitempty"`
	ErrorCount    int            `json:"error_count,omitempty"`
	// Result contains the agent's final output text from the last completed
	// non-blocking Submit run, truncated to maxStatusResultLen runes. It is
	// populated when the status is "completed". Use the result debug tool
	// for the full untruncated text.
	//
	// The result persists until the next Submit call clears it (along with
	// resetting the status to "busy"). There is no explicit "consumed"
	// acknowledgement; callers should track whether they have already
	// processed a given result.
	Result string `json:"result,omitempty"`
}

type StopReason string

type StreamMessage struct {
	Type      MessageType     `json:"type"`
	Subtype   MessageSubtype  `json:"subtype,omitempty"`
	Timestamp string          `json:"timestamp,omitempty"`
	Message   json.RawMessage `json:"message,omitempty"`

	// Fields present on "system" messages.
	SessionID string `json:"session_id,omitempty"`

	// Fields present on "assistant" messages with subtype "text".
	Text string `json:"text,omitempty"`

	// Fields present on "assistant" messages with subtype "tool_use".
	ToolName string          `json:"tool_name,omitempty"`
	ToolID   string          `json:"tool_id,omitempty"`
	ToolArgs json.RawMessage `json:"tool_args,omitempty"`

	// Usage holds token counts from the Claude API, present on "assistant" messages.
	Usage *TokenUsage `json:"usage,omitempty"`

	// Fields present on "result" messages.
	Result   string  `json:"result,omitempty"`
	Duration float64 `json:"duration_ms,omitempty"`
	Cost     float64 `json:"cost_usd,omitempty"`
	IsError  bool    `json:"is_error,omitempty"`

	// TotalCost tracks the running total cost of the session.
	TotalCost float64 `json:"total_cost_usd,omitempty"`

	// Fields present on "stream_event" messages (--include-partial-messages).
	EventType      string `json:"-"`
	DeltaText      string `json:"-"`
	ToolUseName    string `json:"-"` // tool name from content_block_start with type "tool_use"
	ToolUseBlockID string `json:"-"` // tool use ID from content_block_start with type "tool_use"
	InputJSONDelta string `json:"-"` // partial JSON from content_block_delta with input_json_delta

	// Raw holds the original JSON for messages we don't fully parse.
	Raw json.RawMessage `json:"-"`
}

type SubagentCall struct {
	Type        string  `json:"type"`
	Description string  `json:"description,omitempty"`
	ToolID      string  `json:"tool_id,omitempty"`
	ToolCalls   int     `json:"tool_calls,omitempty"`
	Tokens      int     `json:"tokens,omitempty"`
	DurationMS  float64 `json:"duration_ms,omitempty"`
	Status      string  `json:"status,omitempty"`
}

type ThinkingBlock struct {
	Type      string `json:"type"`
	Thinking  string `json:"thinking"`
	Signature string `json:"signature,omitempty"`
}

type TokenUsage struct {
	InputTokens              int64 `json:"input_tokens,omitempty"`
	OutputTokens             int64 `json:"output_tokens,omitempty"`
	CacheCreationInputTokens int64 `json:"cache_creation_input_tokens,omitempty"`
	CacheReadInputTokens     int64 `json:"cache_read_input_tokens,omitempty"`
}

type ToolCallInfo struct {
	ID   string          `json:"id"`
	Name string          `json:"name"`
	Args json.RawMessage `json:"args,omitempty"`
}

type ToolResultBlock struct {
	Type      string `json:"type"`
	ToolUseID string `json:"tool_use_id,omitempty"`
	Content   string `json:"content"`
	IsError   bool   `json:"is_error"`
}

type ToolResultInfo struct {
	ToolCallID string `json:"tool_call_id"`
	Content    string `json:"content"`
	IsError    bool   `json:"is_error,omitempty"`
}