@sweetretry/ai-sdk-volcengine-adapter 0.1.0

package/README.md

@@ -0,0 +1,190 @@
+# AI SDK Volcengine Adapter
+
+[Volcengine](https://www.volcengine.com/) (Doubao) provider for the [AI SDK](https://sdk.vercel.ai/).
+
+## Installation
+
+```bash
+npm install ai-sdk-volcengine-adapter
+```
+
+## Setup
+
+Set your Volcengine API key as an environment variable:
+
+```bash
+export ARK_API_KEY=your-api-key
+```
+
+Or pass it directly when creating the provider:
+
+```typescript
+import { createVolcengine } from 'ai-sdk-volcengine-adapter';
+
+const volcengine = createVolcengine({
+  apiKey: 'your-api-key',
+});
+```
+
+## Usage
+
+### Basic Text Generation
+
+```typescript
+import { generateText } from 'ai';
+import { volcengine } from 'ai-sdk-volcengine-adapter';
+
+const { text } = await generateText({
+  model: volcengine('doubao-seed-1-8-251228'),
+  prompt: 'What is the meaning of life?',
+});
+
+console.log(text);
+```
+
+### Streaming
+
+```typescript
+import { streamText } from 'ai';
+import { volcengine } from 'ai-sdk-volcengine-adapter';
+
+const result = streamText({
+  model: volcengine('doubao-seed-1-8-251228'),
+  prompt: 'Write a short story about a robot.',
+});
+
+for await (const chunk of result.textStream) {
+  process.stdout.write(chunk);
+}
+```
+
+### Extended Thinking Mode
+
+Enable extended thinking to get reasoning content from the model:
+
+```typescript
+import { streamText } from 'ai';
+import { volcengine } from 'ai-sdk-volcengine-adapter';
+
+const result = streamText({
+  model: volcengine('doubao-seed-1-8-251228'),
+  prompt: 'Solve this step by step: What is 23 * 47?',
+  providerOptions: {
+    volcengine: {
+      thinking: true,
+    },
+  },
+});
+
+for await (const part of result.fullStream) {
+  if (part.type === 'reasoning-delta') {
+    process.stdout.write(`[Thinking] ${part.text}`);
+  } else if (part.type === 'text-delta') {
+    process.stdout.write(part.text);
+  }
+}
+```
+
+### Tool Calling
+
+```typescript
+import { generateText } from 'ai';
+import { volcengine } from 'ai-sdk-volcengine-adapter';
+import { z } from 'zod';
+
+const { text, toolCalls } = await generateText({
+  model: volcengine('doubao-seed-1-8-251228'),
+  prompt: 'What is the weather in San Francisco?',
+  tools: {
+    getWeather: {
+      description: 'Get the weather for a location',
+      parameters: z.object({
+        location: z.string().describe('The city name'),
+      }),
+      execute: async ({ location }) => {
+        return { temperature: 72, condition: 'sunny' };
+      },
+    },
+  },
+});
+```
+
+### Web Search Tool
+
+Use the built-in web search tool:
+
+```typescript
+import { generateText } from 'ai';
+import { volcengine, volcengineTools } from 'ai-sdk-volcengine-adapter';
+
+const { text } = await generateText({
+  model: volcengine('doubao-seed-1-8-251228'),
+  prompt: 'What are the latest news about AI?',
+  tools: {
+    webSearch: volcengineTools.webSearch(),
+  },
+});
+```
+
+## Supported Models
+
+- `doubao-seed-1-8-251228` - Latest Doubao Seed model
+- `doubao-seed-code-preview-251028` - Code-optimized model
+- `doubao-seed-1-6-lite-251015` - Lightweight model
+- `doubao-seed-1-6-flash-250828` - Fast inference model
+- `doubao-seed-1-6-vision-250815` - Vision-capable model
+
+You can also use any model ID string for custom endpoints.
+
+## Provider Options
+
+```typescript
+import { createVolcengine } from 'ai-sdk-volcengine-adapter';
+
+const volcengine = createVolcengine({
+  // Custom base URL (default: https://ark.cn-beijing.volces.com/api/v3)
+  baseURL: 'https://your-custom-endpoint.com/api/v3',
+
+  // API key (default: ARK_API_KEY env variable)
+  apiKey: 'your-api-key',
+
+  // Custom headers
+  headers: {
+    'X-Custom-Header': 'value',
+  },
+
+  // Custom fetch implementation
+  fetch: customFetch,
+});
+```
+
+## Model Options
+
+```typescript
+import { generateText } from 'ai';
+import { volcengine } from 'ai-sdk-volcengine-adapter';
+
+const { text } = await generateText({
+  model: volcengine('doubao-seed-1-8-251228'),
+  prompt: 'Hello!',
+  providerOptions: {
+    volcengine: {
+      // Enable extended thinking mode
+      thinking: true,
+
+      // Enable structured outputs
+      structuredOutputs: true,
+
+      // Enable strict JSON schema validation
+      strictJsonSchema: false,
+
+      // Enable parallel tool calls
+      parallelToolCalls: true,
+    },
+  },
+});
+```
+
+## License
+
+MIT

package/dist/convert-to-volcengine-chat-message.d.ts

@@ -0,0 +1,3 @@
+import { LanguageModelV3Prompt } from "@ai-sdk/provider";
+import { VolcengineChatPrompt } from "./volcengine-chat-prompt";
+export declare function convertToVolcengineChatMessages(prompt: LanguageModelV3Prompt): VolcengineChatPrompt;

package/dist/convert-to-volcengine-chat-message.js

@@ -0,0 +1,157 @@
+import { UnsupportedFunctionalityError } from "@ai-sdk/provider";
+import { convertToBase64 } from "@ai-sdk/provider-utils";
+function formatDataUrl(data, mediaType) {
+    if (data instanceof URL) {
+        return data.toString();
+    }
+    if (typeof data === "string") {
+        return data.startsWith("data:") ? data : `data:${mediaType};base64,${data}`;
+    }
+    return `data:${mediaType};base64,${convertToBase64(data)}`;
+}
+export function convertToVolcengineChatMessages(prompt) {
+    const messages = [];
+    for (const message of prompt){
+        switch(message.role){
+            case "system":
+                {
+                    messages.push({
+                        role: "system",
+                        content: message.content
+                    });
+                    break;
+                }
+            case "user":
+                {
+                    messages.push({
+                        role: "user",
+                        content: message.content.map((part)=>{
+                            switch(part.type){
+                                case "text":
+                                    return {
+                                        type: "text",
+                                        text: part.text
+                                    };
+                                case "file":
+                                    {
+                                        const { mediaType, data } = part;
+                                        if (mediaType.startsWith("image/")) {
+                                            return {
+                                                type: "image_url",
+                                                image_url: {
+                                                    url: formatDataUrl(data, mediaType)
+                                                }
+                                            };
+                                        }
+                                        if (mediaType.startsWith("video/")) {
+                                            return {
+                                                type: "video_url",
+                                                video_url: {
+                                                    url: formatDataUrl(data, mediaType)
+                                                }
+                                            };
+                                        }
+                                        throw new UnsupportedFunctionalityError({
+                                            functionality: `File type: ${mediaType}`
+                                        });
+                                    }
+                                default:
+                                    {
+                                        const _exhaustiveCheck = part;
+                                        throw new UnsupportedFunctionalityError({
+                                            functionality: `User message part type: ${_exhaustiveCheck.type}`
+                                        });
+                                    }
+                            }
+                        })
+                    });
+                    break;
+                }
+            case "assistant":
+                {
+                    let text = "";
+                    let reasoningContent;
+                    const toolCalls = [];
+                    for (const part of message.content){
+                        switch(part.type){
+                            case "text":
+                                text += part.text;
+                                break;
+                            case "reasoning":
+                                reasoningContent = (reasoningContent ?? "") + part.text;
+                                break;
+                            case "tool-call":
+                                toolCalls.push({
+                                    id: part.toolCallId,
+                                    type: "function",
+                                    function: {
+                                        name: part.toolName,
+                                        arguments: typeof part.input === "string" ? part.input : JSON.stringify(part.input)
+                                    }
+                                });
+                                break;
+                            case "file":
+                            case "tool-result":
+                                break;
+                            default:
+                                {
+                                    const _exhaustiveCheck = part;
+                                    throw new UnsupportedFunctionalityError({
+                                        functionality: `Assistant message part type: ${_exhaustiveCheck.type}`
+                                    });
+                                }
+                        }
+                    }
+                    messages.push({
+                        role: "assistant",
+                        content: text,
+                        reasoning_content: reasoningContent,
+                        tool_calls: toolCalls.length > 0 ? toolCalls : undefined
+                    });
+                    break;
+                }
+            case "tool":
+                {
+                    for (const toolResponse of message.content){
+                        if (toolResponse.type === "tool-approval-response") {
+                            continue;
+                        }
+                        const { output } = toolResponse;
+                        let content;
+                        switch(output.type){
+                            case "text":
+                            case "error-text":
+                                content = output.value;
+                                break;
+                            case "json":
+                            case "error-json":
+                                content = JSON.stringify(output.value);
+                                break;
+                            case "execution-denied":
+                                content = output.reason ?? "Tool execution denied.";
+                                break;
+                            case "content":
+                                content = output.value.map((v)=>v.type === "text" ? v.text : JSON.stringify(v)).join("\n");
+                                break;
+                        }
+                        messages.push({
+                            role: "tool",
+                            tool_call_id: toolResponse.toolCallId,
+                            content
+                        });
+                    }
+                    break;
+                }
+            default:
+                {
+                    const _exhaustiveCheck = message;
+                    throw new UnsupportedFunctionalityError({
+                        functionality: `Message role: ${_exhaustiveCheck.role}`
+                    });
+                }
+        }
+    }
+    return messages;
+}
+
+//# sourceMappingURL=convert-to-volcengine-chat-message.js.map

package/dist/convert-to-volcengine-chat-message.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/convert-to-volcengine-chat-message.ts"],"sourcesContent":["import {\n  LanguageModelV3DataContent,\n  LanguageModelV3Prompt,\n  UnsupportedFunctionalityError\n} from \"@ai-sdk/provider\";\nimport { convertToBase64 } from \"@ai-sdk/provider-utils\";\nimport {\n  VolcengineChatAssistantMessage,\n  VolcengineChatPrompt,\n  VolcengineChatUserMessageContent\n} from \"./volcengine-chat-prompt\";\n\nfunction formatDataUrl(data: LanguageModelV3DataContent, mediaType: string): string {\n  if (data instanceof URL) {\n    return data.toString();\n  }\n  if (typeof data === \"string\") {\n    return data.startsWith(\"data:\") ? data : `data:${mediaType};base64,${data}`;\n  }\n  return `data:${mediaType};base64,${convertToBase64(data)}`;\n}\n\n\nexport function convertToVolcengineChatMessages(\n  prompt: LanguageModelV3Prompt\n): VolcengineChatPrompt {\n  const messages: VolcengineChatPrompt = [];\n\n  for (const message of prompt) {\n    switch (message.role) {\n      case \"system\": {\n        messages.push({\n          role: \"system\",\n          content: message.content\n        });\n        break;\n      }\n\n      case \"user\": {\n        messages.push({\n          role: \"user\",\n          content: message.content.map((part): VolcengineChatUserMessageContent => {\n            switch (part.type) {\n              case \"text\":\n                return { type: \"text\", text: part.text };\n\n              case \"file\": {\n                const { mediaType, data } = part;\n\n                if (mediaType.startsWith(\"image/\")) {\n                  return {\n                    type: \"image_url\",\n                    image_url: { url: formatDataUrl(data, mediaType) }\n                  };\n                }\n                if (mediaType.startsWith(\"video/\")) {\n                  return {\n                    type: \"video_url\",\n                    video_url: { url: formatDataUrl(data, mediaType) }\n                  };\n                }\n                throw new UnsupportedFunctionalityError({\n                  functionality: `File type: ${mediaType}`\n                });\n              }\n\n              default: {\n                const _exhaustiveCheck: never = part;\n                throw new UnsupportedFunctionalityError({\n                  functionality: `User message part type: ${(_exhaustiveCheck as { type: string }).type}`\n                });\n              }\n            }\n          })\n        });\n        break;\n      }\n\n      case \"assistant\": {\n        let text = \"\";\n        let reasoningContent: string | undefined;\n        const toolCalls: VolcengineChatAssistantMessage[\"tool_calls\"] = [];\n\n        for (const part of message.content) {\n          switch (part.type) {\n            case \"text\":\n              text += part.text;\n              break;\n            case \"reasoning\":\n              reasoningContent = (reasoningContent ?? \"\") + part.text;\n              break;\n            case \"tool-call\":\n              toolCalls.push({\n                id: part.toolCallId,\n                type: \"function\",\n                function: {\n                  name: part.toolName,\n                  arguments:\n                    typeof part.input === \"string\"\n                      ? part.input\n                      : JSON.stringify(part.input)\n                }\n              });\n              break;\n            case \"file\":\n            case \"tool-result\":\n              // Skip file and tool-result in assistant messages\n              break;\n            default: {\n              const _exhaustiveCheck: never = part;\n              throw new UnsupportedFunctionalityError({\n                functionality: `Assistant message part type: ${(_exhaustiveCheck as { type: string }).type}`\n              });\n            }\n          }\n        }\n\n        messages.push({\n          role: \"assistant\",\n          content: text,\n          reasoning_content: reasoningContent,\n          tool_calls: toolCalls.length > 0 ? toolCalls : undefined\n        });\n        break;\n      }\n\n      case \"tool\": {\n        for (const toolResponse of message.content) {\n          if (toolResponse.type === \"tool-approval-response\") {\n            continue;\n          }\n\n          const { output } = toolResponse;\n          let content: string;\n\n          switch (output.type) {\n            case \"text\":\n            case \"error-text\":\n              content = output.value;\n              break;\n            case \"json\":\n            case \"error-json\":\n              content = JSON.stringify(output.value);\n              break;\n            case \"execution-denied\":\n              content = output.reason ?? \"Tool execution denied.\";\n              break;\n            case \"content\":\n              content = output.value\n                .map((v) => (v.type === \"text\" ? v.text : JSON.stringify(v)))\n                .join(\"\\n\");\n              break;\n          }\n\n          messages.push({\n            role: \"tool\",\n            tool_call_id: toolResponse.toolCallId,\n            content\n          });\n        }\n        break;\n      }\n\n      default: {\n        const _exhaustiveCheck: never = message;\n        throw new UnsupportedFunctionalityError({\n          functionality: `Message role: ${(_exhaustiveCheck as { role: string }).role}`\n        });\n      }\n    }\n  }\n\n  return messages;\n}\n"],"names":["UnsupportedFunctionalityError","convertToBase64","formatDataUrl","data","mediaType","URL","toString","startsWith","convertToVolcengineChatMessages","prompt","messages","message","role","push","content","map","part","type","text","image_url","url","video_url","functionality","_exhaustiveCheck","reasoningContent","toolCalls","id","toolCallId","function","name","toolName","arguments","input","JSON","stringify","reasoning_content","tool_calls","length","undefined","toolResponse","output","value","reason","v","join","tool_call_id"],"mappings":"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"}

