@dudousxd/nestjs-agent 1.31.0 → 1.31.1

package/dist/genui/index.d.cts

@@ -1,8 +1,7 @@
-export { A as AgentGenuiModule, a as AgentGenuiModuleAsyncOptions, b as AgentGenuiModuleOptions, c as AgentGenuiOptions, d as AgentGenuiSandboxKitOptions, e as GENUI_CATALOG, f as GENUI_OPTIONS, G as GenuiCatalogResolver, I as InjectGenuiCatalog } from '../agent-genui.module-D0X3YnzO.cjs';
-import { Catalog, GenuiCatalogScope, GenuiChannels, GenuiChannelBase, SandboxClientConfig } from '@dudousxd/nestjs-agent-core/genui';
+import { ToolPresentation } from '@dudousxd/nestjs-agent-core';
+import { Catalog, GenuiCatalogScope, GenuiChannels, GenuiChannelBase, SandboxClientConfig, TreeSchemaMode, GenuiStreaming, TreeLimits, DefineSandboxOptions } from '@dudousxd/nestjs-agent-core/genui';
 export * from '@dudousxd/nestjs-agent-core/genui';
-import '@dudousxd/nestjs-agent-core';
-import '@nestjs/common';
+import { Type, DynamicModule, ModuleMetadata, FactoryProvider } from '@nestjs/common';
 
 /**
  * The app's genui setup ({@link AgentGenui}): the catalog, the per-channel options and what the
@@ -32,4 +31,146 @@ declare class AgentGenui {
     sandboxClient?: (() => SandboxClientConfig) | undefined);
 }
 
-export { AGENT_GENUI, AgentGenui };
+/** The app's genui catalog — `@InjectGenuiCatalog()` it anywhere; `overrideProvider` it in tests. */
+declare const GENUI_CATALOG: unique symbol;
+/** The resolved {@link AgentGenuiOptions} (without the resolver). */
+declare const GENUI_OPTIONS: unique symbol;
+/** Inject the app's genui catalog ({@link GENUI_CATALOG}). */
+declare const InjectGenuiCatalog: () => ParameterDecorator & PropertyDecorator;
+/**
+ * Picks the catalog for ONE request — a tenant's own, versioned components. Consulted when a genui
+ * call is validated and when the turn's tool list is described to the model, so components can
+ * change without rebuilding tools at boot. Cache in here if resolving costs a round trip: it runs
+ * once per turn per genui tool, and once per call.
+ *
+ * Provide it through `AgentGenuiModule.forRoot({ resolver })` (a class, resolved with DI, or an
+ * instance); it is then injectable, and replaceable in a test with
+ * `overrideProvider(GenuiCatalogResolver)`.
+ */
+declare abstract class GenuiCatalogResolver {
+    abstract resolve(scope: GenuiCatalogScope): Catalog | Promise<Catalog>;
+}
+/** What {@link AgentGenuiModule} builds tools from. */
+interface AgentGenuiOptions {
+    /**
+     * The catalog. With a {@link GenuiCatalogResolver} it is the boot-time one — it names the
+     * per-component tools — and may be empty. Default: an empty catalog.
+     */
+    catalog?: Catalog;
+    /**
+     * `tree` (default): one `ui__render` tool taking a composed tree (a single node is pushed as that
+     * component). `per-component`: one `ui__show_<snake>` tool per component.
+     */
+    mode?: 'per-component' | 'tree';
+    /** `ui__render`'s input schema: `'strict'` (default, a `$defs` union per component) or `'loose'`. */
+    treeSchema?: TreeSchemaMode;
+    /**
+     * Tree mode: `'complete'` (default) draws the tree once the call has run; `'partial'` streams it
+     * as `partial` ui frames while the model writes it. A component's own `streaming` overrides it.
+     */
+    streaming?: GenuiStreaming;
+    /** Least time between two partial tree frames of one call, in ms. Default 100. */
+    streamingThrottleMs?: number;
+    /** End the model's turn once a genui call succeeds (no narrating follow-up call). */
+    terminal?: boolean;
+    /** Tool name in `tree` mode. Default `ui__render`. */
+    treeToolName?: string;
+    /** Text prepended to the tree tool's description. */
+    treeInstructions?: string;
+    treeLimits?: TreeLimits;
+    /**
+     * Tree mode: components that ALSO get a flat tool whose input IS their props —
+     * `componentTools: ['Sandbox']` adds `ui__sandbox`, so a model writing a big component on its own
+     * has no `{ type, props }` envelope to leave out.
+     */
+    componentTools?: readonly string[];
+    /** Tool-name prefix for `componentTools`. Default `ui__` (`Sandbox` → `ui__sandbox`). */
+    componentToolPrefix?: string;
+    /** Tool-name prefix in `per-component` mode. Default `ui__show_`. */
+    namePrefix?: string;
+    /**
+     * Also register ONE generic tool taking `{ component, props }`, validated against the request's
+     * catalog — how a model reaches a tenant's own components, which no boot-time tool names. `true`
+     * names it `ui__show`.
+     */
+    showTool?: boolean | string;
+    /** Text prepended to the show tool's description. */
+    showInstructions?: string;
+    /** Roles allowed to call the tools. Undefined → the roles policy default. */
+    roles?: string[];
+    /** Override the generated presentation per component (or per tree / show tool name). */
+    presentation?: (component: string) => ToolPresentation | undefined;
+    /**
+     * Add the sandbox component (`Sandbox`): the model may write HTML, CSS and JS for a one-off
+     * interactive answer when no catalog component fits. `true` for the defaults (no network), or
+     * the {@link DefineSandboxOptions} (a policy listing origins, extra instructions). Off by default.
+     * The browser's catalog should carry the same definition (`defineSandbox(...)` in the shared
+     * catalog file) so the renderer enforces the same policy.
+     *
+     * `theme` (default on), `tailwind` and `kit` put the app's design system in the frame. `kit: true`
+     * (and the theme's variable names) are found through `sandboxKit`: the descriptor
+     * `genuiSandboxKit()` (`@dudousxd/nestjs-agent/vite`) writes in dev, the Vite manifest in
+     * production — and `GET <base>/config` tells the renderer where the assets are.
+     */
+    sandbox?: boolean | DefineSandboxOptions;
+    /**
+     * Per-channel generative UI: each entry sets the mode, streaming, sandbox and rendering of one
+     * channel (`web`, `mobile`, `whatsapp`, `telegram`, `email`, or `default` for the rest), over the
+     * top-level options. A text channel (`@dudousxd/nestjs-agent-channels`) configured here draws the
+     * components natively (reply buttons, lists, images). Omitted → every channel is served by the
+     * top-level options, as before.
+     */
+    channels?: GenuiChannels;
+    /**
+     * Where the sandbox kit is found (with `sandbox: { kit: true }`, `tailwind: true` or the theme's
+     * names). No Vite runs in the Nest process, so: the descriptor the dev plugin writes, else the
+     * production Vite manifest (read first when `NODE_ENV=production`).
+     */
+    sandboxKit?: AgentGenuiSandboxKitOptions;
+}
+/** {@link AgentGenuiOptions.sandboxKit}. Relative paths resolve against `root`. */
+interface AgentGenuiSandboxKitOptions {
+    /** Default `process.cwd()`. */
+    root?: string;
+    /** The dev descriptor `genuiSandboxKit()` writes. Default `.genui/sandbox-kit.json`. */
+    descriptor?: string;
+    /**
+     * The production Vite manifest, and the directory its `file`s are relative to. Default
+     * `{ file: 'public/.vite/manifest.json', outDir: 'public' }`; `false` → none.
+     */
+    manifest?: {
+        file: string;
+        outDir: string;
+    } | false;
+    /** An explicit kit url (an SPA served from elsewhere), over what is found. */
+    kitUrl?: string;
+    /** Read the manifest first. Default: `NODE_ENV === 'production'`. */
+    production?: boolean;
+}
+type ResolverOption = Type<GenuiCatalogResolver> | GenuiCatalogResolver;
+interface AgentGenuiModuleOptions extends AgentGenuiOptions {
+    /** Per-request catalogs. A class is instantiated with DI (its dependencies must be global or exported to the root). */
+    resolver?: ResolverOption;
+}
+interface AgentGenuiModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    inject?: FactoryProvider['inject'];
+    useFactory: (...deps: any[]) => AgentGenuiOptions | Promise<AgentGenuiOptions>;
+    /** Per-request catalogs. A class resolves its dependencies from `imports`. */
+    resolver?: ResolverOption;
+}
+/**
+ * Generative UI for the agent: registers the tools that let the model push catalog components
+ * (one `ui__render` tree tool, or `ui__show_<component>` per component, and/or the generic
+ * `ui__show`), and makes the catalog
+ * injectable. Global, like `AgentModule`; import it once, next to it.
+ *
+ * ```ts
+ * AgentGenuiModule.forRoot({ catalog, mode: 'tree', terminal: true })
+ * ```
+ */
+declare class AgentGenuiModule {
+    static forRoot(options?: AgentGenuiModuleOptions): DynamicModule;
+    static forRootAsync(options: AgentGenuiModuleAsyncOptions): DynamicModule;
+}
+
+export { AGENT_GENUI, AgentGenui, AgentGenuiModule, type AgentGenuiModuleAsyncOptions, type AgentGenuiModuleOptions, type AgentGenuiOptions, type AgentGenuiSandboxKitOptions, GENUI_CATALOG, GENUI_OPTIONS, GenuiCatalogResolver, InjectGenuiCatalog };

