condukt 0.25.0 → 0.27.0

package/dist/runtimes/claude/session-recovery.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * Same-session recovery for the Claude runtime (ADR-009, ADR-008 parity).
+ *
+ * The Claude SDK has no empty-turn primitive in string-prompt mode, so
+ * recovery here resumes the failed session and sends one fixed,
+ * task-free continuation. Everything in this module is pure so it can be
+ * unit-tested without a CLI: the session owns the loop and the events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClaudeConfigurationError = exports.ClaudeStreamEndedError = exports.ClaudeResumeAttemptError = exports.CONTINUATION_PROMPT = void 0;
+exports.toResumeAttemptError = toResumeAttemptError;
+exports.outcomeIsFailure = outcomeIsFailure;
+exports.failureFromOutcome = failureFromOutcome;
+exports.classifyClaudeFailure = classifyClaudeFailure;
+/**
+ * The idempotent nudge sent after a resume. It must not repeat the original
+ * task: `resume` may already have re-run an interrupted turn on its own
+ * (`resume_reason` frames), and a second full task would duplicate work.
+ */
+exports.CONTINUATION_PROMPT = 'Continue from where you left off. Do not repeat work that is already complete. '
+    + 'If the task is finished, reply briefly with the final result.';
+/**
+ * A failed recovery step.
+ *
+ * `fatal` marks steps whose failure cannot change its answer on a retry: the
+ * resumed session reported a different id than the one asked for, or the CLI
+ * refused the required permission mode. Every other step is retried until
+ * the continuation count or the recovery budget runs out.
+ */
+class ClaudeResumeAttemptError extends Error {
+    stage;
+    fatal;
+    constructor(stage, message, fatal, options) {
+        super(message, options);
+        this.stage = stage;
+        this.fatal = fatal;
+        this.name = 'ClaudeResumeAttemptError';
+    }
+}
+exports.ClaudeResumeAttemptError = ClaudeResumeAttemptError;
+function toResumeAttemptError(value, stage) {
+    if (value instanceof ClaudeResumeAttemptError)
+        return value;
+    const message = value instanceof Error ? value.message : String(value);
+    return new ClaudeResumeAttemptError(stage, message, false, {
+        cause: value instanceof Error ? value : undefined,
+    });
+}
+/** The CLI accepted the prompt but the query stream ended with no result. */
+class ClaudeStreamEndedError extends Error {
+    constructor(message = 'Claude query ended without a result message') {
+        super(message);
+        this.name = 'ClaudeStreamEndedError';
+    }
+}
+exports.ClaudeStreamEndedError = ClaudeStreamEndedError;
+/** A requested configuration invariant was not applied by the CLI. */
+class ClaudeConfigurationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ClaudeConfigurationError';
+    }
+}
+exports.ClaudeConfigurationError = ClaudeConfigurationError;
+/**
+ * Assistant-frame errors that a resumed turn cannot fix. Credentials, request
+ * shape, and model selection are configuration facts, not transient faults;
+ * `max_output_tokens` is a per-turn limit that a continuation could mask but
+ * not raise.
+ */
+const NON_RECOVERABLE_ASSISTANT_ERRORS = new Set([
+    'authentication_failed',
+    'oauth_org_not_allowed',
+    'account_on_hold',
+    'verification_required',
+    'billing_error',
+    'invalid_request',
+    'model_not_found',
+    'max_output_tokens',
+    'cloud_credential_error',
+]);
+const RECOVERABLE_ASSISTANT_ERRORS = new Set([
+    'rate_limit',
+    'overloaded',
+    'server_error',
+    'unknown',
+]);
+/** Terminal reasons where the model call itself was interrupted. */
+const RECOVERABLE_TERMINAL_REASONS = new Set([
+    'model_error',
+    'api_error',
+    'aborted_streaming',
+    'aborted_tools',
+]);
+const NON_RECOVERABLE_TERMINAL_REASONS = new Set([
+    'prompt_too_long',
+    'blocking_limit',
+    'rapid_refill_breaker',
+    'max_turns',
+    'budget_exhausted',
+    'structured_output_retry_exhausted',
+    'turn_setup_failed',
+    'image_error',
+    'malformed_tool_use_exhausted',
+    'stop_hook_prevented',
+    'hook_stopped',
+    'tool_deferred',
+    'tool_deferred_unavailable',
+    'background_requested',
+]);
+const NON_RECOVERABLE_SUBTYPES = new Set([
+    'error_max_turns',
+    'error_max_budget_usd',
+    'error_max_structured_output_retries',
+]);
+const TRANSIENT_TEXT = /terminated|connection|socket|timeout|timed out|econn|network|fetch failed|temporar|unavailable|overloaded|rate.?limit|too many requests|bad gateway|service unavailable|gateway timeout|internal server error/i;
+const NON_RECOVERABLE_TEXT = /authentication|unauthorized|forbidden|invalid api key|invalid_request|permission denied|model not found|prompt is too long|context length|maximum context|max_tokens|exceeds the context window/i;
+/** `result.subtype !== 'success'` or a transient API failure flagged in-band. */
+function outcomeIsFailure(outcome) {
+    return outcome.subtype !== 'success' || outcome.isError;
+}
+/** The error a terminal result should fail the turn with. */
+function failureFromOutcome(outcome) {
+    const message = outcome.errors[0]
+        ?? (outcome.apiErrorStatus !== undefined && outcome.apiErrorStatus !== null
+            ? `Claude API error (status ${outcome.apiErrorStatus})`
+            : outcome.terminalReason !== undefined
+                ? `Claude session failed (${outcome.subtype}: ${outcome.terminalReason})`
+                : `Claude session failed (${outcome.subtype})`);
+    const error = new Error(message);
+    error.name = outcome.subtype === 'success' ? 'ClaudeApiError' : 'ClaudeResultError';
+    return error;
+}
+/**
+ * Decides whether resuming the same session can plausibly fix a failed turn.
+ *
+ * Evidence is checked in the order the SDK makes it authoritative:
+ * `startup_failure_reason` and fatal local errors first, then the assistant
+ * error enum, then the HTTP status, then `terminal_reason`, then message
+ * text. A thrown stream error with no explicit signal is treated as a
+ * transport failure and is recoverable; a result error with no evidence is
+ * not retried blindly.
+ */
+function classifyClaudeFailure(signals) {
+    if (signals.error instanceof ClaudeConfigurationError) {
+        return {
+            recoverable: false,
+            reason: signals.error.message,
+            failureKind: 'configuration',
+        };
+    }
+    if (signals.error instanceof ClaudeResumeAttemptError && signals.error.fatal) {
+        return {
+            recoverable: false,
+            reason: signals.error.message,
+            failureKind: signals.error.stage,
+        };
+    }
+    if (signals.aborted) {
+        return { recoverable: false, reason: 'turn was aborted', failureKind: 'aborted' };
+    }
+    const outcome = signals.outcome;
+    if (outcome?.startupFailureReason !== undefined) {
+        return {
+            recoverable: false,
+            reason: `Claude startup failed: ${outcome.startupFailureReason}`,
+            errorCode: outcome.startupFailureReason,
+            failureKind: 'startup',
+        };
+    }
+    if (outcome !== undefined && NON_RECOVERABLE_SUBTYPES.has(outcome.subtype)) {
+        return {
+            recoverable: false,
+            reason: `Claude result '${outcome.subtype}' is not recoverable`,
+            errorCode: outcome.subtype,
+            failureKind: outcome.subtype,
+        };
+    }
+    const assistantError = signals.assistantError;
+    if (assistantError !== undefined) {
+        if (NON_RECOVERABLE_ASSISTANT_ERRORS.has(assistantError)) {
+            return {
+                recoverable: false,
+                reason: `Claude reported '${assistantError}'`,
+                errorCode: assistantError,
+                failureKind: 'assistant-error',
+            };
+        }
+        if (RECOVERABLE_ASSISTANT_ERRORS.has(assistantError)) {
+            return {
+                recoverable: true,
+                reason: `Claude reported '${assistantError}'`,
+                errorCode: assistantError,
+                failureKind: 'assistant-error',
+            };
+        }
+    }
+    const status = outcome?.apiErrorStatus ?? undefined;
+    if (typeof status === 'number' && Number.isFinite(status)) {
+        const recoverable = status === 408 || status === 425 || status === 429 || status === 499 || status >= 500;
+        return {
+            recoverable,
+            reason: `Claude API status ${status}`,
+            statusCode: status,
+            ...(assistantError !== undefined ? { errorCode: assistantError } : {}),
+            failureKind: 'api-error',
+        };
+    }
+    const terminalReason = outcome?.terminalReason;
+    if (terminalReason !== undefined) {
+        const recoverable = RECOVERABLE_TERMINAL_REASONS.has(terminalReason);
+        return {
+            recoverable,
+            reason: NON_RECOVERABLE_TERMINAL_REASONS.has(terminalReason)
+                ? `Claude terminal reason '${terminalReason}' is not recoverable`
+                : `Claude terminal reason '${terminalReason}'`,
+            errorCode: terminalReason,
+            failureKind: 'terminal',
+        };
+    }
+    const evidence = [
+        ...(outcome?.errors ?? []),
+        ...(assistantError !== undefined ? [assistantError] : []),
+        ...(signals.error !== undefined ? [signals.error.message] : []),
+    ].join('\n');
+    if (evidence.length > 0) {
+        if (NON_RECOVERABLE_TEXT.test(evidence)) {
+            return {
+                recoverable: false,
+                reason: 'failure text describes a non-transient condition',
+                failureKind: 'text',
+            };
+        }
+        if (TRANSIENT_TEXT.test(evidence)) {
+            return {
+                recoverable: true,
+                reason: 'failure text describes a transient fault',
+                failureKind: 'text',
+            };
+        }
+    }
+    if (signals.error !== undefined) {
+        return {
+            recoverable: true,
+            reason: signals.error.message,
+            failureKind: 'stream',
+        };
+    }
+    return {
+        recoverable: false,
+        reason: outcome !== undefined
+            ? `Claude result '${outcome.subtype}' carried no recoverable evidence`
+            : 'no failure evidence',
+        ...(outcome !== undefined ? { errorCode: outcome.subtype } : {}),
+        failureKind: 'unknown',
+    };
+}
+//# sourceMappingURL=session-recovery.js.map