package/dist/convert-volcengine-usage.d.ts

@@ -0,0 +1,28 @@
+import { LanguageModelV3Usage } from "@ai-sdk/provider";
+/**
+ * Volcengine API usage response structure
+ * @see https://www.volcengine.com/docs/82379/1494384
+ */
+export type VolcengineUsage = {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    prompt_tokens_details?: {
+        cached_tokens?: number;
+    };
+    completion_tokens_details?: {
+        reasoning_tokens?: number;
+    };
+};
+/**
+ * Converts Volcengine usage data to the AI SDK's LanguageModelV3Usage format.
+ *
+ * Field mappings:
+ * - prompt_tokens → inputTokens.total
+ * - prompt_tokens - cached_tokens → inputTokens.noCache
+ * - cached_tokens → inputTokens.cacheRead
+ * - completion_tokens → outputTokens.total
+ * - completion_tokens - reasoning_tokens → outputTokens.text
+ * - reasoning_tokens → outputTokens.reasoning
+ */
+export declare function convertVolcengineUsage(usage: VolcengineUsage | undefined | null): LanguageModelV3Usage;

package/dist/convert-volcengine-usage.js

@@ -0,0 +1,51 @@
+/**
+ * Converts Volcengine usage data to the AI SDK's LanguageModelV3Usage format.
+ *
+ * Field mappings:
+ * - prompt_tokens → inputTokens.total
+ * - prompt_tokens - cached_tokens → inputTokens.noCache
+ * - cached_tokens → inputTokens.cacheRead
+ * - completion_tokens → outputTokens.total
+ * - completion_tokens - reasoning_tokens → outputTokens.text
+ * - reasoning_tokens → outputTokens.reasoning
+ */ export function convertVolcengineUsage(usage) {
+    if (usage == null) {
+        return {
+            inputTokens: {
+                total: undefined,
+                noCache: undefined,
+                cacheRead: undefined,
+                cacheWrite: undefined
+            },
+            outputTokens: {
+                total: undefined,
+                text: undefined,
+                reasoning: undefined
+            }
+        };
+    }
+    const promptTokens = usage.prompt_tokens;
+    const completionTokens = usage.completion_tokens;
+    const cachedTokens = usage.prompt_tokens_details?.cached_tokens;
+    const reasoningTokens = usage.completion_tokens_details?.reasoning_tokens;
+    // Calculate non-cached input tokens
+    const noCacheTokens = promptTokens != null && cachedTokens != null ? promptTokens - cachedTokens : promptTokens;
+    // Calculate text output tokens (completion minus reasoning)
+    const textTokens = completionTokens != null && reasoningTokens != null ? completionTokens - reasoningTokens : completionTokens;
+    return {
+        inputTokens: {
+            total: promptTokens,
+            noCache: noCacheTokens,
+            cacheRead: cachedTokens,
+            cacheWrite: undefined
+        },
+        outputTokens: {
+            total: completionTokens,
+            text: textTokens,
+            reasoning: reasoningTokens
+        },
+        raw: usage
+    };
+}
+
+//# sourceMappingURL=convert-volcengine-usage.js.map

