opensquid 0.5.395

package/dist/channels/config.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Chat-connection configuration loaded from
+ * `~/.opensquid/config.json` `chat_connections` block. Per-platform
+ * blocks are independent — having one configured doesn't require any
+ * of the others.
+ *
+ * Shape:
+ * ```json
+ * {
+ *   "version": 1,
+ *   "chat_connections": {
+ *     "telegram": { "bot_token": "...", "allowlist_chat_ids": ["8075471258"] },
+ *     "discord":  { "bot_token": "...", "allowlist_user_ids":  ["..."] },
+ *     "slack":    { "bot_token": "xoxb-...", "app_token": "xapp-...", "allowlist_user_ids": ["..."] }
+ *   }
+ * }
+ * ```
+ *
+ * Tokens are stored in cleartext in `config.json`; advise users to
+ * `chmod 600 ~/.opensquid/config.json` (the file lives in a hidden
+ * dir already, so this is a small additional hardening — not a real
+ * defense against a compromised user account).
+ *
+ * Ported from `src.legacy/chat/config.ts` for CAT.1b. Two relocations
+ * vs. the legacy module:
+ *   - The host `config.json` is read/written here directly, keyed on
+ *     `OPENSQUID_HOME()` (runtime/paths), instead of the legacy
+ *     `codex/store.js` data-root + `../config.js` engine helpers. The
+ *     new tree split engine-binary discovery into a SEPARATE
+ *     `engine-config.json` (src/engine/config.ts), so `config.json` is
+ *     now the chat stack's own file — but we still round-trip unknown
+ *     top-level keys so we never clobber a field another writer owns.
+ *   - The token resolver imports from the relocated `./env-token.js`.
+ */
+import { type EnvSource } from './env-token.js';
+export type ChatPlatform = 'telegram' | 'discord' | 'slack';
+export interface TelegramConfig {
+    bot_token: string;
+    /**
+     * Chat ids the bot will accept messages from. Empty = accept from any
+     * chat (NOT recommended — the bot is publicly addressable via Telegram).
+     */
+    allowlist_chat_ids?: string[];
+}
+export interface DiscordConfig {
+    bot_token: string;
+    /** User ids whose DMs / @-mentions the bot will respond to. Empty = bot owner only. */
+    allowlist_user_ids?: string[];
+}
+export interface SlackConfig {
+    /** Bot User OAuth Token — starts with `xoxb-`. Used for Web API calls. */
+    bot_token: string;
+    /**
+     * App-level Token — starts with `xapp-`. Required for Socket Mode
+     * (the no-public-ingress connection style we use).
+     */
+    app_token: string;
+    /** User ids the bot will respond to. Empty = bot owner only. */
+    allowlist_user_ids?: string[];
+}
+export interface ChatConnectionsConfig {
+    telegram?: TelegramConfig;
+    discord?: DiscordConfig;
+    slack?: SlackConfig;
+}
+export declare function loadChatConfig(): Promise<ChatConnectionsConfig>;
+export interface ChatTokenSources {
+    telegram?: EnvSource;
+    discord?: EnvSource;
+    slack_bot?: EnvSource;
+    slack_app?: EnvSource;
+    env_file_path?: string;
+}
+/**
+ * Like loadChatConfig but also returns which source each token came
+ * from. The chat-daemon uses this to log "[chat-daemon] telegram
+ * bot_token source: env-file (~/.loop/.env)" so operators can debug
+ * "which bot is this daemon actually using" without exposing the
+ * secret.
+ */
+export declare function loadChatConfigWithSources(): Promise<{
+    config: ChatConnectionsConfig;
+    sources: ChatTokenSources;
+}>;
+export declare function overlayEnvTokens(base: ChatConnectionsConfig): Promise<ChatConnectionsConfig>;
+export declare function saveChatConfig(chat: ChatConnectionsConfig): Promise<void>;
+/**
+ * Set a single platform's config block. Convenience for the future
+ * `opensquid chat setup <platform>` wizard.
+ */
+export declare function setPlatformConfig<P extends ChatPlatform>(platform: P, config: P extends 'telegram' ? TelegramConfig : P extends 'discord' ? DiscordConfig : SlackConfig): Promise<void>;
+/**
+ * Forget a single platform's config block. Reverts that platform to
+ * inactive on the next opensquid restart.
+ */
+export declare function forgetPlatformConfig(platform: ChatPlatform): Promise<void>;
+export interface ConfigValidationIssue {
+    platform: ChatPlatform;
+    field: string;
+    problem: string;
+}
+/**
+ * Surface obvious config errors without trying to validate the token
+ * against the live API (that happens on adapter start). Catches
+ * empty-string / undefined / shape mistakes before opening a connection.
+ */
+export declare function validateChatConfig(config: ChatConnectionsConfig): ConfigValidationIssue[];
+/** Which platforms have any non-empty config block? */
+export declare function configuredPlatforms(config: ChatConnectionsConfig): ChatPlatform[];
+//# sourceMappingURL=config.d.ts.map

