agent

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

type AuditEntry struct {
	TaskID    string
	ToolName  string
	Args      any
	Prompt    string
	Decision  string
	Result    string
	Error     string
	Agent     string
	Duration  string
	Timestamp time.Time
}

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

type Checker interface {
	Pass(ctx interface{}, contract string) (bool, string)
}

type ComboChecker struct {
	Checkers []Checker // 要依次执行的验证器列表
}

type Config struct {
	Model         string        `json:"model"`          // 模型
	GatewayURL    string        `json:"gateway_url"`    // 网关地址
	AuthToken     string        `json:"auth_token"`     // X-Auth-Token
	MaxTurns      int           `json:"max_turns"`      // 最大轮数
	Budget        int64         `json:"budget"`         // token 预算
	Timeout       time.Duration `json:"timeout"`        // 网关超时
	ContextWindow int           `json:"context_window"` // v2.5.4.9 滚动窗口压缩——保留最近 N 轮完整（默认 5——Mr2109）
	WorkDir       string        `json:"work_dir"`       // 工作区
	StateDir      string        `json:"state_dir"`      // 状态目录
	Temperature   float64       `json:"temperature"`    // 采样温度（v2.5：默认 0.3——低温稳定工具调用）
}

type Decision struct {
	Action  string // allow / block / require_approval
	Message string // 决策说明
}

type DeviceAwareConfig struct {
	Devices []DeviceConfig `yaml:"devices"`
}

type DeviceConfig struct {
	Hostname   string `yaml:"hostname"`
	MaxWorkers *int   `yaml:"max_workers"` // nil=未给（回退默认）· 0=显式暂停 · >0=并发上限
}

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

type EventEntry struct {
	Seq       int64
	TaskID    string
	Type      string
	Level     string
	Action    string
	ToolName  string
	Prompt    string
	Args      any
	Result    string
	Error     string
	Step      int
	Duration  string
	Timestamp time.Time
}

type EventType string

type ExecContext struct {
	WorkDir   string        // 工作区根目录
	Timeout   time.Duration // 命令超时（默认 30s）
	OutputMax int           // 输出最大字符数（默认 2000）
	AgentName string        // agent 名称（用于 gate 日志）
	// v2.5.5 P2: 父 agent 引用（spawn_agent 子 agent 委托——2026-08-21 Mr2109）
	Parent *Agent
	// S10: 白名单目录（任务目录——结晶模式报告写入——validatePath 例外）
	ExtraAllowDirs []string
	// ── T1.2 观测（实现见 tool_decision.go）──
	// Session: 会话 id（**只观测**；空 ⇒ 观测面无 trace/span 骨架——不编造 id）
	// obs:     本次调用的判定作用域（工具名/参数摘要/是否已记拒绝）
	Session string
	// contains filtered or unexported fields
}

type ExtraTool struct {
	Name string                                                    // 工具名
	Desc string                                                    // 描述（工具列表/搜索用）
	Fn   func(args map[string]any, workDir string) (string, error) // 执行器
}

type FailureCluster struct {
	Key           string   `json:"key"`            // 簇标识（失败类型:任务hash前4位）
	ErrorType     string   `json:"error_type"`     // 失败类型
	Count         int      `json:"count"`          // 簇内 issue 数量
	IssueIDs      []string `json:"issue_ids"`      // 簇内所有 issue ID
	SuggestedRoot string   `json:"suggested_root"` // 建议根因
}

type FunctionDef struct {
	Name        string         `json:"name"`
	Description string         `json:"description"` // "怎么用"（含示例/边界）——模型靠它学会
	Parameters  map[string]any `json:"parameters"`  // JSON Schema
}

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

type InternalTask struct {
	ID          string        // 任务类型 ID（如 "tool-check"）
	Description string        // 人类可读描述
	Template    string        // 任务描述模板（派 CA 用——含工作区/要求）
	Cooldown    time.Duration // 冷却时间（同类型防重复）
}

