@llumiverse/common 1.1.1-dev.20260505.151157Z → 1.3.0

package/src/capability/anthropic.ts

@@ -0,0 +1,49 @@
+import type { ModelCapabilities } from "../types.js";
+
+// Explicit model exceptions
+const RECORD_MODEL_CAPABILITIES: Record<string, ModelCapabilities> = {
+    // claude-3-5-haiku: no image input
+    "claude-3-5-haiku-20241022": { input: { text: true, image: false, video: false, audio: false, embed: false }, output: { text: true, image: false, video: false, audio: false, embed: false }, tool_support: true, tool_support_streaming: true },
+};
+
+// Family-level capabilities (longest prefix match)
+const RECORD_FAMILY_CAPABILITIES: Record<string, ModelCapabilities> = {
+    "claude-3-5-haiku": { input: { text: true, image: false, video: false, audio: false, embed: false }, output: { text: true, image: false, video: false, audio: false, embed: false }, tool_support: true, tool_support_streaming: true },
+    "claude-3-haiku": { input: { text: true, image: true, video: false, audio: false, embed: false }, output: { text: true, image: false, video: false, audio: false, embed: false }, tool_support: true, tool_support_streaming: true },
+    "claude-3-sonnet": { input: { text: true, image: true, video: false, audio: false, embed: false }, output: { text: true, image: false, video: false, audio: false, embed: false }, tool_support: true, tool_support_streaming: true },
+    "claude-3-opus": { input: { text: true, image: true, video: false, audio: false, embed: false }, output: { text: true, image: false, video: false, audio: false, embed: false }, tool_support: true, tool_support_streaming: true },
+    "claude-3-5": { input: { text: true, image: true, video: false, audio: false, embed: false }, output: { text: true, image: false, video: false, audio: false, embed: false }, tool_support: true, tool_support_streaming: true },
+    "claude-3-7": { input: { text: true, image: true, video: false, audio: false, embed: false }, output: { text: true, image: false, video: false, audio: false, embed: false }, tool_support: true, tool_support_streaming: true },
+    "claude-3": { input: { text: true, image: true, video: false, audio: false, embed: false }, output: { text: true, image: false, video: false, audio: false, embed: false }, tool_support: true, tool_support_streaming: true },
+    "claude-4": { input: { text: true, image: true, video: false, audio: false, embed: false }, output: { text: true, image: false, video: false, audio: false, embed: false }, tool_support: true, tool_support_streaming: true },
+    "claude-": { input: { text: true, image: true, video: false, audio: false, embed: false }, output: { text: true, image: false, video: false, audio: false, embed: false }, tool_support: true, tool_support_streaming: true },
+};
+
+const DEFAULT_CLAUDE_CAPABILITIES: ModelCapabilities = {
+    input: { text: true, image: true, video: false, audio: false, embed: false },
+    output: { text: true, image: false, video: false, audio: false, embed: false },
+    tool_support: true,
+    tool_support_streaming: true,
+};
+
+export function getModelCapabilitiesAnthropic(model: string): ModelCapabilities {
+    const lower = model.toLowerCase();
+
+    // Exact match first
+    if (lower in RECORD_MODEL_CAPABILITIES) {
+        return RECORD_MODEL_CAPABILITIES[lower];
+    }
+
+    // Longest prefix family match
+    let bestKey: string | undefined;
+    for (const key of Object.keys(RECORD_FAMILY_CAPABILITIES)) {
+        if (lower.startsWith(key) && (!bestKey || key.length > bestKey.length)) {
+            bestKey = key;
+        }
+    }
+    if (bestKey) {
+        return RECORD_FAMILY_CAPABILITIES[bestKey];
+    }
+
+    return DEFAULT_CLAUDE_CAPABILITIES;
+}

package/src/capability.ts

@@ -1,8 +1,9 @@
+import { getModelCapabilitiesAnthropic } from "./capability/anthropic.js";
 import { getModelCapabilitiesAzureFoundry } from "./capability/azure_foundry.js";
 import { getModelCapabilitiesBedrock } from "./capability/bedrock.js";
 import { getModelCapabilitiesOpenAI } from "./capability/openai.js";
 import { getModelCapabilitiesVertexAI } from "./capability/vertexai.js";
