@tanstack/ai-anthropic 0.15.9 → 0.15.10

package/dist/esm/adapters/summarize.d.ts

@@ -0,0 +1,41 @@
+import { ChatStreamSummarizeAdapter, InferTextProviderOptions } from '@tanstack/ai/adapters';
+import { AnthropicTextAdapter } from './text.js';
+import { ANTHROPIC_MODELS } from '../model-meta.js';
+import { AnthropicClientConfig } from '../utils.js';
+/**
+ * Configuration for Anthropic summarize adapter
+ */
+export interface AnthropicSummarizeConfig extends AnthropicClientConfig {
+}
+/** Model type for Anthropic summarization */
+export type AnthropicSummarizeModel = (typeof ANTHROPIC_MODELS)[number];
+/**
+ * Creates an Anthropic summarize adapter with explicit API key.
+ * Type resolution happens here at the call site.
+ *
+ * @param model - The model name (e.g., 'claude-sonnet-4-5', 'claude-3-5-haiku-latest')
+ * @param apiKey - Your Anthropic API key
+ * @param config - Optional additional configuration
+ * @returns Configured Anthropic summarize adapter instance with resolved types
+ *
+ * @example
+ * ```typescript
+ * const adapter = createAnthropicSummarize('claude-sonnet-4-5', 'sk-ant-...');
+ * ```
+ */
+export declare function createAnthropicSummarize<TModel extends AnthropicSummarizeModel>(model: TModel, apiKey: string, config?: Omit<AnthropicSummarizeConfig, 'apiKey'>): ChatStreamSummarizeAdapter<TModel, InferTextProviderOptions<AnthropicTextAdapter<TModel>>>;
+/**
+ * Creates an Anthropic summarize adapter with automatic API key detection.
+ * Type resolution happens here at the call site.
+ *
+ * @param model - The model name (e.g., 'claude-sonnet-4-5', 'claude-3-5-haiku-latest')
+ * @param config - Optional configuration (excluding apiKey which is auto-detected)
+ * @returns Configured Anthropic summarize adapter instance with resolved types
+ *
+ * @example
+ * ```typescript
+ * const adapter = anthropicSummarize('claude-sonnet-4-5');
+ * await summarize({ adapter, text: 'Long article text...' });
+ * ```
+ */
+export declare function anthropicSummarize<TModel extends AnthropicSummarizeModel>(model: TModel, config?: Omit<AnthropicSummarizeConfig, 'apiKey'>): ChatStreamSummarizeAdapter<TModel, InferTextProviderOptions<AnthropicTextAdapter<TModel>>>;

package/dist/esm/adapters/summarize.js

@@ -0,0 +1,18 @@
+import { ChatStreamSummarizeAdapter } from "@tanstack/ai/adapters";
+import { getAnthropicApiKeyFromEnv } from "../utils/client.js";
+import { AnthropicTextAdapter } from "./text.js";
+function createAnthropicSummarize(model, apiKey, config) {
+  return new ChatStreamSummarizeAdapter(
+    new AnthropicTextAdapter({ apiKey, ...config }, model),
+    model,
+    "anthropic"
+  );
+}
+function anthropicSummarize(model, config) {
+  return createAnthropicSummarize(model, getAnthropicApiKeyFromEnv(), config);
+}
+export {
+  anthropicSummarize,
+  createAnthropicSummarize
+};
+//# sourceMappingURL=summarize.js.map

