@paraharness/claude 0.0.0-stage → 0.2.0

package/dist/driver/internal/claude-prepare-fork.js

@@ -0,0 +1,59 @@
+import { buildClaudePairedForkToolFrame } from './build-claude-paired-fork-tool-frame.js';
+import { buildClaudeUserFrame } from './build-claude-user-frame.js';
+import { formatClaudeForkPromptText } from './format-claude-fork-prompt-text.js';
+import { sliceClaudeParentChain } from './slice-claude-parent-chain.js';
+import { transformClaudeForkFrame } from './transform-claude-fork-frame.js';
+/**
+ * Synthesizes the initial `WireFrameRecord[]` chain for an Anthropic downward fork or cross-model escalation.
+ *
+ * Handles `'shared-prefix-only'` clean starts, `'clone-transcript'` with `substituteTombstones` (`false` vs `true`),
+ * and full-turn `(1..k)` `tool_result` pairing whenever `ctx.forkCallId` is set on an assistant tool-call turn.
+ *
+ * @param {ForkContext}       ctx    - Fork lineage, history mode, and assistant turn-batch metadata.
+ * @param {PrepareForkTarget} target - Target model configuration and `substituteTombstones` flag.
+ *
+ * @returns {readonly WireFrameRecord[]} Synthesized wire frame chain to persist in `LedgerStore`.
+ */
+export function claudePrepareFork(ctx, target) {
+    const combinedPrompt = formatClaudeForkPromptText(ctx);
+    if (ctx.historyMode === 'shared-prefix-only') {
+        if (combinedPrompt.length === 0) {
+            return Object.freeze([]);
+        }
+        return Object.freeze([
+            buildClaudeUserFrame({
+                messageId: `msg:fork:${target.modelId}:turn-0`,
+                parentMessageId: null,
+                text: combinedPrompt,
+            }),
+        ]);
+    }
+    const sliced = sliceClaudeParentChain(ctx);
+    const frames = [];
+    for (let idx = 0; idx < sliced.length; idx += 1) {
+        const sourceFrame = sliced[idx];
+        if (sourceFrame !== undefined) {
+            frames.push(transformClaudeForkFrame({
+                frame: sourceFrame,
+                substituteTombstones: target.substituteTombstones,
+                isForkPoint: idx === sliced.length - 1,
+            }));
+        }
+    }
+    const lastFrame = frames[frames.length - 1];
+    if (lastFrame !== undefined &&
+        (lastFrame.canonical.toolCalls?.length ?? 0) > 0 &&
+        ctx.forkCallId !== undefined) {
+        frames.push(buildClaudePairedForkToolFrame(ctx, lastFrame));
+    }
+    else if (ctx.childRoleContextFrameText !== undefined &&
+        ctx.childRoleContextFrameText.length > 0) {
+        frames.push(buildClaudeUserFrame({
+            messageId: `${lastFrame?.messageId ?? 'root'}:fork-context`,
+            parentMessageId: lastFrame?.messageId ?? null,
+            text: combinedPrompt,
+        }));
+    }
+    return Object.freeze(frames);
+}
+//# sourceMappingURL=claude-prepare-fork.js.map

package/dist/driver/internal/claude-prepare-fork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-prepare-fork.js","sourceRoot":"","sources":["../../../src/driver/internal/claude-prepare-fork.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAgB,EAChB,MAAyB;IAEzB,MAAM,cAAc,GAAG,0BAA0B,CAAC,GAAG,CAAC,CAAC;IACvD,IAAI,GAAG,CAAC,WAAW,KAAK,oBAAoB,EAAE,CAAC;QAC7C,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,oBAAoB,CAAC;gBACnB,SAAS,EAAE,YAAY,MAAM,CAAC,OAAO,SAAS;gBAC9C,eAAe,EAAE,IAAI;gBACrB,IAAI,EAAE,cAAc;aACrB,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IACD,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CACT,wBAAwB,CAAC;gBACvB,KAAK,EAAE,WAAW;gBAClB,oBAAoB,EAAE,MAAM,CAAC,oBAAoB;gBACjD,WAAW,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC;aACvC,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC5C,IACE,SAAS,KAAK,SAAS;QACvB,CAAC,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QAChD,GAAG,CAAC,UAAU,KAAK,SAAS,EAC5B,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,8BAA8B,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9D,CAAC;SAAM,IACL,GAAG,CAAC,yBAAyB,KAAK,SAAS;QAC3C,GAAG,CAAC,yBAAyB,CAAC,MAAM,GAAG,CAAC,EACxC,CAAC;QACD,MAAM,CAAC,IAAI,CACT,oBAAoB,CAAC;YACnB,SAAS,EAAE,GAAG,SAAS,EAAE,SAAS,IAAI,MAAM,eAAe;YAC3D,eAAe,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI;YAC7C,IAAI,EAAE,cAAc;SACrB,CAAC,CACH,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/dist/driver/internal/claude-seat-auth.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Resolved Anthropic authentication headers and active seat metadata for a single turn invocation.
+ *
+ * Produced by `resolveClaudeSeatAuth()` before dispatching an Anthropic `/v1/messages` request.
+ */
+export interface ClaudeSeatAuth {
+    /** Active `ClaudeAccountSeatNode` identifier selected for the turn, when available. */
+    readonly seatId: string | undefined;
+    /** Authentication mechanism applied (`'cli-oauth'`, `'api-key'`, or `'none'`). */
+    readonly authSource: 'cli-oauth' | 'api-key' | 'none';
+    /** Outbound HTTP request headers including `anthropic-version` and credentials. */
+    readonly headers: Readonly<Record<string, string>>;
+}
+//# sourceMappingURL=claude-seat-auth.d.ts.map

