@dudousxd/nestjs-agent-core 0.40.0 → 0.42.0

package/dist/ag-ui/index.d.ts

@@ -1,6 +1,6 @@
-import { A as AgentStreamEvent, U as UiCapabilities } from '../stream-events-DAmes2Of.js';
+import { A as AgentStreamEvent, U as UiCapabilities } from '../stream-events-D92SgfRk.js';
 import '@standard-schema/spec';
-import '../catalog-CrzetM3_.js';
+import '../catalog-BKS3Yxo6.js';
 
 /**
  * The slice of AG-UI 1.0 (https://docs.ag-ui.com/spec/1.0) this producer writes and reads. Typed by
@@ -199,6 +199,8 @@ declare const AG_UI_CUSTOM: {
     readonly elicitation: "agora.elicitation";
     /** `{ usage, costUsd, reasoningMs }` of one model step. */
     readonly stepUsage: "agora.step-usage";
+    /** A proposal decided by a text message or an interrupt resume, with no model run behind it. */
+    readonly actionProposalDecision: "agora.action-proposal-decision";
     /** `{ message }` — input material this producer could not use and dropped. */
     readonly warning: "agora.warning";
 };
@@ -361,7 +363,8 @@ declare class AgUiEncoder {
  * the native approve/answer routes do.
  */
 interface InterruptAddress {
-    kind: 'approval' | 'elicitation';
+    /** `proposal` — an independent proposal's approval, decided through the proposal service. */
+    kind: 'approval' | 'elicitation' | 'proposal';
     /** The run to settle the call on. */
     parked: string;
     /** The run whose buffered stream the resume re-attaches to. */
@@ -369,6 +372,9 @@ interface InterruptAddress {
     toolCallId: string;
     /** Frames of `stream` already delivered when the run was reported interrupted. */
     position: number;
+    /** `proposal` only: the proposal and the library thread it belongs to. */
+    proposalId?: string;
+    threadId?: string;
 }
 declare function encodeInterruptId(address: InterruptAddress): string;
 /** The address an id names, or `null` for an id this producer did not mint. */

package/dist/ag-ui/index.js

@@ -2,15 +2,21 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/ag-ui/interrupt-id.ts
+var KIND_CODES = {
+  approval: "a",
+  elicitation: "e",
+  proposal: "p"
+};
 var PREFIX = "agora_";
 function encodeInterruptId(address) {
   const compact = [
-    address.kind === "approval" ? "a" : "e",
+    KIND_CODES[address.kind],
     address.parked,
     address.stream,
     address.toolCallId,
     address.position
   ];
+  if (address.kind === "proposal") compact.push(address.proposalId, address.threadId);
   return PREFIX + Buffer.from(JSON.stringify(compact), "utf8").toString("base64url");
 }
 __name(encodeInterruptId, "encodeInterruptId");
@@ -18,17 +24,21 @@ function decodeInterruptId(id) {
   if (typeof id !== "string" || !id.startsWith(PREFIX)) return null;
   try {
     const parsed = JSON.parse(Buffer.from(id.slice(PREFIX.length), "base64url").toString("utf8"));
-    if (!Array.isArray(parsed) || parsed.length !== 5) return null;
-    const [kind, parked, stream, toolCallId, position] = parsed;
-    if (kind !== "a" && kind !== "e" || typeof parked !== "string" || typeof stream !== "string" || typeof toolCallId !== "string" || typeof position !== "number" || !Number.isSafeInteger(position) || position < 0) {
+    if (!Array.isArray(parsed)) return null;
+    const [kind, parked, stream, toolCallId, position, proposalId, threadId] = parsed;
+    if (parsed.length !== (kind === "p" ? 7 : 5) || kind === "p" && (typeof proposalId !== "string" || typeof threadId !== "string") || kind !== "a" && kind !== "e" && kind !== "p" || typeof parked !== "string" || typeof stream !== "string" || typeof toolCallId !== "string" || typeof position !== "number" || !Number.isSafeInteger(position) || position < 0) {
       return null;
     }
     return {
-      kind: kind === "a" ? "approval" : "elicitation",
+      kind: kind === "a" ? "approval" : kind === "e" ? "elicitation" : "proposal",
       parked,
       stream,
       toolCallId,
-      position
+      position,
+      ...kind === "p" ? {
+        proposalId,
+        threadId
+      } : {}
     };
   } catch {
     return null;
@@ -52,6 +62,8 @@ var AG_UI_CUSTOM = {
   elicitation: "agora.elicitation",
   /** `{ usage, costUsd, reasoningMs }` of one model step. */
   stepUsage: "agora.step-usage",
+  /** A proposal decided by a text message or an interrupt resume, with no model run behind it. */
+  actionProposalDecision: "agora.action-proposal-decision",
   /** `{ message }` — input material this producer could not use and dropped. */
   warning: "agora.warning"
 };
@@ -239,6 +251,13 @@ var AgUiEncoder = class {
             ...event.version !== void 0 ? {
               version: event.version
             } : {},
+            // What a client that cannot draw the component shows instead.
+            ...event.fallbackText !== void 0 ? {
+              fallbackText: event.fallbackText
+            } : {},
+            ...event.componentVersions !== void 0 ? {
+              componentVersions: event.componentVersions
+            } : {},
             ...event.toolCallId !== void 0 ? {
               toolCallId: event.toolCallId
             } : {}
@@ -249,10 +268,14 @@ var AgUiEncoder = class {
         const parked = event.runId ?? this.options.streamRunId;
         const toolName = event.toolName ?? call?.name ?? "";
         const input = event.input ?? call?.input ?? null;
+        const proposal = event.target?.kind === "proposal" ? event.target : void 0;
         this.pending.set(event.id, {
-          kind: "approval",
+          kind: proposal !== void 0 ? "proposal" : "approval",
           parked,
           toolCallId: event.id,
+          ...proposal !== void 0 ? {
+            proposalId: proposal.proposalId
+          } : {},
           interrupt: {
             reason: "tool_approval",
             message: event.reason ?? (toolName.length > 0 ? `Approve ${toolName}?` : "Approve?"),
@@ -264,7 +287,10 @@ var AgUiEncoder = class {
             metadata: {
               "agora.toolName": toolName,
               "agora.input": input,
-              "agora.approver": event.approver
+              "agora.approver": event.approver,
+              ...event.target !== void 0 ? {
+                "agora.target": event.target
+              } : {}
             }
           }
         });
@@ -275,6 +301,12 @@ var AgUiEncoder = class {
             toolName,
             input,
             approver: event.approver,
+            ...event.target !== void 0 ? {
+              target: event.target
+            } : {},
+            ...event.confirmation !== void 0 ? {
+              confirmation: event.confirmation
+            } : {},
             ...event.expiresAt !== void 0 ? {
               expiresAt: event.expiresAt
             } : {},
@@ -502,7 +534,11 @@ var AgUiEncoder = class {
         parked: entry.parked,
         stream: this.options.streamRunId,
         toolCallId: entry.toolCallId,
-        position: this.position
+        position: this.position,
+        ...entry.proposalId !== void 0 ? {
+          proposalId: entry.proposalId,
+          threadId: this.options.streamThreadId ?? this.options.threadId
+        } : {}
       }),
       ...entry.interrupt
     }));
@@ -1053,7 +1089,7 @@ function actionProposalDecisionEvents(input) {
     },
     {
       type: "CUSTOM",
-      name: "aviary.action-proposal-decision",
+      name: AG_UI_CUSTOM.actionProposalDecision,
       value: {
         threadId: input.threadId,
         proposalDecision: input.proposalDecision