@convex-dev/agent 0.6.4 → 0.7.0-alpha.0

package/dist/{client → vercel/client}/definePlaygroundAPI.d.ts

@@ -1,5 +1,6 @@
 import { type ApiFromModules, type GenericActionCtx, type GenericDataModel, type GenericQueryCtx } from "convex/server";
-import { type Agent, type AgentComponent } from "./index.js";
+import type { Agent } from "../index.js";
+import type { AgentComponent } from "./types.js";
 export type PlaygroundAPI = ApiFromModules<{
     playground: ReturnType<typeof definePlaygroundAPI>;
 }>["playground"];
@@ -86,6 +87,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
     }, Promise<{
         streams: import("./types.js").SyncStreamsReturnValue;
         page: {
+            text?: string | undefined;
+            reasoning?: string | undefined;
             id?: string | undefined;
             userId?: string | undefined;
             embeddingId?: string | undefined;
@@ -101,14 +104,17 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 content: string | ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     mediaType?: string | undefined;
                     mimeType?: string | undefined;
                     type: "image";
-                    image: string | ArrayBuffer;
+                    image: string | ArrayBuffer | {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    };
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -116,7 +122,10 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     mimeType?: string | undefined;
                     filename?: string | undefined;
                     type: "file";
-                    data: string | ArrayBuffer;
+                    data: string | ArrayBuffer | {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    };
                 })[];
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -124,8 +133,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 content: string | ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -133,32 +142,51 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     mimeType?: string | undefined;
                     filename?: string | undefined;
                     type: "file";
-                    data: string | ArrayBuffer;
+                    data: string | ArrayBuffer | {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    };
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     signature?: string | undefined;
-                    type: "reasoning";
                     text: string;
