@cleocode/core 2026.9.21 → 2026.9.23

package/dist/decide/operations.d.ts

@@ -8,8 +8,9 @@
  * @task T12491
  * @epic T12486
  */
-import type { DecisionAnswer } from '@cleocode/contracts';
+import { type DecisionAnswer, type DecisionProviderCapabilities, type DecisionProviderKind, type DecisionProviderUsage } from '@cleocode/contracts';
 import { type DecideCredentialsSummary, type SealedDecideConnection } from './credentials.js';
+import { type SpendLedger, type SpendLedgerHealth, type SpendResetOptions, type SpendResetReceipt } from './spend.js';
 /** Default deadline for the `GET /v1/models` probe, ms. */
 export declare const DEFAULT_DECIDE_PROBE_TIMEOUT_MS = 3000;
 /** Default deadline for `cleo decide ask`, ms (generous: it is a debug tool). */
@@ -18,11 +19,28 @@ export declare const DEFAULT_DECIDE_ASK_TIMEOUT_MS = 10000;
  * Reachability of the configured provider.
  *
  * - `reachable`    — `GET /v1/models` answered 2xx.
- * - `unauthorized` — the provider rejected the key (401/403).
+ * - `unauthorized` — the provider rejected the key (401, or a 403 that is not a key limit).
+ * - `key_limit_reached` — the key's monthly decision limit is reached (403
+ *   `key_limit_exceeded`); decisions resume when the UTC month rolls over.
  * - `unconfigured` — no valid base URL + key stored.
  * - `unreachable`  — network failure, timeout, or any other HTTP status.
  */
