@sayknow-cli/coding-agent 0.3.12 → 0.3.15

package/dist/types/goals/tools/goal-tool.d.ts

@@ -7,12 +7,12 @@ import type { ToolSession } from "../../tools";
 import type { Goal, GoalToolDetails } from "../state";
 declare const goalSchema: z.ZodObject<{
     op: z.ZodEnum<{
-        complete: "complete";
         create: "create";
-        drop: "drop";
         get: "get";
-        pause: "pause";
+        complete: "complete";
         resume: "resume";
+        drop: "drop";
+        pause: "pause";
     }>;
     objective: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -29,12 +29,12 @@ export declare class GoalTool implements AgentTool<typeof goalSchema, GoalToolDe
     readonly description: string;
     readonly parameters: z.ZodObject<{
         op: z.ZodEnum<{
-            complete: "complete";
             create: "create";
-            drop: "drop";
             get: "get";
-            pause: "pause";
+            complete: "complete";
             resume: "resume";
+            drop: "drop";
+            pause: "pause";
         }>;
         objective: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;

package/dist/types/i18n/messages/en.d.ts

@@ -1,15 +1,15 @@
 export declare const en: {
     readonly "lang.auto": "Auto (system)";
     readonly "lang.en": "English";
-    readonly "lang.ko": "\uD55C\uAD6D\uC5B4";
-    readonly "lang.zh": "\u4E2D\u6587 (\u7B80\u4F53)";
-    readonly "lang.ja": "\u65E5\u672C\u8A9E";
-    readonly "lang.es": "Espa\u00F1ol";
-    readonly "lang.fr": "Fran\u00E7ais";
+    readonly "lang.ko": "한국어";
+    readonly "lang.zh": "中文 (简体)";
+    readonly "lang.ja": "日本語";
+    readonly "lang.es": "Español";
+    readonly "lang.fr": "Français";
     readonly "lang.de": "Deutsch";
     readonly "welcome.tagline": "Coding should feel like thinking.";
     readonly "welcome.workflows": "Workflows";
-    readonly "welcome.wf.deepInterview": "scope \u00B7 interview \u2192 spec";
+    readonly "welcome.wf.deepInterview": "scope · interview → spec";
     readonly "welcome.wf.ralplan": "consensus plan";
     readonly "welcome.wf.ultragoal": "autonomous build";
     readonly "welcome.wf.team": "parallel agents";
@@ -26,7 +26,7 @@ export declare const en: {
     readonly "welcome.sessionTrail": "Session trail";
     readonly "welcome.noSessions": "No saved trails";
     readonly "welcome.chooseModel": "choose a model";
-    readonly "welcome.modelHint": "ctrl+l to pick \u00B7 / for commands";
+    readonly "welcome.modelHint": "ctrl+l to pick · / for commands";
     readonly "settings.tab.appearance": "Appearance";
     readonly "settings.tab.model": "Model";
     readonly "settings.tab.interaction": "Interaction";
@@ -46,7 +46,7 @@ export declare const en: {
     readonly "help.envVars": "ENVIRONMENT VARIABLES";
     readonly "help.tools": "AVAILABLE TOOLS";
     readonly "help.usefulCommands": "USEFUL COMMANDS";
-    readonly "help.appDescription": "Sayknow-CLI \u2014 an AI coding assistant";
+    readonly "help.appDescription": "Sayknow-CLI — an AI coding assistant";
     readonly "statusline.plan": "Plan";
     readonly "statusline.goal": "Goal";
     readonly "statusline.paused": "paused";

package/dist/types/internal-urls/local-protocol.d.ts

@@ -17,22 +17,26 @@ export declare class LocalProtocolHandler implements ProtocolHandler {
     readonly scheme = "local";
     readonly immutable = false;
     /**
-     * Install a process-global override that wins over the AgentRegistry-based
-     * derivation. Used by SDK consumers that wire `localProtocolOptions` on
-     * `createAgentSession` and by subagents that share their parent's root.
+     * Install an explicit local-protocol mapping owned by the caller.
+     *
+     * The most recently installed live mapping wins. The returned disposer removes
+     * only this registration and is safe to call more than once.
+     */
+    static installOverride(value: LocalProtocolOptions): () => void;
+    /**
+     * Install a process-global test override that wins over owned and registry
+     * mappings. Prefer {@link installOverride} for lifecycle-bound production use.
      */
     static setOverride(value: LocalProtocolOptions | undefined): void;
-    /** Reset the process-global override. Test-only. */
+    /** Reset all process-global local-protocol overrides. Test-only. */
     static resetOverrideForTests(): void;
     /**
      * Returns the active local-protocol options.
      *
      * Resolution order:
-     * 1. Explicit override installed via {@link setOverride} (used by subagents
-     *    that share their parent's root and by SDK consumers with a custom
-     *    artifacts/session id mapping).
-     * 2. The main session in `AgentRegistry.global()`. Its `SessionManager`
-     *    supplies both `getArtifactsDir` and `getSessionId`.
+     * 1. Direct test override installed via {@link setOverride}.
+     * 2. The most recently installed live owned override.
+     * 3. A live main session in `AgentRegistry.global()`.
      */
     static resolveOptions(): LocalProtocolOptions | undefined;
     resolve(url: InternalUrl): Promise<InternalResource>;

package/dist/types/lsp/index.d.ts

@@ -95,20 +95,20 @@ export declare class LspTool implements AgentTool<typeof lspSchema, LspToolDetai
     readonly description: string;
     readonly parameters: import("zod").ZodObject<{
         action: import("zod").ZodEnum<{
-            capabilities: "capabilities";
-            code_actions: "code_actions";
-            definition: "definition";
+            status: "status";
             diagnostics: "diagnostics";
-            hover: "hover";
-            implementation: "implementation";
+            definition: "definition";
             references: "references";
-            reload: "reload";
+            hover: "hover";
+            symbols: "symbols";
             rename: "rename";
             rename_file: "rename_file";
-            request: "request";
-            status: "status";
-            symbols: "symbols";
+            code_actions: "code_actions";
             type_definition: "type_definition";
+            implementation: "implementation";
+            reload: "reload";
+            capabilities: "capabilities";
+            request: "request";
         }>;
         file: import("zod").ZodOptional<import("zod").ZodString>;
         line: import("zod").ZodOptional<import("zod").ZodNumber>;

package/dist/types/lsp/types.d.ts

@@ -3,20 +3,20 @@ import * as z from "zod/v4";
 import type { OwnedProcess } from "../runtime/process-lifecycle";
 export declare const lspSchema: z.ZodObject<{
     action: z.ZodEnum<{
-        capabilities: "capabilities";
-        code_actions: "code_actions";
-        definition: "definition";
+        status: "status";
         diagnostics: "diagnostics";
-        hover: "hover";
-        implementation: "implementation";
+        definition: "definition";
         references: "references";
-        reload: "reload";
+        hover: "hover";
+        symbols: "symbols";
         rename: "rename";
         rename_file: "rename_file";
-        request: "request";
-        status: "status";
-        symbols: "symbols";
+        code_actions: "code_actions";
         type_definition: "type_definition";
+        implementation: "implementation";
+        reload: "reload";
+        capabilities: "capabilities";
+        request: "request";
     }>;
     file: z.ZodOptional<z.ZodString>;
     line: z.ZodOptional<z.ZodNumber>;

package/dist/types/main.d.ts

@@ -4,15 +4,39 @@
  * This file handles CLI argument parsing and translates them into
  * createAgentSession() options. The SDK does the heavy lifting.
  */
+import type { ImageContent } from "@sayknow-cli/ai";
 import type { Args } from "./cli/args";
 import { ModelRegistry } from "./config/model-registry";
 import { Settings } from "./config/settings";
+import type { ExtensionUIContext } from "./extensibility/extensions/types";
+import type { SessionSelectionResult } from "./modes/components/session-selector";
 import type { InteractiveMode } from "./modes/interactive-mode";
+import type { PrintModeOptions } from "./modes/print-mode";
+import { initTheme } from "./modes/theme/theme";
 import type { SubmittedUserInput } from "./modes/types";
+import type { MCPManager } from "./runtime-mcp";
 import { type CreateAgentSessionOptions, type CreateAgentSessionResult, createAgentSession, discoverAuthStorage } from "./sdk";
 import type { AgentSession } from "./session/agent-session";
 import type { AuthStorage } from "./session/auth-storage";
-import { SessionManager } from "./session/session-manager";
+import { type ResumeSessionIdentity, type SessionInfo, SessionManager, type StrictSessionOpenResult } from "./session/session-manager";
+import { runStartupCredentialAutoImportIfNeeded } from "./setup/credential-auto-import";
+import type { LspStartupServerInfo } from "./tools";
+import type { EventBus } from "./utils/event-bus";
+export type StartupUpdateRoute = "interactive" | "print" | "text" | "json" | "rpc" | "rpc-ui" | "acp" | "bridge";
+export declare function classifyStartupUpdateRoute(parsed: Pick<Args, "print" | "mode">, autoPrint: boolean): StartupUpdateRoute;
+/** Coordinates the non-blocking update check around the interactive UI lifecycle. */
+export declare class StartupUpdateOrchestrator {
+    #private;
+    constructor(route: StartupUpdateRoute, enabled: () => boolean, check: () => Promise<string | undefined>);
+    startBeforeInteractiveInitialization(): void;
+    attachAfterInteractiveInitialization(notify: (version: string) => void): void;
+}
+export interface StartupUpdateInteractiveMode {
+    init: () => Promise<void>;
+    showNewVersionNotification: (version: string) => void;
+}
+export declare function initializeInteractiveModeWithStartupUpdate(mode: StartupUpdateInteractiveMode, startupUpdate: StartupUpdateOrchestrator): Promise<void>;
+declare function readPipedInput(): Promise<string | undefined>;
 export interface InteractiveModeNotify {
     kind: "warn" | "error" | "info";
     message: string;
@@ -52,6 +76,25 @@ export declare function applyStartupModelProfilesOrExit(args: Parameters<typeof
  * tool registry and shadow the client-supplied servers (issue #1234).
  */
 export declare function createAcpSessionFactory(args: AcpSessionFactoryOptions): AcpSessionFactory;
+interface InteractiveModeFactoryOptions {
+    session: AgentSession;
+    version: string;
+    changelogMarkdown: string | undefined;
+    setExtensionUIContext: (uiContext: ExtensionUIContext, hasUI: boolean) => void;
+    lspServers: LspStartupServerInfo[] | undefined;
+    mcpManager: MCPManager | undefined;
+    eventBus?: EventBus;
+}
+type CreateInteractiveMode = (options: InteractiveModeFactoryOptions) => InteractiveMode;
+type ResumePickerTerminalCheck = () => boolean;
+type ListForResumePickerReadOnly = (cwd: string, sessionDir?: string) => Promise<SessionInfo[]>;
+type SelectResumeSession = (sessions: SessionInfo[]) => Promise<SessionSelectionResult>;
+type OpenExistingSessionStrict = (identity: ResumeSessionIdentity, sessionDir?: string) => Promise<StrictSessionOpenResult>;
+export declare const BARE_RESUME_CONFLICT_ERROR = "--resume without a session cannot be combined with --continue, --fork, or --no-session.";
+export declare const BARE_RESUME_INTERACTIVE_ERROR = "--resume requires an interactive terminal; use --resume <id>.";
+export declare const BARE_RESUME_OPEN_ERROR = "Could not open the selected session. Use --resume <id>.";
+export declare function runInteractiveMode(session: AgentSession, version: string, changelogMarkdown: string | undefined, notifs: (InteractiveModeNotify | null)[], startupUpdate: StartupUpdateOrchestrator, initialMessages: string[], setExtensionUIContext: (uiContext: ExtensionUIContext, hasUI: boolean) => void, lspServers: LspStartupServerInfo[] | undefined, mcpManager: MCPManager | undefined, eventBus?: EventBus, initialMessage?: string, initialImages?: ImageContent[], createInteractiveMode?: CreateInteractiveMode, resumeAction?: "continue-tail" | "open-idle"): Promise<void>;
+declare function getChangelogForDisplay(parsed: Args): Promise<string | undefined>;
 export declare function createSessionManager(parsed: Args, cwd: string, activeSettings?: Settings): Promise<SessionManager | undefined>;
 /**
  * Research-mode (RLM) preset hook. Lets `skc rlm` augment the session options
@@ -62,13 +105,34 @@ export interface RlmPreset {
     applyOptions: (options: CreateAgentSessionOptions, settings: Settings) => void;
     onSessionCreated?: (session: AgentSession) => void | Promise<void>;
 }
-interface RunRootCommandDependencies {
+type RunRpcMode = (session: AgentSession, setToolUIContext?: CreateAgentSessionResult["setToolUIContext"], options?: {
+    listen?: string;
+}) => Promise<void>;
+type RunBridgeMode = (session: AgentSession, setToolUIContext?: CreateAgentSessionResult["setToolUIContext"]) => Promise<void>;
+type RunPrintMode = (session: AgentSession, options: PrintModeOptions) => Promise<void>;
+export interface RunRootCommandDependencies {
     createAgentSession?: typeof createAgentSession;
     discoverAuthStorage?: typeof discoverAuthStorage;
     runAcpMode?: (createSession: AcpSessionFactory) => Promise<void>;
     settings?: Settings;
     rlmPreset?: RlmPreset;
     suppressProcessExit?: boolean;
+    startupUpdate?: {
+        check: () => Promise<string | undefined>;
+    };
+    initTheme?: typeof initTheme;
+    readPipedInput?: typeof readPipedInput;
+    runStartupCredentialAutoImportIfNeeded?: typeof runStartupCredentialAutoImportIfNeeded;
+    getChangelogForDisplay?: typeof getChangelogForDisplay;
+    runRpcMode?: RunRpcMode;
+    runBridgeMode?: RunBridgeMode;
+    createInteractiveMode?: CreateInteractiveMode;
+    runPrintMode?: RunPrintMode;
+    isResumePickerTerminal?: ResumePickerTerminalCheck;
+    listForResumePickerReadOnly?: ListForResumePickerReadOnly;
+    selectResumeSession?: SelectResumeSession;
+    openExistingSessionStrict?: OpenExistingSessionStrict;
+    initializeSettings?: typeof Settings.init;
 }
 export declare function runRootCommand(parsed: Args, rawArgs: string[], deps?: RunRootCommandDependencies): Promise<void>;
 export declare function main(args: string[]): Promise<void>;

package/dist/types/modes/acp/acp-agent.d.ts

@@ -1,4 +1,4 @@
-import { type Agent, type AgentSideConnection, type AuthenticateRequest, type AuthenticateResponse, type ClientCapabilities, type CloseSessionRequest, type CloseSessionResponse, type ForkSessionRequest, type ForkSessionResponse, type InitializeRequest, type InitializeResponse, type ListSessionsRequest, type ListSessionsResponse, type LoadSessionRequest, type LoadSessionResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type ResumeSessionRequest, type ResumeSessionResponse, type SetSessionConfigOptionRequest, type SetSessionConfigOptionResponse, type SetSessionModelRequest, type SetSessionModelResponse, type SetSessionModeRequest, type SetSessionModeResponse } from "@agentclientprotocol/sdk";
+import { type Agent, type AgentSideConnection, type AuthenticateRequest, type AuthenticateResponse, type ClientCapabilities, type CloseSessionRequest, type CloseSessionResponse, type DeleteSessionRequest, type DeleteSessionResponse, type ForkSessionRequest, type ForkSessionResponse, type InitializeRequest, type InitializeResponse, type ListSessionsRequest, type ListSessionsResponse, type LoadSessionRequest, type LoadSessionResponse, type NewSessionRequest, type NewSessionResponse, type PromptRequest, type PromptResponse, type ResumeSessionRequest, type ResumeSessionResponse, type SetSessionConfigOptionRequest, type SetSessionConfigOptionResponse, type SetSessionModeRequest, type SetSessionModeResponse } from "@agentclientprotocol/sdk";
 import type { ExtensionUIContext } from "../../extensibility/extensions";
 import type { AgentSession } from "../../session/agent-session";
 /**
@@ -40,9 +40,20 @@ export declare class AcpAgent implements Agent {
     resumeSession(params: ResumeSessionRequest): Promise<ResumeSessionResponse>;
     unstable_forkSession(params: ForkSessionRequest): Promise<ForkSessionResponse>;
     closeSession(params: CloseSessionRequest): Promise<CloseSessionResponse>;
+    /**
+     * Hard delete an ACP session. `DeleteSessionRequest` carries only `sessionId`;
+     * the server owns authorization through the immutable canonical cwd scope and
+     * the complete strict scoped inventory snapshot.
+     *
+     * - No scope / unknown / already-deleted id → lookup-free `{}`.
+     * - Duplicate/conflict id → visible error; neither transcript nor artifacts change.
+     * - Active session → reserve `deleting`, drain/cancel prompt, flush, strict
+     *   dispose/close, recheck identity/state, then verified artifact-first deletion.
+     * - Concurrent delete callers join the terminal promise.
+     */
+    deleteSession(params: DeleteSessionRequest): Promise<DeleteSessionResponse>;
     setSessionMode(params: SetSessionModeRequest): Promise<SetSessionModeResponse>;
     setSessionConfigOption(params: SetSessionConfigOptionRequest): Promise<SetSessionConfigOptionResponse>;
-    unstable_setSessionModel(params: SetSessionModelRequest): Promise<SetSessionModelResponse>;
     prompt(params: PromptRequest): Promise<PromptResponse>;
     cancel(params: {
         sessionId: string;
@@ -57,5 +68,11 @@ export declare class AcpAgent implements Agent {
     }): Promise<void>;
     get signal(): AbortSignal;
     get closed(): Promise<void>;
+    /**
+     * Connection-local shutdown promise. Resolves once all terminal work (dispose,
+     * active deletes, abort cleanup) has settled. `acp-mode.ts` awaits this after
+     * transport closure so `process.exit` never kills in-flight deletion/disposal.
+     */
+    get shutdownPromise(): Promise<void>;
 }
 export {};

package/dist/types/modes/acp/acp-mode.d.ts

@@ -1,5 +1,17 @@
 import { AgentSideConnection, type Stream } from "@agentclientprotocol/sdk";
 import type { AgentSession } from "../../session/agent-session";
+import { AcpAgent } from "./acp-agent";
 export type AcpSessionFactory = (cwd: string) => Promise<AgentSession>;
+export interface AcpConnectionHandle {
+    connection: AgentSideConnection;
+    agent: AcpAgent;
+}
 export declare function createAcpConnection(transport: Stream, createSession: AcpSessionFactory, initialSession?: AgentSession): AgentSideConnection;
+/**
+ * Create an ACP connection and return both the {@link AgentSideConnection} and the
+ * underlying {@link AcpAgent}. Callers that need to await agent shutdown (terminal
+ * delete/dispose work) after transport closure should use this instead of
+ * {@link createAcpConnection}.
+ */
+export declare function createAcpConnectionWithAgent(transport: Stream, createSession: AcpSessionFactory, initialSession?: AgentSession): AcpConnectionHandle;
 export declare function runAcpMode(createSession: AcpSessionFactory, initialSession?: AgentSession): Promise<never>;

package/dist/types/modes/components/assistant-message.d.ts

@@ -10,7 +10,7 @@ export declare class AssistantMessageComponent extends Container {
     #private;
     private hideThinkingBlock;
     private readonly onImageUpdate?;
-    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: (() => void) | undefined);
+    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: (() => void) | undefined, viewportAnchorId?: string);
     invalidate(): void;
     setHideThinkingBlock(hide: boolean): void;
     setToolResultImages(toolCallId: string, images: ImageContent[]): void;

package/dist/types/modes/components/custom-editor.d.ts

@@ -49,6 +49,8 @@ export declare class CustomEditor extends Editor {
     /** Called before regular composer input should return the transcript viewport to the live bottom. */
     onViewportFollowLive?: () => void;
     setActionKeys(action: ConfigurableEditorAction, keys: KeyId[]): void;
+    /** Returns whether a built-in editor action consumes this configured key before custom handlers. */
+    hasActionKey(key: KeyId): boolean;
     /**
      * Register a custom key handler. Extensions use this for shortcuts.
      */

package/dist/types/modes/components/hook-selector.d.ts

@@ -44,6 +44,11 @@ export interface HookSelectorOptions {
      * completion behavior as the main prompt editor.
      */
     autocompleteProvider?: AutocompleteProvider;
+    /**
+     * Maps raw single-key accelerators to option labels. Unset maps preserve
+     * the legacy selector key handling exactly.
+     */
+    acceleratorMap?: Readonly<Record<string, string>>;
 }
 export declare class HookSelectorComponent extends Container {
     #private;

package/dist/types/modes/components/irc-sidebar.d.ts

@@ -0,0 +1,32 @@
+import { type Component, type ViewportAnchorProvider, type ViewportAnchorRender } from "@sayknow-cli/tui";
+import type { IrcObservationLedger } from "../irc-observation-ledger";
+export declare const IRC_SIDEBAR_WIDTH_RATIO = 0.3;
+export declare const IRC_SIDEBAR_MAX_RENDER_ROWS = 2048;
+/** Computes transcript/sidebar widths while preserving at least half the terminal for the transcript. */
+export declare function computeIrcSplitWidths(width: number): {
+    leftWidth: number;
+    separatorWidth: number;
+    rightWidth: number;
+};
+export interface IrcSidebarTheme {
+    fg(color: "dim" | "accent", text: string): string;
+    bold(text: string): string;
+    readonly boxSharp: {
+        readonly vertical: string;
+    };
+}
+export type IrcSidebarThemeSource = IrcSidebarTheme | (() => IrcSidebarTheme);
+/** Read-only IRC history alongside the active transcript. */
+export declare class IrcSplitViewComponent implements ViewportAnchorProvider {
+    #private;
+    private readonly leftPane;
+    private readonly ledger;
+    private readonly componentTheme;
+    constructor(leftPane: Component, ledger: IrcObservationLedger, componentTheme: IrcSidebarThemeSource);
+    get visible(): boolean;
+    effectiveSidebarVisible(width?: number): boolean;
+    setVisible(visible: boolean): void;
+    render(width: number): string[];
+    renderWithViewportAnchors(width: number): ViewportAnchorRender;
+    invalidate(): void;
+}

package/dist/types/modes/components/pet-selector.d.ts

@@ -0,0 +1,11 @@
+import { Container, SelectList } from "@sayknow-cli/tui";
+import type { PetMode } from "./sayknow-pet-widget";
+/**
+ * Theme-style picker for the sayknow pet skin (Off / RedSayknow / BlueSayknow). Preview
+ * fires as the selection moves; select commits, cancel restores.
+ */
+export declare class PetSelectorComponent extends Container {
+    #private;
+    constructor(current: PetMode, onSelect: (mode: PetMode) => void, onCancel: () => void, onPreview: (mode: PetMode) => void);
+    getSelectList(): SelectList;
+}

package/dist/types/modes/components/sayknow-pet-widget.d.ts

@@ -0,0 +1,59 @@
+import { type Component, type Container, type PetMode, type PetSkinId, type TUI } from "@sayknow-cli/tui";
+import type { CustomEditor } from "./custom-editor";
+/** Re-exported from the tui skin registry so widget-relative imports stay valid. */
+export type { PetMode, PetSkinId };
+/**
+ * Wraps the composer editor, reserving a right-side area beside it where the
+ * real-pixel pet is drawn. The editor just renders narrower; the pet pixels
+ * are emitted separately as an absolute-positioned overlay.
+ */
+export declare class PetFramedEditor implements Component {
+    #private;
+    constructor(editor: CustomEditor);
+    setReserve(columns: number): void;
+    canFit(width: number): boolean;
+    invalidate(): void;
+    render(width: number): string[];
+}
+/**
+ * The sayknow pet: a 16x16 real-pixel sprite living in a reserved area beside
+ * the composer. It is nearest-neighbor scaled to the two terminal rows occupied
+ * by an empty one-line composer and lifted one row so its feet meet the input
+ * box's bottom edge.
+ *
+ * Rendering has two paths that share one payload builder:
+ * - a post-render emitter re-draws the sprite after every TUI write (line
+ *   renders clear the pet cells, so the overlay must be re-applied), and
+ * - frame advances write the payload directly to the terminal, because the
+ *   TUI skips writes entirely when no component line changed.
+ *
+ * Requires a sixel- or kitty-graphics terminal (`pixelProtocol()`).
+ */
+export declare class SayknowPetWidget {
+    #private;
+    constructor(options: {
+        ui: TUI;
+        editor: CustomEditor;
+        editorContainer: Container;
+        floorContainer: Container;
+        isWorking: () => boolean;
+        /** Rows rendered below the composer box (pet floor + hook widgets). */
+        getComposerBottomOffset: () => number;
+        forcePixelProtocol?: "sixel" | "kitty";
+        /** Random [min, max] ms between auto-flexes; null disables. */
+        autoFlexGapMs?: [number, number] | null;
+    });
+    /** Protocol available for the real-pixel pet, if any. */
+    static pixelProtocol(): "sixel" | "kitty" | null;
+    get mode(): PetMode;
+    get isFlexing(): boolean;
+    setMode(mode: PetMode): void;
+    /** Live preview during a selector: change the sprite without re-mounting the
+     *  composer editor (that would tear down the open overlay). After a short idle
+     *  eye-roll it fires the signature burst once (RedSayknow flex, BlueSayknow para-para
+     *  then sob) so the selector demos the animation instead of waiting the random gap. */
+    previewMode(mode: PetMode): void;
+    dispose(): void;
+    /** Re-mount the composer editor (framed when a skin is active) after an overlay. */
+    remountComposer(): void;
+}

package/dist/types/modes/components/session-selector.d.ts

@@ -1,28 +1,41 @@
 import { type Component, Container } from "@sayknow-cli/tui";
-import type { SessionInfo } from "../../session/session-manager";
-/**
- * Custom session list component with multi-line items and search
- */
+import type { ResumeSessionIdentity, ResumeTailInspection, SessionInfo } from "../../session/session-manager";
+export interface SelectedSession {
+    kind: "selected";
+    path: string;
+    identity: ResumeSessionIdentity;
+    action: "continue-tail" | "open-idle";
+}
+export interface CancelledSessionSelection {
+    kind: "cancelled";
+}
+export type SessionSelectionResult = SelectedSession | CancelledSessionSelection;
+export type SessionInspector = (sessionPath: string) => Promise<ResumeTailInspection>;
 declare class SessionList implements Component {
     #private;
     private readonly allSessions;
     private readonly showCwd;
-    onSelect?: (sessionPath: string) => void;
+    onSelect?: (session: SessionInfo) => void;
     onCancel?: () => void;
     onExit: () => void;
     onDeleteRequest?: (session: SessionInfo) => void;
     constructor(allSessions: SessionInfo[], showCwd?: boolean);
+    setInputFrozen(frozen: boolean): void;
     removeSession(sessionPath: string): void;
     invalidate(): void;
     render(width: number): string[];
     handleInput(keyData: string): void;
 }
-/**
- * Component that renders a session selector with optional confirmation dialog
- */
+/** A one-shot resume consent selector. It never opens or mutates sessions. */
 export declare class SessionSelectorComponent extends Container {
     #private;
-    constructor(sessions: SessionInfo[], onSelect: (sessionPath: string) => void, onCancel: () => void, onExit: () => void, onDelete?: (session: SessionInfo) => Promise<boolean>);
+    private readonly onSelect;
+    private readonly onCancel;
+    private readonly onExit;
+    private readonly onDelete?;
+    private readonly inspector?;
+    private readonly onSelection?;
+    constructor(sessions: SessionInfo[], onSelect: (sessionPath: string) => void, onCancel: () => void, onExit: () => void, onDelete?: ((session: SessionInfo) => Promise<boolean>) | undefined, inspector?: SessionInspector | undefined, onSelection?: ((selection: SessionSelectionResult) => void) | undefined);
     setOnRequestRender(callback: () => void): void;
     handleInput(keyData: string): void;
     getSessionList(): SessionList;

package/dist/types/modes/components/settings-selector.d.ts

@@ -39,6 +39,8 @@ export interface SettingsCallbacks {
     onThemePreview?: (theme: string) => void | Promise<void>;
     /** Called to restore the rendered theme when theme settings preview is cancelled */
     onThemePreviewCancel?: (theme: string) => void | Promise<void>;
+    /** Called to live-preview the sayknow pet skin while browsing the pet setting. */
+    onPetPreview?: (mode: string) => void;
     /** Called for status line preview while configuring */
     onStatusLinePreview?: (settings: StatusLinePreviewSettings) => void;
     /** Get current rendered status line for inline preview */

package/dist/types/modes/components/status-line/types.d.ts

@@ -25,7 +25,7 @@ export interface SegmentContext {
         cost: number;
         tokensPerSecond: number | null;
     };
-    contextPercent: number;
+    contextPercent: number | null;
     contextWindow: number;
     /**
      * True when a standalone `context_pct` segment is also part of the active

package/dist/types/modes/components/status-line.d.ts

@@ -70,16 +70,6 @@ export declare class StatusLineComponent implements Component {
      * unit tests can verify the backoff invariant.
      */
     refreshUsageInBackground(): void;
-    /**
-     * Compute the (cached) used-tokens / context-window totals for the
-     * status-line context% segment. Exposed (non-private) so unit tests can
-     * verify the incremental-cache invariants; not part of any external
-     * API.
-     */
-    getCachedContextBreakdown(): {
-        usedTokens: number;
-        contextWindow: number;
-    };
     getTopBorder(width: number): {
         content: string;
         width: number;

package/dist/types/modes/components/tool-execution.d.ts

@@ -51,4 +51,5 @@ export declare class ToolExecutionComponent extends Container {
     setExpanded(expanded: boolean): void;
     setShowImages(show: boolean): void;
     invalidate(): void;
+    render(width: number): string[];
 }

package/dist/types/modes/components/user-message.d.ts

@@ -3,5 +3,6 @@ import { Container } from "@sayknow-cli/tui";
  * Component that renders a user message
  */
 export declare class UserMessageComponent extends Container {
-    constructor(text: string, synthetic?: boolean);
+    #private;
+    constructor(text: string, synthetic?: boolean, viewportAnchorId?: string);
 }

package/dist/types/modes/controllers/event-controller.d.ts

@@ -1,3 +1,4 @@
+import { type Component } from "@sayknow-cli/tui";
 import type { InteractiveModeContext } from "../../modes/types";
 import type { AgentSessionEvent } from "../../session/agent-session";
 /** Test-only performance counters for advisory baseline tests. */
@@ -12,6 +13,9 @@ export declare class EventController {
     dispose(): void;
     subscribeToAgent(): void;
     handleEvent(event: AgentSessionEvent): Promise<void>;
+    clearIrcExpiryTimers(): void;
+    resetIrcObservations(): void;
+    reconcileIrcExpiryTimers(componentsByObservationId: Map<string, readonly Component[]>): void;
     sendCompletionNotification(): void;
     handleBackgroundEvent(event: AgentSessionEvent): Promise<void>;
 }

package/dist/types/modes/controllers/selector-controller.d.ts

@@ -29,6 +29,7 @@ export declare class SelectorController {
     showEffortSelector(): void;
     showSettingsSelector(): void;
     showThemeSelector(): void;
+    showPetSelector(): void;
     showHistorySearch(): void;
     /**
      * Show the Extension Control Center dashboard.