@rubytech/create-realagent-code 0.1.603 → 0.1.604

package/dist/__tests__/email-sampler-unit.test.js

@@ -29,3 +29,25 @@ test("carries the plugin runtime env and the brand .env", () => {
     assert.match(unit, /^Environment=EMAIL_SAMPLER_INTERVAL_SEC=60$/m);
     assert.match(unit, /^EnvironmentFile=-\/home\/x\/\.maxy\/\.env$/m);
 });
+// Task 2683 — the Outlook arm shares this unit's process, so it needs the same
+// Azure app credentials the session-manager unit carries. Without them
+// callGraph cannot refresh an access token, so every Outlook mailbox would
+// sample correctly until its current token expired and then error permanently.
+test("a brand with an outlook client id stamps both outlook env lines", () => {
+    const withOutlook = buildEmailSamplerUnitFile({
+        productName: "Maxy",
+        installDir: "/home/x/maxy-code",
+        persistDir: "/home/x/.maxy",
+        accountId: "acc-1",
+        logPath: "/home/x/.maxy/logs/email-sampler.log",
+        outlookClientId: "azure-app-id",
+    });
+    assert.match(withOutlook, /^Environment=OUTLOOK_CLIENT_ID=azure-app-id$/m);
+    assert.match(withOutlook, /^Environment=OUTLOOK_TENANT_ID=common$/m);
+    // Both land above EnvironmentFile so the brand .env can still override.
+    assert.ok(withOutlook.indexOf("OUTLOOK_TENANT_ID") < withOutlook.indexOf("EnvironmentFile="), "outlook env must precede EnvironmentFile");
+});
+test("a brand with no outlook client id stamps neither outlook env line", () => {
+    assert.doesNotMatch(unit, /OUTLOOK_CLIENT_ID/);
+    assert.doesNotMatch(unit, /OUTLOOK_TENANT_ID/);
+});

package/dist/index.js

@@ -4582,6 +4582,9 @@ WantedBy=default.target
         persistDir,
         accountId: installAccountId,
         logPath: emailSamplerLogPath,
+        // Task 2683 — the sampler's Outlook arm runs in this process and needs the
+        // brand's Azure app to refresh a token.
+        outlookClientId: BRAND.outlookClientId,
     });
     writeFileSync(join(serviceDir, emailSamplerUnitName), emailSamplerUnit);
     logFile(`  email-sampler installed: ${emailSamplerUnitName} LOG_PATH=${emailSamplerLogPath}`);

package/dist/port-resolution.js

@@ -172,6 +172,14 @@ WantedBy=default.target
 `;
 }
 export function buildEmailSamplerUnitFile(o) {
+    // Task 2683 — the Outlook arm runs inside this unit's process, so it needs the
+    // same Azure app credentials the session-manager unit carries. Both lines land
+    // together so OUTLOOK_TENANT_ID never trails a bare client id. Without them
+    // callGraph cannot refresh an access token, so every Outlook mailbox would
+    // sample correctly until its current token expired and then error for ever.
+    const outlookEnv = o.outlookClientId
+        ? `\nEnvironment=OUTLOOK_CLIENT_ID=${o.outlookClientId}\nEnvironment=OUTLOOK_TENANT_ID=common`
+        : "";
     return `[Unit]
 Description=${o.productName} Email Sampler
 After=network.target
@@ -186,7 +194,7 @@ Environment=NODE_ENV=production
 Environment=ACCOUNT_ID=${o.accountId}
 Environment=PLATFORM_ROOT=${o.installDir}/platform
 Environment=EMAIL_SAMPLER_LOG_PATH=${o.logPath}