package/dist/convert-volcengine-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/convert-volcengine-usage.ts"],"sourcesContent":["import { LanguageModelV3Usage } from \"@ai-sdk/provider\"\n\n/**\n * Volcengine API usage response structure\n * @see https://www.volcengine.com/docs/82379/1494384\n */\nexport type VolcengineUsage = {\n  prompt_tokens?: number\n  completion_tokens?: number\n  total_tokens?: number\n  prompt_tokens_details?: {\n    cached_tokens?: number\n  }\n  completion_tokens_details?: {\n    reasoning_tokens?: number\n  }\n}\n\n/**\n * Converts Volcengine usage data to the AI SDK's LanguageModelV3Usage format.\n *\n * Field mappings:\n * - prompt_tokens → inputTokens.total\n * - prompt_tokens - cached_tokens → inputTokens.noCache\n * - cached_tokens → inputTokens.cacheRead\n * - completion_tokens → outputTokens.total\n * - completion_tokens - reasoning_tokens → outputTokens.text\n * - reasoning_tokens → outputTokens.reasoning\n */\nexport function convertVolcengineUsage(\n  usage: VolcengineUsage | undefined | null\n): LanguageModelV3Usage {\n  if (usage == null) {\n    return {\n      inputTokens: {\n        total: undefined,\n        noCache: undefined,\n        cacheRead: undefined,\n        cacheWrite: undefined,\n      },\n      outputTokens: {\n        total: undefined,\n        text: undefined,\n        reasoning: undefined,\n      },\n    }\n  }\n\n  const promptTokens = usage.prompt_tokens\n  const completionTokens = usage.completion_tokens\n  const cachedTokens = usage.prompt_tokens_details?.cached_tokens\n  const reasoningTokens = usage.completion_tokens_details?.reasoning_tokens\n\n  // Calculate non-cached input tokens\n  const noCacheTokens =\n    promptTokens != null && cachedTokens != null\n      ? promptTokens - cachedTokens\n      : promptTokens\n\n  // Calculate text output tokens (completion minus reasoning)\n  const textTokens =\n    completionTokens != null && reasoningTokens != null\n      ? completionTokens - reasoningTokens\n      : completionTokens\n\n  return {\n    inputTokens: {\n      total: promptTokens,\n      noCache: noCacheTokens,\n      cacheRead: cachedTokens,\n      cacheWrite: undefined, // Volcengine API doesn't report cache write tokens\n    },\n    outputTokens: {\n      total: completionTokens,\n      text: textTokens,\n      reasoning: reasoningTokens,\n    },\n    raw: usage,\n  }\n}\n"],"names":["convertVolcengineUsage","usage","inputTokens","total","undefined","noCache","cacheRead","cacheWrite","outputTokens","text","reasoning","promptTokens","prompt_tokens","completionTokens","completion_tokens","cachedTokens","prompt_tokens_details","cached_tokens","reasoningTokens","completion_tokens_details","reasoning_tokens","noCacheTokens","textTokens","raw"],"mappings":"AAkBA;;;;;;;;;;CAUC,GACD,OAAO,SAASA,uBACdC,KAAyC;IAEzC,IAAIA,SAAS,MAAM;QACjB,OAAO;YACLC,aAAa;gBACXC,OAAOC;gBACPC,SAASD;gBACTE,WAAWF;gBACXG,YAAYH;YACd;YACAI,cAAc;gBACZL,OAAOC;gBACPK,MAAML;gBACNM,WAAWN;YACb;QACF;IACF;IAEA,MAAMO,eAAeV,MAAMW,aAAa;IACxC,MAAMC,mBAAmBZ,MAAMa,iBAAiB;IAChD,MAAMC,eAAed,MAAMe,qBAAqB,EAAEC;IAClD,MAAMC,kBAAkBjB,MAAMkB,yBAAyB,EAAEC;IAEzD,oCAAoC;IACpC,MAAMC,gBACJV,gBAAgB,QAAQI,gBAAgB,OACpCJ,eAAeI,eACfJ;IAEN,4DAA4D;IAC5D,MAAMW,aACJT,oBAAoB,QAAQK,mBAAmB,OAC3CL,mBAAmBK,kBACnBL;IAEN,OAAO;QACLX,aAAa;YACXC,OAAOQ;YACPN,SAASgB;YACTf,WAAWS;YACXR,YAAYH;QACd;QACAI,cAAc;YACZL,OAAOU;YACPJ,MAAMa;YACNZ,WAAWQ;QACb;QACAK,KAAKtB;IACP;AACF"}

