@dudousxd/nestjs-agent-core 0.39.0 → 0.40.0

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

@@ -1,5 +1,6 @@
-import { A as AgentStreamEvent } from '../stream-events-CbVEowYb.cjs';
+import { A as AgentStreamEvent, U as UiCapabilities } from '../stream-events-M0jc7lSW.cjs';
 import '@standard-schema/spec';
+import '../catalog-CrzetM3_.cjs';
 
 /**
  * The slice of AG-UI 1.0 (https://docs.ag-ui.com/spec/1.0) this producer writes and reads. Typed by
@@ -412,6 +413,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 +478,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.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-DAmes2Of.js';
 import '@standard-schema/spec';
+import '../catalog-CrzetM3_.js';
 
 /**
  * The slice of AG-UI 1.0 (https://docs.ag-ui.com/spec/1.0) this producer writes and reads. Typed by
@@ -412,6 +413,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 +478,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

@@ -655,6 +655,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 +711,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 +822,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 +1040,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: "aviary.action-proposal-decision",
+      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,