opensquid 0.5.395

package/dist/chat/daemon/inbox-read.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Read side of the per-project inbox (v0.7.1 Phase E).
+ *
+ * Daemon writes to ~/.opensquid/projects/<uuid>/inbox/<platform>.jsonl;
+ * MCP servers (via the `chat_poll_inbox` tool) read here. Each line is
+ * a self-contained `InboxMessage` (see inbox.ts for the schema).
+ *
+ * `pollInbox` reads the tail of the file. For v0.7.1 the implementation
+ * is "read the whole file, take last N lines after `since`" — simple
+ * and correct for our expected file sizes (a few KB per project per
+ * day). Tail-with-offset can replace this when files routinely exceed
+ * 1 MB.
+ */
+import type { InboxMessage } from "./inbox.js";
+import type { ChatPlatform } from "../gateway.js";
+export interface PollInboxParams {
+    /** Project uuid whose inbox to read. */
+    projectUuid: string;
+    /** If set, only this platform; else all platforms with inbox files. */
+    platform?: ChatPlatform;
+    /** Cap on returned messages. Default 20. */
+    limit?: number;
+    /** Drop messages with `enqueued_at` ≤ this ISO timestamp. */
+    since?: string;
+    /** Override data root (tests). */
+    dataRoot?: string;
+}
+export interface PollInboxResult {
+    /** Messages in chronological order (oldest first). */
+    messages: InboxMessage[];
+    /** Platforms whose inbox files were scanned. */
+    scanned_platforms: ChatPlatform[];
+}
+export declare function pollInbox(params: PollInboxParams): Promise<PollInboxResult>;
+//# sourceMappingURL=inbox-read.d.ts.map

package/dist/chat/daemon/inbox-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-read.d.ts","sourceRoot":"","sources":["../../../src.legacy/chat/daemon/inbox-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,gDAAgD;IAChD,iBAAiB,EAAE,YAAY,EAAE,CAAC;CACnC;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAoCjF"}

package/dist/chat/daemon/inbox-read.js

@@ -0,0 +1,75 @@
+/**
+ * Read side of the per-project inbox (v0.7.1 Phase E).
+ *
+ * Daemon writes to ~/.opensquid/projects/<uuid>/inbox/<platform>.jsonl;
+ * MCP servers (via the `chat_poll_inbox` tool) read here. Each line is
+ * a self-contained `InboxMessage` (see inbox.ts for the schema).
+ *
+ * `pollInbox` reads the tail of the file. For v0.7.1 the implementation
+ * is "read the whole file, take last N lines after `since`" — simple
+ * and correct for our expected file sizes (a few KB per project per
+ * day). Tail-with-offset can replace this when files routinely exceed
+ * 1 MB.
+ */
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { projectInboxDir } from "./routing.js";
+export async function pollInbox(params) {
+    const limit = params.limit ?? 20;
+    const dir = projectInboxDir(params.projectUuid, params.dataRoot);
+    const platforms = params.platform
+        ? [params.platform]
+        : await listPlatformsWithInbox(dir);
+    const all = [];
+    for (const p of platforms) {
+        const file = path.join(dir, `${p}.jsonl`);
+        try {
+            const raw = await fs.readFile(file, "utf8");
+            for (const line of raw.split("\n")) {
+                if (!line.trim())
+                    continue;
+                try {
+                    all.push(JSON.parse(line));
+                }
+                catch {
+                    // Skip malformed lines — daemon writes valid JSON only, but
+                    // a partial write under abnormal shutdown could leave one
+                    // bad line. Don't crash the poll over it.
+                }
+            }
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                continue;
+            throw err;
+        }
+    }
+    // Filter by `since`, then take the tail up to `limit`.
+    const filtered = params.since ? all.filter((m) => m.enqueued_at > params.since) : all;
+    // Sort by enqueued_at to give a consistent chronological order even
+    // when multiple platforms interleave.
+    filtered.sort((a, b) => a.enqueued_at.localeCompare(b.enqueued_at));
+    const tail = filtered.slice(-limit);
+    return { messages: tail, scanned_platforms: platforms };
+}
+async function listPlatformsWithInbox(dir) {
+    try {
+        const entries = await fs.readdir(dir);
+        const out = [];
+        for (const e of entries) {
+            if (e === "telegram.jsonl")
+                out.push("telegram");
+            else if (e === "discord.jsonl")
+                out.push("discord");
+            else if (e === "slack.jsonl")
+                out.push("slack");
+        }
+        return out;
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            return [];
+        throw err;
+    }
+}
+//# sourceMappingURL=inbox-read.js.map

