@dudousxd/nestjs-agent 1.34.0 → 1.35.0

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

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

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

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

package/dist/index.cjs

@@ -4985,9 +4985,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;
@@ -5199,7 +5209,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_core24.normalizeDelegation)(edge);
+        const { agent: target, detached, roles, ability } = (0, import_nestjs_agent_core24.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.`);
@@ -5221,6 +5231,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()
@@ -5633,6 +5649,35 @@ var ActionProposalWorkerService = class _ActionProposalWorkerService {
   worker;
   logger = new import_common25.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
@@ -5676,6 +5721,7 @@ var ActionProposalWorkerService = class _ActionProposalWorkerService {
       workerId: (0, import_node_crypto2.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_core30.ActionProposalExecutor({
         resolver,
         resolveExecution: /* @__PURE__ */ __name(async (proposal, actor) => {
@@ -6494,6 +6540,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);
     }
   };
 }
@@ -6535,7 +6588,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_core34.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_core34.personalAgentScopes)(skills.scopes)
+        };
+      }, "useFactory"),
       inject: [
         import_nestjs_agent_core34.AGENT_OPTIONS,
         import_nestjs_agent_core34.AGENT_SKILL_SOURCES
@@ -6545,7 +6605,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_core34.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_core34.personalAgentScopes)(options.memory.scopes)
+      }, "useFactory"),
       inject: [
         import_nestjs_agent_core34.AGENT_OPTIONS
       ]
@@ -6559,7 +6624,10 @@ function sharedProviders(durable, engine) {
     },
     {
       provide: import_nestjs_agent_core34.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_core34.personalAgentGate)(resolveRolesPolicy(options, modules)), "useFactory"),
       inject: [
         import_nestjs_agent_core34.AGENT_OPTIONS,
         import_core4.ModulesContainer