@dudousxd/nestjs-agent 1.31.0 → 1.31.1

package/dist/a2ui/index.d.cts

@@ -1,9 +1,9 @@
 export * from '@dudousxd/nestjs-agent-core/a2ui';
-export { b as A2uiAdapterOptions, c as A2uiRunHandler, i as a2uiAdapter } from '../index-DoCdfNrO.cjs';
+export { b as A2uiAdapterOptions, c as A2uiRunHandler, i as a2uiAdapter } from '../index-DIFUEKPr.cjs';
 import '@dudousxd/nestjs-agent-core';
 import 'express';
 import '@dudousxd/nestjs-agent-core/genui';
-import '../chat-queue.service-ZwQ9p-Ps.cjs';
+import '../chat-queue.service-QIuTS-5c.cjs';
 import '@standard-schema/spec';
 import '@nestjs/common';
-import '../agent-genui.module-D0X3YnzO.cjs';
+import '../genui/index.cjs';

package/dist/a2ui/index.d.ts

@@ -1,9 +1,9 @@
 export * from '@dudousxd/nestjs-agent-core/a2ui';
-export { b as A2uiAdapterOptions, c as A2uiRunHandler, i as a2uiAdapter } from '../index-BGevU_Ih.js';
+export { b as A2uiAdapterOptions, c as A2uiRunHandler, i as a2uiAdapter } from '../index-DFKUTFfZ.js';
 import '@dudousxd/nestjs-agent-core';
 import 'express';
 import '@dudousxd/nestjs-agent-core/genui';
-import '../chat-queue.service-Bdz43pAC.js';
+import '../chat-queue.service-wNWaoUN8.js';
 import '@standard-schema/spec';
 import '@nestjs/common';
-import '../agent-genui.module-D0X3YnzO.js';
+import '../genui/index.js';

package/dist/{chat-queue.service-ZwQ9p-Ps.d.cts → chat-queue.service-QIuTS-5c.d.cts}

@@ -1,12 +1,14 @@
-import { ResolveToolUiCatalog, ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, Persona, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, createFunctionalTool, QuotaProvider, QuotaQuery, QuotaReport, ActionApprovalMode, BackgroundActorResolver, ActionProposal, TextActionProposalConfig, PriceCatalogOptions, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, Actor, AttachmentStagingStore, ChatQueueStore, ChatQueueState, AgentRunner, AgentRunInput, AgentStreamEvent, QueuePauseReason } from '@dudousxd/nestjs-agent-core';
+import { ResolveToolUiCatalog, ToolUiChannelGuide, ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, Persona, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, createFunctionalTool, QuotaProvider, QuotaQuery, QuotaReport, ActionApprovalMode, BackgroundActorResolver, ActionProposal, TextActionProposalConfig, PriceCatalogOptions, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, Actor, AttachmentStagingStore, ChatQueueStore, ChatQueueState, AgentRunner, AgentRunInput, AgentStreamEvent, QueuePauseReason } from '@dudousxd/nestjs-agent-core';
 import { Catalog } from '@dudousxd/nestjs-agent-core/genui';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { Provider, InjectionToken, Type, FactoryProvider, CanActivate, ModuleMetadata, OptionalFactoryDependency } from '@nestjs/common';
