@dexto/server 1.6.16 → 1.6.17

package/dist/events/a2a-sse-subscriber.cjs

@@ -98,11 +98,18 @@ class A2ASseEventSubscriber {
           message: {
             role: "agent",
             content: [{ type: "text", text: payload.content }],
-            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+            timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+            ...payload.messageId && { messageId: payload.messageId }
           },
           tokenUsage: payload.tokenUsage,
           provider: payload.provider,
-          model: payload.model
+          model: payload.model,
+          ...payload.messageId && { messageId: payload.messageId },
+          ...payload.usageScopeId && { usageScopeId: payload.usageScopeId },
+          ...payload.estimatedCost !== void 0 && {
+            estimatedCost: payload.estimatedCost
+          },
+          ...payload.pricingStatus && { pricingStatus: payload.pricingStatus }
         });
       },
       { signal }

package/dist/events/a2a-sse-subscriber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"a2a-sse-subscriber.d.ts","sourceRoot":"","sources":["../../src/events/a2a-sse-subscriber.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAiB5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,qBAAqB,CAAC,CAAkB;IAEhD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAkHxC;;;;;;;OAOG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC;IAiDxD;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IA0BvB;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,IAAI,IAAI;IAgBf;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CASjD"}
+{"version":3,"file":"a2a-sse-subscriber.d.ts","sourceRoot":"","sources":["../../src/events/a2a-sse-subscriber.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAiB5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,qBAAqB;IAC9B,OAAO,CAAC,WAAW,CAAyC;IAC5D,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,qBAAqB,CAAC,CAAkB;IAEhD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAyHxC;;;;;;;OAOG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC;IAiDxD;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IA0BvB;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IASpB;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,OAAO,IAAI,IAAI;IAgBf;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CASjD"}

package/dist/events/a2a-sse-subscriber.js

@@ -75,11 +75,18 @@ class A2ASseEventSubscriber {
           message: {
             role: "agent",
             content: [{ type: "text", text: payload.content }],
-            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+            timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+            ...payload.messageId && { messageId: payload.messageId }
           },
           tokenUsage: payload.tokenUsage,
           provider: payload.provider,
-          model: payload.model
+          model: payload.model,
+          ...payload.messageId && { messageId: payload.messageId },
+          ...payload.usageScopeId && { usageScopeId: payload.usageScopeId },
+          ...payload.estimatedCost !== void 0 && {
+            estimatedCost: payload.estimatedCost
+          },
+          ...payload.pricingStatus && { pricingStatus: payload.pricingStatus }
         });
       },
       { signal }

package/dist/events/usage-event-subscriber.cjs

