@dudousxd/nestjs-agent 1.31.0 → 1.32.0

package/dist/durable/index.d.cts

@@ -1,11 +1,11 @@
 import { AgentStore, AgentRunInput, AgentLoopResult, LlmStepEnvelope, BufferedModelTurnResult, ToolStepEnvelope, AgentRunner, TokenStreamSink, AgentRunStartOptions, HumanReply } from '@dudousxd/nestjs-agent-core';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { RunGateway, WorkflowCtx } from '@dudousxd/nestjs-durable-core';
-import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-ZwQ9p-Ps.cjs';
+import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-QIuTS-5c.cjs';
 import { DynamicModule } from '@nestjs/common';
 import '@dudousxd/nestjs-agent-core/genui';
 import '@standard-schema/spec';
-import '../agent-genui.module-D0X3YnzO.cjs';
+import '../genui/index.cjs';
 
 /**
  * The agent turn AS a durable workflow. Persist/stream checkpoints are `ctx.localStep`s — the

package/dist/durable/index.d.ts

@@ -1,11 +1,11 @@
 import { AgentStore, AgentRunInput, AgentLoopResult, LlmStepEnvelope, BufferedModelTurnResult, ToolStepEnvelope, AgentRunner, TokenStreamSink, AgentRunStartOptions, HumanReply } from '@dudousxd/nestjs-agent-core';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { RunGateway, WorkflowCtx } from '@dudousxd/nestjs-durable-core';
-import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-Bdz43pAC.js';
+import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-wNWaoUN8.js';
 import { DynamicModule } from '@nestjs/common';
 import '@dudousxd/nestjs-agent-core/genui';
 import '@standard-schema/spec';
-import '../agent-genui.module-D0X3YnzO.js';
+import '../genui/index.js';
 
 /**
  * The agent turn AS a durable workflow. Persist/stream checkpoints are `ctx.localStep`s — the

package/dist/durable/index.js

@@ -93,7 +93,7 @@ var AGENT_CHAT_QUEUE = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:chat-q
 // src/durable/agent-run.steps.ts
 import { createNegotiatedUiCollector } from "@dudousxd/nestjs-agent-core";
 import { prepareActionProposal, resolveActionProposalApproval } from "@dudousxd/nestjs-agent-core";
-import { AGENT_DEPS_FACTORY, createFrameBuffer, createNoopEmitUi, encodeStreamEvent, intersectAllowLists, invokeWithTransientRetry, isControlFlowSignal, isReplayIntegrityError, observeTurnFrames, previewToolInputs, publishAgentToolRetry, registryInputPreviews, stampToolKinds, toolCallContext, traceLlmTurn, traceToolExecution, withAskTool, withMemoryTool, withSkillTool, withToolTimeout, withTurnFrames, wrapToolPreflightDenied, wrapToolStepOutput } from "@dudousxd/nestjs-agent-core";
+import { AGENT_DEPS_FACTORY, createFrameBuffer, createNoopEmitUi, encodeStreamEvent, intersectAllowLists, invokeWithTransientRetry, isControlFlowSignal, isReplayIntegrityError, observeTurnFrames, previewToolInputs, publishAgentToolRetry, registryInputPreviews, stampToolKinds, toolCallContext, traceLlmTurn, traceToolExecution, withAskTool, withChannelDelivery, withMemoryTool, withSkillTool, withToolTimeout, withTurnFrames, wrapToolPreflightDenied, wrapToolStepOutput } from "@dudousxd/nestjs-agent-core";
 import { turnChannel } from "@dudousxd/nestjs-agent-core/genui";
 import { Step } from "@dudousxd/nestjs-durable";
 import { Inject, Injectable } from "@nestjs/common";
@@ -353,6 +353,7 @@ var AgentRunSteps = class {
       }
       throw error;
     }
+    output = await withChannelDelivery(deps, input.ctx, output, ui.components());
     return input.collectUi === true ? wrapToolStepOutput(output, ui.components(), ui.text()) : output;
   }
 };
@@ -1254,7 +1255,7 @@ import { Global as Global2, Logger as Logger10, Module as Module3 } from "@nestj
 import { DiscoveryModule, ModulesContainer, RouterModule } from "@nestjs/core";
 
 // src/agent-deps.factory.ts
-import { assertIndependentActionCapabilities } from "@dudousxd/nestjs-agent-core";
+import { assertIndependentActionCapabilities, createToolUiChannelGuide } from "@dudousxd/nestjs-agent-core";
 import { AGENT_MEMORY, AGENT_MODEL, AGENT_PRICING_STORE, AGENT_PROMPT_CONTRIBUTORS, AGENT_REGISTRY, AGENT_ROLES_POLICY, AGENT_SINK as AGENT_SINK2, AGENT_SKILLS, AGENT_STORE as AGENT_STORE3, AGENT_TOOL_REGISTRY, AgentRegistry as AgentRegistry2, ToolRegistry as ToolRegistry2, findPersona, intersectAllowLists as intersectAllowLists2, normalizeDelegation, personaCatalogEntry, resolvePersonaAlias, summarizeWithModel, windowHistory } from "@dudousxd/nestjs-agent-core";
 import { AGENT_OPTIONS } from "@dudousxd/nestjs-agent-core";
 import { BadRequestException, Inject as Inject5, Injectable as Injectable4, Optional as Optional3 } from "@nestjs/common";
@@ -1289,7 +1290,7 @@ __name(provideAgentTools, "provideAgentTools");
 
 // src/genui/agent-genui.token.ts
 var AGENT_GENUI = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:genui");
-var AgentGenui = class {
+var AgentGenui2 = class {
   static {
     __name(this, "AgentGenui");
   }
@@ -1350,8 +1351,9 @@ function mergeSandboxClients(clients) {
   for (const client of clients) {
     const one = client();
     merged.theme ||= one.theme;
-    if (one.tailwind !== void 0) merged.tailwind ??= one.tailwind;
     if (one.kit !== void 0) merged.kit ??= one.kit;
+    if (one.css !== void 0) merged.css ??= one.css;
+    if (one.tailwind !== void 0) merged.tailwind ??= one.tailwind;
   }
   return merged;
 }
@@ -1374,7 +1376,7 @@ async function resolveGenui(options) {
   }, "resolveSandbox");
   const sandbox = await resolveSandbox(asked);
   const own = options.catalog?.components.find((each) => sandboxPolicyOf(each) !== void 0);
-  const ownOptions = asked === void 0 && own?.sandboxOptions !== void 0 && (own.sandboxView?.kit === true || own.sandboxView?.tailwind === true) ? await resolveSandbox({
+  const ownOptions = asked === void 0 && own?.sandboxOptions !== void 0 && own.sandboxView?.kit === true ? await resolveSandbox({
     ...own.sandboxOptions,
     name: own.name
   }) : void 0;
@@ -1459,7 +1461,7 @@ function coreProviders(resolver) {
     },
     {
       provide: AGENT_GENUI,
-      useFactory: /* @__PURE__ */ __name((options, catalog, resolved, resolverInstance) => new AgentGenui(catalog, perRequest(resolverInstance), resolved.channels, {
+      useFactory: /* @__PURE__ */ __name((options, catalog, resolved, resolverInstance) => new AgentGenui2(catalog, perRequest(resolverInstance), resolved.channels, {
         ...options.mode !== void 0 ? {
           mode: options.mode
         } : {},
@@ -1595,7 +1597,8 @@ var AgentDepsFactory2 = class {
   memory;
   uiCatalog;
   uiCatalogResolver;
-  constructor(options, model, store, sink, rolesPolicy, registry, agents, promptContributors, pricingStore, skills, memory, uiCatalog, uiCatalogResolver) {
+  genui;
+  constructor(options, model, store, sink, rolesPolicy, registry, agents, promptContributors, pricingStore, skills, memory, uiCatalog, uiCatalogResolver, genui) {
     this.options = options;
     this.model = model;
     this.store = store;
@@ -1609,6 +1612,7 @@ var AgentDepsFactory2 = class {
     this.memory = memory;
     this.uiCatalog = uiCatalog;
     this.uiCatalogResolver = uiCatalogResolver;
+    this.genui = genui;
     if (options.actionApprovalMode === "independent") assertIndependentActionCapabilities(store, options.backgroundActorResolver);
   }
   /** The turn's memory seam, shared with the read-back endpoint. Undefined → memory is not configured. */
@@ -1710,6 +1714,30 @@ var AgentDepsFactory2 = class {
     }
     return deps;
   }
+  /** The turn's UI catalog: the per-request resolver's, else the app's. */
+  resolveUiCatalog = /* @__PURE__ */ __name((scope) => {
+    const catalog = this.uiCatalogResolver?.resolve({
+      ...scope,
+      ...scope.actor.tenantRef !== void 0 ? {
+        tenant: scope.actor.tenantRef
+      } : {}
+    }) ?? this.uiCatalog;
+    if (!catalog) throw new Error("UI catalog unavailable");
+    return catalog;
+  }, "resolveUiCatalog");
+  #uiChannelGuide;
+  /** genui `channels`: what the model is told per channel. Built once; `undefined` without channels. */
+  uiChannelGuide() {
+    if (this.#uiChannelGuide === void 0) {
+      const channels = this.genui?.channels;
+      this.#uiChannelGuide = channels === void 0 || this.uiCatalog === void 0 && this.uiCatalogResolver === void 0 ? null : createToolUiChannelGuide({
+        channels,
+        base: this.genui?.base ?? {},
+        resolveCatalog: this.resolveUiCatalog
+      });
+    }
+    return this.#uiChannelGuide ?? void 0;
+  }
   forAgent(agentName) {
     const name = agentName ?? this.defaultAgentName();
     if (agentName !== void 0 && !this.agents.has(agentName)) {
@@ -1725,6 +1753,7 @@ var AgentDepsFactory2 = class {
     const retrieval = this.options.retrieval;
     const historyPolicy = this.historyPolicy(definition);
     const ask = definition?.ask ?? this.options.ask;
+    const uiChannelGuide = this.uiChannelGuide();
     return {
       model: this.model,
       store: this.store,
@@ -1738,16 +1767,10 @@ var AgentDepsFactory2 = class {
       } : {},
       registry: this.registry,
       ...this.uiCatalog !== void 0 || this.uiCatalogResolver !== void 0 ? {
-        resolveUiCatalog: /* @__PURE__ */ __name((scope) => {
-          const catalog = this.uiCatalogResolver?.resolve({
-            ...scope,
-            ...scope.actor.tenantRef !== void 0 ? {
-              tenant: scope.actor.tenantRef
-            } : {}
-          }) ?? this.uiCatalog;
-          if (!catalog) throw new Error("UI catalog unavailable");
-          return catalog;
-        }, "resolveUiCatalog")
+        resolveUiCatalog: this.resolveUiCatalog
+      } : {},
+      ...uiChannelGuide !== void 0 ? {
+        uiChannelGuide
       } : {},
       promptContributors: this.promptContributors,
       systemPrompt: definition?.systemPrompt ?? this.options.systemPrompt ?? "You are a helpful assistant.",
@@ -1918,6 +1941,8 @@ AgentDepsFactory2 = _ts_decorate6([
   _ts_param4(11, Optional3()),
   _ts_param4(11, Inject5(GENUI_CATALOG)),
   _ts_param4(12, Optional3()),
+  _ts_param4(13, Optional3()),
+  _ts_param4(13, Inject5(AGENT_GENUI)),
   _ts_metadata4("design:type", Function),
   _ts_metadata4("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -1932,7 +1957,8 @@ AgentDepsFactory2 = _ts_decorate6([
     Object,
     Object,
     typeof Catalog === "undefined" ? Object : Catalog,
-    typeof GenuiCatalogResolver === "undefined" ? Object : GenuiCatalogResolver
+    typeof GenuiCatalogResolver === "undefined" ? Object : GenuiCatalogResolver,
+    typeof AgentGenui === "undefined" ? Object : AgentGenui
   ])
 ], AgentDepsFactory2);