@galdor/provider-anthropic 0.3.0

package/dist/convert.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Conversion between galdor's shared schema and the Anthropic Messages API
+ * wire shape.
+ *
+ * One direction, {@link buildRequest}, lowers a galdor {@link Request} into the
+ * snake_case JSON the Messages API expects: system messages are hoisted into a
+ * dedicated `system` array, content parts and tool calls become typed blocks,
+ * extended thinking and structured output are expressed in Anthropic's own
+ * terms, and prompt-caching markers are attached to the final block of a span.
+ * The other direction, {@link responseFromWire} (with
+ * {@link extractStructuredOutput} and {@link usageFromWire}), collapses a wire
+ * response back into a galdor {@link Response}.
+ */
+import { type Request, type Response } from "@galdor/core/provider";
+/**
+ * Default `max_tokens` sent when the caller leaves {@link Request.maxTokens}
+ * unset. The Messages API requires the field, so a concrete value is always
+ * supplied.
+ */
+export declare const DEFAULT_MAX_TOKENS = 4096;
+/** A single Anthropic content block in its on-the-wire JSON form. */
+interface WireBlock {
+    type: string;
+    text?: string;
+    source?: {
+        type: string;
+        media_type?: string;
+        data?: string;
+        url?: string;
+    };
+    id?: string;
+    name?: string;
+    input?: unknown;
+    thinking?: string;
+    signature?: string;
+    data?: string;
+    tool_use_id?: string;
+    content?: WireBlock[];
+    is_error?: boolean;
+    cache_control?: {
+        type: string;
+    };
+}
+/** One turn in the Anthropic conversation array (role plus content blocks). */
+interface WireMessage {
+    role: string;
+    content: WireBlock[];
+}
+/** Request body of the Anthropic Messages API in its JSON wire shape. */
+export interface MessageRequest {
+    model: string;
+    messages: WireMessage[];
+    system?: Array<{
+        type: string;
+        text: string;
+        cache_control?: {
+            type: string;
+        };
+    }>;
+    max_tokens: number;
+    temperature?: number;
+    top_p?: number;
+    stop_sequences?: string[];
+    stream?: boolean;
+    tools?: Array<{
+        name: string;
+        description?: string;
+        input_schema: unknown;
+    }>;
+    tool_choice?: {
+        type: string;
+        name?: string;
+    };
+    thinking?: {
+        type: string;
+        budget_tokens: number;
+    };
+    metadata?: {
+        user_id?: string;
+    };
+}
+/** Response body of a non-streaming Anthropic Messages API call. */
+export interface MessageResponse {
+    id: string;
+    type: string;
+    role: string;
+    model: string;
+    content: WireBlock[];
+    stop_reason: string;
+    stop_sequence?: string;
+    usage: WireUsage;
+}
+/** Token-usage block reported by the Messages API, including cache counters. */
+export interface WireUsage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+}
+/**
+ * Translate a galdor {@link Request} into an Anthropic {@link MessageRequest}.
+ *
+ * System messages are hoisted into the `system` array; user, assistant and tool
+ * messages become conversation turns, with consecutive tool results folded into
+ * the preceding user turn. Enabling reasoning sets a thinking budget (clamped to
+ * a minimum), grows `max_tokens` to cover it, and drops sampling controls that
+ * are incompatible with extended thinking. A `json_schema` response format is
+ * realized as a single forced tool call whose input schema is the requested one.
+ *
+ * @param req - The galdor request to lower.
+ * @param stream - Whether to set the wire `stream` flag.
+ * @returns The fully-formed Anthropic request body.
+ * @throws {InvalidRequestError} When the model is empty, a role is unknown, or content cannot be converted.
+ * @example
+ * const wire = buildRequest({ model: "claude-haiku-4-5", messages }, false);
+ */
+export declare function buildRequest(req: Request, stream: boolean): MessageRequest;
+/**
+ * Convert a wire usage block into galdor's usage shape.
+ *
+ * @returns Token counts with cache-creation and cache-read figures, each
+ * defaulting to zero when the field is absent.
+ */
+export declare function usageFromWire(u: WireUsage): {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+};
+/**
+ * Collapse a non-streaming Anthropic {@link MessageResponse} into a galdor {@link Response}.
+ *
+ * Text and thinking blocks become assistant content parts; `tool_use` blocks
+ * become tool calls; `redacted_thinking` is preserved via its signature. Empty
+ * blocks are skipped.
+ *
+ * @param r - The decoded wire response.
+ * @param raw - Optional raw response bytes, attached as `providerRaw` when given.
+ * @returns The assembled response with message, stop reason, usage and model.
+ */
+export declare function responseFromWire(r: MessageResponse, raw?: Uint8Array): Response;
+/**
+ * Rewrite a forced structured-output tool call into plain message text.
+ *
+ * When the response contains the tool call that backs structured output, its
+ * arguments are serialized to JSON and become the assistant message body, so
+ * callers receive the structured result as text rather than a tool invocation.
+ * If no matching call is found, the response is returned unchanged.
+ *
+ * @param resp - The response produced by {@link responseFromWire}.
+ * @param schemaName - The configured schema name, resolved the same way as in {@link buildRequest}.
+ * @returns The (possibly rewritten) response.
+ */
+export declare function extractStructuredOutput(resp: Response, schemaName: string | undefined): Response;
+export {};
+//# sourceMappingURL=convert.d.ts.map