package/dist/driver/internal/claude-seat-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-seat-auth.d.ts","sourceRoot":"","sources":["../../../src/driver/internal/claude-seat-auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;IACtD,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD"}

package/dist/driver/internal/claude-seat-auth.js

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

package/dist/driver/internal/claude-seat-auth.js.map

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

package/dist/driver/internal/claude-wire-converter.d.ts

@@ -0,0 +1,27 @@
+import { type ModelTurnRequest, type ModelTurnResponse } from '@paraharness/core';
+/**
+ * Assembles an Anthropic `/v1/messages` request payload from a `ModelTurnRequest`.
+ *
+ * Pins `system` and `tools` from `CompiledWirePrefix`, preserves `tools` when `toolChoice === 'none'`,
+ * and configures native `output_config.format` JSON-schema enforcement when `outputSchema` is present.
+ *
+ * @param {ModelTurnRequest} req - Turn invocation request parameters.
+ *
+ * @returns {Readonly<Record<string, unknown>>} Serialized Anthropic `/v1/messages` request body.
+ */
+export declare function buildAnthropicMessagesRequest(req: ModelTurnRequest): Readonly<Record<string, unknown>>;
+/**
+ * Parses an Anthropic `/v1/messages` response payload into a `ModelTurnResponse`.
+ *
+ * Preserves exact `thinking` and `signature` blocks in `wireFrame`, extracts `tool_use` calls into
+ * `canonical.toolCalls`, and validates `structuredOutput` when `canonical.toolCalls` is empty.
+ *
+ * @param {Readonly<Record<string, unknown>>} responseBody - Raw JSON object returned by `/v1/messages`.
+ * @param {ModelTurnRequest}                  req          - Originating turn request with optional `outputSchema`.
+ *
+ * @returns {ModelTurnResponse} Parsed turn response with raw wire bytes, canonical message, and usage.
+ *
+ * @throws {Error} If `req.outputSchema` is present and the response JSON fails schema validation.
+ */
+export declare function parseAnthropicMessagesResponse(responseBody: Readonly<Record<string, unknown>>, req: ModelTurnRequest): ModelTurnResponse;
+//# sourceMappingURL=claude-wire-converter.d.ts.map

package/dist/driver/internal/claude-wire-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-wire-converter.d.ts","sourceRoot":"","sources":["../../../src/driver/internal/claude-wire-converter.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,mBAAmB,CAAC;AAU3B;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,gBAAgB,GACpB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgCnC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC/C,GAAG,EAAE,gBAAgB,GACpB,iBAAiB,CAsBnB"}

package/dist/driver/internal/claude-wire-converter.js

