app

func (*App) AvailableModels ¶ added in v1.19.0

func (a *App) AvailableModels(ctx context.Context) []runtime.ModelChoice

AvailableModels returns the list of models available for selection. Returns nil if model switching is not supported.

func (*App) CompactSession ¶ added in v1.6.0

func (a *App) CompactSession(additionalPrompt string)

func (*App) CurrentAgentCommands ¶ added in v1.8.2

func (a *App) CurrentAgentCommands(ctx context.Context) types.Commands

CurrentAgentCommands returns the commands for the active agent

func (*App) CurrentMCPPrompts ¶ added in v1.8.2

func (a *App) CurrentMCPPrompts(ctx context.Context) map[string]mcptools.PromptInfo

CurrentMCPPrompts returns the available MCP prompts for the active agent

func (*App) EmitStartupInfo ¶ added in v1.8.2

func (a *App) EmitStartupInfo(ctx context.Context, events chan runtime.Event)

EmitStartupInfo emits initial agent, team, and toolset information to the provided channel

func (*App) ExecuteMCPPrompt ¶ added in v1.8.2

func (a *App) ExecuteMCPPrompt(ctx context.Context, promptName string, arguments map[string]string) (string, error)

ExecuteMCPPrompt executes an MCP prompt with provided arguments and returns the content

func (*App) ExportHTML ¶ added in v1.18.6

func (a *App) ExportHTML(filename string) (string, error)

ExportHTML exports the current session as a standalone HTML file. If filename is empty, a default name based on the session title and timestamp is used.

func (*App) FirstMessage ¶

func (a *App) FirstMessage() *string

func (*App) FirstMessageAttachment ¶ added in v1.8.2

func (a *App) FirstMessageAttachment() string

FirstMessageAttachment returns the attachment path for the first message.

func (*App) NewSession ¶ added in v1.6.0

func (a *App) NewSession()

func (*App) PlainTextTranscript ¶ added in v1.8.2

func (a *App) PlainTextTranscript() string

func (*App) ReplaceSession ¶ added in v1.8.2

func (a *App) ReplaceSession(ctx context.Context, sess *session.Session)

ReplaceSession replaces the current session with the given session. This is used when loading a past session. It also re-emits startup info so the sidebar displays the agent and tool information. If the session has stored model overrides, they are applied to the runtime.

func (*App) ResolveCommand ¶ added in v1.8.2

func (a *App) ResolveCommand(ctx context.Context, userInput string) string

ResolveCommand converts /command to its prompt text

func (*App) Resume ¶

func (a *App) Resume(resumeType runtime.ResumeType)

Resume resumes the runtime with the given confirmation type

func (*App) ResumeElicitation ¶ added in v1.8.2

func (a *App) ResumeElicitation(ctx context.Context, action tools.ElicitationAction, content map[string]any) error

ResumeElicitation resumes an elicitation request with the given action and content

func (*App) Run ¶

func (a *App) Run(ctx context.Context, cancel context.CancelFunc, message string, attachments map[string]string)

Run one agent loop

func (*App) RunBangCommand ¶ added in v1.8.0

func (a *App) RunBangCommand(ctx context.Context, command string)

func (*App) RunWithMessage ¶ added in v1.8.2

func (a *App) RunWithMessage(ctx context.Context, cancel context.CancelFunc, msg *session.Message)

RunWithMessage runs the agent loop with a pre-constructed message. This is used for special cases like image attachments.

func (*App) Runtime ¶ added in v1.8.2

func (a *App) Runtime() runtime.Runtime

Runtime returns the runtime for this app.

func (*App) Session ¶ added in v1.8.2

func (a *App) Session() *session.Session

func (*App) SessionStore ¶ added in v1.8.2

func (a *App) SessionStore() session.Store

SessionStore returns the session store for browsing/loading sessions. Returns nil if no session store is configured.

func (*App) SetCurrentAgentModel ¶ added in v1.19.0

func (a *App) SetCurrentAgentModel(ctx context.Context, modelRef string) error

SetCurrentAgentModel sets the model for the current agent and persists the override in the session. Returns an error if model switching is not supported by the runtime (e.g., remote runtimes). Pass an empty modelRef to clear the override and use the agent's default model.

func (*App) Subscribe ¶

func (a *App) Subscribe(ctx context.Context, program *tea.Program)

func (*App) SupportsModelSwitching ¶ added in v1.19.0

func (a *App) SupportsModelSwitching() bool

SupportsModelSwitching returns true if the runtime supports model switching.

func (*App) SwitchAgent ¶ added in v1.8.2

func (a *App) SwitchAgent(agentName string) error

SwitchAgent switches the currently active agent for subsequent user messages