@sayknow-cli/coding-agent 0.3.5 → 0.3.7

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

@@ -22,6 +22,9 @@ export interface StatusLineSegmentOptions {
         format?: "12h" | "24h";
         showSeconds?: boolean;
     };
+    usage?: {
+        mode?: "used" | "remaining";
+    };
 }
 export interface StatusLineSettings {
     preset?: StatusLinePreset;
@@ -29,9 +32,11 @@ export interface StatusLineSettings {
     rightSegments?: StatusLineSegmentId[];
     separator?: StatusLineSeparatorStyle;
     segmentOptions?: StatusLineSegmentOptions;
+    previewHighlightSegment?: StatusLineSegmentId;
     showHookStatus?: boolean;
     showSkillHud?: boolean;
     sessionAccent?: boolean;
+    maxRows?: number;
 }
 export interface StatusLineComponentOptions {
     version?: string;
@@ -59,9 +64,9 @@ export declare class StatusLineComponent implements Component {
     dispose(): void;
     invalidate(): void;
     /**
-     * Background-refresh the Anthropic OAuth quota report. Guarded by a 5-min
-     * TTL on both success (cache lifetime) and error (backoff). Exposed
-     * (non-private) so unit tests can verify the backoff invariant.
+     * Background-refresh the OAuth quota report. Guarded by a 5-min TTL on both
+     * success (cache lifetime) and error (backoff). Exposed (non-private) so
+     * unit tests can verify the backoff invariant.
      */
     refreshUsageInBackground(): void;
     /**
@@ -78,5 +83,12 @@ export declare class StatusLineComponent implements Component {
         content: string;
         width: number;
     };
+    /**
+     * Multi-row-aware content for the settings preview: the wrapped rows joined
+     * with newlines so a single `Text` renders them stacked. Honors the current
+     * `maxRows`; identical to the single status line when `maxRows` is 1 or when
+     * everything fits on one row.
+     */
+    getPreviewContent(width: number): string;
     render(width: number): string[];
 }

package/dist/types/modes/components/two-column-body.d.ts

@@ -0,0 +1,9 @@
+import { type Component } from "@sayknow-cli/tui";
+export declare class TwoColumnBody implements Component {
+    private readonly leftPane;
+    private readonly rightPane;
+    private readonly maxHeight;
+    constructor(leftPane: Component, rightPane: Component, maxHeight: number);
+    render(width: number): string[];
+    invalidate(): void;
+}

package/dist/types/modes/components/welcome.d.ts

@@ -9,6 +9,12 @@ export interface LspServerInfo {
     fileTypes: string[];
 }
 export type WelcomeLogoMode = "unicode" | "square" | "ascii";
+export interface WelcomeComponentOptions {
+    getViewportRows?: () => number | undefined;
+    getReservedBottomRows?: (termWidth: number) => number;
+    changelogMarkdown?: string;
+    collapseChangelog?: boolean;
+}
 /**
  * Sayknow-CLI launch surface: a blue-gradient SAYKNOW wordmark, compact
  * command affordances, and project signals — a distinct identity, not a
@@ -22,7 +28,8 @@ export declare class WelcomeComponent implements Component {
     private recentSessions;
     private lspServers;
     private readonly logoMode;
-    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], lspServers?: LspServerInfo[], logoMode?: WelcomeLogoMode);
+    private readonly options;
+    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], lspServers?: LspServerInfo[], logoMode?: WelcomeLogoMode, options?: WelcomeComponentOptions);
     invalidate(): void;
     /**
      * Play a one-shot intro that sweeps the gradient through every phase
@@ -30,6 +37,7 @@ export declare class WelcomeComponent implements Component {
      * subsequent calls reset and replay.
      */
     playIntro(requestRender: () => void): void;
+    dispose(): void;
     setModel(modelName: string, providerName: string): void;
     setRecentSessions(sessions: RecentSession[]): void;
     setLspServers(servers: LspServerInfo[]): void;

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

@@ -18,6 +18,7 @@ export declare class CommandController {
     handleUsageCommand(reports?: UsageReport[] | null): Promise<void>;
     handleChangelogCommand(showFull?: boolean): Promise<void>;
     handleHotkeysCommand(): void;
+    handleHelpCommand(): void;
     handleToolsCommand(): void;
     handleContextCommand(): void;
     handleMemoryCommand(text: string): Promise<void>;

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

@@ -1,4 +1,4 @@
-import type { AutocompleteProvider, SlashCommand } from "@sayknow-cli/tui";
+import { type AutocompleteProvider, type SlashCommand } from "@sayknow-cli/tui";
 import type { InteractiveModeContext } from "../../modes/types";
 export declare class InputController {
     #private;
@@ -14,6 +14,9 @@ export declare class InputController {
     handleFollowUp(): Promise<void>;
     /** Send editor text explicitly as a queued next-turn message. */
     handleQueueSubmit(): Promise<void>;
+    restoreLatestQueuedMessageToEditor(options?: {
+        currentText?: string;
+    }): number;
     restoreQueuedMessagesToEditor(options?: {
         abort?: boolean;
         currentText?: string;
@@ -27,11 +30,13 @@ export declare class InputController {
     handleCopyCurrentLine(): void;
     /** Copy current prompt text to system clipboard. */
     handleCopyPrompt(): void;
+    openCommandPalette(): void;
     cycleThinkingLevel(): void;
     cycleRoleModel(options?: {
         temporary?: boolean;
     }): Promise<void>;
     toggleToolOutputExpansion(): void;
+    scrollTmuxToPreviousUserInput(): void;
     setToolsExpanded(expanded: boolean): void;
     toggleThinkingBlockVisibility(): void;
     openExternalEditor(): Promise<void>;

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

@@ -1,7 +1,16 @@
 import type { Component } from "@sayknow-cli/tui";
+import type { ModelProfileConfig } from "../../config/models-config-schema";
+import { type Settings } from "../../config/settings";
 import type { InteractiveModeContext, OAuthSelectorOptions } from "../../modes/types";
+import type { StatusLineSettings } from "../components/status-line";
 import type { JobsObserver } from "../jobs-observer";
 import type { SessionObserverRegistry } from "../session-observer-registry";
+/**
+ * Snapshot the persisted status-line settings that the status-line component
+ * cares about. Preview, cancel-restore, and commit paths all share this so the
+ * previewed row count (and every other field) can never drift out of sync.
+ */
+export declare function buildStatusLineSettings(settingsInstance: Settings): StatusLineSettings;
 export declare class SelectorController {
     #private;
     private ctx;
@@ -15,7 +24,7 @@ export declare class SelectorController {
         focus: Component;
     }): void;
     showProviderOnboarding(): void;
-    showCustomModelPresetWizard(): void;
+    showCustomModelPresetWizard(snapshot: ModelProfileConfig): void;
     showCustomProviderWizard(): void;
     showSettingsSelector(): void;
     showThemeSelector(): void;

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

@@ -89,6 +89,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     retryLoader: Loader | undefined;
     autoCompactionEscapeHandler?: () => void;
     retryEscapeHandler?: () => void;
+    retryEscapePrimed: boolean;
     retryCountdownTimer?: NodeJS.Timeout;
     unsubscribe?: () => void;
     onInputCallback?: (input: SubmittedUserInput) => void;
@@ -184,6 +185,7 @@ export declare class InteractiveMode implements InteractiveModeContext {
     handleUsageCommand(reports?: UsageReport[] | null): Promise<void>;
     handleChangelogCommand(showFull?: boolean): Promise<void>;
     handleHotkeysCommand(): void;
+    handleHelpCommand(): void;
     handleToolsCommand(): void;
     handleContextCommand(): void;
     handleClearCommand(): Promise<void>;

package/dist/types/modes/prompt-action-autocomplete.d.ts

@@ -14,6 +14,9 @@ interface PromptActionAutocompleteOptions {
     copyCurrentLine: () => void;
     copyPrompt: () => void;
     pasteImage: () => void;
+    newSession: () => void;
+    showHelp: () => void;
+    scrollTmuxToPreviousUserInput: () => void;
     undo: (prefix: string) => void;
     moveCursorToMessageEnd: () => void;
     moveCursorToMessageStart: () => void;

package/dist/types/modes/rpc/rpc-types.d.ts

@@ -641,6 +641,7 @@ export interface RpcJsonSchema {
     items?: RpcJsonSchema;
     minLength?: number;
     maxLength?: number;
+    pattern?: string;
     minItems?: number;
     maxItems?: number;
     uniqueItems?: boolean;

package/dist/types/modes/shared/agent-wire/deep-interview-gate.d.ts

@@ -1,3 +1,17 @@
+/**
+ * Deep-interview gate mapping (#316).
+ *
+ * Converts deep-interview `ask`-tool questions into machine-addressable
+ * `workflow_gate` { kind: "question" } events (option set + free-text shape
+ * encoded in `schema`/`options`) and decodes a `workflow_gate_response` answer
+ * back into the exact QuestionResult shape the human path produces, so ambiguity
+ * scoring/state updates proceed identically whether a human or an agent answers.
+ *
+ * This is the pure mapping primitive. Routing the ask tool through it (instead of
+ * the interactive select/editor UI) when an unattended controller + gate broker
+ * are attached is wired with the transport in #321 and exercised by #323.
+ */
+import type { RpcWorkflowGateKind, RpcWorkflowStage } from "../../rpc/rpc-types";
 import type { OpenGateInput } from "./workflow-gate-broker";
 /** "Other (type your own)" sentinel, mirroring the interactive ask tool. */
 export declare const GATE_OTHER_OPTION = "Other (type your own)";
@@ -9,6 +23,10 @@ export interface AskGateDeepInterviewState {
     dimension: string;
     ambiguity: number;
 }
+export interface AskGateWorkflowGateMeta {
+    stage: RpcWorkflowStage;
+    kind: RpcWorkflowGateKind;
+}
 export interface AskGateQuestion {
     id: string;
     question: string;
@@ -22,6 +40,8 @@ export interface AskGateQuestion {
      * `stage_state`; when absent, the question text is regex-parsed as a fallback.
      */
     deepInterview?: AskGateDeepInterviewState;
+    /** Override the emitted workflow gate address for non-deep-interview ask prompts. */
+    workflowGate?: AskGateWorkflowGateMeta;
 }
 export interface AskGateResult {
     id: string;
@@ -30,6 +50,7 @@ export interface AskGateResult {
     multi: boolean;
     selectedOptions: string[];
     customInput?: string;
+    clarificationQuestion?: string;
 }
 /**
  * The answer shape an agent returns for a deep-interview question gate.
@@ -37,17 +58,30 @@ export interface AskGateResult {
  * `selected` are picked option labels; free text is conveyed by `other: true`
  * plus `custom`, encoded separately from `selected` so a real option whose label
  * happens to equal the display sentinel can never collide with the free-text path.
+ *
+ * `action: "clarify"` is a non-answer. It lets a Deep Interview user ask about
+ * the presented choices without advancing the round, scoring ambiguity, or
+ * recording selection state.
  */
-export interface DeepInterviewGateAnswer {
+export type DeepInterviewGateAnswer = {
     selected: string[];
-    other?: boolean;
-    custom?: string;
-}
+    other?: false;
+    custom?: undefined;
+    action?: "answer";
+} | {
+    selected: string[];
+    other: true;
+    custom: string;
+    action?: "answer";
+} | {
+    action: "clarify";
+    question: string;
+};
 export declare class DeepInterviewGateError extends Error {
-    readonly code: "invalid_answer_shape" | "unknown_option" | "multi_not_allowed" | "missing_custom" | "empty_selection" | "duplicate_selection";
-    constructor(code: "invalid_answer_shape" | "unknown_option" | "multi_not_allowed" | "missing_custom" | "empty_selection" | "duplicate_selection", message: string);
+    readonly code: "invalid_answer_shape" | "unknown_option" | "multi_not_allowed" | "missing_custom" | "missing_clarification" | "empty_selection" | "duplicate_selection";
+    constructor(code: "invalid_answer_shape" | "unknown_option" | "multi_not_allowed" | "missing_custom" | "missing_clarification" | "empty_selection" | "duplicate_selection", message: string);
 }
-/** Build the `workflow_gate` open-input for one deep-interview question. */
+/** Build the `workflow_gate` open-input for one ask question. */
 export declare function questionToGate(question: AskGateQuestion): OpenGateInput;
 /**
  * Decode a gate answer into the QuestionResult the interactive path produces.

package/dist/types/modes/slash-command-visibility.d.ts

@@ -0,0 +1 @@
+export declare function shouldShowExtensionCommand(name: string, activeProvider: string | undefined): boolean;

package/dist/types/modes/theme/theme.d.ts

@@ -6,7 +6,7 @@ export type SymbolPreset = "unicode" | "nerd" | "ascii";
 /**
  * All available symbol keys organized by category.
  */
-export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.folder" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "checkbox.checked" | "checkbox.unchecked" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers";
+export type SymbolKey = "status.success" | "status.error" | "status.warning" | "status.info" | "status.pending" | "status.disabled" | "status.enabled" | "status.running" | "status.shadowed" | "status.aborted" | "nav.cursor" | "nav.selected" | "nav.expand" | "nav.collapse" | "nav.back" | "tree.branch" | "tree.last" | "tree.vertical" | "tree.horizontal" | "tree.hook" | "boxRound.topLeft" | "boxRound.topRight" | "boxRound.bottomLeft" | "boxRound.bottomRight" | "boxRound.horizontal" | "boxRound.vertical" | "boxSharp.topLeft" | "boxSharp.topRight" | "boxSharp.bottomLeft" | "boxSharp.bottomRight" | "boxSharp.horizontal" | "boxSharp.vertical" | "boxSharp.cross" | "boxSharp.teeDown" | "boxSharp.teeUp" | "boxSharp.teeRight" | "boxSharp.teeLeft" | "sep.powerline" | "sep.powerlineThin" | "sep.powerlineLeft" | "sep.powerlineRight" | "sep.powerlineThinLeft" | "sep.powerlineThinRight" | "sep.block" | "sep.space" | "sep.asciiLeft" | "sep.asciiRight" | "sep.dot" | "sep.slash" | "sep.pipe" | "icon.model" | "icon.plan" | "icon.goal" | "icon.pause" | "icon.folder" | "icon.scratchFolder" | "icon.file" | "icon.git" | "icon.branch" | "icon.pr" | "icon.tokens" | "icon.context" | "icon.cost" | "icon.time" | "icon.pi" | "icon.agents" | "icon.cache" | "icon.input" | "icon.output" | "icon.host" | "icon.session" | "icon.package" | "icon.warning" | "icon.rewind" | "icon.auto" | "icon.fast" | "icon.extensionSkill" | "icon.extensionTool" | "icon.extensionSlashCommand" | "icon.extensionMcp" | "icon.extensionRule" | "icon.extensionHook" | "icon.extensionPrompt" | "icon.extensionContextFile" | "icon.extensionInstruction" | "icon.mic" | "thinking.minimal" | "thinking.low" | "thinking.medium" | "thinking.high" | "thinking.xhigh" | "thinking.max" | "checkbox.checked" | "checkbox.unchecked" | "format.bullet" | "format.dash" | "format.bracketLeft" | "format.bracketRight" | "md.quoteBorder" | "md.hrChar" | "md.bullet" | "lang.default" | "lang.typescript" | "lang.javascript" | "lang.python" | "lang.rust" | "lang.go" | "lang.java" | "lang.c" | "lang.cpp" | "lang.csharp" | "lang.ruby" | "lang.php" | "lang.swift" | "lang.kotlin" | "lang.shell" | "lang.html" | "lang.css" | "lang.json" | "lang.yaml" | "lang.markdown" | "lang.sql" | "lang.docker" | "lang.lua" | "lang.text" | "lang.env" | "lang.toml" | "lang.xml" | "lang.ini" | "lang.conf" | "lang.log" | "lang.csv" | "lang.tsv" | "lang.image" | "lang.pdf" | "lang.archive" | "lang.binary" | "tab.appearance" | "tab.model" | "tab.interaction" | "tab.context" | "tab.editing" | "tab.tools" | "tab.memory" | "tab.tasks" | "tab.providers" | "tab.integrations";
 export type SpinnerType = "status" | "activity";
 export declare const THEME_COLOR_KEYS: readonly ["accent", "border", "borderAccent", "borderMuted", "success", "error", "warning", "muted", "dim", "text", "thinkingText", "selectedBg", "userMessageBg", "userMessageText", "customMessageBg", "customMessageText", "customMessageLabel", "toolPendingBg", "toolSuccessBg", "toolErrorBg", "toolTitle", "toolOutput", "mdHeading", "mdLink", "mdLinkUrl", "mdCode", "mdCodeBlock", "mdCodeBlockBorder", "mdQuote", "mdQuoteBorder", "mdHr", "mdListBullet", "toolDiffAdded", "toolDiffRemoved", "toolDiffContext", "syntaxComment", "syntaxKeyword", "syntaxFunction", "syntaxVariable", "syntaxString", "syntaxNumber", "syntaxType", "syntaxOperator", "syntaxPunctuation", "thinkingOff", "thinkingMinimal", "thinkingLow", "thinkingMedium", "thinkingHigh", "thinkingXhigh", "bashMode", "pythonMode", "statusLineBg", "statusLineSep", "statusLineModel", "statusLinePath", "statusLineGitClean", "statusLineGitDirty", "statusLineContext", "statusLineSpend", "statusLineStaged", "statusLineDirty", "statusLineUntracked", "statusLineOutput", "statusLineCost", "statusLineSubagents"];
 export type ThemeColor = "accent" | "border" | "borderAccent" | "borderMuted" | "success" | "error" | "warning" | "muted" | "dim" | "text" | "thinkingText" | "userMessageText" | "customMessageText" | "customMessageLabel" | "toolTitle" | "toolOutput" | "mdHeading" | "mdLink" | "mdLinkUrl" | "mdCode" | "mdCodeBlock" | "mdCodeBlockBorder" | "mdQuote" | "mdQuoteBorder" | "mdHr" | "mdListBullet" | "toolDiffAdded" | "toolDiffRemoved" | "toolDiffContext" | "syntaxComment" | "syntaxKeyword" | "syntaxFunction" | "syntaxVariable" | "syntaxString" | "syntaxNumber" | "syntaxType" | "syntaxOperator" | "syntaxPunctuation" | "thinkingOff" | "thinkingMinimal" | "thinkingLow" | "thinkingMedium" | "thinkingHigh" | "thinkingXhigh" | "bashMode" | "pythonMode" | "statusLineSep" | "statusLineModel" | "statusLinePath" | "statusLineGitClean" | "statusLineGitDirty" | "statusLineContext" | "statusLineSpend" | "statusLineStaged" | "statusLineDirty" | "statusLineUntracked" | "statusLineOutput" | "statusLineCost" | "statusLineSubagents";

package/dist/types/modes/tmux-scroll.d.ts

@@ -0,0 +1,18 @@
+export declare const TMUX_PREVIOUS_USER_INPUT_SEARCH_PATTERN = "^ *user *$";
+type TmuxScrollFailureReason = "not_inside_tmux" | "tmux_command_failed" | "copy_mode_failed" | "history_bottom_failed" | "search_failed";
+export type TmuxScrollToPreviousUserInputResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: TmuxScrollFailureReason;
+    error?: string;
+};
+interface TmuxSpawnResult {
+    exitCode: number | null;
+    stderr?: {
+        toString(): string;
+    };
+}
+type TmuxSpawnSync = (command: string, args: string[], env: NodeJS.ProcessEnv) => TmuxSpawnResult;
+export declare function scrollTmuxToPreviousUserInput(env?: NodeJS.ProcessEnv, spawnSync?: TmuxSpawnSync): TmuxScrollToPreviousUserInputResult;
+export {};

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

@@ -94,6 +94,7 @@ export interface InteractiveModeContext {
     retryLoader: Loader | undefined;
     autoCompactionEscapeHandler?: () => void;
     retryEscapeHandler?: () => void;
+    retryEscapePrimed: boolean;
     retryCountdownTimer?: NodeJS.Timeout;
     unsubscribe?: () => void;
     onInputCallback?: (input: SubmittedUserInput) => void;
@@ -191,6 +192,7 @@ export interface InteractiveModeContext {
     handleUsageCommand(reports?: UsageReport[] | null): Promise<void>;
     handleChangelogCommand(showFull?: boolean): Promise<void>;
     handleHotkeysCommand(): void;
+    handleHelpCommand(): void;
     handleToolsCommand(): void;
     handleContextCommand(): void;
     handleDumpCommand(): void;
@@ -260,7 +262,9 @@ export interface InteractiveModeContext {
     setHookStatus(key: string, text: string | undefined): void;
     showHookSelector(title: string, options: string[], dialogOptions?: ExtensionUIDialogOptions): Promise<string | undefined>;
     hideHookSelector(): void;
-    showHookInput(title: string, placeholder?: string): Promise<string | undefined>;
+    showHookInput(title: string, placeholder?: string, dialogOptions?: ExtensionUIDialogOptions, inputOptions?: {
+        readonly initialValue?: string;
+    }): Promise<string | undefined>;
     hideHookInput(): void;
     showHookEditor(title: string, prefill?: string, dialogOptions?: ExtensionUIDialogOptions, editorOptions?: {
         promptStyle?: boolean;

package/dist/types/modes/utils/terminal-bell.d.ts

@@ -0,0 +1,3 @@
+export type TerminalBellEvent = "complete" | "approval" | "ask";
+export declare function ringTerminalBell(event: TerminalBellEvent, output?: Pick<NodeJS.WriteStream, "write">): void;
+export declare function classifyHookSelectorBellEvent(title: string): TerminalBellEvent;

package/dist/types/notifications/daemon-paths.d.ts

@@ -0,0 +1,9 @@
+export interface DaemonPaths {
+    dir: string;
+    lock: string;
+    state: string;
+    roots: string;
+    steal: string;
+    aliases: string;
+}
+export declare function daemonPaths(agentDir: string): DaemonPaths;

package/dist/types/notifications/html-format.d.ts

@@ -38,6 +38,8 @@ export declare function markdownToTelegramHtml(markdown: string): string;
  * `marker`. The final string is guaranteed to be <= `max`.
  */
 export declare function truncateTelegramHtml(message: string, max?: number, marker?: string): string;
+/** Split a finished Telegram HTML message into ordered chunks without splitting tags or entities. */
+export declare function splitTelegramHtml(message: string, max?: number): string[];
 /** Finalize an optional message: undefined passthrough, else safe-truncate. */
 export declare function finalizeTelegramHtml(message?: string): string | undefined;
 /**

package/dist/types/notifications/recent-activity.d.ts

@@ -14,6 +14,8 @@ export interface RecentSessionEntry {
     mtimeMs: number;
     /** True when a terminal breadcrumb points at this session file. */
     currentTerminal?: boolean;
+    /** True when this history is an internal helper/sub-agent session. */
+    internal?: boolean;
 }
 export interface RecentActivityDeps {
     /** Root holding `<encoded-cwd>/<sessionId>.jsonl` history files. */
@@ -22,8 +24,10 @@ export interface RecentActivityDeps {
     breadcrumbPaths?: string[];
     /** Max entries to return (default 20). */
     limit?: number;
+    /** Include internal helper/sub-agent sessions (default true). */
+    includeInternal?: boolean;
     /** Injection seam for tests. */
-    readFirstLine?: (file: string) => string | undefined;
+    readInitialLines?: (file: string, maxLines: number) => string[];
 }
 /**
  * List recent sessions ranked by history-file mtime (newest first).

package/dist/types/notifications/telegram-daemon-cli.d.ts

@@ -1,11 +1,28 @@
-import { Settings } from "../config/settings";
-import { TelegramNotificationDaemon } from "./telegram-daemon";
+import type { Settings } from "../config/settings";
+import type { TelegramDaemonOptions } from "./telegram-daemon";
+type TelegramDaemonRunner = {
+    run(): Promise<void>;
+    requestStop(reason?: "reload" | "signal" | "stop"): void;
+};
+type TelegramDaemonConstructor = new (opts: TelegramDaemonOptions) => TelegramDaemonRunner;
 export interface RunDaemonInternalDeps {
-    SettingsImpl?: Pick<typeof Settings, "init">;
-    DaemonImpl?: typeof TelegramNotificationDaemon;
+    SettingsImpl?: {
+        init: (options?: {
+            agentDir?: string;
+        }) => Promise<Pick<Settings, "get" | "getAgentDir">>;
+    };
+    DaemonImpl?: TelegramDaemonConstructor;
     processPid?: number;
+    pidAlive?: (pid: number) => boolean;
 }
+export declare function createLightweightDaemonSettings(input: {
+    agentDir: string;
+    rawConfig?: unknown;
+}): Pick<Settings, "get" | "getAgentDir">;
+export declare function loadLightweightDaemonSettings(agentDir: string): Promise<Pick<Settings, "get" | "getAgentDir">>;
+export declare function ownerPidFromOwnerId(ownerId: string): number | undefined;
 export declare function runDaemonSmoke(opts?: {
     agentDir?: string;
 }): Promise<void>;
 export declare function runDaemonInternal(argv: string[], deps?: RunDaemonInternalDeps): Promise<void>;
+export {};

package/dist/types/notifications/telegram-daemon-control.d.ts

@@ -29,6 +29,14 @@ export interface TelegramDaemonControlDeps {
     sendSignal?: (pid: number, signal: NodeJS.Signals) => void;
     spawn?: TelegramDaemonDeps["spawn"];
     execPath?: string;
+    /**
+     * Stable process id encoded into freshly-spawned daemon owner ids.
+     *
+     * The daemon-internal entrypoint rejects numeric owner ids whose process is
+     * already gone. `skc daemon reload` is a short-lived CLI process, so using its
+     * own pid can race the child startup and make the replacement exit immediately.
+     */
+    ownerPid?: number;
     randomId?: () => string;
     sleep?: (ms: number) => Promise<void>;
     waitStepMs?: number;

package/dist/types/notifications/telegram-daemon.d.ts

@@ -16,14 +16,6 @@ export interface DaemonState {
     version: 1;
     stoppedAt?: number;
 }
-export interface DaemonPaths {
-    dir: string;
-    lock: string;
-    state: string;
-    roots: string;
-    steal: string;
-    aliases: string;
-}
 export interface TelegramDaemonFs {
     mkdir(path: string, opts?: fs.MakeDirectoryOptions): Promise<void>;
     readFile(path: string, encoding: BufferEncoding): Promise<string>;
@@ -59,7 +51,7 @@ export declare const DAEMON_VERSION = 1;
 export declare const CLIENT_PING_PONG_CAPABILITY = "client_ping_pong";
 /** Protocol version the daemon advertises in its ClientHello. */
 export declare const NOTIFICATION_PROTOCOL_VERSION = 2;
-export declare function daemonPaths(agentDir: string): DaemonPaths;
+export { type DaemonPaths, daemonPaths } from "./daemon-paths";
 /**
  * Attach session-lifecycle control (create/close/resume) to the running daemon.
  *
@@ -241,6 +233,7 @@ export interface TelegramDaemonOptions {
 interface SessionSocket {
     sessionId: string;
     token: string;
+    endpointKey: string;
     ws: WebSocket;
     pending: Map<string, {
         sessionId: string;
@@ -275,6 +268,8 @@ export declare class TelegramNotificationDaemon {
     private readonly topicOwnerByIdentity;
     /** Non-identity frames held until identity creates the correct thread. */
     private readonly pendingThreadedFrames;
+    /** Endpoint generation tombstones for sessions that already sent session_closed. */
+    private readonly closedEndpointKeys;
     /** True once the daemon has nudged the user to enable Threaded Mode. */
     private threadedFallbackNoticeSent;
     /** Sessions whose identity header was already sent flat (Threaded Mode off). */
@@ -390,4 +385,3 @@ export declare class TelegramNotificationDaemon {
     run(): Promise<void>;
     private controlStopRequested;
 }
-export {};

package/dist/types/notifications/telegram-reference.d.ts

@@ -23,6 +23,7 @@ export interface RenderedMessage {
     text: string;
     inline_keyboard?: InlineButton[][];
 }
+type TelegramSend = (method: string, body: unknown) => Promise<Response>;
 /** Encode `actionId` + option `index` into Telegram callback_data (<=64 bytes). */
 export declare function encodeCallbackData(actionId: string, index: number): string;
 /** Decode callback_data produced by {@link encodeCallbackData}. */
@@ -58,6 +59,8 @@ export declare function buildActionMessage(action: {
     options?: string[];
     summary?: string;
 }): RenderedMessage;
+/** Send Telegram HTML text chunks sequentially so long messages preserve order. */
+export declare function sendTelegramHtmlChunks(send: TelegramSend, chatId: string, text: string, inlineKeyboard?: InlineButton[][]): Promise<void>;
 /** A protocol `reply` frame the client should send to the server. */
 export interface ReplyFrame {
     type: "reply";
@@ -111,3 +114,4 @@ export interface TelegramReferenceOptions {
  * production clients add reconnection, multi-chat routing, and persistence.
  */
 export declare function runTelegramReferenceClient(opts: TelegramReferenceOptions): Promise<void>;
+export {};

package/dist/types/notifications/threaded-render.d.ts

@@ -42,6 +42,7 @@ interface ThreadedFrame {
     tokenUsage?: unknown;
     model?: unknown;
     diff?: unknown;
+    cwd?: unknown;
     phase?: unknown;
     text?: unknown;
     messageRef?: unknown;

package/dist/types/runtime-mcp/config-writer.d.ts

@@ -69,6 +69,15 @@ export declare function getMCPServer(filePath: string, name: string): Promise<MC
  * List all server names in a config file.
  */
 export declare function listMCPServers(filePath: string): Promise<string[]>;
+/**
+ * Set a server's autoload flag (connect automatically at session startup).
+ *
+ * Autoload defaults to true, so turning it on removes the key to keep the
+ * config file free of redundant fields; turning it off writes `autoload: false`.
+ *
+ * @throws Error if the server doesn't exist
+ */
+export declare function setServerAutoload(filePath: string, name: string, autoload: boolean): Promise<void>;
 /**
  * Read the disabled servers list from a config file.
  */

package/dist/types/runtime-mcp/config.d.ts

@@ -13,6 +13,8 @@ export interface LoadMCPConfigsOptions {
     filterExa?: boolean;
     /** Whether to filter out browser MCP servers when builtin browser tool is enabled (default: false) */
     filterBrowser?: boolean;
+    /** Only include servers eligible for startup connection, i.e. autoload !== false (default: false) */
+    autoloadOnly?: boolean;
 }
 /** Result of loading MCP configs */
 export interface LoadMCPConfigsResult {

package/dist/types/runtime-mcp/loader.d.ts

@@ -28,6 +28,8 @@ export interface MCPToolsLoadOptions {
     filterExa?: boolean;
     /** Whether to filter out browser MCP servers when builtin browser tool is enabled (default: false) */
     filterBrowser?: boolean;
+    /** Only connect servers with autoload !== false (default: false) */
+    autoloadOnly?: boolean;
     /** SQLite storage for MCP tool cache (null disables cache) */
     cacheStorage?: AgentStorage | null;
     /** Auth storage used to resolve OAuth credentials before initial MCP connect */

package/dist/types/runtime-mcp/manager.d.ts

@@ -38,6 +38,8 @@ export interface MCPDiscoverOptions {
     filterExa?: boolean;
     /** Whether to filter out browser MCP servers when builtin browser tool is enabled (default: false) */
     filterBrowser?: boolean;
+    /** Only connect servers with autoload !== false (default: false) */
+    autoloadOnly?: boolean;
     /** Called when starting to connect to servers */
     onConnecting?: (serverNames: string[]) => void;
 }

package/dist/types/runtime-mcp/types.d.ts

@@ -45,6 +45,12 @@ export interface MCPAuthConfig {
 interface MCPServerConfigBase {
     /** Whether this server is enabled (default: true) */
     enabled?: boolean;
+    /**
+     * Whether to connect this server automatically at session startup (default: true).
+     * When false the server stays configured-but-disconnected until connected
+     * explicitly (e.g. `/mcp connect <name>`).
+     */
+    autoload?: boolean;
     /** Connection timeout in milliseconds (default: 30000) */
     timeout?: number;
     /** Authentication configuration (optional) */

package/dist/types/sdk.d.ts

@@ -47,7 +47,7 @@ export interface CreateAgentSessionOptions {
         requestedModel: Model;
         reason: string;
     };
-    /** Models available for cycling (Ctrl+P in interactive mode) */
+    /** Models available for cycling (Alt+N in interactive mode) */
     scopedModels?: ScopedModelSelection[];
     /** System prompt blocks. Array replaces default, function receives default blocks and returns final blocks. */
     systemPrompt?: string[] | ((defaultPrompt: string[]) => string[]);

package/dist/types/skc-runtime/launch-tmux.d.ts

@@ -1,6 +1,6 @@
 import type { Args } from "../cli/args";
-import { buildSkcTmuxProfileCommands, SKC_DEFAULT_TMUX_SESSION, SKC_TMUX_COMMAND_ENV, SKC_TMUX_MOUSE_ENV, SKC_TMUX_PROFILE_ENV, SKC_TMUX_SESSION_PREFIX, type SkcTmuxProfileCommand } from "./tmux-common";
-export { buildSkcTmuxProfileCommands, SKC_DEFAULT_TMUX_SESSION, SKC_TMUX_COMMAND_ENV, SKC_TMUX_MOUSE_ENV, SKC_TMUX_PROFILE_ENV, SKC_TMUX_SESSION_PREFIX, };
+import { buildSkcTmuxExactSessionTarget, buildSkcTmuxProfileCommands, SKC_DEFAULT_TMUX_SESSION, SKC_TMUX_COMMAND_ENV, SKC_TMUX_MOUSE_ENV, SKC_TMUX_PROFILE_ENV, SKC_TMUX_SESSION_PREFIX, type SkcTmuxProfileCommand } from "./tmux-common";
+export { buildSkcTmuxExactSessionTarget, buildSkcTmuxProfileCommands, SKC_DEFAULT_TMUX_SESSION, SKC_TMUX_COMMAND_ENV, SKC_TMUX_MOUSE_ENV, SKC_TMUX_PROFILE_ENV, SKC_TMUX_SESSION_PREFIX, };
 export declare const SKC_TMUX_LAUNCHED_ENV = "SKC_TMUX_LAUNCHED";
 export declare const SKC_LAUNCH_POLICY_ENV = "SKC_LAUNCH_POLICY";
 export declare const SKC_TMUX_WINDOW_LABEL_MAX_WIDTH = 48;

package/dist/types/skc-runtime/ralplan-runtime.d.ts

@@ -10,8 +10,9 @@
  *    that lives in the bundled `/skill:ralplan` skill — but it accepts every documented flag so
  *    scripted users see a useful response and the active run is visible to the TUI.
  *
- * 2. **Artifact write**: `skc ralplan --write --stage <type> --stage_n <N> --artifact
- *    <path-or-string> [--run-id <id>] [--session-id <id>] [--json]` persists Planner / Architect
+ * 2. **Artifact write**: `skc ralplan --write --stage <type> --stage_n <N>
+ *    (--artifact <path-or-string> | --artifact-env SKC_RALPLAN_ARTIFACT)
+ *    [--run-id <id>] [--session-id <id>] [--json]` persists Planner / Architect
  *    / Critic / revision / post-interview / ADR / final markdown under `.skc/plans/ralplan/<run-id>/`, maintains
  *    an `index.jsonl` audit log, copies `final` stages to `pending-approval.md`, and advances
  *    the HUD chip to reflect the latest persisted stage.

package/dist/types/skc-runtime/restricted-role-agent-bash.d.ts

@@ -1,2 +1,3 @@
 export declare const SKC_RESTRICTED_ROLE_AGENT_BASH_ENV = "SKC_RESTRICTED_ROLE_AGENT_BASH";
+export declare const SKC_RALPLAN_ARTIFACT_ENV = "SKC_RALPLAN_ARTIFACT";
 export declare function isRestrictedRoleAgentBash(): boolean;