@dudousxd/nestjs-agent 1.31.0 → 1.32.0

package/dist/index.d.cts

@@ -1,19 +1,18 @@
 import { DynamicModule, Type, OnApplicationBootstrap, OnModuleInit, ConflictException, OnModuleDestroy } from '@nestjs/common';
-import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, d as AgentProtocolAdapter, A as AgentDepsFactory, e as AgentSkillsOptions, C as ChatQueueService } from './chat-queue.service-ZwQ9p-Ps.cjs';
-export { f as AGENT_TOOL_BRAND, g as AgentAttachmentsOptions, h as AgentDeps, i as AgentEngine, j as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QueuePlan, k as QueueSettleOutcome, l as QueuedTurn, m as QueuedTurnStarter, n as QuotaLimits, o as QuotaWindowLimits, p as defineTool, q as delegateToolName, r as provideAgentTool, s as provideAgentTools, u as utcDay } from './chat-queue.service-ZwQ9p-Ps.cjs';
+import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, d as AgentProtocolAdapter, A as AgentDepsFactory, e as AgentSkillsOptions, C as ChatQueueService } from './chat-queue.service-QIuTS-5c.cjs';
+export { f as AGENT_TOOL_BRAND, g as AgentAttachmentsOptions, h as AgentDeps, i as AgentEngine, j as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QueuePlan, k as QueueSettleOutcome, l as QueuedTurn, m as QueuedTurnStarter, n as QuotaLimits, o as QuotaWindowLimits, p as defineTool, q as delegateToolName, r as provideAgentTool, s as provideAgentTools, u as utcDay } from './chat-queue.service-QIuTS-5c.cjs';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
 import { ActorResolver, AttachmentStagingStore, AgentApprovalPort, Actor, AgentStore, StagedAttachment, MessageAttachment, ModelCatalog, AgentClientConfig, ToolSpec, ToolPresentation, AgentHistoryWindow, AgentIntake, Persona, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, MessageFeedbackValue, MessageFeedback, ModelCatalogView, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunner, AgentRunInput, AgentRunStartOptions, HumanReply, ChatQueueState, TokenStreamSink, SinkWriter, ActionProposal } from '@dudousxd/nestjs-agent-core';
 export * from '@dudousxd/nestjs-agent-core';
 export { FunctionalToolDefinition } from '@dudousxd/nestjs-agent-core';
 import { A2uiOptions } from '@dudousxd/nestjs-agent-core/a2ui';
 import { Request, Response } from 'express';
-import { A as AgentService, a as ActionProposalService } from './index-DoCdfNrO.cjs';
-export { b as A2uiAdapterOptions, c as A2uiRunHandler, d as AttachmentLimits, C as ChatParams, e as ChatSendMode, f as ChatSendResult, D as DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, g as DEFAULT_MAX_ATTACHMENT_BYTES, M as MAX_ATTACHMENTS_PER_MESSAGE, N as NO_USER_MESSAGE_CODE, Q as QueuedSend, T as ThreadDefaultAgentReader, h as ThreadModelReader, i as a2uiAdapter, j as attachmentLimits } from './index-DoCdfNrO.cjs';
+import { A as AgentService, a as ActionProposalService } from './index-DIFUEKPr.cjs';
+export { b as A2uiAdapterOptions, c as A2uiRunHandler, d as AttachmentLimits, C as ChatParams, e as ChatSendMode, f as ChatSendResult, D as DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, g as DEFAULT_MAX_ATTACHMENT_BYTES, M as MAX_ATTACHMENTS_PER_MESSAGE, N as NO_USER_MESSAGE_CODE, Q as QueuedSend, T as ThreadDefaultAgentReader, h as ThreadModelReader, i as a2uiAdapter, j as attachmentLimits } from './index-DIFUEKPr.cjs';
 import { AgentGenui } from './genui/index.cjs';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { DiscoveryService, MetadataScanner } from '@nestjs/core';
 import '@dudousxd/nestjs-agent-core/genui';
