@dudousxd/nestjs-agent 1.23.1 → 1.24.0

package/dist/{chat-queue.service-D1z3WjFI.d.cts → chat-queue.service-Crf9uwum.d.cts}

@@ -1,4 +1,4 @@
-import { ResolveToolUiCatalog, 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, TextActionProposalConfig, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, ActionProposal, Actor, AttachmentStagingStore, ChatQueueStore, ChatQueueState, AgentRunner, AgentRunInput, AgentStreamEvent, QueuePauseReason } from '@dudousxd/nestjs-agent-core';
+import { ResolveToolUiCatalog, 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, 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';
@@ -296,12 +296,16 @@ interface AgentModuleOptions {
      * (started with the module unless `surface: 'http'`). `pollIntervalMs` — how often it looks for
      * queued work, default 1000; `leaseMs` — how long a claim holds before another worker may recover
      * it, default 30000; `maxConcurrency` — proposals claimed per poll, default 1. All positive
-     * integers, and `pollIntervalMs` must stay below a third of `leaseMs`.
+     * 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`.
      */
     actionProposalWorker?: {
         pollIntervalMs?: number;
         leaseMs?: number;
         maxConcurrency?: number;
+        onSettled?(proposal: ActionProposal): 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-CwxJDrBM.d.ts → chat-queue.service-ZQkqb1Yw.d.ts}

@@ -1,4 +1,4 @@
-import { ResolveToolUiCatalog, 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, TextActionProposalConfig, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, ActionProposal, Actor, AttachmentStagingStore, ChatQueueStore, ChatQueueState, AgentRunner, AgentRunInput, AgentStreamEvent, QueuePauseReason } from '@dudousxd/nestjs-agent-core';
+import { ResolveToolUiCatalog, 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, 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';
@@ -296,12 +296,16 @@ interface AgentModuleOptions {
      * (started with the module unless `surface: 'http'`). `pollIntervalMs` — how often it looks for
      * queued work, default 1000; `leaseMs` — how long a claim holds before another worker may recover
      * it, default 30000; `maxConcurrency` — proposals claimed per poll, default 1. All positive
-     * integers, and `pollIntervalMs` must stay below a third of `leaseMs`.
+     * 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`.
      */
     actionProposalWorker?: {
         pollIntervalMs?: number;
         leaseMs?: number;
         maxConcurrency?: number;
+        onSettled?(proposal: ActionProposal): 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

@@ -1749,6 +1749,31 @@ AgentDepsFactory2 = _ts_decorate6([
 var import_nestjs_agent_core16 = require("@dudousxd/nestjs-agent-core");
 var import_common10 = require("@nestjs/common");
 
+// src/attachment-limits.ts
+var DEFAULT_MAX_ATTACHMENT_BYTES = 20 * 1024 * 1024;
+var DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES = [
+  "image/png",
+  "image/jpeg",
+  "image/gif",
+  "image/webp",
+  "application/pdf",
+  "text/plain",
+  "text/csv"
+];
+var MAX_ATTACHMENTS_PER_MESSAGE = 10;
+function attachmentLimits(options, staging) {
+  const declared = staging?.describe?.();
+  const own = options?.attachments;
+  return {
+    enabled: staging !== void 0,
+    upload: staging === void 0 ? null : declared?.upload ?? "multipart",
+    maxBytes: declared?.maxBytes ?? own?.maxBytes ?? DEFAULT_MAX_ATTACHMENT_BYTES,
+    allowedContentTypes: declared?.allowedContentTypes ?? own?.allowedContentTypes ?? DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES,
+    maxPerMessage: MAX_ATTACHMENTS_PER_MESSAGE
+  };
+}
+__name(attachmentLimits, "attachmentLimits");
+
 // src/proposals/action-proposal.service.ts
 var import_nestjs_agent_core12 = require("@dudousxd/nestjs-agent-core");
 var import_common7 = require("@nestjs/common");
@@ -1905,6 +1930,10 @@ var ActionProposalService = class {
       text: this.reply(result, decision)
     };
   }
+  /** The configured words a text decision is made of (`actionProposalText.vocabulary`). */
+  textVocabulary() {
+    return this.vocabulary;
+  }
   /** The configured reply to a decision the store answered with `result`. */
   reply(result, decision) {
     return (0, import_nestjs_agent_core12.textActionProposalReply)(result, decision, this.replies);
@@ -2531,6 +2560,65 @@ var AgentService = class {
     };
     return this.proposals.handleTextDecision(threadId, actor, text);
   }
+  /** How `action` tools wait for their approval here — `AgentModule.forRoot({ actionApprovalMode })`. */
+  actionApprovalMode() {
+    return this.options?.actionApprovalMode ?? "blocking";
+  }
+  /**
+  * The words a text decision is made of (`actionProposalText.vocabulary`, English by default) — what
+  * a surface without buttons tells the person to reply.
+  */
+  actionProposalVocabulary() {
+    return this.proposals?.textVocabulary() ?? import_nestjs_agent_core16.DEFAULT_TEXT_ACTION_PROPOSAL_VOCABULARY;
+  }
+  /** The configured reply (`actionProposalText.replies`) to a decision the store answered with `result`. */
+  actionProposalReply(result, decision) {
+    return this.proposals?.reply(result, decision) ?? (0, import_nestjs_agent_core16.textActionProposalReply)(result, decision);
+  }
+  /**
+  * The proposals of a thread this actor may see — the thread's own actor, or one the policy lets
+  * decide them; what `GET <base>/threads/:threadId/action-proposals` serves (its first page). `404`
+  * when independent approvals are not on.
+  */
+  async listActionProposals(actor, threadId) {
+    if (this.options?.actionApprovalMode !== "independent" || !this.proposals) {
+      throw new import_common10.NotFoundException("Proposal not found");
+    }
+    return this.proposals.list(threadId, actor);
+  }
+  /**
+  * The attachment rules in force — what `GET <base>/config` serves and `POST <base>/attachments`
+  * enforces. `enabled: false` when no `AGENT_ATTACHMENT_STAGING` provider is bound.
+  */
+  attachmentLimits() {
+    return attachmentLimits(this.options, this.staging);
+  }
+  /**
+  * Stage a file for a later turn, held to the same limits as `POST <base>/attachments` — for a
+  * surface that receives files itself (a messaging webhook). Refuses with `501` when attachments are
+  * off, `415` for a type outside the allowlist and `413` past the size cap; send the returned
+  * `mediaId` as `attachments: [{ mediaId }]`.
+  */
+  async stageAttachment(actor, file) {
+    if (this.staging === void 0) {
+      throw new import_common10.NotImplementedException("Attachments are not configured on this server: bind AGENT_ATTACHMENT_STAGING (e.g. import AgentMediaAttachmentsModule).");
+    }
+    const { allowedContentTypes, maxBytes } = this.attachmentLimits();
+    const contentType = file.contentType.split(";")[0]?.trim().toLowerCase() ?? "";
+    if (!allowedContentTypes.includes(contentType)) {
+      throw new import_common10.UnsupportedMediaTypeException(`content type "${contentType}" is not allowed (allowed: ${allowedContentTypes.join(", ")})`);
+    }
+    if (file.data.byteLength > maxBytes) {
+      throw new import_common10.PayloadTooLargeException(`file exceeds the ${maxBytes}-byte limit`);
+    }
+    return this.staging.stage({
+      data: file.data,
+      filename: file.filename,
+      contentType,
+      sizeBytes: file.data.byteLength,
+      actor
+    });
+  }
   /** The queue service when the bound store can hold a queue, else `undefined`. */
   queueing() {
     return this.queue?.supported === true ? this.queue : void 0;
@@ -3814,33 +3902,6 @@ AgentsController = _ts_decorate11([
 var import_nestjs_agent_core18 = require("@dudousxd/nestjs-agent-core");
 var import_common13 = require("@nestjs/common");
 var import_platform_express = require("@nestjs/platform-express");
-
-// src/attachment-limits.ts
-var DEFAULT_MAX_ATTACHMENT_BYTES = 20 * 1024 * 1024;
-var DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES = [
-  "image/png",
-  "image/jpeg",
-  "image/gif",
-  "image/webp",
-  "application/pdf",
-  "text/plain",
-  "text/csv"
-];
-var MAX_ATTACHMENTS_PER_MESSAGE = 10;
-function attachmentLimits(options, staging) {
-  const declared = staging?.describe?.();
-  const own = options?.attachments;
-  return {
-    enabled: staging !== void 0,
-    upload: staging === void 0 ? null : declared?.upload ?? "multipart",
-    maxBytes: declared?.maxBytes ?? own?.maxBytes ?? DEFAULT_MAX_ATTACHMENT_BYTES,
-    allowedContentTypes: declared?.allowedContentTypes ?? own?.allowedContentTypes ?? DEFAULT_ALLOWED_ATTACHMENT_CONTENT_TYPES,
-    maxPerMessage: MAX_ATTACHMENTS_PER_MESSAGE
-  };
-}
-__name(attachmentLimits, "attachmentLimits");
-
-// src/controller/attachments.controller.ts
 function _ts_decorate12(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") {
@@ -6131,6 +6192,34 @@ var ActionProposalWorkerService = class _ActionProposalWorkerService {
   deps;
   worker;
   logger = new import_common28.Logger(_ActionProposalWorkerService.name);
+  settledListeners = /* @__PURE__ */ new Set();
+  /**
+  * 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
+  * `actionProposalWorker.onSettled`; a listener that throws is logged and does not stop the others.
+  * Returns the unsubscribe. Only the replicas that run the worker (not `surface: 'http'`) call it.
+  */
+  onSettled(listener) {
+    this.settledListeners.add(listener);
+    return () => {
+      this.settledListeners.delete(listener);
+    };
+  }
+  async settled(proposal) {
+    const configured = this.options.actionProposalWorker?.onSettled;
+    for (const listener of [
+      ...configured ? [
+        configured
+      ] : [],
+      ...this.settledListeners
+    ]) {
+      try {
+        await listener(proposal);
+      } catch (error) {
+        this.logger.error(error);
+      }
+    }
+  }
   constructor(store, options, deps) {
     this.store = store;
     this.options = options;
@@ -6146,6 +6235,7 @@ var ActionProposalWorkerService = class _ActionProposalWorkerService {
       store: this.store,
       workerId: (0, import_node_crypto3.randomUUID)(),
       ...this.options.actionProposalWorker,
+      onSettled: /* @__PURE__ */ __name((proposal) => this.settled(proposal), "onSettled"),
       executor: new import_nestjs_agent_core35.ActionProposalExecutor({
         resolver,
         resolveExecution: /* @__PURE__ */ __name(async (proposal, actor) => {