@guuey/threads 0.29.0 → 0.31.0

package/dist/fold-rows.d.ts

@@ -20,13 +20,37 @@ export interface RowCtx {
     untrustedOrigin?: boolean;
 }
 /**
- * Plain-text projection of an AgMessage. Distinct text blocks are distinct
- * paragraphs, so they join with a paragraph break — the same block-boundary
- * contract as `@guuey/agent-client`'s live flat-text fold (guuey#98); raw
- * concatenation jammed "…instead.Here's your packing…". Empty blocks
- * contribute nothing (no stacked separators).
+ * The ANSWER as plain text: the message's text blocks WITHOUT interim
+ * narration. Distinct text blocks are distinct paragraphs, so they join with
+ * a paragraph break, the same block-boundary contract as `@guuey/agent-client`'s
+ * live flat-text fold (guuey#98); raw concatenation jammed "…instead.Here's
+ * your packing…". Empty blocks contribute nothing (no stacked separators).
+ * This is the row's `text`: what a reloaded thread, a preview and a hook read.
  */
 export declare function messageText(msg: AgMessage): string;
+/** The message's interim narration, one entry per non-empty narration block, in order. */
+export declare function messageNarration(msg: AgMessage): string[];
+/**
+ * EVERY text block, narration included, joined as the answer text was joined
+ * before narration split out of it: the MODEL's view of a stored message.
+ * `loadHistory` replays this, so the model's conversation history is the same
+ * bytes whether a row was written before the split or after it.
+ */
+export declare function messageFullText(msg: AgMessage): string;
+/** A stored message's text, split: the answer, the narration, and everything (the model's view). */
+export interface StoredTextParts {
+    answer: string;
+    narration: string[];
+    all: string;
+}
+/**
+ * Split a stored row's `content` into answer, narration and the model's full
+ * text, when `content` is a stored `AgMessage` (an object, or the JSON string
+ * an AppSync writer stores). Anything else is null, and a reader falls back to
+ * the row's `text`. It is read through core's lenient stored-record reader, so
+ * an unknown block is omitted rather than failing the row.
+ */
+export declare function storedTextParts(content: unknown): StoredTextParts | null;
 export declare function agMessageToRow(msg: AgMessage, ctx: RowCtx & {
     turnRecord?: AgTurnRecord;
 }): ThreadMessageRow;
@@ -102,6 +126,39 @@ export declare function splitStoredThreadMemory(stored: readonly JsonValue[]): P
  * turn, so write order stays time order.
  */
 export declare function joinStoredThreadMemory(row: Pick<ThreadSnapshotRow, "threadMemory" | "carriedThreadMemory">): JsonValue[];
+/**
+ * The thread records a turn persists: each record of the fold, except that a
+ * record the turn did NOT change is persisted as the PRIOR stored record
+ * instead of the fold's rebuild of it (guuey#1669).
+ *
+ * The prior view comes from the stored-record reader, whose elements are raw
+ * copies that keep members this runtime does not know. The fold cannot
+ * carry those: {@link seedEventsForReducer} rebuilds each record as a
+ * `memory.write` from its known fields, and the reducer keeps only those. So
+ * persisting the fold alone would drop a record's unknown members on the first
+ * turn that re-persists the thread, even though the turn never touched it. A
+ * record keeps what it was stored with until a turn changes it.
+ *
+ * - **Identity** is the reducer's: scope plus `key ?? ""`. A fold record meets
+ *   the LAST prior record of that identity, the one the seed left standing,
+ *   because the last write wins. Several key-less records of one scope were
+ *   already collapsed to that one by the reducer before this existed; that
+ *   limit predates the overlay and is not papered over here.
+ * - **Unchanged** means the known fields a turn can write are deep-equal:
+ *   `scope`, `key`, `value`, `reason`, `durable`, `turnId` and `_meta`
+ *   (draft.8: a `memory.write` sets it, and a patch can replace it without
+ *   touching the value or the turnId, so a `_meta`-only change must count as
+ *   a change or the prior `_meta` would be persisted over it). A live write
+ *   stamps the current turn's `turnId`, so a turn that rewrites the SAME value
+ *   still changes the record, and the fold's record wins (the unknown members
+ *   described the previous write). **`threadId` is deliberately left out:** a
+ *   `memory.write` has no `threadId` on its event arm, so no turn can set it and
+ *   the seed cannot carry it. Comparing it would mark every stored record that
+ *   has one as changed, which is exactly the loss this prevents.
+ * - Records the turn removed are absent from the fold and stay absent; a
+ *   record the turn added has no prior and is the fold's own.
+ */
+export declare function keepUnchangedThreadMemory(priorView: readonly AgMemoryRecord[], folded: readonly AgMemoryRecord[]): AgMemoryRecord[];
 /**
  * Synthetic events that seed a reducer with prior latest-replace state before
  * folding a turn (design §8.1). Seeds state + thread-memory ONLY — never
@@ -114,6 +171,10 @@ export declare function joinStoredThreadMemory(row: Pick<ThreadSnapshotRow, "thr
  * Each synthetic `memory.write` carries `turnId` so the reducer's SET handler
  * lands it back onto the AgMemoryRecord — without it, a re-seeded thread-memory
  * record loses its turnId and memory byte-identity breaks from turn 2 on.
+ * It carries the record's `_meta` the same way: AgJSON draft.8 declares
+ * `_meta` on both the record and `memory.write`, and the reducer folds it
+ * onto the record (set on create, replaced on update), so a record's host
+ * side-channel (e.g. `_meta.provenance`) survives every re-seeded turn.
  * (`threadId` is NOT carried: `memory.write` has no threadId on its event arm,
  * so it cannot round-trip through a live write — that is expected.)
  */