package/dist/get-response-metadata.d.ts

@@ -0,0 +1,9 @@
+export declare function getResponseMetadata(response: {
+    id?: string;
+    model?: string;
+    created?: number;
+}): {
+    id: string | undefined;
+    modelId: string | undefined;
+    timestamp: Date | undefined;
+};

package/dist/get-response-metadata.js

@@ -0,0 +1,9 @@
+export function getResponseMetadata(response) {
+    return {
+        id: response.id,
+        modelId: response.model,
+        timestamp: response.created != null ? new Date(response.created * 1000) : undefined
+    };
+}
+
+//# sourceMappingURL=get-response-metadata.js.map

package/dist/get-response-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/get-response-metadata.ts"],"sourcesContent":["export function getResponseMetadata(response: {\n  id?: string;\n  model?: string;\n  created?: number;\n}) {\n  return {\n    id: response.id,\n    modelId: response.model,\n    timestamp: response.created != null ? new Date(response.created * 1000) : undefined\n  };\n}\n"],"names":["getResponseMetadata","response","id","modelId","model","timestamp","created","Date","undefined"],"mappings":"AAAA,OAAO,SAASA,oBAAoBC,QAInC;IACC,OAAO;QACLC,IAAID,SAASC,EAAE;QACfC,SAASF,SAASG,KAAK;QACvBC,WAAWJ,SAASK,OAAO,IAAI,OAAO,IAAIC,KAAKN,SAASK,OAAO,GAAG,QAAQE;IAC5E;AACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createVolcengine, volcengine } from "./volcengine-provider";
+export type { VolcengineProvider, VolcengineProviderSettings } from "./volcengine-provider";
+export type { VolcengineChatOptions } from './volcengine-chat-options';
+export { convertVolcengineUsage } from './convert-volcengine-usage';
+export type { VolcengineUsage } from './convert-volcengine-usage';
+export { volcengineTools } from './volcengine-tools';
+export { VERSION } from './version';

