tools

type AgentDispatchReply struct {
	TaskID  string
	AgentID string
	Status  string
	Result  string
	Run     RunRecord
	Error   *RuntimeError
}

type AgentDispatchRequest struct {
	Task            string
	RunKind         string
	AgentID         string
	Decision        *DispatchDecision
	Target          *TargetRef
	Origin          *OriginRef
	ExecutionPolicy *ExecutionPolicy
	WorldDecision   *WorldDecisionContext
}

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

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

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

type AgentMessage struct {
	MessageID string `json:"message_id"`
	ThreadID  string `json:"thread_id"`
	FromAgent string `json:"from_agent"`
	ToAgent   string `json:"to_agent"`
	Type      string `json:"type"`
	Content   string `json:"content"`
	Status    string `json:"status"`
	CreatedAt int64  `json:"created_at"`
}

type AgentProfile struct {
	AgentID         string   `json:"agent_id"`
	Name            string   `json:"name"`
	Kind            string   `json:"kind,omitempty"`
	Transport       string   `json:"transport,omitempty"`
	NodeID          string   `json:"node_id,omitempty"`
	ParentAgentID   string   `json:"parent_agent_id,omitempty"`
	Role            string   `json:"role,omitempty"`
	Persona         string   `json:"persona,omitempty"`
	Traits          []string `json:"traits,omitempty"`
	Faction         string   `json:"faction,omitempty"`
	HomeLocation    string   `json:"home_location,omitempty"`
	DefaultGoals    []string `json:"default_goals,omitempty"`
	PerceptionScope int      `json:"perception_scope,omitempty"`
	ScheduleHint    string   `json:"schedule_hint,omitempty"`
	WorldTags       []string `json:"world_tags,omitempty"`
	PromptFile      string   `json:"prompt_file,omitempty"`
	ToolAllowlist   []string `json:"tool_allowlist,omitempty"`
	MemoryNamespace string   `json:"memory_namespace,omitempty"`
	MaxRetries      int      `json:"max_retries,omitempty"`
	RetryBackoff    int      `json:"retry_backoff_ms,omitempty"`
	TimeoutSec      int      `json:"timeout_sec,omitempty"`
	MaxTaskChars    int      `json:"max_task_chars,omitempty"`
	MaxResultChars  int      `json:"max_result_chars,omitempty"`
	Status          string   `json:"status"`
	CreatedAt       int64    `json:"created_at"`
	UpdatedAt       int64    `json:"updated_at"`
	ManagedBy       string   `json:"managed_by,omitempty"`
}

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

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

type AgentRunEvent struct {
	RunID      string `json:"run_id"`
	AgentID    string `json:"agent_id,omitempty"`
	Type       string `json:"type"`
	Status     string `json:"status,omitempty"`
	Message    string `json:"message,omitempty"`
	RetryCount int    `json:"retry_count,omitempty"`
	At         int64  `json:"ts"`
}

type AgentRunFunc func(ctx context.Context, task *AgentTask) (string, error)

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

type AgentSpawnOptions struct {
	Task            string
	RunKind         string
	Role            string
	AgentID         string
	Target          *TargetRef
	ExecutionPolicy *ExecutionPolicy
	Origin          *OriginRef
	WorldDecision   *WorldDecisionContext
}

type AgentTask struct {
	ID              string                `json:"id"`
	Task            string                `json:"task"`
	RunKind         string                `json:"run_kind,omitempty"`
	AgentID         string                `json:"agent_id"`
	Target          *TargetRef            `json:"target,omitempty"`
	ExecutionPolicy *ExecutionPolicy      `json:"execution_policy,omitempty"`
	RetryCount      int                   `json:"retry_count,omitempty"`
	WorldDecision   *WorldDecisionContext `json:"world_decision,omitempty"`
	Origin          *OriginRef            `json:"origin,omitempty"`
	Status          string                `json:"status"`
	Result          string                `json:"result,omitempty"`
	Created         int64                 `json:"created"`
	Updated         int64                 `json:"updated"`
}

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

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

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