package/dist/fold-rows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fold-rows.d.ts","sourceRoot":"","sources":["../src/fold-rows.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAEZ,cAAc,EACd,OAAO,EACP,cAAc,EACd,SAAS,EACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAwC,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG3G,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AASD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAMlD;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,MAAM,GAAG;IAAE,UAAU,CAAC,EAAE,YAAY,CAAA;CAAE,GAC1C,gBAAgB,CA2BlB;AA+DD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,CAmC/E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAU5E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA0BrG;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAY/D;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,UAAU,GAAG,SAAS,CAMjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,EAAE,EACxB,QAAQ,EAAE,iBAAiB,GAAG,SAAS,GACtC,cAAc,CA2BhB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CAAC,iBAAiB,EAAE,cAAc,CAAC,GAAG;IAC/G,mBAAmB,EAAE,SAAS,EAAE,CAAC;CAClC,CAoBA;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,EAAE,cAAc,GAAG,qBAAqB,CAAC,GAAG,SAAS,EAAE,CAExH;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,SAAS,GAAG,SAAS,EACjC,iBAAiB,EAAE,cAAc,EAAE,GAClC,OAAO,EAAE,CAmBX"}
+{"version":3,"file":"fold-rows.d.ts","sourceRoot":"","sources":["../src/fold-rows.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAEZ,cAAc,EACd,OAAO,EACP,cAAc,EACd,SAAS,EACV,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,gBAAgB,EAAwC,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG3G,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA2BD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAElD;AAED,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,EAAE,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,oGAAoG;AACpG,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAexE;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,MAAM,GAAG;IAAE,UAAU,CAAC,EAAE,YAAY,CAAA;CAAE,GAC1C,gBAAgB,CA2BlB;AA+DD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,CAmC/E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAU5E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,UAAU,EACf,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,MAAM,GAAG,SAAS,CAQpB;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CA0BrG;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAY/D;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,UAAU,GAAG,SAAS,CAMjF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,gBAAgB,EAAE,EACxB,QAAQ,EAAE,iBAAiB,GAAG,SAAS,GACtC,cAAc,CA2BhB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CAAC,iBAAiB,EAAE,cAAc,CAAC,GAAG;IAC/G,mBAAmB,EAAE,SAAS,EAAE,CAAC;CAClC,CAoBA;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,EAAE,cAAc,GAAG,qBAAqB,CAAC,GAAG,SAAS,EAAE,CAExH;AAqBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,cAAc,EAAE,EACpC,MAAM,EAAE,SAAS,cAAc,EAAE,GAChC,cAAc,EAAE,CAgBlB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,SAAS,GAAG,SAAS,EACjC,iBAAiB,EAAE,cAAc,EAAE,GAClC,OAAO,EAAE,CAoBX"}

package/dist/fold-rows.js

@@ -9,20 +9,78 @@ function roleToAuthor(role) {
     return "agent"; // assistant | tool
 }
 /**
- * Plain-text projection of an AgMessage. Distinct text blocks are distinct
- * paragraphs, so they join with a paragraph break — the same block-boundary
- * contract as `@guuey/agent-client`'s live flat-text fold (guuey#98); raw
- * concatenation jammed "…instead.Here's your packing…". Empty blocks
- * contribute nothing (no stacked separators).
+ * A text block the producer marked as INTERIM narration (AgJSON's open-string
+ * `phase`; an OpenAI `commentary` message arrives this way), not the answer.
+ * Only the one value this package knows splits; any other phase is answer text.
  */
-export function messageText(msg) {
+function isNarration(block) {
+    return block.type === "text" && block.phase === "interim";
+}
+/** The non-empty text blocks, in order, that `keep` admits, joined as paragraphs. */
+function joinText(msg, keep) {
     const parts = [];
     for (const block of msg.content) {
-        if (block.type === "text" && block.text)
+        if (block.type === "text" && block.text && keep(block))
             parts.push(block.text);
     }
     return parts.join("\n\n");
 }
+/**
+ * The ANSWER as plain text: the message's text blocks WITHOUT interim
+ * narration. Distinct text blocks are distinct paragraphs, so they join with
+ * a paragraph break, the same block-boundary contract as `@guuey/agent-client`'s
+ * live flat-text fold (guuey#98); raw concatenation jammed "…instead.Here's
+ * your packing…". Empty blocks contribute nothing (no stacked separators).
+ * This is the row's `text`: what a reloaded thread, a preview and a hook read.
+ */
+export function messageText(msg) {
+    return joinText(msg, (block) => !isNarration(block));
+}
+/** The message's interim narration, one entry per non-empty narration block, in order. */
+export function messageNarration(msg) {
+    const out = [];
+    for (const block of msg.content) {
+        if (isNarration(block) && block.type === "text" && block.text)
+            out.push(block.text);
+    }
+    return out;
+}
+/**
+ * EVERY text block, narration included, joined as the answer text was joined
+ * before narration split out of it: the MODEL's view of a stored message.
+ * `loadHistory` replays this, so the model's conversation history is the same
+ * bytes whether a row was written before the split or after it.
+ */
+export function messageFullText(msg) {
+    return joinText(msg, () => true);
+}
+/**
+ * Split a stored row's `content` into answer, narration and the model's full
+ * text, when `content` is a stored `AgMessage` (an object, or the JSON string
+ * an AppSync writer stores). Anything else is null, and a reader falls back to
+ * the row's `text`. It is read through core's lenient stored-record reader, so
+ * an unknown block is omitted rather than failing the row.
+ */
+export function storedTextParts(content) {
+    let raw = content;
+    if (typeof content === "string") {
+        try {
+            raw = JSON.parse(content);
+        }
+        catch (err) {
+            if (err instanceof SyntaxError)
+                return null; // not JSON: not a stored AgMessage
+            throw err;
+        }
+    }
+    if (raw === null || typeof raw !== "object")
+        return null;
+    const read = readStoredAgMessage(raw);
+    if (read.value === undefined)
+        return null;
+    const msg = read.value;
+    return { answer: messageText(msg), narration: messageNarration(msg), all: messageFullText(msg) };
+}
 export function agMessageToRow(msg, ctx) {
     const text = messageText(msg);
     const kind = "text";
@@ -330,6 +388,78 @@ export function splitStoredThreadMemory(stored) {
 export function joinStoredThreadMemory(row) {
     return [...(row.carriedThreadMemory ?? []), ...row.threadMemory];
 }
+/** Structural equality over JSON values (object key order does not matter). */
+function jsonEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === undefined || b === undefined || a === null || b === null)
+        return false;
+    if (Array.isArray(a) || Array.isArray(b)) {
+        if (!Array.isArray(a) || !Array.isArray(b) || a.length !== b.length)
+            return false;
+        return a.every((v, i) => jsonEqual(v, b[i]));
+    }
+    if (typeof a !== "object" || typeof b !== "object")
+        return false;
+    const keys = Object.keys(a);
+    if (keys.length !== Object.keys(b).length)
+        return false;
+    return keys.every((k) => Object.prototype.hasOwnProperty.call(b, k) && jsonEqual(a[k], b[k]));
+}
+/** The reducer's own memory identity (`${scope}${key ?? ""}`): a key-less record is its scope's singleton. */
+function memoryIdentity(rec) {
+    return `${rec.scope}${rec.key ?? ""}`;
+}
+/**
+ * The thread records a turn persists: each record of the fold, except that a
+ * record the turn did NOT change is persisted as the PRIOR stored record
+ * instead of the fold's rebuild of it (guuey#1669).
+ *
+ * The prior view comes from the stored-record reader, whose elements are raw
+ * copies that keep members this runtime does not know. The fold cannot
+ * carry those: {@link seedEventsForReducer} rebuilds each record as a
+ * `memory.write` from its known fields, and the reducer keeps only those. So
+ * persisting the fold alone would drop a record's unknown members on the first
+ * turn that re-persists the thread, even though the turn never touched it. A
+ * record keeps what it was stored with until a turn changes it.
+ *
+ * - **Identity** is the reducer's: scope plus `key ?? ""`. A fold record meets
+ *   the LAST prior record of that identity, the one the seed left standing,
+ *   because the last write wins. Several key-less records of one scope were
+ *   already collapsed to that one by the reducer before this existed; that
+ *   limit predates the overlay and is not papered over here.
+ * - **Unchanged** means the known fields a turn can write are deep-equal:
+ *   `scope`, `key`, `value`, `reason`, `durable`, `turnId` and `_meta`
+ *   (draft.8: a `memory.write` sets it, and a patch can replace it without
+ *   touching the value or the turnId, so a `_meta`-only change must count as
+ *   a change or the prior `_meta` would be persisted over it). A live write
+ *   stamps the current turn's `turnId`, so a turn that rewrites the SAME value
+ *   still changes the record, and the fold's record wins (the unknown members
+ *   described the previous write). **`threadId` is deliberately left out:** a
+ *   `memory.write` has no `threadId` on its event arm, so no turn can set it and
+ *   the seed cannot carry it. Comparing it would mark every stored record that
+ *   has one as changed, which is exactly the loss this prevents.
+ * - Records the turn removed are absent from the fold and stay absent; a
+ *   record the turn added has no prior and is the fold's own.
+ */
+export function keepUnchangedThreadMemory(priorView, folded) {
+    const prior = new Map();
+    for (const rec of priorView)
+        prior.set(memoryIdentity(rec), rec);
+    return folded.map((rec) => {
+        const before = prior.get(memoryIdentity(rec));
+        if (before === undefined)
+            return rec;
+        const unchanged = before.scope === rec.scope &&
+            before.key === rec.key &&
+            jsonEqual(before.value, rec.value) &&
+            before.reason === rec.reason &&
+            before.durable === rec.durable &&
+            before.turnId === rec.turnId &&
+            jsonEqual(before._meta, rec._meta);
+        return unchanged ? before : rec;
+    });
+}
 /**
  * Synthetic events that seed a reducer with prior latest-replace state before
  * folding a turn (design §8.1). Seeds state + thread-memory ONLY — never
@@ -342,6 +472,10 @@ export function joinStoredThreadMemory(row) {
  * Each synthetic `memory.write` carries `turnId` so the reducer's SET handler
  * lands it back onto the AgMemoryRecord — without it, a re-seeded thread-memory
  * record loses its turnId and memory byte-identity breaks from turn 2 on.
+ * It carries the record's `_meta` the same way: AgJSON draft.8 declares
+ * `_meta` on both the record and `memory.write`, and the reducer folds it
+ * onto the record (set on create, replaced on update), so a record's host
+ * side-channel (e.g. `_meta.provenance`) survives every re-seeded turn.
  * (`threadId` is NOT carried: `memory.write` has no threadId on its event arm,
  * so it cannot round-trip through a live write — that is expected.)
  */
@@ -361,6 +495,7 @@ export function seedEventsForReducer(priorState, priorThreadMemory) {
             ...(rec.reason !== undefined ? { reason: rec.reason } : {}),
             ...(rec.durable !== undefined ? { durable: rec.durable } : {}),
             ...(rec.turnId !== undefined ? { turnId: rec.turnId } : {}),
+            ...(rec._meta !== undefined ? { _meta: rec._meta } : {}),
         });
     }
     return events;