-import { ModelCapabilities, ModelModalities, Providers } from "./types.js";
+import { type ModelCapabilities, type ModelModalities, Providers } from "./types.js";
 
 export function getModelCapabilities(model: string, provider?: string | Providers): ModelCapabilities {
     //Check for locations/<location>/ prefix and remove it
@@ -25,6 +26,8 @@ export function getModelCapabilities(model: string, provider?: string | Provider
 
 function _getModelCapabilities(model: string, provider?: string | Providers): ModelCapabilities {
     switch (provider?.toLowerCase()) {
+        case Providers.anthropic:
+            return getModelCapabilitiesAnthropic(model);
         case Providers.vertexai:
             return getModelCapabilitiesVertexAI(model);
         case Providers.openai:
@@ -53,6 +56,8 @@ function _getModelCapabilities(model: string, provider?: string | Providers): Mo
             // Guess the provider based on the model name
             if (model.startsWith("gpt")) {
                 return getModelCapabilitiesOpenAI(model);
+            } else if (model.startsWith("claude")) {
+                return getModelCapabilitiesAnthropic(model);
             } else if (model.startsWith("grok")) {
                 // xAI Grok models
                 return {

package/src/index.ts

@@ -1,11 +1,12 @@
-export * from "./types.js";
 export * from "./capability.js";
 export * from "./options.js";
-
+export * from "./options/anthropic.js";
 export * from "./options/bedrock.js";
+export * from "./options/context-windows.js";
 export * from "./options/fallback.js";
 export * from "./options/groq.js";
 export * from "./options/openai.js";
+export * from "./options/shared-parsing.js";
+export * from "./options/version-parsing.js";
 export * from "./options/vertexai.js";
-export * from "./options/context-windows.js";
-export * from "./options/version-parsing.js";
+export * from "./types.js";

package/src/options/anthropic.ts

@@ -0,0 +1,56 @@
+import { type ModelOptions, type ModelOptionsInfo, OptionType, SharedOptions } from "../types.js";
+import { textOptionsFallback } from "./fallback.js";
+import {
+    buildClaudeCacheOptions,
+    buildClaudeCacheTtlOptions,
+    buildClaudeEffortOptions,
+    buildClaudeIncludeThoughtsOption,
+    buildClaudeThinkingBudgetOption,
+    getClaudeMaxTokensLimit,
+} from "./shared-parsing.js";
+import { hasSamplingParameterRestriction } from "./version-parsing.js";
+
+export interface AnthropicClaudeOptions {
+    _option_id: "anthropic-claude";
+    max_tokens?: number;
+    temperature?: number;
+    top_p?: number;
+    top_k?: number;
+    stop_sequence?: string[];
+    effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+    thinking_budget_tokens?: number;
+    include_thoughts?: boolean;
+    cache_enabled?: boolean;
+    cache_ttl?: '5m' | '1h';
+}
+
+export function getAnthropicOptions(model: string, option?: ModelOptions): ModelOptionsInfo {
+    const max_tokens_limit = getClaudeMaxTokensLimit(model);
+    const excludeOptions = ["max_tokens", "presence_penalty", "frequency_penalty"];
+    let commonOptions = textOptionsFallback.options.filter((o) => !excludeOptions.includes(o.name));
+
+    const hasSamplingRestriction = hasSamplingParameterRestriction(model);
+    if (hasSamplingRestriction) {
+        commonOptions = commonOptions.filter((o) =>
+            o.name !== SharedOptions.temperature &&
+            o.name !== SharedOptions.top_p &&
+            o.name !== "top_k"
+        );
+    }
+
+    return {
+        _option_id: "anthropic-claude",
+        options: [
+            {
+                name: SharedOptions.max_tokens, type: OptionType.numeric, min: 1, max: max_tokens_limit,
+                integer: true, step: 200, description: "The maximum number of tokens to generate",
+            },
+            ...commonOptions,
+            ...buildClaudeEffortOptions(model),
+            ...buildClaudeThinkingBudgetOption(model),
+            ...buildClaudeIncludeThoughtsOption(model),
+            ...buildClaudeCacheOptions(),
+            ...buildClaudeCacheTtlOptions((option as unknown as AnthropicClaudeOptions)?.cache_enabled),
+        ],
+    };
+}

package/src/options/bedrock.ts

@@ -9,8 +9,22 @@ import {
 } from "./shared-parsing.js";
 import { hasSamplingParameterRestriction } from "./version-parsing.js";
 
-// Union type of all Bedrock options
-export type BedrockOptions = NovaCanvasOptions | BaseConverseOptions | BedrockClaudeOptions | BedrockPalmyraOptions | BedrockGptOssOptions | TwelvelabsPegasusOptions;
+/**
+ * Union type of all Bedrock options
+ *
+ * @discriminator _option_id
+ */
+export type BedrockOptions =
+    | NovaCanvasOptions
+    | BedrockConverseOptions
+    | BedrockNovaOptions
+    | BedrockMistralOptions
+    | BedrockAI21Options
+    | BedrockCohereCommandOptions
+    | BedrockClaudeOptions
+    | BedrockPalmyraOptions
+    | BedrockGptOssOptions
+    | TwelvelabsPegasusOptions;
 
 export interface NovaCanvasOptions {
     _option_id: "bedrock-nova-canvas"
@@ -28,16 +42,21 @@ export interface NovaCanvasOptions {
     outPaintingMode?: "DEFAULT" | "PRECISE";
 }
 
-export interface BaseConverseOptions {
-    _option_id: "bedrock-converse" | "bedrock-claude" | "bedrock-nova" | "bedrock-mistral" | "bedrock-ai21" | "bedrock-cohere-command" | "bedrock-palmyra" | "bedrock-gpt-oss";
+export interface BaseConverseOptions<TOptionId extends string = string> {
+    _option_id: TOptionId;
     max_tokens?: number;
     temperature?: number;
     top_p?: number;
     stop_sequence?: string[];
 }
 
-export interface BedrockClaudeOptions extends BaseConverseOptions {
-    _option_id: "bedrock-claude";
+export type BedrockConverseOptions = BaseConverseOptions<"bedrock-converse">;
+export type BedrockNovaOptions = BaseConverseOptions<"bedrock-nova">;
+export type BedrockMistralOptions = BaseConverseOptions<"bedrock-mistral">;
+export type BedrockAI21Options = BaseConverseOptions<"bedrock-ai21">;
+export type BedrockCohereCommandOptions = BaseConverseOptions<"bedrock-cohere-command">;
+
+export interface BedrockClaudeOptions extends BaseConverseOptions<"bedrock-claude"> {
     top_k?: number;
     thinking_budget_tokens?: number;
     include_thoughts?: boolean;
@@ -46,16 +65,14 @@ export interface BedrockClaudeOptions extends BaseConverseOptions {
     cache_ttl?: '5m' | '1h';
 }
 
-export interface BedrockPalmyraOptions extends BaseConverseOptions {
-    _option_id: "bedrock-palmyra";
+export interface BedrockPalmyraOptions extends BaseConverseOptions<"bedrock-palmyra"> {
     min_tokens?: number;
     seed?: number;
     frequency_penalty?: number;
     presence_penalty?: number;
 }
 
-export interface BedrockGptOssOptions extends BaseConverseOptions {
-    _option_id: "bedrock-gpt-oss";
+export interface BedrockGptOssOptions extends BaseConverseOptions<"bedrock-gpt-oss"> {
     reasoning_effort?: "low" | "medium" | "high";
     frequency_penalty?: number;
     presence_penalty?: number;

package/src/options/openai.ts

@@ -2,6 +2,9 @@ import { ModelOptionInfoItem, ModelOptions, ModelOptionsInfo, OptionType, Reason
 import { textOptionsFallback } from "./fallback.js";
 
 // Union type of all OpenAI options
+/**
+ * @discriminator _option_id
+ */
 export type OpenAiOptions = OpenAiThinkingOptions | OpenAiTextOptions | OpenAiDalleOptions | OpenAiGptImageOptions;
 
 export interface OpenAiThinkingOptions {

package/src/options/vertexai.ts

@@ -14,6 +14,9 @@ import {
 } from "./version-parsing.js";
 
 // Union type of all VertexAI options
+/**
+ * @discriminator _option_id
+ */
 export type VertexAIOptions = ImagenOptions | VertexAIClaudeOptions | VertexAIGeminiOptions;
 
 export enum ImagenTaskType {

package/src/options.ts

@@ -1,16 +1,19 @@
+import { getAnthropicOptions } from "./options/anthropic.js";
+import { getAzureFoundryOptions } from "./options/azure_foundry.js";
 import { getBedrockOptions } from "./options/bedrock.js";
+import { textOptionsFallback } from "./options/fallback.js";
 import { getGroqOptions } from "./options/groq.js";
 import { getOpenAiOptions } from "./options/openai.js";
 import { getVertexAiOptions } from "./options/vertexai.js";
-import { textOptionsFallback } from "./options/fallback.js";
-import { ModelOptionsInfo, ModelOptions, Providers } from "./types.js";
-import { getAzureFoundryOptions } from "./options/azure_foundry.js";
+import { type ModelOptions, type ModelOptionsInfo, Providers } from "./types.js";
 
 export function getOptions(model: string, provider?: string | Providers, options?: ModelOptions): ModelOptionsInfo {
-    if(!provider) {
+    if (!provider) {
         return textOptionsFallback;
     }
     switch (provider.toLowerCase()) {
+        case Providers.anthropic:
+            return getAnthropicOptions(model, options);
         case Providers.bedrock:
             return getBedrockOptions(model, options);
         case Providers.vertexai:

package/src/types.ts

@@ -1,8 +1,8 @@
-import { BedrockOptions } from './options/bedrock.js';
-import { TextFallbackOptions } from './options/fallback.js';
-import { GroqOptions } from './options/groq.js';
-import { OpenAiOptions } from './options/openai.js';
-import { VertexAIOptions } from './options/vertexai.js';
+import type { BedrockOptions } from './options/bedrock.js';
+import type { TextFallbackOptions } from './options/fallback.js';
+import type { GroqOptions } from './options/groq.js';
+import type { OpenAiOptions } from './options/openai.js';
+import type { VertexAIOptions } from './options/vertexai.js';
 
 // ============== Provider details ===============
 
@@ -19,7 +19,8 @@ export enum Providers {
     mistralai = 'mistralai',
     groq = 'groq',
     watsonx = 'watsonx',
-    xai = 'xai'
+    xai = 'xai',
+    anthropic = 'anthropic'
 }
 
 export interface ProviderParams {
@@ -130,6 +131,13 @@ export const ProviderList: Record<Providers, ProviderParams> = {
         endpointPlaceholder: "https://api.example.com/v1",
         supportSearch: false
     },
+    anthropic: {
+        id: Providers.anthropic,
+        name: "Anthropic",
+        requiresApiKey: true,
+        requiresEndpointUrl: false,
+        supportSearch: false,
+    },
 }
 
 // ============== Embeddings ===============
@@ -324,6 +332,9 @@ export interface ImageResult extends BaseResult {
     value: string; // base64 data url or real url
 }
 
+/**
+ * @discriminator type
+ */
 export type CompletionResult = TextResult | JsonResult | ImageResult;
 
 
@@ -466,10 +477,15 @@ export interface JSONSchemaObject {
 
 export interface JSONSchemaArray extends Array<JSONSchemaType> { }
 
+export interface JSONSchemaProperties {
+    [key: string]: JSONSchema;
+}
+
 export interface JSONSchema {
     type?: JSONSchemaTypeName | JSONSchemaTypeName[];
     description?: string;
-    properties?: Record<string, JSONSchema>;
+    properties?: JSONSchemaProperties;
+    additionalProperties?: boolean | JSONSchema;
     required?: string[];
     [k: string]: any;
 }
@@ -577,6 +593,9 @@ export type ReasoningEffort = "low" | "medium" | "high";
 
 // ============== Model Options ===============
 
+/**
+ * @discriminator _option_id
+ */
 export type ModelOptions = TextFallbackOptions | VertexAIOptions | BedrockOptions | OpenAiOptions | GroqOptions;
 
 // ============== Option Info ===============