@dudousxd/nestjs-agent 1.27.1 → 1.29.0

package/dist/index.cjs

@@ -22,8 +22,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  A2uiRunHandler: () => A2uiRunHandler,
   AGENT_CHAT_QUEUE: () => AGENT_CHAT_QUEUE,
   AGENT_METADATA: () => AGENT_METADATA,
+  AGENT_SERVICE: () => AGENT_SERVICE,
   AGENT_TOOL_BRAND: () => AGENT_TOOL_BRAND,
   AI_TOOL_METADATA: () => AI_TOOL_METADATA,
   ATTACHMENT_PAGE_SIZE: () => ATTACHMENT_PAGE_SIZE,
@@ -36,7 +38,7 @@ __export(index_exports, {
   AgentDepsFactory: () => AgentDepsFactory2,
   AgentDiscoveryService: () => AgentDiscoveryService,
   AgentModule: () => AgentModule,
-  AgentService: () => AgentService,
+  AgentService: () => AgentService2,
   AiTool: () => AiTool,
   AiToolDiscoveryService: () => AiToolDiscoveryService,
   AnonymousActorResolver: () => AnonymousActorResolver,
@@ -65,6 +67,7 @@ __export(index_exports, {
   SystemPrompt: () => SystemPrompt,
   SystemPromptContributor: () => SystemPromptContributor,
   ToolsController: () => ToolsController,
+  a2uiAdapter: () => a2uiAdapter,
   agUiAdapter: () => agUiAdapter,
   attachmentLimits: () => attachmentLimits,
   declaredSkillProvider: () => declaredSkillProvider,
@@ -176,7 +179,7 @@ function resolverProviders(resolver) {
 }
 __name(resolverProviders, "resolverProviders");
 function toolOptions(options, resolver) {
-  const { catalog: _catalog, ...rest } = options;
+  const { catalog: _catalog, sandbox: _sandbox, ...rest } = options;
   return {
     ...rest,
     ...resolver !== void 0 ? {
@@ -185,11 +188,19 @@ function toolOptions(options, resolver) {
   };
 }
 __name(toolOptions, "toolOptions");
+function withSandbox(options) {
+  const base = options.catalog ?? (0, import_genui.defineCatalog)([]);
+  const { sandbox } = options;
+  return sandbox === void 0 || sandbox === false ? base : base.extend([
+    (0, import_genui.defineSandbox)(sandbox === true ? {} : sandbox)
+  ]);
+}
+__name(withSandbox, "withSandbox");
 function coreProviders(resolver) {
   return [
     {
       provide: GENUI_CATALOG,
-      useFactory: /* @__PURE__ */ __name((options) => options.catalog ?? (0, import_genui.defineCatalog)([]), "useFactory"),
+      useFactory: /* @__PURE__ */ __name((options) => withSandbox(options), "useFactory"),
       inject: [
         GENUI_OPTIONS
       ]
@@ -648,6 +659,9 @@ AgentDepsFactory2 = _ts_decorate2([
   ])
 ], AgentDepsFactory2);
 
+// src/agent-service.token.ts
+var AGENT_SERVICE = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:agent-service");
+
 // src/agent.service.ts
 var import_nestjs_agent_core9 = require("@dudousxd/nestjs-agent-core");
 var import_common6 = require("@nestjs/common");
@@ -1477,7 +1491,7 @@ function sendableParams(params) {
   };
 }
 __name(sendableParams, "sendableParams");
-var AgentService = class {
+var AgentService2 = class {
   static {
     __name(this, "AgentService");
   }
@@ -2660,7 +2674,7 @@ var AgentService = class {
     }
   }
 };
-AgentService = _ts_decorate5([
+AgentService2 = _ts_decorate5([
   (0, import_common6.Injectable)(),
   _ts_param4(0, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_RUNNER)),
   _ts_param4(1, (0, import_common6.Inject)(import_nestjs_agent_core9.AGENT_STORE)),
@@ -2687,7 +2701,7 @@ AgentService = _ts_decorate5([
     typeof ChatQueueService === "undefined" ? Object : ChatQueueService,
     typeof ActionProposalService === "undefined" ? Object : ActionProposalService
   ])
-], AgentService);
+], AgentService2);
 
 // src/approval-port.adapter.ts
 var import_common7 = require("@nestjs/common");
@@ -2781,7 +2795,7 @@ AgentApprovalPortAdapter = _ts_decorate6([
   _ts_param5(1, (0, import_common7.Optional)()),
   _ts_metadata5("design:type", Function),
   _ts_metadata5("design:paramtypes", [
-    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof AgentService2 === "undefined" ? Object : AgentService2,
     typeof ActionProposalService === "undefined" ? Object : ActionProposalService
   ])
 ], AgentApprovalPortAdapter);
@@ -2982,7 +2996,7 @@ AttachmentsController = _ts_decorate8([
   _ts_metadata7("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
-    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof AgentService2 === "undefined" ? Object : AgentService2,
     Object
   ])
 ], AttachmentsController);
@@ -3254,7 +3268,7 @@ ChatController = _ts_decorate9([
   _ts_param8(1, (0, import_common10.Inject)(import_nestjs_agent_core12.AGENT_ACTOR_RESOLVER)),
   _ts_metadata8("design:type", Function),
   _ts_metadata8("design:paramtypes", [
-    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof AgentService2 === "undefined" ? Object : AgentService2,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ChatController);
@@ -3652,7 +3666,7 @@ MessagesController = _ts_decorate12([
   _ts_param11(1, (0, import_common13.Inject)(import_nestjs_agent_core15.AGENT_ACTOR_RESOLVER)),
   _ts_metadata11("design:type", Function),
   _ts_metadata11("design:paramtypes", [
-    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof AgentService2 === "undefined" ? Object : AgentService2,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], MessagesController);
@@ -3721,7 +3735,7 @@ ModelsController = _ts_decorate13([
   _ts_param12(1, (0, import_common14.Inject)(import_nestjs_agent_core16.AGENT_ACTOR_RESOLVER)),
   _ts_metadata12("design:type", Function),
   _ts_metadata12("design:paramtypes", [
-    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof AgentService2 === "undefined" ? Object : AgentService2,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ModelsController);
@@ -3881,7 +3895,7 @@ QueueController = _ts_decorate14([
   _ts_param13(1, (0, import_common15.Inject)(import_nestjs_agent_core17.AGENT_ACTOR_RESOLVER)),
   _ts_metadata13("design:type", Function),
   _ts_metadata13("design:paramtypes", [
-    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof AgentService2 === "undefined" ? Object : AgentService2,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], QueueController);
@@ -3948,7 +3962,7 @@ QuotaController = _ts_decorate15([
   _ts_param14(1, (0, import_common16.Inject)(import_nestjs_agent_core18.AGENT_ACTOR_RESOLVER)),
   _ts_metadata14("design:type", Function),
   _ts_metadata14("design:paramtypes", [
-    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof AgentService2 === "undefined" ? Object : AgentService2,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], QuotaController);
@@ -4211,7 +4225,7 @@ ThreadsController = _ts_decorate17([
   _ts_param16(1, (0, import_common18.Inject)(import_nestjs_agent_core20.AGENT_ACTOR_RESOLVER)),
   _ts_metadata16("design:type", Function),
   _ts_metadata16("design:paramtypes", [
-    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof AgentService2 === "undefined" ? Object : AgentService2,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ThreadsController);
@@ -4426,7 +4440,7 @@ ToolCallController = _ts_decorate18([
   _ts_param17(1, (0, import_common19.Inject)(import_nestjs_agent_core21.AGENT_ACTOR_RESOLVER)),
   _ts_metadata17("design:type", Function),
   _ts_metadata17("design:paramtypes", [
-    typeof AgentService === "undefined" ? Object : AgentService,
+    typeof AgentService2 === "undefined" ? Object : AgentService2,
     typeof ActorResolver === "undefined" ? Object : ActorResolver
   ])
 ], ToolCallController);
@@ -6360,7 +6374,11 @@ function sharedProviders(durable, engine) {
       useExisting: ChatQueueService
     },
     InlineAgentRunner,
-    AgentService,
+    AgentService2,
+    {
+      provide: AGENT_SERVICE,
+      useExisting: AgentService2
+    },
     ActionProposalService,
     ActionProposalWorkerService,
     // Bound ALWAYS (durable or inline) — the console's cross-thread approvals inbox routes decisions
@@ -6427,7 +6445,8 @@ function exportsFor(engine) {
     import_nestjs_agent_core34.AGENT_MEMORY,
     import_nestjs_agent_core34.AGENT_DEPS_FACTORY,
     AgentDepsFactory2,
-    AgentService,
+    AgentService2,
+    AGENT_SERVICE,
     ActionProposalService,
     ActionProposalWorkerService,
     ChatQueueService,
@@ -6588,7 +6607,9 @@ AgentModule = _ts_decorate27([
 
 // src/ag-ui/ag-ui.adapter.ts
 var import_nestjs_agent_core35 = require("@dudousxd/nestjs-agent-core");
+var import_a2ui = require("@dudousxd/nestjs-agent-core/a2ui");
 var import_ag_ui = require("@dudousxd/nestjs-agent-core/ag-ui");
+var import_genui3 = require("@dudousxd/nestjs-agent-core/genui");
 var import_common29 = require("@nestjs/common");
 function _ts_decorate28(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -6644,12 +6665,14 @@ var AgUiRunHandler = class {
   options;
   staging;
   quietMs;
-  constructor(agent, actorResolver, options, staging, quietMs) {
+  a2ui;
+  constructor(agent, actorResolver, options, staging, quietMs, a2ui = void 0) {
     this.agent = agent;
     this.actorResolver = actorResolver;
     this.options = options;
     this.staging = staging;
     this.quietMs = quietMs;
+    this.a2ui = a2ui;
   }
   async handle(req, res, body) {
     const input = (0, import_ag_ui.parseRunInput)(body);
@@ -6698,12 +6721,22 @@ var AgUiRunHandler = class {
           skip: first.address.position,
           answered: plan.decisions.map((decision) => decision.address.toolCallId),
           ...quiet,
+          ...this.a2uiFor(input),
           preamble: warningEvents(warnings)
         });
         return;
       }
     }
-    const turn = (0, import_ag_ui.readUserTurn)(input.messages);
+    const action = forwarded.uiAction;
+    if (typeof action === "string") {
+      throw invalid("invalid_ui_action", action);
+    }
+    const turn = action !== void 0 ? {
+      text: (0, import_genui3.uiActionText)(action),
+      media: [],
+      staged: [],
+      dropped: []
+    } : (0, import_ag_ui.readUserTurn)(input.messages);
     if (turn === null) {
       throw invalid(NO_USER_MESSAGE_CODE, "messages carries no user message to answer");
     }
@@ -6715,7 +6748,7 @@ var AgUiRunHandler = class {
     if (forwarded.regenerate === true && owner === null) {
       throw invalid("invalid_input", "regenerate needs a thread that already has an exchange");
     }
-    if (owner !== null && forwarded.regenerate !== true && turn.media.length === 0 && turn.staged.length === 0) {
+    if (owner !== null && forwarded.regenerate !== true && action === void 0 && turn.media.length === 0 && turn.staged.length === 0) {
       const decision = await this.agent.handleTextDecision(input.threadId, actor, turn.text);
       if ("proposalDecision" in decision) {
         this.writeEvents(res, [
@@ -6777,6 +6810,7 @@ var AgUiRunHandler = class {
       streamRunId: started.runId,
       streamThreadId: started.threadId,
       ...quiet,
+      ...this.a2uiFor(input),
       preamble: warningEvents(warnings)
     });
   }
@@ -6923,6 +6957,13 @@ var AgUiRunHandler = class {
     for (const event of events) res.write((0, import_ag_ui.agUiSse)(event));
     res.end();
   }
+  /** A2UI for this request's client: the basic catalog under the id it advertises. Off when off. */
+  a2uiFor(input) {
+    if (this.a2ui === void 0) return {};
+    return {
+      a2ui: (0, import_a2ui.negotiateA2uiCatalog)(this.a2ui, (0, import_a2ui.readAgUiA2uiCatalogIds)(input), import_a2ui.A2UI_LEGACY_BASIC_CATALOG_ID)
+    };
+  }
   /**
   * Pipe a run to the client as AG-UI 1.0 over SSE: one event per `data:` line, from `RUN_STARTED`
   * to the run's terminal event. It ends when the run stops to ask — the library run stays parked,
@@ -6964,12 +7005,13 @@ var AgUiRunHandler = class {
 function agUiAdapter(options = {}) {
   const path = (options.path ?? "ag-ui").replace(/^\/+|\/+$/g, "");
   const quietMs = options.quietMs;
+  const a2ui = options.a2ui === void 0 || options.a2ui === false ? void 0 : options.a2ui === true ? {} : options.a2ui;
   let AgUiController = class AgUiController extends AgUiRunHandler {
     static {
       __name(this, "AgUiController");
     }
-    constructor(agent, actorResolver, moduleOptions, staging) {
-      super(agent, actorResolver, moduleOptions, staging, quietMs);
+    constructor(agent, actorResolver, moduleOptions, staging, catalog) {
+      super(agent, actorResolver, moduleOptions, staging, quietMs, a2ui !== void 0 ? withCatalog(a2ui, catalog) : void 0);
     }
     run(req, res, body) {
       return this.handle(req, res, body);
@@ -6991,17 +7033,20 @@ function agUiAdapter(options = {}) {
   ], AgUiController.prototype, "run", null);
   AgUiController = _ts_decorate28([
     (0, import_common29.Controller)(),
-    _ts_param26(0, (0, import_common29.Inject)(AgentService)),
+    _ts_param26(0, (0, import_common29.Inject)(AgentService2)),
     _ts_param26(1, (0, import_common29.Inject)(import_nestjs_agent_core35.AGENT_ACTOR_RESOLVER)),
     _ts_param26(2, (0, import_common29.Inject)(import_nestjs_agent_core35.AGENT_OPTIONS)),
     _ts_param26(3, (0, import_common29.Optional)()),
     _ts_param26(3, (0, import_common29.Inject)(import_nestjs_agent_core35.AGENT_ATTACHMENT_STAGING)),
+    _ts_param26(4, (0, import_common29.Optional)()),
+    _ts_param26(4, (0, import_common29.Inject)(GENUI_CATALOG)),
     _ts_metadata26("design:type", Function),
     _ts_metadata26("design:paramtypes", [
-      typeof AgentService === "undefined" ? Object : AgentService,
+      typeof AgentService2 === "undefined" ? Object : AgentService2,
       typeof ActorResolver === "undefined" ? Object : ActorResolver,
       typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
-      typeof AttachmentStagingStore === "undefined" ? Object : AttachmentStagingStore
+      typeof AttachmentStagingStore === "undefined" ? Object : AttachmentStagingStore,
+      typeof Catalog === "undefined" ? Object : Catalog
     ])
   ], AgUiController);
   return {
@@ -7012,9 +7057,362 @@ function agUiAdapter(options = {}) {
   };
 }
 __name(agUiAdapter, "agUiAdapter");
+function withCatalog(options, catalog) {
+  if (options.catalog !== void 0 || catalog === void 0) return options;
+  return {
+    ...options,
+    catalog
+  };
+}
+__name(withCatalog, "withCatalog");
 
-// src/resolver/header-actor-resolver.ts
+// src/a2ui/a2ui.adapter.ts
+var import_nestjs_agent_core36 = require("@dudousxd/nestjs-agent-core");
+var import_a2ui2 = require("@dudousxd/nestjs-agent-core/a2ui");
+var import_ag_ui2 = require("@dudousxd/nestjs-agent-core/ag-ui");
+var import_genui4 = require("@dudousxd/nestjs-agent-core/genui");
 var import_common30 = require("@nestjs/common");
+function _ts_decorate29(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
+    r = Reflect.decorate(decorators, target, key, desc);
+  } else {
+    for (var i = decorators.length - 1; i >= 0; i--) {
+      if (d = decorators[i]) {
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+      }
+    }
+  }
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+__name(_ts_decorate29, "_ts_decorate");
+function _ts_metadata27(metadataKey, metadataValue) {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") {
+    return Reflect.metadata(metadataKey, metadataValue);
+  }
+}
+__name(_ts_metadata27, "_ts_metadata");
+function _ts_param27(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param27, "_ts_param");
+var A2UI_VIA = "a2ui";
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+__name(isRecord, "isRecord");
+function invalid2(code, message) {
+  return new import_common30.BadRequestException({
+    statusCode: 400,
+    code,
+    message
+  });
+}
+__name(invalid2, "invalid");
+function bodyField(body, key) {
+  if (body[key] !== void 0) return body[key];
+  return isRecord(body.metadata) ? body.metadata[key] : void 0;
+}
+__name(bodyField, "bodyField");
+function readDataModel(raw, maxBytes) {
+  if (raw === void 0) return void 0;
+  if (!isRecord(raw) || !isRecord(raw.surfaces)) {
+    return "a2uiClientDataModel carries { version, surfaces }";
+  }
+  let size;
+  try {
+    size = new TextEncoder().encode(JSON.stringify(raw.surfaces)).length;
+  } catch {
+    return "a2uiClientDataModel must be JSON";
+  }
+  if (size > maxBytes) {
+    return `a2uiClientDataModel may be at most ${maxBytes} bytes (this one is ${size})`;
+  }
+  return Object.keys(raw.surfaces).length > 0 ? raw.surfaces : void 0;
+}
+__name(readDataModel, "readDataModel");
+var A2uiRunHandler = class {
+  static {
+    __name(this, "A2uiRunHandler");
+  }
+  agent;
+  actorResolver;
+  projection;
+  quietMs;
+  maxActionBytes;
+  maxDataModelBytes;
+  constructor(agent, actorResolver, projection, quietMs, maxActionBytes, maxDataModelBytes = void 0) {
+    this.agent = agent;
+    this.actorResolver = actorResolver;
+    this.projection = projection;
+    this.quietMs = quietMs;
+    this.maxActionBytes = maxActionBytes;
+    this.maxDataModelBytes = maxDataModelBytes;
+  }
+  /**
+  * `GET <path>/a2ui/threads/:threadId`: a stored thread as `{ threadId, entries }`
+  * (`a2uiThreadReplay`) — what a client draws again after a reload. Owner-scoped; a thread nobody
+  * has answers `{ entries: [] }`. `?catalog=<id>` names the client's basic catalog id.
+  */
+  async replay(req, threadId, catalog) {
+    const actor = await this.actorResolver.resolve(req);
+    const owner = await this.agent.threadOwner(threadId);
+    if (owner === null) return {
+      threadId,
+      entries: []
+    };
+    const thread = await this.agent.getThread(actor, threadId);
+    const supported = typeof catalog === "string" ? [
+      catalog
+    ] : Array.isArray(catalog) ? catalog.filter((id) => typeof id === "string") : void 0;
+    return {
+      threadId,
+      entries: (0, import_a2ui2.a2uiThreadReplay)(thread?.messages ?? [], (0, import_a2ui2.negotiateA2uiCatalog)(this.projection, supported))
+    };
+  }
+  async handle(req, res, raw) {
+    const body = isRecord(raw) ? raw : {};
+    const agentName = typeof body.agent === "string" && body.agent.length > 0 ? body.agent : void 0;
+    const actor = await this.actorResolver.resolve(req);
+    const projection = (0, import_a2ui2.negotiateA2uiCatalog)(this.projection, (0, import_a2ui2.readA2uiClientCapabilities)(bodyField(body, "a2uiClientCapabilities")));
+    const dataModel = readDataModel(bodyField(body, "a2uiClientDataModel"), this.maxDataModelBytes ?? 32768);
+    if (typeof dataModel === "string") throw invalid2("invalid_data_model", dataModel);
+    let action;
+    if (body.action !== void 0) {
+      const read = isRecord(body.action) ? (0, import_a2ui2.readA2uiAction)(body.action, {
+        ...this.maxActionBytes !== void 0 ? {
+          maxBytes: this.maxActionBytes
+        } : {}
+      }) : "action must be an A2UI action message";
+      if (typeof read === "string") throw invalid2("invalid_action", read);
+      action = read;
+    }
+    if (action?.name === import_a2ui2.A2UI_APPROVE_ACTION || action?.name === import_a2ui2.A2UI_REJECT_ACTION) {
+      const interruptId = action.context.interruptId;
+      const address = typeof interruptId === "string" ? (0, import_ag_ui2.decodeInterruptId)(interruptId) : void 0;
+      if (address === void 0 || address === null || address.kind === "elicitation") {
+        throw invalid2("invalid_action", "an approval action carries the interruptId it decides");
+      }
+      if (address.kind === "proposal") {
+        if (address.proposalId === void 0 || address.threadId === void 0) {
+          throw invalid2("invalid_action", "the interruptId names no proposal");
+        }
+        const decided = await this.agent.decideActionProposal(actor, address.threadId, address.proposalId, {
+          decision: action.name === import_a2ui2.A2UI_APPROVE_ACTION ? "approved" : "rejected",
+          via: A2UI_VIA
+        });
+        this.writeHead(res, {
+          "X-Agent-Thread-Id": address.threadId
+        });
+        const projector = new import_a2ui2.A2uiProjector(projection);
+        const messageId = `proposal-${address.proposalId}`;
+        for (const event of [
+          {
+            type: "TEXT_MESSAGE_START",
+            messageId,
+            role: "assistant"
+          },
+          {
+            type: "TEXT_MESSAGE_CONTENT",
+            messageId,
+            delta: decided.text
+          }
+        ]) {
+          for (const message2 of projector.project(event)) res.write(`${JSON.stringify(message2)}
+`);
+        }
+        res.end();
+        return;
+      }
+      await this.agent.assertResumable(actor, address.stream);
+      await this.agent.checkDecision(actor, address.toolCallId);
+      if (action.name === import_a2ui2.A2UI_APPROVE_ACTION) {
+        await this.agent.approve(actor, address.toolCallId, {
+          via: A2UI_VIA
+        });
+      } else {
+        await this.agent.reject(actor, address.toolCallId, void 0, {
+          via: A2UI_VIA
+        });
+      }
+      await this.stream(res, address.stream, {
+        skip: address.position,
+        answered: [
+          address.toolCallId
+        ],
+        projection
+      });
+      return;
+    }
+    const message = typeof body.message === "string" ? body.message : "";
+    const text = action !== void 0 ? (0, import_genui4.uiActionText)(action) : message;
+    if (text.trim().length === 0) {
+      throw invalid2("no_user_message", "send a message or an action");
+    }
+    const threadId = typeof body.threadId === "string" && body.threadId.length > 0 ? body.threadId : void 0;
+    const owner = threadId !== void 0 ? await this.agent.threadOwner(threadId) : null;
+    if (owner !== null && owner !== actor.id) {
+      throw new import_common30.ForbiddenException("thread belongs to another actor");
+    }
+    let uiCapabilities;
+    if (Object.hasOwn(body, "uiCapabilities")) {
+      try {
+        uiCapabilities = (0, import_genui4.validateUiCapabilities)(body.uiCapabilities);
+      } catch (error) {
+        throw invalid2("invalid_input", error.message);
+      }
+    }
+    const started = await this.agent.chat({
+      actor,
+      message: text,
+      ...threadId === void 0 ? {} : owner !== null ? {
+        threadId
+      } : {
+        newThreadId: threadId
+      },
+      ...agentName !== void 0 ? {
+        agentName
+      } : {},
+      ...uiCapabilities !== void 0 ? {
+        uiCapabilities
+      } : {},
+      ...dataModel !== void 0 ? {
+        pageContext: {
+          a2uiDataModel: dataModel
+        }
+      } : {}
+    });
+    await this.stream(res, started.runId, {
+      threadId: started.threadId,
+      projection
+    });
+  }
+  /** Open the JSON Lines response. */
+  writeHead(res, extra) {
+    res.status(200);
+    res.setHeader("Content-Type", "application/jsonl; charset=utf-8");
+    res.setHeader("Cache-Control", "no-cache, no-transform");
+    res.setHeader("Connection", "keep-alive");
+    res.setHeader("X-Accel-Buffering", "no");
+    for (const [name, value] of Object.entries(extra)) res.setHeader(name, value);
+    res.flushHeaders();
+  }
+  /** Write one run as A2UI JSON Lines, until it ends or stops to ask. */
+  async stream(res, runId, options) {
+    this.writeHead(res, {
+      "X-Agent-Run-Id": runId,
+      ...options.threadId !== void 0 ? {
+        "X-Agent-Thread-Id": options.threadId
+      } : {}
+    });
+    const projector = new import_a2ui2.A2uiProjector(options.projection ?? this.projection);
+    const write = /* @__PURE__ */ __name((messages) => {
+      for (const message of messages) res.write(`${JSON.stringify(message)}
+`);
+    }, "write");
+    try {
+      const frames = (0, import_ag_ui2.agUiFramesFromNdjson)(this.agent.subscribe(runId));
+      for await (const event of (0, import_ag_ui2.agUiEvents)(frames, {
+        threadId: options.threadId ?? runId,
+        runId,
+        streamRunId: runId,
+        ...options.threadId !== void 0 ? {
+          streamThreadId: options.threadId
+        } : {},
+        ...options.skip !== void 0 ? {
+          skip: options.skip
+        } : {},
+        ...options.answered !== void 0 ? {
+          answered: options.answered
+        } : {},
+        ...this.quietMs !== void 0 ? {
+          quietMs: this.quietMs
+        } : {}
+      })) {
+        write(projector.project(event));
+      }
+    } catch {
+      write(projector.project({
+        type: "RUN_ERROR",
+        message: "The run could not be followed."
+      }));
+    }
+    res.end();
+  }
+};
+function a2uiAdapter(options = {}) {
+  const path = (options.path ?? "a2ui").replace(/^\/+|\/+$/g, "");
+  const { path: _path, quietMs, maxActionBytes, maxDataModelBytes, ...projection } = options;
+  let A2uiController = class A2uiController extends A2uiRunHandler {
+    static {
+      __name(this, "A2uiController");
+    }
+    constructor(agent, actorResolver, catalog) {
+      super(agent, actorResolver, projection.catalog === void 0 && catalog !== void 0 ? {
+        ...projection,
+        catalog
+      } : projection, quietMs, maxActionBytes, maxDataModelBytes);
+    }
+    thread(req, threadId, catalog) {
+      return this.replay(req, threadId, catalog);
+    }
+    run(req, res, body) {
+      return this.handle(req, res, body);
+    }
+  };
+  _ts_decorate29([
+    (0, import_common30.Get)(`${path}/threads/:threadId`),
+    _ts_param27(0, (0, import_common30.Req)()),
+    _ts_param27(1, (0, import_common30.Param)("threadId")),
+    _ts_param27(2, (0, import_common30.Query)("catalog")),
+    _ts_metadata27("design:type", Function),
+    _ts_metadata27("design:paramtypes", [
+      typeof Request === "undefined" ? Object : Request,
+      String,
+      Object
+    ]),
+    _ts_metadata27("design:returntype", typeof ReturnType === "undefined" ? Object : ReturnType)
+  ], A2uiController.prototype, "thread", null);
+  _ts_decorate29([
+    (0, import_common30.Post)(path),
+    (0, import_common30.HttpCode)(200),
+    _ts_param27(0, (0, import_common30.Req)()),
+    _ts_param27(1, (0, import_common30.Res)()),
+    _ts_param27(2, (0, import_common30.Body)()),
+    _ts_metadata27("design:type", Function),
+    _ts_metadata27("design:paramtypes", [
+      typeof Request === "undefined" ? Object : Request,
+      typeof Response === "undefined" ? Object : Response,
+      Object
+    ]),
+    _ts_metadata27("design:returntype", typeof Promise === "undefined" ? Object : Promise)
+  ], A2uiController.prototype, "run", null);
+  A2uiController = _ts_decorate29([
+    (0, import_common30.Controller)(),
+    _ts_param27(0, (0, import_common30.Inject)(AGENT_SERVICE)),
+    _ts_param27(1, (0, import_common30.Inject)(import_nestjs_agent_core36.AGENT_ACTOR_RESOLVER)),
+    _ts_param27(2, (0, import_common30.Optional)()),
+    _ts_param27(2, (0, import_common30.Inject)(GENUI_CATALOG)),
+    _ts_metadata27("design:type", Function),
+    _ts_metadata27("design:paramtypes", [
+      typeof AgentService === "undefined" ? Object : AgentService,
+      typeof ActorResolver === "undefined" ? Object : ActorResolver,
+      typeof Catalog === "undefined" ? Object : Catalog
+    ])
+  ], A2uiController);
+  return {
+    name: "a2ui",
+    controllers: [
+      A2uiController
+    ]
+  };
+}
+__name(a2uiAdapter, "a2uiAdapter");
+
+// src/resolver/header-actor-resolver.ts
+var import_common31 = require("@nestjs/common");
 function readHeader(req, name) {
   if (typeof req !== "object" || req === null || !("headers" in req)) return void 0;
   const { headers } = req;
@@ -7030,7 +7428,7 @@ var HeaderActorResolver = class {
   resolve(req) {
     const id = readHeader(req, "x-actor-id");
     if (id === void 0 || id.length === 0) {
-      throw new import_common30.UnauthorizedException("HeaderActorResolver: missing x-actor-id header. No default actor is fabricated. Send x-actor-id from a trusted gateway, or configure AgentModule.forRoot({ actorResolver }) with a resolver that reads your authenticated principal.");
+      throw new import_common31.UnauthorizedException("HeaderActorResolver: missing x-actor-id header. No default actor is fabricated. Send x-actor-id from a trusted gateway, or configure AgentModule.forRoot({ actorResolver }) with a resolver that reads your authenticated principal.");
     }
     const roles = (readHeader(req, "x-actor-role") ?? "").split(",").map((role) => role.trim()).filter((role) => role.length > 0);
     const tenantRef = readHeader(req, "x-tenant-ref");
@@ -7045,7 +7443,7 @@ var HeaderActorResolver = class {
 };
 
 // src/resolver/request-user-actor-resolver.ts
-var import_common31 = require("@nestjs/common");
+var import_common32 = require("@nestjs/common");
 function field(user, ...names) {
   for (const name of names) {
     const value = user[name];
@@ -7057,7 +7455,7 @@ __name(field, "field");
 function defaultRequestUserMapper(user) {
   const id = field(user, "id", "sub", "_id", "userId");
   if (id === void 0) {
-    throw new import_common31.UnauthorizedException("requestUserActorResolver: req.user has no id/sub/_id/userId \u2014 pass a mapper: requestUserActorResolver((user) => ({ id: \u2026, roles: \u2026 }))");
+    throw new import_common32.UnauthorizedException("requestUserActorResolver: req.user has no id/sub/_id/userId \u2014 pass a mapper: requestUserActorResolver((user) => ({ id: \u2026, roles: \u2026 }))");
   }
   const rawRoles = field(user, "roles", "role");
   const roles = Array.isArray(rawRoles) ? rawRoles.map(String) : typeof rawRoles === "string" ? [
@@ -7078,7 +7476,7 @@ function requestUserActorResolver(map) {
     async resolve(req) {
       const user = typeof req === "object" && req !== null ? req.user : void 0;
       if (user === void 0 || user === null || user === false) {
-        throw new import_common31.UnauthorizedException("Sign in to use the agent.");
+        throw new import_common32.UnauthorizedException("Sign in to use the agent.");
       }
       if (map !== void 0) return map(user, req);
       return defaultRequestUserMapper(user);
@@ -7091,8 +7489,10 @@ __name(requestUserActorResolver, "requestUserActorResolver");
 __reExport(index_exports, require("@dudousxd/nestjs-agent-core"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  A2uiRunHandler,
   AGENT_CHAT_QUEUE,
   AGENT_METADATA,
+  AGENT_SERVICE,
   AGENT_TOOL_BRAND,
   AI_TOOL_METADATA,
   ATTACHMENT_PAGE_SIZE,
@@ -7134,6 +7534,7 @@ __reExport(index_exports, require("@dudousxd/nestjs-agent-core"), module.exports
   SystemPrompt,
   SystemPromptContributor,
   ToolsController,
+  a2uiAdapter,
   agUiAdapter,
   attachmentLimits,
   declaredSkillProvider,