@@ -0,0 +1,83 @@
+import { zodToJsonSchema, } from '@paraharness/core';
+import { CLAUDE_THINKING_BUDGETS, DEFAULT_CLAUDE_MAX_TOKENS, } from '../default-claude-http-transport.constants.js';
+import { computeAnthropicTurnUsage } from './compute-anthropic-turn-usage.js';
+import { decodeFrameToAnthropicMessage } from './decode-frame-to-anthropic-message.js';
+import { extractAnthropicContentBlocks } from './extract-anthropic-content-blocks.js';
+import { resolveAnthropicWireTools } from './resolve-anthropic-wire-tools.js';
+/**
+ * Assembles an Anthropic `/v1/messages` request payload from a `ModelTurnRequest`.
+ *
+ * Pins `system` and `tools` from `CompiledWirePrefix`, preserves `tools` when `toolChoice === 'none'`,
+ * and configures native `output_config.format` JSON-schema enforcement when `outputSchema` is present.
+ *
+ * @param {ModelTurnRequest} req - Turn invocation request parameters.
+ *
+ * @returns {Readonly<Record<string, unknown>>} Serialized Anthropic `/v1/messages` request body.
+ */
+export function buildAnthropicMessagesRequest(req) {
+    const messages = [];
+    for (const frame of req.history) {
+        messages.push(decodeFrameToAnthropicMessage(frame));
+    }
+    const tools = resolveAnthropicWireTools(req);
+    const body = {
+        model: req.modelId,
+        max_tokens: DEFAULT_CLAUDE_MAX_TOKENS,
+        messages: Object.freeze(messages),
+    };
+    if (req.wirePrefix !== undefined && req.wirePrefix.systemPromptText.length > 0) {
+        body['system'] = req.wirePrefix.systemPromptText;
+    }
+    if (tools.length > 0) {
+        body['tools'] = tools;
+    }
+    if (req.toolChoice !== undefined) {
+        body['tool_choice'] = Object.freeze({ type: req.toolChoice });
+    }
+    if (req.effort !== undefined) {
+        body['thinking'] = Object.freeze({
+            type: 'enabled',
+            budget_tokens: CLAUDE_THINKING_BUDGETS[req.effort],
+        });
+    }
+    if (req.outputSchema !== undefined) {
+        body['output_config'] = Object.freeze({
+            format: Object.freeze({ type: 'json_schema', schema: zodToJsonSchema(req.outputSchema) }),
+        });
+    }
+    return Object.freeze(body);
+}
+/**
+ * Parses an Anthropic `/v1/messages` response payload into a `ModelTurnResponse`.
+ *
+ * Preserves exact `thinking` and `signature` blocks in `wireFrame`, extracts `tool_use` calls into
+ * `canonical.toolCalls`, and validates `structuredOutput` when `canonical.toolCalls` is empty.
+ *
+ * @param {Readonly<Record<string, unknown>>} responseBody - Raw JSON object returned by `/v1/messages`.
+ * @param {ModelTurnRequest}                  req          - Originating turn request with optional `outputSchema`.
+ *
+ * @returns {ModelTurnResponse} Parsed turn response with raw wire bytes, canonical message, and usage.
+ *
+ * @throws {Error} If `req.outputSchema` is present and the response JSON fails schema validation.
+ */
+export function parseAnthropicMessagesResponse(responseBody, req) {
+    const { rawContent, visibleText, toolCalls } = extractAnthropicContentBlocks(responseBody);
+    const wireFrame = new TextEncoder().encode(JSON.stringify({ role: 'assistant', content: rawContent }));
+    const shouldParseOutput = toolCalls.length === 0 && req.outputSchema !== undefined && visibleText.trim().length > 0;
+    const structuredOutput = shouldParseOutput
+        ? req.outputSchema?.parse(JSON.parse(visibleText))
+        : undefined;
+    const canonical = Object.freeze({
+        role: 'assistant',
+        visibleText,
+        toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+        toolResults: undefined,
+    });
+    return Object.freeze({
+        wireFrame,
+        canonical,
+        structuredOutput,
+        usage: computeAnthropicTurnUsage(responseBody),
+    });
+}
+//# sourceMappingURL=claude-wire-converter.js.map

package/dist/driver/internal/claude-wire-converter.js.map

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

package/dist/driver/internal/compute-anthropic-turn-usage.d.ts

@@ -0,0 +1,12 @@
+import type { ModelTurnResponse } from '@paraharness/core';
+/**
+ * Extracts token usage and USD cost metrics from an Anthropic `/v1/messages` response payload.
+ *
+ * Reads `input_tokens`, `cache_read_input_tokens`, `output_tokens`, and `cost_usd` from `responseBody.usage`.
+ *
+ * @param {Readonly<Record<string, unknown>>} responseBody - Parsed JSON object returned by `/v1/messages`.
+ *
+ * @returns {ModelTurnResponse['usage']} Frozen token usage and cost summary.
+ */
+export declare function computeAnthropicTurnUsage(responseBody: Readonly<Record<string, unknown>>): ModelTurnResponse['usage'];
+//# sourceMappingURL=compute-anthropic-turn-usage.d.ts.map

package/dist/driver/internal/compute-anthropic-turn-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-anthropic-turn-usage.d.ts","sourceRoot":"","sources":["../../../src/driver/internal/compute-anthropic-turn-usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC9C,iBAAiB,CAAC,OAAO,CAAC,CAmB5B"}

package/dist/driver/internal/compute-anthropic-turn-usage.js

