@covia/covia-sdk 1.23.0 → 1.24.1

package/dist/index.d.mts

@@ -1886,9 +1886,9 @@ interface AgentSessionMessage {
     tokens?: number;
 }
 /**
- * An archived run of turns that compaction replaced with a summary
+ * A legacy archived run of turns that compaction replaced with a summary
  * (AGENT_CONTEXT.md §1.1 `CompactedSegment`). `items` is the exact recursively
- * archived vector, so no history is lost — {@link AgentSession.conversation}
+ * archived vector (new frame histories use backward historyRange references), so no history is lost — {@link AgentSession.conversation}
  * expands it back into the transcript.
  */
 interface AgentCompactedSegment {

package/dist/index.d.ts

@@ -1886,9 +1886,9 @@ interface AgentSessionMessage {
     tokens?: number;
 }
 /**
- * An archived run of turns that compaction replaced with a summary
+ * A legacy archived run of turns that compaction replaced with a summary
  * (AGENT_CONTEXT.md §1.1 `CompactedSegment`). `items` is the exact recursively
- * archived vector, so no history is lost — {@link AgentSession.conversation}
+ * archived vector (new frame histories use backward historyRange references), so no history is lost — {@link AgentSession.conversation}
  * expands it back into the transcript.
  */
 interface AgentCompactedSegment {

package/dist/index.js

@@ -1931,11 +1931,42 @@ function collectTurns(entries, out, depth = 0) {
     }
   }
 }
+function collectHistory(frame, out) {
+  const history = frame.history;
+  const start = frame.contextStart;
+  if (frame.historyVersion !== void 0 && frame.historyVersion !== 1 || "conversation" in frame || !Array.isArray(history) || !Number.isSafeInteger(start) || start < 0 || start > history.length) {
+    throw new Error("Invalid or unsupported agent frame history");
+  }
+  const pending = [[start, history.length]];
+  const visited = /* @__PURE__ */ new Set();
+  while (pending.length) {
+    const [from, end] = pending.pop();
+    for (let i = from; i < end; i++) {
+      if (visited.has(i)) continue;
+      visited.add(i);
+      const entry = record(history[i]);
+      if (!entry) continue;
+      if ("historyRange" in entry) {
+        const range = entry.historyRange;
+        if (typeof entry.summary !== "string" || "items" in entry || !Number.isSafeInteger(entry.turns) || entry.turns < 0 || !Array.isArray(range) || range.length !== 2 || !range.every(Number.isSafeInteger) || range[0] < 0 || range[1] < range[0] || range[1] > i) {
+          throw new Error("Invalid agent summary historyRange");
+        }
+        pending.push([i + 1, end], [range[0], range[1]]);
+        break;
+      }
+      collectTurns([entry], out);
+    }
+  }
+}
 function sessionConversation(frames) {
   const turns = [];
   for (const frame of frames) {
-    const entries = record(frame)?.conversation;
-    if (Array.isArray(entries)) collectTurns(entries, turns);
+    const value = record(frame);
+    if (!value) continue;
+    if ("history" in value) collectHistory(value, turns);
+    else if ("historyVersion" in value || "contextStart" in value) {
+      throw new Error("Invalid or unsupported agent frame history");
+    } else if (Array.isArray(value.conversation)) collectTurns(value.conversation, turns);
   }
   return turns;
 }

package/dist/index.mjs

@@ -1929,11 +1929,42 @@ function collectTurns(entries, out, depth = 0) {
     }
   }
 }
+function collectHistory(frame, out) {
+  const history = frame.history;
+  const start = frame.contextStart;
+  if (frame.historyVersion !== void 0 && frame.historyVersion !== 1 || "conversation" in frame || !Array.isArray(history) || !Number.isSafeInteger(start) || start < 0 || start > history.length) {
+    throw new Error("Invalid or unsupported agent frame history");
+  }
+  const pending = [[start, history.length]];
+  const visited = /* @__PURE__ */ new Set();
+  while (pending.length) {
+    const [from, end] = pending.pop();
+    for (let i = from; i < end; i++) {
+      if (visited.has(i)) continue;
+      visited.add(i);
+      const entry = record(history[i]);
+      if (!entry) continue;
+      if ("historyRange" in entry) {
+        const range = entry.historyRange;
+        if (typeof entry.summary !== "string" || "items" in entry || !Number.isSafeInteger(entry.turns) || entry.turns < 0 || !Array.isArray(range) || range.length !== 2 || !range.every(Number.isSafeInteger) || range[0] < 0 || range[1] < range[0] || range[1] > i) {
+          throw new Error("Invalid agent summary historyRange");
+        }
+        pending.push([i + 1, end], [range[0], range[1]]);
+        break;
+      }
+      collectTurns([entry], out);
+    }
+  }
+}
 function sessionConversation(frames) {
   const turns = [];
   for (const frame of frames) {
-    const entries = record(frame)?.conversation;
-    if (Array.isArray(entries)) collectTurns(entries, turns);
+    const value = record(frame);
+    if (!value) continue;
+    if ("history" in value) collectHistory(value, turns);
+    else if ("historyVersion" in value || "contextStart" in value) {
+      throw new Error("Invalid or unsupported agent frame history");
+    } else if (Array.isArray(value.conversation)) collectTurns(value.conversation, turns);
   }
   return turns;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@covia/covia-sdk",
-  "version": "1.23.0",
+  "version": "1.24.1",
   "description": "Typescript library for covia-ai",
   "packageManager": "pnpm@11.9.0",
   "main": "./dist/index.js",