package/dist/convert.d.ts.map

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

package/dist/convert.js

@@ -0,0 +1,303 @@
+/**
+ * Conversion between galdor's shared schema and the Anthropic Messages API
+ * wire shape.
+ *
+ * One direction, {@link buildRequest}, lowers a galdor {@link Request} into the
+ * snake_case JSON the Messages API expects: system messages are hoisted into a
+ * dedicated `system` array, content parts and tool calls become typed blocks,
+ * extended thinking and structured output are expressed in Anthropic's own
+ * terms, and prompt-caching markers are attached to the final block of a span.
+ * The other direction, {@link responseFromWire} (with
+ * {@link extractStructuredOutput} and {@link usageFromWire}), collapses a wire
+ * response back into a galdor {@link Response}.
+ */
+import { InvalidRequestError } from "@galdor/core/provider";
+import { ContentType, messageText, Role, textPart, } from "@galdor/core/schema";
+/**
+ * Default `max_tokens` sent when the caller leaves {@link Request.maxTokens}
+ * unset. The Messages API requires the field, so a concrete value is always
+ * supplied.
+ */
+export const DEFAULT_MAX_TOKENS = 4096;
+/**
+ * Build an {@link InvalidRequestError} for a request that cannot be lowered to
+ * the wire shape (empty model, unknown role, unconvertible content). Typed so
+ * callers can discriminate a local build failure from a transport error.
+ */
+function invalidRequest(message) {
+    return new InvalidRequestError({ kind: "invalid_request", provider: "anthropic", statusCode: 0, message });
+}
+/** Resolve the tool name used for forced structured output, defaulting when unnamed. */
+function structuredToolName(name) {
+    return name && name !== "" ? name : "structured_output";
+}
+/** Encode raw image bytes as a base64 string for inline transport. */
+function toBase64(data) {
+    return Buffer.from(data).toString("base64");
+}
+/**
+ * Build the `source` of an image block, preferring a URL reference and otherwise
+ * encoding inline bytes as base64.
+ *
+ * @throws {InvalidRequestError} When inline data is present but its MIME type is missing, or
+ * when the part carries neither a URL nor data.
+ */
+function imageToWire(img) {
+    if (img.url && img.url !== "")
+        return { type: "url", url: img.url };
+    if (img.data && img.data.length > 0) {
+        if (!img.media)
+            throw invalidRequest("anthropic: inline image missing media (MIME type)");
+        return { type: "base64", media_type: img.media, data: toBase64(img.data) };
+    }
+    throw invalidRequest("anthropic: image part with no url or data");
+}
+/**
+ * Convert galdor content parts into Anthropic content blocks, attaching the
+ * message's cache-control marker to the final emitted block.
+ *
+ * Unsigned reasoning parts are dropped because they cannot be replayed without a
+ * signature.
+ *
+ * @throws {InvalidRequestError} On an image part missing its image, or an unsupported part type.
+ */
+function partsToWire(parts, cc) {
+    const out = [];
+    for (const p of parts) {
+        switch (p.type) {
+            case ContentType.Text:
+                out.push({ type: "text", text: p.text ?? "" });
+                break;
+            case ContentType.Image:
+                if (!p.image)
+                    throw invalidRequest("anthropic: image part with nil image");
+                out.push({ type: "image", source: imageToWire(p.image) });
+                break;
+            case ContentType.Thinking:
+                if (!p.signature)
+                    continue; // unsigned reasoning can't be resent
+                out.push({ type: "thinking", thinking: p.text ?? "", signature: p.signature });
+                break;
+            case ContentType.RedactedThinking:
+                if (!p.signature)
+                    continue;
+                out.push({ type: "redacted_thinking", data: p.signature });
+                break;
+            default:
+                throw invalidRequest(`anthropic: unsupported content type ${p.type}`);
+        }
+    }
+    applyCacheControl(out, cc);
+    return out;
+}
+/** Stamp the cache-control marker, if any, onto the last block of a span. */
+function applyCacheControl(blocks, cc) {
+    if (cc && blocks.length > 0)
+        blocks[blocks.length - 1].cache_control = { type: cc.type };
+}
+/**
+ * Translate a galdor {@link ToolChoice} into the Anthropic `tool_choice` object.
+ *
+ * @returns The wire choice, or `undefined` to leave the field unset (provider default).
+ */
+function toolChoiceToWire(c) {
+    switch (c) {
+        case "none":
+            return { type: "none" };
+        case "required":
+            return { type: "any" };
+        case "auto":
+            return { type: "auto" };
+        default:
+            return undefined;
+    }
+}
+/**
+ * Translate a galdor {@link Request} into an Anthropic {@link MessageRequest}.
+ *
+ * System messages are hoisted into the `system` array; user, assistant and tool
+ * messages become conversation turns, with consecutive tool results folded into
+ * the preceding user turn. Enabling reasoning sets a thinking budget (clamped to
+ * a minimum), grows `max_tokens` to cover it, and drops sampling controls that
+ * are incompatible with extended thinking. A `json_schema` response format is
+ * realized as a single forced tool call whose input schema is the requested one.
+ *
+ * @param req - The galdor request to lower.
+ * @param stream - Whether to set the wire `stream` flag.
+ * @returns The fully-formed Anthropic request body.
+ * @throws {InvalidRequestError} When the model is empty, a role is unknown, or content cannot be converted.
+ * @example
+ * const wire = buildRequest({ model: "claude-haiku-4-5", messages }, false);
+ */
+export function buildRequest(req, stream) {
+    if (req.model === "")
+        throw invalidRequest("anthropic: model is required");
+    let maxTokens = req.maxTokens ?? DEFAULT_MAX_TOKENS;
+    const out = { model: req.model, messages: [], max_tokens: maxTokens, stream };
+    if (req.temperature !== undefined)
+        out.temperature = req.temperature;
+    if (req.topP !== undefined)
+        out.top_p = req.topP;
+    if (req.stopSequences)
+        out.stop_sequences = req.stopSequences;
+    if (req.reasoning?.enabled) {
+        let budget = req.reasoning.budget ?? 0;
+        if (budget < 1024)
+            budget = 1024;
+        if (out.max_tokens <= budget)
+            out.max_tokens = budget + maxTokens;
+        out.thinking = { type: "enabled", budget_tokens: budget };
+        delete out.temperature; // incompatible with extended thinking
+        delete out.top_p;
+    }
+    for (const m of req.messages) {
+        switch (m.role) {
+            case Role.System:
+                (out.system ??= []).push({ type: "text", text: messageText(m), ...(m.cacheControl ? { cache_control: { type: m.cacheControl.type } } : {}) });
+                break;
+            case Role.User:
+                out.messages.push({ role: "user", content: partsToWire(m.content, m.cacheControl) });
+                break;
+            case Role.Assistant: {
+                const blocks = partsToWire(m.content, undefined);
+                for (const tc of m.toolCalls ?? []) {
+                    const input = tc.arguments === undefined || tc.arguments === null ? {} : tc.arguments;
+                    blocks.push({ type: "tool_use", id: tc.id, name: tc.name, input });
+                }
+                applyCacheControl(blocks, m.cacheControl);
+                out.messages.push({ role: "assistant", content: blocks });
+                break;
+            }
+            case Role.Tool: {
+                const block = {
+                    type: "tool_result",
+                    tool_use_id: m.toolCallId ?? "",
+                    content: [{ type: "text", text: messageText(m) }],
+                };
+                const last = out.messages.at(-1);
+                if (last && last.role === "user")
+                    last.content.push(block);
+                else
+                    out.messages.push({ role: "user", content: [block] });
+                break;
+            }
+            default:
+                throw invalidRequest(`anthropic: unknown role ${m.role}`);
+        }
+    }
+    if (req.tools && req.tools.length > 0) {
+        out.tools = req.tools.map((t) => ({ name: t.name, description: t.description, input_schema: t.schema }));
+    }
+    const tc = toolChoiceToWire(req.toolChoice);
+    if (tc)
+        out.tool_choice = tc;
+    // Structured output → forced single tool whose input_schema is the request's.
+    if (req.responseFormat?.type === "json_schema") {
+        const name = structuredToolName(req.responseFormat.name);
+        out.tools = [{ name, description: "Respond by calling this tool with the structured result.", input_schema: req.responseFormat.schema }];
+        out.tool_choice = { type: "tool", name };
+    }
+    const uid = req.metadata?.user_id;
+    if (uid)
+        out.metadata = { user_id: uid };
+    return out;
+}
+/** Map a wire stop-reason string to a galdor {@link StopReason}, treating empty as `end_turn`. */
+function normalizeStopReason(s) {
+    switch (s) {
+        case "end_turn":
+            return "end_turn";
+        case "max_tokens":
+            return "max_tokens";
+        case "tool_use":
+            return "tool_use";
+        case "stop_sequence":
+            return "stop_sequence";
+        case "refusal":
+            return "refusal";
+        default:
+            // Empty and unknown reasons pass through as-is (matching the oracle),
+            // rather than being coerced to end_turn.
+            return s;
+    }
+}
+/**
+ * Convert a wire usage block into galdor's usage shape.
+ *
+ * @returns Token counts with cache-creation and cache-read figures, each
+ * defaulting to zero when the field is absent.
+ */
+export function usageFromWire(u) {
+    return {
+        inputTokens: u.input_tokens ?? 0,
+        outputTokens: u.output_tokens ?? 0,
+        cacheCreationTokens: u.cache_creation_input_tokens ?? 0,
+        cacheReadTokens: u.cache_read_input_tokens ?? 0,
+    };
+}
+/**
+ * Collapse a non-streaming Anthropic {@link MessageResponse} into a galdor {@link Response}.
+ *
+ * Text and thinking blocks become assistant content parts; `tool_use` blocks
+ * become tool calls; `redacted_thinking` is preserved via its signature. Empty
+ * blocks are skipped.
+ *
+ * @param r - The decoded wire response.
+ * @param raw - Optional raw response bytes, attached as `providerRaw` when given.
+ * @returns The assembled response with message, stop reason, usage and model.
+ */
+export function responseFromWire(r, raw) {
+    const message = { role: Role.Assistant, content: [] };
+    const toolCalls = [];
+    for (const b of r.content) {
+        switch (b.type) {
+            case "text":
+                if (b.text)
+                    message.content.push(textPart(b.text));
+                break;
+            case "tool_use":
+                toolCalls.push({ id: b.id ?? "", name: b.name ?? "", arguments: (b.input ?? {}) });
+                break;
+            case "thinking":
+                if (b.thinking)
+                    message.content.push({ type: ContentType.Thinking, text: b.thinking, ...(b.signature ? { signature: b.signature } : {}) });
+                break;
+            case "redacted_thinking":
+                if (b.data)
+                    message.content.push({ type: ContentType.RedactedThinking, signature: b.data });
+                break;
+        }
+    }
+    if (toolCalls.length > 0)
+        message.toolCalls = toolCalls;
+    return {
+        message,
+        stopReason: normalizeStopReason(r.stop_reason),
+        usage: usageFromWire(r.usage),
+        model: r.model,
+        ...(raw ? { providerRaw: raw } : {}),
+    };
+}
+/**
+ * Rewrite a forced structured-output tool call into plain message text.
+ *
+ * When the response contains the tool call that backs structured output, its
+ * arguments are serialized to JSON and become the assistant message body, so
+ * callers receive the structured result as text rather than a tool invocation.
+ * If no matching call is found, the response is returned unchanged.
+ *
+ * @param resp - The response produced by {@link responseFromWire}.
+ * @param schemaName - The configured schema name, resolved the same way as in {@link buildRequest}.
+ * @returns The (possibly rewritten) response.
+ */
+export function extractStructuredOutput(resp, schemaName) {
+    const name = structuredToolName(schemaName);
+    for (const tc of resp.message.toolCalls ?? []) {
+        if (tc.name === name) {
+            resp.message = { role: Role.Assistant, content: [textPart(JSON.stringify(tc.arguments))] };
+            return resp;
+        }
+    }
+    return resp;
+}
+//# sourceMappingURL=convert.js.map

