@friendliai/ai-provider 1.0.0-beta.1 → 1.0.0-beta.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @friendliai/ai-provider
 
+## 1.0.0-beta.2
+
+### Minor Changes
+
+- 049179d: Add Linkup integrated tool helper (`friendli.tools.linkupSearch`) for Tool Assisted API.
+
+### Patch Changes
+
+- 049179d: Support Friendli serverless chat options (`topK` -> `top_k`, sampling providerOptions) and improve error propagation for HTTP and streaming tool-assisted responses.
+
 ## 1.0.0-beta.1
 
 ### Minor Changes

package/README.md

@@ -27,8 +27,28 @@ const { text } = await generateText({
   model: friendli('meta-llama-3.3-70b-instruct'),
   prompt: 'What is the meaning of life?',
   maxTokens: 20,
+  topK: 10,
+  providerOptions: {
+    friendliai: {
+      minP: 0.2,
+    },
+  },
 });
 console.log(text);
 ```
 
+### Provider Options
+
+You can pass Friendli-specific parameters using `providerOptions.friendliai`. For backward compatibility, the `friendli` key is also supported.
+
+Supported options (camelCase):
+
+- `minP`
+- `repetitionPenalty`
+- `xtcThreshold`
+- `xtcProbability`
+- `parallelToolCalls`
+- `regex` (BETA: Force output to satisfy a regular expression)
+- `chat_template_kwargs`
+
 For more details, see the [official documentation](https://friendli.ai/docs/).

package/dist/index.d.mts

@@ -2,25 +2,20 @@ import { z } from 'zod/v4';
 import { ProviderV3, LanguageModelV3, EmbeddingModelV3, ImageModelV3, TranscriptionModelV3, SpeechModelV3 } from '@ai-sdk/provider';
 import { Tool, FetchFunction } from '@ai-sdk/provider-utils';
 
-declare const friendliaiErrorSchema: z.ZodObject<{
+declare const friendliaiErrorSchema: z.ZodUnion<readonly [z.ZodObject<{
+    error: z.ZodObject<{
+        message: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$loose>, z.ZodObject<{
     message: z.ZodString;
-    error: z.ZodRecord<z.ZodString, z.ZodAny>;
-}, z.core.$strip>;
+    error: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>]>;
 type FriendliAIErrorData = z.infer<typeof friendliaiErrorSchema>;
 
 declare const FriendliAIServerlessModelIds: readonly ["MiniMaxAI/MiniMax-M2", "zai-org/GLM-4.6", "LGAI-EXAONE/EXAONE-4.0.1-32B", "skt/A.X-4.0", "skt/A.X-3.1", "naver-hyperclovax/HyperCLOVAX-SEED-Think-14B", "deepseek-ai/DeepSeek-V3.1", "deepseek-ai/DeepSeek-R1-0528", "meta-llama/Llama-4-Maverick-17B-128E-Instruct", "meta-llama/Llama-4-Scout-17B-16E-Instruct", "meta-llama/Llama-3.3-70B-Instruct", "meta-llama-3.3-70b-instruct", "meta-llama/Llama-3.1-8B-Instruct", "meta-llama-3.1-8b-instruct", "Qwen/Qwen3-235B-A22B-Thinking-2507", "Qwen/Qwen3-235B-A22B-Instruct-2507", "Qwen/Qwen3-30B-A3B", "Qwen/Qwen3-32B", "google/gemma-3-27b-it", "mistralai/Mistral-Small-3.1-24B-Instruct-2503", "mistralai/Devstral-Small-2505", "mistralai/Magistral-Small-2506"];
 type FriendliAIServerlessModelId = (typeof FriendliAIServerlessModelIds)[number];
 type FriendliAILanguageModelId = FriendliAIServerlessModelId | (string & {});
 
-/**
- * Friendli built-in tools for serverless tool-assisted API.
- *
- * @remarks
- * These tools are currently in **Beta**. While we strive to provide a stable
- * and reliable experience, this feature is still under active development.
- *
- * @see https://friendli.ai/docs/guides/serverless_endpoints/tool-assisted-api
- */
 /**
  * Web search tool - searches the web for information.
  * @beta
@@ -51,6 +46,11 @@ declare function mathCalculator(): Tool;
  * @beta
  */
 declare function codePythonInterpreter(): Tool;
+/**
+ * Linkup search tool - searches the web for real-time information with citations.
+ * @see https://www.linkup.so
+ */
+declare function linkupSearch(): Tool;
 declare const friendliTools: {
     webSearch: typeof webSearch;
     webUrl: typeof webUrl;
@@ -58,6 +58,7 @@ declare const friendliTools: {
     mathStatistics: typeof mathStatistics;
     mathCalculator: typeof mathCalculator;
     codePythonInterpreter: typeof codePythonInterpreter;
+    linkupSearch: typeof linkupSearch;
 };
 
 type Pricing = {
@@ -103,6 +104,10 @@ interface FriendliAIProviderSettings {
      * or to provide a custom fetch implementation for e.g. testing.
      */
     fetch?: FetchFunction;
+    /**
+     * Whether to include usage information in the response.
+     */
+    includeUsage?: boolean;
 }
 interface FriendliAIProvider extends ProviderV3 {
     /**

package/dist/index.d.ts

@@ -2,25 +2,20 @@ import { z } from 'zod/v4';
 import { ProviderV3, LanguageModelV3, EmbeddingModelV3, ImageModelV3, TranscriptionModelV3, SpeechModelV3 } from '@ai-sdk/provider';
 import { Tool, FetchFunction } from '@ai-sdk/provider-utils';
 
-declare const friendliaiErrorSchema: z.ZodObject<{
+declare const friendliaiErrorSchema: z.ZodUnion<readonly [z.ZodObject<{
+    error: z.ZodObject<{
+        message: z.ZodString;
+    }, z.core.$loose>;
+}, z.core.$loose>, z.ZodObject<{
     message: z.ZodString;
-    error: z.ZodRecord<z.ZodString, z.ZodAny>;
-}, z.core.$strip>;
+    error: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>]>;
 type FriendliAIErrorData = z.infer<typeof friendliaiErrorSchema>;
 
 declare const FriendliAIServerlessModelIds: readonly ["MiniMaxAI/MiniMax-M2", "zai-org/GLM-4.6", "LGAI-EXAONE/EXAONE-4.0.1-32B", "skt/A.X-4.0", "skt/A.X-3.1", "naver-hyperclovax/HyperCLOVAX-SEED-Think-14B", "deepseek-ai/DeepSeek-V3.1", "deepseek-ai/DeepSeek-R1-0528", "meta-llama/Llama-4-Maverick-17B-128E-Instruct", "meta-llama/Llama-4-Scout-17B-16E-Instruct", "meta-llama/Llama-3.3-70B-Instruct", "meta-llama-3.3-70b-instruct", "meta-llama/Llama-3.1-8B-Instruct", "meta-llama-3.1-8b-instruct", "Qwen/Qwen3-235B-A22B-Thinking-2507", "Qwen/Qwen3-235B-A22B-Instruct-2507", "Qwen/Qwen3-30B-A3B", "Qwen/Qwen3-32B", "google/gemma-3-27b-it", "mistralai/Mistral-Small-3.1-24B-Instruct-2503", "mistralai/Devstral-Small-2505", "mistralai/Magistral-Small-2506"];
 type FriendliAIServerlessModelId = (typeof FriendliAIServerlessModelIds)[number];
 type FriendliAILanguageModelId = FriendliAIServerlessModelId | (string & {});
 
-/**
- * Friendli built-in tools for serverless tool-assisted API.
- *
- * @remarks
- * These tools are currently in **Beta**. While we strive to provide a stable
- * and reliable experience, this feature is still under active development.
- *
- * @see https://friendli.ai/docs/guides/serverless_endpoints/tool-assisted-api
- */
 /**
  * Web search tool - searches the web for information.
  * @beta
@@ -51,6 +46,11 @@ declare function mathCalculator(): Tool;
  * @beta
  */
 declare function codePythonInterpreter(): Tool;
+/**
+ * Linkup search tool - searches the web for real-time information with citations.
+ * @see https://www.linkup.so
+ */
+declare function linkupSearch(): Tool;
 declare const friendliTools: {
     webSearch: typeof webSearch;
     webUrl: typeof webUrl;
@@ -58,6 +58,7 @@ declare const friendliTools: {
     mathStatistics: typeof mathStatistics;
     mathCalculator: typeof mathCalculator;
     codePythonInterpreter: typeof codePythonInterpreter;
+    linkupSearch: typeof linkupSearch;
 };
 
 type Pricing = {
@@ -103,6 +104,10 @@ interface FriendliAIProviderSettings {
      * or to provide a custom fetch implementation for e.g. testing.
      */
     fetch?: FetchFunction;
+    /**
+     * Whether to include usage information in the response.
+     */
+    includeUsage?: boolean;
 }
 interface FriendliAIProvider extends ProviderV3 {
     /**