theokit 0.55.0 → 0.56.0

package/dist/cost-types-BALTuBpG.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Cost tracking types (R0.5.11).
+ *
+ * Phase 5 — Production-Readiness #4: adds `ToolUsageRecord` for per-tool
+ * latency / error tracking via SDK's onToolStart/onToolEnd/onToolError hooks.
+ * Same UsageStorageAdapter handles both via discriminated union.
+ *
+ * EC-9 (SHOULD TEST): backward compat — record() input without `kind` is
+ * normalized to 'llm' by the framework so external adapters from older
+ * versions keep working.
+ */
+/**
+ * Per-LLM-call cost record (existing — gains optional `kind` discriminator).
+ */
+interface UsageRecord {
+    /** Discriminator. Optional for backward-compat; defaults to 'llm'. */
+    kind?: 'llm';
+    /** User identifier (e.g., session userId, tenantId, apiKey hash). */
+    userId: string;
+    /** Model id (e.g., 'claude-sonnet-4-5-20250929'). */
+    model: string;
+    /** Token counts per direction. */
+    tokens: {
+        input: number;
+        output: number;
+    };
+    /** USD cost in fractional dollars. */
+    costUsd: number;
+    /** When the run happened. */
+    timestamp: Date;
+}
+/**
+ * Per-tool-invocation record (Phase 5 — Production-Readiness #4).
+ *
+ * Emitted by `trackAgentTools` on every `onToolEnd` / `onToolError`. The same
+ * `UsageStorageAdapter.record` accepts both record kinds via union.
+ */
+interface ToolUsageRecord {
+    kind: 'tool';
+    userId: string;
+    conversationId: string;
+    toolName: string;
+    /**
+     * Unique per invocation; correlates onToolStart with onToolEnd / onToolError.
+     * EC-16 (DOCUMENT): callId uniqueness is SDK contract — if SDK ever reuses
+     * a callId, `trackAgentTools`'s Map uses last-write-wins (defensive).
+     */
+    callId: string;
+    /** True when the tool handler returned; false when it threw. */
+    success: boolean;
+    /** Milliseconds from onToolStart to onToolEnd / onToolError. */
+    durationMs: number;
+    /** Populated only when success === false. */
+    errorMessage?: string;
+    timestamp: Date;
+}
+interface UsageQuery {
+    userId: string;
+    period: {
+        from: Date;
+        to: Date;
+    };
+}
+interface UsageResult {
+    totalTokens: number;
+    totalCostUsd: number;
+    runs: number;
+}
+interface UsageStorageAdapter {
+    readonly name: string;
+    /**
+     * Record a usage event. Accepts both kinds; framework normalizes input
+     * without `kind` to 'llm' before calling adapter (EC-9 backward compat).
+     */
+    record(input: UsageRecord | ToolUsageRecord): Promise<void>;
+    getUsage(query: UsageQuery): Promise<UsageResult>;
+}
+
+export type { ToolUsageRecord as T, UsageStorageAdapter as U, UsageRecord as a, UsageQuery as b, UsageResult as c };

package/dist/{dev-MWGPBGQP.js → dev-ZNTHPBBN.js}

@@ -11,14 +11,14 @@ import {
 } from "./chunk-KTMQUYED.js";
 import {
   theoPluginAsync
-} from "./chunk-VRELW5NF.js";
-import "./chunk-QZUIF64G.js";
+} from "./chunk-5TPBOAAH.js";
+import "./chunk-6PFF5HMY.js";
 import "./chunk-2CVV6CNN.js";
 import "./chunk-3PWQQWT6.js";
 import "./chunk-FDOOBTXJ.js";
 import "./chunk-47MM2JUK.js";
-import "./chunk-DADMEW4G.js";
-import "./chunk-5YPXXSYY.js";
+import "./chunk-22ZZSUKD.js";
+import "./chunk-35QIWOHT.js";
 import "./chunk-MWWFXYW3.js";
 import "./chunk-RPET332G.js";
 import "./chunk-5VLP3GQ2.js";
@@ -123,4 +123,4 @@ export {
   devCommand,
   startDevServer
 };
