@jinn-network/client 0.1.7 → 0.1.8

package/dist/spend/credential.js

@@ -0,0 +1,71 @@
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { CLAUDE_CODE_HARNESS, CODEX_HARNESS, HERMES_AGENT_HARNESS, canonicalHarnessName, } from '../harnesses/names.js';
+/**
+ * Does this operator have Claude Code installed and authed via OAuth?
+ *
+ * The `claude` CLI keeps its OAuth token in the OS keyring on macOS, in
+ * platform-equivalent stores elsewhere, and writes per-user state under
+ * `~/.claude/`. The cheapest cross-platform "operator has an active
+ * Claude Code Pro subscription set up" probe is "does `~/.claude/`
+ * exist?" — it's created by `claude` on first run and persists.
+ *
+ * Injectable for tests via `homeDirOverride`.
+ */
+export function hasClaudeCodeOnDisk(homeDirOverride) {
+    return existsSync(join(homeDirOverride ?? homedir(), '.claude'));
+}
+/**
+ * Does this operator have Codex CLI installed and authed?
+ *
+ * Codex CLI writes its OAuth to `~/.codex/auth.json`. Presence is the
+ * subscription signal.
+ */
+export function hasCodexOnDisk(homeDirOverride) {
+    return existsSync(join(homeDirOverride ?? homedir(), '.codex', 'auth.json'));
+}
+/**
+ * Resolve which authentication credential a harness will bill against.
+ *
+ * Precedence per provider (preserved from PR #345 / #474):
+ *   1. subscription token env var (`*:subscription`) — most explicit
+ *      subscription marker; the operator has deliberately set it
+ *   2. raw-API-key env var (`*:api-key`) — explicit api-key
+ *   3. on-disk OAuth (`*:subscription`) — the typical operator who
+ *      installed `claude` / `codex` CLI and never set an env var
+ *   4. null — no credential resolved
+ *
+ * Returns null when the harness makes no paid LLM call (e.g. prediction
+ * harnesses) or no credential is recognisable. Issue #901: disk
+ * detection added so stock subscription installs get a credential and
+ * the AI-units gate engages by default; precedence above kept stable so
+ * the cost-surface UI from #345 / #474 still reads the same.
+ */
+export function resolveCredentialId(harness, env, homeDirOverride) {
+    if (!harness)
+        return null;
+    switch (canonicalHarnessName(harness)) {
+        case CLAUDE_CODE_HARNESS:
+            if (env['CLAUDE_CODE_OAUTH_TOKEN'])
+                return 'anthropic:subscription';
+            if (env['ANTHROPIC_API_KEY'])
+                return 'anthropic:api-key';
+            if (hasClaudeCodeOnDisk(homeDirOverride))
+                return 'anthropic:subscription';
+            return null;
+        case CODEX_HARNESS:
+            if (env['OPENAI_API_KEY'])
+                return 'openai:api-key';
+            if (hasCodexOnDisk(homeDirOverride))
+                return 'openai:subscription';
+            return null;
+        case HERMES_AGENT_HARNESS: {
+            const provider = (env['JINN_HERMES_PROVIDER'] ?? 'hermes').trim().toLowerCase();
+            return `${provider}:api-key`;
+        }
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=credential.js.map

package/dist/spend/credential.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credential.js","sourceRoot":"","sources":["../../src/spend/credential.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAK/B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,eAAwB;IAC1D,OAAO,UAAU,CAAC,IAAI,CAAC,eAAe,IAAI,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,eAAwB;IACrD,OAAO,UAAU,CAAC,IAAI,CAAC,eAAe,IAAI,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA2B,EAC3B,GAAsB,EACtB,eAAwB;IAExB,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,QAAQ,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,KAAK,mBAAmB;YACtB,IAAI,GAAG,CAAC,yBAAyB,CAAC;gBAAE,OAAO,wBAAwB,CAAC;YACpE,IAAI,GAAG,CAAC,mBAAmB,CAAC;gBAAE,OAAO,mBAAmB,CAAC;YACzD,IAAI,mBAAmB,CAAC,eAAe,CAAC;gBAAE,OAAO,wBAAwB,CAAC;YAC1E,OAAO,IAAI,CAAC;QACd,KAAK,aAAa;YAChB,IAAI,GAAG,CAAC,gBAAgB,CAAC;gBAAE,OAAO,gBAAgB,CAAC;YACnD,IAAI,cAAc,CAAC,eAAe,CAAC;gBAAE,OAAO,qBAAqB,CAAC;YAClE,OAAO,IAAI,CAAC;QACd,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,sBAAsB,CAAC,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAChF,OAAO,GAAG,QAAQ,UAAU,CAAC;QAC/B,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/spend/daemon-config.d.ts

@@ -0,0 +1,13 @@
+import type { JinnConfig } from '../config.js';
+import { type CredentialId } from './credential.js';
+export interface SpendCapDaemonConfig {
+    /** credentialId -> USD/day cap. */
+    caps: Record<CredentialId, number>;
+    /** manifest CID -> the credential its harness bills against. */
+    manifestCredentials: Record<string, CredentialId>;
+}
+/**
+ * Assemble the daemon's spend-cap config from operator config + env. Returns
+ * undefined when no credential ends up with a cap (the gate then stays off).
+ */
+export declare function buildSpendCapConfig(config: Pick<JinnConfig, 'joinedSolverNets' | 'spendCaps'>, env: NodeJS.ProcessEnv): SpendCapDaemonConfig | undefined;

package/dist/spend/daemon-config.js

@@ -0,0 +1,24 @@
+import { resolveCredentialId } from './credential.js';
+/**
+ * Assemble the daemon's spend-cap config from operator config + env. Returns
+ * undefined when no credential ends up with a cap (the gate then stays off).
+ */
+export function buildSpendCapConfig(config, env) {
+    const blanketRaw = env['JINN_SPEND_CAP_USD'];
+    const blanketNum = blanketRaw != null && blanketRaw.trim() !== '' ? Number(blanketRaw) : NaN;
+    const blanket = Number.isFinite(blanketNum) && blanketNum > 0 ? blanketNum : undefined;
+    const manifestCredentials = {};
+    for (const [manifestCid, entry] of Object.entries(config.joinedSolverNets ?? {})) {
+        const credentialId = resolveCredentialId(entry.harness, env);
+        if (credentialId)
+            manifestCredentials[manifestCid] = credentialId;
+    }
+    const caps = {};
+    for (const credentialId of new Set(Object.values(manifestCredentials))) {
+        const cap = config.spendCaps?.[credentialId] ?? blanket;
+        if (cap != null)
+            caps[credentialId] = cap;
+    }
+    return Object.keys(caps).length > 0 ? { caps, manifestCredentials } : undefined;
+}
+//# sourceMappingURL=daemon-config.js.map

package/dist/spend/daemon-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-config.js","sourceRoot":"","sources":["../../src/spend/daemon-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAqB,MAAM,iBAAiB,CAAC;AASzE;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAA0D,EAC1D,GAAsB;IAEtB,MAAM,UAAU,GAAG,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,UAAU,IAAI,IAAI,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7F,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvF,MAAM,mBAAmB,GAAiC,EAAE,CAAC;IAC7D,KAAK,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC,EAAE,CAAC;QACjF,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC7D,IAAI,YAAY;YAAE,mBAAmB,CAAC,WAAW,CAAC,GAAG,YAAY,CAAC;IACpE,CAAC;IAED,MAAM,IAAI,GAAiC,EAAE,CAAC;IAC9C,KAAK,MAAM,YAAY,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC;QACvE,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC;QACxD,IAAI,GAAG,IAAI,IAAI;YAAE,IAAI,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAClF,CAAC"}

package/dist/spend/pricing.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Price a token count in USD for the given model. Returns null when the model
+ * is unknown to the catalog (caller falls back to a heuristic).
+ *
+ * Uses the tokenlens bundled, offline model catalog (models.dev snapshot).
+ * The `tokenlens` re-export of `getTokenCosts` accepts an object with
+ * `{ modelId, usage }` and injects the default catalog automatically.
+ *
+ * Note: tokenlens's bundled catalog may lag current model IDs (e.g.
+ * `claude-haiku-4-5-20251001` is absent in v1.3.1 and returns null);
+ * callers must handle null gracefully.
+ */
+export declare function priceTokens(modelId: string, tokens: {
+    inputTokens: number;
+    outputTokens: number;
+}): number | null;

package/dist/spend/pricing.js

@@ -0,0 +1,26 @@
+import { getTokenCosts } from 'tokenlens';
+/**
+ * Price a token count in USD for the given model. Returns null when the model
+ * is unknown to the catalog (caller falls back to a heuristic).
+ *
+ * Uses the tokenlens bundled, offline model catalog (models.dev snapshot).
+ * The `tokenlens` re-export of `getTokenCosts` accepts an object with
+ * `{ modelId, usage }` and injects the default catalog automatically.
+ *
+ * Note: tokenlens's bundled catalog may lag current model IDs (e.g.
+ * `claude-haiku-4-5-20251001` is absent in v1.3.1 and returns null);
+ * callers must handle null gracefully.
+ */
+export function priceTokens(modelId, tokens) {
+    try {
+        const costs = getTokenCosts({
+            modelId,
+            usage: { prompt_tokens: tokens.inputTokens, completion_tokens: tokens.outputTokens },
+        });
+        return typeof costs?.totalUSD === 'number' ? costs.totalUSD : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=pricing.js.map

package/dist/spend/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/spend/pricing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CACzB,OAAe,EACf,MAAqD;IAErD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,aAAa,CAAC;YAC1B,OAAO;YACP,KAAK,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,EAAE,MAAM,CAAC,YAAY,EAAE;SACrF,CAAC,CAAC;QACH,OAAO,OAAO,KAAK,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/spend/record.d.ts

@@ -0,0 +1,13 @@
+import type { Store } from '../store/store.js';
+/**
+ * Record the cost of one finished harness run as a `task_cost` activity row.
+ * Called once per harness run (at the POST_SNAPSHOT transition). Best-effort:
+ * never throws — a parse failure must not break task execution.
+ */
+export declare function recordTaskCost(store: Store, args: {
+    requestId: string;
+    harness: string;
+    model: string | undefined;
+    workingDir: string;
+    solverType: string | null;
+}, env?: NodeJS.ProcessEnv): void;

package/dist/spend/record.js

@@ -0,0 +1,36 @@
+import { resolveCredentialId } from './credential.js';
+import { harvestHarnessUsage } from './usage.js';
+/**
+ * Record the cost of one finished harness run as a `task_cost` activity row.
+ * Called once per harness run (at the POST_SNAPSHOT transition). Best-effort:
+ * never throws — a parse failure must not break task execution.
+ */
+export function recordTaskCost(store, args, env = process.env) {
+    try {
+        const credentialId = resolveCredentialId(args.harness, env);
+        if (!credentialId)
+            return;
+        const usage = harvestHarnessUsage(args.harness, args.workingDir, args.model);
+        const actualCostUsdMicros = Math.round(usage.costUsd * 1_000_000);
+        store.recordActivityEvent({
+            ts: new Date().toISOString(),
+            kind: 'task_cost',
+            requestId: args.requestId,
+            solverType: args.solverType,
+            credentialId,
+            costUsdMicros: actualCostUsdMicros,
+            model: usage.model,
+            detail: usage.estimated ? 'estimated' : 'observed',
+        });
+        // Issue #815: fill actual_cost_usd_micros on the per-request claimed
+        // row + set claim_status='delivered'. ai_units stays as captured at
+        // claim time (estimates are the gate input, never recomputed).
+        // Idempotent: no-op when no claimed row exists for this request id.
+        store.finalizeClaimDelivered(args.requestId, actualCostUsdMicros);
+    }
+    catch (err) {
+        console.warn(`[spend] failed to record task cost for ${args.requestId}: ` +
+            `${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=record.js.map

package/dist/spend/record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.js","sourceRoot":"","sources":["../../src/spend/record.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAY,EACZ,IAMC,EACD,MAAyB,OAAO,CAAC,GAAG;IAEpC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC5D,IAAI,CAAC,YAAY;YAAE,OAAO;QAC1B,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7E,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;QAClE,KAAK,CAAC,mBAAmB,CAAC;YACxB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,IAAI,EAAE,WAAW;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,YAAY;YACZ,aAAa,EAAE,mBAAmB;YAClC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU;SACnD,CAAC,CAAC;QACH,qEAAqE;QACrE,oEAAoE;QACpE,+DAA+D;QAC/D,oEAAoE;QACpE,KAAK,CAAC,sBAAsB,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CACV,0CAA0C,IAAI,CAAC,SAAS,IAAI;YAC1D,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACxD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/spend/usage.d.ts

@@ -0,0 +1,27 @@
+/** USD attributed to a task whose model has no known price. */
+export declare const UNKNOWN_MODEL_FALLBACK_USD = 1;
+export interface HarnessUsage {
+    model: string;
+    costUsd: number;
+    /** true = derived from an a-priori heuristic; false = from observed usage. */
+    estimated: boolean;
+    inputTokens?: number;
+    outputTokens?: number;
+}
+/** Parse Claude Code `--output-format stream-json` output for the terminal result. */
+export declare function parseClaudeCodeUsage(stdoutJsonl: string): {
+    costUsd: number;
+    inputTokens?: number;
+    outputTokens?: number;
+} | null;
+/** Parse Codex `--json` output for the last turn.completed token usage. */
+export declare function parseCodexUsage(stdoutJsonl: string): {
+    inputTokens: number;
+    outputTokens: number;
+} | null;
+/**
+ * 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 declare function harvestHarnessUsage(harness: string, workingDir: string, model: string | undefined): HarnessUsage;

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 {};