@tanstack/ai-anthropic 0.0.1

package/src/message-types.ts

@@ -0,0 +1,85 @@
+/**
+ * Anthropic-specific metadata types for multimodal content parts.
+ * These types extend the base ContentPart metadata with Anthropic-specific options.
+ *
+ * @see https://docs.anthropic.com/claude/docs/vision
+ * @see https://docs.anthropic.com/claude/docs/pdf-support
+ */
+
+/**
+ * Supported image media types for Anthropic.
+ */
+export type AnthropicImageMediaType =
+  | 'image/jpeg'
+  | 'image/png'
+  | 'image/gif'
+  | 'image/webp'
+
+/**
+ * Metadata for Anthropic image content parts.
+ */
+export interface AnthropicImageMetadata {
+  /**
+   * The MIME type of the image.
+   * Required when using base64 source type.
+   *
+   * @see https://docs.anthropic.com/claude/docs/vision#supported-image-types
+   */
+  mediaType?: AnthropicImageMediaType
+}
+
+/**
+ * Supported document media types for Anthropic.
+ */
+export type AnthropicDocumentMediaType = 'application/pdf'
+
+/**
+ * Metadata for Anthropic document content parts (e.g., PDFs).
+ */
+export interface AnthropicDocumentMetadata {
+  /**
+   * The MIME type of the document.
+   * Required for document content, typically 'application/pdf'.
+   *
+   * @see https://docs.anthropic.com/claude/docs/pdf-support
+   */
+  mediaType?: AnthropicDocumentMediaType
+}
+
+/**
+ * Metadata for Anthropic audio content parts.
+ * Note: Audio support in Anthropic may be limited; check current API capabilities.
+ */
+export interface AnthropicAudioMetadata {
+  /**
+   * The MIME type of the audio.
+   */
+  mediaType?:
+    | 'audio/mpeg'
+    | 'audio/wav'
+    | 'audio/ogg'
+    | 'audio/webm'
+    | 'audio/flac'
+}
+
+/**
+ * Metadata for Anthropic video content parts.
+ * Note: Video support in Anthropic may be limited; check current API capabilities.
+ */
+export interface AnthropicVideoMetadata {
+  /**
+   * The MIME type of the video.
+   */
+  mediaType?: 'video/mp4' | 'video/webm' | 'video/mpeg'
+}
+
+/**
+ * Map of modality types to their Anthropic-specific metadata types.
+ * Used for type inference when constructing multimodal messages.
+ */
+export interface AnthropicMessageMetadataByModality {
+  image: AnthropicImageMetadata
+  audio: AnthropicAudioMetadata
+  video: AnthropicVideoMetadata
+  document: AnthropicDocumentMetadata
+}

package/src/model-meta.ts