type IssueRecord struct {
	InstanceID    string   `json:"instance_id"`          // 唯一标识（时间戳+任务hash）
	Task          string   `json:"task"`                 // 任务描述（截断 200）
	ExitStatus    string   `json:"exit_status"`          // failed/timeout/blocked/token_budget/model_error
	ErrorType     string   `json:"error_type"`           // 失败分类枚举
	RetryCount    int      `json:"retry_count"`          // 重试次数
	AssignedAgent string   `json:"assigned_agent"`       // 派单 agent（默认 zerg-agent）
	CreatedAt     string   `json:"created_at"`           // 创建时间
	LastAttemptAt string   `json:"last_attempt_at"`      // 最后尝试
	ToolTrace     []string `json:"tool_trace,omitempty"` // 工具调用轨迹（诊断用）
	Status        string   `json:"status"`               // open/fixing/resolved/escalated
	Resolution    string   `json:"resolution,omitempty"` // 修复结论（agent 填）
}

type LLMChoice struct {
	Message      LLMMessage `json:"message"`
	FinishReason string     `json:"finish_reason,omitempty"`
}

type LLMError struct {
	Message string `json:"message"`
	Code    string `json:"code,omitempty"`
}

type LLMJudge struct {
	GatewayURL string // 模型网关地址（如 "https://api.openai.com/v1/chat/completions"）
	AuthToken  string // API 密钥
	Model      string // 模型名（如 "gpt-4o-mini"）
}

type LLMJudgeRequest struct {
	Model    string       `json:"model"`
	Messages []LLMMessage `json:"messages"`
}

type LLMJudgeResponse struct {
	Error   *LLMError   `json:"error,omitempty"`
	Choices []LLMChoice `json:"choices"`
}

type LLMMessage struct {
	Role    string `json:"role"`
	Content string `json:"content"`
}

type LogLevel string

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

type LoopResult struct {
	Reason    TerminateReason // 终止原因
	Turns     int             // 执行轮数
	Tokens    int64           // 累计 token
	Content   string          // 最终内容
	ToolTrace []string        // v2.5.1 工具调用轨迹（挂单诊断用）
}

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

type MemoryStore struct {
	Dir     string // 记忆目录（.zerg/memory/{agentId}/）
	HotFile string // 热记忆（MEMORY.md——上限 4KB）
}

type Message struct {
	Role       string     `json:"role"`
	Content    string     `json:"content"`
	ToolCallID string     `json:"tool_call_id,omitempty"`
	ToolCalls  []ToolCall `json:"tool_calls,omitempty"`
}

type ModelAdapter interface {
	Call(ctx context.Context, sysPrompt string, messages []Message, tools []ToolDef) (*ModelResponse, error)
}

type ModelResponse struct {
	Content   string
	Reasoning string
	// ReasoningOnly 标记「只有思考、无正文」（不把思考搬进 Content——见事故注释）
	ReasoningOnly bool
	ToolCalls     []ToolCall
	Finish        string
	Usage         struct {
		TotalTokens int64
	}
}

type NoProgressDetector struct {
	Threshold int
	// contains filtered or unexported fields
}

type ParsedIssue struct {
	Path        string    // 文件绝对路径
	InstanceID  string    // 从文件名提取
	Status      string    // 当前状态
	Priority    Priority  // 优先级
	RetryCount  int       // 当前重试次数
	LastAttempt time.Time // 最后尝试时间
	CreatedAt   time.Time // 创建时间
	Content     string    // 原始 markdown 内容
}

type Priority int

type RetryPolicy struct {
	MaxRetries int
	Backoff    time.Duration
	Retryable  func(err error) bool
}

type Scheduler struct {

	// v2.5.3 容器模式（CA 脱离沙箱——docker run 完整环境）
	ContainerMode     bool   // true=容器内执行 worker（默认 false=exec 兼容）
	ContainerAgentBin string // Linux zerg-agent 路径（容器内挂载）
	DevMode           bool   // C4: 开发模式（容器内分支开发→commit→PR——主仓库=workDir）
	RepoDir           string // v2.5.3: 开发仓库路径（纯代码——git管理——DevMode用）
	// contains filtered or unexported fields
}

type SearchParams struct {
	Query     string   // 搜索词
	Limit     int      // 结果数（默认 5——auto 深度: 长 query 自动 8）
	Lang      string   // 语言 all/zh/en...（ISO 639-1——searxng babel locale）
	TimeRange string   // 时间过滤 day/week/month/year（空=不限）
	Domains   []string // 限定域名（site: 操作符——信任站点）
	FetchTop  int      // 自动抓取前 N 条正文（0=不抓——默认 1 更实用）
	Rewrite   bool     // LLM query 重写（X3 9001——失败 fallback 规则）
}

type SearchResult struct {
	Title   string `json:"title"`
	URL     string `json:"url"`
	Content string `json:"content"`
}

