@sayknow-cli/coding-agent 0.3.0 → 0.3.1

package/dist/types/cli/notify-cli.d.ts

@@ -17,6 +17,8 @@ export interface NotifyCommandDeps {
     pollIntervalMs?: number;
     setupChatId?: string;
     setupRedact?: boolean;
+    setupInteractive?: boolean;
+    threadedModePrompt?: (message: string) => Promise<string>;
 }
 export declare function parseNotifyArgs(args: string[]): NotifyCommandArgs | undefined;
 export declare function runNotifyCommand(cmd: NotifyCommandArgs, deps?: NotifyCommandDeps): Promise<void>;

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

@@ -10,7 +10,7 @@ import { type SkillDiscoverySettings } from "./skill-settings-defaults";
  *   settings.get("compaction.enabled")  // => boolean
  *   settings.set("theme.dark", "red-octopus")  // sync, saves in background
  */
-export type SettingTab = "appearance" | "model" | "interaction" | "context" | "memory" | "editing" | "tools" | "tasks" | "providers";
+export type SettingTab = "appearance" | "model" | "interaction" | "notifications" | "context" | "memory" | "editing" | "tools" | "tasks" | "providers";
 /** Tab display metadata - icon is resolved via theme.symbol() */
 export type TabMetadata = {
     label: string;
@@ -56,10 +56,13 @@ interface UiString extends UiBase {
      *  - Omitted → renders as a free text input.
      */
     options?: ReadonlyArray<SubmenuOption> | "runtime";
+    /** When true, the value is masked in the settings list display but edited in full. */
+    secret?: boolean;
 }
 /** Wide ui shape exposed to consumers that walk the schema generically. */
 export type AnyUiMetadata = UiBase & {
     options?: ReadonlyArray<SubmenuOption> | "runtime";
+    secret?: boolean;
 };
 interface BooleanDef {
     type: "boolean";
@@ -121,23 +124,94 @@ export declare const SETTINGS_SCHEMA: {
     readonly "notifications.enabled": {
         readonly type: "boolean";
         readonly default: false;
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Enabled";
+            readonly description: "Master switch for notifications. Requires at least one adapter (Telegram/Discord/Slack) configured with a token and a chat/channel to actually deliver.";
+        };
     };
     readonly "notifications.telegram.botToken": {
         readonly type: "string";
         readonly default: undefined;
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Telegram bot token";
+            readonly description: "Telegram BotFather HTTP API token. Stored locally; shown masked.";
+            readonly secret: true;
+        };
     };
     readonly "notifications.telegram.chatId": {
         readonly type: "string";
         readonly default: undefined;
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Telegram chat ID";
+            readonly description: "Target chat. For end-to-end per-session delivery this must be a forum-enabled supergroup the bot can manage; a private chat id is only enough for setup/status.";
+        };
+    };
+    readonly "notifications.discord.botToken": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Discord bot token";
+            readonly description: "Discord bot token for the notifications adapter. Stored locally; shown masked.";
+            readonly secret: true;
+        };
+    };
+    readonly "notifications.discord.channelId": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Discord channel ID";
+            readonly description: "Discord channel that receives notifications and routes replies back.";
+        };
+    };
+    readonly "notifications.slack.botToken": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Slack bot token";
+            readonly description: "Slack bot token for the notifications adapter. Stored locally; shown masked.";
+            readonly secret: true;
+        };
+    };
+    readonly "notifications.slack.channelId": {
+        readonly type: "string";
+        readonly default: undefined;
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Slack channel ID";
+            readonly description: "Slack channel that receives notifications and routes replies back.";
+        };
     };
     readonly "notifications.redact": {
         readonly type: "boolean";
         readonly default: false;
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Redact";
+            readonly description: "Strip idle summaries and streamed content before remote delivery. Ask prompts are always sent so they remain answerable.";
+        };
     };
     readonly "notifications.verbosity": {
         readonly type: "string";
         readonly default: "lean";
         readonly validate: (value: string) => value is "lean" | "verbose";
+        readonly ui: {
+            readonly tab: "notifications";
+            readonly label: "Verbosity";
+            readonly description: "How much session context to stream to Telegram.";
+            readonly options: readonly [{
+                readonly value: "lean";
+                readonly label: "Lean";
+            }, {
+                readonly value: "verbose";
+                readonly label: "Verbose";
+            }];
+        };
     };
     readonly "notifications.daemon.idleTimeoutMs": {
         readonly type: "number";
@@ -2512,6 +2586,15 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Allow the read tool to fetch and process URLs";
         };
     };
