@providerprotocol/ai 0.0.39 → 0.0.40

package/dist/{stream-DVVUIKpz.d.ts → stream-bBd_4Ipu.d.ts}

@@ -1,4 +1,4 @@
-import { c as ToolCall, d as ToolResult, e as ToolExecution } from './tool-D22EhP5F.js';
+import { T as ToolCall, a as ToolResult, b as ToolExecution } from './tool-BmAfKNBq.js';
 
 /**
  * @fileoverview Content block types for multimodal messages.
@@ -1002,6 +1002,8 @@ declare const StreamEventType: {
     readonly ToolExecutionStart: "tool_execution_start";
     /** Tool execution has completed */
     readonly ToolExecutionEnd: "tool_execution_end";
+    /** Stream is being retried after an error */
+    readonly StreamRetry: "stream_retry";
     /** Beginning of a message */
     readonly MessageStart: "message_start";
     /** End of a message */
@@ -1035,10 +1037,14 @@ type StreamEventType = (typeof StreamEventType)[keyof typeof StreamEventType];
  * | `tool_call_delta` | `toolCallId`, `toolName`, `argumentsJson` |
  * | `tool_execution_start` | `toolCallId`, `toolName`, `timestamp` |
  * | `tool_execution_end` | `toolCallId`, `toolName`, `result`, `isError`, `timestamp` |
+ * | `stream_retry` | `attempt`, `maxAttempts`, `error`, `timestamp` |
  * | `message_start` | (none) |
  * | `message_stop` | (none) |
  * | `content_block_start` | (none) |
  * | `content_block_stop` | (none) |