package/dist/genui/index.d.ts

@@ -1,8 +1,7 @@
-export { A as AgentGenuiModule, a as AgentGenuiModuleAsyncOptions, b as AgentGenuiModuleOptions, c as AgentGenuiOptions, d as AgentGenuiSandboxKitOptions, e as GENUI_CATALOG, f as GENUI_OPTIONS, G as GenuiCatalogResolver, I as InjectGenuiCatalog } from '../agent-genui.module-D0X3YnzO.js';
-import { Catalog, GenuiCatalogScope, GenuiChannels, GenuiChannelBase, SandboxClientConfig } from '@dudousxd/nestjs-agent-core/genui';
+import { ToolPresentation } from '@dudousxd/nestjs-agent-core';
+import { Catalog, GenuiCatalogScope, GenuiChannels, GenuiChannelBase, SandboxClientConfig, TreeSchemaMode, GenuiStreaming, TreeLimits, DefineSandboxOptions } from '@dudousxd/nestjs-agent-core/genui';
 export * from '@dudousxd/nestjs-agent-core/genui';
-import '@dudousxd/nestjs-agent-core';
-import '@nestjs/common';
+import { Type, DynamicModule, ModuleMetadata, FactoryProvider } from '@nestjs/common';
 
 /**
  * The app's genui setup ({@link AgentGenui}): the catalog, the per-channel options and what the
@@ -32,4 +31,146 @@ declare class AgentGenui {
     sandboxClient?: (() => SandboxClientConfig) | undefined);
 }
 
-export { AGENT_GENUI, AgentGenui };
+/** The app's genui catalog — `@InjectGenuiCatalog()` it anywhere; `overrideProvider` it in tests. */
+declare const GENUI_CATALOG: unique symbol;
+/** The resolved {@link AgentGenuiOptions} (without the resolver). */
+declare const GENUI_OPTIONS: unique symbol;
+/** Inject the app's genui catalog ({@link GENUI_CATALOG}). */
+declare const InjectGenuiCatalog: () => ParameterDecorator & PropertyDecorator;
+/**
+ * Picks the catalog for ONE request — a tenant's own, versioned components. Consulted when a genui
+ * call is validated and when the turn's tool list is described to the model, so components can
+ * change without rebuilding tools at boot. Cache in here if resolving costs a round trip: it runs
+ * once per turn per genui tool, and once per call.
+ *
+ * Provide it through `AgentGenuiModule.forRoot({ resolver })` (a class, resolved with DI, or an
+ * instance); it is then injectable, and replaceable in a test with
+ * `overrideProvider(GenuiCatalogResolver)`.
+ */
+declare abstract class GenuiCatalogResolver {
+    abstract resolve(scope: GenuiCatalogScope): Catalog | Promise<Catalog>;
+}
+/** What {@link AgentGenuiModule} builds tools from. */
+interface AgentGenuiOptions {
+    /**
+     * The catalog. With a {@link GenuiCatalogResolver} it is the boot-time one — it names the
+     * per-component tools — and may be empty. Default: an empty catalog.
+     */
+    catalog?: Catalog;
+    /**
+     * `tree` (default): one `ui__render` tool taking a composed tree (a single node is pushed as that
+     * component). `per-component`: one `ui__show_<snake>` tool per component.
+     */
+    mode?: 'per-component' | 'tree';
+    /** `ui__render`'s input schema: `'strict'` (default, a `$defs` union per component) or `'loose'`. */
+    treeSchema?: TreeSchemaMode;
+    /**
+     * Tree mode: `'complete'` (default) draws the tree once the call has run; `'partial'` streams it
+     * as `partial` ui frames while the model writes it. A component's own `streaming` overrides it.
+     */
+    streaming?: GenuiStreaming;
+    /** Least time between two partial tree frames of one call, in ms. Default 100. */
+    streamingThrottleMs?: number;
+    /** End the model's turn once a genui call succeeds (no narrating follow-up call). */
+    terminal?: boolean;
+    /** Tool name in `tree` mode. Default `ui__render`. */
+    treeToolName?: string;
+    /** Text prepended to the tree tool's description. */
+    treeInstructions?: string;
+    treeLimits?: TreeLimits;
+    /**
+     * Tree mode: components that ALSO get a flat tool whose input IS their props —
+     * `componentTools: ['Sandbox']` adds `ui__sandbox`, so a model writing a big component on its own
+     * has no `{ type, props }` envelope to leave out.
+     */
+    componentTools?: readonly string[];
+    /** Tool-name prefix for `componentTools`. Default `ui__` (`Sandbox` → `ui__sandbox`). */
+    componentToolPrefix?: string;
+    /** Tool-name prefix in `per-component` mode. Default `ui__show_`. */
+    namePrefix?: string;
+    /**
+     * Also register ONE generic tool taking `{ component, props }`, validated against the request's
+     * catalog — how a model reaches a tenant's own components, which no boot-time tool names. `true`
+     * names it `ui__show`.
+     */
+    showTool?: boolean | string;
+    /** Text prepended to the show tool's description. */
+    showInstructions?: string;
+    /** Roles allowed to call the tools. Undefined → the roles policy default. */
+    roles?: string[];
+    /** Override the generated presentation per component (or per tree / show tool name). */
+    presentation?: (component: string) => ToolPresentation | undefined;
+    /**
+     * Add the sandbox component (`Sandbox`): the model may write HTML, CSS and JS for a one-off
+     * interactive answer when no catalog component fits. `true` for the defaults (no network), or
+     * the {@link DefineSandboxOptions} (a policy listing origins, extra instructions). Off by default.
+     * The browser's catalog should carry the same definition (`defineSandbox(...)` in the shared
+     * catalog file) so the renderer enforces the same policy.
+     *
+     * `theme` (default on), `tailwind` and `kit` put the app's design system in the frame. `kit: true`
+     * (and the theme's variable names) are found through `sandboxKit`: the descriptor
+     * `genuiSandboxKit()` (`@dudousxd/nestjs-agent/vite`) writes in dev, the Vite manifest in
+     * production — and `GET <base>/config` tells the renderer where the assets are.
+     */
+    sandbox?: boolean | DefineSandboxOptions;
+    /**
+     * Per-channel generative UI: each entry sets the mode, streaming, sandbox and rendering of one
+     * channel (`web`, `mobile`, `whatsapp`, `telegram`, `email`, or `default` for the rest), over the
+     * top-level options. A text channel (`@dudousxd/nestjs-agent-channels`) configured here draws the
+     * components natively (reply buttons, lists, images). Omitted → every channel is served by the
+     * top-level options, as before.
+     */
+    channels?: GenuiChannels;
+    /**
+     * Where the sandbox kit is found (with `sandbox: { kit: true }`, `tailwind: true` or the theme's
+     * names). No Vite runs in the Nest process, so: the descriptor the dev plugin writes, else the
+     * production Vite manifest (read first when `NODE_ENV=production`).
+     */
+    sandboxKit?: AgentGenuiSandboxKitOptions;
+}
+/** {@link AgentGenuiOptions.sandboxKit}. Relative paths resolve against `root`. */
+interface AgentGenuiSandboxKitOptions {
+    /** Default `process.cwd()`. */
+    root?: string;
+    /** The dev descriptor `genuiSandboxKit()` writes. Default `.genui/sandbox-kit.json`. */
+    descriptor?: string;
+    /**
+     * The production Vite manifest, and the directory its `file`s are relative to. Default
+     * `{ file: 'public/.vite/manifest.json', outDir: 'public' }`; `false` → none.
+     */
+    manifest?: {
+        file: string;
+        outDir: string;
+    } | false;
+    /** An explicit kit url (an SPA served from elsewhere), over what is found. */
+    kitUrl?: string;
+    /** Read the manifest first. Default: `NODE_ENV === 'production'`. */
+    production?: boolean;
+}
+type ResolverOption = Type<GenuiCatalogResolver> | GenuiCatalogResolver;
+interface AgentGenuiModuleOptions extends AgentGenuiOptions {
+    /** Per-request catalogs. A class is instantiated with DI (its dependencies must be global or exported to the root). */
+    resolver?: ResolverOption;
+}
+interface AgentGenuiModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    inject?: FactoryProvider['inject'];
+    useFactory: (...deps: any[]) => AgentGenuiOptions | Promise<AgentGenuiOptions>;
+    /** Per-request catalogs. A class resolves its dependencies from `imports`. */
+    resolver?: ResolverOption;
+}
+/**
+ * Generative UI for the agent: registers the tools that let the model push catalog components
+ * (one `ui__render` tree tool, or `ui__show_<component>` per component, and/or the generic
+ * `ui__show`), and makes the catalog
+ * injectable. Global, like `AgentModule`; import it once, next to it.
+ *
+ * ```ts
+ * AgentGenuiModule.forRoot({ catalog, mode: 'tree', terminal: true })
+ * ```
+ */
+declare class AgentGenuiModule {
+    static forRoot(options?: AgentGenuiModuleOptions): DynamicModule;
+    static forRootAsync(options: AgentGenuiModuleAsyncOptions): DynamicModule;
+}
+
+export { AGENT_GENUI, AgentGenui, AgentGenuiModule, type AgentGenuiModuleAsyncOptions, type AgentGenuiModuleOptions, type AgentGenuiOptions, type AgentGenuiSandboxKitOptions, GENUI_CATALOG, GENUI_OPTIONS, GenuiCatalogResolver, InjectGenuiCatalog };