package/dist/index.d.ts

@@ -17,9 +17,10 @@
  *   - `@guuey/threads/testing` — the port contract suite: run it against
  *     your binding for the same guarantees the hosted one carries.
  */
-export type { HandoffEvent, ReportEvent, StoredHistoryMessage, ThreadMessageEvent, ThreadMessageKind, ThreadMessageRole, ThreadMessageRow, ThreadPersistencePort, ThreadRow, ThreadSnapshotRow, } from "./rows.js";
+export type { HandoffEvent, ReportEvent, StoredHistoryMessage, ThreadMessageEvent, ThreadMessageKind, ThreadMessageRole, ThreadMessageRow, ThreadPersistencePort, ThreadRow, ThreadSnapshotRow, TurnOrigin, ClientClass, } from "./rows.js";
 export { ThreadStore, type AppendFoldInput, type AppendFoldResult, type AppendMessageInput, type AppendMessageResult, type EnsureThreadInput, } from "./store.js";
 export { InMemoryThreadPersistence } from "./in-memory.js";
+export { AGENT_ERROR_ROW_SUFFIX, classifyStoredRow, isBlankBlock, isInformationless, type StoredRowClass, } from "./stored-row.js";
 export { HttpThreadPersistence, HttpThreadStoreError, type HttpThreadPersistenceOptions, type ThreadScope, } from "./http.js";
