tools

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

type Property struct {
	Type        string    `json:"type"`
	Description string    `json:"description,omitempty"`
	Enum        []string  `json:"enum,omitempty"`
	Items       *Property `json:"items,omitempty"`
}

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

type Schema struct {
	Type       string               `json:"type"`
	Required   []string             `json:"required,omitempty"`
	Properties map[string]*Property `json:"properties,omitempty"`
}

type Tool interface {
	Name() string
	Description() string
	InputSchema() Schema
	Execute(ctx context.Context, input json.RawMessage) (string, error)
}

type ToolContext struct {
	// RunID 是本次 agent 运行的唯一标识。
	RunID string
	// TraceID 是跨服务关联的分布式追踪标识。
	TraceID string
	// AssistantPublicID 是执行本次运行的助手public_id。
	AssistantPublicID string
	// UserID 是发起本次运行的人类用户标识。
	UserID string
	// AccountID 是租户或组织账号标识。
	AccountID string
	// Channel 是接收请求的交互渠道（如 "github"、"slack"）。
	Channel string
	// ConversationID 是本次运行所属的会话标识。
	ConversationID string
	// ExternalID 是外部渠道中的发起者标识。
	ExternalID string
	// WorkNodeID 是执行本次运行时的工作节点标识。
	WorkNodeID string
	// WorkDir 是本次运行隔离工作区的绝对路径。
	WorkDir string
	// Metadata carries typed workspace data needed by business tools.
	Metadata ToolMetadata
}

type ToolMetadata struct {
	RepoDir              string
	ArtifactManifestPath string
	// SkillDir is the explicit per-run Skill catalog root. Tools must not fall
	// back to the worker-wide directory when this is set.
	SkillDir string
}

type Validator interface {
	Validate(input json.RawMessage) error
}