package/dist/channels/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/channels/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAOH,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAW9D,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAM5D,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AA4CD,wBAAsB,cAAc,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAQrE;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC;IACzD,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,EAAE,gBAAgB,CAAC;CAC3B,CAAC,CAGD;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,qBAAqB,CAAC,CAGhC;AA0CD,wBAAsB,cAAc,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/E;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,YAAY,EAC5D,QAAQ,EAAE,CAAC,EACX,MAAM,EAAE,CAAC,SAAS,UAAU,GAAG,cAAc,GAAG,CAAC,SAAS,SAAS,GAAG,aAAa,GAAG,WAAW,GAChG,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhF;AAMD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,qBAAqB,EAAE,CAyDzF;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,YAAY,EAAE,CAMjF"}

package/dist/channels/config.js

@@ -0,0 +1,223 @@
+/**
+ * Chat-connection configuration loaded from
+ * `~/.opensquid/config.json` `chat_connections` block. Per-platform
+ * blocks are independent — having one configured doesn't require any
+ * of the others.
+ *
+ * Shape:
+ * ```json
+ * {
+ *   "version": 1,
+ *   "chat_connections": {
+ *     "telegram": { "bot_token": "...", "allowlist_chat_ids": ["8075471258"] },
+ *     "discord":  { "bot_token": "...", "allowlist_user_ids":  ["..."] },
+ *     "slack":    { "bot_token": "xoxb-...", "app_token": "xapp-...", "allowlist_user_ids": ["..."] }
+ *   }
+ * }
+ * ```
+ *
+ * Tokens are stored in cleartext in `config.json`; advise users to
+ * `chmod 600 ~/.opensquid/config.json` (the file lives in a hidden
+ * dir already, so this is a small additional hardening — not a real
+ * defense against a compromised user account).
+ *
+ * Ported from `src.legacy/chat/config.ts` for CAT.1b. Two relocations
+ * vs. the legacy module:
+ *   - The host `config.json` is read/written here directly, keyed on
+ *     `OPENSQUID_HOME()` (runtime/paths), instead of the legacy
+ *     `codex/store.js` data-root + `../config.js` engine helpers. The
+ *     new tree split engine-binary discovery into a SEPARATE
+ *     `engine-config.json` (src/engine/config.ts), so `config.json` is
+ *     now the chat stack's own file — but we still round-trip unknown
+ *     top-level keys so we never clobber a field another writer owns.
+ *   - The token resolver imports from the relocated `./env-token.js`.
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+import { OPENSQUID_HOME } from '../runtime/paths.js';
+import { resolveToken } from './env-token.js';
+const DEFAULT_HOST_CONFIG = { version: 1 };
+function hostConfigPath() {
+    return path.join(OPENSQUID_HOME(), 'config.json');
+}
+async function loadHostConfig() {
+    try {
+        const raw = await fs.readFile(hostConfigPath(), 'utf8');
+        const parsed = JSON.parse(raw);
+        if (parsed?.version === 1)
+            return parsed;
+    }
+    catch {
+        // missing or malformed — return default
+    }
+    return { ...DEFAULT_HOST_CONFIG };
+}
+async function saveHostConfig(config) {
+    const p = hostConfigPath();
+    await fs.mkdir(path.dirname(p), { recursive: true });
+    await fs.writeFile(p, JSON.stringify(config, null, 2) + '\n', 'utf8');
+}
+// ---------------------------------------------------------------------
+// Load / save
+// ---------------------------------------------------------------------
+export async function loadChatConfig() {
+    const raw = await loadHostConfig();
+    // 0.7.5 (#148): overlay env-var + .env tokens atop config.json. Lets
+    // the user park a Telegram bot token in ~/.loop/.env so opensquid
+    // uses a DIFFERENT bot than Claude Code's plugin:telegram (no 409
+    // collision possible — they're different bots). Priority is
+    // env > .env > config.json (per resolveToken).
+    return overlayEnvTokens(raw.chat_connections ?? {});
+}
+/**
+ * Like loadChatConfig but also returns which source each token came
+ * from. The chat-daemon uses this to log "[chat-daemon] telegram
+ * bot_token source: env-file (~/.loop/.env)" so operators can debug
+ * "which bot is this daemon actually using" without exposing the
+ * secret.
+ */
+export async function loadChatConfigWithSources() {
+    const raw = await loadHostConfig();
+    return overlayEnvTokensWithSources(raw.chat_connections ?? {});
+}
+export async function overlayEnvTokens(base) {
+    const { config } = await overlayEnvTokensWithSources(base);
+    return config;
+}
+async function overlayEnvTokensWithSources(base) {
+    const out = { ...base };
+    const sources = {};
+    // Telegram
+    const tg = await resolveToken('OPENSQUID_TELEGRAM_BOT_TOKEN', base.telegram?.bot_token);
+    if (tg.value) {
+        out.telegram = { ...(base.telegram ?? {}), bot_token: tg.value };
+        sources.telegram = tg.source;
+        if (tg.env_file_path)
+            sources.env_file_path = tg.env_file_path;
+    }
+    // Discord
+    const dc = await resolveToken('OPENSQUID_DISCORD_BOT_TOKEN', base.discord?.bot_token);
+    if (dc.value) {
+        out.discord = { ...(base.discord ?? {}), bot_token: dc.value };
+        sources.discord = dc.source;
+        if (dc.env_file_path && !sources.env_file_path)
+            sources.env_file_path = dc.env_file_path;
+    }
+    // Slack: needs both bot_token + app_token
+    const sb = await resolveToken('OPENSQUID_SLACK_BOT_TOKEN', base.slack?.bot_token);
+    const sa = await resolveToken('OPENSQUID_SLACK_APP_TOKEN', base.slack?.app_token);
+    if (sb.value || sa.value || base.slack) {
+        out.slack = {
+            ...(base.slack ?? { bot_token: '', app_token: '' }),
+            bot_token: sb.value ?? base.slack?.bot_token ?? '',
+            app_token: sa.value ?? base.slack?.app_token ?? '',
+        };
+        sources.slack_bot = sb.source;
+        sources.slack_app = sa.source;
+        if (sb.env_file_path && !sources.env_file_path)
+            sources.env_file_path = sb.env_file_path;
+        if (sa.env_file_path && !sources.env_file_path)
+            sources.env_file_path = sa.env_file_path;
+    }
+    return { config: out, sources };
+}
+export async function saveChatConfig(chat) {
+    const raw = await loadHostConfig();
+    raw.chat_connections = chat;
+    await saveHostConfig(raw);
+}
+/**
+ * Set a single platform's config block. Convenience for the future
+ * `opensquid chat setup <platform>` wizard.
+ */
+export async function setPlatformConfig(platform, config) {
+    const chat = await loadChatConfig();
+    // Cast narrows correctly per the conditional type above.
+    chat[platform] = config;
+    await saveChatConfig(chat);
+}
+/**
+ * Forget a single platform's config block. Reverts that platform to
+ * inactive on the next opensquid restart.
+ */
+export async function forgetPlatformConfig(platform) {
+    const chat = await loadChatConfig();
+    delete chat[platform];
+    await saveChatConfig(chat);
+}
+/**
+ * Surface obvious config errors without trying to validate the token
+ * against the live API (that happens on adapter start). Catches
+ * empty-string / undefined / shape mistakes before opening a connection.
+ */
+export function validateChatConfig(config) {
+    const issues = [];
+    if (config.telegram) {
+        if (!config.telegram.bot_token?.trim()) {
+            issues.push({
+                platform: 'telegram',
+                field: 'bot_token',
+                problem: 'empty — get one from @BotFather and run `opensquid chat setup telegram`',
+            });
+        }
+        else if (!/^\d+:[A-Za-z0-9_-]+$/.test(config.telegram.bot_token)) {
+            issues.push({
+                platform: 'telegram',
+                field: 'bot_token',
+                problem: "wrong format — should look like '123456:ABC-DEF...'",
+            });
+        }
+    }
+    if (config.discord) {
+        if (!config.discord.bot_token?.trim()) {
+            issues.push({
+                platform: 'discord',
+                field: 'bot_token',
+                problem: 'empty — Discord Developer Portal → Application → Bot → Reset Token',
+            });
+        }
+    }
+    if (config.slack) {
+        if (!config.slack.bot_token?.trim()) {
+            issues.push({
+                platform: 'slack',
+                field: 'bot_token',
+                problem: 'empty — api.slack.com/apps → OAuth & Permissions → Bot User OAuth Token (xoxb-...)',
+            });
+        }
+        else if (!config.slack.bot_token.startsWith('xoxb-')) {
+            issues.push({
+                platform: 'slack',
+                field: 'bot_token',
+                problem: "should start with 'xoxb-' (Bot User OAuth Token, not Workspace token)",
+            });
+        }
+        if (!config.slack.app_token?.trim()) {
+            issues.push({
+                platform: 'slack',
+                field: 'app_token',
+                problem: 'empty — required for Socket Mode; api.slack.com/apps → Basic Information → App-Level Tokens (xapp-...)',
+            });
+        }
+        else if (!config.slack.app_token.startsWith('xapp-')) {
+            issues.push({
+                platform: 'slack',
+                field: 'app_token',
+                problem: "should start with 'xapp-' (App-Level Token, NOT Bot User OAuth Token)",
+            });
+        }
+    }
+    return issues;
+}
+/** Which platforms have any non-empty config block? */
+export function configuredPlatforms(config) {
+    const out = [];
+    if (config.telegram)
+        out.push('telegram');
+    if (config.discord)
+        out.push('discord');
+    if (config.slack)
+        out.push('slack');
+    return out;
+}
+//# sourceMappingURL=config.js.map