package/dist/convert.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Normalization of Anthropic HTTP failures into galdor's typed error surface.
+ *
+ * The Messages API signals failure both through the HTTP status code and through
+ * a JSON `error.type` discriminator in the body. This module folds the two into
+ * a single {@link ErrorKind}, preferring the body's classification when present
+ * and falling back to the status code otherwise, then wraps the result in an
+ * {@link APIError} so callers can branch on `instanceof` of the concrete error
+ * subclasses produced by {@link classify}.
+ */
+import { APIError } from "@galdor/core/provider";
+/**
+ * Minimal structural view of a fetch `Response` needed to classify a failure.
+ *
+ * Accepting this narrow interface (rather than the full `Response`) keeps
+ * {@link normalizeHTTPError} testable with lightweight stubs.
+ */
+export interface ResponseLike {
+    /** HTTP status code of the failed response. */
+    status: number;
+    /** Header accessor; used to read `retry-after`. */
+    headers: {
+        get(name: string): string | null;
+    };
+    /** Reads the full response body as text. */
+    text(): Promise<string>;
+}
+/**
+ * Convert a non-2xx Anthropic response into a typed galdor {@link APIError}.
+ *
+ * The body is read once and parsed as JSON; when it carries an `error.type`,
+ * that classification wins over the status-derived kind, and the human-readable
+ * `error.message` becomes the error message. A `retry-after` header, if present,
+ * is parsed and attached. The result is passed through {@link classify} so the
+ * caller receives the concrete error subclass for the kind.
+ *
+ * @param res - The failed response (or a structural stand-in).
+ * @returns A classified {@link APIError} describing the failure.
+ * @example
+ * if (Math.floor(res.status / 100) !== 2) throw await normalizeHTTPError(res);
+ */
+export declare function normalizeHTTPError(res: ResponseLike): Promise<APIError>;
+/**
+ * Build a typed galdor {@link APIError} from an Anthropic streaming `error`
+ * frame, which carries no HTTP status.
+ *
+ * The mid-stream `error` SSE event reports its `error.type` discriminator and a
+ * human message but, unlike an HTTP failure, has no status code to fall back on.
+ * The type is mapped through the same {@link kindForType} table used for HTTP
+ * errors and defaults to `server` when unrecognized. The result is passed
+ * through {@link classify} so the caller receives the concrete subclass.
+ *
+ * @param type - The `error.type` discriminator from the frame, if any.
+ * @param message - The human-readable error message from the frame.
+ * @returns A classified {@link APIError} with `statusCode` 0.
+ */
+export declare function classifyStreamError(type: string | undefined, message: string): APIError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAA6C,MAAM,uBAAuB,CAAC;AA2C5F;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAC9C,4CAA4C;IAC5C,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkB7E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAGvF"}

