conversation

type Delivery string

type Event interface{ Event() }

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

type MessageAccepted struct {
	ID       string
	Text     string
	Images   []llm.ImageContent
	Files    []engine.File
	Delivery Delivery
	Queued   bool
}

type MessageCancelled struct{ ID string }

type MessageDequeued struct{ ID string }

type NewTransport func(sessionID string) Transport

type Options struct {
	DataDir        string
	Usage          *usage.Store
	Workspaces     *workspace.Registry
	NewTransport   NewTransport
	TitleGenerator titlegen.Generator
}

type QueuedMessage struct {
	ID       string
	Delivery Delivery
	Text     string
	Images   []llm.ImageContent
	Files    []engine.AttachedFile
}

type RunFailed struct{ Text string }

type Snapshot struct {
	History         []engine.HistoryItem
	Queue           []Event
	ContextUsage    engine.ContextUsage
	Tasks           []engine.BackgroundTask
	Running         bool
	Title           string
	AITitle         string
	CustomTitle     string
	TitleGeneration TitleGeneration
}

type Summary struct {
	ID              string                 `json:"id"`
	Title           string                 `json:"title"`
	AITitle         string                 `json:"aiTitle,omitempty"`
	CustomTitle     string                 `json:"customTitle,omitempty"`
	TitleGeneration TitleGeneration        `json:"titleGeneration"`
	WorkspacePath   string                 `json:"workspacePath"`
	WorkspaceName   string                 `json:"workspaceName"`
	Scope           string                 `json:"scope"`
	WorkspaceKind   string                 `json:"workspaceKind"`
	CreatedAt       time.Time              `json:"createdAt"`
	UpdatedAt       time.Time              `json:"updatedAt"`
	Running         bool                   `json:"running"`
	HasApproval     bool                   `json:"hasApproval"`
	HasQuestion     bool                   `json:"hasQuestion"`
	ModelProvider   string                 `json:"modelProvider"`
	ModelID         string                 `json:"modelId"`
	ModelName       string                 `json:"modelName"`
	ThinkingLevel   llm.ModelThinkingLevel `json:"thinkingLevel"`
	PermissionMode  permission.Mode        `json:"permissionMode"`
}

type TitleChanged struct {
	Title       string
	AITitle     string
	CustomTitle string
}

type TitleGeneration struct {
	Status      TitleGenerationStatus `json:"status"`
	Provider    string                `json:"provider,omitempty"`
	Model       string                `json:"model,omitempty"`
	ErrorCode   string                `json:"errorCode,omitempty"`
	Error       string                `json:"error,omitempty"`
	AttemptedAt string                `json:"attemptedAt,omitempty"`
}

type TitleGenerationChanged struct{ Generation TitleGeneration }

type TitleGenerationStatus string

type Transport interface {
	// Publish delivers a state change this session raised.
	Publish(Event)
	// PublishAgent delivers an event raised by the agent underneath.
	PublishAgent(engine.Event)
	// Decide gates one tool call, blocking until answered or cancelled.
	Decide(context.Context, permission.ApprovalRequest) (permission.ApprovalResponse, error)
	// HasPendingApproval reports a gate still waiting on a viewer.
	HasPendingApproval() bool
	// OpenBrowser delivers one validated agent navigation and waits for the
	// viewer's product shell to report its terminal result.
	OpenBrowser(context.Context, tools.BrowserRequest) (tools.BrowserResult, error)
	// Ask puts the agent's multiple-choice questions to the viewer and blocks
	// until they answer or the run is cancelled.
	Ask(context.Context, []tools.Question) ([]tools.Answer, error)
	// HasPendingQuestion reports a question still waiting on a viewer.
	HasPendingQuestion() bool
	// Close releases the delivery link after its session is removed.
	Close()
}