@dudousxd/nestjs-agent 2.0.1 → 2.1.0

package/dist/a2ui/index.d.cts

@@ -1,10 +1,10 @@
 export * from '@dudousxd/nestjs-agent-core/a2ui';
-export { b as A2uiAdapterOptions, c as A2uiRunHandler, i as a2uiAdapter } from '../index-BBkyvNUi.cjs';
+export { b as A2uiAdapterOptions, c as A2uiRunHandler, i as a2uiAdapter } from '../index-QYQiIXCI.cjs';
 import '@dudousxd/nestjs-agent-core';
 import 'express';
 import '@dudousxd/nestjs-agent-core/genui';
-import '../chat-queue.service-C49HIuEV.cjs';
-import '@standard-schema/spec';
 import '@nestjs/common';
+import '../chat-queue.service-OY6mUgB9.cjs';
+import '@standard-schema/spec';
 import '@nestjs/ai';
 import '../genui/index.cjs';

package/dist/a2ui/index.d.ts

@@ -1,10 +1,10 @@
 export * from '@dudousxd/nestjs-agent-core/a2ui';
-export { b as A2uiAdapterOptions, c as A2uiRunHandler, i as a2uiAdapter } from '../index-CRCbsO6E.js';
+export { b as A2uiAdapterOptions, c as A2uiRunHandler, i as a2uiAdapter } from '../index-Ba_0o9Ze.js';
 import '@dudousxd/nestjs-agent-core';
 import 'express';
 import '@dudousxd/nestjs-agent-core/genui';
-import '../chat-queue.service-BjPCw4Pf.js';
-import '@standard-schema/spec';
 import '@nestjs/common';
+import '../chat-queue.service-MYNBAY3P.js';
+import '@standard-schema/spec';
 import '@nestjs/ai';
 import '../genui/index.js';

package/dist/{chat-queue.service-BjPCw4Pf.d.ts → chat-queue.service-MYNBAY3P.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, Actor, AiToolCtx, ActionApprovalMode, BackgroundActorResolver, ActionProposal, ActionProposalOutcome, TextActionProposalConfig, PriceCatalogOptions, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, 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, Actor, AiToolCtx, ActionApprovalMode, BackgroundActorResolver, ActionProposal, ActionProposalOutcome, TextActionProposalConfig, PriceCatalogOptions, TenancyOption, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, 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, ModuleMetadata, OptionalFactoryDependency } from '@nestjs/common';
@@ -142,8 +142,16 @@ interface QuotaLimits {
     day?: QuotaWindowLimits;
     month?: QuotaWindowLimits;
 }
