@dudousxd/nestjs-agent 1.32.3 → 1.33.0

package/dist/a2ui/index.cjs

@@ -48,11 +48,14 @@ __export(kit_exports, {
   NEST_SANDBOX_KIT_MANIFEST: () => NEST_SANDBOX_KIT_MANIFEST,
   nestSandboxKitDiscovery: () => nestSandboxKitDiscovery
 });
-function nestSandboxKitDiscovery(options = {}) {
+function nestSandboxKitDiscovery(options = {}, name) {
   const manifest = options.manifest ?? NEST_SANDBOX_KIT_MANIFEST;
   return (0, import_kit2.sandboxKitDiscovery)({
     root: (0, import_node_path.resolve)(options.root ?? process.cwd()),
-    descriptor: options.descriptor ?? NEST_SANDBOX_KIT_DESCRIPTOR,
+    ...name !== void 0 ? {
+      name
+    } : {},
+    descriptor: (0, import_kit2.sandboxKitDescriptorPath)(options.descriptor ?? NEST_SANDBOX_KIT_DESCRIPTOR, name),
     ...manifest !== false ? {
       manifest: {
         file: manifest.file,
@@ -62,6 +65,12 @@ function nestSandboxKitDiscovery(options = {}) {
     ...options.kitUrl !== void 0 ? {
       kitUrl: options.kitUrl
     } : {},
+    ...options.cssUrl !== void 0 ? {
+      cssUrl: options.cssUrl
+    } : {},
+    ...options.tailwindUrl !== void 0 ? {
+      tailwindUrl: options.tailwindUrl
+    } : {},
     ...options.production !== void 0 ? {
       production: options.production
     } : {}
@@ -188,6 +197,7 @@ function mergeSandboxClients(clients) {
   for (const client of clients) {
     const one = client();
     merged.theme ||= one.theme;
+    if (one.name !== void 0 && merged.kit === void 0 && one.kit !== void 0) merged.name = one.name;
     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;
@@ -199,14 +209,19 @@ async function resolveGenui(options) {
   const { sandbox: asked, channels: askedChannels } = options;
   (0, import_genui.assertGenuiChannels)(askedChannels);
   const clients = [];
-  let discovery;
+  const discoveries = /* @__PURE__ */ new Map();
   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 kitName = value === true ? void 0 : value.kitName;
+    let discovery = discoveries.get(kitName ?? "");
+    if (discovery === void 0) {
+      discovery = nestSandboxKitDiscovery2(options.sandboxKit, kitName);
+      discoveries.set(kitName ?? "", discovery);
+    }
     const resolved = resolveSandboxServer(value, discovery);
     clients.push(resolved.client);
     return resolved.define;

package/dist/a2ui/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/vite/index.ts","../../src/genui/kit.ts","../../src/a2ui/index.ts","../../src/a2ui/a2ui.adapter.ts","../../src/agent-service.token.ts","../../src/genui/agent-genui.module.ts","../../src/functional-tool.ts","../../src/genui/agent-genui.token.ts"],"sourcesContent":["/**\n * `@dudousxd/nestjs-agent/vite` — `genuiSandboxKit()`, the Vite plugin that puts the app's design\n * system (its styles, its components, its providers) inside the sandbox, whatever the stack:\n *\n * ```ts\n * // vite.config.ts (the SPA that talks to the agent)\n * import { genuiSandboxKit } from '@dudousxd/nestjs-agent/vite'\n * export default defineConfig({\n *   plugins: [react(), genuiSandboxKit({ styles: 'src/index.css', components: 'src/components/ui' })],\n * })\n * ```\n *\n * Then `AgentGenuiModule.forRoot({ sandbox: { kit: true } })` finds what it built: the descriptor\n * the dev server writes (`.genui/sandbox-kit.json`) in dev, the Vite manifest in production (see\n * `AgentGenuiOptions.sandboxKit`).\n */\nimport {\n  type GenuiSandboxKitApi,\n  type GenuiSandboxKitOptions,\n  type GenuiSandboxKitPlugin,\n  SANDBOX_KIT_DEV_PREFIX,\n  SANDBOX_KIT_MANIFEST_KEYS,\n  SANDBOX_KIT_UPDATE_EVENT,\n  createGenuiSandboxKitPlugin,\n} from '@dudousxd/nestjs-agent-core/genui/kit';\n\n/**\n * Where the dev descriptor is written, relative to the Vite root — and where the server reads it,\n * relative to its working directory (run both from the project root, or point\n * `sandboxKit.descriptor` at it). Add `.genui/` to `.gitignore`.\n */\nexport const NEST_SANDBOX_KIT_DESCRIPTOR = '.genui/sandbox-kit.json';\n\n/**\n * The sandbox kit plugin: `styles` (the app's style entries — default, the stylesheets among its\n * Vite entrypoints or `index.html`), `components` (modules or globs exporting React components —\n * default, the first `components/ui` folder), `wrapper` (a module whose default export wraps the\n * model's App). See {@link GenuiSandboxKitOptions}.\n */\nexport function genuiSandboxKit(options: GenuiSandboxKitOptions = {}): GenuiSandboxKitPlugin {\n  return createGenuiSandboxKitPlugin(options, {\n    descriptor: NEST_SANDBOX_KIT_DESCRIPTOR,\n    rendererImport: /@dudousxd\\/nestjs-agent-react/,\n  });\n}\n\nexport {\n  type GenuiSandboxKitApi,\n  type GenuiSandboxKitOptions,\n  type GenuiSandboxKitPlugin,\n  SANDBOX_KIT_DEV_PREFIX,\n  SANDBOX_KIT_MANIFEST_KEYS,\n  SANDBOX_KIT_UPDATE_EVENT,\n};\n","/**\n * The sandbox kit in a Nest app. No Vite runs in the Nest process, so the kit is found in files:\n * the descriptor `genuiSandboxKit()` (`@dudousxd/nestjs-agent/vite`) writes while the dev server\n * runs, and in production the Vite manifest the build wrote (`genui-sandbox-kit.json` and the assets\n * it names). Node-only: loaded by {@link AgentGenuiModule} only when a sandbox is configured.\n */\nimport { resolve } from 'node:path';\nimport {\n  type SandboxKitDiscovery,\n  sandboxKitDiscovery,\n} from '@dudousxd/nestjs-agent-core/genui/kit';\nimport { NEST_SANDBOX_KIT_DESCRIPTOR } from '../vite/index.js';\nimport type { AgentGenuiSandboxKitOptions } from './agent-genui.module.js';\n\n/** Where the production Vite manifest is looked for by default, and the directory it is relative to. */\nexport const NEST_SANDBOX_KIT_MANIFEST = Object.freeze({\n  file: 'public/.vite/manifest.json',\n  outDir: 'public',\n});\n\n/** Find the kit for `AgentGenuiModule.forRoot({ sandbox: { kit: true } })`. */\nexport function nestSandboxKitDiscovery(\n  options: AgentGenuiSandboxKitOptions = {},\n): SandboxKitDiscovery {\n  const manifest = options.manifest ?? NEST_SANDBOX_KIT_MANIFEST;\n  return sandboxKitDiscovery({\n    root: resolve(options.root ?? process.cwd()),\n    descriptor: options.descriptor ?? NEST_SANDBOX_KIT_DESCRIPTOR,\n    ...(manifest !== false ? { manifest: { file: manifest.file, outDir: manifest.outDir } } : {}),\n    ...(options.kitUrl !== undefined ? { kitUrl: options.kitUrl } : {}),\n    ...(options.production !== undefined ? { production: options.production } : {}),\n  });\n}\n","/**\n * `@dudousxd/nestjs-agent/a2ui` — A2UI (https://a2ui.org, v0.9) for the agent: the `a2uiAdapter()`\n * route (JSON Lines of A2UI messages), and the framework-free pieces it is built from (re-exported\n * from `@dudousxd/nestjs-agent-core/a2ui`) — the `ui` frame → A2UI converter, the builtin →\n * basic-catalog mappings, the catalog export, the inbound action reader. For A2UI over AG-UI, pass\n * `a2ui: true` to `agUiAdapter()`.\n */\n\nexport * from '@dudousxd/nestjs-agent-core/a2ui';\nexport { type A2uiAdapterOptions, A2uiRunHandler, a2uiAdapter } from './a2ui.adapter.js';\n","import { AGENT_ACTOR_RESOLVER, type ActorResolver } from '@dudousxd/nestjs-agent-core';\nimport {\n  A2UI_APPROVE_ACTION,\n  A2UI_REJECT_ACTION,\n  A2uiProjector,\n  type A2uiServerMessage,\n  type A2uiStreamOptions,\n  a2uiThreadReplay,\n  negotiateA2uiCatalog,\n  readA2uiAction,\n  readA2uiClientCapabilities,\n} from '@dudousxd/nestjs-agent-core/a2ui';\nimport {\n  agUiEvents,\n  agUiFramesFromNdjson,\n  decodeInterruptId,\n} from '@dudousxd/nestjs-agent-core/ag-ui';\nimport {\n  type Catalog,\n  type UiAction,\n  type UiCapabilities,\n  uiActionText,\n  validateUiCapabilities,\n} from '@dudousxd/nestjs-agent-core/genui';\nimport {\n  BadRequestException,\n  Body,\n  Controller,\n  ForbiddenException,\n  Get,\n  HttpCode,\n  Inject,\n  Optional,\n  Param,\n  Post,\n  Query,\n  Req,\n  Res,\n} from '@nestjs/common';\nimport type { Request, Response } from 'express';\nimport { AGENT_SERVICE } from '../agent-service.token.js';\nimport type { AgentService } from '../agent.service.js';\nimport { GENUI_CATALOG } from '../genui/agent-genui.module.js';\nimport type { AgentProtocolAdapter } from '../protocol-adapter.js';\n\nexport interface A2uiAdapterOptions extends A2uiStreamOptions {\n  /** Where the route mounts, under the agent's path. Default `'a2ui'` → `POST <path>/a2ui`. */\n  path?: string;\n  /** As `agUiAdapter`'s: how long a run waiting on a person may stay silent before the stream ends. */\n  quietMs?: number;\n  /** Largest action accepted, as JSON, in bytes. Default 8192. */\n  maxActionBytes?: number;\n  /** Largest `a2uiClientDataModel` accepted, as JSON, in bytes. Default 32768. */\n  maxDataModelBytes?: number;\n}\n\n/** The surface an A2UI decision is recorded as having come through. */\nconst A2UI_VIA = 'a2ui';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction invalid(code: string, message: string): BadRequestException {\n  return new BadRequestException({ statusCode: 400, code, message });\n}\n\n/** A field of the body, or of its A2A-style `metadata` (where A2UI puts client capabilities). */\nfunction bodyField(body: Record<string, unknown>, key: string): unknown {\n  if (body[key] !== undefined) return body[key];\n  return isRecord(body.metadata) ? body.metadata[key] : undefined;\n}\n\n/** `a2uiClientDataModel` (`{ version, surfaces: { <surfaceId>: model } }`): its surfaces, or why not. */\nfunction readDataModel(\n  raw: unknown,\n  maxBytes: number,\n): Record<string, unknown> | undefined | string {\n  if (raw === undefined) return undefined;\n  if (!isRecord(raw) || !isRecord(raw.surfaces)) {\n    return 'a2uiClientDataModel carries { version, surfaces }';\n  }\n  let size: number;\n  try {\n    size = new TextEncoder().encode(JSON.stringify(raw.surfaces)).length;\n  } catch {\n    return 'a2uiClientDataModel must be JSON';\n  }\n  if (size > maxBytes) {\n    return `a2uiClientDataModel may be at most ${maxBytes} bytes (this one is ${size})`;\n  }\n  return Object.keys(raw.surfaces).length > 0 ? raw.surfaces : undefined;\n}\n\n/**\n * Serves the agent as an A2UI agent. Not mounted directly — {@link a2uiAdapter} mounts a subclass at\n * the configured path — but exported so a host can extend it under a route of its own.\n */\nexport class A2uiRunHandler {\n  constructor(\n    protected readonly agent: AgentService,\n    protected readonly actorResolver: ActorResolver,\n    protected readonly projection: A2uiStreamOptions,\n    protected readonly quietMs: number | undefined,\n    protected readonly maxActionBytes: number | undefined,\n    protected readonly maxDataModelBytes: number | undefined = undefined,\n  ) {}\n\n  /**\n   * `GET <path>/a2ui/threads/:threadId`: a stored thread as `{ threadId, entries }`\n   * (`a2uiThreadReplay`) — what a client draws again after a reload. Owner-scoped; a thread nobody\n   * has answers `{ entries: [] }`. `?catalog=<id>` names the client's basic catalog id.\n   */\n  async replay(\n    req: Request,\n    threadId: string,\n    catalog: unknown,\n  ): Promise<{ threadId: string; entries: ReturnType<typeof a2uiThreadReplay> }> {\n    const actor = await this.actorResolver.resolve(req);\n    const owner = await this.agent.threadOwner(threadId);\n    if (owner === null) return { threadId, entries: [] };\n    const thread = await this.agent.getThread(actor, threadId);\n    const supported =\n      typeof catalog === 'string'\n        ? [catalog]\n        : Array.isArray(catalog)\n          ? catalog.filter((id): id is string => typeof id === 'string')\n          : undefined;\n    return {\n      threadId,\n      entries: a2uiThreadReplay(\n        thread?.messages ?? [],\n        negotiateA2uiCatalog(this.projection, supported),\n      ),\n    };\n  }\n\n  async handle(req: Request, res: Response, raw: unknown): Promise<void> {\n    const body = isRecord(raw) ? raw : {};\n    const agentName =\n      typeof body.agent === 'string' && body.agent.length > 0 ? body.agent : undefined;\n    const actor = await this.actorResolver.resolve(req);\n    // The basic catalog under the id this client advertises (`a2uiClientCapabilities`).\n    const projection = negotiateA2uiCatalog(\n      this.projection,\n      readA2uiClientCapabilities(bodyField(body, 'a2uiClientCapabilities')),\n    );\n    const dataModel = readDataModel(\n      bodyField(body, 'a2uiClientDataModel'),\n      this.maxDataModelBytes ?? 32768,\n    );\n    if (typeof dataModel === 'string') throw invalid('invalid_data_model', dataModel);\n\n    let action: UiAction | undefined;\n    if (body.action !== undefined) {\n      const read = isRecord(body.action)\n        ? readA2uiAction(body.action, {\n            ...(this.maxActionBytes !== undefined ? { maxBytes: this.maxActionBytes } : {}),\n          })\n        : 'action must be an A2UI action message';\n      if (typeof read === 'string') throw invalid('invalid_action', read);\n      action = read;\n    }\n\n    // Deciding the approval a stream ended on: settle it, then stream the rest of the run.\n    if (action?.name === A2UI_APPROVE_ACTION || action?.name === A2UI_REJECT_ACTION) {\n      const interruptId = action.context.interruptId;\n      const address = typeof interruptId === 'string' ? decodeInterruptId(interruptId) : undefined;\n      if (address === undefined || address === null || address.kind === 'elicitation') {\n        throw invalid('invalid_action', 'an approval action carries the interruptId it decides');\n      }\n      // An independent proposal: decided through the proposal service (its own run is not\n      // waiting), as an AG-UI resume decides it, and answered with the configured reply.\n      if (address.kind === 'proposal') {\n        if (address.proposalId === undefined || address.threadId === undefined) {\n          throw invalid('invalid_action', 'the interruptId names no proposal');\n        }\n        const decided = await this.agent.decideActionProposal(\n          actor,\n          address.threadId,\n          address.proposalId,\n          {\n            decision: action.name === A2UI_APPROVE_ACTION ? 'approved' : 'rejected',\n            via: A2UI_VIA,\n          },\n        );\n        this.writeHead(res, { 'X-Agent-Thread-Id': address.threadId });\n        const projector = new A2uiProjector(projection);\n        const messageId = `proposal-${address.proposalId}`;\n        for (const event of [\n          { type: 'TEXT_MESSAGE_START' as const, messageId, role: 'assistant' as const },\n          { type: 'TEXT_MESSAGE_CONTENT' as const, messageId, delta: decided.text },\n        ]) {\n          for (const message of projector.project(event)) res.write(`${JSON.stringify(message)}\\n`);\n        }\n        res.end();\n        return;\n      }\n      // The same checks an AG-UI resume makes: the run is the actor's and still waiting, and the\n      // actor may decide this call.\n      await this.agent.assertResumable(actor, address.stream);\n      await this.agent.checkDecision(actor, address.toolCallId);\n      if (action.name === A2UI_APPROVE_ACTION) {\n        await this.agent.approve(actor, address.toolCallId, { via: A2UI_VIA });\n      } else {\n        await this.agent.reject(actor, address.toolCallId, undefined, { via: A2UI_VIA });\n      }\n      await this.stream(res, address.stream, {\n        skip: address.position,\n        answered: [address.toolCallId],\n        projection,\n      });\n      return;\n    }\n\n    const message = typeof body.message === 'string' ? body.message : '';\n    const text = action !== undefined ? uiActionText(action) : message;\n    if (text.trim().length === 0) {\n      throw invalid('no_user_message', 'send a message or an action');\n    }\n    const threadId =\n      typeof body.threadId === 'string' && body.threadId.length > 0 ? body.threadId : undefined;\n    const owner = threadId !== undefined ? await this.agent.threadOwner(threadId) : null;\n    if (owner !== null && owner !== actor.id) {\n      throw new ForbiddenException('thread belongs to another actor');\n    }\n    let uiCapabilities: UiCapabilities | undefined;\n    if (Object.hasOwn(body, 'uiCapabilities')) {\n      try {\n        uiCapabilities = validateUiCapabilities(body.uiCapabilities);\n      } catch (error) {\n        throw invalid('invalid_input', (error as Error).message);\n      }\n    }\n    const started = await this.agent.chat({\n      actor,\n      message: text,\n      ...(threadId === undefined ? {} : owner !== null ? { threadId } : { newThreadId: threadId }),\n      ...(agentName !== undefined ? { agentName } : {}),\n      ...(uiCapabilities !== undefined ? { uiCapabilities } : {}),\n      ...(dataModel !== undefined ? { pageContext: { a2uiDataModel: dataModel } } : {}),\n    });\n    await this.stream(res, started.runId, { threadId: started.threadId, projection });\n  }\n\n  /** Open the JSON Lines response. */\n  protected writeHead(res: Response, extra: Record<string, string>): void {\n    res.status(200);\n    res.setHeader('Content-Type', 'application/jsonl; charset=utf-8');\n    res.setHeader('Cache-Control', 'no-cache, no-transform');\n    res.setHeader('Connection', 'keep-alive');\n    res.setHeader('X-Accel-Buffering', 'no');\n    for (const [name, value] of Object.entries(extra)) res.setHeader(name, value);\n    res.flushHeaders();\n  }\n\n  /** Write one run as A2UI JSON Lines, until it ends or stops to ask. */\n  protected async stream(\n    res: Response,\n    runId: string,\n    options: {\n      threadId?: string;\n      skip?: number;\n      answered?: string[];\n      projection?: A2uiStreamOptions;\n    },\n  ): Promise<void> {\n    this.writeHead(res, {\n      'X-Agent-Run-Id': runId,\n      ...(options.threadId !== undefined ? { 'X-Agent-Thread-Id': options.threadId } : {}),\n    });\n    const projector = new A2uiProjector(options.projection ?? this.projection);\n    const write = (messages: A2uiServerMessage[]) => {\n      for (const message of messages) res.write(`${JSON.stringify(message)}\\n`);\n    };\n    try {\n      const frames = agUiFramesFromNdjson(this.agent.subscribe(runId));\n      for await (const event of agUiEvents(frames, {\n        threadId: options.threadId ?? runId,\n        runId,\n        streamRunId: runId,\n        ...(options.threadId !== undefined ? { streamThreadId: options.threadId } : {}),\n        ...(options.skip !== undefined ? { skip: options.skip } : {}),\n        ...(options.answered !== undefined ? { answered: options.answered } : {}),\n        ...(this.quietMs !== undefined ? { quietMs: this.quietMs } : {}),\n      })) {\n        write(projector.project(event));\n      }\n    } catch {\n      write(projector.project({ type: 'RUN_ERROR', message: 'The run could not be followed.' }));\n    }\n    res.end();\n  }\n}\n\n/**\n * Serve the agent as an A2UI (https://a2ui.org, v0.9) agent: `POST <path>/a2ui` answers with the\n * run as a JSON Lines stream of A2UI server-to-client messages — `createSurface`,\n * `updateComponents`, `updateDataModel`, `deleteSurface` — that any A2UI renderer draws.\n *\n * ```ts\n * import { a2uiAdapter } from '@dudousxd/nestjs-agent/a2ui'\n *\n * AgentModule.forRoot({ model, adapters: [a2uiAdapter()] })\n * ```\n *\n * The body is `{ threadId?, message?, action?, uiCapabilities?, a2uiClientCapabilities?,\n * a2uiClientDataModel?, agent? }` (the two A2UI fields also read from `metadata`, A2A-style):\n *  - `message` — the user's text;\n *  - `action` — an A2UI client message (`{ version: 'v0.9', action: { name, surfaceId,\n *    sourceComponentId, timestamp, context } }`, or v0.8's `{ userAction }`): it becomes the turn\n *    (`uiActionText`). `agora.approve` / `agora.reject` with `context.interruptId` decide the\n *    approval a previous stream ended on, and stream the rest of that run (an independent\n *    proposal is decided through the proposal service and answered with its reply);\n *  - `threadId` — continue that thread (its owner is checked), or start one under that id;\n *  - `a2uiClientCapabilities` — the catalogs the client draws (`{ 'v0.9': { supportedCatalogIds } }`,\n *    what `MessageProcessor.getRendererCapabilities()` builds): the basic catalog is sent under the\n *    id the client lists for it;\n *  - `a2uiClientDataModel` — the data models of surfaces created with `sendDataModel`, handed to the\n *    prompt builder as `pageContext.a2uiDataModel`.\n *\n * `GET <path>/a2ui/threads/:threadId` answers a stored thread as `{ threadId, entries }`\n * (`a2uiThreadReplay`): what a client draws again after a reload.\n *\n * Response headers name the library's ids: `X-Agent-Thread-Id`, `X-Agent-Run-Id`. Authenticated by\n * the module's `actorResolver`, guarded by its `guards` and owner-scoped exactly as `chat` is.\n * Components nothing maps are drawn as their text, from the `AgentGenuiModule` catalog when there\n * is one (or `catalog` here).\n */\nexport function a2uiAdapter(options: A2uiAdapterOptions = {}): AgentProtocolAdapter {\n  const path = (options.path ?? 'a2ui').replace(/^\\/+|\\/+$/g, '');\n  const { path: _path, quietMs, maxActionBytes, maxDataModelBytes, ...projection } = options;\n\n  @Controller()\n  class A2uiController extends A2uiRunHandler {\n    constructor(\n      // Tokens, never classes: this entry is its own bundle (see AGENT_SERVICE).\n      @Inject(AGENT_SERVICE) agent: AgentService,\n      @Inject(AGENT_ACTOR_RESOLVER) actorResolver: ActorResolver,\n      @Optional() @Inject(GENUI_CATALOG) catalog?: Catalog,\n    ) {\n      super(\n        agent,\n        actorResolver,\n        projection.catalog === undefined && catalog !== undefined\n          ? { ...projection, catalog }\n          : projection,\n        quietMs,\n        maxActionBytes,\n        maxDataModelBytes,\n      );\n    }\n\n    @Get(`${path}/threads/:threadId`)\n    thread(\n      @Req() req: Request,\n      @Param('threadId') threadId: string,\n      @Query('catalog') catalog: unknown,\n    ): ReturnType<A2uiRunHandler['replay']> {\n      return this.replay(req, threadId, catalog);\n    }\n\n    @Post(path)\n    @HttpCode(200)\n    run(@Req() req: Request, @Res() res: Response, @Body() body: unknown): Promise<void> {\n      return this.handle(req, res, body);\n    }\n  }\n\n  return { name: 'a2ui', controllers: [A2uiController] };\n}\n","/**\n * `AgentService`, as the controllers of a secondary entry (`@dudousxd/nestjs-agent/a2ui`) ask for it.\n *\n * A token rather than the class: every entry is its own bundle with its own copy of every class it\n * imports, so the class used as an injection token there is not the one `AgentModule` provides.\n * `Symbol.for` is the same value in every bundle.\n */\nexport const AGENT_SERVICE = Symbol.for('@dudousxd/nestjs-agent:agent-service');\n","import type { ToolPresentation } from '@dudousxd/nestjs-agent-core';\nimport type {\n  Catalog,\n  GenuiAbility,\n  GenuiCatalogScope,\n  GenuiChannels,\n  GenuiStreaming,\n  GenuiToolsOptions,\n  SandboxClientConfig,\n  TreeLimits,\n  TreeSchemaMode,\n} from '@dudousxd/nestjs-agent-core/genui';\nimport {\n  type DefineSandboxOptions,\n  type SandboxDefinition,\n  assertGenuiChannels,\n  defineCatalog,\n  defineSandbox,\n  genuiTools,\n  sandboxPolicyOf,\n} from '@dudousxd/nestjs-agent-core/genui';\nimport {\n  type DynamicModule,\n  type FactoryProvider,\n  Inject,\n  Module,\n  type ModuleMetadata,\n  type Provider,\n  type Type,\n} from '@nestjs/common';\nimport { provideAgentTools } from '../functional-tool.js';\nimport { AGENT_GENUI, AgentGenui } from './agent-genui.token.js';\n\nexport { AGENT_GENUI, AgentGenui } from './agent-genui.token.js';\n\n/** The app's genui catalog — `@InjectGenuiCatalog()` it anywhere; `overrideProvider` it in tests. */\nexport const GENUI_CATALOG = Symbol.for('@dudousxd/nestjs-agent:genui-catalog');\n\n/** The resolved {@link AgentGenuiOptions} (without the resolver). */\nexport const GENUI_OPTIONS = Symbol.for('@dudousxd/nestjs-agent:genui-options');\n\n/** The sandbox and channels as boot resolved them (kit, Tailwind and theme found). Internal. */\nconst GENUI_RESOLVED = Symbol.for('@dudousxd/nestjs-agent:genui-resolved');\n\n/** Inject the app's genui catalog ({@link GENUI_CATALOG}). */\nexport const InjectGenuiCatalog = (): ParameterDecorator & PropertyDecorator =>\n  Inject(GENUI_CATALOG);\n\n/**\n * Picks the catalog for ONE request — a tenant's own, versioned components. Consulted when a genui\n * call is validated and when the turn's tool list is described to the model, so components can\n * change without rebuilding tools at boot. Cache in here if resolving costs a round trip: it runs\n * once per turn per genui tool, and once per call.\n *\n * Provide it through `AgentGenuiModule.forRoot({ resolver })` (a class, resolved with DI, or an\n * instance); it is then injectable, and replaceable in a test with\n * `overrideProvider(GenuiCatalogResolver)`.\n */\nexport abstract class GenuiCatalogResolver {\n  abstract resolve(scope: GenuiCatalogScope): Catalog | Promise<Catalog>;\n}\n\n/** What {@link AgentGenuiModule} builds tools from. */\nexport interface AgentGenuiOptions {\n  /**\n   * The catalog. With a {@link GenuiCatalogResolver} it is the boot-time one — it names the\n   * per-component tools — and may be empty. Default: an empty catalog.\n   */\n  catalog?: Catalog;\n  /**\n   * `tree` (default): one `ui__render` tool taking a composed tree (a single node is pushed as that\n   * component). `per-component`: one `ui__show_<snake>` tool per component.\n   */\n  mode?: 'per-component' | 'tree';\n  /** `ui__render`'s input schema: `'strict'` (default, a `$defs` union per component) or `'loose'`. */\n  treeSchema?: TreeSchemaMode;\n  /**\n   * Tree mode: `'complete'` (default) draws the tree once the call has run; `'partial'` streams it\n   * as `partial` ui frames while the model writes it. A component's own `streaming` overrides it.\n   */\n  streaming?: GenuiStreaming;\n  /** Least time between two partial tree frames of one call, in ms. Default 100. */\n  streamingThrottleMs?: number;\n  /** End the model's turn once a genui call succeeds (no narrating follow-up call). */\n  terminal?: boolean;\n  /** Tool name in `tree` mode. Default `ui__render`. */\n  treeToolName?: string;\n  /** Text prepended to the tree tool's description. */\n  treeInstructions?: string;\n  treeLimits?: TreeLimits;\n  /**\n   * Tree mode: components that ALSO get a flat tool whose input IS their props —\n   * `componentTools: ['Sandbox']` adds `ui__sandbox`, so a model writing a big component on its own\n   * has no `{ type, props }` envelope to leave out.\n   */\n  componentTools?: readonly string[];\n  /** Tool-name prefix for `componentTools`. Default `ui__` (`Sandbox` → `ui__sandbox`). */\n  componentToolPrefix?: string;\n  /** Tool-name prefix in `per-component` mode. Default `ui__show_`. */\n  namePrefix?: string;\n  /**\n   * Also register ONE generic tool taking `{ component, props }`, validated against the request's\n   * catalog — how a model reaches a tenant's own components, which no boot-time tool names. `true`\n   * names it `ui__show`.\n   */\n  showTool?: boolean | string;\n  /** Text prepended to the show tool's description. */\n  showInstructions?: string;\n  /** Roles allowed to call the tools. Undefined → the roles policy default. */\n  roles?: string[];\n  /**\n   * The authorization ability the UI tools declare (`ToolSpec.ability`), for an ability-aware\n   * authorizer such as `authzToolAuthorizer`, which denies a tool with none. A string for every\n   * tool; a map by tool name (`{ ui__render: 'genui.render', ui__sandbox: 'genui.sandbox' }`, a tool\n   * left out declares none); or a function of `{ name, component }`. The authorizer decides.\n   */\n  ability?: GenuiAbility;\n  /** Override the generated presentation per component (or per tree / show tool name). */\n  presentation?: (component: string) => ToolPresentation | undefined;\n  /**\n   * Add the sandbox component (`Sandbox`): the model may write HTML, CSS and JS for a one-off\n   * interactive answer when no catalog component fits. `true` for the defaults (no network), or\n   * the {@link DefineSandboxOptions} (a policy listing origins, extra instructions). Off by default.\n   * The browser's catalog should carry the same definition (`defineSandbox(...)` in the shared\n   * catalog file) so the renderer enforces the same policy.\n   *\n   * `theme` (default on) and `kit` put the app's design system in the frame: `kit: true` turns on\n   * whatever `genuiSandboxKit()` built (styles, Tailwind, components, wrapper, docs), found through\n   * `sandboxKit`: the descriptor\n   * `genuiSandboxKit()` (`@dudousxd/nestjs-agent/vite`) writes in dev, the Vite manifest in\n   * production — and `GET <base>/config` tells the renderer where the assets are.\n   */\n  sandbox?: boolean | DefineSandboxOptions;\n  /**\n   * Per-channel generative UI: each entry sets the mode, streaming, sandbox and rendering of one\n   * channel (`web`, `mobile`, `whatsapp`, `telegram`, `email`, or `default` for the rest), over the\n   * top-level options. A text channel (`@dudousxd/nestjs-agent-channels`) configured here draws the\n   * components natively (reply buttons, lists, images). Omitted → every channel is served by the\n   * top-level options, as before.\n   */\n  channels?: GenuiChannels;\n  /**\n   * Where the sandbox kit is found (with `sandbox: { kit: true }` or the theme's names). No Vite\n   * runs in the Nest process, so: the descriptor the dev plugin writes, or the production Vite\n   * manifest — in production the manifest first, otherwise whichever was written last.\n   */\n  sandboxKit?: AgentGenuiSandboxKitOptions;\n}\n\n/** {@link AgentGenuiOptions.sandboxKit}. Relative paths resolve against `root`. */\nexport interface AgentGenuiSandboxKitOptions {\n  /** Default `process.cwd()`. */\n  root?: string;\n  /** The dev descriptor `genuiSandboxKit()` writes. Default `.genui/sandbox-kit.json`. */\n  descriptor?: string;\n  /**\n   * The production Vite manifest, and the directory its `file`s are relative to. Default\n   * `{ file: 'public/.vite/manifest.json', outDir: 'public' }`; `false` → none.\n   */\n  manifest?: { file: string; outDir: string } | false;\n  /** An explicit kit url (an SPA served from elsewhere), over what is found. */\n  kitUrl?: string;\n  /** Read the manifest first (else the freshest of the two). Default: `NODE_ENV === 'production'`. */\n  production?: boolean;\n}\n\ntype ResolverOption = Type<GenuiCatalogResolver> | GenuiCatalogResolver;\n\nexport interface AgentGenuiModuleOptions extends AgentGenuiOptions {\n  /** Per-request catalogs. A class is instantiated with DI (its dependencies must be global or exported to the root). */\n  resolver?: ResolverOption;\n}\n\nexport interface AgentGenuiModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {\n  inject?: FactoryProvider['inject'];\n  useFactory: (...deps: any[]) => AgentGenuiOptions | Promise<AgentGenuiOptions>;\n  /** Per-request catalogs. A class resolves its dependencies from `imports`. */\n  resolver?: ResolverOption;\n}\n\nfunction resolverProviders(resolver: ResolverOption | undefined): Provider[] {\n  if (resolver === undefined) return [];\n  return [\n    typeof resolver === 'function'\n      ? { provide: GenuiCatalogResolver, useClass: resolver }\n      : { provide: GenuiCatalogResolver, useValue: resolver },\n  ];\n}\n\n/** The sandbox and channels with the kit and theme names found ({@link GENUI_RESOLVED}). */\ninterface ResolvedGenui {\n  sandbox?: boolean | DefineSandboxOptions;\n  /** A kit sandbox the catalog itself defines, resolved (under its own name). */\n  catalogSandbox?: DefineSandboxOptions;\n  channels?: GenuiChannels;\n  sandboxClient?: () => SandboxClientConfig;\n}\n\n/** What every configured sandbox (top level and channels) needs from the browser, together. */\nfunction mergeSandboxClients(clients: Array<() => SandboxClientConfig>): SandboxClientConfig {\n  const merged: SandboxClientConfig = { theme: false };\n  for (const client of clients) {\n    const one = client();\n    merged.theme ||= one.theme;\n    if (one.kit !== undefined) merged.kit ??= one.kit;\n    if (one.css !== undefined) merged.css ??= one.css;\n    if (one.tailwind !== undefined) merged.tailwind ??= one.tailwind;\n  }\n  return merged;\n}\n\n/** Resolve the sandbox (top level and per channel) against the kit discovery. */\nasync function resolveGenui(options: AgentGenuiOptions): Promise<ResolvedGenui> {\n  const { sandbox: asked, channels: askedChannels } = options;\n  assertGenuiChannels(askedChannels);\n  // A sandbox's kit (styles, components, wrapper) and theme names are found through the app's Vite output.\n  const clients: Array<() => SandboxClientConfig> = [];\n  let discovery: import('@dudousxd/nestjs-agent-core/genui/kit').SandboxKitDiscovery | undefined;\n  const resolveSandbox = async (\n    value: boolean | DefineSandboxOptions | undefined,\n  ): Promise<boolean | DefineSandboxOptions | undefined> => {\n    if (value === undefined || value === false) return value;\n    // Node-only, and only with a sandbox: loaded when one is configured.\n    const [{ nestSandboxKitDiscovery }, { resolveSandboxServer }] = await Promise.all([\n      import('./kit.js'),\n      import('@dudousxd/nestjs-agent-core/genui/kit'),\n    ]);\n    discovery ??= nestSandboxKitDiscovery(options.sandboxKit);\n    const resolved = resolveSandboxServer(value, discovery);\n    clients.push(resolved.client);\n    return resolved.define;\n  };\n  const sandbox = await resolveSandbox(asked);\n  // A kit sandbox defined in the (shared) catalog itself: found the same way, and put\n  // back under its own name, so the browser's copy of the catalog validates what the model writes.\n  const own = options.catalog?.components.find((each) => sandboxPolicyOf(each) !== undefined) as\n    | SandboxDefinition\n    | undefined;\n  const ownOptions =\n    asked === undefined && own?.sandboxOptions !== undefined && own.sandboxView?.kit === true\n      ? await resolveSandbox({ ...own.sandboxOptions, name: own.name })\n      : undefined;\n  let channels: GenuiChannels | undefined;\n  if (askedChannels !== undefined) {\n    channels = {};\n    for (const [name, entry] of Object.entries(askedChannels)) {\n      if (entry === undefined) continue;\n      const own = await resolveSandbox(entry.sandbox);\n      channels[name] = { ...entry, ...(own !== undefined ? { sandbox: own } : {}) };\n    }\n  }\n  return {\n    ...(sandbox !== undefined ? { sandbox } : {}),\n    ...(typeof ownOptions === 'object' ? { catalogSandbox: ownOptions } : {}),\n    ...(channels !== undefined ? { channels } : {}),\n    ...(clients.length > 0 ? { sandboxClient: () => mergeSandboxClients(clients) } : {}),\n  };\n}\n\nfunction perRequest(\n  resolver: GenuiCatalogResolver | undefined,\n): GenuiToolsOptions['resolveCatalog'] | undefined {\n  return resolver === undefined ? undefined : (scope: GenuiCatalogScope) => resolver.resolve(scope);\n}\n\nfunction toolOptions(\n  options: AgentGenuiOptions,\n  resolved: ResolvedGenui,\n  resolver: GenuiCatalogResolver | undefined,\n): GenuiToolsOptions {\n  const {\n    catalog: _catalog,\n    sandbox: _sandbox,\n    channels: _channels,\n    sandboxKit: _sandboxKit,\n    ...rest\n  } = options;\n  const resolveCatalog = perRequest(resolver);\n  return {\n    ...rest,\n    ...(resolved.channels !== undefined ? { channels: resolved.channels } : {}),\n    ...(resolved.sandbox !== undefined ? { sandbox: resolved.sandbox } : {}),\n    ...(resolveCatalog !== undefined ? { resolveCatalog } : {}),\n  };\n}\n\n/** The configured catalog, with the sandbox component added when `sandbox` asks for it. */\nfunction withSandbox(options: AgentGenuiOptions, resolved: ResolvedGenui): Catalog {\n  const base = options.catalog ?? defineCatalog([]);\n  const { sandbox, catalogSandbox } = resolved;\n  if (sandbox === undefined || sandbox === false)\n    return catalogSandbox !== undefined ? base.extend([defineSandbox(catalogSandbox)]) : base;\n  return base.extend([defineSandbox(sandbox === true ? {} : sandbox)]);\n}\n\nfunction coreProviders(resolver: ResolverOption | undefined): Provider[] {\n  return [\n    {\n      provide: GENUI_RESOLVED,\n      useFactory: (options: AgentGenuiOptions) => resolveGenui(options),\n      inject: [GENUI_OPTIONS],\n    },\n    {\n      provide: GENUI_CATALOG,\n      useFactory: (options: AgentGenuiOptions, resolved: ResolvedGenui) =>\n        withSandbox(options, resolved),\n      inject: [GENUI_OPTIONS, GENUI_RESOLVED],\n    },\n    {\n      provide: AGENT_GENUI,\n      useFactory: (\n        options: AgentGenuiOptions,\n        catalog: Catalog,\n        resolved: ResolvedGenui,\n        resolverInstance?: GenuiCatalogResolver,\n      ) =>\n        new AgentGenui(\n          catalog,\n          perRequest(resolverInstance),\n          resolved.channels,\n          {\n            ...(options.mode !== undefined ? { mode: options.mode } : {}),\n            ...(options.streaming !== undefined ? { streaming: options.streaming } : {}),\n            ...(resolved.sandbox !== undefined ? { sandbox: resolved.sandbox } : {}),\n          },\n          resolved.sandboxClient,\n        ),\n      inject: [\n        GENUI_OPTIONS,\n        GENUI_CATALOG,\n        GENUI_RESOLVED,\n        { token: GenuiCatalogResolver, optional: true },\n      ],\n    },\n    ...resolverProviders(resolver),\n    // The generated tools, registered by the agent module's discovery like any `provideAgentTool`.\n    // Built from the injected catalog, so `overrideProvider(GENUI_CATALOG)` changes them too.\n    provideAgentTools(\n      (\n        options: AgentGenuiOptions,\n        catalog: Catalog,\n        resolved: ResolvedGenui,\n        perRequestResolver?: GenuiCatalogResolver,\n      ) => genuiTools(catalog, toolOptions(options, resolved, perRequestResolver)),\n      [\n        GENUI_OPTIONS,\n        GENUI_CATALOG,\n        GENUI_RESOLVED,\n        { token: GenuiCatalogResolver, optional: true },\n      ],\n    ),\n  ];\n}\n\nconst EXPORTS = [GENUI_CATALOG, GENUI_OPTIONS, AGENT_GENUI];\n\n/**\n * Generative UI for the agent: registers the tools that let the model push catalog components\n * (one `ui__render` tree tool, or `ui__show_<component>` per component, and/or the generic\n * `ui__show`), and makes the catalog\n * injectable. Global, like `AgentModule`; import it once, next to it.\n *\n * ```ts\n * AgentGenuiModule.forRoot({ catalog, mode: 'tree', terminal: true })\n * ```\n */\n@Module({})\nexport class AgentGenuiModule {\n  static forRoot(options: AgentGenuiModuleOptions = {}): DynamicModule {\n    const { resolver, ...rest } = options;\n    return {\n      module: AgentGenuiModule,\n      global: true,\n      providers: [{ provide: GENUI_OPTIONS, useValue: rest }, ...coreProviders(resolver)],\n      exports: resolver === undefined ? EXPORTS : [...EXPORTS, GenuiCatalogResolver],\n    };\n  }\n\n  static forRootAsync(options: AgentGenuiModuleAsyncOptions): DynamicModule {\n    return {\n      module: AgentGenuiModule,\n      global: true,\n      imports: options.imports ?? [],\n      providers: [\n        { provide: GENUI_OPTIONS, useFactory: options.useFactory, inject: options.inject ?? [] },\n        ...coreProviders(options.resolver),\n      ],\n      exports: options.resolver === undefined ? EXPORTS : [...EXPORTS, GenuiCatalogResolver],\n    };\n  }\n}\n","import {\n  type FunctionalToolDefinition,\n  type ToolHandler,\n  type ToolSpec,\n  createFunctionalTool,\n} from '@dudousxd/nestjs-agent-core';\nimport type { FactoryProvider, Provider } from '@nestjs/common';\n\n/**\n * Brand stamped onto a functional-tool provider instance so `AiToolDiscoveryService` picks it up\n * when it walks every provider at boot — the declarative alternative to a manual `registry.register`.\n */\nexport const AGENT_TOOL_BRAND = Symbol.for('@dudousxd/nestjs-agent:functional-tool');\n\n/** A tool expressed as data + handler (e.g. from `createExecuteSqlTool`), not an `@AiTool` class. */\nexport interface FunctionalTool {\n  spec: ToolSpec;\n  handler: ToolHandler;\n}\n\n/** A {@link FunctionalTool} carrying {@link AGENT_TOOL_BRAND} — what a provider resolves to. */\nexport interface BrandedFunctionalTool extends FunctionalTool {\n  readonly [AGENT_TOOL_BRAND]: true;\n}\n\nfunction brand(tool: FunctionalTool): BrandedFunctionalTool {\n  return { [AGENT_TOOL_BRAND]: true, spec: tool.spec, handler: tool.handler };\n}\n\n/** Narrows a provider instance to a branded functional tool for boot-time registration. */\nexport function isBrandedFunctionalTool(value: object): value is BrandedFunctionalTool {\n  return AGENT_TOOL_BRAND in value && 'spec' in value && 'handler' in value;\n}\n\n/**\n * Registers a functional tool declaratively — drop the returned provider in a module's `providers`\n * and `AiToolDiscoveryService` auto-registers it at boot. Each call uses a fresh, unique provide\n * token so the same tool can be provided many times without collisions.\n *\n * Two forms: a static tool (`useValue`) or a factory with `inject` for DI-resolved dependencies\n * (`useFactory`). Either way the resolved instance is branded with {@link AGENT_TOOL_BRAND}.\n */\nexport function provideAgentTool(tool: FunctionalTool): Provider;\nexport function provideAgentTool(\n  factory: (...deps: never[]) => FunctionalTool,\n  inject?: FactoryProvider['inject'],\n): Provider;\nexport function provideAgentTool(\n  factoryOrTool: FunctionalTool | ((...deps: never[]) => FunctionalTool),\n  inject?: FactoryProvider['inject'],\n): Provider {\n  const provide = Symbol('nestjs-agent:functional-tool-instance');\n  if (typeof factoryOrTool === 'function') {\n    return {\n      provide,\n      useFactory: (...deps: never[]) => brand(factoryOrTool(...deps)),\n      inject: inject ?? [],\n    };\n  }\n  return { provide, useValue: brand(factoryOrTool) };\n}\n\n/**\n * Registers a LIST of functional tools from one factory — for a producer whose tool count is only\n * known once its dependencies resolve (a catalog loaded from config, one tool per entry). The\n * factory's result is branded element by element; `AiToolDiscoveryService` registers each.\n */\nexport function provideAgentTools(\n  factory: (...deps: never[]) => readonly FunctionalTool[] | Promise<readonly FunctionalTool[]>,\n  inject?: FactoryProvider['inject'],\n): Provider {\n  return {\n    provide: Symbol('nestjs-agent:functional-tool-list'),\n    useFactory: async (...deps: never[]) => (await factory(...deps)).map(brand),\n    inject: inject ?? [],\n  };\n}\n\n/** Author a functional tool with inferred Standard Schema input and domain output. */\nexport const defineTool = createFunctionalTool;\nexport type { FunctionalToolDefinition };\n","import type {\n  Catalog,\n  GenuiCatalogScope,\n  GenuiChannelBase,\n  GenuiChannels,\n  SandboxClientConfig,\n} from '@dudousxd/nestjs-agent-core/genui';\n\n/**\n * The app's genui setup ({@link AgentGenui}): the catalog, the per-channel options and what the\n * sandbox renderer is told — what the text channels (`@dudousxd/nestjs-agent-channels`) and\n * `GET <base>/config` read.\n */\nexport const AGENT_GENUI = Symbol.for('@dudousxd/nestjs-agent:genui');\n\n/**\n * The app's genui setup, bound to {@link AGENT_GENUI}: what a text channel draws with\n * (`catalog`, `channels`, `base`) and what the sandbox renderer is told (`sandboxClient`).\n */\nexport class AgentGenui {\n  constructor(\n    readonly catalog: Catalog,\n    readonly resolveCatalog?: (scope: GenuiCatalogScope) => Catalog | Promise<Catalog>,\n    /** `AgentGenuiModule.forRoot({ channels })`, when configured. */\n    readonly channels?: GenuiChannels,\n    /** The top-level options a channel falls back to. */\n    readonly base: GenuiChannelBase = {},\n    /** What the sandbox renderer is told, when a sandbox is configured. */\n    readonly sandboxClient?: () => SandboxClientConfig,\n  ) {}\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAgBA,YAeaA;AA/Bb;;;AAgBA,iBAQO;AAOA,IAAMA,8BAA8B;;;;;AC/B3C;;;;;AAqBO,SAASC,wBACdC,UAAuC,CAAC,GAAC;AAEzC,QAAMC,WAAWD,QAAQC,YAAYC;AACrC,aAAOC,iCAAoB;IACzBC,UAAMC,0BAAQL,QAAQI,QAAQE,QAAQC,IAAG,CAAA;IACzCC,YAAYR,QAAQQ,cAAcC;IAClC,GAAIR,aAAa,QAAQ;MAAEA,UAAU;QAAES,MAAMT,SAASS;QAAMC,QAAQV,SAASU;MAAO;IAAE,IAAI,CAAC;IAC3F,GAAIX,QAAQY,WAAWC,SAAY;MAAED,QAAQZ,QAAQY;IAAO,IAAI,CAAC;IACjE,GAAIZ,QAAQc,eAAeD,SAAY;MAAEC,YAAYd,QAAQc;IAAW,IAAI,CAAC;EAC/E,CAAA;AACF;AAhCA,IAMA,kBACAC,aAQab;AAfb;;;AAMA,uBAAwB;AACxB,IAAAa,cAGO;AACP;AAIO,IAAMb,4BAA4Bc,OAAOC,OAAO;MACrDP,MAAM;MACNC,QAAQ;IACV,CAAA;AAGgBZ;;;;;ACrBhB;;;;;;AAQA,yBAAc,6CARd;;;ACAA,IAAAmB,4BAAyD;AACzD,kBAUO;AACP,mBAIO;AACP,IAAAC,gBAMO;AACP,IAAAC,iBAcO;;;AC/BA,IAAMC,gBAAgBC,uBAAOC,IAAI,sCAAA;;;ACKxC,mBAQO;AACP,oBAQO;;;AC7BP,+BAKO;AAOA,IAAMC,mBAAmBC,uBAAOC,IAAI,wCAAA;AAa3C,SAASC,MAAMC,MAAoB;AACjC,SAAO;IAAE,CAACJ,gBAAAA,GAAmB;IAAMK,MAAMD,KAAKC;IAAMC,SAASF,KAAKE;EAAQ;AAC5E;AAFSH;AA0CF,SAASI,kBACdC,SACAC,QAAkC;AAElC,SAAO;IACLC,SAASC,uBAAO,mCAAA;IAChBC,YAAY,iCAAUC,UAAmB,MAAML,QAAAA,GAAWK,IAAAA,GAAOC,IAAIC,KAAAA,GAAzD;IACZN,QAAQA,UAAU,CAAA;EACpB;AACF;AATgBF;;;ACtDT,IAAMS,cAAcC,uBAAOC,IAAI,8BAAA;AAM/B,IAAMC,aAAN,MAAMA;EAXb,OAWaA;;;;;;;;EACX,YACWC,SACAC,gBAEAC,UAEAC,OAAyB,CAAC,GAE1BC,eACT;SARSJ,UAAAA;SACAC,iBAAAA;SAEAC,WAAAA;SAEAC,OAAAA;SAEAC,gBAAAA;EACR;AACL;;;;;;;;;;;;;;;;;AFMO,IAAMC,gBAAgBC,uBAAOC,IAAI,sCAAA;AAGjC,IAAMC,gBAAgBF,uBAAOC,IAAI,sCAAA;AAGxC,IAAME,iBAAiBH,uBAAOC,IAAI,uCAAA;AAgB3B,IAAeG,uBAAf,MAAeA;SAAAA;;;AAEtB;AAwHA,SAASC,kBAAkBC,UAAoC;AAC7D,MAAIA,aAAaC,OAAW,QAAO,CAAA;AACnC,SAAO;IACL,OAAOD,aAAa,aAChB;MAAEE,SAASJ;MAAsBK,UAAUH;IAAS,IACpD;MAAEE,SAASJ;MAAsBM,UAAUJ;IAAS;;AAE5D;AAPSD;AAmBT,SAASM,oBAAoBC,SAAyC;AACpE,QAAMC,SAA8B;IAAEC,OAAO;EAAM;AACnD,aAAWC,UAAUH,SAAS;AAC5B,UAAMI,MAAMD,OAAAA;AACZF,WAAOC,UAAUE,IAAIF;AACrB,QAAIE,IAAIC,QAAQV,OAAWM,QAAOI,QAAQD,IAAIC;AAC9C,QAAID,IAAIE,QAAQX,OAAWM,QAAOK,QAAQF,IAAIE;AAC9C,QAAIF,IAAIG,aAAaZ,OAAWM,QAAOM,aAAaH,IAAIG;EAC1D;AACA,SAAON;AACT;AAVSF;AAaT,eAAeS,aAAaC,SAA0B;AACpD,QAAM,EAAEC,SAASC,OAAOC,UAAUC,cAAa,IAAKJ;AACpDK,wCAAoBD,aAAAA;AAEpB,QAAMb,UAA4C,CAAA;AAClD,MAAIe;AACJ,QAAMC,iBAAiB,8BACrBC,UAAAA;AAEA,QAAIA,UAAUtB,UAAasB,UAAU,MAAO,QAAOA;AAEnD,UAAM,CAAC,EAAEC,yBAAAA,yBAAuB,GAAI,EAAEC,qBAAoB,CAAE,IAAI,MAAMC,QAAQC,IAAI;MAChF;MACA,OAAO,uCAAA;KACR;AACDN,kBAAcG,yBAAwBT,QAAQa,UAAU;AACxD,UAAMC,WAAWJ,qBAAqBF,OAAOF,SAAAA;AAC7Cf,YAAQwB,KAAKD,SAASpB,MAAM;AAC5B,WAAOoB,SAASE;EAClB,GAbuB;AAcvB,QAAMf,UAAU,MAAMM,eAAeL,KAAAA;AAGrC,QAAMe,MAAMjB,QAAQkB,SAASC,WAAWC,KAAK,CAACC,aAASC,8BAAgBD,IAAAA,MAAUnC,MAAAA;AAGjF,QAAMqC,aACJrB,UAAUhB,UAAa+B,KAAKO,mBAAmBtC,UAAa+B,IAAIQ,aAAa7B,QAAQ,OACjF,MAAMW,eAAe;IAAE,GAAGU,IAAIO;IAAgBE,MAAMT,IAAIS;EAAK,CAAA,IAC7DxC;AACN,MAAIiB;AACJ,MAAIC,kBAAkBlB,QAAW;AAC/BiB,eAAW,CAAC;AACZ,eAAW,CAACuB,MAAMC,KAAAA,KAAUC,OAAOC,QAAQzB,aAAAA,GAAgB;AACzD,UAAIuB,UAAUzC,OAAW;AACzB,YAAM+B,OAAM,MAAMV,eAAeoB,MAAM1B,OAAO;AAC9CE,eAASuB,IAAAA,IAAQ;QAAE,GAAGC;QAAO,GAAIV,SAAQ/B,SAAY;UAAEe,SAASgB;QAAI,IAAI,CAAC;MAAG;IAC9E;EACF;AACA,SAAO;IACL,GAAIhB,YAAYf,SAAY;MAAEe;IAAQ,IAAI,CAAC;IAC3C,GAAI,OAAOsB,eAAe,WAAW;MAAEO,gBAAgBP;IAAW,IAAI,CAAC;IACvE,GAAIpB,aAAajB,SAAY;MAAEiB;IAAS,IAAI,CAAC;IAC7C,GAAIZ,QAAQwC,SAAS,IAAI;MAAEC,eAAe,6BAAM1C,oBAAoBC,OAAAA,GAA1B;IAAmC,IAAI,CAAC;EACpF;AACF;AA7CeQ;AA+Cf,SAASkC,WACPhD,UAA0C;AAE1C,SAAOA,aAAaC,SAAYA,SAAY,CAACgD,UAA6BjD,SAASkD,QAAQD,KAAAA;AAC7F;AAJSD;AAMT,SAASG,YACPpC,SACAc,UACA7B,UAA0C;AAE1C,QAAM,EACJiC,SAASmB,UACTpC,SAASqC,UACTnC,UAAUoC,WACV1B,YAAY2B,aACZ,GAAGC,KAAAA,IACDzC;AACJ,QAAM0C,iBAAiBT,WAAWhD,QAAAA;AAClC,SAAO;IACL,GAAGwD;IACH,GAAI3B,SAASX,aAAajB,SAAY;MAAEiB,UAAUW,SAASX;IAAS,IAAI,CAAC;IACzE,GAAIW,SAASb,YAAYf,SAAY;MAAEe,SAASa,SAASb;IAAQ,IAAI,CAAC;IACtE,GAAIyC,mBAAmBxD,SAAY;MAAEwD;IAAe,IAAI,CAAC;EAC3D;AACF;AAnBSN;AAsBT,SAASO,YAAY3C,SAA4Bc,UAAuB;AACtE,QAAM8B,OAAO5C,QAAQkB,eAAW2B,4BAAc,CAAA,CAAE;AAChD,QAAM,EAAE5C,SAAS6B,eAAc,IAAKhB;AACpC,MAAIb,YAAYf,UAAae,YAAY,MACvC,QAAO6B,mBAAmB5C,SAAY0D,KAAKE,OAAO;QAACC,4BAAcjB,cAAAA;GAAgB,IAAIc;AACvF,SAAOA,KAAKE,OAAO;QAACC,4BAAc9C,YAAY,OAAO,CAAC,IAAIA,OAAAA;GAAS;AACrE;AANS0C;AAQT,SAASK,cAAc/D,UAAoC;AACzD,SAAO;IACL;MACEE,SAAS8D;MACTC,YAAY,wBAAClD,YAA+BD,aAAaC,OAAAA,GAA7C;MACZmD,QAAQ;QAACC;;IACX;IACA;MACEjE,SAASkE;MACTH,YAAY,wBAAClD,SAA4Bc,aACvC6B,YAAY3C,SAASc,QAAAA,GADX;MAEZqC,QAAQ;QAACC;QAAeH;;IAC1B;IACA;MACE9D,SAASmE;MACTJ,YAAY,wBACVlD,SACAkB,SACAJ,UACAyC,qBAEA,IAAIC,WACFtC,SACAe,WAAWsB,gBAAAA,GACXzC,SAASX,UACT;QACE,GAAIH,QAAQyD,SAASvE,SAAY;UAAEuE,MAAMzD,QAAQyD;QAAK,IAAI,CAAC;QAC3D,GAAIzD,QAAQ0D,cAAcxE,SAAY;UAAEwE,WAAW1D,QAAQ0D;QAAU,IAAI,CAAC;QAC1E,GAAI5C,SAASb,YAAYf,SAAY;UAAEe,SAASa,SAASb;QAAQ,IAAI,CAAC;MACxE,GACAa,SAASkB,aAAa,GAfd;MAiBZmB,QAAQ;QACNC;QACAC;QACAJ;QACA;UAAEU,OAAO5E;UAAsB6E,UAAU;QAAK;;IAElD;OACG5E,kBAAkBC,QAAAA;;;IAGrB4E,kBACE,CACE7D,SACAkB,SACAJ,UACAgD,2BACGC,yBAAW7C,SAASkB,YAAYpC,SAASc,UAAUgD,kBAAAA,CAAAA,GACxD;MACEV;MACAC;MACAJ;MACA;QAAEU,OAAO5E;QAAsB6E,UAAU;MAAK;KAC/C;;AAGP;AAzDSZ;AA2DT,IAAMgB,UAAU;EAACX;EAAeD;EAAeE;;AAaxC,IAAMW,mBAAN,MAAMA,kBAAAA;SAAAA;;;EACX,OAAOC,QAAQlE,UAAmC,CAAC,GAAkB;AACnE,UAAM,EAAEf,UAAU,GAAGwD,KAAAA,IAASzC;AAC9B,WAAO;MACLmE,QAAQF;MACRG,QAAQ;MACRC,WAAW;QAAC;UAAElF,SAASiE;UAAe/D,UAAUoD;QAAK;WAAMO,cAAc/D,QAAAA;;MACzEqF,SAASrF,aAAaC,SAAY8E,UAAU;WAAIA;QAASjF;;IAC3D;EACF;EAEA,OAAOwF,aAAavE,SAAsD;AACxE,WAAO;MACLmE,QAAQF;MACRG,QAAQ;MACRI,SAASxE,QAAQwE,WAAW,CAAA;MAC5BH,WAAW;QACT;UAAElF,SAASiE;UAAeF,YAAYlD,QAAQkD;UAAYC,QAAQnD,QAAQmD,UAAU,CAAA;QAAG;WACpFH,cAAchD,QAAQf,QAAQ;;MAEnCqF,SAAStE,QAAQf,aAAaC,SAAY8E,UAAU;WAAIA;QAASjF;;IACnE;EACF;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AF7UA,IAAM0F,WAAW;AAEjB,SAASC,SAASC,OAAc;AAC9B,SAAO,OAAOA,UAAU,YAAYA,UAAU,QAAQ,CAACC,MAAMC,QAAQF,KAAAA;AACvE;AAFSD;AAIT,SAASI,QAAQC,MAAcC,SAAe;AAC5C,SAAO,IAAIC,mCAAoB;IAAEC,YAAY;IAAKH;IAAMC;EAAQ,CAAA;AAClE;AAFSF;AAKT,SAASK,UAAUC,MAA+BC,KAAW;AAC3D,MAAID,KAAKC,GAAAA,MAASC,OAAW,QAAOF,KAAKC,GAAAA;AACzC,SAAOX,SAASU,KAAKG,QAAQ,IAAIH,KAAKG,SAASF,GAAAA,IAAOC;AACxD;AAHSH;AAMT,SAASK,cACPC,KACAC,UAAgB;AAEhB,MAAID,QAAQH,OAAW,QAAOA;AAC9B,MAAI,CAACZ,SAASe,GAAAA,KAAQ,CAACf,SAASe,IAAIE,QAAQ,GAAG;AAC7C,WAAO;EACT;AACA,MAAIC;AACJ,MAAI;AACFA,WAAO,IAAIC,YAAAA,EAAcC,OAAOC,KAAKC,UAAUP,IAAIE,QAAQ,CAAA,EAAGM;EAChE,QAAQ;AACN,WAAO;EACT;AACA,MAAIL,OAAOF,UAAU;AACnB,WAAO,sCAAsCA,QAAAA,uBAA+BE,IAAAA;EAC9E;AACA,SAAOM,OAAOC,KAAKV,IAAIE,QAAQ,EAAEM,SAAS,IAAIR,IAAIE,WAAWL;AAC/D;AAlBSE;AAwBF,IAAMY,iBAAN,MAAMA;SAAAA;;;;;;;;;EACX,YACqBC,OACAC,eACAC,YACAC,SACAC,gBACAC,oBAAwCpB,QAC3D;SANmBe,QAAAA;SACAC,gBAAAA;SACAC,aAAAA;SACAC,UAAAA;SACAC,iBAAAA;SACAC,oBAAAA;EAClB;;;;;;EAOH,MAAMC,OACJC,KACAC,UACAC,SAC6E;AAC7E,UAAMC,QAAQ,MAAM,KAAKT,cAAcU,QAAQJ,GAAAA;AAC/C,UAAMK,QAAQ,MAAM,KAAKZ,MAAMa,YAAYL,QAAAA;AAC3C,QAAII,UAAU,KAAM,QAAO;MAAEJ;MAAUM,SAAS,CAAA;IAAG;AACnD,UAAMC,SAAS,MAAM,KAAKf,MAAMgB,UAAUN,OAAOF,QAAAA;AACjD,UAAMS,YACJ,OAAOR,YAAY,WACf;MAACA;QACDlC,MAAMC,QAAQiC,OAAAA,IACZA,QAAQS,OAAO,CAACC,OAAqB,OAAOA,OAAO,QAAA,IACnDlC;AACR,WAAO;MACLuB;MACAM,aAASM,8BACPL,QAAQM,YAAY,CAAA,OACpBC,kCAAqB,KAAKpB,YAAYe,SAAAA,CAAAA;IAE1C;EACF;EAEA,MAAMM,OAAOhB,KAAciB,KAAepC,KAA6B;AACrE,UAAML,OAAOV,SAASe,GAAAA,IAAOA,MAAM,CAAC;AACpC,UAAMqC,YACJ,OAAO1C,KAAKiB,UAAU,YAAYjB,KAAKiB,MAAMJ,SAAS,IAAIb,KAAKiB,QAAQf;AACzE,UAAMyB,QAAQ,MAAM,KAAKT,cAAcU,QAAQJ,GAAAA;AAE/C,UAAML,iBAAaoB,kCACjB,KAAKpB,gBACLwB,wCAA2B5C,UAAUC,MAAM,wBAAA,CAAA,CAAA;AAE7C,UAAM4C,YAAYxC,cAChBL,UAAUC,MAAM,qBAAA,GAChB,KAAKsB,qBAAqB,KAAA;AAE5B,QAAI,OAAOsB,cAAc,SAAU,OAAMlD,QAAQ,sBAAsBkD,SAAAA;AAEvE,QAAIC;AACJ,QAAI7C,KAAK6C,WAAW3C,QAAW;AAC7B,YAAM4C,OAAOxD,SAASU,KAAK6C,MAAM,QAC7BE,4BAAe/C,KAAK6C,QAAQ;QAC1B,GAAI,KAAKxB,mBAAmBnB,SAAY;UAAEI,UAAU,KAAKe;QAAe,IAAI,CAAC;MAC/E,CAAA,IACA;AACJ,UAAI,OAAOyB,SAAS,SAAU,OAAMpD,QAAQ,kBAAkBoD,IAAAA;AAC9DD,eAASC;IACX;AAGA,QAAID,QAAQG,SAASC,mCAAuBJ,QAAQG,SAASE,gCAAoB;AAC/E,YAAMC,cAAcN,OAAOO,QAAQD;AACnC,YAAME,UAAU,OAAOF,gBAAgB,eAAWG,gCAAkBH,WAAAA,IAAejD;AACnF,UAAImD,YAAYnD,UAAamD,YAAY,QAAQA,QAAQE,SAAS,eAAe;AAC/E,cAAM7D,QAAQ,kBAAkB,uDAAA;MAClC;AAGA,UAAI2D,QAAQE,SAAS,YAAY;AAC/B,YAAIF,QAAQG,eAAetD,UAAamD,QAAQ5B,aAAavB,QAAW;AACtE,gBAAMR,QAAQ,kBAAkB,mCAAA;QAClC;AACA,cAAM+D,UAAU,MAAM,KAAKxC,MAAMyC,qBAC/B/B,OACA0B,QAAQ5B,UACR4B,QAAQG,YACR;UACEG,UAAUd,OAAOG,SAASC,kCAAsB,aAAa;UAC7DW,KAAKvE;QACP,CAAA;AAEF,aAAKwE,UAAUpB,KAAK;UAAE,qBAAqBY,QAAQ5B;QAAS,CAAA;AAC5D,cAAMqC,YAAY,IAAIC,0BAAc5C,UAAAA;AACpC,cAAM6C,YAAY,YAAYX,QAAQG,UAAU;AAChD,mBAAWS,SAAS;UAClB;YAAEC,MAAM;YAA+BF;YAAWG,MAAM;UAAqB;UAC7E;YAAED,MAAM;YAAiCF;YAAWI,OAAOX,QAAQY;UAAK;WACvE;AACD,qBAAWzE,YAAWkE,UAAUQ,QAAQL,KAAAA,EAAQxB,KAAI8B,MAAM,GAAG5D,KAAKC,UAAUhB,QAAAA,CAAAA;CAAY;QAC1F;AACA6C,YAAI+B,IAAG;AACP;MACF;AAGA,YAAM,KAAKvD,MAAMwD,gBAAgB9C,OAAO0B,QAAQqB,MAAM;AACtD,YAAM,KAAKzD,MAAM0D,cAAchD,OAAO0B,QAAQuB,UAAU;AACxD,UAAI/B,OAAOG,SAASC,iCAAqB;AACvC,cAAM,KAAKhC,MAAM4D,QAAQlD,OAAO0B,QAAQuB,YAAY;UAAEhB,KAAKvE;QAAS,CAAA;MACtE,OAAO;AACL,cAAM,KAAK4B,MAAM6D,OAAOnD,OAAO0B,QAAQuB,YAAY1E,QAAW;UAAE0D,KAAKvE;QAAS,CAAA;MAChF;AACA,YAAM,KAAKqF,OAAOjC,KAAKY,QAAQqB,QAAQ;QACrCK,MAAM1B,QAAQ2B;QACdC,UAAU;UAAC5B,QAAQuB;;QACnBzD;MACF,CAAA;AACA;IACF;AAEA,UAAMvB,UAAU,OAAOI,KAAKJ,YAAY,WAAWI,KAAKJ,UAAU;AAClE,UAAMyE,OAAOxB,WAAW3C,aAAYgF,4BAAarC,MAAAA,IAAUjD;AAC3D,QAAIyE,KAAKc,KAAI,EAAGtE,WAAW,GAAG;AAC5B,YAAMnB,QAAQ,mBAAmB,6BAAA;IACnC;AACA,UAAM+B,WACJ,OAAOzB,KAAKyB,aAAa,YAAYzB,KAAKyB,SAASZ,SAAS,IAAIb,KAAKyB,WAAWvB;AAClF,UAAM2B,QAAQJ,aAAavB,SAAY,MAAM,KAAKe,MAAMa,YAAYL,QAAAA,IAAY;AAChF,QAAII,UAAU,QAAQA,UAAUF,MAAMS,IAAI;AACxC,YAAM,IAAIgD,kCAAmB,iCAAA;IAC/B;AACA,QAAIC;AACJ,QAAIvE,OAAOwE,OAAOtF,MAAM,gBAAA,GAAmB;AACzC,UAAI;AACFqF,6BAAiBE,sCAAuBvF,KAAKqF,cAAc;MAC7D,SAASG,OAAO;AACd,cAAM9F,QAAQ,iBAAkB8F,MAAgB5F,OAAO;MACzD;IACF;AACA,UAAM6F,UAAU,MAAM,KAAKxE,MAAMyE,KAAK;MACpC/D;MACA/B,SAASyE;MACT,GAAI5C,aAAavB,SAAY,CAAC,IAAI2B,UAAU,OAAO;QAAEJ;MAAS,IAAI;QAAEkE,aAAalE;MAAS;MAC1F,GAAIiB,cAAcxC,SAAY;QAAEwC;MAAU,IAAI,CAAC;MAC/C,GAAI2C,mBAAmBnF,SAAY;QAAEmF;MAAe,IAAI,CAAC;MACzD,GAAIzC,cAAc1C,SAAY;QAAE0F,aAAa;UAAEC,eAAejD;QAAU;MAAE,IAAI,CAAC;IACjF,CAAA;AACA,UAAM,KAAK8B,OAAOjC,KAAKgD,QAAQK,OAAO;MAAErE,UAAUgE,QAAQhE;MAAUN;IAAW,CAAA;EACjF;;EAGU0C,UAAUpB,KAAesD,OAAqC;AACtEtD,QAAIuD,OAAO,GAAA;AACXvD,QAAIwD,UAAU,gBAAgB,kCAAA;AAC9BxD,QAAIwD,UAAU,iBAAiB,wBAAA;AAC/BxD,QAAIwD,UAAU,cAAc,YAAA;AAC5BxD,QAAIwD,UAAU,qBAAqB,IAAA;AACnC,eAAW,CAACjD,MAAMzD,KAAAA,KAAUuB,OAAOiB,QAAQgE,KAAAA,EAAQtD,KAAIwD,UAAUjD,MAAMzD,KAAAA;AACvEkD,QAAIyD,aAAY;EAClB;;EAGA,MAAgBxB,OACdjC,KACAqD,OACAK,SAMe;AACf,SAAKtC,UAAUpB,KAAK;MAClB,kBAAkBqD;MAClB,GAAIK,QAAQ1E,aAAavB,SAAY;QAAE,qBAAqBiG,QAAQ1E;MAAS,IAAI,CAAC;IACpF,CAAA;AACA,UAAMqC,YAAY,IAAIC,0BAAcoC,QAAQhF,cAAc,KAAKA,UAAU;AACzE,UAAMoD,QAAQ,wBAACjC,aAAAA;AACb,iBAAW1C,WAAW0C,SAAUG,KAAI8B,MAAM,GAAG5D,KAAKC,UAAUhB,OAAAA,CAAAA;CAAY;IAC1E,GAFc;AAGd,QAAI;AACF,YAAMwG,aAASC,mCAAqB,KAAKpF,MAAMqF,UAAUR,KAAAA,CAAAA;AACzD,uBAAiB7B,aAASsC,yBAAWH,QAAQ;QAC3C3E,UAAU0E,QAAQ1E,YAAYqE;QAC9BA;QACAU,aAAaV;QACb,GAAIK,QAAQ1E,aAAavB,SAAY;UAAEuG,gBAAgBN,QAAQ1E;QAAS,IAAI,CAAC;QAC7E,GAAI0E,QAAQpB,SAAS7E,SAAY;UAAE6E,MAAMoB,QAAQpB;QAAK,IAAI,CAAC;QAC3D,GAAIoB,QAAQlB,aAAa/E,SAAY;UAAE+E,UAAUkB,QAAQlB;QAAS,IAAI,CAAC;QACvE,GAAI,KAAK7D,YAAYlB,SAAY;UAAEkB,SAAS,KAAKA;QAAQ,IAAI,CAAC;MAChE,CAAA,GAAI;AACFmD,cAAMT,UAAUQ,QAAQL,KAAAA,CAAAA;MAC1B;IACF,QAAQ;AACNM,YAAMT,UAAUQ,QAAQ;QAAEJ,MAAM;QAAatE,SAAS;MAAiC,CAAA,CAAA;IACzF;AACA6C,QAAI+B,IAAG;EACT;AACF;AAoCO,SAASkC,YAAYP,UAA8B,CAAC,GAAC;AAC1D,QAAMQ,QAAQR,QAAQQ,QAAQ,QAAQC,QAAQ,cAAc,EAAA;AAC5D,QAAM,EAAED,MAAME,OAAOzF,SAASC,gBAAgBC,mBAAmB,GAAGH,WAAAA,IAAegF;AAEnF,MACMW,iBADN,MACMA,uBAAuB9F,eAAAA;WAAAA;;;IAC3B,YAEyBC,OACOC,eACKQ,SACnC;AACA,YACET,OACAC,eACAC,WAAWO,YAAYxB,UAAawB,YAAYxB,SAC5C;QAAE,GAAGiB;QAAYO;MAAQ,IACzBP,YACJC,SACAC,gBACAC,iBAAAA;IAEJ;IAGAU,OACSR,KACYC,UACDC,SACoB;AACtC,aAAO,KAAKH,OAAOC,KAAKC,UAAUC,OAAAA;IACpC;IAIAqF,IAAWvF,KAAqBiB,KAAuBzC,MAA8B;AACnF,aAAO,KAAKwC,OAAOhB,KAAKiB,KAAKzC,IAAAA;IAC/B;EACF;;+BAdU2G,IAAAA,oBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBjC,SAAO;IAAE3D,MAAM;IAAQgE,aAAa;MAACF;;EAAgB;AACvD;AAzCgBJ;","names":["NEST_SANDBOX_KIT_DESCRIPTOR","nestSandboxKitDiscovery","options","manifest","NEST_SANDBOX_KIT_MANIFEST","sandboxKitDiscovery","root","resolve","process","cwd","descriptor","NEST_SANDBOX_KIT_DESCRIPTOR","file","outDir","kitUrl","undefined","production","import_kit","Object","freeze","import_nestjs_agent_core","import_genui","import_common","AGENT_SERVICE","Symbol","for","AGENT_TOOL_BRAND","Symbol","for","brand","tool","spec","handler","provideAgentTools","factory","inject","provide","Symbol","useFactory","deps","map","brand","AGENT_GENUI","Symbol","for","AgentGenui","catalog","resolveCatalog","channels","base","sandboxClient","GENUI_CATALOG","Symbol","for","GENUI_OPTIONS","GENUI_RESOLVED","GenuiCatalogResolver","resolverProviders","resolver","undefined","provide","useClass","useValue","mergeSandboxClients","clients","merged","theme","client","one","kit","css","tailwind","resolveGenui","options","sandbox","asked","channels","askedChannels","assertGenuiChannels","discovery","resolveSandbox","value","nestSandboxKitDiscovery","resolveSandboxServer","Promise","all","sandboxKit","resolved","push","define","own","catalog","components","find","each","sandboxPolicyOf","ownOptions","sandboxOptions","sandboxView","name","entry","Object","entries","catalogSandbox","length","sandboxClient","perRequest","scope","resolve","toolOptions","_catalog","_sandbox","_channels","_sandboxKit","rest","resolveCatalog","withSandbox","base","defineCatalog","extend","defineSandbox","coreProviders","GENUI_RESOLVED","useFactory","inject","GENUI_OPTIONS","GENUI_CATALOG","AGENT_GENUI","resolverInstance","AgentGenui","mode","streaming","token","optional","provideAgentTools","perRequestResolver","genuiTools","EXPORTS","AgentGenuiModule","forRoot","module","global","providers","exports","forRootAsync","imports","A2UI_VIA","isRecord","value","Array","isArray","invalid","code","message","BadRequestException","statusCode","bodyField","body","key","undefined","metadata","readDataModel","raw","maxBytes","surfaces","size","TextEncoder","encode","JSON","stringify","length","Object","keys","A2uiRunHandler","agent","actorResolver","projection","quietMs","maxActionBytes","maxDataModelBytes","replay","req","threadId","catalog","actor","resolve","owner","threadOwner","entries","thread","getThread","supported","filter","id","a2uiThreadReplay","messages","negotiateA2uiCatalog","handle","res","agentName","readA2uiClientCapabilities","dataModel","action","read","readA2uiAction","name","A2UI_APPROVE_ACTION","A2UI_REJECT_ACTION","interruptId","context","address","decodeInterruptId","kind","proposalId","decided","decideActionProposal","decision","via","writeHead","projector","A2uiProjector","messageId","event","type","role","delta","text","project","write","end","assertResumable","stream","checkDecision","toolCallId","approve","reject","skip","position","answered","uiActionText","trim","ForbiddenException","uiCapabilities","hasOwn","validateUiCapabilities","error","started","chat","newThreadId","pageContext","a2uiDataModel","runId","extra","status","setHeader","flushHeaders","options","frames","agUiFramesFromNdjson","subscribe","agUiEvents","streamRunId","streamThreadId","a2uiAdapter","path","replace","_path","A2uiController","run","controllers"]}
+{"version":3,"sources":["../../src/vite/index.ts","../../src/genui/kit.ts","../../src/a2ui/index.ts","../../src/a2ui/a2ui.adapter.ts","../../src/agent-service.token.ts","../../src/genui/agent-genui.module.ts","../../src/functional-tool.ts","../../src/genui/agent-genui.token.ts"],"sourcesContent":["/**\n * `@dudousxd/nestjs-agent/vite` — `genuiSandboxKit()`, the Vite plugin that puts the app's design\n * system (its styles, its components, its providers) inside the sandbox, whatever the stack:\n *\n * ```ts\n * // vite.config.ts (the SPA that talks to the agent)\n * import { genuiSandboxKit } from '@dudousxd/nestjs-agent/vite'\n * export default defineConfig({\n *   plugins: [react(), genuiSandboxKit({ styles: 'src/index.css', components: 'src/components/ui' })],\n * })\n * ```\n *\n * Then `AgentGenuiModule.forRoot({ sandbox: { kit: true } })` finds what it built: the descriptor\n * the dev server writes (`.genui/sandbox-kit.json`) in dev, the Vite manifest in production (see\n * `AgentGenuiOptions.sandboxKit`).\n */\nimport {\n  type GenuiSandboxKitApi,\n  type GenuiSandboxKitOptions,\n  type GenuiSandboxKitPlugin,\n  SANDBOX_KIT_DEV_PREFIX,\n  SANDBOX_KIT_MANIFEST_KEYS,\n  SANDBOX_KIT_UPDATE_EVENT,\n  createGenuiSandboxKitPlugin,\n} from '@dudousxd/nestjs-agent-core/genui/kit';\n\n/**\n * Where the dev descriptor is written, relative to the Vite root — and where the server reads it,\n * relative to its working directory (run both from the project root, or point\n * `sandboxKit.descriptor` at it). Add `.genui/` to `.gitignore`.\n */\nexport const NEST_SANDBOX_KIT_DESCRIPTOR = '.genui/sandbox-kit.json';\n\n/**\n * The sandbox kit plugin: `styles` (the app's style entries — default, the stylesheets among its\n * Vite entrypoints or `index.html`), `components` (modules or globs exporting React components —\n * default, the first `components/ui` folder), `wrapper` (a module whose default export wraps the\n * model's App). See {@link GenuiSandboxKitOptions}.\n */\nexport function genuiSandboxKit(options: GenuiSandboxKitOptions = {}): GenuiSandboxKitPlugin {\n  return createGenuiSandboxKitPlugin(options, {\n    descriptor: NEST_SANDBOX_KIT_DESCRIPTOR,\n    rendererImport: /@dudousxd\\/nestjs-agent-react/,\n  });\n}\n\nexport {\n  type GenuiSandboxKitApi,\n  type GenuiSandboxKitOptions,\n  type GenuiSandboxKitPlugin,\n  SANDBOX_KIT_DEV_PREFIX,\n  SANDBOX_KIT_MANIFEST_KEYS,\n  SANDBOX_KIT_UPDATE_EVENT,\n};\n","/**\n * The sandbox kit in a Nest app. No Vite runs in the Nest process, so the kit is found in files:\n * the descriptor `genuiSandboxKit()` (`@dudousxd/nestjs-agent/vite`) writes while the dev server\n * runs, and in production the Vite manifest the build wrote (`genui-sandbox-kit.json` and the assets\n * it names). Node-only: loaded by {@link AgentGenuiModule} only when a sandbox is configured.\n */\nimport { resolve } from 'node:path';\nimport {\n  type SandboxKitDiscovery,\n  sandboxKitDescriptorPath,\n  sandboxKitDiscovery,\n} from '@dudousxd/nestjs-agent-core/genui/kit';\nimport { NEST_SANDBOX_KIT_DESCRIPTOR } from '../vite/index.js';\nimport type { AgentGenuiSandboxKitOptions } from './agent-genui.module.js';\n\n/** Where the production Vite manifest is looked for by default, and the directory it is relative to. */\nexport const NEST_SANDBOX_KIT_MANIFEST = Object.freeze({\n  file: 'public/.vite/manifest.json',\n  outDir: 'public',\n});\n\n/**\n * Find the kit for `AgentGenuiModule.forRoot({ sandbox: { kit: true } })` — a named kit's\n * (`genuiSandboxKit({ name })`, `sandbox: { kit: true, kitName }`) with `name`.\n */\nexport function nestSandboxKitDiscovery(\n  options: AgentGenuiSandboxKitOptions = {},\n  name?: string,\n): SandboxKitDiscovery {\n  const manifest = options.manifest ?? NEST_SANDBOX_KIT_MANIFEST;\n  return sandboxKitDiscovery({\n    root: resolve(options.root ?? process.cwd()),\n    ...(name !== undefined ? { name } : {}),\n    descriptor: sandboxKitDescriptorPath(options.descriptor ?? NEST_SANDBOX_KIT_DESCRIPTOR, name),\n    ...(manifest !== false ? { manifest: { file: manifest.file, outDir: manifest.outDir } } : {}),\n    ...(options.kitUrl !== undefined ? { kitUrl: options.kitUrl } : {}),\n    ...(options.cssUrl !== undefined ? { cssUrl: options.cssUrl } : {}),\n    ...(options.tailwindUrl !== undefined ? { tailwindUrl: options.tailwindUrl } : {}),\n    ...(options.production !== undefined ? { production: options.production } : {}),\n  });\n}\n","/**\n * `@dudousxd/nestjs-agent/a2ui` — A2UI (https://a2ui.org, v0.9) for the agent: the `a2uiAdapter()`\n * route (JSON Lines of A2UI messages), and the framework-free pieces it is built from (re-exported\n * from `@dudousxd/nestjs-agent-core/a2ui`) — the `ui` frame → A2UI converter, the builtin →\n * basic-catalog mappings, the catalog export, the inbound action reader. For A2UI over AG-UI, pass\n * `a2ui: true` to `agUiAdapter()`.\n */\n\nexport * from '@dudousxd/nestjs-agent-core/a2ui';\nexport { type A2uiAdapterOptions, A2uiRunHandler, a2uiAdapter } from './a2ui.adapter.js';\n","import { AGENT_ACTOR_RESOLVER, type ActorResolver } from '@dudousxd/nestjs-agent-core';\nimport {\n  A2UI_APPROVE_ACTION,\n  A2UI_REJECT_ACTION,\n  A2uiProjector,\n  type A2uiServerMessage,\n  type A2uiStreamOptions,\n  a2uiThreadReplay,\n  negotiateA2uiCatalog,\n  readA2uiAction,\n  readA2uiClientCapabilities,\n} from '@dudousxd/nestjs-agent-core/a2ui';\nimport {\n  agUiEvents,\n  agUiFramesFromNdjson,\n  decodeInterruptId,\n} from '@dudousxd/nestjs-agent-core/ag-ui';\nimport {\n  type Catalog,\n  type UiAction,\n  type UiCapabilities,\n  uiActionText,\n  validateUiCapabilities,\n} from '@dudousxd/nestjs-agent-core/genui';\nimport {\n  BadRequestException,\n  Body,\n  Controller,\n  ForbiddenException,\n  Get,\n  HttpCode,\n  Inject,\n  Optional,\n  Param,\n  Post,\n  Query,\n  Req,\n  Res,\n} from '@nestjs/common';\nimport type { Request, Response } from 'express';\nimport { AGENT_SERVICE } from '../agent-service.token.js';\nimport type { AgentService } from '../agent.service.js';\nimport { GENUI_CATALOG } from '../genui/agent-genui.module.js';\nimport type { AgentProtocolAdapter } from '../protocol-adapter.js';\n\nexport interface A2uiAdapterOptions extends A2uiStreamOptions {\n  /** Where the route mounts, under the agent's path. Default `'a2ui'` → `POST <path>/a2ui`. */\n  path?: string;\n  /** As `agUiAdapter`'s: how long a run waiting on a person may stay silent before the stream ends. */\n  quietMs?: number;\n  /** Largest action accepted, as JSON, in bytes. Default 8192. */\n  maxActionBytes?: number;\n  /** Largest `a2uiClientDataModel` accepted, as JSON, in bytes. Default 32768. */\n  maxDataModelBytes?: number;\n}\n\n/** The surface an A2UI decision is recorded as having come through. */\nconst A2UI_VIA = 'a2ui';\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction invalid(code: string, message: string): BadRequestException {\n  return new BadRequestException({ statusCode: 400, code, message });\n}\n\n/** A field of the body, or of its A2A-style `metadata` (where A2UI puts client capabilities). */\nfunction bodyField(body: Record<string, unknown>, key: string): unknown {\n  if (body[key] !== undefined) return body[key];\n  return isRecord(body.metadata) ? body.metadata[key] : undefined;\n}\n\n/** `a2uiClientDataModel` (`{ version, surfaces: { <surfaceId>: model } }`): its surfaces, or why not. */\nfunction readDataModel(\n  raw: unknown,\n  maxBytes: number,\n): Record<string, unknown> | undefined | string {\n  if (raw === undefined) return undefined;\n  if (!isRecord(raw) || !isRecord(raw.surfaces)) {\n    return 'a2uiClientDataModel carries { version, surfaces }';\n  }\n  let size: number;\n  try {\n    size = new TextEncoder().encode(JSON.stringify(raw.surfaces)).length;\n  } catch {\n    return 'a2uiClientDataModel must be JSON';\n  }\n  if (size > maxBytes) {\n    return `a2uiClientDataModel may be at most ${maxBytes} bytes (this one is ${size})`;\n  }\n  return Object.keys(raw.surfaces).length > 0 ? raw.surfaces : undefined;\n}\n\n/**\n * Serves the agent as an A2UI agent. Not mounted directly — {@link a2uiAdapter} mounts a subclass at\n * the configured path — but exported so a host can extend it under a route of its own.\n */\nexport class A2uiRunHandler {\n  constructor(\n    protected readonly agent: AgentService,\n    protected readonly actorResolver: ActorResolver,\n    protected readonly projection: A2uiStreamOptions,\n    protected readonly quietMs: number | undefined,\n    protected readonly maxActionBytes: number | undefined,\n    protected readonly maxDataModelBytes: number | undefined = undefined,\n  ) {}\n\n  /**\n   * `GET <path>/a2ui/threads/:threadId`: a stored thread as `{ threadId, entries }`\n   * (`a2uiThreadReplay`) — what a client draws again after a reload. Owner-scoped; a thread nobody\n   * has answers `{ entries: [] }`. `?catalog=<id>` names the client's basic catalog id.\n   */\n  async replay(\n    req: Request,\n    threadId: string,\n    catalog: unknown,\n  ): Promise<{ threadId: string; entries: ReturnType<typeof a2uiThreadReplay> }> {\n    const actor = await this.actorResolver.resolve(req);\n    const owner = await this.agent.threadOwner(threadId);\n    if (owner === null) return { threadId, entries: [] };\n    const thread = await this.agent.getThread(actor, threadId);\n    const supported =\n      typeof catalog === 'string'\n        ? [catalog]\n        : Array.isArray(catalog)\n          ? catalog.filter((id): id is string => typeof id === 'string')\n          : undefined;\n    return {\n      threadId,\n      entries: a2uiThreadReplay(\n        thread?.messages ?? [],\n        negotiateA2uiCatalog(this.projection, supported),\n      ),\n    };\n  }\n\n  async handle(req: Request, res: Response, raw: unknown): Promise<void> {\n    const body = isRecord(raw) ? raw : {};\n    const agentName =\n      typeof body.agent === 'string' && body.agent.length > 0 ? body.agent : undefined;\n    const actor = await this.actorResolver.resolve(req);\n    // The basic catalog under the id this client advertises (`a2uiClientCapabilities`).\n    const projection = negotiateA2uiCatalog(\n      this.projection,\n      readA2uiClientCapabilities(bodyField(body, 'a2uiClientCapabilities')),\n    );\n    const dataModel = readDataModel(\n      bodyField(body, 'a2uiClientDataModel'),\n      this.maxDataModelBytes ?? 32768,\n    );\n    if (typeof dataModel === 'string') throw invalid('invalid_data_model', dataModel);\n\n    let action: UiAction | undefined;\n    if (body.action !== undefined) {\n      const read = isRecord(body.action)\n        ? readA2uiAction(body.action, {\n            ...(this.maxActionBytes !== undefined ? { maxBytes: this.maxActionBytes } : {}),\n          })\n        : 'action must be an A2UI action message';\n      if (typeof read === 'string') throw invalid('invalid_action', read);\n      action = read;\n    }\n\n    // Deciding the approval a stream ended on: settle it, then stream the rest of the run.\n    if (action?.name === A2UI_APPROVE_ACTION || action?.name === A2UI_REJECT_ACTION) {\n      const interruptId = action.context.interruptId;\n      const address = typeof interruptId === 'string' ? decodeInterruptId(interruptId) : undefined;\n      if (address === undefined || address === null || address.kind === 'elicitation') {\n        throw invalid('invalid_action', 'an approval action carries the interruptId it decides');\n      }\n      // An independent proposal: decided through the proposal service (its own run is not\n      // waiting), as an AG-UI resume decides it, and answered with the configured reply.\n      if (address.kind === 'proposal') {\n        if (address.proposalId === undefined || address.threadId === undefined) {\n          throw invalid('invalid_action', 'the interruptId names no proposal');\n        }\n        const decided = await this.agent.decideActionProposal(\n          actor,\n          address.threadId,\n          address.proposalId,\n          {\n            decision: action.name === A2UI_APPROVE_ACTION ? 'approved' : 'rejected',\n            via: A2UI_VIA,\n          },\n        );\n        this.writeHead(res, { 'X-Agent-Thread-Id': address.threadId });\n        const projector = new A2uiProjector(projection);\n        const messageId = `proposal-${address.proposalId}`;\n        for (const event of [\n          { type: 'TEXT_MESSAGE_START' as const, messageId, role: 'assistant' as const },\n          { type: 'TEXT_MESSAGE_CONTENT' as const, messageId, delta: decided.text },\n        ]) {\n          for (const message of projector.project(event)) res.write(`${JSON.stringify(message)}\\n`);\n        }\n        res.end();\n        return;\n      }\n      // The same checks an AG-UI resume makes: the run is the actor's and still waiting, and the\n      // actor may decide this call.\n      await this.agent.assertResumable(actor, address.stream);\n      await this.agent.checkDecision(actor, address.toolCallId);\n      if (action.name === A2UI_APPROVE_ACTION) {\n        await this.agent.approve(actor, address.toolCallId, { via: A2UI_VIA });\n      } else {\n        await this.agent.reject(actor, address.toolCallId, undefined, { via: A2UI_VIA });\n      }\n      await this.stream(res, address.stream, {\n        skip: address.position,\n        answered: [address.toolCallId],\n        projection,\n      });\n      return;\n    }\n\n    const message = typeof body.message === 'string' ? body.message : '';\n    const text = action !== undefined ? uiActionText(action) : message;\n    if (text.trim().length === 0) {\n      throw invalid('no_user_message', 'send a message or an action');\n    }\n    const threadId =\n      typeof body.threadId === 'string' && body.threadId.length > 0 ? body.threadId : undefined;\n    const owner = threadId !== undefined ? await this.agent.threadOwner(threadId) : null;\n    if (owner !== null && owner !== actor.id) {\n      throw new ForbiddenException('thread belongs to another actor');\n    }\n    let uiCapabilities: UiCapabilities | undefined;\n    if (Object.hasOwn(body, 'uiCapabilities')) {\n      try {\n        uiCapabilities = validateUiCapabilities(body.uiCapabilities);\n      } catch (error) {\n        throw invalid('invalid_input', (error as Error).message);\n      }\n    }\n    const started = await this.agent.chat({\n      actor,\n      message: text,\n      ...(threadId === undefined ? {} : owner !== null ? { threadId } : { newThreadId: threadId }),\n      ...(agentName !== undefined ? { agentName } : {}),\n      ...(uiCapabilities !== undefined ? { uiCapabilities } : {}),\n      ...(dataModel !== undefined ? { pageContext: { a2uiDataModel: dataModel } } : {}),\n    });\n    await this.stream(res, started.runId, { threadId: started.threadId, projection });\n  }\n\n  /** Open the JSON Lines response. */\n  protected writeHead(res: Response, extra: Record<string, string>): void {\n    res.status(200);\n    res.setHeader('Content-Type', 'application/jsonl; charset=utf-8');\n    res.setHeader('Cache-Control', 'no-cache, no-transform');\n    res.setHeader('Connection', 'keep-alive');\n    res.setHeader('X-Accel-Buffering', 'no');\n    for (const [name, value] of Object.entries(extra)) res.setHeader(name, value);\n    res.flushHeaders();\n  }\n\n  /** Write one run as A2UI JSON Lines, until it ends or stops to ask. */\n  protected async stream(\n    res: Response,\n    runId: string,\n    options: {\n      threadId?: string;\n      skip?: number;\n      answered?: string[];\n      projection?: A2uiStreamOptions;\n    },\n  ): Promise<void> {\n    this.writeHead(res, {\n      'X-Agent-Run-Id': runId,\n      ...(options.threadId !== undefined ? { 'X-Agent-Thread-Id': options.threadId } : {}),\n    });\n    const projector = new A2uiProjector(options.projection ?? this.projection);\n    const write = (messages: A2uiServerMessage[]) => {\n      for (const message of messages) res.write(`${JSON.stringify(message)}\\n`);\n    };\n    try {\n      const frames = agUiFramesFromNdjson(this.agent.subscribe(runId));\n      for await (const event of agUiEvents(frames, {\n        threadId: options.threadId ?? runId,\n        runId,\n        streamRunId: runId,\n        ...(options.threadId !== undefined ? { streamThreadId: options.threadId } : {}),\n        ...(options.skip !== undefined ? { skip: options.skip } : {}),\n        ...(options.answered !== undefined ? { answered: options.answered } : {}),\n        ...(this.quietMs !== undefined ? { quietMs: this.quietMs } : {}),\n      })) {\n        write(projector.project(event));\n      }\n    } catch {\n      write(projector.project({ type: 'RUN_ERROR', message: 'The run could not be followed.' }));\n    }\n    res.end();\n  }\n}\n\n/**\n * Serve the agent as an A2UI (https://a2ui.org, v0.9) agent: `POST <path>/a2ui` answers with the\n * run as a JSON Lines stream of A2UI server-to-client messages — `createSurface`,\n * `updateComponents`, `updateDataModel`, `deleteSurface` — that any A2UI renderer draws.\n *\n * ```ts\n * import { a2uiAdapter } from '@dudousxd/nestjs-agent/a2ui'\n *\n * AgentModule.forRoot({ model, adapters: [a2uiAdapter()] })\n * ```\n *\n * The body is `{ threadId?, message?, action?, uiCapabilities?, a2uiClientCapabilities?,\n * a2uiClientDataModel?, agent? }` (the two A2UI fields also read from `metadata`, A2A-style):\n *  - `message` — the user's text;\n *  - `action` — an A2UI client message (`{ version: 'v0.9', action: { name, surfaceId,\n *    sourceComponentId, timestamp, context } }`, or v0.8's `{ userAction }`): it becomes the turn\n *    (`uiActionText`). `agora.approve` / `agora.reject` with `context.interruptId` decide the\n *    approval a previous stream ended on, and stream the rest of that run (an independent\n *    proposal is decided through the proposal service and answered with its reply);\n *  - `threadId` — continue that thread (its owner is checked), or start one under that id;\n *  - `a2uiClientCapabilities` — the catalogs the client draws (`{ 'v0.9': { supportedCatalogIds } }`,\n *    what `MessageProcessor.getRendererCapabilities()` builds): the basic catalog is sent under the\n *    id the client lists for it;\n *  - `a2uiClientDataModel` — the data models of surfaces created with `sendDataModel`, handed to the\n *    prompt builder as `pageContext.a2uiDataModel`.\n *\n * `GET <path>/a2ui/threads/:threadId` answers a stored thread as `{ threadId, entries }`\n * (`a2uiThreadReplay`): what a client draws again after a reload.\n *\n * Response headers name the library's ids: `X-Agent-Thread-Id`, `X-Agent-Run-Id`. Authenticated by\n * the module's `actorResolver`, guarded by its `guards` and owner-scoped exactly as `chat` is.\n * Components nothing maps are drawn as their text, from the `AgentGenuiModule` catalog when there\n * is one (or `catalog` here).\n */\nexport function a2uiAdapter(options: A2uiAdapterOptions = {}): AgentProtocolAdapter {\n  const path = (options.path ?? 'a2ui').replace(/^\\/+|\\/+$/g, '');\n  const { path: _path, quietMs, maxActionBytes, maxDataModelBytes, ...projection } = options;\n\n  @Controller()\n  class A2uiController extends A2uiRunHandler {\n    constructor(\n      // Tokens, never classes: this entry is its own bundle (see AGENT_SERVICE).\n      @Inject(AGENT_SERVICE) agent: AgentService,\n      @Inject(AGENT_ACTOR_RESOLVER) actorResolver: ActorResolver,\n      @Optional() @Inject(GENUI_CATALOG) catalog?: Catalog,\n    ) {\n      super(\n        agent,\n        actorResolver,\n        projection.catalog === undefined && catalog !== undefined\n          ? { ...projection, catalog }\n          : projection,\n        quietMs,\n        maxActionBytes,\n        maxDataModelBytes,\n      );\n    }\n\n    @Get(`${path}/threads/:threadId`)\n    thread(\n      @Req() req: Request,\n      @Param('threadId') threadId: string,\n      @Query('catalog') catalog: unknown,\n    ): ReturnType<A2uiRunHandler['replay']> {\n      return this.replay(req, threadId, catalog);\n    }\n\n    @Post(path)\n    @HttpCode(200)\n    run(@Req() req: Request, @Res() res: Response, @Body() body: unknown): Promise<void> {\n      return this.handle(req, res, body);\n    }\n  }\n\n  return { name: 'a2ui', controllers: [A2uiController] };\n}\n","/**\n * `AgentService`, as the controllers of a secondary entry (`@dudousxd/nestjs-agent/a2ui`) ask for it.\n *\n * A token rather than the class: every entry is its own bundle with its own copy of every class it\n * imports, so the class used as an injection token there is not the one `AgentModule` provides.\n * `Symbol.for` is the same value in every bundle.\n */\nexport const AGENT_SERVICE = Symbol.for('@dudousxd/nestjs-agent:agent-service');\n","import type { ToolPresentation } from '@dudousxd/nestjs-agent-core';\nimport type {\n  Catalog,\n  GenuiAbility,\n  GenuiCatalogScope,\n  GenuiChannels,\n  GenuiStreaming,\n  GenuiToolsOptions,\n  SandboxClientConfig,\n  TreeLimits,\n  TreeSchemaMode,\n} from '@dudousxd/nestjs-agent-core/genui';\nimport {\n  type DefineSandboxOptions,\n  type SandboxDefinition,\n  assertGenuiChannels,\n  defineCatalog,\n  defineSandbox,\n  genuiTools,\n  sandboxPolicyOf,\n} from '@dudousxd/nestjs-agent-core/genui';\nimport {\n  type DynamicModule,\n  type FactoryProvider,\n  Inject,\n  Module,\n  type ModuleMetadata,\n  type Provider,\n  type Type,\n} from '@nestjs/common';\nimport { provideAgentTools } from '../functional-tool.js';\nimport { AGENT_GENUI, AgentGenui } from './agent-genui.token.js';\n\nexport { AGENT_GENUI, AgentGenui } from './agent-genui.token.js';\n\n/** The app's genui catalog — `@InjectGenuiCatalog()` it anywhere; `overrideProvider` it in tests. */\nexport const GENUI_CATALOG = Symbol.for('@dudousxd/nestjs-agent:genui-catalog');\n\n/** The resolved {@link AgentGenuiOptions} (without the resolver). */\nexport const GENUI_OPTIONS = Symbol.for('@dudousxd/nestjs-agent:genui-options');\n\n/** The sandbox and channels as boot resolved them (kit, Tailwind and theme found). Internal. */\nconst GENUI_RESOLVED = Symbol.for('@dudousxd/nestjs-agent:genui-resolved');\n\n/** Inject the app's genui catalog ({@link GENUI_CATALOG}). */\nexport const InjectGenuiCatalog = (): ParameterDecorator & PropertyDecorator =>\n  Inject(GENUI_CATALOG);\n\n/**\n * Picks the catalog for ONE request — a tenant's own, versioned components. Consulted when a genui\n * call is validated and when the turn's tool list is described to the model, so components can\n * change without rebuilding tools at boot. Cache in here if resolving costs a round trip: it runs\n * once per turn per genui tool, and once per call.\n *\n * Provide it through `AgentGenuiModule.forRoot({ resolver })` (a class, resolved with DI, or an\n * instance); it is then injectable, and replaceable in a test with\n * `overrideProvider(GenuiCatalogResolver)`.\n */\nexport abstract class GenuiCatalogResolver {\n  abstract resolve(scope: GenuiCatalogScope): Catalog | Promise<Catalog>;\n}\n\n/** What {@link AgentGenuiModule} builds tools from. */\nexport interface AgentGenuiOptions {\n  /**\n   * The catalog. With a {@link GenuiCatalogResolver} it is the boot-time one — it names the\n   * per-component tools — and may be empty. Default: an empty catalog.\n   */\n  catalog?: Catalog;\n  /**\n   * `tree` (default): one `ui__render` tool taking a composed tree (a single node is pushed as that\n   * component). `per-component`: one `ui__show_<snake>` tool per component.\n   */\n  mode?: 'per-component' | 'tree';\n  /** `ui__render`'s input schema: `'strict'` (default, a `$defs` union per component) or `'loose'`. */\n  treeSchema?: TreeSchemaMode;\n  /**\n   * Tree mode: `'complete'` (default) draws the tree once the call has run; `'partial'` streams it\n   * as `partial` ui frames while the model writes it. A component's own `streaming` overrides it.\n   */\n  streaming?: GenuiStreaming;\n  /** Least time between two partial tree frames of one call, in ms. Default 100. */\n  streamingThrottleMs?: number;\n  /** End the model's turn once a genui call succeeds (no narrating follow-up call). */\n  terminal?: boolean;\n  /** Tool name in `tree` mode. Default `ui__render`. */\n  treeToolName?: string;\n  /** Text prepended to the tree tool's description. */\n  treeInstructions?: string;\n  treeLimits?: TreeLimits;\n  /**\n   * Tree mode: components that ALSO get a flat tool whose input IS their props —\n   * `componentTools: ['Sandbox']` adds `ui__sandbox`, so a model writing a big component on its own\n   * has no `{ type, props }` envelope to leave out.\n   */\n  componentTools?: readonly string[];\n  /** Tool-name prefix for `componentTools`. Default `ui__` (`Sandbox` → `ui__sandbox`). */\n  componentToolPrefix?: string;\n  /** Tool-name prefix in `per-component` mode. Default `ui__show_`. */\n  namePrefix?: string;\n  /**\n   * Also register ONE generic tool taking `{ component, props }`, validated against the request's\n   * catalog — how a model reaches a tenant's own components, which no boot-time tool names. `true`\n   * names it `ui__show`.\n   */\n  showTool?: boolean | string;\n  /** Text prepended to the show tool's description. */\n  showInstructions?: string;\n  /** Roles allowed to call the tools. Undefined → the roles policy default. */\n  roles?: string[];\n  /**\n   * The authorization ability the UI tools declare (`ToolSpec.ability`), for an ability-aware\n   * authorizer such as `authzToolAuthorizer`, which denies a tool with none. A string for every\n   * tool; a map by tool name (`{ ui__render: 'genui.render', ui__sandbox: 'genui.sandbox' }`, a tool\n   * left out declares none); or a function of `{ name, component }`. The authorizer decides.\n   */\n  ability?: GenuiAbility;\n  /** Override the generated presentation per component (or per tree / show tool name). */\n  presentation?: (component: string) => ToolPresentation | undefined;\n  /**\n   * Add the sandbox component (`Sandbox`): the model may write HTML, CSS and JS for a one-off\n   * interactive answer when no catalog component fits. `true` for the defaults (no network), or\n   * the {@link DefineSandboxOptions} (a policy listing origins, extra instructions). Off by default.\n   * The browser's catalog should carry the same definition (`defineSandbox(...)` in the shared\n   * catalog file) so the renderer enforces the same policy.\n   *\n   * `theme` (default on) and `kit` put the app's design system in the frame: `kit: true` turns on\n   * whatever `genuiSandboxKit()` built (styles, Tailwind, components, wrapper, docs), found through\n   * `sandboxKit`: the descriptor\n   * `genuiSandboxKit()` (`@dudousxd/nestjs-agent/vite`) writes in dev, the Vite manifest in\n   * production — and `GET <base>/config` tells the renderer where the assets are.\n   */\n  sandbox?: boolean | DefineSandboxOptions;\n  /**\n   * Per-channel generative UI: each entry sets the mode, streaming, sandbox and rendering of one\n   * channel (`web`, `mobile`, `whatsapp`, `telegram`, `email`, or `default` for the rest), over the\n   * top-level options. A text channel (`@dudousxd/nestjs-agent-channels`) configured here draws the\n   * components natively (reply buttons, lists, images). Omitted → every channel is served by the\n   * top-level options, as before.\n   */\n  channels?: GenuiChannels;\n  /**\n   * Where the sandbox kit is found (with `sandbox: { kit: true }` or the theme's names). No Vite\n   * runs in the Nest process, so: the descriptor the dev plugin writes, or the production Vite\n   * manifest — in production the manifest first, otherwise whichever was written last.\n   */\n  sandboxKit?: AgentGenuiSandboxKitOptions;\n}\n\n/** {@link AgentGenuiOptions.sandboxKit}. Relative paths resolve against `root`. */\nexport interface AgentGenuiSandboxKitOptions {\n  /** Default `process.cwd()`. */\n  root?: string;\n  /**\n   * The dev descriptor `genuiSandboxKit()` writes. Default `.genui/sandbox-kit.json` — for a named\n   * kit (`genuiSandboxKit({ name })`, picked with `kitName`), `.genui/sandbox-kit.<name>.json`.\n   */\n  descriptor?: string;\n  /**\n   * The production Vite manifest, and the directory its `file`s are relative to. Default\n   * `{ file: 'public/.vite/manifest.json', outDir: 'public' }`; `false` → none.\n   */\n  manifest?: { file: string; outDir: string } | false;\n  /** An explicit kit url (an SPA served from elsewhere), over what is found. */\n  kitUrl?: string;\n  /** An explicit url of the compiled styles, over what is found (the same SPA case). */\n  cssUrl?: string;\n  /** An explicit url of the Tailwind browser runtime, over what is found (the same SPA case). */\n  tailwindUrl?: string;\n  /** Read the manifest first (else the freshest of the two). Default: `NODE_ENV === 'production'`. */\n  production?: boolean;\n}\n\ntype ResolverOption = Type<GenuiCatalogResolver> | GenuiCatalogResolver;\n\nexport interface AgentGenuiModuleOptions extends AgentGenuiOptions {\n  /** Per-request catalogs. A class is instantiated with DI (its dependencies must be global or exported to the root). */\n  resolver?: ResolverOption;\n}\n\nexport interface AgentGenuiModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {\n  inject?: FactoryProvider['inject'];\n  useFactory: (...deps: any[]) => AgentGenuiOptions | Promise<AgentGenuiOptions>;\n  /** Per-request catalogs. A class resolves its dependencies from `imports`. */\n  resolver?: ResolverOption;\n}\n\nfunction resolverProviders(resolver: ResolverOption | undefined): Provider[] {\n  if (resolver === undefined) return [];\n  return [\n    typeof resolver === 'function'\n      ? { provide: GenuiCatalogResolver, useClass: resolver }\n      : { provide: GenuiCatalogResolver, useValue: resolver },\n  ];\n}\n\n/** The sandbox and channels with the kit and theme names found ({@link GENUI_RESOLVED}). */\ninterface ResolvedGenui {\n  sandbox?: boolean | DefineSandboxOptions;\n  /** A kit sandbox the catalog itself defines, resolved (under its own name). */\n  catalogSandbox?: DefineSandboxOptions;\n  channels?: GenuiChannels;\n  sandboxClient?: () => SandboxClientConfig;\n}\n\n/** What every configured sandbox (top level and channels) needs from the browser, together. */\nfunction mergeSandboxClients(clients: Array<() => SandboxClientConfig>): SandboxClientConfig {\n  const merged: SandboxClientConfig = { theme: false };\n  for (const client of clients) {\n    const one = client();\n    merged.theme ||= one.theme;\n    if (one.name !== undefined && merged.kit === undefined && one.kit !== undefined)\n      merged.name = one.name;\n    if (one.kit !== undefined) merged.kit ??= one.kit;\n    if (one.css !== undefined) merged.css ??= one.css;\n    if (one.tailwind !== undefined) merged.tailwind ??= one.tailwind;\n  }\n  return merged;\n}\n\n/** Resolve the sandbox (top level and per channel) against the kit discovery. */\nasync function resolveGenui(options: AgentGenuiOptions): Promise<ResolvedGenui> {\n  const { sandbox: asked, channels: askedChannels } = options;\n  assertGenuiChannels(askedChannels);\n  // A sandbox's kit (styles, components, wrapper) and theme names are found through the app's Vite output.\n  const clients: Array<() => SandboxClientConfig> = [];\n  const discoveries = new Map<\n    string,\n    import('@dudousxd/nestjs-agent-core/genui/kit').SandboxKitDiscovery\n  >();\n  const resolveSandbox = async (\n    value: boolean | DefineSandboxOptions | undefined,\n  ): Promise<boolean | DefineSandboxOptions | undefined> => {\n    if (value === undefined || value === false) return value;\n    // Node-only, and only with a sandbox: loaded when one is configured.\n    const [{ nestSandboxKitDiscovery }, { resolveSandboxServer }] = await Promise.all([\n      import('./kit.js'),\n      import('@dudousxd/nestjs-agent-core/genui/kit'),\n    ]);\n    const kitName = value === true ? undefined : value.kitName;\n    let discovery = discoveries.get(kitName ?? '');\n    if (discovery === undefined) {\n      discovery = nestSandboxKitDiscovery(options.sandboxKit, kitName);\n      discoveries.set(kitName ?? '', discovery);\n    }\n    const resolved = resolveSandboxServer(value, discovery);\n    clients.push(resolved.client);\n    return resolved.define;\n  };\n  const sandbox = await resolveSandbox(asked);\n  // A kit sandbox defined in the (shared) catalog itself: found the same way, and put\n  // back under its own name, so the browser's copy of the catalog validates what the model writes.\n  const own = options.catalog?.components.find((each) => sandboxPolicyOf(each) !== undefined) as\n    | SandboxDefinition\n    | undefined;\n  const ownOptions =\n    asked === undefined && own?.sandboxOptions !== undefined && own.sandboxView?.kit === true\n      ? await resolveSandbox({ ...own.sandboxOptions, name: own.name })\n      : undefined;\n  let channels: GenuiChannels | undefined;\n  if (askedChannels !== undefined) {\n    channels = {};\n    for (const [name, entry] of Object.entries(askedChannels)) {\n      if (entry === undefined) continue;\n      const own = await resolveSandbox(entry.sandbox);\n      channels[name] = { ...entry, ...(own !== undefined ? { sandbox: own } : {}) };\n    }\n  }\n  return {\n    ...(sandbox !== undefined ? { sandbox } : {}),\n    ...(typeof ownOptions === 'object' ? { catalogSandbox: ownOptions } : {}),\n    ...(channels !== undefined ? { channels } : {}),\n    ...(clients.length > 0 ? { sandboxClient: () => mergeSandboxClients(clients) } : {}),\n  };\n}\n\nfunction perRequest(\n  resolver: GenuiCatalogResolver | undefined,\n): GenuiToolsOptions['resolveCatalog'] | undefined {\n  return resolver === undefined ? undefined : (scope: GenuiCatalogScope) => resolver.resolve(scope);\n}\n\nfunction toolOptions(\n  options: AgentGenuiOptions,\n  resolved: ResolvedGenui,\n  resolver: GenuiCatalogResolver | undefined,\n): GenuiToolsOptions {\n  const {\n    catalog: _catalog,\n    sandbox: _sandbox,\n    channels: _channels,\n    sandboxKit: _sandboxKit,\n    ...rest\n  } = options;\n  const resolveCatalog = perRequest(resolver);\n  return {\n    ...rest,\n    ...(resolved.channels !== undefined ? { channels: resolved.channels } : {}),\n    ...(resolved.sandbox !== undefined ? { sandbox: resolved.sandbox } : {}),\n    ...(resolveCatalog !== undefined ? { resolveCatalog } : {}),\n  };\n}\n\n/** The configured catalog, with the sandbox component added when `sandbox` asks for it. */\nfunction withSandbox(options: AgentGenuiOptions, resolved: ResolvedGenui): Catalog {\n  const base = options.catalog ?? defineCatalog([]);\n  const { sandbox, catalogSandbox } = resolved;\n  if (sandbox === undefined || sandbox === false)\n    return catalogSandbox !== undefined ? base.extend([defineSandbox(catalogSandbox)]) : base;\n  return base.extend([defineSandbox(sandbox === true ? {} : sandbox)]);\n}\n\nfunction coreProviders(resolver: ResolverOption | undefined): Provider[] {\n  return [\n    {\n      provide: GENUI_RESOLVED,\n      useFactory: (options: AgentGenuiOptions) => resolveGenui(options),\n      inject: [GENUI_OPTIONS],\n    },\n    {\n      provide: GENUI_CATALOG,\n      useFactory: (options: AgentGenuiOptions, resolved: ResolvedGenui) =>\n        withSandbox(options, resolved),\n      inject: [GENUI_OPTIONS, GENUI_RESOLVED],\n    },\n    {\n      provide: AGENT_GENUI,\n      useFactory: (\n        options: AgentGenuiOptions,\n        catalog: Catalog,\n        resolved: ResolvedGenui,\n        resolverInstance?: GenuiCatalogResolver,\n      ) =>\n        new AgentGenui(\n          catalog,\n          perRequest(resolverInstance),\n          resolved.channels,\n          {\n            ...(options.mode !== undefined ? { mode: options.mode } : {}),\n            ...(options.streaming !== undefined ? { streaming: options.streaming } : {}),\n            ...(resolved.sandbox !== undefined ? { sandbox: resolved.sandbox } : {}),\n          },\n          resolved.sandboxClient,\n        ),\n      inject: [\n        GENUI_OPTIONS,\n        GENUI_CATALOG,\n        GENUI_RESOLVED,\n        { token: GenuiCatalogResolver, optional: true },\n      ],\n    },\n    ...resolverProviders(resolver),\n    // The generated tools, registered by the agent module's discovery like any `provideAgentTool`.\n    // Built from the injected catalog, so `overrideProvider(GENUI_CATALOG)` changes them too.\n    provideAgentTools(\n      (\n        options: AgentGenuiOptions,\n        catalog: Catalog,\n        resolved: ResolvedGenui,\n        perRequestResolver?: GenuiCatalogResolver,\n      ) => genuiTools(catalog, toolOptions(options, resolved, perRequestResolver)),\n      [\n        GENUI_OPTIONS,\n        GENUI_CATALOG,\n        GENUI_RESOLVED,\n        { token: GenuiCatalogResolver, optional: true },\n      ],\n    ),\n  ];\n}\n\nconst EXPORTS = [GENUI_CATALOG, GENUI_OPTIONS, AGENT_GENUI];\n\n/**\n * Generative UI for the agent: registers the tools that let the model push catalog components\n * (one `ui__render` tree tool, or `ui__show_<component>` per component, and/or the generic\n * `ui__show`), and makes the catalog\n * injectable. Global, like `AgentModule`; import it once, next to it.\n *\n * ```ts\n * AgentGenuiModule.forRoot({ catalog, mode: 'tree', terminal: true })\n * ```\n */\n@Module({})\nexport class AgentGenuiModule {\n  static forRoot(options: AgentGenuiModuleOptions = {}): DynamicModule {\n    const { resolver, ...rest } = options;\n    return {\n      module: AgentGenuiModule,\n      global: true,\n      providers: [{ provide: GENUI_OPTIONS, useValue: rest }, ...coreProviders(resolver)],\n      exports: resolver === undefined ? EXPORTS : [...EXPORTS, GenuiCatalogResolver],\n    };\n  }\n\n  static forRootAsync(options: AgentGenuiModuleAsyncOptions): DynamicModule {\n    return {\n      module: AgentGenuiModule,\n      global: true,\n      imports: options.imports ?? [],\n      providers: [\n        { provide: GENUI_OPTIONS, useFactory: options.useFactory, inject: options.inject ?? [] },\n        ...coreProviders(options.resolver),\n      ],\n      exports: options.resolver === undefined ? EXPORTS : [...EXPORTS, GenuiCatalogResolver],\n    };\n  }\n}\n","import {\n  type FunctionalToolDefinition,\n  type ToolHandler,\n  type ToolSpec,\n  createFunctionalTool,\n} from '@dudousxd/nestjs-agent-core';\nimport type { FactoryProvider, Provider } from '@nestjs/common';\n\n/**\n * Brand stamped onto a functional-tool provider instance so `AiToolDiscoveryService` picks it up\n * when it walks every provider at boot — the declarative alternative to a manual `registry.register`.\n */\nexport const AGENT_TOOL_BRAND = Symbol.for('@dudousxd/nestjs-agent:functional-tool');\n\n/** A tool expressed as data + handler (e.g. from `createExecuteSqlTool`), not an `@AiTool` class. */\nexport interface FunctionalTool {\n  spec: ToolSpec;\n  handler: ToolHandler;\n}\n\n/** A {@link FunctionalTool} carrying {@link AGENT_TOOL_BRAND} — what a provider resolves to. */\nexport interface BrandedFunctionalTool extends FunctionalTool {\n  readonly [AGENT_TOOL_BRAND]: true;\n}\n\nfunction brand(tool: FunctionalTool): BrandedFunctionalTool {\n  return { [AGENT_TOOL_BRAND]: true, spec: tool.spec, handler: tool.handler };\n}\n\n/** Narrows a provider instance to a branded functional tool for boot-time registration. */\nexport function isBrandedFunctionalTool(value: object): value is BrandedFunctionalTool {\n  return AGENT_TOOL_BRAND in value && 'spec' in value && 'handler' in value;\n}\n\n/**\n * Registers a functional tool declaratively — drop the returned provider in a module's `providers`\n * and `AiToolDiscoveryService` auto-registers it at boot. Each call uses a fresh, unique provide\n * token so the same tool can be provided many times without collisions.\n *\n * Two forms: a static tool (`useValue`) or a factory with `inject` for DI-resolved dependencies\n * (`useFactory`). Either way the resolved instance is branded with {@link AGENT_TOOL_BRAND}.\n */\nexport function provideAgentTool(tool: FunctionalTool): Provider;\nexport function provideAgentTool(\n  factory: (...deps: never[]) => FunctionalTool,\n  inject?: FactoryProvider['inject'],\n): Provider;\nexport function provideAgentTool(\n  factoryOrTool: FunctionalTool | ((...deps: never[]) => FunctionalTool),\n  inject?: FactoryProvider['inject'],\n): Provider {\n  const provide = Symbol('nestjs-agent:functional-tool-instance');\n  if (typeof factoryOrTool === 'function') {\n    return {\n      provide,\n      useFactory: (...deps: never[]) => brand(factoryOrTool(...deps)),\n      inject: inject ?? [],\n    };\n  }\n  return { provide, useValue: brand(factoryOrTool) };\n}\n\n/**\n * Registers a LIST of functional tools from one factory — for a producer whose tool count is only\n * known once its dependencies resolve (a catalog loaded from config, one tool per entry). The\n * factory's result is branded element by element; `AiToolDiscoveryService` registers each.\n */\nexport function provideAgentTools(\n  factory: (...deps: never[]) => readonly FunctionalTool[] | Promise<readonly FunctionalTool[]>,\n  inject?: FactoryProvider['inject'],\n): Provider {\n  return {\n    provide: Symbol('nestjs-agent:functional-tool-list'),\n    useFactory: async (...deps: never[]) => (await factory(...deps)).map(brand),\n    inject: inject ?? [],\n  };\n}\n\n/** Author a functional tool with inferred Standard Schema input and domain output. */\nexport const defineTool = createFunctionalTool;\nexport type { FunctionalToolDefinition };\n","import type {\n  Catalog,\n  GenuiCatalogScope,\n  GenuiChannelBase,\n  GenuiChannels,\n  SandboxClientConfig,\n} from '@dudousxd/nestjs-agent-core/genui';\n\n/**\n * The app's genui setup ({@link AgentGenui}): the catalog, the per-channel options and what the\n * sandbox renderer is told — what the text channels (`@dudousxd/nestjs-agent-channels`) and\n * `GET <base>/config` read.\n */\nexport const AGENT_GENUI = Symbol.for('@dudousxd/nestjs-agent:genui');\n\n/**\n * The app's genui setup, bound to {@link AGENT_GENUI}: what a text channel draws with\n * (`catalog`, `channels`, `base`) and what the sandbox renderer is told (`sandboxClient`).\n */\nexport class AgentGenui {\n  constructor(\n    readonly catalog: Catalog,\n    readonly resolveCatalog?: (scope: GenuiCatalogScope) => Catalog | Promise<Catalog>,\n    /** `AgentGenuiModule.forRoot({ channels })`, when configured. */\n    readonly channels?: GenuiChannels,\n    /** The top-level options a channel falls back to. */\n    readonly base: GenuiChannelBase = {},\n    /** What the sandbox renderer is told, when a sandbox is configured. */\n    readonly sandboxClient?: () => SandboxClientConfig,\n  ) {}\n}\n"],"mappings":"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","names":["NEST_SANDBOX_KIT_DESCRIPTOR","nestSandboxKitDiscovery","options","name","manifest","NEST_SANDBOX_KIT_MANIFEST","sandboxKitDiscovery","root","resolve","process","cwd","undefined","descriptor","sandboxKitDescriptorPath","NEST_SANDBOX_KIT_DESCRIPTOR","file","outDir","kitUrl","cssUrl","tailwindUrl","production","import_kit","Object","freeze","import_nestjs_agent_core","import_genui","import_common","AGENT_SERVICE","Symbol","for","AGENT_TOOL_BRAND","Symbol","for","brand","tool","spec","handler","provideAgentTools","factory","inject","provide","Symbol","useFactory","deps","map","brand","AGENT_GENUI","Symbol","for","AgentGenui","catalog","resolveCatalog","channels","base","sandboxClient","GENUI_CATALOG","Symbol","for","GENUI_OPTIONS","GENUI_RESOLVED","GenuiCatalogResolver","resolverProviders","resolver","undefined","provide","useClass","useValue","mergeSandboxClients","clients","merged","theme","client","one","name","kit","css","tailwind","resolveGenui","options","sandbox","asked","channels","askedChannels","assertGenuiChannels","discoveries","Map","resolveSandbox","value","nestSandboxKitDiscovery","resolveSandboxServer","Promise","all","kitName","discovery","get","sandboxKit","set","resolved","push","define","own","catalog","components","find","each","sandboxPolicyOf","ownOptions","sandboxOptions","sandboxView","entry","Object","entries","catalogSandbox","length","sandboxClient","perRequest","scope","resolve","toolOptions","_catalog","_sandbox","_channels","_sandboxKit","rest","resolveCatalog","withSandbox","base","defineCatalog","extend","defineSandbox","coreProviders","GENUI_RESOLVED","useFactory","inject","GENUI_OPTIONS","GENUI_CATALOG","AGENT_GENUI","resolverInstance","AgentGenui","mode","streaming","token","optional","provideAgentTools","perRequestResolver","genuiTools","EXPORTS","AgentGenuiModule","forRoot","module","global","providers","exports","forRootAsync","imports","A2UI_VIA","isRecord","value","Array","isArray","invalid","code","message","BadRequestException","statusCode","bodyField","body","key","undefined","metadata","readDataModel","raw","maxBytes","surfaces","size","TextEncoder","encode","JSON","stringify","length","Object","keys","A2uiRunHandler","agent","actorResolver","projection","quietMs","maxActionBytes","maxDataModelBytes","replay","req","threadId","catalog","actor","resolve","owner","threadOwner","entries","thread","getThread","supported","filter","id","a2uiThreadReplay","messages","negotiateA2uiCatalog","handle","res","agentName","readA2uiClientCapabilities","dataModel","action","read","readA2uiAction","name","A2UI_APPROVE_ACTION","A2UI_REJECT_ACTION","interruptId","context","address","decodeInterruptId","kind","proposalId","decided","decideActionProposal","decision","via","writeHead","projector","A2uiProjector","messageId","event","type","role","delta","text","project","write","end","assertResumable","stream","checkDecision","toolCallId","approve","reject","skip","position","answered","uiActionText","trim","ForbiddenException","uiCapabilities","hasOwn","validateUiCapabilities","error","started","chat","newThreadId","pageContext","a2uiDataModel","runId","extra","status","setHeader","flushHeaders","options","frames","agUiFramesFromNdjson","subscribe","agUiEvents","streamRunId","streamThreadId","a2uiAdapter","path","replace","_path","A2uiController","run","controllers"]}

package/dist/a2ui/index.js

@@ -26,12 +26,15 @@ __export(kit_exports, {
   nestSandboxKitDiscovery: () => nestSandboxKitDiscovery
 });
 import { resolve } from "path";
-import { sandboxKitDiscovery } from "@dudousxd/nestjs-agent-core/genui/kit";
-function nestSandboxKitDiscovery(options = {}) {
+import { sandboxKitDescriptorPath, sandboxKitDiscovery } from "@dudousxd/nestjs-agent-core/genui/kit";
+function nestSandboxKitDiscovery(options = {}, name) {
   const manifest = options.manifest ?? NEST_SANDBOX_KIT_MANIFEST;
   return sandboxKitDiscovery({
     root: resolve(options.root ?? process.cwd()),
-    descriptor: options.descriptor ?? NEST_SANDBOX_KIT_DESCRIPTOR,
+    ...name !== void 0 ? {
+      name
+    } : {},
+    descriptor: sandboxKitDescriptorPath(options.descriptor ?? NEST_SANDBOX_KIT_DESCRIPTOR, name),
     ...manifest !== false ? {
       manifest: {
         file: manifest.file,
@@ -41,6 +44,12 @@ function nestSandboxKitDiscovery(options = {}) {
     ...options.kitUrl !== void 0 ? {
       kitUrl: options.kitUrl
     } : {},
+    ...options.cssUrl !== void 0 ? {
+      cssUrl: options.cssUrl
+    } : {},
+    ...options.tailwindUrl !== void 0 ? {
+      tailwindUrl: options.tailwindUrl
+    } : {},
     ...options.production !== void 0 ? {
       production: options.production
     } : {}
@@ -159,6 +168,7 @@ function mergeSandboxClients(clients) {
   for (const client of clients) {
     const one = client();
     merged.theme ||= one.theme;
+    if (one.name !== void 0 && merged.kit === void 0 && one.kit !== void 0) merged.name = one.name;
     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;
@@ -170,14 +180,19 @@ async function resolveGenui(options) {
   const { sandbox: asked, channels: askedChannels } = options;
   assertGenuiChannels(askedChannels);
   const clients = [];
-  let discovery;
+  const discoveries = /* @__PURE__ */ new Map();
   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 kitName = value === true ? void 0 : value.kitName;
+    let discovery = discoveries.get(kitName ?? "");
+    if (discovery === void 0) {
+      discovery = nestSandboxKitDiscovery2(options.sandboxKit, kitName);
+      discoveries.set(kitName ?? "", discovery);
+    }
     const resolved = resolveSandboxServer(value, discovery);
     clients.push(resolved.client);
     return resolved.define;