package/dist/chat/daemon/inbox-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox-read.js","sourceRoot":"","sources":["../../../src.legacy/chat/daemon/inbox-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAsB/C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,MAAuB;IACrD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEjE,MAAM,SAAS,GAAmB,MAAM,CAAC,QAAQ;QAC/C,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;QACnB,CAAC,CAAC,MAAM,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAEtC,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC5C,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;oBAAE,SAAS;gBAC3B,IAAI,CAAC;oBACH,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC,CAAC;gBAC7C,CAAC;gBAAC,MAAM,CAAC;oBACP,4DAA4D;oBAC5D,0DAA0D;oBAC1D,0CAA0C;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YAC/D,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,uDAAuD;IACvD,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAI,MAAM,CAAC,KAAgB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAClG,oEAAoE;IACpE,sCAAsC;IACtC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,GAAW;IAC/C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,GAAG,GAAmB,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,KAAK,gBAAgB;gBAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;iBAC5C,IAAI,CAAC,KAAK,eAAe;gBAAE,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;iBAC/C,IAAI,CAAC,KAAK,aAAa;gBAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAChE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/chat/daemon/inbox-read.test.js

@@ -0,0 +1,97 @@
+/**
+ * inbox-read.test.ts — pollInbox happy paths (v0.7.1 Phase E).
+ */
+import { promises as fs } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { appendToInbox } from "./inbox.js";
+import { pollInbox } from "./inbox-read.js";
+let tmpRoot;
+let prevHome;
+beforeEach(async () => {
+    tmpRoot = await fs.mkdtemp(path.join(os.tmpdir(), "opensquid-inbox-read-test-"));
+    prevHome = process.env.OPENSQUID_HOME;
+    process.env.OPENSQUID_HOME = tmpRoot;
+});
+afterEach(async () => {
+    if (prevHome === undefined)
+        delete process.env.OPENSQUID_HOME;
+    else
+        process.env.OPENSQUID_HOME = prevHome;
+    await fs.rm(tmpRoot, { recursive: true, force: true });
+});
+function makeMsg(overrides = {}) {
+    return {
+        id: "m1",
+        platform: "telegram",
+        channel: "telegram:100",
+        sender: "u",
+        senderId: "100",
+        text: "hello",
+        receivedAt: new Date("2026-05-16T10:00:00Z"),
+        mentionsBot: false,
+        ...overrides,
+    };
+}
+describe("pollInbox", () => {
+    it("returns empty messages + empty platforms list when inbox dir is missing", async () => {
+        const r = await pollInbox({ projectUuid: "no-such-uuid", dataRoot: tmpRoot });
+        expect(r.messages).toEqual([]);
+        expect(r.scanned_platforms).toEqual([]);
+    });
+    it("returns messages from a single platform inbox", async () => {
+        await appendToInbox(makeMsg({ id: "a", text: "first" }), "uuid-1", tmpRoot);
+        await appendToInbox(makeMsg({ id: "b", text: "second" }), "uuid-1", tmpRoot);
+        const r = await pollInbox({ projectUuid: "uuid-1", dataRoot: tmpRoot });
+        expect(r.messages.length).toBe(2);
+        expect(r.messages[0].id).toBe("a");
+        expect(r.messages[1].id).toBe("b");
+        expect(r.scanned_platforms).toEqual(["telegram"]);
+    });
+    it("scans all platforms when `platform` is omitted", async () => {
+        await appendToInbox(makeMsg({ platform: "telegram", channel: "telegram:1" }), "uuid-2", tmpRoot);
+        await appendToInbox(makeMsg({ platform: "discord", channel: "discord:2" }), "uuid-2", tmpRoot);
+        const r = await pollInbox({ projectUuid: "uuid-2", dataRoot: tmpRoot });
+        expect(r.messages.length).toBe(2);
+        expect(r.scanned_platforms).toEqual(expect.arrayContaining(["telegram", "discord"]));
+    });
+    it("restricts to a single platform when `platform` is given", async () => {
+        await appendToInbox(makeMsg({ platform: "telegram", channel: "telegram:1" }), "uuid-3", tmpRoot);
+        await appendToInbox(makeMsg({ platform: "discord", channel: "discord:2" }), "uuid-3", tmpRoot);
+        const r = await pollInbox({ projectUuid: "uuid-3", platform: "discord", dataRoot: tmpRoot });
+        expect(r.messages.length).toBe(1);
+        expect(r.messages[0].platform).toBe("discord");
+        expect(r.scanned_platforms).toEqual(["discord"]);
+    });
+    it("honors limit (returns the tail)", async () => {
+        for (let i = 0; i < 5; i++) {
+            await appendToInbox(makeMsg({ id: `m${i}` }), "uuid-4", tmpRoot);
+        }
+        const r = await pollInbox({ projectUuid: "uuid-4", limit: 2, dataRoot: tmpRoot });
+        expect(r.messages.length).toBe(2);
+        // Last two by chronological order.
+        expect(r.messages[0].id).toBe("m3");
+        expect(r.messages[1].id).toBe("m4");
+    });
+    it("filters by `since` (strict greater-than on enqueued_at)", async () => {
+        await appendToInbox(makeMsg({ id: "x" }), "uuid-5", tmpRoot);
+        // Small wait so enqueued_at differs.
+        await new Promise((r) => setTimeout(r, 5));
+        const marker = new Date().toISOString();
+        await new Promise((r) => setTimeout(r, 5));
+        await appendToInbox(makeMsg({ id: "y" }), "uuid-5", tmpRoot);
+        const r = await pollInbox({ projectUuid: "uuid-5", since: marker, dataRoot: tmpRoot });
+        expect(r.messages.length).toBe(1);
+        expect(r.messages[0].id).toBe("y");
+    });
+    it("survives a malformed line in the inbox (skips it, returns valid ones)", async () => {
+        await appendToInbox(makeMsg({ id: "good-1" }), "uuid-6", tmpRoot);
+        // Append a broken line by writing directly.
+        const inboxFile = path.join(tmpRoot, "projects", "uuid-6", "inbox", "telegram.jsonl");
+        await fs.appendFile(inboxFile, "{ not json\n");
+        await appendToInbox(makeMsg({ id: "good-2" }), "uuid-6", tmpRoot);
+        const r = await pollInbox({ projectUuid: "uuid-6", dataRoot: tmpRoot });
+        expect(r.messages.map((m) => m.id)).toEqual(["good-1", "good-2"]);
+    });
+});

