@providerprotocol/ai 0.0.20 → 0.0.22

package/dist/anthropic/index.js

@@ -1,36 +1,164 @@
 import {
-  createProvider
-} from "../chunk-MSR5P65T.js";
+  parseJsonResponse
+} from "../chunk-I2VHCGQE.js";
 import {
   AssistantMessage,
+  createProvider,
+  generateId,
   isAssistantMessage,
   isToolResultMessage,
   isUserMessage
-} from "../chunk-UMKWXGO3.js";
+} from "../chunk-M4BMM5IB.js";
 import {
   parseSSEStream
-} from "../chunk-Z7RBRCRN.js";
+} from "../chunk-NWS5IKNR.js";
 import {
   resolveApiKey
-} from "../chunk-P5IRTEM5.js";
+} from "../chunk-7WYBJPJJ.js";
 import {
   UPPError,
   doFetch,
   doStreamFetch,
-  normalizeHttpError
-} from "../chunk-U3FZWV4U.js";
+  normalizeHttpError,
+  toError
+} from "../chunk-RFWLEFAB.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,
     messages: request.messages.map(transformMessage)
   };
-  if (request.system) {
-    anthropicRequest.system = request.system;
+  const normalizedSystem = normalizeSystem(request.system);
+  if (normalizedSystem !== void 0) {
+    anthropicRequest.system = normalizedSystem;
   }
   const allTools = [];
   if (request.tools && request.tools.length > 0) {
@@ -44,20 +172,85 @@ 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,
+          ...request.structure.additionalProperties !== void 0 ? { additionalProperties: request.structure.additionalProperties } : {}
+        }
+      };
+      anthropicRequest.tools = [...anthropicRequest.tools ?? [], structuredTool];
+      anthropicRequest.tool_choice = { type: "tool", name: "json_response" };
+    }
   }
   return anthropicRequest;
 }
+function normalizeSystem(system) {
+  if (system === void 0 || system === null) return void 0;
+  if (typeof system === "string") return system;
+  if (!Array.isArray(system)) {
+    throw new UPPError(
+      "System prompt must be a string or an array of text blocks",
+      "INVALID_REQUEST",
+      "anthropic",
+      "llm"
+    );
+  }
+  const blocks = [];
+  for (const block of system) {
+    if (!block || typeof block !== "object") {
+      throw new UPPError(
+        'System prompt array must contain objects with type "text"',
+        "INVALID_REQUEST",
+        "anthropic",
+        "llm"
+      );
+    }
+    const candidate = block;
+    if (candidate.type !== "text" || typeof candidate.text !== "string") {
+      throw new UPPError(
+        'Anthropic system blocks must be of type "text" with a string text field',
+        "INVALID_REQUEST",
+        "anthropic",
+        "llm"
+      );
+    }
+    if (candidate.cache_control !== void 0 && !isValidCacheControl(candidate.cache_control)) {
+      throw new UPPError(
+        "Invalid cache_control for Anthropic system prompt",
+        "INVALID_REQUEST",
+        "anthropic",
+        "llm"
+      );
+    }
+    blocks.push(block);
+  }
+  return blocks.length > 0 ? blocks : void 0;
+}
+function isValidCacheControl(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  if (candidate.type !== "ephemeral") return false;
+  if (candidate.ttl !== void 0 && candidate.ttl !== "5m" && candidate.ttl !== "1h") {
+    return false;
+  }
+  return true;
+}
 function filterValidContent(content) {
   return content.filter((c) => c && typeof c.type === "string");
 }