type SearxngResponse struct {
	Results []SearchResult `json:"results"`
}

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

type Skill struct {
	Name        string // frontmatter name
	Description string // frontmatter description（触发器）
	Path        string // SKILL.md 路径
	Body        string // 正文（触发时读取）
}

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

type SubagentConfig struct {
	Type     SubagentType // 子 agent 类型
	Model    string       // 模型名称（explore 用轻量模型——nanbeige）
	MaxTurns int          // 每层配额——默认 SubAgentMaxTurns（见 max_turns.go）
	Tools    []string     // 工具白名单（allowlist）
}

type SubagentResult struct {
	TaskDesc   string          // 任务描述
	Summary    string          // 精简摘要（1-2K 字符，父上下文干净）
	Terminates TerminateReason // 终止原因
	ToolUse    string          // 工具调用摘要（如 "read×3, grep×1"）
}

type SubagentType string

type SysMetric struct {
	Timestamp time.Time `json:"ts"`
	Step      int       `json:"step"`
	// 本机
	LocalCPU  float64 `json:"local_cpu,omitempty"`       // 本机 CPU %（总）
	LocalMem  float64 `json:"local_mem,omitempty"`       // 本机内存 %
	DiskRead  float64 `json:"disk_read_mbps,omitempty"`  // 磁盘读 MB/s
	DiskWrite float64 `json:"disk_write_mbps,omitempty"` // 磁盘写 MB/s
	// X3（agent 状态——如有）
	X3GPU      float64 `json:"x3_gpu,omitempty"`          // X3 GPU %
	X3CPU      float64 `json:"x3_cpu,omitempty"`          // X3 CPU %
	X3Active   int     `json:"x3_active,omitempty"`       // X3 活跃请求
	X3MemAvail float64 `json:"x3_mem_avail_gb,omitempty"` // X3 可用内存 GB
}

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

type TaskInput struct {
	Description string       // 任务简述（用于日志/摘要）
	Prompt      string       // 完整提示词（发给子 agent）
	Type        SubagentType // 子 agent 类型
	Model       string       // 覆盖默认模型
}

type TaskSpec struct {
	Task     string `json:"task"`     // 任务描述
	Type     string `json:"type"`     // 任务类型：code/report/research/fix
	Priority string `json:"priority"` // 优先级：high/normal/low
	Repo     string `json:"repo"`     // 关联仓库（可选）
	Source   string `json:"source"`   // 来源：git/cron/api/a2a
}

type TerminateReason string

type Terminator func(reason TerminateReason)

type TestChecker struct {
	Command string // 要执行的命令（如 "go test ./..."）
}

type TodoItem struct {
	ID      string `json:"id"`
	Content string `json:"content"`
	Status  string `json:"status"` // pending/in_progress/completed
}

type ToolCall struct {
	ID      string         `json:"id"`
	Name    string         `json:"name"`
	Args    map[string]any `json:"args"`
	RawArgs string         `json:"raw_args"`
	RawCall string         `json:"raw_call,omitempty"` // P4-47 模型输出原文（Hermes <tool_call> 原文——回传上下文用）
}

type ToolCallResult struct {
	ToolCallID string `json:"tool_call_id"`
	ToolName   string `json:"tool_name"` // 工具名（无进展检测用——v2.5）
	Content    string `json:"content"`
	Error      string `json:"error,omitempty"`
	Duration   string `json:"duration,omitempty"` // v2.5.4.9 工具执行耗时（CA 追踪）
}

type ToolDef struct {
	Type     string      `json:"type"` // function
	Function FunctionDef `json:"function"`
}

type ToolEvent struct {
	Ts    int64  `json:"ts"`     // Unix 秒（时间维度——按天/月聚合）
	Node  string `json:"node"`   // 执行节点（local/x3/...——未来多节点汇总）
	Tool  string `json:"tool"`   // 工具名
	DurMs int64  `json:"dur_ms"` // 执行耗时（毫秒——工作量参考）
}

type ToolGater interface {
	Check(toolName, args string, agent string) (Decision, error)
}

type TranscriptEntry struct {
	TaskID     string
	Step       int
	Role       string
	Content    string
	ToolName   string
	ToolCallID string
	Args       any
	Result     string
	Error      string
	Duration   string
	Timestamp  time.Time
}

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

type WorkerRunner func(issuePath string) int

type WorkersConfig struct {
	MaxWorkers int `yaml:"max_workers"`
}