@ai-sdk/perplexity 2.1.0-beta.8 → 2.1.0

package/CHANGELOG.md

@@ -1,87 +1,273 @@
 # @ai-sdk/perplexity
 
-## 2.1.0-beta.8
+## 2.1.0
+
+### Minor Changes
+
+- 9e05839: BREAKING: Migrate language generation from the Sonar Chat Completions API (supported by Perplexity only until September 27, 2026) to the Agent API. Replace Sonar model IDs and provider options with Agent API presets, models, and tools. The new API changes request and response metadata, raw stream events, usage and cost data, and does not support Sonar PDF input or image and video results. Reasoning effort is configured through `providerOptions.perplexity.reasoning`. Agent API stream events with `null` fields are accepted.
+
+## 2.0.45
 
 ### Patch Changes
 
-- Updated dependencies [e06565c]
-  - @ai-sdk/provider-utils@3.1.0-beta.8
+- bf29419: chore: enable dead code lint rules
+- Updated dependencies [bf29419]
+  - @ai-sdk/provider-utils@3.0.39
 
-## 2.1.0-beta.7
+## 2.0.44
 
 ### Patch Changes
 
-- Updated dependencies [046aa3b]
-- Updated dependencies [e8109d3]
-  - @ai-sdk/provider@2.1.0-beta.5
-  - @ai-sdk/provider-utils@3.1.0-beta.7
+- Updated dependencies [594787e]
+  - @ai-sdk/provider@2.0.5
+  - @ai-sdk/provider-utils@3.0.38
 
-## 2.1.0-beta.6
+## 2.0.43
 
 ### Patch Changes
 
-- Updated dependencies [0adc679]
-- Updated dependencies [2b0caef]
-  - @ai-sdk/provider-utils@3.1.0-beta.6
-  - @ai-sdk/provider@2.1.0-beta.4
+- Updated dependencies [c2089a9]
+- Updated dependencies [ab3990f]
+  - @ai-sdk/provider@2.0.4
+  - @ai-sdk/provider-utils@3.0.37
 
-## 2.1.0-beta.5
+## 2.0.42
 
 ### Patch Changes
 
-- 8dac895: feat: `LanguageModelV3`
-- 10c1322: fix: moved dependency `@ai-sdk/test-server` to devDependencies
-- Updated dependencies [8dac895]
-  - @ai-sdk/provider-utils@3.1.0-beta.5
-  - @ai-sdk/provider@2.1.0-beta.3
+- Updated dependencies [26165ee]
+  - @ai-sdk/provider-utils@3.0.36
 
-## 2.1.0-beta.4
+## 2.0.41
 
 ### Patch Changes
 
-- 4616b86: chore: update zod peer depenedency version
-- Updated dependencies [4616b86]
-  - @ai-sdk/provider-utils@3.1.0-beta.4
+- Updated dependencies [77d33c0]
+  - @ai-sdk/provider-utils@3.0.35
 
-## 2.1.0-beta.3
+## 2.0.40
 
 ### Patch Changes
 
-- ed329cb: feat: `Provider-V3`
-- Updated dependencies [ed329cb]
-- Updated dependencies [522f6b8]
-  - @ai-sdk/provider@2.1.0-beta.2
-  - @ai-sdk/provider-utils@3.1.0-beta.3
+- Updated dependencies [2fff9f1]
+- Updated dependencies [f364ea0]
+  - @ai-sdk/provider-utils@3.0.34
 
-## 2.1.0-beta.2
+## 2.0.39
 
 ### Patch Changes
 
-- 1cad0ab: feat: add provider version to user-agent header
-- Updated dependencies [0c4822d]
-  - @ai-sdk/provider@2.1.0-beta.1
-  - @ai-sdk/provider-utils@3.1.0-beta.2
+- Updated dependencies [9e8e087]
+  - @ai-sdk/provider-utils@3.0.33
 
-## 2.1.0-beta.1
+## 2.0.38
 
 ### Patch Changes
 