package/dist/esm/adapters/summarize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize.js","sources":["../../../src/adapters/summarize.ts"],"sourcesContent":["import { ChatStreamSummarizeAdapter } from '@tanstack/ai/adapters'\nimport { getAnthropicApiKeyFromEnv } from '../utils'\nimport { AnthropicTextAdapter } from './text'\nimport type { InferTextProviderOptions } from '@tanstack/ai/adapters'\nimport type { ANTHROPIC_MODELS } from '../model-meta'\nimport type { AnthropicClientConfig } from '../utils'\n\n/**\n * Configuration for Anthropic summarize adapter\n */\nexport interface AnthropicSummarizeConfig extends AnthropicClientConfig {}\n\n/** Model type for Anthropic summarization */\nexport type AnthropicSummarizeModel = (typeof ANTHROPIC_MODELS)[number]\n\n/**\n * Creates an Anthropic summarize adapter with explicit API key.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'claude-sonnet-4-5', 'claude-3-5-haiku-latest')\n * @param apiKey - Your Anthropic API key\n * @param config - Optional additional configuration\n * @returns Configured Anthropic summarize adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = createAnthropicSummarize('claude-sonnet-4-5', 'sk-ant-...');\n * ```\n */\nexport function createAnthropicSummarize<\n  TModel extends AnthropicSummarizeModel,\n>(\n  model: TModel,\n  apiKey: string,\n  config?: Omit<AnthropicSummarizeConfig, 'apiKey'>,\n): ChatStreamSummarizeAdapter<\n  TModel,\n  InferTextProviderOptions<AnthropicTextAdapter<TModel>>\n> {\n  return new ChatStreamSummarizeAdapter(\n    new AnthropicTextAdapter({ apiKey, ...config }, model),\n    model,\n    'anthropic',\n  )\n}\n\n/**\n * Creates an Anthropic summarize adapter with automatic API key detection.\n * Type resolution happens here at the call site.\n *\n * @param model - The model name (e.g., 'claude-sonnet-4-5', 'claude-3-5-haiku-latest')\n * @param config - Optional configuration (excluding apiKey which is auto-detected)\n * @returns Configured Anthropic summarize adapter instance with resolved types\n *\n * @example\n * ```typescript\n * const adapter = anthropicSummarize('claude-sonnet-4-5');\n * await summarize({ adapter, text: 'Long article text...' });\n * ```\n */\nexport function anthropicSummarize<TModel extends AnthropicSummarizeModel>(\n  model: TModel,\n  config?: Omit<AnthropicSummarizeConfig, 'apiKey'>,\n): ChatStreamSummarizeAdapter<\n  TModel,\n  InferTextProviderOptions<AnthropicTextAdapter<TModel>>\n> {\n  return createAnthropicSummarize(model, getAnthropicApiKeyFromEnv(), config)\n}\n"],"names":[],"mappings":";;;AA6BO,SAAS,yBAGd,OACA,QACA,QAIA;AACA,SAAO,IAAI;AAAA,IACT,IAAI,qBAAqB,EAAE,QAAQ,GAAG,OAAA,GAAU,KAAK;AAAA,IACrD;AAAA,IACA;AAAA,EAAA;AAEJ;AAgBO,SAAS,mBACd,OACA,QAIA;AACA,SAAO,yBAAyB,OAAO,0BAAA,GAA6B,MAAM;AAC5E;"}

package/dist/esm/adapters/text.d.ts

