@cuylabs/agent-runtime-dapr 4.9.0 → 5.0.0

package/README.md

@@ -118,6 +118,20 @@ tool still executes through `agent.getHost()`.
 
 For the full explanation, see [Tool Hosts In Durable Workflows](docs/tool-hosts.md).
 
+## Durable Context Compaction
+
+Durable turns compact at the same model-step boundary as direct `Agent.chat()`,
+but they do it through workflow state instead of the in-process chat loop.
+Before a `model-step` activity runs, the workflow can call a
+`context-compaction` activity. That activity applies the agent's normal
+compaction policy to the serialized workflow messages, persists the compaction
+entry to session storage, returns the compacted message snapshots, and the
+workflow checkpoints `context-compaction-finish` before continuing.
+
+This keeps the durable path crash-safe without importing direct-loop internals:
+direct execution uses `ChatModelStepSnapshot`; Dapr durable execution uses
+`AgentWorkflowTurnState.messages` and `AgentWorkflowModelStepPlan`.
+
 ## Quick Start
 
 ### Step 1: Define your agent

package/dist/{chunk-6BLY7B7U.js → chunk-BQLQLDWZ.js}

@@ -4,7 +4,10 @@ import {
 } from "./chunk-HQLQRXU5.js";
 
 // src/dispatch/runtime.ts
-import { ensureNonEmpty as ensureNonEmpty2, mergeInspection, sleep } from "@cuylabs/agent-core";
+import { ensureNonEmpty as ensureNonEmpty3, mergeInspection, sleep } from "@cuylabs/agent-core";
+
+// src/dispatch/targets.ts
+import { ensureNonEmpty as ensureNonEmpty2 } from "@cuylabs/agent-core";
 
 // src/host/invoker.ts
 var DEFAULT_DAPR_HTTP_ENDPOINT = "http://127.0.0.1:3500";
@@ -163,121 +166,7 @@ async function invokeRemoteAgentRun(invoker, appId, request, methodPath = "agent
   return response.data;
 }
 
