@dudousxd/nestjs-agent-core 0.39.0 → 0.41.0

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

@@ -1,5 +1,6 @@
-import { A as AgentStreamEvent } from '../stream-events-CbVEowYb.js';
+import { A as AgentStreamEvent, U as UiCapabilities } from '../stream-events-BGKLD6RX.js';
 import '@standard-schema/spec';
+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
@@ -198,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";
 };
@@ -360,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. */
@@ -368,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. */
@@ -412,6 +419,7 @@ declare function readContext(context: readonly AgUiContext[] | undefined): AgUiC
  * model: which agent, which model, which persona, and the page context the tools see.
  */
 interface ForwardedOptions {
+    uiCapabilities?: UiCapabilities;
     agent?: string;
     model?: string;
     persona?: string;
@@ -476,4 +484,12 @@ declare function agUiSse(event: AgUiEvent): string;
  */
 declare function agUiFramesFromNdjson(chunks: AsyncIterable<Uint8Array>): AsyncGenerator<AgUiSourceFrame>;
 
-export { AG_UI_CUSTOM, AG_UI_PROTOCOL_VERSION, type AgUiContentPart, type AgUiContext, AgUiEncoder, type AgUiEncoderOptions, type AgUiEvent, type AgUiInterrupt, type AgUiMessage, type AgUiMetadata, type AgUiPartSource, type AgUiResumeEntry, type AgUiRunInput, type AgUiRunOutcome, type AgUiSourceFrame, type AgUiStreamOptions, type AgUiTokenUsage, type ForwardedOptions, type InlineMedia, type InterruptAddress, type ResumeDecision, type ResumePlan, type UserTurn, agUiEvents, agUiFramesFromNdjson, agUiSse, decodeInterruptId, encodeInterruptId, parseRunInput, planResume, readAnswersPayload, readApprovalPayload, readContext, readForwardedProps, readUserTurn };
+/** A decision-only protocol invocation: no model run, stream holder or tool execution is created. */
+declare function actionProposalDecisionEvents(input: {
+    threadId: string;
+    runId: string;
+    text: string;
+    proposalDecision: unknown;
+}): AgUiEvent[];
+
+export { AG_UI_CUSTOM, AG_UI_PROTOCOL_VERSION, type AgUiContentPart, type AgUiContext, AgUiEncoder, type AgUiEncoderOptions, type AgUiEvent, type AgUiInterrupt, type AgUiMessage, type AgUiMetadata, type AgUiPartSource, type AgUiResumeEntry, type AgUiRunInput, type AgUiRunOutcome, type AgUiSourceFrame, type AgUiStreamOptions, type AgUiTokenUsage, type ForwardedOptions, type InlineMedia, type InterruptAddress, type ResumeDecision, type ResumePlan, type UserTurn, actionProposalDecisionEvents, agUiEvents, agUiFramesFromNdjson, agUiSse, decodeInterruptId, encodeInterruptId, parseRunInput, planResume, readAnswersPayload, readApprovalPayload, readContext, readForwardedProps, readUserTurn };

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
     }));
@@ -655,6 +691,31 @@ var AgUiEncoder = class {
   }
 };
 
+// src/genui/catalog.ts
+var COMPONENT_NAME = /^[A-Za-z][A-Za-z0-9]{0,63}$/;
+
+// src/genui/capabilities.ts
+function validateUiCapabilities(value) {
+  if (!record(value) || Object.keys(value).some((key) => key !== "components") || !Array.isArray(value.components)) throw new TypeError("Invalid UI capabilities");
+  const seen = /* @__PURE__ */ new Set();
+  const components = value.components.map((component) => {
+    if (!record(component) || Object.keys(component).some((key) => key !== "name" && key !== "version") || typeof component.name !== "string" || !COMPONENT_NAME.test(component.name) || !Number.isSafeInteger(component.version) || Number(component.version) <= 0 || seen.has(component.name)) throw new TypeError("Invalid UI component capability");
+    seen.add(component.name);
+    return {
+      name: component.name,
+      version: Number(component.version)
+    };
+  });
+  return {
+    components
+  };
+}
+__name(validateUiCapabilities, "validateUiCapabilities");
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+__name(record, "record");
+
 // src/ag-ui/input.ts
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -686,6 +747,13 @@ function parseRunInput(body) {
   if (body.context !== void 0 && !Array.isArray(body.context)) {
     return "context must be an array";
   }
+  if (isRecord(body.forwardedProps) && Object.hasOwn(body.forwardedProps, "uiCapabilities")) {
+    try {
+      validateUiCapabilities(body.forwardedProps.uiCapabilities);
+    } catch {
+      return "forwardedProps.uiCapabilities must be valid UI capabilities";
+    }
+  }
   return body;
 }
 __name(parseRunInput, "parseRunInput");
@@ -790,6 +858,9 @@ function readForwardedProps(forwarded) {
   const model = pick("model");
   const persona = pick("persona");
   return {
+    ...Object.hasOwn(forwarded, "uiCapabilities") ? {
+      uiCapabilities: validateUiCapabilities(forwarded.uiCapabilities)
+    } : {},
     ...agent !== void 0 ? {
       agent
     } : {},
@@ -1005,10 +1076,52 @@ async function* agUiFramesFromNdjson(chunks) {
   }
 }
 __name(agUiFramesFromNdjson, "agUiFramesFromNdjson");
+
+// src/ag-ui/proposal-decision.ts
+function actionProposalDecisionEvents(input) {
+  const messageId = `${input.runId}:proposal-decision`;
+  return [
+    {
+      type: "RUN_STARTED",
+      threadId: input.threadId,
+      runId: input.runId,
+      protocolVersion: AG_UI_PROTOCOL_VERSION
+    },
+    {
+      type: "CUSTOM",
+      name: AG_UI_CUSTOM.actionProposalDecision,
+      value: {
+        threadId: input.threadId,
+        proposalDecision: input.proposalDecision
+      }
+    },
+    {
+      type: "TEXT_MESSAGE_START",
+      messageId,
+      role: "assistant"
+    },
+    {
+      type: "TEXT_MESSAGE_CONTENT",
+      messageId,
+      delta: input.text
+    },
+    {
+      type: "TEXT_MESSAGE_END",
+      messageId
+    },
+    {
+      type: "RUN_FINISHED",
+      threadId: input.threadId,
+      runId: input.runId
+    }
+  ];
+}
+__name(actionProposalDecisionEvents, "actionProposalDecisionEvents");
 export {
   AG_UI_CUSTOM,
   AG_UI_PROTOCOL_VERSION,
   AgUiEncoder,
+  actionProposalDecisionEvents,
   agUiEvents,
   agUiFramesFromNdjson,
   agUiSse,