opensquid 0.5.395

package/dist/chat/gateway.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Chat gateway — unified surface for bot-style chat connections (v0.7).
+ *
+ * Three concrete adapters plug into this interface: Telegram, Discord,
+ * Slack. Each is independently activatable via a token in
+ * `~/.opensquid/config.json` `chat_connections.<platform>.bot_token`.
+ * Adapters that don't have a token configured are skipped at startup —
+ * opensquid works fine with zero, one, or all three chat platforms wired.
+ *
+ * Scope decisions (per [[find-simple-solutions]]):
+ * - Single bot owner per platform (no multi-tenancy, no OAuth flows).
+ *   The user runs their OWN bot with their OWN token.
+ * - Bot owner is the only authorized chat participant by default.
+ *   Allowlist of additional chat/channel/user ids in config.
+ * - Outbound-only connection mechanism (long-poll, WebSocket, Socket
+ *   Mode) — no inbound HTTP server, no webhook URL, no public
+ *   ingress required. Works behind any NAT.
+ * - Text-only messages in v0.7. Images / files / inline buttons
+ *   deferred until concrete user-need surfaces.
+ *
+ * Why a gateway abstraction at all (vs per-platform code paths):
+ * the opensquid-side MCP tool surface (`chat.send`, `chat.list_channels`,
+ * the inbound-message → MCP-context bridge) should NOT care which
+ * platform a message came from. The gateway normalizes incoming events
+ * to a single `ChatMessage` shape and routes outgoing sends by
+ * channel id.
+ *
+ * What is NOT in this file:
+ * - Token storage / config loading (lives in `chat/config.ts`).
+ * - The actual SDK calls (live in `chat/adapters/<platform>.ts`).
+ * - The MCP tool wiring (lives in `chat/mcp-tools.ts`).
+ *
+ * What IS in this file: types + the `ChatGateway` orchestrator that
+ * holds N adapters and presents a single send/subscribe API.
+ */
+/** Stable platform identifier. */
+export type ChatPlatform = "telegram" | "discord" | "slack";
+/**
+ * A logical destination for outbound messages. The shape varies by
+ * platform but always normalizes to a single string id from opensquid's
+ * point of view. Adapters parse the id back to platform-native form
+ * (Telegram chat_id, Discord channel snowflake, Slack channel id).
+ *
+ * Format: `<platform>:<native_id>`, e.g. `telegram:8075471258`.
+ */
+export type ChannelId = string;
+/** Normalized inbound message (platform-agnostic shape). */
+export interface ChatMessage {
+    /** Stable id from the platform (snowflake / message_id / ts). */
+    id: string;
+    /**
+     * Optional thread / topic id for platforms that support sub-threads
+     * within a single channel (Telegram forum topics, Discord threads).
+     * Preserved on inbound so the daemon can route to per-topic projects;
+     * preserved on outbound so replies thread correctly. v0.7.2.
+     */
+    threadId?: string;
+    /** Which platform delivered this. */
+    platform: ChatPlatform;
+    /** Channel the message was posted in (DM, group, server channel). */
+    channel: ChannelId;
+    /** Display name of the sender (best-effort; falls back to user id). */
+    sender: string;
+    /** Native sender id (preserved for allowlist checks + replies). */
+    senderId: string;
+    /** Message body, text only in v0.7. */
+    text: string;
+    /** Wall-clock the platform stamped the message with. */
+    receivedAt: Date;
+    /** True when the message contains @-mention or trigger-word for the bot. */
+    mentionsBot: boolean;
+}
+/**
+ * Outbound message payload — text-only in v0.7. `replyTo` populates
+ * platform-specific threading metadata where it's free (Telegram
+ * `reply_to_message_id`, Slack `thread_ts`, Discord `message_reference`).
+ */
+export interface OutboundMessage {
+    channel: ChannelId;
+    text: string;
+    /** Source message id to reply-thread under (best-effort per platform). */
+    replyTo?: string;
+    /**
+     * Optional thread / topic id for platforms that support sub-threads
+     * within a single channel:
+     *
+     * - **Telegram**: `message_thread_id` for forum topics (a supergroup
+     *   with Topics enabled has multiple topic threads, each one a
+     *   separate logical channel within the same chat_id). v0.7.2.
+     * - **Discord**: thread id for thread messages.
+     * - **Slack**: not used (Slack threading is via `replyTo` only).
+     *
+     * Adapters that don't support thread_id ignore it.
+     */
+    threadId?: string;
+}
+/** Result of a single send. Adapter-defined fields preserved opaquely. */
+export interface SendResult {
+    platform: ChatPlatform;
+    /** Native id of the delivered message — for future edit / delete / react. */
+    messageId: string;
+    /** Wall-clock the platform stamped the delivered message with. */
+    deliveredAt: Date;
+}
+/** Inbound message handler. Async return for await-based pipelines. */
+export type MessageHandler = (msg: ChatMessage) => Promise<void> | void;
+/**
+ * What every chat adapter must implement. Adapter authors hold the
+ * platform-specific SDK / WebSocket / long-poll loop; this interface
+ * is the only surface opensquid touches.
+ *
+ * Lifecycle:
+ *   1. `start()` — open the connection (login, attach handlers).
+ *      Resolves when ready to receive + send. Throws on auth failure.
+ *   2. `onMessage(handler)` — subscribe to inbound events. Multiple
+ *      subscriptions stack; all fire per message in registration order.
+ *   3. `send(message)` — push outbound. Throws on permanent failures
+ *      (channel doesn't exist, bot kicked); transient errors are
+ *      retried internally per the adapter's policy.
+ *   4. `shutdown()` — close the connection cleanly. Idempotent.
+ *
+ * `identity()` returns the bot's own user info (username + native id) —
+ * used by the gateway to recognize self-authored messages and to
+ * resolve @-mention tokens to bot identity.
+ */
+export interface ChatAdapter {
+    /** Platform identifier this adapter handles. */
+    readonly platform: ChatPlatform;
+    start(): Promise<void>;
+    shutdown(): Promise<void>;
+    onMessage(handler: MessageHandler): void;
+    send(message: OutboundMessage): Promise<SendResult>;
+    identity(): Promise<{
+        username: string;
+        nativeId: string;
+    }>;
+}
+/**
+ * Holds N adapters and presents the unified API. Construct with the
+ * adapter array you want active for this opensquid process. Pre-wired
+ * tokens live in config; the factory at `chat/factory.ts` builds the
+ * adapter array based on which tokens are present.
+ */
+export declare class ChatGateway {
+    private readonly adapters;
+    private readonly handlers;
+    private started;
+    constructor(adapters: ChatAdapter[]);
+    /** Open all adapter connections in parallel. First failure surfaces. */
+    start(): Promise<void>;
+    /** Close all adapter connections. Errors are logged and swallowed
+     * so shutdown is always best-effort. */
+    shutdown(): Promise<void>;
+    /** Subscribe to inbound messages from any platform. */
+    onMessage(handler: MessageHandler): void;
+    /** Route an outbound message to the right adapter by `channel` prefix. */
+    send(message: OutboundMessage): Promise<SendResult>;
+    /** List the platforms currently wired up. Used by `chat.list_channels`. */
+    activePlatforms(): ChatPlatform[];
+    /**
+     * v0.7.2 — get the active adapter for a platform so daemon-internal
+     * code paths (e.g. `chat-daemon-worker` RPC dispatch) can reach
+     * platform-specific methods like Telegram's `createTopic`. Returns
+     * undefined when the platform isn't activated.
+     */
+    getAdapter(platform: ChatPlatform): ChatAdapter | undefined;
+    private dispatch;
+}
+export declare class ChatGatewayError extends Error {
+    readonly hint?: string | undefined;
+    constructor(message: string, hint?: string | undefined);
+}
+export declare function formatChannelId(platform: ChatPlatform, nativeId: string): ChannelId;
+export declare function platformFromChannel(channel: ChannelId): ChatPlatform;
+export declare function nativeIdFromChannel(channel: ChannelId): string;
+//# sourceMappingURL=gateway.d.ts.map