@@ -0,0 +1,263 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var usage_event_subscriber_exports = {};
+__export(usage_event_subscriber_exports, {
+  UsageEventSubscriber: () => UsageEventSubscriber
+});
+module.exports = __toCommonJS(usage_event_subscriber_exports);
+var import_events = require("events");
+var import_core = require("@dexto/core");
+const OUTBOX_KEY_PREFIX = "usage-outbox:";
+const DEFAULT_DELIVERY_OPTIONS = {
+  fetchFn: fetch,
+  flushIntervalMs: 5e3,
+  batchSize: 50,
+  requestTimeoutMs: 1e4
+};
+function requirePositiveIntegerOption(name, value) {
+  if (!Number.isInteger(value) || value <= 0) {
+    throw new RangeError(
+      `UsageEventSubscriber ${name} must be a positive integer. Received: ${value}`
+    );
+  }
+  return value;
+}
+function createUsageEventId(usageScopeId, messageId) {
+  return `usage:${usageScopeId}:${messageId}`;
+}
+function createOutboxKey(eventId) {
+  return `${OUTBOX_KEY_PREFIX}${eventId}`;
+}
+class UsageEventSubscriber {
+  database;
+  targetUrl;
+  authToken;
+  runtimeId;
+  runId;
+  deliveryOptions;
+  abortController;
+  inFlightDeliveryAbortController;
+  flushInterval;
+  flushPromise = null;
+  flushRequestedWhileRunning = false;
+  isCleaningUp = false;
+  constructor(config) {
+    this.database = config.database;
+    this.targetUrl = config.targetUrl;
+    this.authToken = config.authToken;
+    this.runtimeId = config.runtimeId;
+    this.runId = config.runId;
+    const flushIntervalMs = requirePositiveIntegerOption(
+      "flushIntervalMs",
+      config.flushIntervalMs ?? DEFAULT_DELIVERY_OPTIONS.flushIntervalMs
+    );
+    const batchSize = requirePositiveIntegerOption(
+      "batchSize",
+      config.batchSize ?? DEFAULT_DELIVERY_OPTIONS.batchSize
+    );
+    const requestTimeoutMs = requirePositiveIntegerOption(
+      "requestTimeoutMs",
+      config.requestTimeoutMs ?? DEFAULT_DELIVERY_OPTIONS.requestTimeoutMs
+    );
+    this.deliveryOptions = {
+      fetchFn: config.fetchFn ?? DEFAULT_DELIVERY_OPTIONS.fetchFn,
+      flushIntervalMs,
+      batchSize,
+      requestTimeoutMs
+    };
+  }
+  subscribe(eventBus) {
+    this.isCleaningUp = false;
+    this.abortController?.abort();
+    if (this.flushInterval) {
+      clearInterval(this.flushInterval);
+    }
+    this.abortController = new AbortController();
+    const { signal } = this.abortController;
+    (0, import_events.setMaxListeners)(10, signal);
+    eventBus.on(
+      "llm:response",
+      (payload) => {
+        void this.enqueueUsageEvent(payload);
+      },
+      { signal }
+    );
+    this.flushInterval = setInterval(() => {
+      void this.flushPending();
+    }, this.deliveryOptions.flushIntervalMs);
+    void this.flushPending();
+  }
+  cleanup() {
+    this.isCleaningUp = true;
+    if (this.abortController) {
+      this.abortController.abort();
+      delete this.abortController;
+    }
+    if (this.flushInterval) {
+      clearInterval(this.flushInterval);
+      delete this.flushInterval;
+    }
+    if (this.inFlightDeliveryAbortController) {
+      this.inFlightDeliveryAbortController.abort();
+      delete this.inFlightDeliveryAbortController;
+    }
+  }
+  async flush() {
+    await this.flushPending();
+  }
+  buildUsageEvent(payload) {
+    if (!payload.messageId || !payload.usageScopeId || !payload.tokenUsage) {
+      return null;
+    }
+    if (!(0, import_core.hasMeaningfulTokenUsage)(payload.tokenUsage)) {
+      return null;
+    }
+    const resolvedCostBreakdown = payload.provider && payload.model ? (() => {
+      const pricing = (0, import_core.getModelPricing)(payload.provider, payload.model);
+      if (!pricing) {
+        return void 0;
+      }
+      return (0, import_core.calculateCostBreakdown)(payload.tokenUsage, pricing);
+    })() : void 0;
+    const resolvedEstimatedCost = payload.estimatedCost ?? resolvedCostBreakdown?.totalUsd;
+    return {
+      eventId: createUsageEventId(payload.usageScopeId, payload.messageId),
+      occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
+      sessionId: payload.sessionId,
+      messageId: payload.messageId,
+      usageScopeId: payload.usageScopeId,
+      ...payload.provider && { provider: payload.provider },
+      ...payload.model && { model: payload.model },
+      tokenUsage: payload.tokenUsage,
+      ...resolvedEstimatedCost !== void 0 && { estimatedCostUsd: resolvedEstimatedCost },
+      ...resolvedCostBreakdown && { costBreakdownUsd: resolvedCostBreakdown },
+      ...this.runtimeId && { runtimeId: this.runtimeId },
+      ...this.runId && { runId: this.runId }
+    };
+  }
+  async enqueueUsageEvent(payload) {
+    const usageEvent = this.buildUsageEvent(payload);
+    if (!usageEvent) {
+      return;
+    }
+    await this.database.set(createOutboxKey(usageEvent.eventId), {
+      event: usageEvent
+    });
+    void this.flushPending();
+  }
+  async listPendingRecords() {
+    const keys = await this.database.list(OUTBOX_KEY_PREFIX);
+    if (keys.length === 0) {
+      return [];
+    }
+    const records = await Promise.all(
+      keys.map(async (key) => {
+        const record = await this.database.get(key);
+        return record ? { key, record } : null;
+      })
+    );
+    return records.filter(
+      (value) => value !== null
+    ).sort(
+      (left, right) => left.record.event.occurredAt.localeCompare(right.record.event.occurredAt)
+    );
+  }
+  async flushPending() {
+    if (this.isCleaningUp) {
+      return this.flushPromise ?? Promise.resolve();
+    }
+    if (this.flushPromise) {
+      this.flushRequestedWhileRunning = true;
+      return this.flushPromise;
+    }
+    this.flushPromise = this.doFlushPending().finally(() => {
+      this.flushPromise = null;
+      const shouldFlushAgain = this.flushRequestedWhileRunning;
+      this.flushRequestedWhileRunning = false;
+      if (shouldFlushAgain) {
+        void this.flushPending();
+      }
+    });
+    return this.flushPromise;
+  }
+  async doFlushPending() {
+    if (this.isCleaningUp) {
+      return;
+    }
+    const pendingRecords = await this.listPendingRecords();
+    if (pendingRecords.length === 0) {
+      return;
+    }
+    for (let index = 0; index < pendingRecords.length; index += this.deliveryOptions.batchSize) {
+      if (this.isCleaningUp) {
+        return;
+      }
+      const batchRecords = pendingRecords.slice(
+        index,
+        index + this.deliveryOptions.batchSize
+      );
+      const payload = {
+        events: batchRecords.map((record) => record.record.event)
+      };
+      const abortController = new AbortController();
+      this.inFlightDeliveryAbortController = abortController;
+      const timeout = setTimeout(() => {
+        abortController.abort();
+      }, this.deliveryOptions.requestTimeoutMs);
+      try {
+        const response = await this.deliveryOptions.fetchFn(this.targetUrl, {
+          method: "POST",
+          headers: {
+            Authorization: `Bearer ${this.authToken}`,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(payload),
+          signal: abortController.signal
+        });
+        if (!response.ok) {
+          import_core.logger.warn(
+            `Usage event delivery failed (${response.status}) for ${batchRecords.length} events`
+          );
+          return;
+        }
+        if (this.isCleaningUp) {
+          return;
+        }
+        await Promise.all(batchRecords.map((record) => this.database.delete(record.key)));
+      } catch (error) {
+        if (this.isCleaningUp && abortController.signal.aborted) {
+          return;
+        }
+        import_core.logger.warn(
+          `Usage event delivery failed: ${error instanceof Error ? error.message : String(error)}`
+        );
+        return;
+      } finally {
+        clearTimeout(timeout);
+        if (this.inFlightDeliveryAbortController === abortController) {
+          delete this.inFlightDeliveryAbortController;
+        }
+      }
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UsageEventSubscriber
+});

package/dist/events/usage-event-subscriber.d.ts

@@ -0,0 +1,35 @@
+import { AgentEventBus, type Database } from '@dexto/core';
+import type { EventSubscriber } from './types.js';
+import type { UsageEventDeliveryOptions } from './usage-event-types.js';
+interface UsageEventSubscriberConfig extends UsageEventDeliveryOptions {
+    database: Database;
+    targetUrl: string;
+    authToken: string;
+    runtimeId?: string;
+    runId?: string;
+}
+export declare class UsageEventSubscriber implements EventSubscriber {
+    private readonly database;
+    private readonly targetUrl;
+    private readonly authToken;
+    private readonly runtimeId;
+    private readonly runId;
+    private readonly deliveryOptions;
+    private abortController?;
+    private inFlightDeliveryAbortController?;
+    private flushInterval?;
+    private flushPromise;
+    private flushRequestedWhileRunning;
+    private isCleaningUp;
+    constructor(config: UsageEventSubscriberConfig);
+    subscribe(eventBus: AgentEventBus): void;
+    cleanup(): void;
+    flush(): Promise<void>;
+    private buildUsageEvent;
+    private enqueueUsageEvent;
+    private listPendingRecords;
+    private flushPending;
+    private doFlushPending;
+}
+export {};
+//# sourceMappingURL=usage-event-subscriber.d.ts.map

package/dist/events/usage-event-subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-event-subscriber.d.ts","sourceRoot":"","sources":["../../src/events/usage-event-subscriber.ts"],"names":[],"mappings":"AACA,OAAO,EACH,aAAa,EAMb,KAAK,QAAQ,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAGR,yBAAyB,EAC5B,MAAM,wBAAwB,CAAC;AAqBhC,UAAU,0BAA2B,SAAQ,yBAAyB;IAClE,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAcD,qBAAa,oBAAqB,YAAW,eAAe;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsC;IACtE,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,+BAA+B,CAAC,CAAkB;IAC1D,OAAO,CAAC,aAAa,CAAC,CAAiC;IACvD,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,0BAA0B,CAAS;IAC3C,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,0BAA0B;IA0B9C,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IA2BxC,OAAO,IAAI,IAAI;IAmBF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,OAAO,CAAC,eAAe;YAsCT,iBAAiB;YAajB,kBAAkB;YA2BlB,YAAY;YAsBZ,cAAc;CA2E/B"}

package/dist/events/usage-event-subscriber.js

@@ -0,0 +1,244 @@
+import { setMaxListeners } from "events";
+import {
+  calculateCostBreakdown,
+  getModelPricing,
+  hasMeaningfulTokenUsage,
+  logger
+} from "@dexto/core";
+const OUTBOX_KEY_PREFIX = "usage-outbox:";
+const DEFAULT_DELIVERY_OPTIONS = {
+  fetchFn: fetch,
+  flushIntervalMs: 5e3,
+  batchSize: 50,
+  requestTimeoutMs: 1e4
+};
+function requirePositiveIntegerOption(name, value) {
+  if (!Number.isInteger(value) || value <= 0) {
+    throw new RangeError(
+      `UsageEventSubscriber ${name} must be a positive integer. Received: ${value}`
+    );
+  }
+  return value;
+}
+function createUsageEventId(usageScopeId, messageId) {
+  return `usage:${usageScopeId}:${messageId}`;
+}
+function createOutboxKey(eventId) {
+  return `${OUTBOX_KEY_PREFIX}${eventId}`;
+}
+class UsageEventSubscriber {
+  database;
+  targetUrl;
+  authToken;
+  runtimeId;
+  runId;
+  deliveryOptions;
+  abortController;
+  inFlightDeliveryAbortController;
+  flushInterval;
+  flushPromise = null;
+  flushRequestedWhileRunning = false;
+  isCleaningUp = false;
+  constructor(config) {
+    this.database = config.database;
+    this.targetUrl = config.targetUrl;
+    this.authToken = config.authToken;
+    this.runtimeId = config.runtimeId;
+    this.runId = config.runId;
+    const flushIntervalMs = requirePositiveIntegerOption(
+      "flushIntervalMs",
+      config.flushIntervalMs ?? DEFAULT_DELIVERY_OPTIONS.flushIntervalMs
+    );
+    const batchSize = requirePositiveIntegerOption(
+      "batchSize",
+      config.batchSize ?? DEFAULT_DELIVERY_OPTIONS.batchSize
+    );
+    const requestTimeoutMs = requirePositiveIntegerOption(
+      "requestTimeoutMs",
+      config.requestTimeoutMs ?? DEFAULT_DELIVERY_OPTIONS.requestTimeoutMs
+    );
+    this.deliveryOptions = {
+      fetchFn: config.fetchFn ?? DEFAULT_DELIVERY_OPTIONS.fetchFn,
+      flushIntervalMs,
+      batchSize,
+      requestTimeoutMs
+    };
+  }
+  subscribe(eventBus) {
+    this.isCleaningUp = false;
+    this.abortController?.abort();
+    if (this.flushInterval) {
+      clearInterval(this.flushInterval);
+    }
+    this.abortController = new AbortController();
+    const { signal } = this.abortController;
+    setMaxListeners(10, signal);
+    eventBus.on(
+      "llm:response",
+      (payload) => {
+        void this.enqueueUsageEvent(payload);
+      },
+      { signal }
+    );
+    this.flushInterval = setInterval(() => {
+      void this.flushPending();
+    }, this.deliveryOptions.flushIntervalMs);
+    void this.flushPending();
+  }
+  cleanup() {
+    this.isCleaningUp = true;
+    if (this.abortController) {
+      this.abortController.abort();
+      delete this.abortController;
+    }
+    if (this.flushInterval) {
+      clearInterval(this.flushInterval);
+      delete this.flushInterval;
+    }
+    if (this.inFlightDeliveryAbortController) {
+      this.inFlightDeliveryAbortController.abort();
+      delete this.inFlightDeliveryAbortController;
+    }
+  }
+  async flush() {
+    await this.flushPending();
+  }
+  buildUsageEvent(payload) {
+    if (!payload.messageId || !payload.usageScopeId || !payload.tokenUsage) {
+      return null;
+    }
+    if (!hasMeaningfulTokenUsage(payload.tokenUsage)) {
+      return null;
+    }
+    const resolvedCostBreakdown = payload.provider && payload.model ? (() => {
+      const pricing = getModelPricing(payload.provider, payload.model);
+      if (!pricing) {
+        return void 0;
+      }
+      return calculateCostBreakdown(payload.tokenUsage, pricing);
+    })() : void 0;
+    const resolvedEstimatedCost = payload.estimatedCost ?? resolvedCostBreakdown?.totalUsd;
+    return {
+      eventId: createUsageEventId(payload.usageScopeId, payload.messageId),
+      occurredAt: (/* @__PURE__ */ new Date()).toISOString(),
+      sessionId: payload.sessionId,
+      messageId: payload.messageId,
+      usageScopeId: payload.usageScopeId,
+      ...payload.provider && { provider: payload.provider },
+      ...payload.model && { model: payload.model },
+      tokenUsage: payload.tokenUsage,
+      ...resolvedEstimatedCost !== void 0 && { estimatedCostUsd: resolvedEstimatedCost },
+      ...resolvedCostBreakdown && { costBreakdownUsd: resolvedCostBreakdown },
+      ...this.runtimeId && { runtimeId: this.runtimeId },
+      ...this.runId && { runId: this.runId }
+    };
+  }
+  async enqueueUsageEvent(payload) {
+    const usageEvent = this.buildUsageEvent(payload);
+    if (!usageEvent) {
+      return;
+    }
+    await this.database.set(createOutboxKey(usageEvent.eventId), {
+      event: usageEvent
+    });
+    void this.flushPending();
+  }
+  async listPendingRecords() {
+    const keys = await this.database.list(OUTBOX_KEY_PREFIX);
+    if (keys.length === 0) {
+      return [];
+    }
+    const records = await Promise.all(
+      keys.map(async (key) => {
+        const record = await this.database.get(key);
+        return record ? { key, record } : null;
+      })
+    );
+    return records.filter(
+      (value) => value !== null
+    ).sort(
+      (left, right) => left.record.event.occurredAt.localeCompare(right.record.event.occurredAt)
+    );
+  }
+  async flushPending() {
+    if (this.isCleaningUp) {
+      return this.flushPromise ?? Promise.resolve();
+    }
+    if (this.flushPromise) {
+      this.flushRequestedWhileRunning = true;
+      return this.flushPromise;
+    }
+    this.flushPromise = this.doFlushPending().finally(() => {
+      this.flushPromise = null;
+      const shouldFlushAgain = this.flushRequestedWhileRunning;
+      this.flushRequestedWhileRunning = false;
+      if (shouldFlushAgain) {
+        void this.flushPending();
+      }
+    });
+    return this.flushPromise;
+  }
+  async doFlushPending() {
+    if (this.isCleaningUp) {
+      return;
+    }
+    const pendingRecords = await this.listPendingRecords();
+    if (pendingRecords.length === 0) {
+      return;
+    }
+    for (let index = 0; index < pendingRecords.length; index += this.deliveryOptions.batchSize) {
+      if (this.isCleaningUp) {
+        return;
+      }
+      const batchRecords = pendingRecords.slice(
+        index,
+        index + this.deliveryOptions.batchSize
+      );
+      const payload = {
+        events: batchRecords.map((record) => record.record.event)
+      };
+      const abortController = new AbortController();
+      this.inFlightDeliveryAbortController = abortController;
+      const timeout = setTimeout(() => {
+        abortController.abort();
+      }, this.deliveryOptions.requestTimeoutMs);
+      try {
+        const response = await this.deliveryOptions.fetchFn(this.targetUrl, {
+          method: "POST",
+          headers: {
+            Authorization: `Bearer ${this.authToken}`,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(payload),
+          signal: abortController.signal
+        });
+        if (!response.ok) {
+          logger.warn(
+            `Usage event delivery failed (${response.status}) for ${batchRecords.length} events`
+          );
+          return;
+        }
+        if (this.isCleaningUp) {
+          return;
+        }
+        await Promise.all(batchRecords.map((record) => this.database.delete(record.key)));
+      } catch (error) {
+        if (this.isCleaningUp && abortController.signal.aborted) {
+          return;
+        }
+        logger.warn(
+          `Usage event delivery failed: ${error instanceof Error ? error.message : String(error)}`
+        );
+        return;
+      } finally {
+        clearTimeout(timeout);
+        if (this.inFlightDeliveryAbortController === abortController) {
+          delete this.inFlightDeliveryAbortController;
+        }
+      }
+    }
+  }
+}
+export {
+  UsageEventSubscriber
+};

package/dist/events/usage-event-types.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var usage_event_types_exports = {};
+module.exports = __toCommonJS(usage_event_types_exports);

package/dist/events/usage-event-types.d.ts

@@ -0,0 +1,33 @@
+import type { LLMProvider, TokenUsage } from '@dexto/core';
+export interface UsageEventCostBreakdown {
+    inputUsd: number;
+    outputUsd: number;
+    reasoningUsd: number;
+    cacheReadUsd: number;
+    cacheWriteUsd: number;
+    totalUsd: number;
+}
+export interface UsageEvent {
+    eventId: string;
+    occurredAt: string;
+    sessionId: string;
+    messageId: string;
+    usageScopeId: string;
+    provider?: LLMProvider;
+    model?: string;
+    tokenUsage: TokenUsage;
+    estimatedCostUsd?: number;
+    costBreakdownUsd?: UsageEventCostBreakdown;
+    runtimeId?: string;
+    runId?: string;
+}
+export interface UsageEventBatch {
+    events: UsageEvent[];
+}
+export interface UsageEventDeliveryOptions {
+    fetchFn?: typeof globalThis.fetch;
+    flushIntervalMs?: number;
+    batchSize?: number;
+    requestTimeoutMs?: number;
+}
+//# sourceMappingURL=usage-event-types.d.ts.map

package/dist/events/usage-event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-event-types.d.ts","sourceRoot":"","sources":["../../src/events/usage-event-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,WAAW,uBAAuB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,UAAU,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACtC,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B"}