@providerprotocol/ai 0.0.21 → 0.0.22

package/dist/{stream-Di9acos2.d.ts → stream-DbkLOIbJ.d.ts}

@@ -1,4 +1,4 @@
-import { C as ContentBlock, l as ImageBlock, m as AudioBlock, V as VideoBlock, A as AssistantContent, U as UserContent } from './provider-DGQHYE6I.js';
+import { C as ContentBlock, l as ImageBlock, m as AudioBlock, V as VideoBlock, A as AssistantContent, U as UserContent } from './provider-DWEAzeM5.js';
 
 /**
  * @fileoverview JSON Schema types for tool parameters and structured outputs.
@@ -752,7 +752,12 @@ interface Turn<TData = unknown> {
     readonly messages: Message[];
     /** The final assistant response (last AssistantMessage in the turn) */
     readonly response: AssistantMessage;
-    /** Tool executions that occurred during this turn */
+    /**
+     * Tool executions that occurred during this turn.
+     *
+     * Execution order reflects completion timing, not call order.
+     * Correlate with tool calls using toolCallId.
+     */
     readonly toolExecutions: ToolExecution[];
     /** Aggregate token usage for the entire turn */
     readonly usage: TokenUsage;
@@ -767,6 +772,9 @@ interface Turn<TData = unknown> {
 /**
  * Turn serialized to JSON format.
  * Messages are converted to MessageJSON, response is omitted (computed from messages).
+ *
+ * @remarks
+ * This type is derived from {@link Turn} and should stay in sync with it.
  */
 type TurnJSON = Omit<Turn, 'messages' | 'response'> & {
     messages: MessageJSON[];
@@ -850,7 +858,7 @@ type StreamEventType =
  | 'video_delta'
 /** Incremental tool call data (arguments being streamed) */
  | 'tool_call_delta'
-/** Tool execution has started */
+/** Tool execution has started (may be emitted after completion in some implementations) */
  | 'tool_execution_start'
 /** Tool execution has completed */
  | 'tool_execution_end'
@@ -938,10 +946,12 @@ interface StreamEvent {
 interface StreamResult<TData = unknown> extends AsyncIterable<StreamEvent> {
     /**
      * Promise that resolves to the complete Turn after streaming finishes.
+     * Rejects if the stream is aborted or terminated early.
      */
     readonly turn: Promise<Turn<TData>>;
     /**
      * Aborts the stream, stopping further events and cancelling the request.
+     * This will cause {@link StreamResult.turn} to reject.
      */
     abort(): void;
 }
@@ -950,7 +960,7 @@ interface StreamResult<TData = unknown> extends AsyncIterable<StreamEvent> {
  *
  * @typeParam TData - Type of the structured output data
  * @param generator - Async generator that yields stream events
- * @param turnPromise - Promise that resolves to the complete Turn
+ * @param turnPromiseOrFactory - Promise or factory that resolves to the complete Turn
  * @param abortController - Controller for aborting the stream
  * @returns A StreamResult that can be iterated and awaited
  *
@@ -964,7 +974,7 @@ interface StreamResult<TData = unknown> extends AsyncIterable<StreamEvent> {
  * );
  * ```
  */
-declare function createStreamResult<TData = unknown>(generator: AsyncGenerator<StreamEvent, void, unknown>, turnPromise: Promise<Turn<TData>>, abortController: AbortController): StreamResult<TData>;
+declare function createStreamResult<TData = unknown>(generator: AsyncGenerator<StreamEvent, void, unknown>, turnPromiseOrFactory: Promise<Turn<TData>> | (() => Promise<Turn<TData>>), abortController: AbortController): StreamResult<TData>;
 /**
  * Creates a text delta stream event.
  *

package/dist/xai/index.d.ts

@@ -1,4 +1,4 @@
-import { g as Provider } from '../provider-DGQHYE6I.js';
+import { g as Provider } from '../provider-DWEAzeM5.js';
 
 /**
  * xAI Chat Completions API parameters (OpenAI-compatible).

package/dist/xai/index.js

@@ -1,25 +1,30 @@
 import {
   Image
 } from "../chunk-WAKD3OO5.js";
+import {
+  parseJsonResponse
+} from "../chunk-I2VHCGQE.js";
 import {
   AssistantMessage,
   createProvider,
+  generateId,
   isAssistantMessage,
   isToolResultMessage,
   isUserMessage
 } from "../chunk-M4BMM5IB.js";
 import {
   parseSSEStream
-} from "../chunk-Z7RBRCRN.js";
+} from "../chunk-NWS5IKNR.js";
 import {
   resolveApiKey
-} from "../chunk-Y3GBJNA2.js";
+} from "../chunk-7WYBJPJJ.js";
 import {
   UPPError,
   doFetch,
   doStreamFetch,
-  normalizeHttpError
-} from "../chunk-EDENPF3E.js";
+  normalizeHttpError,
+  toError
+} from "../chunk-RFWLEFAB.js";
 
 // src/providers/xai/transform.completions.ts
 function transformRequest(request, modelId) {
@@ -55,9 +60,40 @@ function transformRequest(request, modelId) {
   return xaiRequest;
 }
 function normalizeSystem(system) {
-  if (!system) return void 0;
+  if (system === void 0 || system === null) return void 0;
   if (typeof system === "string") return system;
-  return system.map((block) => block.text ?? "").filter((text) => text.length > 0).join("\n\n");
+  if (!Array.isArray(system)) {
+    throw new UPPError(
+      "System prompt must be a string or an array of text blocks",
+      "INVALID_REQUEST",
+      "xai",
+      "llm"
+    );
+  }
+  const texts = [];
+  for (const block of system) {
+    if (!block || typeof block !== "object" || !("text" in block)) {
+      throw new UPPError(
+        "System prompt array must contain objects with a text field",
+        "INVALID_REQUEST",
+        "xai",
+        "llm"
+      );
+    }
+    const textValue = block.text;
+    if (typeof textValue !== "string") {
+      throw new UPPError(
+        "System prompt text must be a string",
+        "INVALID_REQUEST",
+        "xai",
+        "llm"
+      );
+    }
+    if (textValue.length > 0) {
+      texts.push(textValue);
+    }
+  }
+  return texts.length > 0 ? texts.join("\n\n") : void 0;
 }
 function transformMessages(messages, system) {
   const result = [];
@@ -216,11 +252,12 @@ function transformResponse(data) {
       });
     }
   }
+  const responseId = data.id || generateId();
   const message = new AssistantMessage(
     textContent,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
-      id: data.id,
+      id: responseId,
       metadata: {
         xai: {
           model: data.model,
@@ -370,11 +407,12 @@ function buildResponseFromState(state) {
       arguments: args
     });
   }
+  const messageId = state.id || generateId();
   const message = new AssistantMessage(
     textContent,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
-      id: state.id,
+      id: messageId,
       metadata: {
         xai: {
           model: state.model,
@@ -479,7 +517,7 @@ function createCompletionsLLMHandler() {
             "xai",
             "llm"
           );
-          const data = await response.json();
+          const data = await parseJsonResponse(response, "xai", "llm");
           return transformResponse(data);
         },
         stream(request) {
@@ -504,7 +542,8 @@ function createCompletionsLLMHandler() {
               body.stream_options = { include_usage: true };
               const headers = {
                 "Content-Type": "application/json",
-                Authorization: `Bearer ${apiKey}`
+                Authorization: `Bearer ${apiKey}`,
+                Accept: "text/event-stream"
               };
               if (request.config.headers) {
                 for (const [key, value] of Object.entries(request.config.headers)) {
@@ -565,8 +604,9 @@ function createCompletionsLLMHandler() {
               }
               responseResolve(buildResponseFromState(state));
             } catch (error) {
-              responseReject(error);
-              throw error;
+              const err = toError(error);
+              responseReject(err);
+              throw err;
             }
           }
           return {
@@ -622,9 +662,40 @@ function transformRequest2(request, modelId) {
   return xaiRequest;
 }
 function normalizeSystem2(system) {
-  if (!system) return void 0;
+  if (system === void 0 || system === null) return void 0;
   if (typeof system === "string") return system;
-  return system.map((block) => block.text ?? "").filter((text) => text.length > 0).join("\n\n");
+  if (!Array.isArray(system)) {
+    throw new UPPError(
+      "System prompt must be a string or an array of text blocks",
+      "INVALID_REQUEST",
+      "xai",
+      "llm"
+    );
+  }
+  const texts = [];
+  for (const block of system) {
+    if (!block || typeof block !== "object" || !("text" in block)) {
+      throw new UPPError(
+        "System prompt array must contain objects with a text field",
+        "INVALID_REQUEST",
+        "xai",
+        "llm"
+      );
+    }
+    const textValue = block.text;
+    if (typeof textValue !== "string") {
+      throw new UPPError(
+        "System prompt text must be a string",
+        "INVALID_REQUEST",
+        "xai",
+        "llm"
+      );
+    }
+    if (textValue.length > 0) {
+      texts.push(textValue);
+    }
+  }
+  return texts.length > 0 ? texts.join("\n\n") : void 0;
 }
 function transformInputItems(messages, system) {
   const result = [];
@@ -805,16 +876,17 @@ function transformResponse2(data) {
       });
     }
   }
+  const responseId = data.id || generateId();
   const message = new AssistantMessage(
     textContent,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
-      id: data.id,
+      id: responseId,
       metadata: {
         xai: {
           model: data.model,
           status: data.status,
-          response_id: data.id,
+          response_id: responseId,
           functionCallItems: functionCallItems.length > 0 ? functionCallItems : void 0,
           citations: data.citations,
           inline_citations: data.inline_citations
@@ -1040,16 +1112,17 @@ function buildResponseFromState2(state) {
       });
     }
   }
+  const responseId = state.id || generateId();
   const message = new AssistantMessage(
     textContent,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
-      id: state.id,
+      id: responseId,
       metadata: {
         xai: {
           model: state.model,
           status: state.status,
-          response_id: state.id,
+          response_id: responseId,
           functionCallItems: functionCallItems.length > 0 ? functionCallItems : void 0
         }
       }
@@ -1142,7 +1215,7 @@ function createResponsesLLMHandler() {
             "xai",
             "llm"
           );
-          const data = await response.json();
+          const data = await parseJsonResponse(response, "xai", "llm");
           if (data.status === "failed" && data.error) {
             throw new UPPError(
               data.error.message,
@@ -1174,7 +1247,8 @@ function createResponsesLLMHandler() {
               body.stream = true;
               const headers = {
                 "Content-Type": "application/json",
-                Authorization: `Bearer ${apiKey}`
+                Authorization: `Bearer ${apiKey}`,
+                Accept: "text/event-stream"
               };
               if (request.config.headers) {
                 for (const [key, value] of Object.entries(request.config.headers)) {
@@ -1235,8 +1309,9 @@ function createResponsesLLMHandler() {
               }
               responseResolve(buildResponseFromState2(state));
             } catch (error) {
-              responseReject(error);
-              throw error;
+              const err = toError(error);
+              responseReject(err);
+              throw err;
             }
           }
           return {
@@ -1254,9 +1329,40 @@ function createResponsesLLMHandler() {
 
 // src/providers/xai/transform.messages.ts
 function normalizeSystem3(system) {
-  if (!system) return void 0;
+  if (system === void 0 || system === null) return void 0;
   if (typeof system === "string") return system;
-  return system.map((block) => block.text ?? "").filter((text) => text.length > 0).join("\n\n");
+  if (!Array.isArray(system)) {
+    throw new UPPError(
+      "System prompt must be a string or an array of text blocks",
+      "INVALID_REQUEST",
+      "xai",
+      "llm"
+    );
+  }
+  const texts = [];
+  for (const block of system) {
+    if (!block || typeof block !== "object" || !("text" in block)) {
+      throw new UPPError(
+        "System prompt array must contain objects with a text field",
+        "INVALID_REQUEST",
+        "xai",
+        "llm"
+      );
+    }
+    const textValue = block.text;
+    if (typeof textValue !== "string") {
+      throw new UPPError(
+        "System prompt text must be a string",
+        "INVALID_REQUEST",
+        "xai",
+        "llm"
+      );
+    }
+    if (textValue.length > 0) {
+      texts.push(textValue);
+    }
+  }
+  return texts.length > 0 ? texts.join("\n\n") : void 0;
 }
 function transformRequest3(request, modelId) {
   const params = request.params ?? {};
@@ -1547,11 +1653,12 @@ function buildResponseFromState3(state) {
       });
     }
   }
+  const messageId = state.messageId || generateId();
   const message = new AssistantMessage(
     textContent,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
-      id: state.messageId,
+      id: messageId,
       metadata: {
         xai: {
           stop_reason: state.stopReason,
@@ -1639,7 +1746,7 @@ function createMessagesLLMHandler() {
             "xai",
             "llm"
           );
-          const data = await response.json();
+          const data = await parseJsonResponse(response, "xai", "llm");
           return transformResponse3(data);
         },
         stream(request) {
@@ -1664,7 +1771,8 @@ function createMessagesLLMHandler() {
               const headers = {
                 "Content-Type": "application/json",
                 "x-api-key": apiKey,
-                "anthropic-version": "2023-06-01"
+                "anthropic-version": "2023-06-01",
+                Accept: "text/event-stream"
               };
               if (request.config.headers) {
                 for (const [key, value] of Object.entries(request.config.headers)) {
@@ -1721,8 +1829,9 @@ function createMessagesLLMHandler() {
               }
               responseResolve(buildResponseFromState3(state));
             } catch (error) {
-              responseReject(error);
-              throw error;
+              const err = toError(error);
+              responseReject(err);
+              throw err;
             }
           }
           return {
@@ -1813,7 +1922,7 @@ async function executeGenerate(modelId, request) {
     body: JSON.stringify(body),
     signal: request.signal
   }, request.config, "xai", "image");
-  const data = await response.json();
+  const data = await parseJsonResponse(response, "xai", "image");
   return transformResponse4(data);
 }
 function transformResponse4(data) {