@@ -0,0 +1,27 @@
+/**
+ * Extracts token usage and USD cost metrics from an Anthropic `/v1/messages` response payload.
+ *
+ * Reads `input_tokens`, `cache_read_input_tokens`, `output_tokens`, and `cost_usd` from `responseBody.usage`.
+ *
+ * @param {Readonly<Record<string, unknown>>} responseBody - Parsed JSON object returned by `/v1/messages`.
+ *
+ * @returns {ModelTurnResponse['usage']} Frozen token usage and cost summary.
+ */
+export function computeAnthropicTurnUsage(responseBody) {
+    const usageRaw = (responseBody['usage'] ?? {});
+    const inputTokens = typeof usageRaw['input_tokens'] === 'number' ? usageRaw['input_tokens'] : 0;
+    const cachedInputTokens = typeof usageRaw['cache_read_input_tokens'] === 'number'
+        ? usageRaw['cache_read_input_tokens']
+        : 0;
+    const outputTokens = typeof usageRaw['output_tokens'] === 'number' ? usageRaw['output_tokens'] : 0;
+    const costUsd = typeof usageRaw['cost_usd'] === 'number'
+        ? usageRaw['cost_usd']
+        : (inputTokens * 0.003 + outputTokens * 0.015) / 1_000;
+    return Object.freeze({
+        inputTokens,
+        cachedInputTokens,
+        outputTokens,
+        costUsd,
+    });
+}
+//# sourceMappingURL=compute-anthropic-turn-usage.js.map

package/dist/driver/internal/compute-anthropic-turn-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-anthropic-turn-usage.js","sourceRoot":"","sources":["../../../src/driver/internal/compute-anthropic-turn-usage.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CACvC,YAA+C;IAE/C,MAAM,QAAQ,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,CAAsC,CAAC;IACpF,MAAM,WAAW,GAAG,OAAO,QAAQ,CAAC,cAAc,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChG,MAAM,iBAAiB,GACrB,OAAO,QAAQ,CAAC,yBAAyB,CAAC,KAAK,QAAQ;QACrD,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACrC,CAAC,CAAC,CAAC,CAAC;IACR,MAAM,YAAY,GAChB,OAAO,QAAQ,CAAC,eAAe,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,MAAM,OAAO,GACX,OAAO,QAAQ,CAAC,UAAU,CAAC,KAAK,QAAQ;QACtC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,CAAC,WAAW,GAAG,KAAK,GAAG,YAAY,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;IAC3D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,WAAW;QACX,iBAAiB;QACjB,YAAY;QACZ,OAAO;KACR,CAAC,CAAC;AACL,CAAC"}

package/dist/driver/internal/create-anthropic-sdk-fetch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Parameters for constructing an `@anthropic-ai/sdk` `fetch` wrapper via `createAnthropicSdkFetch()`.
+ *
+ * Controls whether placeholder SDK auth headers are stripped when no seat credential is configured.
+ */
+export interface CreateAnthropicSdkFetchParams {
+    /** Whether the active seat provided an explicit API key or OAuth bearer token. */
+    readonly hasExplicitAuth: boolean;
+    /** Underlying `fetch` implementation to invoke. */
+    readonly baseFetch: typeof globalThis.fetch;
+}
+/**
+ * Wraps the target `fetch` function used by `@anthropic-ai/sdk` to preserve exact seat headers.
+ *
+ * Removes placeholder `authorization` and `x-api-key` headers injected by the SDK when
+ * `params.hasExplicitAuth` is `false`.
+ *
+ * @param {CreateAnthropicSdkFetchParams} params - Explicit auth flag and underlying `fetch` function.
+ *
+ * @returns {typeof globalThis.fetch} Wrapped `fetch` function passed to `new Anthropic({ fetch })`.
+ */
+export declare function createAnthropicSdkFetch(params: CreateAnthropicSdkFetchParams): typeof globalThis.fetch;
+//# sourceMappingURL=create-anthropic-sdk-fetch.d.ts.map

package/dist/driver/internal/create-anthropic-sdk-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-anthropic-sdk-fetch.d.ts","sourceRoot":"","sources":["../../../src/driver/internal/create-anthropic-sdk-fetch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,kFAAkF;IAClF,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CAC7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,6BAA6B,GACpC,OAAO,UAAU,CAAC,KAAK,CASzB"}

package/dist/driver/internal/create-anthropic-sdk-fetch.js