@@ -177,18 +370,25 @@ function transformTool(tool) {
     input_schema: {
       type: "object",
       properties: tool.parameters.properties,
-      required: tool.parameters.required
+      required: tool.parameters.required,
+      ...tool.parameters.additionalProperties !== void 0 ? { additionalProperties: tool.parameters.additionalProperties } : {}
     },
     ...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;
@@ -255,6 +455,7 @@ function createStreamState() {
   };
 }
 function transformStreamEvent(event, state) {
+  const events = [];
   switch (event.type) {
     case "message_start":
       state.messageId = event.message.id;
@@ -262,7 +463,8 @@ function transformStreamEvent(event, state) {
       state.inputTokens = event.message.usage.input_tokens;
       state.cacheReadTokens = event.message.usage.cache_read_input_tokens ?? 0;
       state.cacheWriteTokens = event.message.usage.cache_creation_input_tokens ?? 0;
-      return { type: "message_start", index: 0, delta: {} };
+      events.push({ type: "message_start", index: 0, delta: {} });
+      break;
     case "content_block_start":
       if (event.content_block.type === "text") {
         state.content[event.index] = { type: "text", text: "" };
@@ -295,24 +497,26 @@ function transformStreamEvent(event, state) {
           fileContent: resultBlock.content?.content ?? ""
         };
       }
-      return { type: "content_block_start", index: event.index, delta: {} };
+      events.push({ type: "content_block_start", index: event.index, delta: {} });
+      break;
     case "content_block_delta": {
       const delta = event.delta;
       if (delta.type === "text_delta") {
         if (state.content[event.index]) {
           state.content[event.index].text = (state.content[event.index].text ?? "") + delta.text;
         }
-        return {
+        events.push({
           type: "text_delta",
           index: event.index,
           delta: { text: delta.text }
-        };
+        });
+        break;
       }
       if (delta.type === "input_json_delta") {
         if (state.content[event.index]) {
           state.content[event.index].input = (state.content[event.index].input ?? "") + delta.partial_json;
         }
-        return {
+        events.push({
           type: "tool_call_delta",
           index: event.index,
           delta: {
@@ -320,33 +524,38 @@ function transformStreamEvent(event, state) {
             toolCallId: state.content[event.index]?.id,
             toolName: state.content[event.index]?.name
           }
-        };
+        });
+        break;
       }
       if (delta.type === "thinking_delta") {
-        return {
+        events.push({
           type: "reasoning_delta",
           index: event.index,
           delta: { text: delta.thinking }
-        };
+        });
+        break;
       }
-      return null;
+      break;
     }
     case "content_block_stop":
-      return { type: "content_block_stop", index: event.index, delta: {} };
+      events.push({ type: "content_block_stop", index: event.index, delta: {} });
+      break;
     case "message_delta":
       state.stopReason = event.delta.stop_reason;
       state.outputTokens = event.usage.output_tokens;
-      return null;
+      return [];
     case "message_stop":
-      return { type: "message_stop", index: 0, delta: {} };
+      events.push({ type: "message_stop", index: 0, delta: {} });
+      break;
     case "ping":
     case "error":
-      return null;
+      return [];
     default:
-      return null;
+      break;
   }
+  return events;
 }
-function buildResponseFromState(state) {
+function buildResponseFromState(state, useNativeStructuredOutput = false) {
   const textContent = [];
   const toolCalls = [];
   let structuredData;
@@ -354,6 +563,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) {
@@ -382,11 +597,12 @@ ${block.fileContent}\`\`\`
 ` });
     }
   }
+  const messageId = state.messageId || generateId();
   const message = new AssistantMessage(
     textContent,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
-      id: state.messageId,
+      id: messageId,
       metadata: {
         anthropic: {
           stop_reason: state.stopReason,
@@ -411,6 +627,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 +675,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,
@@ -475,11 +705,15 @@ function createLLMHandler() {
             "anthropic",
             "llm"
           );
-          const data = await response.json();
-          return transformResponse(data);
+          const data = await parseJsonResponse(response, "anthropic", "llm");
+          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,12 +729,13 @@ 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",
                 "x-api-key": apiKey,
-                "anthropic-version": request.config.apiVersion ?? ANTHROPIC_VERSION
+                "anthropic-version": request.config.apiVersion ?? ANTHROPIC_VERSION,
+                Accept: "text/event-stream"
               };
               if (request.config.headers) {
                 for (const [key, value] of Object.entries(request.config.headers)) {
@@ -549,16 +784,17 @@ function createLLMHandler() {
                     responseReject(error);
                     throw error;
                   }
-                  const uppEvent = transformStreamEvent(event, state);
-                  if (uppEvent) {
+                  const uppEvents = transformStreamEvent(event, state);
+                  for (const uppEvent of uppEvents) {
                     yield uppEvent;
                   }
                 }
               }
-              responseResolve(buildResponseFromState(state));
+              responseResolve(buildResponseFromState(state, useNativeStructuredOutput));
             } catch (error) {
-              responseReject(error);
-              throw error;
+              const err = toError(error);
+              responseReject(err);
+              throw err;
             }
           }
           return {
@@ -574,74 +810,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