@sayknow-cli/coding-agent 0.3.5 → 0.3.6

package/dist/types/extensibility/extensions/types.d.ts

@@ -1,899 +0,0 @@
-/**
- * Extension system types.
- *
- * Extensions are TypeScript modules that can:
- * - Subscribe to agent lifecycle events
- * - Register LLM-callable tools
- * - Register commands, keyboard shortcuts, and CLI flags
- * - Interact with the user via UI primitives
- */
-import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel } from "@sayknow-cli/agent-core";
-import type { CompactionResult } from "@sayknow-cli/agent-core/compaction";
-import type { Api, AssistantMessageEvent, AssistantMessageEventStream, Context, ImageContent, Model, ProviderResponseMetadata, SimpleStreamOptions, Static, TextContent, TSchema } from "@sayknow-cli/ai";
-import type { OAuthCredentials, OAuthLoginCallbacks } from "@sayknow-cli/ai/utils/oauth/types";
-import type * as piCodingAgent from "@sayknow-cli/coding-agent";
-import type { AutocompleteItem, Component, EditorTheme, KeyId, TUI } from "@sayknow-cli/tui";
-import type { KeybindingsManager } from "../../config/keybindings";
-import type { ModelRegistry } from "../../config/model-registry";
-import type { EditToolDetails } from "../../edit";
-import type { PythonResult } from "../../eval/py/executor";
-import type { BashResult } from "../../exec/bash-executor";
-import type { ExecOptions, ExecResult } from "../../exec/exec";
-import type { CustomEditor } from "../../modes/components/custom-editor";
-import type { WorkflowGateEmitter } from "../../modes/shared/agent-wire/unattended-session";
-import type { Theme } from "../../modes/theme/theme";
-import type { CustomMessage } from "../../session/messages";
-import type { ReadonlySessionManager, SessionManager } from "../../session/session-manager";
-import type { BashToolDetails, BashToolInput, FindToolDetails, FindToolInput, ReadToolDetails, ReadToolInput, SearchToolDetails, SearchToolInput, WriteToolInput } from "../../tools";
-import type { EventBus } from "../../utils/event-bus";
-import type { AgentEndEvent, AgentStartEvent, AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, ContextEvent, GoalUpdatedEvent, SessionBeforeBranchEvent, SessionBeforeBranchResult, SessionBeforeCompactEvent, SessionBeforeCompactResult, SessionBeforeSwitchEvent, SessionBeforeSwitchResult, SessionBeforeTreeEvent, SessionBeforeTreeResult, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionCompactingResult, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionSwitchEvent, SessionTreeEvent, TodoReminderEvent, ToolCallEventResult, ToolResultEventResult, TtsrTriggeredEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
-import type { SlashCommandInfo } from "../slash-commands";
-export type { AppKeybinding, KeybindingsManager } from "../../config/keybindings";
-export type { ExecOptions, ExecResult } from "../../exec/exec";
-export type { AgentToolResult, AgentToolUpdateCallback };
-/**
- * UI dialog options for extensions.
- */
-export interface ExtensionUIDialogOptions {
-    signal?: AbortSignal;
-    timeout?: number;
-    /** Invoked when the UI times out while waiting for a selection/input */
-    onTimeout?: () => void;
-    /** Initial cursor position for select dialogs (0-indexed) */
-    initialIndex?: number;
-    /** Render an outlined list for select dialogs */
-    outline?: boolean;
-    /** Invoked when user presses left arrow in select dialogs */
-    onLeft?: () => void;
-    /** Invoked when user presses right arrow in select dialogs */
-    onRight?: () => void;
-    /** Invoked when user presses the external editor shortcut in select dialogs */
-    onExternalEditor?: () => void;
-    /** Optional footer hint text rendered by interactive selector */
-    helpText?: string;
-    /**
-     * For interactive TUI select dialogs, render the focused option across
-     * multiple rows instead of truncating it. This is a select-only rendering
-     * hint; non-TUI bridges (RPC, ACP) drop it and do not serialize it.
-     */
-    wrapFocused?: boolean;
-    /**
-     * For interactive TUI select dialogs, cap the title/prompt area to this
-     * many rows and let PageUp/PageDown scroll that prompt locally. This is a
-     * select-only rendering hint; non-TUI bridges drop it and do not serialize it.
-     */
-    scrollTitleRows?: number;
-    /**
-     * For interactive TUI select dialogs, handle the option with `optionLabel`
-     * inline: selecting it keeps the title and option list on screen and opens
-     * a free-text input below the list. Submitting calls `onSubmit` with the
-     * typed text and resolves the select with `optionLabel`; Escape returns to
-     * option selection. Non-TUI bridges (RPC, ACP) drop it; callers must keep
-     * a fallback path for selects that resolve `optionLabel` without invoking
-     * `onSubmit`.
-     */
-    customInput?: {
-        optionLabel: string;
-        onSubmit: (text: string) => void;
-    };
-}
-/** Raw terminal input listener for extensions. */
-export type TerminalInputHandler = (data: string) => {
-    consume?: boolean;
-    data?: string;
-} | undefined;
-export type WidgetPlacement = "aboveEditor" | "belowEditor";
-export interface ExtensionWidgetOptions {
-    placement?: WidgetPlacement;
-}
-export type ExtensionUiComponent = Component & {
-    dispose?(): void;
-};
-export type ExtensionUiComponentFactory = (tui: TUI, theme: Theme) => ExtensionUiComponent;
-export type ExtensionWidgetContent = string[] | ExtensionUiComponentFactory | undefined;
-/**
- * UI context for extensions to request interactive UI.
- * Each mode (interactive, RPC, print) provides its own implementation.
- */
-export interface ExtensionUIContext {
-    /** Show a selector and return the user's choice. */
-    select(title: string, options: string[], dialogOptions?: ExtensionUIDialogOptions): Promise<string | undefined>;
-    /** Show a confirmation dialog. */
-    confirm(title: string, message: string, dialogOptions?: ExtensionUIDialogOptions): Promise<boolean>;
-    /** Show a text input dialog. */
-    input(title: string, placeholder?: string, dialogOptions?: ExtensionUIDialogOptions): Promise<string | undefined>;
-    /** Show a notification to the user. */
-    notify(message: string, type?: "info" | "warning" | "error"): void;
-    /** Listen to raw terminal input (interactive mode only). Returns an unsubscribe function. */
-    onTerminalInput(handler: TerminalInputHandler): () => void;
-    /** Set status text in the footer/status bar. Pass undefined to clear. */
-    setStatus(key: string, text: string | undefined): void;
-    /** Set the working/loading message shown during streaming. Call with no argument to restore default. */
-    setWorkingMessage(message?: string): void;
-    /** Set a widget to display above or below the editor. Accepts string array or component factory. */
-    setWidget(key: string, content: ExtensionWidgetContent, options?: ExtensionWidgetOptions): void;
-    /** Set a custom footer component, or undefined to restore the built-in footer. */
-    setFooter(factory: ExtensionUiComponentFactory | undefined): void;
-    /** Set a custom header component, or undefined to restore the built-in header. */
-    setHeader(factory: ExtensionUiComponentFactory | undefined): void;
-    /** Set the terminal window/tab title. */
-    setTitle(title: string): void;
-    /** Show a custom component with keyboard focus. */
-    custom<T>(factory: (tui: TUI, theme: Theme, keybindings: KeybindingsManager, done: (result: T) => void) => ExtensionUiComponent | Promise<ExtensionUiComponent>, options?: {
-        overlay?: boolean;
-    }): Promise<T>;
-    /** Set the text in the core input editor. */
-    setEditorText(text: string): void;
-    /**
-     * Paste text into the core input editor.
-     *
-     * Interactive mode should route through the editor's paste handling (e.g. large paste markers).
-     * Non-interactive modes may fall back to replacing the editor text.
-     */
-    pasteToEditor(text: string): void;
-    /** Get the current text from the core input editor. */
-    getEditorText(): string;
-    /** Show a multi-line editor for text editing. */
-    editor(title: string, prefill?: string, dialogOptions?: ExtensionUIDialogOptions, editorOptions?: {
-        promptStyle?: boolean;
-    }): Promise<string | undefined>;
-    /**
-     * Set a custom editor component via factory function, or `undefined` to restore the default editor.
-     *
-     * The factory must return a {@link CustomEditor} subclass. Plain `EditorComponent`/`Editor`
-     * instances do not implement the action-keys, escape callbacks, and custom-key-handler surface
-     * required by interactive mode.
-     */
-    setEditorComponent(factory: ((tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => CustomEditor) | undefined): void;
-    /** Get the current theme for styling. */
-    readonly theme: Theme;
-    /** Get all available themes with names and paths. */
-    getAllThemes(): Promise<{
-        name: string;
-        path: string | undefined;
-    }[]>;
-    /** Load a theme by name without switching to it. */
-    getTheme(name: string): Promise<Theme | undefined>;
-    /** Set the current theme by name or Theme object. */
-    setTheme(theme: string | Theme): Promise<{
-        success: boolean;
-        error?: string;
-    }>;
-    /** Get current tool output expansion state. */
-    getToolsExpanded(): boolean;
-    /** Set tool output expansion state. */
-    setToolsExpanded(expanded: boolean): void;
-}
-export interface ContextUsage {
-    /** Estimated context tokens, or null if unknown (e.g. right after compaction, before next LLM response). */
-    tokens: number | null;
-    contextWindow: number;
-    /** Context usage as percentage of context window, or null if tokens is unknown. */
-    percent: number | null;
-}
-export interface CompactOptions {
-    onComplete?: (result: CompactionResult) => void;
-    onError?: (error: Error) => void;
-}
-/**
- * Context passed to extension event handlers.
- */
-export interface ExtensionContext {
-    /** UI methods for user interaction */
-    ui: ExtensionUIContext;
-    /** Get current context usage for the active model. */
-    getContextUsage(): ContextUsage | undefined;
-    /** Compact the session context (interactive mode shows UI). */
-    compact(instructionsOrOptions?: string | CompactOptions): Promise<void>;
-    /** Whether UI is available (false in print/RPC mode) */
-    hasUI: boolean;
-    /** Current working directory */
-    cwd: string;
-    /** Session manager (read-only) */
-    sessionManager: ReadonlySessionManager;
-    /** Model registry for API key resolution */
-    modelRegistry: ModelRegistry;
-    /** Current model (may be undefined) */
-    model: Model | undefined;
-    /** Whether the agent is idle (not streaming) */
-    isIdle(): boolean;
-    /** Abort the current agent operation */
-    abort(): void;
-    /** Whether there are queued messages waiting */
-    hasPendingMessages(): boolean;
-    /** Gracefully shutdown and exit. */
-    shutdown(): void;
-    /** Get the current effective system prompt. */
-    getSystemPrompt(): string[];
-    /** @deprecated Use hasPendingMessages() instead */
-    hasQueuedMessages(): boolean;
-    /**
-     * Unattended workflow-gate bridge. Present only when the session runs in
-     * unattended/RPC mode; `undefined` in interactive/TUI mode (notify-only).
-     */
-    workflowGate?: WorkflowGateEmitter;
-}
-/**
- * Extended context for command handlers.
- * Includes session control methods only safe in user-initiated commands.
- */
-export interface ExtensionCommandContext extends ExtensionContext {
-    /** Get current context usage for the active model. */
-    getContextUsage(): ContextUsage | undefined;
-    /** Wait for the agent to finish streaming */
-    waitForIdle(): Promise<void>;
-    /** Start a new session, optionally with initialization. */
-    newSession(options?: {
-        parentSession?: string;
-        setup?: (sessionManager: SessionManager) => Promise<void>;
-    }): Promise<{
-        cancelled: boolean;
-    }>;
-    /** Branch from a specific entry, creating a new session file. */
-    branch(entryId: string): Promise<{
-        cancelled: boolean;
-    }>;
-    /** Navigate to a different point in the session tree. */
-    navigateTree(targetId: string, options?: {
-        summarize?: boolean;
-    }): Promise<{
-        cancelled: boolean;
-    }>;
-    /** Switch to a different session file. */
-    switchSession(sessionPath: string): Promise<{
-        cancelled: boolean;
-    }>;
-    /** Reload the current session/runtime state. */
-    reload(): Promise<void>;
-    /** Compact the session context (interactive mode shows UI). */
-    compact(instructionsOrOptions?: string | CompactOptions): Promise<void>;
-}
-/** Rendering options for tool results */
-export interface ToolRenderResultOptions {
-    /** Whether the result view is expanded */
-    expanded: boolean;
-    /** Whether this is a partial/streaming result */
-    isPartial: boolean;
-    /** Current spinner frame index for animated elements (optional) */
-    spinnerFrame?: number;
-}
-/** Session event for tool onSession lifecycle */
-export interface ToolSessionEvent {
-    /** Reason for the session event */
-    reason: "start" | "switch" | "branch" | "tree" | "shutdown";
-    /** Previous session file path, or undefined for "start" and "shutdown" */
-    previousSessionFile: string | undefined;
-}
-/**
- * Tool definition for registerTool().
- */
-export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = unknown> {
-    /** Tool name (used in LLM tool calls) */
-    name: string;
-    /** Human-readable label for UI */
-    label: string;
-    /** Description for LLM */
-    description: string;
-    /** Parameter schema (Zod, or TypeBox for legacy/extension compat). */
-    parameters: TParams;
-    /** Tool scheduling mode; exclusive tools do not run in parallel with other tools in a model turn. */
-    concurrency?: "shared" | "exclusive";
-    /** If true, tool is excluded unless explicitly listed in --tools or agent's tools field */
-    hidden?: boolean;
-    /** If true, tool is registered but not auto-included in the initial active set.
-     *  The registering extension is responsible for activating/deactivating it via setActiveTools(). */
-    defaultInactive?: boolean;
-    /** If true, tool may stage deferred changes that require explicit resolve/discard. */
-    deferrable?: boolean;
-    /** MCP server name for discovery/search metadata when this tool fronts an MCP server. */
-    mcpServerName?: string;
-    /** Original MCP tool name for discovery/search metadata. */
-    mcpToolName?: string;
-    /** Execute the tool. */
-    execute(toolCallId: string, params: Static<TParams>, signal: AbortSignal | undefined, onUpdate: AgentToolUpdateCallback<TDetails> | undefined, ctx: ExtensionContext): Promise<AgentToolResult<TDetails>>;
-    /** Called on session lifecycle events - use to reconstruct state or cleanup resources */
-    onSession?: (event: ToolSessionEvent, ctx: ExtensionContext) => void | Promise<void>;
-    /** Custom rendering for tool call display */
-    renderCall?: (args: Static<TParams>, options: ToolRenderResultOptions, theme: Theme) => Component;
-    /** Custom rendering for tool result display */
-    renderResult?: (result: AgentToolResult<TDetails>, options: ToolRenderResultOptions, theme: Theme, args?: Static<TParams>) => Component;
-}
-/** Fired after session_start to allow extensions to provide additional resource paths. */
-export interface ResourcesDiscoverEvent {
-    type: "resources_discover";
-    cwd: string;
-    reason: "startup" | "reload";
-}
-/** Result from resources_discover event handler */
-export interface ResourcesDiscoverResult {
-    skillPaths?: string[];
-    promptPaths?: string[];
-    themePaths?: string[];
-}
-export type { SessionBeforeBranchEvent, SessionBeforeCompactEvent, SessionBeforeSwitchEvent, SessionBeforeTreeEvent, SessionBranchEvent, SessionCompactEvent, SessionCompactingEvent, SessionEvent, SessionShutdownEvent, SessionStartEvent, SessionSwitchEvent, SessionTreeEvent, TreePreparation, } from "../shared-events";
-export type { ContextEvent } from "../shared-events";
-/** Fired before a provider request is sent. Can replace the payload. */
-export interface BeforeProviderRequestEvent {
-    type: "before_provider_request";
-    payload: unknown;
-}
-/** Fired after a provider response is received, before its stream body is consumed. */
-export interface AfterProviderResponseEvent extends ProviderResponseMetadata {
-    type: "after_provider_response";
-}
-/** Fired after user submits prompt but before agent loop. */
-export interface BeforeAgentStartEvent {
-    type: "before_agent_start";
-    prompt: string;
-    images?: ImageContent[];
-    systemPrompt: string[];
-}
-export type { AgentEndEvent, AgentStartEvent, TurnEndEvent, TurnStartEvent } from "../shared-events";
-/** Fired when a message starts (user, assistant, or toolResult) */
-export interface MessageStartEvent {
-    type: "message_start";
-    message: AgentMessage;
-}
-/** Fired during assistant message streaming with token-by-token updates */
-export interface MessageUpdateEvent {
-    type: "message_update";
-    message: AgentMessage;
-    assistantMessageEvent: AssistantMessageEvent;
-}
-/** Fired when a message ends */
-export interface MessageEndEvent {
-    type: "message_end";
-    message: AgentMessage;
-}
-/** Fired when a tool starts executing */
-export interface ToolExecutionStartEvent {
-    type: "tool_execution_start";
-    toolCallId: string;
-    toolName: string;
-    args: unknown;
-    intent?: string;
-}
-/** Fired during tool execution with partial/streaming output */
-export interface ToolExecutionUpdateEvent {
-    type: "tool_execution_update";
-    toolCallId: string;
-    toolName: string;
-    args: unknown;
-    partialResult: unknown;
-}
-/** Fired when a tool finishes executing */
-export interface ToolExecutionEndEvent {
-    type: "tool_execution_end";
-    toolCallId: string;
-    toolName: string;
-    result: unknown;
-    isError: boolean;
-}
-export type { AutoCompactionEndEvent, AutoCompactionStartEvent, AutoRetryEndEvent, AutoRetryStartEvent, TodoReminderEvent, TtsrTriggeredEvent, } from "../shared-events";
-/** Fired when AuthStorage automatically soft-disables a credential (e.g. OAuth `invalid_grant`). Not fired for user-initiated `remove()` or duplicate-credential dedup. */
-export interface CredentialDisabledEvent {
-    type: "credential_disabled";
-    /** Provider id whose credential was disabled (e.g. "anthropic"). */
-    provider: string;
-    /** Verbatim error captured for forensics (truncated upstream). */
-    disabledCause: string;
-}
-/** Fired when user executes a bash command via ! or !! prefix */
-export interface UserBashEvent {
-    type: "user_bash";
-    /** The command to execute */
-    command: string;
-    /** True if !! prefix was used (excluded from LLM context) */
-    excludeFromContext: boolean;
-    /** Current working directory */
-    cwd: string;
-}
-/** Fired when user executes Python code via $ or $$ prefix */
-export interface UserPythonEvent {
-    type: "user_python";
-    /** The Python code to execute */
-    code: string;
-    /** True if $$ prefix was used (excluded from LLM context) */
-    excludeFromContext: boolean;
-    /** Current working directory */
-    cwd: string;
-}
-/** Fired when the user submits input (interactive mode only). */
-export interface InputEvent {
-    type: "input";
-    text: string;
-    images?: ImageContent[];
-    source: "interactive" | "rpc" | "extension";
-}
-interface ToolCallEventBase {
-    type: "tool_call";
-    toolCallId: string;
-}
-export interface BashToolCallEvent extends ToolCallEventBase {
-    toolName: "bash";
-    input: BashToolInput;
-}
-export interface ReadToolCallEvent extends ToolCallEventBase {
-    toolName: "read";
-    input: ReadToolInput;
-}
-export interface EditToolCallEvent extends ToolCallEventBase {
-    toolName: "edit";
-    input: Record<string, unknown>;
-}
-export interface WriteToolCallEvent extends ToolCallEventBase {
-    toolName: "write";
-    input: WriteToolInput;
-}
-export interface SearchToolCallEvent extends ToolCallEventBase {
-    toolName: "search";
-    input: SearchToolInput;
-}
-export interface FindToolCallEvent extends ToolCallEventBase {
-    toolName: "find";
-    input: FindToolInput;
-}
-export interface CustomToolCallEvent extends ToolCallEventBase {
-    toolName: string;
-    input: Record<string, unknown>;
-}
-/** Fired before a tool executes. Can block. */
-export type ToolCallEvent = BashToolCallEvent | ReadToolCallEvent | EditToolCallEvent | WriteToolCallEvent | SearchToolCallEvent | FindToolCallEvent | CustomToolCallEvent;
-interface ToolResultEventBase {
-    type: "tool_result";
-    toolCallId: string;
-    input: Record<string, unknown>;
-    content: (TextContent | ImageContent)[];
-    isError: boolean;
-}
-export interface BashToolResultEvent extends ToolResultEventBase {
-    toolName: "bash";
-    details: BashToolDetails | undefined;
-}
-export interface ReadToolResultEvent extends ToolResultEventBase {
-    toolName: "read";
-    details: ReadToolDetails | undefined;
-}
-export interface EditToolResultEvent extends ToolResultEventBase {
-    toolName: "edit";
-    details: EditToolDetails | undefined;
-}
-export interface WriteToolResultEvent extends ToolResultEventBase {
-    toolName: "write";
-    details: undefined;
-}
-export interface SearchToolResultEvent extends ToolResultEventBase {
-    toolName: "search";
-    details: SearchToolDetails | undefined;
-}
-export interface FindToolResultEvent extends ToolResultEventBase {
-    toolName: "find";
-    details: FindToolDetails | undefined;
-}
-export interface CustomToolResultEvent extends ToolResultEventBase {
-    toolName: string;
-    details: unknown;
-}
-/** Fired after a tool executes. Can modify result. */
-export type ToolResultEvent = BashToolResultEvent | ReadToolResultEvent | EditToolResultEvent | WriteToolResultEvent | SearchToolResultEvent | FindToolResultEvent | CustomToolResultEvent;
-/**
- * Type guard for narrowing ToolCallEvent by tool name.
- *
- * Built-in tools narrow automatically (no type params needed):
- * ```ts
- * if (isToolCallEventType("bash", event)) {
- *   event.input.command;  // string
- * }
- * ```
- *
- * Custom tools require explicit type parameters:
- * ```ts
- * if (isToolCallEventType<"my_tool", MyToolInput>("my_tool", event)) {
- *   event.input.action;  // typed
- * }
- * ```
- *
- * Note: Direct narrowing via `event.toolName === "bash"` doesn't work because
- * CustomToolCallEvent.toolName is `string` which overlaps with all literals.
- */
-export declare function isToolCallEventType(toolName: "bash", event: ToolCallEvent): event is BashToolCallEvent;
-export declare function isToolCallEventType(toolName: "read", event: ToolCallEvent): event is ReadToolCallEvent;
-export declare function isToolCallEventType(toolName: "edit", event: ToolCallEvent): event is EditToolCallEvent;
-export declare function isToolCallEventType(toolName: "write", event: ToolCallEvent): event is WriteToolCallEvent;
-export declare function isToolCallEventType(toolName: "search", event: ToolCallEvent): event is SearchToolCallEvent;
-export declare function isToolCallEventType(toolName: "find", event: ToolCallEvent): event is FindToolCallEvent;
-export declare function isToolCallEventType<TName extends string, TInput extends Record<string, unknown>>(toolName: TName, event: ToolCallEvent): event is ToolCallEvent & {
-    toolName: TName;
-    input: TInput;
-};
-/** Union of all event types */
-export type ExtensionEvent = ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | AutoCompactionStartEvent | AutoCompactionEndEvent | AutoRetryStartEvent | AutoRetryEndEvent | TtsrTriggeredEvent | TodoReminderEvent | GoalUpdatedEvent | CredentialDisabledEvent | UserBashEvent | UserPythonEvent | InputEvent | ToolCallEvent | ToolResultEvent;
-export interface ContextEventResult {
-    messages?: AgentMessage[];
-}
-export type BeforeProviderRequestEventResult = unknown;
-export type { ToolCallEventResult } from "../shared-events";
-/** Result from input event handler */
-export interface InputEventResult {
-    /** If true, the input was handled and should not continue through normal flow */
-    handled?: boolean;
-    /** Replace the input text */
-    text?: string;
-    /** Replace any pending images */
-    images?: ImageContent[];
-}
-/** Result from user_bash event handler */
-export interface UserBashEventResult {
-    /** Full replacement: extension handled execution, use this result */
-    result?: BashResult;
-}
-/** Result from user_python event handler */
-export interface UserPythonEventResult {
-    /** Full replacement: extension handled execution, use this result */
-    result?: PythonResult;
-}
-export type { ToolResultEventResult } from "../shared-events";
-export interface BeforeAgentStartEventResult {
-    message?: Pick<CustomMessage, "customType" | "content" | "display" | "details" | "attribution">;
-    /** Replace the system prompt for this turn. If multiple extensions return this, they are chained. */
-    systemPrompt?: string[];
-}
-export type { SessionBeforeBranchResult, SessionBeforeCompactResult, SessionBeforeSwitchResult, SessionBeforeTreeResult, SessionCompactingResult, } from "../shared-events";
-export interface MessageRenderOptions {
-    expanded: boolean;
-}
-export type MessageRenderer<T = unknown> = (message: CustomMessage<T>, options: MessageRenderOptions, theme: Theme) => Component | undefined;
-export interface RegisteredCommand {
-    name: string;
-    description?: string;
-    getArgumentCompletions?: (argumentPrefix: string) => AutocompleteItem[] | null;
-    handler: (args: string, ctx: ExtensionCommandContext) => Promise<void>;
-}
-/** Handler function type for events */
-export type ExtensionHandler<E, R = undefined> = (event: E, ctx: ExtensionContext) => Promise<R | void> | R | void;
-/**
- * ExtensionAPI passed to extension factory functions.
- */
-export interface ExtensionAPI {
-    /** File logger for error/warning/debug messages */
-    logger: typeof import("@sayknow-cli/utils").logger;
-    /** Injected zod-backed typebox shim for legacy `Type.Object(...)` parameter authoring. */
-    typebox: typeof import("../typebox");
-    /** Injected zod module for Zod-authored extension tools (canonical going forward). */
-    zod: typeof import("zod/v4");
-    /** Injected sayknow-cli exports for accessing SDK utilities */
-    pi: typeof piCodingAgent;
-    on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
-    on(event: "session_start", handler: ExtensionHandler<SessionStartEvent>): void;
-    on(event: "session_before_switch", handler: ExtensionHandler<SessionBeforeSwitchEvent, SessionBeforeSwitchResult>): void;
-    on(event: "session_switch", handler: ExtensionHandler<SessionSwitchEvent>): void;
-    on(event: "session_before_branch", handler: ExtensionHandler<SessionBeforeBranchEvent, SessionBeforeBranchResult>): void;
-    on(event: "session_branch", handler: ExtensionHandler<SessionBranchEvent>): void;
-    on(event: "session_before_compact", handler: ExtensionHandler<SessionBeforeCompactEvent, SessionBeforeCompactResult>): void;
-    on(event: "session.compacting", handler: ExtensionHandler<SessionCompactingEvent, SessionCompactingResult>): void;
-    on(event: "session_compact", handler: ExtensionHandler<SessionCompactEvent>): void;
-    on(event: "session_shutdown", handler: ExtensionHandler<SessionShutdownEvent>): void;
-    on(event: "session_before_tree", handler: ExtensionHandler<SessionBeforeTreeEvent, SessionBeforeTreeResult>): void;
-    on(event: "session_tree", handler: ExtensionHandler<SessionTreeEvent>): void;
-    on(event: "context", handler: ExtensionHandler<ContextEvent, ContextEventResult>): void;
-    on(event: "before_provider_request", handler: ExtensionHandler<BeforeProviderRequestEvent, BeforeProviderRequestEventResult>): void;
-    on(event: "after_provider_response", handler: ExtensionHandler<AfterProviderResponseEvent>): void;
-    on(event: "before_agent_start", handler: ExtensionHandler<BeforeAgentStartEvent, BeforeAgentStartEventResult>): void;
-    on(event: "agent_start", handler: ExtensionHandler<AgentStartEvent>): void;
-    on(event: "agent_end", handler: ExtensionHandler<AgentEndEvent>): void;
-    on(event: "turn_start", handler: ExtensionHandler<TurnStartEvent>): void;
-    on(event: "turn_end", handler: ExtensionHandler<TurnEndEvent>): void;
-    on(event: "message_start", handler: ExtensionHandler<MessageStartEvent>): void;
-    on(event: "message_update", handler: ExtensionHandler<MessageUpdateEvent>): void;
-    on(event: "message_end", handler: ExtensionHandler<MessageEndEvent>): void;
-    on(event: "tool_execution_start", handler: ExtensionHandler<ToolExecutionStartEvent>): void;
-    on(event: "tool_execution_update", handler: ExtensionHandler<ToolExecutionUpdateEvent>): void;
-    on(event: "tool_execution_end", handler: ExtensionHandler<ToolExecutionEndEvent>): void;
-    on(event: "auto_compaction_start", handler: ExtensionHandler<AutoCompactionStartEvent>): void;
-    on(event: "auto_compaction_end", handler: ExtensionHandler<AutoCompactionEndEvent>): void;
-    on(event: "auto_retry_start", handler: ExtensionHandler<AutoRetryStartEvent>): void;
-    on(event: "auto_retry_end", handler: ExtensionHandler<AutoRetryEndEvent>): void;
-    on(event: "ttsr_triggered", handler: ExtensionHandler<TtsrTriggeredEvent>): void;
-    on(event: "todo_reminder", handler: ExtensionHandler<TodoReminderEvent>): void;
-    on(event: "goal_updated", handler: ExtensionHandler<GoalUpdatedEvent>): void;
-    on(event: "credential_disabled", handler: ExtensionHandler<CredentialDisabledEvent>): void;
-    on(event: "input", handler: ExtensionHandler<InputEvent, InputEventResult>): void;
-    on(event: "tool_call", handler: ExtensionHandler<ToolCallEvent, ToolCallEventResult>): void;
-    on(event: "tool_result", handler: ExtensionHandler<ToolResultEvent, ToolResultEventResult>): void;
-    on(event: "user_bash", handler: ExtensionHandler<UserBashEvent, UserBashEventResult>): void;
-    on(event: "user_python", handler: ExtensionHandler<UserPythonEvent, UserPythonEventResult>): void;
-    /** Register a tool that the LLM can call. */
-    registerTool<TParams extends TSchema = TSchema, TDetails = unknown>(tool: ToolDefinition<TParams, TDetails>): void;
-    /** Register a custom command. */
-    registerCommand(name: string, options: {
-        description?: string;
-        getArgumentCompletions?: RegisteredCommand["getArgumentCompletions"];
-        handler: RegisteredCommand["handler"];
-    }): void;
-    /** Register a keyboard shortcut. */
-    registerShortcut(shortcut: KeyId, options: {
-        description?: string;
-        handler: (ctx: ExtensionContext) => Promise<void> | void;
-    }): void;
-    /** Register a CLI flag. */
-    registerFlag(name: string, options: {
-        description?: string;
-        type: "boolean" | "string";
-        default?: boolean | string;
-    }): void;
-    /** Set the display label for this extension, or set a label on a specific entry. */
-    setLabel(entryIdOrLabel: string, label?: string | undefined): void;
-    /** Get the value of a registered CLI flag. */
-    getFlag(name: string): boolean | string | undefined;
-    /** Register a custom renderer for CustomMessageEntry. */
-    registerMessageRenderer<T = unknown>(customType: string, renderer: MessageRenderer<T>): void;
-    /**
-     * Send a custom message to the session.
-     *
-     * `deliverAs: "nextTurn"` keeps the message hidden from the editable pending-message UI.
-     * If `triggerTurn` is also true while the current turn is still unwinding, the session schedules
-     * an internal continuation that consumes the message on the next turn.
-     */
-    sendMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details" | "attribution">, options?: {
-        triggerTurn?: boolean;
-        deliverAs?: "steer" | "followUp" | "nextTurn";
-    }): void;
-    /** Send a user message to the agent, or queue it when deliverAs is set. */
-    sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
-        deliverAs?: "steer" | "followUp";
-    }): void;
-    /** Append a custom entry to the session for state persistence (not sent to LLM). */
-    appendEntry<T = unknown>(customType: string, data?: T): void;
-    /** Execute a shell command. */
-    exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
-    /** Get the list of currently active tool names. */
-    getActiveTools(): string[];
-    /** Get all configured tools (built-in + extension tools). */
-    getAllTools(): string[];
-    /** Set the active tools by name. */
-    setActiveTools(toolNames: string[]): Promise<void>;
-    /** Get available slash commands in the current session. */
-    getCommands(): SlashCommandInfo[];
-    /** Set the current model. Returns false if no API key available. */
-    setModel(model: Model): Promise<boolean>;
-    /** Get current thinking level. */
-    getThinkingLevel(): ThinkingLevel | undefined;
-    /** Set thinking level for the current session. */
-    setThinkingLevel(level: ThinkingLevel): void;
-    /** Get the current session name. */
-    getSessionName(): string | undefined;
-    /** Set the session name. Persists to the session file. */
-    setSessionName(name: string): Promise<void>;
-    /**
-     * Register or override a model provider.
-     *
-     * If `models` is provided: replaces all existing models for this provider.
-     * If only `baseUrl` is provided: overrides the URL for existing models.
-     * If `streamSimple` is provided: registers a custom API stream handler.
-     *
-     * @example
-     * // Register a new provider with custom models and streaming
-     * pi.registerProvider("google-vertex-Anthropic model", {
-     *   baseUrl: "https://us-east5-aiplatform.googleapis.com",
-     *   apiKey: "GOOGLE_CLOUD_PROJECT",
-     *   api: "vertex-Anthropic model-api",
-     *   streamSimple: myStreamFunction,
-     *   models: [
-     *     {
-     *       id: "Anthropic model-sonnet-4@20250514",
-     *       name: "Anthropic model Sonnet 4 (Vertex)",
-     *       reasoning: true,
-     *       thinking: { mode: "anthropic-adaptive", minLevel: "minimal", maxLevel: "high" },
-     *       input: ["text", "image"],
-     *       cost: { input: 3, output: 15, cacheRead: 0.3, cacheWrite: 3.75 },
-     *       contextWindow: 200000,
-     *       maxTokens: 64000,
-     *   ]
-     * });
-     *
-     * @example
-     * // Override baseUrl for an existing provider
-     * pi.registerProvider("anthropic", {
-     *   baseUrl: "https://proxy.example.com"
-     * });
-     */
-    registerProvider(name: string, config: ProviderConfig): void;
-    /** Shared event bus for extension communication. */
-    events: EventBus;
-}
-/** Configuration for registering a provider via pi.registerProvider(). */
-export interface ProviderConfig {
-    /** Base URL for the API endpoint. Required when defining models. */
-    baseUrl?: string;
-    /** API key or environment variable name. Required when defining models unless oauth is provided. */
-    apiKey?: string;
-    /** API type identifier. Required when registering streamSimple or when models don't specify one. */
-    api?: Api;
-    /** Custom streaming function for non-built-in APIs. */
-    streamSimple?: (model: Model<Api>, context: Context, options?: SimpleStreamOptions) => AssistantMessageEventStream;
-    /** Custom headers to include in requests. */
-    headers?: Record<string, string>;
-    /** If true, adds Authorization: Bearer header with the resolved API key. */
-    authHeader?: boolean;
-    /** Models to register. If provided, replaces all existing models for this provider. */
-    models?: ProviderModelConfig[];
-    /** OAuth provider for /login support. */
-    oauth?: {
-        /** Display name in login UI. */
-        name: string;
-        /** Run the provider login flow and return credentials (or a plain API key) to persist. */
-        login(callbacks: OAuthLoginCallbacks): Promise<OAuthCredentials | string>;
-        /** Refresh expired credentials. */
-        refreshToken?(credentials: OAuthCredentials): Promise<OAuthCredentials>;
-        /** Convert credentials to an API key string for requests. */
-        getApiKey?(credentials: OAuthCredentials): string;
-        /** Optional model rewrite hook for credential-aware routing (e.g., enterprise URLs). */
-        modifyModels?(models: Model<Api>[], credentials: OAuthCredentials): Model<Api>[];
-    };
-}
-/** Configuration for a model within a provider. */
-export interface ProviderModelConfig {
-    /** Model ID (e.g., "Anthropic model-sonnet-4@20250514"). */
-    id: string;
-    /** Display name (e.g., "Anthropic model Sonnet 4 (Vertex)"). */
-    name: string;
-    /** API type override for this model. */
-    api?: Api;
-    /** Whether the model supports extended thinking at all. */
-    reasoning: boolean;
-    /** Optional canonical thinking capability metadata for per-model effort support. */
-    thinking?: Model["thinking"];
-    /** Supported input types. */
-    input: ("text" | "image")[];
-    /** Cost per million tokens. */
-    cost: {
-        input: number;
-        output: number;
-        cacheRead: number;
-        cacheWrite: number;
-    };
-    /** Premium Copilot requests charged per user-initiated request. */
-    premiumMultiplier?: number;
-    /** Maximum context window size in tokens. */
-    contextWindow: number;
-    /** Maximum output tokens. */
-    maxTokens: number;
-    /** Custom headers for this model. */
-    headers?: Record<string, string>;
-    /** OpenAI compatibility settings. */
-    compat?: Model<Api>["compat"];
-}
-/** Extension factory function type. Supports both sync and async initialization. */
-export type ExtensionFactory = (pi: ExtensionAPI) => void | Promise<void>;
-export interface RegisteredTool<TParams extends TSchema = TSchema, TDetails = unknown> {
-    definition: ToolDefinition<TParams, TDetails>;
-    extensionPath: string;
-}
-export interface ExtensionFlag {
-    name: string;
-    description?: string;
-    type: "boolean" | "string";
-    default?: boolean | string;
-    extensionPath: string;
-}
-export interface ExtensionShortcut {
-    shortcut: KeyId;
-    description?: string;
-    handler: (ctx: ExtensionContext) => Promise<void> | void;
-    extensionPath: string;
-}
-type HandlerFn = (...args: unknown[]) => Promise<unknown>;
-export type SendMessageHandler = <T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details" | "attribution">, 
-/**
- * `deliverAs: "nextTurn"` queues hidden custom context for the next turn.
- * When paired with `triggerTurn: true` during prompt teardown, the session schedules
- * an internal continuation without surfacing the message in the editable pending queue.
- */
-options?: {
-    triggerTurn?: boolean;
-    deliverAs?: "steer" | "followUp" | "nextTurn";
-}) => void;
-export type SendUserMessageHandler = (content: string | (TextContent | ImageContent)[], options?: {
-    deliverAs?: "steer" | "followUp";
-}) => void;
-export type AppendEntryHandler = <T = unknown>(customType: string, data?: T) => void;
-export type GetActiveToolsHandler = () => string[];
-export type GetAllToolsHandler = () => string[];
-export type GetCommandsHandler = () => SlashCommandInfo[];
-export type SetActiveToolsHandler = (toolNames: string[]) => Promise<void>;
-export type SetModelHandler = (model: Model) => Promise<boolean>;
-export type GetThinkingLevelHandler = () => ThinkingLevel | undefined;
-export type SetThinkingLevelHandler = (level: ThinkingLevel, persist?: boolean) => void;
-/** Shared state created by loader, used during registration and runtime. */
-export interface ExtensionRuntimeState {
-    flagValues: Map<string, boolean | string>;
-    /** Provider registrations queued during extension loading, processed during session initialization */
-    pendingProviderRegistrations: Array<{
-        name: string;
-        config: ProviderConfig;
-        sourceId: string;
-    }>;
-}
-/** Action implementations for ExtensionAPI methods. */
-export interface ExtensionActions {
-    sendMessage: SendMessageHandler;
-    sendUserMessage: SendUserMessageHandler;
-    appendEntry: AppendEntryHandler;
-    setLabel: (targetId: string, label: string | undefined) => void;
-    getActiveTools: GetActiveToolsHandler;
-    getAllTools: GetAllToolsHandler;
-    setActiveTools: SetActiveToolsHandler;
-    getCommands: GetCommandsHandler;
-    setModel: SetModelHandler;
-    getThinkingLevel: GetThinkingLevelHandler;
-    setThinkingLevel: SetThinkingLevelHandler;
-    getSessionName: () => string | undefined;
-    setSessionName: (name: string) => Promise<void>;
-}
-/** Actions for ExtensionContext (ctx.* in event handlers). */
-export interface ExtensionContextActions {
-    getModel: () => Model | undefined;
-    isIdle: () => boolean;
-    abort: () => void;
-    hasPendingMessages: () => boolean;
-    shutdown: () => void;
-    getContextUsage: () => ContextUsage | undefined;
-    compact: (instructionsOrOptions?: string | CompactOptions) => Promise<void>;
-    getSystemPrompt: () => string[];
-    /** Unattended workflow-gate bridge (present only in unattended/RPC mode). */
-    getWorkflowGate?: () => WorkflowGateEmitter | undefined;
-}
-/** Actions for ExtensionCommandContext (ctx.* in command handlers). */
-export interface ExtensionCommandContextActions {
-    getContextUsage: () => ContextUsage | undefined;
-    waitForIdle: () => Promise<void>;
-    newSession: (options?: {
-        parentSession?: string;
-        setup?: (sessionManager: SessionManager) => Promise<void>;
-    }) => Promise<{
-        cancelled: boolean;
-    }>;
-    branch: (entryId: string) => Promise<{
-        cancelled: boolean;
-    }>;
-    navigateTree: (targetId: string, options?: {
-        summarize?: boolean;
-    }) => Promise<{
-        cancelled: boolean;
-    }>;
-    compact: (instructionsOrOptions?: string | CompactOptions) => Promise<void>;
-    switchSession: (sessionPath: string) => Promise<{
-        cancelled: boolean;
-    }>;
-    reload: () => Promise<void>;
-}
-/** Full runtime = state + actions. */
-export interface ExtensionRuntime extends ExtensionRuntimeState, ExtensionActions {
-}
-/** Loaded extension with all registered items. */
-export interface Extension {
-    path: string;
-    resolvedPath: string;
-    label?: string;
-    handlers: Map<string, HandlerFn[]>;
-    tools: Map<string, RegisteredTool<any, any>>;
-    messageRenderers: Map<string, MessageRenderer>;
-    commands: Map<string, RegisteredCommand>;
-    flags: Map<string, ExtensionFlag>;
-    shortcuts: Map<KeyId, ExtensionShortcut>;
-}
-/** Result of loading extensions. */
-export interface LoadExtensionsResult {
-    extensions: Extension[];
-    errors: Array<{
-        path: string;
-        error: string;
-    }>;
-    runtime: ExtensionRuntime;
-}
-export interface ExtensionError {
-    extensionPath: string;
-    event: string;
-    error: string;
-    stack?: string;
-}