@aplaytest/llm 0.1.0

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAG3F,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC;AAE5C,MAAM,WAAW,mBAAoB,SAAQ,sBAAsB;IACjE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC;CACzE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,mBAAwB,GAAG,SAAS,CAgB5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,MAAM,CAG3F"}

package/dist/factory.js

@@ -0,0 +1,58 @@
+/**
+ * Client construction.
+ *
+ * Resolving to an UnavailableLlmClient rather than throwing at startup is the
+ * point: every deterministic feature keeps working, and only the code paths
+ * that genuinely need a model fail — with a reason that names itself.
+ */
+import { AnthropicLlmClient } from './providers/anthropic.js';
+import { UnavailableLlmClient } from './providers/unavailable.js';
+/**
+ * Build an {@link LlmClient} from options and the environment.
+ *
+ * Resolves to {@link UnavailableLlmClient} rather than throwing: every
+ * deterministic feature keeps working, and only paths that genuinely need a
+ * model fail — with a reason that names itself.
+ *
+ * @param options - Provider, API key, and an optional `env` override (tests
+ *   inject this so they never touch `process.env`).
+ * @returns A live Anthropic client, or an unavailable client whose
+ *   `complete()` rejects with `LlmUnavailableError`.
+ *
+ * @example
+ * ```ts
+ * const llm = createLlmClient(); // unavailable when ANTHROPIC_API_KEY is unset
+ * if (!llm.available) {
+ *   // heal, flaky, impact still run
+ * }
+ * ```
+ */
+export function createLlmClient(options = {}) {
+    if (options.disabled === true) {
+        return new UnavailableLlmClient('disabled by --no-llm');
+    }
+    if (options.provider === 'none') {
+        return new UnavailableLlmClient('provider is set to "none"');
+    }
+    const env = options.env ?? process.env;
+    const apiKey = options.apiKey ?? env['ANTHROPIC_API_KEY'];
+    if (apiKey === undefined || apiKey === '') {
+        return new UnavailableLlmClient('ANTHROPIC_API_KEY is not set');
+    }
+    return new AnthropicLlmClient({ ...options, apiKey });
+}
+/**
+ * One-line description of which roles a client can serve, for `aplaytest doctor`
+ * and CLI banners.
+ *
+ * @param client - The client to describe.
+ * @param roles - Roles to include in the description.
+ * @returns `"no model — deterministic tier only"` when unavailable, otherwise
+ *   a `role: model-id` list.
+ */
+export function describeAvailability(client, roles) {
+    if (!client.available)
+        return 'no model — deterministic tier only';
+    return roles.map(role => `${role}: ${client.modelFor(role)}`).join(' · ');
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,kBAAkB,EAA+B,MAAM,0BAA0B,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAWlE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,eAAe,CAAC,UAA+B,EAAE;IAC/D,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC9B,OAAO,IAAI,oBAAoB,CAAC,sBAAsB,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAChC,OAAO,IAAI,oBAAoB,CAAC,2BAA2B,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAE1D,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;QAC1C,OAAO,IAAI,oBAAoB,CAAC,8BAA8B,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,IAAI,kBAAkB,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,KAA2B;IACjF,IAAI,CAAC,MAAM,CAAC,SAAS;QAAE,OAAO,oCAAoC,CAAC;IACnE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC5E,CAAC"}

package/dist/fake.d.ts

@@ -0,0 +1,29 @@
+/**
+ * A scripted client for tests.
+ *
+ * Exported from the package, not hidden in a test folder, because the agent
+ * runtime in @aplaytest/agent needs it too — and because an agent loop that can
+ * only be exercised with a live API key is an agent loop nobody will test.
+ */
+import type { z } from 'zod';
+import { type CompleteRequest, type CompleteResponse, type LlmClient, type ModelRole, type StructuredResponse, type Usage } from './client.js';
+export interface ScriptedTurn {
+    /** Text the model "returns". Objects are serialised. */
+    readonly reply: string | object;
+    readonly refused?: boolean;
+    readonly refusalCategory?: string;
+    readonly usage?: Partial<Usage>;
+}
+export declare class FakeLlmClient implements LlmClient {
+    private readonly script;
+    readonly available = true;
+    /** Every request made, in order — assert against these. */
+    readonly requests: CompleteRequest[];
+    private turn;
+    constructor(script: readonly ScriptedTurn[]);
+    modelFor(role: ModelRole): string;
+    get callCount(): number;
+    complete(request: CompleteRequest): Promise<CompleteResponse>;
+    completeStructured<T>(request: CompleteRequest, schema: z.ZodType<T>): Promise<StructuredResponse<T>>;
+}
+//# sourceMappingURL=fake.d.ts.map

package/dist/fake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../src/fake.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,KAAK,EACX,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACjC;AAED,qBAAa,aAAc,YAAW,SAAS;IAMjC,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,QAAQ,CAAC,SAAS,QAAQ;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAM;IAC1C,OAAO,CAAC,IAAI,CAAK;gBAEY,MAAM,EAAE,SAAS,YAAY,EAAE;IAE5D,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAIjC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEK,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAsB7D,kBAAkB,CAAC,CAAC,EACxB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAmBlC"}

package/dist/fake.js

@@ -0,0 +1,68 @@
+/**
+ * A scripted client for tests.
+ *
+ * Exported from the package, not hidden in a test folder, because the agent
+ * runtime in @aplaytest/agent needs it too — and because an agent loop that can
+ * only be exercised with a live API key is an agent loop nobody will test.
+ */
+import { EMPTY_USAGE, } from './client.js';
+import { RefusalError, StructuredOutputError } from './errors.js';
+import { DEFAULT_MODELS } from './pricing.js';
+export class FakeLlmClient {
+    script;
+    available = true;
+    /** Every request made, in order — assert against these. */
+    requests = [];
+    turn = 0;
+    constructor(script) {
+        this.script = script;
+    }
+    modelFor(role) {
+        return DEFAULT_MODELS[role];
+    }
+    get callCount() {
+        return this.turn;
+    }
+    async complete(request) {
+        this.requests.push(request);
+        const scripted = this.script[this.turn];
+        this.turn += 1;
+        if (scripted === undefined) {
+            throw new Error(`FakeLlmClient ran out of script at call ${this.turn} — the code under test made ` +
+                'more model calls than expected.');
+        }
+        const text = typeof scripted.reply === 'string' ? scripted.reply : JSON.stringify(scripted.reply);
+        return {
+            text: scripted.refused === true ? '' : text,
+            usage: { ...EMPTY_USAGE, outputTokens: text.length, ...scripted.usage },
+            model: this.modelFor(request.role),
+            refused: scripted.refused === true,
+            refusalCategory: scripted.refusalCategory ?? null,
+        };
+    }
+    async completeStructured(request, schema) {
+        const first = await this.complete(request);
+        if (first.refused)
+            throw new RefusalError(first.refusalCategory);
+        const parsed = schema.safeParse(safeJson(first.text));
+        if (parsed.success)
+            return { ...first, value: parsed.data, raw: first.text, repaired: false };
+        const retry = await this.complete(request);
+        if (retry.refused)
+            throw new RefusalError(retry.refusalCategory);
+        const second = schema.safeParse(safeJson(retry.text));
+        if (!second.success) {
+            throw new StructuredOutputError(second.error.issues.map(i => i.message).join(', '), retry.text);
+        }
+        return { ...retry, value: second.data, raw: retry.text, repaired: true };
+    }
+}
+function safeJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return text;
+    }
+}
+//# sourceMappingURL=fake.js.map

