@od-oneapp/ai-platform 0.1.0

package/src/internal/shared/ai-types.ts

@@ -0,0 +1,942 @@
+/**
+ * @fileoverview Central AI SDK v6 type and function re-exports.
+ * @module @od-oneapp/ai-platform/shared
+ *
+ * This module serves as the canonical source for ALL SDK types and functions
+ * used throughout the ai-platform package. Import SDK types and functions from
+ * here instead of directly from 'ai' to ensure consistency and simplify future
+ * SDK updates.
+ *
+ * @example
+ * ```ts
+ * // ✅ Correct - use SDK* prefix
+ * import type { SDKTextPart, SDKToolCallPart, SDKLanguageModel } from '@od-oneapp/ai-platform/shared';
+ * import { tool, generateText, streamText } from '@od-oneapp/ai-platform/shared';
+ *
+ * // ❌ Wrong - don't import directly from 'ai'
+ * import { tool, generateText, type Tool } from 'ai';
+ * ```
+ */
+
+// =============================================================================
+// PART 1: TYPE-ONLY IMPORTS FROM AI SDK
+// =============================================================================
+
+import { NoObjectGeneratedError } from 'ai';
+
+import type {
+  // Provider V3 Model Interface Types
+  LanguageModelV3,
+  LanguageModelV3Middleware,
+  EmbeddingModelV3,
+  EmbeddingModelV3Middleware,
+  ImageModelV3,
+  ImageModelV3Middleware,
+  SpeechModelV3,
+  TranscriptionModelV3,
+  RerankingModelV3,
+  ProviderV3,
+
+  // Provider V3 Operation Types
+  LanguageModelV3CallOptions,
+  LanguageModelV3Content,
+  LanguageModelV3GenerateResult,
+  LanguageModelV3Message,
+  LanguageModelV3Prompt,
+  LanguageModelV3StreamPart,
+  LanguageModelV3ToolResult,
+  LanguageModelV3ToolResultOutput,
+  LanguageModelV3ToolCall,
+  LanguageModelV3Source,
+  SharedV3Warning,
+  SharedV3ProviderMetadata,
+  EmbeddingModelV3Embedding,
+  EmbeddingModelV3CallOptions,
+
+  // Experimental Types
+  Experimental_VideoModelV3,
+} from '@ai-sdk/provider';
+import type { Output as OutputNamespace ,
+  // Core Model Types (v6)
+  LanguageModel,
+  LanguageModelUsage,
+  LanguageModelMiddleware,
+  LanguageModelRequestMetadata,
+  LanguageModelResponseMetadata,
+
+  // Embedding Types (v6)
+  EmbeddingModel,
+  Embedding,
+  EmbeddingModelMiddleware,
+  EmbeddingModelUsage,
+
+  // Image Types (v6)
+  ImageModel,
+  ImageModelMiddleware,
+  ImageModelProviderMetadata,
+  ImageModelResponseMetadata,
+  ImageModelUsage,
+
+  // Speech & Transcription Types (v6)
+  SpeechModel,
+  SpeechModelResponseMetadata,
+  TranscriptionModel,
+  TranscriptionModelResponseMetadata,
+
+  // Reranking Types
+  RerankingModel,
+
+  // Message Part Types (from @ai-sdk/provider-utils)
+  TextPart,
+  ImagePart,
+  FilePart,
+  ToolCallPart,
+  ToolResultPart,
+  ToolApprovalRequest,
+  ToolApprovalResponse,
+
+  // Tool Types
+  Tool,
+  ToolSet,
+  ToolChoice,
+  ToolExecuteFunction,
+  ToolExecutionOptions,
+  InferToolInput,
+  InferToolOutput,
+  FlexibleSchema,
+  InferSchema,
+  Schema,
+
+  // Message Types
+  ModelMessage,
+  SystemModelMessage,
+  UserModelMessage,
+  AssistantModelMessage,
+  ToolModelMessage,
+  AssistantContent,
+  UserContent,
+  ToolContent,
+  DataContent,
+
+  // UI Types
+  UIMessage,
+  UIMessagePart,
+  UIMessageChunk,
+  UIMessageStreamWriter,
+  UIMessageStreamOptions,
+  UIMessageStreamOnFinishCallback,
+  UIMessageStreamError,
+  UITool,
+  UITools,
+  UIToolInvocation,
+  InferUITool,
+  InferUITools,
+  InferUIMessageChunk,
+  InferUIDataParts,
+  TextUIPart,
+  FileUIPart,
+  DataUIPart,
+  ToolUIPart,
+  ReasoningUIPart,
+  StepStartUIPart,
+  SourceUrlUIPart,
+  SourceDocumentUIPart,
+  UIDataPartSchemas,
+  UIDataTypes,
+  CreateUIMessage,
+
+  // Agent Types (Experimental)
+  ToolLoopAgent,
+  ToolLoopAgentSettings,
+  ToolLoopAgentOnFinishCallback,
+  ToolLoopAgentOnStepFinishCallback,
+  InferAgentUIMessage,
+  Agent,
+  AgentCallParameters,
+  AgentStreamParameters,
+
+  // Result Types
+  GenerateTextResult,
+  GenerateTextOnFinishCallback,
+  GenerateTextOnStepFinishCallback,
+  StreamTextResult,
+  StreamTextOnChunkCallback,
+  StreamTextOnErrorCallback,
+  StreamTextOnFinishCallback,
+  StreamTextOnStepFinishCallback,
+  StreamTextTransform,
+  GenerateObjectResult,
+  StreamObjectResult,
+  StreamObjectOnFinishCallback,
+  ObjectStreamPart,
+  EmbedResult,
+  EmbedManyResult,
+  RerankResult,
+  GenerateImageResult,
+  GeneratedFile,
+  GeneratedAudioFile,
+  GenerateVideoResult,
+  GenerateVideoPrompt,
+
+  // Step Types
+  StepResult,
+  StopCondition,
+  PrepareStepFunction,
+  PrepareStepResult,
+
+  // Transport Types
+  ChatTransport,
+  DefaultChatTransport,
+  HttpChatTransport,
+  HttpChatTransportInitOptions,
+  DirectChatTransport,
+  DirectChatTransportOptions,
+  TextStreamChatTransport,
+  ChatRequestOptions,
+  CompletionRequestOptions,
+  ChatState,
+  ChatStatus,
+  ChatInit,
+  ChatOnDataCallback,
+  ChatOnErrorCallback,
+  ChatOnFinishCallback,
+  ChatOnToolCallCallback,
+  ChatAddToolApproveResponseFunction,
+  PrepareReconnectToStreamRequest,
+  PrepareSendMessagesRequest,
+  AbstractChat,
+
+  // Tool Call Types
+  StaticToolCall,
+  StaticToolError,
+  StaticToolResult,
+  StaticToolOutputDenied,
+  DynamicToolCall,
+  DynamicToolError,
+  DynamicToolResult,
+  TypedToolCall,
+  TypedToolError,
+  TypedToolResult,
+  TypedToolOutputDenied,
+  ToolApprovalRequestOutput,
+
+  // Stream Types
+  TextStreamPart,
+  AsyncIterableStream,
+
+  // Telemetry Types
+  TelemetrySettings,
+
+  // Provider Types
+  Provider,
+  ProviderMetadata,
+  ProviderRegistryProvider,
+
+  // Settings Types
+  CallSettings,
+  CallWarning,
+  Warning,
+  TimeoutConfiguration,
+
+  // Utility Types
+  JSONValue as AI_JSONValue,
+  JSONSchema7 as AI_JSONSchema7,
+  ContentPart,
+  DeepPartial as AI_DeepPartial,
+  ChunkDetector,
+
+  // Completion Types (legacy naming)
+  UseCompletionOptions,
+
+  // Validation Types
+  SafeValidateUIMessagesResult,
+
+  // Error Handlers
+  ErrorHandler,
+  LogWarningsFunction,
+  RepairTextFunction,
+  ToolCallRepairFunction,
+} from 'ai';
+
+
+// Import NoObjectGeneratedError as a value (not type-only) for error handling
+
+
+// =============================================================================
+// PART 2: RUNTIME FUNCTION EXPORTS FROM AI SDK
+// =============================================================================
+
+export {
+  // Gateway
+  gateway,
+  createGateway,
+
+  // Core Generation Functions
+  generateText,
+  streamText,
+  generateObject,
+  streamObject,
+
+  // Embedding Functions
+  embed,
+  embedMany,
+
+  // Image Generation
+  generateImage,
+
+  // Reranking
+  rerank,
+
+  // Tool Functions
+  tool,
+  dynamicTool,
+
+  // Agent Functions
+  ToolLoopAgent,
+  createAgentUIStream,
+  createAgentUIStreamResponse,
+
+  // Message Conversion Functions
+  convertToModelMessages,
+  convertFileListToFileUIParts,
+
+  // UI Stream Functions
+  createUIMessageStream,
+  createUIMessageStreamResponse,
+  createTextStreamResponse,
+  pipeUIMessageStreamToResponse,
+  pipeTextStreamToResponse,
+  pipeAgentUIStreamToResponse,
+  readUIMessageStream,
+
+  // Middleware Functions
+  wrapLanguageModel,
+  wrapEmbeddingModel,
+  wrapImageModel,
+  wrapProvider,
+  addToolInputExamplesMiddleware,
+  extractReasoningMiddleware,
+  extractJsonMiddleware,
+  defaultSettingsMiddleware,
+  defaultEmbeddingSettingsMiddleware,
+  simulateStreamingMiddleware,
+
+  // Stream Utilities
+  smoothStream,
+  simulateReadableStream,
+  consumeStream,
+
+  // Provider Registry
+  createProviderRegistry,
+  customProvider,
+
+  // Validation Functions
+  validateUIMessages,
+  safeValidateUIMessages,
+
+  // Utility Functions
+  generateId,
+  createIdGenerator,
+  cosineSimilarity,
+  parsePartialJson,
+  getTextFromDataUrl,
+
+  // Tool Helpers
+  getToolName,
+  getStaticToolName,
+  getToolOrDynamicToolName,
+  hasToolCall,
+
+  // Type Guards
+  isTextUIPart,
+  isFileUIPart,
+  isDataUIPart,
+  isToolUIPart,
+  isReasoningUIPart,
+  isToolOrDynamicToolUIPart,
+  isDeepEqualData,
+
+  // Message Helpers
+  lastAssistantMessageIsCompleteWithToolCalls,
+  lastAssistantMessageIsCompleteWithApprovalResponses,
+  pruneMessages,
+
+  // Schema Functions
+  asSchema,
+  jsonSchema,
+  zodSchema,
+
+  // Stop Conditions
+  stepCountIs,
+
+  // Output API
+  Output,
+
+  // Completion API
+  callCompletionApi,
+
+  // Stream Transformers
+  JsonToSseTransformStream,
+  parseJsonEventStream,
+
+  // Headers
+  UI_MESSAGE_STREAM_HEADERS,
+
+  // Schemas
+  assistantModelMessageSchema,
+  systemModelMessageSchema,
+  userModelMessageSchema,
+  toolModelMessageSchema,
+  modelMessageSchema,
+  uiMessageChunkSchema,
+
+  // Job Executor
+  SerialJobExecutor,
+
+  // Experimental Functions (prefixed)
+  experimental_createProviderRegistry,
+  experimental_customProvider,
+  experimental_generateSpeech,
+  experimental_generateVideo,
+  experimental_transcribe,
+} from 'ai';
+
+// =============================================================================
+// PART 3: SDK-PREFIXED TYPE EXPORTS
+// =============================================================================
+
+// Language Model Types (v6)
+export type SDKLanguageModel = LanguageModel;
+export type SDKLanguageModelV3 = LanguageModelV3;
+export type SDKLanguageModelUsage = LanguageModelUsage;
+export type SDKLanguageModelMiddleware = LanguageModelMiddleware;
+export type SDKLanguageModelV3Middleware = LanguageModelV3Middleware;
+export type SDKLanguageModelRequestMetadata = LanguageModelRequestMetadata;
+export type SDKLanguageModelResponseMetadata = LanguageModelResponseMetadata;
+export type SDKLanguageModelV3CallOptions = LanguageModelV3CallOptions;
+export type SDKLanguageModelV3Content = LanguageModelV3Content;
+export type SDKLanguageModelV3GenerateResult = LanguageModelV3GenerateResult;
+export type SDKLanguageModelV3Message = LanguageModelV3Message;
+export type SDKLanguageModelV3Prompt = LanguageModelV3Prompt;
+export type SDKLanguageModelV3StreamPart = LanguageModelV3StreamPart;
+export type SDKLanguageModelV3ToolResult = LanguageModelV3ToolResult;
+export type SDKLanguageModelV3ToolResultOutput = LanguageModelV3ToolResultOutput;
+export type SDKLanguageModelV3ToolCall = LanguageModelV3ToolCall;
+export type SDKLanguageModelV3Source = LanguageModelV3Source;
+
+// Embedding Types (v6)
+export type SDKEmbeddingModel = EmbeddingModel;
+export type SDKEmbeddingModelV3 = EmbeddingModelV3;
+export type SDKEmbedding = Embedding;
+export type SDKEmbeddingModelMiddleware = EmbeddingModelMiddleware;
+export type SDKEmbeddingModelV3Middleware = EmbeddingModelV3Middleware;
+export type SDKEmbeddingModelUsage = EmbeddingModelUsage;
+export type SDKEmbeddingModelV3Embedding = EmbeddingModelV3Embedding;
+export type SDKEmbeddingModelV3CallOptions = EmbeddingModelV3CallOptions;
+
+// Image Types (v6)
+export type SDKImageModel = ImageModel;
+export type SDKImageModelV3 = ImageModelV3;
+export type SDKImageModelMiddleware = ImageModelMiddleware;
+export type SDKImageModelV3Middleware = ImageModelV3Middleware;
+export type SDKImageModelProviderMetadata = ImageModelProviderMetadata;
+export type SDKImageModelResponseMetadata = ImageModelResponseMetadata;
+export type SDKImageModelUsage = ImageModelUsage;
+
+// Speech & Transcription Types (v6)
+export type SDKSpeechModel = SpeechModel;
+export type SDKSpeechModelV3 = SpeechModelV3;
+export type SDKSpeechModelResponseMetadata = SpeechModelResponseMetadata;
+export type SDKTranscriptionModel = TranscriptionModel;
+export type SDKTranscriptionModelV3 = TranscriptionModelV3;
+export type SDKTranscriptionModelResponseMetadata = TranscriptionModelResponseMetadata;
+
+// Reranking Types
+export type SDKRerankingModel = RerankingModel;
+export type SDKRerankingModelV3 = RerankingModelV3;
+
+// Message Part Types
+export type SDKTextPart = TextPart;
+export type SDKImagePart = ImagePart;
+export type SDKFilePart = FilePart;
+export type SDKToolCallPart = ToolCallPart;
+export type SDKToolResultPart = ToolResultPart;
+export type SDKToolResultOutput = ToolResultPart['output'];
+export type SDKToolApprovalRequest = ToolApprovalRequest;
+export type SDKToolApprovalResponse = ToolApprovalResponse;
+
+// Tool Types
+export type SDKTool<TInput = any, TOutput = any> = Tool<TInput, TOutput>;
+export type SDKToolSet = ToolSet;
+export type SDKToolChoice<TTools extends ToolSet = ToolSet> = ToolChoice<TTools>;
+export type SDKToolExecuteFunction<TParams = unknown, TResult = unknown> = ToolExecuteFunction<
+  TParams,
+  TResult
+>;
+export type SDKToolExecutionOptions = ToolExecutionOptions;
+export type SDKInferToolInput<T extends Tool> = InferToolInput<T>;
+export type SDKInferToolOutput<T extends Tool> = InferToolOutput<T>;
+export type SDKFlexibleSchema = FlexibleSchema;
+export type SDKInferSchema<T> = InferSchema<T>;
+export type SDKSchema<T> = Schema<T>;
+
+// Message Types
+export type SDKModelMessage = ModelMessage;
+export type SDKSystemMessage = SystemModelMessage;
+export type SDKSystemModelMessage = SystemModelMessage;
+export type SDKUserMessage = UserModelMessage;
+export type SDKUserModelMessage = UserModelMessage;
+export type SDKAssistantMessage = AssistantModelMessage;
+export type SDKAssistantModelMessage = AssistantModelMessage;
+export type SDKToolMessage = ToolModelMessage;
+export type SDKToolModelMessage = ToolModelMessage;
+export type SDKAssistantContent = AssistantContent;
+export type SDKUserContent = UserContent;
+export type SDKToolContent = ToolContent;
+export type SDKDataContent = DataContent;
+
+// UI Types
+export type SDKUIMessage<
+  METADATA = unknown,
+  DATA_PARTS extends UIDataTypes = UIDataTypes,
+  TOOLS extends UITools = UITools,
+> = UIMessage<METADATA, DATA_PARTS, TOOLS>;
+export type SDKUIMessagePart<
+  DATA_PARTS extends UIDataTypes = UIDataTypes,
+  TOOLS extends UITools = UITools,
+> = UIMessagePart<DATA_PARTS, TOOLS>;
+export type SDKUIMessageChunk = UIMessageChunk;
+export type SDKUIMessageStreamWriter<TMessage extends UIMessage = UIMessage> =
+  UIMessageStreamWriter<TMessage>;
+export type SDKUIMessageStreamOptions<UI_MESSAGE extends UIMessage = UIMessage> =
+  UIMessageStreamOptions<UI_MESSAGE>;
+export type SDKUIMessageStreamOnFinishCallback<UI_MESSAGE extends UIMessage = UIMessage> =
+  UIMessageStreamOnFinishCallback<UI_MESSAGE>;
+export type SDKUIMessageStreamError = UIMessageStreamError;
+export type SDKUITool = UITool;
+export type SDKUITools = UITools;
+export type SDKUIToolInvocation<TOOLS extends Tool | UITool = Tool> = UIToolInvocation<TOOLS>;
+export type SDKInferUITool<T extends Tool = Tool> = InferUITool<T>;
+export type SDKInferUITools<T extends ToolSet = ToolSet> = InferUITools<T>;
+export type SDKInferUIMessageChunk<T extends UIMessage = UIMessage> = InferUIMessageChunk<T>;
+export type SDKInferUIDataParts<T extends UIDataPartSchemas = UIDataPartSchemas> =
+  InferUIDataParts<T>;
+export type SDKTextUIPart = TextUIPart;
+export type SDKFileUIPart = FileUIPart;
+export type SDKDataUIPart<DATA_PARTS extends UIDataTypes = UIDataTypes> = DataUIPart<DATA_PARTS>;
+export type SDKToolUIPart<TOOLS extends UITools = UITools> = ToolUIPart<TOOLS>;
+export type SDKReasoningUIPart = ReasoningUIPart;
+export type SDKStepStartUIPart = StepStartUIPart;
+export type SDKSourceUrlUIPart = SourceUrlUIPart;
+export type SDKSourceDocumentUIPart = SourceDocumentUIPart;
+export type SDKUIDataPartSchemas = UIDataPartSchemas;
+export type SDKUIDataTypes = UIDataTypes;
+export type SDKCreateUIMessage<UI_MESSAGE extends UIMessage = UIMessage> =
+  CreateUIMessage<UI_MESSAGE>;
+
+// Agent Types
+export type SDKToolLoopAgent<TTools extends ToolSet = ToolSet> = ToolLoopAgent<TTools>;
+export type SDKToolLoopAgentSettings<TTools extends ToolSet = ToolSet> =
+  ToolLoopAgentSettings<TTools>;
+export type SDKToolLoopAgentOnFinishCallback<TTools extends ToolSet = ToolSet> =
+  ToolLoopAgentOnFinishCallback<TTools>;
+export type SDKToolLoopAgentOnStepFinishCallback<TTools extends ToolSet = ToolSet> =
+  ToolLoopAgentOnStepFinishCallback<TTools>;
+export type SDKInferAgentUIMessage<TTools extends ToolSet = ToolSet> = InferAgentUIMessage<TTools>;
+export type SDKAgent = Agent;
+export type SDKAgentCallParameters<
+  CALL_OPTIONS = never,
+  TOOLS extends ToolSet = ToolSet,
+> = AgentCallParameters<CALL_OPTIONS, TOOLS>;
+export type SDKAgentStreamParameters<
+  CALL_OPTIONS = never,
+  TOOLS extends ToolSet = ToolSet,
+> = AgentStreamParameters<CALL_OPTIONS, TOOLS>;
+
+// Result Types
+export type SDKGenerateTextResult<
+  TOOLS extends ToolSet = ToolSet,
+  OUTPUT extends OutputNamespace.Output<any, any, any> = OutputNamespace.Output<
+    string,
+    string,
+    never
+  >,
+> = GenerateTextResult<TOOLS, OUTPUT>;
+export type SDKGenerateTextOnFinishCallback<TOOLS extends ToolSet = ToolSet> =
+  GenerateTextOnFinishCallback<TOOLS>;
+export type SDKGenerateTextOnStepFinishCallback<TOOLS extends ToolSet = ToolSet> =
+  GenerateTextOnStepFinishCallback<TOOLS>;
+export type SDKStreamTextResult<
+  TOOLS extends ToolSet = ToolSet,
+  OUTPUT extends OutputNamespace.Output<any, any, any> = OutputNamespace.Output<
+    string,
+    string,
+    never
+  >,
+> = StreamTextResult<TOOLS, OUTPUT>;
+export type SDKStreamTextOnChunkCallback<TOOLS extends ToolSet = ToolSet> =
+  StreamTextOnChunkCallback<TOOLS>;
+export type SDKStreamTextOnErrorCallback = StreamTextOnErrorCallback;
+export type SDKStreamTextOnFinishCallback<TOOLS extends ToolSet = ToolSet> =
+  StreamTextOnFinishCallback<TOOLS>;
+export type SDKStreamTextOnStepFinishCallback<TOOLS extends ToolSet = ToolSet> =
+  StreamTextOnStepFinishCallback<TOOLS>;
+export type SDKStreamTextTransform<TOOLS extends ToolSet = ToolSet> = StreamTextTransform<TOOLS>;
+export type SDKGenerateObjectResult<T> = GenerateObjectResult<T>;
+export type SDKStreamObjectResult<PARTIAL, RESULT, ELEMENT_STREAM = unknown> = StreamObjectResult<
+  PARTIAL,
+  RESULT,
+  ELEMENT_STREAM
+>;
+export type SDKStreamObjectOnFinishCallback<T> = StreamObjectOnFinishCallback<T>;
+export type SDKObjectStreamPart<T> = ObjectStreamPart<T>;
+export type SDKEmbedResult = EmbedResult;
+export type SDKEmbedManyResult = EmbedManyResult;
+export type SDKRerankResult<VALUE = unknown> = RerankResult<VALUE>;
+export type SDKGenerateImageResult = GenerateImageResult;
+export type SDKGeneratedFile = GeneratedFile;
+export type SDKGeneratedAudioFile = GeneratedAudioFile;
+export type SDKGenerateVideoResult = GenerateVideoResult;
+export type SDKGenerateVideoPrompt = GenerateVideoPrompt;
+
+// Step Types
+export type SDKStepResult<TTools extends ToolSet = ToolSet> = StepResult<TTools>;
+export type SDKStopCondition<TTools extends ToolSet = ToolSet> = StopCondition<TTools>;
+export type SDKPrepareStepFunction = PrepareStepFunction;
+export type SDKPrepareStepResult = PrepareStepResult;
+
+// Transport Types
+export type SDKChatTransport<UI_MESSAGE extends UIMessage = UIMessage> = ChatTransport<UI_MESSAGE>;
+export type SDKDefaultChatTransport<UI_MESSAGE extends UIMessage = UIMessage> =
+  DefaultChatTransport<UI_MESSAGE>;
+export type SDKHttpChatTransport<UI_MESSAGE extends UIMessage = UIMessage> =
+  HttpChatTransport<UI_MESSAGE>;
+export type SDKHttpChatTransportInitOptions<UI_MESSAGE extends UIMessage = UIMessage> =
+  HttpChatTransportInitOptions<UI_MESSAGE>;
+export type SDKDirectChatTransport = DirectChatTransport;
+export type SDKDirectChatTransportOptions<
+  CALL_OPTIONS = never,
+  TOOLS extends ToolSet = ToolSet,
+  OUTPUT extends OutputNamespace.Output<any, any, any> = OutputNamespace.Output<
+    string,
+    string,
+    never
+  >,
+  UI_MESSAGE extends UIMessage<unknown, never, InferUITools<TOOLS>> = UIMessage<
+    unknown,
+    never,
+    InferUITools<TOOLS>
+  >,
+> = DirectChatTransportOptions<CALL_OPTIONS, TOOLS, OUTPUT, UI_MESSAGE>;
+export type SDKTextStreamChatTransport<UI_MESSAGE extends UIMessage = UIMessage> =
+  TextStreamChatTransport<UI_MESSAGE>;
+export type SDKChatRequestOptions = ChatRequestOptions;
+export type SDKCompletionRequestOptions = CompletionRequestOptions;
+export type SDKChatState<UI_MESSAGE extends UIMessage = UIMessage> = ChatState<UI_MESSAGE>;
+export type SDKChatStatus = ChatStatus;
+export type SDKChatInit<UI_MESSAGE extends UIMessage = UIMessage> = ChatInit<UI_MESSAGE>;
+export type SDKChatOnDataCallback<UI_MESSAGE extends UIMessage = UIMessage> =
+  ChatOnDataCallback<UI_MESSAGE>;
+export type SDKChatOnErrorCallback = ChatOnErrorCallback;
+export type SDKChatOnFinishCallback<UI_MESSAGE extends UIMessage = UIMessage> =
+  ChatOnFinishCallback<UI_MESSAGE>;
+export type SDKChatOnToolCallCallback = ChatOnToolCallCallback;
+export type SDKChatAddToolApproveResponseFunction = ChatAddToolApproveResponseFunction;
+export type SDKPrepareReconnectToStreamRequest = PrepareReconnectToStreamRequest;
+export type SDKPrepareSendMessagesRequest<UI_MESSAGE extends UIMessage = UIMessage> =
+  PrepareSendMessagesRequest<UI_MESSAGE>;
+export type SDKAbstractChat<UI_MESSAGE extends UIMessage = UIMessage> = AbstractChat<UI_MESSAGE>;
+
+// Tool Call Types
+export type SDKStaticToolCall<TOOLS extends ToolSet = ToolSet> = StaticToolCall<TOOLS>;
+export type SDKStaticToolError<TOOLS extends ToolSet = ToolSet> = StaticToolError<TOOLS>;
+export type SDKStaticToolResult<TOOLS extends ToolSet = ToolSet> = StaticToolResult<TOOLS>;
+export type SDKStaticToolOutputDenied<TOOLS extends ToolSet = ToolSet> =
+  StaticToolOutputDenied<TOOLS>;
+export type SDKDynamicToolCall = DynamicToolCall;
+export type SDKDynamicToolError = DynamicToolError;
+export type SDKDynamicToolResult = DynamicToolResult;
+export type SDKTypedToolCall<TOOLS extends ToolSet = ToolSet> = TypedToolCall<TOOLS>;
+export type SDKTypedToolError<TOOLS extends ToolSet = ToolSet> = TypedToolError<TOOLS>;
+export type SDKTypedToolResult<TOOLS extends ToolSet = ToolSet> = TypedToolResult<TOOLS>;
+export type SDKTypedToolOutputDenied<TOOLS extends ToolSet = ToolSet> =
+  TypedToolOutputDenied<TOOLS>;
+export type SDKToolApprovalRequestOutput<TOOLS extends ToolSet = ToolSet> =
+  ToolApprovalRequestOutput<TOOLS>;
+
+// Stream Types
+export type SDKTextStreamPart<TOOLS extends ToolSet = ToolSet> = TextStreamPart<TOOLS>;
+export type SDKAsyncIterableStream<T> = AsyncIterableStream<T>;
+
+// Telemetry Types
+export type SDKTelemetrySettings = TelemetrySettings;
+
+// Provider Types
+export type SDKProvider = Provider;
+export type SDKProviderMetadata = ProviderMetadata;
+export type SDKProviderRegistryProvider = ProviderRegistryProvider;
+export type SDKProviderV3 = ProviderV3;
+
+// Settings Types
+export type SDKCallSettings = CallSettings;
+export type SDKCallWarning = CallWarning;
+export type SDKWarning = Warning;
+export type SDKSharedV3Warning = SharedV3Warning;
+export type SDKSharedV3ProviderMetadata = SharedV3ProviderMetadata;
+export type SDKTimeoutConfiguration = TimeoutConfiguration;
+
+// Utility Types
+export type SDKContentPart<TOOLS extends ToolSet = ToolSet> = ContentPart<TOOLS>;
+export type DeepPartial<T> = AI_DeepPartial<T>;
+export type SDKChunkDetector = ChunkDetector;
+
+// Valid non-SDK types
+export type JSONValue = AI_JSONValue;
+export type JSONSchema7 = AI_JSONSchema7;
+
+// Completion Types
+export type SDKUseCompletionOptions = UseCompletionOptions;
+
+// Validation Types
+export type SDKSafeValidateUIMessagesResult<UI_MESSAGE extends UIMessage = UIMessage> =
+  SafeValidateUIMessagesResult<UI_MESSAGE>;
+
+// Error Handlers
+export type SDKErrorHandler = ErrorHandler;
+export type SDKLogWarningsFunction = LogWarningsFunction;
+export type SDKRepairTextFunction = RepairTextFunction;
+export type SDKToolCallRepairFunction<TOOLS extends ToolSet = ToolSet> =
+  ToolCallRepairFunction<TOOLS>;
+
+// Error Classes
+export { NoObjectGeneratedError };
+export type SDKNoObjectGeneratedError = NoObjectGeneratedError;
+
+// Experimental Types
+export type SDKExperimentalVideoModelV3 = Experimental_VideoModelV3;
+
+// =============================================================================
+// PART 4: MIDDLEWARE PARAMETER TYPES (for type-safe middleware creation)
+// =============================================================================
+
+export type SDKWrapGenerateArgs = Parameters<
+  NonNullable<SDKLanguageModelV3Middleware['wrapGenerate']>
+>[0];
+export type SDKWrapStreamArgs = Parameters<
+  NonNullable<SDKLanguageModelV3Middleware['wrapStream']>
+>[0];
+export type SDKTransformParamsArgs = Parameters<
+  NonNullable<SDKLanguageModelV3Middleware['transformParams']>
+>[0];
+
+// =============================================================================
+// PART 5: BACKWARDS COMPATIBILITY (OneApp Token Usage)
+// =============================================================================
+
+/**
+ * TokenUsage type for tracking token consumption.
+ * Uses familiar promptTokens/completionTokens naming for backwards compatibility.
+ *
+ * Note: SDK uses inputTokens/outputTokens. Use convertFromSDKUsage() to convert.
+ */
+export interface TokenUsage {
+  readonly promptTokens: number;
+  readonly completionTokens: number;
+  readonly totalTokens: number;
+}
+
+/**
+ * Convert SDK LanguageModelUsage to OneApp TokenUsage.
+ */
+export function convertFromSDKUsage(usage: SDKLanguageModelUsage): TokenUsage {
+  const promptTokens = usage.inputTokens ?? 0;
+  const completionTokens = usage.outputTokens ?? 0;
+  return {
+    promptTokens,
+    completionTokens,
+    totalTokens: promptTokens + completionTokens,
+  };
+}
+
+/**
+ * Create an empty TokenUsage object.
+ */
+export function createEmptyUsage(): TokenUsage {
+  return {
+    promptTokens: 0,
+    completionTokens: 0,
+    totalTokens: 0,
+  };
+}
+
+/**
+ * Add two TokenUsage objects together.
+ */
+export function addUsage(a: TokenUsage, b: TokenUsage | undefined): TokenUsage {
+  if (!b) return a;
+  return {
+    promptTokens: a.promptTokens + b.promptTokens,
+    completionTokens: a.completionTokens + b.completionTokens,
+    totalTokens: a.totalTokens + b.totalTokens,
+  };
+}
+
+// =============================================================================
+// PART 6: MODEL REFERENCE HELPERS
+// =============================================================================
+
+/**
+ * ModelRef - reference to a language model.
+ * Can be a model ID string or the model instance itself.
+ */
+export type ModelRef = string | SDKLanguageModel;
+
+/**
+ * Gets the model ID from a ModelRef.
+ */
+export function getModelId(model: ModelRef): string {
+  if (typeof model === 'string') {
+    return model;
+  }
+  return model.modelId;
+}
+
+/**
+ * Runtime guard for ModelRef values.
+ */
+export function isModelRef(value: unknown): value is ModelRef {
+  if (typeof value === 'string') {
+    return value.trim().length > 0;
+  }
+
+  if (typeof value !== 'object' || value === null) {
+    return false;
+  }
+
+  const candidate = value as { modelId?: unknown };
+  return typeof candidate.modelId === 'string' && candidate.modelId.trim().length > 0;
+}
+
+/**
+ * Generates a unique identifier.
+ * Uses crypto.randomUUID() when available (Node.js 14.17+, modern browsers),
+ * otherwise falls back to timestamp + random for local correlation IDs.
+ * Note: Fallback is not suitable for security-sensitive contexts or high-frequency distributed scenarios.
+ */
+export function generateUniqueId(options: { requireSecure?: boolean } = {}): string {
+  const requireSecure = options.requireSecure ?? true;
+
+  if (typeof crypto !== 'undefined') {
+    if (crypto.randomUUID) {
+      return crypto.randomUUID();
+    }
+
+    if (crypto.getRandomValues) {
+      const bytes = new Uint8Array(16);
+      crypto.getRandomValues(bytes);
+      const byte6 = bytes[6] ?? 0;
+      const byte8 = bytes[8] ?? 0;
+      bytes[6] = (byte6 & 0x0f) | 0x40;
+      bytes[8] = (byte8 & 0x3f) | 0x80;
+
+      const toHex = (value: number): string => value.toString(16).padStart(2, '0');
+      const byte = (index: number): number => bytes[index] ?? 0;
+      return [
+        `${toHex(byte(0))}${toHex(byte(1))}${toHex(byte(2))}${toHex(byte(3))}`,
+        `${toHex(byte(4))}${toHex(byte(5))}`,
+        `${toHex(byte(6))}${toHex(byte(7))}`,
+        `${toHex(byte(8))}${toHex(byte(9))}`,
+        `${toHex(byte(10))}${toHex(byte(11))}${toHex(byte(12))}${toHex(byte(13))}${toHex(byte(14))}${toHex(byte(15))}`,
+      ].join('-');
+    }
+  }
+
+  if (requireSecure) {
+    throw new Error('Secure random generator unavailable for generateId');
+  }
+
+  const timestamp = Date.now().toString(36);
+  const entropy = `${timestamp}-${timestamp.slice(-4)}`;
+  return entropy;
+}
+
+// =============================================================================
+// PART 7: TOOL INVOCATION STATES (SDK-Aligned)
+// =============================================================================
+
+/**
+ * SDK-aligned tool invocation states for UI rendering.
+ * These represent the lifecycle of a tool call in the SDK.
+ */
+export type SDKToolInvocationState = 'partial-call' | 'call' | 'result';
+
+/**
+ * Tool shimmer states for UI loading indicators.
+ * These are OneApp-specific states for rendering tool shimmers.
+ */
+export type ToolShimmerState = 'pending' | 'loading' | 'success' | 'error';
+
+// =============================================================================
+// PART 8: MESSAGE ROLE TYPES (SDK-Aligned)
+// =============================================================================
+
+/**
+ * SDK-aligned message role types.
+ * These match the roles used in AI SDK v6 message types.
+ */
+export type MessageRole = 'user' | 'assistant' | 'system' | 'tool';
+
+/**
+ * Core message roles (without 'tool').
+ * Used in contexts where tool messages are not applicable.
+ */
+export type CoreMessageRole = 'user' | 'assistant' | 'system';
+
+/**
+ * Basic message interface aligned with SDK patterns.
+ * Use this as a base for custom message types.
+ */
+export interface BaseMessage {
+  readonly role: MessageRole;
+  readonly content: string;
+}
+
+/**
+ * Core message interface (without tool role).
+ */
+export interface CoreMessage {
+  readonly role: CoreMessageRole;
+  readonly content: string;
+}
+
+// =============================================================================
+// PART 9: MESSAGE PART UNION TYPES
+// =============================================================================
+
+/**
+ * Union of all SDK message part types.
+ * Use this for content arrays that can contain any part type.
+ */
+export type SDKMessagePart =
+  | SDKTextPart
+  | SDKFilePart
+  | SDKImagePart
+  | SDKToolCallPart
+  | SDKToolResultPart
+  | SDKToolApprovalResponse;
+
+// =============================================================================
+// PART 10: FINISH REASON TYPES (SDK-Aligned)
+// =============================================================================
+
+/**
+ * Finish reason for a single generation step.
+ * Used in step results.
+ */
+export type StepFinishReason = 'stop' | 'tool-calls' | 'length' | 'content-filter';
+
+/**
+ * Finish reason for complete agent execution.
+ * Includes agent-specific reasons like max-steps and abort.
+ */
+export type AgentFinishReason = 'stop' | 'max-steps' | 'abort';