@demicodes/provider-anthropic-api 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,11 @@
+# @demicodes/provider-anthropic-api
+
+A Demi provider for the Anthropic Messages API. Exposes
+`createAnthropicApiProvider()`.
+
+```ts
+import { createAnthropicApiProvider } from '@demicodes/provider-anthropic-api'
+```
+
+Implements the [`@demicodes/provider`](../provider/README.md) contract. Part of
+[Demi](../../README.md). Apache-2.0.

package/dist/index.d.mts

@@ -0,0 +1,51 @@
+import { Provider, ProviderModel, ProviderModelList } from "@demicodes/provider";
+
+//#region src/models.d.ts
+interface AnthropicApiModelOptions {
+  id: string;
+  displayName?: string;
+  description?: string;
+  contextWindow: number;
+  outputLimit?: number | null;
+  supportsTools?: boolean | null;
+  supportsAttachments?: boolean | null;
+  supportsReasoning?: boolean | null;
+  supportedThinkingEfforts?: string[] | null;
+  defaultThinkingEffort?: string | null;
+  canDisableThinking?: boolean | null;
+  serviceTiers?: ProviderModel['serviceTiers'];
+  defaultServiceTierId?: string | null;
+}
+declare function anthropicApiDefaultModels(providerId?: string): ProviderModelList;
+//#endregion
+//#region src/provider.d.ts
+type AnthropicApiSecretResolver = () => string | Promise<string> | null | undefined;
+type AnthropicApiHeadersResolver = () => Record<string, string> | Promise<Record<string, string>>;
+type AnthropicApiFetch = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+interface AnthropicApiRequestOptions {
+  /** Overrides the derived max_tokens (default: the model's outputLimit, else 32000). */
+  maxTokens?: number;
+  /**
+   * Budget tokens used when an effort/adaptive thinking config is mapped onto
+   * the Messages API's budget knob. Merged over the built-in ladder
+   * (low 4k / medium 16k / high 32k / xhigh 64k / max 96k).
+   */
+  effortBudgetTokens?: Record<string, number>;
+  extraBody?: Record<string, unknown>;
+}
+interface AnthropicApiProviderOptions {
+  id?: string;
+  displayName?: string;
+  envPrefix?: string;
+  baseUrl?: string;
+  apiKey?: AnthropicApiSecretResolver;
+  headers?: AnthropicApiHeadersResolver;
+  anthropicVersion?: string;
+  models?: AnthropicApiModelOptions[];
+  defaultModelId?: string;
+  request?: AnthropicApiRequestOptions;
+  fetch?: AnthropicApiFetch;
+}
+declare function createAnthropicApiProvider(options?: AnthropicApiProviderOptions): Provider;
+//#endregion
+export { type AnthropicApiHeadersResolver, type AnthropicApiModelOptions, type AnthropicApiProviderOptions, type AnthropicApiRequestOptions, type AnthropicApiSecretResolver, anthropicApiDefaultModels, createAnthropicApiProvider };

package/dist/index.mjs

