@providerprotocol/ai 0.0.19 → 0.0.21

package/dist/anthropic/index.js

@@ -1,29 +1,151 @@
-import {
-  createProvider
-} from "../chunk-MSR5P65T.js";
 import {
   AssistantMessage,
+  createProvider,
   isAssistantMessage,
   isToolResultMessage,
   isUserMessage
-} from "../chunk-UMKWXGO3.js";
+} from "../chunk-M4BMM5IB.js";
 import {
   parseSSEStream
 } from "../chunk-Z7RBRCRN.js";
 import {
-  doFetch,
-  doStreamFetch,
-  normalizeHttpError,
   resolveApiKey
-} from "../chunk-5FEAOEXV.js";
+} from "../chunk-Y3GBJNA2.js";
 import {
-  UPPError
-} from "../chunk-DZQHVGNV.js";
+  UPPError,
+  doFetch,
+  doStreamFetch,
+  normalizeHttpError
+} from "../chunk-EDENPF3E.js";
+
+// src/providers/anthropic/types.ts
+var betas = {
+  // Structured Outputs
+  /** Guaranteed JSON schema conformance for responses. Available for Claude Sonnet 4.5+. */
+  structuredOutputs: "structured-outputs-2025-11-13",
+  // Extended Thinking / Reasoning
+  /** Enables Claude to think between tool calls in Claude 4 models. */
+  interleavedThinking: "interleaved-thinking-2025-05-14",
+  /** Developer mode for full thinking output visibility. */
+  devFullThinking: "dev-full-thinking-2025-05-14",
+  /** Effort parameter for Claude Opus 4.5 - controls response thoroughness vs efficiency. */
+  effort: "effort-2025-11-24",
+  // Computer Use
+  /** Legacy computer use tool (Claude 3.x models). */
+  computerUseLegacy: "computer-use-2024-10-22",
+  /** Computer use tool for Claude 4 models (mouse, keyboard, screenshots). */
+  computerUse: "computer-use-2025-01-24",
+  /** Computer use tool for Claude Opus 4.5 with additional commands. */
+  computerUseOpus: "computer-use-2025-11-24",
+  // Extended Output / Context
+  /** Enables up to 8,192 output tokens from Claude Sonnet 3.5. */
+  maxTokens35Sonnet: "max-tokens-3-5-sonnet-2024-07-15",
+  /** Enables 128K token output length. */
+  output128k: "output-128k-2025-02-19",
+  /** Enables 1 million token context window for Claude Sonnet 4. */
+  context1m: "context-1m-2025-08-07",
+  // Token Efficiency
+  /** Reduces output token consumption by up to 70% for tool calls. */
+  tokenEfficientTools: "token-efficient-tools-2025-02-19",
+  /** Streams tool use parameters without buffering/JSON validation. */
+  fineGrainedToolStreaming: "fine-grained-tool-streaming-2025-05-14",
+  // Code Execution
+  /** Code execution tool for running Python/Bash in secure sandbox. */
+  codeExecution: "code-execution-2025-08-25",
+  // Advanced Tool Use
+  /** Advanced tool use: Tool Search, Programmatic Tool Calling, Tool Use Examples. */
+  advancedToolUse: "advanced-tool-use-2025-11-20",
+  // Files & Documents
+  /** Files API for uploading and managing files. */
+  filesApi: "files-api-2025-04-14",
+  /** PDF document support. */
+  pdfs: "pdfs-2024-09-25",
+  // MCP (Model Context Protocol)
+  /** MCP connector to connect to remote MCP servers. */
+  mcpClient: "mcp-client-2025-04-04",
+  /** Updated MCP client. */
+  mcpClientLatest: "mcp-client-2025-11-20",
+  // Caching
+  /** Prompt caching for reduced latency and costs. Now works automatically with cache_control. */
+  promptCaching: "prompt-caching-2024-07-31",
+  /** Enables 1-hour cache TTL (vs default 5-minute). */
+  extendedCacheTtl: "extended-cache-ttl-2025-04-11",
+  // Context Management
+  /** Automatic tool call clearing for context management. */
+  contextManagement: "context-management-2025-06-27",
+  /** Handling for when model context window is exceeded. */
+  modelContextWindowExceeded: "model-context-window-exceeded-2025-08-26",
+  // Message Batches (generally available but may still need header)
+  /** Message Batches API for async processing at 50% cost. */
+  messageBatches: "message-batches-2024-09-24",
+  // Token Counting (generally available)
+  /** Token counting endpoint. */
+  tokenCounting: "token-counting-2024-11-01",
+  // Skills
+  /** Agent Skills for specialized tasks (PowerPoint, Excel, Word, PDF). */
+  skills: "skills-2025-10-02"
+};
+function webSearchTool(options) {
+  return {
+    type: "web_search_20250305",
+    name: "web_search",
+    ...options
+  };
+}
+function computerTool(options) {
+  const { version = "20250124", ...rest } = options;
+  return {
+    type: version === "20251124" ? "computer_20251124" : "computer_20250124",
+    name: "computer",
+    ...rest
+  };
+}
+function textEditorTool(options) {
+  const version = options?.version ?? "20250728";
+  return {
+    type: version === "20250728" ? "text_editor_20250728" : "text_editor_20250124",
+    name: version === "20250728" ? "str_replace_based_edit_tool" : "str_replace_editor",
+    ...options?.max_characters !== void 0 && { max_characters: options.max_characters }
+  };
+}
+function bashTool() {
+  return {
+    type: "bash_20250124",
+    name: "bash"
+  };
+}
+function codeExecutionTool() {
+  return {
+    type: "code_execution_20250825",
+    name: "code_execution"
+  };
+}
+function toolSearchTool(options) {
+  const mode = options?.mode ?? "regex";
+  return {
+    type: mode === "regex" ? "tool_search_tool_regex_20251119" : "tool_search_tool_bm25_20251119",
+    name: mode === "regex" ? "tool_search_tool_regex" : "tool_search_tool_bm25"
+  };
+}
+var tools = {
+  /** Creates a web search tool configuration */
+  webSearch: webSearchTool,
+  /** Creates a computer use tool configuration */
+  computer: computerTool,
+  /** Creates a text editor tool configuration */
+  textEditor: textEditorTool,
+  /** Creates a bash tool configuration */
+  bash: bashTool,
+  /** Creates a code execution tool configuration */
+  codeExecution: codeExecutionTool,
+  /** Creates a tool search tool configuration */
+  toolSearch: toolSearchTool
+};
 
 // src/providers/anthropic/transform.ts