package/dist/index.js

@@ -0,0 +1,6 @@
+export { createVolcengine, volcengine } from "./volcengine-provider";
+export { convertVolcengineUsage } from './convert-volcengine-usage';
+export { volcengineTools } from './volcengine-tools';
+export { VERSION } from './version';
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { createVolcengine, volcengine } from \"./volcengine-provider\";\nexport type {\n  VolcengineProvider,\n  VolcengineProviderSettings\n} from \"./volcengine-provider\";\nexport type { VolcengineChatOptions } from './volcengine-chat-options';\nexport { convertVolcengineUsage } from './convert-volcengine-usage';\nexport type { VolcengineUsage } from './convert-volcengine-usage';\nexport { volcengineTools } from './volcengine-tools';\nexport { VERSION } from './version';"],"names":["createVolcengine","volcengine","convertVolcengineUsage","volcengineTools","VERSION"],"mappings":"AAAA,SAASA,gBAAgB,EAAEC,UAAU,QAAQ,wBAAwB;AAMrE,SAASC,sBAAsB,QAAQ,6BAA6B;AAEpE,SAASC,eAAe,QAAQ,qBAAqB;AACrD,SAASC,OAAO,QAAQ,YAAY"}

package/dist/map-volcengine-finish-reason.d.ts