@@ -0,0 +1,537 @@
+import { isAbortError, isRecord, normalizeBaseUrl, numberOrNull, numberOrZero, parseJsonObject, parseJsonOrString, stringOrNull } from "@demicodes/utils";
+import { Buffer } from "node:buffer";
+import process from "node:process";
+import { zeroUsage } from "@demicodes/core";
+import { authStatusFromKey, defineProvider, httpRequestFailedEvent, normalizeErrorCode, providerErrorFromUnknown, withProviderId } from "@demicodes/provider";
+//#region src/models.ts
+const SOURCE_FETCHED_AT = "1970-01-01T00:00:00.000Z";
+function anthropicApiDefaultModels(providerId = "anthropic") {
+	return modelListFromAnthropicApiModels([
+		{
+			id: "claude-opus-4-8",
+			displayName: "Claude Opus 4.8",
+			contextWindow: 1e6,
+			outputLimit: 128e3,
+			supportsTools: true,
+			supportsAttachments: true,
+			supportsReasoning: true,
+			supportedThinkingEfforts: [
+				"low",
+				"medium",
+				"high",
+				"xhigh",
+				"max"
+			],
+			canDisableThinking: false
+		},
+		{
+			id: "claude-opus-4-7",
+			displayName: "Claude Opus 4.7",
+			contextWindow: 1e6,
+			outputLimit: 128e3,
+			supportsTools: true,
+			supportsAttachments: true,
+			supportsReasoning: true,
+			supportedThinkingEfforts: [
+				"low",
+				"medium",
+				"high",
+				"xhigh",
+				"max"
+			],
+			canDisableThinking: false
+		},
+		{
+			id: "claude-opus-4-6",
+			displayName: "Claude Opus 4.6",
+			contextWindow: 1e6,
+			outputLimit: 128e3,
+			supportsTools: true,
+			supportsAttachments: true,
+			supportsReasoning: true,
+			supportedThinkingEfforts: [
+				"low",
+				"medium",
+				"high",
+				"max"
+			],
+			canDisableThinking: false
+		},
+		{
+			id: "claude-sonnet-4-6",
+			displayName: "Claude Sonnet 4.6",
+			contextWindow: 1e6,
+			outputLimit: 64e3,
+			supportsTools: true,
+			supportsAttachments: true,
+			supportsReasoning: true,
+			supportedThinkingEfforts: [
+				"low",
+				"medium",
+				"high",
+				"max"
+			],
+			canDisableThinking: false
+		},
+		{
+			id: "claude-fable-5",
+			displayName: "Claude Fable 5",
+			contextWindow: 1e6,
+			outputLimit: 128e3,
+			supportsTools: true,
+			supportsAttachments: true,
+			supportsReasoning: true,
+			supportedThinkingEfforts: [
+				"low",
+				"medium",
+				"high",
+				"xhigh",
+				"max"
+			],
+			canDisableThinking: false
+		}
+	], {
+		providerId,
+		defaultModelId: "claude-opus-4-8",
+		sourceFetchedAt: SOURCE_FETCHED_AT
+	});
+}
+function modelListFromAnthropicApiModels(models, options) {
+	const sourceFetchedAt = options.sourceFetchedAt ?? (/* @__PURE__ */ new Date()).toISOString();
+	const stale = options.stale === true;
+	const mapped = models.map((model) => ({
+		providerId: options.providerId,
+		id: model.id,
+		displayName: model.displayName ?? model.id,
+		description: model.description,
+		contextWindow: positiveInteger(model.contextWindow, `models[${model.id}].contextWindow`),
+		outputLimit: model.outputLimit ?? null,
+		supportsTools: model.supportsTools ?? null,
+		supportsAttachments: model.supportsAttachments ?? null,
+		supportsReasoning: model.supportsReasoning ?? null,
+		supportedThinkingEfforts: model.supportedThinkingEfforts ? [...model.supportedThinkingEfforts] : null,
+		defaultThinkingEffort: model.defaultThinkingEffort ?? null,
+		canDisableThinking: model.canDisableThinking ?? null,
+		serviceTiers: model.serviceTiers ? model.serviceTiers.map((tier) => ({ ...tier })) : model.serviceTiers,
+		defaultServiceTierId: model.defaultServiceTierId ?? null,
+		sourceFetchedAt,
+		stale
+	}));
+	return {
+		providerId: options.providerId,
+		models: mapped,
+		defaultModelId: options.defaultModelId && mapped.some((model) => model.id === options.defaultModelId) ? options.defaultModelId : mapped[0]?.id ?? null,
+		warnings: [],
+		sourceFetchedAt,
+		stale
+	};
+}
+function positiveInteger(value, field) {
+	if (!Number.isInteger(value) || value <= 0) throw new Error(`${field} must be a positive integer`);
+	return value;
+}
+//#endregion
+//#region src/provider.ts
+const DEFAULT_ANTHROPIC_API_BASE_URL = "https://api.anthropic.com/v1";
+const DEFAULT_ANTHROPIC_VERSION = "2023-06-01";
+const DEFAULT_MAX_TOKENS = 32e3;
+const MIN_THINKING_BUDGET_TOKENS = 1024;
+const DEFAULT_EFFORT_BUDGET_TOKENS = {
+	low: 4096,
+	medium: 16384,
+	high: 32768,
+	xhigh: 65536,
+	max: 98304
+};
+var AnthropicApiProvider = class {
+	options;
+	constructor(options) {
+		this.options = options;
+	}
+	async *run(request) {
+		if (request.cancel.aborted) {
+			yield { type: "abort" };
+			return;
+		}
+		let apiKey;
+		let headers;
+		try {
+			apiKey = await this.options.apiKey();
+			headers = await this.buildHeaders(apiKey);
+			if (!apiKey && !headers.has("x-api-key")) {
+				yield {
+					type: "error",
+					message: "Anthropic API key is missing",
+					code: "auth_missing"
+				};
+				return;
+			}
+		} catch (error) {
+			yield providerErrorFromUnknown(error, apiKey);
+			return;
+		}
+		try {
+			const response = await this.options.fetch(anthropicMessagesUrl(this.options.baseUrl), {
+				method: "POST",
+				headers,
+				body: JSON.stringify(buildAnthropicMessagesBody(request, this.options.request)),
+				signal: request.cancel
+			});
+			if (!response.ok) {
+				yield await httpRequestFailedEvent(response, apiKey, "Anthropic");
+				return;
+			}
+			yield* mapAnthropicMessageStream(readServerSentEvents(response.body, request.cancel), request.cancel);
+		} catch (error) {
+			if (request.cancel.aborted || isAbortError(error)) {
+				yield { type: "abort" };
+				return;
+			}
+			yield providerErrorFromUnknown(error, apiKey);
+		}
+	}
+	async buildHeaders(apiKey) {
+		const headers = new Headers(await this.options.headers?.());
+		headers.set("accept", "text/event-stream");
+		headers.set("content-type", "application/json");
+		headers.set("anthropic-version", this.options.anthropicVersion);
+		if (apiKey) headers.set("x-api-key", apiKey);
+		return headers;
+	}
+};
+function createAnthropicApiProvider(options = {}) {
+	const id = options.id ?? "anthropic";
+	const displayName = options.displayName ?? "Anthropic API";
+	const envPrefix = options.envPrefix ?? "ANTHROPIC";
+	const baseUrl = normalizeBaseUrl(options.baseUrl ?? process.env[`${envPrefix}_BASE_URL`] ?? DEFAULT_ANTHROPIC_API_BASE_URL);
+	const apiKey = options.apiKey ?? (() => process.env[`${envPrefix}_API_KEY`]);
+	const fetchImpl = options.fetch ?? fetch;
+	const modelList = () => options.models ? modelListFromAnthropicApiModels(options.models, {
+		providerId: id,
+		defaultModelId: options.defaultModelId ?? null
+	}) : withProviderId(anthropicApiDefaultModels(id), id);
+	const runtimeOptions = {
+		baseUrl,
+		apiKey,
+		headers: options.headers,
+		anthropicVersion: options.anthropicVersion ?? DEFAULT_ANTHROPIC_VERSION,
+		request: options.request,
+		fetch: fetchImpl
+	};
+	return defineProvider({
+		id,
+		displayName,
+		auth: { status: () => authStatusFromKey(apiKey, options.headers, "x-api-key", "Anthropic") },
+		state: () => ({
+			status: "ready",
+			message: "Uses the Anthropic Messages API"
+		}),
+		listModels: modelList,
+		createRuntime: (selection) => {
+			const outputLimit = modelList().models.find((model) => model.id === selection.model.model.id)?.outputLimit ?? null;
+			const request = {
+				...options.request,
+				maxTokens: options.request?.maxTokens ?? outputLimit ?? void 0
+			};
+			return new AnthropicApiProvider({
+				...runtimeOptions,
+				request
+			});
+		}
+	});
+}
+function buildAnthropicMessagesBody(request, options) {
+	const maxTokens = options?.maxTokens ?? DEFAULT_MAX_TOKENS;
+	const body = {
+		model: request.modelId,
+		messages: inferenceItemsToAnthropicMessages(request.items),
+		max_tokens: maxTokens,
+		stream: true
+	};
+	if (request.systemPrompt.trim()) body.system = request.systemPrompt;
+	if (request.tools.length > 0) body.tools = request.tools.map(toolToAnthropicTool);
+	const budgetTokens = thinkingBudgetTokens(request.thinking, maxTokens, options?.effortBudgetTokens);
+	if (budgetTokens !== null) body.thinking = {
+		type: "enabled",
+		budget_tokens: budgetTokens
+	};
+	if (request.serviceTierId) body.service_tier = request.serviceTierId;
+	if (options?.extraBody) Object.assign(body, options.extraBody);
+	return body;
+}
+/**
+* Maps any thinking config onto the Messages API budget knob: budget configs
+* pass through, effort/adaptive configs resolve through the effort ladder
+* (caller-overridable). Budgets clamp below max_tokens and to the API minimum;
+* nothing is silently dropped.
+*/
+function thinkingBudgetTokens(thinking, maxTokens, effortBudgets) {
+	if (!thinking || thinking.type === "disabled") return null;
+	const requested = thinking.type === "budget" ? thinking.budgetTokens : effortBudgets?.[thinking.effort] ?? DEFAULT_EFFORT_BUDGET_TOKENS[thinking.effort] ?? DEFAULT_EFFORT_BUDGET_TOKENS.medium;
+	const cap = Math.max(MIN_THINKING_BUDGET_TOKENS, maxTokens - MIN_THINKING_BUDGET_TOKENS);
+	return Math.max(MIN_THINKING_BUDGET_TOKENS, Math.min(requested, cap));
+}
+async function* mapAnthropicMessageStream(events, signal) {
+	const toolBlocks = /* @__PURE__ */ new Map();
+	let usage = zeroUsage();
+	for await (const event of events) {
+		if (signal?.aborted) {
+			yield { type: "abort" };
+			return;
+		}
+		for (const data of event.data) {
+			const value = parseJsonObject(data);
+			if (!value) continue;
+			const type = stringOrNull(value.type) ?? event.event;
+			if (type === "error") {
+				const error = isRecord(value.error) ? value.error : value;
+				const message = stringOrNull(error.message) ?? "Anthropic API stream error";
+				yield {
+					type: "error",
+					message,
+					code: normalizeErrorCode(stringOrNull(error.type), message)
+				};
+				return;
+			}
+			if (type === "message_start") {
+				const message = isRecord(value.message) ? value.message : null;
+				const messageUsage = message && isRecord(message.usage) ? message.usage : null;
+				if (messageUsage) usage = mergeAnthropicUsage(usage, messageUsage);
+				continue;
+			}
+			if (type === "content_block_start") {
+				const index = numberOrNull(value.index) ?? 0;
+				const block = isRecord(value.content_block) ? value.content_block : null;
+				if (block?.type === "tool_use") toolBlocks.set(index, {
+					id: stringOrNull(block.id) ?? `tool_use_${index}`,
+					name: stringOrNull(block.name) ?? "",
+					initialInput: block.input,
+					inputJson: ""
+				});
+				else if (block?.type === "thinking") yield { type: "thinking_start" };
+				else if (block?.type === "text") {
+					const text = stringOrNull(block.text);
+					if (text) yield {
+						type: "text_delta",
+						text
+					};
+				}
+				continue;
+			}
+			if (type === "content_block_delta") {
+				const index = numberOrNull(value.index) ?? 0;
+				const delta = isRecord(value.delta) ? value.delta : null;
+				if (!delta) continue;
+				if (delta.type === "text_delta") {
+					const text = stringOrNull(delta.text);
+					if (text) yield {
+						type: "text_delta",
+						text
+					};
+				} else if (delta.type === "thinking_delta") {
+					const text = stringOrNull(delta.thinking);
+					if (text) yield {
+						type: "thinking_delta",
+						text
+					};
+				} else if (delta.type === "signature_delta") {
+					const signature = stringOrNull(delta.signature);
+					if (signature) yield {
+						type: "thinking_signature",
+						signature
+					};
+				} else if (delta.type === "input_json_delta") {
+					const block = toolBlocks.get(index);
+					if (block) block.inputJson += stringOrNull(delta.partial_json) ?? "";
+				}
+				continue;
+			}
+			if (type === "content_block_stop") {
+				const index = numberOrNull(value.index) ?? 0;
+				const block = toolBlocks.get(index);
+				if (block && block.name) yield {
+					type: "tool_call_requested",
+					toolUseId: block.id,
+					toolName: block.name,
+					input: block.inputJson ? parseJsonOrString(block.inputJson) : block.initialInput ?? {}
+				};
+				toolBlocks.delete(index);
+				continue;
+			}
+			if (type === "message_delta") {
+				const deltaUsage = isRecord(value.usage) ? value.usage : null;
+				if (deltaUsage) usage = mergeAnthropicUsage(usage, deltaUsage);
+				continue;
+			}
+			if (type === "message_stop") {
+				yield {
+					type: "response",
+					usage
+				};
+				return;
+			}
+		}
+	}
+	yield {
+		type: "response",
+		usage
+	};
+}
+function inferenceItemsToAnthropicMessages(items) {
+	const messages = [];
+	const append = (role, content) => {
+		const last = messages[messages.length - 1];
+		if (last?.role === role) {
+			last.content.push(...content);
+			return;
+		}
+		messages.push({
+			role,
+			content
+		});
+	};
+	for (const item of items) switch (item.type) {
+		case "user_message":
+		case "user_steer":
+			append("user", userContentToAnthropic(item.content));
+			break;
+		case "assistant_text":
+			append("assistant", [{
+				type: "text",
+				text: item.text
+			}]);
+			break;
+		case "tool_use":
+			append("assistant", [{
+				type: "tool_use",
+				id: item.toolUseId,
+				name: item.toolName,
+				input: item.input ?? {}
+			}]);
+			break;
+		case "tool_result":
+			append("user", [{
+				type: "tool_result",
+				tool_use_id: item.toolUseId,
+				content: toolResultContentToAnthropic(item.output),
+				...item.isError ? { is_error: true } : {}
+			}]);
+			break;
+		case "assistant_thinking":
+		case "assistant_redacted_thinking": break;
+	}
+	return messages;
+}
+function userContentToAnthropic(content) {
+	return content.flatMap((block) => {
+		if (block.type === "text") return [{
+			type: "text",
+			text: block.text
+		}];
+		if (block.type === "reference") return [{
+			type: "text",
+			text: block.reference
+		}];
+		if (block.type === "document") return [{
+			type: "text",
+			text: `[document:${block.source.fileName} ${block.source.mediaType}]`
+		}];
+		if (block.source.type === "url") return [{
+			type: "text",
+			text: `[image:${block.source.url}]`
+		}];
+		return [{
+			type: "image",
+			source: {
+				type: "base64",
+				media_type: block.source.mediaType,
+				data: Buffer.from(block.source.data).toString("base64")
+			}
+		}];
+	});
+}
+function toolResultContentToAnthropic(output) {
+	return output.map((block) => {
+		if (block.type === "text") return {
+			type: "text",
+			text: block.text
+		};
+		return {
+			type: "image",
+			source: {
+				type: "base64",
+				media_type: block.source.mediaType,
+				data: block.source.data
+			}
+		};
+	});
+}
+function toolToAnthropicTool(tool) {
+	return {
+		name: tool.name,
+		description: tool.description,
+		input_schema: tool.inputSchema
+	};
+}
+async function* readServerSentEvents(body, signal) {
+	if (!body) return;
+	const reader = body.getReader();
+	const decoder = new TextDecoder();
+	let buffer = "";
+	let eventName = null;
+	let data = [];
+	const flush = function* () {
+		if (data.length === 0) return;
+		yield {
+			event: eventName,
+			data
+		};
+		eventName = null;
+		data = [];
+	};
+	try {
+		while (true) {
+			if (signal?.aborted) return;
+			const { value, done } = await reader.read();
+			if (done) break;
+			buffer += decoder.decode(value, { stream: true });
+			let newline = buffer.indexOf("\n");
+			while (newline !== -1) {
+				const raw = buffer.slice(0, newline);
+				buffer = buffer.slice(newline + 1);
+				const line = raw.endsWith("\r") ? raw.slice(0, -1) : raw;
+				if (line === "") yield* flush();
+				else if (line.startsWith("event:")) eventName = line.slice(6).trim();
+				else if (line.startsWith("data:")) data.push(line.slice(5).trimStart());
+				newline = buffer.indexOf("\n");
+			}
+		}
+		buffer += decoder.decode();
+		if (buffer) {
+			const line = buffer.endsWith("\r") ? buffer.slice(0, -1) : buffer;
+			if (line.startsWith("data:")) data.push(line.slice(5).trimStart());
+			else if (line.startsWith("event:")) eventName = line.slice(6).trim();
+		}
+		yield* flush();
+	} finally {
+		reader.releaseLock();
+	}
+}
+function anthropicMessagesUrl(baseUrl) {
+	const normalized = normalizeBaseUrl(baseUrl);
+	return normalized.endsWith("/messages") ? normalized : `${normalized}/messages`;
+}
+function mergeAnthropicUsage(current, usage) {
+	const inputTokens = numberOrZero(usage.input_tokens);
+	const outputTokens = numberOrZero(usage.output_tokens);
+	const cacheReadTokens = numberOrZero(usage.cache_read_input_tokens);
+	const cacheWriteTokens = numberOrZero(usage.cache_creation_input_tokens);
+	return {
+		inputTokens: inputTokens || current.inputTokens,
+		outputTokens: outputTokens || current.outputTokens,
+		cacheReadTokens: cacheReadTokens || current.cacheReadTokens,
+		cacheWriteTokens: cacheWriteTokens || current.cacheWriteTokens
+	};
+}
+//#endregion
+export { anthropicApiDefaultModels, createAnthropicApiProvider };

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@demicodes/provider-anthropic-api",
+  "description": "Anthropic API provider adapter for Demi.",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "dependencies": {
+    "@demicodes/core": "workspace:*",
+    "@demicodes/provider": "workspace:*",
+    "@demicodes/utils": "workspace:*"
+  },
+  "license": "Apache-2.0",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wspl/demi.git",
+    "directory": "packages/provider-anthropic-api"
+  },
+  "homepage": "https://github.com/wspl/demi/tree/main/packages/provider-anthropic-api#readme",
+  "bugs": "https://github.com/wspl/demi/issues"
+}