-export { agArtifactToCardRow, agMessageToRow, cardRowToAgArtifact, messageText, producingToolName, joinStoredThreadMemory, reassembleFold, rowToAgMessage, seedEventsForReducer, splitStoredThreadMemory, toolNamesByCallId, uiCardArtifactsFromMessages, type RowCtx, } from "./fold-rows.js";
+export { agArtifactToCardRow, agMessageToRow, cardRowToAgArtifact, messageFullText, messageNarration, messageText, producingToolName, storedTextParts, type StoredTextParts, joinStoredThreadMemory, reassembleFold, rowToAgMessage, seedEventsForReducer, splitStoredThreadMemory, toolNamesByCallId, uiCardArtifactsFromMessages, type RowCtx, } from "./fold-rows.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,YAAY,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,EACT,iBAAiB,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,4BAA4B,EACjC,KAAK,WAAW,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,KAAK,MAAM,GACZ,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,YAAY,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,4BAA4B,EACjC,KAAK,WAAW,GACjB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,KAAK,eAAe,EACpB,sBAAsB,EACtB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB,EACjB,2BAA2B,EAC3B,KAAK,MAAM,GACZ,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { ThreadStore, } from "./store.js";
 export { InMemoryThreadPersistence } from "./in-memory.js";
+export { AGENT_ERROR_ROW_SUFFIX, classifyStoredRow, isBlankBlock, isInformationless, } from "./stored-row.js";
 export { HttpThreadPersistence, HttpThreadStoreError, } from "./http.js";