package/dist/fake.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @aplaytest/llm — the only package that talks to a model.
+ *
+ * Everything else takes an injected `LlmClient`, which is what keeps a model
+ * SDK out of the reporter (running in every test worker) and lets the agent
+ * loop be tested against a scripted fake.
+ */
+export type { LlmClient, ModelRole, Effort, Message, Usage, CompleteRequest, CompleteResponse, StructuredResponse, } from './client.js';
+export { EMPTY_USAGE } from './client.js';
+export { createLlmClient, describeAvailability } from './factory.js';
+export type { CreateClientOptions, Provider } from './factory.js';
+export { AnthropicLlmClient } from './providers/anthropic.js';
+export { UnavailableLlmClient } from './providers/unavailable.js';
+export { FakeLlmClient } from './fake.js';
+export type { ScriptedTurn } from './fake.js';
+export { BudgetGuard, DEFAULT_BUDGET } from './budget.js';
+export type { BudgetLimits, BudgetState } from './budget.js';
+export { MODELS, DEFAULT_MODELS, DEFAULT_EFFORT, specFor, costUsd, checkCacheable, estimateTokens, } from './pricing.js';
+export type { ModelSpec, TokenCounts, CacheWarning } from './pricing.js';
+export { LlmUnavailableError, BudgetExceededError, RefusalError, StructuredOutputError, } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,SAAS,EACT,SAAS,EACT,MAAM,EACN,OAAO,EACP,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACrE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EACL,MAAM,EACN,cAAc,EACd,cAAc,EACd,OAAO,EACP,OAAO,EACP,cAAc,EACd,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @aplaytest/llm — the only package that talks to a model.
+ *
+ * Everything else takes an injected `LlmClient`, which is what keeps a model
+ * SDK out of the reporter (running in every test worker) and lets the agent
+ * loop be tested against a scripted fake.
+ */
+export { EMPTY_USAGE } from './client.js';
+export { createLlmClient, describeAvailability } from './factory.js';
+export { AnthropicLlmClient } from './providers/anthropic.js';
+export { UnavailableLlmClient } from './providers/unavailable.js';
+export { FakeLlmClient } from './fake.js';
+export { BudgetGuard, DEFAULT_BUDGET } from './budget.js';
+export { MODELS, DEFAULT_MODELS, DEFAULT_EFFORT, specFor, costUsd, checkCacheable, estimateTokens, } from './pricing.js';
+export { LlmUnavailableError, BudgetExceededError, RefusalError, StructuredOutputError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EACL,MAAM,EACN,cAAc,EACd,cAAc,EACd,OAAO,EACP,OAAO,EACP,cAAc,EACd,cAAc,GACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/pricing.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Model selection, pricing, and the cache-prefix rules.
+ *
+ * Cost is computed from real per-token rates rather than estimated, so the
+ * CLI can always disclose what a run actually spent. A user must never have
+ * to wonder whether a number came from a model or a measurement.
+ */
+import type { Effort, ModelRole } from './client.js';
+export interface ModelSpec {
+    readonly id: string;
+    /** USD per million input tokens. */
+    readonly inputPerMTok: number;
+    readonly outputPerMTok: number;
+    /**
+     * Minimum cacheable prefix, in tokens.
+     *
+     * NOT monotonic across generations, which is the trap: 512 on Opus 5 but
+     * 4096 on Haiku 4.5. A conventions block that caches fine on the heal path
+     * can silently fail to cache on the classify path, with no error — just
+     * `cache_creation_input_tokens: 0` forever.
+     */
+    readonly minCacheablePrefix: number;
+    readonly contextWindow: number;
+}
+export declare const MODELS: Readonly<Record<string, ModelSpec>>;
+/**
+ * Role → model. Split by JOB SHAPE, not by a vague quality axis.
+ *
+ *   classify — taxonomy tie-breaks and phrasing. High volume, low stakes, and
+ *              the deterministic tier has already done the real work.
+ *   heal     — ranking pre-verified candidates by intent. A judgement call
+ *              between a handful of options, not a research task.
+ *   author   — planning, browser exploration, code synthesis.
+ */
+export declare const DEFAULT_MODELS: Readonly<Record<ModelRole, string>>;
+export declare const DEFAULT_EFFORT: Readonly<Record<ModelRole, Effort>>;
+export declare function specFor(modelId: string): ModelSpec | null;
+export interface TokenCounts {
+    readonly inputTokens: number;
+    readonly outputTokens: number;
+    readonly cacheReadTokens: number;
+    readonly cacheWriteTokens: number;
+}
+export declare function costUsd(modelId: string, counts: TokenCounts): number;
+export interface CacheWarning {
+    readonly model: string;
+    readonly prefixTokens: number;
+    readonly minimum: number;
+    readonly message: string;
+}
+/** Rough token estimate. Only used to warn, never to bill. */
+export declare function estimateTokens(text: string): number;
+/**
+ * Warn when a prefix is too short to cache on this model.
+ *
+ * Silent is the problem: below the minimum the API simply does not cache and
+ * reports nothing, so the first sign is a bill.
+ */
+export declare function checkCacheable(modelId: string, systemPrompt: string): CacheWarning | null;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;;;;;OAOG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,eAAO,MAAM,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAsBtD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAK9D,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAM9D,CAAC;AAEF,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEzD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAUD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAapE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,8DAA8D;AAC9D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAgBzF"}

package/dist/pricing.js

@@ -0,0 +1,100 @@
+/**
+ * Model selection, pricing, and the cache-prefix rules.
+ *
+ * Cost is computed from real per-token rates rather than estimated, so the
+ * CLI can always disclose what a run actually spent. A user must never have
+ * to wonder whether a number came from a model or a measurement.
+ */
+export const MODELS = {
+    'claude-opus-5': {
+        id: 'claude-opus-5',
+        inputPerMTok: 5,
+        outputPerMTok: 25,
+        minCacheablePrefix: 512,
+        contextWindow: 1_000_000,
+    },
+    'claude-sonnet-5': {
+        id: 'claude-sonnet-5',
+        inputPerMTok: 3,
+        outputPerMTok: 15,
+        minCacheablePrefix: 1024,
+        contextWindow: 1_000_000,
+    },
+    'claude-haiku-4-5': {
+        id: 'claude-haiku-4-5',
+        inputPerMTok: 1,
+        outputPerMTok: 5,
+        minCacheablePrefix: 4096,
+        contextWindow: 200_000,
+    },
+};
+/**
+ * Role → model. Split by JOB SHAPE, not by a vague quality axis.
+ *
+ *   classify — taxonomy tie-breaks and phrasing. High volume, low stakes, and
+ *              the deterministic tier has already done the real work.
+ *   heal     — ranking pre-verified candidates by intent. A judgement call
+ *              between a handful of options, not a research task.
+ *   author   — planning, browser exploration, code synthesis.
+ */
+export const DEFAULT_MODELS = {
+    classify: 'claude-haiku-4-5',
+    heal: 'claude-sonnet-5',
+    author: 'claude-opus-5',
+    vision: 'claude-sonnet-5',
+};
+export const DEFAULT_EFFORT = {
+    classify: 'low',
+    heal: 'medium',
+    // The documented setting for coding and agentic work.
+    author: 'xhigh',
+    vision: 'medium',
+};
+export function specFor(modelId) {
+    return MODELS[modelId] ?? null;
+}
+/**
+ * Cache reads cost ~0.1× base input; writes cost 1.25× (5-minute TTL).
+ * Two requests break even, so an analyze pass over several failures is well
+ * past the threshold on its second call.
+ */
+const CACHE_READ_MULTIPLIER = 0.1;
+const CACHE_WRITE_MULTIPLIER = 1.25;
+export function costUsd(modelId, counts) {
+    const spec = specFor(modelId);
+    if (spec === null)
+        return 0;
+    const perInputToken = spec.inputPerMTok / 1_000_000;
+    const perOutputToken = spec.outputPerMTok / 1_000_000;
+    return (counts.inputTokens * perInputToken +
+        counts.outputTokens * perOutputToken +
+        counts.cacheReadTokens * perInputToken * CACHE_READ_MULTIPLIER +
+        counts.cacheWriteTokens * perInputToken * CACHE_WRITE_MULTIPLIER);
+}
+/** Rough token estimate. Only used to warn, never to bill. */
+export function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Warn when a prefix is too short to cache on this model.
+ *
+ * Silent is the problem: below the minimum the API simply does not cache and
+ * reports nothing, so the first sign is a bill.
+ */
+export function checkCacheable(modelId, systemPrompt) {
+    const spec = specFor(modelId);
+    if (spec === null)
+        return null;
+    const prefixTokens = estimateTokens(systemPrompt);
+    if (prefixTokens >= spec.minCacheablePrefix)
+        return null;
+    return {
+        model: modelId,
+        prefixTokens,
+        minimum: spec.minCacheablePrefix,
+        message: `Cache prefix is ~${prefixTokens} tokens, below the ${spec.minCacheablePrefix}-token ` +
+            `minimum for ${modelId}. cache_control will be silently ignored — no error, just no ` +
+            'caching. Note the minimum is not monotonic across models.',
+    };
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAqBH,MAAM,CAAC,MAAM,MAAM,GAAwC;IACzD,eAAe,EAAE;QACf,EAAE,EAAE,eAAe;QACnB,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,EAAE;QACjB,kBAAkB,EAAE,GAAG;QACvB,aAAa,EAAE,SAAS;KACzB;IACD,iBAAiB,EAAE;QACjB,EAAE,EAAE,iBAAiB;QACrB,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,EAAE;QACjB,kBAAkB,EAAE,IAAI;QACxB,aAAa,EAAE,SAAS;KACzB;IACD,kBAAkB,EAAE;QAClB,EAAE,EAAE,kBAAkB;QACtB,YAAY,EAAE,CAAC;QACf,aAAa,EAAE,CAAC;QAChB,kBAAkB,EAAE,IAAI;QACxB,aAAa,EAAE,OAAO;KACvB;CACF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwC;IACjE,QAAQ,EAAE,kBAAkB;IAC5B,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,iBAAiB;CAC1B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAwC;IACjE,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,QAAQ;IACd,sDAAsD;IACtD,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,MAAM,UAAU,OAAO,CAAC,OAAe;IACrC,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AACjC,CAAC;AASD;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAEpC,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,MAAmB;IAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAE5B,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;IACpD,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa,GAAG,SAAS,CAAC;IAEtD,OAAO,CACL,MAAM,CAAC,WAAW,GAAG,aAAa;QAClC,MAAM,CAAC,YAAY,GAAG,cAAc;QACpC,MAAM,CAAC,eAAe,GAAG,aAAa,GAAG,qBAAqB;QAC9D,MAAM,CAAC,gBAAgB,GAAG,aAAa,GAAG,sBAAsB,CACjE,CAAC;AACJ,CAAC;AASD,8DAA8D;AAC9D,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,YAAoB;IAClE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAE/B,MAAM,YAAY,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAClD,IAAI,YAAY,IAAI,IAAI,CAAC,kBAAkB;QAAE,OAAO,IAAI,CAAC;IAEzD,OAAO;QACL,KAAK,EAAE,OAAO;QACd,YAAY;QACZ,OAAO,EAAE,IAAI,CAAC,kBAAkB;QAChC,OAAO,EACL,oBAAoB,YAAY,sBAAsB,IAAI,CAAC,kBAAkB,SAAS;YACtF,eAAe,OAAO,+DAA+D;YACrF,2DAA2D;KAC9D,CAAC;AACJ,CAAC"}

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The Anthropic provider.
+ *
+ * Three things here are deliberate and easy to get wrong:
+ *
+ *   1. NO sampling parameters. `temperature`, `top_p` and `top_k` are rejected
+ *      with a 400 on current Opus and Sonnet models. Depth is `effort`.
+ *   2. The system prompt is a cacheable block, ordered first. It is the only
+ *      part guaranteed byte-identical across a run, so it is the cache prefix.
+ *   3. `stop_reason: "refusal"` arrives as a normal HTTP 200. Reading
+ *      `content[0]` without checking it will break.
+ */
+import type { z } from 'zod';
+import { EMPTY_USAGE, type CompleteRequest, type CompleteResponse, type LlmClient, type ModelRole, type StructuredResponse, type Usage } from '../client.js';
+export interface AnthropicClientOptions {
+    readonly apiKey?: string | undefined;
+    readonly models?: Partial<Record<ModelRole, string>> | undefined;
+    readonly maxTokens?: number | undefined;
+    /** Emitted for each call so the CLI can disclose model usage inline. */
+    onUsage?: ((usage: Usage, model: string) => void) | undefined;
+}
+export declare class AnthropicLlmClient implements LlmClient {
+    private readonly options;
+    readonly available = true;
+    private readonly anthropic;
+    private readonly models;
+    constructor(options?: AnthropicClientOptions);
+    modelFor(role: ModelRole): string;
+    complete(request: CompleteRequest): Promise<CompleteResponse>;
+    /**
+     * Structured output via the API's own schema constraint, not prompting.
+     *
+     * The earlier implementation asked for JSON in prose and re-parsed the text,
+     * with one repair round when that failed. Measured against the live model,
+     * that is not a robustness question — it is a correctness one. The author
+     * agent's prompt asked for a test plan and never mentioned JSON, so the model
+     * returned an excellent Markdown plan; every field parsed as `undefined`, the
+     * repair round produced more prose, and the run failed after 100 seconds and
+     * $0.19. The repair agent only worked because its prompt happened to carry
+     * "Reply with JSON only, matching this shape:".
+     *
+     * `output_config.format` constrains the response at the API level, so the
+     * schema is enforced rather than requested and the repair round has nothing
+     * left to do.
+     */
+    completeStructured<T>(request: CompleteRequest, schema: z.ZodType<T>): Promise<StructuredResponse<T>>;
+    private toUsage;
+}
+export declare function mergeUsage(a: Usage, b: Usage): Usage;
+export { EMPTY_USAGE };
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EACL,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,KAAK,EACX,MAAM,cAAc,CAAC;AAItB,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,wEAAwE;IACxE,OAAO,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC/D;AAyBD,qBAAa,kBAAmB,YAAW,SAAS;IAKtC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,QAAQ,CAAC,SAAS,QAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;gBAEtB,OAAO,GAAE,sBAA2B;IAMjE,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAI3B,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoCnE;;;;;;;;;;;;;;;OAeG;IACG,kBAAkB,CAAC,CAAC,EACxB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAsDjC,OAAO,CAAC,OAAO;CAShB;AAGD,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,KAAK,CAQpD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/providers/anthropic.js

@@ -0,0 +1,150 @@
+/**
+ * The Anthropic provider.
+ *
+ * Three things here are deliberate and easy to get wrong:
+ *
+ *   1. NO sampling parameters. `temperature`, `top_p` and `top_k` are rejected
+ *      with a 400 on current Opus and Sonnet models. Depth is `effort`.
+ *   2. The system prompt is a cacheable block, ordered first. It is the only
+ *      part guaranteed byte-identical across a run, so it is the cache prefix.
+ *   3. `stop_reason: "refusal"` arrives as a normal HTTP 200. Reading
+ *      `content[0]` without checking it will break.
+ */
+import Anthropic from '@anthropic-ai/sdk';
+import { zodOutputFormat } from '@anthropic-ai/sdk/helpers/zod';
+import { EMPTY_USAGE, } from '../client.js';
+import { RefusalError, StructuredOutputError } from '../errors.js';
+import { DEFAULT_EFFORT, DEFAULT_MODELS, costUsd } from '../pricing.js';
+const DEFAULT_MAX_TOKENS = 16_000;
+function extractText(response) {
+    return response.content
+        .filter(block => block.type === 'text')
+        .map(block => block.text ?? '')
+        .join('');
+}
+export class AnthropicLlmClient {
+    options;
+    available = true;
+    anthropic;
+    models;
+    constructor(options = {}) {
+        this.options = options;
+        this.anthropic =
+            options.apiKey === undefined ? new Anthropic() : new Anthropic({ apiKey: options.apiKey });
+        this.models = { ...DEFAULT_MODELS, ...options.models };
+    }
+    modelFor(role) {
+        return this.models[role];
+    }
+    async complete(request) {
+        const model = this.modelFor(request.role);
+        const response = (await this.anthropic.messages.create({
+            model,
+            max_tokens: request.maxTokens ?? this.options.maxTokens ?? DEFAULT_MAX_TOKENS,
+            // The cache prefix: marked cacheable, and rendered before `messages`.
+            system: [
+                {
+                    type: 'text',
+                    text: request.system,
+                    cache_control: { type: 'ephemeral' },
+                },
+            ],
+            messages: request.messages.map(m => ({ role: m.role, content: m.content })),
+            // Depth, not sampling. `temperature` here would be a 400.
+            output_config: { effort: request.effort ?? DEFAULT_EFFORT[request.role] },
+            thinking: { type: 'adaptive' },
+        }));
+        const usage = this.toUsage(response, model);
+        this.options.onUsage?.(usage, model);
+        const refused = response.stop_reason === 'refusal';
+        return {
+            // Empty on refusal rather than whatever partial text exists: callers
+            // that ignore `refused` should get nothing, not something plausible.
+            text: refused ? '' : extractText(response),
+            usage,
+            model: response.model ?? model,
+            refused,
+            refusalCategory: response.stop_details?.category ?? null,
+        };
+    }
+    /**
+     * Structured output via the API's own schema constraint, not prompting.
+     *
+     * The earlier implementation asked for JSON in prose and re-parsed the text,
+     * with one repair round when that failed. Measured against the live model,
+     * that is not a robustness question — it is a correctness one. The author
+     * agent's prompt asked for a test plan and never mentioned JSON, so the model
+     * returned an excellent Markdown plan; every field parsed as `undefined`, the
+     * repair round produced more prose, and the run failed after 100 seconds and
+     * $0.19. The repair agent only worked because its prompt happened to carry
+     * "Reply with JSON only, matching this shape:".
+     *
+     * `output_config.format` constrains the response at the API level, so the
+     * schema is enforced rather than requested and the repair round has nothing
+     * left to do.
+     */
+    async completeStructured(request, schema) {
+        const model = this.modelFor(request.role);
+        const response = (await this.anthropic.messages.parse({
+            model,
+            max_tokens: request.maxTokens ?? this.options.maxTokens ?? DEFAULT_MAX_TOKENS,
+            system: [
+                {
+                    type: 'text',
+                    text: request.system,
+                    cache_control: { type: 'ephemeral' },
+                },
+            ],
+            messages: request.messages.map(m => ({ role: m.role, content: m.content })),
+            output_config: {
+                effort: request.effort ?? DEFAULT_EFFORT[request.role],
+                format: zodOutputFormat(schema),
+            },
+            thinking: { type: 'adaptive' },
+        }));
+        const usage = this.toUsage(response, model);
+        this.options.onUsage?.(usage, model);
+        if (response.stop_reason === 'refusal') {
+            throw new RefusalError(response.stop_details?.category ?? null);
+        }
+        const text = extractText(response);
+        if (response.parsed_output === null || response.parsed_output === undefined) {
+            // Reached when the response is schema-shaped but fails a constraint the
+            // API does not enforce (string lengths, array bounds — the SDK strips
+            // those from the wire schema and checks them client-side), or when the
+            // turn was truncated. Nothing a retry would fix, so it fails loudly.
+            throw new StructuredOutputError(response.stop_reason === 'max_tokens'
+                ? 'response hit max_tokens before the schema was satisfied'
+                : 'response did not satisfy the schema', text);
+        }
+        return {
+            usage,
+            model: response.model ?? model,
+            refused: false,
+            refusalCategory: null,
+            value: response.parsed_output,
+            raw: text,
+            repaired: false,
+        };
+    }
+    toUsage(response, model) {
+        const counts = {
+            inputTokens: response.usage?.input_tokens ?? 0,
+            outputTokens: response.usage?.output_tokens ?? 0,
+            cacheReadTokens: response.usage?.cache_read_input_tokens ?? 0,
+            cacheWriteTokens: response.usage?.cache_creation_input_tokens ?? 0,
+        };
+        return { ...counts, usd: costUsd(model, counts) };
+    }
+}
+export function mergeUsage(a, b) {
+    return {
+        inputTokens: a.inputTokens + b.inputTokens,
+        outputTokens: a.outputTokens + b.outputTokens,
+        cacheReadTokens: a.cacheReadTokens + b.cacheReadTokens,
+        cacheWriteTokens: a.cacheWriteTokens + b.cacheWriteTokens,
+        usd: a.usd + b.usd,
+    };
+}
+export { EMPTY_USAGE };
+//# sourceMappingURL=anthropic.js.map

package/dist/providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,EACL,WAAW,GAOZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAUxE,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAelC,SAAS,WAAW,CAAC,QAAqB;IACxC,OAAO,QAAQ,CAAC,OAAO;SACpB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;SACtC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;SAC9B,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAGD,MAAM,OAAO,kBAAkB;IAKA;IAJpB,SAAS,GAAG,IAAI,CAAC;IACT,SAAS,CAAY;IACrB,MAAM,CAA4B;IAEnD,YAA6B,UAAkC,EAAE;QAApC,YAAO,GAAP,OAAO,CAA6B;QAC/D,IAAI,CAAC,SAAS;YACZ,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IACzD,CAAC;IAED,QAAQ,CAAC,IAAe;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,OAAwB;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE1C,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;YACrD,KAAK;YACL,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,kBAAkB;YAC7E,sEAAsE;YACtE,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,OAAO,CAAC,MAAM;oBAEpB,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;iBACrC;aACF;YACD,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3E,0DAA0D;YAC1D,aAAa,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACzE,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;SACtB,CAAC,CAA2B,CAAC;QAEvC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAErC,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC;QACnD,OAAO;YACL,qEAAqE;YACrE,qEAAqE;YACrE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC;YAC1C,KAAK;YACL,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,KAAK;YAC9B,OAAO;YACP,eAAe,EAAE,QAAQ,CAAC,YAAY,EAAE,QAAQ,IAAI,IAAI;SACzD,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,kBAAkB,CACtB,OAAwB,EACxB,MAAoB;QAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAE1C,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;YACpD,KAAK;YACL,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,kBAAkB;YAC7E,MAAM,EAAE;gBACN;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,OAAO,CAAC,MAAM;oBACpB,aAAa,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE;iBACrC;aACF;YACD,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3E,aAAa,EAAE;gBACb,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC;gBACtD,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC;aAChC;YACD,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;SACtB,CAAC,CAAyD,CAAC;QAErE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAErC,IAAI,QAAQ,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,YAAY,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;QAEnC,IAAI,QAAQ,CAAC,aAAa,KAAK,IAAI,IAAI,QAAQ,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YAC5E,wEAAwE;YACxE,sEAAsE;YACtE,uEAAuE;YACvE,qEAAqE;YACrE,MAAM,IAAI,qBAAqB,CAC7B,QAAQ,CAAC,WAAW,KAAK,YAAY;gBACnC,CAAC,CAAC,yDAAyD;gBAC3D,CAAC,CAAC,qCAAqC,EACzC,IAAI,CACL,CAAC;QACJ,CAAC;QAED,OAAO;YACL,KAAK;YACL,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,KAAK;YAC9B,OAAO,EAAE,KAAK;YACd,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,QAAQ,CAAC,aAAa;YAC7B,GAAG,EAAE,IAAI;YACT,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAEO,OAAO,CAAC,QAAqB,EAAE,KAAa;QAClD,MAAM,MAAM,GAAG;YACb,WAAW,EAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;YAC9C,YAAY,EAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;YAChD,eAAe,EAAE,QAAQ,CAAC,KAAK,EAAE,uBAAuB,IAAI,CAAC;YAC7D,gBAAgB,EAAE,QAAQ,CAAC,KAAK,EAAE,2BAA2B,IAAI,CAAC;SACnE,CAAC;QACF,OAAO,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;IACpD,CAAC;CACF;AAGD,MAAM,UAAU,UAAU,CAAC,CAAQ,EAAE,CAAQ;IAC3C,OAAO;QACL,WAAW,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;QAC1C,YAAY,EAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY;QAC7C,eAAe,EAAE,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,eAAe;QACtD,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,GAAG,CAAC,CAAC,gBAAgB;QACzD,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG;KACnB,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/providers/unavailable.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The no-model client.
+ *
+ * Every call throws a NAMED error rather than returning empty output. That is
+ * the degradation contract: a command either works, works with reduced scope,
+ * or exits non-zero saying which. What it must never do is quietly produce a
+ * worse answer that looks like a normal one.
+ */
+import type { z } from 'zod';
+import type { CompleteRequest, CompleteResponse, LlmClient, ModelRole, StructuredResponse } from '../client.js';
+export declare class UnavailableLlmClient implements LlmClient {
+    private readonly reason;
+    readonly available = false;
+    constructor(reason: string);
+    modelFor(role: ModelRole): string;
+    complete(_request: CompleteRequest): Promise<CompleteResponse>;
+    completeStructured<T>(_request: CompleteRequest, _schema: z.ZodType<T>): Promise<StructuredResponse<T>>;
+}
+//# sourceMappingURL=unavailable.d.ts.map

package/dist/providers/unavailable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unavailable.d.ts","sourceRoot":"","sources":["../../src/providers/unavailable.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAItB,qBAAa,oBAAqB,YAAW,SAAS;IAGxC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,QAAQ,CAAC,SAAS,SAAS;gBAEE,MAAM,EAAE,MAAM;IAE3C,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM;IAI3B,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI9D,kBAAkB,CAAC,CAAC,EACxB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GACpB,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAGlC"}