@@ -0,0 +1,21 @@
+/**
+ * Wraps the target `fetch` function used by `@anthropic-ai/sdk` to preserve exact seat headers.
+ *
+ * Removes placeholder `authorization` and `x-api-key` headers injected by the SDK when
+ * `params.hasExplicitAuth` is `false`.
+ *
+ * @param {CreateAnthropicSdkFetchParams} params - Explicit auth flag and underlying `fetch` function.
+ *
+ * @returns {typeof globalThis.fetch} Wrapped `fetch` function passed to `new Anthropic({ fetch })`.
+ */
+export function createAnthropicSdkFetch(params) {
+    return (input, init) => {
+        const mergedHeaders = new Headers(init?.headers);
+        if (!params.hasExplicitAuth) {
+            mergedHeaders.delete('authorization');
+            mergedHeaders.delete('x-api-key');
+        }
+        return params.baseFetch(input, { ...init, headers: mergedHeaders });
+    };
+}
+//# sourceMappingURL=create-anthropic-sdk-fetch.js.map

package/dist/driver/internal/create-anthropic-sdk-fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-anthropic-sdk-fetch.js","sourceRoot":"","sources":["../../../src/driver/internal/create-anthropic-sdk-fetch.ts"],"names":[],"mappings":"AAYA;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAqC;IAErC,OAAO,CAAC,KAA6B,EAAE,IAAkB,EAAqB,EAAE;QAC9E,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC5B,aAAa,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;YACtC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;IACtE,CAAC,CAAC;AACJ,CAAC"}

package/dist/driver/internal/decode-frame-to-anthropic-message.d.ts

@@ -0,0 +1,14 @@
+import type { WireFrameRecord } from '@paraharness/core';
+/**
+ * Decodes a single `WireFrameRecord` into an Anthropic `/v1/messages` wire message object.
+ *
+ * Uses `rawWireFrame` directly when it already holds a valid Anthropic `{ role, content }` message
+ * (preserving `thinking` blocks, `signature` fields, and `cache_control`), and otherwise projects
+ * from `frame.canonical`.
+ *
+ * @param {WireFrameRecord} frame - Conversation history frame record.
+ *
+ * @returns {Readonly<Record<string, unknown>>} Anthropic wire message object.
+ */
+export declare function decodeFrameToAnthropicMessage(frame: WireFrameRecord): Readonly<Record<string, unknown>>;
+//# sourceMappingURL=decode-frame-to-anthropic-message.d.ts.map

package/dist/driver/internal/decode-frame-to-anthropic-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-frame-to-anthropic-message.d.ts","sourceRoot":"","sources":["../../../src/driver/internal/decode-frame-to-anthropic-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,eAAe,GACrB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgBnC"}

package/dist/driver/internal/decode-frame-to-anthropic-message.js

@@ -0,0 +1,29 @@
+import { projectCanonicalToAnthropicMessage } from './project-canonical-to-anthropic-message.js';
+/**
+ * Decodes a single `WireFrameRecord` into an Anthropic `/v1/messages` wire message object.
+ *
+ * Uses `rawWireFrame` directly when it already holds a valid Anthropic `{ role, content }` message
+ * (preserving `thinking` blocks, `signature` fields, and `cache_control`), and otherwise projects
+ * from `frame.canonical`.
+ *
+ * @param {WireFrameRecord} frame - Conversation history frame record.
+ *
+ * @returns {Readonly<Record<string, unknown>>} Anthropic wire message object.
+ */
+export function decodeFrameToAnthropicMessage(frame) {
+    const text = new TextDecoder().decode(frame.rawWireFrame).trim();
+    if (text.startsWith('{')) {
+        try {
+            const parsed = JSON.parse(text);
+            if ((parsed['role'] === 'user' || parsed['role'] === 'assistant') &&
+                Array.isArray(parsed['content'])) {
+                return parsed;
+            }
+        }
+        catch {
+            return projectCanonicalToAnthropicMessage(frame.canonical);
+        }
+    }
+    return projectCanonicalToAnthropicMessage(frame.canonical);
+}
+//# sourceMappingURL=decode-frame-to-anthropic-message.js.map

package/dist/driver/internal/decode-frame-to-anthropic-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode-frame-to-anthropic-message.js","sourceRoot":"","sources":["../../../src/driver/internal/decode-frame-to-anthropic-message.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kCAAkC,EAAE,MAAM,6CAA6C,CAAC;AAEjG;;;;;;;;;;GAUG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAsB;IAEtB,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;IACjE,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsC,CAAC;YACrE,IACE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,WAAW,CAAC;gBAC7D,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAChC,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,kCAAkC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,kCAAkC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;AAC7D,CAAC"}

package/dist/driver/internal/extract-anthropic-content-blocks.d.ts