-// src/dispatch/runtime.ts
-var DEFAULT_KEY_PREFIX = "agent-runtime:dispatch:";
-var STORED_KIND = "@cuylabs/agent-runtime-dapr/dispatch-record";
-var STORED_VERSION = 1;
-var DEFAULT_INDEX_UPDATE_RETRIES = 4;
-var DEFAULT_POLL_INTERVAL_MS = 500;
-function cloneRecord(record) {
-  return structuredClone(record);
-}
-function toStoredRecord(record) {
-  return {
-    kind: STORED_KIND,
-    version: STORED_VERSION,
-    record
-  };
-}
-function fromStoredRecord(value) {
-  if (!value || typeof value !== "object") {
-    return void 0;
-  }
-  const envelope = value;
-  if (envelope.kind !== STORED_KIND || envelope.version !== STORED_VERSION || !envelope.record) {
-    return void 0;
-  }
-  return cloneRecord(envelope.record);
-}
-function normalizeStatuses(status) {
-  if (!status) {
-    return void 0;
-  }
-  return new Set(Array.isArray(status) ? status : [status]);
-}
-function createDaprDispatchRecordWriter(options) {
-  const client = new DaprSidecarClient(options);
-  const agentId = ensureNonEmpty2(options.agentId, "agentId");
-  const keyPrefix = ensureNonEmpty2(
-    options.keyPrefix ?? DEFAULT_KEY_PREFIX,
-    "keyPrefix"
-  );
-  function recordKey(id) {
-    return `${keyPrefix}records/${agentId}/${id}`;
-  }
-  function globalIndexKey() {
-    return `${keyPrefix}record-index/${agentId}`;
-  }
-  function sessionIndexKey(sessionId) {
-    return `${keyPrefix}session-index/${agentId}/${sessionId}`;
-  }
-  async function readIndex(key) {
-    const entry = await client.getStateEntry(key);
-    if (entry.value === void 0) {
-      return { exists: false };
-    }
-    if (!Array.isArray(entry.value)) {
-      return { ids: [], etag: entry.etag, exists: true };
-    }
-    return {
-      ids: [
-        ...new Set(
-          entry.value.filter(
-            (item) => typeof item === "string"
-          )
-        )
-      ],
-      etag: entry.etag,
-      exists: true
-    };
-  }
-  async function writeIndex(key, ids, etag) {
-    await client.saveState(key, [...new Set(ids)], {
-      ...etag ? { etag } : {},
-      concurrency: etag ? "first-write" : void 0
-    });
-  }
-  async function updateIndex(key, updater) {
-    for (let attempt = 0; attempt < DEFAULT_INDEX_UPDATE_RETRIES; attempt += 1) {
-      const current = await readIndex(key);
-      const next = updater(current.ids ?? []);
-      if (!next) {
-        return;
-      }
-      try {
-        await writeIndex(key, next, current.etag);
-        return;
-      } catch (error) {
-        if (isDaprConflictError(error) && attempt + 1 < DEFAULT_INDEX_UPDATE_RETRIES) {
-          continue;
-        }
-        throw error;
-      }
-    }
-  }
-  async function addRecordToIndex(key, id) {
-    await updateIndex(key, (ids) => {
-      if (ids.includes(id)) {
-        return void 0;
-      }
-      return [...ids, id];
-    });
-  }
-  return {
-    async saveStartedRecord(record) {
-      await client.saveState(recordKey(record.id), toStoredRecord(record), {
-        concurrency: "first-write"
-      });
-      await addRecordToIndex(globalIndexKey(), record.id);
-      if (record.parentSessionId) {
-        await addRecordToIndex(
-          sessionIndexKey(record.parentSessionId),
-          record.id
-        );
-      }
-    }
-  };
-}
+// src/dispatch/targets.ts
 function mapWorkflowStatus(status) {
   switch (status) {
     case "COMPLETED":
@@ -494,10 +383,126 @@ function createRemoteAgentDispatchTarget(options) {
     }
   };
 }
