@sayknow-cli/coding-agent 0.4.6 → 0.5.0

package/dist/types/config/settings-schema.d.ts

@@ -180,7 +180,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "notifications.telegram.toolActivity.enabled": {
         readonly type: "boolean";
-        readonly default: true;
+        readonly default: false;
         readonly ui: {
             readonly tab: "notifications";
             readonly label: "Telegram Tool Activity";
@@ -427,6 +427,16 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: 0.05;
         readonly validate: (value: number) => boolean;
     };
+    readonly "skc.ralplan.maxIterations": {
+        readonly type: "number";
+        readonly default: 5;
+        readonly validate: (value: number) => boolean;
+    };
+    readonly "skc.ralplan.maxReviewPassesPerLane": {
+        readonly type: "number";
+        readonly default: 1;
+        readonly validate: (value: number) => boolean;
+    };
     readonly "theme.dark": {
         readonly type: "string";
         readonly default: "blue-octopus";
@@ -984,6 +994,15 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "boolean";
         readonly default: true;
     };
+    readonly "statusLine.showActionHints": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "appearance";
+            readonly label: "Status Line Action Hints";
+            readonly description: "Show contextual keyboard shortcuts in the status line";
+        };
+    };
     readonly "statusLine.leftSegments": {
         readonly type: "array";
         readonly default: StatusLineSegmentId[];
@@ -1499,7 +1518,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly ui: {
             readonly tab: "interaction";
             readonly label: "Mouse Support";
-            readonly description: "Enable SGR mouse wheel scrolling and overlay row selection. Disabled in tmux and screen.";
+            readonly description: "Enable SKC session scrolling, drag-to-copy text selection, and overlay row selection with the mouse. Disabled by default to preserve native terminal or tmux scrollback and selection.";
         };
     };
     readonly steeringMode: {
@@ -1599,6 +1618,15 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Suggest emojis from `:name:` shortcodes and expand text emoticons like `:D` or `:-)`";
         };
     };
