agent

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

type AgentEvent struct {
	TurnID           int            `json:"turn_id"`
	SubTaskID        string         `json:"sub_task_id,omitempty"` // 子 Agent 事件路由 ID（对应 run_subagent 的 tool call ID）
	Seq              int            `json:"seq,omitempty"`         // turn 内事件序号，前端用于纠正 dev 模式 WebSocket 乱序
	Type             AgentEventType `json:"type"`
	Data             string         `json:"data,omitempty"`              // thinking / content 文本 chunk
	ToolName         string         `json:"tool_name,omitempty"`         // EventToolCall 时
	ToolID           string         `json:"tool_id,omitempty"`           // EventToolCall 时
	Phase            string         `json:"phase,omitempty"`             // "selected" | "executing" | "awaiting_approval" | "completed" | "failed" | "cancelled" | "loop_detected"
	ToolArgs         map[string]any `json:"tool_args,omitempty"`         // 工具参数快照
	Success          bool           `json:"success,omitempty"`           // 工具执行结果摘要
	ErrMsg           string         `json:"error,omitempty"`             // 失败时的错误信息
	DisplayText      string         `json:"display_text,omitempty"`      // buildDisplay 产出的展示文本
	ActivityKind     string         `json:"activity_kind,omitempty"`     // 展示类别
	Metadata         map[string]any `json:"metadata,omitempty"`          // buildDisplay 产出的附加信息（如 sub_agent_type）
	Usage            map[string]any `json:"usage,omitempty"`             // token 用量详情（含 usage_ratio / detail）
	CompressionPhase string         `json:"compression_phase,omitempty"` // "compressing" | "done"
	Summary          string         `json:"summary,omitempty"`           // 压缩摘要文本
	Attempt          int            `json:"attempt,omitempty"`           // EventRetrying 时：第几次重试（1-indexed）
	MaxRetries       int            `json:"max_retries,omitempty"`       // EventRetrying 时：最大重试次数
	BackoffMs        int64          `json:"backoff_ms,omitempty"`        // EventRetrying 时：本次退避毫秒数
	ClearFromSeq     int            `json:"clear_from_seq,omitempty"`    // EventRetrying 时：本轮 streamLoop 起点事件 seq（前端据此清空本轮 partial segments）
	Timestamp        time.Time      `json:"timestamp"`                   // 事件生成时间
}

type AgentEventType int

type AgentLoopResult struct {
	FinalText       string
	ThinkingContent string
	TurnCount       int
}

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

type InterruptError interface {
	error
	InterruptReason() string
}

type LoopInterrupt struct{ Reason string }

type MaxTurnsInterrupt struct{ Reason string }

type RunOptions struct {
	TurnID          int
	SessionID       string
	NovelID         int64
	Messages        []map[string]any
	AllowedTools    map[string]bool
	ActiveVersion   int
	SubAgentVersion int // 子 Agent 内存版本计数器，不持久化
	Model           *llm.ModelInfo
	ProviderName    string
	AgentType       string
	SubTaskID       string // 子 Agent 事件路由 ID
	EventSeq        *int   // 共享事件序号，nil 时自建（主Agent）；子Agent传入父的指针
	MaxTurns        int
	ReasoningEffort string // 用户选择的推理等级
}

type ToolFailureInterrupt struct{ Reason string }