package/dist/channels/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/channels/config.ts"],"names":[],"mappings":"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"}

package/dist/channels/daemon/autospawn.d.ts

@@ -0,0 +1,64 @@
+/**
+ * chat-transport daemon auto-spawn (T-CHAT-AS-TERMINAL CAT.1d).
+ *
+ * Re-point of the legacy `src.legacy/chat/daemon/autospawn.ts`. The legacy
+ * autospawn fired from the legacy MCP server boot (`src.legacy/index.ts`),
+ * which is no longer the active server — the live MCP entrypoints are
+ * `src/mcp/server.js` + `src/mcp/chat-bridge-server.js` (G.8 wiring). So the
+ * NEW chat MCP bridge (`src/mcp/chat-bridge-server.ts`) calls this on boot to
+ * opportunistically ensure the NEW chat-transport daemon
+ * (`src/channels/daemon/`) is running, so `chat_send` has a socket to dial and
+ * inbound Telegram lands in the umbrella inboxes — without the operator having
+ * to remember `opensquid chat-daemon start` after every reboot.
+ *
+ * Behavior (mirrors the legacy contract):
+ *   - No-op when no chat platform is configured (`loadChatConfig` → nothing).
+ *   - No-op when a daemon is already running.
+ *   - Otherwise acquire an atomic spawn-lock (`fs.open(lock, 'wx')`) so two
+ *     concurrent MCP servers don't double-spawn; the loser waits briefly for
+ *     the winner's pidfile. Stale lock (> 15s) is reclaimed.
+ *   - Always async + non-throwing: callers fire-and-forget without try/catch.
+ *
+ * `startDaemon` (lifecycle.ts) spawns `process.argv[1]` (the running binary,
+ * `dist/cli.js`) with the `chat-daemon-worker` token — which `src/cli.ts`
+ * short-circuits to `runDaemonWorker()`. The MCP server's `process.argv[1]` is
+ * `dist/mcp/chat-bridge-server.js`, NOT `dist/cli.js`, so we override
+ * `entrypoint` to the CLI binary (resolved alongside the MCP server in dist/).
+ *
+ * Imports from: node:fs, node:path, ../config, ../../runtime/paths, ./lifecycle.
+ * Imported by: src/mcp/chat-bridge-server.ts (boot) + tests.
+ */
+import { startDaemon, status } from './lifecycle.js';
+export interface AutoSpawnResult {
+    status: 'spawned' | 'already_running' | 'waited_for_peer' | 'no_config' | 'error';
+    pid?: number;
+    error?: string;
+}
+/**
+ * Resolve the CLI binary (`dist/cli.js`) so the spawned worker re-invokes the
+ * right entrypoint regardless of which binary is doing the autospawn. From the
+ * MCP server at `dist/mcp/chat-bridge-server.js`, the CLI sits at `dist/cli.js`
+ * — two dirs up + `cli.js`. Honors `OPENSQUID_CLI_ENTRYPOINT` for tests.
+ */
+export declare function resolveCliEntrypoint(): string;
+/**
+ * Injection seams for tests — so a unit test can exercise the autospawn FSM
+ * WITHOUT reading the developer's real chat config or spawning a live daemon
+ * (the live cutover is the operator's job, never the test suite's).
+ */
+export interface EnsureChatDaemonDeps {
+    /** Override the spawned worker's entrypoint (defaults to `dist/cli.js`). */
+    entrypoint?: string;
+    /** Override the "is any platform configured" probe. */
+    isConfigured?: () => Promise<boolean>;
+    /** Override the liveness probe (defaults to `lifecycle.status`). */
+    statusFn?: typeof status;
+    /** Override the spawn (defaults to `lifecycle.startDaemon`). */
+    startFn?: typeof startDaemon;
+}
+/**
+ * Best-effort: ensure the chat-transport daemon is running. Returns on the
+ * no-op paths (no config, already running, peer-spawning). Never throws.
+ */
+export declare function ensureChatDaemonRunning(opts?: EnsureChatDaemonDeps): Promise<AutoSpawnResult>;
+//# sourceMappingURL=autospawn.d.ts.map