@@ -0,0 +1,2 @@
+import { LanguageModelV3FinishReason } from "@ai-sdk/provider";
+export declare function mapVolcengineFinishReason(finishReason: string | null | undefined): LanguageModelV3FinishReason;

package/dist/map-volcengine-finish-reason.js

@@ -0,0 +1,32 @@
+export function mapVolcengineFinishReason(finishReason) {
+    switch(finishReason){
+        case "stop":
+            return {
+                unified: "stop",
+                raw: finishReason
+            };
+        case "length":
+            return {
+                unified: "length",
+                raw: finishReason
+            };
+        case "tool_calls":
+        case "function_call":
+            return {
+                unified: "tool-calls",
+                raw: finishReason
+            };
+        case "content_filter":
+            return {
+                unified: "content-filter",
+                raw: finishReason
+            };
+        default:
+            return {
+                unified: "other",
+                raw: finishReason ?? undefined
+            };
+    }
+}
+
+//# sourceMappingURL=map-volcengine-finish-reason.js.map

package/dist/map-volcengine-finish-reason.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/map-volcengine-finish-reason.ts"],"sourcesContent":["import { LanguageModelV3FinishReason } from \"@ai-sdk/provider\";\n\nexport function mapVolcengineFinishReason(\n  finishReason: string | null | undefined\n): LanguageModelV3FinishReason {\n  switch (finishReason) {\n    case \"stop\":\n      return { unified: \"stop\", raw: finishReason };\n    case \"length\":\n      return { unified: \"length\", raw: finishReason };\n    case \"tool_calls\":\n    case \"function_call\":\n      return { unified: \"tool-calls\", raw: finishReason };\n    case \"content_filter\":\n      return { unified: \"content-filter\", raw: finishReason };\n    default:\n      return { unified: \"other\", raw: finishReason ?? undefined };\n  }\n}\n"],"names":["mapVolcengineFinishReason","finishReason","unified","raw","undefined"],"mappings":"AAEA,OAAO,SAASA,0BACdC,YAAuC;IAEvC,OAAQA;QACN,KAAK;YACH,OAAO;gBAAEC,SAAS;gBAAQC,KAAKF;YAAa;QAC9C,KAAK;YACH,OAAO;gBAAEC,SAAS;gBAAUC,KAAKF;YAAa;QAChD,KAAK;QACL,KAAK;YACH,OAAO;gBAAEC,SAAS;gBAAcC,KAAKF;YAAa;QACpD,KAAK;YACH,OAAO;gBAAEC,SAAS;gBAAkBC,KAAKF;YAAa;QACxD;YACE,OAAO;gBAAEC,SAAS;gBAASC,KAAKF,gBAAgBG;YAAU;IAC9D;AACF"}