+
+// src/dispatch/runtime.ts
+var DEFAULT_KEY_PREFIX = "agent-runtime:dispatch:";
+var STORED_KIND = "@cuylabs/agent-runtime-dapr/dispatch-record";
+var STORED_VERSION = 1;
+var DEFAULT_INDEX_UPDATE_RETRIES = 4;
+var DEFAULT_POLL_INTERVAL_MS = 500;
+function cloneRecord(record) {
+  return structuredClone(record);
+}
+function toStoredRecord(record) {
+  return {
+    kind: STORED_KIND,
+    version: STORED_VERSION,
+    record
+  };
+}
+function fromStoredRecord(value) {
+  if (!value || typeof value !== "object") {
+    return void 0;
+  }
+  const envelope = value;
+  if (envelope.kind !== STORED_KIND || envelope.version !== STORED_VERSION || !envelope.record) {
+    return void 0;
+  }
+  return cloneRecord(envelope.record);
+}
+function normalizeStatuses(status) {
+  if (!status) {
+    return void 0;
+  }
+  return new Set(Array.isArray(status) ? status : [status]);
+}
+function createDaprDispatchRecordWriter(options) {
+  const client = new DaprSidecarClient(options);
+  const agentId = ensureNonEmpty3(options.agentId, "agentId");
+  const keyPrefix = ensureNonEmpty3(
+    options.keyPrefix ?? DEFAULT_KEY_PREFIX,
+    "keyPrefix"
+  );
+  function recordKey(id) {
+    return `${keyPrefix}records/${agentId}/${id}`;
+  }
+  function globalIndexKey() {
+    return `${keyPrefix}record-index/${agentId}`;
+  }
+  function sessionIndexKey(sessionId) {
+    return `${keyPrefix}session-index/${agentId}/${sessionId}`;
+  }
+  async function readIndex(key) {
+    const entry = await client.getStateEntry(key);
+    if (entry.value === void 0) {
+      return { exists: false };
+    }
+    if (!Array.isArray(entry.value)) {
+      return { ids: [], etag: entry.etag, exists: true };
+    }
+    return {
+      ids: [
+        ...new Set(
+          entry.value.filter(
+            (item) => typeof item === "string"
+          )
+        )
+      ],
+      etag: entry.etag,
+      exists: true
+    };
+  }
+  async function writeIndex(key, ids, etag) {
+    await client.saveState(key, [...new Set(ids)], {
+      ...etag ? { etag } : {},
+      concurrency: etag ? "first-write" : void 0
+    });
+  }
+  async function updateIndex(key, updater) {
+    for (let attempt = 0; attempt < DEFAULT_INDEX_UPDATE_RETRIES; attempt += 1) {
+      const current = await readIndex(key);
+      const next = updater(current.ids ?? []);
+      if (!next) {
+        return;
+      }
+      try {
+        await writeIndex(key, next, current.etag);
+        return;
+      } catch (error) {
+        if (isDaprConflictError(error) && attempt + 1 < DEFAULT_INDEX_UPDATE_RETRIES) {
+          continue;
+        }
+        throw error;
+      }
+    }
+  }
+  async function addRecordToIndex(key, id) {
+    await updateIndex(key, (ids) => {
+      if (ids.includes(id)) {
+        return void 0;
+      }
+      return [...ids, id];
+    });
+  }
+  return {
+    async saveStartedRecord(record) {
+      await client.saveState(recordKey(record.id), toStoredRecord(record), {
+        concurrency: "first-write"
+      });
+      await addRecordToIndex(globalIndexKey(), record.id);
+      if (record.parentSessionId) {
+        await addRecordToIndex(
+          sessionIndexKey(record.parentSessionId),
+          record.id
+        );
+      }
+    }
+  };
+}
 function createDaprDispatchRuntime(options) {
   const client = new DaprSidecarClient(options);
-  const agentId = ensureNonEmpty2(options.agentId, "agentId");
-  const keyPrefix = ensureNonEmpty2(
+  const agentId = ensureNonEmpty3(options.agentId, "agentId");
+  const keyPrefix = ensureNonEmpty3(
     options.keyPrefix ?? DEFAULT_KEY_PREFIX,
     "keyPrefix"
   );
@@ -677,7 +682,7 @@ function createDaprDispatchRuntime(options) {
     },
     async start(input) {
       const target = targets.get(
-        ensureNonEmpty2(input.targetType, "targetType")
+        ensureNonEmpty3(input.targetType, "targetType")
       );
       if (!target) {
         throw new Error(`Unknown dispatch target "${input.targetType}".`);
@@ -685,7 +690,7 @@ function createDaprDispatchRuntime(options) {
       const id = createId();
       const startedAt = now();
       const title = input.title?.trim() || `Dispatch: ${target.name}`;
-      const brief = ensureNonEmpty2(input.brief, "brief");
+      const brief = ensureNonEmpty3(input.brief, "brief");
       const launched = await target.start({
         id,
         brief,
@@ -736,7 +741,7 @@ function createDaprDispatchRuntime(options) {
           `No target registered for dispatch target "${current.targetType}".`
         );
       }
-      const nextMessage = ensureNonEmpty2(message, "message");
+      const nextMessage = ensureNonEmpty3(message, "message");
       await target.redirect({
         record: cloneRecord(current),
         message: nextMessage
@@ -992,9 +997,9 @@ function createDaprCompositeDispatchExecutor(options) {
 export {
   DaprServiceInvoker,
   invokeRemoteAgentRun,
-  createDaprDispatchRecordWriter,
   createWorkflowDispatchTarget,
   createRemoteAgentDispatchTarget,
+  createDaprDispatchRecordWriter,
   createDaprDispatchRuntime,
   readWorkflowCompletion,
   createDaprWorkflowDispatchExecutor,