@providerprotocol/ai 0.0.29 → 0.0.32

package/dist/{retry-DXLQnTuU.d.ts → retry-8Ch-WWgX.d.ts}

@@ -1,4 +1,4 @@
-import { ar as KeyStrategy, aq as ProviderConfig, i as Modality, as as RetryStrategy, U as UPPError } from './llm-DgDEy9il.js';
+import { av as KeyStrategy, au as ProviderConfig, k as Modality, aw as RetryStrategy, U as UPPError } from './llm-BQJZj3cD.js';
 
 /**
  * API key management strategies for load balancing and dynamic key selection.
@@ -147,6 +147,20 @@ declare class DynamicKey implements KeyStrategy {
      */
     getKey(): Promise<string>;
 }
+/**
+ * Masks an API key for safe logging.
+ * Shows first 4 and last 4 characters with ellipsis, or '***' for short keys.
+ *
+ * @param key - The API key to mask
+ * @returns Masked key like "sk-ab...yz12" or "***" for short keys
+ *
+ * @example
+ * ```typescript
+ * maskApiKey('sk-abc123def456xyz789'); // 'sk-a...z789'
+ * maskApiKey('short'); // '***'
+ * ```
+ */
+declare function maskApiKey(key: string): string;
 /**
  * Resolves an API key from provider configuration with multiple fallback options.
  *
@@ -514,4 +528,4 @@ declare class RetryAfterStrategy implements RetryStrategy {
     onRetry(error: UPPError, attempt: number): number | null;
 }
 
-export { DynamicKey as D, ExponentialBackoff as E, LinearBackoff as L, NoRetry as N, RoundRobinKeys as R, TokenBucket as T, WeightedKeys as W, RetryAfterStrategy as a, resolveApiKey as r };
+export { DynamicKey as D, ExponentialBackoff as E, LinearBackoff as L, NoRetry as N, RoundRobinKeys as R, TokenBucket as T, WeightedKeys as W, RetryAfterStrategy as a, maskApiKey as m, resolveApiKey as r };

package/dist/xai/index.d.ts

@@ -1,4 +1,4 @@
-import { P as Provider } from '../llm-DgDEy9il.js';
+import { P as Provider } from '../llm-BQJZj3cD.js';
 
 /**
  * xAI Chat Completions API parameters (OpenAI-compatible).
@@ -59,11 +59,6 @@ interface XAICompletionsParams {
     metadata?: Record<string, string>;
     /** Response format for structured output */
     response_format?: XAIResponseFormat;
-    /**
-     * Live Search parameters (deprecated, will be removed Dec 15, 2025)
-     * Use Agent Tools API instead for new implementations
-     */
-    search_parameters?: XAISearchParameters;
 }
 /**
  * xAI Responses API parameters (OpenAI Responses-compatible).
@@ -112,11 +107,6 @@ interface XAIResponsesParams {
     store_messages?: boolean;
     /** Metadata key-value pairs */
     metadata?: Record<string, string>;
-    /**
-     * Live Search parameters (deprecated, will be removed Dec 15, 2025)
-     * Use Agent Tools API instead for new implementations
-     */
-    search_parameters?: XAISearchParameters;
     /**
      * Built-in agentic tools for server-side execution.
      *
@@ -191,6 +181,17 @@ interface XAIMessagesParams {
         type: 'enabled';
         budget_tokens: number;
     };
+    /**
+     * Tool selection strategy.
+     *
+     * - `auto`: Model decides when to use tools
+     * - `any`: Model must use at least one tool
+     * - `tool`: Model must use the specific tool named in `name`
+     */
+    tool_choice?: {
+        type: 'auto' | 'any' | 'tool';
+        name?: string;
+    };
 }
 /**
  * API mode selector for the xAI provider.
@@ -224,24 +225,6 @@ interface XAIConfig {
     /** The API mode to use (defaults to 'completions') */
     api?: XAIAPIMode;
 }
-/**
- * Live Search parameters for real-time web search integration.
- *
- * @deprecated Live Search API will be removed on December 15, 2025.
- * Use the Agent Tools API with `web_search` tool instead.
- */
-interface XAISearchParameters {
-    /** Search mode */
-    mode?: 'auto' | 'on' | 'off';
-    /** Limit search to specific date range */
-    from_date?: string;
-    /** End date for search range */
-    to_date?: string;
-    /** Sources to search */
-    sources?: Array<'web' | 'x' | 'news' | 'rss'>;
-    /** Maximum number of search results */
-    max_search_results?: number;
-}
 /**
  * Web search tool for real-time web information retrieval.
  *
@@ -677,15 +660,12 @@ type XAIProvider = Provider<XAIProviderOptions>;
  *   }
  * });
  *
- * // Using Live Search (deprecated Dec 2025)
+ * // Using Agent Tools (web search, code execution, etc.)
  * const searchModel = llm({
- *   model: xai('grok-4'),
+ *   model: xai('grok-4', { api: 'responses' }),
  *   params: {
  *     max_tokens: 1000,
- *     search_parameters: {
- *       mode: 'auto',
- *       sources: ['web', 'x', 'news'],
- *     }
+ *     tools: [tools.webSearch()],
  *   }
  * });
  *
@@ -696,4 +676,4 @@ type XAIProvider = Provider<XAIProviderOptions>;
  */
 declare const xai: Provider<XAIProviderOptions>;
 
