fix(tool): use dynamic peerDependencies version in error message

- Import peerDependencies from package.json to dynamically show
  supported AI SDK version range in installation error messages
- Update JSDoc comments to reference 'ai' package instead of
  @ai-sdk/provider-utils
- Simplify try-import example to use generic install hint

This ensures error messages stay in sync with peerDependencies
when the supported version range changes.

Author: ryoppippi

src/tool.ts

@@ -4,6 +4,7 @@ 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 {
@@ -240,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);
 

src/types.ts

@@ -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/utils/try-import.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;
  * ```
  */