package/dist/chat/daemon/inbox.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Per-project inbound message inbox (v0.7.1 Phase C).
+ *
+ * The daemon receives inbound messages from all activated chat
+ * platforms via gateway.onMessage. This module is the write side:
+ * given a destination project (or "orphan" if no routing match),
+ * atomically append the message to its JSONL inbox.
+ *
+ * Read side lives in Phase E (the MCP `chat_poll_inbox` tool that
+ * per-project servers call to surface inbound messages to their
+ * agent).
+ *
+ * File layout:
+ *   ~/.opensquid/projects/<uuid>/inbox/<platform>.jsonl  (per-project)
+ *   ~/.opensquid/inbox/orphan/<platform>.jsonl           (catch-all)
+ *
+ * One line per message; line format is the JSON serialization of the
+ * `InboxMessage` shape below. Newline-delimited so consumers can tail
+ * incrementally without seeing partial writes (POSIX guarantees O_APPEND
+ * writes ≤ PIPE_BUF are atomic; our messages are typically a few
+ * hundred bytes, well under the 4096-byte threshold).
+ */
+import type { ChatMessage } from "../gateway.js";
+export interface InboxMessage {
+    /** Wire-format version; bump when the line format changes. */
+    v: 1;
+    /** Platform-stable message id (Telegram message_id, Slack ts, etc.). */
+    id: string;
+    /** Optional thread / topic id for sub-threaded platforms (v0.7.2). */
+    thread_id?: string;
+    /** Stable platform identifier. */
+    platform: string;
+    /** Full channel id (`<platform>:<native>`) the message arrived on. */
+    channel: string;
+    /** Display name of sender; falls back to native id when display is absent. */
+    sender: string;
+    /** Native sender id (Telegram user_id, Slack user, etc.). */
+    sender_id: string;
+    /** Message body text. */
+    text: string;
+    /** Wall-clock the platform stamped the message with (ISO 8601). */
+    received_at: string;
+    /** Daemon-side wall-clock the message hit the inbox (ISO 8601). */
+    enqueued_at: string;
+    /** True when the message contained an @-mention of the bot. */
+    mentions_bot: boolean;
+}
+export interface AppendResult {
+    /** Where the message ended up. */
+    destination: "project" | "orphan";
+    /** Project uuid (only when destination=project). */
+    project_uuid?: string;
+    /** Absolute path of the inbox file we wrote to. */
+    inbox_path: string;
+}
+/**
+ * Append a single inbound ChatMessage to the appropriate inbox.
+ * Caller decides which (route via `routing.RoutingIndex` lookup before
+ * calling). If projectUuid is provided, writes to that project's inbox;
+ * otherwise to the orphan inbox.
+ */
+export declare function appendToInbox(msg: ChatMessage, projectUuid: string | null, dataRoot?: string): Promise<AppendResult>;
+//# sourceMappingURL=inbox.d.ts.map

