@galdor/provider-anthropic 0.3.0

package/dist/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * `@galdor/provider-anthropic` — Anthropic (Claude Messages API) adapter.
+ *
+ * Implements the galdor {@link Provider} interface over the `/v1/messages`
+ * endpoint, supporting tool use, vision input, extended thinking, prompt
+ * caching, and structured output (expressed as a forced single tool call). Both
+ * a buffered {@link AnthropicProvider.generate} and an incremental
+ * {@link AnthropicProvider.stream} path are provided; construct an instance with
+ * {@link newAnthropic}.
+ */
+import { type Capabilities, type Event, type Provider, type Request, type Response, type RunContext } from "@galdor/core/provider";
+/** Construction options for an {@link AnthropicProvider}. */
+export interface Config {
+    /** Anthropic API key; required and must be non-empty. */
+    apiKey: string;
+    /** Overrides the API endpoint. Defaults to `https://api.anthropic.com`; trailing slashes are trimmed. */
+    baseURL?: string;
+    /** Value sent as the `anthropic-version` header. Defaults to `2023-06-01`. */
+    apiVersion?: string;
+    /** Suffix appended to the default user-agent when non-empty. */
+    userAgent?: string;
+    /**
+     * Response-header timeout in milliseconds: abort if the server doesn't return
+     * headers in time. Streaming bodies are NOT cut off once headers arrive.
+     * Defaults to 60000 (60 s); `0` disables it. Also settable via
+     * `LLM_HTTP_TIMEOUT` through providerset.
+     */
+    timeoutMs?: number;
+}
+/**
+ * galdor {@link Provider} backed by the Anthropic Messages API.
+ *
+ * Holds connection settings and builds the per-request headers; the actual wire
+ * translation and SSE handling live in the conversion and streaming helpers.
+ * Prefer {@link newAnthropic} to construct one.
+ */
+export declare class AnthropicProvider implements Provider {
+    #private;
+    /**
+     * Create a provider from the given {@link Config}.
+     *
+     * @throws {Error} When `apiKey` is missing or blank.
+     */
+    constructor(cfg: Config);
+    /** @returns The provider's stable identifier, `"anthropic"`. */
+    name(): string;
+    /** @returns The feature set this adapter supports, including the model context window. */
+    capabilities(): Capabilities;
+    /**
+     * Run a single buffered completion against `/v1/messages`.
+     *
+     * Lowers the request to the wire shape, POSTs it, decodes the full response,
+     * and applies structured-output extraction when a `json_schema` format was
+     * requested.
+     *
+     * @param req - The galdor request to run.
+     * @param ctx - Optional run context; its abort signal cancels the request.
+     * @returns The completed galdor {@link Response}.
+     * @throws {APIError} On a non-2xx status or when the response body cannot be decoded.
+     */
+    generate(req: Request, ctx?: RunContext): Promise<Response>;
+    /**
+     * Run a streaming completion, yielding incremental provider events.
+     *
+     * @param req - The galdor request to run.
+     * @param ctx - Optional run context; its abort signal cancels the stream.
+     * @returns An async iterable of {@link Event}s ending with a message-stop event.
+     */
+    stream(req: Request, ctx?: RunContext): AsyncIterable<Event>;
+}
+/**
+ * Construct an {@link AnthropicProvider} from a {@link Config}.
+ *
+ * @param cfg - Connection options; `apiKey` is required.
+ * @returns A ready-to-use provider instance.
+ * @throws {Error} When `apiKey` is missing or blank.
+ * @example
+ * const provider = newAnthropic({ apiKey: process.env.ANTHROPIC_API_KEY! });
+ * const resp = await provider.generate({
+ *   model: "claude-haiku-4-5",
+ *   messages: [{ role: "user", content: [{ type: "text", text: "hi" }] }],
+ * });
+ */
+export declare function newAnthropic(cfg: Config): AnthropicProvider;
+export { normalizeHTTPError } from "./errors.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,YAAY,EAEjB,KAAK,KAAK,EAEV,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,UAAU,EAEhB,MAAM,uBAAuB,CAAC;AAS/B,6DAA6D;AAC7D,MAAM,WAAW,MAAM;IACrB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;;IAOhD;;;;OAIG;gBACS,GAAG,EAAE,MAAM;IASvB,gEAAgE;IAChE,IAAI,IAAI,MAAM;IAId,0FAA0F;IAC1F,YAAY,IAAI,YAAY;IAwB5B;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC;IA0BjE;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC;CAM7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAE3D;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,138 @@
+/**
+ * `@galdor/provider-anthropic` — Anthropic (Claude Messages API) adapter.
+ *
+ * Implements the galdor {@link Provider} interface over the `/v1/messages`
+ * endpoint, supporting tool use, vision input, extended thinking, prompt
+ * caching, and structured output (expressed as a forced single tool call). Both
+ * a buffered {@link AnthropicProvider.generate} and an incremental
+ * {@link AnthropicProvider.stream} path are provided; construct an instance with
+ * {@link newAnthropic}.
+ */
+import { APIError, classify, fetchWithHeaderTimeout, validateRequest, } from "@galdor/core/provider";
+import { buildRequest, extractStructuredOutput, responseFromWire } from "./convert.js";
+import { normalizeHTTPError } from "./errors.js";
+import { streamMessages } from "./stream.js";
+const PROVIDER_NAME = "anthropic";
+const DEFAULT_BASE_URL = "https://api.anthropic.com";
+const DEFAULT_API_VERSION = "2023-06-01";
+/**
+ * galdor {@link Provider} backed by the Anthropic Messages API.
+ *
+ * Holds connection settings and builds the per-request headers; the actual wire
+ * translation and SSE handling live in the conversion and streaming helpers.
+ * Prefer {@link newAnthropic} to construct one.
+ */
+export class AnthropicProvider {
+    #apiKey;
+    #baseURL;
+    #apiVersion;
+    #userAgent;
+    #timeoutMs;
+    /**
+     * Create a provider from the given {@link Config}.
+     *
+     * @throws {Error} When `apiKey` is missing or blank.
+     */
+    constructor(cfg) {
+        if (!cfg.apiKey || cfg.apiKey.trim() === "")
+            throw new Error("anthropic: apiKey is required");
+        this.#apiKey = cfg.apiKey;
+        this.#baseURL = (cfg.baseURL || DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.#apiVersion = cfg.apiVersion || DEFAULT_API_VERSION;
+        this.#userAgent = cfg.userAgent ?? "";
+        this.#timeoutMs = cfg.timeoutMs ?? 60_000;
+    }
+    /** @returns The provider's stable identifier, `"anthropic"`. */
+    name() {
+        return PROVIDER_NAME;
+    }
+    /** @returns The feature set this adapter supports, including the model context window. */
+    capabilities() {
+        return {
+            streaming: true,
+            toolCalling: true,
+            structuredOutput: true,
+            promptCaching: true,
+            visionInput: true,
+            reasoning: true,
+            maxContextTokens: 200_000,
+        };
+    }
+    /** Build the request headers, folding in any configured user-agent suffix. */
+    #headers() {
+        let ua = "galdor-anthropic/0.1";
+        if (this.#userAgent)
+            ua += ` ${this.#userAgent}`;
+        return {
+            "x-api-key": this.#apiKey,
+            "anthropic-version": this.#apiVersion,
+            "content-type": "application/json",
+            "user-agent": ua,
+        };
+    }
+    /**
+     * Run a single buffered completion against `/v1/messages`.
+     *
+     * Lowers the request to the wire shape, POSTs it, decodes the full response,
+     * and applies structured-output extraction when a `json_schema` format was
+     * requested.
+     *
+     * @param req - The galdor request to run.
+     * @param ctx - Optional run context; its abort signal cancels the request.
+     * @returns The completed galdor {@link Response}.
+     * @throws {APIError} On a non-2xx status or when the response body cannot be decoded.
+     */
+    async generate(req, ctx) {
+        const capErr = validateRequest(this.capabilities(), req);
+        if (capErr)
+            throw capErr;
+        const wire = buildRequest(req, false);
+        const res = await fetchWithHeaderTimeout(`${this.#baseURL}/v1/messages`, { method: "POST", headers: this.#headers(), body: JSON.stringify(wire) }, this.#timeoutMs, ctx?.signal);
+        if (Math.floor(res.status / 100) !== 2)
+            throw await normalizeHTTPError(res);
+        const rawBytes = new Uint8Array(await res.arrayBuffer());
+        let body;
+        try {
+            body = JSON.parse(new TextDecoder().decode(rawBytes));
+        }
+        catch (e) {
+            throw classify(new APIError({ kind: "server", provider: PROVIDER_NAME, statusCode: res.status, message: `decode response: ${e.message}` }));
+        }
+        let out = responseFromWire(body, rawBytes);
+        if (req.responseFormat?.type === "json_schema")
+            out = extractStructuredOutput(out, req.responseFormat.name);
+        return out;
+    }
+    /**
+     * Run a streaming completion, yielding incremental provider events.
+     *
+     * @param req - The galdor request to run.
+     * @param ctx - Optional run context; its abort signal cancels the stream.
+     * @returns An async iterable of {@link Event}s ending with a message-stop event.
+     */
+    stream(req, ctx) {
+        const capErr = validateRequest(this.capabilities(), req);
+        if (capErr)
+            throw capErr;
+        const wire = buildRequest(req, true);
+        return streamMessages(`${this.#baseURL}/v1/messages`, this.#headers(), wire, ctx?.signal, this.#timeoutMs);
+    }
+}
+/**
+ * Construct an {@link AnthropicProvider} from a {@link Config}.
+ *
+ * @param cfg - Connection options; `apiKey` is required.
+ * @returns A ready-to-use provider instance.
+ * @throws {Error} When `apiKey` is missing or blank.
+ * @example
+ * const provider = newAnthropic({ apiKey: process.env.ANTHROPIC_API_KEY! });
+ * const resp = await provider.generate({
+ *   model: "claude-haiku-4-5",
+ *   messages: [{ role: "user", content: [{ type: "text", text: "hi" }] }],
+ * });
+ */
+export function newAnthropic(cfg) {
+    return new AnthropicProvider(cfg);
+}
+export { normalizeHTTPError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/stream.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Anthropic streaming over Server-Sent Events.
+ *
+ * Translates Anthropic's SSE event sequence (`message_start`, `content_block_*`,
+ * `message_delta`, `message_stop`) into galdor's provider {@link Event} stream
+ * ({@link EventType.MessageStart}, {@link EventType.ContentDelta},
+ * {@link EventType.ToolCallDelta}, {@link EventType.MessageStop}). The bytes
+ * arrive in arbitrary chunks, so the reader buffers and splits on the blank-line
+ * delimiter that separates SSE messages. Consume the result with `for await`, or
+ * fold it back into a single Response with `collectStream`.
+ */
+import { type Event } from "@galdor/core/provider";
+import type { MessageRequest } from "./convert.ts";
+/**
+ * POST a streaming `/v1/messages` request and yield galdor provider events.
+ *
+ * Sends the request with `stream: true` already set on `body`, then reads the
+ * SSE response incrementally: each complete event block is parsed and converted
+ * into zero or more {@link Event}s. Running token usage, the model name, and the
+ * stop reason are accumulated across the stream and emitted as a final
+ * {@link EventType.MessageStop} once the body is exhausted.
+ *
+ * @param url - Full messages endpoint to POST to.
+ * @param headers - Request headers, including auth and content type.
+ * @param body - The wire request; its `stream` flag should already be true.
+ * @param signal - Optional abort signal to cancel the in-flight request.
+ * @returns An async generator of provider events, ending with a MessageStop.
+ * @throws {APIError} When the response status is not 2xx (see {@link normalizeHTTPError}).
+ * @throws {Error} When a 2xx response unexpectedly carries no body.
+ * @example
+ * for await (const ev of streamMessages(url, headers, wire, signal)) {
+ *   if (ev.type === EventType.ContentDelta) process.stdout.write(ev.contentDelta);
+ * }
+ */
+export declare function streamMessages(url: string, headers: Record<string, string>, body: MessageRequest, signal: AbortSignal | undefined, timeoutMs?: number): AsyncGenerator<Event>;
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAqC,MAAM,uBAAuB,CAAC;AAGtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AA0FnD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAuB,cAAc,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,SAAS,SAAI,GACZ,cAAc,CAAC,KAAK,CAAC,CAwCvB"}

package/dist/stream.js

@@ -0,0 +1,212 @@
+/**
+ * Anthropic streaming over Server-Sent Events.
+ *
+ * Translates Anthropic's SSE event sequence (`message_start`, `content_block_*`,
+ * `message_delta`, `message_stop`) into galdor's provider {@link Event} stream
+ * ({@link EventType.MessageStart}, {@link EventType.ContentDelta},
+ * {@link EventType.ToolCallDelta}, {@link EventType.MessageStop}). The bytes
+ * arrive in arbitrary chunks, so the reader buffers and splits on the blank-line
+ * delimiter that separates SSE messages. Consume the result with `for await`, or
+ * fold it back into a single Response with `collectStream`.
+ */
+import { EventType, fetchWithHeaderTimeout } from "@galdor/core/provider";
+import { ContentType, Role } from "@galdor/core/schema";
+import { classifyStreamError, normalizeHTTPError } from "./errors.js";
+/** A zero-valued usage accumulator to fill in as the stream reports token counts. */
+function emptyUsage() {
+    return { inputTokens: 0, outputTokens: 0, cacheCreationTokens: 0, cacheReadTokens: 0 };
+}
+/**
+ * Fold any cache token counts from a wire usage object into the running usage,
+ * so streamed usage matches the non-streaming path. Counts are reported only
+ * when present, so each is applied only when non-zero.
+ */
+function foldCacheUsage(usage, wire) {
+    if (wire?.cache_creation_input_tokens)
+        usage.cacheCreationTokens = wire.cache_creation_input_tokens;
+    if (wire?.cache_read_input_tokens)
+        usage.cacheReadTokens = wire.cache_read_input_tokens;
+}
+/**
+ * Build the terminal assistant {@link Message} carrying any accumulated
+ * reasoning, or `undefined` when none was streamed. The assistant text rides the
+ * content deltas, so this message holds only the thinking part; downstream
+ * `collectStream` harvests the thinking block from here.
+ */
+function reasoningMessage(r) {
+    if (r.thinking === "" && r.signature === "")
+        return undefined;
+    return {
+        role: Role.Assistant,
+        content: [{ type: ContentType.Thinking, text: r.thinking, signature: r.signature }],
+    };
+}
+/**
+ * Map a raw Anthropic stop-reason string to a {@link StopReason}. Known reasons
+ * map to themselves; empty and unknown values pass through unchanged (matching
+ * the non-streaming path) rather than being coerced to `end_turn`.
+ */
+function normalizeStopReason(s) {
+    switch (s) {
+        case "end_turn":
+        case "max_tokens":
+        case "tool_use":
+        case "stop_sequence":
+        case "refusal":
+            return s;
+        default:
+            return (s ?? "");
+    }
+}
+/**
+ * POST a streaming `/v1/messages` request and yield galdor provider events.
+ *
+ * Sends the request with `stream: true` already set on `body`, then reads the
+ * SSE response incrementally: each complete event block is parsed and converted
+ * into zero or more {@link Event}s. Running token usage, the model name, and the
+ * stop reason are accumulated across the stream and emitted as a final
+ * {@link EventType.MessageStop} once the body is exhausted.
+ *
+ * @param url - Full messages endpoint to POST to.
+ * @param headers - Request headers, including auth and content type.
+ * @param body - The wire request; its `stream` flag should already be true.
+ * @param signal - Optional abort signal to cancel the in-flight request.
+ * @returns An async generator of provider events, ending with a MessageStop.
+ * @throws {APIError} When the response status is not 2xx (see {@link normalizeHTTPError}).
+ * @throws {Error} When a 2xx response unexpectedly carries no body.
+ * @example
+ * for await (const ev of streamMessages(url, headers, wire, signal)) {
+ *   if (ev.type === EventType.ContentDelta) process.stdout.write(ev.contentDelta);
+ * }
+ */
+export async function* streamMessages(url, headers, body, signal, timeoutMs = 0) {
+    const res = await fetchWithHeaderTimeout(url, { method: "POST", headers: { ...headers, accept: "text/event-stream" }, body: JSON.stringify(body) }, timeoutMs, signal);
+    if (Math.floor(res.status / 100) !== 2)
+        throw await normalizeHTTPError(res);
+    if (!res.body)
+        throw new Error("anthropic: streaming response had no body");
+    // Maps a content-block index to its tool-call id so later input_json_delta
+    // events (which carry only the index) can be attributed to the right call.
+    const toolIndex = new Map();
+    const usage = emptyUsage();
+    const reasoning = { thinking: "", signature: "" };
+    let model = "";
+    // Empty until a message_delta reports one; passed through as-is, matching the
+    // oracle (a stream that ends without a stop_reason emits an empty reason).
+    let stopReason = "";
+    const decoder = new TextDecoder();
+    let buffer = "";
+    for await (const chunk of res.body) {
+        buffer += decoder.decode(chunk, { stream: true });
+        // SSE messages are separated by a blank line.
+        let sep;
+        while ((sep = buffer.indexOf("\n\n")) !== -1) {
+            const rawEvent = buffer.slice(0, sep);
+            buffer = buffer.slice(sep + 2);
+            const data = parseDataLine(rawEvent);
+            if (data === undefined)
+                continue;
+            // handleEvent throws on a mid-stream `error` frame; the throw propagates
+            // through `yield*` to the `for await` consumer.
+            yield* handleEvent(data, { toolIndex, usage, reasoning }, (m) => (model = m), (sr) => (stopReason = sr));
+        }
+    }
+    const message = reasoningMessage(reasoning);
+    yield { type: EventType.MessageStop, stopReason, usage, model, ...(message ? { message } : {}) };
+}
+/**
+ * Extract and JSON-parse the `data:` payload from one SSE event block.
+ *
+ * Concatenates multiple `data:` lines within the block, ignores the terminal
+ * `[DONE]` sentinel and empty payloads, and swallows parse failures.
+ *
+ * @returns The decoded event, or `undefined` when there is nothing to emit.
+ */
+function parseDataLine(rawEvent) {
+    const dataParts = [];
+    for (const line of rawEvent.split("\n")) {
+        if (line.startsWith("data:"))
+            dataParts.push(line.slice(5).trimStart());
+    }
+    if (dataParts.length === 0)
+        return undefined;
+    const payload = dataParts.join("\n");
+    if (payload === "" || payload === "[DONE]")
+        return undefined;
+    try {
+        return JSON.parse(payload);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Convert one decoded SSE event into galdor provider events, mutating the shared
+ * accumulator state (tool-index map, usage, and reasoning) and reporting the
+ * model and stop reason through the supplied setters. Block-stop, message-stop
+ * and ping events produce nothing mid-stream. Thinking and signature deltas are
+ * accumulated silently rather than forwarded. An `error` frame throws.
+ *
+ * @throws {APIError} When the frame is a mid-stream `error` event.
+ */
+function* handleEvent(ev, state, setModel, setStop) {
+    switch (ev.type) {
+        case "message_start": {
+            const model = ev.message?.model ?? "";
+            if (model)
+                setModel(model);
+            if (ev.message?.usage?.input_tokens)
+                state.usage.inputTokens = ev.message.usage.input_tokens;
+            foldCacheUsage(state.usage, ev.message?.usage);
+            yield { type: EventType.MessageStart, model, usage: { ...state.usage } };
+            break;
+        }
+        case "content_block_start": {
+            const cb = ev.content_block;
+            if (cb?.type === "tool_use" && typeof ev.index === "number") {
+                const id = cb.id ?? "";
+                state.toolIndex.set(ev.index, id);
+                yield { type: EventType.ToolCallDelta, toolCallDelta: { id, name: cb.name ?? "", argumentsDelta: "" } };
+            }
+            break;
+        }
+        case "content_block_delta": {
+            const d = ev.delta;
+            if (d?.type === "text_delta" && d.text) {
+                yield { type: EventType.ContentDelta, contentDelta: d.text };
+            }
+            else if (d?.type === "input_json_delta" && typeof ev.index === "number") {
+                const id = state.toolIndex.get(ev.index) ?? "";
+                yield { type: EventType.ToolCallDelta, toolCallDelta: { id, name: "", argumentsDelta: d.partial_json ?? "" } };
+            }
+            else if (d?.type === "thinking_delta" && d.thinking) {
+                // Extended-thinking text; gather it for the terminal message, not live.
+                state.reasoning.thinking += d.thinking;
+            }
+            else if (d?.type === "signature_delta" && d.signature) {
+                // The provider-issued signature for the thinking block, gathered silently.
+                state.reasoning.signature += d.signature;
+            }
+            break;
+        }
+        case "message_delta": {
+            if (ev.delta?.stop_reason)
+                setStop(normalizeStopReason(ev.delta.stop_reason));
+            if (ev.usage?.output_tokens)
+                state.usage.outputTokens = ev.usage.output_tokens;
+            // Anthropic can also report input_tokens here (not just at message_start);
+            // track the latest so the terminal event carries them, matching the oracle.
+            if (ev.usage?.input_tokens)
+                state.usage.inputTokens = ev.usage.input_tokens;
+            foldCacheUsage(state.usage, ev.usage);
+            break;
+        }
+        case "error": {
+            // A mid-stream failure: classify by error type and propagate by throwing,
+            // which surfaces to the `for await` consumer rather than being swallowed.
+            throw classifyStreamError(ev.error?.type, ev.error?.message ?? "anthropic: stream error");
+        }
+        // content_block_stop / message_stop / ping: nothing to emit mid-stream.
+    }
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

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

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@galdor/provider-anthropic",
+  "version": "0.3.0",
+  "type": "module",
+  "description": "Anthropic (Claude Messages API) provider adapter for galdor-bun.",
+  "author": {
+    "name": "Yasser Rosas",
+    "email": "yassros16@gmail.com"
+  },
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json"
+  },
+  "engines": {
+    "node": ">=22.5",
+    "bun": ">=1.3"
+  },
+  "dependencies": {
+    "@galdor/core": "0.3.0"
+  }
+}