@@ -0,0 +1,92 @@
+import { BaseTextAdapter, StructuredOutputOptions, StructuredOutputResult } from '@tanstack/ai/adapters';
+import { ANTHROPIC_MODELS, AnthropicChatModelProviderOptionsByName, AnthropicChatModelToolCapabilitiesByName, AnthropicModelInputModalitiesByName } from '../model-meta.js';
+import { AnthropicBeta } from '@anthropic-ai/sdk/resources/beta/beta';
+import { AnyTool, Modality, StreamChunk, TextOptions } from '@tanstack/ai';
+import { AnthropicSystemPromptMetadata, ExternalTextProviderOptions } from '../text/text-provider-options.js';
+import { AnthropicMessageMetadataByModality } from '../message-types.js';
+import { AnthropicClientConfig } from '../utils.js';
+/**
+ * Computes the `betas` array for a Messages request. Unions:
+ * - `interleaved-thinking-2025-05-14` when interleaved thinking is enabled,
+ * - `code-execution-2025-08-25` when a `code_execution` tool is present,
+ * - `skills-2025-10-02` when that tool carries skills.
+ * Returns `undefined` when none apply (so the call site omits `betas`).
+ */
+export declare function computeAnthropicBetas(tools: Array<AnyTool> | undefined, modelOptions: {
+    thinking?: {
+        type?: 'enabled' | 'disabled' | 'adaptive';
+        budget_tokens?: number;
+    };
+} | undefined): Array<AnthropicBeta> | undefined;
+/**
+ * Configuration for Anthropic text adapter
+ */
+export interface AnthropicTextConfig extends AnthropicClientConfig {
+}
+/**
+ * Anthropic-specific provider options for text/chat
+ */
+export type AnthropicTextProviderOptions = ExternalTextProviderOptions;
+/**
+ * Resolve provider options for a specific model.
+ * If the model has explicit options in the map, use those; otherwise use base options.
+ */
+type ResolveProviderOptions<TModel extends string> = TModel extends keyof AnthropicChatModelProviderOptionsByName ? AnthropicChatModelProviderOptionsByName[TModel] : AnthropicTextProviderOptions;
+/**
+ * Resolve input modalities for a specific model.
+ * If the model has explicit modalities in the map, use those; otherwise use default.
+ */
+type ResolveInputModalities<TModel extends string> = TModel extends keyof AnthropicModelInputModalitiesByName ? AnthropicModelInputModalitiesByName[TModel] : readonly ['text', 'image', 'document'];
+type ResolveToolCapabilities<TModel extends string> = TModel extends keyof AnthropicChatModelToolCapabilitiesByName ? NonNullable<AnthropicChatModelToolCapabilitiesByName[TModel]> : readonly [];
+/**
+ * Anthropic Text (Chat) Adapter
+ *
+ * Tree-shakeable adapter for Anthropic chat/text completion functionality.
+ * Import only what you need for smaller bundle sizes.
+ */
+export declare class AnthropicTextAdapter<TModel extends (typeof ANTHROPIC_MODELS)[number], TProviderOptions extends Record<string, any> = ResolveProviderOptions<TModel>, TInputModalities extends ReadonlyArray<Modality> = ResolveInputModalities<TModel>, TToolCapabilities extends ReadonlyArray<string> = ResolveToolCapabilities<TModel>> extends BaseTextAdapter<TModel, TProviderOptions, TInputModalities, AnthropicMessageMetadataByModality, TToolCapabilities, unknown, AnthropicSystemPromptMetadata> {
+    readonly kind: "text";
+    readonly name: "anthropic";
+    private readonly client;
+    constructor(config: AnthropicTextConfig, model: TModel);
+    chatStream(options: TextOptions<TProviderOptions>): AsyncIterable<StreamChunk>;
+    /**
+     * Generate structured output using Anthropic's tool-based approach.
+     * Anthropic doesn't have native structured output, so we use a tool with the schema
+     * and force the model to call it.
+     * The outputSchema is already JSON Schema (converted in the ai layer).
+     */
+    structuredOutput(options: StructuredOutputOptions<TProviderOptions>): Promise<StructuredOutputResult<unknown>>;
+    private mapCommonOptionsToAnthropic;
+    /**
+     * Anthropic supports `output_config.format` + `tools` in a single streaming
+     * Messages request only for Claude 4.5+ (GA 2026-01-29). For 4.4 and
+     * earlier we keep the forced-tool-use workaround in
+     * {@link structuredOutput} via the engine's finalization path.
+     */
+    supportsCombinedToolsAndSchema(): boolean;
+    private convertContentPartToAnthropic;
+    private formatMessages;
+    private appendThinkingBlocks;
+    /**
+     * Merge consecutive messages of the same role into a single message.
+     * Anthropic's API requires strictly alternating user/assistant roles.
+     * Tool results are wrapped as role:'user' messages, which can collide
+     * with actual user messages in multi-turn conversations.
+     *
+     * Also filters out empty assistant messages (e.g., from a previous failed request).
+     */
+    private mergeConsecutiveSameRoleMessages;
+    private processAnthropicStream;
+}
+/**
+ * Creates an Anthropic chat adapter with explicit API key.
+ * Type resolution happens here at the call site.
+ */
+export declare function createAnthropicChat<TModel extends (typeof ANTHROPIC_MODELS)[number]>(model: TModel, apiKey: string, config?: Omit<AnthropicTextConfig, 'apiKey'>): AnthropicTextAdapter<TModel, ResolveProviderOptions<TModel>, ResolveInputModalities<TModel>>;
+/**
+ * Creates an Anthropic text adapter with automatic API key detection.
+ * Type resolution happens here at the call site.
+ */
+export declare function anthropicText<TModel extends (typeof ANTHROPIC_MODELS)[number]>(model: TModel, config?: Omit<AnthropicTextConfig, 'apiKey'>): AnthropicTextAdapter<TModel, ResolveProviderOptions<TModel>, ResolveInputModalities<TModel>>;
+export {};