@@ -0,0 +1,12 @@
+import type { ExtractedAnthropicContentBlocks } from './extracted-anthropic-content-blocks.js';
+/**
+ * Extracts raw content blocks, visible text, and canonical tool calls from an Anthropic `/v1/messages` response body.
+ *
+ * Preserves `rawContent` (including `thinking` and `signature` fields) intact for `wireFrame` serialization.
+ *
+ * @param {Readonly<Record<string, unknown>>} responseBody - Raw JSON object returned by `/v1/messages`.
+ *
+ * @returns {ExtractedAnthropicContentBlocks} Frozen extracted content blocks, visible text, and tool calls.
+ */
+export declare function extractAnthropicContentBlocks(responseBody: Readonly<Record<string, unknown>>): ExtractedAnthropicContentBlocks;
+//# sourceMappingURL=extract-anthropic-content-blocks.d.ts.map

package/dist/driver/internal/extract-anthropic-content-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-anthropic-content-blocks.d.ts","sourceRoot":"","sources":["../../../src/driver/internal/extract-anthropic-content-blocks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAE/F;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC9C,+BAA+B,CA4BjC"}

package/dist/driver/internal/extract-anthropic-content-blocks.js

@@ -0,0 +1,36 @@
+/**
+ * Extracts raw content blocks, visible text, and canonical tool calls from an Anthropic `/v1/messages` response body.
+ *
+ * Preserves `rawContent` (including `thinking` and `signature` fields) intact for `wireFrame` serialization.
+ *
+ * @param {Readonly<Record<string, unknown>>} responseBody - Raw JSON object returned by `/v1/messages`.
+ *
+ * @returns {ExtractedAnthropicContentBlocks} Frozen extracted content blocks, visible text, and tool calls.
+ */
+export function extractAnthropicContentBlocks(responseBody) {
+    const rawContent = Array.isArray(responseBody['content'])
+        ? responseBody['content']
+        : [];
+    const textParts = [];
+    const toolCalls = [];
+    for (const block of rawContent) {
+        if (block['type'] === 'text' && typeof block['text'] === 'string') {
+            textParts.push(block['text']);
+        }
+        else if (block['type'] === 'tool_use' &&
+            typeof block['id'] === 'string' &&
+            typeof block['name'] === 'string') {
+            toolCalls.push(Object.freeze({
+                id: block['id'],
+                name: block['name'],
+                argsJson: JSON.stringify(block['input'] ?? {}),
+            }));
+        }
+    }
+    return Object.freeze({
+        rawContent,
+        visibleText: textParts.join(''),
+        toolCalls: Object.freeze(toolCalls),
+    });
+}
+//# sourceMappingURL=extract-anthropic-content-blocks.js.map

package/dist/driver/internal/extract-anthropic-content-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-anthropic-content-blocks.js","sourceRoot":"","sources":["../../../src/driver/internal/extract-anthropic-content-blocks.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,MAAM,UAAU,6BAA6B,CAC3C,YAA+C;IAE/C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACvD,CAAC,CAAE,YAAY,CAAC,SAAS,CAAkD;QAC3E,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAwB,EAAE,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;YAClE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAChC,CAAC;aAAM,IACL,KAAK,CAAC,MAAM,CAAC,KAAK,UAAU;YAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ;YAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,QAAQ,EACjC,CAAC;YACD,SAAS,CAAC,IAAI,CACZ,MAAM,CAAC,MAAM,CAAoB;gBAC/B,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC;gBACnB,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;aAC/C,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAkC;QACpD,UAAU;QACV,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;KACpC,CAAC,CAAC;AACL,CAAC"}

package/dist/driver/internal/extract-claude-response-body.d.ts

@@ -0,0 +1,29 @@
+import type { ClaudeHttpResponse } from '../claude-http-response.js';
+/**
+ * Parameters for validating an Anthropic HTTP response and extracting its JSON body.
+ *
+ * Used by `extractClaudeResponseBody()` to surface structured `429` rate-limit and non-2xx errors.
+ */
+export interface ExtractClaudeResponseBodyParams {
+    /** HTTP response envelope returned by `ClaudeHttpTransport.sendMessagesRequest()`. */
+    readonly response: ClaudeHttpResponse;
+    /** Target Anthropic model identifier for diagnostic error messages. */
+    readonly modelId: string;
+    /** Optional active `ClaudeAccountSeatNode` identifier for diagnostic error messages. */
+    readonly seatId: string | undefined;
+}
+/**
+ * Validates the HTTP status on a `ClaudeHttpResponse` and returns the parsed JSON body.
+ *
+ * Checks HTTP status codes before invoking `JSON.parse(response.bodyText)` so non-JSON error
+ * gateways (`502 Bad Gateway`) never throw `SyntaxError`, and attaches `{ status: 429, resetAtMs }`
+ * on rate-limit responses.
+ *
+ * @param {ExtractClaudeResponseBodyParams} params - HTTP response envelope, model ID, and seat ID.
+ *
+ * @returns {Readonly<Record<string, unknown>>} Validated JSON response payload object.
+ *
+ * @throws {Error} With `{ status: 429, resetAtMs }` on HTTP `429` or `{ status }` on non-2xx responses.
+ */
+export declare function extractClaudeResponseBody(params: ExtractClaudeResponseBodyParams): Readonly<Record<string, unknown>>;
+//# sourceMappingURL=extract-claude-response-body.d.ts.map