@@ -0,0 +1,482 @@
+import type {
+  AnthropicContainerOptions,
+  AnthropicContextManagementOptions,
+  AnthropicMCPOptions,
+  AnthropicSamplingOptions,
+  AnthropicServiceTierOptions,
+  AnthropicStopSequencesOptions,
+  AnthropicThinkingOptions,
+  AnthropicToolChoiceOptions,
+} from './text/text-provider-options'
+
+interface ModelMeta<
+  TProviderOptions = unknown,
+  TToolCapabilities = unknown,
+  TMessageCapabilities = unknown,
+> {
+  name: string
+  id: string
+  supports: {
+    input: Array<'text' | 'image' | 'audio' | 'video' | 'document'>
+    extended_thinking?: boolean
+    priority_tier?: boolean
+  }
+  context_window?: number
+  max_output_tokens?: number
+  knowledge_cutoff?: string
+  pricing: {
+    input: {
+      normal: number
+      cached?: number
+    }
+    output: {
+      normal: number
+    }
+  }
+  /**
+   * Type-level description of which provider options this model supports.
+   */
+  providerOptions?: TProviderOptions
+  /**
+   * Type-level description of which tool capabilities this model supports.
+   */
+  toolCapabilities?: TToolCapabilities
+  /**
+   * Type-level description of which message/input capabilities this model supports.
+   */
+  messageCapabilities?: TMessageCapabilities
+}
+const CLAUDE_SONNET_4_5 = {
+  name: 'claude-sonnet-4-5',
+  id: 'claude-sonnet-4-5',
+  context_window: 200_000,
+  max_output_tokens: 64_000,
+  knowledge_cutoff: '2025-09-29',
+  pricing: {
+    input: {
+      normal: 3,
+    },
+    output: {
+      normal: 15,
+    },
+  },
+  supports: {
+    input: ['text', 'image', 'document'],
+    extended_thinking: true,
+    priority_tier: true,
+  },
+} as const satisfies ModelMeta<
+  AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+>
+
+const CLAUDE_HAIKU_4_5 = {
+  name: 'claude-haiku-4-5',
+  id: 'claude-haiku-4-5',
+  context_window: 200_000,
+  max_output_tokens: 64_000,
+  knowledge_cutoff: '2025-10-01',
+  pricing: {
+    input: {
+      normal: 1,
+    },
+    output: {
+      normal: 5,
+    },
+  },
+  supports: {
+    input: ['text', 'image', 'document'],
+    extended_thinking: true,
+    priority_tier: true,
+  },
+} as const satisfies ModelMeta<
+  AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+>
+
+const CLAUDE_OPUS_4_1 = {
+  name: 'claude-opus-4-1',
+  id: 'claude-opus-4-1',
+  context_window: 200_000,
+  max_output_tokens: 64_000,
+  knowledge_cutoff: '2025-08-05',
+  pricing: {
+    input: {
+      normal: 15,
+    },
+    output: {
+      normal: 75,
+    },
+  },
+  supports: {
+    input: ['text', 'image', 'document'],
+    extended_thinking: true,
+    priority_tier: true,
+  },
+} as const satisfies ModelMeta<
+  AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+>
+
+const CLAUDE_OPUS_4_5 = {
+  name: 'claude-opus-4-5',
+  id: 'claude-opus-4-5',
+  context_window: 200_000,
+  max_output_tokens: 32_000,
+  knowledge_cutoff: '2025-11-01',
+  pricing: {
+    input: {
+      normal: 15,
+    },
+    output: {
+      normal: 75,
+    },
+  },
+  supports: {
+    input: ['text', 'image', 'document'],
+    extended_thinking: true,
+    priority_tier: true,
+  },
+} as const satisfies ModelMeta<
+  AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+>
+
+const CLAUDE_SONNET_4 = {
+  name: 'claude-sonnet-4',
+  id: 'claude-sonnet-4',
+  context_window: 200_000,
+  max_output_tokens: 64_000,
+  knowledge_cutoff: '2025-05-14',
+  pricing: {
+    input: {
+      normal: 3,
+    },
+    output: {
+      normal: 15,
+    },
+  },
+  supports: {
+    input: ['text', 'image', 'document'],
+    extended_thinking: true,
+    priority_tier: true,
+  },
+} as const satisfies ModelMeta<
+  AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+>
+
+const CLAUDE_SONNET_3_7 = {
+  name: 'claude-sonnet-3-7',
+  id: 'claude-3-7-sonnet',
+  max_output_tokens: 64_000,
+  knowledge_cutoff: '2025-05-14',
+  pricing: {
+    input: {
+      normal: 3,
+    },
+    output: {
+      normal: 15,
+    },
+  },
+  supports: {
+    input: ['text', 'image', 'document'],
+    extended_thinking: true,
+    priority_tier: true,
+  },
+} as const satisfies ModelMeta<
+  AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+>
+
+const CLAUDE_OPUS_4 = {
+  name: 'claude-opus-4',
+  id: 'claude-opus-4',
+  context_window: 200_000,
+  max_output_tokens: 32_000,
+  knowledge_cutoff: '2025-05-14',
+  pricing: {
+    input: {
+      normal: 15,
+    },
+    output: {
+      normal: 75,
+    },
+  },
+  supports: {
+    input: ['text', 'image', 'document'],
+    extended_thinking: true,
+    priority_tier: true,
+  },
+} as const satisfies ModelMeta<
+  AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+>
+
+const CLAUDE_HAIKU_3_5 = {
+  name: 'claude-haiku-3-5',
+  id: 'claude-3-5-haiku',
+  context_window: 200_000,
+  max_output_tokens: 8_000,
+  knowledge_cutoff: '2025-10-22',
+  pricing: {
+    input: {
+      normal: 0.8,
+    },
+    output: {
+      normal: 4,
+    },
+  },
+  supports: {
+    input: ['text', 'image', 'document'],
+    extended_thinking: false,
+    priority_tier: true,
+  },
+} as const satisfies ModelMeta<
+  AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+>
+
+const CLAUDE_HAIKU_3 = {
+  name: 'claude-haiku-3',
+  id: 'claude-3-haiku',
+  context_window: 200_000,
+  max_output_tokens: 4_000,
+  knowledge_cutoff: '2024-03-07',
+  pricing: {
+    input: {
+      normal: 0.25,
+    },
+    output: {
+      normal: 1.25,
+    },
+  },
+  supports: {
+    input: ['text', 'image', 'document'],
+    extended_thinking: false,
+    priority_tier: false,
+  },
+} as const satisfies ModelMeta<
+  AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+>
+
+/* const ANTHROPIC_MODEL_META = {
+  [CLAUDE_OPUS_4_5.name]: CLAUDE_OPUS_4_5,
+  [CLAUDE_SONNET_4_5.name]: CLAUDE_SONNET_4_5,
+  [CLAUDE_HAIKU_4_5.name]: CLAUDE_HAIKU_4_5,
+  [CLAUDE_OPUS_4_1.name]: CLAUDE_OPUS_4_1,
+  [CLAUDE_SONNET_4.name]: CLAUDE_SONNET_4,
+  [CLAUDE_SONNET_3_7.name]: CLAUDE_SONNET_3_7,
+  [CLAUDE_OPUS_4.name]: CLAUDE_OPUS_4,
+  [CLAUDE_HAIKU_3_5.name]: CLAUDE_HAIKU_3_5,
+  [CLAUDE_HAIKU_3.name]: CLAUDE_HAIKU_3,
+} as const */
+
+/* export type AnthropicModelProviderOptions<
+  TModel extends keyof AnthropicModelMetaMap,
+> =
+  AnthropicModelMetaMap[TModel] extends ModelMeta<
+    infer TProviderOptions,
+    any,
+    any
+  >
+  ? TProviderOptions
+  : unknown */
+
+/* export type AnthropicModelToolCapabilities<
+  TModel extends keyof AnthropicModelMetaMap,
+> =
+  AnthropicModelMetaMap[TModel] extends ModelMeta<
+    any,
+    infer TToolCapabilities,
+    any
+  >
+  ? TToolCapabilities
+  : unknown
+ */
+/* export type AnthropicModelMessageCapabilities<
+  TModel extends keyof AnthropicModelMetaMap,
+> =
+  AnthropicModelMetaMap[TModel] extends ModelMeta<
+    any,
+    any,
+    infer TMessageCapabilities
+  >
+  ? TMessageCapabilities
+  : unknown */
+
+export const ANTHROPIC_MODELS = [
+  CLAUDE_OPUS_4_5.id,
+  CLAUDE_SONNET_4_5.id,
+  CLAUDE_HAIKU_4_5.id,
+  CLAUDE_OPUS_4_1.id,
+  CLAUDE_SONNET_4.id,
+  CLAUDE_SONNET_3_7.id,
+  CLAUDE_OPUS_4.id,
+  CLAUDE_HAIKU_3_5.id,
+  CLAUDE_HAIKU_3.id,
+] as const
+
+// const ANTHROPIC_IMAGE_MODELS = [] as const
+// const ANTHROPIC_EMBEDDING_MODELS = [] as const
+// const ANTHROPIC_AUDIO_MODELS = [] as const
+// const ANTHROPIC_VIDEO_MODELS = [] as const
+
+/*  type AnthropicModel = (typeof ANTHROPIC_MODELS)[number] */
+
+// Manual type map for per-model provider options
+// Models are differentiated by extended_thinking and priority_tier support
+export type AnthropicChatModelProviderOptionsByName = {
+  // Models with both extended_thinking and priority_tier
+  [CLAUDE_OPUS_4_5.id]: AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+  [CLAUDE_SONNET_4_5.id]: AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+  [CLAUDE_HAIKU_4_5.id]: AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+  [CLAUDE_OPUS_4_1.id]: AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+  [CLAUDE_SONNET_4.id]: AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+  [CLAUDE_SONNET_3_7.id]: AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+  [CLAUDE_OPUS_4.id]: AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicThinkingOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+
+  // Model with priority_tier but NO extended_thinking
+  [CLAUDE_HAIKU_3_5.id]: AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicServiceTierOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+
+  // Model with neither extended_thinking nor priority_tier
+  [CLAUDE_HAIKU_3.id]: AnthropicContainerOptions &
+    AnthropicContextManagementOptions &
+    AnthropicMCPOptions &
+    AnthropicStopSequencesOptions &
+    AnthropicToolChoiceOptions &
+    AnthropicSamplingOptions
+}
+
+/**
+ * Type-only map from chat model name to its supported input modalities.
+ * All Anthropic Claude models support text, image, and document (PDF) input.
+ * Used by the core AI types to constrain ContentPart types based on the selected model.
+ * Note: These must be inlined as readonly arrays (not typeof) because the model
+ * constants are not exported and typeof references don't work in .d.ts files
+ * when consumed by external packages.
+ *
+ * @see https://docs.anthropic.com/claude/docs/vision
+ * @see https://docs.anthropic.com/claude/docs/pdf-support
+ */
+export type AnthropicModelInputModalitiesByName = {
+  [CLAUDE_OPUS_4_5.id]: typeof CLAUDE_OPUS_4_5.supports.input
+  [CLAUDE_SONNET_4_5.id]: typeof CLAUDE_SONNET_4_5.supports.input
+  [CLAUDE_HAIKU_4_5.id]: typeof CLAUDE_HAIKU_4_5.supports.input
+  [CLAUDE_OPUS_4_1.id]: typeof CLAUDE_OPUS_4_1.supports.input
+  [CLAUDE_SONNET_4.id]: typeof CLAUDE_SONNET_4.supports.input
+  [CLAUDE_SONNET_3_7.id]: typeof CLAUDE_SONNET_3_7.supports.input
+  [CLAUDE_OPUS_4.id]: typeof CLAUDE_OPUS_4.supports.input
+  [CLAUDE_HAIKU_3_5.id]: typeof CLAUDE_HAIKU_3_5.supports.input
+  [CLAUDE_HAIKU_3.id]: typeof CLAUDE_HAIKU_3.supports.input
+}