package/dist/chat/daemon/inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.d.ts","sourceRoot":"","sources":["../../../src.legacy/chat/daemon/inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,CAAC,EAAE,CAAC,CAAC;IACL,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,WAAW,EAAE,SAAS,GAAG,QAAQ,CAAC;IAClC,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,CAAC,CAwBvB"}

package/dist/chat/daemon/inbox.js

@@ -0,0 +1,56 @@
+/**
+ * Per-project inbound message inbox (v0.7.1 Phase C).
+ *
+ * The daemon receives inbound messages from all activated chat
+ * platforms via gateway.onMessage. This module is the write side:
+ * given a destination project (or "orphan" if no routing match),
+ * atomically append the message to its JSONL inbox.
+ *
+ * Read side lives in Phase E (the MCP `chat_poll_inbox` tool that
+ * per-project servers call to surface inbound messages to their
+ * agent).
+ *
+ * File layout:
+ *   ~/.opensquid/projects/<uuid>/inbox/<platform>.jsonl  (per-project)
+ *   ~/.opensquid/inbox/orphan/<platform>.jsonl           (catch-all)
+ *
+ * One line per message; line format is the JSON serialization of the
+ * `InboxMessage` shape below. Newline-delimited so consumers can tail
+ * incrementally without seeing partial writes (POSIX guarantees O_APPEND
+ * writes ≤ PIPE_BUF are atomic; our messages are typically a few
+ * hundred bytes, well under the 4096-byte threshold).
+ */
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { orphanInboxDir, projectInboxDir } from "./routing.js";
+/**
+ * Append a single inbound ChatMessage to the appropriate inbox.
+ * Caller decides which (route via `routing.RoutingIndex` lookup before
+ * calling). If projectUuid is provided, writes to that project's inbox;
+ * otherwise to the orphan inbox.
+ */
+export async function appendToInbox(msg, projectUuid, dataRoot) {
+    const destDir = projectUuid ? projectInboxDir(projectUuid, dataRoot) : orphanInboxDir(dataRoot);
+    await fs.mkdir(destDir, { recursive: true });
+    const inboxFile = path.join(destDir, `${msg.platform}.jsonl`);
+    const line = {
+        v: 1,
+        id: msg.id,
+        thread_id: msg.threadId,
+        platform: msg.platform,
+        channel: msg.channel,
+        sender: msg.sender,
+        sender_id: msg.senderId,
+        text: msg.text,
+        received_at: msg.receivedAt.toISOString(),
+        enqueued_at: new Date().toISOString(),
+        mentions_bot: msg.mentionsBot,
+    };
+    // appendFile with utf8 uses O_APPEND under the hood; small writes
+    // are POSIX-atomic. JSONL line ends with \n so consumers can split
+    // safely even if a write straddles a buffer flush.
+    await fs.appendFile(inboxFile, `${JSON.stringify(line)}\n`, "utf8");
+    return projectUuid
+        ? { destination: "project", project_uuid: projectUuid, inbox_path: inboxFile }
+        : { destination: "orphan", inbox_path: inboxFile };
+}

package/dist/chat/daemon/inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbox.js","sourceRoot":"","sources":["../../../src.legacy/chat/daemon/inbox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAoC/D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAgB,EAChB,WAA0B,EAC1B,QAAiB;IAEjB,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAChG,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,QAAQ,QAAQ,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAiB;QACzB,CAAC,EAAE,CAAC;QACJ,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,SAAS,EAAE,GAAG,CAAC,QAAQ;QACvB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE;QACzC,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,YAAY,EAAE,GAAG,CAAC,WAAW;KAC9B,CAAC;IACF,kEAAkE;IAClE,mEAAmE;IACnE,mDAAmD;IACnD,MAAM,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpE,OAAO,WAAW;QAChB,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE;QAC9E,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AACvD,CAAC"}