package/dist/{index-BGevU_Ih.d.ts → index-DFKUTFfZ.d.ts}

@@ -2,7 +2,7 @@ import { A2uiStreamOptions, a2uiThreadReplay } from '@dudousxd/nestjs-agent-core
 import { AgentAttachmentConfig, AttachmentStagingStore, AgentStore, Actor, ListActionProposals, ActionProposalView, ActionProposalMutationView, TextActionProposalVocabulary, AgentRunner, ModelCatalog, QuotaProvider, ActionApprovalMode, MessageAttachment, QuotaReport, ModelCatalogView, AgentHostContext, AttachmentRef, PageContext, ChatQueueState, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, ActorResolver } from '@dudousxd/nestjs-agent-core';
 import { Request, Response } from 'express';
 import { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
-import { b as AgentModuleOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter } from './chat-queue.service-Bdz43pAC.js';
+import { b as AgentModuleOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter } from './chat-queue.service-wNWaoUN8.js';
 
 /** Default per-file size cap (20 MiB). */
 declare const DEFAULT_MAX_ATTACHMENT_BYTES: number;

package/dist/{index-DoCdfNrO.d.cts → index-DIFUEKPr.d.cts}

@@ -2,7 +2,7 @@ import { A2uiStreamOptions, a2uiThreadReplay } from '@dudousxd/nestjs-agent-core
 import { AgentAttachmentConfig, AttachmentStagingStore, AgentStore, Actor, ListActionProposals, ActionProposalView, ActionProposalMutationView, TextActionProposalVocabulary, AgentRunner, ModelCatalog, QuotaProvider, ActionApprovalMode, MessageAttachment, QuotaReport, ModelCatalogView, AgentHostContext, AttachmentRef, PageContext, ChatQueueState, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, ActorResolver } from '@dudousxd/nestjs-agent-core';
 import { Request, Response } from 'express';
 import { UiCapabilities } from '@dudousxd/nestjs-agent-core/genui';
-import { b as AgentModuleOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter } from './chat-queue.service-ZwQ9p-Ps.cjs';
+import { b as AgentModuleOptions, A as AgentDepsFactory, C as ChatQueueService, d as AgentProtocolAdapter } from './chat-queue.service-QIuTS-5c.cjs';
 
 /** Default per-file size cap (20 MiB). */
 declare const DEFAULT_MAX_ATTACHMENT_BYTES: number;

package/dist/index.cjs

@@ -208,7 +208,7 @@ var defineTool = import_nestjs_agent_core.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");
   }
@@ -378,7 +378,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
         } : {},
@@ -514,7 +514,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;
@@ -528,6 +529,7 @@ var AgentDepsFactory2 = class {
     this.memory = memory;
     this.uiCatalog = uiCatalog;
     this.uiCatalogResolver = uiCatalogResolver;
+    this.genui = genui;
     if (options.actionApprovalMode === "independent") (0, import_nestjs_agent_core2.assertIndependentActionCapabilities)(store, options.backgroundActorResolver);
   }
   /** The turn's memory seam, shared with the read-back endpoint. Undefined → memory is not configured. */
@@ -629,6 +631,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_core2.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)) {
@@ -644,6 +670,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,
@@ -657,16 +684,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.",
@@ -837,6 +858,8 @@ AgentDepsFactory2 = _ts_decorate2([
   _ts_param(11, (0, import_common2.Optional)()),
   _ts_param(11, (0, import_common2.Inject)(GENUI_CATALOG)),
   _ts_param(12, (0, import_common2.Optional)()),
+  _ts_param(13, (0, import_common2.Optional)()),
+  _ts_param(13, (0, import_common2.Inject)(AGENT_GENUI)),
   _ts_metadata("design:type", Function),
   _ts_metadata("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
@@ -851,7 +874,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);