-Environment=EMAIL_SAMPLER_INTERVAL_SEC=${o.intervalSec ?? 60}
+Environment=EMAIL_SAMPLER_INTERVAL_SEC=${o.intervalSec ?? 60}${outlookEnv}
 EnvironmentFile=-${o.persistDir}/.env
 StandardOutput=append:${o.persistDir}/logs/server.log
 StandardError=append:${o.persistDir}/logs/server.log

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-realagent-code",
-  "version": "0.1.603",
+  "version": "0.1.604",
   "description": "Install Real Agent — Built for agents. By agents.",
   "bin": {
     "create-realagent-code": "./dist/index.js"

package/payload/platform/lib/routine-templates/dist/roster.d.ts

@@ -76,7 +76,23 @@ export interface RoutineGraphCheck {
     readonly type: "graph";
     readonly scope: "appointments";
 }
-export type RoutineGateCheck = RoutineMailCheck | RoutineD1Check | RoutineWhatsappCheck | RoutineCalendarCheck | RoutineTelegramCheck | RoutineGraphCheck;
+/** Task 2684 — nodes of one label this routine has not yet flagged processed.
+ *
+ *  The other graph check compares one stored timestamp, which can skip a node
+ *  written between the probe and the promote. This one holds no position at all:
+ *  "outstanding for this routine" is an exact set, so a node the probe missed is
+ *  simply still unflagged next fire.
+ *
+ *  `label` is a closed pair rather than a free string because a Cypher label
+ *  cannot be a parameter. `Section` and `ConversationArchive` are different
+ *  grains: sections are written per ingest, so new content always arrives
+ *  unflagged, while an archive is MERGEd per thread, so a reply into a thread
+ *  this routine already flagged leaves that node flagged. */
+export interface RoutineGraphUnflaggedCheck {
+    readonly type: "graph-unflagged";
+    readonly label: "ConversationArchive" | "Section";
+}
+export type RoutineGateCheck = RoutineMailCheck | RoutineD1Check | RoutineWhatsappCheck | RoutineCalendarCheck | RoutineTelegramCheck | RoutineGraphCheck | RoutineGraphUnflaggedCheck;
 /** The plugin and the tool are constants for every roster gate, so a template
  *  carries neither. `hasWork` is true when ANY check is true. */
 export interface RoutineGate {

package/payload/platform/lib/routine-templates/dist/roster.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;gFAGgF;AAChF,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AACD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;CACtC;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AACD;iDACiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AACD;2EAC2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AACD,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,cAAc,GACd,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,CAAC;AAEtB;iEACiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAWD;;;;;;;;;;;4DAW4D;AAC5D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAUnE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE1D;AAED,MAAM,WAAW,eAAe;IAC9B;;mEAE+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;6EAGyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;wEACoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;2CAIuC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B;;;+DAG2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;2BAO2B;AAC3B,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAI/D;AA8KD;;;;;;;;iFAQiF;AACjF,eAAO,MAAM,cAAc,EAAE,SAAS,eAAe,EAiIpD,CAAC;AAEF;;6DAE6D;AAC7D,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAAqC,CAAC"}
+{"version":3,"file":"roster.d.ts","sourceRoot":"","sources":["../src/roster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH;;;gFAGgF;AAChF,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AACD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;CACtC;AACD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AACD;iDACiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B;AACD;2EAC2E;AAC3E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AACD;;;;;;;;;;;6DAW6D;AAC7D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,SAAS,CAAC;CACnD;AACD,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,cAAc,GACd,oBAAoB,GACpB,oBAAoB,GACpB,oBAAoB,GACpB,iBAAiB,GACjB,0BAA0B,CAAC;AAE/B;iEACiE;AACjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAWD;;;;;;;;;;;4DAW4D;AAC5D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAkBnE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAE1D;AAED,MAAM,WAAW,eAAe;IAC9B;;mEAE+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;6EAGyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;wEACoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;2CAIuC;IACvC,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B;;;+DAG2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;2BAO2B;AAC3B,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAI/D;AA8KD;;;;;;;;iFAQiF;AACjF,eAAO,MAAM,cAAc,EAAE,SAAS,eAAe,EAiIpD,CAAC;AAEF;;6DAE6D;AAC7D,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAAqC,CAAC"}

package/payload/platform/lib/routine-templates/dist/roster.js

@@ -64,6 +64,14 @@ exports.ROUTINE_TEMPLATE_VERSION = 6;
 function isWatermarkedCheck(check) {
     if (check.type === "whatsapp")
         return check.scope === "inbound";
+    // Task 2684 — `graph-unflagged` is NOT watermarked, and it is the first check
+    // that is neither watermarked nor stateless. Its state is a flag on each node,
+    // written by the dispatcher on an accepted wake, so it needs no stored
+    // position and a routine gated only on it needs no commit line. It is listed
+    // by omission from the set below, and a test pins that: a later edit that
+    // added it here would make `gateNeedsCommit` demand a commit for a check that
+    // has no mark to advance.
+    //
     // Task 2681 — `graph` compares an ISO `updatedAt` against a stored one, so a
     // commitless graph gate reports work on every fire exactly as a mail one does.
     return (check.type === "mail" ||

package/payload/platform/lib/routine-templates/dist/roster.js.map

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

package/payload/platform/lib/routine-templates/src/__tests__/seed.test.ts

@@ -25,7 +25,7 @@ import {
   type RoutineMergeAction,
   type SeedSessionLike,
 } from "../index.js";
-import { isClassified } from "../roster.js";
+import { isClassified, type RoutineGateCheck } from "../roster.js";
 
 interface FakeCall {
   query: string;
@@ -437,3 +437,28 @@ describe("telegram-inbound-check template (Task 2675)", () => {
     expect(gateNeedsCommit(tg.gate!)).toBe(true);
   });
 });
+
+// Task 2684 — the unflagged-node check carries no stored position, so it must
+// never join the watermarked set. If it did, `gateNeedsCommit` would demand a
+// commit for a check with no mark to advance, and `schedule-audit`'s stalled-
+// mark check would measure a routine against a file it never writes.
+describe("graph-unflagged check classification (Task 2684)", () => {
+  const CHECK: RoutineGateCheck = { type: "graph-unflagged", label: "Section" };
+
+  it("is not watermarked — its state is the flag on each node", () => {
+    expect(isWatermarkedCheck(CHECK)).toBe(false);
+  });
+
+  it("needs no commit when it is a gate's only check", () => {
+    expect(gateNeedsCommit({ checks: [CHECK] })).toBe(false);
+  });
+
+  it("does not suppress a watermarked sibling's commit", () => {
+    expect(gateNeedsCommit({ checks: [CHECK, { type: "telegram", scope: "inbound" }] })).toBe(true);
+  });
+
+  it("accepts both grains the email sampler writes", () => {
+    const archives: RoutineGateCheck = { type: "graph-unflagged", label: "ConversationArchive" };
+    expect(isWatermarkedCheck(archives)).toBe(false);
+  });
+});

package/payload/platform/lib/routine-templates/src/roster.ts

@@ -78,13 +78,30 @@ export interface RoutineGraphCheck {
   readonly type: "graph";
   readonly scope: "appointments";
 }
+/** Task 2684 — nodes of one label this routine has not yet flagged processed.
+ *
+ *  The other graph check compares one stored timestamp, which can skip a node
+ *  written between the probe and the promote. This one holds no position at all:
+ *  "outstanding for this routine" is an exact set, so a node the probe missed is
+ *  simply still unflagged next fire.
+ *
+ *  `label` is a closed pair rather than a free string because a Cypher label
+ *  cannot be a parameter. `Section` and `ConversationArchive` are different
+ *  grains: sections are written per ingest, so new content always arrives
+ *  unflagged, while an archive is MERGEd per thread, so a reply into a thread
+ *  this routine already flagged leaves that node flagged. */
+export interface RoutineGraphUnflaggedCheck {
+  readonly type: "graph-unflagged";
+  readonly label: "ConversationArchive" | "Section";
+}
 export type RoutineGateCheck =
   | RoutineMailCheck
   | RoutineD1Check
   | RoutineWhatsappCheck
   | RoutineCalendarCheck
   | RoutineTelegramCheck
-  | RoutineGraphCheck;
+  | RoutineGraphCheck
+  | RoutineGraphUnflaggedCheck;
 
 /** The plugin and the tool are constants for every roster gate, so a template
  *  carries neither. `hasWork` is true when ANY check is true. */
@@ -115,6 +132,14 @@ export interface RoutineGate {
  *  on every fire exactly as a commitless mail gate does. */
 export function isWatermarkedCheck(check: RoutineGateCheck): boolean {
   if (check.type === "whatsapp") return check.scope === "inbound";
+  // Task 2684 — `graph-unflagged` is NOT watermarked, and it is the first check
+  // that is neither watermarked nor stateless. Its state is a flag on each node,
+  // written by the dispatcher on an accepted wake, so it needs no stored
+  // position and a routine gated only on it needs no commit line. It is listed
+  // by omission from the set below, and a test pins that: a later edit that
+  // added it here would make `gateNeedsCommit` demand a commit for a check that
+  // has no mark to advance.
+  //
   // Task 2681 — `graph` compares an ISO `updatedAt` against a stored one, so a
   // commitless graph gate reports work on every fire exactly as a mail one does.
   return (

package/payload/platform/lib/telegram-store-read/dist/index.d.ts

@@ -0,0 +1,59 @@
+/** One stored message with every patch that names it already applied. */
+export interface FoldedMessage {
+    messageId: string;
+    /** ISO 8601, this install's clock at write time — NOT Telegram's own second. */
+    dateSent: string;
+    /** The patched body when an update replaced it, else the row's own. */
+    body: string;
+    /** 'inbound' | 'agent' | 'operator-manual'. Kept as the string the store
+     *  holds: a reader that meets an origin this build does not know should show
+     *  it, not drop the message. */
+    origin: string;
+    fromMe: boolean;
+    senderId: string;
+    senderName: string | null;
+    /** The sender withdrew this at their end. The body is KEPT: Telegram sends
+     *  none on a deletion, so the stored body is the only account anywhere of what
+     *  was withdrawn. */
+    deleted: boolean;
+    /** Servable attachment ids in arrival order, de-duplicated. Raw ids, never
+     *  resolved metadata — see the file header. */
+    attachmentIds: string[];
+    /** A card's inline-keyboard labels. Null on an ordinary message that never
+     *  carried a keyboard; an EMPTY ARRAY when an edit removed the one it had.
+     *  The two are different facts and the distinction is the route's, kept here
+     *  so the agent and the operator cannot read one card two ways. */
+    buttons: {
+        text: string;
+        data: string | null;
+    }[] | null;
+}
+export interface ConversationCensus {
+    /** Store files in this directory holding a storable channel key. */
+    conversations: number;
+    /** Message rows across all of them. Update rows are patches, not messages, and
+     *  counting them would inflate the total. */
+    rows: number;
+    /** Newest `dateSent` anywhere in the directory, or null when empty. */
+    newest: string | null;
+}
+/**
+ * One conversation, oldest first, with every patch applied.
+ *
+ * Empty for an unstorable key, a missing directory and a conversation with no
+ * file. Those are three different facts, and none of them is an error the caller
+ * can act on differently: all three mean there is nothing stored to show.
+ */
+export declare function readFoldedConversation(storeDir: string, channelKey: string): FoldedMessage[];
+/**
+ * What this account's store actually holds.
+ *
+ * `conversations` beside `rows` is load-bearing. A tool that returns nothing
+ * looks identical to a conversation that is empty, and `conversations=0
+ * rows=0` is also exactly what a reader pointed at the wrong directory prints —
+ * which is the failure Task 2644 shipped and Task 2557 named. With both numbers,
+ * a zero result on an account showing `conversations>0` is a wrong chat id, and
+ * `conversations=0` on a live account is a dead reader.
+ */
+export declare function conversationCensus(storeDir: string): ConversationCensus;
+//# sourceMappingURL=index.d.ts.map

package/payload/platform/lib/telegram-store-read/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwCA,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb;;oCAEgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;yBAEqB;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB;mDAC+C;IAC/C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;;;uEAGmE;IACnE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,GAAG,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB;iDAC6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAsGD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,aAAa,EAAE,CAiC5F;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CA+BvE"}

package/payload/platform/lib/telegram-store-read/dist/index.js

@@ -0,0 +1,219 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFoldedConversation = readFoldedConversation;
+exports.conversationCensus = conversationCensus;
+/**
+ * Task 2709 — reading one Telegram conversation back off disk, patches folded.
+ *
+ * The store is the only complete record of a Telegram conversation. No platform
+ * path writes a `:Message` node for Telegram: `persistMessage` in
+ * `ui/app/lib/neo4j-store.ts` has one caller, the webchat customer-inbound path,
+ * so a `:Message` carrying `channel:'telegram'` was written by an agent calling
+ * `memory-write` and records only what that agent chose to save. On 2026-08-13
+ * that was every inbound and one of ten outbound, and the agent read it back as
+ * the whole conversation.
+ *
+ * A message row is never rewritten once appended — `telegram-reader.ts` streams
+ * byte offsets as SSE resume ids, so a read-modify-write would invalidate every
+ * offset behind it. A correction is therefore a SECOND line, a
+ * `TelegramUpdateRecord`, naming its target. Reading the message rows alone
+ * yields the pre-patch text: a voice note's placeholder instead of its
+ * transcript, an edited message's original wording, and a withdrawn message with
+ * nothing saying it was withdrawn. Folding is what makes the read truthful,
+ * which is why this is a library and not four lines at the call site.
+ *
+ * Attachment ids come back RAW. `telegram-reader.ts` resolves each one to
+ * servable metadata against an uploads directory, because it is answering a
+ * browser; an agent has no use for that URL, and importing the uploads directory
+ * into the MCP would drag an HTTP concern across the plugin boundary. The three
+ * rules that ARE shared — body last-write-wins, buttons last-write-wins, deleted
+ * sticky-true — are pinned against the route by
+ * `ui/app/lib/telegram/__tests__/store-read-boundary.test.ts`.
+ *
+ * The key and filename rules are imported from `telegram-reach` rather than
+ * restated. That module is already the one derivation the store writer uses, and
+ * Task 2644 is the record of what a second derivation costs.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const index_js_1 = require("../../telegram-reach/dist/index.js");
+function parseLines(raw) {
+    const out = [];
+    for (const line of raw.split("\n")) {
+        if (!line.trim())
+            continue;
+        try {
+            out.push(JSON.parse(line));
+        }
+        catch {
+            // A partial write from a crash mid-append is skipped, never fatal: one
+            // corrupt line must not hide every other message in the conversation.
+        }
+    }
+    return out;
+}
+function isUpdateRow(row) {
+    return row.kind === "update";
+}
+function readButtons(value) {
+    if (!Array.isArray(value))
+        return null;
+    const out = [];
+    for (const b of value) {
+        if (!b || typeof b !== "object")
+            continue;
+        const { text, data } = b;
+        if (typeof text !== "string")
+            continue;
+        out.push({ text, data: typeof data === "string" ? data : null });
+    }
+    return out.length > 0 ? out : null;
+}
+/** Fold every update row into one patch per target id.
+ *
+ *  Mirrors `telegram-reader.ts:77-106`. Later rows win for the body and the
+ *  buttons. Attachment ids accumulate in arrival order and are de-duplicated per
+ *  target, because two rows can legitimately name the same id: `appendMessage`
+ *  dedupes a Telegram redelivery, but the route does not read that result — it
+ *  downloads again, resolves the SAME deterministic id, and patches again.
+ *  `deleted` is sticky: a withdrawal is not undone by a later transcript or
+ *  media patch, and letting one clear it would hide the withdrawal. */
+function foldPatches(rows) {
+    const out = new Map();
+    for (const row of rows) {
+        if (!isUpdateRow(row))
+            continue;
+        if (typeof row.targetMessageId !== "string")
+            continue;
+        const patch = out.get(row.targetMessageId) ?? { attachmentIds: [] };
+        if (Array.isArray(row.attachmentIds)) {
+            for (const id of row.attachmentIds) {
+                if (typeof id !== "string")
+                    continue;
+                if (patch.attachmentIds.includes(id))
+                    continue;
+                patch.attachmentIds.push(id);
+            }
+        }
+        if (typeof row.body === "string")
+            patch.body = row.body;
+        // Keyed on the field BEING an array, not on it holding anything. An operator
+        // editing a card down to no buttons produces `buttons: []`, and that is a
+        // removal: the route reads it as one, because an empty array is truthy
+        // there. Treating it as "no patch" would keep showing the agent buttons the
+        // customer can no longer see, with nothing failing while the two surfaces
+        // disagreed.
+        if (Array.isArray(row.buttons))
+            patch.buttons = readButtons(row.buttons) ?? [];
+        if (row.deleted === true)
+            patch.deleted = true;
+        out.set(row.targetMessageId, patch);
+    }
+    return out;
+}
+function conversationFile(storeDir, channelKey) {
+    // The guard, not the path. Both halves of a key are Telegram numeric ids
+    // around an optional literal `biz`, so a key that passes cannot carry a `.`,
+    // `/` or `\`, and one that fails is refused rather than sanitised into a path
+    // nobody asked for.
+    if (!(0, index_js_1.isStorableChannelKey)(channelKey))
+        return null;
+    return (0, node_path_1.join)(storeDir, `${(0, index_js_1.channelKeyToFileStem)(channelKey)}.jsonl`);
+}
+/**
+ * One conversation, oldest first, with every patch applied.
+ *
+ * Empty for an unstorable key, a missing directory and a conversation with no
+ * file. Those are three different facts, and none of them is an error the caller
+ * can act on differently: all three mean there is nothing stored to show.
+ */
+function readFoldedConversation(storeDir, channelKey) {
+    const file = conversationFile(storeDir, channelKey);
+    if (file === null || !(0, node_fs_1.existsSync)(file))
+        return [];
+    let raw;
+    try {
+        raw = (0, node_fs_1.readFileSync)(file, "utf8");
+    }
+    catch {
+        return [];
+    }
+    const rows = parseLines(raw);
+    const patches = foldPatches(rows);
+    const out = [];
+    for (const row of rows) {
+        if (isUpdateRow(row))
+            continue;
+        if (typeof row.messageId !== "string")
+            continue;
+        if (typeof row.dateSent !== "string")
+            continue;
+        const patch = patches.get(row.messageId);
+        out.push({
+            messageId: row.messageId,
+            dateSent: row.dateSent,
+            body: patch?.body ?? (typeof row.body === "string" ? row.body : ""),
+            origin: typeof row.origin === "string" ? row.origin : "inbound",
+            fromMe: row.fromMe === true,
+            senderId: typeof row.senderId === "string" ? row.senderId : "",
+            senderName: typeof row.senderName === "string" ? row.senderName : null,
+            deleted: patch?.deleted === true,
+            attachmentIds: patch?.attachmentIds ?? [],
+            buttons: patch?.buttons ?? readButtons(row.buttons),
+        });
+    }
+    // Sort AFTER folding, so a patch that arrived before its target in file order
+    // still lands on it. Ties keep file order, which is arrival order.
+    return out.sort((a, b) => a.dateSent.localeCompare(b.dateSent));
+}
+/**
+ * What this account's store actually holds.
+ *
+ * `conversations` beside `rows` is load-bearing. A tool that returns nothing
+ * looks identical to a conversation that is empty, and `conversations=0
+ * rows=0` is also exactly what a reader pointed at the wrong directory prints —
+ * which is the failure Task 2644 shipped and Task 2557 named. With both numbers,
+ * a zero result on an account showing `conversations>0` is a wrong chat id, and
+ * `conversations=0` on a live account is a dead reader.
+ */
+function conversationCensus(storeDir) {
+    const empty = { conversations: 0, rows: 0, newest: null };
+    if (!storeDir || !(0, node_fs_1.existsSync)(storeDir))
+        return empty;
+    let entries;
+    try {
+        entries = (0, node_fs_1.readdirSync)(storeDir);
+    }
+    catch {
+        return empty;
+    }
+    let conversations = 0;
+    let rows = 0;
+    let newest = null;
+    for (const entry of entries) {
+        if (!entry.endsWith(".jsonl"))
+            continue;
+        const channelKey = (0, index_js_1.fileStemToChannelKey)(entry.slice(0, -".jsonl".length));
+        if (!(0, index_js_1.isStorableChannelKey)(channelKey))
+            continue;
+        conversations += 1;
+        let raw;
+        try {
+            raw = (0, node_fs_1.readFileSync)((0, node_path_1.join)(storeDir, entry), "utf8");
+        }
+        catch {
+            continue;
+        }
+        for (const row of parseLines(raw)) {
+            if (isUpdateRow(row))
+                continue;
+            rows += 1;
+            if (typeof row.dateSent !== "string")
+                continue;
+            if (newest === null || newest.localeCompare(row.dateSent) < 0)
+                newest = row.dateSent;
+        }
+    }
+    return { conversations, rows, newest };
+}
+//# sourceMappingURL=index.js.map

package/payload/platform/lib/telegram-store-read/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;AAyLA,wDAiCC;AAYD,gDA+BC;AArQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qCAAgE;AAChE,yCAAiC;AACjC,iEAI4C;AA0D5C,SAAS,UAAU,CAAC,GAAW;IAC7B,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,uEAAuE;YACvE,sEAAsE;QACxE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,WAAW,CAAC,GAAiB;IACpC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC/B,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,GAAG,GAA4C,EAAE,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,SAAS;QAC1C,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAuC,CAAC;QAC/D,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QACvC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACrC,CAAC;AASD;;;;;;;;uEAQuE;AACvE,SAAS,WAAW,CAAC,IAAoB;IACvC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAiB,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;YAAE,SAAS;QAChC,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ;YAAE,SAAS;QACtD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QACpE,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACrC,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;gBACnC,IAAI,OAAO,EAAE,KAAK,QAAQ;oBAAE,SAAS;gBACrC,IAAI,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAAE,SAAS;gBAC/C,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACxD,6EAA6E;QAC7E,0EAA0E;QAC1E,uEAAuE;QACvE,4EAA4E;QAC5E,0EAA0E;QAC1E,aAAa;QACb,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/E,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI;YAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QAC/C,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB,EAAE,UAAkB;IAC5D,yEAAyE;IACzE,6EAA6E;IAC7E,8EAA8E;IAC9E,oBAAoB;IACpB,IAAI,CAAC,IAAA,+BAAoB,EAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,OAAO,IAAA,gBAAI,EAAC,QAAQ,EAAE,GAAG,IAAA,+BAAoB,EAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,sBAAsB,CAAC,QAAgB,EAAE,UAAkB;IACzE,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACpD,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAClD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,IAAA,sBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,WAAW,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/B,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;YAAE,SAAS;QAChD,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ;YAAE,SAAS;QAC/C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,GAAG,CAAC,IAAI,CAAC;YACP,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,MAAM,EAAE,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;YAC/D,MAAM,EAAE,GAAG,CAAC,MAAM,KAAK,IAAI;YAC3B,QAAQ,EAAE,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;YAC9D,UAAU,EAAE,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI;YACtE,OAAO,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI;YAChC,aAAa,EAAE,KAAK,EAAE,aAAa,IAAI,EAAE;YACzC,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC;SACpD,CAAC,CAAC;IACL,CAAC;IACD,8EAA8E;IAC9E,mEAAmE;IACnE,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,kBAAkB,CAAC,QAAgB;IACjD,MAAM,KAAK,GAAuB,EAAE,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC9E,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAA,oBAAU,EAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,IAAA,qBAAW,EAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,SAAS;QACxC,MAAM,UAAU,GAAG,IAAA,+BAAoB,EAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAA,+BAAoB,EAAC,UAAU,CAAC;YAAE,SAAS;QAChD,aAAa,IAAI,CAAC,CAAC;QACnB,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,IAAI,WAAW,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC/B,IAAI,IAAI,CAAC,CAAC;YACV,IAAI,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ;gBAAE,SAAS;YAC/C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC;QACvF,CAAC;IACH,CAAC;IACD,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACzC,CAAC"}

package/payload/platform/lib/telegram-store-read/src/__tests__/fold.test.ts

@@ -0,0 +1,124 @@
+import { describe, expect, it } from "vitest";
+import { mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { conversationCensus, readFoldedConversation } from "../index.js";
+
+function seed(rows: unknown[], stem = "111_222"): string {
+  const dir = mkdtempSync(join(tmpdir(), "tg-store-"));
+  writeFileSync(join(dir, `${stem}.jsonl`), rows.map((r) => JSON.stringify(r)).join("\n") + "\n");
+  return dir;
+}
+
+const msg = (over: Record<string, unknown> = {}) => ({
+  messageId: "m1",
+  sessionId: "s",
+  dateSent: "2026-08-13T17:00:00.000Z",
+  body: "hello",
+  fromMe: false,
+  senderId: "222",
+  senderName: "Mcha",
+  chatId: "222",
+  channelKey: "111:222",
+  scope: "admin",
+  origin: "inbound",
+  createdAt: "2026-08-13T17:00:00.000Z",
+  ...over,
+});
+
+describe("readFoldedConversation", () => {
+  it("returns both directions in dateSent order", () => {
+    const dir = seed([
+      msg({
+        messageId: "m2",
+        dateSent: "2026-08-13T17:01:00.000Z",
+        origin: "agent",
+        fromMe: true,
+        body: "hi back",
+      }),
+      msg(),
+    ]);
+    const out = readFoldedConversation(dir, "111:222");
+    expect(out.map((m) => m.body)).toEqual(["hello", "hi back"]);
+    expect(out.map((m) => m.origin)).toEqual(["inbound", "agent"]);
+  });
+
+  it("lets a later update row replace the body", () => {
+    const dir = seed([
+      msg({ body: "[voice note]" }),
+      { kind: "update", targetMessageId: "m1", body: "the transcript", createdAt: "x" },
+    ]);
+    expect(readFoldedConversation(dir, "111:222")[0].body).toBe("the transcript");
+  });
+
+  it("keeps deleted sticky once a later patch arrives", () => {
+    const dir = seed([
+      msg(),
+      { kind: "update", targetMessageId: "m1", deleted: true, createdAt: "x" },
+      { kind: "update", targetMessageId: "m1", attachmentIds: ["a1"], createdAt: "x" },
+    ]);
+    expect(readFoldedConversation(dir, "111:222")[0].deleted).toBe(true);
+  });
+
+  it("de-dupes attachment ids across repeated patches", () => {
+    const dir = seed([
+      msg(),
+      { kind: "update", targetMessageId: "m1", attachmentIds: ["a1"], createdAt: "x" },
+      { kind: "update", targetMessageId: "m1", attachmentIds: ["a1", "a2"], createdAt: "x" },
+    ]);
+    expect(readFoldedConversation(dir, "111:222")[0].attachmentIds).toEqual(["a1", "a2"]);
+  });
+
+  it("lets a later update row replace the buttons", () => {
+    const dir = seed([
+      msg({ buttons: [{ text: "old", data: "o" }] }),
+      { kind: "update", targetMessageId: "m1", buttons: [{ text: "new", data: "n" }], createdAt: "x" },
+    ]);
+    expect(readFoldedConversation(dir, "111:222")[0].buttons).toEqual([{ text: "new", data: "n" }]);
+  });
+
+  it("refuses an unstorable channel key rather than building a path", () => {
+    const dir = seed([msg()]);
+    expect(readFoldedConversation(dir, "../../etc:222")).toEqual([]);
+  });
+
+  it("returns nothing for a conversation with no file, without throwing", () => {
+    const dir = seed([msg()]);
+    expect(readFoldedConversation(dir, "111:999")).toEqual([]);
+  });
+
+  it("skips one corrupt line and keeps the rest", () => {
+    const dir = mkdtempSync(join(tmpdir(), "tg-store-"));
+    writeFileSync(join(dir, "111_222.jsonl"), JSON.stringify(msg()) + "\n{not json\n");
+    expect(readFoldedConversation(dir, "111:222")).toHaveLength(1);
+  });
+
+  it("reads a business conversation under its three-part key", () => {
+    const dir = seed([msg({ channelKey: "111:biz:222" })], "111_biz_222");
+    expect(readFoldedConversation(dir, "111:biz:222")).toHaveLength(1);
+  });
+});
+
+describe("conversationCensus", () => {
+  it("counts conversations and message rows, and reports the newest dateSent", () => {
+    const dir = seed([
+      msg(),
+      msg({ messageId: "m2", dateSent: "2026-08-13T17:05:00.000Z" }),
+      { kind: "update", targetMessageId: "m1", body: "patched", createdAt: "x" },
+    ]);
+    writeFileSync(join(dir, "111_333.jsonl"), JSON.stringify(msg({ chatId: "333", senderId: "333" })) + "\n");
+    const census = conversationCensus(dir);
+    expect(census.conversations).toBe(2);
+    // The update row is a patch, not a message: counting it would inflate the total.
+    expect(census.rows).toBe(3);
+    expect(census.newest).toBe("2026-08-13T17:05:00.000Z");
+  });
+
+  it("reports zeroes and a null newest for a directory that does not exist", () => {
+    expect(conversationCensus(join(tmpdir(), "tg-store-absent-xyz"))).toEqual({
+      conversations: 0,
+      rows: 0,
+      newest: null,
+    });
+  });
+});