-- Updated dependencies [953d0f2]
-- Updated dependencies [cbb1d35]
-  - @ai-sdk/test-server@1.0.0-beta.0
-  - @ai-sdk/provider-utils@3.1.0-beta.1
+- Updated dependencies [0e51b7b]
+  - @ai-sdk/provider-utils@3.0.32
 
-## 2.1.0-beta.0
+## 2.0.37
 
-### Minor Changes
+### Patch Changes
+
+- Updated dependencies [7a6bdbc]
+  - @ai-sdk/provider-utils@3.0.31
+
+## 2.0.36
+
+### Patch Changes
+
+- Updated dependencies [2fd6076]
+  - @ai-sdk/provider-utils@3.0.30
+
+## 2.0.35
+
+### Patch Changes
+
+- Updated dependencies [c6e1d1a]
+  - @ai-sdk/provider-utils@3.0.29
+
+## 2.0.34
+
+### Patch Changes
+
+- 509f1c6: Fix Perplexity prompt conversion for file parts with unsupported media types and top-level PDF media types.
+
+## 2.0.33
+
+### Patch Changes
+
+- Updated dependencies [b85c4fb]
+  - @ai-sdk/provider-utils@3.0.28
+
+## 2.0.32
+
+### Patch Changes
+
+- Updated dependencies [9169261]
+  - @ai-sdk/provider-utils@3.0.27
+
+## 2.0.31
+
+### Patch Changes
+
+- Updated dependencies [9f67efe]
+- Updated dependencies [eea9166]
+  - @ai-sdk/provider-utils@3.0.26
+
+## 2.0.30
+
+### Patch Changes
+
+- 783fa6c: chore: ensure consistent import handling and avoid import duplicates or cycles
+- Updated dependencies [783fa6c]
+  - @ai-sdk/provider-utils@3.0.25
+  - @ai-sdk/provider@2.0.3
+
+## 2.0.29
+
+### Patch Changes
+
+- 0a00b9b: trigger release for all packages after provenance setup
+- Updated dependencies [0a00b9b]
+  - @ai-sdk/provider@2.0.2
+  - @ai-sdk/provider-utils@3.0.24
+
+## 2.0.28
+
+### Patch Changes
+
+- 5543cd1: Add AI Gateway hint to provider READMEs
+
+## 2.0.27
+
+### Patch Changes
+
+- Updated dependencies [a27a978]
+  - @ai-sdk/provider-utils@3.0.23
+
+## 2.0.26
+
+### Patch Changes
+
+- e70fd60: feat(perplexity): expose provider-reported cost in providerMetadata
+
+## 2.0.25
+
+### Patch Changes
+
+- Updated dependencies [6a2f01b]
+- Updated dependencies [17d64e3]
+  - @ai-sdk/provider-utils@3.0.22
+
+## 2.0.24
+
+### Patch Changes
+
+- Updated dependencies [20565b8]
+  - @ai-sdk/provider-utils@3.0.21
+
+## 2.0.23
+
+### Patch Changes
+
+- 526fe8d: fix: trigger new release for `@ai-v5` dist-tag
+- Updated dependencies [526fe8d]
+  - @ai-sdk/provider@2.0.1
+  - @ai-sdk/provider-utils@3.0.20
+
+## 2.0.22
+
+### Patch Changes
+
+- Updated dependencies [ef6d784]
+  - @ai-sdk/provider-utils@3.0.19
+
+## 2.0.21
+
+### Patch Changes
+
+- Updated dependencies [d1dbe5d]
+  - @ai-sdk/provider-utils@3.0.18
+
+## 2.0.20
+
+### Patch Changes
+
+- 7b99331: feat (provider/perplexity): add reasoning tokens
+
+## 2.0.19
+
+### Patch Changes
+
+- Updated dependencies [056c471]
+  - @ai-sdk/provider-utils@3.0.17
+
+## 2.0.18
+
+### Patch Changes
+
+- ee28981: Add PDF support to Perplexity provider
+
+## 2.0.17
+
+### Patch Changes
+
+- 51aa5de: backport: test server
+- Updated dependencies [51aa5de]
+  - @ai-sdk/provider-utils@3.0.16
+
+## 2.0.16
+
+### Patch Changes
+
+- Updated dependencies [f2da310]
+  - @ai-sdk/provider-utils@3.0.15
+
+## 2.0.15
+
+### Patch Changes
+
+- Updated dependencies [949718b]
+  - @ai-sdk/provider-utils@3.0.14
+
+## 2.0.14
+
+### Patch Changes
+
+- Updated dependencies [1e05490]
+  - @ai-sdk/provider-utils@3.0.13
+
+## 2.0.13
+
+### Patch Changes
+
+- Updated dependencies [17f9872]
+  - @ai-sdk/provider-utils@3.0.12
+
+## 2.0.12
+
+### Patch Changes
+
+- 6f0644c: chore: use import \* from zod/v4
+- Updated dependencies [6f0644c]
+- Updated dependencies [6f0644c]
+  - @ai-sdk/provider-utils@3.0.11
+
+## 2.0.11
+
+### Patch Changes
+
+- bc5ed71: chore: update zod peer depenedency version
+- Updated dependencies [bc5ed71]
+  - @ai-sdk/provider-utils@3.0.10
 