package/dist/chat/daemon/inbox.test.js

@@ -0,0 +1,110 @@
+/**
+ * inbox.ts tests (v0.7.1 Phase C) — exercise appendToInbox end-to-end
+ * (real files, real JSONL parsing) so the wire format AND the
+ * project/orphan routing decision are both covered.
+ */
+import { promises as fs } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { appendToInbox } from "./inbox.js";
+import { orphanInboxDir, projectInboxDir } from "./routing.js";
+let tmpRoot;
+let prevHome;
+beforeEach(async () => {
+    tmpRoot = await fs.mkdtemp(path.join(os.tmpdir(), "opensquid-inbox-test-"));
+    prevHome = process.env.OPENSQUID_HOME;
+    process.env.OPENSQUID_HOME = tmpRoot;
+});
+afterEach(async () => {
+    if (prevHome === undefined)
+        delete process.env.OPENSQUID_HOME;
+    else
+        process.env.OPENSQUID_HOME = prevHome;
+    await fs.rm(tmpRoot, { recursive: true, force: true });
+});
+function makeMsg(overrides = {}) {
+    return {
+        id: "msg-1",
+        platform: "telegram",
+        channel: "telegram:8075471258",
+        sender: "tester",
+        senderId: "8075471258",
+        text: "hello inbox",
+        receivedAt: new Date("2026-05-16T10:00:00Z"),
+        mentionsBot: false,
+        ...overrides,
+    };
+}
+describe("appendToInbox — project path", () => {
+    it("writes a JSONL line into projects/<uuid>/inbox/<platform>.jsonl", async () => {
+        const res = await appendToInbox(makeMsg(), "uuid-x", tmpRoot);
+        expect(res.destination).toBe("project");
+        expect(res.project_uuid).toBe("uuid-x");
+        expect(res.inbox_path).toBe(path.join(projectInboxDir("uuid-x", tmpRoot), "telegram.jsonl"));
+        const content = await fs.readFile(res.inbox_path, "utf8");
+        expect(content.endsWith("\n")).toBe(true);
+        const parsed = JSON.parse(content.trim());
+        expect(parsed.v).toBe(1);
+        expect(parsed.id).toBe("msg-1");
+        expect(parsed.platform).toBe("telegram");
+        expect(parsed.channel).toBe("telegram:8075471258");
+        expect(parsed.text).toBe("hello inbox");
+        expect(parsed.received_at).toBe("2026-05-16T10:00:00.000Z");
+        expect(parsed.enqueued_at).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+        expect(parsed.mentions_bot).toBe(false);
+    });
+    it("appends multiple lines, one per message", async () => {
+        const res = await appendToInbox(makeMsg({ id: "a" }), "uuid-y", tmpRoot);
+        await appendToInbox(makeMsg({ id: "b", text: "second" }), "uuid-y", tmpRoot);
+        const content = await fs.readFile(res.inbox_path, "utf8");
+        const lines = content.trim().split("\n");
+        expect(lines.length).toBe(2);
+        expect(JSON.parse(lines[0]).id).toBe("a");
+        expect(JSON.parse(lines[1]).id).toBe("b");
+    });
+    it("separates inboxes by platform", async () => {
+        await appendToInbox(makeMsg({ platform: "telegram", channel: "telegram:1" }), "uuid-z", tmpRoot);
+        await appendToInbox(makeMsg({ platform: "discord", channel: "discord:2" }), "uuid-z", tmpRoot);
+        const dir = projectInboxDir("uuid-z", tmpRoot);
+        const entries = await fs.readdir(dir);
+        expect(entries).toEqual(expect.arrayContaining(["telegram.jsonl", "discord.jsonl"]));
+    });
+});
+describe("appendToInbox — orphan path", () => {
+    it("writes to <dataRoot>/inbox/orphan/<platform>.jsonl when projectUuid is null", async () => {
+        const res = await appendToInbox(makeMsg(), null, tmpRoot);
+        expect(res.destination).toBe("orphan");
+        expect(res.project_uuid).toBeUndefined();
+        expect(res.inbox_path).toBe(path.join(orphanInboxDir(tmpRoot), "telegram.jsonl"));
+        const exists = await fs
+            .stat(res.inbox_path)
+            .then(() => true)
+            .catch(() => false);
+        expect(exists).toBe(true);
+    });
+});
+describe("appendToInbox — line format details", () => {
+    it("preserves mentions_bot flag", async () => {
+        const res = await appendToInbox(makeMsg({ mentionsBot: true }), "uuid-m", tmpRoot);
+        const line = (await fs.readFile(res.inbox_path, "utf8")).trim();
+        const parsed = JSON.parse(line);
+        expect(parsed.mentions_bot).toBe(true);
+    });
+    it("preserves sender_id (native id) separately from display sender", async () => {
+        const res = await appendToInbox(makeMsg({ sender: "Display Name", senderId: "native-987" }), "uuid-s", tmpRoot);
+        const line = (await fs.readFile(res.inbox_path, "utf8")).trim();
+        const parsed = JSON.parse(line);
+        expect(parsed.sender).toBe("Display Name");
+        expect(parsed.sender_id).toBe("native-987");
+    });
+    it("handles multi-line text without breaking JSONL framing", async () => {
+        // JSON.stringify escapes newlines as \\n; one logical line on disk.
+        const res = await appendToInbox(makeMsg({ text: "line one\nline two\nline three" }), "uuid-multi", tmpRoot);
+        const content = await fs.readFile(res.inbox_path, "utf8");
+        const lines = content.trim().split("\n");
+        expect(lines.length).toBe(1);
+        const parsed = JSON.parse(lines[0]);
+        expect(parsed.text).toBe("line one\nline two\nline three");
+    });
+});

