@framers/agentos 0.12.24 → 0.13.2

package/dist/safety/runtime/SqlSpendMeter.js

@@ -0,0 +1,268 @@
+import { DEFAULT_SPEND_RETRY_POLICY, isTransientStorageError, SpendMeterUnavailableError, withBoundedRetry, } 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 const SPEND_METER_DDL = `
+CREATE TABLE IF NOT EXISTS agentos_spend_meter (
+  account_id TEXT NOT NULL,
+  period TEXT NOT NULL,
+  allowance BIGINT NOT NULL,
+  used BIGINT NOT NULL DEFAULT 0,
+  reserved BIGINT NOT NULL DEFAULT 0,
+  updated_at BIGINT NOT NULL,
+  PRIMARY KEY (account_id, period),
+  CHECK (used >= 0 AND reserved >= 0)
+);
+CREATE TABLE IF NOT EXISTS agentos_spend_reservations (
+  operation_id TEXT PRIMARY KEY,
+  account_id TEXT NOT NULL,
+  period TEXT NOT NULL,
+  units BIGINT NOT NULL,
+  state TEXT NOT NULL CHECK (state IN ('reserved', 'consumed', 'released')),
+  outcome TEXT,
+  attempts BIGINT NOT NULL DEFAULT 1,
+  reserved_at BIGINT NOT NULL,
+  expires_at BIGINT NOT NULL,
+  settled_at BIGINT,
+  usage_json TEXT
+);
+CREATE INDEX IF NOT EXISTS idx_spend_reservations_due ON agentos_spend_reservations (state, expires_at);
+`;
+/** Rolls a reservation's transaction back when the allowance has no room; caught inside the same try, never retried. */
+class AllowanceExhausted extends Error {
+    constructor(remaining) {
+        super('allowance_exhausted');
+        this.remaining = remaining;
+    }
+}
+const num = (v) => (typeof v === 'number' ? v : Number(v ?? 0));
+export class SqlSpendMeter {
+    constructor(opts) {
+        this.opts = opts;
+        this.schemaReady = null;
+        this.reconciler = null;
+        const caps = opts.db.capabilities;
+        if (opts.requireShared !== false && !(caps.has('transactions') && caps.has('persistence') && caps.has('concurrent'))) {
+            throw new Error(`SqlSpendMeter needs a store several processes share (transactions, persistence and concurrent access); "${opts.db.kind}" lacks one. Pass requireShared: false for a single process.`);
+        }
+        if (!caps.has('transactions'))
+            throw new Error(`SqlSpendMeter needs a store with transactions; "${opts.db.kind}" has none.`);
+        this.db = opts.db;
+        this.leaseMs = opts.leaseMs ?? 45000;
+        this.maxAttempts = opts.maxAttemptsPerOperation ?? 3;
+        this.retry = opts.retry ?? DEFAULT_SPEND_RETRY_POLICY;
+    }
+    /** Creates the tables unless they answer a read already. Called before the first statement; safe to call again. */
+    ensureSchema() {
+        if (this.opts.ensureSchema === false)
+            return Promise.resolve();
+        this.schemaReady ?? (this.schemaReady = (async () => {
+            try {
+                await this.db.get('SELECT 1 FROM agentos_spend_meter LIMIT 1');
+                await this.db.get('SELECT 1 FROM agentos_spend_reservations LIMIT 1');
+            }
+            catch {
+                await this.db.exec(SPEND_METER_DDL);
+            }
+        })().catch((e) => {
+            this.schemaReady = null;
+            throw e;
+        }));
+        return this.schemaReady;
+    }
+    run(fn) {
+        return withBoundedRetry(async () => {
+            await this.ensureSchema();
+            return fn();
+        }, this.retry, isTransientStorageError);
+    }
+    async reserve(req) {
+        const now = req.now ?? Date.now();
+        const units = Math.max(1, Math.trunc(req.units ?? 1));
+        let period;
+        let allowance;
+        try {
+            period = await this.opts.periodOf(now, req.accountId);
+            allowance = Math.max(0, Math.trunc(await this.opts.allowanceFor(req.accountId, period)));
+        }
+        catch (e) {
+            throw new SpendMeterUnavailableError(`the allowance could not be read: ${e instanceof Error ? e.message : String(e)}`, e);
+        }
+        const base = { operationId: req.operationId, accountId: req.accountId, period };
+        const expiresAt = now + this.leaseMs;
+        return this.run(async () => {
+            try {
+                return await this.db.transaction(async (trx) => {
+                    // (a) the reservation row: new, or a retry of one that was released
+                    const inserted = await trx.run(`INSERT INTO agentos_spend_reservations (operation_id, account_id, period, units, state, attempts, reserved_at, expires_at)
+             VALUES (?, ?, ?, ?, 'reserved', 1, ?, ?) ON CONFLICT (operation_id) DO NOTHING`, [req.operationId, req.accountId, period, units, now, expiresAt]);
+                    let attempt = 1;
+                    if (!inserted.changes) {
+                        const retried = await trx.run(`UPDATE agentos_spend_reservations
+                  SET state = 'reserved', attempts = attempts + 1, account_id = ?, period = ?, units = ?, reserved_at = ?, expires_at = ?,
+                      outcome = NULL, settled_at = NULL, usage_json = NULL
+                WHERE operation_id = ? AND state = 'released' AND attempts < ?`, [req.accountId, period, units, now, expiresAt, req.operationId, this.maxAttempts]);
+                        const row = await trx.get('SELECT state, attempts FROM agentos_spend_reservations WHERE operation_id = ?', [req.operationId]);
+                        if (!retried.changes) {
+                            const reason = row?.state === 'reserved' ? 'in_flight' : row?.state === 'consumed' ? 'already_consumed' : 'retries_exhausted';
+                            return { status: 'denied', reason, ...base, remaining: await this.remainingIn(trx, req.accountId, period, allowance) };
+                        }
+                        attempt = num(row?.attempts);
+                    }
+                    // (b) the period's row, with the allowance in force today
+                    await trx.run(`INSERT INTO agentos_spend_meter (account_id, period, allowance, used, reserved, updated_at) VALUES (?, ?, ?, 0, 0, ?)
+             ON CONFLICT (account_id, period) DO UPDATE SET allowance = excluded.allowance`, [req.accountId, period, allowance, now]);
+                    // (c) the units taken only where they fit: the row lock makes concurrent reservations queue here
+                    const taken = await trx.run(`UPDATE agentos_spend_meter SET reserved = reserved + ?, updated_at = ?
+              WHERE account_id = ? AND period = ? AND used + reserved + ? <= allowance`, [units, now, req.accountId, period, units]);
+                    if (!taken.changes)
+                        throw new AllowanceExhausted(await this.remainingIn(trx, req.accountId, period, allowance));
+                    return { status: 'reserved', ...base, units, attempt, remaining: await this.remainingIn(trx, req.accountId, period, allowance), expiresAt };
+                });
+            }
+            catch (e) {
+                // the transaction rolled (a) and (b) back; the refusal is an answer, not a failure
+                if (e instanceof AllowanceExhausted)
+                    return { status: 'denied', reason: 'allowance_exhausted', ...base, remaining: e.remaining };
+                throw e;
+            }
+        });
+    }
+    async remainingIn(trx, accountId, period, fallbackAllowance) {
+        const m = await trx.get('SELECT allowance, used, reserved FROM agentos_spend_meter WHERE account_id = ? AND period = ?', [accountId, period]);
+        if (!m)
+            return fallbackAllowance;
+        return Math.max(0, num(m.allowance) - num(m.used) - num(m.reserved));
+    }
+    async settle(req) {
+        const now = req.now ?? Date.now();
+        return this.run(() => this.db.transaction(async (trx) => {
+            const row = await trx.get('SELECT operation_id, account_id, period, units, state FROM agentos_spend_reservations WHERE operation_id = ?', [req.operationId]);
+            if (!row)
+                return { status: 'not_found' };
+            const move = transition(row.state, req.outcome);
+            if (!move)
+                return { status: 'already_settled', state: row.state };
+            // the move only from the state just read: a concurrent settle that got there first leaves nothing to change
+            const changed = await trx.run(`UPDATE agentos_spend_reservations SET state = ?, outcome = ?, settled_at = ?, usage_json = ? WHERE operation_id = ? AND state = ?`, [move.to, req.outcome, now, req.usage ? JSON.stringify(req.usage) : null, req.operationId, row.state]);
+            if (!changed.changes) {
+                const current = await trx.get('SELECT state FROM agentos_spend_reservations WHERE operation_id = ?', [req.operationId]);
+                return { status: 'already_settled', state: current?.state };
+            }
+            const units = num(row.units);
+            const sets = [];
+            const params = [];
+            if (move.reserved) {
+                sets.push('reserved = CASE WHEN reserved >= ? THEN reserved - ? ELSE 0 END');
+                params.push(units, units);
+            }
+            if (move.used > 0) {
+                sets.push('used = used + ?');
+                params.push(units);
+            }
+            else if (move.used < 0) {
+                sets.push('used = CASE WHEN used >= ? THEN used - ? ELSE 0 END');
+                params.push(units, units);
+            }
+            sets.push('updated_at = ?');
+            params.push(now, row.account_id, row.period);
+            await trx.run(`UPDATE agentos_spend_meter SET ${sets.join(', ')} WHERE account_id = ? AND period = ?`, params);
+            return { status: 'settled', state: move.to };
+        }));
+    }
+    async heartbeat(operationId, now = Date.now()) {
+        // every write goes through a transaction: on a single-connection SQLite store that is what keeps it out of another's
+        await this.run(() => this.db.transaction((trx) => trx.run(`UPDATE agentos_spend_reservations SET expires_at = ? WHERE operation_id = ? AND state = 'reserved' AND expires_at < ?`, [
+            now + this.leaseMs,
+            operationId,
+            now + this.leaseMs,
+        ])));
+    }
+    async reconcile(opts = {}) {
+        const now = opts.now ?? Date.now();
+        const limit = Math.max(1, Math.trunc(opts.limit ?? 100));
+        const due = await this.run(() => this.db.all(`SELECT operation_id, account_id, period, units, state FROM agentos_spend_reservations WHERE state = 'reserved' AND expires_at <= ? ORDER BY expires_at LIMIT ${limit}`, [now]));
+        const out = { consumed: 0, released: 0, pending: 0 };
+        for (const r of due) {
+            let resolution = 'unknown';
+            try {
+                if (this.opts.resolveUnknown) {
+                    resolution = await this.opts.resolveUnknown({ operationId: r.operation_id, accountId: r.account_id, period: r.period, units: num(r.units) });
+                }
+            }
+            catch {
+                resolution = 'unknown';
+            }
+            const outcome = resolution === 'consumed' ? 'consumed' : resolution === 'released' ? 'released' : this.opts.unknownAfterLease === 'consume' ? 'consumed' : 'released';
+            const settled = await this.settle({ operationId: r.operation_id, outcome, now });
+            if (settled.status !== 'settled')
+                out.pending += settled.state === 'reserved' ? 1 : 0;
+            else if (outcome === 'consumed')
+                out.consumed += 1;
+            else
+                out.released += 1;
+        }
+        return out;
+    }
+    async snapshot(accountId, now = Date.now()) {
+        let period;
+        let allowance;
+        try {
+            period = await this.opts.periodOf(now, accountId);
+            allowance = Math.max(0, Math.trunc(await this.opts.allowanceFor(accountId, period)));
+        }
+        catch (e) {
+            throw new SpendMeterUnavailableError(`the allowance could not be read: ${e instanceof Error ? e.message : String(e)}`, e);
+        }
+        const m = await this.run(() => this.db.get('SELECT allowance, used, reserved FROM agentos_spend_meter WHERE account_id = ? AND period = ?', [
+            accountId,
+            period,
+        ]));
+        // what is enforced now: the period's stored allowance once the period has a row, else the product's answer
+        const enforced = m ? num(m.allowance) : allowance;
+        const used = num(m?.used);
+        const reserved = num(m?.reserved);
+        return { accountId, period, allowance: enforced, used, reserved, remaining: Math.max(0, enforced - used - reserved) };
+    }
+    async setAllowance(accountId, allowance, now = Date.now()) {
+        const value = Math.max(0, Math.trunc(allowance));
+        let period;
+        try {
+            period = await this.opts.periodOf(now, accountId);
+        }
+        catch (e) {
+            throw new SpendMeterUnavailableError(`the period could not be read: ${e instanceof Error ? e.message : String(e)}`, e);
+        }
+        await this.run(() => this.db.transaction((trx) => trx.run(`INSERT INTO agentos_spend_meter (account_id, period, allowance, used, reserved, updated_at) VALUES (?, ?, ?, 0, 0, ?)
+           ON CONFLICT (account_id, period) DO UPDATE SET allowance = excluded.allowance, updated_at = excluded.updated_at`, [accountId, period, value, now])));
+    }
+    /** Runs {@link reconcile} every interval until {@link stopReconciler}. A failed pass is retried on the next tick. */
+    startReconciler(intervalMs = 15000, onError) {
+        if (this.reconciler)
+            return;
+        this.reconciler = setInterval(() => {
+            this.reconcile().catch((e) => onError?.(e));
+        }, intervalMs);
+        this.reconciler.unref?.();
+    }
+    stopReconciler() {
+        if (this.reconciler)
+            clearInterval(this.reconciler);
+        this.reconciler = null;
+    }
+}
+/** Where an outcome moves a reservation from its state, and what it does to the period's counters; null when it moves nothing. */
+function transition(from, outcome) {
+    if (from === 'reserved') {
+        if (outcome === 'consumed')
+            return { to: 'consumed', reserved: true, used: 1 };
+        return { to: 'released', reserved: true, used: 0 };
+    }
+    // a reply replaced after its turn counted is refunded
+    if (from === 'consumed' && outcome === 'replaced')
+        return { to: 'released', reserved: false, used: -1 };
+    return null;
+}
+//# sourceMappingURL=SqlSpendMeter.js.map

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

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

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