package/dist/channels/daemon/autospawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autospawn.d.ts","sourceRoot":"","sources":["../../../src/channels/daemon/autospawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AASH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAMrD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,WAAW,GAAG,OAAO,CAAC;IAClF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C;AAYD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,MAAM,CAAC;IACzB,gEAAgE;IAChE,OAAO,CAAC,EAAE,OAAO,WAAW,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,GAAE,oBAAyB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAqC1B"}

package/dist/channels/daemon/autospawn.js

@@ -0,0 +1,145 @@
+/**
+ * chat-transport daemon auto-spawn (T-CHAT-AS-TERMINAL CAT.1d).
+ *
+ * Re-point of the legacy `src.legacy/chat/daemon/autospawn.ts`. The legacy
+ * autospawn fired from the legacy MCP server boot (`src.legacy/index.ts`),
+ * which is no longer the active server — the live MCP entrypoints are
+ * `src/mcp/server.js` + `src/mcp/chat-bridge-server.js` (G.8 wiring). So the
+ * NEW chat MCP bridge (`src/mcp/chat-bridge-server.ts`) calls this on boot to
+ * opportunistically ensure the NEW chat-transport daemon
+ * (`src/channels/daemon/`) is running, so `chat_send` has a socket to dial and
+ * inbound Telegram lands in the umbrella inboxes — without the operator having
+ * to remember `opensquid chat-daemon start` after every reboot.
+ *
+ * Behavior (mirrors the legacy contract):
+ *   - No-op when no chat platform is configured (`loadChatConfig` → nothing).
+ *   - No-op when a daemon is already running.
+ *   - Otherwise acquire an atomic spawn-lock (`fs.open(lock, 'wx')`) so two
+ *     concurrent MCP servers don't double-spawn; the loser waits briefly for
+ *     the winner's pidfile. Stale lock (> 15s) is reclaimed.
+ *   - Always async + non-throwing: callers fire-and-forget without try/catch.
+ *
+ * `startDaemon` (lifecycle.ts) spawns `process.argv[1]` (the running binary,
+ * `dist/cli.js`) with the `chat-daemon-worker` token — which `src/cli.ts`
+ * short-circuits to `runDaemonWorker()`. The MCP server's `process.argv[1]` is
+ * `dist/mcp/chat-bridge-server.js`, NOT `dist/cli.js`, so we override
+ * `entrypoint` to the CLI binary (resolved alongside the MCP server in dist/).
+ *
+ * Imports from: node:fs, node:path, ../config, ../../runtime/paths, ./lifecycle.
+ * Imported by: src/mcp/chat-bridge-server.ts (boot) + tests.
+ */
+import { promises as fs } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loadChatConfig } from '../config.js';
+import { OPENSQUID_HOME } from '../../runtime/paths.js';
+import { startDaemon, status } from './lifecycle.js';
+const STALE_LOCK_AGE_MS = 15_000;
+const PIDFILE_WAIT_MS = 8_000;
+const POLL_INTERVAL_MS = 100;
+const spawnLockPath = () => join(OPENSQUID_HOME(), 'chat-daemon.spawn.lock');
+/**
+ * Resolve the CLI binary (`dist/cli.js`) so the spawned worker re-invokes the
+ * right entrypoint regardless of which binary is doing the autospawn. From the
+ * MCP server at `dist/mcp/chat-bridge-server.js`, the CLI sits at `dist/cli.js`
+ * — two dirs up + `cli.js`. Honors `OPENSQUID_CLI_ENTRYPOINT` for tests.
+ */
+export function resolveCliEntrypoint() {
+    const override = process.env.OPENSQUID_CLI_ENTRYPOINT;
+    if (override !== undefined && override.length > 0)
+        return override;
+    const here = fileURLToPath(import.meta.url);
+    // dist/channels/daemon/autospawn.js → dist → dist/cli.js
+    return resolve(dirname(here), '..', '..', 'cli.js');
+}
+/** True iff at least one chat platform has a token configured. */
+async function anyChatConfigured() {
+    const config = await loadChatConfig();
+    return (config.telegram?.bot_token !== undefined ||
+        config.discord?.bot_token !== undefined ||
+        config.slack?.bot_token !== undefined);
+}
+/**
+ * Best-effort: ensure the chat-transport daemon is running. Returns on the
+ * no-op paths (no config, already running, peer-spawning). Never throws.
+ */
+export async function ensureChatDaemonRunning(opts = {}) {
+    const isConfigured = opts.isConfigured ?? anyChatConfigured;
+    const statusFn = opts.statusFn ?? status;
+    const startFn = opts.startFn ?? startDaemon;
+    try {
+        if (!(await isConfigured()))
+            return { status: 'no_config' };
+        const cur = await statusFn();
+        if (cur.running)
+            return { status: 'already_running', pid: cur.pid };
+        const entrypoint = opts.entrypoint ?? resolveCliEntrypoint();
+        const lockPath = spawnLockPath();
+        const acquired = await tryAcquireLock(lockPath);
+        if (acquired) {
+            try {
+                // Re-check after acquiring the lock — a peer may have finished
+                // spawning between our status() and the lock.
+                const re = await statusFn();
+                if (re.running)
+                    return { status: 'already_running', pid: re.pid };
+                const res = await startFn({ entrypoint });
+                return res.already_running
+                    ? { status: 'already_running', pid: res.pid }
+                    : { status: 'spawned', pid: res.pid };
+            }
+            finally {
+                await fs.unlink(lockPath).catch(() => {
+                    /* race-tolerant */
+                });
+            }
+        }
+        // Another process holds the lock — wait for its pidfile.
+        const pid = await waitForPeer(statusFn);
+        if (pid !== null)
+            return { status: 'waited_for_peer', pid };
+        return { status: 'error', error: 'peer spawn timed out' };
+    }
+    catch (err) {
+        return { status: 'error', error: err instanceof Error ? err.message : String(err) };
+    }
+}
+async function tryAcquireLock(lockPath) {
+    await fs.mkdir(dirname(lockPath), { recursive: true });
+    try {
+        const fd = await fs.open(lockPath, 'wx');
+        await fd.write(`${process.pid}\n`);
+        await fd.close();
+        return true;
+    }
+    catch (err) {
+        if (err.code !== 'EEXIST')
+            throw err;
+        // Lock exists — reclaim it if stale, else yield.
+        try {
+            const st = await fs.stat(lockPath);
+            if (Date.now() - st.mtimeMs > STALE_LOCK_AGE_MS) {
+                await fs.unlink(lockPath).catch(() => {
+                    /* race */
+                });
+                return tryAcquireLock(lockPath);
+            }
+        }
+        catch {
+            // Lock vanished between EEXIST and stat — retry.
+            return tryAcquireLock(lockPath);
+        }
+        return false;
+    }
+}
+async function waitForPeer(statusFn) {
+    const deadline = Date.now() + PIDFILE_WAIT_MS;
+    while (Date.now() < deadline) {
+        const s = await statusFn();
+        if (s.running)
+            return s.pid;
+        await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+    }
+    return null;
+}
+//# sourceMappingURL=autospawn.js.map