package/dist/chat/daemon/lifecycle.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Chat-daemon lifecycle — start / stop / status (v0.7.1 Phase A).
+ *
+ * The daemon owns the single long-poll connection per chat platform so
+ * multiple Claude Code projects sharing the same machine can run their
+ * own opensquid MCP servers without colliding on the bot token (Telegram
+ * returns 409 Conflict when two consumers long-poll the same token —
+ * the v0.7 cause of "last-connected wins" behavior).
+ *
+ * Lifecycle is single-instance per machine: PID file at
+ * ~/.opensquid/chat-daemon.pid, log at ~/.opensquid/chat-daemon.log.
+ * A `start` call against a running daemon is a no-op (idempotent);
+ * `stop` is also idempotent. `status` is read-only.
+ *
+ * Outbound RPC (Unix socket) lands in Phase B; routing config + inbox
+ * write-out in Phase C; auto-spawn from MCP server in Phase D.
+ */
+export interface DaemonPaths {
+    pidFile: string;
+    logFile: string;
+    sockFile: string;
+}
+export declare function daemonPaths(dataRoot?: string): DaemonPaths;
+export type DaemonStatus = {
+    running: true;
+    pid: number;
+    uptime_ms: number | null;
+} | {
+    running: false;
+    stale_pid?: number;
+};
+/**
+ * Read the pidfile and check whether the recorded process is alive.
+ * A pidfile that points at a dead pid is treated as not-running (the
+ * caller should clean it up if they want; status itself is read-only).
+ */
+export declare function status(dataRoot?: string): Promise<DaemonStatus>;
+/**
+ * Start the daemon by spawning a detached child that runs
+ * `node dist/index.js chat-daemon-worker` (the actual long-poll loop
+ * lives in worker.ts). Returns immediately once the child has either
+ * forked successfully or failed.
+ *
+ * Idempotent: a start against an already-running daemon returns
+ * `{ already_running: true, pid }` without launching a second process.
+ *
+ * Stale pidfile handling: if the pidfile points at a dead pid, it's
+ * silently removed so this call can succeed.
+ */
+export declare function startDaemon(options?: {
+    dataRoot?: string;
+    nodeBin?: string;
+    entrypoint?: string;
+}): Promise<{
+    already_running: boolean;
+    pid: number;
+}>;
+/**
+ * Stop a running daemon by sending SIGTERM, then waiting briefly for
+ * the process to exit and the pidfile to disappear. Falls back to
+ * SIGKILL after the grace period. Idempotent — a stop against a
+ * not-running daemon returns `{ stopped: false }` without error.
+ */
+export declare function stopDaemon(options?: {
+    dataRoot?: string;
+    graceMs?: number;
+}): Promise<{
+    stopped: boolean;
+    pid?: number;
+}>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/chat/daemon/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src.legacy/chat/daemon/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAO1D;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACxD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBrE;AAaD;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACzE,OAAO,CAAC;IAAE,eAAe,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAoEpD;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmC7C"}