-import { G as GenuiCatalogResolver } from './agent-genui.module-D0X3YnzO.cjs';
+import { GenuiCatalogResolver, AgentGenui } from './genui/index.cjs';
 
 /** Everything `runAgentLoop` needs, minus the per-run `day` the runner stamps. */
 interface AgentDeps {
     resolveUiCatalog?: ResolveToolUiCatalog;
+    /** genui `channels`: the channel's prompt block, and what tool pushes were delivered as. */
+    uiChannelGuide?: ToolUiChannelGuide;
     actionApprovalMode?: 'blocking' | 'independent';
     model: ModelProvider;
     store: AgentStore;
@@ -644,6 +646,7 @@ declare function delegateToolName(args: {
 }): string;
 /** Builds the per-agent loop deps. The single-agent case is just the one registered `@Agent`. */
 declare class AgentDepsFactory {
+    #private;
     private readonly options;
     private readonly model;
     private readonly store;
@@ -657,7 +660,8 @@ declare class AgentDepsFactory {
     private readonly memory;
     private readonly uiCatalog?;
     private readonly uiCatalogResolver?;
-    constructor(options: AgentModuleOptions, model: ModelProvider, store: AgentStore, sink: TokenStreamSink, rolesPolicy: RolesPolicy, registry: ToolRegistry, agents: AgentRegistry, promptContributors: PromptContributor[], pricingStore: AgentPricingStore | undefined, skills: SkillsConfig | undefined, memory: MemoryConfig | undefined, uiCatalog?: Catalog | undefined, uiCatalogResolver?: GenuiCatalogResolver | undefined);
+    private readonly genui?;
+    constructor(options: AgentModuleOptions, model: ModelProvider, store: AgentStore, sink: TokenStreamSink, rolesPolicy: RolesPolicy, registry: ToolRegistry, agents: AgentRegistry, promptContributors: PromptContributor[], pricingStore: AgentPricingStore | undefined, skills: SkillsConfig | undefined, memory: MemoryConfig | undefined, uiCatalog?: Catalog | undefined, uiCatalogResolver?: GenuiCatalogResolver | undefined, genui?: AgentGenui | undefined);
     /** The turn's memory seam, shared with the read-back endpoint. Undefined → memory is not configured. */
     memoryConfig(): MemoryConfig | undefined;
     /** The turn's skills seam, shared with the listing endpoint. Undefined → skills are not configured. */
@@ -691,6 +695,10 @@ declare class AgentDepsFactory {
         threadPersona?: string | null;
     }): string | undefined;
     forProposal(proposal: ActionProposal, _actor: Actor): AgentDeps;
+    /** The turn's UI catalog: the per-request resolver's, else the app's. */
+    private readonly resolveUiCatalog;
+    /** genui `channels`: what the model is told per channel. Built once; `undefined` without channels. */
+    private uiChannelGuide;
     forAgent(agentName?: string): AgentDeps;
     /**
      * A persona baked into an agent's deps — how a run journaled under an agent name that a persona

package/dist/{chat-queue.service-Bdz43pAC.d.ts → chat-queue.service-wNWaoUN8.d.ts}

@@ -1,12 +1,14 @@
-import { ResolveToolUiCatalog, ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, Persona, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, createFunctionalTool, QuotaProvider, QuotaQuery, QuotaReport, ActionApprovalMode, BackgroundActorResolver, ActionProposal, TextActionProposalConfig, PriceCatalogOptions, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, Actor, AttachmentStagingStore, ChatQueueStore, ChatQueueState, AgentRunner, AgentRunInput, AgentStreamEvent, QueuePauseReason } from '@dudousxd/nestjs-agent-core';
+import { ResolveToolUiCatalog, ToolUiChannelGuide, ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, Persona, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, createFunctionalTool, QuotaProvider, QuotaQuery, QuotaReport, ActionApprovalMode, BackgroundActorResolver, ActionProposal, TextActionProposalConfig, PriceCatalogOptions, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, Actor, AttachmentStagingStore, ChatQueueStore, ChatQueueState, AgentRunner, AgentRunInput, AgentStreamEvent, QueuePauseReason } from '@dudousxd/nestjs-agent-core';
 import { Catalog } from '@dudousxd/nestjs-agent-core/genui';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { Provider, InjectionToken, Type, FactoryProvider, CanActivate, ModuleMetadata, OptionalFactoryDependency } from '@nestjs/common';
-import { G as GenuiCatalogResolver } from './agent-genui.module-D0X3YnzO.js';
+import { GenuiCatalogResolver, AgentGenui } from './genui/index.js';
 
 /** Everything `runAgentLoop` needs, minus the per-run `day` the runner stamps. */
 interface AgentDeps {
     resolveUiCatalog?: ResolveToolUiCatalog;
+    /** genui `channels`: the channel's prompt block, and what tool pushes were delivered as. */
+    uiChannelGuide?: ToolUiChannelGuide;
     actionApprovalMode?: 'blocking' | 'independent';
     model: ModelProvider;
     store: AgentStore;
@@ -644,6 +646,7 @@ declare function delegateToolName(args: {
 }): string;
 /** Builds the per-agent loop deps. The single-agent case is just the one registered `@Agent`. */
 declare class AgentDepsFactory {
+    #private;
     private readonly options;
     private readonly model;
     private readonly store;
@@ -657,7 +660,8 @@ declare class AgentDepsFactory {
     private readonly memory;
     private readonly uiCatalog?;
     private readonly uiCatalogResolver?;
-    constructor(options: AgentModuleOptions, model: ModelProvider, store: AgentStore, sink: TokenStreamSink, rolesPolicy: RolesPolicy, registry: ToolRegistry, agents: AgentRegistry, promptContributors: PromptContributor[], pricingStore: AgentPricingStore | undefined, skills: SkillsConfig | undefined, memory: MemoryConfig | undefined, uiCatalog?: Catalog | undefined, uiCatalogResolver?: GenuiCatalogResolver | undefined);
+    private readonly genui?;
+    constructor(options: AgentModuleOptions, model: ModelProvider, store: AgentStore, sink: TokenStreamSink, rolesPolicy: RolesPolicy, registry: ToolRegistry, agents: AgentRegistry, promptContributors: PromptContributor[], pricingStore: AgentPricingStore | undefined, skills: SkillsConfig | undefined, memory: MemoryConfig | undefined, uiCatalog?: Catalog | undefined, uiCatalogResolver?: GenuiCatalogResolver | undefined, genui?: AgentGenui | undefined);
     /** The turn's memory seam, shared with the read-back endpoint. Undefined → memory is not configured. */
     memoryConfig(): MemoryConfig | undefined;
     /** The turn's skills seam, shared with the listing endpoint. Undefined → skills are not configured. */
@@ -691,6 +695,10 @@ declare class AgentDepsFactory {
         threadPersona?: string | null;
     }): string | undefined;
     forProposal(proposal: ActionProposal, _actor: Actor): AgentDeps;
+    /** The turn's UI catalog: the per-request resolver's, else the app's. */
+    private readonly resolveUiCatalog;
+    /** genui `channels`: what the model is told per channel. Built once; `undefined` without channels. */
+    private uiChannelGuide;
     forAgent(agentName?: string): AgentDeps;
     /**
      * A persona baked into an agent's deps — how a run journaled under an agent name that a persona

package/dist/durable/index.cjs

@@ -386,6 +386,7 @@ var AgentRunSteps = class {
       }
       throw error;
     }
+    output = await (0, import_nestjs_agent_core3.withChannelDelivery)(deps, input.ctx, output, ui.components());
     return input.collectUi === true ? (0, import_nestjs_agent_core3.wrapToolStepOutput)(output, ui.components(), ui.text()) : output;
   }
 };
@@ -1322,7 +1323,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");
   }
@@ -1492,7 +1493,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
         } : {},
@@ -1628,7 +1629,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;
@@ -1642,6 +1644,7 @@ var AgentDepsFactory2 = class {
     this.memory = memory;
     this.uiCatalog = uiCatalog;
     this.uiCatalogResolver = uiCatalogResolver;
+    this.genui = genui;
     if (options.actionApprovalMode === "independent") (0, import_nestjs_agent_core9.assertIndependentActionCapabilities)(store, options.backgroundActorResolver);
   }
   /** The turn's memory seam, shared with the read-back endpoint. Undefined → memory is not configured. */
@@ -1743,6 +1746,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 : (0, import_nestjs_agent_core9.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)) {
@@ -1758,6 +1785,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,
@@ -1771,16 +1799,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.",
@@ -1951,6 +1973,8 @@ AgentDepsFactory2 = _ts_decorate6([
   _ts_param4(11, (0, import_common6.Optional)()),
   _ts_param4(11, (0, import_common6.Inject)(GENUI_CATALOG)),
   _ts_param4(12, (0, import_common6.Optional)()),
+  _ts_param4(13, (0, import_common6.Optional)()),
+  _ts_param4(13, (0, import_common6.Inject)(AGENT_GENUI)),
   _ts_metadata4("design:type", Function),
   _ts_metadata4("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -1965,7 +1989,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);