+    readonly promptSuggestions: {
+        readonly type: "boolean";
+        readonly default: false;
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly label: "Prompt Suggestions";
+            readonly description: "Predict your likely next prompt after each turn (smol-model call) and show it as ghost text; Tab accepts";
+        };
+    };
     readonly "startup.quiet": {
         readonly type: "boolean";
         readonly default: false;
@@ -2488,7 +2516,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly ui: {
             readonly tab: "editing";
             readonly label: "Default Read Limit";
-            readonly description: "Default number of lines returned when agent calls read without a limit";
+            readonly description: "Default collection/selection limit for read operations; bare local receipts use the separate 50-line / 10 KiB receipt budgets";
             readonly options: readonly [{
                 readonly value: "200";
                 readonly label: "200 lines";
@@ -2556,6 +2584,29 @@ export declare const SETTINGS_SCHEMA: {
             }];
         };
     };
+    readonly "read.truncation": {
+        readonly type: "enum";
+        readonly values: readonly ["head", "last", "both"];
+        readonly default: "last";
+        readonly ui: {
+            readonly tab: "editing";
+            readonly label: "Read Truncation";
+            readonly description: "Configured default direction for routes that support directional truncation; bare local and archive reads use this value (factory default: last), while explicit truncation always wins";
+            readonly options: readonly [{
+                readonly value: "head";
+                readonly label: "Head";
+                readonly description: "Keep the first N lines";
+            }, {
+                readonly value: "last";
+                readonly label: "Last";
+                readonly description: "Keep the last N lines (default)";
+            }, {
+                readonly value: "both";
+                readonly label: "Both";
+                readonly description: "Keep the start and the end, elide the middle";
+            }];
+        };
+    };
     readonly "read.summaryMaxBytes": {
         readonly type: "number";
         readonly default: 20;
@@ -2962,8 +3013,8 @@ export declare const SETTINGS_SCHEMA: {
         readonly default: false;
         readonly ui: {
             readonly tab: "tools";
-            readonly label: "Insane Search Fallback";
-            readonly description: "Opt in to the vendored insane-search escalation for blocked public URL reads (403/WAF/JS-gated). Off by default. Requires preinstalled python3 + curl_cffi (and node + playwright/stealth for the browser phase); changes network posture by enabling TLS/browser impersonation for public pages.";
+            readonly label: "Insane Search Fallback (Compatibility)";
+            readonly description: "Compatibility-only preference. Remote renderer fallback stays disabled because it cannot preserve validated per-hop network routing.";
         };
     };
     readonly "github.enabled": {
@@ -3132,6 +3183,45 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "How often the resource GC sweeps browser tabs and stale screenshot directories.";
         };
     };
+    readonly "memoryGuard.enabled": {
+        readonly type: "boolean";
+        readonly default: false;
+    };
+    readonly "memoryGuard.checkIntervalMs": {
+        readonly type: "number";
+        readonly default: 30000;
+        readonly validate: (value: number) => boolean;
+    };
+    readonly "memoryGuard.gcThresholdPercent": {
+        readonly type: "number";
+        readonly default: 70;
+        readonly validate: (value: number) => boolean;
+    };
+    readonly "memoryGuard.restartThresholdPercent": {
+        readonly type: "number";
+        readonly default: 85;
+        readonly validate: (value: number) => boolean;
+    };
+    readonly "memoryGuard.restartThresholdWindowMs": {
+        readonly type: "number";
+        readonly default: 90000;
+        readonly validate: (value: number) => boolean;
+    };
+    readonly "memoryGuard.cooldownMs": {
+        readonly type: "number";
+        readonly default: 600000;
+        readonly validate: (value: number) => boolean;
+    };
+    readonly "memoryGuard.parentReserveMb": {
+        readonly type: "number";
+        readonly default: 1024;
+        readonly validate: (value: number) => boolean;
+    };
+    readonly "memoryGuard.policyLimitMb": {
+        readonly type: "number";
+        readonly default: 0;
+        readonly validate: (value: number) => boolean;
+    };
     readonly "computer.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -3824,20 +3914,20 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "providers.image": {
         readonly type: "enum";
-        readonly values: readonly ["auto", "openai", "gemini", "openrouter", "antigravity"];
+        readonly values: readonly ["auto", "openai", "gemini", "openrouter", "antigravity", "alibaba", "custom"];
         readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
-            readonly label: "Image Provider";
-            readonly description: "Provider for image generation tool";
+            readonly label: "Image Generation";
+            readonly description: "Provider and model for image generation tool";
             readonly options: readonly [{
                 readonly value: "auto";
                 readonly label: "Auto";
-                readonly description: "Priority: GPT model image tool > Antigravity > OpenRouter > Gemini";
+                readonly description: "Priority: GPT model image tool > Antigravity > OpenRouter > Gemini > Alibaba";
             }, {
                 readonly value: "openai";
                 readonly label: "OpenAI";
-                readonly description: "Uses the active GPT Responses/Codex model";
+                readonly description: "Uses gpt-image-2 via OpenAI Responses/Codex";
             }, {
                 readonly value: "gemini";
                 readonly label: "Gemini";
@@ -3850,9 +3940,53 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "antigravity";
                 readonly label: "Antigravity";
                 readonly description: "Requires login with google-antigravity";
+            }, {
+                readonly value: "alibaba";
+                readonly label: "Alibaba Bailian";
+                readonly description: "Requires ALIBABA_TOKEN_PLAN_API_KEY (wan2.7-image via Token Plan)";
+            }, {
+                readonly value: "custom";
+                readonly label: "Custom";
+                readonly description: "OpenAI-compatible endpoint (set providers.imageCustomUrl)";
             }];
         };
     };
