@dudousxd/nestjs-agent 1.29.0 → 1.31.0

package/dist/durable/index.d.cts

@@ -1,11 +1,11 @@
 import { AgentStore, AgentRunInput, AgentLoopResult, LlmStepEnvelope, BufferedModelTurnResult, ToolStepEnvelope, AgentRunner, TokenStreamSink, AgentRunStartOptions, HumanReply } from '@dudousxd/nestjs-agent-core';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { RunGateway, WorkflowCtx } from '@dudousxd/nestjs-durable-core';
-import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-Bk7DCKGV.cjs';
+import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-ZwQ9p-Ps.cjs';
 import { DynamicModule } from '@nestjs/common';
 import '@dudousxd/nestjs-agent-core/genui';
 import '@standard-schema/spec';
-import '../genui/index.cjs';
+import '../agent-genui.module-D0X3YnzO.cjs';
 
 /**
  * The agent turn AS a durable workflow. Persist/stream checkpoints are `ctx.localStep`s — the

package/dist/durable/index.d.ts

@@ -1,11 +1,11 @@
 import { AgentStore, AgentRunInput, AgentLoopResult, LlmStepEnvelope, BufferedModelTurnResult, ToolStepEnvelope, AgentRunner, TokenStreamSink, AgentRunStartOptions, HumanReply } from '@dudousxd/nestjs-agent-core';
 import { WorkflowService } from '@dudousxd/nestjs-durable';
 import { RunGateway, WorkflowCtx } from '@dudousxd/nestjs-durable-core';
-import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-B-fVOJGf.js';
+import { A as AgentDepsFactory, C as ChatQueueService, a as AgentSurface, b as AgentModuleOptions } from '../chat-queue.service-Bdz43pAC.js';
 import { DynamicModule } from '@nestjs/common';
 import '@dudousxd/nestjs-agent-core/genui';
 import '@standard-schema/spec';
-import '../genui/index.js';
+import '../agent-genui.module-D0X3YnzO.js';
 
 /**
  * The agent turn AS a durable workflow. Persist/stream checkpoints are `ctx.localStep`s — the

package/dist/durable/index.js

@@ -1,5 +1,63 @@
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+// src/vite/index.ts
+import { SANDBOX_KIT_DEV_PREFIX, SANDBOX_KIT_MANIFEST_KEYS, SANDBOX_KIT_UPDATE_EVENT, createGenuiSandboxKitPlugin } from "@dudousxd/nestjs-agent-core/genui/kit";
+var NEST_SANDBOX_KIT_DESCRIPTOR;
+var init_vite = __esm({
+  "src/vite/index.ts"() {
+    "use strict";
+    NEST_SANDBOX_KIT_DESCRIPTOR = ".genui/sandbox-kit.json";
+  }
+});
+
+// src/genui/kit.ts
+var kit_exports = {};
+__export(kit_exports, {
+  NEST_SANDBOX_KIT_MANIFEST: () => NEST_SANDBOX_KIT_MANIFEST,
+  nestSandboxKitDiscovery: () => nestSandboxKitDiscovery
+});
+import { resolve } from "path";
+import { sandboxKitDiscovery } from "@dudousxd/nestjs-agent-core/genui/kit";
+function nestSandboxKitDiscovery(options = {}) {
+  const manifest = options.manifest ?? NEST_SANDBOX_KIT_MANIFEST;
+  return sandboxKitDiscovery({
+    root: resolve(options.root ?? process.cwd()),
+    descriptor: options.descriptor ?? NEST_SANDBOX_KIT_DESCRIPTOR,
+    ...manifest !== false ? {
+      manifest: {
+        file: manifest.file,
+        outDir: manifest.outDir
+      }
+    } : {},
+    ...options.kitUrl !== void 0 ? {
+      kitUrl: options.kitUrl
+    } : {},
+    ...options.production !== void 0 ? {
+      production: options.production
+    } : {}
+  });
+}
+var NEST_SANDBOX_KIT_MANIFEST;
+var init_kit = __esm({
+  "src/genui/kit.ts"() {
+    "use strict";
+    init_vite();
+    NEST_SANDBOX_KIT_MANIFEST = Object.freeze({
+      file: "public/.vite/manifest.json",
+      outDir: "public"
+    });
+    __name(nestSandboxKitDiscovery, "nestSandboxKitDiscovery");
+  }
+});
 
 // src/durable/agent-run.workflow.ts
 import { AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY2, AGENT_STORE, RUN_ENDED_BEFORE_TOOL_CALL, RunCancelledError, agentFailureCode, encodeStreamEvent as encodeStreamEvent2, isReplayIntegrityError as isReplayIntegrityError2, publishAgentRunFailed, releaseThreadRun, runAgentLoop, settleAll, settleDeadRun, settleUnsettledDelegation, streamFailure } from "@dudousxd/nestjs-agent-core";
@@ -36,6 +94,7 @@ var AGENT_CHAT_QUEUE = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:chat-q
 import { createNegotiatedUiCollector } from "@dudousxd/nestjs-agent-core";
 import { prepareActionProposal, resolveActionProposalApproval } from "@dudousxd/nestjs-agent-core";
 import { AGENT_DEPS_FACTORY, createFrameBuffer, createNoopEmitUi, encodeStreamEvent, intersectAllowLists, invokeWithTransientRetry, isControlFlowSignal, isReplayIntegrityError, observeTurnFrames, previewToolInputs, publishAgentToolRetry, registryInputPreviews, stampToolKinds, toolCallContext, traceLlmTurn, traceToolExecution, withAskTool, withMemoryTool, withSkillTool, withToolTimeout, withTurnFrames, wrapToolPreflightDenied, wrapToolStepOutput } from "@dudousxd/nestjs-agent-core";
+import { turnChannel } from "@dudousxd/nestjs-agent-core/genui";
 import { Step } from "@dudousxd/nestjs-durable";
 import { Inject, Injectable } from "@nestjs/common";
 
@@ -112,6 +171,7 @@ var AgentRunSteps = class {
               ...input.preflightContext?.uiCapabilities !== void 0 ? {
                 uiCapabilities: input.preflightContext.uiCapabilities
               } : {},
+              channel: turnChannel(input.preflightContext?.pageContext),
               ...input.agentName !== void 0 ? {
                 agentName: input.agentName
               } : {}
@@ -141,7 +201,8 @@ var AgentRunSteps = class {
       } : {},
       ...input.preflightContext?.uiCapabilities !== void 0 ? {
         uiCapabilities: input.preflightContext.uiCapabilities
-      } : {}
+      } : {},
+      channel: turnChannel(input.preflightContext?.pageContext)
     }));
     const frames = observeTurnFrames(previews.writer);
     const turn = withTurnFrames(await traceLlmTurn(input.runId, input.step, () => deps.model.runTurn({
@@ -798,8 +859,8 @@ var InProcessTokenStreamSink = class {
     return buf;
   }
   wake(buf) {
-    for (const resolve of buf.notify) {
-      resolve();
+    for (const resolve2 of buf.notify) {
+      resolve2();
     }
     buf.notify.clear();
   }
@@ -838,7 +899,7 @@ var InProcessTokenStreamSink = class {
         }
         return;
       }
-      await new Promise((resolve) => buf.notify.add(resolve));
+      await new Promise((resolve2) => buf.notify.add(resolve2));
     }
   }
   close(runId) {
@@ -1199,7 +1260,7 @@ import { AGENT_OPTIONS } from "@dudousxd/nestjs-agent-core";
 import { BadRequestException, Inject as Inject5, Injectable as Injectable4, Optional as Optional3 } from "@nestjs/common";
 
 // src/genui/agent-genui.module.ts
-import { defineCatalog, defineSandbox, genuiTools } from "@dudousxd/nestjs-agent-core/genui";
+import { assertGenuiChannels, defineCatalog, defineSandbox, genuiTools, sandboxPolicyOf } from "@dudousxd/nestjs-agent-core/genui";
 import { Inject as Inject4, Module as Module2 } from "@nestjs/common";
 
 // src/functional-tool.ts
@@ -1226,6 +1287,26 @@ function provideAgentTools(factory, inject) {
 }
 __name(provideAgentTools, "provideAgentTools");
 
+// src/genui/agent-genui.token.ts
+var AGENT_GENUI = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:genui");
+var AgentGenui = class {
+  static {
+    __name(this, "AgentGenui");
+  }
+  catalog;
+  resolveCatalog;
+  channels;
+  base;
+  sandboxClient;
+  constructor(catalog, resolveCatalog2, channels, base = {}, sandboxClient) {
+    this.catalog = catalog;
+    this.resolveCatalog = resolveCatalog2;
+    this.channels = channels;
+    this.base = base;
+    this.sandboxClient = sandboxClient;
+  }
+};
+
 // src/genui/agent-genui.module.ts
 function _ts_decorate5(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -1243,6 +1324,7 @@ function _ts_decorate5(decorators, target, key, desc) {
 __name(_ts_decorate5, "_ts_decorate");
 var GENUI_CATALOG = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:genui-catalog");
 var GENUI_OPTIONS = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:genui-options");
+var GENUI_RESOLVED = /* @__PURE__ */ Symbol.for("@dudousxd/nestjs-agent:genui-resolved");
 var GenuiCatalogResolver = class {
   static {
     __name(this, "GenuiCatalogResolver");
@@ -1261,20 +1343,99 @@ function resolverProviders(resolver) {
   ];
 }
 __name(resolverProviders, "resolverProviders");
-function toolOptions(options, resolver) {
-  const { catalog: _catalog, sandbox: _sandbox, ...rest } = options;
+function mergeSandboxClients(clients) {
+  const merged = {
+    theme: false
+  };
+  for (const client of clients) {
+    const one = client();
+    merged.theme ||= one.theme;
+    if (one.tailwind !== void 0) merged.tailwind ??= one.tailwind;
+    if (one.kit !== void 0) merged.kit ??= one.kit;
+  }
+  return merged;
+}
+__name(mergeSandboxClients, "mergeSandboxClients");
+async function resolveGenui(options) {
+  const { sandbox: asked, channels: askedChannels } = options;
+  assertGenuiChannels(askedChannels);
+  const clients = [];
+  let discovery;
+  const resolveSandbox = /* @__PURE__ */ __name(async (value) => {
+    if (value === void 0 || value === false) return value;
+    const [{ nestSandboxKitDiscovery: nestSandboxKitDiscovery2 }, { resolveSandboxServer }] = await Promise.all([
+      Promise.resolve().then(() => (init_kit(), kit_exports)),
+      import("@dudousxd/nestjs-agent-core/genui/kit")
+    ]);
+    discovery ??= nestSandboxKitDiscovery2(options.sandboxKit);
+    const resolved = resolveSandboxServer(value, discovery);
+    clients.push(resolved.client);
+    return resolved.define;
+  }, "resolveSandbox");
+  const sandbox = await resolveSandbox(asked);
+  const own = options.catalog?.components.find((each) => sandboxPolicyOf(each) !== void 0);
+  const ownOptions = asked === void 0 && own?.sandboxOptions !== void 0 && (own.sandboxView?.kit === true || own.sandboxView?.tailwind === true) ? await resolveSandbox({
+    ...own.sandboxOptions,
+    name: own.name
+  }) : void 0;
+  let channels;
+  if (askedChannels !== void 0) {
+    channels = {};
+    for (const [name, entry] of Object.entries(askedChannels)) {
+      if (entry === void 0) continue;
+      const own2 = await resolveSandbox(entry.sandbox);
+      channels[name] = {
+        ...entry,
+        ...own2 !== void 0 ? {
+          sandbox: own2
+        } : {}
+      };
+    }
+  }
+  return {
+    ...sandbox !== void 0 ? {
+      sandbox
+    } : {},
+    ...typeof ownOptions === "object" ? {
+      catalogSandbox: ownOptions
+    } : {},
+    ...channels !== void 0 ? {
+      channels
+    } : {},
+    ...clients.length > 0 ? {
+      sandboxClient: /* @__PURE__ */ __name(() => mergeSandboxClients(clients), "sandboxClient")
+    } : {}
+  };
+}
+__name(resolveGenui, "resolveGenui");
+function perRequest(resolver) {
+  return resolver === void 0 ? void 0 : (scope) => resolver.resolve(scope);
+}
+__name(perRequest, "perRequest");
+function toolOptions(options, resolved, resolver) {
+  const { catalog: _catalog, sandbox: _sandbox, channels: _channels, sandboxKit: _sandboxKit, ...rest } = options;
+  const resolveCatalog2 = perRequest(resolver);
   return {
     ...rest,
-    ...resolver !== void 0 ? {
-      resolveCatalog: /* @__PURE__ */ __name((scope) => resolver.resolve(scope), "resolveCatalog")
+    ...resolved.channels !== void 0 ? {
+      channels: resolved.channels
+    } : {},
+    ...resolved.sandbox !== void 0 ? {
+      sandbox: resolved.sandbox
+    } : {},
+    ...resolveCatalog2 !== void 0 ? {
+      resolveCatalog: resolveCatalog2
     } : {}
   };
 }
 __name(toolOptions, "toolOptions");
-function withSandbox(options) {
+function withSandbox(options, resolved) {
   const base = options.catalog ?? defineCatalog([]);
-  const { sandbox } = options;
-  return sandbox === void 0 || sandbox === false ? base : base.extend([
+  const { sandbox, catalogSandbox } = resolved;
+  if (sandbox === void 0 || sandbox === false) return catalogSandbox !== void 0 ? base.extend([
+    defineSandbox(catalogSandbox)
+  ]) : base;
+  return base.extend([
     defineSandbox(sandbox === true ? {} : sandbox)
   ]);
 }
@@ -1282,18 +1443,50 @@ __name(withSandbox, "withSandbox");
 function coreProviders(resolver) {
   return [
     {
-      provide: GENUI_CATALOG,
-      useFactory: /* @__PURE__ */ __name((options) => withSandbox(options), "useFactory"),
+      provide: GENUI_RESOLVED,
+      useFactory: /* @__PURE__ */ __name((options) => resolveGenui(options), "useFactory"),
       inject: [
         GENUI_OPTIONS
       ]
     },
+    {
+      provide: GENUI_CATALOG,
+      useFactory: /* @__PURE__ */ __name((options, resolved) => withSandbox(options, resolved), "useFactory"),
+      inject: [
+        GENUI_OPTIONS,
+        GENUI_RESOLVED
+      ]
+    },
+    {
+      provide: AGENT_GENUI,
+      useFactory: /* @__PURE__ */ __name((options, catalog, resolved, resolverInstance) => new AgentGenui(catalog, perRequest(resolverInstance), resolved.channels, {
+        ...options.mode !== void 0 ? {
+          mode: options.mode
+        } : {},
+        ...options.streaming !== void 0 ? {
+          streaming: options.streaming
+        } : {},
+        ...resolved.sandbox !== void 0 ? {
+          sandbox: resolved.sandbox
+        } : {}
+      }, resolved.sandboxClient), "useFactory"),
+      inject: [
+        GENUI_OPTIONS,
+        GENUI_CATALOG,
+        GENUI_RESOLVED,
+        {
+          token: GenuiCatalogResolver,
+          optional: true
+        }
+      ]
+    },
     ...resolverProviders(resolver),
     // The generated tools, registered by the agent module's discovery like any `provideAgentTool`.
     // Built from the injected catalog, so `overrideProvider(GENUI_CATALOG)` changes them too.
-    provideAgentTools((options, catalog, perRequest) => genuiTools(catalog, toolOptions(options, perRequest)), [
+    provideAgentTools((options, catalog, resolved, perRequestResolver) => genuiTools(catalog, toolOptions(options, resolved, perRequestResolver)), [
       GENUI_OPTIONS,
       GENUI_CATALOG,
+      GENUI_RESOLVED,
       {
         token: GenuiCatalogResolver,
         optional: true
@@ -1304,7 +1497,8 @@ function coreProviders(resolver) {
 __name(coreProviders, "coreProviders");
 var EXPORTS = [
   GENUI_CATALOG,
-  GENUI_OPTIONS
+  GENUI_OPTIONS,
+  AGENT_GENUI
 ];
 var AgentGenuiModule = class _AgentGenuiModule {
   static {
@@ -1636,7 +1830,7 @@ var AgentDepsFactory2 = class {
       id: persona.id,
       label: persona.label
     };
-    const resolve = /* @__PURE__ */ __name(async (prompt, ctx) => typeof prompt === "function" ? prompt(ctx) : prompt, "resolve");
+    const resolve2 = /* @__PURE__ */ __name(async (prompt, ctx) => typeof prompt === "function" ? prompt(ctx) : prompt, "resolve");
     const own = persona.systemPrompt;
     const systemPrompt = /* @__PURE__ */ __name(async (ctx) => {
       const scoped = {
@@ -1644,10 +1838,10 @@ var AgentDepsFactory2 = class {
         persona: ref
       };
       if (own === void 0) {
-        return resolve(base, scoped);
+        return resolve2(base, scoped);
       }
-      const basePrompt = typeof own === "function" ? await resolve(base, scoped) : void 0;
-      return resolve(own, {
+      const basePrompt = typeof own === "function" ? await resolve2(base, scoped) : void 0;
+      return resolve2(own, {
         ...scoped,
         ...basePrompt !== void 0 ? {
           basePrompt
@@ -2546,8 +2740,16 @@ function sendableParams(params) {
       message: "nothing to answer: send a non-empty message, an attachment, or regenerate"
     });
   }
-  return text === message ? params : {
-    ...params,
+  const { channel, ...rest } = params;
+  const stamped = channel === void 0 ? params : {
+    ...rest,
+    pageContext: {
+      ...params.pageContext,
+      channel
+    }
+  };
+  return text === message ? stamped : {
+    ...stamped,
     message: text
   };
 }
@@ -4469,11 +4671,13 @@ var ConfigController = class {
   actorResolver;
   staging;
   models;
-  constructor(options, actorResolver, staging, models) {
+  genui;
+  constructor(options, actorResolver, staging, models, genui) {
     this.options = options;
     this.actorResolver = actorResolver;
     this.staging = staging;
     this.models = models;
+    this.genui = genui;
   }
   async config(req) {
     await this.actorResolver.resolve(req);
@@ -4487,7 +4691,12 @@ var ConfigController = class {
       },
       identity: {
         anonymous: this.actorResolver instanceof AnonymousActorResolver
-      }
+      },
+      ...this.genui?.sandboxClient !== void 0 ? {
+        genui: {
+          sandbox: this.genui.sandboxClient()
+        }
+      } : {}
     };
   }
 };
@@ -4508,11 +4717,14 @@ ConfigController = _ts_decorate14([
   _ts_param12(2, Inject12(AGENT_ATTACHMENT_STAGING4)),
   _ts_param12(3, Optional8()),
   _ts_param12(3, Inject12(AGENT_MODEL_CATALOG2)),
+  _ts_param12(4, Optional8()),
+  _ts_param12(4, Inject12(AGENT_GENUI)),
   _ts_metadata12("design:type", Function),
   _ts_metadata12("design:paramtypes", [
     typeof AgentModuleOptions === "undefined" ? Object : AgentModuleOptions,
     typeof ActorResolver === "undefined" ? Object : ActorResolver,
     Object,
+    Object,
     Object
   ])
 ], ConfigController);
@@ -6796,12 +7008,12 @@ var InlineAgentRunner = class _InlineAgentRunner {
     }
     const key = `${runId}:${toolCallId2}`;
     let timer;
-    const lapse = new Promise((resolve) => {
+    const lapse = new Promise((resolve2) => {
       timer = setTimeout(() => {
         const entry = this.pending.get(key);
         if (entry !== void 0) {
           this.pending.delete(key);
-          resolve({
+          resolve2({
             approved: false,
             expired: true
           });
@@ -6815,9 +7027,9 @@ var InlineAgentRunner = class _InlineAgentRunner {
     ]).finally(() => clearTimeout(timer));
   }
   park(runId, toolCallId2) {
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve2, reject) => {
       this.pending.set(`${runId}:${toolCallId2}`, {
-        resolve,
+        resolve: resolve2,
         reject
       });
     });