@dudousxd/nestjs-agent 1.7.0 → 1.9.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { DynamicModule, OnModuleInit, Type, OnApplicationBootstrap } from '@nestjs/common';
-import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, d as AgentSkillsOptions } from './agent-deps.factory-CiC5Va9J.cjs';
-export { e as AGENT_TOOL_BRAND, f as AgentAttachmentsOptions, g as AgentDeps, h as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, i as delegateToolName, p as provideAgentTool, u as utcDay } from './agent-deps.factory-CiC5Va9J.cjs';
-import { AgentRunner, AgentStore, QuotaStore, AttachmentStagingStore, ModelCatalog, Actor, ModelCatalogView, AttachmentRef, PageContext, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, QuotaView, AgentApprovalPort, ActorResolver, MessageAttachment, ToolPresentation, AgentHistoryWindow, AgentIntake, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, TokenStreamSink, SinkWriter, QuotaState } from '@dudousxd/nestjs-agent-core';
+import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, d as AgentSkillsOptions } from './agent-deps.factory-DuTy1UyU.cjs';
+export { e as AGENT_TOOL_BRAND, f as AgentAttachmentsOptions, g as AgentDeps, h as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QuotaLimits, i as QuotaWindowLimits, j as delegateToolName, p as provideAgentTool, k as provideAgentTools, u as utcDay } from './agent-deps.factory-DuTy1UyU.cjs';
+import { AgentRunner, AgentStore, QuotaStore, AttachmentStagingStore, ModelCatalog, QuotaProvider, Actor, QuotaReport, ModelCatalogView, AttachmentRef, PageContext, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, QuotaView, AgentApprovalPort, ActorResolver, MessageAttachment, ToolPresentation, AgentHistoryWindow, AgentIntake, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, TokenStreamSink, SinkWriter, QuotaState } from '@dudousxd/nestjs-agent-core';
 export * from '@dudousxd/nestjs-agent-core';
 import { Request } from 'express';
 import { StandardSchemaV1 } from '@standard-schema/spec';