+    readonly "web.insaneFallback": {
+        readonly type: "boolean";
+        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 "github.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -2561,7 +2644,7 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "array";
         readonly default: string[];
         readonly items: {
-            readonly enum: readonly ["duckduckgo", "exa", "brave", "jina", "kimi", "zai", "anthropic", "perplexity", "gemini", "codex", "xai", "tavily", "parallel", "kagi", "synthetic", "searxng"];
+            readonly enum: readonly ["duckduckgo", "insane", "exa", "brave", "jina", "kimi", "zai", "anthropic", "perplexity", "gemini", "codex", "xai", "tavily", "parallel", "kagi", "synthetic", "searxng"];
         };
         readonly ui: {
             readonly tab: "tools";
@@ -3164,7 +3247,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly "providers.webSearch": {
         readonly type: "enum";
-        readonly values: readonly ["auto", "duckduckgo", "exa", "brave", "jina", "kimi", "zai", "perplexity", "anthropic", "gemini", "codex", "xai", "tavily", "kagi", "synthetic", "parallel", "searxng"];
+        readonly values: readonly ["auto", "duckduckgo", "insane", "exa", "brave", "jina", "kimi", "zai", "perplexity", "anthropic", "gemini", "codex", "xai", "tavily", "kagi", "synthetic", "parallel", "searxng"];
         readonly default: "auto";
         readonly ui: {
             readonly tab: "providers";
@@ -3178,6 +3261,10 @@ export declare const SETTINGS_SCHEMA: {
                 readonly value: "duckduckgo";
                 readonly label: "DuckDuckGo";
                 readonly description: "Keyless default \u2014 no API key or OAuth required";
+            }, {
+                readonly value: "insane";
+                readonly label: "Insane";
+                readonly description: "Keyless safe public-route fallback inspired by upstream insane-search";
             }, {
                 readonly value: "exa";
                 readonly label: "Exa";
@@ -3650,6 +3737,14 @@ export interface NotificationsSettings {
         botToken: string | undefined;
         chatId: string | undefined;
     };
+    discord: {
+        botToken: string | undefined;
+        channelId: string | undefined;
+    };
+    slack: {
+        botToken: string | undefined;
+        channelId: string | undefined;
+    };
     redact: boolean;
     daemon: {
         idleTimeoutMs: number;

package/dist/types/defaults/skc-defaults.d.ts

@@ -1,6 +1,6 @@
 export declare const DEFAULT_SKC_DEFINITION_NAMES: readonly ["deep-interview", "ralplan", "team", "ultragoal"];
 export type DefaultSkcDefinitionName = (typeof DEFAULT_SKC_DEFINITION_NAMES)[number];
-export type DefaultSkcDefinitionKind = "skill" | "skill-fragment" | "rule";
+export type DefaultSkcDefinitionKind = "skill" | "skill-fragment";
 export type EmbeddedDefaultSkcSkill = {
     name: DefaultSkcDefinitionName;
     description: string;
@@ -23,13 +23,7 @@ export interface DefaultSkcSkillFragmentDefinition {
     relativePath: string;
     content: string;
 }
-export interface DefaultSkcRuleDefinition {
-    kind: "rule";
-    name: string;
-    relativePath: string;
-    content: string;
-}
-export type DefaultSkcDefinition = DefaultSkcSkillDefinition | DefaultSkcSkillFragmentDefinition | DefaultSkcRuleDefinition;
+export type DefaultSkcDefinition = DefaultSkcSkillDefinition | DefaultSkcSkillFragmentDefinition;
 export interface InstallDefaultSkcDefinitionsOptions {
     check?: boolean;
     force?: boolean;
@@ -45,11 +39,6 @@ export type DefaultSkcDefinitionInstallFile = {
     parentSkillName: DefaultSkcDefinitionName;
     path: string;
     status: DefaultSkcInstallStatus;
-} | {
-    kind: "rule";
-    name: string;
-    path: string;
-    status: DefaultSkcInstallStatus;
 };
 export interface DefaultSkcDefinitionInstallResult {
     targetRoot: string;

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

@@ -172,6 +172,7 @@ export interface AutoCompactionEndEvent {
     errorMessage?: string;
     /** True when compaction was skipped for a benign reason (no model, no candidates, nothing to compact). */
     skipped?: boolean;
+    continuationSkipReason?: "auto_continue_disabled_non_resumable_tail";
 }
 /** Fired when auto-retry starts */
 export interface AutoRetryStartEvent {

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

@@ -30,6 +30,7 @@ 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/lsp/types.d.ts

@@ -224,6 +224,8 @@ export interface ServerConfig {
     /** Per-server warmup timeout in milliseconds. Overrides the global WARMUP_TIMEOUT_MS for this server during startup. */
     warmupTimeoutMs?: number;
     capabilities?: ServerCapabilities;
+    /** Names of lower-precedence servers to drop when this server is available. */
+    supersedes?: string[];
     /** If true, this is a linter/formatter server (e.g., Biome) - used only for diagnostics/actions, not type intelligence */
     isLinter?: boolean;
     /** Resolved absolute path to the command binary (set during config loading) */

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

@@ -37,6 +37,7 @@ 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/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.notifications" | "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/attachment-registry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Process-wide registry mapping a session id to a sink that delivers a local
+ * file to the session's connected Telegram chat as a document. Registered by
+ * the notifications extension; consumed by the telegram_send tool.
+ */
+/** Delivers a local file to the session's Telegram chat. */
+export type TelegramFileSink = (file: {
+    path: string;
+    caption?: string;
+}) => Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/** Register `sink` for `sessionId`. Returns a disposer that clears it. */
+export declare function registerTelegramFileSink(sessionId: string, sink: TelegramFileSink): () => void;
+/** The Telegram file sink for `sessionId`, if one is registered. */
+export declare function getTelegramFileSink(sessionId: string): TelegramFileSink | undefined;

package/dist/types/notifications/chat-adapters.d.ts

@@ -0,0 +1,9 @@
+import type { NotificationPresentationAdapter } from "./engine";
+type AdapterKind = "discord" | "slack";
+interface ChatAdapterOptions {
+    kind: AdapterKind;
+    channelId?: string;
+}
+export declare function createDiscordAdapter(opts?: Omit<ChatAdapterOptions, "kind">): NotificationPresentationAdapter;
+export declare function createSlackAdapter(opts?: Omit<ChatAdapterOptions, "kind">): NotificationPresentationAdapter;
+export {};

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

@@ -3,13 +3,21 @@ export interface NotificationConfig {
     enabled: boolean;
     botToken?: string;
     chatId?: string;
+    discord: {
+        botToken?: string;
+        channelId?: string;
+    };
+    slack: {
+        botToken?: string;
+        channelId?: string;
+    };
     redact: boolean;
     verbosity: "lean" | "verbose";
     idleTimeoutMs: number;
 }
 /** Read typed config from Settings. */
 export declare function getNotificationConfig(settings: Settings): NotificationConfig;
-/** Is global config sufficient for auto-on (enabled + botToken + chatId all present)? */
+/** Is global config sufficient for auto-on (enabled + at least one configured adapter)? */
 export declare function isGloballyConfigured(cfg: NotificationConfig): boolean;
 /** Resolve whether the notifications extension should be registered at SDK startup. */
 export declare function shouldRegisterNotificationsExtension(input: {

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

@@ -0,0 +1,59 @@
+import { type RedactableAction } from "./config";
+export type NotificationEvent = ({
+    type: "action_needed";
+} & RedactableAction) | {
+    type: "action_resolved";
+    id: string;
+    sessionId: string;
+    resolvedBy?: string;
+} | {
+    type: "frame";
+    sessionId: string;
+    frame: Record<string, unknown>;
+};
+export interface NotificationReplyRoute {
+    sessionId: string;
+    actionId: string;
+    answer: number | string | {
+        selected?: Array<number | string>;
+        custom?: string;
+    };
+}
+export interface NotificationAdapterPayload {
+    adapter: string;
+    channelKey?: string;
+    body: unknown;
+    route?: Omit<NotificationReplyRoute, "answer">;
+}
+export interface NotificationPresentationAdapter {
+    readonly kind: "telegram" | "discord" | "slack";
+    render(event: NotificationEvent): NotificationAdapterPayload[];
+    mapInbound(input: unknown): NotificationReplyRoute | undefined;
+}
+export interface EngineSessionSink {
+    sendReply(route: NotificationReplyRoute): void;
+}
+export interface NotificationEngineOptions {
+    redact: boolean;
+    sessionTag: (sessionId: string) => string;
+}
+/**
+ * Shared presentation engine for managed notification clients.
+ *
+ * It owns fanout, redaction boundaries, pending-action routing, and reply
+ * delivery into session sinks. Transport adapters stay pure: render an internal
+ * event into a public-safe payload and map an inbound transport interaction
+ * back into a session/action answer.
+ */
+export declare class NotificationPresentationEngine {
+    private readonly opts;
+    readonly adapters: readonly NotificationPresentationAdapter[];
+    private readonly sessions;
+    private readonly pending;
+    constructor(adapters: readonly NotificationPresentationAdapter[], opts: NotificationEngineOptions);
+    connectSession(sessionId: string, sink: EngineSessionSink): void;
+    dropSession(sessionId: string): void;
+    fanout(event: NotificationEvent): NotificationAdapterPayload[];
+    routeInbound(adapterKind: NotificationPresentationAdapter["kind"], input: unknown): boolean;
+    private redactEvent;
+}

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

@@ -0,0 +1,48 @@
+import type { Settings } from "../config/settings";
+import { RateLimitPool } from "./rate-limit-pool";
+import { type ThreadedSend } from "./threaded-render";
+export interface ManagedNotificationDaemonFs {
+    readdir(path: string): Promise<string[]>;
+}
+export interface ManagedSessionSocket {
+    sessionId: string;
+    token: string;
+    ws: WebSocket;
+    pending: Map<string, {
+        sessionId: string;
+        actionId: string;
+    }>;
+    capable: boolean;
+    lastPongAt: number;
+    awaitingNonce: string | undefined;
+    pingTimer: ReturnType<typeof setInterval> | undefined;
+}
+export interface ManagedNotificationDaemonOptions {
+    settings: Settings;
+    fs: ManagedNotificationDaemonFs;
+    WebSocketImpl?: typeof WebSocket;
+    now?: () => number;
+    setIntervalImpl?: typeof setInterval;
+    clearIntervalImpl?: typeof clearInterval;
+    rateLimitPool?: RateLimitPool<{
+        send: ThreadedSend;
+        topicId?: string;
+    }>;
+}
+export declare abstract class ManagedNotificationDaemon {
+    protected readonly opts: ManagedNotificationDaemonOptions;
+    readonly sessions: Map<string, ManagedSessionSocket>;
+    readonly pool: RateLimitPool<{
+        send: ThreadedSend;
+        topicId?: string;
+    }>;
+    protected constructor(opts: ManagedNotificationDaemonOptions);
+    scanRoots(): Promise<void>;
+    connectSession(sessionId: string, url: string, token: string): ManagedSessionSocket;
+    protected handleSessionMessage(session: ManagedSessionSocket, msg: Record<string, unknown>): Promise<boolean>;
+    protected renderFrame(frame: Record<string, unknown>): ThreadedSend | undefined;
+    protected dropSession(session: ManagedSessionSocket): void;
+    protected abstract readRoots(): Promise<string[]>;
+    private sendHello;
+    private startLiveness;
+}

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

@@ -206,6 +206,12 @@ export declare class TelegramNotificationDaemon {
     private readonly topics;
     private readonly pool;
     private readonly seenUpdateIds;
+    /** 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). */
+    private readonly flatIdentitySent;
+    /** Cached result of whether the paired chat is a private chat (flat-fallback gate). */
+    private pairedChatPrivate;
     private flushTimer;
     private scanTimer;
     private scanning;
@@ -251,7 +257,20 @@ export declare class TelegramNotificationDaemon {
     private ensureTopic;
     private persistTopics;
     loadTopics(): Promise<void>;
+    private downloadTelegramFile;
+    /**
+     * Per-session private temp directories (mode 0700) holding inbound non-image
+     * attachments. Keyed by session id and reused across transient reconnects;
+     * removed when the daemon stops (see {@link cleanupAllAttachmentDirs}).
+     */
+    private readonly attachmentDirs;
+    private ensureAttachmentDir;
+    private cleanupAllAttachmentDirs;
+    private resolveInboundAttachment;
     private flushPool;
+    private deliverFlatFallback;
+    private pairedChatIsPrivate;
+    private notifyThreadedFallback;
     private startFlushTimer;
     private stopFlushTimer;
     private runScan;

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

@@ -20,12 +20,30 @@ export interface InboundUpdate {
     message?: {
         message_id?: unknown;
         text?: unknown;
+        caption?: unknown;
+        photo?: unknown;
+        document?: unknown;
+        video?: unknown;
+        audio?: unknown;
+        voice?: unknown;
+        animation?: unknown;
         chat?: {
             id?: unknown;
         };
         message_thread_id?: unknown;
     };
 }
+/** A downloadable media attachment referenced by an inbound message. */
+export interface InboundAttachment {
+    /** Telegram file_id to resolve via getFile. */
+    fileId: string;
+    /** Source media kind; "photo" is always an image. */
+    kind: "photo" | "document" | "video" | "audio" | "voice" | "animation";
+    /** MIME type when Telegram provides one. */
+    mime?: string;
+    /** Original file name when provided. */
+    fileName?: string;
+}
 /** Context for {@link decideThreadedInbound}. All lookups are injected. */
 export interface ThreadedInboundCtx {
     /** The single paired chat id (string-compared). */
@@ -43,6 +61,7 @@ export type ThreadedInboundDecision = {
     updateId: number;
     threadId: string;
     messageId?: number;
+    attachment?: InboundAttachment;
 } | {
     kind: "duplicate";
     updateId: number;

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

@@ -11,15 +11,19 @@
 import type { RateLimitLane } from "./rate-limit-pool";
 /** A Telegram send derived from a threaded frame (topic id is applied by the daemon). */
 export interface ThreadedSend {
-    method: "sendMessage" | "sendPhoto";
+    method: "sendMessage" | "sendPhoto" | "sendDocument";
     /** Rate-limit lane for prioritisation/fairness. */
     lane: RateLimitLane;
     /** Message text (sendMessage) or photo caption (sendPhoto). */
     text?: string;
     /** Base64 image bytes for sendPhoto. */
     photoBase64?: string;
+    /** Base64 file bytes for sendDocument. */
+    documentBase64?: string;
     /** Image MIME type for sendPhoto. */
     mime?: string;
+    /** Suggested document filename. */
+    fileName?: string;
     /** Coalesce key for live edits (same key collapses to the latest). */
     coalesceKey?: string;
     /** True for the one-time identity header (the daemon pins it once). */
@@ -45,6 +49,7 @@ interface ThreadedFrame {
     data?: unknown;
     mime?: unknown;
     caption?: unknown;
+    name?: unknown;
     verbosity?: unknown;
     redact?: unknown;
 }

package/dist/types/session/agent-session.d.ts

@@ -81,6 +81,7 @@ import type { BranchSummaryEntry, NewSessionOptions, SessionContext, SessionMana
 import { ToolChoiceQueue } from "./tool-choice-queue";
 import { YieldQueue } from "./yield-queue";
 /** Session-specific events that extend the core AgentEvent */
+export type AutoCompactionContinuationSkipReason = "auto_continue_disabled_non_resumable_tail";
 export type AgentSessionEvent = AgentEvent | {
     type: "auto_compaction_start";
     reason: "threshold" | "overflow" | "idle";
@@ -94,6 +95,7 @@ export type AgentSessionEvent = AgentEvent | {
     errorMessage?: string;
     /** True when compaction was skipped for a benign reason (no model, no candidates, nothing to compact). */
     skipped?: boolean;
+    continuationSkipReason?: AutoCompactionContinuationSkipReason;
 } | {
     type: "auto_retry_start";
     attempt: number;

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

@@ -12,7 +12,7 @@
  *
  * 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
- *    / Critic / revision / ADR / final markdown under `.skc/plans/ralplan/<run-id>/`, maintains
+ *    / 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/tools/fetch.d.ts

@@ -1,8 +1,10 @@
 import type { AgentToolResult } from "@sayknow-cli/agent-core";
 import { type Component } from "@sayknow-cli/tui";
+import type { Settings } from "../config/settings";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import { type Theme } from "../modes/theme/theme";
 import type { ToolSession } from "../sdk";
+import type { RenderResult } from "../web/scrapers/types";
 import { type OutputMeta } from "./output-meta";
 export declare function isReadableUrlPath(value: string): boolean;
 export interface ParsedReadUrlTarget {
@@ -16,6 +18,27 @@ interface FetchImagePayload {
     data: string;
     mimeType: string;
 }
+type FetchRenderResult = RenderResult & {
+    image?: FetchImagePayload;
+};
+/**
+ * Opt-in insane-search fallback for blocked / degraded public URL reads.
+ *
+ * Returns a finalized `method: "insane"` result on success, or null (so the
+ * caller continues with its normal degraded behavior). Fail-closed: no note,
+ * guard DNS, dependency probe, or subprocess when raw mode or the opt-in
+ * setting is off. The public-URL guard runs BEFORE any probe/spawn.
+ */
+export declare function tryInsaneFallback(args: {
+    url: string;
+    finalUrl: string;
+    timeout: number;
+    raw: boolean;
+    settings: Settings;
+    signal: AbortSignal | undefined;
+    fetchedAt: string;
+    notes: string[];
+}): Promise<FetchRenderResult | null>;
 export interface ReadUrlToolDetails {
     kind: "url";
     url: string;

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

@@ -55,6 +55,7 @@ export * from "./search-tool-bm25";
 export * from "./skill";
 export * from "./ssh";
 export * from "./subagent";
+export * from "./telegram-send";
 export * from "./todo-write";
 export * from "./vim";
 export * from "./write";