+/**
+ * Whose spend a window sums: the actor's own (`'actor'`, the default), every actor's in the actor's
+ * tenant (`'tenant'`), or the actor's own within that tenant (`'actor-in-tenant'`). The tenant is
+ * `Actor.tenantRef`; an actor without one is counted per actor.
+ */
+type QuotaPer = 'actor' | 'tenant' | 'actor-in-tenant';
 /** {@link LedgerQuotaProvider}'s tuning beyond the ceilings. */
 interface LedgerQuotaOptions {
+    /** See {@link QuotaPer}. Default `'actor'`. Needs a store with `usageWindowsForTenant` otherwise. */
+    per?: QuotaPer;
     /**
      * The soft limit: the share of a ceiling (`0..1`) past which the report carries a `warning`.
      * Stamped on every window that has a ceiling. Omit → no warnings.
@@ -164,7 +172,7 @@ interface LedgerQuotaOptions {
  * - `month` — when the store implements `usageBetween` or `usageWindows`.
  *
  * `limits` add ceilings per window (tokens and/or USD). A window that reaches one makes the report
- * `blocked`.
+ * `blocked`. `options.per` sums the windows by tenant instead of by actor (see {@link QuotaPer}).
  */
 declare class LedgerQuotaProvider implements QuotaProvider {
     private readonly store;
@@ -449,12 +457,26 @@ interface AgentModuleOptions {
      * provider that reports none (marked `cost_source = 'estimate'`). `countEstimatedCost: false` counts
      * reported cost only. The default (`true`) is there because otherwise a USD ceiling on Bedrock /
      * OpenAI / Anthropic direct would read $0 and never block.
+     *
+     * `per` picks whose spend the windows sum: `'actor'` (default) the actor's own; `'tenant'` every
+     * actor's in the actor's tenant (`Actor.tenantRef`); `'actor-in-tenant'` the actor's own within
+     * that tenant. An actor with no tenant is counted per actor.
      */
     quota?: {
         limits: QuotaLimits;
         warnAt?: number;
         countEstimatedCost?: boolean;
+        per?: QuotaPer;
     } | QuotaProvider;
+    /**
+     * Scope the agent by the request's tenant (from `@dudousxd/nestjs-context`). Default
+     * `'inherit'`: follow `ContextModule`'s `tenancy.enabled`, which is off by default. With tenancy
+     * on, an actor the `actorResolver` resolved without a `tenantRef` gets the context tenant's id,
+     * `recordUsage` records it when the input names none, and thread and run reads (and the governance
+     * dashboard) see only the request tenant's rows: another tenant's thread or run answers `404`.
+     * A `tenantRef` your resolver sets always wins. `false` keeps the agent out of tenancy.
+     */
+    tenancy?: TenancyOption;
     /**
      * Which models a caller may pick — `GET <base>/models`, a send's `model`, a thread's pinned model
      * (`PATCH <base>/threads/:id { model }`). Omit → the catalog the model provider carries

package/dist/{chat-queue.service-C49HIuEV.d.cts → chat-queue.service-OY6mUgB9.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, Actor, AiToolCtx, ActionApprovalMode, BackgroundActorResolver, ActionProposal, ActionProposalOutcome, TextActionProposalConfig, PriceCatalogOptions, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, 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, Actor, AiToolCtx, ActionApprovalMode, BackgroundActorResolver, ActionProposal, ActionProposalOutcome, TextActionProposalConfig, PriceCatalogOptions, TenancyOption, ModelCatalog, EmptyRoles, ActorResolver, AgentHistoryWindow, SkillProvider, ScopeResolver, MemoryProvider, AgentRegistry, PersonaCatalogEntry, 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, ModuleMetadata, OptionalFactoryDependency } from '@nestjs/common';
@@ -142,8 +142,16 @@ interface QuotaLimits {
     day?: QuotaWindowLimits;
     month?: QuotaWindowLimits;
 }
+/**
+ * Whose spend a window sums: the actor's own (`'actor'`, the default), every actor's in the actor's
+ * tenant (`'tenant'`), or the actor's own within that tenant (`'actor-in-tenant'`). The tenant is
+ * `Actor.tenantRef`; an actor without one is counted per actor.
+ */
+type QuotaPer = 'actor' | 'tenant' | 'actor-in-tenant';
 /** {@link LedgerQuotaProvider}'s tuning beyond the ceilings. */
 interface LedgerQuotaOptions {
+    /** See {@link QuotaPer}. Default `'actor'`. Needs a store with `usageWindowsForTenant` otherwise. */
+    per?: QuotaPer;
     /**
      * The soft limit: the share of a ceiling (`0..1`) past which the report carries a `warning`.
      * Stamped on every window that has a ceiling. Omit → no warnings.
@@ -164,7 +172,7 @@ interface LedgerQuotaOptions {
  * - `month` — when the store implements `usageBetween` or `usageWindows`.
  *
  * `limits` add ceilings per window (tokens and/or USD). A window that reaches one makes the report
- * `blocked`.
+ * `blocked`. `options.per` sums the windows by tenant instead of by actor (see {@link QuotaPer}).
  */
 declare class LedgerQuotaProvider implements QuotaProvider {
     private readonly store;
@@ -449,12 +457,26 @@ interface AgentModuleOptions {
      * provider that reports none (marked `cost_source = 'estimate'`). `countEstimatedCost: false` counts
      * reported cost only. The default (`true`) is there because otherwise a USD ceiling on Bedrock /
      * OpenAI / Anthropic direct would read $0 and never block.
+     *
+     * `per` picks whose spend the windows sum: `'actor'` (default) the actor's own; `'tenant'` every
+     * actor's in the actor's tenant (`Actor.tenantRef`); `'actor-in-tenant'` the actor's own within
+     * that tenant. An actor with no tenant is counted per actor.
      */
     quota?: {
         limits: QuotaLimits;
         warnAt?: number;
         countEstimatedCost?: boolean;
+        per?: QuotaPer;
     } | QuotaProvider;
+    /**
+     * Scope the agent by the request's tenant (from `@dudousxd/nestjs-context`). Default
+     * `'inherit'`: follow `ContextModule`'s `tenancy.enabled`, which is off by default. With tenancy
+     * on, an actor the `actorResolver` resolved without a `tenantRef` gets the context tenant's id,
+     * `recordUsage` records it when the input names none, and thread and run reads (and the governance
+     * dashboard) see only the request tenant's rows: another tenant's thread or run answers `404`.
+     * A `tenantRef` your resolver sets always wins. `false` keeps the agent out of tenancy.
+     */
+    tenancy?: TenancyOption;
     /**
      * Which models a caller may pick — `GET <base>/models`, a send's `model`, a thread's pinned model
      * (`PATCH <base>/threads/:id { model }`). Omit → the catalog the model provider carries