-function transformRequest(request, modelId) {
+function transformRequest(request, modelId, useNativeStructuredOutput = false) {
   const params = request.params ?? {};
-  const { builtInTools, ...restParams } = params;
+  const { tools: builtInTools, ...restParams } = params;
   const anthropicRequest = {
     ...restParams,
     model: modelId,
@@ -44,17 +166,30 @@ function transformRequest(request, modelId) {
     anthropicRequest.tool_choice = { type: "auto" };
   }
   if (request.structure) {
-    const structuredTool = {
-      name: "json_response",
-      description: "Return the response in the specified JSON format. You MUST use this tool to provide your response.",
-      input_schema: {
-        type: "object",
-        properties: request.structure.properties,
-        required: request.structure.required
-      }
-    };
-    anthropicRequest.tools = [...anthropicRequest.tools ?? [], structuredTool];
-    anthropicRequest.tool_choice = { type: "tool", name: "json_response" };
+    if (useNativeStructuredOutput) {
+      const outputFormat = {
+        type: "json_schema",
+        schema: {
+          type: "object",
+          properties: request.structure.properties,
+          required: request.structure.required,
+          additionalProperties: false
+        }
+      };
+      anthropicRequest.output_format = outputFormat;
+    } else {
+      const structuredTool = {
+        name: "json_response",
+        description: "Return the response in the specified JSON format. You MUST use this tool to provide your response.",
+        input_schema: {
+          type: "object",
+          properties: request.structure.properties,
+          required: request.structure.required
+        }
+      };
+      anthropicRequest.tools = [...anthropicRequest.tools ?? [], structuredTool];
+      anthropicRequest.tool_choice = { type: "tool", name: "json_response" };
+    }
   }
   return anthropicRequest;
 }
@@ -182,13 +317,19 @@ function transformTool(tool) {
     ...cacheControl ? { cache_control: cacheControl } : {}
   };
 }
-function transformResponse(data) {
+function transformResponse(data, useNativeStructuredOutput = false) {
   const textContent = [];
   const toolCalls = [];
   let structuredData;
   for (const block of data.content) {
     if (block.type === "text") {
       textContent.push({ type: "text", text: block.text });
+      if (useNativeStructuredOutput && structuredData === void 0) {
+        try {
+          structuredData = JSON.parse(block.text);
+        } catch {
+        }
+      }
     } else if (block.type === "tool_use") {
       if (block.name === "json_response") {
         structuredData = block.input;
@@ -346,7 +487,7 @@ function transformStreamEvent(event, state) {
       return null;
   }
 }
-function buildResponseFromState(state) {
+function buildResponseFromState(state, useNativeStructuredOutput = false) {
   const textContent = [];
   const toolCalls = [];
   let structuredData;
@@ -354,6 +495,12 @@ function buildResponseFromState(state) {
     if (!block) continue;
     if (block.type === "text" && block.text) {
       textContent.push({ type: "text", text: block.text });
+      if (useNativeStructuredOutput && structuredData === void 0) {
+        try {
+          structuredData = JSON.parse(block.text);
+        } catch {
+        }
+      }
     } else if (block.type === "tool_use" && block.id && block.name) {
       let args = {};
       if (block.input) {
@@ -411,6 +558,16 @@ ${block.fileContent}\`\`\`
 }
 
 // src/providers/anthropic/llm.ts
+function shouldUseNativeStructuredOutput(config, structure) {
+  if (!structure) {
+    return false;
+  }
+  const betaHeader = config.headers?.["anthropic-beta"];
+  if (!betaHeader) {
+    return false;
+  }
+  return betaHeader.includes(betas.structuredOutputs);
+}
 var ANTHROPIC_API_URL = "https://api.anthropic.com/v1/messages";
 var ANTHROPIC_VERSION = "2023-06-01";
 var ANTHROPIC_CAPABILITIES = {
@@ -449,8 +606,12 @@ function createLLMHandler() {
             "anthropic",
             "llm"
           );
+          const useNativeStructuredOutput = shouldUseNativeStructuredOutput(
+            request.config,
+            request.structure
+          );
           const baseUrl = request.config.baseUrl ?? ANTHROPIC_API_URL;
-          const body = transformRequest(request, modelId);
+          const body = transformRequest(request, modelId, useNativeStructuredOutput);
           const headers = {
             "Content-Type": "application/json",
             "x-api-key": apiKey,
@@ -476,10 +637,14 @@ function createLLMHandler() {
             "llm"
           );
           const data = await response.json();
-          return transformResponse(data);
+          return transformResponse(data, useNativeStructuredOutput);
         },
         stream(request) {
           const state = createStreamState();
+          const useNativeStructuredOutput = shouldUseNativeStructuredOutput(
+            request.config,
+            request.structure
+          );
           let responseResolve;
           let responseReject;
           const responsePromise = new Promise((resolve, reject) => {
@@ -495,7 +660,7 @@ function createLLMHandler() {
                 "llm"
               );
               const baseUrl = request.config.baseUrl ?? ANTHROPIC_API_URL;
-              const body = transformRequest(request, modelId);
+              const body = transformRequest(request, modelId, useNativeStructuredOutput);
               body.stream = true;
               const headers = {
                 "Content-Type": "application/json",
@@ -555,7 +720,7 @@ function createLLMHandler() {
                   }
                 }
               }
-              responseResolve(buildResponseFromState(state));
+              responseResolve(buildResponseFromState(state, useNativeStructuredOutput));
             } catch (error) {
               responseReject(error);
               throw error;
@@ -574,74 +739,37 @@ function createLLMHandler() {
   };
 }
 
-// src/providers/anthropic/types.ts
-function webSearchTool(options) {
-  return {
-    type: "web_search_20250305",
-    name: "web_search",
-    ...options
-  };
-}
-function computerTool(options) {
-  const { version = "20250124", ...rest } = options;
-  return {
-    type: version === "20251124" ? "computer_20251124" : "computer_20250124",
-    name: "computer",
-    ...rest
-  };
-}
-function textEditorTool(options) {
-  const version = options?.version ?? "20250728";
-  return {
-    type: version === "20250728" ? "text_editor_20250728" : "text_editor_20250124",
-    name: version === "20250728" ? "str_replace_based_edit_tool" : "str_replace_editor",
-    ...options?.max_characters !== void 0 && { max_characters: options.max_characters }
-  };
-}
-function bashTool() {
-  return {
-    type: "bash_20250124",
-    name: "bash"
-  };
-}
-function codeExecutionTool() {
-  return {
-    type: "code_execution_20250825",
-    name: "code_execution"
-  };
-}
-function toolSearchTool(options) {
-  const mode = options?.mode ?? "regex";
+// src/providers/anthropic/index.ts
+function createProviderConfig(options) {
+  if (!options?.betas || options.betas.length === 0) {
+    return void 0;
+  }
+  const betaHeader = options.betas.join(",");
   return {
-    type: mode === "regex" ? "tool_search_tool_regex_20251119" : "tool_search_tool_bm25_20251119",
-    name: mode === "regex" ? "tool_search_tool_regex" : "tool_search_tool_bm25"
+    headers: {
+      "anthropic-beta": betaHeader
+    }
   };
 }
-var tools = {
-  /** Creates a web search tool configuration */
-  webSearch: webSearchTool,
-  /** Creates a computer use tool configuration */
-  computer: computerTool,
-  /** Creates a text editor tool configuration */
-  textEditor: textEditorTool,
-  /** Creates a bash tool configuration */
-  bash: bashTool,
-  /** Creates a code execution tool configuration */
-  codeExecution: codeExecutionTool,
-  /** Creates a tool search tool configuration */
-  toolSearch: toolSearchTool
-};
-
-// src/providers/anthropic/index.ts
 var anthropic = createProvider({
   name: "anthropic",
   version: "1.0.0",
-  modalities: {
+  handlers: {
     llm: createLLMHandler()
+  },
+  createModelReference: (modelId, options, provider) => {
+    const providerConfig = createProviderConfig(options);
+    return {
+      modelId,
+      provider,
+      options,
+      ...providerConfig && { providerConfig }
+    };
   }
 });
 export {
   anthropic,
+  betas,
   tools
 };
 //# sourceMappingURL=index.js.map