-//# sourceMappingURL=dev-MWGPBGQP.js.map
+//# sourceMappingURL=dev-ZNTHPBBN.js.map

package/dist/{dev-emit-W27J3DLU.js → dev-emit-FIQASO3D.js}

@@ -1,15 +1,15 @@
 import {
   generateManifest
-} from "./chunk-I2UN46ZX.js";
+} from "./chunk-XJOU425Y.js";
+import "./chunk-KDP2HURW.js";
 import "./chunk-DV34VG3N.js";
-import "./chunk-IRASEXOG.js";
-import "./chunk-5K4TDLRG.js";
+import "./chunk-SOYOYGWY.js";
 import "./chunk-ZWN3AODA.js";
 import "./chunk-XTHN6JBX.js";
 
 // src/vite-plugin/openapi-emit/emit.ts
-import { mkdirSync, writeFileSync } from "fs";
-import { join } from "path";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
 
 // src/vite-plugin/openapi-emit/zod-to-openapi.ts
 import { z } from "zod";
@@ -235,7 +235,7 @@ function applyServerOverride(servers) {
 }
 
 // src/vite-plugin/openapi-emit/load-routes.ts
-import { resolve } from "path";
+import { resolve } from "node:path";
 var HTTP_METHOD_KEYS = ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"];
 async function loadRoutesForOpenApi(options) {
   const { serverDir, routes } = options;
@@ -339,4 +339,4 @@ export {
   _resetInFlightForTests,
   reEmitOpenApi
 };
-//# sourceMappingURL=dev-emit-W27J3DLU.js.map
+//# sourceMappingURL=dev-emit-FIQASO3D.js.map

package/dist/index.js

@@ -8,44 +8,44 @@ import {
   scanRoutes,
   theoConfigSchema,
   theoPlugin
-} from "./chunk-F6P6S5YS.js";
-import "./chunk-VQPHPQ5L.js";
+} from "./chunk-ZTIB4QSV.js";
+import "./chunk-7NRFZBAL.js";
 import "./chunk-SSYDEKWF.js";
-import "./chunk-3DRALT3J.js";
+import "./chunk-XYVZJCZU.js";
+import "./chunk-M357ILK5.js";
 import "./chunk-OIGJOYX6.js";
-import "./chunk-WX6NHGKS.js";
-import "./chunk-4X6H2BXP.js";
+import "./chunk-U3SPBLJF.js";
+import "./chunk-BPYMC7SU.js";
+import "./chunk-IRQGAC4L.js";
 import "./chunk-OGLS76RN.js";
-import "./chunk-ITSNTHWN.js";
+import "./chunk-JW5UFKQ3.js";
+import "./chunk-P6OS7652.js";
 import "./chunk-ZDUO4IYN.js";
+import "./chunk-D4VP2QPR.js";
+import "./chunk-YN4W7LCX.js";
 import "./chunk-47FFT43U.js";
 import "./chunk-NTDN54XO.js";
-import "./chunk-2OEN3YTE.js";
-import "./chunk-BND4YZTQ.js";
+import "./chunk-PVNMLZ5G.js";
+import "./chunk-ZDCCILMP.js";
 import "./chunk-CHTAWXC2.js";
+import "./chunk-AVQU5CQF.js";
 import "./chunk-VSLTKX5L.js";
 import "./chunk-TNI4MARH.js";
-import "./chunk-OQCRCXCP.js";
-import "./chunk-I2UN46ZX.js";
+import "./chunk-4ERYQBL6.js";
+import "./chunk-XJOU425Y.js";
+import "./chunk-KDP2HURW.js";
 import "./chunk-DV34VG3N.js";
-import "./chunk-IRASEXOG.js";
-import "./chunk-BX6EUYHU.js";
-import "./chunk-BPYMC7SU.js";
-import "./chunk-IRQGAC4L.js";
-import "./chunk-P6OS7652.js";
-import "./chunk-AVQU5CQF.js";
+import "./chunk-V6Y2SMRG.js";
 import "./chunk-ACKBVBUI.js";
 import "./chunk-IZ3TIL6K.js";
 import "./chunk-YOIVCCZT.js";