package/dist/errors.js

@@ -0,0 +1,100 @@
+/**
+ * Normalization of Anthropic HTTP failures into galdor's typed error surface.
+ *
+ * The Messages API signals failure both through the HTTP status code and through
+ * a JSON `error.type` discriminator in the body. This module folds the two into
+ * a single {@link ErrorKind}, preferring the body's classification when present
+ * and falling back to the status code otherwise, then wraps the result in an
+ * {@link APIError} so callers can branch on `instanceof` of the concrete error
+ * subclasses produced by {@link classify}.
+ */
+import { APIError, classify, parseRetryAfter } from "@galdor/core/provider";
+const PROVIDER_NAME = "anthropic";
+/** Map an HTTP status code to a galdor {@link ErrorKind} as a coarse fallback. */
+function kindForStatus(code) {
+    if (code === 401 || code === 403)
+        return "auth";
+    if (code === 429)
+        return "rate_limited";
+    if (code >= 500)
+        return "server";
+    if (code >= 400)
+        return "invalid_request";
+    return "server";
+}
+/**
+ * Map Anthropic's `error.type` discriminator to a galdor {@link ErrorKind}.
+ *
+ * @returns The matching kind, or `undefined` when the type is unknown so the
+ * caller can fall back to {@link kindForStatus}.
+ */
+function kindForType(t) {
+    switch (t) {
+        case "authentication_error":
+        case "permission_error":
+            return "auth";
+        case "rate_limit_error":
+        case "overloaded_error":
+            return "rate_limited";
+        case "invalid_request_error":
+        case "not_found_error":
+            return "invalid_request";
+        case "api_error":
+            return "server";
+        default:
+            return undefined;
+    }
+}
+/**
+ * Convert a non-2xx Anthropic response into a typed galdor {@link APIError}.
+ *
+ * The body is read once and parsed as JSON; when it carries an `error.type`,
+ * that classification wins over the status-derived kind, and the human-readable
+ * `error.message` becomes the error message. A `retry-after` header, if present,
+ * is parsed and attached. The result is passed through {@link classify} so the
+ * caller receives the concrete error subclass for the kind.
+ *
+ * @param res - The failed response (or a structural stand-in).
+ * @returns A classified {@link APIError} describing the failure.
+ * @example
+ * if (Math.floor(res.status / 100) !== 2) throw await normalizeHTTPError(res);
+ */
+export async function normalizeHTTPError(res) {
+    const text = await res.text().catch(() => "");
+    let kind = kindForStatus(res.status);
+    let message = `anthropic: HTTP ${res.status}`;
+    if (text) {
+        try {
+            const body = JSON.parse(text);
+            if (body.error?.message)
+                message = body.error.message;
+            const k = kindForType(body.error?.type);
+            if (k)
+                kind = k;
+        }
+        catch {
+            /* non-JSON body: keep the status-derived kind and default message */
+        }
+    }
+    const retryAfter = parseRetryAfter(res.headers.get("retry-after") ?? "", new Date());
+    return classify(new APIError({ kind, provider: PROVIDER_NAME, statusCode: res.status, message, ...(retryAfter !== null ? { retryAfter } : {}) }));
+}
+/**
+ * Build a typed galdor {@link APIError} from an Anthropic streaming `error`
+ * frame, which carries no HTTP status.
+ *
+ * The mid-stream `error` SSE event reports its `error.type` discriminator and a
+ * human message but, unlike an HTTP failure, has no status code to fall back on.
+ * The type is mapped through the same {@link kindForType} table used for HTTP
+ * errors and defaults to `server` when unrecognized. The result is passed
+ * through {@link classify} so the caller receives the concrete subclass.
+ *
+ * @param type - The `error.type` discriminator from the frame, if any.
+ * @param message - The human-readable error message from the frame.
+ * @returns A classified {@link APIError} with `statusCode` 0.
+ */
+export function classifyStreamError(type, message) {
+    const kind = kindForType(type) ?? "server";
+    return classify(new APIError({ kind, provider: PROVIDER_NAME, statusCode: 0, message }));
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAkB,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE5F,MAAM,aAAa,GAAG,WAAW,CAAC;AAQlC,kFAAkF;AAClF,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IAChD,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,cAAc,CAAC;IACxC,IAAI,IAAI,IAAI,GAAG;QAAE,OAAO,QAAQ,CAAC;IACjC,IAAI,IAAI,IAAI,GAAG;QAAE,OAAO,iBAAiB,CAAC;IAC1C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,CAAqB;IACxC,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,sBAAsB,CAAC;QAC5B,KAAK,kBAAkB;YACrB,OAAO,MAAM,CAAC;QAChB,KAAK,kBAAkB,CAAC;QACxB,KAAK,kBAAkB;YACrB,OAAO,cAAc,CAAC;QACxB,KAAK,uBAAuB,CAAC;QAC7B,KAAK,iBAAiB;YACpB,OAAO,iBAAiB,CAAC;QAC3B,KAAK,WAAW;YACd,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAiBD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAiB;IACxD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,OAAO,GAAG,mBAAmB,GAAG,CAAC,MAAM,EAAE,CAAC;IAC9C,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAuB,CAAC;YACpD,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO;gBAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YACtD,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC;gBAAE,IAAI,GAAG,CAAC,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;QACvE,CAAC;IACH,CAAC;IACD,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACrF,OAAO,QAAQ,CACb,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CACjI,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAwB,EAAE,OAAe;IAC3E,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;IAC3C,OAAO,QAAQ,CAAC,IAAI,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAC3F,CAAC"}