@vincemakes/kiso-runtime 0.1.28 → 0.1.29

package/dist/summarize.d.ts

@@ -50,6 +50,14 @@ export declare function lastSummaryPoint(events: readonly Event[]): number;
  * a turn boundary by construction, so the projection's skip never splits
  * a message. Returns undefined when fewer than keepRounds+1 uncovered
  * rounds exist (nothing worth covering yet).
+ *
+ * ⑥ (todo round): a tool result tagged do-not-compact is DURABLE work
+ * memory (the todo_set echo) — the summary must never cover its round,
+ * or the model loses the current list. When the base boundary would
+ * cover such a result, the boundary pulls back to just before the round
+ * containing the LATEST one (still a turn boundary). A protected round
+ * as the FIRST uncovered round leaves nothing before it to cover →
+ * undefined (an honest "nothing to compact").
  */
 export declare function summaryBoundarySeq(events: readonly Event[], keepRounds?: number): number | undefined;
 /**

package/dist/summarize.js

@@ -13,7 +13,7 @@
  * unchanged ("nothing happened"). Only the generated `summarized` event
  * lands on disk; the original events stay there forever.
  */
-import { estimateTokens } from "@vincemakes/kiso-core";
+import { estimateTokens, DO_NOT_COMPACT } from "@vincemakes/kiso-core";
 /** K (ADR-0044): the recent ROUNDS kept intact by /compact — a constant,
  *  not a knob. The covered range ends just before the K-th most recent
  *  round, so the model still reasons over the recent conversation. */
@@ -84,6 +84,14 @@ export function lastSummaryPoint(events) {
  * a turn boundary by construction, so the projection's skip never splits
  * a message. Returns undefined when fewer than keepRounds+1 uncovered
  * rounds exist (nothing worth covering yet).
+ *
+ * ⑥ (todo round): a tool result tagged do-not-compact is DURABLE work
+ * memory (the todo_set echo) — the summary must never cover its round,
+ * or the model loses the current list. When the base boundary would
+ * cover such a result, the boundary pulls back to just before the round
+ * containing the LATEST one (still a turn boundary). A protected round
+ * as the FIRST uncovered round leaves nothing before it to cover →
+ * undefined (an honest "nothing to compact").
  */
 export function summaryBoundarySeq(events, keepRounds = KEEP_RECENT_ROUNDS) {
     const prevPoint = lastSummaryPoint(events);
@@ -94,9 +102,48 @@ export function summaryBoundarySeq(events, keepRounds = KEEP_RECENT_ROUNDS) {
     }
     if (uncoveredInputs.length <= keepRounds)
         return undefined;
+    const base = uncoveredInputs[uncoveredInputs.length - keepRounds] - 1;
+    const protectedRound = latestProtectedBoundary(events, prevPoint, base);
+    if (protectedRound !== undefined) {
+        if (protectedRound <= prevPoint)
+            return undefined;
+        return protectedRound;
+    }
     // The input at m - keepRounds opens the FIRST KEPT round; everything
     // before it (m - keepRounds ≥ 1 covered rounds) is summarizable.
-    return uncoveredInputs[uncoveredInputs.length - keepRounds] - 1;
+    return base;
+}
+/**
+ * ⑥: the boundary just before the round holding the LATEST do-not-compact
+ * tool result inside (prevPoint, base] — that round's opening user_input
+ * minus one, or undefined when the range holds no such result. The
+ * projection replaces by RANGE, so only the newest echo matters: older
+ * tagged echoes are superseded and may be covered.
+ */
+function latestProtectedBoundary(events, prevPoint, base) {
+    let protectSeq = -1;
+    for (const ev of events) {
+        if (ev.type === "tool_result" &&
+            ev.seq > prevPoint &&
+            ev.seq <= base &&
+            (ev.tags ?? []).includes(DO_NOT_COMPACT)) {
+            protectSeq = ev.seq;
+        }
+    }
+    if (protectSeq < 0)
+        return undefined;
+    // The round's opening input: the last user_input before the result.
+    // The result's whole round is uncovered by construction (the previous
+    // compact ended at a turn boundary before its input), so the input is
+    // > prevPoint — the guard is the belt.
+    let inputSeq = -1;
+    for (const ev of events) {
+        if (ev.type === "user_input" && ev.seq > prevPoint && ev.seq < protectSeq)
+            inputSeq = ev.seq;
+    }
+    if (inputSeq < 0)
+        return undefined;
+    return inputSeq - 1;
 }
 /**
  * The NoticeCell's number: estimated tokens of the covered content minus

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vincemakes/kiso-runtime",
-  "version": "0.1.28",
+  "version": "0.1.29",
   "description": "kiso runtime — durable multi-turn agent sessions: AgentDefinition, AgentRuntime, AgentSession, Run, append-only JSONL store.",
   "type": "module",
   "license": "MIT",
@@ -21,11 +21,11 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@vincemakes/kiso-core": "0.1.28"
+    "@vincemakes/kiso-core": "0.1.29"
   },
   "peerDependencies": {
-    "@vincemakes/kiso-provider-anthropic": "0.1.28",
-    "@vincemakes/kiso-provider-openai": "0.1.28"
+    "@vincemakes/kiso-provider-anthropic": "0.1.29",
+    "@vincemakes/kiso-provider-openai": "0.1.29"
   },
   "peerDependenciesMeta": {
     "@vincemakes/kiso-provider-anthropic": {
@@ -36,7 +36,7 @@
     }
   },
   "devDependencies": {
-    "@vincemakes/kiso-evals": "0.1.28",
+    "@vincemakes/kiso-evals": "0.1.29",
     "@types/node": "^26.1.2",
     "typescript": "^5.7.2",
     "vitest": "^3.0.0"