type CatalogTool interface {
	CatalogEntry() map[string]interface{}
}

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

type DispatchDecision struct {
	TargetAgent string  `json:"target_agent,omitempty"`
	Reason      string  `json:"reason,omitempty"`
	Confidence  float64 `json:"confidence,omitempty"`
	TaskText    string  `json:"task_text,omitempty"`
	RouteSource string  `json:"route_source,omitempty"`
}

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

type EventRecord struct {
	ID         string        `json:"id,omitempty"`
	RunID      string        `json:"run_id,omitempty"`
	TaskID     string        `json:"task_id,omitempty"`
	AgentID    string        `json:"agent_id,omitempty"`
	Type       string        `json:"type"`
	Status     string        `json:"status,omitempty"`
	Message    string        `json:"message,omitempty"`
	RetryCount int           `json:"retry_count,omitempty"`
	Error      *RuntimeError `json:"error,omitempty"`
	At         int64         `json:"ts"`
}

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

type ExecutionPolicy struct {
	PromptFile     string   `json:"prompt_file,omitempty"`
	ToolAllowlist  []string `json:"tool_allowlist,omitempty"`
	MaxRetries     int      `json:"max_retries,omitempty"`
	RetryBackoff   int      `json:"retry_backoff,omitempty"`
	TimeoutSec     int      `json:"timeout_sec,omitempty"`
	MaxTaskChars   int      `json:"max_task_chars,omitempty"`
	MaxResultChars int      `json:"max_result_chars,omitempty"`
}

type ExecutionRun struct {
	Run      RunRecord        `json:"run"`
	Task     TaskRecord       `json:"task"`
	Decision DispatchDecision `json:"decision,omitempty"`
}

type FunctionCall struct {
	Name      string `json:"name"`
	Arguments string `json:"arguments"`
}

type LLMProvider interface {
	Chat(ctx context.Context, messages []Message, tools []ToolDefinition, model string, options map[string]interface{}) (*LLMResponse, error)
	GetDefaultModel() string
}

type LLMResponse struct {
	Content      string     `json:"content"`
	ToolCalls    []ToolCall `json:"tool_calls,omitempty"`
	FinishReason string     `json:"finish_reason"`
	Usage        *UsageInfo `json:"usage,omitempty"`
}

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

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

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

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

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

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

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

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

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

type OriginRef struct {
	Channel string `json:"channel,omitempty"`
	ChatID  string `json:"chat_id,omitempty"`
}

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

type ParallelSafeTool interface {
	ParallelSafe() bool
}

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

type ProcessEvent struct {
	Type      string    `json:"type"`
	SessionID string    `json:"session_id"`
	Command   string    `json:"command,omitempty"`
	At        time.Time `json:"at"`
	ExitCode  *int      `json:"exit_code,omitempty"`
}

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

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

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

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

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

type ResourceScopedTool interface {
	ResourceKeys(args map[string]interface{}) []string
}

type RunRecord struct {
	ID        string        `json:"id"`
	TaskID    string        `json:"task_id,omitempty"`
	AgentID   string        `json:"agent_id,omitempty"`
	Kind      string        `json:"kind,omitempty"`
	Status    string        `json:"status"`
	Input     string        `json:"input,omitempty"`
	Output    string        `json:"output,omitempty"`
	Error     *RuntimeError `json:"error,omitempty"`
	CreatedAt int64         `json:"created_at"`
	UpdatedAt int64         `json:"updated_at"`
}

type RuntimeError struct {
	Code      string `json:"code,omitempty"`
	Message   string `json:"message,omitempty"`
	Stage     string `json:"stage,omitempty"`
	Retryable bool   `json:"retryable,omitempty"`
	Source    string `json:"source,omitempty"`
}