@@ -59,7 +59,20 @@ declare class AgentService {
     private readonly quota;
     private readonly staging?;
     private readonly models?;
-    constructor(runner: AgentRunner, store: AgentStore, deps: AgentDepsFactory, quota: QuotaStore | undefined, staging?: AttachmentStagingStore | undefined, models?: ModelCatalog | undefined);
+    private readonly quotaProvider?;
+    private readonly options?;
+    constructor(runner: AgentRunner, store: AgentStore, deps: AgentDepsFactory, quota: QuotaStore | undefined, staging?: AttachmentStagingStore | undefined, models?: ModelCatalog | undefined, quotaProvider?: QuotaProvider | undefined, options?: Pick<AgentModuleOptions, "quotaProvider" | "quotaLimits"> | undefined);
+    /**
+     * The actor's budget across windows (`GET <base>/quota`) — the bound {@link QuotaProvider}'s
+     * report. Without one (a service built outside the module), a day window from the ledger.
+     */
+    quotaReport(actor: Actor): Promise<QuotaReport>;
+    /**
+     * Refuse a turn the actor's budget no longer covers — only when the host configured one
+     * (`quotaProvider` or `quotaLimits`): the default report is informational, and the daily token
+     * quota the loop enforces keeps working as it always has.
+     */
+    private assertWithinQuota;
     /**
      * The models `actor` may pick for `agent` (`GET <base>/models`). An empty catalog when none is
      * bound, so a picker simply has nothing to offer.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { DynamicModule, OnModuleInit, Type, OnApplicationBootstrap } from '@nestjs/common';
-import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, d as AgentSkillsOptions } from './agent-deps.factory-CiC5Va9J.js';
-export { e as AGENT_TOOL_BRAND, f as AgentAttachmentsOptions, g as AgentDeps, h as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, i as delegateToolName, p as provideAgentTool, u as utcDay } from './agent-deps.factory-CiC5Va9J.js';
-import { AgentRunner, AgentStore, QuotaStore, AttachmentStagingStore, ModelCatalog, Actor, ModelCatalogView, AttachmentRef, PageContext, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, QuotaView, AgentApprovalPort, ActorResolver, MessageAttachment, ToolPresentation, AgentHistoryWindow, AgentIntake, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, TokenStreamSink, SinkWriter, QuotaState } from '@dudousxd/nestjs-agent-core';
+import { b as AgentModuleOptions, c as AgentModuleAsyncOptions, A as AgentDepsFactory, d as AgentSkillsOptions } from './agent-deps.factory-DuTy1UyU.js';
+export { e as AGENT_TOOL_BRAND, f as AgentAttachmentsOptions, g as AgentDeps, h as AgentMemoryOptions, a as AgentSurface, F as FunctionalTool, L as LedgerQuotaProvider, Q as QuotaLimits, i as QuotaWindowLimits, j as delegateToolName, p as provideAgentTool, k as provideAgentTools, u as utcDay } from './agent-deps.factory-DuTy1UyU.js';
+import { AgentRunner, AgentStore, QuotaStore, AttachmentStagingStore, ModelCatalog, QuotaProvider, Actor, QuotaReport, ModelCatalogView, AttachmentRef, PageContext, HumanReply, ThreadSummary, ThreadDetail, UpdateThreadInput, MessageFeedbackValue, MessageFeedback, StagedAttachment, QuotaView, AgentApprovalPort, ActorResolver, MessageAttachment, ToolPresentation, AgentHistoryWindow, AgentIntake, SkillContext, ToolRegistry, AgentRegistry, PromptContributor, SkillsConfig, SkillCatalogEntry, ToolCatalogEntry, MemoryConfig, MemoryDigestEntry, SkillProvider, AgentRunInput, TokenStreamSink, SinkWriter, QuotaState } from '@dudousxd/nestjs-agent-core';
 export * from '@dudousxd/nestjs-agent-core';
 import { Request } from 'express';
 import { StandardSchemaV1 } from '@standard-schema/spec';
@@ -59,7 +59,20 @@ declare class AgentService {
     private readonly quota;
     private readonly staging?;
     private readonly models?;
-    constructor(runner: AgentRunner, store: AgentStore, deps: AgentDepsFactory, quota: QuotaStore | undefined, staging?: AttachmentStagingStore | undefined, models?: ModelCatalog | undefined);
+    private readonly quotaProvider?;
+    private readonly options?;
+    constructor(runner: AgentRunner, store: AgentStore, deps: AgentDepsFactory, quota: QuotaStore | undefined, staging?: AttachmentStagingStore | undefined, models?: ModelCatalog | undefined, quotaProvider?: QuotaProvider | undefined, options?: Pick<AgentModuleOptions, "quotaProvider" | "quotaLimits"> | undefined);
+    /**
+     * The actor's budget across windows (`GET <base>/quota`) — the bound {@link QuotaProvider}'s
+     * report. Without one (a service built outside the module), a day window from the ledger.
+     */
+    quotaReport(actor: Actor): Promise<QuotaReport>;
+    /**
+     * Refuse a turn the actor's budget no longer covers — only when the host configured one
+     * (`quotaProvider` or `quotaLimits`): the default report is informational, and the daily token
+     * quota the loop enforces keeps working as it always has.
+     */
+    private assertWithinQuota;
     /**
      * The models `actor` may pick for `agent` (`GET <base>/models`). An empty catalog when none is
      * bound, so a picker simply has nothing to offer.

package/dist/index.js

@@ -2,7 +2,7 @@ var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
 // src/agent.module.ts
-import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER11, AGENT_APPROVAL_PORT, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY5, AGENT_DURABLE_RUNNER, AGENT_MEMORY as AGENT_MEMORY3, AGENT_MODEL as AGENT_MODEL2, AGENT_MODEL_CATALOG as AGENT_MODEL_CATALOG2, AGENT_OPTIONS as AGENT_OPTIONS4, AGENT_PROMPT_CONTRIBUTORS as AGENT_PROMPT_CONTRIBUTORS3, AGENT_QUOTA_STORE as AGENT_QUOTA_STORE3, AGENT_REGISTRY as AGENT_REGISTRY6, AGENT_ROLES_POLICY as AGENT_ROLES_POLICY2, AGENT_RUNNER as AGENT_RUNNER2, AGENT_SINK as AGENT_SINK2, AGENT_SKILLS as AGENT_SKILLS3, AGENT_SKILL_SOURCES as AGENT_SKILL_SOURCES2, AGENT_STORE as AGENT_STORE4, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY3, AgentRegistry as AgentRegistry6, DefaultRolesPolicy, ToolRegistry as ToolRegistry3 } from "@dudousxd/nestjs-agent-core";
+import { AGENT_ACTOR_RESOLVER as AGENT_ACTOR_RESOLVER11, AGENT_APPROVAL_PORT, AGENT_DEPS_FACTORY as AGENT_DEPS_FACTORY5, AGENT_DURABLE_RUNNER, AGENT_MEMORY as AGENT_MEMORY3, AGENT_MODEL as AGENT_MODEL2, AGENT_MODEL_CATALOG as AGENT_MODEL_CATALOG2, AGENT_OPTIONS as AGENT_OPTIONS5, AGENT_PROMPT_CONTRIBUTORS as AGENT_PROMPT_CONTRIBUTORS3, AGENT_QUOTA_PROVIDER as AGENT_QUOTA_PROVIDER2, AGENT_QUOTA_STORE as AGENT_QUOTA_STORE3, AGENT_REGISTRY as AGENT_REGISTRY6, AGENT_ROLES_POLICY as AGENT_ROLES_POLICY2, AGENT_RUNNER as AGENT_RUNNER2, AGENT_SINK as AGENT_SINK2, AGENT_SKILLS as AGENT_SKILLS3, AGENT_SKILL_SOURCES as AGENT_SKILL_SOURCES2, AGENT_STORE as AGENT_STORE4, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY3, AgentRegistry as AgentRegistry6, DefaultRolesPolicy, ToolRegistry as ToolRegistry3 } from "@dudousxd/nestjs-agent-core";
 import { Global, Module } from "@nestjs/common";
 import { DiscoveryModule, RouterModule } from "@nestjs/core";
 
@@ -272,8 +272,8 @@ AgentDepsFactory2 = _ts_decorate([
 ], AgentDepsFactory2);
 
 // src/agent.service.ts
-import { AGENT_ATTACHMENT_STAGING, AGENT_DEPS_FACTORY, AGENT_MODEL_CATALOG, AGENT_QUOTA_STORE as AGENT_QUOTA_STORE2, AGENT_RUNNER, AGENT_STORE as AGENT_STORE2, REQUESTER_APPROVER, findCatalogModel, mayDecideApproval, readElicitationQuestions, validateElicitationAnswer } from "@dudousxd/nestjs-agent-core";
-import { BadRequestException, ForbiddenException, GoneException, Inject as Inject2, Injectable as Injectable2, NotFoundException, NotImplementedException, Optional as Optional2 } from "@nestjs/common";
+import { AGENT_ATTACHMENT_STAGING, AGENT_DEPS_FACTORY, AGENT_MODEL_CATALOG, AGENT_OPTIONS as AGENT_OPTIONS2, AGENT_QUOTA_PROVIDER, AGENT_QUOTA_STORE as AGENT_QUOTA_STORE2, AGENT_RUNNER, AGENT_STORE as AGENT_STORE2, REQUESTER_APPROVER, findCatalogModel, mayDecideApproval, readElicitationQuestions, validateElicitationAnswer } from "@dudousxd/nestjs-agent-core";
+import { BadRequestException, ForbiddenException, GoneException, HttpException, HttpStatus, Inject as Inject2, Injectable as Injectable2, NotFoundException, NotImplementedException, Optional as Optional2 } from "@nestjs/common";
 
 // src/agent-deps.ts
 function utcDay(date = /* @__PURE__ */ new Date()) {
@@ -328,13 +328,68 @@ var AgentService = class {
   quota;
   staging;
   models;
-  constructor(runner, store, deps, quota, staging, models) {
+  quotaProvider;
+  options;
+  constructor(runner, store, deps, quota, staging, models, quotaProvider, options) {
     this.runner = runner;
     this.store = store;
     this.deps = deps;
     this.quota = quota;
     this.staging = staging;
     this.models = models;
+    this.quotaProvider = quotaProvider;
+    this.options = options;
+  }
+  /**
+  * The actor's budget across windows (`GET <base>/quota`) — the bound {@link QuotaProvider}'s
+  * report. Without one (a service built outside the module), a day window from the ledger.
+  */
+  async quotaReport(actor) {
+    if (this.quotaProvider !== void 0) {
+      return this.quotaProvider.report({
+        actor
+      });
+    }
+    const today = await this.quotaToday(actor.id);
+    return {
+      windows: [
+        {
+          period: "day",
+          usedTokens: today.usedTokens,
+          ...today.limitTokens !== null ? {
+            limitTokens: today.limitTokens
+          } : {},
+          usedUsd: today.costUsd
+        }
+      ],
+      ...today.withinLimit ? {} : {
+        blocked: {
+          period: "day"
+        }
+      }
+    };
+  }
+  /**
+  * Refuse a turn the actor's budget no longer covers — only when the host configured one
+  * (`quotaProvider` or `quotaLimits`): the default report is informational, and the daily token
+  * quota the loop enforces keeps working as it always has.
+  */
+  async assertWithinQuota(actor) {
+    const gated = this.options?.quotaProvider !== void 0 || this.options?.quotaLimits !== void 0;
+    if (!gated || this.quotaProvider === void 0) {
+      return;
+    }
+    const { blocked } = await this.quotaProvider.report({
+      actor
+    });
+    if (blocked !== void 0) {
+      throw new HttpException({
+        statusCode: HttpStatus.TOO_MANY_REQUESTS,
+        code: "quota_exceeded",
+        period: blocked.period,
+        message: blocked.reason ?? `The ${blocked.period === "day" ? "daily" : "monthly"} quota is used up`
+      }, HttpStatus.TOO_MANY_REQUESTS);
+    }
   }
   /**
   * The models `actor` may pick for `agent` (`GET <base>/models`). An empty catalog when none is
@@ -391,6 +446,7 @@ var AgentService = class {
     return (await this.store.getThread(threadId))?.model ?? null;
   }
   async chat(params) {
+    await this.assertWithinQuota(params.actor);
     const agentName = await this.resolveAgentName(params.agentName, params.threadId);
     const model = await this.resolveModel(params.actor, agentName, params.model, params.threadId);
     const attachments = await this.resolveAttachments(params.actor, params.attachments ?? []);
@@ -932,6 +988,10 @@ AgentService = _ts_decorate2([
   _ts_param2(4, Inject2(AGENT_ATTACHMENT_STAGING)),
   _ts_param2(5, Optional2()),
   _ts_param2(5, Inject2(AGENT_MODEL_CATALOG)),
+  _ts_param2(6, Optional2()),
+  _ts_param2(6, Inject2(AGENT_QUOTA_PROVIDER)),
+  _ts_param2(7, Optional2()),
+  _ts_param2(7, Inject2(AGENT_OPTIONS2)),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
     typeof AgentRunner === "undefined" ? Object : AgentRunner,
@@ -939,7 +999,9 @@ AgentService = _ts_decorate2([
     typeof AgentDepsFactory === "undefined" ? Object : AgentDepsFactory,
     Object,
     typeof AttachmentStagingStore === "undefined" ? Object : AttachmentStagingStore,
-    typeof ModelCatalog === "undefined" ? Object : ModelCatalog
+    typeof ModelCatalog === "undefined" ? Object : ModelCatalog,
+    typeof QuotaProvider === "undefined" ? Object : QuotaProvider,
+    typeof Pick === "undefined" ? Object : Pick
   ])
 ], AgentService);
 
@@ -1078,7 +1140,7 @@ AgentsController = _ts_decorate4([
 ], AgentsController);
 
 // src/controller/attachments.controller.ts
-import { AGENT_ACTOR_RESOLVER, AGENT_ATTACHMENT_STAGING as AGENT_ATTACHMENT_STAGING2, AGENT_OPTIONS as AGENT_OPTIONS2 } from "@dudousxd/nestjs-agent-core";
+import { AGENT_ACTOR_RESOLVER, AGENT_ATTACHMENT_STAGING as AGENT_ATTACHMENT_STAGING2, AGENT_OPTIONS as AGENT_OPTIONS3 } from "@dudousxd/nestjs-agent-core";
 import { BadRequestException as BadRequestException2, Controller as Controller2, Get as Get2, Inject as Inject4, NotImplementedException as NotImplementedException2, Optional as Optional3, PayloadTooLargeException, Post, Req, UnsupportedMediaTypeException, UploadedFile, UseInterceptors } from "@nestjs/common";
 import { FileInterceptor } from "@nestjs/platform-express";
 function _ts_decorate5(decorators, target, key, desc) {
@@ -1211,7 +1273,7 @@ _ts_decorate5([
 ], AttachmentsController.prototype, "upload", null);
 AttachmentsController = _ts_decorate5([
   Controller2("attachments"),
-  _ts_param4(0, Inject4(AGENT_OPTIONS2)),
+  _ts_param4(0, Inject4(AGENT_OPTIONS3)),
   _ts_param4(1, Inject4(AGENT_ACTOR_RESOLVER)),
   _ts_param4(3, Optional3()),
   _ts_param4(3, Inject4(AGENT_ATTACHMENT_STAGING2)),
@@ -1786,11 +1848,28 @@ var QuotaController = class {
     this.agent = agent;
     this.actorResolver = actorResolver;
   }
+  /**
+  * The caller's budget across windows — `{ windows: [{ period, usedTokens, limitTokens?, usedUsd,
+  * limitUsd?, resetsAt? }], blocked?: { period, reason? } }` — from the bound `QuotaProvider`.
+  */
+  async report(req) {
+    const actor = await this.actorResolver.resolve(req);
+    return this.agent.quotaReport(actor);
+  }
   async today(req) {
     const actor = await this.actorResolver.resolve(req);
     return this.agent.quotaToday(actor.id);
   }
 };
+_ts_decorate10([
+  Get6(),
+  _ts_param9(0, Req6()),
+  _ts_metadata10("design:type", Function),
+  _ts_metadata10("design:paramtypes", [
+    typeof Request === "undefined" ? Object : Request
+  ]),
+  _ts_metadata10("design:returntype", Promise)
+], QuotaController.prototype, "report", null);
 _ts_decorate10([
   Get6("today"),
   _ts_param9(0, Req6()),
@@ -2565,7 +2644,7 @@ AgentDiscoveryService = _ts_decorate15([
 ], AgentDiscoveryService);
 
 // src/discovery/ai-tool-discovery.service.ts
-import { AGENT_OPTIONS as AGENT_OPTIONS3, AGENT_REGISTRY as AGENT_REGISTRY5, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY2, normalizeDelegation as normalizeDelegation2 } from "@dudousxd/nestjs-agent-core";
+import { AGENT_OPTIONS as AGENT_OPTIONS4, AGENT_REGISTRY as AGENT_REGISTRY5, AGENT_TOOL_REGISTRY as AGENT_TOOL_REGISTRY2, normalizeDelegation as normalizeDelegation2 } from "@dudousxd/nestjs-agent-core";
 import { Inject as Inject15, Injectable as Injectable5, Logger as Logger2 } from "@nestjs/common";
 import { DiscoveryService as DiscoveryService2 } from "@nestjs/core";
 import { z } from "zod";
@@ -2613,6 +2692,14 @@ function provideAgentTool(factoryOrTool, inject) {
   };
 }
 __name(provideAgentTool, "provideAgentTool");
+function provideAgentTools(factory, inject) {
+  return {
+    provide: /* @__PURE__ */ Symbol("nestjs-agent:functional-tool-list"),
+    useFactory: /* @__PURE__ */ __name(async (...deps) => (await factory(...deps)).map(brand), "useFactory"),
+    inject: inject ?? []
+  };
+}
+__name(provideAgentTools, "provideAgentTools");
 
 // src/discovery/ai-tool-discovery.service.ts
 function _ts_decorate16(decorators, target, key, desc) {
@@ -2664,6 +2751,14 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
       if (instance === null || instance === void 0 || typeof instance !== "object") {
         continue;
       }
+      if (Array.isArray(instance) && instance.length > 0 && instance.every((each) => typeof each === "object" && each !== null && isBrandedFunctionalTool(each))) {
+        for (const tool of instance) {
+          if (this.registerFunctionalTool(tool)) {
+            functional += 1;
+          }
+        }
+        continue;
+      }
       if (isBrandedFunctionalTool(instance)) {
         if (this.registerFunctionalTool(instance)) {
           functional += 1;
@@ -2711,6 +2806,9 @@ var AiToolDiscoveryService = class _AiToolDiscoveryService {
         } : {},
         ...typeof handler.canUse === "function" ? {
           canUse: /* @__PURE__ */ __name((actor) => instance.canUse(actor), "canUse")
+        } : {},
+        ...typeof handler.describe === "function" ? {
+          describe: /* @__PURE__ */ __name((scope) => instance.describe(scope), "describe")
         } : {}
       });
       count += 1;
@@ -2777,7 +2875,7 @@ AiToolDiscoveryService = _ts_decorate16([
   Injectable5(),
   _ts_param15(1, Inject15(AGENT_TOOL_REGISTRY2)),
   _ts_param15(2, Inject15(AGENT_REGISTRY5)),
-  _ts_param15(3, Inject15(AGENT_OPTIONS3)),
+  _ts_param15(3, Inject15(AGENT_OPTIONS4)),
   _ts_metadata16("design:type", Function),
   _ts_metadata16("design:paramtypes", [
     typeof DiscoveryService2 === "undefined" ? Object : DiscoveryService2,
@@ -2959,6 +3057,69 @@ var InProcessTokenStreamSink = class {
   }
 };
 
+// src/ledger-quota-provider.ts
+import { exhaustedWindow, quotaPeriodRange } from "@dudousxd/nestjs-agent-core";
+var LedgerQuotaProvider = class {
+  static {
+    __name(this, "LedgerQuotaProvider");
+  }
+  store;
+  quota;
+  limits;
+  constructor(store, quota, limits = {}) {
+    this.store = store;
+    this.quota = quota;
+    this.limits = limits;
+  }
+  async report(query) {
+    const now = query.now ?? /* @__PURE__ */ new Date();
+    const actorRef = query.actor.id;
+    const windows = [
+      await this.dayWindow(actorRef, now)
+    ];
+    if (this.store.usageBetween !== void 0) {
+      const range = quotaPeriodRange("month", now);
+      const used = await this.store.usageBetween(actorRef, range.fromDay, range.toDay);
+      windows.push(this.window("month", used.usedTokens, used.costUsd, range.resetsAt));
+    }
+    const blocked = exhaustedWindow(windows);
+    return {
+      windows,
+      ...blocked !== void 0 ? {
+        blocked
+      } : {}
+    };
+  }
+  async dayWindow(actorRef, now) {
+    const range = quotaPeriodRange("day", now);
+    const { usedTokens, costUsd } = await this.store.quotaToday(actorRef, range.fromDay);
+    if (this.quota === void 0) {
+      return this.window("day", usedTokens, costUsd, range.resetsAt);
+    }
+    const state = await this.quota.check(actorRef, range.fromDay);
+    const window = this.window("day", state.usedTokens, costUsd, range.resetsAt);
+    if (window.limitTokens === void 0) {
+      window.limitTokens = state.limitTokens;
+    }
+    return window;
+  }
+  window(period, usedTokens, usedUsd, resetsAt) {
+    const limits = this.limits[period] ?? {};
+    return {
+      period,
+      usedTokens,
+      ...limits.tokens !== void 0 ? {
+        limitTokens: limits.tokens
+      } : {},
+      usedUsd,
+      ...limits.usd !== void 0 ? {
+        limitUsd: limits.usd
+      } : {},
+      resetsAt
+    };
+  }
+};
+
 // src/ledger-quota-store.ts
 var LedgerQuotaStore = class {
   static {
@@ -3485,7 +3646,7 @@ function sharedProviders(durable, includeStore) {
       provide: AGENT_SKILLS3,
       useFactory: /* @__PURE__ */ __name((options, declared) => resolveSkillsConfig(options.skills, declared), "useFactory"),
       inject: [
-        AGENT_OPTIONS4,
+        AGENT_OPTIONS5,
         AGENT_SKILL_SOURCES2
       ]
     },
@@ -3495,35 +3656,35 @@ function sharedProviders(durable, includeStore) {
       provide: AGENT_MEMORY3,
       useFactory: /* @__PURE__ */ __name((options) => options.memory, "useFactory"),
       inject: [
-        AGENT_OPTIONS4
+        AGENT_OPTIONS5
       ]
     },
     {
       provide: AGENT_SINK2,
       useFactory: /* @__PURE__ */ __name((options) => options.sink ?? new InProcessTokenStreamSink(), "useFactory"),
       inject: [
-        AGENT_OPTIONS4
+        AGENT_OPTIONS5
       ]
     },
     {
       provide: AGENT_ROLES_POLICY2,
       useFactory: /* @__PURE__ */ __name((options) => options.rolesPolicy ?? new DefaultRolesPolicy(options.defaultRoles), "useFactory"),
       inject: [
-        AGENT_OPTIONS4
+        AGENT_OPTIONS5
       ]
     },
     {
       provide: AGENT_ACTOR_RESOLVER11,
       useFactory: /* @__PURE__ */ __name((options) => options.actorResolver, "useFactory"),
       inject: [
-        AGENT_OPTIONS4
+        AGENT_OPTIONS5
       ]
     },
     {
       provide: AGENT_MODEL2,
       useFactory: /* @__PURE__ */ __name((o) => o.model, "useFactory"),
       inject: [
-        AGENT_OPTIONS4
+        AGENT_OPTIONS5
       ]
     },
     {
@@ -3533,15 +3694,24 @@ function sharedProviders(durable, includeStore) {
       provide: AGENT_QUOTA_STORE3,
       useFactory: /* @__PURE__ */ __name((o, store) => o.quota ?? (o.quotaLimitTokens !== void 0 ? new LedgerQuotaStore(store, o.quotaLimitTokens) : void 0), "useFactory"),
       inject: [
-        AGENT_OPTIONS4,
+        AGENT_OPTIONS5,
         AGENT_STORE4
       ]
     },
+    {
+      provide: AGENT_QUOTA_PROVIDER2,
+      useFactory: /* @__PURE__ */ __name((o, store, quota) => o.quotaProvider ?? new LedgerQuotaProvider(store, quota, o.quotaLimits), "useFactory"),
+      inject: [
+        AGENT_OPTIONS5,
+        AGENT_STORE4,
+        AGENT_QUOTA_STORE3
+      ]
+    },
     {
       provide: AGENT_MODEL_CATALOG2,
       useFactory: /* @__PURE__ */ __name((o) => o.models, "useFactory"),
       inject: [
-        AGENT_OPTIONS4
+        AGENT_OPTIONS5
       ]
     },
     AgentDepsFactory2,
@@ -3569,7 +3739,7 @@ function sharedProviders(durable, includeStore) {
       provide: AGENT_STORE4,
       useFactory: /* @__PURE__ */ __name((o) => o.store, "useFactory"),
       inject: [
-        AGENT_OPTIONS4
+        AGENT_OPTIONS5
       ]
     });
   }
@@ -3600,7 +3770,7 @@ function sharedProviders(durable, includeStore) {
 __name(sharedProviders, "sharedProviders");
 function exportsFor(includeStore) {
   return [
-    AGENT_OPTIONS4,
+    AGENT_OPTIONS5,
     AGENT_TOOL_REGISTRY3,
     AGENT_REGISTRY6,
     AGENT_SINK2,
@@ -3612,6 +3782,7 @@ function exportsFor(includeStore) {
     ] : [],
     AGENT_QUOTA_STORE3,
     AGENT_MODEL_CATALOG2,
+    AGENT_QUOTA_PROVIDER2,
     AGENT_PROMPT_CONTRIBUTORS3,
     AGENT_SKILLS3,
     AGENT_MEMORY3,
@@ -3691,7 +3862,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface, options.attachments?.upload === true),
       providers: [
         {
-          provide: AGENT_OPTIONS4,
+          provide: AGENT_OPTIONS5,
           useValue: options
         },
         ...sharedProviders(options.durable ?? false, includeStore),
@@ -3715,7 +3886,7 @@ var AgentModule = class _AgentModule {
       controllers: controllersForSurface(options.surface, options.attachmentsUpload === true),
       providers: [
         {
-          provide: AGENT_OPTIONS4,
+          provide: AGENT_OPTIONS5,
           // Stamp the STATIC wiring flags onto the factory result: `durable`/`surface` are
           // authoritative on the async config object (they decided the actual wiring above), and
           // the durable module reads `durable` back off AGENT_OPTIONS. `surface` isn't read back by
@@ -3793,6 +3964,7 @@ export {
   HeaderActorResolver,
   InProcessTokenStreamSink,
   InlineAgentRunner,
+  LedgerQuotaProvider,
   LedgerQuotaStore,
   MemoriesController,
   MessagesController,
@@ -3809,6 +3981,7 @@ export {
   declaredSkillProvider,
   delegateToolName,
   provideAgentTool,
+  provideAgentTools,
   readAgentMetadata,
   readAiToolMetadata,
   readSkillMetadata,