package/dist/tool/index.d.ts

@@ -0,0 +1 @@
+export { webSearch } from "./web-search";

package/dist/tool/index.js

@@ -0,0 +1,3 @@
+export { webSearch } from "./web-search";
+
+//# sourceMappingURL=index.js.map

package/dist/tool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tool/index.ts"],"sourcesContent":["export { webSearch } from \"./web-search\";\n"],"names":["webSearch"],"mappings":"AAAA,SAASA,SAAS,QAAQ,eAAe"}

package/dist/tool/web-search.d.ts

@@ -0,0 +1,20 @@
+export interface WebSearchInput {
+    maxKeyword?: number;
+    limit?: number;
+    maxToolCalls?: number;
+    sources?: string[];
+    userLocation?: {
+        type?: "approximate";
+        country?: string;
+        region?: string;
+        city?: string;
+    };
+}
+/**
+ * Volcengine Web Search Tool
+ *
+ * Enables the model to perform web searches to retrieve up-to-date information.
+ *
+ * @see https://www.volcengine.com/docs/82379/1756990
+ */
+export declare const webSearch: import("@ai-sdk/provider-utils").ProviderToolFactory<WebSearchInput, WebSearchInput>;

package/dist/tool/web-search.js

@@ -0,0 +1,39 @@
+import { createProviderToolFactory, lazySchema, zodSchema } from "@ai-sdk/provider-utils";
+import { z } from "zod";
+/**
+ * User location for optimizing search results.
+ */ const userLocationSchema = z.object({
+    /**
+   * Location type.
+   * @default "approximate"
+   */ type: z.enum([
+        "approximate"
+    ]).default("approximate"),
+    /**
+   * Country name (e.g., "中国").
+   */ country: z.string().optional(),
+    /**
+   * Region/Province name (e.g., "浙江").
+   */ region: z.string().optional(),
+    /**
+   * City name (e.g., "杭州").
+   */ city: z.string().optional()
+});
+/**
+ * Volcengine Web Search Tool
+ *
+ * Enables the model to perform web searches to retrieve up-to-date information.
+ *
+ * @see https://www.volcengine.com/docs/82379/1756990
+ */ export const webSearch = createProviderToolFactory({
+    id: "volcengine.web_search",
+    inputSchema: lazySchema(()=>zodSchema(z.object({
+            maxKeyword: z.number().min(1).max(50).optional(),
+            limit: z.number().min(1).max(50).default(10),
+            maxToolCalls: z.number().min(1).max(10).default(3),
+            sources: z.array(z.string()).optional(),
+            userLocation: userLocationSchema.optional()
+        })))
+});
+
+//# sourceMappingURL=web-search.js.map