-- 78928cb: release: start 5.1 beta
+## 2.0.10
 
 ### Patch Changes
 
-- Updated dependencies [78928cb]
-  - @ai-sdk/provider@2.1.0-beta.0
-  - @ai-sdk/provider-utils@3.1.0-beta.0
+- 322901b: feat: add provider version to user-agent header
 
 ## 2.0.9
 

package/README.md

@@ -1,18 +1,17 @@
 # AI SDK - Perplexity Provider
 
 The **[Perplexity provider](https://ai-sdk.dev/providers/ai-sdk-providers/perplexity)** for the [AI SDK](https://ai-sdk.dev/docs)
-contains language model support for Perplexity's Sonar API - a powerful answer engine with real-time web search capabilities.
+contains language model support for Perplexity's Agent API, including web search, citations, function tools, and structured output.
 
 ## Features
 
 - Real-time web search grounding for accurate, up-to-date responses
-- Support for advanced queries and follow-up questions
-- Multiple tiers available:
-  - **Sonar Pro**: Enhanced capabilities for complex tasks with 2x more citations
-  - **Sonar**: Lightweight offering optimized for speed and cost
-- Industry-leading answer quality
-- Data privacy - no training on customer data
-- Self-serve API access with scalable pricing
+- Agent API presets from `fast` through `xhigh`
+- Direct access to supported third-party models through Perplexity
+- Native tools for web search, URL fetching, code execution, finance, MCP, and connectors
+- AI SDK function tools, structured output, reasoning streams, and multi-turn tool calls
+
+> **Deploying to Vercel?** With Vercel's AI Gateway you can access Perplexity (and hundreds of models from other providers) — no additional packages, API keys, or extra cost. [Get started with AI Gateway](https://vercel.com/ai-gateway).
 
 ## Setup
 
@@ -37,11 +36,23 @@ import { perplexity } from '@ai-sdk/perplexity';
 import { generateText } from 'ai';
 
 const { text } = await generateText({
-  model: perplexity('sonar-pro'),
+  model: perplexity('low'),
   prompt: 'What are the latest developments in quantum computing?',
 });
 ```
 
+Version 2.1.0 is a breaking migration from Sonar Chat Completions to the Agent
+API. Legacy Sonar model IDs and provider options are not mapped. Review the
+[migration notes](https://ai-sdk.dev/providers/ai-sdk-providers/perplexity#migrating-from-v4-sonar-to-v5-agent-api)
+before upgrading an existing application (the notes refer to the Sonar-based
+releases as v4 and the Agent API releases as v5; for AI SDK 5 these are
+2.0.45 and earlier, and 2.1.0 and later).
+
+Perplexity supports Sonar Chat Completions only until September 27, 2026.
+Remaining on version 2.0.45 or earlier will not preserve language generation
+after that date.
+Migrate unsupported Sonar features using the alternatives in the migration notes.
+
 ## Documentation
 
 Please check out the **[Perplexity provider documentation](https://ai-sdk.dev/providers/ai-sdk-providers/perplexity)** for more information.

package/dist/index.d.mts

@@ -1,21 +1,23 @@
-import { ProviderV3, LanguageModelV3 } from '@ai-sdk/provider';
+import { ProviderV2, LanguageModelV2 } from '@ai-sdk/provider';
 import { FetchFunction } from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
 
-type PerplexityLanguageModelId = 'sonar-deep-research' | 'sonar-reasoning-pro' | 'sonar-reasoning' | 'sonar-pro' | 'sonar' | (string & {});
+type PerplexityAgentPreset = 'fast' | 'low' | 'medium' | 'high' | 'xhigh';
+type PerplexityLanguageModelId = PerplexityAgentPreset | 'perplexity/sonar' | (string & {});
 
-interface PerplexityProvider extends ProviderV3 {
+interface PerplexityProvider extends ProviderV2 {
     /**
-  Creates an Perplexity chat model for text generation.
+  Creates a Perplexity Agent API model or preset for text generation.
      */
-    (modelId: PerplexityLanguageModelId): LanguageModelV3;
+    (modelId: PerplexityLanguageModelId): LanguageModelV2;
     /**
-  Creates an Perplexity language model for text generation.
+  Creates a Perplexity Agent API model or preset for text generation.
      */
-    languageModel(modelId: PerplexityLanguageModelId): LanguageModelV3;
+    languageModel(modelId: PerplexityLanguageModelId): LanguageModelV2;
 }
 interface PerplexityProviderSettings {
     /**
-  Base URL for the perplexity API calls.
+  Base URL for Perplexity API calls.
        */
     baseURL?: string;
     /**
@@ -35,6 +37,112 @@ interface PerplexityProviderSettings {
 declare function createPerplexity(options?: PerplexityProviderSettings): PerplexityProvider;
 declare const perplexity: PerplexityProvider;
 
+declare const perplexityLanguageModelOptions: z.ZodObject<{
+    /** Top-level Agent API instructions. */
+    instructions: z.ZodOptional<z.ZodString>;
+    /**
+     * Native Agent API tools. AI SDK function tools can also be supplied through
+     * the top-level `tools` option on `generateText` and `streamText`.
+     */
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"web_search">;
+        filters: z.ZodOptional<z.ZodObject<{
+            search_domain_filter: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            search_recency_filter: z.ZodOptional<z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                year: "year";
+            }>>;
+            search_after_date_filter: z.ZodOptional<z.ZodString>;
+            search_before_date_filter: z.ZodOptional<z.ZodString>;
+            last_updated_after_filter: z.ZodOptional<z.ZodString>;
+            last_updated_before_filter: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        max_results: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        max_tokens_per_page: z.ZodOptional<z.ZodNumber>;
+        search_context_size: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        user_location: z.ZodOptional<z.ZodObject<{
+            latitude: z.ZodOptional<z.ZodNumber>;
+            longitude: z.ZodOptional<z.ZodNumber>;
+            country: z.ZodOptional<z.ZodString>;
+            city: z.ZodOptional<z.ZodString>;
+            region: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"fetch_url">;
+        max_urls: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"people_search">;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"finance_search">;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"sandbox">;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"mcp">;
+        server_label: z.ZodString;
+        server_url: z.ZodString;
+        allowed_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        authorization: z.ZodOptional<z.ZodString>;
+        defer_loading: z.ZodOptional<z.ZodBoolean>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"connector">;
+        id: z.ZodString;
+        server_label: z.ZodString;
+        server_description: z.ZodOptional<z.ZodString>;
+        allowed_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$loose>]>>>;
+    /** A fallback model list for Agent API routing. */
+    models: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    /** Maximum number of agentic steps. */
+    max_steps: z.ZodOptional<z.ZodNumber>;
+    /** Maximum number of native tool calls. */
+    max_tool_calls: z.ZodOptional<z.ZodNumber>;
+    /** Continue a conversation from an earlier Agent API response. */
+    previous_response_id: z.ZodOptional<z.ZodString>;
+    /**
+     * Whether the response can be retrieved later. Setting this to false does
+     * not disable persistence or prevent previous_response_id continuations.
+     */
+    store: z.ZodOptional<z.ZodBoolean>;
+    /** Preferred response language as an ISO 639-1 language code. */
+    language_preference: z.ZodOptional<z.ZodString>;
+    /** Agent API reasoning configuration. */
+    reasoning: z.ZodOptional<z.ZodObject<{
+        effort: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            minimal: "minimal";
+            xhigh: "xhigh";
+        }>>;
+    }, z.core.$loose>>;
+    /** Agent API skill configuration. */
+    skills: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"builtin">;
+        name: z.ZodEnum<{
+            office: "office";
+            "office/docx": "office/docx";
+            "office/pdf": "office/pdf";
+            "office/pptx": "office/pptx";
+            "office/xlsx": "office/xlsx";
+        }>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"inline">;
+        name: z.ZodString;
+        description: z.ZodString;
+        instructions: z.ZodString;
+    }, z.core.$loose>]>>>;
+}, z.core.$loose>;
+type PerplexityLanguageModelOptions = z.infer<typeof perplexityLanguageModelOptions>;
+
 declare const VERSION: string;
 
-export { type PerplexityProvider, type PerplexityProviderSettings, VERSION, createPerplexity, perplexity };
+export { type PerplexityAgentPreset, type PerplexityLanguageModelId, type PerplexityLanguageModelOptions, type PerplexityProvider, type PerplexityProviderSettings, VERSION, createPerplexity, perplexity };

package/dist/index.d.ts

@@ -1,21 +1,23 @@
-import { ProviderV3, LanguageModelV3 } from '@ai-sdk/provider';
+import { ProviderV2, LanguageModelV2 } from '@ai-sdk/provider';
 import { FetchFunction } from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
 
-type PerplexityLanguageModelId = 'sonar-deep-research' | 'sonar-reasoning-pro' | 'sonar-reasoning' | 'sonar-pro' | 'sonar' | (string & {});
+type PerplexityAgentPreset = 'fast' | 'low' | 'medium' | 'high' | 'xhigh';
+type PerplexityLanguageModelId = PerplexityAgentPreset | 'perplexity/sonar' | (string & {});
 
-interface PerplexityProvider extends ProviderV3 {
+interface PerplexityProvider extends ProviderV2 {
     /**
-  Creates an Perplexity chat model for text generation.
+  Creates a Perplexity Agent API model or preset for text generation.
      */
-    (modelId: PerplexityLanguageModelId): LanguageModelV3;
+    (modelId: PerplexityLanguageModelId): LanguageModelV2;
     /**
-  Creates an Perplexity language model for text generation.
+  Creates a Perplexity Agent API model or preset for text generation.
      */
-    languageModel(modelId: PerplexityLanguageModelId): LanguageModelV3;
+    languageModel(modelId: PerplexityLanguageModelId): LanguageModelV2;
 }
 interface PerplexityProviderSettings {
     /**
-  Base URL for the perplexity API calls.
+  Base URL for Perplexity API calls.
        */
     baseURL?: string;
     /**
@@ -35,6 +37,112 @@ interface PerplexityProviderSettings {
 declare function createPerplexity(options?: PerplexityProviderSettings): PerplexityProvider;
 declare const perplexity: PerplexityProvider;
 
+declare const perplexityLanguageModelOptions: z.ZodObject<{
+    /** Top-level Agent API instructions. */
+    instructions: z.ZodOptional<z.ZodString>;
+    /**
+     * Native Agent API tools. AI SDK function tools can also be supplied through
+     * the top-level `tools` option on `generateText` and `streamText`.
+     */
+    tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"web_search">;
+        filters: z.ZodOptional<z.ZodObject<{
+            search_domain_filter: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            search_recency_filter: z.ZodOptional<z.ZodEnum<{
+                hour: "hour";
+                day: "day";
+                week: "week";
+                month: "month";
+                year: "year";
+            }>>;
+            search_after_date_filter: z.ZodOptional<z.ZodString>;
+            search_before_date_filter: z.ZodOptional<z.ZodString>;
+            last_updated_after_filter: z.ZodOptional<z.ZodString>;
+            last_updated_before_filter: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+        max_results: z.ZodOptional<z.ZodNumber>;
+        max_tokens: z.ZodOptional<z.ZodNumber>;
+        max_tokens_per_page: z.ZodOptional<z.ZodNumber>;
+        search_context_size: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+        }>>;
+        user_location: z.ZodOptional<z.ZodObject<{
+            latitude: z.ZodOptional<z.ZodNumber>;
+            longitude: z.ZodOptional<z.ZodNumber>;
+            country: z.ZodOptional<z.ZodString>;
+            city: z.ZodOptional<z.ZodString>;
+            region: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"fetch_url">;
+        max_urls: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"people_search">;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"finance_search">;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"sandbox">;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"mcp">;
+        server_label: z.ZodString;
+        server_url: z.ZodString;
+        allowed_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        authorization: z.ZodOptional<z.ZodString>;
+        defer_loading: z.ZodOptional<z.ZodBoolean>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"connector">;
+        id: z.ZodString;
+        server_label: z.ZodString;
+        server_description: z.ZodOptional<z.ZodString>;
+        allowed_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$loose>]>>>;
+    /** A fallback model list for Agent API routing. */
+    models: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    /** Maximum number of agentic steps. */
+    max_steps: z.ZodOptional<z.ZodNumber>;
+    /** Maximum number of native tool calls. */
+    max_tool_calls: z.ZodOptional<z.ZodNumber>;
+    /** Continue a conversation from an earlier Agent API response. */
+    previous_response_id: z.ZodOptional<z.ZodString>;
+    /**
+     * Whether the response can be retrieved later. Setting this to false does
+     * not disable persistence or prevent previous_response_id continuations.
+     */
+    store: z.ZodOptional<z.ZodBoolean>;
+    /** Preferred response language as an ISO 639-1 language code. */
+    language_preference: z.ZodOptional<z.ZodString>;
+    /** Agent API reasoning configuration. */
+    reasoning: z.ZodOptional<z.ZodObject<{
+        effort: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            medium: "medium";
+            high: "high";
+            minimal: "minimal";
+            xhigh: "xhigh";
+        }>>;
+    }, z.core.$loose>>;
+    /** Agent API skill configuration. */
+    skills: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"builtin">;
+        name: z.ZodEnum<{
+            office: "office";
+            "office/docx": "office/docx";
+            "office/pdf": "office/pdf";
+            "office/pptx": "office/pptx";
+            "office/xlsx": "office/xlsx";
+        }>;
+    }, z.core.$loose>, z.ZodObject<{
+        type: z.ZodLiteral<"inline">;
+        name: z.ZodString;
+        description: z.ZodString;
+        instructions: z.ZodString;
+    }, z.core.$loose>]>>>;
+}, z.core.$loose>;
+type PerplexityLanguageModelOptions = z.infer<typeof perplexityLanguageModelOptions>;
+
 declare const VERSION: string;
 
-export { type PerplexityProvider, type PerplexityProviderSettings, VERSION, createPerplexity, perplexity };
+export { type PerplexityAgentPreset, type PerplexityLanguageModelId, type PerplexityLanguageModelOptions, type PerplexityProvider, type PerplexityProviderSettings, VERSION, createPerplexity, perplexity };