package/dist/chat/gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../src.legacy/chat/gateway.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAMH,kCAAkC;AAClC,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5D;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,EAAE,EAAE,MAAM,CAAC;IACX;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,QAAQ,EAAE,YAAY,CAAC;IACvB,qEAAqE;IACrE,OAAO,EAAE,SAAS,CAAC;IACnB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,UAAU,EAAE,IAAI,CAAC;IACjB,4EAA4E;IAC5E,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,SAAS,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAMxE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAEhC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEpD,QAAQ,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAMD;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAwB;IACjD,OAAO,CAAC,OAAO,CAAS;gBAEZ,QAAQ,EAAE,WAAW,EAAE;IAInC,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B;4CACwC;IAClC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,uDAAuD;IACvD,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIxC,0EAA0E;IACpE,IAAI,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC;IAYzD,2EAA2E;IAC3E,eAAe,IAAI,YAAY,EAAE;IAIjC;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,YAAY,GAAG,WAAW,GAAG,SAAS;YAI7C,QAAQ;CAYvB;AAMD,qBAAa,gBAAiB,SAAQ,KAAK;aAGvB,IAAI,CAAC,EAAE,MAAM;gBAD7B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA;CAKhC;AAMD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAEnF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,GAAG,YAAY,CAgBpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,GAAG,MAAM,CAM9D"}