-import './agent-genui.module-D0X3YnzO.cjs';
 
 declare class AgentModule {
     static forRoot(options: AgentModuleOptions): DynamicModule;

package/dist/index.d.ts

@@ -1,19 +1,18 @@
 import { DynamicModule, Type, OnApplicationBootstrap, OnModuleInit, ConflictException, OnModuleDestroy } from '@nestjs/common';
-import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, d as AgentProtocolAdapter, A as AgentDepsFactory, e as AgentSkillsOptions, C as ChatQueueService } from './chat-queue.service-Bdz43pAC.js';
-export { f as AGENT_TOOL_BRAND, g as AgentAttachmentsOptions, h as AgentDeps, i as AgentEngine, j as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QueuePlan, k as QueueSettleOutcome, l as QueuedTurn, m as QueuedTurnStarter, n as QuotaLimits, o as QuotaWindowLimits, p as defineTool, q as delegateToolName, r as provideAgentTool, s as provideAgentTools, u as utcDay } from './chat-queue.service-Bdz43pAC.js';
+import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, d as AgentProtocolAdapter, A as AgentDepsFactory, e as AgentSkillsOptions, C as ChatQueueService } from './chat-queue.service-wNWaoUN8.js';
+export { f as AGENT_TOOL_BRAND, g as AgentAttachmentsOptions, h as AgentDeps, i as AgentEngine, j as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QueuePlan, k as QueueSettleOutcome, l as QueuedTurn, m as QueuedTurnStarter, n as QuotaLimits, o as QuotaWindowLimits, p as defineTool, q as delegateToolName, r as provideAgentTool, s as provideAgentTools, u as utcDay } from './chat-queue.service-wNWaoUN8.js';
 import * as _dudousxd_nestjs_agent_core from '@dudousxd/nestjs-agent-core';
 import { ActorResolver, AttachmentStagingStore, AgentApprovalPort, Actor, AgentStore, StagedAttachment, MessageAttachment, ModelCatalog, AgentClientConfig, ToolSpec, ToolPresentation, AgentHistoryWindow, AgentIntake, Persona, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, MessageFeedbackValue, MessageFeedback, ModelCatalogView, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunner, AgentRunInput, AgentRunStartOptions, HumanReply, ChatQueueState, TokenStreamSink, SinkWriter, ActionProposal } from '@dudousxd/nestjs-agent-core';
 export * from '@dudousxd/nestjs-agent-core';
 export { FunctionalToolDefinition } from '@dudousxd/nestjs-agent-core';
 import { A2uiOptions } from '@dudousxd/nestjs-agent-core/a2ui';
 import { Request, Response } from 'express';
-import { A as AgentService, a as ActionProposalService } from './index-BGevU_Ih.js';
-export { b as A2uiAdapterOptions, c as A2uiRunHandler, d as AttachmentLimits, C as ChatParams, e as ChatSendMode, f as ChatSendResult, D as DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, g as DEFAULT_MAX_ATTACHMENT_BYTES, M as MAX_ATTACHMENTS_PER_MESSAGE, N as NO_USER_MESSAGE_CODE, Q as QueuedSend, T as ThreadDefaultAgentReader, h as ThreadModelReader, i as a2uiAdapter, j as attachmentLimits } from './index-BGevU_Ih.js';
+import { A as AgentService, a as ActionProposalService } from './index-DFKUTFfZ.js';
+export { b as A2uiAdapterOptions, c as A2uiRunHandler, d as AttachmentLimits, C as ChatParams, e as ChatSendMode, f as ChatSendResult, D as DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES, g as DEFAULT_MAX_ATTACHMENT_BYTES, M as MAX_ATTACHMENTS_PER_MESSAGE, N as NO_USER_MESSAGE_CODE, Q as QueuedSend, T as ThreadDefaultAgentReader, h as ThreadModelReader, i as a2uiAdapter, j as attachmentLimits } from './index-DFKUTFfZ.js';
 import { AgentGenui } from './genui/index.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { DiscoveryService, MetadataScanner } from '@nestjs/core';
 import '@dudousxd/nestjs-agent-core/genui';
-import './agent-genui.module-D0X3YnzO.js';
 
 declare class AgentModule {
     static forRoot(options: AgentModuleOptions): DynamicModule;

package/dist/index.js

@@ -65,7 +65,7 @@ import { Global, Logger as Logger8, Module as Module2 } from "@nestjs/common";
 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, AGENT_SKILLS, AGENT_STORE, AGENT_TOOL_REGISTRY, AgentRegistry as AgentRegistry2, ToolRegistry as ToolRegistry2, findPersona, intersectAllowLists, normalizeDelegation, personaCatalogEntry, resolvePersonaAlias, summarizeWithModel, windowHistory } from "@dudousxd/nestjs-agent-core";
 import { AGENT_OPTIONS } from "@dudousxd/nestjs-agent-core";
 import { BadRequestException, Inject as Inject2, Injectable, Optional } from "@nestjs/common";
@@ -116,7 +116,7 @@ var defineTool = createFunctionalTool;
 
 // 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");
   }
@@ -177,8 +177,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;
 }
@@ -201,7 +202,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;
@@ -286,7 +287,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
         } : {},
@@ -422,7 +423,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;
@@ -436,6 +438,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. */
@@ -537,6 +540,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)) {
@@ -552,6 +579,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,
@@ -565,16 +593,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.",
@@ -745,6 +767,8 @@ AgentDepsFactory2 = _ts_decorate2([
   _ts_param(11, Optional()),
   _ts_param(11, Inject2(GENUI_CATALOG)),
   _ts_param(12, Optional()),
+  _ts_param(13, Optional()),
+  _ts_param(13, Inject2(AGENT_GENUI)),
   _ts_metadata("design:type", Function),
   _ts_metadata("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -759,7 +783,8 @@ AgentDepsFactory2 = _ts_decorate2([
     Object,
     Object,
     typeof Catalog === "undefined" ? Object : Catalog,
-    typeof GenuiCatalogResolver === "undefined" ? Object : GenuiCatalogResolver
+    typeof GenuiCatalogResolver === "undefined" ? Object : GenuiCatalogResolver,
+    typeof AgentGenui === "undefined" ? Object : AgentGenui
   ])
 ], AgentDepsFactory2);