+                    type: "reasoning";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    data?: string | ArrayBuffer | undefined;
+                    url?: string | undefined;
+                    type: "reasoning-file";
+                    mediaType: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    type: "custom";
+                    kind: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     type: "redacted-reasoning";
                     data: string;
                 } | {
+                    title?: string | undefined;
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     args?: any;
                     providerExecuted?: boolean | undefined;
+                    toolMetadata?: Record<string, any> | undefined;
                     type: "tool-call";
                     toolCallId: string;
                     toolName: string;
                     input: any;
                 } | {
+                    title?: string | undefined;
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     input?: any;
                     providerExecuted?: boolean | undefined;
+                    toolMetadata?: Record<string, any> | undefined;
                     type: "tool-call";
                     toolCallId: string;
                     toolName: string;
@@ -192,8 +220,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                         type: "content";
                         value: ({
                             providerOptions?: Record<string, Record<string, any>> | undefined;
-                            type: "text";
                             text: string;
+                            type: "text";
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            filename?: string | undefined;
+                            type: "file";
+                            mediaType: string;
+                            data: {
+                                type: "reference";
+                                reference: Record<string, string>;
+                            } | {
+                                type: "url";
+                                url: string;
+                            } | {
+                                type: "data";
+                                data: string | ArrayBuffer;
+                            } | {
+                                text: string;
+                                type: "text";
+                            };
                         } | {
                             type: "media";
                             mediaType: string;
@@ -206,17 +252,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                             data: string;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
+                            mediaType?: string | undefined;
                             type: "file-url";
                             url: string;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "file-id";
                             fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-reference";
+                            providerReference: Record<string, string>;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "image-data";
                             mediaType: string;
                             data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-file-reference";
+                            providerReference: Record<string, string>;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "image-url";
@@ -233,8 +288,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     result?: any;
                     isError?: boolean | undefined;
                     experimental_content?: ({
-                        type: "text";
                         text: string;
+                        type: "text";
                     } | {
                         mimeType?: string | undefined;
                         type: "image";
@@ -263,6 +318,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    signature?: string | undefined;
+                    isAutomatic?: boolean | undefined;
                     type: "tool-approval-request";
                     toolCallId: string;
                     approvalId: string;
@@ -299,8 +356,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                         type: "content";
                         value: ({
                             providerOptions?: Record<string, Record<string, any>> | undefined;
-                            type: "text";
                             text: string;
+                            type: "text";
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            filename?: string | undefined;
+                            type: "file";
+                            mediaType: string;
+                            data: {
+                                type: "reference";
+                                reference: Record<string, string>;
+                            } | {
+                                type: "url";
+                                url: string;
+                            } | {
+                                type: "data";
+                                data: string | ArrayBuffer;
+                            } | {
+                                text: string;
+                                type: "text";
+                            };
                         } | {
                             type: "media";
                             mediaType: string;
@@ -313,17 +388,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                             data: string;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
+                            mediaType?: string | undefined;
                             type: "file-url";
                             url: string;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "file-id";
                             fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-reference";
+                            providerReference: Record<string, string>;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "image-data";
                             mediaType: string;
                             data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-file-reference";
+                            providerReference: Record<string, string>;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "image-url";
@@ -340,8 +424,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     result?: any;
                     isError?: boolean | undefined;
                     experimental_content?: ({
-                        type: "text";
                         text: string;
+                        type: "text";
                     } | {
                         mimeType?: string | undefined;
                         type: "image";
@@ -364,15 +448,17 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 role: "system";
                 content: string;
             } | undefined;
-            text?: string | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            reasoning?: string | undefined;
             usage?: {
+                promptTokens?: number | undefined;
+                completionTokens?: number | undefined;
+                totalTokens?: number | undefined;
                 reasoningTokens?: number | undefined;
                 cachedInputTokens?: number | undefined;
-                promptTokens: number;
-                completionTokens: number;
-                totalTokens: number;
+                nonCachedInputTokens?: number | undefined;
+                cacheWriteInputTokens?: number | undefined;
+                textOutputTokens?: number | undefined;
+                raw?: Record<string, any> | undefined;
             } | undefined;
             sources?: ({
                 title?: string | undefined;
@@ -393,13 +479,25 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 sourceType: "document";
             })[] | undefined;
             warnings?: ({
+                details?: string | undefined;
+                type: "unsupported";
+                feature: string;
+            } | {
+                details?: string | undefined;
+                type: "compatibility";
+                feature: string;
+            } | {
+                type: "deprecated";
+                message: string;
+                setting: string;
+            } | {
                 details?: string | undefined;
                 type: "unsupported-setting";
                 setting: string;
             } | {
                 details?: string | undefined;
-                type: "unsupported-tool";
                 tool: any;
+                type: "unsupported-tool";
             } | {
                 type: "other";
                 message: string;
@@ -409,22 +507,22 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                type: "reasoning";
                 text: string;
+                type: "reasoning";
             } | {
                 signature?: string | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 type: "redacted";
                 data: string;
             })[] | undefined;
+            tool: boolean;
             status: "pending" | "success" | "failed";
             order: number;
             _creationTime: number;
             threadId: string;
             stepOrder: number;
-            tool: boolean;
             _id: string;
         }[];
         isDone: boolean;
@@ -438,7 +536,7 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
         apiKey: string;
     }, Promise<{
         name: string;
-        instructions: string | undefined;
+        instructions: import("ai").Instructions | undefined;
         contextOptions: import("./types.js").ContextOptions | undefined;
         storageOptions: import("./types.js").StorageOptions | undefined;
         maxRetries: number | undefined;
@@ -461,14 +559,17 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 type: "image";
-                image: string | ArrayBuffer;
+                image: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -476,7 +577,10 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -484,8 +588,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -493,32 +597,51 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                type: "reasoning";
                 text: string;
+                type: "reasoning";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                data?: string | ArrayBuffer | undefined;
+                url?: string | undefined;
+                type: "reasoning-file";
+                mediaType: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                type: "custom";
+                kind: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 input: any;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 input?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
@@ -552,8 +675,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -566,17 +707,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -593,8 +743,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -623,6 +773,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
+                isAutomatic?: boolean | undefined;
                 type: "tool-approval-request";
                 toolCallId: string;
                 approvalId: string;
@@ -659,8 +811,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -673,17 +843,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -700,8 +879,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -750,6 +929,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
     }, Promise<{
         text: string;
         messages: {
+            text?: string | undefined;
+            reasoning?: string | undefined;
             id?: string | undefined;
             userId?: string | undefined;
             embeddingId?: string | undefined;
@@ -765,14 +946,17 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 content: string | ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     mediaType?: string | undefined;
                     mimeType?: string | undefined;
                     type: "image";
-                    image: string | ArrayBuffer;
+                    image: string | ArrayBuffer | {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    };
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -780,7 +964,10 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     mimeType?: string | undefined;
                     filename?: string | undefined;
                     type: "file";
-                    data: string | ArrayBuffer;
+                    data: string | ArrayBuffer | {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    };
                 })[];
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -788,8 +975,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 content: string | ({
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -797,32 +984,51 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     mimeType?: string | undefined;
                     filename?: string | undefined;
                     type: "file";
-                    data: string | ArrayBuffer;
+                    data: string | ArrayBuffer | {
+                        type: "reference";
+                        reference: Record<string, string>;
+                    };
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     signature?: string | undefined;
-                    type: "reasoning";
                     text: string;
+                    type: "reasoning";
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    data?: string | ArrayBuffer | undefined;
+                    url?: string | undefined;
+                    type: "reasoning-file";
+                    mediaType: string;
+                } | {
+                    providerOptions?: Record<string, Record<string, any>> | undefined;
+                    providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    type: "custom";
+                    kind: string;
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     type: "redacted-reasoning";
                     data: string;
                 } | {
+                    title?: string | undefined;
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     args?: any;
                     providerExecuted?: boolean | undefined;
+                    toolMetadata?: Record<string, any> | undefined;
                     type: "tool-call";
                     toolCallId: string;
                     toolName: string;
                     input: any;
                 } | {
+                    title?: string | undefined;
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
                     input?: any;
                     providerExecuted?: boolean | undefined;
+                    toolMetadata?: Record<string, any> | undefined;
                     type: "tool-call";
                     toolCallId: string;
                     toolName: string;
@@ -856,8 +1062,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                         type: "content";
                         value: ({
                             providerOptions?: Record<string, Record<string, any>> | undefined;
-                            type: "text";
                             text: string;
+                            type: "text";
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            filename?: string | undefined;
+                            type: "file";
+                            mediaType: string;
+                            data: {
+                                type: "reference";
+                                reference: Record<string, string>;
+                            } | {
+                                type: "url";
+                                url: string;
+                            } | {
+                                type: "data";
+                                data: string | ArrayBuffer;
+                            } | {
+                                text: string;
+                                type: "text";
+                            };
                         } | {
                             type: "media";
                             mediaType: string;
@@ -870,17 +1094,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                             data: string;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
+                            mediaType?: string | undefined;
                             type: "file-url";
                             url: string;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "file-id";
                             fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-reference";
+                            providerReference: Record<string, string>;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "image-data";
                             mediaType: string;
                             data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-file-reference";
+                            providerReference: Record<string, string>;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "image-url";
@@ -897,8 +1130,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     result?: any;
                     isError?: boolean | undefined;
                     experimental_content?: ({
-                        type: "text";
                         text: string;
+                        type: "text";
                     } | {
                         mimeType?: string | undefined;
                         type: "image";
@@ -927,6 +1160,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 } | {
                     providerOptions?: Record<string, Record<string, any>> | undefined;
                     providerMetadata?: Record<string, Record<string, any>> | undefined;
+                    signature?: string | undefined;
+                    isAutomatic?: boolean | undefined;
                     type: "tool-approval-request";
                     toolCallId: string;
                     approvalId: string;
@@ -963,8 +1198,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                         type: "content";
                         value: ({
                             providerOptions?: Record<string, Record<string, any>> | undefined;
-                            type: "text";
                             text: string;
+                            type: "text";
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            filename?: string | undefined;
+                            type: "file";
+                            mediaType: string;
+                            data: {
+                                type: "reference";
+                                reference: Record<string, string>;
+                            } | {
+                                type: "url";
+                                url: string;
+                            } | {
+                                type: "data";
+                                data: string | ArrayBuffer;
+                            } | {
+                                text: string;
+                                type: "text";
+                            };
                         } | {
                             type: "media";
                             mediaType: string;
@@ -977,17 +1230,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                             data: string;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
+                            mediaType?: string | undefined;
                             type: "file-url";
                             url: string;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "file-id";
                             fileId: string | Record<string, string>;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "file-reference";
+                            providerReference: Record<string, string>;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "image-data";
                             mediaType: string;
                             data: string;
+                        } | {
+                            providerOptions?: Record<string, Record<string, any>> | undefined;
+                            type: "image-file-reference";
+                            providerReference: Record<string, string>;
                         } | {
                             providerOptions?: Record<string, Record<string, any>> | undefined;
                             type: "image-url";
@@ -1004,8 +1266,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     result?: any;
                     isError?: boolean | undefined;
                     experimental_content?: ({
-                        type: "text";
                         text: string;
+                        type: "text";
                     } | {
                         mimeType?: string | undefined;
                         type: "image";
@@ -1028,15 +1290,17 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 role: "system";
                 content: string;
             } | undefined;
-            text?: string | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
-            reasoning?: string | undefined;
             usage?: {
+                promptTokens?: number | undefined;
+                completionTokens?: number | undefined;
+                totalTokens?: number | undefined;
                 reasoningTokens?: number | undefined;
                 cachedInputTokens?: number | undefined;
-                promptTokens: number;
-                completionTokens: number;
-                totalTokens: number;
+                nonCachedInputTokens?: number | undefined;
+                cacheWriteInputTokens?: number | undefined;
+                textOutputTokens?: number | undefined;
+                raw?: Record<string, any> | undefined;
             } | undefined;
             sources?: ({
                 title?: string | undefined;
@@ -1057,13 +1321,25 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 sourceType: "document";
             })[] | undefined;
             warnings?: ({
+                details?: string | undefined;
+                type: "unsupported";
+                feature: string;
+            } | {
+                details?: string | undefined;
+                type: "compatibility";
+                feature: string;
+            } | {
+                type: "deprecated";
+                message: string;
+                setting: string;
+            } | {
                 details?: string | undefined;
                 type: "unsupported-setting";
                 setting: string;
             } | {
                 details?: string | undefined;
-                type: "unsupported-tool";
                 tool: any;
+                type: "unsupported-tool";
             } | {
                 type: "other";
                 message: string;
@@ -1073,22 +1349,22 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                type: "reasoning";
                 text: string;
+                type: "reasoning";
             } | {
                 signature?: string | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 type: "redacted";
                 data: string;
             })[] | undefined;
+            tool: boolean;
             status: "pending" | "success" | "failed";
             order: number;
             _creationTime: number;
             threadId: string;
             stepOrder: number;
-            tool: boolean;
             _id: string;
         }[];
     }>>;
@@ -1101,14 +1377,17 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 type: "image";
-                image: string | ArrayBuffer;
+                image: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1116,7 +1395,10 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -1124,8 +1406,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1133,32 +1415,51 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                type: "reasoning";
                 text: string;
+                type: "reasoning";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                data?: string | ArrayBuffer | undefined;
+                url?: string | undefined;
+                type: "reasoning-file";
+                mediaType: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                type: "custom";
+                kind: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 input: any;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 input?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
@@ -1192,8 +1493,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -1206,17 +1525,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -1233,8 +1561,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1263,6 +1591,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
+                isAutomatic?: boolean | undefined;
                 type: "tool-approval-request";
                 toolCallId: string;
                 approvalId: string;
@@ -1299,8 +1629,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -1313,17 +1661,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -1340,8 +1697,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1385,6 +1742,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
         };
         apiKey: string;
     }, Promise<{
+        text?: string | undefined;
+        reasoning?: string | undefined;
         id?: string | undefined;
         userId?: string | undefined;
         embeddingId?: string | undefined;
@@ -1400,14 +1759,17 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 mediaType?: string | undefined;
                 mimeType?: string | undefined;
                 type: "image";
-                image: string | ArrayBuffer;
+                image: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1415,7 +1777,10 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             })[];
         } | {
             providerOptions?: Record<string, Record<string, any>> | undefined;
@@ -1423,8 +1788,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             content: string | ({
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
-                type: "text";
                 text: string;
+                type: "text";
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
@@ -1432,32 +1797,51 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 mimeType?: string | undefined;
                 filename?: string | undefined;
                 type: "file";
-                data: string | ArrayBuffer;
+                data: string | ArrayBuffer | {
+                    type: "reference";
+                    reference: Record<string, string>;
+                };
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 signature?: string | undefined;
-                type: "reasoning";
                 text: string;
+                type: "reasoning";
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                data?: string | ArrayBuffer | undefined;
+                url?: string | undefined;
+                type: "reasoning-file";
+                mediaType: string;
+            } | {
+                providerOptions?: Record<string, Record<string, any>> | undefined;
+                providerMetadata?: Record<string, Record<string, any>> | undefined;
+                type: "custom";
+                kind: string;
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 type: "redacted-reasoning";
                 data: string;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 args?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
                 input: any;
             } | {
+                title?: string | undefined;
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
                 input?: any;
                 providerExecuted?: boolean | undefined;
+                toolMetadata?: Record<string, any> | undefined;
                 type: "tool-call";
                 toolCallId: string;
                 toolName: string;
@@ -1491,8 +1875,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -1505,17 +1907,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -1532,8 +1943,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1562,6 +1973,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             } | {
                 providerOptions?: Record<string, Record<string, any>> | undefined;
                 providerMetadata?: Record<string, Record<string, any>> | undefined;
+                signature?: string | undefined;
+                isAutomatic?: boolean | undefined;
                 type: "tool-approval-request";
                 toolCallId: string;
                 approvalId: string;
@@ -1598,8 +2011,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                     type: "content";
                     value: ({
                         providerOptions?: Record<string, Record<string, any>> | undefined;
-                        type: "text";
                         text: string;
+                        type: "text";
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        filename?: string | undefined;
+                        type: "file";
+                        mediaType: string;
+                        data: {
+                            type: "reference";
+                            reference: Record<string, string>;
+                        } | {
+                            type: "url";
+                            url: string;
+                        } | {
+                            type: "data";
+                            data: string | ArrayBuffer;
+                        } | {
+                            text: string;
+                            type: "text";
+                        };
                     } | {
                         type: "media";
                         mediaType: string;
@@ -1612,17 +2043,26 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                         data: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
+                        mediaType?: string | undefined;
                         type: "file-url";
                         url: string;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "file-id";
                         fileId: string | Record<string, string>;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-data";
                         mediaType: string;
                         data: string;
+                    } | {
+                        providerOptions?: Record<string, Record<string, any>> | undefined;
+                        type: "image-file-reference";
+                        providerReference: Record<string, string>;
                     } | {
                         providerOptions?: Record<string, Record<string, any>> | undefined;
                         type: "image-url";
@@ -1639,8 +2079,8 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
                 result?: any;
                 isError?: boolean | undefined;
                 experimental_content?: ({
-                    type: "text";
                     text: string;
+                    type: "text";
                 } | {
                     mimeType?: string | undefined;
                     type: "image";
@@ -1663,15 +2103,17 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             role: "system";
             content: string;
         } | undefined;
-        text?: string | undefined;
         providerMetadata?: Record<string, Record<string, any>> | undefined;
-        reasoning?: string | undefined;
         usage?: {
+            promptTokens?: number | undefined;
+            completionTokens?: number | undefined;
+            totalTokens?: number | undefined;
             reasoningTokens?: number | undefined;
             cachedInputTokens?: number | undefined;
-            promptTokens: number;
-            completionTokens: number;
-            totalTokens: number;
+            nonCachedInputTokens?: number | undefined;
+            cacheWriteInputTokens?: number | undefined;
+            textOutputTokens?: number | undefined;
+            raw?: Record<string, any> | undefined;
         } | undefined;
         sources?: ({
             title?: string | undefined;
@@ -1692,13 +2134,25 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             sourceType: "document";
         })[] | undefined;
         warnings?: ({
+            details?: string | undefined;
+            type: "unsupported";
+            feature: string;
+        } | {
+            details?: string | undefined;
+            type: "compatibility";
+            feature: string;
+        } | {
+            type: "deprecated";
+            message: string;
+            setting: string;
+        } | {
             details?: string | undefined;
             type: "unsupported-setting";
             setting: string;
         } | {
             details?: string | undefined;
-            type: "unsupported-tool";
             tool: any;
+            type: "unsupported-tool";
         } | {
             type: "other";
             message: string;
@@ -1708,22 +2162,22 @@ export declare function definePlaygroundAPI<DataModel extends GenericDataModel>(
             providerOptions?: Record<string, Record<string, any>> | undefined;
             providerMetadata?: Record<string, Record<string, any>> | undefined;
             signature?: string | undefined;
-            type: "reasoning";
             text: string;
+            type: "reasoning";
         } | {
             signature?: string | undefined;
-            type: "text";
             text: string;
+            type: "text";
         } | {
             type: "redacted";
             data: string;
         })[] | undefined;
+        tool: boolean;
         status: "pending" | "success" | "failed";
         order: number;
         _creationTime: number;
         threadId: string;
         stepOrder: number;
-        tool: boolean;
         _id: string;
     }[]>>;
 };