@dudousxd/nestjs-agent 1.34.0 → 1.35.0

package/dist/a2ui/index.d.cts

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

package/dist/a2ui/index.d.ts

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

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

@@ -1,4 +1,4 @@
-import { ResolveToolUiCatalog, ToolUiChannelGuide, ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, Persona, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, createFunctionalTool, QuotaProvider, QuotaQuery, QuotaReport, ActionApprovalMode, BackgroundActorResolver, ActionProposal, TextActionProposalConfig, PriceCatalogOptions, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, Actor, AttachmentStagingStore, ChatQueueStore, ChatQueueState, AgentRunner, AgentRunInput, AgentStreamEvent, QueuePauseReason } from '@dudousxd/nestjs-agent-core';
+import { ResolveToolUiCatalog, ToolUiChannelGuide, ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, Persona, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, createFunctionalTool, QuotaProvider, QuotaQuery, QuotaReport, ActionApprovalMode, BackgroundActorResolver, ActionProposal, ActionProposalOutcome, TextActionProposalConfig, PriceCatalogOptions, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, Actor, AttachmentStagingStore, ChatQueueStore, ChatQueueState, AgentRunner, AgentRunInput, AgentStreamEvent, QueuePauseReason } from '@dudousxd/nestjs-agent-core';
 import { Catalog } from '@dudousxd/nestjs-agent-core/genui';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { Provider, InjectionToken, Type, FactoryProvider, CanActivate, ModuleMetadata, OptionalFactoryDependency } from '@nestjs/common';
