feat: support AI SDK v5 and v6 via unified imports [ENG-11722] (#269)

* chore: update ai sdk v6

* feat(deps): support AI SDK v5 and v6 via unified imports

Remove direct dependencies on @ai-sdk/provider and @ai-sdk/provider-utils
internal packages. Import JSONSchema7 and Tool types directly from the
main 'ai' package instead.

This change:
- Removes @ai-sdk/provider and @ai-sdk/provider-utils from devDependencies
- Updates peerDependencies to accept ai >=5.0.0 <7.0.0
- Simplifies the dependency tree for consumers

Both AI SDK v5 and v6 export the required types from the main package,
making the internal package dependencies unnecessary.

* chore(deps): require ai SDK >=5.0.108

Author: ryoppippi

package.json

@@ -57,14 +57,12 @@
 		"zod": "catalog:prod"
 	},
 	"devDependencies": {
-		"@ai-sdk/provider": "catalog:dev",
-		"@ai-sdk/provider-utils": "catalog:dev",
 		"@fast-check/vitest": "catalog:dev",
 		"@hono/mcp": "catalog:dev",
 		"@types/node": "catalog:dev",
 		"@typescript/native-preview": "catalog:dev",
 		"@vitest/coverage-v8": "catalog:dev",
-		"ai": "catalog:peer",
+		"ai": "catalog:dev",
 		"hono": "catalog:dev",
 		"knip": "catalog:dev",
 		"lefthook": "catalog:dev",

pnpm-lock.yaml

@@ -6,10 +6,9 @@ catalogMode: strict
 
 catalogs:
   dev:
-    '@ai-sdk/openai': ^2.0.80
-    '@ai-sdk/provider': ^2.0.0
+    '@ai-sdk/openai': ^3.0.2
+    ai: ^6.0.7
     '@fast-check/vitest': ^0.2.0
-    '@ai-sdk/provider-utils': ^3.0.18
     '@clack/prompts': ^0.11.0
     '@hono/mcp': ^0.1.4
     '@types/node': ^22.13.5
@@ -34,7 +33,7 @@ catalogs:
     '@tanstack/ai-openai': ^0.0.3
   peer:
     '@anthropic-ai/sdk': ^0.52.0
-    ai: ^5.0.108
+    ai: '>=5.0.108 <7.0.0'
     openai: ^6.2.0
   prod:
     '@modelcontextprotocol/sdk': ^1.24.3
@@ -47,9 +46,14 @@ enablePrePostScripts: true
 minimumReleaseAge: 1440
 
 minimumReleaseAgeExclude:
+  - '@ai-sdk/gateway'
+  - '@ai-sdk/openai'
+  - '@ai-sdk/provider'
+  - '@ai-sdk/provider-utils'
   - '@anthropic-ai/claude-agent-sdk'
   - '@tanstack/ai'
   - '@tanstack/ai-openai'
+  - ai
 
 onlyBuiltDependencies:
   - esbuild

pnpm-workspace.yaml

@@ -1,9 +1,10 @@
-import type { JSONSchema7 as AISDKJSONSchema } from '@ai-sdk/provider';
+import type { JSONSchema7 as AISDKJSONSchema } from 'ai';
 import type { Tool as AnthropicTool } from '@anthropic-ai/sdk/resources';
 import * as orama from '@orama/orama';
 import type { ChatCompletionFunctionTool } from 'openai/resources/chat/completions';
 import type { FunctionTool as OpenAIResponsesFunctionTool } from 'openai/resources/responses/responses';
 import type { OverrideProperties } from 'type-fest';
+import { peerDependencies } from '../package.json';
 import { DEFAULT_HYBRID_ALPHA } from './consts';
 import { RequestBuilder } from './requestBuilder';
 import type {
@@ -52,7 +53,9 @@ export class BaseTool {
 						method: this.executeConfig.method,
 						url: this.executeConfig.url,
 						bodyType: this.executeConfig.bodyType,
-						params: this.executeConfig.params.map((param) => ({ ...param })),
+						params: this.executeConfig.params.map((param) => ({
+							...param,
+						})),
 					} satisfies HttpExecuteConfig;
 				case 'rpc':
 					return {
@@ -145,7 +148,9 @@ export class BaseTool {
 				typeof inputParams !== 'object'
 			) {
 				throw new StackOneError(
-					`Invalid parameters type. Expected object or string, got ${typeof inputParams}. Parameters: ${JSON.stringify(inputParams)}`,
+					`Invalid parameters type. Expected object or string, got ${typeof inputParams}. Parameters: ${JSON.stringify(
+						inputParams,
+					)}`,
 				);
 			}
 
@@ -236,7 +241,7 @@ export class BaseTool {
 		/** AI SDK is optional dependency, import only when needed */
 		const ai = await tryImport<typeof import('ai')>(
 			'ai',
-			'npm install ai@4.x|5.x or pnpm add [email protected]|5.x',
+			`npm install ai (requires ${peerDependencies.ai})`,
 		);
 		const schemaObject = ai.jsonSchema(schema);
 
@@ -257,7 +262,9 @@ export class BaseTool {
 							try {
 								return await this.execute(args as JsonObject);
 							} catch (error) {
-								return `Error executing tool: ${error instanceof Error ? error.message : String(error)}`;
+								return `Error executing tool: ${
+									error instanceof Error ? error.message : String(error)
+								}`;
 							}
 						}
 					: undefined,
@@ -582,7 +589,9 @@ function metaSearchTools(
 				typeof inputParams !== 'object'
 			) {
 				throw new StackOneError(
-					`Invalid parameters type. Expected object or string, got ${typeof inputParams}. Parameters: ${JSON.stringify(inputParams)}`,
+					`Invalid parameters type. Expected object or string, got ${typeof inputParams}. Parameters: ${JSON.stringify(
+						inputParams,
+					)}`,
 				);
 			}
 
@@ -712,7 +721,9 @@ function metaExecuteTool(tools: Tools): BaseTool {
 				typeof inputParams !== 'object'
 			) {
 				throw new StackOneError(
-					`Invalid parameters type. Expected object or string, got ${typeof inputParams}. Parameters: ${JSON.stringify(inputParams)}`,
+					`Invalid parameters type. Expected object or string, got ${typeof inputParams}. Parameters: ${JSON.stringify(
+						inputParams,
+					)}`,
 				);
 			}
 

src/tool.ts

@@ -2,7 +2,7 @@
  * Common type definitions for the StackOne SDK
  */
 
-import type { Tool } from '@ai-sdk/provider-utils';
+import type { Tool } from 'ai';
 import type { ToolSet } from 'ai';
 import type { JsonObject, JsonValue, ValueOf } from 'type-fest';
 
@@ -176,7 +176,7 @@ export interface ToolDefinition {
 
 /**
  * Extended AI SDK tool definition with StackOne-specific execution metadata.
- * Extends the base Tool type from @ai-sdk/provider-utils.
+ * Extends the base Tool type from the 'ai' package.
  *
  * NOTE: We avoid defining our own types as much as possible and use existing
  * types from dependencies. This type only extends the AI SDK Tool type with

src/types.ts

@@ -10,7 +10,7 @@ import { StackOneError } from './error-stackone';
  *
  * @example
  * ```ts
- * const ai = await tryImport('ai', 'npm install ai@4.x|5.x');
+ * const ai = await tryImport('ai', 'npm install ai');
  * const { jsonSchema } = ai;
  * ```
  */

src/utils/try-import.ts

@@ -9,7 +9,7 @@ export default defineConfig({
 	treeshake: true,
 	dts: {
 		tsgo: true,
-		resolve: [/^@types\//, 'type-fest', 'ai', '@ai-sdk/provider-utils'],
+		resolve: [/^@types\//, 'type-fest', 'ai'],
 	},
 	publint: true,
 	unused: true,