type RuntimeSnapshot struct {
	Tasks  []TaskRecord  `json:"tasks,omitempty"`
	Runs   []RunRecord   `json:"runs,omitempty"`
	Events []EventRecord `json:"events,omitempty"`
	World  interface{}   `json:"world,omitempty"`
}

type SendCallback func(channel, chatID, action, content, media, messageID, emoji string, buttons [][]bus.Button) error

type SessionInfo struct {
	Key             string
	Kind            string
	Summary         string
	CompactionCount int
	UpdatedAt       time.Time
}

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

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

type SystemInfoTool struct{}

type TargetRef struct {
	Transport     string `json:"transport,omitempty"`
	NodeID        string `json:"node_id,omitempty"`
	ParentAgentID string `json:"parent_agent_id,omitempty"`
}

type TaskRecord struct {
	ID           string `json:"id"`
	OwnerAgentID string `json:"owner_agent_id,omitempty"`
	Status       string `json:"status"`
	Input        string `json:"input,omitempty"`
	Origin       string `json:"origin,omitempty"`
	CreatedAt    int64  `json:"created_at"`
	UpdatedAt    int64  `json:"updated_at"`
}

type Tool interface {
	Name() string
	Description() string
	Parameters() map[string]interface{}
	Execute(ctx context.Context, args map[string]interface{}) (string, error)
}

type ToolAllowlistGroup struct {
	Name        string   `json:"name"`
	Description string   `json:"description"`
	Aliases     []string `json:"aliases,omitempty"`
	Tools       []string `json:"tools"`
}

type ToolCall struct {
	ID        string                 `json:"id"`
	Type      string                 `json:"type"`
	Function  *FunctionCall          `json:"function,omitempty"`
	Name      string                 `json:"name,omitempty"`
	Arguments map[string]interface{} `json:"arguments,omitempty"`
}

type ToolDefinition struct {
	Type     string                 `json:"type"`
	Function ToolFunctionDefinition `json:"function"`
}

type ToolFunctionDefinition struct {
	Name        string                 `json:"name"`
	Description string                 `json:"description"`
	Parameters  map[string]interface{} `json:"parameters"`
}

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

type UsageInfo struct {
	PromptTokens     int `json:"prompt_tokens"`
	CompletionTokens int `json:"completion_tokens"`
	TotalTokens      int `json:"total_tokens"`
}

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

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

type WorldDecisionContext struct {
	WorldTick           int64                    `json:"world_tick,omitempty"`
	WorldSnapshot       map[string]interface{}   `json:"world_snapshot,omitempty"`
	NPCSnapshot         map[string]interface{}   `json:"npc_snapshot,omitempty"`
	VisibleEvents       []map[string]interface{} `json:"visible_events,omitempty"`
	IntentSchemaVersion string                   `json:"intent_schema_version,omitempty"`
}

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

type WorldToolRuntime interface {
	Snapshot(limit int) (interface{}, error)
	Tick(ctx context.Context, source string) (string, error)
	NPCList() ([]map[string]interface{}, error)
	NPCGet(id string) (map[string]interface{}, bool, error)
	EntityList() ([]map[string]interface{}, error)
	EntityGet(id string) (map[string]interface{}, bool, error)
	UpdateEntity(ctx context.Context, args map[string]interface{}) (map[string]interface{}, error)
	UpdateLocation(ctx context.Context, args map[string]interface{}) (map[string]interface{}, error)
	UpdateRoom(ctx context.Context, args map[string]interface{}) (map[string]interface{}, error)
	WorldGet() (map[string]interface{}, error)
	EventLog(limit int) ([]map[string]interface{}, error)
	CreateNPC(ctx context.Context, args map[string]interface{}) (map[string]interface{}, error)
	CreateEntity(ctx context.Context, args map[string]interface{}) (map[string]interface{}, error)
	QuestList() ([]map[string]interface{}, error)
	QuestGet(id string) (map[string]interface{}, bool, error)
	CreateQuest(ctx context.Context, args map[string]interface{}) (map[string]interface{}, error)
}

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