@rubytech/create-realagent-code 0.1.603 → 0.1.605

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

@@ -35,7 +35,7 @@
  *  routine's prompt only when the stored `routineTemplateVersion` is BELOW this
  *  and no operator has edited the row, so an unbumped edit ships to new installs
  *  and never reaches existing ones — bump it in the same commit as the edit. */
-export const ROUTINE_TEMPLATE_VERSION = 6;
+export const ROUTINE_TEMPLATE_VERSION = 10;
 
 /**
  * Task 2379 — the check shapes a shipped template may name.
@@ -78,13 +78,61 @@ 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";
+}
+/** Task 2689 — the memory sweep's own state: its two review queues, and whether
+ *  it has stopped running. No fields, because an account has exactly one sweep
+ *  and one of each queue. What is compared is a digest, so the routine wakes
+ *  when a queue moves or the sweep goes silent, never merely because the sweep
+ *  ran again — it runs hourly and this routine is weekly. */
+/** Task 2688 — records changed in a connector this account registered, since
+ *  the routine last woke.
+ *
+ *  `scope` is a KIND of connector, never a name: the account describes the
+ *  queue once, on the connector's own registry record, and the template names
+ *  only which kind it watches. That is what lets a shipped template gate on a
+ *  third-party system at all, since it can carry no per-account value (Task
+ *  2389). A connector that is not registered, or whose credential is refused,
+ *  answers quiet, so the routine no-ops rather than erroring every fire. */
+export interface RoutineConnectorCheck {
+  readonly type: "connector";
+  readonly scope: "operational" | "accounting";
+}
+export interface RoutineSweepCheck {
+  readonly type: "sweep";
+}
+/** Task 2689 — growth under the account's own directory since the last accepted
+ *  wake. `minGrowthBytes` is a size rather than per-account data, so a shipped
+ *  template may name it and still be correct on every install. */
+export interface RoutineFilesystemCheck {
+  readonly type: "filesystem";
+  readonly minGrowthBytes?: number;
+}
 export type RoutineGateCheck =
   | RoutineMailCheck
   | RoutineD1Check
   | RoutineWhatsappCheck
   | RoutineCalendarCheck
   | RoutineTelegramCheck
-  | RoutineGraphCheck;
+  | RoutineGraphCheck
+  | RoutineGraphUnflaggedCheck
+  | RoutineConnectorCheck
+  | RoutineSweepCheck
+  | RoutineFilesystemCheck;
 
 /** 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,13 +163,34 @@ 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.
+  //
+  // Task 2688 — `connector` holds one position PER registered connector, and
+  // compares each against the instant that connector's queue was last read, so
+  // it is watermarked for the same reason.
+  //
+  // Task 2689 — `sweep` compares a digest and `filesystem` compares a byte
+  // count, both against a stored value, so both belong here for the same
+  // reason. Their positions are promoted by the dispatcher on an accepted wake,
+  // which is what makes "since the last report" literal rather than "since the
+  // last fire".
   return (
     check.type === "mail" ||
     check.type === "calendar" ||
     check.type === "telegram" ||
-    check.type === "graph"
+    check.type === "graph" ||
+    check.type === "connector" ||
+    check.type === "sweep" ||
+    check.type === "filesystem"
   );
 }
 
@@ -224,18 +293,6 @@ Say what is unfinished and what tomorrow looks like, in that order, in plain sen
 
 If nothing is waiting, nothing is overdue and tomorrow is empty, end the turn without replying.`;
 
-const APPOINTMENT_REMINDER = `Remind the people attending an appointment that is coming up, so nobody is reminded twice and nobody is missed.
-
-Call capabilities-here first. If neither a mail plugin nor a messaging channel is enabled, end the turn without replying.
-
-Find appointments starting within the next reminder window with schedule-list, and read each one's attendees. Resolve each attendee to a person and a contact route with contact-lookup. An attendee you cannot resolve to a route is not a failure to work around: leave them, and say so at the end.
-
-Send each attendee one reminder on the route they are already reachable on: email-send for a mailbox, whatsapp-reply or the Telegram message tool for a messaging thread that already exists. Carry the time, the place and what the appointment is about. Do not open a new conversation with someone who has never messaged the business.
-
-Send at most one reminder per attendee per appointment. Before sending, check the appointment's notes for a reminder already recorded, and record the one you send there.
-
-Reply with one line naming who was reminded and who could not be reached. If no appointment falls in the window, end the turn without replying.`;
-
 const COMMITMENT_CHASE = `Find the promises the business has made and not kept, and the promises made to it that nobody has kept.
 
 Call capabilities-here first and use only the surfaces it reports.
@@ -362,7 +419,20 @@ export const ROUTINE_ROSTER: readonly RoutineTemplate[] = [
       "Sends one morning message covering what needs a decision, what is time-bound and what changed overnight; stays silent when there is nothing worth saying.",
     recurrence: "30 7 * * 1-5",
     prompt: START_OF_DAY,
-    gateless: "A morning briefing is judgement every fire, so a gate would either always pass or suppress the briefing.",
+    // Task 2686 — the briefing's two gateable arms. `Section` rather than
+    // `ConversationArchive` on every email-driven row here: sections are written
+    // per ingest, so a reply into a thread this routine already flagged arrives
+    // as a fresh unflagged node, while the archive is MERGEd per thread and
+    // would stay flagged — muting the routine on the traffic it exists to read.
+    // The check names a label and not a source, so any ingested content wakes
+    // these rows, which over-wakes and never mutes. The briefing's third arm,
+    // open and overdue work, has no check type: Task 2714.
+    gate: {
+      checks: [
+        { type: "graph-unflagged", label: "Section" },
+        { type: "graph", scope: "appointments" },
+      ],
+    },
   },
   {
     key: "inbound-check",
@@ -371,7 +441,10 @@ export const ROUTINE_ROSTER: readonly RoutineTemplate[] = [
       "Triages mail that arrived since the last check and writes replies for you to approve; it never sends anything itself.",
     recurrence: "*/30 9-17 * * 1-5",
     prompt: INBOUND_CHECK,