package/dist/chat/gateway.js

@@ -0,0 +1,146 @@
+/**
+ * Chat gateway — unified surface for bot-style chat connections (v0.7).
+ *
+ * Three concrete adapters plug into this interface: Telegram, Discord,
+ * Slack. Each is independently activatable via a token in
+ * `~/.opensquid/config.json` `chat_connections.<platform>.bot_token`.
+ * Adapters that don't have a token configured are skipped at startup —
+ * opensquid works fine with zero, one, or all three chat platforms wired.
+ *
+ * Scope decisions (per [[find-simple-solutions]]):
+ * - Single bot owner per platform (no multi-tenancy, no OAuth flows).
+ *   The user runs their OWN bot with their OWN token.
+ * - Bot owner is the only authorized chat participant by default.
+ *   Allowlist of additional chat/channel/user ids in config.
+ * - Outbound-only connection mechanism (long-poll, WebSocket, Socket
+ *   Mode) — no inbound HTTP server, no webhook URL, no public
+ *   ingress required. Works behind any NAT.
+ * - Text-only messages in v0.7. Images / files / inline buttons
+ *   deferred until concrete user-need surfaces.
+ *
+ * Why a gateway abstraction at all (vs per-platform code paths):
+ * the opensquid-side MCP tool surface (`chat.send`, `chat.list_channels`,
+ * the inbound-message → MCP-context bridge) should NOT care which
+ * platform a message came from. The gateway normalizes incoming events
+ * to a single `ChatMessage` shape and routes outgoing sends by
+ * channel id.
+ *
+ * What is NOT in this file:
+ * - Token storage / config loading (lives in `chat/config.ts`).
+ * - The actual SDK calls (live in `chat/adapters/<platform>.ts`).
+ * - The MCP tool wiring (lives in `chat/mcp-tools.ts`).
+ *
+ * What IS in this file: types + the `ChatGateway` orchestrator that
+ * holds N adapters and presents a single send/subscribe API.
+ */
+// ---------------------------------------------------------------------
+// Gateway orchestrator
+// ---------------------------------------------------------------------
+/**
+ * Holds N adapters and presents the unified API. Construct with the
+ * adapter array you want active for this opensquid process. Pre-wired
+ * tokens live in config; the factory at `chat/factory.ts` builds the
+ * adapter array based on which tokens are present.
+ */
+export class ChatGateway {
+    adapters;
+    handlers = [];
+    started = false;
+    constructor(adapters) {
+        this.adapters = new Map(adapters.map((a) => [a.platform, a]));
+    }
+    /** Open all adapter connections in parallel. First failure surfaces. */
+    async start() {
+        if (this.started)
+            return;
+        // Wire incoming handler dispatch BEFORE starting connections so we
+        // don't drop early messages.
+        for (const adapter of this.adapters.values()) {
+            adapter.onMessage((msg) => this.dispatch(msg));
+        }
+        await Promise.all([...this.adapters.values()].map((a) => a.start()));
+        this.started = true;
+    }
+    /** Close all adapter connections. Errors are logged and swallowed
+     * so shutdown is always best-effort. */
+    async shutdown() {
+        if (!this.started)
+            return;
+        await Promise.allSettled([...this.adapters.values()].map((a) => a.shutdown()));
+        this.started = false;
+    }
+    /** Subscribe to inbound messages from any platform. */
+    onMessage(handler) {
+        this.handlers.push(handler);
+    }
+    /** Route an outbound message to the right adapter by `channel` prefix. */
+    async send(message) {
+        const platform = platformFromChannel(message.channel);
+        const adapter = this.adapters.get(platform);
+        if (!adapter) {
+            throw new ChatGatewayError(`no adapter active for platform '${platform}' (channel '${message.channel}')`, "ensure the corresponding bot_token is set in ~/.opensquid/config.json chat_connections");
+        }
+        return adapter.send(message);
+    }
+    /** List the platforms currently wired up. Used by `chat.list_channels`. */
+    activePlatforms() {
+        return [...this.adapters.keys()];
+    }
+    /**
+     * v0.7.2 — get the active adapter for a platform so daemon-internal
+     * code paths (e.g. `chat-daemon-worker` RPC dispatch) can reach
+     * platform-specific methods like Telegram's `createTopic`. Returns
+     * undefined when the platform isn't activated.
+     */
+    getAdapter(platform) {
+        return this.adapters.get(platform);
+    }
+    async dispatch(msg) {
+        for (const handler of this.handlers) {
+            try {
+                await handler(msg);
+            }
+            catch (err) {
+                const e = err instanceof Error ? err.message : String(err);
+                // Don't let one handler break the dispatch chain.
+                // eslint-disable-next-line no-console
+                console.error(`[chat-gateway] handler error on ${msg.platform}: ${e}`);
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------
+// Errors
+// ---------------------------------------------------------------------
+export class ChatGatewayError extends Error {
+    hint;
+    constructor(message, hint) {
+        super(message);
+        this.hint = hint;
+        this.name = "ChatGatewayError";
+    }
+}
+// ---------------------------------------------------------------------
+// ChannelId helpers
+// ---------------------------------------------------------------------
+export function formatChannelId(platform, nativeId) {
+    return `${platform}:${nativeId}`;
+}
+export function platformFromChannel(channel) {
+    const idx = channel.indexOf(":");
+    if (idx === -1) {
+        throw new ChatGatewayError(`malformed channel id '${channel}'`, "channel ids must be '<platform>:<native_id>', e.g. 'telegram:8075471258'");
+    }
+    const candidate = channel.slice(0, idx);
+    if (candidate !== "telegram" && candidate !== "discord" && candidate !== "slack") {
+        throw new ChatGatewayError(`unknown platform '${candidate}' in channel id '${channel}'`, "supported platforms: telegram, discord, slack");
+    }
+    return candidate;
+}
+export function nativeIdFromChannel(channel) {
+    const idx = channel.indexOf(":");
+    if (idx === -1) {
+        throw new ChatGatewayError(`malformed channel id '${channel}'`);
+    }
+    return channel.slice(idx + 1);
+}

package/dist/chat/gateway.js.map

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

package/dist/chat/gateway.test.js

@@ -0,0 +1,192 @@
+import { describe, expect, it, vi } from "vitest";
+import { ChatGateway, ChatGatewayError, formatChannelId, nativeIdFromChannel, platformFromChannel, } from "./gateway.js";
+// ---------------------------------------------------------------------
+// Mock adapter
+// ---------------------------------------------------------------------
+class MockAdapter {
+    platform;
+    started = false;
+    shutdownCalls = 0;
+    sends = [];
+    handlers = [];
+    constructor(platform) {
+        this.platform = platform;
+    }
+    async start() {
+        this.started = true;
+    }
+    async shutdown() {
+        this.shutdownCalls++;
+        this.started = false;
+    }
+    onMessage(handler) {
+        this.handlers.push(handler);
+    }
+    async send(message) {
+        this.sends.push(message);
+        return {
+            platform: this.platform,
+            messageId: `mock-${this.sends.length}`,
+            deliveredAt: new Date("2026-05-16T00:00:00Z"),
+        };
+    }
+    async identity() {
+        return { username: `mock-${this.platform}-bot`, nativeId: "bot-1" };
+    }
+    // Test helper: simulate an inbound message.
+    async simulateMessage(text, sender = "user-1") {
+        const msg = {
+            id: `m-${Date.now()}`,
+            platform: this.platform,
+            channel: formatChannelId(this.platform, "channel-1"),
+            sender,
+            senderId: sender,
+            text,
+            receivedAt: new Date("2026-05-16T00:00:00Z"),
+            mentionsBot: false,
+        };
+        for (const h of this.handlers)
+            await h(msg);
+    }
+}
+// ---------------------------------------------------------------------
+// channel id helpers
+// ---------------------------------------------------------------------
+describe("channel id helpers", () => {
+    it("formatChannelId joins with colon", () => {
+        expect(formatChannelId("telegram", "8075471258")).toBe("telegram:8075471258");
+    });
+    it("platformFromChannel parses telegram", () => {
+        expect(platformFromChannel("telegram:8075471258")).toBe("telegram");
+    });
+    it("platformFromChannel parses discord", () => {
+        expect(platformFromChannel("discord:1234567890")).toBe("discord");
+    });
+    it("platformFromChannel parses slack", () => {
+        expect(platformFromChannel("slack:C012345")).toBe("slack");
+    });
+    it("platformFromChannel rejects unknown platform", () => {
+        expect(() => platformFromChannel("hipchat:xyz")).toThrow(ChatGatewayError);
+    });
+    it("platformFromChannel rejects malformed", () => {
+        expect(() => platformFromChannel("telegram-no-colon")).toThrow(ChatGatewayError);
+    });
+    it("nativeIdFromChannel strips the prefix", () => {
+        expect(nativeIdFromChannel("telegram:8075471258")).toBe("8075471258");
+    });
+    it("nativeIdFromChannel preserves colons in native id (slack thread_ts)", () => {
+        expect(nativeIdFromChannel("slack:C012345:1234.5678")).toBe("C012345:1234.5678");
+    });
+});
+// ---------------------------------------------------------------------
+// ChatGateway lifecycle
+// ---------------------------------------------------------------------
+describe("ChatGateway lifecycle", () => {
+    it("start() calls start on every adapter", async () => {
+        const tg = new MockAdapter("telegram");
+        const dc = new MockAdapter("discord");
+        const gw = new ChatGateway([tg, dc]);
+        expect(tg.started).toBe(false);
+        expect(dc.started).toBe(false);
+        await gw.start();
+        expect(tg.started).toBe(true);
+        expect(dc.started).toBe(true);
+    });
+    it("start() is idempotent", async () => {
+        const tg = new MockAdapter("telegram");
+        const startSpy = vi.spyOn(tg, "start");
+        const gw = new ChatGateway([tg]);
+        await gw.start();
+        await gw.start();
+        expect(startSpy).toHaveBeenCalledTimes(1);
+    });
+    it("shutdown() closes every adapter", async () => {
+        const tg = new MockAdapter("telegram");
+        const dc = new MockAdapter("discord");
+        const gw = new ChatGateway([tg, dc]);
+        await gw.start();
+        await gw.shutdown();
+        expect(tg.shutdownCalls).toBe(1);
+        expect(dc.shutdownCalls).toBe(1);
+    });
+    it("shutdown() before start is a no-op", async () => {
+        const tg = new MockAdapter("telegram");
+        const gw = new ChatGateway([tg]);
+        await gw.shutdown();
+        expect(tg.shutdownCalls).toBe(0);
+    });
+    it("activePlatforms reports configured set", () => {
+        const tg = new MockAdapter("telegram");
+        const sl = new MockAdapter("slack");
+        const gw = new ChatGateway([tg, sl]);
+        expect(gw.activePlatforms().sort()).toEqual(["slack", "telegram"]);
+    });
+});
+// ---------------------------------------------------------------------
+// Routing
+// ---------------------------------------------------------------------
+describe("ChatGateway routing", () => {
+    it("send() routes to the adapter matching the channel prefix", async () => {
+        const tg = new MockAdapter("telegram");
+        const dc = new MockAdapter("discord");
+        const gw = new ChatGateway([tg, dc]);
+        await gw.start();
+        await gw.send({ channel: "telegram:8075471258", text: "hi tg" });
+        await gw.send({ channel: "discord:1234", text: "hi dc" });
+        expect(tg.sends.map((s) => s.text)).toEqual(["hi tg"]);
+        expect(dc.sends.map((s) => s.text)).toEqual(["hi dc"]);
+    });
+    it("send() throws when no adapter is configured for the platform", async () => {
+        const tg = new MockAdapter("telegram");
+        const gw = new ChatGateway([tg]);
+        await gw.start();
+        await expect(gw.send({ channel: "slack:C012", text: "hi" })).rejects.toThrow(ChatGatewayError);
+    });
+});
+// ---------------------------------------------------------------------
+// Inbound dispatch
+// ---------------------------------------------------------------------
+describe("ChatGateway inbound dispatch", () => {
+    it("forwards inbound messages to all registered handlers", async () => {
+        const tg = new MockAdapter("telegram");
+        const gw = new ChatGateway([tg]);
+        await gw.start();
+        const h1 = vi.fn();
+        const h2 = vi.fn();
+        gw.onMessage(h1);
+        gw.onMessage(h2);
+        await tg.simulateMessage("hello");
+        expect(h1).toHaveBeenCalledOnce();
+        expect(h2).toHaveBeenCalledOnce();
+        expect(h1.mock.calls[0][0].text).toBe("hello");
+    });
+    it("one handler throwing doesn't block the others", async () => {
+        const tg = new MockAdapter("telegram");
+        const gw = new ChatGateway([tg]);
+        await gw.start();
+        const errorSpy = vi.spyOn(console, "error").mockImplementation(() => { });
+        const failing = vi.fn(() => {
+            throw new Error("boom");
+        });
+        const ok = vi.fn();
+        gw.onMessage(failing);
+        gw.onMessage(ok);
+        await tg.simulateMessage("test");
+        expect(failing).toHaveBeenCalledOnce();
+        expect(ok).toHaveBeenCalledOnce();
+        errorSpy.mockRestore();
+    });
+    it("messages route through with correct platform tag", async () => {
+        const dc = new MockAdapter("discord");
+        const gw = new ChatGateway([dc]);
+        await gw.start();
+        const captured = [];
+        gw.onMessage((m) => {
+            captured.push(m);
+        });
+        await dc.simulateMessage("from discord");
+        expect(captured).toHaveLength(1);
+        expect(captured[0].platform).toBe("discord");
+        expect(captured[0].channel).toBe("discord:channel-1");
+    });
+});

package/dist/chat_daemon/client.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The single owner of the chat-daemon client (T-CHAT-FINALIZE-REMOVE-LEGACY CL.1).
+ *
+ * Before this module the one-shot JSON-RPC-over-UNIX-socket dance was copy-pasted into
+ * ~5 call sites (agent_bridge/tools/chat_send, mcp/chat-bridge-server, setup/cli/
+ * chat_actions_test_step, functions/ensure_umbrella_topic) plus the socket-path
+ * derivation in ~5 places — duplication left over from when the chat-daemon client
+ * lived in the now-removed `src.legacy/` tree. This is that shared client (the home the
+ * chat_send.ts comment named). STRICT extraction: the
+ * socket/timeout/decode behavior matches the prior `defaultDaemonSend` byte-for-byte;
+ * `daemonRpc` just generalizes it over the RPC `method` + result type.
+ *
+ * Scope (Simplicity — no method without a present caller): socket-path resolution, one
+ * one-shot `daemonRpc`, and the typed `sendChat` wrapper. No pooling / retry / streaming —
+ * the daemon calls are one-shot, so a one-shot client is the correct shape.
+ *
+ * Imports from: node:net, node:os, ../runtime/paths.js.
+ * Imported by: the chat-daemon call sites (CL.3).
+ */
+/**
+ * The chat-daemon socket address. Unix: the canonical `chatDaemonSockPath()`
+ * (`<home>/chat-daemon.sock`). Win32: a named pipe whose fingerprint = the last path
+ * segment of the data root (keeps multiple installs isolated — the convention the legacy
+ * `daemonSockAddress` used). This is the ONE place the Win32 branch lives now.
+ */
+export declare function daemonSocketPath(): string;
+/** The `send` RPC result (the narrow slice the callers use). */
+export interface DaemonSendResult {
+    ok: boolean;
+    platform: string;
+    message_id: string;
+    delivered_at: string;
+}
+/**
+ * One-shot JSON-RPC over the daemon UNIX socket: connect → write a single newline-framed
+ * request → read the first newline-framed response → resolve its `result` (or reject on
+ * RPC error / malformed JSON / connection error / timeout). Never spawns the daemon — a
+ * down daemon surfaces as a connection-error rejection.
+ */
+export declare function daemonRpc<T>(method: string, params: Record<string, unknown>, opts?: {
+    timeoutMs?: number;
+}): Promise<T>;
+/** Parameters for the daemon `send` RPC (the daemon's media field is `mediaPath`). */
+export interface DaemonSendParams {
+    channel: string;
+    text: string;
+    replyTo?: string;
+    threadId?: string;
+    /** Absolute path to a local image delivered as a photo (text → caption). */
+    imagePath?: string;
+}
+/** Typed `send` RPC — the one-shot reply path used by the agent-bridge + MCP bridge. */
+export declare const sendChat: (params: DaemonSendParams) => Promise<DaemonSendResult>;
+/** Typed `create_topic` RPC — creates one Telegram forum topic, returns its thread id. */
+export declare const createTopic: (chatId: string, name: string) => Promise<{
+    message_thread_id: number;
+    name: string;
+}>;
+/** Liveness gate — true iff a chat-daemon answers `ping` on its socket. Any failure ⇒ false. */
+export declare const pingDaemon: (timeoutMs?: number) => Promise<boolean>;
+//# sourceMappingURL=client.d.ts.map

package/dist/chat_daemon/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/chat_daemon/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AASD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC,OAAO,CAAC,CAAC,CAAC,CAyDZ;AAED,sFAAsF;AACtF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wFAAwF;AACxF,eAAO,MAAM,QAAQ,GAAI,QAAQ,gBAAgB,KAAG,OAAO,CAAC,gBAAgB,CAOxE,CAAC;AAEL,0FAA0F;AAC1F,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,MAAM,MAAM,KACX,OAAO,CAAC;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKlD,CAAC;AAEL,gGAAgG;AAChG,eAAO,MAAM,UAAU,GAAU,kBAAgB,KAAG,OAAO,CAAC,OAAO,CAOlE,CAAC"}