+    readonly "providers.imageModel": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly label: "Image Model";
+            readonly description: "Override the default image generation model for the selected provider";
+        };
+    };
+    readonly "providers.imageCustomUrl": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly label: "Image Custom URL";
+            readonly description: "Base URL for custom OpenAI-compatible image endpoint";
+        };
+    };
+    readonly "providers.imageCustomKey": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly label: "Image Custom API Key";
+            readonly description: "API key for custom OpenAI-compatible image endpoint";
+        };
+    };
+    readonly "providers.imageCustomKeyEnv": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "providers";
+            readonly label: "Image Custom API Key Env";
+            readonly description: "Environment variable name holding the API key for custom image endpoint";
+        };
+    };
     readonly "providers.kimiApiFormat": {
         readonly type: "enum";
         readonly values: readonly ["openai", "anthropic"];
@@ -4385,6 +4519,7 @@ export interface StatusLineSettings {
     maxRows: number;
     showHookStatus: boolean;
     showSkillHud: boolean;
+    showActionHints: boolean;
     leftSegments: StatusLineSegmentId[];
     rightSegments: StatusLineSegmentId[];
     segmentOptions: Record<string, unknown>;
@@ -4418,6 +4553,16 @@ export interface ShellMinimizerSettings {
     except: string[];
     maxCaptureBytes: number;
 }
+export interface MemoryGuardSettings {
+    enabled: boolean;
+    checkIntervalMs: number;
+    gcThresholdPercent: number;
+    restartThresholdPercent: number;
+    restartThresholdWindowMs: number;
+    cooldownMs: number;
+    parentReserveMb: number;
+    policyLimitMb: number;
+}
 export interface NotificationsSettings {
     enabled: boolean;
     telegram: {
@@ -4503,6 +4648,7 @@ export interface GroupTypeMap {
     statusLine: StatusLineSettings;
     thinkingBudgets: ThinkingBudgetsSettings;
     stt: SttSettings;
+    memoryGuard: MemoryGuardSettings;
     modelRoles: Record<string, ModelSelectorValue>;
     modelTags: ModelTagsSettings;
     cycleOrder: string[];

package/dist/types/config/settings.d.ts

@@ -89,6 +89,9 @@ export declare class Settings implements NotificationSettingsReader {
     has(path: SettingPath): boolean;
     /** Diagnostics from schema reconciliation during the most recent load. */
     getSchemaReport(): SettingsSchemaReport;
+    onChanged(listener: (path: SettingPath) => void): () => void;
+    /** Whether durable settings mutations are permitted for the loaded configuration. */
+    canWriteDurableConfig(): boolean;
     /**
      * Set a setting value (sync).
      * Updates global settings and reserves its background persistence slot before

package/dist/types/edit/modes/patch.d.ts

@@ -41,11 +41,24 @@ export interface ApplyPatchOptions {
     fuzzyThreshold?: number;
     allowFuzzy?: boolean;
     fs?: FileSystem;
+    /**
+     * When false, skip durable cross-process file locks (in-process path mutex
+     * still serializes). Defaults to true only for the real `defaultFileSystem`
+     * (or when `fs` is omitted). Disk-backed adapters that are not
+     * `defaultFileSystem` (notably production `LspFileSystem` via
+     * `executePatchSingle`) MUST pass `crossProcessLock: true` explicitly —
+     * object identity is not a durable-lock capability probe.
+     */
+    crossProcessLock?: boolean;
 }
 /** Default filesystem implementation using Bun APIs */
 export declare const defaultFileSystem: FileSystem;
 /**
  * Apply a patch operation to the filesystem.
+ *
+ * Concurrent mutations of the same absolute path are serialized (in-process always;
+ * cross-process file lock when using the real filesystem) so disjoint concurrent
+ * edits cannot silently overwrite each other (#2900).
  */
 export declare function applyPatch(input: PatchInput, options: ApplyPatchOptions): Promise<ApplyPatchResult>;
 /**

package/dist/types/edit/path-mutation-lock.d.ts

@@ -0,0 +1,15 @@
+import { type FileLockOptions } from "../config/file-lock";
+export type EditPathMutationOptions = {
+    /**
+     * When true (default), also acquire a durable cross-process file lock.
+     * Disable for injectible/in-memory filesystem tests that do not touch disk.
+     */
+    crossProcess?: boolean;
+    fileLock?: FileLockOptions;
+};
+/**
+ * Run `fn` while holding exclusive mutation rights for every absolute path.
+ * Paths are locked in lexicographic order to avoid deadlocks on multi-path ops
+ * (e.g. rename source + destination).
+ */
+export declare function withEditPathMutation<T>(absolutePaths: readonly string[], fn: () => Promise<T>, options?: EditPathMutationOptions): Promise<T>;

package/dist/types/eval/py/executor.d.ts

@@ -50,7 +50,7 @@ export interface PythonExecutorOptions {
     /** @internal Bridge endpoint info, set by `executePython` before delegating. */
     bridge?: {
         url: string;
-        token: string;
+        capability: string;
     };
 }
 export interface PythonKernelExecutor {

package/dist/types/eval/py/runner-artifact.d.ts

@@ -0,0 +1,8 @@
+export interface RunnerScriptCache {
+    ensureRunnerScript(): Promise<string>;
+    cleanup(): Promise<void>;
+}
+export declare function createRunnerScriptCache(tempRoot: string): RunnerScriptCache;
+/** @internal Test-only initializer for isolated artifact assertions. */
+export declare function createRunnerScriptInitializer(tempRoot: string): () => Promise<string>;
+export declare const ensureRunnerScript: () => Promise<string>;

package/dist/types/eval/py/tool-bridge.d.ts

@@ -7,7 +7,6 @@ export interface PyToolBridgeEntry {
 }
 export interface PyToolBridgeInfo {
     url: string;
-    token: string;
 }
 /** Starts the bridge server lazily and returns its connection info. */
 export declare function ensurePyToolBridge(): Promise<PyToolBridgeInfo>;
@@ -15,6 +14,6 @@ export declare function ensurePyToolBridge(): Promise<PyToolBridgeInfo>;
  * Register a tool session for the duration of one execution. The returned
  * function MUST be called to remove the entry once execution finishes.
  */
-export declare function registerPyToolBridge(sessionId: string, entry: PyToolBridgeEntry): () => void;
+export declare function registerPyToolBridge(sessionId: string, capability: string, entry: PyToolBridgeEntry): () => void;
 /** Stop the bridge and clear registrations. Test-only / shutdown helper. */
 export declare function disposePyToolBridge(): Promise<void>;

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

@@ -186,6 +186,25 @@ export interface ExtensionTranscriptEntry {
     textSummary: string;
     ts: string;
     body?: string;
+    /**
+     * Durable, image-free message blocks used by rich transcript consumers such
+     * as ACP replay. Binary image payloads intentionally remain unavailable.
+     */
+    content?: Array<{
+        type: "text";
+        text: string;
+    } | {
+        type: "thinking";
+        thinking: string;
+    } | {
+        type: "toolCall";
+        id: string;
+        name: string;
+        arguments: unknown;
+    }>;
+    toolCallId?: string;
+    toolName?: string;
+    isError?: boolean;
 }
 export interface ContextUsage {
     /** Context tokens, or null if unknown (e.g. right after compaction, before next LLM response). */
@@ -255,6 +274,7 @@ export interface ExtensionContext {
         model: Model;
         thinkingLevel: ThinkingLevel | undefined;
     } | undefined>;
+    setModelProfile?(name: string): Promise<boolean>;
     cycleThinkingLevel(): ThinkingLevel | undefined;
     setQueueMode(kind: "steering" | "follow_up" | "interrupt", mode: unknown): boolean;
     getSkillState(): unknown;
@@ -271,7 +291,16 @@ export interface ExtensionContext {
     } | undefined>;
     getJobs(): unknown;
     /** Typed skill and mode controls exposed to the SDK host. */
-    invokeSkill?(name: string, args?: string): Promise<unknown>;
+    invokeSkill?(name: string, args?: string, options?: {
+        onPreflightAccepted?: () => void;
+        onPreflightAcceptCommit?: () => void | Promise<void>;
+        onSkillPrepared?: (meta: {
+            name: string;
+            path: string;
+            lineCount?: number;
+            cleanedArgs?: string;
+        }) => void;
+    }): Promise<unknown>;
     setPlanMode?(on: boolean): unknown;
     operateGoal?(op: "create" | "get" | "resume" | "pause" | "complete" | "drop", objective?: string): Promise<unknown>;
     /** Typed nonvisual session controls exposed to the SDK host. */
@@ -740,6 +769,7 @@ export interface ExtensionAPI {
     sendUserMessage(content: string | (TextContent | ImageContent)[], options?: {
         deliverAs?: "steer" | "followUp";
         onPreflightAccepted?: () => void;
+        onPreflightAcceptCommit?: () => void | Promise<void>;
     }): Promise<void>;
     /** Append a custom entry to the session for state persistence (not sent to LLM). */
     appendEntry<T = unknown>(customType: string, data?: T): void;
@@ -913,6 +943,7 @@ options?: {
 export type SendUserMessageHandler = (content: string | (TextContent | ImageContent)[], options?: {
     deliverAs?: "steer" | "followUp";
     onPreflightAccepted?: () => void;
+    onPreflightAcceptCommit?: () => void | Promise<void>;
 }) => void | Promise<void>;
 export type AppendEntryHandler = <T = unknown>(customType: string, data?: T) => void;
 export type GetActiveToolsHandler = () => string[];
@@ -999,6 +1030,7 @@ export interface ExtensionContextActions {
         model: Model;
         thinkingLevel: ThinkingLevel | undefined;
     } | undefined>;
+    setModelProfile?: (name: string) => Promise<boolean>;
     cycleThinkingLevel?: () => ThinkingLevel | undefined;
     setQueueMode?: (kind: "steering" | "follow_up" | "interrupt", mode: unknown) => boolean;
     getSkillState?: () => unknown;
@@ -1016,7 +1048,16 @@ export interface ExtensionContextActions {
     getJobs?: () => unknown;
     setSdkPermissionProvider?: (provider: ((toolCall: ClientBridgePermissionToolCall, options: ClientBridgePermissionOption[], signal?: AbortSignal) => Promise<ClientBridgePermissionOutcome>) | undefined) => void;
     sdkControl?: (operation: string, input: Record<string, unknown>) => unknown | Promise<unknown>;
-    invokeSkill?: (name: string, args?: string) => Promise<unknown>;
+    invokeSkill?: (name: string, args?: string, options?: {
+        onPreflightAccepted?: () => void;
+        onPreflightAcceptCommit?: () => void | Promise<void>;
+        onSkillPrepared?: (meta: {
+            name: string;
+            path: string;
+            lineCount?: number;
+            cleanedArgs?: string;
+        }) => void;
+    }) => Promise<unknown>;
     setPlanMode?: (on: boolean) => unknown;
     operateGoal?: (op: "create" | "get" | "resume" | "pause" | "complete" | "drop", objective?: string) => Promise<unknown>;
 }

package/dist/types/extensibility/shared-events.d.ts

@@ -31,6 +31,8 @@ export interface SessionBeforeSwitchEvent {
     /** Session file we're switching to (only for "resume") */
     targetSessionFile?: string;
 }
+/** Origin used when an interactive session selector resumes a session. */
+export declare const INTERACTIVE_SELECTOR_RESUME_ORIGIN = "interactive_selector_resume";
 /** Fired after switching to another session */
 export interface SessionSwitchEvent {
     type: "session_switch";
@@ -38,6 +40,10 @@ export interface SessionSwitchEvent {
     reason: "new" | "resume" | "fork";
     /** Session file we came from */
     previousSessionFile: string | undefined;
+    /** Optional provenance for this session transition. */
+    transition?: {
+        origin: string;
+    };
 }
 /** Fired before branching a session (can be cancelled) */
 export interface SessionBeforeBranchEvent {

package/dist/types/internal-urls/local-root-gc.d.ts

@@ -0,0 +1,2 @@
+import type { GcStoreAdapter } from "../skc-runtime/gc-runtime";
+export declare const localRootsGcAdapter: GcStoreAdapter;

package/dist/types/main.d.ts

@@ -85,14 +85,18 @@ interface InteractiveModeFactoryOptions {
 }
 type CreateInteractiveMode = (options: InteractiveModeFactoryOptions) => InteractiveMode;
 type ResumePickerTerminalCheck = () => boolean;
-type ListForResumePickerReadOnly = (cwd: string, sessionDir?: string) => Promise<SessionInfo[]>;
+type ListForResumePickerReadOnly = (cwd: string, sessionDir?: string, storage?: undefined) => Promise<SessionInfo[]>;
+type ListManagedForResumePickerReadOnly = (cwd: string, managedAgentDir?: string, storage?: undefined) => Promise<SessionInfo[]>;
+type ResolveManagedAgentDirForScope = (cwd: string) => string;
 type SelectResumeSession = (sessions: SessionInfo[]) => Promise<SessionSelectionResult>;
 type OpenExistingSessionStrict = (identity: ResumeSessionIdentity, destination: SessionDestination, storage?: undefined, migrationPolicy?: SessionDirectoryMigrationPolicy) => 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>.";
+/** Resolves only the managed agent root needed for pre-consent picker inventory. */
+export declare function resolveManagedAgentDirForScope(_cwd: string): string;
 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 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
@@ -125,11 +129,38 @@ export interface RunRootCommandDependencies {
     runPrintMode?: RunPrintMode;
     isResumePickerTerminal?: ResumePickerTerminalCheck;
     listForResumePickerReadOnly?: ListForResumePickerReadOnly;
+    listManagedForResumePickerReadOnly?: ListManagedForResumePickerReadOnly;
+    resolveManagedAgentDirForScope?: ResolveManagedAgentDirForScope;
     selectResumeSession?: SelectResumeSession;
     openExistingSessionStrict?: OpenExistingSessionStrict;
     initializeSettings?: typeof Settings.init;
     loadSettingsForScope?: typeof Settings.loadForScope;
 }
+export interface ModelRoleOverrides {
+    smol?: string;
+    slow?: string;
+    plan?: string;
+}
+/**
+ * Resolve the ephemeral `smol`/`slow`/`plan` model-role overrides.
+ *
+ * Precedence per role is CLI flag > documented `SKC_*_MODEL` > legacy
+ * `PI_*_MODEL`, matching the repo-wide SKC-first/PI-fallback convention.
+ * Resolution reads the process environment via `$pickenv`, which trims values
+ * and treats empty/whitespace as unset; it is deliberately kept separate from
+ * credential env resolution (`$credentialEnv`/`$pickCredentialEnv`). The
+ * function is pure and stateless, so it reads fresh each call and a later
+ * invocation never inherits an earlier one's values.
+ */
+export declare function resolveModelRoleOverrides(parsed: Pick<Args, "smol" | "slow" | "plan">): ModelRoleOverrides;
+/**
+ * Apply the `--no-pty` / `--no-title` terminal-control flags to the environment.
+ *
+ * Sets the canonical `SKC_*` name (so an explicit flag wins over a user-set
+ * `SKC_*` value under the SKC-first resolver — CLI authority) and the legacy
+ * `PI_*` name for backward compatibility. `--acp` mode implies `--no-title`.
+ */
+export declare function applyTerminalControlFlagsToEnv(parsed: Pick<Args, "noPty" | "noTitle" | "mode">, env?: NodeJS.ProcessEnv): void;
 export declare function runRootCommand(parsed: Args, rawArgs: string[], deps?: RunRootCommandDependencies): Promise<void>;
 export declare function main(args: string[]): Promise<void>;
 export {};

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

@@ -25,4 +25,6 @@ export declare function clearMemoryData(agentDir: string, cwd: string): Promise<
  * Force-enqueue global consolidation maintenance work.
  */
 export declare function enqueueMemoryConsolidation(agentDir: string, cwd: string, sourceUpdatedAt?: number): void;
+/** Secret scrubbing applied to every phase-2 consolidation output. Test seam. */
+export declare function redactMemorySecretsForTesting(input: string): string;
 export declare function getMemoryRoot(agentDir: string, cwd: string): string;

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

@@ -1,10 +1,15 @@
-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 Agent, type AgentSideConnection, type AuthenticateRequest, type AuthenticateResponse, type AvailableCommand, 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 AcpProviderRegistration, AcpSdkAdapter } from "../../sdk/acp";
 import type { AcpStartupOptions } from "./startup-options";
 export declare const ACP_BOOTSTRAP_RACE_GUARD_MS = 50;
 type JsonObject = Record<string, unknown>;
 /** Applies ACP's offset cursor after narrowing the broker listing to the requested cwd. */
-export declare function paginateAcpSessions(listed: unknown[], cwd: string | undefined, offset: number): ListSessionsResponse;
+export declare function paginateAcpSessions(listed: unknown[], cwd: string | undefined, offset: number, sessionMetadata?: ReadonlyMap<string, {
+    title?: string;
+    updatedAt?: string;
+}>): ListSessionsResponse;
+/** Build the ACP command palette from the shared builtins and live SDK skill state. */
+export declare function acpAvailableCommandsFromSkills(query: unknown): AvailableCommand[];
 export type TranscriptReplayBlock = {
     type: "text";
     text: string;
@@ -27,8 +32,8 @@ export interface TranscriptReplayContent {
     };
 }
 export declare function transcriptReplayContent(entry: unknown): TranscriptReplayContent;
-/** Maps live canonical SDK config and model queries into the ACP 1.2.1 session state surface. */
-export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?: unknown): {
+/** Maps live canonical SDK config and the selected model catalog into the ACP 1.2.1 session state surface. */
+export declare function acpSessionStateFromConfig(query: unknown, modelCatalogQuery?: unknown, modelPreset?: string): {
     configOptions: ({
         type: "select";
         currentValue: string;
@@ -54,8 +59,8 @@ export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?:
             readonly value: "wait";
             readonly name: "Wait";
         })[];
+        name: string;
         id: "model";
-        name: "Model";
     } | {
         type: "select";
         currentValue: string;
@@ -81,8 +86,8 @@ export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?:
             readonly value: "wait";
             readonly name: "Wait";
         })[];
+        name: string;
         id: "thinking";
-        name: "Thinking";
     } | {
         type: "select";
         currentValue: string;
@@ -108,8 +113,8 @@ export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?:
             readonly value: "wait";
             readonly name: "Wait";
         })[];
+        name: string;
         id: "steeringMode";
-        name: "Steering queue";
     } | {
         type: "select";
         currentValue: string;
@@ -135,8 +140,8 @@ export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?:
             readonly value: "wait";
             readonly name: "Wait";
         })[];
+        name: string;
         id: "followUpMode";
-        name: "Follow-up queue";
     } | {
         type: "select";
         currentValue: string;
@@ -162,8 +167,8 @@ export declare function acpSessionStateFromConfig(query: unknown, modelsQuery?:
             readonly value: "wait";
             readonly name: "Wait";
         })[];
+        name: string;
         id: "interruptMode";
-        name: "Interrupt mode";
     } | {
         id: string;
         name: string;
@@ -190,6 +195,14 @@ export declare function acpPromptPayload(blocks: PromptRequest["prompt"]): {
         mimeType: string;
     }>;
 };
+/**
+ * `AcpSdkAdapterError.code` is an internal string, but the SDK only derives a
+ * JSON-RPC code from a `RequestError`. Everything else collapses to an opaque
+ * `-32603 Internal error`, which hides the reason and defeats client-side
+ * recovery (an ACP client cannot see that it must authenticate). Map the codes
+ * that have a defined ACP/JSON-RPC counterpart onto a real `RequestError`.
+ */
+export declare function acpRequestFailure(error: unknown): unknown;
 /** Registers a permission provider only when the ACP client requires prompts. */
 export declare function acpProviderRegistrations(capabilities: ClientCapabilities | undefined, env?: NodeJS.ProcessEnv): AcpProviderRegistration[];
 /** Maps ACP permission handling to the session's canonical SDK policy. */

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

@@ -10,11 +10,13 @@ export declare class AssistantMessageComponent extends Container {
     #private;
     private hideThinkingBlock;
     private readonly onImageUpdate?;
-    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: (() => void) | undefined, viewportAnchorId?: string);
+    private readonly onVisibleMutation?;
+    constructor(message?: AssistantMessage, hideThinkingBlock?: boolean, onImageUpdate?: (() => void) | undefined, viewportAnchorId?: string, onVisibleMutation?: (() => void) | undefined);
     invalidate(): void;
     setHideThinkingBlock(hide: boolean): void;
     setToolResultImages(toolCallId: string, images: ImageContent[]): void;
     setUsageInfo(usage: Usage): void;
     updateContent(message: AssistantMessage, options?: AssistantMessageUpdateOptions): void;
+    dispose(): void;
 }
 export {};