From d76a5b4f2aa892c38592f73f648806f37d8bae7f Mon Sep 17 00:00:00 2001
From: Rin <shinohara-rin@users.noreply.github.com>
Date: Wed, 18 Feb 2026 05:27:24 +0800
Subject: [PATCH] fix(stage-ui): hardcode Perplexity models and disable dynamic
 listing (#1038)

This fixes the 404 error on the settings page for the Perplexity provider by:
1. Removing the `model_list` validation check, as Perplexity does not support a standard `/models` endpoint compatible with the validator.
2. Hardcoding the list of supported Sonar models (`sonar`, `sonar-pro`, `sonar-reasoning-pro`, `sonar-deep-research`) in the provider capabilities.
3. Ensuring `sonar` is the first model in the list so it is used for connectivity health checks.

Changes applied to both `packages/stage-ui/src/libs/providers/providers/perplexity-ai/index.ts` and `packages/stage-ui/src/stores/providers.ts`.

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
Co-authored-by: shinohara-rin <25588514+shinohara-rin@users.noreply.github.com>
---
 .../providers/perplexity-ai/index.ts          | 38 ++++++++++++++++++-
 packages/stage-ui/src/stores/providers.ts     | 34 ++++++++++++++++-
 2 files changed, 70 insertions(+), 2 deletions(-)

diff --git a/packages/stage-ui/src/libs/providers/providers/perplexity-ai/index.ts b/packages/stage-ui/src/libs/providers/providers/perplexity-ai/index.ts
index 6181e0b74..84e741dbf 100644
--- a/packages/stage-ui/src/libs/providers/providers/perplexity-ai/index.ts
+++ b/packages/stage-ui/src/libs/providers/providers/perplexity-ai/index.ts
@@ -1,3 +1,5 @@
+import type { ModelInfo } from '../../types'
+
 import { createPerplexity } from '@xsai-ext/providers/create'
 import { z } from 'zod'
 
@@ -45,9 +47,43 @@ export const providerPerplexityAI = defineProvider<PerplexityConfig>({
   validationRequiredWhen(config) {
     return !!config.apiKey?.trim()
   },
+  extraMethods: {
+    async listModels() {
+      return [
+        {
+          id: 'sonar',
+          name: 'Sonar',
+          provider: 'perplexity-ai',
+          description: 'Lightweight, cost-effective search model with grounding.',
+          contextLength: 127072,
+        },
+        {
+          id: 'sonar-pro',
+          name: 'Sonar Pro',
+          provider: 'perplexity-ai',
+          description: 'Advanced search offering with grounding, supporting complex queries and follow-ups.',
+          contextLength: 200000,
+        },
+        {
+          id: 'sonar-reasoning-pro',
+          name: 'Sonar Reasoning Pro',
+          provider: 'perplexity-ai',
+          description: 'Precise reasoning offering with Chain of Thought (CoT).',
+          contextLength: 127072,
+        },
+        {
+          id: 'sonar-deep-research',
+          name: 'Sonar Deep Research',
+          provider: 'perplexity-ai',
+          description: 'Expert-level research model conducting exhaustive searches and generating comprehensive reports.',
+          contextLength: 200000,
+        },
+      ] satisfies ModelInfo[]
+    },
+  },
   validators: {
     ...createOpenAICompatibleValidators({
-      checks: ['connectivity', 'model_list'],
+      checks: ['connectivity'],
     }),
   },
 })
diff --git a/packages/stage-ui/src/stores/providers.ts b/packages/stage-ui/src/stores/providers.ts
index e6204cd6e..53c9e07c0 100644
--- a/packages/stage-ui/src/stores/providers.ts
+++ b/packages/stage-ui/src/stores/providers.ts
@@ -1985,7 +1985,39 @@ export const useProvidersStore = defineStore('providers', () => {
       description: 'perplexity.ai',
       defaultBaseUrl: 'https://api.perplexity.ai/',
       creator: createPerplexity,
-      validation: ['health', 'model_list'],
+      validation: ['health'],
+      capabilities: {
+        listModels: async () => [
+          {
+            id: 'sonar',
+            name: 'Sonar',
+            provider: 'perplexity-ai',
+            description: 'Lightweight, cost-effective search model with grounding.',
+            contextLength: 127072,
+          },
+          {
+            id: 'sonar-pro',
+            name: 'Sonar Pro',
+            provider: 'perplexity-ai',
+            description: 'Advanced search offering with grounding, supporting complex queries and follow-ups.',
+            contextLength: 200000,
+          },
+          {
+            id: 'sonar-reasoning-pro',
+            name: 'Sonar Reasoning Pro',
+            provider: 'perplexity-ai',
+            description: 'Precise reasoning offering with Chain of Thought (CoT).',
+            contextLength: 127072,
+          },
+          {
+            id: 'sonar-deep-research',
+            name: 'Sonar Deep Research',
+            provider: 'perplexity-ai',
+            description: 'Expert-level research model conducting exhaustive searches and generating comprehensive reports.',
+            contextLength: 200000,
+          },
+        ] satisfies ModelInfo[],
+      },
     }),
     'mistral-ai': buildOpenAICompatibleProvider({
       id: 'mistral-ai',