-export { type XAIAPIMode, type XAIAgentTool, type XAIBuiltInTool, type XAICodeExecutionTool, type XAICompletionsParams, type XAIConfig, type XAIFileSearchTool, type XAIHeaders, type XAIMcpTool, type XAIMessagesParams, type XAIModelOptions, type XAIModelReference, type XAIProvider, type XAIProviderOptions, type XAIResponsesParams, type XAISearchParameters, type XAIServerSideToolUsage, type XAIWebSearchTool, type XAIXSearchTool, tools, xai };
+export { type XAIAPIMode, type XAIAgentTool, type XAIBuiltInTool, type XAICodeExecutionTool, type XAICompletionsParams, type XAIConfig, type XAIFileSearchTool, type XAIHeaders, type XAIMcpTool, type XAIMessagesParams, type XAIModelOptions, type XAIModelReference, type XAIProvider, type XAIProviderOptions, type XAIResponsesParams, type XAIServerSideToolUsage, type XAIWebSearchTool, type XAIXSearchTool, tools, xai };

package/dist/xai/index.js

@@ -3,10 +3,11 @@ import {
 } from "../chunk-WAKD3OO5.js";
 import {
   parseJsonResponse
-} from "../chunk-Z6DKC37J.js";
+} from "../chunk-3C7O2RNO.js";
 import {
-  StreamEventType
-} from "../chunk-73IIE3QT.js";
+  StreamEventType,
+  objectDelta
+} from "../chunk-6S222DHN.js";
 import {
   AssistantMessage,
   createProvider,
@@ -20,7 +21,7 @@ import {
 } from "../chunk-TOJCZMVU.js";
 import {
   resolveApiKey
-} from "../chunk-55X3W2MN.js";
+} from "../chunk-3D6XGGVG.js";
 import {
   ErrorCode,
   ModalityType,
@@ -29,7 +30,7 @@ import {
   doStreamFetch,
   normalizeHttpError,
   toError
-} from "../chunk-QNJO7DSD.js";
+} from "../chunk-4J6OFUKX.js";
 
 // src/providers/xai/transform.completions.ts
 function transformRequest(request, modelId) {
@@ -192,9 +193,7 @@ function transformContentBlock(block) {
       } else if (imageBlock.source.type === "url") {
         url = imageBlock.source.url;
       } else if (imageBlock.source.type === "bytes") {
-        const base64 = btoa(
-          Array.from(imageBlock.source.data).map((b) => String.fromCharCode(b)).join("")
-        );
+        const base64 = Buffer.from(imageBlock.source.data).toString("base64");
         url = `data:${imageBlock.mimeType};base64,${base64}`;
       } else {
         throw new Error("Unknown image source type");
@@ -619,7 +618,11 @@ function createCompletionsLLMHandler() {
                   }
                   const uppEvents = transformStreamEvent(chunk, state);
                   for (const event of uppEvents) {
-                    yield event;
+                    if (request.structure && event.type === StreamEventType.TextDelta) {
+                      yield objectDelta(event.delta.text ?? "", event.index);
+                    } else {
+                      yield event;
+                    }
                   }
                 }
               }
@@ -844,9 +847,7 @@ function transformContentPart(block) {
         };
       }
       if (imageBlock.source.type === "bytes") {
-        const base64 = btoa(
-          Array.from(imageBlock.source.data).map((b) => String.fromCharCode(b)).join("")
-        );
+        const base64 = Buffer.from(imageBlock.source.data).toString("base64");
         return {
           type: "input_image",
           image_url: `data:${imageBlock.mimeType};base64,${base64}`
@@ -1391,7 +1392,11 @@ function createResponsesLLMHandler() {
                   }
                   const uppEvents = transformStreamEvent2(event, state);
                   for (const uppEvent of uppEvents) {
-                    yield uppEvent;
+                    if (request.structure && uppEvent.type === StreamEventType.TextDelta) {
+                      yield objectDelta(uppEvent.delta.text ?? "", uppEvent.index);
+                    } else {
+                      yield uppEvent;
+                    }
                   }
                 }
               }
@@ -1465,7 +1470,9 @@ function transformRequest3(request, modelId) {
   }
   if (request.tools && request.tools.length > 0) {
     xaiRequest.tools = request.tools.map(transformTool3);
-    xaiRequest.tool_choice = { type: "auto" };
+    if (!xaiRequest.tool_choice) {
+      xaiRequest.tool_choice = { type: "auto" };
+    }
   }
   if (request.structure) {
     const structuredTool = {
@@ -1565,9 +1572,7 @@ function transformContentBlock2(block) {
         };
       }
       if (imageBlock.source.type === "bytes") {
-        const base64 = btoa(
-          Array.from(imageBlock.source.data).map((b) => String.fromCharCode(b)).join("")
-        );
+        const base64 = Buffer.from(imageBlock.source.data).toString("base64");
         return {
           type: "image",
           source: {
@@ -1951,7 +1956,11 @@ function createMessagesLLMHandler() {
                   }
                   const uppEvent = transformStreamEvent3(event, state);
                   if (uppEvent) {
-                    yield uppEvent;
+                    if (request.structure && uppEvent.type === StreamEventType.TextDelta) {
+                      yield objectDelta(uppEvent.delta.text ?? "", uppEvent.index);
+                    } else {
+                      yield uppEvent;
+                    }
                   }
                 }
               }
@@ -2070,7 +2079,8 @@ function transformResponse4(data) {
     }
     return {
       image,
-      metadata: item.revised_prompt ? { revised_prompt: item.revised_prompt } : void 0
+      // Per-image metadata namespaced under provider (Spec 15.4)
+      metadata: item.revised_prompt ? { xai: { revised_prompt: item.revised_prompt } } : void 0
     };
   });
   return {