octoflow-core 1.0.0

package/dist/adapters/data/approval-store/sqlite.js

@@ -0,0 +1,251 @@
+import crypto from "node:crypto";
+import { ApprovalConcurrencyError } from "../../../domain/errors/index.js";
+import { syncPromise } from "../../../utils/sync-promise.js";
+import { nowIso } from "../../../utils/time.js";
+import { createSqliteDb } from "../sqlite-helpers.js";
+import { createApprovalChangeSubscription } from "./change-feed.js";
+class SqliteApprovalStore {
+  db;
+  listeners = /* @__PURE__ */ new Set();
+  constructor(options = {}) {
+    this.db = createSqliteDb(options);
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS approvals (
+        id           TEXT PRIMARY KEY,
+        context_id   TEXT NOT NULL,
+        task_id      TEXT NOT NULL,
+        tenant       TEXT,
+        type         TEXT NOT NULL,
+        status       TEXT NOT NULL DEFAULT 'pending',
+        summary      TEXT NOT NULL,
+        payload      TEXT NOT NULL DEFAULT '{}',
+        requested_by TEXT NOT NULL,
+        requested_at TEXT NOT NULL,
+        decided_by   TEXT,
+        decided_at   TEXT,
+        decision_note TEXT,
+        created_at   TEXT NOT NULL,
+        updated_at   TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS approvals_context ON approvals(context_id);
+      CREATE INDEX IF NOT EXISTS approvals_task    ON approvals(task_id);
+      CREATE INDEX IF NOT EXISTS approvals_status  ON approvals(status);
+    `);
+  }
+  create(input) {
+    return syncPromise(() => {
+      const now = nowIso();
+      const approval = {
+        ...input,
+        id: crypto.randomUUID(),
+        createdAt: now,
+        updatedAt: now
+      };
+      this.db.prepare(
+        `
+        INSERT INTO approvals (
+          id, context_id, task_id, tenant, type, status, summary, payload,
+          requested_by, requested_at, decided_by, decided_at, decision_note,
+          created_at, updated_at
+        ) VALUES (
+          @id, @context_id, @task_id, @tenant, @type, @status, @summary, @payload,
+          @requested_by, @requested_at, @decided_by, @decided_at, @decision_note,
+          @created_at, @updated_at
+        )
+      `
+      ).run(this.toRow(approval));
+      this.emitChange({ type: "created", approval, timestamp: now });
+      return approval;
+    });
+  }
+  getById(id) {
+    return syncPromise(() => {
+      const row = this.db.prepare("SELECT * FROM approvals WHERE id = ?").get(id);
+      return row ? this.fromRow(row) : null;
+    });
+  }
+  list(contextId, options = {}) {
+    return syncPromise(() => {
+      const parts = ["context_id = @context_id"];
+      const params = { context_id: contextId };
+      if (options.status) {
+        parts.push("status = @status");
+        params.status = options.status;
+      }
+      if (options.tenant !== void 0) {
+        parts.push("tenant = @tenant");
+        params.tenant = options.tenant;
+      }
+      if (options.taskId) {
+        parts.push("task_id = @task_id");
+        params.task_id = options.taskId;
+      }
+      const rows = this.db.prepare(
+        `SELECT * FROM approvals WHERE ${parts.join(" AND ")} ORDER BY created_at DESC`
+      ).all(params);
+      return rows.map((row) => this.fromRow(row));
+    });
+  }
+  listAll(options = {}) {
+    return syncPromise(() => {
+      const parts = [];
+      const params = {};
+      if (options.contextId) {
+        parts.push("context_id = @context_id");
+        params.context_id = options.contextId;
+      }
+      if (options.status) {
+        parts.push("status = @status");
+        params.status = options.status;
+      }
+      if (options.tenant !== void 0) {
+        parts.push("tenant = @tenant");
+        params.tenant = options.tenant;
+      }
+      if (options.taskId) {
+        parts.push("task_id = @task_id");
+        params.task_id = options.taskId;
+      }
+      if (options.since) {
+        parts.push("updated_at >= @since");
+        params.since = options.since;
+      }
+      const where = parts.length > 0 ? `WHERE ${parts.join(" AND ")}` : "";
+      const limit = options.limit ?? -1;
+      const offset = options.offset ?? 0;
+      params.limit = limit;
+      params.offset = offset;
+      const rows = this.db.prepare(
+        `SELECT * FROM approvals ${where} ORDER BY created_at DESC LIMIT @limit OFFSET @offset`
+      ).all(params);
+      return rows.map((row) => this.fromRow(row));
+    });
+  }
+  subscribeAll(options = {}) {
+    return createApprovalChangeSubscription((listener) => {
+      this.listeners.add(listener);
+      return () => this.listeners.delete(listener);
+    }, options);
+  }
+  update(id, fields, options = {}) {
+    return syncPromise(() => {
+      const row = this.db.prepare("SELECT * FROM approvals WHERE id = ?").get(id);
+      if (!row) {
+        throw new Error(`Approval not found: ${id}`);
+      }
+      const existing = this.fromRow(row);
+      const updated = {
+        ...existing,
+        ...fields,
+        id: existing.id,
+        contextId: existing.contextId,
+        taskId: existing.taskId,
+        createdAt: existing.createdAt,
+        updatedAt: fields.updatedAt ?? nowIso()
+      };
+      const result = options.expectedStatus !== void 0 ? this.db.prepare(
+        `
+            UPDATE approvals SET
+              status = @status,
+              payload = @payload,
+              decided_by = @decided_by,
+              decided_at = @decided_at,
+              decision_note = @decision_note,
+              updated_at = @updated_at
+            WHERE id = @id AND status = @expected_status
+          `
+      ).run({
+        ...this.toRow(updated),
+        expected_status: options.expectedStatus
+      }) : this.db.prepare(
+        `
+            UPDATE approvals SET
+              status = @status,
+              payload = @payload,
+              decided_by = @decided_by,
+              decided_at = @decided_at,
+              decision_note = @decision_note,
+              updated_at = @updated_at
+            WHERE id = @id
+          `
+      ).run(this.toRow(updated));
+      if (options.expectedStatus !== void 0 && result.changes === 0) {
+        const currentRow = this.db.prepare("SELECT status FROM approvals WHERE id = ?").get(id);
+        throw new ApprovalConcurrencyError(
+          id,
+          options.expectedStatus,
+          currentRow?.status ?? "unknown"
+        );
+      }
+      this.emitChange({
+        type: "updated",
+        approval: updated,
+        previous: existing,
+        timestamp: updated.updatedAt
+      });
+      return updated;
+    });
+  }
+  deleteExpired(cutoffIso) {
+    return syncPromise(() => {
+      const result = this.db.prepare("DELETE FROM approvals WHERE updated_at < ?").run(cutoffIso);
+      return result.changes;
+    });
+  }
+  emitChange(event) {
+    const snapshot = {
+      ...event,
+      approval: { ...event.approval },
+      previous: event.previous ? { ...event.previous } : void 0
+    };
+    for (const listener of this.listeners) listener(snapshot);
+  }
+  close() {
+    return syncPromise(() => {
+      this.db.close();
+    });
+  }
+  toRow(approval) {
+    return {
+      id: approval.id,
+      context_id: approval.contextId,
+      task_id: approval.taskId,
+      tenant: approval.tenant ?? null,
+      type: approval.type,
+      status: approval.status,
+      summary: approval.summary,
+      payload: JSON.stringify(approval.payload),
+      requested_by: approval.requestedBy,
+      requested_at: approval.requestedAt,
+      decided_by: approval.decidedBy ?? null,
+      decided_at: approval.decidedAt ?? null,
+      decision_note: approval.decisionNote ?? null,
+      created_at: approval.createdAt,
+      updated_at: approval.updatedAt
+    };
+  }
+  fromRow(row) {
+    return {
+      id: row.id,
+      contextId: row.context_id,
+      taskId: row.task_id,
+      tenant: row.tenant ?? void 0,
+      type: row.type,
+      status: row.status,
+      summary: row.summary,
+      payload: JSON.parse(row.payload),
+      requestedBy: row.requested_by,
+      requestedAt: row.requested_at,
+      decidedBy: row.decided_by ?? void 0,
+      decidedAt: row.decided_at ?? void 0,
+      decisionNote: row.decision_note ?? void 0,
+      createdAt: row.created_at,
+      updatedAt: row.updated_at
+    };
+  }
+}
+export {
+  SqliteApprovalStore
+};
+//# sourceMappingURL=sqlite.js.map

package/dist/adapters/data/approval-store/sqlite.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/data/approval-store/sqlite.ts"],
+  "sourcesContent": ["import crypto from 'node:crypto';\n\nimport type BetterSqlite3 from 'better-sqlite3';\n\nimport { ApprovalConcurrencyError } from '../../../domain/errors/index.js';\nimport { syncPromise } from '../../../utils/sync-promise.js';\nimport { nowIso } from '../../../utils/time.js';\nimport { createSqliteDb } from '../sqlite-helpers.js';\nimport { createApprovalChangeSubscription } from './change-feed.js';\nimport type {\n  Approval,\n  ApprovalChangeEvent,\n  ApprovalStatus,\n  ApprovalStore,\n  ListAllApprovalsOptions,\n  ListApprovalsOptions,\n} from './types.js';\n\ninterface ApprovalRow {\n  id: string;\n  context_id: string;\n  task_id: string;\n  tenant: string | null;\n  type: string;\n  status: string;\n  summary: string;\n  payload: string;\n  requested_by: string;\n  requested_at: string;\n  decided_by: string | null;\n  decided_at: string | null;\n  decision_note: string | null;\n  created_at: string;\n  updated_at: string;\n}\n\ninterface SqliteApprovalStoreOptions {\n  path?: string;\n  busyTimeoutMs?: number;\n}\n\nexport class SqliteApprovalStore implements ApprovalStore {\n  private readonly db: BetterSqlite3.Database;\n  private readonly listeners = new Set<(event: ApprovalChangeEvent) => void>();\n\n  constructor(options: SqliteApprovalStoreOptions = {}) {\n    this.db = createSqliteDb(options);\n\n    this.db.exec(`\n      CREATE TABLE IF NOT EXISTS approvals (\n        id           TEXT PRIMARY KEY,\n        context_id   TEXT NOT NULL,\n        task_id      TEXT NOT NULL,\n        tenant       TEXT,\n        type         TEXT NOT NULL,\n        status       TEXT NOT NULL DEFAULT 'pending',\n        summary      TEXT NOT NULL,\n        payload      TEXT NOT NULL DEFAULT '{}',\n        requested_by TEXT NOT NULL,\n        requested_at TEXT NOT NULL,\n        decided_by   TEXT,\n        decided_at   TEXT,\n        decision_note TEXT,\n        created_at   TEXT NOT NULL,\n        updated_at   TEXT NOT NULL\n      );\n\n      CREATE INDEX IF NOT EXISTS approvals_context ON approvals(context_id);\n      CREATE INDEX IF NOT EXISTS approvals_task    ON approvals(task_id);\n      CREATE INDEX IF NOT EXISTS approvals_status  ON approvals(status);\n    `);\n  }\n\n  create(\n    input: Omit<Approval, 'id' | 'createdAt' | 'updatedAt'>\n  ): Promise<Approval> {\n    return syncPromise(() => {\n      const now = nowIso();\n      const approval: Approval = {\n        ...input,\n        id: crypto.randomUUID(),\n        createdAt: now,\n        updatedAt: now,\n      };\n\n      this.db\n        .prepare(\n          `\n        INSERT INTO approvals (\n          id, context_id, task_id, tenant, type, status, summary, payload,\n          requested_by, requested_at, decided_by, decided_at, decision_note,\n          created_at, updated_at\n        ) VALUES (\n          @id, @context_id, @task_id, @tenant, @type, @status, @summary, @payload,\n          @requested_by, @requested_at, @decided_by, @decided_at, @decision_note,\n          @created_at, @updated_at\n        )\n      `\n        )\n        .run(this.toRow(approval));\n\n      this.emitChange({ type: 'created', approval, timestamp: now });\n      return approval;\n    });\n  }\n\n  getById(id: string): Promise<Approval | null> {\n    return syncPromise(() => {\n      const row = this.db\n        .prepare('SELECT * FROM approvals WHERE id = ?')\n        .get(id) as ApprovalRow | undefined;\n      return row ? this.fromRow(row) : null;\n    });\n  }\n\n  list(\n    contextId: string,\n    options: ListApprovalsOptions = {}\n  ): Promise<Approval[]> {\n    return syncPromise(() => {\n      const parts = ['context_id = @context_id'];\n      const params: Record<string, string> = { context_id: contextId };\n\n      if (options.status) {\n        parts.push('status = @status');\n        params.status = options.status;\n      }\n      if (options.tenant !== undefined) {\n        parts.push('tenant = @tenant');\n        params.tenant = options.tenant;\n      }\n      if (options.taskId) {\n        parts.push('task_id = @task_id');\n        params.task_id = options.taskId;\n      }\n\n      const rows = this.db\n        .prepare(\n          `SELECT * FROM approvals WHERE ${parts.join(' AND ')} ORDER BY created_at DESC`\n        )\n        .all(params) as ApprovalRow[];\n\n      return rows.map((row) => this.fromRow(row));\n    });\n  }\n\n  listAll(options: ListAllApprovalsOptions = {}): Promise<Approval[]> {\n    return syncPromise(() => {\n      const parts: string[] = [];\n      const params: Record<string, string | number> = {};\n\n      if (options.contextId) {\n        parts.push('context_id = @context_id');\n        params.context_id = options.contextId;\n      }\n      if (options.status) {\n        parts.push('status = @status');\n        params.status = options.status;\n      }\n      if (options.tenant !== undefined) {\n        parts.push('tenant = @tenant');\n        params.tenant = options.tenant;\n      }\n      if (options.taskId) {\n        parts.push('task_id = @task_id');\n        params.task_id = options.taskId;\n      }\n      if (options.since) {\n        parts.push('updated_at >= @since');\n        params.since = options.since;\n      }\n\n      const where = parts.length > 0 ? `WHERE ${parts.join(' AND ')}` : '';\n      const limit = options.limit ?? -1;\n      const offset = options.offset ?? 0;\n      params.limit = limit;\n      params.offset = offset;\n\n      const rows = this.db\n        .prepare(\n          `SELECT * FROM approvals ${where} ORDER BY created_at DESC LIMIT @limit OFFSET @offset`\n        )\n        .all(params) as ApprovalRow[];\n\n      return rows.map((row) => this.fromRow(row));\n    });\n  }\n\n  subscribeAll(\n    options: ListAllApprovalsOptions = {}\n  ): AsyncIterable<ApprovalChangeEvent> {\n    return createApprovalChangeSubscription((listener) => {\n      this.listeners.add(listener);\n      return () => this.listeners.delete(listener);\n    }, options);\n  }\n\n  update(\n    id: string,\n    fields: Partial<\n      Pick<\n        Approval,\n        | 'status'\n        | 'decidedBy'\n        | 'decidedAt'\n        | 'decisionNote'\n        | 'payload'\n        | 'updatedAt'\n      >\n    >,\n    options: { expectedStatus?: ApprovalStatus } = {}\n  ): Promise<Approval> {\n    return syncPromise(() => {\n      const row = this.db\n        .prepare('SELECT * FROM approvals WHERE id = ?')\n        .get(id) as ApprovalRow | undefined;\n      if (!row) {\n        throw new Error(`Approval not found: ${id}`);\n      }\n      const existing = this.fromRow(row);\n\n      const updated: Approval = {\n        ...existing,\n        ...fields,\n        id: existing.id,\n        contextId: existing.contextId,\n        taskId: existing.taskId,\n        createdAt: existing.createdAt,\n        updatedAt: fields.updatedAt ?? nowIso(),\n      };\n\n      const result =\n        options.expectedStatus !== undefined\n          ? this.db\n              .prepare(\n                `\n            UPDATE approvals SET\n              status = @status,\n              payload = @payload,\n              decided_by = @decided_by,\n              decided_at = @decided_at,\n              decision_note = @decision_note,\n              updated_at = @updated_at\n            WHERE id = @id AND status = @expected_status\n          `\n              )\n              .run({\n                ...this.toRow(updated),\n                expected_status: options.expectedStatus,\n              })\n          : this.db\n              .prepare(\n                `\n            UPDATE approvals SET\n              status = @status,\n              payload = @payload,\n              decided_by = @decided_by,\n              decided_at = @decided_at,\n              decision_note = @decision_note,\n              updated_at = @updated_at\n            WHERE id = @id\n          `\n              )\n              .run(this.toRow(updated));\n\n      if (options.expectedStatus !== undefined && result.changes === 0) {\n        const currentRow = this.db\n          .prepare('SELECT status FROM approvals WHERE id = ?')\n          .get(id) as { status: string } | undefined;\n        throw new ApprovalConcurrencyError(\n          id,\n          options.expectedStatus,\n          currentRow?.status ?? 'unknown'\n        );\n      }\n\n      this.emitChange({\n        type: 'updated',\n        approval: updated,\n        previous: existing,\n        timestamp: updated.updatedAt,\n      });\n      return updated;\n    });\n  }\n\n  deleteExpired(cutoffIso: string): Promise<number> {\n    return syncPromise(() => {\n      const result = this.db\n        .prepare('DELETE FROM approvals WHERE updated_at < ?')\n        .run(cutoffIso);\n      return result.changes;\n    });\n  }\n\n  private emitChange(event: ApprovalChangeEvent): void {\n    const snapshot: ApprovalChangeEvent = {\n      ...event,\n      approval: { ...event.approval },\n      previous: event.previous ? { ...event.previous } : undefined,\n    };\n    for (const listener of this.listeners) listener(snapshot);\n  }\n\n  close(): Promise<void> {\n    return syncPromise(() => {\n      this.db.close();\n    });\n  }\n\n  private toRow(approval: Approval): Record<string, string | null> {\n    return {\n      id: approval.id,\n      context_id: approval.contextId,\n      task_id: approval.taskId,\n      tenant: approval.tenant ?? null,\n      type: approval.type,\n      status: approval.status,\n      summary: approval.summary,\n      payload: JSON.stringify(approval.payload),\n      requested_by: approval.requestedBy,\n      requested_at: approval.requestedAt,\n      decided_by: approval.decidedBy ?? null,\n      decided_at: approval.decidedAt ?? null,\n      decision_note: approval.decisionNote ?? null,\n      created_at: approval.createdAt,\n      updated_at: approval.updatedAt,\n    };\n  }\n\n  private fromRow(row: ApprovalRow): Approval {\n    return {\n      id: row.id,\n      contextId: row.context_id,\n      taskId: row.task_id,\n      tenant: row.tenant ?? undefined,\n      type: row.type as Approval['type'],\n      status: row.status as Approval['status'],\n      summary: row.summary,\n      payload: JSON.parse(row.payload) as Record<string, unknown>,\n      requestedBy: row.requested_by,\n      requestedAt: row.requested_at,\n      decidedBy: row.decided_by ?? undefined,\n      decidedAt: row.decided_at ?? undefined,\n      decisionNote: row.decision_note ?? undefined,\n      createdAt: row.created_at,\n      updatedAt: row.updated_at,\n    };\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/adapters/data/approval-store/types.d.ts

@@ -0,0 +1,91 @@
+import type { PolicySubject } from '../../../policy/index.js';
+export type ApprovalStatus = 'pending' | 'approved' | 'rejected' | 'revision-requested';
+export type ApprovalType = 'tool-call' | 'plan-review' | 'escalation' | 'custom';
+export interface Approval {
+    id: string;
+    contextId: string;
+    taskId: string;
+    tenant?: string;
+    type: ApprovalType;
+    status: ApprovalStatus;
+    summary: string;
+    payload: Record<string, unknown>;
+    requestedBy: string;
+    requestedAt: string;
+    decidedBy?: string;
+    decidedAt?: string;
+    decisionNote?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export type ApprovalChangeType = 'created' | 'updated' | 'deleted';
+export interface ApprovalChangeEvent {
+    type: ApprovalChangeType;
+    approval: Approval;
+    previous?: Approval;
+    timestamp: string;
+}
+export interface ApprovalResolution {
+    decision: 'approved' | 'rejected' | 'revision-requested';
+    decidedBy: string;
+    note?: string;
+    subject?: PolicySubject;
+}
+export interface RequestApprovalParams {
+    contextId: string;
+    taskId: string;
+    subject?: PolicySubject;
+    tenant?: string;
+    type: ApprovalType;
+    summary: string;
+    payload?: Record<string, unknown>;
+    requestedBy: string;
+}
+export interface ListApprovalsOptions {
+    status?: ApprovalStatus;
+    subject?: PolicySubject;
+    taskId?: string;
+    tenant?: string;
+}
+/**
+ * Cross-context listing for inbox-style consumers. `contextId` is optional
+ * here (presence narrows results); pagination + ISO `since` cursor allow
+ * scanning across long-lived deployments without loading the full table.
+ */
+export interface ListAllApprovalsOptions extends ListApprovalsOptions {
+    contextId?: string;
+    limit?: number;
+    offset?: number;
+    /** Inclusive ISO timestamp; only approvals updated at-or-after are returned. */
+    since?: string;
+}
+export interface ApprovalStore {
+    create(input: Omit<Approval, 'id' | 'createdAt' | 'updatedAt'>): Promise<Approval>;
+    getById(id: string): Promise<Approval | null>;
+    list(contextId: string, options?: ListApprovalsOptions): Promise<Approval[]>;
+    /**
+     * Cross-context listing. Optional capability — implementations that don't
+     * support efficient global scans may omit it. Callers should treat absence
+     * as "store does not support inbox-style aggregation".
+     */
+    listAll?(options?: ListAllApprovalsOptions): Promise<Approval[]>;
+    /**
+     * Optional in-process change feed for inbox consumers. Implementations may
+     * pair this with `listAll({ since })` replay for durable/cross-process UIs.
+     */
+    subscribeAll?(options?: ListAllApprovalsOptions): AsyncIterable<ApprovalChangeEvent>;
+    /**
+     * Apply field updates to an approval.
+     *
+     * Pass `options.expectedStatus` for compare-and-swap semantics: the write
+     * is rejected with `ApprovalConcurrencyError` when the stored status no
+     * longer matches. Implementations should enforce this atomically; absence
+     * disables the check (back-compat for adapters that pre-date this option).
+     */
+    update(id: string, fields: Partial<Pick<Approval, 'status' | 'decidedBy' | 'decidedAt' | 'decisionNote' | 'payload' | 'updatedAt'>>, options?: {
+        expectedStatus?: ApprovalStatus;
+    }): Promise<Approval>;
+    deleteExpired?(cutoffIso: string): Promise<number>;
+    close?(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/data/approval-store/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/adapters/data/approval-store/types.ts"],"names":[],"mappings":"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"}

package/dist/adapters/data/approval-store/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/adapters/data/approval-store/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/dist/adapters/data/budget/cost-accumulator.d.ts

@@ -0,0 +1,74 @@
+import type { UsageStats } from '../../../domain/contracts/messages.js';
+import { type CostSource, type TokenCostTable } from '../../../domain/cost-estimation.js';
+export interface BudgetLimit {
+    scope: 'context' | 'tenant' | 'task';
+    softThresholdUsd?: number;
+    hardLimitUsd: number;
+}
+export interface BudgetOptions {
+    enabled?: boolean;
+    limits: BudgetLimit[];
+    onSoftThreshold?: (info: BudgetInfo) => void;
+    onHardLimit?: (info: BudgetInfo) => void;
+    /** Default token cost table for backends that report tokens but not USD. */
+    tokenCosts?: TokenCostTable;
+    /** Fire at multiple percentage thresholds (e.g. [0.6, 0.8, 0.9]). */
+    softThresholds?: number[];
+    /** Rehydrate accumulated spend from TaskStore history on construction. */
+    durable?: boolean;
+}
+export interface BudgetInfo {
+    contextId: string;
+    tenant?: string;
+    scope: 'context' | 'tenant' | 'task';
+    taskId?: string;
+    spentUsd: number;
+    limitUsd: number;
+    percentUsed: number;
+    costSource: CostSource;
+}
+export type BudgetCheckResult = {
+    status: 'ok';
+} | {
+    status: 'soft-threshold';
+    info: BudgetInfo;
+} | {
+    status: 'hard-limit';
+    info: BudgetInfo;
+};
+export type { TokenCostTable };
+export declare class CostAccumulator {
+    private readonly contextSpend;
+    private readonly tenantSpend;
+    private readonly taskSpend;
+    private readonly limits;
+    private readonly tokenCosts;
+    private readonly onSoftThreshold?;
+    private readonly onHardLimit?;
+    private readonly softThresholds;
+    /** Tracks which scope+key+threshold combos have fired. */
+    private readonly softThresholdFired;
+    constructor(options: BudgetOptions);
+    record(contextId: string, tenant: string | undefined, costUsd: number | null, usage: UsageStats | null, model?: string, taskId?: string): void;
+    getSpend(contextId: string): {
+        totalUsd: number;
+        totalTokens: number;
+        inputTokens: number;
+        outputTokens: number;
+    };
+    getTotalSpend(): {
+        totalUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+    };
+    getSpendByTenant(tenant: string): {
+        totalUsd: number;
+        totalTokens: number;
+    };
+    checkBudget(contextId: string, tenant?: string, taskId?: string): BudgetCheckResult;
+    reset(contextId: string): void;
+    resetTask(taskId: string): void;
+    updateLimit(scope: 'context' | 'tenant', newLimit: Partial<BudgetLimit>): void;
+    private addSpend;
+}
+//# sourceMappingURL=cost-accumulator.d.ts.map

package/dist/adapters/data/budget/cost-accumulator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-accumulator.d.ts","sourceRoot":"","sources":["../../../../src/adapters/data/budget/cost-accumulator.ts"],"names":[],"mappings":"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"}

package/dist/adapters/data/budget/cost-accumulator.js

@@ -0,0 +1,157 @@
+import {
+  DEFAULT_TOKEN_COSTS,
+  estimateTokenCost
+} from "../../../domain/cost-estimation.js";
+class CostAccumulator {
+  contextSpend = /* @__PURE__ */ new Map();
+  tenantSpend = /* @__PURE__ */ new Map();
+  taskSpend = /* @__PURE__ */ new Map();
+  limits;
+  tokenCosts;
+  onSoftThreshold;
+  onHardLimit;
+  softThresholds;
+  /** Tracks which scope+key+threshold combos have fired. */
+  softThresholdFired = /* @__PURE__ */ new Set();
+  constructor(options) {
+    this.limits = options.limits;
+    this.tokenCosts = { ...DEFAULT_TOKEN_COSTS, ...options.tokenCosts };
+    this.onSoftThreshold = options.onSoftThreshold;
+    this.onHardLimit = options.onHardLimit;
+    this.softThresholds = options.softThresholds ?? [];
+  }
+  record(contextId, tenant, costUsd, usage, model, taskId) {
+    const estimated = estimateTokenCost(
+      costUsd,
+      usage,
+      model,
+      this.tokenCosts
+    );
+    this.addSpend(this.contextSpend, contextId, estimated);
+    if (tenant) {
+      this.addSpend(this.tenantSpend, tenant, estimated);
+    }
+    if (taskId) {
+      this.addSpend(this.taskSpend, taskId, estimated);
+    }
+  }
+  getSpend(contextId) {
+    const record = this.contextSpend.get(contextId);
+    if (!record) {
+      return { totalUsd: 0, totalTokens: 0, inputTokens: 0, outputTokens: 0 };
+    }
+    return {
+      totalUsd: record.totalUsd,
+      totalTokens: record.totalInputTokens + record.totalOutputTokens,
+      inputTokens: record.totalInputTokens,
+      outputTokens: record.totalOutputTokens
+    };
+  }
+  getTotalSpend() {
+    let totalUsd = 0;
+    let inputTokens = 0;
+    let outputTokens = 0;
+    for (const r of this.contextSpend.values()) {
+      totalUsd += r.totalUsd;
+      inputTokens += r.totalInputTokens;
+      outputTokens += r.totalOutputTokens;
+    }
+    return { totalUsd, inputTokens, outputTokens };
+  }
+  getSpendByTenant(tenant) {
+    const record = this.tenantSpend.get(tenant);
+    if (!record) return { totalUsd: 0, totalTokens: 0 };
+    return {
+      totalUsd: record.totalUsd,
+      totalTokens: record.totalInputTokens + record.totalOutputTokens
+    };
+  }
+  checkBudget(contextId, tenant, taskId) {
+    for (const limit of this.limits) {
+      const key = limit.scope === "context" ? contextId : limit.scope === "tenant" ? tenant : taskId;
+      if (!key) continue;
+      const spendMap = limit.scope === "context" ? this.contextSpend : limit.scope === "tenant" ? this.tenantSpend : this.taskSpend;
+      const record = spendMap.get(key);
+      if (!record) continue;
+      const info = {
+        contextId,
+        tenant,
+        scope: limit.scope,
+        taskId,
+        spentUsd: record.totalUsd,
+        limitUsd: limit.hardLimitUsd,
+        percentUsed: record.totalUsd / limit.hardLimitUsd * 100,
+        costSource: record.costSource
+      };
+      if (record.totalUsd >= limit.hardLimitUsd) {
+        this.onHardLimit?.(info);
+        return { status: "hard-limit", info };
+      }
+      const thresholds = [
+        ...this.softThresholds,
+        ...limit.softThresholdUsd ? [limit.softThresholdUsd / limit.hardLimitUsd] : []
+      ].sort((a, b) => a - b);
+      for (const threshold of thresholds) {
+        const thresholdUsd = threshold * limit.hardLimitUsd;
+        const fireKey = `${limit.scope}:${key}:${threshold}`;
+        if (record.totalUsd >= thresholdUsd && !this.softThresholdFired.has(fireKey)) {
+          this.softThresholdFired.add(fireKey);
+          this.onSoftThreshold?.(info);
+          return { status: "soft-threshold", info };
+        }
+      }
+    }
+    return { status: "ok" };
+  }
+  reset(contextId) {
+    this.contextSpend.delete(contextId);
+    for (const key of this.softThresholdFired) {
+      if (key.startsWith(`context:${contextId}`)) {
+        this.softThresholdFired.delete(key);
+      }
+    }
+  }
+  resetTask(taskId) {
+    this.taskSpend.delete(taskId);
+    for (const key of this.softThresholdFired) {
+      if (key.startsWith(`task:${taskId}`)) {
+        this.softThresholdFired.delete(key);
+      }
+    }
+  }
+  updateLimit(scope, newLimit) {
+    const existing = this.limits.find((l) => l.scope === scope);
+    if (existing) {
+      if (newLimit.hardLimitUsd !== void 0) {
+        existing.hardLimitUsd = newLimit.hardLimitUsd;
+      }
+      if (newLimit.softThresholdUsd !== void 0) {
+        existing.softThresholdUsd = newLimit.softThresholdUsd;
+      }
+    }
+  }
+  addSpend(map, key, cost) {
+    const existing = map.get(key);
+    if (existing) {
+      existing.totalUsd += cost.usd;
+      existing.totalInputTokens += cost.inputTokens;
+      existing.totalOutputTokens += cost.outputTokens;
+      if (cost.source === "reported") {
+        existing.costSource = "reported";
+      } else if (existing.costSource === "unknown" && cost.source === "estimated") {
+        existing.costSource = "estimated";
+      }
+    } else {
+      map.set(key, {
+        totalUsd: cost.usd,
+        totalInputTokens: cost.inputTokens,
+        totalOutputTokens: cost.outputTokens,
+        costSource: cost.source
+      });
+    }
+  }
+}
+export {
+  CostAccumulator
+};
+//# sourceMappingURL=cost-accumulator.js.map

package/dist/adapters/data/budget/cost-accumulator.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/adapters/data/budget/cost-accumulator.ts"],
+  "sourcesContent": ["import type { UsageStats } from '../../../domain/contracts/messages.js';\nimport {\n  type CostSource,\n  DEFAULT_TOKEN_COSTS,\n  estimateTokenCost,\n  type TokenCostTable,\n} from '../../../domain/cost-estimation.js';\n\nexport interface BudgetLimit {\n  scope: 'context' | 'tenant' | 'task';\n  softThresholdUsd?: number;\n  hardLimitUsd: number;\n}\n\nexport interface BudgetOptions {\n  enabled?: boolean;\n  limits: BudgetLimit[];\n  onSoftThreshold?: (info: BudgetInfo) => void;\n  onHardLimit?: (info: BudgetInfo) => void;\n  /** Default token cost table for backends that report tokens but not USD. */\n  tokenCosts?: TokenCostTable;\n  /** Fire at multiple percentage thresholds (e.g. [0.6, 0.8, 0.9]). */\n  softThresholds?: number[];\n  /** Rehydrate accumulated spend from TaskStore history on construction. */\n  durable?: boolean;\n}\n\nexport interface BudgetInfo {\n  contextId: string;\n  tenant?: string;\n  scope: 'context' | 'tenant' | 'task';\n  taskId?: string;\n  spentUsd: number;\n  limitUsd: number;\n  percentUsed: number;\n  costSource: CostSource;\n}\n\nexport type BudgetCheckResult =\n  | { status: 'ok' }\n  | { status: 'soft-threshold'; info: BudgetInfo }\n  | { status: 'hard-limit'; info: BudgetInfo };\n\nexport type { TokenCostTable };\n\ninterface SpendRecord {\n  totalUsd: number;\n  totalInputTokens: number;\n  totalOutputTokens: number;\n  costSource: CostSource;\n}\n\nexport class CostAccumulator {\n  private readonly contextSpend = new Map<string, SpendRecord>();\n  private readonly tenantSpend = new Map<string, SpendRecord>();\n  private readonly taskSpend = new Map<string, SpendRecord>();\n  private readonly limits: BudgetLimit[];\n  private readonly tokenCosts: TokenCostTable;\n  private readonly onSoftThreshold?: (info: BudgetInfo) => void;\n  private readonly onHardLimit?: (info: BudgetInfo) => void;\n  private readonly softThresholds: number[];\n  /** Tracks which scope+key+threshold combos have fired. */\n  private readonly softThresholdFired = new Set<string>();\n\n  constructor(options: BudgetOptions) {\n    this.limits = options.limits;\n    this.tokenCosts = { ...DEFAULT_TOKEN_COSTS, ...options.tokenCosts };\n    this.onSoftThreshold = options.onSoftThreshold;\n    this.onHardLimit = options.onHardLimit;\n    this.softThresholds = options.softThresholds ?? [];\n  }\n\n  record(\n    contextId: string,\n    tenant: string | undefined,\n    costUsd: number | null,\n    usage: UsageStats | null,\n    model?: string,\n    taskId?: string\n  ): void {\n    const estimated = estimateTokenCost(\n      costUsd,\n      usage,\n      model,\n      this.tokenCosts\n    );\n    this.addSpend(this.contextSpend, contextId, estimated);\n    if (tenant) {\n      this.addSpend(this.tenantSpend, tenant, estimated);\n    }\n    if (taskId) {\n      this.addSpend(this.taskSpend, taskId, estimated);\n    }\n  }\n\n  getSpend(contextId: string): {\n    totalUsd: number;\n    totalTokens: number;\n    inputTokens: number;\n    outputTokens: number;\n  } {\n    const record = this.contextSpend.get(contextId);\n    if (!record) {\n      return { totalUsd: 0, totalTokens: 0, inputTokens: 0, outputTokens: 0 };\n    }\n    return {\n      totalUsd: record.totalUsd,\n      totalTokens: record.totalInputTokens + record.totalOutputTokens,\n      inputTokens: record.totalInputTokens,\n      outputTokens: record.totalOutputTokens,\n    };\n  }\n\n  getTotalSpend(): {\n    totalUsd: number;\n    inputTokens: number;\n    outputTokens: number;\n  } {\n    let totalUsd = 0;\n    let inputTokens = 0;\n    let outputTokens = 0;\n    for (const r of this.contextSpend.values()) {\n      totalUsd += r.totalUsd;\n      inputTokens += r.totalInputTokens;\n      outputTokens += r.totalOutputTokens;\n    }\n    return { totalUsd, inputTokens, outputTokens };\n  }\n\n  getSpendByTenant(tenant: string): { totalUsd: number; totalTokens: number } {\n    const record = this.tenantSpend.get(tenant);\n    if (!record) return { totalUsd: 0, totalTokens: 0 };\n    return {\n      totalUsd: record.totalUsd,\n      totalTokens: record.totalInputTokens + record.totalOutputTokens,\n    };\n  }\n\n  checkBudget(\n    contextId: string,\n    tenant?: string,\n    taskId?: string\n  ): BudgetCheckResult {\n    for (const limit of this.limits) {\n      const key =\n        limit.scope === 'context'\n          ? contextId\n          : limit.scope === 'tenant'\n            ? tenant\n            : taskId;\n      if (!key) continue;\n      const spendMap =\n        limit.scope === 'context'\n          ? this.contextSpend\n          : limit.scope === 'tenant'\n            ? this.tenantSpend\n            : this.taskSpend;\n      const record = spendMap.get(key);\n      if (!record) continue;\n\n      const info: BudgetInfo = {\n        contextId,\n        tenant,\n        scope: limit.scope,\n        taskId,\n        spentUsd: record.totalUsd,\n        limitUsd: limit.hardLimitUsd,\n        percentUsed: (record.totalUsd / limit.hardLimitUsd) * 100,\n        costSource: record.costSource,\n      };\n\n      if (record.totalUsd >= limit.hardLimitUsd) {\n        this.onHardLimit?.(info);\n        return { status: 'hard-limit', info };\n      }\n\n      const thresholds = [\n        ...this.softThresholds,\n        ...(limit.softThresholdUsd\n          ? [limit.softThresholdUsd / limit.hardLimitUsd]\n          : []),\n      ].sort((a, b) => a - b);\n\n      for (const threshold of thresholds) {\n        const thresholdUsd = threshold * limit.hardLimitUsd;\n        const fireKey = `${limit.scope}:${key}:${threshold}`;\n        if (\n          record.totalUsd >= thresholdUsd &&\n          !this.softThresholdFired.has(fireKey)\n        ) {\n          this.softThresholdFired.add(fireKey);\n          this.onSoftThreshold?.(info);\n          return { status: 'soft-threshold', info };\n        }\n      }\n    }\n    return { status: 'ok' };\n  }\n\n  reset(contextId: string): void {\n    this.contextSpend.delete(contextId);\n    for (const key of this.softThresholdFired) {\n      if (key.startsWith(`context:${contextId}`)) {\n        this.softThresholdFired.delete(key);\n      }\n    }\n  }\n\n  resetTask(taskId: string): void {\n    this.taskSpend.delete(taskId);\n    for (const key of this.softThresholdFired) {\n      if (key.startsWith(`task:${taskId}`)) {\n        this.softThresholdFired.delete(key);\n      }\n    }\n  }\n\n  updateLimit(\n    scope: 'context' | 'tenant',\n    newLimit: Partial<BudgetLimit>\n  ): void {\n    const existing = this.limits.find((l) => l.scope === scope);\n    if (existing) {\n      if (newLimit.hardLimitUsd !== undefined) {\n        existing.hardLimitUsd = newLimit.hardLimitUsd;\n      }\n      if (newLimit.softThresholdUsd !== undefined) {\n        existing.softThresholdUsd = newLimit.softThresholdUsd;\n      }\n    }\n  }\n\n  private addSpend(\n    map: Map<string, SpendRecord>,\n    key: string,\n    cost: {\n      usd: number;\n      inputTokens: number;\n      outputTokens: number;\n      source: BudgetInfo['costSource'];\n    }\n  ): void {\n    const existing = map.get(key);\n    if (existing) {\n      existing.totalUsd += cost.usd;\n      existing.totalInputTokens += cost.inputTokens;\n      existing.totalOutputTokens += cost.outputTokens;\n      if (cost.source === 'reported') {\n        existing.costSource = 'reported';\n      } else if (\n        existing.costSource === 'unknown' &&\n        cost.source === 'estimated'\n      ) {\n        existing.costSource = 'estimated';\n      }\n    } else {\n      map.set(key, {\n        totalUsd: cost.usd,\n        totalInputTokens: cost.inputTokens,\n        totalOutputTokens: cost.outputTokens,\n        costSource: cost.source,\n      });\n    }\n  }\n}\n"],
+  "mappings": "AACA;AAAA,EAEE;AAAA,EACA;AAAA,OAEK;AA8CA,MAAM,gBAAgB;AAAA,EACV,eAAe,oBAAI,IAAyB;AAAA,EAC5C,cAAc,oBAAI,IAAyB;AAAA,EAC3C,YAAY,oBAAI,IAAyB;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA,qBAAqB,oBAAI,IAAY;AAAA,EAEtD,YAAY,SAAwB;AAClC,SAAK,SAAS,QAAQ;AACtB,SAAK,aAAa,EAAE,GAAG,qBAAqB,GAAG,QAAQ,WAAW;AAClE,SAAK,kBAAkB,QAAQ;AAC/B,SAAK,cAAc,QAAQ;AAC3B,SAAK,iBAAiB,QAAQ,kBAAkB,CAAC;AAAA,EACnD;AAAA,EAEA,OACE,WACA,QACA,SACA,OACA,OACA,QACM;AACN,UAAM,YAAY;AAAA,MAChB;AAAA,MACA;AAAA,MACA;AAAA,MACA,KAAK;AAAA,IACP;AACA,SAAK,SAAS,KAAK,cAAc,WAAW,SAAS;AACrD,QAAI,QAAQ;AACV,WAAK,SAAS,KAAK,aAAa,QAAQ,SAAS;AAAA,IACnD;AACA,QAAI,QAAQ;AACV,WAAK,SAAS,KAAK,WAAW,QAAQ,SAAS;AAAA,IACjD;AAAA,EACF;AAAA,EAEA,SAAS,WAKP;AACA,UAAM,SAAS,KAAK,aAAa,IAAI,SAAS;AAC9C,QAAI,CAAC,QAAQ;AACX,aAAO,EAAE,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,cAAc,EAAE;AAAA,IACxE;AACA,WAAO;AAAA,MACL,UAAU,OAAO;AAAA,MACjB,aAAa,OAAO,mBAAmB,OAAO;AAAA,MAC9C,aAAa,OAAO;AAAA,MACpB,cAAc,OAAO;AAAA,IACvB;AAAA,EACF;AAAA,EAEA,gBAIE;AACA,QAAI,WAAW;AACf,QAAI,cAAc;AAClB,QAAI,eAAe;AACnB,eAAW,KAAK,KAAK,aAAa,OAAO,GAAG;AAC1C,kBAAY,EAAE;AACd,qBAAe,EAAE;AACjB,sBAAgB,EAAE;AAAA,IACpB;AACA,WAAO,EAAE,UAAU,aAAa,aAAa;AAAA,EAC/C;AAAA,EAEA,iBAAiB,QAA2D;AAC1E,UAAM,SAAS,KAAK,YAAY,IAAI,MAAM;AAC1C,QAAI,CAAC,OAAQ,QAAO,EAAE,UAAU,GAAG,aAAa,EAAE;AAClD,WAAO;AAAA,MACL,UAAU,OAAO;AAAA,MACjB,aAAa,OAAO,mBAAmB,OAAO;AAAA,IAChD;AAAA,EACF;AAAA,EAEA,YACE,WACA,QACA,QACmB;AACnB,eAAW,SAAS,KAAK,QAAQ;AAC/B,YAAM,MACJ,MAAM,UAAU,YACZ,YACA,MAAM,UAAU,WACd,SACA;AACR,UAAI,CAAC,IAAK;AACV,YAAM,WACJ,MAAM,UAAU,YACZ,KAAK,eACL,MAAM,UAAU,WACd,KAAK,cACL,KAAK;AACb,YAAM,SAAS,SAAS,IAAI,GAAG;AAC/B,UAAI,CAAC,OAAQ;AAEb,YAAM,OAAmB;AAAA,QACvB;AAAA,QACA;AAAA,QACA,OAAO,MAAM;AAAA,QACb;AAAA,QACA,UAAU,OAAO;AAAA,QACjB,UAAU,MAAM;AAAA,QAChB,aAAc,OAAO,WAAW,MAAM,eAAgB;AAAA,QACtD,YAAY,OAAO;AAAA,MACrB;AAEA,UAAI,OAAO,YAAY,MAAM,cAAc;AACzC,aAAK,cAAc,IAAI;AACvB,eAAO,EAAE,QAAQ,cAAc,KAAK;AAAA,MACtC;AAEA,YAAM,aAAa;AAAA,QACjB,GAAG,KAAK;AAAA,QACR,GAAI,MAAM,mBACN,CAAC,MAAM,mBAAmB,MAAM,YAAY,IAC5C,CAAC;AAAA,MACP,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC;AAEtB,iBAAW,aAAa,YAAY;AAClC,cAAM,eAAe,YAAY,MAAM;AACvC,cAAM,UAAU,GAAG,MAAM,KAAK,IAAI,GAAG,IAAI,SAAS;AAClD,YACE,OAAO,YAAY,gBACnB,CAAC,KAAK,mBAAmB,IAAI,OAAO,GACpC;AACA,eAAK,mBAAmB,IAAI,OAAO;AACnC,eAAK,kBAAkB,IAAI;AAC3B,iBAAO,EAAE,QAAQ,kBAAkB,KAAK;AAAA,QAC1C;AAAA,MACF;AAAA,IACF;AACA,WAAO,EAAE,QAAQ,KAAK;AAAA,EACxB;AAAA,EAEA,MAAM,WAAyB;AAC7B,SAAK,aAAa,OAAO,SAAS;AAClC,eAAW,OAAO,KAAK,oBAAoB;AACzC,UAAI,IAAI,WAAW,WAAW,SAAS,EAAE,GAAG;AAC1C,aAAK,mBAAmB,OAAO,GAAG;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAAA,EAEA,UAAU,QAAsB;AAC9B,SAAK,UAAU,OAAO,MAAM;AAC5B,eAAW,OAAO,KAAK,oBAAoB;AACzC,UAAI,IAAI,WAAW,QAAQ,MAAM,EAAE,GAAG;AACpC,aAAK,mBAAmB,OAAO,GAAG;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAAA,EAEA,YACE,OACA,UACM;AACN,UAAM,WAAW,KAAK,OAAO,KAAK,CAAC,MAAM,EAAE,UAAU,KAAK;AAC1D,QAAI,UAAU;AACZ,UAAI,SAAS,iBAAiB,QAAW;AACvC,iBAAS,eAAe,SAAS;AAAA,MACnC;AACA,UAAI,SAAS,qBAAqB,QAAW;AAC3C,iBAAS,mBAAmB,SAAS;AAAA,MACvC;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,SACN,KACA,KACA,MAMM;AACN,UAAM,WAAW,IAAI,IAAI,GAAG;AAC5B,QAAI,UAAU;AACZ,eAAS,YAAY,KAAK;AAC1B,eAAS,oBAAoB,KAAK;AAClC,eAAS,qBAAqB,KAAK;AACnC,UAAI,KAAK,WAAW,YAAY;AAC9B,iBAAS,aAAa;AAAA,MACxB,WACE,SAAS,eAAe,aACxB,KAAK,WAAW,aAChB;AACA,iBAAS,aAAa;AAAA,MACxB;AAAA,IACF,OAAO;AACL,UAAI,IAAI,KAAK;AAAA,QACX,UAAU,KAAK;AAAA,QACf,kBAAkB,KAAK;AAAA,QACvB,mBAAmB,KAAK;AAAA,QACxB,YAAY,KAAK;AAAA,MACnB,CAAC;AAAA,IACH;AAAA,EACF;AACF;",
+  "names": []
+}