@ai-sdk/provider-utils 5.0.15 → 5.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/provider-utils",
-  "version": "5.0.15",
+  "version": "5.0.16",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,

package/src/index.ts

@@ -39,6 +39,7 @@ export { isBuffer } from './is-buffer';
 export { isSameOrigin } from './is-same-origin';
 export { isNonNullable } from './is-non-nullable';
 export { isProviderReference } from './is-provider-reference';
+export { isRecord } from './is-record';
 export { isUrlSupported } from './is-url-supported';
 export * from './load-api-key';
 export { loadOptionalSetting } from './load-optional-setting';

package/src/is-record.ts

@@ -0,0 +1,6 @@
+/**
+ * Checks whether a value is a non-null, non-array object.
+ */
+export function isRecord(value: unknown): value is Record<string, unknown> {
+  return value != null && typeof value === 'object' && !Array.isArray(value);
+}

package/src/transcription-stream-envelope.ts

@@ -2,6 +2,7 @@ import type {
   Experimental_TranscriptionModelV4StreamPart as TranscriptionModelV4StreamPart,
   JSONObject,
 } from '@ai-sdk/provider';
+import { isRecord } from './is-record';
 import { secureJsonParse } from './secure-json-parse';
 
 /**
@@ -240,7 +241,7 @@ export function parseTranscriptionStreamPart(
     case 'transcript-delta':
       return isString(part.delta) &&
         isOptional(part.id, isString) &&
-        isOptional(part.providerMetadata, isPlainObject)
+        isOptional(part.providerMetadata, isRecord)
         ? part
         : undefined;
 
@@ -250,7 +251,7 @@ export function parseTranscriptionStreamPart(
         isOptional(part.startSecond, isNumber) &&
         isOptional(part.durationInSeconds, isNumber) &&
         isOptional(part.channelIndex, isNumber) &&
-        isOptional(part.providerMetadata, isPlainObject)
+        isOptional(part.providerMetadata, isRecord)
         ? part
         : undefined;
 
@@ -260,7 +261,7 @@ export function parseTranscriptionStreamPart(
         isOptional(part.startSecond, isNumber) &&
         isOptional(part.endSecond, isNumber) &&
         isOptional(part.channelIndex, isNumber) &&
-        isOptional(part.providerMetadata, isPlainObject)
+        isOptional(part.providerMetadata, isRecord)
         ? part
         : undefined;
 
@@ -270,7 +271,7 @@ export function parseTranscriptionStreamPart(
         part.segments.every(isSegment) &&
         isOptional(part.language, isString) &&
         isOptional(part.durationInSeconds, isNumber) &&
-        isOptional(part.providerMetadata, isPlainObject)
+        isOptional(part.providerMetadata, isRecord)
         ? part
         : undefined;
 
@@ -278,7 +279,7 @@ export function parseTranscriptionStreamPart(
       if (
         !(
           isOptional(part.modelId, isString) &&
-          isOptional(part.headers, isPlainObject)
+          isOptional(part.headers, isRecord)
         )
       ) {
         return undefined;
@@ -323,19 +324,15 @@ function isOptional(
   return value === undefined || check(value);
 }
 
-function isPlainObject(value: unknown): boolean {
-  return typeof value === 'object' && value != null && !Array.isArray(value);
-}
-
 function isWarning(value: unknown): boolean {
-  return isPlainObject(value) && isString((value as { type?: unknown }).type);
+  return isRecord(value) && isString(value.type);
 }
 
 function isSegment(value: unknown): boolean {
   return (
-    isPlainObject(value) &&
-    isString((value as { text?: unknown }).text) &&
-    isNumber((value as { startSecond?: unknown }).startSecond) &&
-    isNumber((value as { endSecond?: unknown }).endSecond)
+    isRecord(value) &&
+    isString(value.text) &&
+    isNumber(value.startSecond) &&
+    isNumber(value.endSecond)
   );
 }

package/src/types/index.ts

@@ -48,6 +48,12 @@ export {
 export type { ToolApprovalRequest } from './tool-approval-request';
 export type { ToolApprovalResponse } from './tool-approval-response';
 export type { ToolCall } from './tool-call';
+export {
+  getToolCaller as experimental_getToolCaller,
+  toolCaller as experimental_toolCaller,
+  type ToolCallerDefinition as Experimental_ToolCallerDefinition,
+  type ToolCallerTool as Experimental_ToolCallerTool,
+} from './tool-caller';
 export type {
   ToolExecuteFunction,
   ToolExecutionOptions,

package/src/types/tool-caller.ts

@@ -0,0 +1,36 @@
+import type { ProviderOptions } from './provider-options';
+import type { Tool } from './tool';
+import type { ToolSet } from './tool-set';
+
+const toolCallerSymbol = Symbol.for('vercel.ai.experimental.toolCaller');
+
+export type ToolCallerDefinition =
+  | {
+      type: 'local';
+      bind: (tools: ToolSet) => Tool;
+    }
+  | {
+      type: 'provider';
+      prepareProviderOptions: (
+        providerOptions: ProviderOptions | undefined,
+      ) => ProviderOptions;
+    };
+
+export type ToolCallerTool<TOOL extends Tool = Tool> = TOOL & {
+  readonly [toolCallerSymbol]: ToolCallerDefinition;
+};
+
+export function toolCaller<TOOL extends Tool>(
+  tool: TOOL,
+  definition: ToolCallerDefinition,
+): ToolCallerTool<TOOL> {
+  return Object.defineProperty({ ...tool }, toolCallerSymbol, {
+    value: definition,
+  }) as ToolCallerTool<TOOL>;
+}
+
+export function getToolCaller(
+  tool: Tool | undefined,
+): ToolCallerDefinition | undefined {
+  return (tool as ToolCallerTool | undefined)?.[toolCallerSymbol];
+}