@@ -14,4 +14,8 @@ export { CostGuard, CostCapExceededError } from './CostGuard.js';
 export type { CostGuardConfig, CostCapType, CostRecord, CostSnapshot } from './CostGuard.js';
 export { ToolExecutionGuard, ToolTimeoutError } from './ToolExecutionGuard.js';
 export type { ToolExecutionGuardConfig, GuardedToolResult, ToolHealthReport } from './ToolExecutionGuard.js';
+export { SpendMeterUnavailableError, withBoundedRetry, isTransientStorageError, DEFAULT_SPEND_RETRY_POLICY, } from './SpendMeter.js';
+export type { ISpendMeter, SpendOutcome, SpendReservationState, SpendDenyReason, SpendUsage, SpendReserveRequest, SpendReserveResult, SpendSettleRequest, SpendSettleResult, SpendMeterSnapshot, SpendReconcileResult, SpendRetryPolicy, } from './SpendMeter.js';
+export { SqlSpendMeter, SPEND_METER_DDL } from './SqlSpendMeter.js';
+export type { SqlSpendMeterOptions, SpendUnknownResolution } from './SqlSpendMeter.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/safety/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE3F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE3F,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE7F,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/safety/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE3F,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE3F,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE7F,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE7G,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,WAAW,EACX,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/safety/runtime/index.js

@@ -9,4 +9,6 @@ export { ActionDeduplicator } from './ActionDeduplicator.js';
 export { StuckDetector } from './StuckDetector.js';
 export { CostGuard, CostCapExceededError } from './CostGuard.js';
 export { ToolExecutionGuard, ToolTimeoutError } from './ToolExecutionGuard.js';
+export { SpendMeterUnavailableError, withBoundedRetry, isTransientStorageError, DEFAULT_SPEND_RETRY_POLICY, } from './SpendMeter.js';
+export { SqlSpendMeter, SPEND_METER_DDL } from './SqlSpendMeter.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/safety/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/safety/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG/E,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAezB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.12.24",
+  "version": "0.13.2",
   "description": "AgentOS: open-source TypeScript framework for autonomous AI agents. Unified graph orchestration, cognitive memory, runtime tool forging, multi-tier guardrails, voice pipeline, and 11 LLM providers.",
   "homepage": "https://agentos.sh",
   "repository": {