package/dist/channels/daemon/autospawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autospawn.js","sourceRoot":"","sources":["../../../src/channels/daemon/autospawn.ts"],"names":[],"mappings":"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"}

package/dist/channels/daemon/cli.d.ts

@@ -0,0 +1,38 @@
+/**
+ * chat-transport daemon CLI (T-CHAT-AS-TERMINAL CAT.1d).
+ *
+ * Two entry shapes, mirroring the legacy `src.legacy/chat/daemon/cli.ts` so
+ * `lifecycle.startDaemon` (which re-invokes `process.argv[1]` with the
+ * `chat-daemon-worker` token) keeps working against the NEW binary (`dist/
+ * cli.js`):
+ *
+ *   `opensquid chat-daemon {start|stop|status|restart}` — user-facing, a
+ *       commander sub-group registered on the root program.
+ *   `opensquid chat-daemon-worker`                       — internal, never
+ *       typed by a user. Handled by an EARLY short-circuit in `src/cli.ts`
+ *       (before commander parses) because the worker parks the event loop and
+ *       never returns. `runChatDaemonWorkerEntry` is that entrypoint.
+ *
+ * `start` spawns the worker as a detached child and returns once the child has
+ * written its pidfile. The wiring is intentionally thin — all the real
+ * lifecycle logic lives in `./lifecycle.ts` + `./worker.ts`.
+ *
+ * Imports from: commander, ./lifecycle, ./worker.
+ * Imported by: src/cli.ts.
+ */
+import type { Command } from 'commander';
+/**
+ * Internal worker entrypoint — invoked by the detached child that
+ * `lifecycle.startDaemon` spawns. Never returns (parks the event loop); signal
+ * handlers inside `runDaemonWorker` drive shutdown. On an unexpected throw it
+ * logs + exits non-zero so the parent's pidfile-wait fails fast.
+ */
+export declare function runChatDaemonWorkerEntry(): Promise<never>;
+/**
+ * Register `opensquid chat-daemon {start|stop|status|restart}` on the root
+ * program. Each verb wraps the matching `./lifecycle` function. `start` /
+ * `restart` spawn the detached worker via `chat-daemon-worker`; `status` is
+ * read-only; `stop` is idempotent.
+ */
+export declare function registerChatDaemon(program: Command): Command;
+//# sourceMappingURL=cli.d.ts.map

package/dist/channels/daemon/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/channels/daemon/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC;;;;;GAKG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,KAAK,CAAC,CAS/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CA6D5D"}