-export type DecideProviderState = 'reachable' | 'unauthorized' | 'unconfigured' | 'unreachable';
+export type DecideProviderState = 'reachable' | 'unauthorized' | 'key_limit_reached' | 'unconfigured' | 'unreachable';
+/** Month-to-date spend against the CLEO cap (D11159). */
+export interface DecideSpendSummary {
+    /** UTC month, `YYYY-MM`. */
+    readonly month: string;
+    /** Micro-dollars recorded this month. */
+    readonly spentMicros: number;
+    /** Micro-dollars reserved by calls in flight. */
+    readonly reservedMicros: number;
+    /** The cap, micro-dollars (`decide.budget.monthlyMicros`). */
+    readonly capMicros: number;
+    /** Whether sites are degraded to their heuristics because the cap is reached. */
+    readonly capReached: boolean;
+    /** ISO time until which the key's monthly limit stops decisions, when set. */
+    readonly keyLimitedUntil?: string;
+}
 /** Result of {@link probeDecideProvider}. */
 export interface DecideProbeResult {
     /** Reachability verdict. */
@@ -43,6 +61,18 @@ export interface DecideProbeResult {
     readonly latencyMs?: number;
     /** Secret-free explanation or warning. */
     readonly detail?: string;
+    /** Registered decision sites (T12662). */
+    readonly sites: number;
+    /** What the provider supports beyond the Jev minimum (T12664). */
+    readonly capabilities?: DecisionProviderCapabilities;
+    /** Last usage/balance read (refreshed at most every 10 minutes). */
+    readonly usage?: DecisionProviderUsage & {
+        readonly fetchedAt: string;
+    };
+    /** Month-to-date spend against the cap. */
+    readonly spend?: DecideSpendSummary;
+    /** Spend-ledger health; `corrupt` or `unavailable` means every site falls back. */
+    readonly spendLedger?: SpendLedgerHealth;
 }
 /** Options for {@link probeDecideProvider}. */
 export interface DecideProbeOptions {
@@ -52,7 +82,24 @@ export interface DecideProbeOptions {
     readonly fetch?: typeof fetch;
     /** Deadline, ms. Default {@link DEFAULT_DECIDE_PROBE_TIMEOUT_MS}. */
     readonly timeoutMs?: number;
+    /** Spend ledger; `null` omits spend. Default: the machine-wide ledger. */
+    readonly spend?: SpendLedger | null;
+    /** Monthly cap, micro-dollars. Default: `decide.budget.monthlyMicros`, else $1. */
+    readonly capMicros?: number;
+    /** Spend-ledger path to inspect. Default: `<cleoHome>/decide/spend.json`. */
+    readonly spendStatePath?: string;
+    /** Provider-state file (capabilities + usage cache). Default: `<cleoHome>/decide/provider-state.json`. */
+    readonly providerStatePath?: string;
+    /** Wall clock, epoch ms. Default `Date.now`. */
+    readonly now?: () => number;
+    /**
+     * Re-detect capabilities even when the cached read is fresh. Set after the
+     * settings change so the provider's extensions apply immediately (T12713).
+     */
+    readonly refreshCapabilities?: boolean;
 }
+/** Message naming the repair for a ledger that cannot be read. */
+export declare const SPEND_LEDGER_REPAIR_HINT = "The System One spend ledger cannot be read, so every site uses its heuristic (the cap fails closed). Run `cleo decide budget reset` to start a fresh ledger; the old file is kept as a receipt.";
 /**
  * Probe the provider with `GET {baseUrl}/v1/models` under a short deadline.
  * Never throws.
@@ -63,44 +110,61 @@ export interface DecideProbeOptions {
 export declare function probeDecideProvider(opts?: DecideProbeOptions): Promise<DecideProbeResult>;
 /** Input for {@link configureDecide}. */
 export interface DecideConfigureInput {
-    /** Provider base URL. Omitted → the stored URL is kept. */
+    /**
+     * Provider kind. Omitted → the stored kind when the host is unchanged,
+     * else inferred from `baseUrl` (the layahost host → `layahost`, any other →
+     * `jev`), else `layahost`.
+     */
+    readonly provider?: DecisionProviderKind;
+    /**
+     * Provider base URL. Omitted → the stored URL for the same provider, else
+     * the provider's preset URL. Required for `jev` when nothing is stored.
+     */
     readonly baseUrl?: string;
     /** API key. Omitted → the stored key is kept. */
     readonly apiKey?: string;
     /**
-     * Default model. Omitted → the stored model is kept when the URL is
-     * unchanged; otherwise resolved from the provider's model listing.
+     * Default model. Omitted → the stored model when the URL is unchanged;
+     * otherwise the preset default (`layahost`), else the first model the
+     * provider lists (`jev`).
      */
     readonly model?: string;
-    /** `fetch` for the model lookup; tests inject a stub. */
+    /** `fetch` for the model lookup and the post-save probe; tests inject a stub. */
     readonly fetch?: typeof fetch;
-    /** Deadline for the model lookup, ms. */
+    /** Deadline for the model lookup and the probe, ms. */
     readonly timeoutMs?: number;
 }
 /** Result of {@link configureDecide}. */
 export interface DecideConfigureResult extends DecideCredentialsSummary {
     /** Where the stored model came from. */
-    readonly modelSource: 'flag' | 'stored' | 'provider-listing' | 'none';
+    readonly modelSource: 'flag' | 'stored' | 'preset' | 'provider-listing' | 'none';
+    /** Reachability verdict of the probe run after saving. */
+    readonly providerState: DecideProviderState;
+    /** Capabilities detected after saving (the provider's extensions are active from now on). */
+    readonly capabilities?: DecisionProviderCapabilities;
     /** Secret-free warning, e.g. when no model could be resolved. */
     readonly warning?: string;
 }
 /**
- * Store the provider settings, merging omitted values with the stored ones.
+ * Store the provider settings, merging omitted values with the stored ones,
+ * then probe the provider and re-detect its capabilities so its extensions
+ * apply immediately.
  *
- * The Jev `/v1/systemone` endpoint requires a `model`, and no model literal
- * may be hard-coded in core (arch gate 13). So when no model is given (and
- * none is stored for the same URL), this asks the provider (`GET /v1/models`)
- * and stores the FIRST model it lists — the provider's own ordering; layahost
- * lists its routing default first. When that lookup fails the settings are
- * still stored, without a model, and a warning says how to set one.
+ * A model is always stored when one can be known, because the Jev
+ * `/v1/systemone` endpoint rejects a request without one (422, and every
+ * site silently falls back). The model comes from, in order: the flag; the
+ * stored model (same URL); the provider preset (`layahost` →
+ * `LAYAHOST_DEFAULT_MODEL`); the first model the provider lists. Only a
+ * `jev` provider whose listing fails can end with no model, and then a
+ * warning says how to set one.
  *
- * @param input - URL, key, optional model.
- * @returns Secret-free summary plus the model's provenance.
  * A URL whose host differs from the stored one must come with a fresh key:
  * the stored key is never re-used (or sent in the model probe) for a new host.
  *
- * @throws {DecideCredentialsError} On an invalid URL, blank key, invalid model
- *   name, or a host change without a fresh key.
+ * @param input - Provider, URL, key, optional model.
+ * @returns Secret-free summary plus the model's provenance and the probe verdict.
+ * @throws {DecideCredentialsError} On an invalid URL, `jev` without a URL, a
+ *   blank key, an invalid model name, or a host change without a fresh key.
  */
 export declare function configureDecide(input: DecideConfigureInput): Promise<DecideConfigureResult>;
 /**
@@ -149,4 +213,17 @@ export interface DecideAskResult {
  * @returns The typed answer with source, fallback reason, latency and cost.
  */
 export declare function askDecideDebug(input: DecideAskInput): Promise<DecideAskResult>;
+/**
+ * `cleo decide budget reset`: start a fresh spend ledger for this month,
+ * moving the old file aside as a receipt. The repair for a corrupt ledger,
+ * which otherwise keeps every site on its heuristic. A readable ledger is
+ * refused unless `opts.force`, and its month-to-date spend is carried over,
+ * so a reset never lifts a reached cap.
+ *
+ * @param statePath - Ledger path. Default: `<cleoHome>/decide/spend.json`.
+ * @param opts - `force` resets a ledger that is not corrupt.
+ * @returns The receipt: previous health, carried spend and where the old file went.
+ * @throws {SpendResetRefusedError} When the ledger is not corrupt and `force` is not set.
+ */
+export declare function resetDecideBudget(statePath?: string, opts?: SpendResetOptions): Promise<SpendResetReceipt>;
 //# sourceMappingURL=operations.d.ts.map

package/dist/decide/operations.d.ts.map

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

package/dist/decide/operations.js

@@ -8,21 +8,69 @@
  * @task T12491
  * @epic T12486
  */
+import { JEV_MINIMUM_CAPABILITIES, } from '@cleocode/contracts';
 import { getProjectRoot } from '../paths.js';
 import { createJsonlDecisionAudit, } from './audit.js';
 import { decide } from './client.js';
 import { clearDecideCredentials, DecideCredentialsError, describeDecideCredentials, loadDecideConnection, sameDecideHost, saveDecideCredentials, } from './credentials.js';
-import { listJevModels } from './jev-wire.js';
+import { detectJevCapabilities, listJevModels } from './jev-wire.js';
 import { DecisionProviderError } from './provider.js';
+import { providerKeyHash, readProviderState, USAGE_REFRESH_MS, writeProviderState, } from './provider-state.js';
+import { DECISION_PROVIDER_PRESETS, inferDecisionProviderKind } from './providers.js';
+import { DECIDE_ASK_DECISION_SITE, DECISION_SITES } from './sites/registry.js';
+import { createFileSpendLedger, DEFAULT_MONTHLY_SPEND_CAP_MICROS, inspectSpendLedger, MONTHLY_SPEND_CAP_KEY, resetSpendLedger, } from './spend.js';
 /** Default deadline for the `GET /v1/models` probe, ms. */
 export const DEFAULT_DECIDE_PROBE_TIMEOUT_MS = 3_000;
 /** Default deadline for `cleo decide ask`, ms (generous: it is a debug tool). */
 export const DEFAULT_DECIDE_ASK_TIMEOUT_MS = 10_000;
+const KEY_LIMIT_DETAIL = "The key's monthly decision limit is reached (403 key_limit_exceeded). The key itself is fine: decisions resume when the UTC month rolls over, or raise the limit in the provider console.";
+/** Message naming the repair for a ledger that cannot be read. */
+export const SPEND_LEDGER_REPAIR_HINT = 'The System One spend ledger cannot be read, so every site uses its heuristic (the cap fails closed). Run `cleo decide budget reset` to start a fresh ledger; the old file is kept as a receipt.';
+/** `{ detail }` when there is one, else nothing. */
+function optionalDetail(detail) {
+    return detail ? { detail } : {};
+}
+/** Month-to-date spend, or undefined when the ledger is disabled or unreadable. */
+async function spendSummary(opts) {
+    const ledger = opts.spend === undefined ? createFileSpendLedger() : opts.spend;
+    if (!ledger)
+        return undefined;
+    const status = await ledger.status();
+    if (!status)
+        return undefined;
+    let capMicros = opts.capMicros;
+    if (capMicros === undefined) {
+        try {
+            const { getConfigValue } = await import('../config/registry.js');
+            const value = await getConfigValue(MONTHLY_SPEND_CAP_KEY, {
+                projectRoot: getProjectRoot(),
+            });
+            capMicros =
+                typeof value === 'number' && value >= 0 ? value : DEFAULT_MONTHLY_SPEND_CAP_MICROS;
+        }
+        catch {
+            capMicros = DEFAULT_MONTHLY_SPEND_CAP_MICROS;
+        }
+    }
+    return {
+        month: status.month,
+        spentMicros: status.spentMicros,
+        reservedMicros: status.reservedMicros,
+        capMicros,
+        capReached: status.spentMicros >= capMicros,
+        ...(status.keyLimitedUntil !== undefined
+            ? { keyLimitedUntil: new Date(status.keyLimitedUntil).toISOString() }
+            : {}),
+    };
+}
 const NO_MODEL_WARNING = 'No default model is configured. The Jev /v1/systemone endpoint requires a model; set one with `cleo decide config --model <name>` (see `models`).';
 function stateForError(err) {
     if (err instanceof DecisionProviderError) {
         if (err.kind === 'unauthorized')
             return { state: 'unauthorized', httpStatus: err.status };
+        if (err.kind === 'key_limit_exceeded') {
+            return { state: 'key_limit_reached', httpStatus: err.status };
+        }
         if (err.kind === 'invalid_response')
             return { state: 'reachable', httpStatus: err.status };
         return {
@@ -40,98 +88,187 @@ function stateForError(err) {
  * @returns The reachability verdict and, when listed, the available models.
  */
 export async function probeDecideProvider(opts = {}) {
+    const sites = DECISION_SITES.length;
     const sealed = opts.connection === undefined ? loadDecideConnection() : opts.connection;
+    const spend = await spendSummary(opts);
+    const spendLedger = opts.spend === null ? undefined : inspectSpendLedger(opts.spendStatePath);
+    const ledgerBroken = spendLedger === 'corrupt' || spendLedger === 'unavailable';
+    const withHint = (detail) => ledgerBroken ? [detail, SPEND_LEDGER_REPAIR_HINT].filter(Boolean).join(' ') : detail;
     if (!sealed) {
         return {
             state: 'unconfigured',
             modelsEndpoint: 'skipped',
-            detail: 'Run `cleo decide config`.',
+            detail: withHint('Run `cleo decide config`.'),
+            sites,
+            ...(spend ? { spend } : {}),
+            ...(spendLedger ? { spendLedger } : {}),
         };
     }
     const base = {
         baseUrl: sealed.baseUrl,
         keyPreview: sealed.keyPreview,
         ...(sealed.model ? { model: sealed.model } : {}),
+        sites,
+        ...(spend ? { spend } : {}),
+        ...(spendLedger ? { spendLedger } : {}),
     };
+    const now = opts.now ?? Date.now;
     const started = performance.now();
     const signal = AbortSignal.timeout(opts.timeoutMs ?? DEFAULT_DECIDE_PROBE_TIMEOUT_MS);
+    // Capabilities + usage: reuse the cached read unless it is older than 10 minutes.
+    const identity = sealed.connection();
+    const cached = readProviderState(identity, opts.providerStatePath);
+    let state = cached;
+    if (!cached ||
+        opts.refreshCapabilities === true ||
+        now() - cached.detectedAt >= USAGE_REFRESH_MS) {
+        const detected = await detectJevCapabilities(sealed.connection(), signal, {
+            fetch: opts.fetch,
+        });
+        state = {
+            baseUrl: sealed.baseUrl,
+            keyHash: providerKeyHash(identity.apiKey),
+            detectedAt: now(),
+            capabilities: detected.capabilities,
+            ...(detected.usage ? { usage: detected.usage } : {}),
+        };
+        writeProviderState(state, opts.providerStatePath);
+    }
+    const extras = {
+        capabilities: state?.capabilities ?? JEV_MINIMUM_CAPABILITIES,
+        ...(state?.usage
+            ? { usage: { ...state.usage, fetchedAt: new Date(state.detectedAt).toISOString() } }
+            : {}),
+    };
     try {
         const models = await listJevModels(sealed.connection(), signal, { fetch: opts.fetch });
+        const keyLimited = spend?.keyLimitedUntil !== undefined;
         return {
             ...base,
-            state: 'reachable',
+            ...extras,
+            state: keyLimited ? 'key_limit_reached' : 'reachable',
             modelsEndpoint: 'ok',
             models,
             httpStatus: 200,
             latencyMs: Math.round(performance.now() - started),
-            ...(sealed.model ? {} : { detail: NO_MODEL_WARNING }),
+            ...optionalDetail(withHint(keyLimited ? KEY_LIMIT_DETAIL : sealed.model ? undefined : NO_MODEL_WARNING)),
         };
     }
     catch (err) {
         const verdict = stateForError(err);
         return {
             ...base,
+            ...extras,
             ...verdict,
             modelsEndpoint: 'failed',
             latencyMs: Math.round(performance.now() - started),
-            detail: err instanceof Error ? err.message : 'probe failed',
+            ...optionalDetail(withHint(verdict.state === 'key_limit_reached'
+                ? KEY_LIMIT_DETAIL
+                : err instanceof Error
+                    ? err.message
+                    : 'probe failed')),
         };
     }
 }
+/** Resolve the provider kind for {@link configureDecide}. */
+function resolveProviderKind(input, stored) {
+    if (input.provider)
+        return input.provider;
+    const url = input.baseUrl?.trim();
+    if (!url)
+        return stored?.provider ?? 'layahost';
+    if (stored && sameDecideHost(stored.baseUrl, url))
+        return stored.provider;
+    return inferDecisionProviderKind(url);
+}
+/** Resolve the base URL for {@link configureDecide}; throws when `jev` has none. */
+function resolveBaseUrl(input, provider, stored) {
+    const explicit = input.baseUrl?.trim();
+    if (explicit)
+        return explicit;
+    if (stored && stored.provider === provider)
+        return stored.baseUrl;
+    const preset = DECISION_PROVIDER_PRESETS[provider];
+    if (preset.defaultBaseUrl)
+        return preset.defaultBaseUrl;
+    throw new DecideCredentialsError(`the ${provider} provider needs a base URL: pass --url https://your-provider.example (https, or http only for localhost)`);
+}
 /**
- * Store the provider settings, merging omitted values with the stored ones.
+ * Store the provider settings, merging omitted values with the stored ones,
+ * then probe the provider and re-detect its capabilities so its extensions
+ * apply immediately.
  *
- * The Jev `/v1/systemone` endpoint requires a `model`, and no model literal
- * may be hard-coded in core (arch gate 13). So when no model is given (and
- * none is stored for the same URL), this asks the provider (`GET /v1/models`)
- * and stores the FIRST model it lists — the provider's own ordering; layahost
- * lists its routing default first. When that lookup fails the settings are
- * still stored, without a model, and a warning says how to set one.
+ * A model is always stored when one can be known, because the Jev
+ * `/v1/systemone` endpoint rejects a request without one (422, and every
+ * site silently falls back). The model comes from, in order: the flag; the
+ * stored model (same URL); the provider preset (`layahost` →
+ * `LAYAHOST_DEFAULT_MODEL`); the first model the provider lists. Only a
+ * `jev` provider whose listing fails can end with no model, and then a
+ * warning says how to set one.
  *
- * @param input - URL, key, optional model.
- * @returns Secret-free summary plus the model's provenance.
  * A URL whose host differs from the stored one must come with a fresh key:
  * the stored key is never re-used (or sent in the model probe) for a new host.
  *
- * @throws {DecideCredentialsError} On an invalid URL, blank key, invalid model
- *   name, or a host change without a fresh key.
+ * @param input - Provider, URL, key, optional model.
+ * @returns Secret-free summary plus the model's provenance and the probe verdict.
+ * @throws {DecideCredentialsError} On an invalid URL, `jev` without a URL, a
+ *   blank key, an invalid model name, or a host change without a fresh key.
  */
 export async function configureDecide(input) {
     const stored = loadDecideConnection();
-    const baseUrl = input.baseUrl?.trim() || stored?.baseUrl || '';
+    const provider = resolveProviderKind(input, stored);
+    const baseUrl = resolveBaseUrl(input, provider, stored);
     const freshKey = input.apiKey?.trim();
     if (!freshKey && stored && !sameDecideHost(stored.baseUrl, baseUrl)) {
         throw new DecideCredentialsError('changing the provider host requires a fresh key; pass --key-stdin (the stored key is never sent to a new host)');
     }
     const apiKey = freshKey || stored?.connection().apiKey || '';
+    const preset = DECISION_PROVIDER_PRESETS[provider];
     const explicit = input.model?.trim();
+    let model;
+    let modelSource = 'none';
     if (explicit) {
-        return {
-            ...(await saveDecideCredentials({ baseUrl, apiKey, model: explicit })),
-            modelSource: 'flag',
-        };
+        model = explicit;
+        modelSource = 'flag';
+    }
+    else if (stored?.model && stored.baseUrl === baseUrl) {
+        model = stored.model;
+        modelSource = 'stored';
     }
-    if (stored?.model && stored.baseUrl === baseUrl) {
-        const kept = await saveDecideCredentials({ baseUrl, apiKey, model: stored.model });
-        return { ...kept, modelSource: 'stored' };
+    else if (preset.defaultModel) {
+        model = preset.defaultModel;
+        modelSource = 'preset';
     }
-    const saved = await saveDecideCredentials({ baseUrl, apiKey });
+    const saved = await saveDecideCredentials({
+        provider,
+        baseUrl,
+        apiKey,
+        ...(model ? { model } : {}),
+    });
     const probe = await probeDecideProvider({
         connection: loadDecideConnection(),
         fetch: input.fetch,
         timeoutMs: input.timeoutMs,
+        refreshCapabilities: true,
     });
+    const verdict = {
+        providerState: probe.state,
+        ...(probe.capabilities ? { capabilities: probe.capabilities } : {}),
+    };
+    if (model)
+        return { ...saved, modelSource, ...verdict };
     const first = probe.models?.[0];
     if (!first) {
         const why = probe.state === 'reachable' ? 'the provider listed no models' : `probe ${probe.state}`;
         return {
             ...saved,
             modelSource: 'none',
+            ...verdict,
             warning: `No model stored (${why}). ${NO_MODEL_WARNING}`,
         };
     }
-    const withModel = await saveDecideCredentials({ baseUrl, apiKey, model: first });
-    return { ...withModel, modelSource: 'provider-listing' };
+    const withModel = await saveDecideCredentials({ provider, baseUrl, apiKey, model: first });
+    return { ...withModel, modelSource: 'provider-listing', ...verdict };
 }
 /**
  * Remove the stored settings (and rotated backups of them).
@@ -178,7 +315,7 @@ function teeAudit(projectRoot) {
 export async function askDecideDebug(input) {
     const sealed = loadDecideConnection();
     const audit = teeAudit(input.projectRoot);
-    const outcome = await decide('cli.decide-ask', { state: input.state, questions: { answer: { type: 'noul', criteria: input.question } } }, () => ({ answer: NEUTRAL_NOUL }), {
+    const outcome = await decide(DECIDE_ASK_DECISION_SITE.id, { state: input.state, questions: { answer: { type: 'noul', criteria: input.question } } }, () => ({ answer: NEUTRAL_NOUL }), {
         connection: sealed?.connection() ?? null,
         cache: null,
         audit: audit.sink,
@@ -196,4 +333,19 @@ export async function askDecideDebug(input) {
         ...(sealed ? { keyPreview: sealed.keyPreview } : {}),
     };
 }
+/**
+ * `cleo decide budget reset`: start a fresh spend ledger for this month,
+ * moving the old file aside as a receipt. The repair for a corrupt ledger,
+ * which otherwise keeps every site on its heuristic. A readable ledger is
+ * refused unless `opts.force`, and its month-to-date spend is carried over,
+ * so a reset never lifts a reached cap.
+ *
+ * @param statePath - Ledger path. Default: `<cleoHome>/decide/spend.json`.
+ * @param opts - `force` resets a ledger that is not corrupt.
+ * @returns The receipt: previous health, carried spend and where the old file went.
+ * @throws {SpendResetRefusedError} When the ledger is not corrupt and `force` is not set.
+ */
+export async function resetDecideBudget(statePath, opts = {}) {
+    return resetSpendLedger(statePath, Date.now(), opts);
+}
 //# sourceMappingURL=operations.js.map

package/dist/decide/operations.js.map

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

package/dist/decide/provider-state.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Detected provider capabilities and the last usage read, cached per base URL
+ * AND API key in `<cleoHome>/decide/provider-state.json` (T12664). The key is
+ * never stored: the state carries a truncated sha256 of it
+ * ({@link providerKeyHash}), so a different key on the same URL (another
+ * account or plan, with other capabilities) never reuses the cached state.
+ *
+ * Detection (`detectJevCapabilities`) calls `GET /v1/usage` and
+ * `GET /v1/templates`, both of which count toward the provider's rate limit,
+ * so `cleo decide status` refreshes this file at most once every
+ * {@link USAGE_REFRESH_MS}. The client reads it (memoised per process) to
+ * know which extensions the configured provider supports; with no file, or a
+ * file for another base URL or key, the provider is treated as the Jev minimum.
+ *
+ * @task T12664
+ * @epic T12486
+ */
+import type { DecisionProviderCapabilities, DecisionProviderUsage } from '@cleocode/contracts';
+/** Minimum interval between usage/capability refreshes: 10 minutes. */
+export declare const USAGE_REFRESH_MS: number;
+/** The provider identity a cached state belongs to. */
+export interface ProviderStateIdentity {
+    /** Provider base URL. */
+    readonly baseUrl: string;
+    /** API key; only its truncated hash is ever compared or stored. */
+    readonly apiKey: string;
+}
+/**
+ * Non-reversible short identifier of an API key: the first
+ * {@link KEY_HASH_CHARS} hex characters of its sha256. Enough to tell keys
+ * apart in the state file; useless for recovering the key.
+ *
+ * @param apiKey - The API key.
+ * @returns Truncated hex sha256.
+ */
+export declare function providerKeyHash(apiKey: string): string;
+/** One cached provider state. */
+export interface ProviderState {
+    /** Base URL the state was detected for. */
+    readonly baseUrl: string;
+    /** {@link providerKeyHash} of the API key the state was detected with. */
+    readonly keyHash: string;
+    /** Epoch ms of the detection. */
+    readonly detectedAt: number;
+    /** Detected capabilities. */
+    readonly capabilities: DecisionProviderCapabilities;
+    /** Usage read at detection time, when the provider has a usage endpoint. */
+    readonly usage?: DecisionProviderUsage;
+}
+/**
+ * Default location: `<cleoHome>/decide/provider-state.json`.
+ *
+ * @returns Absolute path.
+ */
+export declare function defaultProviderStatePath(): string;
+/**
+ * Read the cached state for a provider URL and key.
+ *
+ * @param identity - The configured base URL and API key.
+ * @param path - State file. Default {@link defaultProviderStatePath}.
+ * @returns The state, or `null` when absent, unreadable, or for another URL
+ *   or key (a state written before keys were recorded counts as another key).
+ */
+export declare function readProviderState(identity: ProviderStateIdentity, path?: string): ProviderState | null;
+/**
+ * Write the cached state (atomic rename). Never throws.
+ *
+ * @param state - State to store.
+ * @param path - State file. Default {@link defaultProviderStatePath}.
+ */
+export declare function writeProviderState(state: ProviderState, path?: string): void;
+/**
+ * Capabilities the client may use for a provider URL and key, memoised per
+ * process for a minute so the hot path does not read the file on every
+ * decision.
+ *
+ * @param identity - The configured base URL and API key.
+ * @param now - Clock, epoch ms.
+ * @param path - State file. Default {@link defaultProviderStatePath}.
+ * @returns Detected capabilities, or `null` (→ the Jev minimum).
+ */
+export declare function cachedCapabilities(identity: ProviderStateIdentity, now?: number, path?: string): DecisionProviderCapabilities | null;
+/**
+ * Clear the in-process memo. Tests only.
+ *
+ * @internal
+ */
+export declare function _resetProviderStateMemoForTest(): void;
+//# sourceMappingURL=provider-state.d.ts.map