-import "./chunk-3PBAN2YE.js";
+import "./chunk-CF2DNN5R.js";
 import "./chunk-YSJOZEI6.js";
 import "./chunk-Z4PJMZLM.js";
 import "./chunk-UMNXCU3K.js";
-import "./chunk-52PDWL5S.js";
-import "./chunk-5K4TDLRG.js";
+import "./chunk-5KRMDP46.js";
+import "./chunk-SOYOYGWY.js";
 import "./chunk-ZWN3AODA.js";
-import "./chunk-D4VP2QPR.js";
-import "./chunk-YN4W7LCX.js";
 import "./chunk-XTHN6JBX.js";
 
 // src/config/define-config.ts
@@ -74,8 +74,8 @@ function config() {
 }
 
 // src/config/validate-structure.ts
-import { existsSync } from "fs";
-import { join } from "path";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
 
 // src/core/errors.ts
 var TheoProjectError = class extends Error {

package/dist/{internal-api-XSUP3NDI.js → internal-api-D76JZGSC.js}

@@ -16,10 +16,10 @@ import {
   handleCspReport,
   handleCsrfReadiness,
   mountAgent
-} from "./chunk-DADMEW4G.js";
+} from "./chunk-22ZZSUKD.js";
 import {
   resolveProvider
-} from "./chunk-5YPXXSYY.js";
+} from "./chunk-35QIWOHT.js";
 import {
   dispatchControllerRequest,
   incomingMessageToHandlerRequest,
@@ -87,4 +87,4 @@ export {
   scanWebSocketRoutes,
   sendError
 };
-//# sourceMappingURL=internal-api-XSUP3NDI.js.map
+//# sourceMappingURL=internal-api-D76JZGSC.js.map

package/dist/{internal-api-J3BYA3VU.js → internal-api-JNX3MTIM.js}

@@ -1,9 +1,17 @@
 import {
   dispatchControllerRequest
-} from "./chunk-3DRALT3J.js";
+} from "./chunk-XYVZJCZU.js";
 import {
   mountAgent
-} from "./chunk-WX6NHGKS.js";
+} from "./chunk-M357ILK5.js";
+import {
+  CSP_REPORT_PATH,
+  CsrfReadinessStore,
+  applySecurityHeaders,
+  handleCspReport,
+  handleCsrfReadiness
+} from "./chunk-BPYMC7SU.js";
+import "./chunk-IRQGAC4L.js";
 import {
   BATCH_PATH,
   createCorsHandler,
@@ -12,19 +20,23 @@ import {
   handleBatchRequest,
   incomingMessageToHandlerRequest,
   sendError
-} from "./chunk-ITSNTHWN.js";
+} from "./chunk-JW5UFKQ3.js";
+import "./chunk-P6OS7652.js";
 import "./chunk-ZDUO4IYN.js";
+import "./chunk-D4VP2QPR.js";
+import "./chunk-YN4W7LCX.js";
 import "./chunk-47FFT43U.js";
 import {
   findSuggestion
 } from "./chunk-NTDN54XO.js";
-import "./chunk-2OEN3YTE.js";
+import "./chunk-PVNMLZ5G.js";
 import {
   TRACE_HEADER,
   extractTraceId,
   logRequest
-} from "./chunk-BND4YZTQ.js";
+} from "./chunk-ZDCCILMP.js";
 import "./chunk-CHTAWXC2.js";
+import "./chunk-AVQU5CQF.js";
 import {
   createPluginRunnerFromConfig
 } from "./chunk-VSLTKX5L.js";