package/dist/runtimes/claude/session-recovery.js.map

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

package/dist/runtimes/claude/sse.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Minimal SSE framing helpers shared by the bridge translators.
+ */
+/** Format one Anthropic SSE frame. */
+export declare function sseFrame(event: string | null, payload: unknown): string;
+/**
+ * Incremental line splitter for upstream SSE byte streams.
+ * Feed decoded text; receive complete lines (no trailing newline).
+ */
+export declare function createLineReader(): {
+    push(chunk: string): string[];
+    flush(): string[];
+};
+/** Extract the JSON payload of a `data:` SSE line, or null. */
+export declare function parseDataLine(line: string): string | null;
+//# sourceMappingURL=sse.d.ts.map

package/dist/runtimes/claude/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../../runtimes/claude/sse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAIvE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI;IAAE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAAC,KAAK,IAAI,MAAM,EAAE,CAAA;CAAE,CAevF;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMzD"}

package/dist/runtimes/claude/sse.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Minimal SSE framing helpers shared by the bridge translators.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sseFrame = sseFrame;
+exports.createLineReader = createLineReader;
+exports.parseDataLine = parseDataLine;
+/** Format one Anthropic SSE frame. */
+function sseFrame(event, payload) {
+    const data = typeof payload === 'string' ? payload : JSON.stringify(payload);
+    if (event)
+        return `event: ${event}\ndata: ${data}\n\n`;
+    return `data: ${data}\n\n`;
+}
+/**
+ * Incremental line splitter for upstream SSE byte streams.
+ * Feed decoded text; receive complete lines (no trailing newline).
+ */
+function createLineReader() {
+    let buffer = '';
+    return {
+        push(chunk) {
+            buffer += chunk;
+            const lines = buffer.split('\n');
+            buffer = lines.pop() ?? '';
+            return lines;
+        },
+        flush() {
+            const rest = buffer;
+            buffer = '';
+            return rest ? [rest] : [];
+        },
+    };
+}
+/** Extract the JSON payload of a `data:` SSE line, or null. */
+function parseDataLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith('data:'))
+        return null;
+    const data = trimmed.slice(5).trim();
+    if (!data || data === '[DONE]')
+        return null;
+    return data;
+}
+//# sourceMappingURL=sse.js.map

