@sayknow-cli/coding-agent 0.2.7 → 0.3.1

package/CHANGELOG.md

@@ -4,6 +4,26 @@ Sayknow-CLI is a rebranded fork of [gajae-code](https://github.com/Yeachan-Heo/g
 This file tracks the **fork's own releases**; upstream's full feature history lives
 in that project. Each release notes the upstream version it is built on.
 
+## [0.3.0] — 2026-06-23
+
+### Changed
+
+- Synced onto upstream **gajae-code v0.7.1** (from v0.6.5), bringing 0.7.0's mobile
+  notifications SDK + managed Telegram daemon and 0.7.1's fixes (assistant
+  notification lead-in, stale tmux session reuse, packaged native imports, and the
+  glm-zcode Z.AI provider) while preserving the Sayknow-CLI brand.
+
+### Added
+
+- **Decepticon red-team integration.** Vendored [Decepticon](https://github.com/PurpleAILAB/Decepticon)
+  as a git submodule (`vendor/decepticon`) plus `python/decepticon-bridge` — an
+  `skc-rpc` host-tool bridge that exposes Decepticon's red-team agents to skc
+  (`decepticon_run_agent` / `decepticon_list_agents`).
+- **Ponytail default rule.** Bundled the ponytail "lazy senior dev" ruleset as an
+  always-on default rule: pick the simplest working solution first (YAGNI, reuse,
+  stdlib/native first) without ever cutting validation, error handling, security,
+  or accessibility. Adapted from [ponytail](https://github.com/DietrichGebert/ponytail) (MIT).
+
 ## [0.2.7] — 2026-06-23
 
 ### Added

package/dist/types/async/job-manager.d.ts

@@ -68,7 +68,9 @@ export interface SubagentLiveHandle {
     /** Request a cooperative safe-boundary pause (never aborts the in-flight tool). */
     requestPause(): void;
     /** Inject a steering message into the live session. */
-    injectMessage(content: string, deliverAs: "steer" | "followUp" | "nextTurn"): Promise<void>;
+    injectMessage(content: string, deliverAs: "steer" | "followUp" | "nextTurn", opts?: {
+        fromAgentId?: string;
+    }): Promise<void>;
 }
 /**
  * Canonical, stable-id-keyed record for a subagent. Survives `AsyncJob`

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

@@ -0,0 +1,25 @@
+/**
+ * `skc daemon` command handler.
+ *
+ * Generic over the static built-in daemon controller map: lists/inspects
+ * daemons and drives cooperative stop/reload. Telegram is the only kind today.
+ */
+import { Settings } from "../config/settings";
+import type { BuiltInDaemonController, DaemonKind } from "../daemon/control-types";
+export type DaemonCliAction = "list" | "status" | "stop" | "reload";
+export interface DaemonCommandArgs {
+    action: DaemonCliAction;
+    kinds: DaemonKind[];
+    all: boolean;
+    json: boolean;
+    force: boolean;
+    gracefulTimeoutMs?: number;
+    killTimeoutMs?: number;
+    spawnIfStopped?: boolean;
+}
+export interface DaemonCommandDeps {
+    settings?: Settings;
+    controllers?: BuiltInDaemonController[];
+}
+export declare function parseDaemonArgs(argv: string[]): DaemonCommandArgs | undefined;
+export declare function runDaemonCommand(cmd: DaemonCommandArgs, deps?: DaemonCommandDeps): Promise<void>;

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

@@ -0,0 +1,25 @@
+import { Settings } from "../config/settings";
+export type NotifyAction = "setup" | "status" | "daemon-internal";
+export interface NotifyCommandArgs {
+    action: NotifyAction;
+    smoke?: boolean;
+    rawArgs: string[];
+    token?: string;
+    chatId?: string;
+    redact?: boolean;
+}
+export interface NotifyCommandDeps {
+    fetchImpl?: typeof fetch;
+    apiBase?: string;
+    settings?: Settings;
+    setupToken?: string;
+    pollTimeoutMs?: number;
+    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>;
+export declare function printNotifyHelp(): void;

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

@@ -3,7 +3,9 @@
  *
  * Handles `skc setup [component]` to install the normal defaults or optional feature dependencies.
  */
-export type SetupComponent = "credentials" | "defaults" | "hermes" | "hooks" | "provider" | "python" | "stt";
+import { AuthStorage, SqliteAuthCredentialStore } from "@sayknow-cli/ai";
+import { runExternalCredentialAutoImport } from "../setup/credential-auto-import";
+export type SetupComponent = "claude" | "codex" | "credentials" | "defaults" | "hermes" | "hooks" | "provider" | "python" | "stt";
 export interface SetupCommandArgs {
     component: SetupComponent;
     flags: {
@@ -34,6 +36,7 @@ export interface SetupCommandArgs {
         profileDir?: string;
         yes?: boolean;
         dryRun?: boolean;
+        keychain?: boolean;
     };
 }
 /**
@@ -48,6 +51,22 @@ export declare function parseSetupArgs(args: string[]): SetupCommandArgs | undef
  * Run the setup command.
  */
 export declare function runSetupCommand(cmd: SetupCommandArgs): Promise<void>;
+/**
+ * Discover existing Claude Code / Codex CLI credentials and import them into the
+ * skc credential store after a redacted preview + confirmation. Falls back to
+ * manual-setup guidance when nothing importable is found.
+ */
+export interface CredentialsSetupDependencies {
+    openStore?: typeof SqliteAuthCredentialStore.open;
+    createAuthStorage?: (store: Awaited<ReturnType<typeof SqliteAuthCredentialStore.open>>) => AuthStorage;
+    discover?: Parameters<typeof runExternalCredentialAutoImport>[0]["discover"];
+}
+export declare function handleCredentialsSetup(flags: {
+    json?: boolean;
+    yes?: boolean;
+    dryRun?: boolean;
+    keychain?: boolean;
+}, deps?: CredentialsSetupDependencies): Promise<void>;
 /**
  * Print setup command help.
  */

package/dist/types/commands/daemon.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Manage SKC background daemons (status/list/stop/reload).
+ */
+import { Command } from "@sayknow-cli/utils/cli";
+import { type DaemonCliAction } from "../cli/daemon-cli";
+export default class Daemon extends Command {
+    static description: string;
+    static args: {
+        action: import("@sayknow-cli/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: DaemonCliAction[];
+        };
+        kind: import("@sayknow-cli/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            multiple: true;
+        };
+    };
+    static flags: {
+        all: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        json: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        force: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "graceful-timeout-ms": import("@sayknow-cli/utils/cli").FlagDescriptor<"integer"> & {
+            description: string;
+        };
+        "kill-timeout-ms": import("@sayknow-cli/utils/cli").FlagDescriptor<"integer"> & {
+            description: string;
+        };
+        "spawn-if-stopped": import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+    };
+    run(): Promise<void>;
+}

package/dist/types/commands/notify.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Configure Telegram notifications.
+ */
+import { Command } from "@sayknow-cli/utils/cli";
+import { type NotifyAction } from "../cli/notify-cli";
+export default class Notify extends Command {
+    static description: string;
+    static args: {
+        action: import("@sayknow-cli/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: NotifyAction[];
+        };
+        extra: import("@sayknow-cli/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            multiple: true;
+        };
+    };
+    static flags: {
+        smoke: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        token: import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "chat-id": import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        redact: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        "owner-id": import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "agent-dir": import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+    };
+    run(): Promise<void>;
+}

package/dist/types/config/model-profile-activation.d.ts

@@ -7,6 +7,8 @@ type ModelProfileActivationSession = Pick<AgentSession, "model" | "thinkingLevel
     setModelTemporary?: AgentSession["setModelTemporary"];
     setActiveModelProfile?: (name: string | undefined) => void;
     getActiveModelProfile?: () => string | undefined;
+    getSessionDefaultModelSelector?: () => string | undefined;
+    recordResumeDefaultModel?: (selector: string) => void;
 };
 export interface PrepareModelProfileActivationOptions {
     session: ModelProfileActivationSession;
@@ -23,10 +25,20 @@ export interface PreparedModelProfileActivation {
     previousModel: Model<Api> | undefined;
     previousThinkingLevel: ThinkingLevel | undefined;
     previousAgentModelOverrides: Record<string, string>;
+    previousModelRoles: Record<string, string>;
     defaultModel: Model<Api> | undefined;
     defaultThinkingLevel: ThinkingLevel | undefined;
+    modelRoles: Record<string, string>;
     agentModelOverrides: Record<string, string>;
     previousActiveModelProfile: string | undefined;
+    /**
+     * The session resume default ("provider/id") captured BEFORE activation —
+     * the model resume would restore prior to this profile. Snapshotted
+     * separately from `previousModel` (the live runtime model, which may be a
+     * transient switch) so a failed-activation rollback restores the correct
+     * resume default without promoting a transient model to it.
+     */
+    previousSessionDefaultModel: string | undefined;
 }
 export declare function formatModelProfileCredentialError(profileName: string, providers: readonly string[]): string;
 export declare function prepareModelProfileActivation(options: PrepareModelProfileActivationOptions): Promise<PreparedModelProfileActivation>;

package/dist/types/config/model-profiles.d.ts

@@ -20,7 +20,8 @@ export interface ModelProfileDefinition {
 }
 export interface ResolvedProfileBinding {
     defaultSelector?: string;
-    agentModelOverrides: Partial<Record<Exclude<ModelProfileRole, "default">, string>>;
+    modelRoles: Partial<Record<"vision", string>>;
+    agentModelOverrides: Partial<Record<Exclude<ModelProfileRole, "default" | "vision">, string>>;
 }
 export declare function deriveModelProfileMappedProviders(definition: Pick<ModelProfileDefinition, "modelMapping">): string[];
 export declare function aggregateModelProfileRequiredProviders(requiredProviders: readonly string[], definition: Pick<ModelProfileDefinition, "modelMapping">): string[];

package/dist/types/config/model-registry.d.ts

@@ -11,7 +11,7 @@ import { type Settings } from "./settings";
 export type { CanonicalModelIndex, CanonicalModelRecord, CanonicalModelVariant, ModelEquivalenceConfig };
 export declare const kNoAuth = "N/A";
 export declare function isAuthenticated(apiKey: string | undefined | null): apiKey is string;
-export type ModelRole = "default";
+export type ModelRole = "default" | "vision";
 export interface ModelRoleInfo {
     tag?: string;
     name: string;
@@ -19,7 +19,7 @@ export interface ModelRoleInfo {
 }
 export declare const MODEL_ROLES: Record<ModelRole, ModelRoleInfo>;
 export declare const MODEL_ROLE_IDS: ModelRole[];
-export type SkcModelAssignmentTargetId = "default" | "executor" | "architect" | "planner" | "critic";
+export type SkcModelAssignmentTargetId = "default" | "vision" | "executor" | "architect" | "planner" | "critic";
 export interface SkcModelAssignmentTargetInfo extends ModelRoleInfo {
     id: SkcModelAssignmentTargetId;
     settingsPath: "modelRoles" | "task.agentModelOverrides";
@@ -268,7 +268,7 @@ export declare const ModelsConfigFile: ConfigFile<{
     profiles?: Record<string, {
         required_providers: string[];
         display_name?: string | undefined;
-        model_mapping: Partial<Record<"architect" | "critic" | "default" | "executor" | "planner", string>>;
+        model_mapping: Partial<Record<"architect" | "critic" | "default" | "executor" | "planner" | "vision", string>>;
     }> | undefined;
 }>;
 /** Provider override config (baseUrl, headers, apiKey, compat, transport) without custom models */

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

@@ -68,6 +68,7 @@ export declare const ProfileRoleSchema: z.ZodEnum<{
     default: "default";
     executor: "executor";
     planner: "planner";
+    vision: "vision";
 }>;
 export declare const ProfileModelSelectorSchema: z.ZodString;
 export declare const ProfileModelMappingSchema: z.ZodRecord<z.ZodEnum<{
@@ -76,6 +77,7 @@ export declare const ProfileModelMappingSchema: z.ZodRecord<z.ZodEnum<{
     default: "default";
     executor: "executor";
     planner: "planner";
+    vision: "vision";
 }> & z.core.$partial, z.ZodString>;
 export declare const ProfileDefinitionSchema: z.ZodObject<{
     required_providers: z.ZodArray<z.ZodString>;
@@ -86,6 +88,7 @@ export declare const ProfileDefinitionSchema: z.ZodObject<{
         default: "default";
         executor: "executor";
         planner: "planner";
+        vision: "vision";
     }> & z.core.$partial, z.ZodString>;
 }, z.core.$strict>;
 export declare const ProfilesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -97,6 +100,7 @@ export declare const ProfilesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         default: "default";
         executor: "executor";
         planner: "planner";
+        vision: "vision";
     }> & z.core.$partial, z.ZodString>;
 }, z.core.$strict>>;
 export declare const ModelOverrideSchema: z.ZodObject<{
@@ -687,6 +691,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
             default: "default";
             executor: "executor";
             planner: "planner";
+            vision: "vision";
         }> & z.core.$partial, z.ZodString>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;

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";
@@ -118,6 +121,103 @@ export declare const SETTINGS_SCHEMA: {
         readonly type: "string";
         readonly default: undefined;
     };
+    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";
+        readonly default: 60000;
+        readonly validate: (value: number) => boolean;
+    };
     readonly autoResume: {
         readonly type: "boolean";
         readonly default: false;
@@ -2486,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;
@@ -2535,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";
@@ -3138,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";
@@ -3152,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";
@@ -3618,6 +3731,25 @@ export interface ShellMinimizerSettings {
     except: string[];
     maxCaptureBytes: number;
 }
+export interface NotificationsSettings {
+    enabled: boolean;
+    telegram: {
+        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;
+    };
+}
 /** Map group prefix -> typed settings interface */
 export interface GroupTypeMap {
     compaction: CompactionSettings;
@@ -3636,6 +3768,7 @@ export interface GroupTypeMap {
     modelTags: ModelTagsSettings;
     cycleOrder: string[];
     shellMinimizer: ShellMinimizerSettings;
+    notifications: NotificationsSettings;
 }
 export type GroupPrefix = keyof GroupTypeMap;
 export {};

package/dist/types/coordinator/contract.d.ts

@@ -1,4 +1,4 @@
 export declare const COORDINATOR_MCP_PROTOCOL_VERSION = "2024-11-05";
 export declare const COORDINATOR_MCP_SERVER_NAME = "skc-coordinator-mcp";
-export declare const COORDINATOR_MCP_TOOL_NAMES: readonly ["skc_coordinator_list_sessions", "skc_coordinator_read_status", "skc_coordinator_read_tail", "skc_coordinator_list_questions", "skc_coordinator_list_artifacts", "skc_coordinator_read_artifact", "skc_coordinator_read_coordination_status", "skc_coordinator_watch_events", "skc_coordinator_register_session", "skc_coordinator_start_session", "skc_coordinator_send_prompt", "skc_coordinator_submit_question_answer", "skc_coordinator_read_turn", "skc_coordinator_await_turn", "skc_coordinator_report_status"];
+export declare const COORDINATOR_MCP_TOOL_NAMES: readonly ["skc_coordinator_list_sessions", "skc_coordinator_read_status", "skc_coordinator_read_tail", "skc_coordinator_list_questions", "skc_coordinator_list_artifacts", "skc_coordinator_read_artifact", "skc_coordinator_read_coordination_status", "skc_coordinator_watch_events", "skc_coordinator_register_session", "skc_coordinator_start_session", "skc_coordinator_send_prompt", "skc_coordinator_submit_question_answer", "skc_coordinator_read_turn", "skc_coordinator_await_turn", "skc_coordinator_report_status", "skc_delegate_plan", "skc_delegate_execute", "skc_delegate_team"];
 export type CoordinatorToolName = (typeof COORDINATOR_MCP_TOOL_NAMES)[number];

package/dist/types/daemon/builtin.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Static built-in daemon controller map.
+ *
+ * Intentionally a static map keyed by daemon kind rather than a mutable plugin
+ * registry: there is exactly one kind today (`telegram`). Promote to a richer
+ * registry only when a second daemon kind exists.
+ */
+import type { Settings } from "../config/settings";
+import { type TelegramDaemonControlDeps } from "../notifications/telegram-daemon-control";
+import type { BuiltInDaemonController, DaemonKind } from "./control-types";
+export declare const BUILT_IN_DAEMON_KINDS: readonly ["telegram"];
+export interface BuiltInDaemonControllerDeps {
+    telegram?: TelegramDaemonControlDeps;
+}
+export declare function createBuiltInDaemonControllers(settings: Settings, deps?: BuiltInDaemonControllerDeps): Record<DaemonKind, BuiltInDaemonController>;
+/**
+ * Resolve the controllers a command should act on. `--all` selects every
+ * built-in kind; otherwise the explicit `kinds` (defaulting to `telegram`).
+ */
+export declare function selectDaemonControllers(settings: Settings, kinds: DaemonKind[] | undefined, all: boolean, deps?: BuiltInDaemonControllerDeps): BuiltInDaemonController[];

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

@@ -0,0 +1,57 @@
+/**
+ * Public types for the `skc daemon` control plane.
+ *
+ * Deliberately compact: a small result/status surface plus a built-in
+ * controller contract. There is exactly one daemon kind today (`telegram`);
+ * a richer registry is intentionally deferred until a second kind exists.
+ */
+export type DaemonKind = "telegram";
+export type DaemonAction = "list" | "status" | "stop" | "reload";
+export type DaemonHealth = "not_configured" | "stopped" | "running" | "stale" | "stopping" | "error";
+export interface DaemonRuntimeInfo {
+    /** `source` when respawn goes through bun/node + the entry script; `compiled` for a single-file binary. */
+    mode: "source" | "compiled";
+    execPath: string;
+    /** True only in source/dev mode, where a respawn loads amended TypeScript directly. */
+    reloadPicksUpSourceEdits: boolean;
+    /** Present when the runtime mode constrains what reload can achieve (e.g. compiled binary). */
+    warning?: string;
+}
+export interface DaemonStatus {
+    kind: DaemonKind;
+    configured: boolean;
+    health: DaemonHealth;
+    pid?: number;
+    ownerId?: string;
+    startedAt?: number;
+    heartbeatAt?: number;
+    roots?: string[];
+    rootCount?: number;
+    runtime: DaemonRuntimeInfo;
+    detail?: string;
+}
+export interface DaemonOperationOptions {
+    /** How long to wait for cooperative release before escalating. */
+    gracefulTimeoutMs?: number;
+    /** How long to wait for the old pid to die after SIGKILL. */
+    killTimeoutMs?: number;
+    /** Allow hard-kill escalation / acting on a still-live owner. */
+    force?: boolean;
+    /** For reload: spawn a fresh owner even when none is currently running. */
+    spawnIfStopped?: boolean;
+}
+export interface DaemonOperationResult {
+    kind: DaemonKind;
+    action: Exclude<DaemonAction, "list">;
+    ok: boolean;
+    before?: DaemonStatus;
+    after?: DaemonStatus;
+    warnings: string[];
+    message: string;
+}
+export interface BuiltInDaemonController {
+    readonly kind: DaemonKind;
+    status(): Promise<DaemonStatus>;
+    stop(opts?: DaemonOperationOptions): Promise<DaemonOperationResult>;
+    reload(opts?: DaemonOperationOptions): Promise<DaemonOperationResult>;
+}

package/dist/types/daemon/runtime.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared source-vs-compiled runtime detection for daemon spawning.
+ *
+ * Centralizes the logic previously embedded in `ensureTelegramDaemonRunning`
+ * so session autostart, reload, and status reporting agree on how a daemon
+ * process is launched and whether a reload can pick up amended source.
+ */
+export interface SkcRuntimeSpawnInfo {
+    execPath: string;
+    mode: "source" | "compiled";
+    /** Prefix prepended before the skc subcommand args; `[Bun.main]` in source mode, otherwise `[]`. */
+    argsPrefix: string[];
+    /** True only when respawn loads edited TypeScript directly (source/dev mode). */
+    reloadPicksUpSourceEdits: boolean;
+    /** Set in compiled mode to explain that a rebuild is required before reload picks up source edits. */
+    warning?: string;
+}
+/**
+ * Resolve how to spawn a detached skc subcommand for the current runtime.
+ *
+ * Source/dev mode (bun/node) prepends the entry script (`Bun.main`) so the
+ * respawn loads edited source. A compiled single-file binary self-spawns its
+ * own subcommand directly and cannot pick up workspace source edits.
+ */
+export declare function resolveSkcRuntimeSpawnInfo(execPath?: string): SkcRuntimeSpawnInfo;