package/dist/driver/internal/extract-claude-response-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-claude-response-body.d.ts","sourceRoot":"","sources":["../../../src/driver/internal/extract-claude-response-body.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGrE;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,+BAA+B,GACtC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAiCnC"}

package/dist/driver/internal/extract-claude-response-body.js

@@ -0,0 +1,36 @@
+import { parseClaudeRetryAfterResetAtMs } from './parse-claude-retry-after-reset-at-ms.js';
+/**
+ * Validates the HTTP status on a `ClaudeHttpResponse` and returns the parsed JSON body.
+ *
+ * Checks HTTP status codes before invoking `JSON.parse(response.bodyText)` so non-JSON error
+ * gateways (`502 Bad Gateway`) never throw `SyntaxError`, and attaches `{ status: 429, resetAtMs }`
+ * on rate-limit responses.
+ *
+ * @param {ExtractClaudeResponseBodyParams} params - HTTP response envelope, model ID, and seat ID.
+ *
+ * @returns {Readonly<Record<string, unknown>>} Validated JSON response payload object.
+ *
+ * @throws {Error} With `{ status: 429, resetAtMs }` on HTTP `429` or `{ status }` on non-2xx responses.
+ */
+export function extractClaudeResponseBody(params) {
+    const { response, modelId, seatId } = params;
+    const resetAtMs = response.resetAtMs ??
+        parseClaudeRetryAfterResetAtMs(response.headers?.['retry-after'] ?? response.headers?.['Retry-After']);
+    if (response.status === 429) {
+        throw Object.assign(new Error(`Anthropic /v1/messages rate limit (429) on model '${modelId}' (seat '${seatId ?? 'default'}').`), { status: 429, resetAtMs: resetAtMs ?? Date.now() + 60_000 });
+    }
+    if (response.status < 200 || response.status >= 300) {
+        const trimmedText = response.bodyText?.trim() ?? '';
+        const detail = trimmedText.length > 0 ? `: ${trimmedText}` : '';
+        throw Object.assign(new Error(`Anthropic /v1/messages failed with HTTP ${String(response.status)} for model '${modelId}'${detail}.`), { status: response.status });
+    }
+    if (response.body !== undefined) {
+        return response.body;
+    }
+    const trimmedBodyText = response.bodyText?.trim() ?? '';
+    if (trimmedBodyText.length > 0) {
+        return JSON.parse(trimmedBodyText);
+    }
+    return Object.freeze({});
+}
+//# sourceMappingURL=extract-claude-response-body.js.map

package/dist/driver/internal/extract-claude-response-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-claude-response-body.js","sourceRoot":"","sources":["../../../src/driver/internal/extract-claude-response-body.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,2CAA2C,CAAC;AAgB3F;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAuC;IAEvC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAC7C,MAAM,SAAS,GACb,QAAQ,CAAC,SAAS;QAClB,8BAA8B,CAC5B,QAAQ,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC,aAAa,CAAC,CACvE,CAAC;IACJ,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CACP,qDAAqD,OAAO,YAAY,MAAM,IAAI,SAAS,KAAK,CACjG,EACD,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,CAC7D,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QACpD,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CACP,2CAA2C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,eAAe,OAAO,IAAI,MAAM,GAAG,CACtG,EACD,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAC5B,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAChC,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IACD,MAAM,eAAe,GAAG,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,CAAsC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC"}

package/dist/driver/internal/extract-oauth-token-from-config-dir.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Extracts an OAuth bearer token string from a Claude CLI `configDir` path on disk when present.
+ *
+ * Searches standard credential JSON files inside `configDir` (or `configDir` directly if it is a file)
+ * and reads `claudeAiOauth.accessToken`, `accessToken`, `access_token`, `oauthToken`, or `token`.
+ *
+ * @param {string} configDir - Filesystem path to the Claude CLI configuration directory.
+ *
+ * @returns {string | undefined} Extracted OAuth bearer token, or `undefined` if no credential file exists.
+ */
+export declare function extractOAuthTokenFromConfigDir(configDir: string): string | undefined;
+//# sourceMappingURL=extract-oauth-token-from-config-dir.d.ts.map