@@ -33,7 +45,7 @@ import {
 } from "./chunk-TNI4MARH.js";
 import {
   createViteLoader
-} from "./chunk-OQCRCXCP.js";
+} from "./chunk-4ERYQBL6.js";
 import {
   ACTION_SCHEMAS_DIR,
   generateManifest,
@@ -42,37 +54,25 @@ import {
   scanServerActionsEnriched,
   scanServerRoutes,
   scanWebSocketRoutes
-} from "./chunk-I2UN46ZX.js";
-import "./chunk-DV34VG3N.js";
+} from "./chunk-XJOU425Y.js";
 import {
   scanAgents
-} from "./chunk-IRASEXOG.js";
-import "./chunk-BX6EUYHU.js";
-import {
-  CSP_REPORT_PATH,
-  CsrfReadinessStore,
-  applySecurityHeaders,
-  handleCspReport,
-  handleCsrfReadiness
-} from "./chunk-BPYMC7SU.js";
-import "./chunk-IRQGAC4L.js";
-import "./chunk-P6OS7652.js";
-import "./chunk-AVQU5CQF.js";
+} from "./chunk-KDP2HURW.js";
+import "./chunk-DV34VG3N.js";
+import "./chunk-V6Y2SMRG.js";
 import "./chunk-ACKBVBUI.js";
 import "./chunk-IZ3TIL6K.js";
 import {
   resolveProvider
-} from "./chunk-3PBAN2YE.js";
+} from "./chunk-CF2DNN5R.js";
 import "./chunk-YSJOZEI6.js";
 import {
   generateNonce
 } from "./chunk-Z4PJMZLM.js";
 import "./chunk-UMNXCU3K.js";
-import "./chunk-52PDWL5S.js";
-import "./chunk-5K4TDLRG.js";
+import "./chunk-5KRMDP46.js";
+import "./chunk-SOYOYGWY.js";
 import "./chunk-ZWN3AODA.js";
-import "./chunk-D4VP2QPR.js";
-import "./chunk-YN4W7LCX.js";
 import "./chunk-XTHN6JBX.js";
 export {
   ACTION_SCHEMAS_DIR,
@@ -107,4 +107,4 @@ export {
   scanWebSocketRoutes,
   sendError
 };
-//# sourceMappingURL=internal-api-J3BYA3VU.js.map
+//# sourceMappingURL=internal-api-JNX3MTIM.js.map

package/dist/{mcp-6IPY275L.js → mcp-IMY3NUCL.js}

@@ -2,12 +2,12 @@
 import "tsx/esm";
 import {
   createAgentSsrLoader
-} from "./chunk-2PSKQWGM.js";
+} from "./chunk-TUO2FE3S.js";
 import {
   extractAppResources,
   handleMcpJsonRpc
 } from "./chunk-2CVV6CNN.js";
-import "./chunk-5YPXXSYY.js";
+import "./chunk-35QIWOHT.js";
 import {
   scanAgents
 } from "./chunk-5NNFO7R7.js";