@@ -311,13 +311,16 @@ interface AgentModuleOptions {
      * integers, and `pollIntervalMs` must stay below a third of `leaseMs`. `onSettled` runs after each
      * proposal the worker settles (executed or failed), with the stored proposal — its `outcome` and
      * `executionContext.pageContext` included; a module can subscribe the same way through
-     * `ActionProposalWorkerService.onSettled`.
+     * `ActionProposalWorkerService.onSettled`. `onAdmitted` runs once a settled proposal's outcome
+     * was written to its thread — the moment to continue the conversation from it
+     * (`ActionProposalWorkerService.onAdmitted` for a module).
      */
     actionProposalWorker?: {
         pollIntervalMs?: number;
         leaseMs?: number;
         maxConcurrency?: number;
         onSettled?(proposal: ActionProposal): void | Promise<void>;
+        onAdmitted?(outcome: ActionProposalOutcome): void | Promise<void>;
     };
     /**
      * The words a chat message must consist of to approve or reject a proposal by text, and what the

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

@@ -1,4 +1,4 @@
-import { ResolveToolUiCatalog, ToolUiChannelGuide, ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, Persona, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, createFunctionalTool, QuotaProvider, QuotaQuery, QuotaReport, ActionApprovalMode, BackgroundActorResolver, ActionProposal, TextActionProposalConfig, PriceCatalogOptions, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, Actor, AttachmentStagingStore, ChatQueueStore, ChatQueueState, AgentRunner, AgentRunInput, AgentStreamEvent, QueuePauseReason } from '@dudousxd/nestjs-agent-core';
+import { ResolveToolUiCatalog, ToolUiChannelGuide, ModelProvider, AgentStore, ToolRegistry, RolesPolicy, ApprovalPolicy, QuotaStore, TokenStreamSink, PromptBuilder, PromptContributor, Persona, ToolTransientRetrySetting, Retriever, AgentPricingStore, HistoryPolicy, InputProcessor, OutputProcessor, AgentIntake, SkillsConfig, MemoryConfig, ToolSpec, ToolHandler, createFunctionalTool, QuotaProvider, QuotaQuery, QuotaReport, ActionApprovalMode, BackgroundActorResolver, ActionProposal, ActionProposalOutcome, TextActionProposalConfig, PriceCatalogOptions, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, Actor, AttachmentStagingStore, ChatQueueStore, ChatQueueState, AgentRunner, AgentRunInput, AgentStreamEvent, QueuePauseReason } from '@dudousxd/nestjs-agent-core';
 import { Catalog } from '@dudousxd/nestjs-agent-core/genui';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { Provider, InjectionToken, Type, FactoryProvider, CanActivate, ModuleMetadata, OptionalFactoryDependency } from '@nestjs/common';
@@ -311,13 +311,16 @@ interface AgentModuleOptions {
      * integers, and `pollIntervalMs` must stay below a third of `leaseMs`. `onSettled` runs after each
      * proposal the worker settles (executed or failed), with the stored proposal — its `outcome` and
      * `executionContext.pageContext` included; a module can subscribe the same way through
-     * `ActionProposalWorkerService.onSettled`.
+     * `ActionProposalWorkerService.onSettled`. `onAdmitted` runs once a settled proposal's outcome
+     * was written to its thread — the moment to continue the conversation from it
+     * (`ActionProposalWorkerService.onAdmitted` for a module).
      */
     actionProposalWorker?: {
         pollIntervalMs?: number;
         leaseMs?: number;
         maxConcurrency?: number;
         onSettled?(proposal: ActionProposal): void | Promise<void>;
+        onAdmitted?(outcome: ActionProposalOutcome): void | Promise<void>;
     };
     /**
      * The words a chat message must consist of to approve or reject a proposal by text, and what the

package/dist/durable/index.cjs

@@ -221,9 +221,9 @@ var AgentRunSteps = class {
           ),
           ask: deps.ask
         }),
-        enabled: deps.skills !== void 0
+        enabled: deps.skills !== void 0 && input.builtins?.skills !== false
       }),
-      enabled: deps.memory?.provider.write !== void 0
+      enabled: deps.memory?.provider.write !== void 0 && input.builtins?.memory !== false
     });
     const buffer = input.bufferOutput === true ? (0, import_nestjs_agent_core3.createFrameBuffer)() : void 0;
     let writer;
@@ -233,7 +233,8 @@ var AgentRunSteps = class {
       const opened = await deps.sink.open(input.sinkRunId);
       writer = input.childSink ? childSinkWriter(opened) : opened;
     }
-    const previews = (0, import_nestjs_agent_core3.previewToolInputs)(writer, (0, import_nestjs_agent_core3.registryInputPreviews)(deps.registry, tools, {
+    const announced = (0, import_nestjs_agent_core3.announcedToolCalls)(writer);
+    const previews = (0, import_nestjs_agent_core3.previewToolInputs)(announced.writer, (0, import_nestjs_agent_core3.registryInputPreviews)(deps.registry, tools, {
       actor: input.actor,
       ...input.threadId !== void 0 ? {
         threadId: input.threadId
@@ -257,6 +258,7 @@ var AgentRunSteps = class {
       } : {}
     })), frames.summary());
     const stamped = (0, import_nestjs_agent_core3.stampToolKinds)(turn, deps);
+    await announced.announceRest(stamped.toolCalls, tools);
     const allowedTools = (0, import_nestjs_agent_core3.intersectAllowLists)(deps.toolAllowList, input.personaAllowedTools);
     for (const call of stamped.toolCalls) {
       if (call.kind !== "action") continue;
@@ -6060,9 +6062,19 @@ var AgentDiscoveryService = class _AgentDiscoveryService {
         this.logger.warn(`Agent "${meta.name}" hands off to ${target.name}, which is not an @Agent \u2014 skipped.`);
         continue;
       }
-      edges.push(detached ? {
+      const roles = typeof entry === "function" ? void 0 : entry.roles;
+      const ability = typeof entry === "function" ? void 0 : entry.ability;
+      edges.push(detached || roles !== void 0 || ability !== void 0 ? {
         agent: targetMeta.name,
-        detached: true
+        ...detached ? {
+          detached: true
+        } : {},
+        ...roles !== void 0 ? {
+          roles
+        } : {},
+        ...ability !== void 0 ? {
+          ability
+        } : {}
       } : targetMeta.name);
     }
     return edges;
@@ -6254,7 +6266,7 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
     let delegates = 0;
     for (const definition of this.agents.list()) {
       for (const edge of definition.delegatesTo ?? []) {
-        const { agent: target, detached } = (0, import_nestjs_agent_core31.normalizeDelegation)(edge);
+        const { agent: target, detached, roles, ability } = (0, import_nestjs_agent_core31.normalizeDelegation)(edge);
         const targetDefinition = this.agents.get(target);
         if (targetDefinition === void 0) {
           throw new Error(`Agent "${definition.name}" hands off to "${target}", which is not a registered @Agent. Declare it as an @Agent provider or fix the reference.`);
@@ -6276,6 +6288,12 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
             ...detached ? {
               detached: true
             } : {},
+            ...roles !== void 0 ? {
+              roles
+            } : {},
+            ...ability !== void 0 ? {
+              ability
+            } : {},
             description,
             inputSchema: import_zod.z.object({
               task: import_zod.z.string()
@@ -6614,6 +6632,35 @@ var ActionProposalWorkerService = class _ActionProposalWorkerService {
   worker;
   logger = new import_common29.Logger(_ActionProposalWorkerService.name);
   settledListeners = /* @__PURE__ */ new Set();
+  admittedListeners = /* @__PURE__ */ new Set();
+  /**
+  * Run `listener` once a settled proposal's outcome is written to its thread by this process's
+  * worker (the thread was free) — what a module uses to CONTINUE a conversation once an action it
+  * proposed ran (a Poppy connect: the next turn goes on with what was asked). Next to
+  * `actionProposalWorker.onAdmitted`; a listener that throws is logged and does not stop the
+  * others. Returns the unsubscribe.
+  */
+  onAdmitted(listener) {
+    this.admittedListeners.add(listener);
+    return () => {
+      this.admittedListeners.delete(listener);
+    };
+  }
+  async admitted(outcome) {
+    const configured = this.options.actionProposalWorker?.onAdmitted;
+    for (const listener of [
+      ...configured ? [
+        configured
+      ] : [],
+      ...this.admittedListeners
+    ]) {
+      try {
+        await listener(outcome);
+      } catch (error) {
+        this.logger.error(error);
+      }
+    }
+  }
   /**
   * Run `listener` after every proposal this process's worker settles — how a module relays an
   * outcome somewhere the turn's stream no longer reaches (a text channel's conversation). Next to
@@ -6657,6 +6704,7 @@ var ActionProposalWorkerService = class _ActionProposalWorkerService {
       workerId: (0, import_node_crypto3.randomUUID)(),
       ...this.options.actionProposalWorker,
       onSettled: /* @__PURE__ */ __name((proposal) => this.settled(proposal), "onSettled"),
+      onAdmitted: /* @__PURE__ */ __name((outcome) => this.admitted(outcome), "onAdmitted"),
       executor: new import_nestjs_agent_core36.ActionProposalExecutor({
         resolver,
         resolveExecution: /* @__PURE__ */ __name(async (proposal, actor) => {
@@ -7472,6 +7520,13 @@ function forwardingPolicy(wrapper) {
         throw new Error("AgentModule: the AGENT_ROLES_POLICY bound by another module is not ready yet");
       }
       return policy.can(actor, tool);
+    },
+    canOffer(actor, tool) {
+      const policy = wrapper.instance;
+      if (policy === void 0 || policy === null) {
+        throw new Error("AgentModule: the AGENT_ROLES_POLICY bound by another module is not ready yet");
+      }
+      return policy.canOffer ? policy.canOffer(actor, tool) : policy.can(actor, tool);
     }
   };
 }
@@ -7513,7 +7568,14 @@ function sharedProviders(durable, engine) {
       // drift, and a user would be offered a skill the agent cannot reach. `undefined` when the
       // host configured none — which is what keeps the turn's checkpoint sequence unchanged.
       provide: import_nestjs_agent_core40.AGENT_SKILLS,
-      useFactory: /* @__PURE__ */ __name((options, declared) => resolveSkillsConfig(options.skills, declared), "useFactory"),
+      // Personal agents resolve no skill scope (`personalAgentScopes`): nothing of the app's to load.
+      useFactory: /* @__PURE__ */ __name((options, declared) => {
+        const skills = resolveSkillsConfig(options.skills, declared);
+        return skills === void 0 ? void 0 : {
+          ...skills,
+          scopes: (0, import_nestjs_agent_core40.personalAgentScopes)(skills.scopes)
+        };
+      }, "useFactory"),
       inject: [
         import_nestjs_agent_core40.AGENT_OPTIONS,
         import_nestjs_agent_core40.AGENT_SKILL_SOURCES
@@ -7523,7 +7585,12 @@ function sharedProviders(durable, engine) {
       // One resolution, shared by the loop's deps and the read-back endpoint: a person has to be
       // shown what the model was shown, and two resolutions would eventually disagree about that.
       provide: import_nestjs_agent_core40.AGENT_MEMORY,
-      useFactory: /* @__PURE__ */ __name((options) => options.memory, "useFactory"),
+      // Personal agents resolve no memory scope (`personalAgentScopes`): under a signed-in Poppy
+      // conversation the actor is the account, and it must neither read nor write its memories.
+      useFactory: /* @__PURE__ */ __name((options) => options.memory === void 0 ? void 0 : {
+        ...options.memory,
+        scopes: (0, import_nestjs_agent_core40.personalAgentScopes)(options.memory.scopes)
+      }, "useFactory"),
       inject: [
         import_nestjs_agent_core40.AGENT_OPTIONS
       ]
@@ -7537,7 +7604,10 @@ function sharedProviders(durable, engine) {
     },
     {
       provide: import_nestjs_agent_core40.AGENT_ROLES_POLICY,
-      useFactory: /* @__PURE__ */ __name((options, modules) => resolveRolesPolicy(options, modules), "useFactory"),
+      // Personal agents (a Poppy conversation, a Poppy session's MCP token) reach only the tools
+      // written for them, and run only those of the scopes their user granted. A no-op for every
+      // other actor.
+      useFactory: /* @__PURE__ */ __name((options, modules) => (0, import_nestjs_agent_core40.personalAgentGate)(resolveRolesPolicy(options, modules)), "useFactory"),
       inject: [
         import_nestjs_agent_core40.AGENT_OPTIONS,
         import_core4.ModulesContainer