-    gateless: "Conditional on new mail, but the mail check matches an exact mailbox address and no shipped template can name one (Task 2389).",
+    // Task 2686 — the mail check still cannot name a mailbox, but the sampler
+    // puts every inbound message in the graph, so the unflagged-section check
+    // reaches the same mail without per-account data.
+    gate: { checks: [{ type: "graph-unflagged", label: "Section" }] },
   },
   {
     key: "telegram-inbound-check",
@@ -386,19 +459,18 @@ export const ROUTINE_ROSTER: readonly RoutineTemplate[] = [
     key: "end-of-day",
     name: "End of day wrap-up",
     description:
-      "Closes the day with your unsent drafts, overdue work and tomorrow's diary; says nothing when all three are empty.",
+      "Closes the day with your unsent drafts, overdue work and tomorrow's diary, once new mail or a diary change has woken it.",
     recurrence: "0 18 * * 1-5",
     prompt: END_OF_DAY,
-    gateless: "A wrap-up is judgement every fire, so no cheap check stands in for reading the three surfaces it reports.",
-  },
-  {
-    key: "appointment-reminder",
-    name: "Appointment reminders",
-    description:
-      "Reminds each attendee once before a booked appointment, on a route they already use; it never opens a conversation with a stranger.",
-    recurrence: "0 * * * *",
-    prompt: APPOINTMENT_REMINDER,
-    gateless: "Conditional on an appointment falling in the window, but no check type reads appointments held in the graph (Task 2389).",
+    // Task 2686 — the wrap-up wakes on new mail or a diary change. Its other two
+    // surfaces, unsent drafts and overdue work, have no check type, so a day
+    // whose only outstanding item is one of those is silent until Task 2714.
+    gate: {
+      checks: [
+        { type: "graph-unflagged", label: "Section" },
+        { type: "graph", scope: "appointments" },
+      ],
+    },
   },
   {
     key: "commitment-chase",
@@ -407,7 +479,11 @@ export const ROUTINE_ROSTER: readonly RoutineTemplate[] = [
       "Surfaces promises the business made and did not keep, and promises made to it that nobody kept; it reports them rather than chasing them.",
     recurrence: "0 10 * * 2",
     prompt: COMMITMENT_CHASE,
-    gateless: "Whether a promise has been dropped is the judgement itself, so no check can answer it more cheaply.",
+    // Task 2686 — a dropped promise is a judgement, but the correspondence it
+    // judges is not: this wakes when inbound mail it has not read is in the
+    // graph. Its outbound arm reads sent mail, which the sampler does not ingest
+    // and no shipped template can name a mailbox for: Task 2715.
+    gate: { checks: [{ type: "graph-unflagged", label: "Section" }] },
   },
   {
     key: "calendar-reconcile",
@@ -427,7 +503,9 @@ export const ROUTINE_ROSTER: readonly RoutineTemplate[] = [
       "Reconciles the people you correspond with against the people on record, creating and updating contacts; it never merges two records that might be two people.",
     recurrence: "45 6 * * 1-5",
     prompt: CONTACT_RECONCILE,
-    gateless: "Conditional on new correspondence, but no check type reads correspondence (Task 2389).",
+    // Task 2686 — correspondence is readable now: the sampler writes it and the
+    // unflagged-section check counts what this routine has not reconciled.
+    gate: { checks: [{ type: "graph-unflagged", label: "Section" }] },
   },
   {
     key: "crm-reconcile",
@@ -436,7 +514,9 @@ export const ROUTINE_ROSTER: readonly RoutineTemplate[] = [
       "Brings across what changed in whichever operational system this business runs; it reads only and never writes back to that system.",
     recurrence: "0 3 * * *",
     prompt: CRM_RECONCILE,
-    gateless: "Conditional on connector movement, but no check type reads a connector queue (Task 2389).",
+    // Task 2688 — wakes when a connector the account registered as its
+    // operational system holds records changed since the last accepted wake.
+    gate: { checks: [{ type: "connector", scope: "operational" }] },
   },
   {
     key: "finance-reconcile",
@@ -445,7 +525,10 @@ export const ROUTINE_ROSTER: readonly RoutineTemplate[] = [
       "Reconciles the accounting system against the internal ledger and reports what does not agree; it never adjusts an entry to make the two sides match.",
     recurrence: "0 4 * * 1",
     prompt: FINANCE_RECONCILE,
-    gateless: "Conditional on accounting movement, but no check type reads an accounting ledger (Task 2389).",
+    // Task 2688 — wakes on movement in the connector the account registered as
+    // its accounting system. A connector that is absent or whose credential is
+    // refused answers quiet, so this no-ops rather than erroring every fire.
+    gate: { checks: [{ type: "connector", scope: "accounting" }] },
   },
   {
     key: "weekly-digest",
@@ -454,7 +537,15 @@ export const ROUTINE_ROSTER: readonly RoutineTemplate[] = [
       "Writes the week in three paragraphs at most: what changed, what is stuck, and what next week turns on.",
     recurrence: "0 16 * * 5",
     prompt: WEEKLY_DIGEST,
-    gateless: "A digest is judgement every fire, and a gate would suppress the report it exists to send.",
+    // Task 2686 — a week with no correspondence and no diary movement has
+    // nothing to report movement on, so the digest is silent rather than
+    // writing three paragraphs about a week in which nothing happened.
+    gate: {
+      checks: [
+        { type: "graph-unflagged", label: "Section" },
+        { type: "graph", scope: "appointments" },
+      ],
+    },
   },
   {
     key: "channel-link-check",
@@ -472,7 +563,11 @@ export const ROUTINE_ROSTER: readonly RoutineTemplate[] = [
       "Reports what the hourly graph sweep last did and what is waiting for review; it reads only and never runs the sweep itself.",
     recurrence: "0 9 * * 1",
     prompt: GRAPH_HEALTH,
-    gateless: "Reports the sweep's state every fire by design, so there is nothing conditional to check.",
+    // Task 2689 — the sweep's state IS the delta. The digest carries the two
+    // review-queue counts and whether the sweep has stopped writing reports,
+    // never the newest report's identity: the sweep runs hourly, so a digest
+    // that moved on every run would make this weekly routine wake every fire.
+    gate: { checks: [{ type: "sweep" }] },
   },
   {
     key: "filesystem-health",
@@ -481,7 +576,10 @@ export const ROUTINE_ROSTER: readonly RoutineTemplate[] = [
       "Reports what has grown under the account directory and which paths are worth attention; it deletes nothing.",
     recurrence: "0 9 * * 1",
     prompt: FILESYSTEM_HEALTH,
-    gateless: "Reports what has grown every fire by design, so there is nothing conditional to check.",
+    // Task 2689 — 64 MiB of growth under the account directory since the last
+    // report. What has ACCUMULATED is the question, so an account that is large
+    // and stable has nothing new to say and the routine stays silent.
+    gate: { checks: [{ type: "filesystem", minGrowthBytes: 67108864 }] },
   },
 ];
 

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"}