@@ -75,4 +75,4 @@ async function mcpCommand(name, deps = {}) {
 export {
   mcpCommand
 };
-//# sourceMappingURL=mcp-6IPY275L.js.map
+//# sourceMappingURL=mcp-IMY3NUCL.js.map

package/dist/{preview-KPAKWBRW.js → preview-K4NIQLAK.js}

@@ -4,8 +4,8 @@ import "tsx/esm";
 // src/cli/commands/preview.ts
 async function defaultSteps() {
   const [{ buildCommand }, { startCommand }] = await Promise.all([
-    import("./build-ESSQS5F5.js"),
-    import("./start-F3T2ZPPI.js")
+    import("./build-4GQLIFTD.js"),
+    import("./start-ONZXIWEG.js")
   ]);
   return {
     build: (opts) => buildCommand(opts),
@@ -20,4 +20,4 @@ async function previewCommand(options = {}, steps) {
 export {
   previewCommand
 };
-//# sourceMappingURL=preview-KPAKWBRW.js.map
+//# sourceMappingURL=preview-K4NIQLAK.js.map

package/dist/{provider-resolver-Dx6QuWrw.d.ts → provider-resolver-VS61zqsw.d.ts}

@@ -105,17 +105,6 @@ declare function resetProviderRegistry(): void;
  * @public
  */
 declare function listProviders(): readonly ProviderDescriptor[];
-/**
- * Resolve the provider for a model.
- *
- * When `modelId` declares a registered provider (`anthropic/…`), THAT provider's key is
- * required — no substitution. Otherwise the registry is walked by priority, first match wins.
- *
- * @returns ResolvedProvider with apiKey + baseUrl + name
- * @throws Error if NO provider env var is set (actionable message)
- *
- * @public
- */
 declare function resolveProvider(modelId?: string, options?: ResolveOptions): ResolvedProvider;
 /**
  * Try to resolve — does NOT throw. Returns null if no provider available.

package/dist/{registry-KBZDCFVQ.js → registry-3LUHO4IB.js}

@@ -7,7 +7,7 @@ var adapterRegistry = {
   vercel: async () => (await import("./vercel-BMCQKCWE.js")).vercelAdapter,
   cloudflare: async () => (await import("./cloudflare-SIG42OIW.js")).cloudflareAdapter,
   static: async () => (await import("./static-SVDWIOXJ.js")).staticAdapter,
-  bun: async () => (await import("./bun-L7PP6ID5.js")).bunAdapter,
+  bun: async () => (await import("./bun-POLTY2HK.js")).bunAdapter,
   "deno-deploy": async () => (await import("./deno-deploy-LQAYOOPW.js")).denoDeployAdapter,
   netlify: async () => (await import("./netlify-C2IRCZKI.js")).netlifyAdapter,
   "aws-lambda": async () => (await import("./aws-lambda-VKMYUMP2.js")).awsLambdaAdapter,
@@ -20,4 +20,4 @@ async function resolveAdapter(target) {
 export {
   resolveAdapter
 };
-//# sourceMappingURL=registry-KBZDCFVQ.js.map
+//# sourceMappingURL=registry-3LUHO4IB.js.map

package/dist/server/agent/index.d.ts

@@ -4,7 +4,7 @@ import { AcpTransport } from '@theokit/agents';
 export { InProcessApprovalRequest, InProcessApprovalRequiredError, InProcessAwaitApproval, StreamAgentTurnDeps, StreamAgentTurnInProcessInput, streamAgentTurnInProcess } from '@theokit/agents';
 import { CustomTool as CustomTool$1 } from '@theokit/sdk';
 import { V as VerifyFn } from '../../webhook-types-DGIjjcaI.js';
-export { P as ProviderDescriptor, R as ResolvedProvider, l as listProviders, a as registerProvider, b as resetProviderRegistry, r as resolveProvider, t as tryResolveProvider } from '../../provider-resolver-Dx6QuWrw.js';
+export { P as ProviderDescriptor, R as ResolvedProvider, l as listProviders, a as registerProvider, b as resetProviderRegistry, r as resolveProvider, t as tryResolveProvider } from '../../provider-resolver-VS61zqsw.js';
 
 /**
  * M26 (ADR-0041) — `createWorkflowTool`: wrap an SDK `Workflow` as a `CustomTool`.

package/dist/server/agent/index.js

@@ -12,7 +12,8 @@ import {
   parseChannelPath,
   serveMcpStdio,
   streamAgentTurnInProcess
-} from "../../chunk-ZQO37YQJ.js";
+} from "../../chunk-PELXWPDF.js";
+import "../../chunk-BZF76LFM.js";
 import {
   buildResourceDescriptors,
   defineAppResource,
@@ -25,8 +26,7 @@ import {
   resetProviderRegistry,
   resolveProvider,
   tryResolveProvider
-} from "../../chunk-3PBAN2YE.js";
-import "../../chunk-BZF76LFM.js";
+} from "../../chunk-CF2DNN5R.js";
 import "../../chunk-XTHN6JBX.js";
 export {
   CodeModePermissionDeniedError,

package/dist/server/cost/index.d.ts

@@ -1,84 +1,7 @@
-import { d as StorageAdapter } from '../../storage-types-DsDTCPbp.js';
+import { U as UsageStorageAdapter, a as UsageRecord, T as ToolUsageRecord, b as UsageQuery, c as UsageResult } from '../../cost-types-BALTuBpG.js';
+import { S as StorageAdapter } from '../../storage-types-CFGPFIdB.js';
 export { InMemoryUsageStorage as NeutralUsageStorage } from '@theokit/agents/usage';
 
-/**
- * Cost tracking types (R0.5.11).
- *
- * Phase 5 — Production-Readiness #4: adds `ToolUsageRecord` for per-tool
- * latency / error tracking via SDK's onToolStart/onToolEnd/onToolError hooks.
- * Same UsageStorageAdapter handles both via discriminated union.
- *
- * EC-9 (SHOULD TEST): backward compat — record() input without `kind` is
- * normalized to 'llm' by the framework so external adapters from older
- * versions keep working.
- */
-/**
- * Per-LLM-call cost record (existing — gains optional `kind` discriminator).
- */
-interface UsageRecord {
-    /** Discriminator. Optional for backward-compat; defaults to 'llm'. */
-    kind?: 'llm';
-    /** User identifier (e.g., session userId, tenantId, apiKey hash). */
-    userId: string;
-    /** Model id (e.g., 'claude-sonnet-4-5-20250929'). */
-    model: string;
-    /** Token counts per direction. */
-    tokens: {
-        input: number;
-        output: number;
-    };
-    /** USD cost in fractional dollars. */
-    costUsd: number;
-    /** When the run happened. */
-    timestamp: Date;
-}
-/**
- * Per-tool-invocation record (Phase 5 — Production-Readiness #4).
- *
- * Emitted by `trackAgentTools` on every `onToolEnd` / `onToolError`. The same
- * `UsageStorageAdapter.record` accepts both record kinds via union.
- */
-interface ToolUsageRecord {
-    kind: 'tool';
-    userId: string;
-    conversationId: string;
-    toolName: string;
-    /**
-     * Unique per invocation; correlates onToolStart with onToolEnd / onToolError.
-     * EC-16 (DOCUMENT): callId uniqueness is SDK contract — if SDK ever reuses
-     * a callId, `trackAgentTools`'s Map uses last-write-wins (defensive).
-     */
-    callId: string;
-    /** True when the tool handler returned; false when it threw. */
-    success: boolean;
-    /** Milliseconds from onToolStart to onToolEnd / onToolError. */
-    durationMs: number;
-    /** Populated only when success === false. */
-    errorMessage?: string;
-    timestamp: Date;
-}
-interface UsageQuery {
-    userId: string;
-    period: {
-        from: Date;
-        to: Date;
-    };
-}
-interface UsageResult {
-    totalTokens: number;
-    totalCostUsd: number;
-    runs: number;
-}
-interface UsageStorageAdapter {
-    readonly name: string;
-    /**
-     * Record a usage event. Accepts both kinds; framework normalizes input
-     * without `kind` to 'llm' before calling adapter (EC-9 backward compat).
-     */
-    record(input: UsageRecord | ToolUsageRecord): Promise<void>;
-    getUsage(query: UsageQuery): Promise<UsageResult>;
-}
-
 interface TrackAgentRunInput {
     userId: string;
     model: string;
@@ -172,4 +95,4 @@ interface TrackAgentToolsHooks {
  */
 declare function trackAgentTools(opts: TrackAgentToolsOptions): TrackAgentToolsHooks;
 
-export { InMemoryUsageStorage, type ToolHookEvent, type ToolUsageRecord, type TrackAgentRunInput, type TrackAgentRunOptions, type TrackAgentToolsHooks, type TrackAgentToolsOptions, type UsageQuery, type UsageRecord, type UsageResult, type UsageStorageAdapter, trackAgentRun, trackAgentTools };
+export { InMemoryUsageStorage, type ToolHookEvent, ToolUsageRecord, type TrackAgentRunInput, type TrackAgentRunOptions, type TrackAgentToolsHooks, type TrackAgentToolsOptions, UsageQuery, UsageRecord, UsageResult, UsageStorageAdapter, trackAgentRun, trackAgentTools };

package/dist/server/cost/sqlite/index.d.ts

@@ -0,0 +1,21 @@
+import { S as StorageAdapter } from '../../../storage-types-CFGPFIdB.js';
+import { U as UsageStorageAdapter, a as UsageRecord, T as ToolUsageRecord, b as UsageQuery, c as UsageResult } from '../../../cost-types-BALTuBpG.js';
+
+declare class SqliteUsageStorage implements UsageStorageAdapter, StorageAdapter {
+    #private;
+    readonly name = "sqlite";
+    /**
+     * @param filename path to the database file. `':memory:'` is accepted and is a legitimate choice
+     *   for a test, but note that it defeats the entire purpose of this class in a deployment.
+     */
+    constructor(filename: string);
+    record(input: UsageRecord | ToolUsageRecord): Promise<void>;
+    getUsage(query: UsageQuery): Promise<UsageResult>;
+    /**
+     * `StorageAdapter` lifecycle (ADR-0007 D6). Unlike the in-memory adapter's noop, this one has a
+     * file handle to release — a graceful shutdown that left it open would leave the WAL unmerged.
+     */
+    dispose(): Promise<void>;
+}
+
+export { SqliteUsageStorage };

package/dist/server/cost/sqlite/index.js

@@ -0,0 +1,102 @@
+import "../../../chunk-XTHN6JBX.js";
+
+// src/server/cost/usage-storage-sqlite.ts
+import { createRequire } from "node:module";
+function loadSqlite() {
+  try {
+    const require_ = createRequire(import.meta.url);
+    const mod = require_("node:sqlite");
+    return mod.DatabaseSync;
+  } catch {
+    throw new Error(
+      `SqliteUsageStorage needs \`node:sqlite\`, which this Node does not provide (running ${process.version}). It is not available at this package's engine floor of 22.12 \u2014 upgrade Node, or use a different UsageStorageAdapter: the interface is two methods and \`InMemoryUsageStorage\` shows the shape.`
+    );
+  }
+}
+var SqliteUsageStorage = class {
+  name = "sqlite";
+  #db;
+  /**
+   * @param filename path to the database file. `':memory:'` is accepted and is a legitimate choice
+   *   for a test, but note that it defeats the entire purpose of this class in a deployment.
+   */
+  constructor(filename) {
+    const DatabaseSync = loadSqlite();
+    this.#db = new DatabaseSync(filename);
+    this.#db.exec("PRAGMA journal_mode = WAL");
+    this.#db.exec(`
+      CREATE TABLE IF NOT EXISTS usage (
+        id          INTEGER PRIMARY KEY AUTOINCREMENT,
+        kind        TEXT    NOT NULL,
+        user_id     TEXT    NOT NULL,
+        at_ms       INTEGER NOT NULL,
+        model       TEXT,
+        input_tok   INTEGER,
+        output_tok  INTEGER,
+        cost_usd    REAL,
+        tool_name   TEXT,
+        call_id     TEXT,
+        success     INTEGER,
+        duration_ms INTEGER,
+        error       TEXT
+      )
+    `);
+    this.#db.exec("CREATE INDEX IF NOT EXISTS usage_lookup ON usage (user_id, kind, at_ms)");
+  }
+  record(input) {
+    if ("kind" in input && input.kind === "tool") {
+      this.#db.prepare(
+        `INSERT INTO usage (kind, user_id, at_ms, tool_name, call_id, success, duration_ms, error)
+           VALUES ('tool', ?, ?, ?, ?, ?, ?, ?)`
+      ).run(
+        input.userId,
+        input.timestamp.getTime(),
+        input.toolName,
+        input.callId,
+        input.success ? 1 : 0,
+        input.durationMs,
+        input.errorMessage ?? null
+      );
+      return Promise.resolve();
+    }
+    const llm = input;
+    this.#db.prepare(
+      `INSERT INTO usage (kind, user_id, at_ms, model, input_tok, output_tok, cost_usd)
+         VALUES ('llm', ?, ?, ?, ?, ?, ?)`
+    ).run(
+      llm.userId,
+      llm.timestamp.getTime(),
+      llm.model,
+      llm.tokens.input,
+      llm.tokens.output,
+      llm.costUsd
+    );
+    return Promise.resolve();
+  }
+  getUsage(query) {
+    const row = this.#db.prepare(
+      `SELECT COALESCE(SUM(input_tok + output_tok), 0) AS tokens,
+                COALESCE(SUM(cost_usd), 0)               AS cost,
+                COUNT(*)                                 AS runs
+           FROM usage
+          WHERE kind = 'llm' AND user_id = ? AND at_ms >= ? AND at_ms <= ?`
+    ).get(query.userId, query.period.from.getTime(), query.period.to.getTime());
+    return Promise.resolve({
+      totalTokens: row?.tokens ?? 0,
+      totalCostUsd: row?.cost ?? 0,
+      runs: row?.runs ?? 0
+    });
+  }
+  /**
+   * `StorageAdapter` lifecycle (ADR-0007 D6). Unlike the in-memory adapter's noop, this one has a
+   * file handle to release — a graceful shutdown that left it open would leave the WAL unmerged.
+   */
+  dispose() {
+    this.#db.close();
+    return Promise.resolve();
+  }
+};
+export {
+  SqliteUsageStorage
+};
+//# sourceMappingURL=index.js.map

package/dist/server/cost/sqlite/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/server/cost/usage-storage-sqlite.ts"],"mappings":";;;AAAA,SAAS,qBAAqB;AAoE9B,SAAS,aAAuD;AAC9D,MAAI;AACF,UAAM,WAAW,cAAc,YAAY,GAAG;AAC9C,UAAM,MAAM,SAAS,aAAa;AAClC,WAAO,IAAI;AAAA,EACb,QAAQ;AACN,UAAM,IAAI;AAAA,MACR,uFACc,QAAQ,OAAO;AAAA,IAG/B;AAAA,EACF;AACF;AAEO,IAAM,qBAAN,MAAwE;AAAA,EACpE,OAAO;AAAA,EACP;AAAA;AAAA;AAAA;AAAA;AAAA,EAMT,YAAY,UAAkB;AAC5B,UAAM,eAAe,WAAW;AAChC,SAAK,MAAM,IAAI,aAAa,QAAQ;AAGpC,SAAK,IAAI,KAAK,2BAA2B;AACzC,SAAK,IAAI,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,KAgBb;AAED,SAAK,IAAI,KAAK,yEAAyE;AAAA,EACzF;AAAA,EAEA,OAAO,OAAqD;AAG1D,QAAI,UAAU,SAAS,MAAM,SAAS,QAAQ;AAC5C,WAAK,IACF;AAAA,QACC;AAAA;AAAA,MAEF,EACC;AAAA,QACC,MAAM;AAAA,QACN,MAAM,UAAU,QAAQ;AAAA,QACxB,MAAM;AAAA,QACN,MAAM;AAAA,QACN,MAAM,UAAU,IAAI;AAAA,QACpB,MAAM;AAAA,QACN,MAAM,gBAAgB;AAAA,MACxB;AACF,aAAO,QAAQ,QAAQ;AAAA,IACzB;AAEA,UAAM,MAAM;AACZ,SAAK,IACF;AAAA,MACC;AAAA;AAAA,IAEF,EACC;AAAA,MACC,IAAI;AAAA,MACJ,IAAI,UAAU,QAAQ;AAAA,MACtB,IAAI;AAAA,MACJ,IAAI,OAAO;AAAA,MACX,IAAI,OAAO;AAAA,MACX,IAAI;AAAA,IACN;AACF,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEA,SAAS,OAAyC;AAChD,UAAM,MAAM,KAAK,IACd;AAAA,MACC;AAAA;AAAA;AAAA;AAAA;AAAA,IAKF,EACC,IAAI,MAAM,QAAQ,MAAM,OAAO,KAAK,QAAQ,GAAG,MAAM,OAAO,GAAG,QAAQ,CAAC;AAQ3E,WAAO,QAAQ,QAAQ;AAAA,MACrB,aAAa,KAAK,UAAU;AAAA,MAC5B,cAAc,KAAK,QAAQ;AAAA,MAC3B,MAAM,KAAK,QAAQ;AAAA,IACrB,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAyB;AACvB,SAAK,IAAI,MAAM;AACf,WAAO,QAAQ,QAAQ;AAAA,EACzB;AACF;","names":[]}