@jinn-network/client 0.1.7-canary.d4e4e183 → 0.1.7-canary.e68c8f43

package/dist/spend/usage.js

@@ -0,0 +1,113 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { CLAUDE_CODE_HARNESS, CODEX_HARNESS, canonicalHarnessName } from '../harnesses/names.js';
+import { estimateModelCost } from '../harnesses/cost-estimates.js';
+import { priceTokens } from './pricing.js';
+/** USD attributed to a task whose model has no known price. */
+export const UNKNOWN_MODEL_FALLBACK_USD = 1.0;
+/** Parse Claude Code `--output-format stream-json` output for the terminal result. */
+export function parseClaudeCodeUsage(stdoutJsonl) {
+    let result = null;
+    for (const line of stdoutJsonl.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let obj;
+        try {
+            obj = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        if (obj['type'] === 'result' && typeof obj['total_cost_usd'] === 'number') {
+            const usage = obj['usage'];
+            result = {
+                costUsd: obj['total_cost_usd'],
+                inputTokens: typeof usage?.['input_tokens'] === 'number' ? usage['input_tokens'] : undefined,
+                outputTokens: typeof usage?.['output_tokens'] === 'number' ? usage['output_tokens'] : undefined,
+            };
+        }
+    }
+    return result;
+}
+/** Parse Codex `--json` output for the last turn.completed token usage. */
+export function parseCodexUsage(stdoutJsonl) {
+    let result = null;
+    for (const line of stdoutJsonl.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let obj;
+        try {
+            obj = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        if (obj['type'] === 'turn.completed' && obj['usage']) {
+            const usage = obj['usage'];
+            const inT = usage['input_tokens'];
+            const outT = usage['output_tokens'];
+            if (typeof inT === 'number' && typeof outT === 'number') {
+                result = { inputTokens: inT, outputTokens: outT };
+            }
+        }
+    }
+    return result;
+}
+function heuristicUsage(model) {
+    const est = model ? estimateModelCost(model) : null;
+    return {
+        model: model ?? 'unknown',
+        costUsd: est?.usd ?? UNKNOWN_MODEL_FALLBACK_USD,
+        estimated: true,
+    };
+}
+/**
+ * Determine the USD cost of a finished harness run. Reads the harness's own
+ * output file for observed usage; falls back to a heuristic on any failure.
+ * Always returns a HarnessUsage — never throws.
+ */
+export function harvestHarnessUsage(harness, workingDir, model) {
+    try {
+        const canonical = canonicalHarnessName(harness);
+        if (canonical === CLAUDE_CODE_HARNESS) {
+            const raw = readFileSync(join(workingDir, '.claude-code', 'stdout.jsonl'), 'utf8');
+            const parsed = parseClaudeCodeUsage(raw);
+            if (parsed) {
+                return {
+                    model: model ?? 'unknown',
+                    costUsd: parsed.costUsd,
+                    estimated: false,
+                    inputTokens: parsed.inputTokens,
+                    outputTokens: parsed.outputTokens,
+                };
+            }
+            return heuristicUsage(model);
+        }
+        if (canonical === CODEX_HARNESS) {
+            const raw = readFileSync(join(workingDir, '.codex-code', 'stdout.jsonl'), 'utf8');
+            const parsed = parseCodexUsage(raw);
+            // When there is no model id, parsed token counts cannot be priced —
+            // discard them and fall back to the heuristic (per spec).
+            if (parsed && model) {
+                const usd = priceTokens(model, parsed);
+                if (usd != null) {
+                    return {
+                        model,
+                        costUsd: usd,
+                        estimated: false,
+                        inputTokens: parsed.inputTokens,
+                        outputTokens: parsed.outputTokens,
+                    };
+                }
+            }
+            return heuristicUsage(model);
+        }
+        return heuristicUsage(model);
+    }
+    catch {
+        return heuristicUsage(model);
+    }
+}
+//# sourceMappingURL=usage.js.map

package/dist/spend/usage.js.map

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

package/dist/store/store.d.ts

@@ -10,6 +10,17 @@ export interface ActivityEventInput {
     solverType?: string | null;
     outcome?: string | null;
     detail?: string | null;
+    credentialId?: string | null;
+    costUsdMicros?: number | null;
+    model?: string | null;
+    /** Projected AI units debited at claim time (issue #815). Estimates are the gate input; never recomputed. */
+    aiUnits?: number | null;
+    /** Lifecycle stamp on the per-request row: 'claimed' | 'claim_failed' | 'delivered'. */
+    claimStatus?: string | null;
+    /** USD estimate captured at claim time (micros). Distinct from `actualCostUsdMicros` filled on completion. */
+    estimatedCostUsdMicros?: number | null;
+    /** USD actually billed (micros) — filled by the completion path; null until then. */
+    actualCostUsdMicros?: number | null;
 }
 export interface ActivityEventRow {
     id: number;
@@ -21,6 +32,13 @@ export interface ActivityEventRow {
     solverType: string | null;
     outcome: string | null;
     detail: string | null;
+    credentialId: string | null;
+    costUsdMicros: number | null;
+    model: string | null;
+    aiUnits: number | null;
+    claimStatus: string | null;
+    estimatedCostUsdMicros: number | null;
+    actualCostUsdMicros: number | null;
 }
 export interface RewardClaimInput {
     ts: string;
@@ -148,6 +166,22 @@ export interface NetworkArtifactMetadataRow {
     lastUsedAt: string;
     peerCatalogId: string | null;
 }
+export interface Erc8004AnchorInput {
+    envelopeId: string;
+    envelopeCid: string;
+    contentKind: string;
+    metadataKey: string;
+    agentId: string;
+    chainId: number;
+    identityRegistryAddress: string;
+    txHash: string;
+    blockNumber: number | null;
+    payloadHex: string;
+    anchoredAt: number;
+}
+export interface Erc8004AnchorRow extends Erc8004AnchorInput {
+    id: number;
+}
 export type TaskPostingPolicyType = 'once_per_safe' | 'once_per_bucket' | 'interval';
 type LauncherTaskProjectionState = 'open' | 'claims-in-flight' | 'fully-claimed' | 'settled' | 'failed';
 export interface TaskPostRecord {
@@ -185,6 +219,8 @@ export declare class Store {
     private ensureTaskPostsTaskCoordinatorColumns;
     /** Older local DBs may have the projection table from before Task grouping fields landed. */
     private ensureEnvelopeProjectionColumns;
+    /** Older local DBs predate the per-credential spend-ledger columns on activity_events. */
+    private ensureActivityEventCostColumns;
     /**
      * Task-native startup ignores the retired request-first `restoration_intents`
      * table. Keep a one-time local marker when old in-flight rows are present so
@@ -194,6 +230,14 @@ export declare class Store {
     /** Idempotent: older DBs before idx_reward_claims_tx may lack the unique index. */
     private ensureRewardClaimsTxIndex;
     recordOwnActivity(requestId: string, role: 'created' | 'claimed' | 'delivered' | 'evaluated'): void;
+    /**
+     * Membership-only variant of `recordOwnActivity`: writes the
+     * `own_activity` row but does NOT emit a generic `activity_events`
+     * row. Used by paths that emit their own enriched activity event
+     * (e.g. issue #815's claim path attaches credentialId / aiUnits /
+     * estimatedCostUsdMicros / claimStatus to the row).
+     */
+    markOwnActivity(requestId: string, role: 'created' | 'claimed' | 'delivered' | 'evaluated'): void;
     isOwnActivity(requestId: string): boolean;
     setShutdownState(state: 'clean' | 'running'): void;
     getShutdownState(): string | null;
@@ -279,8 +323,63 @@ export declare class Store {
         since?: string;
         cursor?: string;
     }): ActivityEventRow[];
+    /**
+     * Total cost in micro-dollars recorded against a credential since the most
+     * recent UTC midnight. Backs the daily spend cap.
+     */
+    spentTodayMicros(credentialId: string, now?: Date): number;
+    /**
+     * Sum of `ai_units` for a credential within the current 6h UTC-aligned
+     * block (00:00 / 06:00 / 12:00 / 18:00 boundaries). Reads only rows whose
+     * `claim_status = 'claimed'` or `'delivered'` so failed-claim rows
+     * (`ai_units = 0`, `claim_status = 'claim_failed'`) don't muddy the sum
+     * even though their contribution is already zero.
+     *
+     * Issue #815. Backs the per-block AI-units ceiling gate.
+     */
+    aiUnitsThisBlock(credentialId: string, now?: Date): number;
+    /**
+     * Sum of `ai_units` for a credential within the trailing 7-day rolling
+     * window from `now`. Backs the per-week AI-units safety-net ceiling.
+     * Issue #815.
+     */
+    aiUnitsThisWeek(credentialId: string, now?: Date): number;
+    /**
+     * True iff an `ai_units_cap_reached` row exists for the given
+     * (credentialId, window, blockId). Used by the daemon to hydrate the
+     * AI-units gate's in-memory pause memo across restarts so the
+     * "exactly one event per (credential, window, block-id)" guarantee
+     * holds across process boundaries (issue #815, finding 1).
+     *
+     * Lookup is by `credential_id` + `kind` + the `[block=...][window=...]`
+     * markers that `daemon.ts` embeds in the row's `detail` string.
+     */
+    hasAiUnitsCapReachedFor(credentialId: string, window: 'block' | 'week', blockId: string): boolean;
+    /**
+     * Mark the per-request `claimed` row as `delivered` and record
+     * `actual_cost_usd_micros`. The `ai_units` projection captured at
+     * claim time is intentionally NOT recomputed — the issue spec says
+     * "estimates are the gate input, never recomputed". Idempotent: a
+     * no-op when no `claimed` row exists.
+     */
+    finalizeClaimDelivered(requestId: string, actualCostUsdMicros: number): void;
     /** Newer events first, then ascending id for `jinn logs --follow` (oldest in batch printed first in caller). */
     getActivityEventsAfterId(afterId: number, limit: number): ActivityEventRow[];
+    /**
+     * Filtered, id-cursored page of activity events for the dedicated Events
+     * page. Newest-first.
+     *
+     * Cursors on `id` rather than `ts` so startup/shutdown rows with null
+     * timestamps remain reachable.
+     */
+    getActivityEventsPage(opts?: {
+        kinds?: string[];
+        outcome?: string;
+        requestId?: string;
+        beforeId?: number;
+        limit?: number;
+    }): ActivityEventRow[];
+    getActivityEventById(id: number): ActivityEventRow | null;
     getActivityCountsByKind(): Record<string, number>;
     getLastEventAtForService(serviceIndex: number): string | null;
     getActivityCountsForService(serviceIndex: number): Record<string, number>;
@@ -398,6 +497,8 @@ export declare class Store {
     }>;
     saveEnvelopeProjection(projection: EnvelopeProjection): void;
     queryEnvelopeProjections(query?: EnvelopeProjectionQuery): EnvelopeProjection[];
+    saveErc8004Anchor(input: Erc8004AnchorInput): void;
+    listErc8004AnchorsByEnvelopeCids(envelopeCids: readonly string[]): Erc8004AnchorRow[];
     close(): void;
 }
 export {};

package/dist/store/store.js

@@ -228,6 +228,23 @@ CREATE TABLE IF NOT EXISTS envelope_projection_metadata (
 CREATE INDEX IF NOT EXISTS idx_envelope_projection_metadata_key_value
   ON envelope_projection_metadata (key, value_text);
 
+CREATE TABLE IF NOT EXISTS erc8004_anchors (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  envelope_id TEXT NOT NULL,
+  envelope_cid TEXT NOT NULL,
+  content_kind TEXT NOT NULL,
+  metadata_key TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  chain_id INTEGER NOT NULL,
+  identity_registry_address TEXT NOT NULL,
+  tx_hash TEXT NOT NULL,
+  block_number INTEGER,
+  payload_hex TEXT NOT NULL,
+  anchored_at INTEGER NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_erc8004_anchors_envelope_cid ON erc8004_anchors(envelope_cid);
+CREATE INDEX IF NOT EXISTS idx_erc8004_anchors_envelope_id ON erc8004_anchors(envelope_id);
+
 CREATE TABLE IF NOT EXISTS task_post_locks (
   creator_safe_address TEXT NOT NULL,
   source_key TEXT NOT NULL,
@@ -299,6 +316,7 @@ export class Store {
         this.ensureNetworkArtifactsPeerCatalogId();
         this.ensureTaskPostsTaskCoordinatorColumns();
         this.ensureEnvelopeProjectionColumns();
+        this.ensureActivityEventCostColumns();
         this.backfillActivityEvents();
         this.recordLegacyRestorationIntentsIgnored();
     }
@@ -363,6 +381,30 @@ export class Store {
         this.db.exec(`CREATE INDEX IF NOT EXISTS idx_envelope_projections_solution_ref ON envelope_projections (solution_envelope_ref)`);
         this.db.exec(`CREATE INDEX IF NOT EXISTS idx_envelope_projections_generated ON envelope_projections (generated_at DESC)`);
     }
+    /** Older local DBs predate the per-credential spend-ledger columns on activity_events. */
+    ensureActivityEventCostColumns() {
+        const activityCols = new Set(this.db.prepare(`PRAGMA table_info(activity_events)`).all()
+            .map(c => c.name));
+        const addActivityColumn = (name, ddl) => {
+            if (!activityCols.has(name))
+                this.db.exec(`ALTER TABLE activity_events ADD COLUMN ${ddl}`);
+        };
+        addActivityColumn('credential_id', 'credential_id TEXT');
+        addActivityColumn('cost_usd_micros', 'cost_usd_micros INTEGER');
+        addActivityColumn('model', 'model TEXT');
+        // Issue #815 — AI-units ceiling. ai_units is the gate-input projection
+        // captured at claim time; claim_status tracks the per-request lifecycle
+        // (claimed / claim_failed / delivered); the cost pair splits the
+        // estimated-at-claim-time vs actual-at-completion telemetry.
+        addActivityColumn('ai_units', 'ai_units REAL');
+        addActivityColumn('claim_status', 'claim_status TEXT');
+        addActivityColumn('estimated_cost_usd_micros', 'estimated_cost_usd_micros INTEGER');
+        addActivityColumn('actual_cost_usd_micros', 'actual_cost_usd_micros INTEGER');
+        this.db.exec(`CREATE INDEX IF NOT EXISTS idx_activity_events_credential ON activity_events (credential_id, ts)`);
+        // Per-request lookup for the completion-time update path that fills
+        // actualCostUsdMicros / sets claim_status='delivered'.
+        this.db.exec(`CREATE INDEX IF NOT EXISTS idx_activity_events_req_claim ON activity_events (request_id, claim_status)`);
+    }
     /**
      * Task-native startup ignores the retired request-first `restoration_intents`
      * table. Keep a one-time local marker when old in-flight rows are present so
@@ -417,6 +459,16 @@ export class Store {
         const ts = new Date().toISOString();
         this.recordActivityEvent({ ts, kind: role, requestId });
     }
+    /**
+     * Membership-only variant of `recordOwnActivity`: writes the
+     * `own_activity` row but does NOT emit a generic `activity_events`
+     * row. Used by paths that emit their own enriched activity event
+     * (e.g. issue #815's claim path attaches credentialId / aiUnits /
+     * estimatedCostUsdMicros / claimStatus to the row).
+     */
+    markOwnActivity(requestId, role) {
+        this.db.prepare(`INSERT OR REPLACE INTO own_activity (request_id, role) VALUES (?, ?)`).run(requestId, role);
+    }
     isOwnActivity(requestId) {
         const row = this.db.prepare('SELECT 1 FROM own_activity WHERE request_id = ?').get(requestId);
         return row !== undefined;
@@ -746,8 +798,14 @@ export class Store {
         return legacyRows.map(r => ({ requestId: r.request_id, role: r.role }));
     }
     recordActivityEvent(event) {
-        this.db.prepare(`INSERT INTO activity_events (ts, kind, request_id, service_index, tx_hash, solver_type, outcome, detail)
-       VALUES (@ts, @kind, @requestId, @serviceIndex, @txHash, @solverType, @outcome, @detail)`).run({
+        this.db.prepare(`INSERT INTO activity_events
+         (ts, kind, request_id, service_index, tx_hash, solver_type, outcome, detail,
+          credential_id, cost_usd_micros, model,
+          ai_units, claim_status, estimated_cost_usd_micros, actual_cost_usd_micros)
+       VALUES
+         (@ts, @kind, @requestId, @serviceIndex, @txHash, @solverType, @outcome, @detail,
+          @credentialId, @costUsdMicros, @model,
+          @aiUnits, @claimStatus, @estimatedCostUsdMicros, @actualCostUsdMicros)`).run({
             ts: event.ts ?? null,
             kind: event.kind,
             requestId: event.requestId ?? null,
@@ -756,6 +814,13 @@ export class Store {
             solverType: event.solverType ?? null,
             outcome: event.outcome ?? null,
             detail: event.detail ?? null,
+            credentialId: event.credentialId ?? null,
+            costUsdMicros: event.costUsdMicros ?? null,
+            model: event.model ?? null,
+            aiUnits: event.aiUnits ?? null,
+            claimStatus: event.claimStatus ?? null,
+            estimatedCostUsdMicros: event.estimatedCostUsdMicros ?? null,
+            actualCostUsdMicros: event.actualCostUsdMicros ?? null,
         });
     }
     getRecentActivityEvents(limit, opts = {}) {
@@ -771,7 +836,9 @@ export class Store {
             params['cursor'] = opts.cursor;
         }
         const where = clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';
-        const rows = this.db.prepare(`SELECT id, ts, kind, request_id, service_index, tx_hash, solver_type, outcome, detail
+        const rows = this.db.prepare(`SELECT id, ts, kind, request_id, service_index, tx_hash, solver_type, outcome, detail,
+              credential_id, cost_usd_micros, model,
+              ai_units, claim_status, estimated_cost_usd_micros, actual_cost_usd_micros
        FROM activity_events
        ${where}
        ORDER BY id DESC
@@ -786,13 +853,106 @@ export class Store {
             solverType: r.solver_type,
             outcome: r.outcome,
             detail: r.detail,
+            credentialId: r.credential_id,
+            costUsdMicros: r.cost_usd_micros,
+            model: r.model,
+            aiUnits: r.ai_units,
+            claimStatus: r.claim_status,
+            estimatedCostUsdMicros: r.estimated_cost_usd_micros,
+            actualCostUsdMicros: r.actual_cost_usd_micros,
         }));
     }
+    /**
+     * Total cost in micro-dollars recorded against a credential since the most
+     * recent UTC midnight. Backs the daily spend cap.
+     */
+    spentTodayMicros(credentialId, now = new Date()) {
+        const midnight = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate())).toISOString();
+        const row = this.db.prepare(`SELECT COALESCE(SUM(cost_usd_micros), 0) AS total
+       FROM activity_events
+       WHERE credential_id = @cid AND ts IS NOT NULL AND ts >= @midnight`).get({ cid: credentialId, midnight });
+        return row.total;
+    }
+    /**
+     * Sum of `ai_units` for a credential within the current 6h UTC-aligned
+     * block (00:00 / 06:00 / 12:00 / 18:00 boundaries). Reads only rows whose
+     * `claim_status = 'claimed'` or `'delivered'` so failed-claim rows
+     * (`ai_units = 0`, `claim_status = 'claim_failed'`) don't muddy the sum
+     * even though their contribution is already zero.
+     *
+     * Issue #815. Backs the per-block AI-units ceiling gate.
+     */
+    aiUnitsThisBlock(credentialId, now = new Date()) {
+        const startOfDay = Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
+        const sinceDayStart = now.getTime() - startOfDay;
+        const sixHoursMs = 6 * 60 * 60 * 1_000;
+        // Cap at 3 — there are 4 blocks per day (indices 0..3). Edge cases
+        // where sinceDayStart ≈ 24h (millisecond rounding) would otherwise
+        // overshoot into a non-existent 5th block in the *next* day.
+        const blocksIn = Math.min(Math.floor(sinceDayStart / sixHoursMs), 3);
+        const blockStart = new Date(startOfDay + blocksIn * sixHoursMs).toISOString();
+        const blockEnd = new Date(startOfDay + (blocksIn + 1) * sixHoursMs).toISOString();
+        const row = this.db.prepare(`SELECT COALESCE(SUM(ai_units), 0) AS total
+       FROM activity_events
+       WHERE credential_id = @cid
+         AND ts IS NOT NULL AND ts >= @blockStart AND ts < @blockEnd
+         AND claim_status IN ('claimed', 'delivered')`).get({ cid: credentialId, blockStart, blockEnd });
+        return row.total ?? 0;
+    }
+    /**
+     * Sum of `ai_units` for a credential within the trailing 7-day rolling
+     * window from `now`. Backs the per-week AI-units safety-net ceiling.
+     * Issue #815.
+     */
+    aiUnitsThisWeek(credentialId, now = new Date()) {
+        const weekStart = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1_000).toISOString();
+        const row = this.db.prepare(`SELECT COALESCE(SUM(ai_units), 0) AS total
+       FROM activity_events
+       WHERE credential_id = @cid
+         AND ts IS NOT NULL AND ts >= @weekStart
+         AND claim_status IN ('claimed', 'delivered')`).get({ cid: credentialId, weekStart });
+        return row.total ?? 0;
+    }
+    /**
+     * True iff an `ai_units_cap_reached` row exists for the given
+     * (credentialId, window, blockId). Used by the daemon to hydrate the
+     * AI-units gate's in-memory pause memo across restarts so the
+     * "exactly one event per (credential, window, block-id)" guarantee
+     * holds across process boundaries (issue #815, finding 1).
+     *
+     * Lookup is by `credential_id` + `kind` + the `[block=...][window=...]`
+     * markers that `daemon.ts` embeds in the row's `detail` string.
+     */
+    hasAiUnitsCapReachedFor(credentialId, window, blockId) {
+        const marker = `[block=${blockId}][window=${window}]`;
+        const row = this.db.prepare(`SELECT 1 AS hit
+       FROM activity_events
+       WHERE kind = 'ai_units_cap_reached'
+         AND credential_id = @cid
+         AND detail LIKE @marker
+       LIMIT 1`).get({ cid: credentialId, marker: `${marker}%` });
+        return row !== undefined;
+    }
+    /**
+     * Mark the per-request `claimed` row as `delivered` and record
+     * `actual_cost_usd_micros`. The `ai_units` projection captured at
+     * claim time is intentionally NOT recomputed — the issue spec says
+     * "estimates are the gate input, never recomputed". Idempotent: a
+     * no-op when no `claimed` row exists.
+     */
+    finalizeClaimDelivered(requestId, actualCostUsdMicros) {
+        this.db.prepare(`UPDATE activity_events
+         SET claim_status = 'delivered',
+             actual_cost_usd_micros = @actual
+       WHERE request_id = @req AND claim_status = 'claimed'`).run({ req: requestId, actual: actualCostUsdMicros });
+    }
     /** Newer events first, then ascending id for `jinn logs --follow` (oldest in batch printed first in caller). */
     getActivityEventsAfterId(afterId, limit) {
         const effectiveLimit = Math.max(0, Math.min(limit, 1000));
         const rows = this.db
-            .prepare(`SELECT id, ts, kind, request_id, service_index, tx_hash, solver_type, outcome, detail
+            .prepare(`SELECT id, ts, kind, request_id, service_index, tx_hash, solver_type, outcome, detail,
+                credential_id, cost_usd_micros, model,
+                ai_units, claim_status, estimated_cost_usd_micros, actual_cost_usd_micros
          FROM activity_events
          WHERE id > @afterId
          ORDER BY id ASC
@@ -808,8 +968,99 @@ export class Store {
             solverType: r.solver_type,
             outcome: r.outcome,
             detail: r.detail,
+            credentialId: r.credential_id,
+            costUsdMicros: r.cost_usd_micros,
+            model: r.model,
+            aiUnits: r.ai_units,
+            claimStatus: r.claim_status,
+            estimatedCostUsdMicros: r.estimated_cost_usd_micros,
+            actualCostUsdMicros: r.actual_cost_usd_micros,
+        }));
+    }
+    /**
+     * Filtered, id-cursored page of activity events for the dedicated Events
+     * page. Newest-first.
+     *
+     * Cursors on `id` rather than `ts` so startup/shutdown rows with null
+     * timestamps remain reachable.
+     */
+    getActivityEventsPage(opts = {}) {
+        const effectiveLimit = Math.max(1, Math.min(opts.limit ?? 50, 200));
+        const clauses = [];
+        const params = { limit: effectiveLimit };
+        if (opts.kinds && opts.kinds.length > 0) {
+            const placeholders = opts.kinds.map((_, i) => `@kind${i}`);
+            clauses.push(`kind IN (${placeholders.join(', ')})`);
+            opts.kinds.forEach((k, i) => {
+                params[`kind${i}`] = k;
+            });
+        }
+        if (opts.outcome) {
+            clauses.push('outcome = @outcome');
+            params['outcome'] = opts.outcome;
+        }
+        if (opts.requestId) {
+            clauses.push('request_id = @requestId');
+            params['requestId'] = opts.requestId;
+        }
+        if (opts.beforeId !== undefined) {
+            clauses.push('id < @beforeId');
+            params['beforeId'] = opts.beforeId;
+        }
+        const where = clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';
+        const rows = this.db.prepare(`SELECT id, ts, kind, request_id, service_index, tx_hash, solver_type, outcome, detail,
+              credential_id, cost_usd_micros, model,
+              ai_units, claim_status, estimated_cost_usd_micros, actual_cost_usd_micros
+       FROM activity_events
+       ${where}
+       ORDER BY id DESC
+       LIMIT @limit`).all(params);
+        return rows.map((r) => ({
+            id: r.id,
+            ts: r.ts,
+            kind: r.kind,
+            requestId: r.request_id,
+            serviceIndex: r.service_index,
+            txHash: r.tx_hash,
+            solverType: r.solver_type,
+            outcome: r.outcome,
+            detail: r.detail,
+            credentialId: r.credential_id,
+            costUsdMicros: r.cost_usd_micros,
+            model: r.model,
+            aiUnits: r.ai_units,
+            claimStatus: r.claim_status,
+            estimatedCostUsdMicros: r.estimated_cost_usd_micros,
+            actualCostUsdMicros: r.actual_cost_usd_micros,
         }));
     }
+    getActivityEventById(id) {
+        const r = this.db.prepare(`SELECT id, ts, kind, request_id, service_index, tx_hash, solver_type, outcome, detail,
+              credential_id, cost_usd_micros, model,
+              ai_units, claim_status, estimated_cost_usd_micros, actual_cost_usd_micros
+       FROM activity_events
+       WHERE id = ?`).get(id);
+        if (!r)
+            return null;
+        return {
+            id: r.id,
+            ts: r.ts,
+            kind: r.kind,
+            requestId: r.request_id,
+            serviceIndex: r.service_index,
+            txHash: r.tx_hash,
+            solverType: r.solver_type,
+            outcome: r.outcome,
+            detail: r.detail,
+            credentialId: r.credential_id,
+            costUsdMicros: r.cost_usd_micros,
+            model: r.model,
+            aiUnits: r.ai_units,
+            claimStatus: r.claim_status,
+            estimatedCostUsdMicros: r.estimated_cost_usd_micros,
+            actualCostUsdMicros: r.actual_cost_usd_micros,
+        };
+    }
     getActivityCountsByKind() {
         const rows = this.db.prepare(`SELECT kind, COUNT(*) as c FROM activity_events GROUP BY kind`).all();
         const out = {};
@@ -1519,6 +1770,55 @@ export class Store {
        LIMIT @limit`).all(params);
         return rows.map(rowToEnvelopeProjection);
     }
+    saveErc8004Anchor(input) {
+        this.db.prepare(`INSERT INTO erc8004_anchors
+         (envelope_id, envelope_cid, content_kind, metadata_key, agent_id,
+          chain_id, identity_registry_address, tx_hash, block_number,
+          payload_hex, anchored_at)
+       VALUES
+         (@envelopeId, @envelopeCid, @contentKind, @metadataKey, @agentId,
+          @chainId, @identityRegistryAddress, @txHash, @blockNumber,
+          @payloadHex, @anchoredAt)`).run({
+            envelopeId: input.envelopeId,
+            envelopeCid: input.envelopeCid,
+            contentKind: input.contentKind,
+            metadataKey: input.metadataKey,
+            agentId: input.agentId,
+            chainId: input.chainId,
+            identityRegistryAddress: input.identityRegistryAddress,
+            txHash: input.txHash,
+            blockNumber: input.blockNumber,
+            payloadHex: input.payloadHex,
+            anchoredAt: input.anchoredAt,
+        });
+    }
+    listErc8004AnchorsByEnvelopeCids(envelopeCids) {
+        if (envelopeCids.length === 0)
+            return [];
+        const placeholders = envelopeCids.map((_, i) => `@cid${i}`).join(', ');
+        const params = {};
+        envelopeCids.forEach((cid, i) => { params[`cid${i}`] = cid; });
+        const rows = this.db.prepare(`SELECT id, envelope_id, envelope_cid, content_kind, metadata_key, agent_id,
+              chain_id, identity_registry_address, tx_hash, block_number,
+              payload_hex, anchored_at
+         FROM erc8004_anchors
+         WHERE envelope_cid IN (${placeholders})
+         ORDER BY anchored_at ASC, id ASC`).all(params);
+        return rows.map((r) => ({
+            id: r.id,
+            envelopeId: r.envelope_id,
+            envelopeCid: r.envelope_cid,
+            contentKind: r.content_kind,
+            metadataKey: r.metadata_key,
+            agentId: r.agent_id,
+            chainId: r.chain_id,
+            identityRegistryAddress: r.identity_registry_address,
+            txHash: r.tx_hash,
+            blockNumber: r.block_number,
+            payloadHex: r.payload_hex,
+            anchoredAt: r.anchored_at,
+        }));
+    }
     close() {
         this.db.close();
     }