@guuey/threads 0.27.0 → 0.28.0

package/dist/fold-rows.d.ts

@@ -53,6 +53,13 @@ export declare function agArtifactToCardRow(art: AgArtifact, ctx: RowCtx, toolNa
  * AgMessage in `content`; user/system rows (persisted up-front) store plain
  * `{ kind, text }` — synthesize a single-text-block AgMessage for those so
  * the reassembled transcript is uniform.
+ *
+ * The stored AgMessage is read with the core's lenient stored-record reader
+ * (AgJSON draft.4 §0.2): a content element of an undefined type, or with an
+ * undefined value in a closed set, is omitted whole and the rest restores in
+ * order; unknown fields pass through untouched. Only a record the reader
+ * cannot materialize (no string `id`, an undefined `role`, no `content`
+ * array) falls to the text projection.
  */
 export declare function rowToAgMessage(row: ThreadMessageRow): AgMessage;
 /** Extract the AgArtifact from a kind='card' row, or undefined if malformed. */

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,CA0BlB;AAkDD,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;;;;;GAKG;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,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;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,oBAAoB,CAClC,UAAU,EAAE,SAAS,GAAG,SAAS,EACjC,iBAAiB,EAAE,cAAc,EAAE,GAClC,OAAO,EAAE,CAmBX"}

package/dist/fold-rows.js

@@ -1,4 +1,4 @@
-import { AgMessage as AgMessageSchema } from "@silverprotocol/core";
+import { readStoredAgMessage } from "@silverprotocol/core";
 import { asUiResource, scanProviderRawForUiResource, toolResultLocator } from "@guuey/mcp-apps-host/narrowing";
 /** AgRole → the row's coarse authorRole projection (secondary; role of record lives in content). */
 function roleToAuthor(role) {
@@ -46,10 +46,24 @@ export function agMessageToRow(msg, ctx) {
         // reducer seed, so stripping could orphan a paused turn's resume after a
         // reload, and the token authorizes the thread owner's OWN resume (not a
         // cross-trust credential like a render wsToken). Revisit on guuey#122.
-        ...(ctx.turnRecord ? { aiContext: ctx.turnRecord } : {}),
+        // The one field it drops is `displayRequired` (turnRecordForStorage).
+        ...(ctx.turnRecord ? { aiContext: turnRecordForStorage(ctx.turnRecord) } : {}),
         ...(ctx.untrustedOrigin === true ? { untrustedOrigin: true } : {}),
     };
 }
+/**
+ * A turn's `displayRequired` is content a model provider requires the host to
+ * show to the person who asked, under that provider's terms, and those terms
+ * allow keeping it only as long as the law requires. It belongs to the LIVE
+ * turn, so it never persists: the stored turn record is the live one without
+ * it, and everything else stays verbatim. Identity when the turn carried none.
+ */
+function turnRecordForStorage(rec) {
+    if (rec.displayRequired === undefined)
+        return rec;
+    const { displayRequired: _dropped, ...rest } = rec;
+    return rest;
+}
 /** Strip every tool-result block's `_meta` (guuey#122); identity when none carried one. */
 function messageWithoutToolResultMeta(msg) {
     let changed = false;
@@ -200,11 +214,18 @@ function isJsonObjectLike(v) {
  * AgMessage in `content`; user/system rows (persisted up-front) store plain
  * `{ kind, text }` — synthesize a single-text-block AgMessage for those so
  * the reassembled transcript is uniform.
+ *
+ * The stored AgMessage is read with the core's lenient stored-record reader
+ * (AgJSON draft.4 §0.2): a content element of an undefined type, or with an
+ * undefined value in a closed set, is omitted whole and the rest restores in
+ * order; unknown fields pass through untouched. Only a record the reader
+ * cannot materialize (no string `id`, an undefined `role`, no `content`
+ * array) falls to the text projection.
  */
 export function rowToAgMessage(row) {
-    const parsed = AgMessageSchema.safeParse(row.content);
-    if (parsed.success)
-        return parsed.data;
+    const stored = readStoredAgMessage(row.content);
+    if (stored.value !== undefined)
+        return stored.value;
     const role = row.authorRole === "user" ? "user" : row.authorRole === "system" ? "system" : "assistant";
     const text = row.text ?? "";
     return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guuey/threads",
-  "version": "0.27.0",
+  "version": "0.28.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",
@@ -22,8 +22,8 @@
     }
   },
   "dependencies": {
-    "@silverprotocol/core": "0.6.7",
-    "@guuey/mcp-apps-host": "0.27.0"
+    "@silverprotocol/core": "0.7.2",
+    "@guuey/mcp-apps-host": "0.28.0"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",