@paraharness/claude 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Tornike Tsomaia
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -1,3 +1,64 @@
-# Temporary Holding Version
+# @paraharness/claude
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Anthropic Claude model driver and declarative `claude.*` builders for [Paraharness](https://github.com/paraharness/paraharness). This package connects `P.agent` actors and `P.pool` seat pools to the Anthropic `/v1/messages` API and Claude CLI OAuth subscription seats (`~/.claude-*`), handling ephemeral KV-cache breakpoint injection, cryptographic `thinking` block signature preservation, native JSON-schema structured outputs, and warm-prefix downward fork preparation.
+
+## Installation
+
+With npm:
+
+```bash
+npm install @paraharness/claude @paraharness/core zod
+```
+
+With yarn:
+
+```bash
+yarn add @paraharness/claude @paraharness/core zod
+```
+
+With pnpm:
+
+```bash
+pnpm add @paraharness/claude @paraharness/core zod
+```
+
+## Usage
+
+```ts
+import { P, z } from '@paraharness/core';
+import { createExecutorRegistry } from '@paraharness/core/runtime';
+import { claude, claudeExecutors } from '@paraharness/claude';
+
+const seatA = claude.cliAccount('seat-a').configDir('~/.claude-seat-a');
+const apiFallback = claude.cliAccount('api-fallback').apiKey(P.env('ANTHROPIC_API_KEY'));
+
+const claudeSeats = P.pool('claude-seats')
+  .items(seatA)
+  .strategy('soonest-reset')
+  .fallback(apiFallback);
+
+const opus = claude
+  .model('opus', { id: 'claude-opus-4-6', effort: 'high' })
+  .accountPool(claudeSeats);
+
+const reviewer = P.agent('reviewer')
+  .model(opus)
+  .instructions('Audit the pull request diff and report any security or correctness regressions.')
+  .input(z.object({ diff: z.string() }))
+  .output(
+    z.object({
+      approved: z.boolean(),
+      findings: z.array(z.string()),
+    }),
+  );
+
+const registry = createExecutorRegistry(claudeExecutors);
+```
+
+## Documentation
+
+See the [`@paraharness/claude` API Reference](https://paraharness.github.io/paraharness/modules/_paraharness_claude.html) for full type and builder specifications.
+
+## License
+
+[MIT](./LICENSE) © Tornike Tsomaia

package/dist/builders/claude-account-seat-builder.d.ts

@@ -0,0 +1,44 @@
+import type { AstBuilder, ClaudeAccountSeatNode, EnvRef } from '@paraharness/core';
+/**
+ * Fluent builder for constructing a passive `ClaudeAccountSeatNode` (`type: 'claude:account-seat'`).
+ *
+ * Configures either a Claude CLI subscription seat backed by an OAuth `configDir` or an API key
+ * seat resolved late via `P.env(key)` at turn execution time without import-time I/O.
+ */
+export interface ClaudeAccountSeatBuilder extends AstBuilder<ClaudeAccountSeatNode> {
+    /** Unique identifier of the Claude account seat within capacity pools. */
+    readonly id: string;
+    /**
+     * Binds a filesystem path to a Claude CLI configuration directory containing OAuth credentials.
+     *
+     * Returns a new immutable builder instance with `configDir` set while leaving the receiver unchanged.
+     *
+     * @param {string} path - Path to the Claude CLI directory (such as `'~/.claude-a'`).
+     *
+     * @returns {ClaudeAccountSeatBuilder} New immutable account seat builder with `configDir` configured.
+     *
+     * @throws {Error} If `path` is empty or whitespace-only.
+     */
+    configDir(path: string): ClaudeAccountSeatBuilder;
+    /**
+     * Binds a literal API key or symbolic `P.env(key)` reference for Anthropic API authentication.
+     *
+     * Returns a new immutable builder instance that resolves the key only at leaf turn invocation time.
+     *
+     * @param {string | EnvRef} envOrKey - Symbolic `EnvRef` or literal API key string.
+     *
+     * @returns {ClaudeAccountSeatBuilder} New immutable account seat builder with `apiKey` configured.
+     *
+     * @throws {Error} If `envOrKey` is an empty or whitespace-only string.
+     */
+    apiKey(envOrKey: string | EnvRef): ClaudeAccountSeatBuilder;
+    /**
+     * Compiles the builder configuration into a deeply frozen passive `ClaudeAccountSeatNode` AST node.
+     *
+     * Preserves a monomorphic property shape with `type: 'claude:account-seat'` and zero runtime methods.
+     *
+     * @returns {ClaudeAccountSeatNode} Frozen passive AST node representing the Claude account seat.
+     */
+    toAST(): ClaudeAccountSeatNode;
+}
+//# sourceMappingURL=claude-account-seat-builder.d.ts.map

package/dist/builders/claude-account-seat-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-account-seat-builder.d.ts","sourceRoot":"","sources":["../../src/builders/claude-account-seat-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,WAAW,wBAAyB,SAAQ,UAAU,CAAC,qBAAqB,CAAC;IACjF,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,CAAC;IAElD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,wBAAwB,CAAC;IAE5D;;;;;;OAMG;IACH,KAAK,IAAI,qBAAqB,CAAC;CAChC"}

package/dist/builders/claude-account-seat-builder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude-account-seat-builder.js.map

package/dist/builders/claude-account-seat-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-account-seat-builder.js","sourceRoot":"","sources":["../../src/builders/claude-account-seat-builder.ts"],"names":[],"mappings":""}

package/dist/builders/claude-model-builder.d.ts

@@ -0,0 +1,52 @@
+import type { AstBuilder, ClaudeAccountSeatNode, ClaudeModelNode, MaybeBuilder, PoolNode } from '@paraharness/core';
+/**
+ * Fluent builder for constructing a passive `ClaudeModelNode` (`type: 'claude:model'`).
+ *
+ * Binds an Anthropic model identifier, optional reasoning effort budget, and an optional
+ * `P.pool` of `ClaudeAccountSeatNode` seats with run-sticky KV-cache affinity.
+ */
+export interface ClaudeModelBuilder extends AstBuilder<ClaudeModelNode> {
+    /** Logical alias of the model within the harness definition. */
+    readonly alias: string;
+    /** Provider-specific Anthropic model identifier transmitted on the wire. */
+    readonly modelId: string;
+    /**
+     * Configures the reasoning effort level for extended thinking turns on this Claude model.
+     *
+     * Returns a new immutable `ClaudeModelBuilder` with the updated effort level.
+     *
+     * @param {'low' | 'medium' | 'high'} level - Extended thinking effort level.
+     *
+     * @returns {ClaudeModelBuilder} New immutable model builder with `effort` configured.
+     */
+    effort(level: 'low' | 'medium' | 'high'): ClaudeModelBuilder;
+    /**
+     * Attaches a capacity pool of `ClaudeAccountSeatNode` seats to multiplex requests with run-sticky affinity.
+     *
+     * Accepts either a compiled `PoolNode<ClaudeAccountSeatNode>` or a `PoolBuilder` instance.
+     *
+     * @param {MaybeBuilder<PoolNode<ClaudeAccountSeatNode>>} pool - Account seat pool node or builder.
+     *
+     * @returns {ClaudeModelBuilder} New immutable model builder bound to the specified account seat pool.
+     */
+    accountPool(pool: MaybeBuilder<PoolNode<ClaudeAccountSeatNode>>): ClaudeModelBuilder;
+    /**
+     * Alias for `accountPool(pool)` attaching a capacity pool of `ClaudeAccountSeatNode` seats.
+     *
+     * Preserves API symmetry across `@paraharness/claude`, `@paraharness/openai`, and `@paraharness/gemini`.
+     *
+     * @param {MaybeBuilder<PoolNode<ClaudeAccountSeatNode>>} pool - Account seat pool node or builder.
+     *
+     * @returns {ClaudeModelBuilder} New immutable model builder bound to the specified account seat pool.
+     */
+    pool(pool: MaybeBuilder<PoolNode<ClaudeAccountSeatNode>>): ClaudeModelBuilder;
+    /**
+     * Compiles the builder configuration into a deeply frozen passive `ClaudeModelNode` AST node.
+     *
+     * Produces a monomorphic AST node with `type: 'claude:model'` and `vendor: 'anthropic'`.
+     *
+     * @returns {ClaudeModelNode} Frozen passive AST node representing the Claude model.
+     */
+    toAST(): ClaudeModelNode;
+}
+//# sourceMappingURL=claude-model-builder.d.ts.map

package/dist/builders/claude-model-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-model-builder.d.ts","sourceRoot":"","sources":["../../src/builders/claude-model-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,QAAQ,EACT,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,WAAW,kBAAmB,SAAQ,UAAU,CAAC,eAAe,CAAC;IACrE,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;;;;;;;OAQG;IACH,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,kBAAkB,CAAC;IAE7D;;;;;;;;OAQG;IACH,WAAW,CAAC,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,GAAG,kBAAkB,CAAC;IAErF;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,GAAG,kBAAkB,CAAC;IAE9E;;;;;;OAMG;IACH,KAAK,IAAI,eAAe,CAAC;CAC1B"}

package/dist/builders/claude-model-builder.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude-model-builder.js.map

package/dist/builders/claude-model-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-model-builder.js","sourceRoot":"","sources":["../../src/builders/claude-model-builder.ts"],"names":[],"mappings":""}

package/dist/builders/claude-model-options.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Configuration options for declaring an Anthropic Claude model via `claude.model(alias, options)`.
+ *
+ * Specifies the provider-level model identifier transmitted to `/v1/messages` and the optional
+ * extended thinking effort budget applied across turns.
+ */
+export interface ClaudeModelOptions {
+    /** Anthropic wire model identifier (such as `'claude-sonnet-4-6'` or `'claude-opus-4-6'`). */
+    readonly id: string;
+    /** Optional reasoning effort level controlling extended thinking budget allocation. */
+    readonly effort?: 'low' | 'medium' | 'high';
+}
+//# sourceMappingURL=claude-model-options.d.ts.map

package/dist/builders/claude-model-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-model-options.d.ts","sourceRoot":"","sources":["../../src/builders/claude-model-options.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,uFAAuF;IACvF,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CAC7C"}

package/dist/builders/claude-model-options.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude-model-options.js.map

package/dist/builders/claude-model-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-model-options.js","sourceRoot":"","sources":["../../src/builders/claude-model-options.ts"],"names":[],"mappings":""}

package/dist/builders/claude-namespace-contract.d.ts

@@ -0,0 +1,49 @@
+import type { ClaudeAccountSeatBuilder } from './claude-account-seat-builder.js';
+import type { ClaudeModelBuilder } from './claude-model-builder.js';
+import type { ClaudeModelOptions } from './claude-model-options.js';
+/**
+ * Builder namespace contract exported as `claude` by `@paraharness/claude`.
+ *
+ * Provides entrypoints for declaring passive `ClaudeAccountSeatNode` and `ClaudeModelNode`
+ * AST descriptors without import-time or declaration-time side effects.
+ */
+export interface ClaudeNamespace {
+    /**
+     * Declares a Claude CLI subscription or API fallback seat (`type: 'claude:account-seat'`).
+     *
+     * Supports `.configDir(path)` for OAuth credential extraction and `.apiKey(envRef)` for API key fallback.
+     *
+     * @param {string} id - Unique identifier for the Claude account seat.
+     *
+     * @returns {ClaudeAccountSeatBuilder} Fluent builder for the Claude account seat.
+     *
+     * @throws {Error} If `id` is empty or whitespace-only.
+     */
+    cliAccount(id: string): ClaudeAccountSeatBuilder;
+    /**
+     * Declares a Claude account seat (`type: 'claude:account-seat'`).
+     *
+     * Alias for `cliAccount(id)` supporting both `.apiKey(envRef)` and `.configDir(path)` configurations.
+     *
+     * @param {string} id - Unique identifier for the Claude account seat.
+     *
+     * @returns {ClaudeAccountSeatBuilder} Fluent builder for the Claude account seat.
+     *
+     * @throws {Error} If `id` is empty or whitespace-only.
+     */
+    account(id: string): ClaudeAccountSeatBuilder;
+    /**
+     * Declares an Anthropic Claude model configuration (`type: 'claude:model'`, `vendor: 'anthropic'`).
+     *
+     * Supports `.accountPool(pool)` / `.pool(pool)` and `.effort(level)` before compiling to `ClaudeModelNode`.
+     *
+     * @param {string}             alias   - Logical model alias (such as `'sonnet'` or `'opus'`).
+     * @param {ClaudeModelOptions} options - Anthropic model identifier and optional thinking effort.
+     *
+     * @returns {ClaudeModelBuilder} Fluent builder for the Claude model node.
+     *
+     * @throws {Error} If `alias` or `options.id` is empty or whitespace-only.
+     */
+    model(alias: string, options: ClaudeModelOptions): ClaudeModelBuilder;
+}
+//# sourceMappingURL=claude-namespace-contract.d.ts.map

package/dist/builders/claude-namespace-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-namespace-contract.d.ts","sourceRoot":"","sources":["../../src/builders/claude-namespace-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,CAAC;IAEjD;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,CAAC;IAE9C;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAAC;CACvE"}

package/dist/builders/claude-namespace-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude-namespace-contract.js.map

package/dist/builders/claude-namespace-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-namespace-contract.js","sourceRoot":"","sources":["../../src/builders/claude-namespace-contract.ts"],"names":[],"mappings":""}

package/dist/builders/claude-namespace.d.ts

@@ -0,0 +1,4 @@
+import type { ClaudeNamespace } from './claude-namespace-contract.js';
+/** Frozen `claude` builder namespace for constructing passive Anthropic AST nodes. */
+export declare const claude: ClaudeNamespace;
+//# sourceMappingURL=claude-namespace.d.ts.map

package/dist/builders/claude-namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-namespace.d.ts","sourceRoot":"","sources":["../../src/builders/claude-namespace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAItE,sFAAsF;AACtF,eAAO,MAAM,MAAM,EAAE,eAInB,CAAC"}

package/dist/builders/claude-namespace.js

@@ -0,0 +1,9 @@
+import { createClaudeAccountSeatBuilder } from './create-claude-account-seat-builder.js';
+import { createClaudeModelBuilder } from './create-claude-model-builder.js';
+/** Frozen `claude` builder namespace for constructing passive Anthropic AST nodes. */
+export const claude = Object.freeze({
+    cliAccount: (id) => createClaudeAccountSeatBuilder(id),
+    account: (id) => createClaudeAccountSeatBuilder(id),
+    model: (alias, options) => createClaudeModelBuilder(alias, options),
+});
+//# sourceMappingURL=claude-namespace.js.map

package/dist/builders/claude-namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-namespace.js","sourceRoot":"","sources":["../../src/builders/claude-namespace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,sFAAsF;AACtF,MAAM,CAAC,MAAM,MAAM,GAAoB,MAAM,CAAC,MAAM,CAAkB;IACpE,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,8BAA8B,CAAC,EAAE,CAAC;IACtD,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,8BAA8B,CAAC,EAAE,CAAC;IACnD,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,CAAC;CACpE,CAAC,CAAC"}

package/dist/builders/create-claude-account-seat-builder.d.ts

@@ -0,0 +1,18 @@
+import type { EnvRef } from '@paraharness/core';
+import type { ClaudeAccountSeatBuilder } from './claude-account-seat-builder.js';
+/**
+ * Creates an immutable `ClaudeAccountSeatBuilder` for an Anthropic CLI subscription or API key seat.
+ *
+ * Performs zero filesystem reads or environment variable lookups at builder construction time,
+ * deferring credential extraction to `ClaudeModelDriver.invokeTurn()`.
+ *
+ * @param {string}                      id        - Non-empty unique seat identifier.
+ * @param {string | undefined}          configDir - Optional Claude CLI OAuth configuration directory path.
+ * @param {string | EnvRef | undefined} apiKey    - Optional literal API key or symbolic `EnvRef`.
+ *
+ * @returns {ClaudeAccountSeatBuilder} Immutable builder compiling to `ClaudeAccountSeatNode`.
+ *
+ * @throws {Error} If `id` is empty or whitespace-only.
+ */
+export declare function createClaudeAccountSeatBuilder(id: string, configDir?: string, apiKey?: string | EnvRef): ClaudeAccountSeatBuilder;
+//# sourceMappingURL=create-claude-account-seat-builder.d.ts.map

package/dist/builders/create-claude-account-seat-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-claude-account-seat-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-claude-account-seat-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAEjF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,MAAM,EACV,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GACvB,wBAAwB,CA4B1B"}

package/dist/builders/create-claude-account-seat-builder.js

@@ -0,0 +1,44 @@
+/**
+ * Creates an immutable `ClaudeAccountSeatBuilder` for an Anthropic CLI subscription or API key seat.
+ *
+ * Performs zero filesystem reads or environment variable lookups at builder construction time,
+ * deferring credential extraction to `ClaudeModelDriver.invokeTurn()`.
+ *
+ * @param {string}                      id        - Non-empty unique seat identifier.
+ * @param {string | undefined}          configDir - Optional Claude CLI OAuth configuration directory path.
+ * @param {string | EnvRef | undefined} apiKey    - Optional literal API key or symbolic `EnvRef`.
+ *
+ * @returns {ClaudeAccountSeatBuilder} Immutable builder compiling to `ClaudeAccountSeatNode`.
+ *
+ * @throws {Error} If `id` is empty or whitespace-only.
+ */
+export function createClaudeAccountSeatBuilder(id, configDir, apiKey) {
+    if (id.trim().length === 0) {
+        throw new Error('Claude account seat id must be a non-empty string.');
+    }
+    const astNode = Object.freeze({
+        type: 'claude:account-seat',
+        id,
+        configDir,
+        apiKey,
+    });
+    return Object.freeze({
+        id,
+        configDir(path) {
+            if (path.trim().length === 0) {
+                throw new Error(`Claude account seat '${id}' configDir must be a non-empty path.`);
+            }
+            return createClaudeAccountSeatBuilder(id, path, apiKey);
+        },
+        apiKey(envOrKey) {
+            if (typeof envOrKey === 'string' && envOrKey.trim().length === 0) {
+                throw new Error(`Claude account seat '${id}' apiKey string must be non-empty.`);
+            }
+            return createClaudeAccountSeatBuilder(id, configDir, envOrKey);
+        },
+        toAST() {
+            return astNode;
+        },
+    });
+}
+//# sourceMappingURL=create-claude-account-seat-builder.js.map

package/dist/builders/create-claude-account-seat-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-claude-account-seat-builder.js","sourceRoot":"","sources":["../../src/builders/create-claude-account-seat-builder.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,8BAA8B,CAC5C,EAAU,EACV,SAAkB,EAClB,MAAwB;IAExB,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAwB;QACnD,IAAI,EAAE,qBAAqB;QAC3B,EAAE;QACF,SAAS;QACT,MAAM;KACP,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAA2B;QAC7C,EAAE;QACF,SAAS,CAAC,IAAY;YACpB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,wBAAwB,EAAE,uCAAuC,CAAC,CAAC;YACrF,CAAC;YACD,OAAO,8BAA8B,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,CAAC,QAAyB;YAC9B,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjE,MAAM,IAAI,KAAK,CAAC,wBAAwB,EAAE,oCAAoC,CAAC,CAAC;YAClF,CAAC;YACD,OAAO,8BAA8B,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACjE,CAAC;QACD,KAAK;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/builders/create-claude-model-builder.d.ts

@@ -0,0 +1,19 @@
+import { type ClaudeAccountSeatNode, type PoolNode } from '@paraharness/core';
+import type { ClaudeModelBuilder } from './claude-model-builder.js';
+import type { ClaudeModelOptions } from './claude-model-options.js';
+/**
+ * Creates an immutable `ClaudeModelBuilder` for an Anthropic Claude model configuration.
+ *
+ * Validates that both `alias` and `options.id` are non-empty strings and compiles to a frozen
+ * passive `ClaudeModelNode` without performing network or environment I/O.
+ *
+ * @param {string}                                      alias       - Logical alias of the model.
+ * @param {ClaudeModelOptions}                          options     - Provider model identifier and optional effort level.
+ * @param {PoolNode<ClaudeAccountSeatNode> | undefined} accountPool - Optional compiled pool of Claude account seats.
+ *
+ * @returns {ClaudeModelBuilder} Immutable builder compiling to `ClaudeModelNode`.
+ *
+ * @throws {Error} If `alias` or `options.id` is empty or whitespace-only.
+ */
+export declare function createClaudeModelBuilder(alias: string, options: ClaudeModelOptions, accountPool?: PoolNode<ClaudeAccountSeatNode>): ClaudeModelBuilder;
+//# sourceMappingURL=create-claude-model-builder.d.ts.map

package/dist/builders/create-claude-model-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-claude-model-builder.d.ts","sourceRoot":"","sources":["../../src/builders/create-claude-model-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,qBAAqB,EAG1B,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,EAC3B,WAAW,CAAC,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAC5C,kBAAkB,CA+BpB"}

package/dist/builders/create-claude-model-builder.js

@@ -0,0 +1,48 @@
+import { extractAST, } from '@paraharness/core';
+/**
+ * Creates an immutable `ClaudeModelBuilder` for an Anthropic Claude model configuration.
+ *
+ * Validates that both `alias` and `options.id` are non-empty strings and compiles to a frozen
+ * passive `ClaudeModelNode` without performing network or environment I/O.
+ *
+ * @param {string}                                      alias       - Logical alias of the model.
+ * @param {ClaudeModelOptions}                          options     - Provider model identifier and optional effort level.
+ * @param {PoolNode<ClaudeAccountSeatNode> | undefined} accountPool - Optional compiled pool of Claude account seats.
+ *
+ * @returns {ClaudeModelBuilder} Immutable builder compiling to `ClaudeModelNode`.
+ *
+ * @throws {Error} If `alias` or `options.id` is empty or whitespace-only.
+ */
+export function createClaudeModelBuilder(alias, options, accountPool) {
+    if (alias.trim().length === 0) {
+        throw new Error('Claude model alias must be a non-empty string.');
+    }
+    if (options.id.trim().length === 0) {
+        throw new Error(`Claude model '${alias}' options.id must be a non-empty string.`);
+    }
+    const astNode = Object.freeze({
+        type: 'claude:model',
+        vendor: 'anthropic',
+        alias,
+        modelId: options.id,
+        effort: options.effort,
+        accountPool,
+    });
+    return Object.freeze({
+        alias,
+        modelId: options.id,
+        effort(level) {
+            return createClaudeModelBuilder(alias, { id: options.id, effort: level }, accountPool);
+        },
+        accountPool(pool) {
+            return createClaudeModelBuilder(alias, options, extractAST(pool));
+        },
+        pool(pool) {
+            return createClaudeModelBuilder(alias, options, extractAST(pool));
+        },
+        toAST() {
+            return astNode;
+        },
+    });
+}
+//# sourceMappingURL=create-claude-model-builder.js.map

package/dist/builders/create-claude-model-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-claude-model-builder.js","sourceRoot":"","sources":["../../src/builders/create-claude-model-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,GAKX,MAAM,mBAAmB,CAAC;AAI3B;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,OAA2B,EAC3B,WAA6C;IAE7C,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,0CAA0C,CAAC,CAAC;IACpF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAkB;QAC7C,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,WAAW;QACnB,KAAK;QACL,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW;KACZ,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAqB;QACvC,KAAK;QACL,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,MAAM,CAAC,KAAgC;YACrC,OAAO,wBAAwB,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,WAAW,CAAC,CAAC;QACzF,CAAC;QACD,WAAW,CAAC,IAAmD;YAC7D,OAAO,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,IAAmD;YACtD,OAAO,wBAAwB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,KAAK;YACH,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/driver/claude-executors.constants.d.ts

@@ -0,0 +1,4 @@
+import type { RuntimeExecutorRegistrySlice } from '@paraharness/core';
+/** Default `RuntimeExecutorRegistrySlice` for `@paraharness/claude` (`models['claude:model']`). */
+export declare const claudeExecutors: RuntimeExecutorRegistrySlice;
+//# sourceMappingURL=claude-executors.constants.d.ts.map

package/dist/driver/claude-executors.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-executors.constants.d.ts","sourceRoot":"","sources":["../../src/driver/claude-executors.constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,mBAAmB,CAAC;AAGtE,mGAAmG;AACnG,eAAO,MAAM,eAAe,EAAE,4BAAsD,CAAC"}

package/dist/driver/claude-executors.constants.js

@@ -0,0 +1,4 @@
+import { createClaudeExecutors } from './create-claude-executors.js';
+/** Default `RuntimeExecutorRegistrySlice` for `@paraharness/claude` (`models['claude:model']`). */
+export const claudeExecutors = createClaudeExecutors();
+//# sourceMappingURL=claude-executors.constants.js.map

package/dist/driver/claude-executors.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-executors.constants.js","sourceRoot":"","sources":["../../src/driver/claude-executors.constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,mGAAmG;AACnG,MAAM,CAAC,MAAM,eAAe,GAAiC,qBAAqB,EAAE,CAAC"}

package/dist/driver/claude-http-request.d.ts

@@ -0,0 +1,23 @@
+/**
+ * HTTP request descriptor passed to `ClaudeHttpTransport.sendMessagesRequest()`.
+ *
+ * Encapsulates the target Anthropic `/v1/messages` endpoint URL, authentication headers,
+ * wire-formatted JSON request payload, resolved seat metadata, and optional abort signal.
+ */
+export interface ClaudeHttpRequest {
+    /** Target Anthropic Messages API endpoint URL. */
+    readonly url: string;
+    /** HTTP request headers including `anthropic-version` and OAuth bearer or `x-api-key` credentials. */
+    readonly headers: Readonly<Record<string, string>>;
+    /** Serialized Anthropic `/v1/messages` request payload object. */
+    readonly body: Readonly<Record<string, unknown>>;
+    /** Optional identifier of the active `ClaudeAccountSeatNode` selected for this turn. */
+    readonly seatId?: string;
+    /** Resolved authentication mechanism used for the request (`'cli-oauth'`, `'api-key'`, or `'none'`). */
+    readonly authSource?: 'cli-oauth' | 'api-key' | 'none';
+    /** Optional abort signal cancelling the in-flight HTTP request. */
+    readonly signal?: AbortSignal;
+    /** Optional custom `fetch` implementation passed to the underlying `@anthropic-ai/sdk` client. */
+    readonly fetch?: typeof globalThis.fetch;
+}
+//# sourceMappingURL=claude-http-request.d.ts.map

package/dist/driver/claude-http-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-http-request.d.ts","sourceRoot":"","sources":["../../src/driver/claude-http-request.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sGAAsG;IACtG,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,wFAAwF;IACxF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wGAAwG;IACxG,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;IACvD,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,kGAAkG;IAClG,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC1C"}

package/dist/driver/claude-http-request.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude-http-request.js.map

package/dist/driver/claude-http-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-http-request.js","sourceRoot":"","sources":["../../src/driver/claude-http-request.ts"],"names":[],"mappings":""}

package/dist/driver/claude-http-response.d.ts

@@ -0,0 +1,19 @@
+/**
+ * HTTP response descriptor returned by `ClaudeHttpTransport.sendMessagesRequest()`.
+ *
+ * Carries the HTTP status code, parsed JSON response payload or raw text body from Anthropic
+ * `/v1/messages`, response headers, and optional rate-limit cooldown reset timestamp when `status === 429`.
+ */
+export interface ClaudeHttpResponse {
+    /** HTTP status code returned by the Anthropic `/v1/messages` endpoint. */
+    readonly status: number;
+    /** Parsed JSON response body returned by the Anthropic API when available. */
+    readonly body?: Readonly<Record<string, unknown>>;
+    /** Optional raw HTTP response body text before JSON parsing. */
+    readonly bodyText?: string;
+    /** Optional HTTP response headers map (`retry-after`, etc.). */
+    readonly headers?: Readonly<Record<string, string>>;
+    /** Optional epoch timestamp in milliseconds when an HTTP `429` rate limit resets. */
+    readonly resetAtMs?: number;
+}
+//# sourceMappingURL=claude-http-response.d.ts.map

package/dist/driver/claude-http-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-http-response.d.ts","sourceRoot":"","sources":["../../src/driver/claude-http-response.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,qFAAqF;IACrF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/driver/claude-http-response.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude-http-response.js.map

package/dist/driver/claude-http-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-http-response.js","sourceRoot":"","sources":["../../src/driver/claude-http-response.ts"],"names":[],"mappings":""}

package/dist/driver/claude-http-transport.d.ts

@@ -0,0 +1,24 @@
+import type { ClaudeHttpRequest } from './claude-http-request.js';
+import type { ClaudeHttpResponse } from './claude-http-response.js';
+/**
+ * Injectable HTTP transport port for dispatching Anthropic `/v1/messages` requests.
+ *
+ * Allows `ClaudeModelDriver` to execute against either the production `fetch` transport
+ * or deterministic recorded transport fixtures in unit and integration tests.
+ */
+export interface ClaudeHttpTransport {
+    /**
+     * Sends a single `/v1/messages` POST request to the Anthropic API and returns the parsed response.
+     *
+     * Implementations must honor `request.signal` and return status `429` with `resetAtMs` rather
+     * than swallowing rate-limit responses so `PoolManager` can fail over across seats.
+     *
+     * @param {ClaudeHttpRequest} request - Wire-formatted Anthropic Messages API request.
+     *
+     * @returns {Promise<ClaudeHttpResponse>} HTTP status code, response body, and optional rate-limit reset timestamp.
+     *
+     * @throws {Error} If `request.signal` is aborted or an unrecoverable transport failure occurs.
+     */
+    sendMessagesRequest(request: ClaudeHttpRequest): Promise<ClaudeHttpResponse>;
+}
+//# sourceMappingURL=claude-http-transport.d.ts.map

package/dist/driver/claude-http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-http-transport.d.ts","sourceRoot":"","sources":["../../src/driver/claude-http-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC9E"}

package/dist/driver/claude-http-transport.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claude-http-transport.js.map

package/dist/driver/claude-http-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-http-transport.js","sourceRoot":"","sources":["../../src/driver/claude-http-transport.ts"],"names":[],"mappings":""}