smart_guide

type AgentConfig struct {
	SmartGuideConfig *SmartGuideConfig
	ToolExecutor     *ToolExecutor

	// HTTP endpoint configuration (resolved from TBClient by caller).
	BaseURL string
	APIKey  string
	Model   string

	// 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

	// Approval context for non-allowlisted commands.
	Approver Approver
	ChatID   string
	Platform string
	BotUUID  string

	// ToolContext for file send capability and cross-path approval. If nil,
	// the send_file tool is not registered.
	ToolCtx *ToolContext

	// SessionLog is the chat's append-only conversation log. When set, the run
	// is checkpointed to it as each step completes, so an interrupted turn keeps
	// the work it already did. Nil disables mid-run persistence.
	SessionLog afk.Log
}

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 Approver interface {
	OnApproval(ctx context.Context, req agentboot.ApprovalRequestEvent) (agentboot.ApprovalResponse, error)
}

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

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

type CompletionResult struct {
	Success    bool
	DurationMS int64
	SessionID  string
	Error      string
}

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

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

type HandoffManager 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 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 ReadFileTool struct {
	// contains filtered or unexported fields
}

type SendFileParams struct {
	FilePath string `json:"file_path"`
	Caption  string `json:"caption,omitempty"`
}

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"`

	// Thinking selects the model's reasoning mode: "" (the model's own
	// default), "visible", "hidden", or "off". See afk.ThinkingMode.
	//
	// "visible" is what makes @tb render 💭 lines: reasoning only comes back
	// with content when it is asked for explicitly, and the streaming layer
	// shows it in verbose mode.
	Thinking string `json:"thinking,omitempty"`

	// Effort is how hard the model works on a turn: "" (the model's own
	// default), "low", "medium", "high", "xhigh", or "max". See
	// afk.EffortLevel. Separate axis from Thinking — that one is whether the
	// model reasons, this one is how much it spends overall.
	Effort string `json:"effort,omitempty"`

	// 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 StreamHandler interface {
	OnMessage(msg any) error
	OnError(err error)
	OnComplete(result *CompletionResult)
}

type TinglyBoxAgent struct {
	// 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
}

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