@framers/agentos 0.12.24 → 0.13.2

package/dist/io/speech/providers/MiniMaxTextToSpeechProvider.js

@@ -20,12 +20,63 @@ const MIME_TYPES = {
     flac: "audio/flac",
     pcm: "audio/L16",
 };
+/** How long a URL-output download may take by default: 30 seconds. */
+const DEFAULT_AUDIO_DOWNLOAD_TIMEOUT_MS = 30000;
+/** The largest URL-output download accepted by default: 100 MiB. */
+const DEFAULT_MAX_AUDIO_DOWNLOAD_BYTES = 100 * 1024 * 1024;
 function decodeHexAudio(value) {
     if (value.length % 2 !== 0 || !/^[0-9a-f]*$/i.test(value)) {
         throw new Error("MiniMax speech returned invalid hex audio.");
     }
     return Buffer.from(value, "hex");
 }
+/** An int64 id field of a MiniMax response, written as a JSON integer. */
+const INT64_ID_FIELD = /(?<!\\)("(?:task_id|file_id)"\s*:\s*)(-?\d+)(?=\s*[,}])/g;
+/**
+ * Parse a MiniMax JSON body. JSON.parse rounds an integer past 2^53, so an
+ * id field holding one is read as its decimal string instead.
+ */
+function parseMiniMaxJson(text) {
+    return JSON.parse(text.replace(INT64_ID_FIELD, (match, prefix, digits) => Number.isSafeInteger(Number(digits)) ? match : `${prefix}"${digits}"`));
+}
+/** Whether `host` is listed: an exact name, or `*.domain` for its subdomains. */
+function hostAllowed(host, allowed) {
+    const name = host.toLowerCase();
+    return allowed.some((entry) => {
+        const pattern = entry.trim().toLowerCase();
+        if (pattern.startsWith("*.")) {
+            return pattern.length > 2 && name.endsWith(pattern.slice(1));
+        }
+        return pattern !== "" && name === pattern;
+    });
+}
+function audioTooLarge(limit) {
+    return new Error(`MiniMax audio download is larger than ${limit} bytes (maxAudioDownloadBytes).`);
+}
+/** The response body, read until it ends or passes `limit` bytes. */
+async function readCappedBody(response, limit) {
+    if (!response.body) {
+        const whole = Buffer.from(await response.arrayBuffer());
+        if (whole.length > limit)
+            throw audioTooLarge(limit);
+        return whole;
+    }
+    const reader = response.body.getReader();
+    const chunks = [];
+    let total = 0;
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        total += value.byteLength;
+        if (total > limit) {
+            await reader.cancel().catch(() => undefined);
+            throw audioTooLarge(limit);
+        }
+        chunks.push(value);
+    }
+    return Buffer.concat(chunks, total);
+}
 /** Text-to-speech provider for MiniMax HTTP, async, and WebSocket APIs. */
 export class MiniMaxTextToSpeechProvider {
     constructor(config) {
@@ -56,7 +107,7 @@ export class MiniMaxTextToSpeechProvider {
             throw new Error("MiniMax speech synthesis completed without audio output.");
         }
         const audioBuffer = outputFormat === "url"
-            ? Buffer.from(await (await this.fetchImpl(audio)).arrayBuffer())
+            ? await this.downloadAudio(audio)
             : decodeHexAudio(audio);
         return this.result(audioBuffer, text, options, audioFormat, response);
     }
@@ -64,8 +115,14 @@ export class MiniMaxTextToSpeechProvider {
         const providerOptions = this.providerOptions(options);
         return this.request("/v1/t2a_async_v2", this.buildRequest(text, options, providerOptions, this.audioFormat(options, providerOptions)));
     }
+    /**
+     * Query an async task's status: `GET /v1/query/t2a_async_query_v2` with
+     * `task_id` as a query parameter.
+     * https://platform.minimax.io/docs/api-reference/speech-t2a-async-query
+     */
     async queryAsync(taskId) {
-        return this.request("/v1/query/t2a_async_query_v2", { task_id: taskId });
+        const query = new URLSearchParams({ task_id: String(taskId) });
+        return this.request(`/v1/query/t2a_async_query_v2?${query.toString()}`);
     }
     async synthesizeWebSocket(text, options = {}) {
         const providerOptions = this.providerOptions(options);
@@ -160,19 +217,71 @@ export class MiniMaxTextToSpeechProvider {
             voice_modify: providerOptions.voiceModify,
         };
     }
+    /**
+     * Download the audio a `url` response links to. The link must be `https`
+     * on a host in `audioUrlHosts`. The request carries no key, refuses
+     * redirects, has a timeout, and fails on a non-2xx status or a body past
+     * `maxAudioDownloadBytes`.
+     */
+    async downloadAudio(link) {
+        let url;
+        try {
+            url = new URL(link);
+        }
+        catch {
+            throw new Error("MiniMax speech returned an audio URL that is not a URL.");
+        }
+        if (url.protocol !== "https:") {
+            throw new Error(`MiniMax speech returned a ${url.protocol} audio URL; only https is downloaded.`);
+        }
+        if (!hostAllowed(url.hostname, this.config.audioUrlHosts ?? [])) {
+            throw new Error(`MiniMax speech returned an audio URL on ${url.hostname}, which is not in ` +
+                "audioUrlHosts; list the host there to download URL output.");
+        }
+        const limit = this.config.maxAudioDownloadBytes ?? DEFAULT_MAX_AUDIO_DOWNLOAD_BYTES;
+        const timeoutMs = this.config.audioDownloadTimeoutMs ?? DEFAULT_AUDIO_DOWNLOAD_TIMEOUT_MS;
+        const signal = AbortSignal.timeout(timeoutMs);
+        try {
+            const response = await this.fetchImpl(url.href, { redirect: "error", signal });
+            if (!response.ok) {
+                await response.body?.cancel().catch(() => undefined);
+                throw new Error(`MiniMax audio download failed (${response.status}).`);
+            }
+            const declared = Number(response.headers?.get("content-length"));
+            if (Number.isFinite(declared) && declared > limit) {
+                await response.body?.cancel().catch(() => undefined);
+                throw audioTooLarge(limit);
+            }
+            const audio = await readCappedBody(response, limit);
+            if (audio.length === 0) {
+                throw new Error("MiniMax audio download returned no audio.");
+            }
+            return audio;
+        }
+        catch (error) {
+            if (signal.aborted) {
+                throw new Error(`MiniMax audio download timed out after ${timeoutMs} ms.`);
+            }
+            throw error;
+        }
+    }
+    /** A JSON request to MiniMax: a POST when `body` is given, else a GET. */
     async request(path, body) {
         const baseUrl = this.config.baseUrl ?? `https://${this.host}`;
-        const response = await this.fetchImpl(`${baseUrl}${path}`, {
-            method: "POST",
-            headers: {
-                Authorization: `Bearer ${this.keyPool.next()}`,
-                "Content-Type": "application/json",
-            },
-            body: JSON.stringify(body),
-        });
+        const authorization = `Bearer ${this.keyPool.next()}`;
+        const response = await this.fetchImpl(`${baseUrl}${path}`, body === undefined
+            ? { method: "GET", headers: { Authorization: authorization } }
+            : {
+                method: "POST",
+                headers: {
+                    Authorization: authorization,
+                    "Content-Type": "application/json",
+                },
+                body: JSON.stringify(body),
+            });
         let payload;
         try {
-            payload = (await response.json());
+            payload = parseMiniMaxJson(await response.text());
         }
         catch {
             throw new Error(`MiniMax speech returned invalid JSON (${response.status}).`);

package/dist/io/speech/providers/MiniMaxTextToSpeechProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"MiniMaxTextToSpeechProvider.js","sourceRoot":"","sources":["../../../../src/io/speech/providers/MiniMaxTextToSpeechProvider.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MiniMaxTextToSpeechProvider.js","sourceRoot":"","sources":["../../../../src/io/speech/providers/MiniMaxTextToSpeechProvider.ts"],"names":[],"mappings":"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"}

package/dist/safety/runtime/SpendMeter.d.ts

@@ -0,0 +1,135 @@
+/**
+ * @fileoverview The spend meter contract: a persisted, per-account allowance of turns (or any unit a product
+ * meters), reserved atomically before a turn reaches a model provider and settled when the turn ends.
+ *
+ * A reservation is keyed by the caller's durable `operationId`, so a request retried with the same id replays its
+ * reservation instead of charging twice. A reservation that is never settled (the process died mid-turn) carries a
+ * lease; {@link ISpendMeter.reconcile} settles the expired ones, asking the product what became of each.
+ *
+ * @module safety/runtime/SpendMeter
+ */
+/** How a reservation ends: the turn counted, it did not, or its reply was replaced after it counted (refunded). */
+export type SpendOutcome = 'consumed' | 'released' | 'replaced';
+/** The state of one reservation row. A replaced reservation ends `released`, with the outcome `replaced`. */
+export type SpendReservationState = 'reserved' | 'consumed' | 'released';
+/** Why a reservation was refused. */
+export type SpendDenyReason = 
+/** The period's allowance has no room for the units asked. */
+'allowance_exhausted'
+/** The operation already holds a live reservation (a concurrent duplicate of the same request). */
+ | 'in_flight'
+/** The operation already counted: a retry of a request that finished. */
+ | 'already_consumed'
+/** The operation was released and retried as many times as the meter allows. */
+ | 'retries_exhausted';
+/** Token usage a settle may record beside the outcome. */
+export interface SpendUsage {
+    promptTokens?: number;
+    completionTokens?: number;
+    totalTokens?: number;
+    totalCostUSD?: number;
+}
+export interface SpendReserveRequest {
+    accountId: string;
+    /** The product's durable id for the request; a retry with the same id replays the reservation. */
+    operationId: string;
+    /** Units to reserve. Default 1. */
+    units?: number;
+    /** The clock, in epoch milliseconds; for tests. */
+    now?: number;
+}
+export type SpendReserveResult = {
+    status: 'reserved';
+    operationId: string;
+    accountId: string;
+    period: string;
+    units: number;
+    /** 1 for a first reservation, more for a retry of a released one. */
+    attempt: number;
+    /** Units left in the period after this reservation. */
+    remaining: number;
+    expiresAt: number;
+} | {
+    status: 'denied';
+    reason: SpendDenyReason;
+    operationId: string;
+    accountId: string;
+    period: string;
+    remaining: number;
+};
+export interface SpendSettleRequest {
+    operationId: string;
+    outcome: SpendOutcome;
+    usage?: SpendUsage;
+    now?: number;
+}
+export interface SpendSettleResult {
+    /** `already_settled` when the reservation had already left the state this outcome moves it from. */
+    status: 'settled' | 'already_settled' | 'not_found';
+    state?: SpendReservationState;
+}
+export interface SpendMeterSnapshot {
+    accountId: string;
+    period: string;
+    allowance: number;
+    used: number;
+    reserved: number;
+    remaining: number;
+}
+export interface SpendReconcileResult {
+    consumed: number;
+    released: number;
+    /** Expired reservations still reserved after the pass (a concurrent settle, or the page limit). */
+    pending: number;
+}
+/**
+ * A persisted per-account meter. Every method is safe to call from several processes at once against one store:
+ * two reservations cannot both take the last unit, and a reservation settles exactly once.
+ */
+export interface ISpendMeter {
+    /** Reserves units for an operation, or refuses. Rejects with {@link SpendMeterUnavailableError} when the store cannot answer. */
+    reserve(req: SpendReserveRequest): Promise<SpendReserveResult>;
+    /** Settles an operation's reservation. Idempotent per operation and outcome. */
+    settle(req: SpendSettleRequest): Promise<SpendSettleResult>;
+    /** Pushes a live reservation's lease forward while its turn runs. */
+    heartbeat(operationId: string, now?: number): Promise<void>;
+    /** Settles the reservations whose lease ran out. */
+    reconcile(opts?: {
+        now?: number;
+        limit?: number;
+    }): Promise<SpendReconcileResult>;
+    /** The account's current period: its allowance, the units used and reserved, and what remains. */
+    snapshot(accountId: string, now?: number): Promise<SpendMeterSnapshot>;
+    /**
+     * Writes the current period's allowance at once after a plan change; the units used stay. A store that reads the
+     * product's allowance at every reservation takes the product's answer again at the next one.
+     */
+    setAllowance(accountId: string, allowance: number, now?: number): Promise<void>;
+}
+/** Thrown when the meter's store cannot answer within its retry policy. A caller fails closed on it: no turn runs. */
+export declare class SpendMeterUnavailableError extends Error {
+    readonly cause?: unknown | undefined;
+    readonly code = "SPEND_METER_UNAVAILABLE";
+    constructor(message: string, cause?: unknown | undefined);
+}
+export interface SpendRetryPolicy {
+    /** Tries in all, the first included. */
+    attempts: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+    /** No new try starts after this many milliseconds from the first. */
+    deadlineMs: number;
+}
+export declare const DEFAULT_SPEND_RETRY_POLICY: SpendRetryPolicy;
+/**
+ * Runs `fn`, trying again on an error `isTransient` accepts, with a doubling delay, until the tries or the deadline
+ * run out. Any failure that ends the loop is thrown as a {@link SpendMeterUnavailableError} carrying the last error.
+ */
+export declare function withBoundedRetry<T>(fn: () => Promise<T>, policy: SpendRetryPolicy, isTransient: (e: unknown) => boolean): Promise<T>;
+/**
+ * The store errors worth a second try: Postgres serialization failures and deadlocks (40001, 40P01), its connection
+ * class (08xxx) and an administrator's shutdown (57P01); SQLite's busy and locked; and the network errors a pool
+ * reports when a connection drops.
+ */
+export declare function isTransientStorageError(e: unknown): boolean;
+//# sourceMappingURL=SpendMeter.d.ts.map

package/dist/safety/runtime/SpendMeter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpendMeter.d.ts","sourceRoot":"","sources":["../../../src/safety/runtime/SpendMeter.ts"],"names":[],"mappings":"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"}

package/dist/safety/runtime/SpendMeter.js

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview The spend meter contract: a persisted, per-account allowance of turns (or any unit a product
+ * meters), reserved atomically before a turn reaches a model provider and settled when the turn ends.
+ *
+ * A reservation is keyed by the caller's durable `operationId`, so a request retried with the same id replays its
+ * reservation instead of charging twice. A reservation that is never settled (the process died mid-turn) carries a
+ * lease; {@link ISpendMeter.reconcile} settles the expired ones, asking the product what became of each.
+ *
+ * @module safety/runtime/SpendMeter
+ */
+/** Thrown when the meter's store cannot answer within its retry policy. A caller fails closed on it: no turn runs. */
+export class SpendMeterUnavailableError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.code = 'SPEND_METER_UNAVAILABLE';
+        this.name = 'SpendMeterUnavailableError';
+    }
+}
+export const DEFAULT_SPEND_RETRY_POLICY = { attempts: 3, baseDelayMs: 50, maxDelayMs: 400, deadlineMs: 2000 };
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+/**
+ * Runs `fn`, trying again on an error `isTransient` accepts, with a doubling delay, until the tries or the deadline
+ * run out. Any failure that ends the loop is thrown as a {@link SpendMeterUnavailableError} carrying the last error.
+ */
+export async function withBoundedRetry(fn, policy, isTransient) {
+    const started = Date.now();
+    let last;
+    for (let attempt = 1; attempt <= Math.max(1, policy.attempts); attempt += 1) {
+        try {
+            return await fn();
+        }
+        catch (e) {
+            last = e;
+            if (!isTransient(e))
+                break;
+            const delay = Math.min(policy.maxDelayMs, policy.baseDelayMs * 2 ** (attempt - 1));
+            if (attempt === policy.attempts || Date.now() - started + delay > policy.deadlineMs)
+                break;
+            await sleep(delay);
+        }
+    }
+    const message = last instanceof Error ? last.message : String(last);
+    throw new SpendMeterUnavailableError(`the spend meter's store did not answer: ${message}`, last);
+}
+/**
+ * The store errors worth a second try: Postgres serialization failures and deadlocks (40001, 40P01), its connection
+ * class (08xxx) and an administrator's shutdown (57P01); SQLite's busy and locked; and the network errors a pool
+ * reports when a connection drops.
+ */
+export function isTransientStorageError(e) {
+    const err = e;
+    const code = typeof err?.code === 'string' ? err.code : '';
+    if (code === '40001' || code === '40P01' || code === '57P01' || code.startsWith('08'))
+        return true;
+    if (code === 'SQLITE_BUSY' || code === 'SQLITE_LOCKED' || code === 'ECONNRESET' || code === 'ECONNREFUSED' || code === 'ETIMEDOUT' || code === 'EPIPE')
+        return true;
+    const message = typeof err?.message === 'string' ? err.message : '';
+    return /database is locked|SQLITE_BUSY|Connection terminated|connection timeout/i.test(message);
+}
+//# sourceMappingURL=SpendMeter.js.map

package/dist/safety/runtime/SpendMeter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpendMeter.js","sourceRoot":"","sources":["../../../src/safety/runtime/SpendMeter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA8GH,sHAAsH;AACtH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAEnD,YAAY,OAAe,EAAW,KAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QADqB,UAAK,GAAL,KAAK,CAAU;QAD5C,SAAI,GAAG,yBAAyB,CAAC;QAGxC,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAWD,MAAM,CAAC,MAAM,0BAA0B,GAAqB,EAAE,QAAQ,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,IAAK,EAAE,CAAC;AAEjI,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAEtF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAI,EAAoB,EAAE,MAAwB,EAAE,WAAoC;IAC5H,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC3B,IAAI,IAAa,CAAC;IAClB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,GAAG,CAAC,CAAC;YACT,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;gBAAE,MAAM;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;YACnF,IAAI,OAAO,KAAK,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC,UAAU;gBAAE,MAAM;YAC3F,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,YAAY,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,IAAI,0BAA0B,CAAC,2CAA2C,OAAO,EAAE,EAAE,IAAI,CAAC,CAAC;AACnG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,CAAU;IAChD,MAAM,GAAG,GAAG,CAAiD,CAAC;IAC9D,MAAM,IAAI,GAAG,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnG,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,cAAc,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACpK,MAAM,OAAO,GAAG,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,OAAO,0EAA0E,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAClG,CAAC"}

package/dist/safety/runtime/SqlSpendMeter.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview {@link ISpendMeter} over a `@framers/sql-storage-adapter` store: Postgres for a deployment, SQLite for
+ * a single process and the tests.
+ *
+ * Every write is a conditional statement inside one transaction, never a read followed by a write, so the store's
+ * own row locking decides a race: two reservations cannot both take the last unit, and a settle and a reconcile on
+ * one operation make one transition between them.
+ *
+ * Give the meter an adapter of its own (or the product's own pool), never AgentOS's provenance-wrapped storage
+ * adapter, whose write hooks can turn a `run()` into a no-op.
+ *
+ * @module safety/runtime/SqlSpendMeter
+ */
+import type { StorageAdapter } from '@framers/sql-storage-adapter';
+import { type ISpendMeter, type SpendMeterSnapshot, type SpendReconcileResult, type SpendReserveRequest, type SpendReserveResult, type SpendRetryPolicy, type SpendSettleRequest, type SpendSettleResult } from './SpendMeter.js';
+/**
+ * The meter's two tables. Every time is epoch milliseconds in a BIGINT. There is no literal question mark anywhere in
+ * the text: the Postgres adapter rewrites each one to a numbered parameter. A product that runs its own migrations
+ * copies this text into one of them and passes `ensureSchema: false`.
+ */
+export declare const SPEND_METER_DDL = "\nCREATE TABLE IF NOT EXISTS agentos_spend_meter (\n  account_id TEXT NOT NULL,\n  period TEXT NOT NULL,\n  allowance BIGINT NOT NULL,\n  used BIGINT NOT NULL DEFAULT 0,\n  reserved BIGINT NOT NULL DEFAULT 0,\n  updated_at BIGINT NOT NULL,\n  PRIMARY KEY (account_id, period),\n  CHECK (used >= 0 AND reserved >= 0)\n);\nCREATE TABLE IF NOT EXISTS agentos_spend_reservations (\n  operation_id TEXT PRIMARY KEY,\n  account_id TEXT NOT NULL,\n  period TEXT NOT NULL,\n  units BIGINT NOT NULL,\n  state TEXT NOT NULL CHECK (state IN ('reserved', 'consumed', 'released')),\n  outcome TEXT,\n  attempts BIGINT NOT NULL DEFAULT 1,\n  reserved_at BIGINT NOT NULL,\n  expires_at BIGINT NOT NULL,\n  settled_at BIGINT,\n  usage_json TEXT\n);\nCREATE INDEX IF NOT EXISTS idx_spend_reservations_due ON agentos_spend_reservations (state, expires_at);\n";
+/** What became of an operation whose lease ran out, as the product knows it: its reply was stored, it was not, or it cannot tell. */
+export type SpendUnknownResolution = 'consumed' | 'released' | 'unknown';
+export interface SqlSpendMeterOptions {
+    db: StorageAdapter;
+    /** The account's allowance for a period, in units. Read at every reservation, so a plan change applies at the next turn. */
+    allowanceFor(accountId: string, period: string): number | Promise<number>;
+    /** The period a moment falls in for an account, e.g. its calendar month in its own time zone ("2026-10"). */
+    periodOf(now: number, accountId: string): string | Promise<string>;
+    /** How long a reservation lives without a heartbeat. Default 45 seconds. */
+    leaseMs?: number;
+    /** Reservations an operation may take in all, its retries after a release included. Default 3. */
+    maxAttemptsPerOperation?: number;
+    retry?: SpendRetryPolicy;
+    /** Asked by {@link SqlSpendMeter.reconcile} for each expired reservation. */
+    resolveUnknown?(reservation: {
+        operationId: string;
+        accountId: string;
+        period: string;
+        units: number;
+    }): SpendUnknownResolution | Promise<SpendUnknownResolution>;
+    /** How an expired reservation settles when the product cannot tell. Default `release`: the person is not charged for a turn nobody saw finish. */
+    unknownAfterLease?: 'release' | 'consume';
+    /**
+     * Refuse a store that several processes cannot share (no transactions, no persistence or no concurrent access): a
+     * SQLite file per process would give every instance an allowance of its own. Default true; tests pass false.
+     */
+    requireShared?: boolean;
+    /** Create the tables when they are missing. Default true. */
+    ensureSchema?: boolean;
+}
+export declare class SqlSpendMeter implements ISpendMeter {
+    private readonly opts;
+    private readonly db;
+    private readonly leaseMs;
+    private readonly maxAttempts;
+    private readonly retry;
+    private schemaReady;
+    private reconciler;
+    constructor(opts: SqlSpendMeterOptions);
+    /** Creates the tables unless they answer a read already. Called before the first statement; safe to call again. */
+    ensureSchema(): Promise<void>;
+    private run;
+    reserve(req: SpendReserveRequest): Promise<SpendReserveResult>;
+    private remainingIn;
+    settle(req: SpendSettleRequest): Promise<SpendSettleResult>;
+    heartbeat(operationId: string, now?: number): Promise<void>;
+    reconcile(opts?: {
+        now?: number;
+        limit?: number;
+    }): Promise<SpendReconcileResult>;
+    snapshot(accountId: string, now?: number): Promise<SpendMeterSnapshot>;
+    setAllowance(accountId: string, allowance: number, now?: number): Promise<void>;
+    /** Runs {@link reconcile} every interval until {@link stopReconciler}. A failed pass is retried on the next tick. */
+    startReconciler(intervalMs?: number, onError?: (e: unknown) => void): void;
+    stopReconciler(): void;
+}
+//# sourceMappingURL=SqlSpendMeter.d.ts.map

package/dist/safety/runtime/SqlSpendMeter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlSpendMeter.d.ts","sourceRoot":"","sources":["../../../src/safety/runtime/SqlSpendMeter.ts"],"names":[],"mappings":"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"}