tools

type ApplyPatchToolOpt struct {
	// Workspace 是应用补丁的工作区；补丁路径以它的根目录为基准，只能修改工作区内的文件。
	Workspace workspace.Workspace
}

type CommandResult struct {
	CommandID string `json:"command_id"`
	Status    string `json:"status"`
	// ExitCode 只有 exited 有；被信号终止（含停止）时为 -1。
	ExitCode   *int   `json:"exit_code"`
	StopReason string `json:"stop_reason,omitempty"`
	// Error 是 failed 的原因，其他状态为空。
	Error      string `json:"error,omitempty"`
	Output     string `json:"output"`
	NextCursor uint64 `json:"next_cursor"`
	HasMore    bool   `json:"has_more"`
	Truncated  bool   `json:"truncated,omitempty"`
}

type CommandToolsOpt struct {
	// EnvironmentID 是命令所属的执行环境；查找、列出命令都只看这个环境。
	EnvironmentID string
	// Workspace 是启动命令的工作区；cwd 以它的根目录为基准。
	Workspace workspace.Workspace
	// TerminalManager 是本 Session 的命令集合，由 Session 持有。
	TerminalManager terminal.TerminalManager
}

type PatchFileChange struct {
	Path         string
	Kind         PatchFileKind
	AddedLines   int
	DeletedLines int
	// Content 是新增文件的内容，每行以换行结尾；更新和删除为空。
	Content string
	// Sections 是更新文件的各段改动，顺序和补丁一致；新增和删除为空。
	Sections []PatchSection
}

type PatchFileKind string

type PatchSection struct {
	// Header 是补丁里这一段的 "@@" 行（"@@" 或 "@@ <定位文字>"）。
	Header string
	// Lines 是这一段的上下文、删除、新增行，分别以 " "、"-"、"+" 开头，不含换行。
	Lines []string
}

type ReadFileToolOpt struct {
	// Workspace 是读取文件的工作区；相对路径以它的根目录为基准。
	Workspace workspace.Workspace
	// MaxImageBytes 是交给模型的单张图片上限，超过就压缩；必须大于 0。
	MaxImageBytes int
}