tools

type AppendDiaryInput struct {
	Entry string `json:"entry" jsonschema:"required,description=Diary entry content to append"`
}

type AppendDiaryOutput struct {
	DiaryPath string `json:"diary_path"` // 写入的日记文件路径
}

type AppendFileInput struct {
	Path    string `json:"path" jsonschema:"required,description=Absolute path to the file"`
	Content string `json:"content" jsonschema:"required,description=Content to append to file end"`
}

type CronToolInput struct {
	Action       string `` /* 153-byte string literal not displayed */
	Name         string `json:"name,omitempty" jsonschema:"description=Job name (required for add)"`
	Message      string `json:"message,omitempty" jsonschema:"description=Message to send to agent (required for add)"`
	EverySeconds int64  `json:"every_seconds,omitempty" jsonschema:"description=Repeat interval in seconds (for add with every schedule)"`
	CronExpr     string `json:"cron_expr,omitempty" jsonschema:"description=Cron expression like '0 9 * * *' (for add with cron schedule)"`
	AtTimestamp  string `json:"at_timestamp,omitempty" jsonschema:"description=RFC3339 timestamp for one-shot (for add with at schedule)"`
	JobID        string `json:"job_id,omitempty" jsonschema:"description=Job ID (required for remove/enable/disable)"`
	Deliver      bool   `json:"deliver,omitempty" jsonschema:"description=If true deliver response directly without agent processing"`
}

type EditFileInput struct {
	Path    string `json:"path" jsonschema:"required,description=Absolute path to the file"`
	OldText string `json:"old_text" jsonschema:"required,description=Exact existing text to replace"`
	NewText string `json:"new_text" jsonschema:"required,description=Replacement text"`
}

type ExecInput struct {
	Command    string `json:"command" jsonschema:"required,description=Shell command to execute"`
	WorkingDir string `json:"working_dir" jsonschema:"description=Working directory for the command"`
}

type ExecOutput struct {
	Stdout   string `json:"stdout"`
	Stderr   string `json:"stderr"`
	ExitCode int    `json:"exit_code"`
}

type GuardAction string

type GuardFunc func(ctx context.Context, name, argsJSON string) (GuardResult, error)

type GuardResult struct {
	Action  GuardAction // 决策动作
	Message string      // 决策原因或给用户的提示
}

type InvocationContext struct {
	Channel   string // 调用来源通道（如 telegram, cli）
	ChatID    string // 调用来源聊天会话 ID
	SenderID  string // 发起调用的发送者 ID
	RequestID string // 关联的请求追踪 ID
	SessionID string // 关联的会话 ID
}

type ListDirInput struct {
	Path string `json:"path" jsonschema:"required,description=Directory path to list"`
}

type MessageInput struct {
	Content string `json:"content" jsonschema:"required,description=Message content to send"`
	Channel string `json:"channel,omitempty" jsonschema:"description=Target channel (optional; defaults to current channel)"`
	ChatID  string `json:"chat_id,omitempty" jsonschema:"description=Target chat/session id (optional; defaults to current chat)"`
}

type ReadFileInput struct {
	Path   string `json:"path" jsonschema:"required,description=Absolute path to the file"`
	Offset int    `json:"offset" jsonschema:"description=Starting line number (0-based)"`
	Limit  int    `json:"limit" jsonschema:"description=Maximum number of lines to read"`
}

type ReadFileOutput struct {
	Content    string `json:"content"`     // 文件内容
	TotalLines int    `json:"total_lines"` // 文件总行数
}

type ReadMemoryInput struct{}

type ReadMemoryOutput struct {
	Content string `json:"content"` // 长期记忆文件的完整内容
}

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

type SpawnInput struct {
	Task    string `json:"task" jsonschema:"required,description=Task to delegate to a background subagent"`
	Label   string `json:"label,omitempty" jsonschema:"description=Optional label for task tracking"`
	Channel string `json:"channel,omitempty" jsonschema:"description=Optional origin channel override"`
	ChatID  string `json:"chat_id,omitempty" jsonschema:"description=Optional origin chat id override"`
}

type SubagentExecutor interface {
	// Spawn 异步启动任务。
	Spawn(ctx context.Context, req SubagentRequest) (string, error)
	// RunSync 同步运行任务并等待结果。
	RunSync(ctx context.Context, req SubagentRequest) (string, error)
}

type SubagentInput struct {
	Task    string `json:"task" jsonschema:"required,description=Task to execute via a delegated subagent"`
	Label   string `json:"label,omitempty" jsonschema:"description=Optional label for this delegated run"`
	Channel string `json:"channel,omitempty" jsonschema:"description=Optional origin channel override"`
	ChatID  string `json:"chat_id,omitempty" jsonschema:"description=Optional origin chat id override"`
}

type SubagentRequest struct {
	Task           string // 需要子代理执行的任务描述
	Label          string // 任务的可选描述性标签
	OriginChannel  string // 原始请求通道
	OriginChatID   string // 原始聊天 ID
	OriginSenderID string // 原始发送者 ID
	RequestID      string // 请求追踪 ID
}

type WebFetchInput struct {
	URL      string `json:"url" jsonschema:"required,description=The target URL to fetch"`
	MaxBytes int    `json:"max_bytes" jsonschema:"description=Optional maximum response bytes to keep"`
}

type WebFetchOutput struct {
	URL         string `json:"url"`
	Status      int    `json:"status"`
	ContentType string `json:"content_type"`
	Content     string `json:"content"`
	Truncated   bool   `json:"truncated"`
}

type WebSearchInput struct {
	Query      string `json:"query" jsonschema:"required,description=The search query"`
	MaxResults int    `json:"max_results" jsonschema:"description=Optional per-request result limit"`
}

type WebSearchOutput struct {
	Query   string            `json:"query"`
	Results []WebSearchResult `json:"results"`
}

type WebSearchResult struct {
	Title       string `json:"title"`
	URL         string `json:"url"`
	Description string `json:"description"`
}

type WorkflowExecutor interface {
	// RunWorkflow 执行委托的工作流并返回汇总结果。
	RunWorkflow(ctx context.Context, req WorkflowRequest) (string, error)
}

type WorkflowInput struct {
	Goal     string   `json:"goal" jsonschema:"required,description=Overall workflow goal for decomposition and execution"`
	Mode     string   `json:"mode,omitempty" jsonschema:"description=Execution mode: sequential or parallel"`
	Subtasks []string `json:"subtasks,omitempty" jsonschema:"description=Optional predefined subtasks"`
	Label    string   `json:"label,omitempty" jsonschema:"description=Optional workflow label for tracking"`
}

type WorkflowRequest struct {
	Goal           string   // 整个工作流的最终目标
	Mode           string   // 执行模式：sequential (顺序) 或 parallel (并行)
	Subtasks       []string // 预定义的子任务列表
	Label          string   // 用于追踪的工作流标签
	OriginChannel  string   // 原始请求通道
	OriginChatID   string   // 原始聊天 ID
	OriginSenderID string   // 原始发送者 ID
	RequestID      string   // 请求追踪 ID
}

type WriteFileInput struct {
	Path    string `json:"path" jsonschema:"required,description=Absolute path to the file"`
	Content string `json:"content" jsonschema:"required,description=Content to write"`
}

type WriteMemoryInput struct {
	Content string `json:"content" jsonschema:"required,description=Content to store as long-term memory"`
}