smart_guide

type AgentConfig struct {
	SmartGuideConfig *SmartGuideConfig
	// HTTP endpoint configuration (resolved from TBClient by caller)
	BaseURL      string // e.g., "http://localhost:12580/tingly/_smart_guide"
	APIKey       string // Tingly-box authentication token
	ToolExecutor *ToolExecutor
	// SmartGuide model configuration (required from bot setting)
	Provider string // Provider UUID
	Model    string // Model identifier
	// Callback functions for internal tools
	GetStatusFunc     func(chatID string) (*StatusInfo, error)
	GetProjectFunc    func(chatID string) (string, bool, error)
	UpdateProjectFunc func(chatID string, projectPath string) error // Updates project path in chat store

	// Approval context for non-allowlisted commands
	Handler  agentboot.MessageHandler // Message handler for approval requests
	ChatID   string                   // Chat ID for approval routing
	Platform string                   // Platform identifier
	BotUUID  string                   // Bot UUID for routing

	// ToolContext for injecting file send capability and cross-path approval.
	// If nil, send_file tool will not be registered.
	ToolCtx *ToolContext
}

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

type ApprovalCallback func(ctx context.Context, req ApprovalRequest) (approved bool, err error)

type ApprovalRequest struct {
	Command string   // Command to execute
	Args    []string // Command arguments
	Reason  string   // Reason for approval request
}

type BashParams struct {
	Command string `json:"command" required:"true" jsonschema:"description=The bash command to execute (e.g., 'ls -la', 'git status')"`
}

type BashTool struct {
	Executor        *ToolExecutor
	AllowedCommands []string
}

type ChangeDirParams struct {
	Path   string `json:"path" jsonschema:"description=The directory path to change to (absolute or relative to current directory)"`
	ChatID string `json:"chat_id,omitempty" jsonschema:"description=(internal) Chat ID for persistence"`
}

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

type GetStatusParams struct {
	ChatID string `json:"chat_id,omitempty" jsonschema:"description=Chat ID to get status for"`
}

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

type HandoffManager struct {
}

type HandoffParams struct{}

type HandoffResult struct {
	Success   bool   `json:"success"`
	FromAgent string `json:"from_agent"`
	ToAgent   string `json:"to_agent"`
	Message   string `json:"message"`
	NextHint  string `json:"next_hint"`
	Error     string `json:"error,omitempty"`
}

type HandoffState struct {
	FromAgent        string    `json:"from_agent"`
	ToAgent          string    `json:"to_agent"`
	Timestamp        time.Time `json:"timestamp"`
	ProjectPath      string    `json:"project_path"`
	SessionID        string    `json:"session_id"`
	ChatID           string    `json:"chat_id"`
	PreservedContext []byte    `json:"preserved_context,omitempty"`
}

type HandoffToCCTool struct{}

type ModelConfig struct {
	Provider string `json:"provider"` // "openai", "anthropic", etc.
	Model    string `json:"model"`
	APIKey   string `json:"api_key"`
	BaseURL  string `json:"base_url,omitempty"`
}

type SendFileParams struct {
	FilePath string `json:"file_path" jsonschema:"description=Path to the local file to send (absolute or relative to working directory)"`
	Caption  string `json:"caption,omitempty" jsonschema:"description=Optional caption or message to accompany the file"`
}

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

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

type SmartGuideConfig struct {
	// Enabled determines if smart guide is active
	Enabled bool `json:"enabled"`

	// SystemPrompt is the custom system prompt (optional)
	SystemPrompt string `json:"system_prompt,omitempty"`

	// MaxIterations is the maximum number of tool use iterations
	MaxIterations int `json:"max_iterations"`

	// Temperature for LLM responses
	Temperature float64 `json:"temperature"`

	// ToolsEnabled maps tool names to enabled state
	ToolsEnabled map[string]bool `json:"tools_enabled"`

	// HandoffCommands are the commands that trigger handoff
	HandoffCommands []string `json:"handoff_commands"`

	// Model configuration
	Model ModelConfig `json:"model"`

	// SessionTimeout is how long to remember context
	SessionTimeout time.Duration `json:"session_timeout"`
}

type StatusInfo struct {
	CurrentAgent   string `json:"current_agent"`
	SessionID      string `json:"session_id"`
	ProjectPath    string `json:"project_path"`
	WorkingDir     string `json:"working_dir"`
	HasRunningTask bool   `json:"has_running_task"`
	Whitelisted    bool   `json:"whitelisted"`
}

type TinglyBoxAgent struct {
	*agent.ReActAgent
	// contains filtered or unexported fields
}

type ToolContext struct {
	ChatID      string
	ProjectPath string
	SessionID   string

	// SendFile sends a local file to the user via the IM bot.
	// Injected by the bot layer; nil if file sending is not available.
	SendFile func(ctx context.Context, filePath, caption string) error

	// RequestApproval requests explicit user approval for sensitive operations
	// (e.g. sending files outside the project path). This callback must NOT be
	// bypassed by yolo mode — it is distinct from the bash approval callback.
	// Returns (false, nil) if denied. Returns (false, err) on failure.
	RequestApproval func(ctx context.Context, prompt string) (approved bool, err error)
}

type ToolExecutor struct {
	BashAllowlist map[string]struct{}
	BashCwd       string // Per-execution working directory
	// contains filtered or unexported fields
}