@dudousxd/nestjs-agent-react 0.30.0 → 0.31.0

package/README.md

@@ -648,6 +648,11 @@ const backend: AgentBackend = {
   answering it is a new run with `resume`, which the app sends through its own backend.
 - A send without a `threadId` gets a new one (AG-UI's thread id is the consumer's), returned as
   the stream's `threadId`, so `onThreadCreated` fires as usual.
+- Activity (`ACTIVITY_SNAPSHOT` / `ACTIVITY_DELTA`) arrives as a `ui` part, component `AgUiActivity`,
+  id `activity:<messageId>`, props `{ activityType, content }`: the whole content each time (the
+  delta's JSON Patch applied), so the widget updates in place.
+- `content: (body) => parts` sends a file with the message as AG-UI content parts (`image`,
+  `document`… by inline `data`), next to the text part.
 - `reframeAgUiStream(body, { threadId })` is the re-framing alone, for a backend that fetches itself.
 
 ### Typing ahead: the message queue

package/dist/index.cjs

@@ -1958,7 +1958,7 @@ async function agUiChatStream(request, options) {
     threadId,
     runId: newId(),
     protocolVersion: "1.0",
-    messages: [{ id: newId(), role: "user", content: message }],
+    messages: [{ id: newId(), role: "user", content: options.content?.(body) ?? message }],
     ...forwarded !== void 0 ? { forwardedProps: forwarded } : {}
   };
   const doFetch = options.fetch ?? globalThis.fetch.bind(globalThis);
@@ -2033,6 +2033,7 @@ function reframeAgUiStream(source, ids) {
   });
 }
 function createReframer(threadId) {
+  const activities = /* @__PURE__ */ new Map();
   let seq = 0;
   let metaSent = false;
   const tools = /* @__PURE__ */ new Map();
@@ -2149,6 +2150,30 @@ data: ${JSON.stringify({
           else frame({ kind: "tool-output", id, output: parseJson(content, content) });
           break;
         }
+        case "ACTIVITY_SNAPSHOT":
+        case "ACTIVITY_DELTA": {
+          const messageId = typeof event.messageId === "string" ? event.messageId : "";
+          if (messageId === "") break;
+          const known = activities.get(messageId);
+          const activityType = typeof event.activityType === "string" ? event.activityType : known?.activityType ?? "";
+          let content;
+          if (event.type === "ACTIVITY_SNAPSHOT") {
+            if (known !== void 0 && event.replace === false) break;
+            content = isRecord2(event.content) ? event.content : {};
+          } else {
+            if (known === void 0 || !Array.isArray(event.patch)) break;
+            content = applyPatch(known.content, event.patch);
+            if (content === void 0) break;
+          }
+          activities.set(messageId, { activityType, content });
+          frame({
+            kind: "ui",
+            id: `activity:${messageId}`,
+            component: "AgUiActivity",
+            props: { activityType, content }
+          });
+          break;
+        }
         case "RUN_ERROR":
           state.closed = true;
           out += `event: error
@@ -2202,6 +2227,38 @@ function contentText(content) {
   if (!Array.isArray(content)) return "";
   return content.filter((part) => isRecord2(part) && part.type === "text" && typeof part.text === "string").map((part) => part.text).join("");
 }
+function applyPatch(target, patch) {
+  const doc = structuredClone(target);
+  for (const operation of patch) {
+    if (!isRecord2(operation) || typeof operation.path !== "string") return void 0;
+    const tokens = operation.path.split("/").slice(1).map((token) => token.replace(/~1/g, "/").replace(/~0/g, "~"));
+    const key = tokens.pop();
+    if (key === void 0) return void 0;
+    let parent = doc;
+    for (const token of tokens) {
+      parent = Array.isArray(parent) ? parent[Number(token)] : isRecord2(parent) ? parent[token] : void 0;
+      if (parent === void 0) return void 0;
+    }
+    if (Array.isArray(parent)) {
+      const index = key === "-" ? parent.length : Number(key);
+      if (!Number.isInteger(index) || index < 0 || index > parent.length) return void 0;
+      if (operation.op === "add") parent.splice(index, 0, operation.value);
+      else if (operation.op === "replace" && index < parent.length) parent[index] = operation.value;
+      else if (operation.op === "remove" && index < parent.length) parent.splice(index, 1);
+      else if (operation.op === "test") {
+        if (JSON.stringify(parent[index]) !== JSON.stringify(operation.value)) return void 0;
+      } else return void 0;
+    } else if (isRecord2(parent)) {
+      if (operation.op === "add" || operation.op === "replace" && key in parent) {
+        parent[key] = operation.value;
+      } else if (operation.op === "remove" && key in parent) delete parent[key];
+      else if (operation.op === "test") {
+        if (JSON.stringify(parent[key]) !== JSON.stringify(operation.value)) return void 0;
+      } else return void 0;
+    } else return void 0;
+  }
+  return doc;
+}
 
 // src/catalog/use-agents.ts
 var import_react9 = require("react");