@ai-sdk/provider-utils 5.0.12 → 5.0.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/provider-utils",
-  "version": "5.0.12",
+  "version": "5.0.14",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -35,7 +35,7 @@
     "@standard-schema/spec": "^1.1.0",
     "@workflow/serde": "4.1.0",
     "eventsource-parser": "^3.0.8",
-    "@ai-sdk/provider": "4.0.3"
+    "@ai-sdk/provider": "4.0.4"
   },
   "devDependencies": {
     "@types/node": "22.19.19",

package/src/connect-to-websocket.ts

@@ -46,7 +46,11 @@ export function connectToWebSocket({
   /** Constructor throws and message decoding/processing failures. */
   onProcessingError: (error: unknown) => void;
   onSocketError?: () => void;
-  onClose?: () => void;
+  /**
+   * Receives the close code and reason when the transport provides them
+   * (native `CloseEvent` / `ws` close event).
+   */
+  onClose?: (info: { code?: number; reason?: string }) => void;
   /** Also called (without opening a socket) when the signal is already aborted. */
   onAbort?: (reason: unknown) => void;
 }): WebSocketConnection {
@@ -108,8 +112,20 @@ export function connectToWebSocket({
   socket.onerror = () => {
     tail = tail.then(() => onSocketError?.()).catch(onProcessingError);
   };
-  socket.onclose = () => {
-    tail = tail.then(() => onClose?.()).catch(onProcessingError);
+  socket.onclose = event => {
+    // Extract close diagnostics when the transport provides them (native
+    // `CloseEvent` and `ws` both carry `code` and `reason`).
+    const closeEvent = event as
+      | { code?: unknown; reason?: unknown }
+      | null
+      | undefined;
+    const code =
+      typeof closeEvent?.code === 'number' ? closeEvent.code : undefined;
+    const reason =
+      typeof closeEvent?.reason === 'string' ? closeEvent.reason : undefined;
+    tail = tail
+      .then(() => onClose?.({ code, reason }))
+      .catch(onProcessingError);
   };
 
   return { socket, close };

package/src/index.ts

@@ -88,6 +88,7 @@ export {
   type ValidationResult,
 } from './schema';
 export { serializeModelOptions } from './serialize-model-options';
+export { SerializationError } from './serialization-error';
 export { secureJsonParse } from './secure-json-parse';
 export {
   StreamingToolCallTracker,

package/src/serialization-error.ts

@@ -0,0 +1,23 @@
+import { AISDKError } from '@ai-sdk/provider';
+
+const name = 'AI_SerializationError';
+const marker = `vercel.ai.error.${name}`;
+const symbol = Symbol.for(marker);
+
+export class SerializationError extends AISDKError {
+  private readonly [symbol] = true; // used in isInstance
+
+  constructor({
+    message = 'Failed to serialize value.',
+    cause,
+  }: {
+    message?: string;
+    cause?: unknown;
+  } = {}) {
+    super({ name, message, cause });
+  }
+
+  static isInstance(error: unknown): error is SerializationError {
+    return AISDKError.hasMarker(error, marker);
+  }
+}

package/src/serialize-model-options.ts

@@ -1,6 +1,7 @@
 import type { JSONObject } from '@ai-sdk/provider';
 import { isJSONSerializable } from './is-json-serializable';
 import type { Resolvable } from './resolve';
+import { SerializationError } from './serialization-error';
 
 /**
  * Serializes a model instance for workflow step boundaries.
@@ -53,10 +54,10 @@ function resolveSync<T>(value: Resolvable<T>): T {
     next = (value as () => unknown)();
   }
 
-  // the serialization for workflows currently only supports synchronous values
-  // TODO introduce SerializationError
   if (next instanceof Promise) {
-    throw new Error('Promise returned from resolveSync');
+    throw new SerializationError({
+      message: 'Cannot serialize asynchronous model options.',
+    });
   }
 
   return next as T;