opensquid 0.5.395

package/dist/channels/daemon/rpc_server.js

@@ -0,0 +1,229 @@
+/**
+ * chat-transport daemon RPC server (T-CHAT-AS-TERMINAL CAT.1b).
+ *
+ * Runs INSIDE the daemon worker. Listens on the platform-correct socket
+ * address (Unix socket / named pipe) and dispatches JSON-RPC method calls to
+ * the in-process `ChatGateway`. Ported from `src.legacy/chat/daemon/
+ * rpc-server.ts`, minus the dropped subscribe/unsubscribe broker (see
+ * `./protocol.ts` — the file-tail watcher replaced inbound push).
+ *
+ * Connection model: stateless. Each newline-delimited line is one request; the
+ * response goes back on the same connection. Connections may pipeline; the
+ * server buffers per-connection until `\n`.
+ *
+ * The `send` result shape `{ok:true, platform, message_id, delivered_at}` and
+ * the method names are LOAD-BEARING — `src/mcp/chat-bridge-server.ts` +
+ * `src/runtime/agent_bridge/tools/chat_send.ts` parse them. Do not change them.
+ *
+ * Imports from: node:net, node:fs, ../gateway, ./protocol.
+ * Imported by: ./worker.ts + tests.
+ */
+import { existsSync, unlinkSync } from 'node:fs';
+import { createServer } from 'node:net';
+import { daemonSockAddress, JSON_RPC_INTERNAL_ERROR, JSON_RPC_INVALID_PARAMS, JSON_RPC_INVALID_REQUEST, JSON_RPC_METHOD_NOT_FOUND, JSON_RPC_PARSE_ERROR, } from './protocol.js';
+export class RpcServer {
+    opts;
+    server;
+    listening = false;
+    address;
+    startedAt;
+    constructor(opts) {
+        this.opts = opts;
+        this.address = daemonSockAddress();
+        this.startedAt = opts.startedAt ?? Date.now();
+        this.server = createServer((socket) => this.handleConnection(socket));
+        // A misbehaving client must not crash the daemon. Per-connection errors
+        // are handled in handleConnection.
+        this.server.on('error', () => {
+            /* swallowed at server level */
+        });
+    }
+    /** The resolved socket address (for diagnostics / tests). */
+    get socketAddress() {
+        return this.address;
+    }
+    async listen() {
+        if (this.listening)
+            return;
+        // Clean up a stale Unix socket left by an aborted daemon. Safe: the
+        // lifecycle layer verified no live daemon before we got here. Windows
+        // named pipes leave no file residue, so this is a no-op there.
+        if (process.platform !== 'win32' && existsSync(this.address)) {
+            try {
+                unlinkSync(this.address);
+            }
+            catch {
+                /* race-tolerant */
+            }
+        }
+        await new Promise((resolve, reject) => {
+            const onError = (err) => reject(err);
+            this.server.once('error', onError);
+            this.server.listen(this.address, () => {
+                this.server.off('error', onError);
+                this.listening = true;
+                resolve();
+            });
+        });
+    }
+    async close() {
+        if (!this.listening)
+            return;
+        await new Promise((resolve) => {
+            this.server.close(() => resolve());
+        });
+        this.listening = false;
+        if (process.platform !== 'win32' && existsSync(this.address)) {
+            try {
+                unlinkSync(this.address);
+            }
+            catch {
+                /* race-tolerant */
+            }
+        }
+    }
+    handleConnection(socket) {
+        let buf = '';
+        socket.setEncoding('utf8');
+        socket.on('data', (chunk) => {
+            buf += chunk;
+            let nl;
+            while ((nl = buf.indexOf('\n')) >= 0) {
+                const line = buf.slice(0, nl);
+                buf = buf.slice(nl + 1);
+                if (line.trim().length === 0)
+                    continue;
+                this.dispatchLine(line, socket);
+            }
+        });
+        socket.on('error', () => {
+            // Half-open connections are common; close quietly without surfacing.
+            try {
+                socket.destroy();
+            }
+            catch {
+                /* already gone */
+            }
+        });
+    }
+    dispatchLine(line, socket) {
+        let req;
+        try {
+            req = JSON.parse(line);
+        }
+        catch {
+            this.respond(socket, parseError());
+            return;
+        }
+        if (req === null ||
+            typeof req !== 'object' ||
+            req.jsonrpc !== '2.0' ||
+            typeof req.id === 'undefined' ||
+            typeof req.method !== 'string') {
+            const maybeId = req?.id;
+            this.respond(socket, invalidRequest(maybeId ?? null));
+            return;
+        }
+        if (this.opts.onRequest)
+            this.opts.onRequest(req.method);
+        void this.handle(req).then((res) => this.respond(socket, res));
+    }
+    respond(socket, response) {
+        try {
+            socket.write(`${JSON.stringify(response)}\n`);
+        }
+        catch {
+            /* dropped — connection gone */
+        }
+    }
+    async handle(req) {
+        try {
+            switch (req.method) {
+                case 'ping':
+                    return success(req.id, {
+                        pong: true,
+                        pid: this.opts.pid ?? process.pid,
+                        version: this.opts.version ?? 'unknown',
+                    });
+                case 'list_channels': {
+                    const platforms = this.opts.gateway.activePlatforms();
+                    // Duck-type isOutboundOnly so a platform can opt in later without
+                    // changing this code. The new telegram adapter does not expose it
+                    // yet, so this stays empty for now.
+                    const outboundOnly = [];
+                    for (const p of platforms) {
+                        const adapter = this.opts.gateway.getAdapter(p);
+                        const maybe = adapter;
+                        if (typeof maybe.isOutboundOnly === 'function' && maybe.isOutboundOnly()) {
+                            outboundOnly.push(p);
+                        }
+                    }
+                    return success(req.id, {
+                        active_platforms: platforms,
+                        uptime_ms: Date.now() - this.startedAt,
+                        outbound_only_platforms: outboundOnly,
+                    });
+                }
+                case 'send': {
+                    const p = req.params;
+                    if (p === undefined || typeof p.channel !== 'string' || typeof p.text !== 'string') {
+                        return failure(req.id, JSON_RPC_INVALID_PARAMS, 'send: channel + text required');
+                    }
+                    const result = await this.opts.gateway.send({
+                        channel: p.channel,
+                        text: p.text,
+                        ...(p.replyTo !== undefined ? { replyTo: p.replyTo } : {}),
+                        ...(p.threadId !== undefined ? { threadId: p.threadId } : {}),
+                        // CAT.4 — additive media path (text → caption when present).
+                        ...(p.mediaPath !== undefined ? { mediaPath: p.mediaPath } : {}),
+                    });
+                    return success(req.id, {
+                        ok: true,
+                        platform: result.platform,
+                        message_id: result.messageId,
+                        delivered_at: result.deliveredAt.toISOString(),
+                    });
+                }
+                case 'create_topic': {
+                    const p = req.params;
+                    if (p?.platform !== 'telegram' ||
+                        typeof p.chat_id !== 'string' ||
+                        typeof p.name !== 'string') {
+                        return failure(req.id, JSON_RPC_INVALID_PARAMS, "create_topic: platform='telegram', chat_id, name required");
+                    }
+                    const res = await this.opts.gateway.createTopic({
+                        platform: 'telegram',
+                        chatId: p.chat_id,
+                        name: p.name,
+                        ...(p.icon_color !== undefined ? { iconColor: p.icon_color } : {}),
+                        ...(p.icon_custom_emoji_id !== undefined
+                            ? { iconCustomEmojiId: p.icon_custom_emoji_id }
+                            : {}),
+                    });
+                    return success(req.id, res);
+                }
+                default:
+                    return failure(req.id, JSON_RPC_METHOD_NOT_FOUND, `unknown method: ${String(req.method)}`);
+            }
+        }
+        catch (err) {
+            return failure(req.id, JSON_RPC_INTERNAL_ERROR, err instanceof Error ? err.message : String(err));
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// JSON-RPC response helpers
+// ---------------------------------------------------------------------------
+function success(id, result) {
+    return { jsonrpc: '2.0', id, result };
+}
+function failure(id, code, message) {
+    return { jsonrpc: '2.0', id, error: { code, message } };
+}
+function parseError() {
+    return failure(null, JSON_RPC_PARSE_ERROR, 'parse error');
+}
+function invalidRequest(id) {
+    return failure(id, JSON_RPC_INVALID_REQUEST, 'invalid jsonrpc request');
+}
+//# sourceMappingURL=rpc_server.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * chat-transport daemon worker (T-CHAT-AS-TERMINAL CAT.1b).
+ *
+ * The long-running process spawned (detached) by `./lifecycle.startDaemon`.
+ * Ported from `src.legacy/chat/daemon/worker.ts` onto the new-tree primitives.
+ *
+ * Lifecycle inside the worker:
+ *   1. Write the pidfile (`chat-daemon.pid`) FIRST so a post-spawn status check
+ *      sees the worker promptly.
+ *   2. Load the umbrella routing config (`loadChannelsConfig`) + build the
+ *      transport adapters (`buildChatAdapters`).
+ *   3. Subscribe the telegram adapter's RICH transport surface
+ *      (`subscribeTransport`) → `routeAndWriteInbound(channelsConfig, msg, now)`
+ *      — the inbound path that writes umbrella-keyed inbox rows. (Inbound
+ *      DELIVERY to sessions is the file-tail watcher's job, not the daemon's.)
+ *   4. `gateway.start()` (kicks the long-poll loops) + start the RPC server
+ *      (outbound `send` + `ping` + `list_channels` + `create_topic`).
+ *   5. SIGTERM/SIGINT → graceful shutdown: stop adapters, close the server,
+ *      remove pidfile + socket.
+ *   6. Park on a long no-op interval so the event loop stays alive.
+ *
+ * Degradation: if `channelsConfig` is null (absent/malformed channels.json) the
+ * worker still serves OUTBOUND (gateway.send works) — only inbound routing is
+ * affected, and every inbound message orphans (routeAndWriteInbound writes to
+ * the orphan inbox when the config can't resolve an umbrella). We pass an empty
+ * `{ v:1, umbrellas:[] }` config in that case so every message orphans cleanly
+ * rather than crashing the handler.
+ *
+ * Imports from: node:fs, grammy, ../config, ../factory, ../gateway, ../routing,
+ *   ../transport_inbox, ../../runtime/paths, ./protocol, ./rpc_server.
+ * Imported by: ./lifecycle.ts (as the worker entry) + tests. NOT wired into the
+ * CLI yet (CAT.1d owns CLI/autospawn).
+ */
+import { type ChannelsConfig } from '../routing.js';
+import type { ChannelAdapter, InboundChatMessage } from '../types.js';
+/**
+ * Wire one rich-transport adapter's `subscribeTransport` to the umbrella inbox
+ * writer. Extracted from `runDaemonWorker` as a pure, testable seam: given a
+ * subscribe-capable adapter + a channels config, every emitted
+ * `InboundChatMessage` is routed + written via `routeAndWriteInbound`. Returns
+ * the subscription (caller owns unsubscribe), or null when the adapter has no
+ * transport surface.
+ */
+export declare function wireInboundTransport(adapter: Pick<ChannelAdapter, 'subscribeTransport'>, routingConfig: ChannelsConfig, onError?: (msg: InboundChatMessage, err: unknown) => void): Promise<{
+    unsubscribe(): Promise<void>;
+} | null>;
+export declare function runDaemonWorker(): Promise<never>;
+//# sourceMappingURL=worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/channels/daemon/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAUH,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA4CtE;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,EACnD,aAAa,EAAE,cAAc,EAC7B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,GACxD,OAAO,CAAC;IAAE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,GAAG,IAAI,CAAC,CASlD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,KAAK,CAAC,CAyGtD"}

package/dist/channels/daemon/worker.js

@@ -0,0 +1,218 @@
+/**
+ * chat-transport daemon worker (T-CHAT-AS-TERMINAL CAT.1b).
+ *
+ * The long-running process spawned (detached) by `./lifecycle.startDaemon`.
+ * Ported from `src.legacy/chat/daemon/worker.ts` onto the new-tree primitives.
+ *
+ * Lifecycle inside the worker:
+ *   1. Write the pidfile (`chat-daemon.pid`) FIRST so a post-spawn status check
+ *      sees the worker promptly.
+ *   2. Load the umbrella routing config (`loadChannelsConfig`) + build the
+ *      transport adapters (`buildChatAdapters`).
+ *   3. Subscribe the telegram adapter's RICH transport surface
+ *      (`subscribeTransport`) → `routeAndWriteInbound(channelsConfig, msg, now)`
+ *      — the inbound path that writes umbrella-keyed inbox rows. (Inbound
+ *      DELIVERY to sessions is the file-tail watcher's job, not the daemon's.)
+ *   4. `gateway.start()` (kicks the long-poll loops) + start the RPC server
+ *      (outbound `send` + `ping` + `list_channels` + `create_topic`).
+ *   5. SIGTERM/SIGINT → graceful shutdown: stop adapters, close the server,
+ *      remove pidfile + socket.
+ *   6. Park on a long no-op interval so the event loop stays alive.
+ *
+ * Degradation: if `channelsConfig` is null (absent/malformed channels.json) the
+ * worker still serves OUTBOUND (gateway.send works) — only inbound routing is
+ * affected, and every inbound message orphans (routeAndWriteInbound writes to
+ * the orphan inbox when the config can't resolve an umbrella). We pass an empty
+ * `{ v:1, umbrellas:[] }` config in that case so every message orphans cleanly
+ * rather than crashing the handler.
+ *
+ * Imports from: node:fs, grammy, ../config, ../factory, ../gateway, ../routing,
+ *   ../transport_inbox, ../../runtime/paths, ./protocol, ./rpc_server.
+ * Imported by: ./lifecycle.ts (as the worker entry) + tests. NOT wired into the
+ * CLI yet (CAT.1d owns CLI/autospawn).
+ */
+import { promises as fs } from 'node:fs';
+import { Bot } from 'grammy';
+import { chatDaemonPidPath } from '../../runtime/paths.js';
+import { loadChatConfig, loadChatConfigWithSources } from '../config.js';
+import { buildChatAdapters } from '../factory.js';
+import { ChatGateway } from '../gateway.js';
+import { loadChannelsConfig } from '../routing.js';
+import { routeAndWriteInbound } from '../transport_inbox.js';
+import { RpcServer } from './rpc_server.js';
+const DAEMON_VERSION = 'cat-1b';
+/** Empty channels config — used when channels.json is absent/malformed so the
+ *  inbound handler still runs (every message orphans cleanly). */
+const EMPTY_CHANNELS_CONFIG = { v: 1, umbrellas: [] };
+function log(line) {
+    // The detached parent redirects stdio to the log file; plain stdout lands
+    // there.
+    process.stdout.write(`${new Date().toISOString()} ${line}\n`);
+}
+/**
+ * Build the telegram `createTopic` seam from the resolved token. Constructs a
+ * dedicated grammy Bot for the outbound forum-topic API call (independent of
+ * the adapter's long-poll). Returns undefined when telegram has no token.
+ */
+async function buildCreateTopicSeam() {
+    const config = await loadChatConfig();
+    const token = config.telegram?.bot_token;
+    if (token === undefined || token.length === 0)
+        return undefined;
+    const bot = new Bot(token);
+    return async (args) => {
+        // grammy's `Other<>` param type rejects `?:`-optional props under
+        // exactOptionalPropertyTypes; build a plain record + cast at the call.
+        const other = {};
+        if (args.iconColor !== undefined)
+            other.icon_color = args.iconColor;
+        if (args.iconCustomEmojiId !== undefined)
+            other.icon_custom_emoji_id = args.iconCustomEmojiId;
+        const res = await bot.api.createForumTopic(args.chatId, args.name, other);
+        return { message_thread_id: res.message_thread_id, name: res.name };
+    };
+}
+/**
+ * Wire one rich-transport adapter's `subscribeTransport` to the umbrella inbox
+ * writer. Extracted from `runDaemonWorker` as a pure, testable seam: given a
+ * subscribe-capable adapter + a channels config, every emitted
+ * `InboundChatMessage` is routed + written via `routeAndWriteInbound`. Returns
+ * the subscription (caller owns unsubscribe), or null when the adapter has no
+ * transport surface.
+ */
+export async function wireInboundTransport(adapter, routingConfig, onError) {
+    if (typeof adapter.subscribeTransport !== 'function')
+        return null;
+    return adapter.subscribeTransport(async (msg) => {
+        try {
+            await routeAndWriteInbound(routingConfig, msg, new Date().toISOString());
+        }
+        catch (err) {
+            if (onError)
+                onError(msg, err);
+        }
+    });
+}
+export async function runDaemonWorker() {
+    const pidFile = chatDaemonPidPath();
+    const state = {
+        gateway: null,
+        rpcServer: null,
+        pidFile,
+        shuttingDown: false,
+    };
+    // Pidfile FIRST. Truncate-write: any previous pidfile is stale by definition
+    // (lifecycle.startDaemon verified no live daemon before spawning us).
+    await fs.writeFile(pidFile, `${process.pid}\n`, 'utf8');
+    log(`[chat-daemon] worker booted pid=${process.pid} cwd=${process.cwd()}`);
+    try {
+        // Log which source each token came from (never the value) so operators can
+        // debug "which bot is this daemon using" — mirrors the legacy worker.
+        try {
+            const { sources } = await loadChatConfigWithSources();
+            const lines = [];
+            if (sources.telegram)
+                lines.push(`telegram=${sources.telegram}`);
+            if (sources.discord)
+                lines.push(`discord=${sources.discord}`);
+            if (sources.slack_bot)
+                lines.push(`slack_bot=${sources.slack_bot}`);
+            if (sources.slack_app)
+                lines.push(`slack_app=${sources.slack_app}`);
+            if (lines.length > 0) {
+                log(`[chat-daemon] token sources: ${lines.join(' ')}${sources.env_file_path ? ` (env-file: ${sources.env_file_path})` : ''}`);
+            }
+        }
+        catch (logErr) {
+            log(`[chat-daemon] could not log token sources (non-fatal): ${logErr instanceof Error ? logErr.message : String(logErr)}`);
+        }
+        // Umbrella routing config. Null ⇒ degrade to an empty config (everything
+        // orphans) while still serving outbound.
+        const channelsConfig = await loadChannelsConfig();
+        if (channelsConfig === null) {
+            log('[chat-daemon] channels.json absent/invalid — inbound messages will orphan');
+        }
+        else {
+            log(`[chat-daemon] channels.json loaded: ${channelsConfig.umbrellas.length} umbrellas`);
+        }
+        const routingConfig = channelsConfig ?? EMPTY_CHANNELS_CONFIG;
+        // Build the transport adapters.
+        const built = await buildChatAdapters();
+        log(`[chat-daemon] activating platforms: ${built.activated.join(',') || '(none)'}`);
+        for (const issue of built.issues)
+            log(`[chat-daemon] ${issue}`);
+        const createTopic = await buildCreateTopicSeam();
+        const gateway = new ChatGateway({
+            adapters: built.adapters,
+            ...(createTopic !== undefined ? { createTopic } : {}),
+        });
+        state.gateway = gateway;
+        // Wire the rich-transport inbound surface → umbrella inbox writer. Only
+        // telegram emits InboundChatMessage today.
+        const telegram = built.adapters.get('telegram');
+        if (telegram !== undefined) {
+            const sub = await wireInboundTransport(telegram, routingConfig, (msg, err) => log(`[chat-daemon] inbox write failed for ${msg.platform}:${msg.chatId}: ${err instanceof Error ? err.message : String(err)}`));
+            if (sub === null) {
+                log('[chat-daemon] telegram adapter has no subscribeTransport surface — inbound disabled');
+            }
+        }
+        // Start adapter long-poll loops, then the RPC server (clients that connect
+        // are guaranteed a warmed gateway).
+        await gateway.start();
+        log('[chat-daemon] gateway start complete');
+        const rpcServer = new RpcServer({ gateway, version: DAEMON_VERSION });
+        await rpcServer.listen();
+        state.rpcServer = rpcServer;
+        log(`[chat-daemon] rpc server listening on ${rpcServer.socketAddress}; entering park loop`);
+    }
+    catch (err) {
+        log(`[chat-daemon] FATAL: startup failed: ${err instanceof Error ? err.stack : String(err)}`);
+        await cleanup(state);
+        process.exit(1);
+    }
+    process.on('SIGTERM', () => void shutdown(state, 'SIGTERM'));
+    process.on('SIGINT', () => void shutdown(state, 'SIGINT'));
+    // Park forever. A long-interval no-op timer is the reliable keep-alive (an
+    // unresolved Promise alone won't hold the loop; stdin is /dev/null when
+    // spawned detached). Signal handlers fire independently.
+    setInterval(() => {
+        /* keep-alive heartbeat */
+    }, 1 << 30);
+    return await new Promise(() => {
+        /* never resolves — held alive by the heartbeat interval */
+    });
+}
+async function shutdown(state, signal) {
+    if (state.shuttingDown)
+        return;
+    state.shuttingDown = true;
+    log(`[chat-daemon] ${signal} received, shutting down...`);
+    try {
+        if (state.rpcServer)
+            await state.rpcServer.close();
+    }
+    catch (err) {
+        log(`[chat-daemon] rpc close error (non-fatal): ${err instanceof Error ? err.message : String(err)}`);
+    }
+    try {
+        if (state.gateway)
+            await state.gateway.stop();
+    }
+    catch (err) {
+        log(`[chat-daemon] gateway.stop error (non-fatal): ${err instanceof Error ? err.message : String(err)}`);
+    }
+    await cleanup(state);
+    log('[chat-daemon] clean exit');
+    process.exit(0);
+}
+async function cleanup(state) {
+    if (state.pidFile !== null) {
+        try {
+            await fs.unlink(state.pidFile);
+        }
+        catch {
+            /* race-tolerant */
+        }
+    }
+}
+//# sourceMappingURL=worker.js.map

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

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

package/dist/channels/env-token.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Telegram / Discord / Slack bot-token loading from env var + .env
+ * file (CAT.1b — ported from `src.legacy/chat/env-token.ts`, #148).
+ *
+ * Priority (highest first):
+ *   1. process.env.OPENSQUID_TELEGRAM_BOT_TOKEN (or _DISCORD_, _SLACK_)
+ *   2. .env file (first match wins):
+ *      - $OPENSQUID_ENV_FILE
+ *      - ~/.loop/.env
+ *      - <OPENSQUID_HOME>/.env   (~/.opensquid/.env by default)
+ *      - <cwd>/.env
+ *   3. <OPENSQUID_HOME>/config.json chat_connections.<platform>.bot_token
+ *      (caller-supplied via `configJsonFallback`)
+ *
+ * The .env parser supports standard KEY=VALUE lines AND a tolerant
+ * "bare token" fallback (single non-comment line, no `=`) — the user
+ * may save just the token. Bare tokens are treated as
+ * OPENSQUID_TELEGRAM_BOT_TOKEN.
+ *
+ * NEVER logs the token value. Only logs which SOURCE the active token
+ * came from, so operators can debug "which bot is this daemon
+ * actually using" without leaking the secret.
+ *
+ * The `~/.opensquid` candidate is rooted at `OPENSQUID_HOME()` (not raw
+ * `os.homedir()`) so the env-var override that the rest of `src/`
+ * honors — tests point it at an `mkdtemp` for isolation — extends to
+ * token resolution too. `~/.loop/.env` and `<cwd>/.env` stay anchored
+ * to `homedir()` / `process.cwd()` respectively: those are not part of
+ * the opensquid data root.
+ *
+ * Imports from: node:fs/promises, node:os, node:path, ../runtime/paths.
+ * Imported by: src/channels config loader (config.ts).
+ */
+export type EnvKey = 'OPENSQUID_TELEGRAM_BOT_TOKEN' | 'OPENSQUID_DISCORD_BOT_TOKEN' | 'OPENSQUID_SLACK_BOT_TOKEN' | 'OPENSQUID_SLACK_APP_TOKEN';
+export type EnvSource = 'env' | 'env-file' | 'config-json' | 'missing';
+export interface TokenLookup {
+    value: string | undefined;
+    source: EnvSource;
+    /** Path to the .env file used (only set when source === "env-file"). */
+    env_file_path?: string;
+}
+/**
+ * Resolve a token by priority: process.env → .env file → config.json
+ * fallback (caller-supplied). Returns the value AND the source it
+ * came from so the caller can log the source without exposing the
+ * value.
+ */
+export declare function resolveToken(key: EnvKey, configJsonFallback: string | undefined): Promise<TokenLookup>;
+/**
+ * Find the first existing .env file in the search order. Returns null
+ * if none exist.
+ */
+export declare function locateEnvFile(): Promise<string | null>;
+/**
+ * Parse a .env file into a flat string map. Supports:
+ *
+ *   - `KEY=VALUE` lines (standard dotenv format)
+ *   - `KEY="quoted value"` (double-quoted)
+ *   - `KEY='quoted value'` (single-quoted)
+ *   - `#` comments + blank lines
+ *   - Bare-token fallback: if the file has exactly ONE non-comment
+ *     line and that line has no `=`, treat it as
+ *     OPENSQUID_TELEGRAM_BOT_TOKEN (most common shape for "user
+ *     saved just the token")
+ *
+ * Caches by path to avoid re-reading on every call.
+ */
+export declare function loadEnvFile(envPath: string): Promise<Record<string, string>>;
+/** Test-only: clear the .env cache so subsequent loads re-read disk. */
+export declare function _clearEnvFileCache(): void;
+//# sourceMappingURL=env-token.d.ts.map

package/dist/channels/env-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-token.d.ts","sourceRoot":"","sources":["../../src/channels/env-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAQH,MAAM,MAAM,MAAM,GACd,8BAA8B,GAC9B,6BAA6B,GAC7B,2BAA2B,GAC3B,2BAA2B,CAAC;AAEhC,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAKD;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,OAAO,CAAC,WAAW,CAAC,CAuBtB;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiB5D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwClF;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}