+ *
+ * Custom event types (via middleware) may extend EventDelta with additional fields.
+ * See {@link @providerprotocol/ai/middleware/flow!FlowStageDelta} for an example.
  */
 interface EventDelta {
     /** Incremental text content (text_delta, reasoning_delta, object_delta) */
@@ -1055,8 +1061,17 @@ interface EventDelta {
     result?: unknown;
     /** Whether tool execution resulted in an error (tool_execution_end) */
     isError?: boolean;
-    /** Timestamp in milliseconds (tool_execution_start/end) */
+    /** Timestamp in milliseconds (tool_execution_start/end, stream_retry) */
     timestamp?: number;
+    /** Current retry attempt number (stream_retry, 1-indexed) */
+    attempt?: number;
+    /** Maximum number of retry attempts configured (stream_retry) */
+    maxAttempts?: number;
+    /** Error that triggered the retry (stream_retry) - serialized for JSON transport */
+    error?: {
+        message: string;
+        code?: string;
+    };
 }
 /**
  * A single streaming event from the LLM.
@@ -1078,8 +1093,16 @@ interface EventDelta {
  * ```
  */
 interface StreamEvent {
-    /** Event type discriminator */
-    type: StreamEventType;
+    /**
+     * Event type discriminator.
+     *
+     * Uses `StreamEventType | (string & Record<never, never>)` to allow custom
+     * event types (like 'flow_stage') while preserving autocomplete for known types.
+     * The `(string & Record<never, never>)` pattern is a TypeScript idiom that
+     * widens the type to accept any string without losing the literal type union
+     * in IDE autocomplete suggestions.
+     */
+    type: StreamEventType | (string & Record<never, never>);
     /** Index of the content block this event belongs to */
     index: number;
     /** Event-specific data payload */

package/dist/{tool-D22EhP5F.d.ts → tool-BmAfKNBq.d.ts}

@@ -504,4 +504,4 @@ interface ToolExecution {
     approved?: boolean;
 }
 
-export type { AfterCallResult as A, BeforeCallResult as B, JSONSchema as J, Structure as S, ToolInput as T, ZodLike as Z, ZodV4Like as a, Tool as b, ToolCall as c, ToolResult as d, ToolExecution as e, ToolUseStrategy as f, JSONSchemaProperty as g, JSONSchemaPropertyType as h, ZodV3Like as i, ToolMetadata as j };
+export type { AfterCallResult as A, BeforeCallResult as B, JSONSchema as J, Structure as S, ToolCall as T, ZodLike as Z, ToolResult as a, ToolExecution as b, ZodV4Like as c, ToolInput as d, Tool as e, ToolUseStrategy as f, JSONSchemaProperty as g, JSONSchemaPropertyType as h, ZodV3Like as i, ToolMetadata as j };

package/dist/{types-CyXF0J7C.d.ts → types-nTwlpyJE.d.ts}

@@ -1,4 +1,4 @@
-import { S as StreamEvent } from './stream-DVVUIKpz.js';
+import { S as StreamEvent } from './stream-bBd_4Ipu.js';
 
 /**
  * @fileoverview Pub-sub middleware types for stream resumption.
@@ -80,6 +80,18 @@ interface PubSubAdapter {
      * Notifies subscribers and removes stream from storage.
      */
     remove(streamId: string): Promise<void>;
+    /**
+     * Clears all events for a stream without removing it.
+     * Used during retry to reset accumulated state.
+     */
+    clear(streamId: string): Promise<void>;
+    /**
+     * Gets the current cursor base for a stream.
+     * After a clear, cursor base increases so new events have higher cursors
+     * than any events sent before the clear.
+     * @returns Cursor base, or 0 if stream doesn't exist or hasn't been cleared
+     */
+    getCursorBase(streamId: string): number;
 }
 /**
  * Options for pub-sub middleware.

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-import { Z as ZodLike, a as ZodV4Like, J as JSONSchema, T as ToolInput, b as Tool } from '../tool-D22EhP5F.js';
+import { Z as ZodLike, c as ZodV4Like, J as JSONSchema, d as ToolInput, e as Tool } from '../tool-BmAfKNBq.js';
 
 /**
  * @fileoverview Partial JSON parser for streaming LLM responses.
@@ -114,4 +114,68 @@ declare function resolveStructure(structure: JSONSchema | ZodLike): JSONSchema;
  */
 declare function resolveTools(tools: ToolInput[]): Tool[];
 
-export { type PartialParseResult, isZodSchema, isZodV4, parsePartialJson, resolveStructure, resolveTools, zodToJSONSchema, zodToJSONSchemaSync };
+/**
+ * @fileoverview Error normalization utilities.
+ *
+ * @module utils/error
+ */
+/**
+ * Converts an unknown thrown value into an Error instance.
+ *
+ * @param value - Unknown error value
+ * @returns An Error instance
+ */
+declare function toError(value: unknown): Error;
+/**
+ * Checks whether an error represents a cancellation.
+ *
+ * @param value - Unknown error value
+ * @returns True if the error indicates cancellation
+ */
+declare function isCancelledError(value: unknown): boolean;
+
+/**
+ * @fileoverview ID generation utilities for the Universal Provider Protocol.
+ *
+ * Provides functions for generating unique identifiers used throughout UPP,
+ * including message IDs, tool call IDs, and other internal references.
+ *
+ * @module utils/id
+ */
+/**
+ * Generates a unique UUID v4 identifier.
+ *
+ * Uses the native `crypto.randomUUID()` when available for cryptographically
+ * secure randomness. Falls back to a Math.random-based implementation for
+ * environments without Web Crypto API support.
+ *
+ * @returns A UUID v4 string in the format `xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`
+ *
+ * @example
+ * ```typescript
+ * const messageId = generateId();
+ * // => "f47ac10b-58cc-4372-a567-0e02b2c3d479"
+ * ```
+ */
+declare function generateId(): string;
+/**
+ * Generates a short alphanumeric identifier.
+ *
+ * Creates a 12-character random string using alphanumeric characters (a-z, A-Z, 0-9).
+ * Useful for tool call IDs and other cases where a full UUID is not required.
+ *
+ * @param prefix - Optional prefix to prepend to the generated ID
+ * @returns A string containing the prefix followed by 12 random alphanumeric characters
+ *
+ * @example
+ * ```typescript
+ * const toolCallId = generateShortId('call_');
+ * // => "call_aB3xY9mK2pQr"
+ *
+ * const simpleId = generateShortId();
+ * // => "Tz4wN8vL1sHj"
+ * ```
+ */
+declare function generateShortId(prefix?: string): string;
+
+export { type PartialParseResult, generateId, generateShortId, isCancelledError, isZodSchema, isZodV4, parsePartialJson, resolveStructure, resolveTools, toError, zodToJSONSchema, zodToJSONSchemaSync };

package/dist/utils/index.js

@@ -9,12 +9,25 @@ import {
   zodToJSONSchema,
   zodToJSONSchemaSync
 } from "../chunk-3Q5VELKG.js";
+import {
+  generateId,
+  generateShortId
+} from "../chunk-U2G5PHHL.js";
+import {
+  isCancelledError,
+  toError
+} from "../chunk-GIDT7C6I.js";
+import "../chunk-COS4ON4G.js";
 export {
+  generateId,
+  generateShortId,
+  isCancelledError,
   isZodSchema,
   isZodV4,
   parsePartialJson,
   resolveStructure,
   resolveTools,
+  toError,
   zodToJSONSchema,
   zodToJSONSchemaSync
 };

package/dist/xai/index.d.ts

@@ -1,6 +1,6 @@
-import { e as Provider } from '../llm-CZqlijjK.js';
-import '../stream-DVVUIKpz.js';
-import '../tool-D22EhP5F.js';
+import { e as Provider } from '../llm-BWLaTzzY.js';
+import '../stream-bBd_4Ipu.js';
+import '../tool-BmAfKNBq.js';
 
 /**
  * xAI Chat Completions API parameters (OpenAI-compatible).

package/dist/xai/index.js

@@ -9,7 +9,7 @@ import {
 } from "../chunk-TUTYMOBL.js";
 import {
   resolveApiKey
-} from "../chunk-ARVM24K2.js";
+} from "../chunk-EY2LLDGY.js";
 import {
   createProvider
 } from "../chunk-JA3UZALR.js";
@@ -17,18 +17,20 @@ import {
   doFetch,
   doStreamFetch,
   normalizeHttpError
-} from "../chunk-SBGZJVTJ.js";
+} from "../chunk-VQZPADW6.js";
 import {
   StreamEventType,
   objectDelta
-} from "../chunk-MJI74VEJ.js";
+} from "../chunk-F5ENANMJ.js";
 import {
   AssistantMessage,
-  generateId,
   isAssistantMessage,
   isToolResultMessage,
   isUserMessage
-} from "../chunk-WU4U6IHF.js";
+} from "../chunk-6QCV4WXF.js";
+import {
+  generateId
+} from "../chunk-U2G5PHHL.js";
 import {
   toError
 } from "../chunk-GIDT7C6I.js";