@sayknow-cli/coding-agent 0.3.1 → 0.3.2

package/dist/types/extensibility/skc-plugins/types.d.ts

@@ -7,12 +7,56 @@ export declare const SKC_SUBSKILL_PARENT_AGENTS: readonly ["executor", "architec
 export type SkcSubskillParentAgent = (typeof SKC_SUBSKILL_PARENT_AGENTS)[number];
 export type SkcSubskillParent = SkcSubskillParentSkill | SkcSubskillParentAgent;
 export declare const SKC_AGENT_SUBSKILL_PHASES: Record<SkcSubskillParentAgent, string[]>;
+export interface SkcPluginToolManifestEntry {
+    name: string;
+    path: string;
+    description?: string;
+    sha256?: string;
+    /**
+     * "always-on" object entries are activated for the whole session; legacy
+     * string shorthand stays "subskill"-scoped and is only attached to subskill
+     * bindings (never registered as an always-on tool surface).
+     */
+    surface: "subskill" | "always-on";
+}
+export interface SkcPluginHookManifestEntry {
+    name: string;
+    event: string;
+    target?: string;
+    phase?: "before" | "after";
+    path: string;
+    sha256?: string;
+}
+export type SkcPluginMcpTransport = "stdio" | "http" | "sse";
+export interface SkcPluginMcpManifestEntry {
+    name: string;
+    transport: SkcPluginMcpTransport;
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    sha256?: string;
+}
+export interface SkcPluginAppendixManifestEntry {
+    name: string;
+    path?: string;
+    content?: string;
+    sha256?: string;
+}
+export interface SkcPluginAgentAppendixManifestEntry extends SkcPluginAppendixManifestEntry {
+    agent: SkcSubskillParentAgent;
+}
 export interface SkcPluginManifest {
     name: string;
     version: string;
     kind: "sayknow-cli-plugin";
     subskills: string[];
-    tools: string[];
+    tools: SkcPluginToolManifestEntry[];
+    hooks: SkcPluginHookManifestEntry[];
+    mcps: SkcPluginMcpManifestEntry[];
+    systemAppendix: SkcPluginAppendixManifestEntry[];
+    agentAppendix: SkcPluginAgentAppendixManifestEntry[];
 }
 export interface SubskillFrontmatter {
     name: string;
@@ -57,8 +101,120 @@ export interface LoadedSkcPlugin {
     bindings: LoadedSubskillBinding[];
     toolBindings: PhaseScopedToolBinding[];
 }
-export type SkcPluginLoadErrorCode = "forbidden_surface" | "invalid_manifest" | "invalid_frontmatter" | "invalid_parent" | "invalid_phase" | "duplicate_arg" | "duplicate_parent_phase" | "missing_file" | "invalid_kind";
+export type SkcPluginLoadErrorCode = "forbidden_surface" | "invalid_manifest" | "invalid_kind" | "unsupported_surface" | "invalid_frontmatter" | "invalid_parent" | "invalid_phase" | "missing_file" | "hash_mismatch" | "invalid_appendix" | "invalid_hook" | "invalid_mcp" | "duplicate_arg" | "duplicate_parent_phase" | "duplicate_tool" | "duplicate_hook" | "duplicate_mcp" | "duplicate_appendix" | "security_policy" | "install_conflict" | "session_collision" | "runtime_mismatch" | "quarantined_surface";
 export declare class SkcPluginLoadError extends Error {
     readonly code: SkcPluginLoadErrorCode;
     constructor(code: SkcPluginLoadErrorCode, message: string, options?: ErrorOptions);
 }
+export type SkcPluginScope = "user" | "project";
+export type SkcPluginSourceKind = "path" | "git" | "tarball";
+export interface SkcPluginCopiedFile {
+    relativePath: string;
+    sha256: string;
+    bytes: number;
+}
+export interface NormalizedSubskillSurface {
+    extensionId: string;
+    name: string;
+    description: string;
+    parent: string;
+    phase: string;
+    activationArg: string;
+    relativePath: string;
+    sha256: string;
+}
+export interface NormalizedToolSurface {
+    extensionId: string;
+    name: string;
+    relativePath: string;
+    sha256: string;
+    description?: string;
+}
+export interface NormalizedHookSurface {
+    extensionId: string;
+    name: string;
+    event: string;
+    target?: string;
+    phase?: "before" | "after";
+    relativePath: string;
+    sha256: string;
+}
+export interface NormalizedMcpSurface {
+    extensionId: string;
+    name: string;
+    transport: SkcPluginMcpTransport;
+    configHash: string;
+    config: SkcPluginMcpManifestEntry;
+}
+export interface NormalizedAppendixSurface {
+    extensionId: string;
+    name: string;
+    relativePath?: string;
+    /** Inline appendix body (when the manifest used `content` instead of `path`). */
+    content?: string;
+    contentHash: string;
+    bytes: number;
+}
+export interface NormalizedAgentAppendixSurface extends NormalizedAppendixSurface {
+    agent: SkcSubskillParentAgent;
+}
+export interface NormalizedSkcPluginSurfaces {
+    subskills: NormalizedSubskillSurface[];
+    tools: NormalizedToolSurface[];
+    hooks: NormalizedHookSurface[];
+    mcps: NormalizedMcpSurface[];
+    systemAppendices: NormalizedAppendixSurface[];
+    agentAppendices: NormalizedAgentAppendixSurface[];
+}
+/**
+ * Result of the pure compile step. Computed from manifest, frontmatter, and
+ * declared files read as bytes only — never by importing plugin code.
+ */
+export interface NormalizedSkcPluginBundle {
+    name: string;
+    version: string;
+    root: string;
+    manifestPath: string;
+    manifestHash: string;
+    surfaces: NormalizedSkcPluginSurfaces;
+    files: SkcPluginCopiedFile[];
+}
+export interface SkcPluginQuarantineEntry {
+    surfaceId: string;
+    code: SkcPluginLoadErrorCode;
+    message: string;
+    detectedAt: string;
+}
+export interface SkcPluginRegistrySource {
+    kind: SkcPluginSourceKind;
+    uri: string;
+    ref?: string;
+    sha?: string;
+    resolvedAt: string;
+}
+export interface SkcPluginRegistryEntry {
+    name: string;
+    version: string;
+    scope: SkcPluginScope;
+    enabled: boolean;
+    pluginRoot: string;
+    manifestPath: string;
+    manifestHash: string;
+    source: SkcPluginRegistrySource;
+    installedAt: string;
+    updatedAt: string;
+    copiedFiles: SkcPluginCopiedFile[];
+    surfaces: NormalizedSkcPluginSurfaces;
+    disabledSurfaceIds: string[];
+    quarantine?: SkcPluginQuarantineEntry[];
+}
+export interface SkcPluginRegistry {
+    version: 1;
+    scope: SkcPluginScope;
+    plugins: SkcPluginRegistryEntry[];
+}
+/**
+ * Stable identifiers for plugin-contributed surfaces used by observability,
+ * disabledSurfaceIds, and quarantine bookkeeping.
+ */
+export type SkcPluginSurfaceExtensionId = string;

package/dist/types/extensibility/skc-plugins/validation.d.ts

@@ -1,4 +1,11 @@
-import { type LoadedSubskillBinding, type SubskillFrontmatter } from "./types";
+import { type LoadedSubskillBinding, type NormalizedSkcPluginBundle, type SkcPluginRegistryEntry, type SubskillFrontmatter } from "./types";
 export declare function validateBinding(fm: SubskillFrontmatter): void;
 export declare function buildParentArgMap(bindings: readonly LoadedSubskillBinding[]): Map<string, Map<string, LoadedSubskillBinding>>;
 export declare function buildParentPhaseSet(bindings: readonly LoadedSubskillBinding[]): Set<string>;
+/**
+ * Hard install-time collision + security validation for a compiled bundle
+ * against the effective installed registry (other plugins in the target scope
+ * universe). Collisions are hard errors; the registry is the collision
+ * authority, never capability first-wins.
+ */
+export declare function validateInstallPlan(bundle: NormalizedSkcPluginBundle, effectiveEntries: readonly SkcPluginRegistryEntry[]): void;

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

@@ -30,7 +30,6 @@ export declare const en: {
     readonly "settings.tab.appearance": "Appearance";
     readonly "settings.tab.model": "Model";
     readonly "settings.tab.interaction": "Interaction";
-    readonly "settings.tab.notifications": "Notifications";
     readonly "settings.tab.context": "Context";
     readonly "settings.tab.memory": "Memory";
     readonly "settings.tab.editing": "Editing";

package/dist/types/main.d.ts

@@ -12,6 +12,7 @@ import type { SubmittedUserInput } from "./modes/types";
 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";
 export interface InteractiveModeNotify {
     kind: "warn" | "error" | "info";
     message: string;
@@ -48,6 +49,7 @@ export declare function applyStartupModelProfilesOrExit(args: Parameters<typeof
  * tool registry and shadow the client-supplied servers (issue #1234).
  */
 export declare function createAcpSessionFactory(args: AcpSessionFactoryOptions): AcpSessionFactory;
+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
  * (system prompt, restricted toolset, custom python tool) and assert the tool

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

@@ -1,6 +1,6 @@
 import { Editor, type KeyId } from "@sayknow-cli/tui";
 import { type AppKeybinding } from "../../config/keybindings";
-type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.message.queue" | "app.clipboard.pasteImage" | "app.clipboard.copyPrompt">;
+type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.message.followUp" | "app.message.queue" | "app.clipboard.pasteImage" | "app.clipboard.copyPrompt">;
 type PastePendingClearReason = "timeout" | "queue-limit";
 /**
  * Custom editor that handles configurable app-level shortcuts for coding-agent.

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

@@ -38,7 +38,15 @@ export declare class ModelSelectorComponent extends Container {
         sessionId?: string;
         isFastForProvider?: (provider?: string) => boolean;
         isFastForSubagentProvider?: (provider?: string) => boolean;
+        isCurrentModelFastModeActive?: () => boolean;
+        currentThinkingLevel?: ThinkingLevel;
+        activeModelProfile?: string;
     });
+    refreshRoleAssignments(options?: {
+        currentModel?: Model;
+        currentThinkingLevel?: ThinkingLevel;
+        activeModelProfile?: string;
+    }): void;
     handleInput(keyData: string): void;
     getSearchInput(): Input;
     __testSelectProfile(profileName: string, setDefault: boolean): Promise<void>;

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

@@ -37,7 +37,6 @@ export interface SubmenuSettingDef extends BaseSettingDef {
 }
 export interface TextInputSettingDef extends BaseSettingDef {
     type: "text";
-    secret?: boolean;
 }
 export type SettingDef = BooleanSettingDef | EnumSettingDef | SubmenuSettingDef | TextInputSettingDef;
 /** Get all setting definitions with UI */

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

@@ -1,3 +1,4 @@
+import type { GitHeadState } from "../../../utils/git";
 /**
  * Extract "owner/repo" from a GitHub remote URL.
  * Handles HTTPS, SSH (scp-style), and git:// protocols.
@@ -20,3 +21,8 @@ export declare function canReuseCachedPr(cachedPr: {
     number: number;
     url: string;
 } | null | undefined, cachedContext: PrCacheContext | undefined, currentContext: PrCacheContext | null): boolean;
+export interface CurrentBranchState {
+    readonly branch: string | null;
+    readonly repoId: string | null;
+}
+export declare function resolveCurrentBranch(cwd: string, resolveHead?: (cwd: string) => GitHeadState | null): CurrentBranchState;

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

@@ -325,6 +325,105 @@ export declare const defaultThemes: {
             "preset": string;
         };
     };
+    "gruvbox-dark": {
+        $schema: string;
+        name: string;
+        vars: {
+            "bgHard": string;
+            "surface": string;
+            "surfaceBright": string;
+            "borderNeutral": string;
+            "borderSubtle": string;
+            "fg": string;
+            "muted": string;
+            "dim": string;
+            "gray": string;
+            "red": string;
+            "green": string;
+            "yellow": string;
+            "blue": string;
+            "purple": string;
+            "aqua": string;
+            "orange": string;
+            "diffRemovalRed": string;
+        };
+        colors: {
+            "accent": string;
+            "border": string;
+            "borderAccent": string;
+            "borderMuted": string;
+            "success": string;
+            "error": string;
+            "warning": string;
+            "muted": string;
+            "dim": string;
+            "text": string;
+            "thinkingText": string;
+            "selectedBg": string;
+            "userMessageBg": string;
+            "userMessageText": string;
+            "customMessageBg": string;
+            "customMessageText": string;
+            "customMessageLabel": string;
+            "toolPendingBg": string;
+            "toolSuccessBg": string;
+            "toolErrorBg": string;
+            "toolTitle": string;
+            "toolOutput": string;
+            "mdHeading": string;
+            "mdLink": string;
+            "mdLinkUrl": string;
+            "mdCode": string;
+            "mdCodeBlock": string;
+            "mdCodeBlockBorder": string;
+            "mdQuote": string;
+            "mdQuoteBorder": string;
+            "mdHr": string;
+            "mdListBullet": string;
+            "toolDiffAdded": string;
+            "toolDiffRemoved": string;
+            "toolDiffContext": string;
+            "syntaxComment": string;
+            "syntaxKeyword": string;
+            "syntaxFunction": string;
+            "syntaxVariable": string;
+            "syntaxString": string;
+            "syntaxNumber": string;
+            "syntaxType": string;
+            "syntaxOperator": string;
+            "syntaxPunctuation": string;
+            "thinkingOff": string;
+            "thinkingMinimal": string;
+            "thinkingLow": string;
+            "thinkingMedium": string;
+            "thinkingHigh": string;
+            "thinkingXhigh": string;
+            "bashMode": string;
+            "pythonMode": string;
+            "statusLineBg": string;
+            "statusLineSep": string;
+            "statusLineModel": string;
+            "statusLinePath": string;
+            "statusLineGitClean": string;
+            "statusLineGitDirty": string;
+            "statusLineContext": string;
+            "statusLineSpend": string;
+            "statusLineStaged": string;
+            "statusLineDirty": string;
+            "statusLineUntracked": string;
+            "statusLineOutput": string;
+            "statusLineCost": string;
+            "statusLineSubagents": string;
+        };
+        export: {
+            "pageBg": string;
+            "cardBg": string;
+            "infoBg": string;
+        };
+        symbols: {
+            "preset": string;
+        };
+    };
     opencode: {
         $schema: string;
         name: string;

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.notifications" | "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";
 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/notifications/html-format.d.ts

@@ -49,10 +49,21 @@ export declare function finalizeTelegramHtml(message?: string): string | undefin
  * `1. 1. …` and keeps the displayed number aligned with the button's real index.
  */
 export declare function buttonLabel(label: string, index: number): string;
+/** Numbered, escaped option list for the Telegram message body. */
+export declare function numberedOptionList(labels: string[]): string;
+/** Compact numeric button label; full option text belongs in the message body. */
+export declare function choiceButtonLabel(index: number): string;
 export interface InlineButton {
     text: string;
     callback_data: string;
 }
+/**
+ * Lay out option callbacks as compact numeric buttons. Telegram mobile clients
+ * ellipsize long inline-keyboard labels and tall keyboards can be obscured by
+ * the composer, so the full choice text is rendered in the message body while
+ * the keyboard keeps only stable one-based tap targets.
+ */
+export declare function buildCompactChoiceGrid(labels: string[], callbackForIndex: (index: number) => string): InlineButton[][];
 /**
  * Lay out option labels as a numbered button grid. Long buttons take a
  * full-width row; runs of short buttons are packed into rows of up to 3. The

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

@@ -12,12 +12,160 @@
  * - `ask` (unattended/RPC): observes emitted workflow gates and resolves the real
  *   gate on a remote reply via `ctx.workflowGate`.
  * - `turn_end` -> `action_needed` (kind `idle`, deduped per turn).
- * - `session_shutdown` -> stop the server + deregister the answer source.
+ * - `session_shutdown` -> `session_closed` frame, stop server, deregister answer source.
  *
  * Enable with Settings notifications config, `SKC_NOTIFICATIONS=1` (a token is
  * generated), or `SKC_NOTIFICATIONS_TOKEN`.
  */
 import type { ExtensionFactory } from "../extensibility/extensions";
+/** Where a `session_create` should run. Discriminated by `kind`. */
+export type SessionCreateTarget = {
+    kind: "existing_path";
+    path: string;
+} | {
+    kind: "worktree";
+    repo: string;
+    branch: string;
+} | {
+    kind: "plain_dir";
+    path: string;
+};
+/** Identifies the session a `session_close` targets. */
+export interface SessionCloseTarget {
+    sessionId: string;
+    /** Expected SKC-managed tmux session name (defense-in-depth match). */
+    tmuxSession?: string;
+    /** Expected `@skc-session-state-file` tag (defense-in-depth match). */
+    sessionStateFile?: string;
+}
+/** Identifies the session a `session_resume` targets. */
+export interface SessionResumeTarget {
+    sessionIdOrPrefix: string;
+    /** Optional repo/working-dir hint to disambiguate matches. */
+    path?: string;
+}
+/** Create a new session. */
+export interface SessionCreateFrame {
+    type: "session_create";
+    requestId: string;
+    /** Deterministic lifecycle marker preallocated by the daemon before spawn. */
+    lifecycleRequestId: string;
+    /** Session id the daemon preallocated and propagates to the child. */
+    intendedSessionId: string;
+    /** Telegram update id (idempotency key on the daemon side). */
+    updateId: number;
+    chatId: string;
+    /** Control-endpoint token authorizing this frame. */
+    token: string;
+    target: SessionCreateTarget;
+    /** Reference to the daemon-written, once-consumed startup-prompt file. */
+    startupPromptRef?: string;
+}
+/** Close (hard-kill, history preserved) a session. */
+export interface SessionCloseFrame {
+    type: "session_close";
+    requestId: string;
+    updateId: number;
+    chatId: string;
+    token: string;
+    target: SessionCloseTarget;
+    /** Hard-kill even if a live pane is attached (SKC-managed only). */
+    force?: boolean;
+}
+/** Resume a session (reattach if alive, else cold-restart from history). */
+export interface SessionResumeFrame {
+    type: "session_resume";
+    requestId: string;
+    updateId: number;
+    chatId: string;
+    token: string;
+    target: SessionResumeTarget;
+    startupPromptRef?: string;
+}
+/** Any client -> ingress lifecycle request frame. */
+export type SessionLifecycleRequest = SessionCreateFrame | SessionCloseFrame | SessionResumeFrame;
+/** Terminal status of a lifecycle request. */
+export type LifecycleStatus = "ok" | "error";
+/** A connected session's per-session endpoint, returned to the control client. */
+export interface LifecycleEndpoint {
+    url: string;
+    token: string;
+}
+/** The Telegram topic/thread a session is surfaced in. */
+export interface LifecycleTopic {
+    chatId: string;
+    threadId: string;
+}
+/** How a create request was correlated to its spawned session. */
+export type MatchedBy = "spawn_marker" | "session_ready";
+/** Response to a successful `session_create`. */
+export interface SessionCreateResponseFrame {
+    type: "session_create_response";
+    requestId: string;
+    status: LifecycleStatus;
+    lifecycleRequestId: string;
+    sessionId: string;
+    matchedBy: MatchedBy;
+    endpoint: LifecycleEndpoint;
+    topic: LifecycleTopic;
+    target: SessionCreateTarget;
+}
+/** Response to a successful `session_close`. */
+export interface SessionCloseResponseFrame {
+    type: "session_close_response";
+    requestId: string;
+    status: LifecycleStatus;
+    sessionId: string;
+    processGone: boolean;
+    historyPreserved: boolean;
+    endpointStale: boolean;
+}
+/** Whether a resume reattached to a live session or cold-restarted a dead one. */
+export type ResumeMode = "reattached" | "cold_restarted";
+/** Response to a successful `session_resume`. */
+export interface SessionResumeResponseFrame {
+    type: "session_resume_response";
+    requestId: string;
+    status: LifecycleStatus;
+    sessionId: string;
+    mode: ResumeMode;
+    endpoint: LifecycleEndpoint;
+    topic: LifecycleTopic;
+}
+/** Machine-readable reason a lifecycle request failed. */
+export type LifecycleErrorReason = "unauthorized" | "rate_limited" | "duplicate_conflict" | "invalid_target" | "ambiguous_target" | "spawn_failed" | "discovery_timeout" | "readiness_timeout" | "close_refused" | "not_found" | "terminal_uncertain";
+/** A candidate returned with an `ambiguous_target` resume error. */
+export interface ResumeCandidate {
+    sessionId: string;
+    path?: string;
+    /** Last-activity epoch-millis (session history file mtime), if known. */
+    mtimeMs?: number;
+}
+/** A structured lifecycle error frame. */
+export interface SessionLifecycleErrorFrame {
+    type: "session_lifecycle_error";
+    requestId: string;
+    status: LifecycleStatus;
+    reason: LifecycleErrorReason;
+    message: string;
+    candidates?: ResumeCandidate[];
+}
+/** Any ingress -> client lifecycle response frame. */
+export type SessionLifecycleResponse = SessionCreateResponseFrame | SessionCloseResponseFrame | SessionResumeResponseFrame | SessionLifecycleErrorFrame;
+/**
+ * Replayable per-session readiness signal (mirror of the Rust `session_ready`
+ * frame). Buffered and replayed to late clients so WS-open alone never implies
+ * the session is live and surfaced.
+ */
+export interface SessionReadyFrame {
+    type: "session_ready";
+    sessionId: string;
+    lifecycleRequestId?: string;
+    startupPromptRef?: string;
+    repo?: string;
+    branch?: string;
+    title?: string;
+}
 /**
  * Best-effort real repository name (no git spawn): resolves the main worktree
  * root directory so linked worktrees report the repo (e.g. `sayknow-cli`)

package/dist/types/notifications/lifecycle-commands.d.ts

@@ -0,0 +1,60 @@
+import type { SessionCloseTarget, SessionCreateTarget, SessionLifecycleResponse, SessionResumeTarget } from "./index";
+export type LifecycleCommandVerb = "session_create" | "session_close" | "session_resume";
+/** A parsed, validated lifecycle command (transport identity added by caller). */
+export type ParsedLifecycleCommand = {
+    kind: "create";
+    target: SessionCreateTarget;
+} | {
+    kind: "close";
+    target: SessionCloseTarget;
+} | {
+    kind: "resume";
+    target: SessionResumeTarget;
+} | {
+    kind: "recent";
+    which: "create" | "resume" | "all";
+} | {
+    kind: "usage";
+    message: string;
+} | {
+    kind: "reject";
+    reason: "invalid_target" | "prompt_unsupported";
+    message: string;
+} | {
+    kind: "none";
+};
+/** True when the text begins a /session_* command (cheap pre-gate). */
+export declare function isLifecycleCommandText(text: string | undefined): boolean;
+/**
+ * Parse a paired-chat message into a lifecycle command. Returns `none` for
+ * non-lifecycle text, `usage`/`reject` for malformed input (no side effect), or
+ * a validated `create`/`close`/`resume`/`recent` intent.
+ *
+ * The caller MUST have already enforced paired-chat authorization; this function
+ * performs grammar + target validation only.
+ */
+export declare function parseLifecycleCommand(text: string | undefined): ParsedLifecycleCommand;
+/** The canonical usage text (exported for the daemon's help replies). */
+export declare function lifecycleUsage(): string;
+/**
+ * Shared target validator reused at the policy/effect boundary (after paired-chat
+ * auth, before any side effect). Returns null when valid, or an `invalid_target`
+ * reason. The orchestrator remains authoritative; this is a defensive pre-check
+ * the parser and any other entry point share.
+ */
+export declare function validateLifecycleTarget(verb: LifecycleCommandVerb, target: SessionCreateTarget | SessionCloseTarget | SessionResumeTarget): {
+    ok: true;
+} | {
+    ok: false;
+    reason: "invalid_target";
+    message: string;
+};
+export declare function normalizeLifecyclePath(value: string): string | undefined;
+/**
+ * Map a lifecycle response/error to a user-facing Telegram message (G010).
+ *
+ * Only derives text from sessionId, mode, reason, a safe message, and candidate
+ * {sessionId,path} — never a token or prompt. Each error reason gets tailored,
+ * actionable copy; an "in progress" pending response is surfaced distinctly.
+ */
+export declare function formatLifecycleOutcome(r: SessionLifecycleResponse): string;