-export { agArtifactToCardRow, agMessageToRow, cardRowToAgArtifact, messageText, producingToolName, joinStoredThreadMemory, reassembleFold, rowToAgMessage, seedEventsForReducer, splitStoredThreadMemory, toolNamesByCallId, uiCardArtifactsFromMessages, } from "./fold-rows.js";
+export { agArtifactToCardRow, agMessageToRow, cardRowToAgArtifact, messageFullText, messageNarration, messageText, producingToolName, storedTextParts, joinStoredThreadMemory, reassembleFold, rowToAgMessage, seedEventsForReducer, splitStoredThreadMemory, toolNamesByCallId, uiCardArtifactsFromMessages, } from "./fold-rows.js";

package/dist/rows.d.ts

@@ -12,6 +12,20 @@
 import type { AgMemoryRecord, JsonValue } from "@silverprotocol/core";
 export type ThreadMessageRole = "user" | "agent" | "system";
 export type ThreadMessageKind = "text" | "card" | "event";
+/**
+ * How a user turn was started: a gesture on a card (`card_action`), a
+ * suggested-prompt chip (`chip`), or typed input (`typed`). Stamped by the
+ * runtime on user rows; absent on rows written before the stamp existed.
+ */
+export type TurnOrigin = "card_action" | "chip" | "typed";
+/**
+ * The kind of client that sent a user turn, from its User-Agent at request
+ * time (the agent string is never stored): the hosting operator's own
+ * automated clients, such as health checks and smoke tests (`operator`); a
+ * third-party crawler or automated client (`bot`); or anything else
+ * (`browser`).
+ */
+export type ClientClass = "operator" | "bot" | "browser";
 export interface ThreadRow {
     id: string;
     userId: string;
@@ -116,6 +130,12 @@ export interface ThreadMessageRow {
      * the row types never carried it). Absent on every non-event row.
      */
     event?: ThreadMessageEvent;
+    /** On a user row: how the turn was started. Absent on older rows. */
+    turnOrigin?: TurnOrigin;
+    /** On a `card_action` user row: the render session id of the card the gesture answered. */
+    answeredCardSessionId?: string;
+    /** On a user row: the sending client's class. Absent on older rows. */
+    clientClass?: ClientClass;
 }
 /** Latest-replace fold snapshot for a thread. */
 export interface ThreadSnapshotRow {

package/dist/rows.d.ts.map

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

package/dist/store.d.ts

@@ -1,5 +1,5 @@
-import type { AgReduceResult, JsonValue } from "@silverprotocol/core";
-import type { ThreadMessageEvent, StoredHistoryMessage, ThreadMessageKind, ThreadMessageRole, ThreadPersistencePort, ThreadSnapshotRow } from "./rows.js";
+import type { AgMemoryRecord, AgReduceResult, JsonValue } from "@silverprotocol/core";
+import type { ThreadMessageEvent, StoredHistoryMessage, ThreadMessageKind, ThreadMessageRole, ThreadPersistencePort, ThreadSnapshotRow, TurnOrigin, ClientClass } from "./rows.js";
 export interface EnsureThreadInput {
     /** Client-supplied thread id (localStorage). Absent on first contact. */
     threadId?: string;
@@ -33,6 +33,12 @@ export interface AppendMessageInput {
      * store does not infer one from the other.
      */
     event?: ThreadMessageEvent;
+    /** A user row's origin (see {@link ThreadMessageRow.turnOrigin}); carried verbatim. */
+    turnOrigin?: TurnOrigin;
+    /** A `card_action` user row's answered card session id; carried verbatim. */
+    answeredCardSessionId?: string;
+    /** A user row's client class (see {@link ThreadMessageRow.clientClass}); carried verbatim. */
+    clientClass?: ClientClass;
 }
 export interface AppendMessageResult {
     seq: number;
@@ -64,6 +70,13 @@ export interface AppendFoldInput {
      * own thread records, so they are never dropped at rest. Absent = none.
      */
     carriedThreadMemory?: readonly JsonValue[];
+    /**
+     * The prior snapshot's `threadMemory`: the view the reducer was seeded
+     * from. A record this turn did not change is persisted as this prior record,
+     * with the members it was stored with (`keepUnchangedThreadMemory`), never as
+     * the fold's rebuild of it. Absent = the fold's records as they are.
+     */
+    priorThreadMemory?: readonly AgMemoryRecord[];
 }
 export interface AppendFoldResult {
     messageSeqs: number[];

package/dist/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAQtE,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EAEjB,qBAAqB,EAErB,iBAAiB,EAClB,MAAM,WAAW,CAAC;AAOnB,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,iBAAiB,CAAC;IACxB,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,cAAc,CAAC;IACrB,2EAA2E;IAC3E,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kEAAkE;IAClE,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,qBAAqB;IAEtD;;;;;;;;;;;;;OAaG;IACG,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4B7D;;;;;;;OAOG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpE,4EAA4E;IACtE,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAA8B,GACpC,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAqBlC;;;;OAIG;IACG,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8B5E,+EAA+E;IACzE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAI3E;;;;;;;;;;;;;;;;;OAiBG;IACG,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAoGpE"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/dist/store.js

@@ -8,7 +8,8 @@
  * DynamoDB).
  */
 import { randomUUID } from "node:crypto";
-import { agMessageToRow, agArtifactToCardRow, producingToolName, toolNamesByCallId, uiCardArtifactsFromMessages, } from "./fold-rows.js";
+import { agMessageToRow, agArtifactToCardRow, keepUnchangedThreadMemory, producingToolName, toolNamesByCallId, uiCardArtifactsFromMessages, storedTextParts, } from "./fold-rows.js";
+import { classifyStoredRow } from "./stored-row.js";
 /** Max history messages fed back as context — bounds latency on long threads. */
 const DEFAULT_HISTORY_LIMIT = 40;
 const PREVIEW_MAX_LEN = 240;
@@ -85,14 +86,32 @@ export class ThreadStore {
         // Known trade-off: cards still consume the DynamoDB Limit before this
         // filter, so card-heavy threads under-fill the window (bounded, most-
         // recent-first; revisit with an over-fetch if it bites).
-        return rows.filter((r) => r.kind !== 'card').map((r) => ({
+        // The model's text is EVERY text block from the stored message, narration
+        // included (`storedTextParts(...).all`): the row's `text` is the answer only
+        // since narration split out of it, so reading `text` here would change what
+        // the model is replayed. For rows written before the split, `all` is the same
+        // bytes their `text` holds. A row whose content is not a stored AgMessage
+        // (an event, a managed-adapter row) keeps its `text`.
+        //
+        // Only CONVERSATION reaches this lane: a failed turn's reader line, a
+        // framework notice and a blank agent message are stored rows, never words
+        // the agent said, so replaying them made the model (and a hook's
+        // transcript) read them as its own ({@link classifyStoredRow}).
+        // Two user turns can now sit side by side (the agent row between them
+        // dropped). That is fine: every runner renders this history as TEXT lines
+        // into its system prompt (`@guuey/host` `withContextPreamble`), never as a
+        // role-alternating message list a provider could refuse.
+        const conversation = rows
+            .filter((r) => r.kind !== 'card' && classifyStoredRow(r).kind === 'conversation')
+            .map((r) => ({
             seq: r.seq,
             authorRole: r.authorRole,
             kind: r.kind,
-            text: r.text ?? null,
+            text: storedTextParts(r.content)?.all || (r.text ?? null),
             content: r.content ?? null,
             at: r.at,
         }));
+        return conversation;
     }
     /**
      * Append one message with an atomic, gap-free seq. Idempotent on
@@ -119,6 +138,9 @@ export class ThreadStore {
             content: input.content,
             ...(input.untrustedOrigin === true ? { untrustedOrigin: true } : {}),
             ...(input.event !== undefined ? { event: input.event } : {}),
+            ...(input.turnOrigin !== undefined ? { turnOrigin: input.turnOrigin } : {}),
+            ...(input.answeredCardSessionId !== undefined ? { answeredCardSessionId: input.answeredCardSessionId } : {}),
+            ...(input.clientClass !== undefined ? { clientClass: input.clientClass } : {}),
         };
         await this.db.putMessage(row);
         return { seq, deduped: false };
@@ -161,7 +183,11 @@ export class ThreadStore {
             const msg = fold.messages[i];
             const clientMessageId = sentinelClaimed ? `${clientMessageIdBase}#agent#${i}` : sentinelKey;
             sentinelClaimed = true;
-            const text = msg.content.reduce((acc, b) => (b.type === 'text' ? acc + b.text : acc), '');
+            // The preview is the ANSWER: interim narration (`phase: "interim"`) never becomes a thread's preview,
+            // and neither does a framework notice (a non-conversational row).
+            const text = msg.role === 'notice'
+                ? ''
+                : msg.content.reduce((acc, b) => (b.type === 'text' && b.phase !== 'interim' ? acc + b.text : acc), '');
             const now = new Date().toISOString();
             // Text-less agent messages (tool-call + tool-result only — the canonical
             // card-producing turn) must not blank the preview: '' takes the SET
@@ -210,7 +236,7 @@ export class ThreadStore {
             }, producingToolName(art, toolNames)));
             artifactSeqs.push(seq);
         }
-        const threadMemory = fold.memory.filter((m) => m.scope === 'thread');
+        const threadMemory = keepUnchangedThreadMemory(input.priorThreadMemory ?? [], fold.memory.filter((m) => m.scope === 'thread'));
         const droppedDurableMemory = fold.memory.length - threadMemory.length;
         if (skipSnapshot !== true) {
             const lastTurnId = fold.turns.length ? fold.turns[fold.turns.length - 1].turnId : undefined;

package/dist/stored-row.d.ts

@@ -0,0 +1,57 @@
+/**
+ * What a stored thread row IS, for every reader that turns rows back into
+ * conversation. Some stored rows are not "the agent said this", and reading
+ * them as such replays them to the model as the agent's own words and draws
+ * them as answer bubbles:
+ *
+ *  - a FAILURE row: the runtime's reader line for a failed turn, keyed
+ *    `…#agentError`. It carries `content.error.code` from the runtime release
+ *    that added codes; rows written before it carry only `{kind:'text', text}`,
+ *    so the key suffix alone must classify them too;
+ *  - a NOTICE row: a stored message with `role: "notice"` (a framework notice
+ *    the agent facet emits), a non-conversational, user-facing row;
+ *  - a BLANK row: an agent message whose every block shows the reader nothing
+ *    (an empty text part, or a provider carry with nothing in it).
+ *
+ * The reader is lenient: it reads the stored `content` through the core's
+ * stored-record reader, so a row written before any of this is classified the
+ * same way, with no migration.
+ */
+import { type AgBlock, type JsonValue } from "@silverprotocol/core";
+import type { ThreadMessageRow } from "./rows.js";
+/** The clientMessageId suffix the runtime gives a failed turn's reader-line row. */
+export declare const AGENT_ERROR_ROW_SUFFIX = "#agentError";
+/**
+ * True when a JSON value carries no information a reader could act on:
+ * `null`/`undefined`, the empty string, an empty array or object, or an
+ * array/object whose every member is itself informationless. Numbers and
+ * booleans are information. The same rule `@guuey/chat` applies to a provider
+ * carry it hides from the transcript.
+ */
+export declare function isInformationless(value: JsonValue | undefined): boolean;
+/**
+ * A block the reader's transcript shows nothing for: an empty text part, or a
+ * `provider-raw` carry whose payload is informationless. Every other block,
+ * reasoning included, is something a reader can see. ONE predicate for the
+ * runtime's turn watch, its stored fold, and this classifier.
+ */
+export declare function isBlankBlock(block: AgBlock): boolean;
+/** The class of one stored row. */
+export type StoredRowClass = {
+    kind: "conversation";
+}
+/** A failed turn's reader line. `code` is null on a row stored before codes were persisted. */
+ | {
+    kind: "failure";
+    code: string | null;
+}
+/** A framework notice. `source` is the injecting layer when the row names one. */
+ | {
+    kind: "notice";
+    source: string | null;
+} | {
+    kind: "blank";
+};
+/** Classify one stored row (see the module doc). */
+export declare function classifyStoredRow(row: Pick<ThreadMessageRow, "clientMessageId" | "authorRole" | "content">): StoredRowClass;
+//# sourceMappingURL=stored-row.d.ts.map

package/dist/stored-row.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-row.d.ts","sourceRoot":"","sources":["../src/stored-row.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAuB,KAAK,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAMvE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIpD;AAED,mCAAmC;AACnC,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE;AAC1B,+FAA+F;GAC7F;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAC1C,kFAAkF;GAChF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC;AAUtB,oDAAoD;AACpD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,GAAG,YAAY,GAAG,SAAS,CAAC,GACxE,cAAc,CAWhB"}

package/dist/stored-row.js

@@ -0,0 +1,79 @@
+/**
+ * What a stored thread row IS, for every reader that turns rows back into
+ * conversation. Some stored rows are not "the agent said this", and reading
+ * them as such replays them to the model as the agent's own words and draws
+ * them as answer bubbles:
+ *
+ *  - a FAILURE row: the runtime's reader line for a failed turn, keyed
+ *    `…#agentError`. It carries `content.error.code` from the runtime release
+ *    that added codes; rows written before it carry only `{kind:'text', text}`,
+ *    so the key suffix alone must classify them too;
+ *  - a NOTICE row: a stored message with `role: "notice"` (a framework notice
+ *    the agent facet emits), a non-conversational, user-facing row;
+ *  - a BLANK row: an agent message whose every block shows the reader nothing
+ *    (an empty text part, or a provider carry with nothing in it).
+ *
+ * The reader is lenient: it reads the stored `content` through the core's
+ * stored-record reader, so a row written before any of this is classified the
+ * same way, with no migration.
+ */
+import { readStoredAgMessage } from "@silverprotocol/core";
+/** The clientMessageId suffix the runtime gives a failed turn's reader-line row. */
+export const AGENT_ERROR_ROW_SUFFIX = "#agentError";
+/**
+ * True when a JSON value carries no information a reader could act on:
+ * `null`/`undefined`, the empty string, an empty array or object, or an
+ * array/object whose every member is itself informationless. Numbers and
+ * booleans are information. The same rule `@guuey/chat` applies to a provider
+ * carry it hides from the transcript.
+ */
+export function isInformationless(value) {
+    if (value === undefined || value === null)
+        return true;
+    if (typeof value === "string")
+        return value === "";
+    if (typeof value === "number" || typeof value === "boolean")
+        return false;
+    if (Array.isArray(value))
+        return value.every((v) => isInformationless(v));
+    return Object.values(value).every((v) => isInformationless(v));
+}
+/**
+ * A block the reader's transcript shows nothing for: an empty text part, or a
+ * `provider-raw` carry whose payload is informationless. Every other block,
+ * reasoning included, is something a reader can see. ONE predicate for the
+ * runtime's turn watch, its stored fold, and this classifier.
+ */
+export function isBlankBlock(block) {
+    if (block.type === "text")
+        return block.text === "";
+    if (block.type === "provider-raw")
+        return isInformationless(block.raw);
+    return false;
+}
+/** The failure code a row's content carries (`content.error.code`), when it carries one. */
+function failureCodeOf(content) {
+    if (typeof content !== "object" || content === null || !("error" in content))
+        return undefined;
+    const error = content.error;
+    if (typeof error !== "object" || error === null || !("code" in error))
+        return undefined;
+    return typeof error.code === "string" && error.code !== "" ? error.code : undefined;
+}
+/** Classify one stored row (see the module doc). */
+export function classifyStoredRow(row) {
+    const code = failureCodeOf(row.content);
+    if (row.clientMessageId.endsWith(AGENT_ERROR_ROW_SUFFIX) || code !== undefined) {
+        return { kind: "failure", code: code ?? null };
+    }
+    if (row.authorRole === "user")
+        return { kind: "conversation" };
+    const stored = readStoredAgMessage(row.content).value;
+    if (stored === undefined)
+        return { kind: "conversation" };
+    if (stored.role === "notice")
+        return { kind: "notice", source: stored.noticeSource ?? null };
+    if (stored.content.every(isBlankBlock))
+        return { kind: "blank" };
+    return { kind: "conversation" };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guuey/threads",
-  "version": "0.29.0",
+  "version": "0.31.0",
   "description": "Universal session/thread persistence for AgJSON agents — the ThreadStore contract (append-fold, history, snapshots), the fold↔row mapping, and an in-memory binding. Guuey's hosted runtime is one binding; implement the port against your own store and run the exported contract suite for the same guarantees.",
   "license": "MIT",
   "type": "module",
@@ -10,6 +10,9 @@
     "dist",
     "README.md"
   ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -22,8 +25,8 @@
     }
   },
   "dependencies": {
-    "@silverprotocol/core": "0.9.0",
-    "@guuey/mcp-apps-host": "0.29.0"
+    "@silverprotocol/core": "0.12.1",
+    "@guuey/mcp-apps-host": "0.31.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",