package/dist/driver/internal/extract-oauth-token-from-config-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-oauth-token-from-config-dir.d.ts","sourceRoot":"","sources":["../../../src/driver/internal/extract-oauth-token-from-config-dir.ts"],"names":[],"mappings":"AAuEA;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoBpF"}

package/dist/driver/internal/extract-oauth-token-from-config-dir.js

@@ -0,0 +1,99 @@
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { CLAUDE_CREDENTIAL_FILENAMES } from '../default-claude-http-transport.constants.js';
+/**
+ * Expands a leading `'~/'` home-directory prefix on a Claude CLI `configDir` path.
+ *
+ * Returns `configDir` unchanged when it does not begin with `'~/'`.
+ *
+ * @param {string} configDir - Raw `configDir` path from a `ClaudeAccountSeatNode`.
+ *
+ * @returns {string} Filesystem path with leading `'~/'` expanded.
+ */
+function expandClaudeConfigDirHome(configDir) {
+    if (configDir.startsWith('~/')) {
+        return join(homedir(), configDir.slice(2));
+    }
+    return configDir;
+}
+/**
+ * Resolves the ordered list of candidate credential file paths for a Claude CLI `configDir`.
+ *
+ * Returns `[resolvedDir]` when `resolvedDir` is a regular file, and otherwise joins each
+ * filename in `CLAUDE_CREDENTIAL_FILENAMES`.
+ *
+ * @param {string} resolvedDir - Existing filesystem path to a file or directory.
+ *
+ * @returns {readonly string[]} Candidate credential file paths to inspect.
+ */
+function resolveClaudeCredentialPaths(resolvedDir) {
+    if (statSync(resolvedDir).isFile()) {
+        return Object.freeze([resolvedDir]);
+    }
+    const candidatePaths = [];
+    for (const filename of CLAUDE_CREDENTIAL_FILENAMES) {
+        candidatePaths.push(join(resolvedDir, filename));
+    }
+    return Object.freeze(candidatePaths);
+}
+/**
+ * Extracts a bearer token string from the raw text of a Claude CLI credential file.
+ *
+ * Parses JSON objects for `claudeAiOauth.accessToken`, `accessToken`, `access_token`, `oauthToken`,
+ * or `token`, and falls back to the raw trimmed string if the file holds a plain-text token.
+ *
+ * @param {string} rawText - Trimmed non-empty file contents.
+ *
+ * @returns {string | undefined} Extracted OAuth bearer token, or `undefined` if no token field is present.
+ */
+function parseClaudeCredentialFileText(rawText) {
+    try {
+        const parsed = JSON.parse(rawText);
+        const nested = parsed['claudeAiOauth'];
+        const token = nested?.['accessToken'] ??
+            parsed['accessToken'] ??
+            parsed['access_token'] ??
+            parsed['oauthToken'] ??
+            parsed['token'];
+        if (typeof token === 'string' && token.trim().length > 0) {
+            return token.trim();
+        }
+        return undefined;
+    }
+    catch {
+        return rawText;
+    }
+}
+/**
+ * Extracts an OAuth bearer token string from a Claude CLI `configDir` path on disk when present.
+ *
+ * Searches standard credential JSON files inside `configDir` (or `configDir` directly if it is a file)
+ * and reads `claudeAiOauth.accessToken`, `accessToken`, `access_token`, `oauthToken`, or `token`.
+ *
+ * @param {string} configDir - Filesystem path to the Claude CLI configuration directory.
+ *
+ * @returns {string | undefined} Extracted OAuth bearer token, or `undefined` if no credential file exists.
+ */
+export function extractOAuthTokenFromConfigDir(configDir) {
+    const resolvedDir = expandClaudeConfigDirHome(configDir);
+    if (!existsSync(resolvedDir)) {
+        return undefined;
+    }
+    const candidatePaths = resolveClaudeCredentialPaths(resolvedDir);
+    for (const filePath of candidatePaths) {
+        if (!existsSync(filePath)) {
+            continue;
+        }
+        const rawText = readFileSync(filePath, 'utf8').trim();
+        if (rawText.length === 0) {
+            continue;
+        }
+        const token = parseClaudeCredentialFileText(rawText);
+        if (token !== undefined) {
+            return token;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=extract-oauth-token-from-config-dir.js.map