package/dist/runtimes/claude/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../../runtimes/claude/sse.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAGH,4BAIC;AAMD,4CAeC;AAGD,sCAMC;AAnCD,sCAAsC;AACtC,SAAgB,QAAQ,CAAC,KAAoB,EAAE,OAAgB;IAC7D,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC7E,IAAI,KAAK;QAAE,OAAO,UAAU,KAAK,WAAW,IAAI,MAAM,CAAC;IACvD,OAAO,SAAS,IAAI,MAAM,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB;IAC9B,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,OAAO;QACL,IAAI,CAAC,KAAa;YAChB,MAAM,IAAI,KAAK,CAAC;YAChB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK;YACH,MAAM,IAAI,GAAG,MAAM,CAAC;YACpB,MAAM,GAAG,EAAE,CAAC;YACZ,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,SAAgB,aAAa,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/runtimes/claude/translate-chat.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Anthropic ⇄ OpenAI chat/completions translation (reference-proxy parity).
+ *
+ * Pure, side-effect-free functions plus a streaming state machine. The
+ * bridge owns HTTP concerns; this module owns wire-shape semantics:
+ *
+ *   - anthropicToOpenAI:     Claude SDK request → chat/completions body
+ *   - applyChatExtras:       DeepSeek/GLM thinking+effort extras (in place)
+ *   - openAIToAnthropic:     non-streaming response → Anthropic message
+ *   - ChatStreamTranslator:  streaming chunks → Anthropic SSE frames
+ *   - estimateInputTokens:   pre-stream input estimate for message_start
+ */
+import { type UpstreamTurnUsage } from './bridge-cache';
+import { extractEffort, extractThinkingType } from './protocol-router';
+/** Chat models that only accept string content (media dropped with warning). */
+export declare const NO_MULTIMODAL: ReadonlySet<string>;
+/**
+ * Narrow an untrusted JSON value to an indexable object. Upstream bodies and
+ * Anthropic requests are both untrusted, so every nested read goes through a
+ * check like this rather than an `any` cast.
+ */
+export declare function asObject(value: unknown): Record<string, unknown> | null;
+export interface AnthropicToOpenAIOptions {
+    /** Models that only accept string content; media is dropped for them. */
+    readonly noMultimodal?: ReadonlySet<string>;
+}
+/**
+ * Convert an Anthropic messages body to an OpenAI chat/completions body.
+ * Ported 1:1 from the reference proxy (system media, thinking replay,
+ * tool ordering, tool_choice, thinking budget → max_completion_tokens).
+ */
+export declare function anthropicToOpenAI(body: Record<string, unknown>, model: string, opts?: AnthropicToOpenAIOptions): Record<string, unknown>;
+export declare function maxTokensFloorFor(effort: string | null): number;
+export interface ChatExtrasSent {
+    readonly effortSent: string | null;
+    readonly thinkingSent: string | null;
+}
+/**
+ * Family-gated chat extras, in place (reference parity).
+ *
+ * Emits thinking + reasoning_effort + user_id for deepseek-/glm- families
+ * only; sets top_p 0.95 default (DeepSeek, client wins); floors max_tokens
+ * by sent effort (never lowers); rejects required/named tool_choice with
+ * thinking on (upstream 400s). Returns the wire truth for telemetry.
+ */
+export declare function applyChatExtras(oaiBody: Record<string, unknown>, modelId: string, session: string, clientEffort?: string | null, clientThinking?: string | null): ChatExtrasSent;
+export declare function mapFinishReason(finish: unknown): string;
+/**
+ * Convert a non-streaming chat/completions response to an Anthropic
+ * message. Loud on malformed tool-call arguments.
+ */
+export declare function openAIToAnthropic(resp: Record<string, unknown>, requested: string, messageId?: string): Record<string, unknown>;
+export declare function parseToolArgs(raw: string): Record<string, unknown>;
+export interface ChatStreamOptions {
+    /** Client-facing model id echoed in message_start. */
+    readonly requestedModel: string;
+    /** Estimated input tokens for message_start (reference: stream_in_est). */
+    readonly estimatedInput?: number;
+    /** Fixed message id (tests); otherwise generated. */
+    readonly messageId?: string;
+    /**
+     * Called once on clean stream close with the final upstream usage
+     * (null when the upstream gave none). Observability only: never lets
+     * an exception reach the translator.
+     */
+    readonly onFinalUsage?: (usage: UpstreamTurnUsage | null) => void;
+}
+export declare class ChatStreamTranslator {
+    private readonly requestedModel;
+    private readonly estimatedInput;
+    private readonly messageId;
+    private readonly reader;
+    private started;
+    private textBlockIdx;
+    private reasoningBlockIdx;
+    private nextBlockIdx;
+    private readonly openBlocks;
+    private readonly toolBlocks;
+    private finishReason;
+    private usage;
+    private stopped;
+    private readonly onFinalUsage?;
+    constructor(opts: ChatStreamOptions);
+    get messageStarted(): boolean;
+    get isStopped(): boolean;
+    /** Feed decoded upstream bytes; returns Anthropic SSE frames to forward. */
+    push(text: string): string[];
+    /**
+     * Parse complete SSE lines into Anthropic frames. `finish()` also
+     * drains the reader's unterminated trailing line, so a usage-only
+     * event at EOF (no final newline) still reaches `onFinalUsage`.
+     */
+    private consume;
+    /** Upstream ended ([DONE] or EOF): emit closing frames. */
+    finish(): string[];
+    /** Transport/upstream failure: emit the reference error close. */
+    fail(message: string): string[];
+    private handleChunk;
+    private startMessage;
+    private finalOutputTokens;
+    private terminalFrames;
+}
+/** Rough pre-stream input estimate (reference `_estimate_input_tokens`). */
+export declare function estimateInputTokens(body: Record<string, unknown>): number;
+export { extractEffort, extractThinkingType };
+//# sourceMappingURL=translate-chat.d.ts.map

package/dist/runtimes/claude/translate-chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate-chat.d.ts","sourceRoot":"","sources":["../../../runtimes/claude/translate-chat.ts"],"names":[],"mappings":"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"}