package/dist/tool/web-search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/tool/web-search.ts"],"sourcesContent":["import {\n  createProviderToolFactory,\n  lazySchema,\n  zodSchema,\n} from \"@ai-sdk/provider-utils\";\nimport { z } from \"zod\";\n\n/**\n * User location for optimizing search results.\n */\nconst userLocationSchema = z.object({\n  /**\n   * Location type.\n   * @default \"approximate\"\n   */\n  type: z.enum([\"approximate\"]).default(\"approximate\"),\n  /**\n   * Country name (e.g., \"中国\").\n   */\n  country: z.string().optional(),\n  /**\n   * Region/Province name (e.g., \"浙江\").\n   */\n  region: z.string().optional(),\n  /**\n   * City name (e.g., \"杭州\").\n   */\n  city: z.string().optional(),\n});\n\nexport interface WebSearchInput {\n  maxKeyword?: number;\n  limit?: number;\n  maxToolCalls?: number;\n  sources?: string[];\n  userLocation?: {\n    type?: \"approximate\";\n    country?: string;\n    region?: string;\n    city?: string;\n  };\n}\n\n/**\n * Volcengine Web Search Tool\n *\n * Enables the model to perform web searches to retrieve up-to-date information.\n *\n * @see https://www.volcengine.com/docs/82379/1756990\n */\nexport const webSearch = createProviderToolFactory<\n  WebSearchInput,\n  WebSearchInput\n>({\n  id: \"volcengine.web_search\",\n  inputSchema: lazySchema(() =>\n    zodSchema(\n      z.object({\n        maxKeyword: z.number().min(1).max(50).optional(),\n        limit: z.number().min(1).max(50).default(10),\n        maxToolCalls: z.number().min(1).max(10).default(3),\n        sources: z.array(z.string()).optional(),\n        userLocation: userLocationSchema.optional(),\n      })\n    )\n  ),\n});\n"],"names":["createProviderToolFactory","lazySchema","zodSchema","z","userLocationSchema","object","type","enum","default","country","string","optional","region","city","webSearch","id","inputSchema","maxKeyword","number","min","max","limit","maxToolCalls","sources","array","userLocation"],"mappings":"AAAA,SACEA,yBAAyB,EACzBC,UAAU,EACVC,SAAS,QACJ,yBAAyB;AAChC,SAASC,CAAC,QAAQ,MAAM;AAExB;;CAEC,GACD,MAAMC,qBAAqBD,EAAEE,MAAM,CAAC;IAClC;;;GAGC,GACDC,MAAMH,EAAEI,IAAI,CAAC;QAAC;KAAc,EAAEC,OAAO,CAAC;IACtC;;GAEC,GACDC,SAASN,EAAEO,MAAM,GAAGC,QAAQ;IAC5B;;GAEC,GACDC,QAAQT,EAAEO,MAAM,GAAGC,QAAQ;IAC3B;;GAEC,GACDE,MAAMV,EAAEO,MAAM,GAAGC,QAAQ;AAC3B;AAeA;;;;;;CAMC,GACD,OAAO,MAAMG,YAAYd,0BAGvB;IACAe,IAAI;IACJC,aAAaf,WAAW,IACtBC,UACEC,EAAEE,MAAM,CAAC;YACPY,YAAYd,EAAEe,MAAM,GAAGC,GAAG,CAAC,GAAGC,GAAG,CAAC,IAAIT,QAAQ;YAC9CU,OAAOlB,EAAEe,MAAM,GAAGC,GAAG,CAAC,GAAGC,GAAG,CAAC,IAAIZ,OAAO,CAAC;YACzCc,cAAcnB,EAAEe,MAAM,GAAGC,GAAG,CAAC,GAAGC,GAAG,CAAC,IAAIZ,OAAO,CAAC;YAChDe,SAASpB,EAAEqB,KAAK,CAACrB,EAAEO,MAAM,IAAIC,QAAQ;YACrCc,cAAcrB,mBAAmBO,QAAQ;QAC3C;AAGN,GAAG"}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/dist/version.js

@@ -0,0 +1,4 @@
+// Version string of this package injected at build time.
+export const VERSION = typeof __PACKAGE_VERSION__ !== 'undefined' ? __PACKAGE_VERSION__ : '0.0.0-test';
+
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["// Version string of this package injected at build time.\ndeclare const __PACKAGE_VERSION__: string | undefined;\nexport const VERSION: string =\n    typeof __PACKAGE_VERSION__ !== 'undefined'\n        ? __PACKAGE_VERSION__\n        : '0.0.0-test';"],"names":["VERSION","__PACKAGE_VERSION__"],"mappings":"AAAA,yDAAyD;AAEzD,OAAO,MAAMA,UACT,OAAOC,wBAAwB,cACzBA,sBACA,aAAa"}