@dudousxd/nestjs-agent 1.30.0 → 1.31.1

package/dist/index.d.cts

@@ -1,18 +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-Bk7DCKGV.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-Bk7DCKGV.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-D9EM7ivO.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-D9EM7ivO.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 './genui/index.cjs';
 
 declare class AgentModule {
     static forRoot(options: AgentModuleOptions): DynamicModule;
@@ -202,7 +202,8 @@ declare class ConfigController {
     private readonly actorResolver;
     private readonly staging;
     private readonly models;
-    constructor(options: AgentModuleOptions, actorResolver: ActorResolver, staging: AttachmentStagingStore | undefined, models: ModelCatalog | undefined);
+    private readonly genui;
+    constructor(options: AgentModuleOptions, actorResolver: ActorResolver, staging: AttachmentStagingStore | undefined, models: ModelCatalog | undefined, genui: AgentGenui | undefined);
     config(req: Request): Promise<AgentClientConfig>;
 }
 

package/dist/index.d.ts

@@ -1,18 +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-B-fVOJGf.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-B-fVOJGf.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-APh8WN3z.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-APh8WN3z.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 './genui/index.js';
 
 declare class AgentModule {
     static forRoot(options: AgentModuleOptions): DynamicModule;
@@ -202,7 +202,8 @@ declare class ConfigController {
     private readonly actorResolver;
     private readonly staging;
     private readonly models;
-    constructor(options: AgentModuleOptions, actorResolver: ActorResolver, staging: AttachmentStagingStore | undefined, models: ModelCatalog | undefined);
+    private readonly genui;
+    constructor(options: AgentModuleOptions, actorResolver: ActorResolver, staging: AttachmentStagingStore | undefined, models: ModelCatalog | undefined, genui: AgentGenui | undefined);
     config(req: Request): Promise<AgentClientConfig>;
 }
 

package/dist/index.js

@@ -1,5 +1,63 @@
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/vite/index.ts
+import { SANDBOX_KIT_DEV_PREFIX, SANDBOX_KIT_MANIFEST_KEYS, SANDBOX_KIT_UPDATE_EVENT, createGenuiSandboxKitPlugin } from "@dudousxd/nestjs-agent-core/genui/kit";
+var NEST_SANDBOX_KIT_DESCRIPTOR;
+var init_vite = __esm({
+  "src/vite/index.ts"() {
+    "use strict";
+    NEST_SANDBOX_KIT_DESCRIPTOR = ".genui/sandbox-kit.json";
+  }
+});
+
+// src/genui/kit.ts
+var kit_exports = {};
+__export(kit_exports, {
+  NEST_SANDBOX_KIT_MANIFEST: () => NEST_SANDBOX_KIT_MANIFEST,
+  nestSandboxKitDiscovery: () => nestSandboxKitDiscovery
+});
+import { resolve } from "path";
+import { sandboxKitDiscovery } from "@dudousxd/nestjs-agent-core/genui/kit";
+function nestSandboxKitDiscovery(options = {}) {
+  const manifest = options.manifest ?? NEST_SANDBOX_KIT_MANIFEST;
+  return sandboxKitDiscovery({
+    root: resolve(options.root ?? process.cwd()),
+    descriptor: options.descriptor ?? NEST_SANDBOX_KIT_DESCRIPTOR,
+    ...manifest !== false ? {
+      manifest: {
+        file: manifest.file,
+        outDir: manifest.outDir
+      }
+    } : {},
+    ...options.kitUrl !== void 0 ? {
+      kitUrl: options.kitUrl
+    } : {},
+    ...options.production !== void 0 ? {
+      production: options.production
+    } : {}
+  });
+}
+var NEST_SANDBOX_KIT_MANIFEST;
+var init_kit = __esm({
+  "src/genui/kit.ts"() {
+    "use strict";
+    init_vite();
+    NEST_SANDBOX_KIT_MANIFEST = Object.freeze({
+      file: "public/.vite/manifest.json",
+      outDir: "public"
+    });
+    __name(nestSandboxKitDiscovery, "nestSandboxKitDiscovery");
+  }
+});
 
 // src/agent.module.ts
 import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER14, AGENT_APPROVAL_PORT, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY7, AGENT_DURABLE_RUNNER, AGENT_MEMORY as AGENT_MEMORY3, AGENT_MODEL as AGENT_MODEL3, AGENT_MODEL_CATALOG as AGENT_MODEL_CATALOG3, AGENT_OPTIONS as AGENT_OPTIONS10, AGENT_PROMPT_CONTRIBUTORS as AGENT_PROMPT_CONTRIBUTORS3, AGENT_QUOTA_PROVIDER as AGENT_QUOTA_PROVIDER3, AGENT_REGISTRY as AGENT_REGISTRY6, AGENT_ROLES_POLICY as AGENT_ROLES_POLICY2, AGENT_RUNNER as AGENT_RUNNER2, AGENT_SINK as AGENT_SINK3, AGENT_SKILLS as AGENT_SKILLS3, AGENT_SKILL_SOURCES as AGENT_SKILL_SOURCES2, AGENT_STORE as AGENT_STORE7, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY3, AgentRegistry as AgentRegistry6, ClosedRolesPolicy, DefaultRolesPolicy, InMemoryAgentStore, ToolRegistry as ToolRegistry3 } from "@dudousxd/nestjs-agent-core";
@@ -7,13 +65,13 @@ 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";
 
 // src/genui/agent-genui.module.ts
-import { defineCatalog, defineSandbox, genuiTools } from "@dudousxd/nestjs-agent-core/genui";
+import { assertGenuiChannels, defineCatalog, defineSandbox, genuiTools, sandboxPolicyOf } from "@dudousxd/nestjs-agent-core/genui";
 import { Inject, Module } from "@nestjs/common";
 
 // src/functional-tool.ts
@@ -56,6 +114,26 @@ function provideAgentTools(factory, inject) {
 __name(provideAgentTools, "provideAgentTools");
 var defineTool = createFunctionalTool;
 
+// src/genui/agent-genui.token.ts
+var AGENT_GENUI = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:genui");
+var AgentGenui2 = class {
+  static {
+    __name(this, "AgentGenui");
+  }
+  catalog;
+  resolveCatalog;
+  channels;
+  base;
+  sandboxClient;
+  constructor(catalog, resolveCatalog2, channels, base = {}, sandboxClient) {
+    this.catalog = catalog;
+    this.resolveCatalog = resolveCatalog2;
+    this.channels = channels;
+    this.base = base;
+    this.sandboxClient = sandboxClient;
+  }
+};
+
 // src/genui/agent-genui.module.ts
 function _ts_decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -73,6 +151,7 @@ function _ts_decorate(decorators, target, key, desc) {
 __name(_ts_decorate, "_ts_decorate");
 var GENUI_CATALOG = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:genui-catalog");
 var GENUI_OPTIONS = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:genui-options");
+var GENUI_RESOLVED = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:genui-resolved");
 var GenuiCatalogResolver = class {
   static {
     __name(this, "GenuiCatalogResolver");
@@ -91,20 +170,99 @@ function resolverProviders(resolver) {
   ];
 }
 __name(resolverProviders, "resolverProviders");
-function toolOptions(options, resolver) {
-  const { catalog: _catalog, sandbox: _sandbox, ...rest } = options;
+function mergeSandboxClients(clients) {
+  const merged = {
+    theme: false
+  };
+  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;
+  }
+  return merged;
+}
+__name(mergeSandboxClients, "mergeSandboxClients");
+async function resolveGenui(options) {
+  const { sandbox: asked, channels: askedChannels } = options;
+  assertGenuiChannels(askedChannels);
+  const clients = [];
+  let discovery;
+  const resolveSandbox = /* @__PURE__ */ __name(async (value) => {
+    if (value === void 0 || value === false) return value;
+    const [{ nestSandboxKitDiscovery: nestSandboxKitDiscovery2 }, { resolveSandboxServer }] = await Promise.all([
+      Promise.resolve().then(() => (init_kit(), kit_exports)),
+      import("@dudousxd/nestjs-agent-core/genui/kit")
+    ]);
+    discovery ??= nestSandboxKitDiscovery2(options.sandboxKit);
+    const resolved = resolveSandboxServer(value, discovery);
+    clients.push(resolved.client);
+    return resolved.define;
+  }, "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({
+    ...own.sandboxOptions,
+    name: own.name
+  }) : void 0;
+  let channels;
+  if (askedChannels !== void 0) {
+    channels = {};
+    for (const [name, entry] of Object.entries(askedChannels)) {
+      if (entry === void 0) continue;
+      const own2 = await resolveSandbox(entry.sandbox);
+      channels[name] = {
+        ...entry,
+        ...own2 !== void 0 ? {
+          sandbox: own2
+        } : {}
+      };
+    }
+  }
+  return {
+    ...sandbox !== void 0 ? {
+      sandbox
+    } : {},
+    ...typeof ownOptions === "object" ? {
+      catalogSandbox: ownOptions
+    } : {},
+    ...channels !== void 0 ? {
+      channels
+    } : {},
+    ...clients.length > 0 ? {
+      sandboxClient: /* @__PURE__ */ __name(() => mergeSandboxClients(clients), "sandboxClient")
+    } : {}
+  };
+}
+__name(resolveGenui, "resolveGenui");
+function perRequest(resolver) {
+  return resolver === void 0 ? void 0 : (scope) => resolver.resolve(scope);
+}
+__name(perRequest, "perRequest");
+function toolOptions(options, resolved, resolver) {
+  const { catalog: _catalog, sandbox: _sandbox, channels: _channels, sandboxKit: _sandboxKit, ...rest } = options;
+  const resolveCatalog2 = perRequest(resolver);
   return {
     ...rest,
-    ...resolver !== void 0 ? {
-      resolveCatalog: /* @__PURE__ */ __name((scope) => resolver.resolve(scope), "resolveCatalog")
+    ...resolved.channels !== void 0 ? {
+      channels: resolved.channels
+    } : {},
+    ...resolved.sandbox !== void 0 ? {
+      sandbox: resolved.sandbox
+    } : {},
+    ...resolveCatalog2 !== void 0 ? {
+      resolveCatalog: resolveCatalog2
     } : {}
   };
 }
 __name(toolOptions, "toolOptions");
-function withSandbox(options) {
+function withSandbox(options, resolved) {
   const base = options.catalog ?? defineCatalog([]);
-  const { sandbox } = options;
-  return sandbox === void 0 || sandbox === false ? base : base.extend([
+  const { sandbox, catalogSandbox } = resolved;
+  if (sandbox === void 0 || sandbox === false) return catalogSandbox !== void 0 ? base.extend([
+    defineSandbox(catalogSandbox)
+  ]) : base;
+  return base.extend([
     defineSandbox(sandbox === true ? {} : sandbox)
   ]);
 }
@@ -112,18 +270,50 @@ __name(withSandbox, "withSandbox");
 function coreProviders(resolver) {
   return [
     {
-      provide: GENUI_CATALOG,
-      useFactory: /* @__PURE__ */ __name((options) => withSandbox(options), "useFactory"),
+      provide: GENUI_RESOLVED,
+      useFactory: /* @__PURE__ */ __name((options) => resolveGenui(options), "useFactory"),
       inject: [
         GENUI_OPTIONS
       ]
     },
+    {
+      provide: GENUI_CATALOG,
+      useFactory: /* @__PURE__ */ __name((options, resolved) => withSandbox(options, resolved), "useFactory"),
+      inject: [
+        GENUI_OPTIONS,
+        GENUI_RESOLVED
+      ]
+    },
+    {
+      provide: AGENT_GENUI,
+      useFactory: /* @__PURE__ */ __name((options, catalog, resolved, resolverInstance) => new AgentGenui2(catalog, perRequest(resolverInstance), resolved.channels, {
+        ...options.mode !== void 0 ? {
+          mode: options.mode
+        } : {},
+        ...options.streaming !== void 0 ? {
+          streaming: options.streaming
+        } : {},
+        ...resolved.sandbox !== void 0 ? {
+          sandbox: resolved.sandbox
+        } : {}
+      }, resolved.sandboxClient), "useFactory"),
+      inject: [
+        GENUI_OPTIONS,
+        GENUI_CATALOG,
+        GENUI_RESOLVED,
+        {
+          token: GenuiCatalogResolver,
+          optional: true
+        }
+      ]
+    },
     ...resolverProviders(resolver),
     // The generated tools, registered by the agent module's discovery like any `provideAgentTool`.
     // Built from the injected catalog, so `overrideProvider(GENUI_CATALOG)` changes them too.
-    provideAgentTools((options, catalog, perRequest) => genuiTools(catalog, toolOptions(options, perRequest)), [
+    provideAgentTools((options, catalog, resolved, perRequestResolver) => genuiTools(catalog, toolOptions(options, resolved, perRequestResolver)), [
       GENUI_OPTIONS,
       GENUI_CATALOG,
+      GENUI_RESOLVED,
       {
         token: GenuiCatalogResolver,
         optional: true
@@ -134,7 +324,8 @@ function coreProviders(resolver) {
 __name(coreProviders, "coreProviders");
 var EXPORTS = [
   GENUI_CATALOG,
-  GENUI_OPTIONS
+  GENUI_OPTIONS,
+  AGENT_GENUI
 ];
 var AgentGenuiModule = class _AgentGenuiModule {
   static {
@@ -231,7 +422,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;
@@ -245,6 +437,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. */
@@ -346,6 +539,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)) {
@@ -361,6 +578,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,
@@ -374,16 +592,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.",
@@ -466,7 +678,7 @@ var AgentDepsFactory2 = class {
       id: persona.id,
       label: persona.label
     };
-    const resolve = /* @__PURE__ */ __name(async (prompt, ctx) => typeof prompt === "function" ? prompt(ctx) : prompt, "resolve");
+    const resolve2 = /* @__PURE__ */ __name(async (prompt, ctx) => typeof prompt === "function" ? prompt(ctx) : prompt, "resolve");
     const own = persona.systemPrompt;
     const systemPrompt = /* @__PURE__ */ __name(async (ctx) => {
       const scoped = {
@@ -474,10 +686,10 @@ var AgentDepsFactory2 = class {
         persona: ref
       };
       if (own === void 0) {
-        return resolve(base, scoped);
+        return resolve2(base, scoped);
       }
-      const basePrompt = typeof own === "function" ? await resolve(base, scoped) : void 0;
-      return resolve(own, {
+      const basePrompt = typeof own === "function" ? await resolve2(base, scoped) : void 0;
+      return resolve2(own, {
         ...scoped,
         ...basePrompt !== void 0 ? {
           basePrompt
@@ -554,6 +766,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,
@@ -568,7 +782,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);
 
@@ -1398,8 +1613,16 @@ function sendableParams(params) {
       message: "nothing to answer: send a non-empty message, an attachment, or regenerate"
     });
   }
-  return text === message ? params : {
-    ...params,
+  const { channel, ...rest } = params;
+  const stamped = channel === void 0 ? params : {
+    ...rest,
+    pageContext: {
+      ...params.pageContext,
+      channel
+    }
+  };
+  return text === message ? stamped : {
+    ...stamped,
     message: text
   };
 }
@@ -3321,11 +3544,13 @@ var ConfigController = class {
   actorResolver;
   staging;
   models;
-  constructor(options, actorResolver, staging, models) {
+  genui;
+  constructor(options, actorResolver, staging, models, genui) {
     this.options = options;
     this.actorResolver = actorResolver;
     this.staging = staging;
     this.models = models;
+    this.genui = genui;
   }
   async config(req) {
     await this.actorResolver.resolve(req);
@@ -3339,7 +3564,12 @@ var ConfigController = class {
       },
       identity: {
         anonymous: this.actorResolver instanceof AnonymousActorResolver
-      }
+      },
+      ...this.genui?.sandboxClient !== void 0 ? {
+        genui: {
+          sandbox: this.genui.sandboxClient()
+        }
+      } : {}
     };
   }
 };
@@ -3360,11 +3590,14 @@ ConfigController = _ts_decorate10([
   _ts_param9(2, Inject9(AGENT_ATTACHMENT_STAGING4)),
   _ts_param9(3, Optional6()),
   _ts_param9(3, Inject9(AGENT_MODEL_CATALOG2)),
+  _ts_param9(4, Optional6()),
+  _ts_param9(4, Inject9(AGENT_GENUI)),
   _ts_metadata9("design:type", Function),
   _ts_metadata9("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object,
+    Object,
     Object
   ])
 ], ConfigController);
@@ -5046,8 +5279,8 @@ var InProcessTokenStreamSink = class {
     return buf;
   }
   wake(buf) {
-    for (const resolve of buf.notify) {
-      resolve();
+    for (const resolve2 of buf.notify) {
+      resolve2();
     }
     buf.notify.clear();
   }
@@ -5086,7 +5319,7 @@ var InProcessTokenStreamSink = class {
         }
         return;
       }
-      await new Promise((resolve) => buf.notify.add(resolve));
+      await new Promise((resolve2) => buf.notify.add(resolve2));
     }
   }
   close(runId) {
@@ -5763,12 +5996,12 @@ var InlineAgentRunner = class _InlineAgentRunner {
     }
     const key = `${runId}:${toolCallId2}`;
     let timer;
-    const lapse = new Promise((resolve) => {
+    const lapse = new Promise((resolve2) => {
       timer = setTimeout(() => {
         const entry = this.pending.get(key);
         if (entry !== void 0) {
           this.pending.delete(key);
-          resolve({
+          resolve2({
             approved: false,
             expired: true
           });
@@ -5782,9 +6015,9 @@ var InlineAgentRunner = class _InlineAgentRunner {
     ]).finally(() => clearTimeout(timer));
   }
   park(runId, toolCallId2) {
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve2, reject) => {
       this.pending.set(`${runId}:${toolCallId2}`, {
-        resolve,
+        resolve: resolve2,
         reject
       });
     });