@ai-sdk/perplexity 4.0.52 → 5.0.0

package/src/perplexity-options.ts

@@ -1,8 +1,11 @@
-// https://docs.perplexity.ai/models/model-cards
+export type PerplexityAgentPreset =
+  | 'fast'
+  | 'low'
+  | 'medium'
+  | 'high'
+  | 'xhigh';
+
 export type PerplexityLanguageModelId =
-  | 'sonar-deep-research'
-  | 'sonar-reasoning-pro'
-  | 'sonar-reasoning'
-  | 'sonar-pro'
-  | 'sonar'
+  | PerplexityAgentPreset
+  | 'perplexity/sonar'
   | (string & {});

package/src/perplexity-prepare-tools.ts

@@ -0,0 +1,48 @@
+import type {
+  LanguageModelV4CallOptions,
+  SharedV4Warning,
+} from '@ai-sdk/provider';
+import type { PerplexityAgentTool } from './perplexity-agent-api';
+
+export function preparePerplexityTools({
+  tools,
+  toolChoice,
+}: {
+  tools: LanguageModelV4CallOptions['tools'];
+  toolChoice: LanguageModelV4CallOptions['toolChoice'];
+}): {
+  tools: PerplexityAgentTool[];
+  warnings: SharedV4Warning[];
+} {
+  const preparedTools: PerplexityAgentTool[] = [];
+  const warnings: SharedV4Warning[] = [];
+
+  for (const tool of tools ?? []) {
+    if (tool.type === 'provider') {
+      warnings.push({
+        type: 'unsupported',
+        feature: `provider-defined tool ${tool.name}`,
+      });
+      continue;
+    }
+
+    preparedTools.push({
+      type: 'function',
+      name: tool.name,
+      description: tool.description,
+      parameters: tool.inputSchema,
+      strict: tool.strict,
+    });
+  }
+
+  if (toolChoice != null && toolChoice.type !== 'auto') {
+    warnings.push({
+      type: 'unsupported',
+      feature: 'toolChoice',
+      details:
+        'The Perplexity Agent API currently selects tools automatically.',
+    });
+  }
+
+  return { tools: preparedTools, warnings };
+}

package/src/perplexity-provider.ts

@@ -19,12 +19,12 @@ import { VERSION } from './version';
 
 export interface PerplexityProvider extends ProviderV4 {
   /**
-   * Creates an Perplexity chat model for text generation.
+   * Creates a Perplexity Agent API model or preset for text generation.
    */
   (modelId: PerplexityLanguageModelId): LanguageModelV4;
 
   /**
-   * Creates an Perplexity language model for text generation.
+   * Creates a Perplexity Agent API model or preset for text generation.
    */
   languageModel(modelId: PerplexityLanguageModelId): LanguageModelV4;
 
@@ -46,7 +46,7 @@ export interface PerplexityProvider extends ProviderV4 {
 
 export interface PerplexityProviderSettings {
   /**
-   * Base URL for the perplexity API calls.
+   * Base URL for Perplexity API calls.
    */
   baseURL?: string;
 

package/src/convert-to-perplexity-messages.ts

@@ -1,143 +0,0 @@
-import {
-  UnsupportedFunctionalityError,
-  type LanguageModelV4Prompt,
-} from '@ai-sdk/provider';
-import type {
-  PerplexityMessageContent,
-  PerplexityPrompt,
-} from './perplexity-language-model-prompt';
-import {
-  convertUint8ArrayToBase64,
-  getTopLevelMediaType,
-  resolveFullMediaType,
-} from '@ai-sdk/provider-utils';
-
-export function convertToPerplexityMessages(
-  prompt: LanguageModelV4Prompt,
-): PerplexityPrompt {
-  const messages: PerplexityPrompt = [];
-
-  for (const { role, content } of prompt) {
-    switch (role) {
-      case 'system': {
-        messages.push({ role: 'system', content });
-        break;
-      }
-
-      case 'user':
-      case 'assistant': {
-        const hasMultipartContent = content.some(
-          part =>
-            (part.type === 'file' &&
-              getTopLevelMediaType(part.mediaType) === 'image') ||
-            (part.type === 'file' &&
-              getTopLevelMediaType(part.mediaType) === 'application'),
-        );
-
-        const messageContent = content
-          .map((part, index) => {
-            switch (part.type) {
-              case 'text': {
-                return {
-                  type: 'text',
-                  text: part.text,
-                };
-              }
-              case 'file': {
-                switch (part.data.type) {
-                  case 'reference': {
-                    throw new UnsupportedFunctionalityError({
-                      functionality: 'file parts with provider references',
-                    });
-                  }
-                  case 'text': {
-                    throw new UnsupportedFunctionalityError({
-                      functionality: 'text file parts',
-                    });
-                  }
-                  case 'url':
-                  case 'data': {
-                    const topLevelMediaType = getTopLevelMediaType(
-                      part.mediaType,
-                    );
-
-                    if (topLevelMediaType === 'application') {
-                      const fullMediaType = resolveFullMediaType({ part });
-
-                      if (fullMediaType !== 'application/pdf') {
-                        throw new UnsupportedFunctionalityError({
-                          functionality: `file part media type ${fullMediaType}`,
-                        });
-                      }
-
-                      return part.data.type === 'url'
-                        ? {
-                            type: 'file_url',
-                            file_url: {
-                              url: part.data.url.toString(),
-                            },
-                            file_name: part.filename,
-                          }
-                        : {
-                            type: 'file_url',
-                            file_url: {
-                              url:
-                                typeof part.data.data === 'string'
-                                  ? part.data.data
-                                  : convertUint8ArrayToBase64(part.data.data),
-                            },
-                            file_name: part.filename || `document-${index}.pdf`,
-                          };
-                    } else if (topLevelMediaType === 'image') {
-                      return part.data.type === 'url'
-                        ? {
-                            type: 'image_url',
-                            image_url: {
-                              url: part.data.url.toString(),
-                            },
-                          }
-                        : {
-                            type: 'image_url',
-                            image_url: {
-                              url: `data:${resolveFullMediaType({ part })};base64,${
-                                typeof part.data.data === 'string'
-                                  ? part.data.data
-                                  : convertUint8ArrayToBase64(part.data.data)
-                              }`,
-                            },
-                          };
-                    }
-                    throw new UnsupportedFunctionalityError({
-                      functionality: `file part media type ${part.mediaType}`,
-                    });
-                  }
-                }
-              }
-            }
-          })
-          .filter(Boolean) as PerplexityMessageContent[];
-        messages.push({
-          role,
-          content: hasMultipartContent
-            ? messageContent
-            : messageContent
-                .filter(part => part.type === 'text')
-                .map(part => part.text)
-                .join(''),
-        });
-        break;
-      }
-      case 'tool': {
-        throw new UnsupportedFunctionalityError({
-          functionality: 'Tool messages',
-        });
-      }
-      default: {
-        const _exhaustiveCheck: never = role;
-        throw new Error(`Unsupported role: ${_exhaustiveCheck}`);
-      }
-    }
-  }
-
-  return messages;
-}