Show each provider's state in the list and open one provider page everywhere (#9661)

* fix(app): leave providers that are not installed out of the model picker

An agent's own provider stays in its selector, labelled Unavailable.

* feat(app): open a provider's detail as a Settings page or a sheet

Settings → Providers now pushes a provider page, like Projects and Plugins;
the model picker gear and setup keep a sheet. Both frame one body, ordered
error, Enabled, Installation, Models, Troubleshooting, Danger zone, so the
old sheet's sticky footer and Retry button are gone. Refresh lives once, in
the Troubleshooting status row.

The page header (back link, icon, title) moves into the shared settings kit
so projects, plugins and providers line up on the same rails.

* feat(app): show each provider's version, updates and faults in the list

Each row now says how its provider is: version and model count, Update
available, a spinner while an update runs, a red dot with the error, or
Not installed / Disabled. Only a broken provider gets a dot, and a
provider that is not installed has no switch, since the model picker
already leaves it out. The kebab is gone; Remove lives on the detail.

Rows read the same installation and update queries as the detail, so
opening a provider costs no new requests. Hosts without
providerInstallation still get a correct list from the snapshot alone.

Add provider is a "+ Provider" button in the header and a muted last row;
both open one sheet with search and catalog rows, replacing the tile grid.
After Add, the new provider's detail opens.

The row is the settings kit's detail row, which gains a leading icon, a
hint status (spinner, error dot, or a held line) and a control before the
chevron. The Unistyles test stub now applies withUnistyles theme mappings,
so browser tests render components that read colours through the theme.

* feat(app): open setup's provider pages over the setup card

The detail and Add provider sheets take the setup card's frame and a back
arrow, so they read as pages of setup instead of a sheet over it. The step
is renamed "Your providers" to match the list it shows.

* docs: describe the provider list and pages as they are now

* fix(app): keep settings rows one height and on one icon rail on phones

On touch layouts a switch reserves a 44px control, so in the provider list
rows with a switch stood 10px taller than "Not installed" rows without one.
Card rows now reserve a default control's height, the rule nested rows
already follow.

A compact SettingsRow wrapped with a full `gap`, which added 12px on top of
the leading slot's margin: catalog icons sat 24px from their labels instead
of 12px. The wrap only needs space between lines, so it uses `rowGap`.

* fix(app): keep a provider row's error to one line

A long or multi-line error wrapped the hint to two lines with the dot
centred between them. The row cuts it to one line; the provider's page
shows it in full.

* fix(app): title a provider's Settings page like a project's

The page title and the detail header both named the provider. The screen
now titles it "Providers" and the page names the provider once, the way a
project's page does.

* fix(app): keep a settings row's switch out of the row's button

The provider row's switch rendered inside the row's <button>. That is
invalid markup, and keys reached both: Enter on the switch toggled it and
also opened the provider's page, and Space on it opened the page without
toggling.

SettingsRowHeader now lays its press target under the row's content as a
sibling of the control. The content lets presses through to the button and
stays out of the accessibility tree, where the button's label already names
the row. Hover is tracked on the row, so it holds over the switch.

* fix(app): reserve a control's height only on rows that open something

The previous change gave every card row a control's minimum height and
the design doc said so, but rows built directly on settingsStyles.row
(66 uses) never got it: a single-line row was 48px or 64px depending on
which code path built it.

The minimum now belongs to SettingsRowHeader, the row with an optional
control slot, so a list where only some rows carry a switch keeps one
height. SettingsRow and hand-built rows take their content's height again,
as on the base branch, and the doc states the narrower rule.

* test(app): give the Unistyles stub the light theme's full colours

Since the stub started applying withUnistyles theme mappings, a mapping
reading a colour the stub's theme lacked crashed: the markdown styles read
colors.terminal and failed the plan card disclosure tests. The stub's
colours now start from the light theme, with its own values pinned on top.

* test(app): find the provider page's buttons in the compact sheet

On compact layouts AdaptiveModalSheet puts its testID on the header only,
so buttons in the page body cannot be found inside it. The spec looks them
up on the page, as it did before the page moved into the sheet.

* fix(app): let screen readers read a settings row's state line

The row's button carries the row's name as its label, so only the title is hidden from assistive tech now; the hint below it (a provider's version, error or Not installed) is read again.

The Enter-on-switch test now dispatches its key events synchronously inside one act. An awaited keyboard call let the Switch's animation run a frame after the test, which Vitest reported as an unhandled error and failed the run.

* fix(app): don't open a provider's page after its Add sheet was closed

Adding a provider waits for the daemon to probe it. If the user closed the sheet during that wait, the completed add still navigated to the provider's page. The add now remembers which sheet session started it and only opens the page if that session is still current.

* fix(app): say Not installed for a disabled provider that is not installed

A disabled provider's snapshot status is unavailable, so the row said Disabled even when the binary was missing. The installation inspection is checked first, so Not installed wins over Disabled.

* fix(app): keep a saved provider choice visible when it is not installed

The provider picker drops unavailable providers. A schedule or metadata-generation setting saved against such a provider then showed Select model. The picker now keeps the saved provider, labelled Unavailable, so the user sees what is set and can change it.

* test(app): wait for an added catalog provider's probe before continuing

Adding a provider opens its page only after the daemon probes it, which can outlast the default expect timeout on CI.

* refactor(app): name the provider picker's connection and saved-choice options

Callers passed a bare true to reach the saved-choice argument.

* fix(app): show a provider page's loading and not-found states

A provider page opened from its URL (a reload, a cold start, a shared link) rendered its title over nothing until the host's providers arrived, and forever when the id named a provider the host doesn't have. The page body now says Loading..., that the host is offline, that the providers couldn't be read, or that the provider isn't on this host, in the same notice card the provider list uses when it is offline. The page and both sheet frames share the body.

* fix(app): don't call a just-removed provider missing while its page closes

The daemon can publish the provider list without the removed provider before it answers the config patch, so the page said "This provider isn't on this host" until the answer arrived and it navigated away; in a sheet, through the exit animation as well. A page that has shown its provider now shows nothing once it leaves the list. The not-found notice is for a page that never found its provider. The removal e2e holds the config answer so it always sees that order.

* fix(app): show the not-found notice when a provider is removed elsewhere

The page hid the notice for any provider it had shown before, to cover its own Remove. A removal from another client, the CLI or a plugin then left the page blank with no way to tell why. The page now owns its Remove: while that runs and once it succeeds the body shows nothing, and any other absence says the provider isn't on this host.

The removal e2e routes only the e2e daemon's socket, so the fixture's port-6767 guard stays in force.

* fix(app): show progress on the provider page's in-flight buttons

Remove, Add model and the diagnostic re-run now show their work on the
pressed control, like the page's Refresh and Update: a spinner, no
further presses and, on a labelled button, "Removing..." or "Adding...".

Remove kept its label and only disabled itself, and the page went blank
mid-removal: the daemon publishes the provider list without the removed
provider before it answers the config patch, so the body had nothing to
show and each frame's title fell back to the raw id. The removal now
keeps the entry the user confirmed, and one hook feeds the frame's title
and the body, so both keep showing the provider until the page closes.
The in-flight state also starts after confirmation, not while the
dialog is open.

The diagnostic sheet's header icon buttons had lost the base branch's
spinner and dimming; SheetHeaderIconButton now takes loading and
disabled, the way Button does.

* fix(app): don't leave a re-added provider's sheet stuck on Removing...

The setup step and the model picker's gear keep a provider's sheet
mounted after it closes, keyed by provider. A finished removal stayed
set in that sheet, so adding the same provider back reopened it with
Remove spinning and disabled. A finished removal now ends when the host
lists the provider again.

* fix(app): keep the composer's remembered provider in its picker

The picker leaves out providers that aren't installed, except the one
holding the picker's current choice. The schedule form and metadata page
passed that choice; the new-agent composer didn't, so a remembered
provider not installed on this host vanished from the picker and the
trigger read "Select model" with no reason given. The builder now requires
every caller to say what its current choice is, or null.

* fix(app): guide a missing catalog provider's install and keep custom models while one fails

A provider added from the Add provider catalog runs through the generic ACP client, which reports
no installation, so its page said nothing when the CLI was missing. The page now shows the
Installation section's Not installed row with Install opening the catalog's guide. A link the
host supplies still wins.

Custom models live in config, so the page lists them and offers Add model whenever the provider
is enabled and installed, including while it fails. The provider's own models, and the search
over them, still show only while it runs.

* fix(app): make settings rows pressable on iOS and Android

React Native 0.86 no longer exports StyleSheet.absoluteFillObject, and
Unistyles' native StyleSheet copies it from React Native, so the spread
was empty there. The row's press target then had no size: on Android,
tapping a provider row or a Voice row did nothing. Web was unaffected
because Unistyles' web StyleSheet still defines the key. Use
StyleSheet.absoluteFill, as the rest of the app does.

* fix(app): let setup's provider sheets leave out the close button again

The base's sheet header rewrite dropped SheetHeaderView's showCloseButton,
which the provider page and Add provider sheets pass when setup's back
arrow is the only way out. Restore it on the header.

* test(app): prove a refresh clears a failed update from the provider's row

The update-failure journey now also walks the provider list: after Refresh
on the page the row reads its version and model count with no error dot,
and a refresh from another client clears a row that is open in the list.
Without the provider.installation.update.cleared handling both row checks
fail. The helper's Refresh now uses the page's Troubleshooting button,
since Settings opens the provider as a page, not a sheet.

* fix(app): show a catalog provider's install guide on hosts that cannot report installations

A host without providerInstallation returns an unsupported installation,
which the page passed through, so a catalog provider whose CLI is missing
showed no Installation section and no guide anywhere. The guide is the
app's own catalog data, so the page builds the same Not installed row
from it on those hosts.
This commit is contained in:
Mohamed Boudra
2026-11-19 21:30:31 +07:00
committed by GitHub
parent 86ebdedcbe
commit d5d385afa7
89 changed files with 3876 additions and 2468 deletions
+6 -6
View File
@@ -134,7 +134,7 @@ A section or group explains itself through the `info` prop on `<SettingsSection>
Cards inside a section sit closer than sections. Rows inside a card touch — only the divider separates them. The rhythm is page → spacious; section → spacious; card → tight.
Rows have generous vertical padding: roughly 16px of content plus 16px of vertical padding for settings rows, 8–12px for sidebar list items where many rows must fit. Compressing rows below the established density to fit more on the screen is wrong. Too many rows means more cards or more sections, not smaller rows.
Rows have generous vertical padding: roughly 16px of content plus 16px of vertical padding for settings rows, 8–12px for sidebar list items where many rows must fit. A row that opens something (`<SettingsDetailRow>`, a collapsible row's header) is at least as tall as one holding a default control, so a list where only some of those rows carry a switch keeps one row height. Other rows take their content's height. Compressing rows below the established density to fit more on the screen is wrong. Too many rows means more cards or more sections, not smaller rows.
Rows revealed under a `<SettingsCollapsibleRow>` are nested rows, one step smaller than card rows: 8px of vertical padding, `fontSize.sm` text, `sm` controls, and one fixed height so rows with and without a trailing button line up. The collapsible row sets this for everything under it (`packages/app/src/components/settings/row-density.tsx`). Never pass a density to a row, and never pad or resize a nested row by hand. Settings rows that share a menu surface with menu rows, such as Usage's options, go inside `<MenuSettingsRows>`, which puts their labels on the menu rows' label rail (`menuRowContentInset`).
@@ -207,11 +207,11 @@ Terminology:
## 11. States
Loading is inline by default. `<LoadingSpinner size={14} color={foregroundMuted} />` sits next to the thing it relates to (`packages/app/src/screens/settings/providers-section.tsx:227-231`). Page-level loading is a centered `<LoadingSpinner size="large">` (`packages/app/src/screens/sessions-screen.tsx:69-72`). Card-level loading is a single short line, not a spinner. In-row dropdown items use `<DropdownMenuItem status="pending" pendingLabel="Removing...">`; the menu item handles its own pending state.
Loading is inline by default. `<LoadingSpinner size={14} color={foregroundMuted} />` leads the line it relates to, never trails a label: a settings row's hint takes `hintStatus="busy"` while its work runs, and `hintStatus="pending"` holds the line with a skeleton until its value is read (`packages/app/src/components/settings/row-header.tsx`). Page-level loading is a centered `<LoadingSpinner size="large">` (`packages/app/src/screens/sessions-screen.tsx:69-72`). Card-level loading is a single short line, not a spinner. In-row dropdown items use `<DropdownMenuItem status="pending" pendingLabel="Removing...">`; the menu item handles its own pending state.
Screen-level empty states use a centered, muted noun phrase and at most one ghost button (`packages/app/src/screens/sessions-screen.tsx`). Sidebar list empty states use a quiet bordered card with a left-aligned `sm` title, a muted `sm` description, and `sm` `<Button>` actions. Use `secondary` for the primary action and `outline` for a secondary action (`packages/app/src/components/sidebar/empty-states.tsx`). Keep both forms short and free of illustrations.
Inline errors are a single sentence in `palette.red[300]` `xs`, sitting under the field or inside the card it relates to (`packages/app/src/screens/settings/providers-section.tsx:115-119`).
Inline errors are a single sentence in `palette.red[300]` `xs`, sitting under the field or inside the card it relates to (`packages/app/src/components/ui/form-field.tsx`). A settings row that is broken says so in its hint with `hintStatus="error"`: a red dot and the error in `statusDanger`.
Page-level alerts — informational notices, success confirmations, warnings, or recoverable errors that need a small visible block on the page — use `<Alert>` (`packages/app/src/components/ui/alert.tsx`). Variants: `default`, `info`, `success`, `warning`, `error`. The chrome is quiet by design: a 1px tinted border, transparent background, a small variant-tinted icon, the title in the variant accent, the description in `foregroundMuted`. Actions go in the `children` slot as `<Button variant="outline">` — recovery actions are low-frequency and outline keeps them quiet alongside the alert's accent (`packages/app/src/screens/project-settings-screen.tsx`). One `<Alert>` at a time per region.
@@ -233,13 +233,13 @@ Changing state must not move the layout. A row that grows when its badge arrives
The row anatomy is a content column with an optional trailing slot. Inside a card the row is `settingsStyles.row`. Inside a sidebar list the row carries its own padding and `borderRadius.lg` per item (`packages/app/src/components/sidebar-workspace-list.tsx:2614-2625`).
Rows that drill into a detail lead with a chevron in the trailing slot (`ChevronRight`, `iconSize.sm`, `foregroundMuted`). The whole row is the `<Pressable>`. Pair-device row (`packages/app/src/screens/settings/host-page.tsx:644-668`), provider row (`packages/app/src/screens/settings/providers-section.tsx:92-132`), project row in the projects list. A fixed right chevron means navigation. An expandable row uses a trailing right chevron that rotates down when expanded (`SettingsCollapsibleRow`); pressing the row reveals its child rows in place.
A trailing chevron opens a detail, as a page or a sheet (`ChevronRight`, `iconSize.sm`, `foregroundMuted`). The whole row is the pressable; use `<SettingsDetailRow>`. Pair-device row (`packages/app/src/screens/settings/host-page.tsx`), provider row (`packages/app/src/provider-settings/internal/provider-row.tsx`), project row in the projects list. A fixed right chevron means navigation. An expandable row uses a trailing right chevron that rotates down when expanded (`SettingsCollapsibleRow`); pressing the row reveals its child rows in place.
Kebab menus (`<DropdownMenu>` with `<MoreVertical size={14} />` trigger) are for actions on the row, not navigation. Trigger style: `padding: 2`, `borderRadius: 4`, hover background `surface2`. Menu position: `align="end"`. Items use `<DropdownMenuItem leading={<Icon size={14} color={foregroundMuted} />} ...>`. Visibility is `isHovered || isTouchPlatform` — hover-revealed on web, always visible on native (`packages/app/src/components/sidebar-workspace-list.tsx:684-770`).
A row may carry both a chevron and a kebab when both navigation and row-level actions apply. Chevron sits at the end; kebab sits before it.
Switches and segmented controls also sit in the trailing slot. A row that both navigates and toggles is a `<Pressable>` with a `<Switch>` in the trailing slot — the switch calls `event.stopPropagation()` so the row press does not fire (`packages/app/src/screens/settings/providers-section.tsx:92-132`). Sidebar items that hold a status dot, a count, and a kebab follow the same rule (`packages/app/src/components/sidebar-workspace-list.tsx`).
Switches and segmented controls also sit in the trailing slot. A row that both navigates and toggles passes its `<Switch>` as the `control` of `<SettingsDetailRow>`, before the chevron; the switch stops the press from reaching the row (`packages/app/src/provider-settings/internal/provider-row.tsx`). A list the user adds to ends with a muted `<SettingsAddRow>`. Sidebar items that hold a status dot, a count, and a kebab follow the same rule (`packages/app/src/components/sidebar-workspace-list.tsx`).
Selected state on rows in a desktop list+detail uses `surfaceSidebarHover` as the background (`packages/app/src/screens/projects-screen.tsx`). Selected state on rows in the sidebar list uses `surface2` (`packages/app/src/components/agent-list.tsx:563-571`).
@@ -288,7 +288,7 @@ New status pills use `<StatusBadge>`. Identity, shortcut, and interactive link b
| Pattern | Reference |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| List+detail (compact stack, desktop sidebar+pane) | `packages/app/src/screens/settings-screen.tsx`, `packages/app/src/screens/projects-screen.tsx` |
| Detail card+row | `packages/app/src/screens/settings/host-page.tsx`, `packages/app/src/screens/settings/providers-section.tsx` |
| Detail card+row | `packages/app/src/screens/settings/host-page.tsx`, `packages/app/src/provider-settings/internal/provider-list.tsx` |
| Section grouping inside a card list | `packages/app/src/screens/settings/settings-section.tsx` |
| Form modal (label + input fields, primary + cancel) | `packages/app/src/hosts/add-host/internal/add-host-modal.tsx`, `packages/app/src/hosts/add-host/internal/pair-link-modal.tsx`, `packages/app/src/components/project-picker-modal.tsx` |
| Destructive confirmation | `confirmDialog` invoked from `packages/app/src/screens/settings/host-page.tsx:541-547` |
+4 -3
View File
@@ -265,7 +265,7 @@ promise for completion: equal results, including equal discovery timestamps, emi
## Installation and updates
The **Installation** section of provider settings reads `AgentClient.installation`. Built-ins set
The provider list and the **Installation** section of a provider's page read `AgentClient.installation`. Built-ins set
it on the client; plugins set `ProviderRegistration.installation`, which the plugin bridge maps to
the same interface. `ProviderInstallations` in `packages/server/src/server/agent/provider-installation/`
owns deadlines, caching and the one running update per provider, so a provider only answers.
@@ -284,8 +284,9 @@ Declare only what the vendor offers:
`runUpdateCommand`. Paseo adds no verification, signature check or rollback, so the update does
exactly what the same command does in a terminal.
The three calls are separate because they cost differently. `inspect` runs whenever someone opens
provider settings, with a 20 s deadline and a 30 s cache. `checkForUpdates` usually reaches the
The three calls are separate because they cost differently. `inspect` runs for every provider
whenever the provider list shows, because each row states its version; a provider's page shares the
row's request. It has a 20 s deadline and a 30 s cache. `checkForUpdates` usually reaches the
network. Paseo calls it only after `inspect` reports the CLI installed, and keeps a conclusive
answer for an hour while `inspect` reports the same version, so a CLI updated outside Paseo is
checked again once the 30 s inspection expires. `update` runs for minutes, streams output, and is
@@ -15,7 +15,8 @@ import {
expectProviderInstalledInSettings,
findAcpCatalogProvider,
installAcpCatalogProvider,
openAddProviderArea,
openAddProvider,
openProviderDetail,
openSettingsHost,
openSettingsHostSection,
seedSavedSettingsHosts,
@@ -47,7 +48,7 @@ test.describe("ACP provider catalog", () => {
await openSettings(page);
await openSettingsHost(page, getServerId());
await openSettingsHostSection(page, getServerId(), "providers");
await openAddProviderArea(page);
await openAddProvider(page);
await installAcpCatalogProvider(page, ACP_PROVIDER.name);
await expectProviderInstalledInSettings(page, ACP_PROVIDER.name);
@@ -69,7 +70,7 @@ test("adds fx from the catalog with only a config entry", async ({ page }, testI
await openSettings(page);
await openSettingsHost(page, getServerId());
await openSettingsHostSection(page, getServerId(), "providers");
await openAddProviderArea(page);
await openAddProvider(page);
await findAcpCatalogProvider(page, "fx");
await page.screenshot({ path: testInfo.outputPath("fx-catalog.png") });
@@ -104,7 +105,7 @@ for (const theme of ["light", "dark"] as const) {
await expect(
page.getByRole("button", { name: "Hoplite provider details", exact: true }),
).toHaveCount(0);
await openAddProviderArea(page);
await openAddProvider(page);
await findAcpCatalogProvider(page, "Hoplite");
await page.screenshot({ path: testInfo.outputPath(`hoplite-catalog-${theme}.png`) });
await installAcpCatalogProvider(page, "Hoplite");
@@ -127,7 +128,7 @@ for (const theme of ["light", "dark"] as const) {
testInfo.outputPath(`hoplite-removed-${theme}.json`),
JSON.stringify(await client.getProvidersSnapshot(), null, 2),
);
await openAddProviderArea(page);
await openAddProvider(page);
await findAcpCatalogProvider(page, "Hoplite");
await page.screenshot({ path: testInfo.outputPath(`hoplite-removed-${theme}.png`) });
await installAcpCatalogProvider(page, "Hoplite");
@@ -140,11 +141,11 @@ for (const theme of ["light", "dark"] as const) {
}
async function removeHoplite(page: import("@playwright/test").Page): Promise<void> {
await page.getByTestId("provider-actions-hoplite").click();
await openProviderDetail(page, "Hoplite");
page.once("dialog", (dialog) => {
void dialog.accept();
});
await page.getByTestId("provider-remove-hoplite").click();
await page.getByTestId("provider-remove").click();
}
test("unsupported host asks for an update without writing Hoplite config", async ({
@@ -164,7 +165,7 @@ test("unsupported host asks for an update without writing Hoplite config", async
await openSettings(page);
await openSettingsHost(page, outdatedDaemon.serverId);
await openSettingsHostSection(page, outdatedDaemon.serverId, "providers");
await openAddProviderArea(page);
await openAddProvider(page);
await page.getByRole("button", { name: "Add Hoplite", exact: true }).click();
const errorToast = page.getByTestId("app-toast-message");
await expect(errorToast).toHaveText("Update the host to add Hoplite.");
@@ -1,10 +1,19 @@
import { test } from "../support/fixtures";
import { expect, test } from "../support/fixtures";
import { gotoAppShell, openSettings } from "../support/helpers/app";
import {
addCustomModel,
expectCustomModelRetained,
openCustomModels,
removeCustomModel,
removeListedCustomModel,
} from "../support/helpers/custom-models";
import { connectDaemonClient } from "../support/helpers/daemon-client-loader";
import { getServerId } from "../support/helpers/server-id";
import {
openProviderDetail,
openSettingsHost,
openSettingsHostSection,
} from "../support/helpers/settings";
const longModelId = "custom-model-with-a-long-name-".repeat(6);
const shortModelId = "custom-short";
@@ -27,3 +36,52 @@ for (const width of [1200, 390]) {
await removeCustomModel(page, shortModelId);
});
}
/** An ACP provider whose command runs but exits before it answers, so the provider fails. */
const FAILING_PROVIDER = { id: "failing-acp", name: "Failing ACP" } as const;
interface ProviderConfigClient {
connect(): Promise<void>;
close(): Promise<void>;
patchDaemonConfig(config: {
providers?: Record<string, { extends: string; label: string; command: string[] }>;
removeProviders?: string[];
}): Promise<unknown>;
}
test("adds and removes a custom model while the provider fails", async ({ page }) => {
test.setTimeout(120_000);
const client = await connectDaemonClient<ProviderConfigClient>({
clientIdPrefix: "custom-model-failing-e2e",
});
try {
await client.patchDaemonConfig({
providers: {
[FAILING_PROVIDER.id]: {
extends: "acp",
label: FAILING_PROVIDER.name,
command: ["node", "-e", "process.exit(1)"],
},
},
});
await gotoAppShell(page);
await openSettings(page);
await openSettingsHost(page, getServerId());
await openSettingsHostSection(page, getServerId(), "providers");
await openProviderDetail(page, FAILING_PROVIDER.name);
await test.step("the page leads with the failure and lists no reported models", async () => {
await expect(page.getByTestId("provider-error")).toBeVisible({ timeout: 30_000 });
await expect(page.getByText("Custom models", { exact: true })).toBeVisible();
await expect(page.getByRole("textbox", { name: "Search models" })).toHaveCount(0);
});
await addCustomModel(page, shortModelId);
await removeListedCustomModel(page, shortModelId);
} finally {
await client
.patchDaemonConfig({ removeProviders: [FAILING_PROVIDER.id] })
.catch(() => undefined);
await client.close().catch(() => undefined);
}
});
+54 -4
View File
@@ -6,6 +6,7 @@ import {
addProjectFromSetup,
continueSetup,
expectSetupStep,
expectSheetCoversSetupCard,
finishSetup,
goToSetupStep,
hostGivesAgentsPaseoTools,
@@ -23,6 +24,7 @@ import {
recordFirstLaunch,
setupModal,
setupPrimaryButton,
setupSheet,
showSetupAgainFromSettings,
skipSetup,
startSetupHost,
@@ -35,7 +37,11 @@ import {
import { installDaemonWebSocketGate } from "../support/helpers/daemon-websocket-gate";
import { enableRelayAndExpectOffer } from "../support/helpers/pair-device";
import { seedWorkspace } from "../support/helpers/seed-client";
import { openSettingsHostSection } from "../support/helpers/settings";
import {
installAcpCatalogProvider,
openAddProvider,
openSettingsHostSection,
} from "../support/helpers/settings";
import { createTempDirectory, createTempGitRepo } from "../support/helpers/workspace";
// Midnight's muted foreground (#9a9db0), which the step description is drawn in.
@@ -59,11 +65,28 @@ test("a new user is walked through setup once", async ({ page }, testInfo) => {
await test.step("Providers shows the same provider list as Settings", async () => {
await continueSetup(page);
await expectSetupStep(page, "Your agents");
await expectSetupStep(page, "Your providers");
await expect(setupModal(page).getByTestId("host-page-providers-card")).toBeVisible();
await page.screenshot({ path: testInfo.outputPath("2-providers.png") });
});
await test.step("a provider's detail and Add provider cover the setup card and lead back to it", async () => {
await setupModal(page)
.getByRole("button", { name: "Claude provider details", exact: true })
.click();
const detail = setupSheet(page, "provider-settings-sheet");
await expectSheetCoversSetupCard(page, detail);
await detail.getByRole("button", { name: "Back to providers", exact: true }).click();
await expect(detail).toHaveCount(0);
await setupModal(page).getByTestId("provider-list-add").click();
const add = setupSheet(page, "add-provider-sheet");
await expectSheetCoversSetupCard(page, add);
await page.keyboard.press("Escape");
await expect(add).toHaveCount(0);
await expectSetupStep(page, "Your providers");
});
await test.step("with no agent history, Add project opens the regular flow and the folder shows as added", async () => {
await continueSetup(page);
await expectSetupStep(page, "Add your projects");
@@ -103,6 +126,33 @@ test("a new user is walked through setup once", async ({ page }, testInfo) => {
}
});
test("a provider removed in setup can be added back and removed again", async ({ page }) => {
test.setTimeout(180_000);
const host = await startSetupHost("re-add");
const detail = setupSheet(page, "provider-settings-sheet");
const remove = detail.getByTestId("provider-remove");
page.on("dialog", (dialog) => void dialog.accept());
try {
await openAppAsNewUser(page, host);
await continueSetup(page);
await expectSetupStep(page, "Your providers");
await openAddProvider(page);
await installAcpCatalogProvider(page, "Junie");
await remove.click();
await expect(detail).toHaveCount(0);
// Adding it back opens the same provider's sheet, which must not still be removing it.
await openAddProvider(page);
await installAcpCatalogProvider(page, "Junie");
await expect(remove).toHaveText("Remove");
await expect(remove).toBeEnabled();
} finally {
await host.close();
}
});
test("a new user goes from the loading screen straight into setup", async ({ page }) => {
const host = await startSetupHost("first-launch");
@@ -145,7 +195,7 @@ test("changing the theme keeps the setup window in place on every step", async (
for (const title of [
"Welcome to Paseo",
"Your agents",
"Your providers",
"Add your projects",
"Let agents use Paseo",
"Take your agents with you",
@@ -418,7 +468,7 @@ test("in the compact layout, Finish on Orchestration applies its switches", asyn
await openAppAsNewUser(page, host);
await step("Welcome to Paseo");
await primary("Continue").click();
await step("Your agents");
await step("Your providers");
await primary("Continue").click();
await step("Add your projects");
await primary("Continue").click();
@@ -1,21 +1,22 @@
import { ACP_PROVIDER_ICON_SVGS } from "../../src/assets/acp-provider-icons";
import { expect, test, type Page } from "../support/fixtures";
import type { TestInfo } from "@playwright/test";
import type { Locator, TestInfo } from "@playwright/test";
import { gotoAppShell, openSettings } from "../support/helpers/app";
import { getServerId } from "../support/helpers/server-id";
import {
findAcpCatalogProvider,
openAddProviderArea,
openAddProvider,
openSettingsHost,
openSettingsHostSection,
} from "../support/helpers/settings";
async function openProviderCatalog(page: Page) {
async function openProviderCatalog(page: Page, viewport?: { width: number; height: number }) {
await gotoAppShell(page);
await openSettings(page);
await openSettingsHost(page, getServerId());
await openSettingsHostSection(page, getServerId(), "providers");
await openAddProviderArea(page);
if (viewport) await page.setViewportSize(viewport);
await openAddProvider(page);
}
async function expectProviderArtwork(
@@ -25,11 +26,11 @@ async function expectProviderArtwork(
name: string,
) {
await findAcpCatalogProvider(page, name);
// Catalog tiles have no semantic role; scope artwork to the named provider's tile.
const icon = page.getByTestId(`provider-catalog-tile-${id}`).locator("svg").first();
// Catalog rows have no semantic role of their own; scope artwork to the named provider's row.
const icon = page.getByTestId(`provider-catalog-row-${id}`).locator("svg").first();
await expect(icon).toBeVisible();
// Provider artwork is 24px; the generic PackagePlus fallback is 20px.
await expect.soft(icon).toHaveAttribute("width", "24");
// Artwork draws at the provider list's icon size, so the catalog and the list share a rail.
await expect.soft(icon).toHaveAttribute("width", "16");
const expectedPaths = await page.evaluate((xml) => {
const document = new DOMParser().parseFromString(xml, "image/svg+xml");
return Array.from(document.querySelectorAll("path"), (path) => path.getAttribute("d")!);
@@ -49,3 +50,20 @@ test("#7087: the provider catalog shows Devin, Hermes, and Kiro artwork", async
await expectProviderArtwork(page, testInfo, "hermes", "Hermes");
await expectProviderArtwork(page, testInfo, "kiro", "Kiro CLI");
});
/** The space between a row's icon and its label, as drawn. */
async function gapAfterIcon(row: Locator, label: string): Promise<number> {
const icon = await row.locator("svg").first().boundingBox();
const text = await row.getByText(label, { exact: true }).boundingBox();
if (!icon || !text) throw new Error(`${label} has no icon or label on screen`);
return text.x - (icon.x + icon.width);
}
test("catalog rows keep the provider list's icon rail on a phone", async ({ page }) => {
await openProviderCatalog(page, { width: 390, height: 844 });
await findAcpCatalogProvider(page, "Kiro CLI");
const listGap = await gapAfterIcon(page.getByTestId("provider-row-claude"), "Claude");
const catalogGap = await gapAfterIcon(page.getByTestId("provider-catalog-row-kiro"), "Kiro CLI");
expect(catalogGap).toBe(listGap);
});
@@ -0,0 +1,54 @@
import { expect, test } from "../support/fixtures";
import { openCustomModels, removeCustomModel } from "../support/helpers/custom-models";
import { installDaemonWebSocketGate } from "../support/helpers/daemon-websocket-gate";
// A pressed control shows its own progress while the daemon answers, the way Button's `loading`
// does: a spinner in place of its icon, no further presses and, on a labelled button, a
// present-participle label.
const MODEL_ID = "in-flight-model";
test.describe("provider page work in flight", () => {
test("says Adding... on the Add button while a custom model is saved", async ({ page }) => {
const gate = await installDaemonWebSocketGate(page);
await openCustomModels(page);
await page.getByRole("button", { name: "Add model", exact: true }).click();
const sheet = page.getByTestId("add-custom-model-sheet");
await page.getByPlaceholder("e.g. openai/gpt-5").fill(MODEL_ID);
gate.holdNextServerMessage("set_daemon_config_response");
await sheet.getByRole("button", { name: "Add", exact: true }).click();
await gate.waitForHeldServerMessage("set_daemon_config_response");
const adding = sheet.getByRole("button", { name: "Adding...", exact: true });
await expect(adding.getByRole("progressbar")).toBeVisible();
await expect(adding).toBeDisabled();
gate.releaseHeldServerMessage("set_daemon_config_response");
await expect(sheet).toBeHidden({ timeout: 30_000 });
await removeCustomModel(page, MODEL_ID);
});
test("shows the diagnostic report running again on its re-run button", async ({ page }) => {
const gate = await installDaemonWebSocketGate(page);
await openCustomModels(page);
await page.getByRole("button", { name: "Diagnostic report", exact: true }).click();
const sheet = page.getByTestId("provider-diagnostic-sheet");
const rerun = sheet.getByRole("button", { name: "Refresh diagnostic", exact: true });
await expect(rerun).toBeEnabled({ timeout: 30_000 });
// Copy has a report to copy once the first run is in.
await expect(sheet.getByRole("button", { name: "Copy diagnostic" })).toBeEnabled();
gate.holdNextServerMessage("provider_diagnostic_response");
await rerun.click();
await gate.waitForHeldServerMessage("provider_diagnostic_response");
const running = sheet.getByRole("button", { name: "Refreshing diagnostic", exact: true });
await expect(running.getByRole("progressbar")).toBeVisible();
await expect(running).toBeDisabled();
gate.releaseHeldServerMessage("provider_diagnostic_response");
await expect(rerun).toBeEnabled({ timeout: 30_000 });
});
});
@@ -2,11 +2,16 @@ import type { Dialog } from "@playwright/test";
import { expect, test, type Page } from "../support/fixtures";
import { gotoAppShell, openSettings } from "../support/helpers/app";
import { connectDaemonClient } from "../support/helpers/daemon-client-loader";
import { installDaemonWebSocketGate } from "../support/helpers/daemon-websocket-gate";
import { getServerId } from "../support/helpers/server-id";
import {
expectInstallOpensGuide,
expectProviderInstalledInSettings,
expectProviderNotOnHost,
installAcpCatalogProvider,
openAddProviderArea,
leaveProviderDetail,
openAddProvider,
openProviderDetail,
openSettingsHost,
openSettingsHostSection,
} from "../support/helpers/settings";
@@ -15,6 +20,8 @@ import { copyPluginExample } from "../support/helpers/plugin-fixture";
const CUSTOM_PROVIDER = {
id: "junie",
name: "Junie",
// The Add provider catalog's guide. The CLI is not installed where these tests run.
installGuide: "https://junie.jetbrains.com/docs/junie-cli-acp.html",
} as const;
const PLUGIN_PROVIDER = {
@@ -62,13 +69,39 @@ async function clickRemoveProviderAndAcceptWarning(page: Page): Promise<Dialog>
expect(dialog.message()).toContain("This deletes the provider entry from config.json.");
void dialog.accept();
});
await page.getByTestId(`provider-remove-${CUSTOM_PROVIDER.id}`).click();
await page.getByTestId("provider-remove").click();
if (!warning) {
throw new Error("Expected a provider removal confirmation dialog, but none was shown.");
}
return warning;
}
const MISSING_NOTICE = '[data-testid="provider-detail-missing"]';
/** Records whether the page ever says its provider isn't on the host, however briefly. */
async function watchForMissingNotice(page: Page): Promise<void> {
await page.evaluate((selector) => {
const flags = window as unknown as { sawMissingNotice?: boolean };
flags.sawMissingNotice = false;
new MutationObserver(() => {
if (document.querySelector(selector)) flags.sawMissingNotice = true;
}).observe(document.body, { childList: true, subtree: true });
}, MISSING_NOTICE);
}
async function expectMissingNoticeNeverShown(page: Page): Promise<void> {
const saw = await page.evaluate(
() => (window as unknown as { sawMissingNotice?: boolean }).sawMissingNotice,
);
expect(saw).toBe(false);
}
/**
* The daemon publishes the provider list without the removed provider before it answers the config
* patch. Holding the answer keeps the page in that window.
*/
const CONFIG_RESPONSE = "set_daemon_config_response";
test.describe("provider removal", () => {
test("removes a custom provider from Settings", async ({ page }) => {
test.setTimeout(120_000);
@@ -79,20 +112,42 @@ test.describe("provider removal", () => {
try {
await removeCustomProvider(client);
const gate = await installDaemonWebSocketGate(page);
await gotoAppShell(page);
await openSettings(page);
await openSettingsHost(page, getServerId());
await openSettingsHostSection(page, getServerId(), "providers");
await expect(page.getByTestId("provider-actions-claude")).toHaveCount(0);
await openAddProviderArea(page);
// A built-in provider has no Danger zone.
await openProviderDetail(page, "Claude");
await expect(page.getByTestId("provider-remove")).toHaveCount(0);
await leaveProviderDetail(page);
await openAddProvider(page);
await installAcpCatalogProvider(page, CUSTOM_PROVIDER.name);
await expectProviderInstalledInSettings(page, CUSTOM_PROVIDER.name);
await expectProviderSource(client, "custom");
await page.getByTestId(`provider-actions-${CUSTOM_PROVIDER.id}`).click();
await expect(page.getByTestId(`provider-remove-${CUSTOM_PROVIDER.id}`)).toBeVisible();
await openProviderDetail(page, CUSTOM_PROVIDER.name);
await test.step("the page points at the catalog's install guide", async () => {
await expectInstallOpensGuide(page, CUSTOM_PROVIDER.installGuide);
});
await expect(page.getByTestId("provider-remove")).toBeVisible();
await watchForMissingNotice(page);
gate.holdNextServerMessage(CONFIG_RESPONSE);
await clickRemoveProviderAndAcceptWarning(page);
await gate.waitForHeldServerMessage(CONFIG_RESPONSE);
await expectProviderSource(client, undefined);
// Until the removal is answered, the page keeps the provider and the pressed button says so.
const removeButton = page.getByTestId("provider-remove");
await expect(removeButton).toHaveText("Removing...");
await expect(removeButton.getByRole("progressbar")).toBeVisible();
await expect(removeButton).toBeDisabled();
await expect(page.getByTestId("provider-detail-title")).toHaveText(CUSTOM_PROVIDER.name);
gate.releaseHeldServerMessage(CONFIG_RESPONSE);
// Removing leaves the provider's page for the list, without first calling it missing.
await expect(page.getByTestId("provider-list")).toBeVisible();
await expectMissingNoticeNeverShown(page);
await expect(
page.getByRole("button", {
@@ -100,7 +155,33 @@ test.describe("provider removal", () => {
exact: true,
}),
).toHaveCount(0);
await expectProviderSource(client, undefined);
} finally {
await removeCustomProvider(client).catch(() => undefined);
await client.close().catch(() => undefined);
}
});
test("says a provider removed elsewhere while its page is open isn't on this host", async ({
page,
}) => {
test.setTimeout(120_000);
const client = await connectDaemonClient<ProviderRemovalDaemonClient>({
clientIdPrefix: "provider-removal-e2e",
});
try {
await removeCustomProvider(client);
await gotoAppShell(page);
await openSettings(page);
await openSettingsHost(page, getServerId());
await openSettingsHostSection(page, getServerId(), "providers");
await openAddProvider(page);
await installAcpCatalogProvider(page, CUSTOM_PROVIDER.name);
await expectProviderInstalledInSettings(page, CUSTOM_PROVIDER.name);
await openProviderDetail(page, CUSTOM_PROVIDER.name);
await removeCustomProvider(client);
await expectProviderNotOnHost(page);
} finally {
await removeCustomProvider(client).catch(() => undefined);
await client.close().catch(() => undefined);
@@ -130,7 +211,9 @@ test.describe("provider removal", () => {
exact: true,
});
await expect(pluginProviderRow).toBeVisible();
await expect(page.getByTestId(`provider-actions-${PLUGIN_PROVIDER.id}`)).toHaveCount(0);
await openProviderDetail(page, PLUGIN_PROVIDER.name);
await expect(page.getByTestId("provider-remove")).toHaveCount(0);
await leaveProviderDetail(page);
// The provider survives a removeProviders patch pointed at it: the
// plugin, not config.json, owns the definition.
@@ -97,7 +97,7 @@ async function hasFocusWithin(locator: Locator): Promise<boolean> {
async function expectProviderSettingsVisible(page: Page) {
await expect(page.getByTestId("provider-settings-sheet")).toBeVisible({ timeout: 10_000 });
await expect(page.getByRole("button", { name: "Add model" })).toBeVisible();
await expect(page.getByRole("button", { name: "Diagnostic", exact: true })).toBeVisible();
await expect(page.getByRole("button", { name: "Diagnostic report" })).toBeVisible();
}
async function exerciseProviderSettingsStack(page: Page) {
@@ -109,7 +109,7 @@ async function exerciseProviderSettingsStack(page: Page) {
await expect(page.getByPlaceholder("e.g. openai/gpt-5")).not.toBeVisible({ timeout: 10_000 });
await expectProviderSettingsVisible(page);
await page.getByRole("button", { name: "Diagnostic", exact: true }).click();
await page.getByRole("button", { name: "Diagnostic report" }).click();
await expect(page.getByTestId("provider-diagnostic-sheet")).toBeVisible({ timeout: 10_000 });
await page.getByRole("button", { name: /Refresh diagnostic/ }).click();
await expect(page.getByTestId("provider-diagnostic-sheet")).toBeVisible({ timeout: 10_000 });
@@ -118,7 +118,7 @@ async function exerciseProviderSettingsStack(page: Page) {
await page.getByRole("button", { name: "Refresh", exact: true }).click();
await expectProviderSettingsVisible(page);
await expect(page.getByText("Updated just now", { exact: true })).toBeVisible({
await expect(page.getByText("Checked just now", { exact: true })).toBeVisible({
timeout: 30_000,
});
}
@@ -1,5 +1,8 @@
import {
backToProviderList,
expectNoUpdateFailure,
expectRowReadsVersionAndModels,
expectRowReportsUpdateFailure,
openProviderInstallation,
refreshFromOtherClient,
refreshProviderDetails,
@@ -7,20 +10,35 @@ import {
test,
} from "../support/helpers/provider-update-failure";
test("a refresh clears a failed update from the open Installation section", async ({
test("a refresh clears a failed update from the provider's page and its row", async ({
providerUpdateFailure: { page, otherClient },
}) => {
await openProviderInstallation(page);
await test.step("Refresh in this view clears the failure", async () => {
await test.step("Refresh on the page clears the failure", async () => {
await runFailingUpdate(page);
await refreshProviderDetails(page);
await expectNoUpdateFailure(page);
});
await test.step("a refresh from another client clears it too", async () => {
await test.step("the row in the list reads the version and models again", async () => {
await backToProviderList(page);
await expectRowReadsVersionAndModels(page);
});
await test.step("a refresh from another client clears the page", async () => {
await openProviderInstallation(page);
await runFailingUpdate(page);
await refreshFromOtherClient(otherClient);
await expectNoUpdateFailure(page);
});
await test.step("a refresh from another client clears the row on the open list", async () => {
await runFailingUpdate(page);
await backToProviderList(page);
// Without a refresh, the row still reports the failure.
await expectRowReportsUpdateFailure(page);
await refreshFromOtherClient(otherClient);
await expectRowReadsVersionAndModels(page);
});
});
@@ -15,6 +15,9 @@ import { startIsolatedHostDaemon } from "../support/helpers/isolated-host-daemon
import { getServerId } from "../support/helpers/server-id";
import {
expectSettingsHeader,
expectProviderNotOnHost,
expectProviderPageLoaded,
gotoProviderPage,
openSettingsHost,
openHostSection,
expectHostLabelDisplayed,
@@ -264,6 +267,20 @@ test.describe("Settings host page", () => {
});
});
test.describe("provider page from its URL", () => {
test("loads a provider's page on a cold visit", async ({ page }) => {
await gotoAppShell(page);
await gotoProviderPage(page, getServerId(), "claude");
await expectProviderPageLoaded(page, "Claude");
});
test("says a provider the host doesn't have isn't on this host", async ({ page }) => {
await gotoAppShell(page);
await gotoProviderPage(page, getServerId(), "not-a-provider");
await expectProviderNotOnHost(page);
});
});
test("restart recovery defaults off and persists opt-in and custom prompt", async ({ page }) => {
const serverId = getServerId();
await gotoAppShell(page);
@@ -26,6 +26,11 @@ export async function addCustomModel(page: Page, id: string): Promise<void> {
export async function removeCustomModel(page: Page, id: string): Promise<void> {
await searchModels(page, id);
await removeListedCustomModel(page, id);
}
/** Removes a custom model shown on the page without searching for it first. */
export async function removeListedCustomModel(page: Page, id: string): Promise<void> {
const remove = page.getByRole("button", { name: `Remove ${id}`, exact: true });
await expect(remove).toBeInViewport({ ratio: 1 });
await remove.click();
@@ -86,6 +86,17 @@ export function setupModal(page: Page): Locator {
return page.getByTestId("onboarding-modal").getByRole("dialog");
}
/** A sheet opened from a setup step, which should sit exactly on the setup card. */
export function setupSheet(page: Page, testID: "provider-settings-sheet" | "add-provider-sheet") {
return page.getByTestId(testID).getByRole("dialog");
}
export async function expectSheetCoversSetupCard(page: Page, sheet: Locator): Promise<void> {
await expect(sheet).toBeVisible();
const card = await setupModal(page).boundingBox();
await expect.poll(() => sheet.boundingBox()).toEqual(card);
}
export async function expectSetupStep(page: Page, title: string): Promise<void> {
await expect(setupModal(page).getByRole("heading", { name: title, exact: true })).toBeVisible({
timeout: 60_000,
@@ -106,10 +106,12 @@ export async function verifyProviderSettings({
await test.step("provider settings render the registered icon", async () => {
await openSettings(page);
await openSettingsHostSection(page, getServerId(), "providers");
await expectProviderIcon(
page.getByRole("button", { name: "Direct provider example provider details", exact: true }),
iconPaths,
);
// The row's button lies under its content, so the icon is in the row, beside the button.
const opener = page.getByRole("button", {
name: "Direct provider example provider details",
exact: true,
});
await expectProviderIcon(page.getByTestId(/^provider-row-/).filter({ has: opener }), iconPaths);
await capture(page, testInfo, "provider-settings");
await page.getByTestId("settings-back-to-workspace").click();
});
@@ -6,7 +6,7 @@ import { gotoAppShell, openSettings } from "./app";
import { connectDaemonClient } from "./daemon-client-loader";
import { copyPluginExample, pluginRequirements } from "./plugin-fixture";
import { getServerId } from "./server-id";
import { openSettingsHostSection } from "./settings";
import { leaveProviderDetail, openSettingsHostSection } from "./settings";
const PLUGIN_ID = "provider-update-failure";
const PROVIDER_ID = "update-failure";
@@ -101,10 +101,30 @@ export async function runFailingUpdate(page: Page): Promise<void> {
}
export async function refreshProviderDetails(page: Page): Promise<void> {
await page
.getByTestId("provider-settings-sheet")
.getByRole("button", { name: "Refresh", exact: true })
.click();
await page.getByTestId("provider-refresh").click();
}
export async function backToProviderList(page: Page): Promise<void> {
await leaveProviderDetail(page);
}
function providerRow(page: Page) {
return page.getByTestId(`provider-row-${PROVIDER_ID}`);
}
/** The provider's row in the list reports the failed update, with the error dot. */
export async function expectRowReportsUpdateFailure(page: Page): Promise<void> {
const row = providerRow(page);
await expect(row).toContainText(FAILURE);
await expect(row.getByTestId("settings-row-error-dot")).toHaveCount(1);
}
/** The provider's row reads its version and model count again, with no error dot. */
export async function expectRowReadsVersionAndModels(page: Page): Promise<void> {
const row = providerRow(page);
await expect(row).toContainText("1.0.0 · 1 model");
await expect(row).not.toContainText(FAILURE);
await expect(row.getByTestId("settings-row-error-dot")).toHaveCount(0);
}
export async function refreshFromOtherClient(client: ObserverClient): Promise<void> {
+67 -2
View File
@@ -515,8 +515,8 @@ export async function serveJson(page: Page, url: string, body: unknown): Promise
});
}
export async function openAddProviderArea(page: Page): Promise<void> {
await page.getByTestId("host-page-add-provider-card").scrollIntoViewIfNeeded();
export async function openAddProvider(page: Page): Promise<void> {
await page.getByTestId("provider-list-add").click();
await expect(page.getByRole("textbox", { name: "Search providers" })).toBeVisible();
}
@@ -528,17 +528,82 @@ export async function findAcpCatalogProvider(page: Page, providerName: string):
export async function installAcpCatalogProvider(page: Page, providerName: string): Promise<void> {
await findAcpCatalogProvider(page, providerName);
await page.getByRole("button", { name: `Add ${providerName}`, exact: true }).click();
// The sheet closes once the add is done. Adding probes the new provider, which can outlast an
// assertion's default wait.
await expect(page.getByRole("textbox", { name: "Search providers" })).toHaveCount(0, {
timeout: 60_000,
});
}
/** Adding opens the new provider's page; its row waits in the list behind it. */
export async function expectProviderInstalledInSettings(
page: Page,
providerName: string,
): Promise<void> {
await expect(page.getByTestId("provider-detail-title")).toHaveText(providerName);
await page.getByTestId("provider-detail-back").click();
await expect(
page.getByRole("button", { name: `${providerName} provider details`, exact: true }),
).toBeVisible();
}
export async function openProviderDetail(page: Page, providerName: string): Promise<void> {
await page.getByRole("button", { name: `${providerName} provider details`, exact: true }).click();
await expect(page.getByTestId("provider-detail-title")).toHaveText(providerName);
}
/** Load a provider's Settings page from its URL, as a reload or a shared link does. */
export async function gotoProviderPage(
page: Page,
serverId: string,
providerId: string,
): Promise<void> {
await page.goto(
`/settings/hosts/${encodeURIComponent(serverId)}/providers/${encodeURIComponent(providerId)}`,
);
}
export async function expectProviderPageLoaded(page: Page, providerName: string): Promise<void> {
await expect(page.getByTestId("provider-detail-title")).toHaveText(providerName, {
timeout: 30_000,
});
await expect(page.getByText("Provider status")).toBeVisible({ timeout: 30_000 });
}
export async function expectProviderNotOnHost(page: Page): Promise<void> {
await expect(page.getByText("This provider isn't on this host")).toBeVisible({
timeout: 30_000,
});
}
/**
* The provider page says the provider's CLI is missing, and Install opens the given guide. The
* guide is served locally so the test never reaches the network.
*/
export async function expectInstallOpensGuide(page: Page, guideUrl: string): Promise<void> {
const installation = page.getByTestId("provider-installation");
await expect(installation.getByText("Not installed", { exact: true })).toBeVisible({
timeout: 30_000,
});
await page.context().route(guideUrl, (route) =>
route.fulfill({
status: 200,
contentType: "text/html",
body: "<title>Install guide</title>",
}),
);
const guide = page.waitForEvent("popup");
await installation.getByRole("button", { name: "Install", exact: true }).click();
const opened = await guide;
expect(opened.url()).toBe(guideUrl);
await opened.close();
}
export async function leaveProviderDetail(page: Page): Promise<void> {
await page.getByTestId("provider-detail-back").click();
await expect(page.getByTestId("provider-list")).toBeVisible();
}
export async function expectHostNoDaemonLifecycleRow(page: Page): Promise<void> {
await expect(page.getByTestId("host-page-daemon-lifecycle-card")).toHaveCount(0);
}
+1
View File
@@ -936,6 +936,7 @@ function RootStack() {
<Stack.Screen name="settings/hosts/[serverId]/plugin-directory/[owner]/[slug]" />
<Stack.Screen name="settings/hosts/[serverId]/projects/index" />
<Stack.Screen name="settings/hosts/[serverId]/projects/[projectId]" />
<Stack.Screen name="settings/hosts/[serverId]/providers/[providerId]" />
</ThemedStack>
);
}
@@ -0,0 +1,24 @@
import { useLocalSearchParams } from "expo-router";
import { useMemo } from "react";
import { HostRouteBootstrapBoundary } from "@/components/host-route-bootstrap-boundary";
import SettingsScreen from "@/screens/settings-screen";
import { normalizeProjectSettingsRouteId } from "@/utils/host-routes";
export default function SettingsHostProviderDetailRoute() {
const params = useLocalSearchParams<{
serverId?: string | string[];
providerId?: string | string[];
}>();
const serverId = normalizeProjectSettingsRouteId(params.serverId);
const providerId = normalizeProjectSettingsRouteId(params.providerId);
const view = useMemo(
() => ({ kind: "provider" as const, serverId, providerId }),
[providerId, serverId],
);
return (
<HostRouteBootstrapBoundary>
<SettingsScreen view={view} />
</HostRouteBootstrapBoundary>
);
}
@@ -437,11 +437,13 @@ export function SheetHeaderSubtitle({ text, testID }: { text: string; testID?: s
export function SheetHeaderView({
header,
onClose,
showCloseButton = true,
testID,
closeTestID,
}: {
header: SheetHeader;
onClose: () => void;
showCloseButton?: boolean;
testID?: string;
closeTestID?: string;
}) {
@@ -473,12 +475,14 @@ export function SheetHeaderView({
</View>
<View style={styles.headerTrailing}>
{header.actions}
<SheetHeaderIconButton
icon={X}
label={t("common.actions.close")}
onPress={onClose}
testID={closeTestID}
/>
{showCloseButton ? (
<SheetHeaderIconButton
icon={X}
label={t("common.actions.close")}
onPress={onClose}
testID={closeTestID}
/>
) : null}
</View>
</View>
</IconButtonChromeProvider>
@@ -566,6 +570,11 @@ export interface AdaptiveModalSheetProps {
* corner, and the compact sheet closes from its handle.
*/
header?: SheetHeader;
/**
* Leave out the header's close button when `header.back` is the only way out, as for a sheet
* that stands in for a page of the surface beneath it. Escape still closes the sheet.
*/
showCloseButton?: boolean;
visible: boolean;
onClose: () => void;
onDismiss?: () => void;
@@ -596,6 +605,7 @@ export interface AdaptiveModalSheetProps {
*/
function CompactSheetBody({
header,
showCloseButton,
onClose,
testID,
footer,
@@ -606,6 +616,7 @@ function CompactSheetBody({
children,
}: {
header?: SheetHeader;
showCloseButton: boolean;
onClose: () => void;
testID?: string;
footer: ReactNode;
@@ -635,7 +646,14 @@ function CompactSheetBody({
);
return (
<SheetVisibleFrame footer={footerView}>
{header ? <SheetHeaderView header={header} onClose={onClose} testID={testID} /> : null}
{header ? (
<SheetHeaderView
header={header}
onClose={onClose}
showCloseButton={showCloseButton}
testID={testID}
/>
) : null}
<View style={[styles.compactStaticContent, bodyStyle]}>
{scrollable ? (
<ScrollView
@@ -662,6 +680,7 @@ function CompactSheetBody({
export function AdaptiveModalSheet({
header,
showCloseButton = true,
visible,
onClose,
onDismiss,
@@ -789,6 +808,7 @@ export function AdaptiveModalSheet({
<OverlayLayerProvider layer={modalLayer}>
<CompactSheetBody
header={header}
showCloseButton={showCloseButton}
onClose={onClose}
testID={testID}
footer={footerView}
@@ -808,7 +828,9 @@ export function AdaptiveModalSheet({
desktopHeight == null ? styles.desktopStaticContent : styles.compactStaticContent;
const cardInner = (
<OverlayLayerProvider layer={modalLayer}>
{header ? <SheetHeaderView header={header} onClose={onClose} /> : null}
{header ? (
<SheetHeaderView header={header} onClose={onClose} showCloseButton={showCloseButton} />
) : null}
<View style={[scrollable ? styles.desktopScrollContainer : desktopStaticStyle, bodyStyle]}>
{scrollable ? (
<ScrollView
@@ -1,234 +0,0 @@
import { useCallback, useMemo, useState } from "react";
import { useTranslation } from "react-i18next";
import { Text, View, type LayoutChangeEvent } from "react-native";
import { SvgXml } from "react-native-svg";
import { StyleSheet, withUnistyles } from "react-native-unistyles";
import { PackagePlus } from "lucide-react-native";
import { Button } from "@/components/ui/button";
import { ExternalLink } from "@/components/ui/external-link";
import { SearchField } from "@/components/ui/search-field";
import { StatusBadge } from "@/components/ui/status-badge";
import { rankProviderCatalog } from "@/components/provider-catalog-search";
import {
useAcpProviderCatalog,
type AcpProviderCatalogItem,
} from "@/hooks/use-acp-provider-catalog";
import { useProvidersSnapshot } from "@/hooks/use-providers-snapshot";
import { SPACING, type Theme } from "@/styles/theme";
import { settingsStyles } from "@/styles/settings";
interface ProviderCatalogListProps {
serverId: string;
installingProviderId: string | null;
onInstall: (entry: AcpProviderCatalogItem) => Promise<void> | void;
}
const PROVIDER_FALLBACK_ICON_SIZE = 20;
const PROVIDER_REMOTE_ICON_SIZE = 24;
const TILE_GAP = SPACING[3];
/** Narrowest tile that keeps the icon, type badge, install link, and Add on one row. */
const MIN_TILE_WIDTH = 300;
const MAX_COLUMNS = 4;
const ThemedPackagePlus = withUnistyles(PackagePlus);
const ThemedSvgXml = withUnistyles(SvgXml);
const foregroundColorMapping = (theme: Theme) => ({ color: theme.colors.foreground });
function columnCountForWidth(width: number): number {
const fits = Math.floor((width + TILE_GAP) / (MIN_TILE_WIDTH + TILE_GAP));
return Math.min(MAX_COLUMNS, Math.max(1, fits));
}
interface CatalogTileProps {
entry: AcpProviderCatalogItem;
/** `undefined` until the grid is measured, or in a single column; the tile fills the row. */
width: number | undefined;
installing: boolean;
onInstall: (entry: AcpProviderCatalogItem) => void;
}
function CatalogTile({ entry, width, installing, onInstall }: CatalogTileProps) {
const { t } = useTranslation();
const handleInstall = useCallback(() => {
onInstall(entry);
}, [entry, onInstall]);
const tileStyle = useMemo(
() => [settingsStyles.card, styles.tile, width === undefined ? styles.tileFull : { width }],
[width],
);
return (
<View style={tileStyle} testID={`provider-catalog-tile-${entry.id}`}>
<View style={styles.iconFrame}>
{entry.iconSvg ? (
<ThemedSvgXml
xml={entry.iconSvg}
width={PROVIDER_REMOTE_ICON_SIZE}
height={PROVIDER_REMOTE_ICON_SIZE}
uniProps={foregroundColorMapping}
/>
) : (
<ThemedPackagePlus size={PROVIDER_FALLBACK_ICON_SIZE} uniProps={foregroundColorMapping} />
)}
</View>
<View style={styles.details}>
<Text style={styles.name} numberOfLines={1}>
{entry.title}
</Text>
<View style={styles.metaRow}>
{/* The catalog is the ACP registry, so every entry it offers is an ACP provider. */}
<StatusBadge label={t("providerCatalog.types.acp")} size="xs" />
<ExternalLink
href={entry.installLink}
label={t("providerCatalog.actions.installInstructions")}
accessibilityLabel={t("providerCatalog.actions.installInstructionsFor", {
provider: entry.title,
})}
/>
</View>
</View>
<Button
size="sm"
variant="outline"
disabled={installing}
loading={installing}
onPress={handleInstall}
accessibilityLabel={t("providerCatalog.actions.addProvider", { provider: entry.title })}
style={styles.addButton}
testID={`install-provider-${entry.id}`}
>
{installing ? t("providerCatalog.actions.adding") : t("providerCatalog.actions.add")}
</Button>
</View>
);
}
export function ProviderCatalogList({
serverId,
installingProviderId,
onInstall,
}: ProviderCatalogListProps) {
const { t } = useTranslation();
const { entries: catalogEntries } = useAcpProviderCatalog();
const { entries: providerEntries } = useProvidersSnapshot(serverId);
const [search, setSearch] = useState("");
const [gridWidth, setGridWidth] = useState<number | null>(null);
const installedIds = useMemo(
() => new Set(providerEntries?.map((entry) => entry.provider) ?? []),
[providerEntries],
);
const availableEntries = useMemo(
() =>
rankProviderCatalog(
catalogEntries.filter((entry) => !installedIds.has(entry.id)),
search,
),
[catalogEntries, installedIds, search],
);
const handleGridLayout = useCallback((event: LayoutChangeEvent) => {
setGridWidth(event.nativeEvent.layout.width);
}, []);
const tileWidth = useMemo(() => {
if (gridWidth === null) return undefined;
const columns = columnCountForWidth(gridWidth);
if (columns === 1) return undefined;
return Math.floor((gridWidth - TILE_GAP * (columns - 1)) / columns);
}, [gridWidth]);
return (
<View>
<View style={styles.searchRail}>
<SearchField
value={search}
onChangeText={setSearch}
placeholder={t("providerCatalog.search")}
clearAccessibilityLabel={t("providerCatalog.clearSearch")}
testID="provider-catalog-search"
clearTestID="provider-catalog-search-clear"
/>
</View>
{availableEntries.length === 0 ? (
<View style={[settingsStyles.card, styles.stateBox]}>
<Text style={styles.stateText}>{t("providerCatalog.noProviders")}</Text>
</View>
) : (
<View style={styles.grid} onLayout={handleGridLayout}>
{availableEntries.map((entry) => (
<CatalogTile
key={entry.id}
entry={entry}
width={tileWidth}
installing={installingProviderId === entry.id}
onInstall={onInstall}
/>
))}
</View>
)}
</View>
);
}
const styles = StyleSheet.create((theme) => ({
searchRail: {
flexDirection: "row",
marginBottom: theme.spacing[3],
},
grid: {
flexDirection: "row",
flexWrap: "wrap",
gap: TILE_GAP,
},
tile: {
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[3],
padding: theme.spacing[3],
},
tileFull: {
width: "100%",
},
details: {
flex: 1,
minWidth: 0,
gap: theme.spacing[1],
},
iconFrame: {
flexShrink: 0,
width: 36,
height: 36,
borderRadius: theme.borderRadius.md,
backgroundColor: theme.colors.surface2,
alignItems: "center",
justifyContent: "center",
},
addButton: {
flexShrink: 0,
},
name: {
color: theme.colors.foreground,
fontSize: theme.fontSize.base,
fontWeight: theme.fontWeight.normal,
},
metaRow: {
flexDirection: "row",
flexWrap: "wrap",
alignItems: "center",
gap: theme.spacing[2],
},
stateBox: {
minHeight: 96,
alignItems: "center",
justifyContent: "center",
padding: theme.spacing[4],
},
stateText: {
color: theme.colors.foregroundMuted,
fontSize: theme.fontSize.base,
},
}));
@@ -1,836 +0,0 @@
import * as Clipboard from "expo-clipboard";
import { AlertTriangle, Copy, FileText, Plus, RotateCw, Trash2 } from "lucide-react-native";
import type { TFunction } from "i18next";
import { useCallback, useEffect, useMemo, useRef, useState } from "react";
import { useTranslation } from "react-i18next";
import { Pressable, type PressableStateCallbackType, Text, View } from "react-native";
import { StyleSheet, useUnistyles } from "react-native-unistyles";
import {
AdaptiveModalSheet,
AdaptiveTextInput,
SheetHeaderIconButton,
type SheetHeader,
} from "@/components/adaptive-modal-sheet";
import { Button } from "@/components/ui/button";
import { LoadingSpinner } from "@/components/ui/loading-spinner";
import { ScrollableCodeSurface, SurfaceCard } from "@/components/ui/scrollable-code-surface";
import { useIsCompactFormFactor } from "@/constants/layout";
import { isWeb } from "@/constants/platform";
import { useToast } from "@/contexts/toast-context";
import { CODE_SURFACE_DATASET } from "@/styles/code-surface";
import { useDaemonConfig } from "@/hooks/use-daemon-config";
import { useProvidersSnapshot } from "@/hooks/use-providers-snapshot";
import { useTimeAgo } from "@/hooks/use-time-ago";
import { useHostRuntimeClient } from "@/runtime/host-runtime";
import { settingsStyles } from "@/styles/settings";
import { resolveProviderLabel } from "@/utils/provider-definitions";
import { compareMatchScores, scoreTextFields } from "@getpaseo/protocol/search/text-match";
import type { AgentModelDefinition, AgentProvider } from "@getpaseo/protocol/agent-types";
import type { ProviderProfileModel } from "@getpaseo/protocol/provider-config";
import { ProviderInstallationSection } from "./provider-installation-section";
import { useProviderInstallation } from "./provider-installation";
import {
resolveProviderDiscoveredModels,
type ProviderDiscoveredModelsCache,
} from "./provider-diagnostic-models";
interface ProviderDiagnosticSheetProps {
provider: string;
visible: boolean;
onClose: () => void;
serverId: string;
}
function rankModels<T>(items: T[], query: string, fields: (item: T) => string[]): T[] {
if (!query.trim()) return items;
const scored = items
.map((item) => ({ item, score: scoreTextFields(query, fields(item)) }))
.filter(
(entry): entry is { item: T; score: NonNullable<typeof entry.score> } => entry.score !== null,
);
scored.sort((a, b) => compareMatchScores(a.score, b.score));
return scored.map((entry) => entry.item);
}
function DiscoveredModelRow({ model }: { model: AgentModelDefinition }) {
return (
<View style={sheetStyles.modelRow}>
<Text style={sheetStyles.modelTitle} numberOfLines={1}>
{model.label}
</Text>
<Text
style={sheetStyles.monoHint}
numberOfLines={1}
selectable
dataSet={CODE_SURFACE_DATASET}
>
{model.id}
</Text>
{model.description ? (
<Text style={sheetStyles.descriptionInline} numberOfLines={1}>
{model.description}
</Text>
) : null}
</View>
);
}
function CustomModelRow({
model,
deleting,
onDelete,
}: {
model: ProviderProfileModel;
deleting: boolean;
onDelete: (modelId: string) => void;
}) {
const { t } = useTranslation();
const { theme } = useUnistyles();
const handleDelete = useCallback(() => onDelete(model.id), [model.id, onDelete]);
const deleteButtonStyle = useCallback(
({ hovered, pressed }: PressableStateCallbackType & { hovered?: boolean }) => [
sheetStyles.iconButton,
(Boolean(hovered) || pressed) && sheetStyles.iconButtonHovered,
deleting ? sheetStyles.disabled : null,
],
[deleting],
);
return (
<View style={sheetStyles.modelRow}>
<Text style={[sheetStyles.modelTitle, sheetStyles.customModelText]} numberOfLines={1}>
{model.label}
</Text>
<Text
style={[sheetStyles.monoHint, sheetStyles.customModelText]}
numberOfLines={1}
selectable
dataSet={CODE_SURFACE_DATASET}
>
{model.id}
</Text>
<View style={sheetStyles.modelRowFiller} />
<Pressable
onPress={handleDelete}
disabled={deleting}
hitSlop={8}
style={deleteButtonStyle}
accessibilityRole="button"
accessibilityLabel={t("settings.providers.models.removeModel", { id: model.id })}
>
<Trash2 size={theme.iconSize.sm} color={theme.colors.destructive} />
</Pressable>
</View>
);
}
function SectionHeader({ title, count, hint }: { title: string; count?: number; hint?: string }) {
return (
<View style={sheetStyles.sectionHeader}>
<Text style={settingsStyles.sectionHeaderTitle}>{title}</Text>
<View style={sheetStyles.sectionHeaderMeta}>
{count !== undefined ? (
<Text style={settingsStyles.sectionHeaderTitle}>{count}</Text>
) : null}
{count !== undefined && hint ? (
<Text style={settingsStyles.sectionHeaderTitle}>·</Text>
) : null}
{hint ? <Text style={settingsStyles.sectionHeaderTitle}>{hint}</Text> : null}
</View>
</View>
);
}
function AddCustomModelSubSheet({
provider,
serverId,
visible,
onClose,
refresh,
}: {
provider: string;
serverId: string;
visible: boolean;
onClose: () => void;
refresh: (providers?: AgentProvider[]) => Promise<void>;
}) {
const { t } = useTranslation();
const { theme } = useUnistyles();
const { config, patchConfig } = useDaemonConfig(serverId);
const [input, setInput] = useState("");
const [error, setError] = useState<string | null>(null);
const [saving, setSaving] = useState(false);
const additionalModels = useMemo(
() => config?.providers?.[provider]?.additionalModels ?? [],
[config?.providers, provider],
);
const trimmed = input.trim();
const canAdd = trimmed.length > 0 && !additionalModels.some((model) => model.id === trimmed);
useEffect(() => {
if (!visible) {
setInput("");
setError(null);
}
}, [visible]);
const handleAdd = useCallback(() => {
if (!canAdd) return;
setError(null);
setSaving(true);
void patchConfig({
providers: {
[provider]: {
additionalModels: [...additionalModels, { id: trimmed, label: trimmed }],
},
},
})
.then(() => refresh([provider]))
.then(() => onClose())
.catch((err) => {
setError(err instanceof Error ? err.message : t("settings.providers.models.failedToSave"));
})
.finally(() => setSaving(false));
}, [additionalModels, canAdd, onClose, patchConfig, provider, refresh, t, trimmed]);
const header = useMemo<SheetHeader>(
() => ({ title: t("settings.providers.models.addCustomTitle") }),
[t],
);
return (
<AdaptiveModalSheet
header={header}
visible={visible}
onClose={onClose}
desktopMaxWidth={420}
snapPoints={ADD_SNAP_POINTS}
testID="add-custom-model-sheet"
>
<View style={sheetStyles.formGroup}>
<Text style={sheetStyles.formLabel}>{t("settings.providers.models.modelId")}</Text>
<AdaptiveTextInput
initialValue={input}
resetKey={`add-custom-${visible}`}
onChangeText={setInput}
onSubmitEditing={handleAdd}
placeholder={t("settings.providers.models.modelIdPlaceholder")}
placeholderTextColor={theme.colors.foregroundMuted}
autoCapitalize="none"
autoCorrect={false}
returnKeyType="done"
// @ts-expect-error - outlineStyle is web-only
style={[sheetStyles.formInput, isWeb && { outlineStyle: "none" }]}
/>
{error ? <Text style={sheetStyles.errorText}>{error}</Text> : null}
<View style={sheetStyles.formActions}>
<Button variant="secondary" onPress={onClose} disabled={saving}>
{t("common.actions.cancel")}
</Button>
<Button variant="default" onPress={handleAdd} disabled={!canAdd || saving}>
{saving ? t("settings.providers.models.adding") : t("settings.providers.models.add")}
</Button>
</View>
</View>
</AdaptiveModalSheet>
);
}
function DiagnosticSubSheet({
provider,
serverId,
visible,
onClose,
}: {
provider: string;
serverId: string;
visible: boolean;
onClose: () => void;
}) {
const { t } = useTranslation();
const { theme } = useUnistyles();
const toast = useToast();
const client = useHostRuntimeClient(serverId);
const [diagnostic, setDiagnostic] = useState<string | null>(null);
const [loading, setLoading] = useState(false);
const fetchDiagnostic = useCallback(async () => {
if (!client) return;
setLoading(true);
try {
const result = await client.getProviderDiagnostic(provider);
setDiagnostic(result.diagnostic);
} catch (err) {
setDiagnostic(
err instanceof Error ? err.message : t("settings.providers.diagnostic.failedToFetch"),
);
} finally {
setLoading(false);
}
}, [client, provider, t]);
useEffect(() => {
if (visible) {
void fetchDiagnostic();
} else {
setDiagnostic(null);
}
}, [visible, fetchDiagnostic]);
const handleRefreshPress = useCallback(() => {
void fetchDiagnostic();
}, [fetchDiagnostic]);
const handleCopyPress = useCallback(() => {
if (!diagnostic) return;
void Clipboard.setStringAsync(diagnostic)
.then(() => toast.copied(t("settings.providers.diagnostic.copyLabel")))
.catch(() => toast.error(t("settings.providers.diagnostic.copyFailed")));
}, [diagnostic, t, toast]);
const header = useMemo<SheetHeader>(
() => ({
title: t("settings.providers.diagnostic.title"),
actions: (
<>
<SheetHeaderIconButton
icon={Copy}
label={t("settings.providers.diagnostic.copyAccessibility")}
onPress={handleCopyPress}
disabled={!diagnostic}
/>
<SheetHeaderIconButton
icon={RotateCw}
label={
loading
? t("settings.providers.diagnostic.refreshingAccessibility")
: t("settings.providers.diagnostic.refreshAccessibility")
}
onPress={handleRefreshPress}
busy={loading}
/>
</>
),
}),
[diagnostic, handleCopyPress, handleRefreshPress, loading, t],
);
let body: React.ReactNode;
if (loading && !diagnostic) {
body = (
<SurfaceCard key={visible ? "visible" : "hidden"}>
<View style={sheetStyles.codeBlockLoading}>
<LoadingSpinner size="small" color={theme.colors.foregroundMuted} />
<Text style={sheetStyles.mutedText}>{t("settings.providers.diagnostic.running")}</Text>
</View>
</SurfaceCard>
);
} else if (diagnostic) {
body = (
<ScrollableCodeSurface key={visible ? "visible" : "hidden"} maxHeight={480}>
{diagnostic}
</ScrollableCodeSurface>
);
} else {
body = (
<SurfaceCard key={visible ? "visible" : "hidden"}>
<View style={sheetStyles.codeBlockLoading}>
<Text style={sheetStyles.mutedText}>{t("settings.providers.diagnostic.none")}</Text>
</View>
</SurfaceCard>
);
}
return (
<AdaptiveModalSheet
header={header}
visible={visible}
onClose={onClose}
snapPoints={DIAGNOSTIC_SNAP_POINTS}
scrollable={false}
testID="provider-diagnostic-sheet"
>
{body}
</AdaptiveModalSheet>
);
}
interface ProviderModalBodyProps {
discoveredCount: number;
additionalCount: number;
providerSnapshotRefreshing: boolean;
providerErrorMessage: string | null;
modelsRefreshing: boolean;
searchActive: boolean;
filteredDiscovered: AgentModelDefinition[];
filteredCustom: ProviderProfileModel[];
deletingModelId: string | null;
onRefresh: () => void;
onDeleteCustom: (modelId: string) => void;
theme: { iconSize: { md: number }; colors: { foregroundMuted: string } };
}
interface ProviderSheetFooterInput {
fetchedAt: string | null;
isCompact: boolean;
/** Models or the installation are being read again. */
refreshing: boolean;
t: TFunction;
onOpenAddSheet: () => void;
onOpenDiagSheet: () => void;
onRefreshModels: () => void;
}
function renderProviderSheetFooter({
fetchedAt,
isCompact,
refreshing,
t,
onOpenAddSheet,
onOpenDiagSheet,
onRefreshModels,
}: ProviderSheetFooterInput) {
const contentStyle = isCompact ? sheetStyles.compactFooterContent : sheetStyles.footerContent;
const actionsStyle = isCompact ? sheetStyles.compactFooterActions : sheetStyles.footerActions;
const buttonStyle = isCompact ? sheetStyles.compactFooterButton : null;
return (
<View style={contentStyle}>
{fetchedAt || !isCompact ? (
<ProviderUpdatedLabel fetchedAt={fetchedAt} isCompact={isCompact} />
) : null}
<View style={actionsStyle}>
<Button variant="secondary" leftIcon={Plus} onPress={onOpenAddSheet} style={buttonStyle}>
{t("settings.providers.models.addModel")}
</Button>
<Button
variant="secondary"
leftIcon={FileText}
onPress={onOpenDiagSheet}
style={buttonStyle}
>
{t("settings.providers.diagnostic.button")}
</Button>
<Button
variant="default"
leftIcon={refreshing ? undefined : RotateCw}
onPress={onRefreshModels}
disabled={refreshing}
style={buttonStyle}
>
{refreshing
? t("settings.providers.diagnostic.refreshing")
: t("settings.providers.diagnostic.refresh")}
</Button>
</View>
</View>
);
}
function ProviderUpdatedLabel({
fetchedAt,
isCompact,
}: {
fetchedAt: string | null;
isCompact: boolean;
}) {
const { t } = useTranslation();
const label = useTimeAgo(fetchedAt ? new Date(fetchedAt) : null);
const style = isCompact
? [sheetStyles.footerMeta, sheetStyles.compactFooterMeta]
: sheetStyles.footerMeta;
return (
<Text style={style} numberOfLines={1}>
{fetchedAt ? t("settings.providers.models.updated", { time: label }) : ""}
</Text>
);
}
function ProviderModalBody(props: ProviderModalBodyProps) {
const { t } = useTranslation();
const {
discoveredCount,
additionalCount,
providerSnapshotRefreshing,
providerErrorMessage,
modelsRefreshing,
searchActive,
filteredDiscovered,
filteredCustom,
deletingModelId,
onRefresh,
onDeleteCustom,
theme,
} = props;
if (discoveredCount === 0 && additionalCount === 0 && providerSnapshotRefreshing) {
return (
<View style={sheetStyles.emptyState}>
<LoadingSpinner size="small" color={theme.colors.foregroundMuted} />
<Text style={sheetStyles.mutedText}>{t("settings.providers.models.loading")}</Text>
</View>
);
}
if (discoveredCount === 0 && additionalCount === 0 && providerErrorMessage) {
return (
<View style={sheetStyles.emptyState}>
<AlertTriangle size={theme.iconSize.md} color={theme.colors.foregroundMuted} />
<Text style={sheetStyles.mutedText}>{providerErrorMessage}</Text>
<Button variant="default" onPress={onRefresh} disabled={modelsRefreshing}>
{modelsRefreshing
? t("settings.providers.models.retrying")
: t("settings.providers.models.retry")}
</Button>
</View>
);
}
if (filteredDiscovered.length === 0 && filteredCustom.length === 0 && searchActive) {
return (
<View style={sheetStyles.emptyState}>
<Text style={sheetStyles.mutedText}>{t("settings.providers.models.noSearchMatches")}</Text>
</View>
);
}
if (discoveredCount === 0 && additionalCount === 0) {
return (
<View style={sheetStyles.emptyState}>
<Text style={sheetStyles.mutedText}>{t("settings.providers.models.noneDetected")}</Text>
</View>
);
}
return (
<>
{filteredDiscovered.length > 0 ? (
<View style={sheetStyles.section}>
<SectionHeader
title={t("settings.providers.models.discovered")}
count={filteredDiscovered.length}
/>
<View style={settingsStyles.card}>
{filteredDiscovered.map((model) => (
<DiscoveredModelRow key={model.id} model={model} />
))}
</View>
</View>
) : null}
{filteredCustom.length > 0 ? (
<View style={sheetStyles.section}>
<SectionHeader
title={t("settings.providers.models.custom")}
count={filteredCustom.length}
/>
<View style={settingsStyles.card}>
{filteredCustom.map((model) => (
<CustomModelRow
key={model.id}
model={model}
deleting={deletingModelId === model.id}
onDelete={onDeleteCustom}
/>
))}
</View>
</View>
) : null}
</>
);
}
export function ProviderDiagnosticSheet({
provider,
visible,
onClose,
serverId,
}: ProviderDiagnosticSheetProps) {
const { t } = useTranslation();
const { theme } = useUnistyles();
const isCompact = useIsCompactFormFactor();
const { entries: snapshotEntries, refresh, isRefreshing } = useProvidersSnapshot(serverId);
const { config, patchConfig } = useDaemonConfig(serverId);
const [query, setQuery] = useState("");
const [addSheetOpen, setAddSheetOpen] = useState(false);
const [diagSheetOpen, setDiagSheetOpen] = useState(false);
const [deletingModelId, setDeletingModelId] = useState<string | null>(null);
const providerLabel = resolveProviderLabel(provider, snapshotEntries);
const providerEntry = useMemo(
() => snapshotEntries?.find((entry) => entry.provider === provider),
[snapshotEntries, provider],
);
const additionalModels = useMemo(
() => config?.providers?.[provider]?.additionalModels ?? [],
[config?.providers, provider],
);
const providerSnapshotRefreshing = providerEntry?.status === "loading";
const providerErrorMessage =
providerEntry?.status === "error"
? (providerEntry.error ?? t("settings.providers.diagnostic.unknownError"))
: null;
const modelsRefreshing = isRefreshing || providerSnapshotRefreshing;
const stableDiscoveredRef = useRef<ProviderDiscoveredModelsCache | null>(null);
const currentModels = providerEntry?.models;
const { models: discoveredModels, cache: nextDiscoveredCache } = resolveProviderDiscoveredModels({
serverId,
provider,
currentModels,
providerSnapshotRefreshing,
previousCache: stableDiscoveredRef.current,
});
stableDiscoveredRef.current = nextDiscoveredCache;
useEffect(() => {
if (!visible) {
setQuery("");
setAddSheetOpen(false);
setDiagSheetOpen(false);
}
}, [visible]);
const q = query.trim();
const filteredDiscovered = useMemo(
() => rankModels(discoveredModels, q, (m) => [m.label, m.id, m.description ?? ""]),
[discoveredModels, q],
);
const filteredCustom = useMemo(
() => rankModels(additionalModels, q, (m) => [m.label, m.id]),
[additionalModels, q],
);
const installation = useProviderInstallation({ serverId, provider, visible });
const refreshInstallation = installation.refresh;
const handleRefreshModels = useCallback(() => {
void refresh([provider]);
refreshInstallation();
}, [provider, refresh, refreshInstallation]);
const handleOpenAddSheet = useCallback(() => setAddSheetOpen(true), []);
const handleCloseAddSheet = useCallback(() => setAddSheetOpen(false), []);
const handleOpenDiagSheet = useCallback(() => setDiagSheetOpen(true), []);
const handleCloseDiagSheet = useCallback(() => setDiagSheetOpen(false), []);
const handleDeleteCustom = useCallback(
(modelId: string) => {
setDeletingModelId(modelId);
void patchConfig({
providers: {
[provider]: {
additionalModels: additionalModels.filter((model) => model.id !== modelId),
},
},
})
.then(() => refresh([provider]))
.finally(() => {
setDeletingModelId((current) => (current === modelId ? null : current));
});
},
[additionalModels, patchConfig, provider, refresh],
);
const sheetHeader = useMemo<SheetHeader>(
() => ({
title: providerLabel,
search: {
onChange: setQuery,
placeholder: t("settings.providers.models.searchPlaceholder"),
testID: "provider-settings-search",
},
}),
[providerLabel, t],
);
return (
<>
<AdaptiveModalSheet
header={sheetHeader}
visible={visible}
onClose={onClose}
testID="provider-settings-sheet"
footer={renderProviderSheetFooter({
fetchedAt: providerEntry?.fetchedAt ?? null,
isCompact,
refreshing: modelsRefreshing || installation.refreshing,
t,
onOpenAddSheet: handleOpenAddSheet,
onOpenDiagSheet: handleOpenDiagSheet,
onRefreshModels: handleRefreshModels,
})}
snapPoints={MAIN_SNAP_POINTS}
>
<ProviderInstallationSection
state={installation.state}
updates={installation.updates}
action={installation.action}
/>
<ProviderModalBody
discoveredCount={discoveredModels.length}
additionalCount={additionalModels.length}
providerSnapshotRefreshing={providerSnapshotRefreshing}
providerErrorMessage={providerErrorMessage}
modelsRefreshing={modelsRefreshing}
searchActive={Boolean(q)}
filteredDiscovered={filteredDiscovered}
filteredCustom={filteredCustom}
deletingModelId={deletingModelId}
onRefresh={handleRefreshModels}
onDeleteCustom={handleDeleteCustom}
theme={theme}
/>
</AdaptiveModalSheet>
<AddCustomModelSubSheet
provider={provider}
serverId={serverId}
visible={addSheetOpen}
onClose={handleCloseAddSheet}
refresh={refresh}
/>
<DiagnosticSubSheet
provider={provider}
serverId={serverId}
visible={diagSheetOpen}
onClose={handleCloseDiagSheet}
/>
</>
);
}
const sheetStyles = StyleSheet.create((theme) => ({
mutedText: {
fontSize: theme.fontSize.base,
color: theme.colors.foregroundMuted,
},
monoHint: {
fontFamily: theme.fontFamily.mono,
fontSize: theme.fontSize.code,
color: theme.colors.foregroundMuted,
flexShrink: 0,
},
descriptionInline: {
flex: 1,
fontSize: theme.fontSize.sm,
color: theme.colors.foregroundMuted,
},
errorText: {
fontSize: theme.fontSize.sm,
color: theme.colors.destructive,
},
formInput: {
backgroundColor: theme.colors.surface2,
borderRadius: theme.borderRadius.lg,
paddingHorizontal: theme.spacing[4],
paddingVertical: theme.spacing[3],
color: theme.colors.foreground,
borderWidth: 1,
borderColor: theme.colors.border,
fontSize: theme.fontSize.base,
},
iconButton: {
width: 28,
height: 28,
flexShrink: 0,
borderRadius: theme.borderRadius.full,
alignItems: "center",
justifyContent: "center",
},
iconButtonHovered: {
backgroundColor: theme.colors.surface2,
},
disabled: {
opacity: 0.5,
},
section: {
marginBottom: theme.spacing[4],
},
sectionHeader: {
flexDirection: "row",
alignItems: "center",
justifyContent: "space-between",
gap: theme.spacing[2],
marginBottom: theme.spacing[2],
marginLeft: theme.spacing[1],
},
sectionHeaderMeta: {
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[1],
},
modelRow: {
flexDirection: "row",
alignItems: "center",
paddingVertical: theme.spacing[2],
paddingHorizontal: theme.spacing[4],
gap: theme.spacing[3],
borderTopWidth: 1,
borderTopColor: theme.colors.border,
},
modelTitle: {
color: theme.colors.foreground,
fontSize: theme.fontSize.base,
flexShrink: 0,
},
customModelText: {
flexShrink: 1,
minWidth: 0,
},
modelRowFiller: {
flex: 1,
},
emptyState: {
paddingVertical: theme.spacing[8],
alignItems: "center",
gap: theme.spacing[3],
},
footerContent: {
flex: 1,
flexDirection: "row",
alignItems: "center",
justifyContent: "space-between",
gap: theme.spacing[2],
},
compactFooterContent: {
flex: 1,
gap: theme.spacing[2],
},
footerMeta: {
flex: 1,
fontSize: theme.fontSize.sm,
color: theme.colors.foregroundMuted,
},
compactFooterMeta: {
flex: 0,
},
footerActions: {
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[2],
},
compactFooterActions: {
gap: theme.spacing[2],
},
compactFooterButton: {
alignSelf: "stretch",
},
formGroup: {
gap: theme.spacing[3],
},
formLabel: {
fontSize: theme.fontSize.base,
fontWeight: theme.fontWeight.medium,
color: theme.colors.foreground,
},
formActions: {
flexDirection: "row",
justifyContent: "flex-end",
gap: theme.spacing[2],
},
codeBlockLoading: {
paddingVertical: theme.spacing[4],
paddingHorizontal: theme.spacing[4],
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[2],
},
}));
const MAIN_SNAP_POINTS = ["65%", "92%"];
const ADD_SNAP_POINTS = ["40%"];
const DIAGNOSTIC_SNAP_POINTS = ["50%", "85%"];
@@ -1,5 +1,5 @@
import { useCallback } from "react";
import { ProviderDiagnosticSheet } from "@/components/provider-diagnostic-sheet";
import { ProviderDetailSheet } from "@/provider-settings";
import { OverlayLayerProvider } from "@/lib/overlay-root";
import { useProviderSettingsStore } from "@/stores/provider-settings-store";
@@ -20,7 +20,7 @@ export function ProviderSettingsHost() {
return (
<OverlayLayerProvider layer={overlayParentLayer}>
<ProviderDiagnosticSheet
<ProviderDetailSheet
key={`${serverId}:${provider}`}
provider={provider}
serverId={serverId}
@@ -0,0 +1,60 @@
import { Plus } from "lucide-react-native";
import { useCallback } from "react";
import { Text, View, type PressableStateCallbackType } from "react-native";
import { StyleSheet, withUnistyles } from "react-native-unistyles";
import { mutedIconColorMapping } from "@/components/ui/icon-color";
import { PressHighlight } from "@/components/ui/press-highlight";
import { ICON_SIZE } from "@/styles/theme";
import { useSettingsRowLayout } from "./row-density";
const ThemedPlus = withUnistyles(Plus);
type HoverState = PressableStateCallbackType & { hovered?: boolean };
/**
* The last row of a card that lists things, adding one more. Quiet, so the list reads first: a
* muted plus in the rows' leading slot and a muted label on the labels' rail.
*/
export function SettingsAddRow({
label,
onPress,
testID,
}: {
label: string;
onPress: () => void;
testID?: string;
}) {
const layout = useSettingsRowLayout();
const rowStyle = useCallback(
({ hovered, pressed }: HoverState) => [
layout.row,
styles.row,
hovered && styles.hovered,
pressed && styles.pressed,
],
[layout],
);
return (
<PressHighlight
accessibilityRole="button"
accessibilityLabel={label}
onPress={onPress}
style={rowStyle}
highlightStyle={styles.pressed}
testID={testID}
>
<View style={styles.leading}>
<ThemedPlus size={ICON_SIZE.md} uniProps={mutedIconColorMapping} />
</View>
<Text style={[layout.title, styles.label]}>{label}</Text>
</PressHighlight>
);
}
const styles = StyleSheet.create((theme) => ({
row: { justifyContent: "flex-start" },
leading: { marginRight: theme.spacing[3], alignItems: "center", justifyContent: "center" },
label: { color: theme.colors.foregroundMuted },
hovered: { backgroundColor: theme.colors.surface2 },
pressed: { backgroundColor: theme.colors.surface3 },
}));
@@ -0,0 +1,86 @@
import { ArrowLeft } from "lucide-react-native";
import type { ReactNode } from "react";
import { Text, View } from "react-native";
import { StyleSheet } from "react-native-unistyles";
import { Button } from "@/components/ui/button";
/**
* "Back to …" above a settings detail page on wide layouts, where the page has no header of its
* own. The ghost button drops its padding so the arrow sits on the content's leading rail.
*/
export function SettingsBackLink({
label,
onPress,
testID,
}: {
label: string;
onPress: () => void;
testID?: string;
}) {
return (
<Button
testID={testID}
accessibilityLabel={label}
onPress={onPress}
variant="ghost"
leftIcon={ArrowLeft}
style={styles.backLink}
>
{label}
</Button>
);
}
/**
* The top of a settings detail page: "Back to …" when the page has no header of its own, then the
* icon and name the page is about, with an optional action after the name.
*/
export function SettingsDetailHeader({
back,
icon,
title,
trailing,
titleTestID,
}: {
back?: { label: string; onPress: () => void; testID?: string };
icon: ReactNode;
title: string;
trailing?: ReactNode;
titleTestID?: string;
}) {
return (
<View style={styles.header}>
{back ? <SettingsBackLink {...back} /> : null}
<View style={styles.titleRow}>
{icon}
<Text style={styles.title} numberOfLines={1} testID={titleTestID}>
{title}
</Text>
{trailing}
</View>
</View>
);
}
const styles = StyleSheet.create((theme) => ({
backLink: {
alignSelf: "flex-start",
paddingHorizontal: 0,
},
header: {
gap: theme.spacing[2],
marginBottom: theme.spacing[4],
},
titleRow: {
marginTop: theme.spacing[2],
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[3],
},
title: {
color: theme.colors.foreground,
fontSize: theme.fontSize.base,
fontWeight: theme.fontWeight.medium,
flexShrink: 1,
},
}));
@@ -1,12 +1,16 @@
import type { ReactNode } from "react";
import { SettingsRowHeader } from "./row-header";
import { SettingsRowHeader, type SettingsRowHintStatus } from "./row-header";
interface SettingsDetailRowProps {
label: string;
/** An icon before the label, such as the thing the row opens. */
leading?: ReactNode;
/** Shown beside the label, such as a badge. */
labelAccessory?: ReactNode;
/** A line under the label saying what the row leads to. */
hint?: string;
/** Marks the hint as work under way, a fault, or a value still loading. */
hintStatus?: SettingsRowHintStatus;
/** What the detail is set to, so the row says it without being opened. */
summary?: string;
onPress: () => void;
@@ -14,6 +18,10 @@ interface SettingsDetailRowProps {
disabled?: boolean;
/** Opens a page outside the app; an outward arrow replaces the chevron. */
external?: boolean;
/** A control acting on the row's subject in place, such as a switch, before the chevron. */
control?: ReactNode;
/** Names the row for assistive tech when the label alone does not say where it leads. */
accessibilityLabel?: string;
testID?: string;
}
+12 -1
View File
@@ -30,12 +30,17 @@ export { SettingsGroup } from "./headings/settings-group";
export { SettingsSection } from "./headings/settings-section";
export { SettingsCollapsibleRow } from "./collapsible-row";
export { SettingsDetailRow } from "./detail-row";
export type { SettingsRowHintStatus } from "./row-header";
export { SettingsAddRow } from "./add-row";
export { SettingsBackLink, SettingsDetailHeader } from "./detail-header";
export { SettingsInfoTip } from "./headings/settings-info-tip";
export { MenuSettingsRows } from "./row-density";
/** What app screens can add to a plugin-facing row: an accessory beside the label, such as an info tip. */
interface AppRowExtras {
labelAccessory?: ReactNode;
/** An icon before the label, such as the thing the row is about. */
leading?: ReactNode;
}
interface AppSettingsRowProps extends Omit<SettingsRowProps, "hint">, AppRowExtras {
@@ -59,6 +64,7 @@ export function SettingsCard({ children, testID }: { children: ReactNode; testID
export function SettingsRow({
label,
leading,
labelAccessory,
hint,
error,
@@ -71,6 +77,7 @@ export function SettingsRow({
const accessoryTitleStyle = useMemo(() => [layout.title, styles.accessoryLabel], [layout]);
return (
<View style={rowStyle} testID={testID}>
{leading ? <View style={styles.leading}>{leading}</View> : null}
<View style={styles.label}>
{labelAccessory ? (
<View style={styles.labelRow}>
@@ -208,7 +215,11 @@ export function SettingsAction({ actionLabel, onPress, disabled, ...row }: Setti
}
const styles = StyleSheet.create((theme) => ({
compactRow: { flexWrap: "wrap", gap: theme.spacing[3] },
// A control that wraps under the label gets space above it. Across the row, the leading slot and
// the label already carry their own margins, so a column gap would double them.
compactRow: { flexWrap: "wrap", rowGap: theme.spacing[3] },
// The same leading slot as `SettingsRowHeader`, so icons and labels share rails across row kinds.
leading: { marginRight: theme.spacing[3], alignItems: "center", justifyContent: "center" },
label: { flexGrow: 1, flexShrink: 1, flexBasis: 160, marginRight: theme.spacing[3] },
labelRow: {
flexDirection: "row",
@@ -2,7 +2,12 @@ import React, { act } from "react";
import { createRoot, type Root } from "react-dom/client";
import { afterEach, describe, expect, it } from "vitest";
import { Button } from "@/components/ui/button";
import { SettingsCard, SettingsCollapsibleRow, SettingsRow } from "@/components/settings";
import {
SettingsCard,
SettingsCollapsibleRow,
SettingsDetailRow,
SettingsRow,
} from "@/components/settings";
let root: Root | null = null;
let container: HTMLDivElement | null = null;
@@ -14,6 +19,8 @@ afterEach(() => {
container = null;
});
function openNothing() {}
function mountRows() {
container = document.createElement("div");
document.body.appendChild(container);
@@ -26,6 +33,7 @@ function mountRows() {
Download
</Button>
</SettingsRow>
<SettingsDetailRow label="Opens a page" onPress={openNothing} testID="detail-row" />
<SettingsCollapsibleRow label="Group" defaultExpanded testID="group">
<SettingsRow label="Nested with a button" testID="nested-with-button">
<Button variant="outline" testID="nested-button">
@@ -66,6 +74,13 @@ describe("settings row density", () => {
expect(heightOf("group-toggle")).toBeGreaterThan(heightOf("nested-without-button"));
});
it("keeps a row that opens something as tall as a row holding a control", () => {
mountRows();
expect(heightOf("detail-row")).toBe(heightOf("card-row"));
expect(heightOf("group-toggle")).toBe(heightOf("card-row"));
});
it("sizes nested text and controls one step below card rows", () => {
mountRows();
@@ -27,6 +27,11 @@ export function MenuSettingsRows({ children }: { children: ReactNode }) {
export interface SettingsRowLayout {
row: StyleProp<ViewStyle>;
/**
* A row as tall as one holding a control of `controlSize`, whether or not it holds one. In a menu
* it keeps the menu's row height.
*/
controlRow: StyleProp<ViewStyle>;
title: StyleProp<TextStyle>;
hint: StyleProp<TextStyle>;
/** The size of the controls in the row's trailing slot. */
@@ -38,6 +43,7 @@ function layoutFor(placement: RowPlacement): SettingsRowLayout {
case "nested":
return {
row: [settingsStyles.row, styles.nestedRow],
controlRow: [settingsStyles.row, styles.nestedRow],
title: [settingsStyles.rowTitle, styles.nestedText],
hint: [settingsStyles.rowHint, styles.nestedText],
controlSize: "sm",
@@ -45,6 +51,7 @@ function layoutFor(placement: RowPlacement): SettingsRowLayout {
case "menu":
return {
row: [settingsStyles.row, styles.menuRow],
controlRow: [settingsStyles.row, styles.menuRow],
title: settingsStyles.rowTitle,
hint: settingsStyles.rowHint,
controlSize: "md",
@@ -52,6 +59,7 @@ function layoutFor(placement: RowPlacement): SettingsRowLayout {
case "card":
return {
row: settingsStyles.row,
controlRow: [settingsStyles.row, styles.cardControlRow],
title: settingsStyles.rowTitle,
hint: settingsStyles.rowHint,
controlSize: "md",
@@ -66,6 +74,9 @@ export function useSettingsRowLayout(): SettingsRowLayout {
}
const styles = StyleSheet.create((theme) => ({
cardControlRow: {
minHeight: mapLayout(CONTROL_HEIGHTS.md, (height) => height + theme.spacing[4] * 2),
},
// Every nested row is as tall as one holding an `sm` control, so rows with and without a
// trailing button line up.
nestedRow: {
@@ -1,25 +1,36 @@
import { ChevronRight } from "lucide-react-native";
import { useCallback, useMemo, type ReactNode } from "react";
import { Text, View, type AccessibilityState, type PressableStateCallbackType } from "react-native";
import { useCallback, useMemo, useState, type ReactNode } from "react";
import { Text, View, type AccessibilityState } from "react-native";
import { StyleSheet, withUnistyles } from "react-native-unistyles";
import { ControlSizeProvider } from "@/components/ui/control-size";
import { ExternalLinkLabel } from "@/components/ui/external-link";
import { mutedIconColorMapping } from "@/components/ui/icon-color";
import { LoadingSpinner } from "@/components/ui/loading-spinner";
import { PressHighlight } from "@/components/ui/press-highlight";
import { SkeletonPulse, useSkeletonPulse } from "@/components/ui/skeleton";
import { settingsStyles } from "@/styles/settings";
import { ICON_SIZE, type Theme } from "@/styles/theme";
import { useSettingsRowLayout } from "./row-density";
import { useSettingsRowLayout, type SettingsRowLayout } from "./row-density";
const ThemedChevron = withUnistyles(ChevronRight);
const ThemedLoadingSpinner = withUnistyles(LoadingSpinner);
const hoveredIconColorMapping = (theme: Theme) => ({ color: theme.colors.foreground });
type HoverState = PressableStateCallbackType & { hovered?: boolean };
/**
* What the hint reports beyond its words: work under way (a leading spinner), a fault (a leading
* red dot and red text), or a value still loading (a placeholder the height of the line).
*/
export type SettingsRowHintStatus = "busy" | "error" | "pending";
export interface SettingsRowHeaderProps {
label: string;
/** An icon before the label, such as the thing the row opens. */
leading?: ReactNode;
/** Shown beside the label, such as a badge. */
labelAccessory?: ReactNode;
/** A line under the label saying what the row leads to. */
hint?: string;
hintStatus?: SettingsRowHintStatus;
/** A short status shown before the chevron. */
summary?: string;
onPress: () => void;
@@ -28,6 +39,10 @@ export interface SettingsRowHeaderProps {
expanded?: boolean;
/** The row leaves the app, such as to a docs page: the summary and an outward arrow are drawn as an external link in place of the chevron. */
external?: boolean;
/** A control acting on the row's subject in place, such as a switch, before the chevron. */
control?: ReactNode;
/** Names the row for assistive tech when the label alone does not say where it leads. */
accessibilityLabel?: string;
accessibilityState?: AccessibilityState;
/** Props React Native Web does not derive from `accessibilityState`, such as `aria-expanded`. */
webAccessibilityProps?: Record<string, unknown> | null;
@@ -38,81 +53,209 @@ export interface SettingsRowHeaderProps {
* The pressable line shared by settings rows that lead somewhere: a label, an optional summary and
* a trailing chevron. A collapsible row turns the chevron down; a row that opens a sheet keeps it
* pointing right.
*
* The press target is a button laid under the row's content rather than wrapped around it, so a
* control in the row is the button's sibling: a switch inside a button is invalid markup, and keys
* pressed on the switch would also press the row. Everything drawn over the button lets presses
* through to it. The label, icon and summary stay out of the accessibility tree, where the button's
* label already names the row; the hint stays readable, since it carries the row's state.
* Hover is tracked on the row itself, so it holds while the pointer is over the control.
*
* The row is as tall as one holding a control whether or not it holds one, so a list where only
* some rows carry a switch keeps one row height.
*/
export function SettingsRowHeader({
label,
leading,
labelAccessory,
hint,
hintStatus,
summary,
onPress,
disabled,
expanded = false,
external = false,
control,
accessibilityLabel,
accessibilityState,
webAccessibilityProps,
testID,
}: SettingsRowHeaderProps) {
const layout = useSettingsRowLayout();
const rowStyle = useCallback(
({ hovered }: HoverState) => [layout.row, !disabled && hovered && styles.hovered],
[disabled, layout],
);
const [pointerOver, setPointerOver] = useState(false);
const handlePointerEnter = useCallback(() => setPointerOver(true), []);
const handlePointerLeave = useCallback(() => setPointerOver(false), []);
const hovered = pointerOver && !disabled;
const rowStyle = useMemo(() => [layout.controlRow, hovered && styles.hovered], [hovered, layout]);
const chevronStyle = useMemo(
() => [styles.chevron, expanded && styles.chevronExpanded],
[expanded],
);
return (
<PressHighlight
{...webAccessibilityProps}
accessibilityRole={external ? "link" : "button"}
accessibilityLabel={summary ? `${label}, ${summary}` : label}
accessibilityState={accessibilityState}
disabled={disabled}
onPress={onPress}
<View
style={rowStyle}
highlightStyle={styles.pressed}
onPointerEnter={handlePointerEnter}
onPointerLeave={handlePointerLeave}
testID={testID}
>
{({ hovered }: HoverState) => (
<>
<View style={settingsStyles.rowContent}>
{labelAccessory ? (
<View style={styles.labelRow}>
<Text style={layout.title}>{label}</Text>
{labelAccessory}
<PressHighlight
{...webAccessibilityProps}
accessibilityRole={external ? "link" : "button"}
accessibilityLabel={accessibilityLabel ?? (summary ? `${label}, ${summary}` : label)}
accessibilityState={accessibilityState}
disabled={disabled}
onPress={onPress}
style={styles.pressTarget}
highlightStyle={styles.pressed}
/>
{leading ? (
<View style={[styles.leading, styles.passThrough]} {...HIDDEN_FROM_ASSISTIVE_TECH}>
{leading}
</View>
) : null}
<View style={[settingsStyles.rowContent, styles.passThrough]}>
<View style={labelAccessory ? styles.labelRow : undefined} {...HIDDEN_FROM_ASSISTIVE_TECH}>
<Text style={layout.title}>{label}</Text>
{labelAccessory}
</View>
{hintStatus ? (
<RowHintLine hint={hint} status={hintStatus} hintStyle={layout.hint} />
) : null}
{hint && !hintStatus ? <Text style={layout.hint}>{hint}</Text> : null}
</View>
{control ? (
<View style={styles.control}>
<ControlSizeProvider size={layout.controlSize}>{control}</ControlSizeProvider>
</View>
) : null}
<View style={[styles.trailing, styles.passThrough]} {...HIDDEN_FROM_ASSISTIVE_TECH}>
{external ? (
// Drawn the same as a section header's docs link, so the two read as one thing.
<ExternalLinkLabel hovered={hovered}>{summary}</ExternalLinkLabel>
) : (
<>
{summary ? (
<Text style={styles.summary} numberOfLines={1}>
{summary}
</Text>
) : null}
{disabled ? null : (
<View style={chevronStyle}>
<ThemedChevron
size={ICON_SIZE.sm}
uniProps={hovered ? hoveredIconColorMapping : mutedIconColorMapping}
/>
</View>
) : (
<Text style={layout.title}>{label}</Text>
)}
{hint ? <Text style={layout.hint}>{hint}</Text> : null}
</View>
{external ? (
// Drawn the same as a section header's docs link, so the two read as one thing.
<ExternalLinkLabel hovered={hovered}>{summary}</ExternalLinkLabel>
) : (
<>
{summary ? (
<Text style={styles.summary} numberOfLines={1}>
{summary}
</Text>
) : null}
{disabled ? null : (
<View style={chevronStyle}>
<ThemedChevron
size={ICON_SIZE.sm}
uniProps={hovered ? hoveredIconColorMapping : mutedIconColorMapping}
/>
</View>
)}
</>
)}
</>
)}
</PressHighlight>
</>
)}
</View>
</View>
);
}
const HIDDEN_FROM_ASSISTIVE_TECH = {
accessibilityElementsHidden: true,
importantForAccessibility: "no-hide-descendants",
"aria-hidden": true,
} as const;
/**
* The hint with its status mark. The line keeps the hint's own height in every status, so a row
* does not move when its value arrives or its work starts. A long error is cut to the line; the
* row's detail says it in full.
*/
function RowHintLine({
hint,
status,
hintStyle,
}: {
hint: string | undefined;
status: SettingsRowHintStatus;
hintStyle: SettingsRowLayout["hint"];
}) {
const textStyle = useMemo(
() => [hintStyle, styles.hintText, status === "error" && styles.hintError],
[hintStyle, status],
);
if (status === "pending") {
return (
<View style={styles.hintLine}>
{/* A blank line of hint text holds the height; the placeholder sits over it. */}
<Text style={textStyle}> </Text>
<HintPlaceholder />
</View>
);
}
return (
<View style={styles.hintLine}>
{status === "busy" ? (
<ThemedLoadingSpinner size={14} uniProps={mutedIconColorMapping} />
) : (
<View style={styles.errorDot} testID="settings-row-error-dot" />
)}
<Text style={textStyle} numberOfLines={1}>
{hint}
</Text>
</View>
);
}
function HintPlaceholder() {
const pulse = useSkeletonPulse();
return <SkeletonPulse pulse={pulse} style={styles.hintPlaceholder} />;
}
const styles = StyleSheet.create((theme) => ({
leading: {
marginRight: theme.spacing[3],
alignItems: "center",
justifyContent: "center",
},
control: {
marginRight: theme.spacing[3],
},
// The button under the row's content; it fills the row, padding included.
pressTarget: {
...StyleSheet.absoluteFill,
},
passThrough: {
pointerEvents: "none",
},
trailing: {
flexDirection: "row",
alignItems: "center",
flexShrink: 1,
},
hintLine: {
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[1.5],
marginTop: theme.spacing[1],
},
// The line carries the hint's top margin, so the mark and the words share one baseline box.
hintText: {
marginTop: 0,
flexShrink: 1,
},
hintError: {
color: theme.colors.statusDanger,
},
errorDot: {
width: 8,
height: 8,
borderRadius: theme.borderRadius.full,
backgroundColor: theme.colors.statusDanger,
},
hintPlaceholder: {
position: "absolute",
left: 0,
top: theme.spacing[0.5],
bottom: theme.spacing[0.5],
width: theme.spacing[32],
borderRadius: theme.borderRadius.sm,
backgroundColor: theme.colors.surface2,
},
labelRow: { flexDirection: "row", alignItems: "center", gap: theme.spacing[2] },
summary: {
flexShrink: 1,
@@ -16,7 +16,7 @@ import { formatThinkingOptionLabel } from "@/agent-controls/labels";
import { CombinedModelSelector } from "@/components/combined-model-selector";
import {
buildProviderSelectorProviders,
buildSelectableProviderSelectorProviders,
buildSelectorProvider,
type ProviderSelectorProvider,
} from "@/provider-selection/provider-selection";
import { filterSelectableModels } from "@/provider-selection/model-catalog";
@@ -1049,7 +1049,7 @@ export const AgentControls = memo(function AgentControls({
);
const agentModelSelectorProviders = useMemo(() => {
if (snapshotSelectedEntry) {
return buildSelectableProviderSelectorProviders([snapshotSelectedEntry]);
return [buildSelectorProvider(snapshotSelectedEntry)];
}
return buildProviderSelectorProviders({
providerDefinitions: agentProviderDefinitions,
@@ -9,6 +9,11 @@ export function getAcpProviderCatalog(): AcpProviderCatalogItem[] {
return ACP_PROVIDER_CATALOG;
}
/** The catalog's install guide for a provider added from it, or null for any other provider. */
export function readAcpProviderInstallGuide(provider: string): string | null {
return ACP_PROVIDER_CATALOG.find((entry) => entry.id === provider)?.installLink ?? null;
}
export function buildAcpProviderConfigPatch(
entry: AcpProviderCatalogItem,
hostSupports: (feature: HostFeatureName) => boolean = () => false,
@@ -236,8 +236,12 @@ export function useAgentFormState(options: UseAgentFormStateOptions): UseAgentFo
[snapshotEntries],
);
const snapshotModelSelectorProviders = useMemo(
() => buildSelectableProviderSelectorProviders(snapshotEntries, isConnected),
[snapshotEntries, isConnected],
() =>
buildSelectableProviderSelectorProviders(snapshotEntries, {
isConnected,
selectedProvider: formState.provider || null,
}),
[snapshotEntries, isConnected, formState.provider],
);
const snapshotSelectedEntry = useMemo(
() =>
+18 -1
View File
@@ -1746,7 +1746,7 @@ export const ar: TranslationResources = {
},
providers: {
label: "المزوّدون",
title: "وكلاؤك",
title: "مزوّدوك",
description: "يشغّل Paseo أدوات CLI للوكلاء المثبتة على هذا الكمبيوتر",
},
projects: {
@@ -3098,6 +3098,22 @@ export const ar: TranslationResources = {
providers: {
title: "مقدمي الخدمات",
addProvider: "إضافة مزود",
list: {
add: "مزود",
updatingTo: "جارٍ التحديث إلى {{version}}...",
},
detail: {
backToProviders: "العودة إلى المزودين",
notOnHost: "هذا المزود غير موجود على هذا المضيف",
enabled: "مفعّل",
unavailableTitle: "{{name}} غير متاح",
troubleshooting: "استكشاف الأخطاء",
status: "حالة المزود",
checked: "تم الفحص {{time}}",
diagnosticReport: "تقرير التشخيص",
dangerZone: "منطقة الخطر",
removeHint: "يحذف هذا المزود من config.json",
},
providerDetails: "تفاصيل مزود{{name}}",
enableProvider: "تمكين{{name}}",
unavailable: "اتصل بهذا المضيف لرؤية مقدمي الخدمة",
@@ -3139,6 +3155,7 @@ export const ar: TranslationResources = {
retrying: "جارٍ إعادة المحاولة...",
noSearchMatches: "لا توجد نماذج تطابق بحثك",
noneDetected: "لم يتم اكتشاف أي نماذج",
noCustom: "لا توجد نماذج مخصصة",
discovered: "اكتشف",
custom: "نماذج مخصصة",
updated: "تم تحديث{{time}}",
+18 -1
View File
@@ -1774,7 +1774,7 @@ export const en = {
},
providers: {
label: "Providers",
title: "Your agents",
title: "Your providers",
description: "Paseo runs the agent CLIs already on this computer",
},
projects: {
@@ -3197,6 +3197,22 @@ export const en = {
providers: {
title: "Providers",
addProvider: "Add provider",
list: {
add: "Provider",
updatingTo: "Updating to {{version}}...",
},
detail: {
backToProviders: "Back to providers",
notOnHost: "This provider isn't on this host",
enabled: "Enabled",
unavailableTitle: "{{name}} isn't available",
troubleshooting: "Troubleshooting",
status: "Provider status",
checked: "Checked {{time}}",
diagnosticReport: "Diagnostic report",
dangerZone: "Danger zone",
removeHint: "Deletes this provider from config.json",
},
providerDetails: "{{name}} provider details",
enableProvider: "Enable {{name}}",
unavailable: "Connect to this host to see providers",
@@ -3238,6 +3254,7 @@ export const en = {
retrying: "Retrying...",
noSearchMatches: "No models match your search",
noneDetected: "No models detected",
noCustom: "No custom models",
discovered: "Discovered",
custom: "Custom models",
updated: "Updated {{time}}",
+18 -1
View File
@@ -1793,7 +1793,7 @@ export const es: TranslationResources = {
},
providers: {
label: "Proveedores",
title: "Tus agentes",
title: "Tus proveedores",
description: "Paseo usa las CLI de agentes que ya están en este ordenador",
},
projects: {
@@ -3127,6 +3127,22 @@ export const es: TranslationResources = {
providers: {
title: "Proveedores",
addProvider: "Agregar proveedor",
list: {
add: "Proveedor",
updatingTo: "Actualizando a {{version}}...",
},
detail: {
backToProviders: "Volver a proveedores",
notOnHost: "Este proveedor no está en este host",
enabled: "Activado",
unavailableTitle: "{{name}} no está disponible",
troubleshooting: "Solución de problemas",
status: "Estado del proveedor",
checked: "Comprobado {{time}}",
diagnosticReport: "Informe de diagnóstico",
dangerZone: "Zona de peligro",
removeHint: "Elimina este proveedor de config.json",
},
providerDetails: "Detalles del proveedor{{name}}",
enableProvider: "Habilitar{{name}}",
unavailable: "Conéctese a este host para ver proveedores",
@@ -3168,6 +3184,7 @@ export const es: TranslationResources = {
retrying: "Reintentando...",
noSearchMatches: "Ningún modelo coincide con tu búsqueda",
noneDetected: "No se detectaron modelos",
noCustom: "No hay modelos personalizados",
discovered: "descubierto",
custom: "Modelos personalizados",
updated: "{{time}}actualizado",
+18 -1
View File
@@ -1791,7 +1791,7 @@ export const fr: TranslationResources = {
},
providers: {
label: "Fournisseurs",
title: "Vos agents",
title: "Vos fournisseurs",
description: "Paseo utilise les CLI d'agents déjà installées sur cet ordinateur",
},
projects: {
@@ -3133,6 +3133,22 @@ export const fr: TranslationResources = {
providers: {
title: "Fournisseurs",
addProvider: "Ajouter un fournisseur",
list: {
add: "Fournisseur",
updatingTo: "Mise à jour vers {{version}}…",
},
detail: {
backToProviders: "Retour aux fournisseurs",
notOnHost: "Ce fournisseur n'est pas sur cet hôte",
enabled: "Activé",
unavailableTitle: "{{name}} n'est pas disponible",
troubleshooting: "Dépannage",
status: "État du fournisseur",
checked: "Vérifié {{time}}",
diagnosticReport: "Rapport de diagnostic",
dangerZone: "Zone de danger",
removeHint: "Supprime ce fournisseur de config.json",
},
providerDetails: "Détails du fournisseur {{name}}",
enableProvider: "Activer {{name}}",
unavailable: "Connectez-vous à cet hôte pour voir les fournisseurs",
@@ -3175,6 +3191,7 @@ export const fr: TranslationResources = {
retrying: "Nouvelle tentative…",
noSearchMatches: "Aucun modèle ne correspond à votre recherche",
noneDetected: "Aucun modèle détecté",
noCustom: "Aucun modèle personnalisé",
discovered: "Détectés",
custom: "Modèles personnalisés",
updated: "Mis à jour {{time}}",
+18 -1
View File
@@ -1764,7 +1764,7 @@ export const ja: TranslationResources = {
},
providers: {
label: "プロバイダー",
title: "エージェント",
title: "プロバイダー",
description: "Paseo はこのコンピューターにインストール済みのエージェント CLI を使います",
},
projects: {
@@ -3095,6 +3095,22 @@ export const ja: TranslationResources = {
providers: {
title: "プロバイダー",
addProvider: "プロバイダーを追加",
list: {
add: "プロバイダー",
updatingTo: "{{version}} に更新中...",
},
detail: {
backToProviders: "プロバイダーに戻る",
notOnHost: "このホストにはこのプロバイダーがありません",
enabled: "有効",
unavailableTitle: "{{name}} は利用できません",
troubleshooting: "トラブルシューティング",
status: "プロバイダーの状態",
checked: "{{time}}に確認",
diagnosticReport: "診断レポート",
dangerZone: "危険な操作",
removeHint: "このプロバイダーを config.json から削除します",
},
providerDetails: "{{name}}プロバイダーの詳細",
enableProvider: "{{name}}を有効にする",
unavailable: "プロバイダーを見るにはこのホストに接続してください",
@@ -3136,6 +3152,7 @@ export const ja: TranslationResources = {
retrying: "再試行中...",
noSearchMatches: "検索に一致するモデルがありません",
noneDetected: "モデルが検出されませんでした",
noCustom: "カスタムモデルはありません",
discovered: "検出済み",
custom: "カスタムモデル",
updated: "{{time}}に更新",
+18 -1
View File
@@ -1757,7 +1757,7 @@ export const ko: TranslationResources = {
},
providers: {
label: "제공자",
title: "에이전트",
title: "제공자",
description: "Paseo는 이 컴퓨터에 이미 설치된 에이전트 CLI를 사용합니다",
},
projects: {
@@ -3080,6 +3080,22 @@ export const ko: TranslationResources = {
providers: {
title: "프로바이더",
addProvider: "프로바이더 추가",
list: {
add: "프로바이더",
updatingTo: "{{version}}(으)로 업데이트 중...",
},
detail: {
backToProviders: "프로바이더로 돌아가기",
notOnHost: "이 호스트에 없는 프로바이더입니다",
enabled: "사용",
unavailableTitle: "{{name}}을(를) 사용할 수 없습니다",
troubleshooting: "문제 해결",
status: "프로바이더 상태",
checked: "{{time}} 확인됨",
diagnosticReport: "진단 보고서",
dangerZone: "위험 구역",
removeHint: "config.json에서 이 프로바이더를 삭제합니다",
},
providerDetails: "{{name}} 프로바이더 세부 정보",
enableProvider: "{{name}} 활성화",
unavailable: "프로바이더를 보려면 이 호스트에 연결하세요",
@@ -3122,6 +3138,7 @@ export const ko: TranslationResources = {
retrying: "다시 시도 중...",
noSearchMatches: "검색과 일치하는 모델이 없습니다",
noneDetected: "감지된 모델이 없습니다",
noCustom: "사용자 지정 모델 없음",
discovered: "발견됨",
custom: "사용자 지정 모델",
updated: "{{time}} 업데이트됨",
+18 -1
View File
@@ -1778,7 +1778,7 @@ export const ptBR: TranslationResources = {
},
providers: {
label: "Provedores",
title: "Seus agentes",
title: "Seus provedores",
description: "O Paseo usa as CLIs de agentes já instaladas neste computador",
},
projects: {
@@ -3108,6 +3108,22 @@ export const ptBR: TranslationResources = {
providers: {
title: "Provedores",
addProvider: "Adicionar provedor",
list: {
add: "Provedor",
updatingTo: "Atualizando para {{version}}...",
},
detail: {
backToProviders: "Voltar para provedores",
notOnHost: "Este provedor não está neste host",
enabled: "Ativado",
unavailableTitle: "{{name}} não está disponível",
troubleshooting: "Solução de problemas",
status: "Status do provedor",
checked: "Verificado {{time}}",
diagnosticReport: "Relatório de diagnóstico",
dangerZone: "Zona de perigo",
removeHint: "Exclui este provedor do config.json",
},
providerDetails: "Detalhes do provedor {{name}}",
enableProvider: "Ativar {{name}}",
unavailable: "Conecte-se a este host para ver provedores",
@@ -3149,6 +3165,7 @@ export const ptBR: TranslationResources = {
retrying: "Tentando novamente...",
noSearchMatches: "Nenhum modelo corresponde à sua busca",
noneDetected: "Nenhum modelo detectado",
noCustom: "Nenhum modelo personalizado",
discovered: "Descobertos",
custom: "Modelos personalizados",
updated: "Atualizado {{time}}",
+18 -1
View File
@@ -1777,7 +1777,7 @@ export const ru: TranslationResources = {
},
providers: {
label: "Провайдеры",
title: "Ваши агенты",
title: "Ваши провайдеры",
description: "Paseo использует CLI агентов, уже установленные на этом компьютере",
},
projects: {
@@ -3119,6 +3119,22 @@ export const ru: TranslationResources = {
providers: {
title: "Провайдеры",
addProvider: "Добавить провайдера",
list: {
add: "Провайдер",
updatingTo: "Обновление до {{version}}...",
},
detail: {
backToProviders: "Назад к провайдерам",
notOnHost: "Этого провайдера нет на этом хосте",
enabled: "Включён",
unavailableTitle: "{{name}} недоступен",
troubleshooting: "Диагностика",
status: "Состояние провайдера",
checked: "Проверено {{time}}",
diagnosticReport: "Диагностический отчёт",
dangerZone: "Опасная зона",
removeHint: "Удаляет этого провайдера из config.json",
},
providerDetails: "Сведения о провайдере {{name}}",
enableProvider: "Включить {{name}}",
unavailable: "Подключитесь к этому хосту, чтобы увидеть провайдеров",
@@ -3161,6 +3177,7 @@ export const ru: TranslationResources = {
retrying: "Повторная попытка...",
noSearchMatches: "Ни одна модель не соответствует вашему запросу",
noneDetected: "Модели не обнаружены",
noCustom: "Нет пользовательских моделей",
discovered: "Обнаруженные модели",
custom: "Пользовательские модели",
updated: "Обновлено {{time}}",
+18 -1
View File
@@ -1729,7 +1729,7 @@ export const zhCN: TranslationResources = {
},
providers: {
label: "提供方",
title: "你的代理",
title: "你的提供方",
description: "Paseo 使用这台电脑上已安装的代理 CLI",
},
projects: {
@@ -3027,6 +3027,22 @@ export const zhCN: TranslationResources = {
providers: {
title: "Providers",
addProvider: "添加 Provider",
list: {
add: "Provider",
updatingTo: "正在更新到 {{version}}...",
},
detail: {
backToProviders: "返回 Provider 列表",
notOnHost: "此 Host 上没有这个 Provider",
enabled: "已启用",
unavailableTitle: "{{name}} 不可用",
troubleshooting: "故障排查",
status: "Provider 状态",
checked: "{{time}}检查",
diagnosticReport: "诊断报告",
dangerZone: "危险操作",
removeHint: "从 config.json 中删除此 Provider",
},
providerDetails: "{{name}} Provider 详情",
enableProvider: "启用 {{name}}",
unavailable: "连接到这个 Host 以查看 Providers",
@@ -3068,6 +3084,7 @@ export const zhCN: TranslationResources = {
retrying: "正在重试...",
noSearchMatches: "没有匹配搜索的 Model",
noneDetected: "未检测到 Model",
noCustom: "没有自定义模型",
discovered: "已发现",
custom: "自定义 Models",
updated: "已更新 {{time}}",
@@ -7,6 +7,7 @@ import {
buildOpenProjectRoute,
buildProjectSettingsRoute,
buildProjectsSettingsRoute,
buildProviderSettingsRoute,
buildSettingsHostSectionRoute,
buildSettingsRoute,
type HostSectionSlug,
@@ -40,7 +41,8 @@ export type SettingsView =
| { kind: "root" }
| { kind: "section"; section: SettingsSectionSlug }
| { kind: "host"; serverId: string; section: HostSectionSlug }
| { kind: "project"; serverId: string; projectId: string };
| { kind: "project"; serverId: string; projectId: string }
| { kind: "provider"; serverId: string; providerId: string };
export function openHostOverview(serverId: string): void {
router.push(buildSettingsHostSectionRoute(serverId, "host"));
@@ -50,6 +52,10 @@ export function openProjectSettings(serverId: string, projectId: string): void {
router.push(buildProjectSettingsRoute(serverId, projectId));
}
export function openProviderSettings(serverId: string, providerId: string): void {
router.push(buildProviderSettingsRoute(serverId, providerId));
}
export function returnFromSettings(view: SettingsView): void {
if (view.kind === "root") {
const destination = getSettingsSidebarReturn();
@@ -74,5 +80,6 @@ export function returnFromSettings(view: SettingsView): void {
if (view.kind === "plugin" || view.kind === "pluginListing")
parent = buildSettingsHostSectionRoute(view.serverId, "plugins");
if (view.kind === "project") parent = buildProjectsSettingsRoute(view.serverId);
if (view.kind === "provider") parent = buildSettingsHostSectionRoute(view.serverId, "providers");
router.dismissTo(parent as Href);
}
@@ -3,11 +3,7 @@ import { useTranslation } from "react-i18next";
import { Text, View, type PressableStateCallbackType } from "react-native";
import { StyleSheet, withUnistyles } from "react-native-unistyles";
import { Check } from "lucide-react-native";
import {
AdaptiveModalSheet,
FULL_SHEET_SNAP_POINTS,
SheetFooter,
} from "@/components/adaptive-modal-sheet";
import { AdaptiveModalSheet, SheetFooter } from "@/components/adaptive-modal-sheet";
import { PaseoLogo } from "@/components/icons/paseo-logo";
import { Button } from "@/components/ui/button";
import { PressHighlight } from "@/components/ui/press-highlight";
@@ -17,6 +13,7 @@ import { useProjectSuggestions, type ProjectSuggestionsController } from "@/proj
import type { Theme } from "@/styles/theme";
import type { OnboardingModel, OnboardingState, OnboardingStepId } from "./model";
import { useOrchestrationSetup, type OrchestrationSetupController } from "./orchestration-setup";
import { SETUP_CARD_FRAME } from "./setup-card";
import { OnboardingStepContent } from "./steps";
type OpenState = Extract<OnboardingState, { status: "open" }>;
@@ -112,9 +109,9 @@ export function OnboardingModal({ model, state }: { model: OnboardingModel; stat
header={isCompact ? compactHeader : undefined}
footer={isCompact ? actions : undefined}
scrollable={false}
snapPoints={FULL_SHEET_SNAP_POINTS}
desktopMaxWidth={880}
desktopHeight={640}
snapPoints={SETUP_CARD_FRAME.snapPoints}
desktopMaxWidth={SETUP_CARD_FRAME.desktopMaxWidth}
desktopHeight={SETUP_CARD_FRAME.desktopHeight}
contentStyle={styles.content}
testID="onboarding-modal"
>
@@ -0,0 +1,8 @@
import { FULL_SHEET_SNAP_POINTS } from "@/components/adaptive-modal-sheet";
/** The setup card's frame. A sheet opened from a setup step takes the same one to cover the card. */
export const SETUP_CARD_FRAME = {
snapPoints: FULL_SHEET_SNAP_POINTS,
desktopMaxWidth: 880,
desktopHeight: 640,
};
@@ -1,10 +1,44 @@
import { useCallback, useState } from "react";
import { View } from "react-native";
import { ProvidersSection } from "@/screens/settings/providers-section";
import { ProviderDetailSheet, ProviderList, type ProviderSheetFrame } from "@/provider-settings";
import { SETUP_CARD_FRAME } from "../setup-card";
/** Provider sheets cover the setup card and return to it, so they read as pages of setup. */
const SETUP_SHEET_FRAME: ProviderSheetFrame = { ...SETUP_CARD_FRAME, returns: true };
interface OpenedProvider {
provider: string;
visible: boolean;
}
export function ProvidersStep({ serverId }: { serverId: string }) {
// The provider outlives `visible` so the sheet can animate out.
const [opened, setOpened] = useState<OpenedProvider | null>(null);
const openProvider = useCallback(
(provider: string) => setOpened({ provider, visible: true }),
[],
);
const closeProvider = useCallback(
() => setOpened((current) => (current ? { ...current, visible: false } : null)),
[],
);
return (
<View>
<ProvidersSection serverId={serverId} />
<ProviderList
serverId={serverId}
onOpenProvider={openProvider}
sheetFrame={SETUP_SHEET_FRAME}
/>
{opened ? (
<ProviderDetailSheet
key={opened.provider}
serverId={serverId}
provider={opened.provider}
visible={opened.visible}
onClose={closeProvider}
frame={SETUP_SHEET_FRAME}
/>
) : null}
</View>
);
}
@@ -1,6 +1,5 @@
import { useQueryClient } from "@tanstack/react-query";
import { router } from "expo-router";
import { ArrowLeft } from "lucide-react-native";
import { useCallback, useMemo, useState, type ReactNode } from "react";
import { useTranslation } from "react-i18next";
import { Image, ScrollView, Text, View } from "react-native";
@@ -14,7 +13,12 @@ import type {
PluginListingDetail,
} from "@getpaseo/protocol/plugin-registry";
import { MarkdownRenderer } from "@/components/markdown/renderer";
import { SettingsCard, SettingsRow, SettingsSection } from "@/components/settings";
import {
SettingsBackLink,
SettingsCard,
SettingsRow,
SettingsSection,
} from "@/components/settings";
import { Alert } from "@/components/ui/alert";
import { Button } from "@/components/ui/button";
import { ExternalLink } from "@/components/ui/external-link";
@@ -428,9 +432,9 @@ export function PluginPage({
}, [listingId, onBack, serverId, subject.kind]);
const back = compact ? null : (
<Button onPress={onBack} variant="ghost" leftIcon={ArrowLeft} style={styles.back}>
{t("settings.plugins.screens.backToPlugins")}
</Button>
<View style={styles.back}>
<SettingsBackLink label={t("settings.plugins.screens.backToPlugins")} onPress={onBack} />
</View>
);
if (loading)
return (
@@ -542,7 +546,7 @@ function PluginPageBody({
}
const styles = StyleSheet.create((theme) => ({
back: { alignSelf: "flex-start", paddingHorizontal: 0, marginBottom: theme.spacing[4] },
back: { marginBottom: theme.spacing[4] },
header: {
flexDirection: "row",
alignItems: "center",
@@ -7,6 +7,7 @@ import {
buildProviderSelectorProviders,
buildSelectableProviderSelectorProviders,
buildSelectedTriggerLabel,
buildSelectorProvider,
filterAndRankModelRows,
matchesModelSearch,
resolveEffectiveComposerModeId,
@@ -21,7 +22,7 @@ describe("combined model selector data", () => {
snapshotEntry({ provider: "waiting", status: "loading", models: [] }),
snapshotEntry({ provider: "codex", status: "ready", models: [codexModel] }),
],
false,
{ isConnected: false, selectedProvider: null },
);
expect(providers[0].modelSelection).toEqual({
kind: "error",
@@ -54,13 +55,16 @@ describe("combined model selector data", () => {
it("builds selector providers from ready enabled snapshot entries", () => {
expect(
buildSelectableProviderSelectorProviders([
snapshotEntry({
provider: "codex",
label: "Codex",
models: [codexModel],
}),
]),
buildSelectableProviderSelectorProviders(
[
snapshotEntry({
provider: "codex",
label: "Codex",
models: [codexModel],
}),
],
{ selectedProvider: null },
),
).toEqual([
{
id: "codex",
@@ -91,9 +95,10 @@ describe("combined model selector data", () => {
isSelectable: false,
};
const [provider] = buildSelectableProviderSelectorProviders([
snapshotEntry({ provider: "codex", models: [codexModel, compatibilityModel] }),
]);
const [provider] = buildSelectableProviderSelectorProviders(
[snapshotEntry({ provider: "codex", models: [codexModel, compatibilityModel] })],
{ selectedProvider: null },
);
expect(provider?.modelSelection).toMatchObject({
kind: "models",
@@ -103,13 +108,16 @@ describe("combined model selector data", () => {
it("synthesizes a default model row for ready enabled providers without explicit models", () => {
expect(
buildSelectableProviderSelectorProviders([
snapshotEntry({
provider: "codewhale",
label: "CodeWhale",
models: [],
}),
]),
buildSelectableProviderSelectorProviders(
[
snapshotEntry({
provider: "codewhale",
label: "CodeWhale",
models: [],
}),
],
{ selectedProvider: null },
),
).toEqual([
{
id: "codewhale",
@@ -134,33 +142,34 @@ describe("combined model selector data", () => {
it("excludes disabled providers from selector data", () => {
expect(
buildSelectableProviderSelectorProviders([
snapshotEntry({
provider: "codewhale",
label: "CodeWhale",
enabled: false,
models: [],
}),
]),
buildSelectableProviderSelectorProviders(
[
snapshotEntry({
provider: "codewhale",
label: "CodeWhale",
enabled: false,
models: [],
}),
],
{ selectedProvider: null },
),
).toEqual([]);
});
it("surfaces non-ready providers with their state-specific selection", () => {
expect(
buildSelectableProviderSelectorProviders([
snapshotEntry({ provider: "loading-provider", status: "loading", models: [] }),
snapshotEntry({
provider: "error-provider",
status: "error",
error: "boom",
models: [],
}),
snapshotEntry({
provider: "unavailable-provider",
status: "unavailable",
models: [],
}),
]),
buildSelectableProviderSelectorProviders(
[
snapshotEntry({ provider: "loading-provider", status: "loading", models: [] }),
snapshotEntry({
provider: "error-provider",
status: "error",
error: "boom",
models: [],
}),
],
{ selectedProvider: null },
),
).toEqual([
{
id: "loading-provider",
@@ -172,14 +181,45 @@ describe("combined model selector data", () => {
label: "error-provider",
modelSelection: { kind: "error", message: "boom" },
},
{
id: "unavailable-provider",
label: "unavailable-provider",
modelSelection: { kind: "error", message: "Unavailable" },
},
]);
});
it("leaves out enabled providers that are not installed", () => {
expect(
buildSelectableProviderSelectorProviders(
[
snapshotEntry({ provider: "codex", label: "Codex" }),
snapshotEntry({ provider: "gemini", status: "unavailable", models: [] }),
],
{ selectedProvider: null },
).map((provider) => provider.id),
).toEqual(["codex"]);
});
it("keeps a saved choice whose provider is not installed, labelled Unavailable", () => {
const providers = buildSelectableProviderSelectorProviders(
[
snapshotEntry({ provider: "codex", label: "Codex" }),
snapshotEntry({ provider: "gemini", status: "unavailable", models: [] }),
],
{ selectedProvider: "gemini" },
);
expect(providers.map((provider) => provider.id)).toEqual(["codex", "gemini"]);
expect(providers[1].modelSelection).toEqual({ kind: "error", message: "Unavailable" });
});
it("keeps an agent's own provider in its selector when that provider is not installed", () => {
expect(
buildSelectorProvider(
snapshotEntry({ provider: "gemini", status: "unavailable", models: [] }),
),
).toEqual({
id: "gemini",
label: "gemini",
modelSelection: { kind: "error", message: "Unavailable" },
});
});
it("builds selector providers from an already-curated provider list", () => {
const providerDefinitions: AgentProviderDefinition[] = [
{
@@ -278,18 +318,21 @@ describe("combined model selector data", () => {
});
it("resolves selected labels from explicit provider model-selection state", () => {
const providers = buildSelectableProviderSelectorProviders([
snapshotEntry({
provider: "codex",
label: "Codex",
models: [codexModel],
}),
snapshotEntry({
provider: "codewhale",
label: "CodeWhale",
models: [],
}),
]);
const providers = buildSelectableProviderSelectorProviders(
[
snapshotEntry({
provider: "codex",
label: "Codex",
models: [codexModel],
}),
snapshotEntry({
provider: "codewhale",
label: "CodeWhale",
models: [],
}),
],
{ selectedProvider: null },
);
expect(
resolveSelectedModelLabel({
@@ -329,13 +372,16 @@ describe("combined model selector data", () => {
});
it("keeps a stored selected model visible when current snapshot rows no longer offer it", () => {
const providers = buildSelectableProviderSelectorProviders([
snapshotEntry({
provider: "codex",
label: "Codex",
models: [{ provider: "codex", id: "gpt-5.4", label: "GPT-5.4", isDefault: true }],
}),
]);
const providers = buildSelectableProviderSelectorProviders(
[
snapshotEntry({
provider: "codex",
label: "Codex",
models: [{ provider: "codex", id: "gpt-5.4", label: "GPT-5.4", isDefault: true }],
}),
],
{ selectedProvider: null },
);
expect(
resolveSelectedModelLabel({
@@ -348,15 +394,18 @@ describe("combined model selector data", () => {
});
it("keeps provider snapshot errors visible in the selected trigger label", () => {
const providers = buildSelectableProviderSelectorProviders([
snapshotEntry({
provider: "opencode",
label: "OpenCode",
status: "error",
error: "OpenCode app.agents timed out after 10s",
models: [],
}),
]);
const providers = buildSelectableProviderSelectorProviders(
[
snapshotEntry({
provider: "opencode",
label: "OpenCode",
status: "error",
error: "OpenCode app.agents timed out after 10s",
models: [],
}),
],
{ selectedProvider: null },
);
expect(
resolveSelectedModelLabel({
@@ -410,21 +459,27 @@ describe("combined model selector data", () => {
it("uses the active app language for utility labels", async () => {
await i18n.changeLanguage("zh-CN");
try {
const providers = buildSelectableProviderSelectorProviders([
snapshotEntry({
provider: "deepseek-tui",
label: "DeepSeek TUI",
models: [],
}),
snapshotEntry({
provider: "unavailable-provider",
status: "unavailable",
models: [],
}),
]);
const providers = buildSelectableProviderSelectorProviders(
[
snapshotEntry({
provider: "deepseek-tui",
label: "DeepSeek TUI",
models: [],
}),
],
{ selectedProvider: null },
);
expect(getAllModelLabels(providers)).toContain("默认");
expect(providers[1]?.modelSelection).toEqual({
expect(
buildSelectorProvider(
snapshotEntry({
provider: "unavailable-provider",
status: "unavailable",
models: [],
}),
).modelSelection,
).toEqual({
kind: "error",
message: "不可用",
});
@@ -143,20 +143,35 @@ export function buildProviderSelectorProviders(input: {
}));
}
/** One provider in a selector, whatever its state. */
export function buildSelectorProvider(
entry: ProviderSnapshotEntry,
isConnected = true,
): ProviderSelectorProvider {
const label = entry.label ?? entry.provider;
return {
id: entry.provider,
label,
modelSelection: buildEntryModelSelection(entry, label, isConnected),
};
}
/**
* The providers a user can pick a model from: enabled, and installed or still being probed. The
* provider of the picker's current choice stays whatever its state, so the selector still names
* it. Every picker says what that choice is, or `null` for none, so none can forget it.
*/
export function buildSelectableProviderSelectorProviders(
entries: ProviderSnapshotEntry[] | undefined,
isConnected = true,
options: { isConnected?: boolean; selectedProvider: string | null },
): ProviderSelectorProvider[] {
const { isConnected = true, selectedProvider } = options;
return (entries ?? [])
.filter((entry) => entry.enabled)
.map((entry) => {
const label = entry.label ?? entry.provider;
return {
id: entry.provider,
label,
modelSelection: buildEntryModelSelection(entry, label, isConnected),
};
});
.filter(
(entry) =>
entry.provider === selectedProvider || (entry.enabled && entry.status !== "unavailable"),
)
.map((entry) => buildSelectorProvider(entry, isConnected));
}
export function getProviderModelRows(
@@ -0,0 +1,4 @@
export { ProviderList } from "./internal/provider-list";
export { ProviderDetailPage } from "./internal/provider-detail-page";
export { ProviderDetailSheet } from "./internal/provider-detail-sheet";
export type { ProviderSheetFrame } from "./internal/sheet-frame";
@@ -0,0 +1,187 @@
import { PackagePlus } from "lucide-react-native";
import { useCallback, useMemo, useRef, useState } from "react";
import { useTranslation } from "react-i18next";
import { Text, View } from "react-native";
import { SvgXml } from "react-native-svg";
import { StyleSheet, withUnistyles } from "react-native-unistyles";
import { AdaptiveModalSheet, type SheetHeader } from "@/components/adaptive-modal-sheet";
import { rankProviderCatalog } from "@/components/provider-catalog-search";
import { SettingsCard, SettingsRow } from "@/components/settings";
import { Button } from "@/components/ui/button";
import {
useAcpProviderCatalog,
type AcpProviderCatalogItem,
} from "@/hooks/use-acp-provider-catalog";
import { useProvidersSnapshot } from "@/hooks/use-providers-snapshot";
import { settingsStyles } from "@/styles/settings";
import { ICON_SIZE, type Theme } from "@/styles/theme";
import { useProviderConfigActions } from "./provider-config";
import { OVERLAY_SHEET_FRAME, type ProviderSheetFrame } from "./sheet-frame";
const ThemedPackagePlus = withUnistyles(PackagePlus);
const ThemedSvgXml = withUnistyles(SvgXml);
const foregroundColorMapping = (theme: Theme) => ({ color: theme.colors.foreground });
export interface AddProviderSheetProps {
serverId: string;
visible: boolean;
onClose: () => void;
/** The provider is in config and listed; open its detail. */
onAdded: (providerId: string) => void;
frame?: ProviderSheetFrame;
}
/** The catalog of providers not added yet, searchable, each with Add. */
export function AddProviderSheet({
serverId,
visible,
onClose,
onAdded,
frame = OVERLAY_SHEET_FRAME,
}: AddProviderSheetProps) {
const { t } = useTranslation();
const { entries: catalog } = useAcpProviderCatalog();
const { entries: providers } = useProvidersSnapshot(serverId);
const { add, addingProviderId } = useProviderConfigActions(serverId);
const [search, setSearch] = useState("");
// Each opening starts from an empty search; the field clears when this changes.
const [session, setSession] = useState(0);
// Read when an add finishes, to tell whether the sheet it started in is still open.
const sessionRef = useRef(0);
const endSession = useCallback(() => {
setSearch("");
sessionRef.current += 1;
setSession(sessionRef.current);
}, []);
const handleClose = useCallback(() => {
endSession();
onClose();
}, [endSession, onClose]);
const available = useMemo(() => {
const added = new Set(providers?.map((entry) => entry.provider) ?? []);
return rankProviderCatalog(
catalog.filter((entry) => !added.has(entry.id)),
search,
);
}, [catalog, providers, search]);
const handleAdd = useCallback(
(entry: AcpProviderCatalogItem) => {
const startedIn = sessionRef.current;
void add(entry).then((added) => {
// Closed before the add finished: the provider is added, but the user has moved on.
if (!added || sessionRef.current !== startedIn) return added;
endSession();
onAdded(entry.id);
return added;
});
},
[add, endSession, onAdded],
);
const header = useMemo<SheetHeader>(
() => ({
title: t("settings.providers.addProvider"),
back: frame.returns
? {
onPress: handleClose,
accessibilityLabel: t("settings.providers.detail.backToProviders"),
}
: undefined,
search: {
onChange: setSearch,
placeholder: t("providerCatalog.search"),
resetKey: session,
testID: "provider-catalog-search",
},
}),
[frame.returns, handleClose, session, t],
);
return (
<AdaptiveModalSheet
header={header}
visible={visible}
onClose={handleClose}
showCloseButton={!frame.returns}
desktopMaxWidth={frame.desktopMaxWidth}
desktopHeight={frame.desktopHeight}
snapPoints={frame.snapPoints}
testID="add-provider-sheet"
>
<SettingsCard>
{available.length === 0 ? (
<View style={settingsStyles.row}>
<Text style={styles.empty}>{t("providerCatalog.noProviders")}</Text>
</View>
) : (
available.map((entry) => (
<CatalogRow
key={entry.id}
entry={entry}
adding={addingProviderId === entry.id}
disabled={addingProviderId !== null}
onAdd={handleAdd}
/>
))
)}
</SettingsCard>
</AdaptiveModalSheet>
);
}
function CatalogRow({
entry,
adding,
disabled,
onAdd,
}: {
entry: AcpProviderCatalogItem;
adding: boolean;
disabled: boolean;
onAdd: (entry: AcpProviderCatalogItem) => void;
}) {
const { t } = useTranslation();
const handleAdd = useCallback(() => onAdd(entry), [entry, onAdd]);
const icon = useMemo(
() =>
entry.iconSvg ? (
<ThemedSvgXml
xml={entry.iconSvg}
width={ICON_SIZE.md}
height={ICON_SIZE.md}
uniProps={foregroundColorMapping}
/>
) : (
<ThemedPackagePlus size={ICON_SIZE.md} uniProps={foregroundColorMapping} />
),
[entry.iconSvg],
);
return (
<SettingsRow
leading={icon}
label={entry.title}
hint={entry.description}
testID={`provider-catalog-row-${entry.id}`}
>
<Button
variant="outline"
onPress={handleAdd}
loading={adding}
disabled={disabled}
accessibilityLabel={t("providerCatalog.actions.addProvider", { provider: entry.title })}
testID={`install-provider-${entry.id}`}
>
{adding ? t("providerCatalog.actions.adding") : t("providerCatalog.actions.add")}
</Button>
</SettingsRow>
);
}
const styles = StyleSheet.create((theme) => ({
empty: {
color: theme.colors.foregroundMuted,
fontSize: theme.fontSize.base,
},
}));
@@ -0,0 +1,249 @@
import { describe, expect, it } from "vitest";
import type { ProviderSnapshotEntry } from "@getpaseo/protocol/agent-types";
import type { ProviderInstallationState } from "@/components/provider-installation-section";
import { readDetailPresence, readDetailSections, readShownInstallation } from "./detail-sections";
function entry(overrides: Partial<ProviderSnapshotEntry> = {}): ProviderSnapshotEntry {
return {
provider: "opencode",
label: "OpenCode",
status: "ready",
enabled: true,
modes: [],
models: [],
...overrides,
};
}
const unsupported: ProviderInstallationState = { status: "unsupported" };
const notInstalled: ProviderInstallationState = {
status: "ready",
installation: { inspection: { status: "not_installed" }, canUpdate: false },
};
describe("provider detail sections", () => {
it("shows every model for a provider that runs", () => {
expect(readDetailSections(entry(), unsupported)).toEqual({ error: null, models: "all" });
});
it("keeps every model while the provider is probed again", () => {
expect(readDetailSections(entry({ status: "loading" }), unsupported).models).toBe("all");
});
it("leads with the error and keeps custom models when the provider fails", () => {
expect(
readDetailSections(
entry({ status: "error", error: "opencode exited with code 1" }),
unsupported,
),
).toEqual({ error: "opencode exited with code 1", models: "custom" });
});
it("says nothing extra and lists no models when Installation already says Not installed", () => {
expect(readDetailSections(entry({ status: "unavailable" }), unsupported)).toEqual({
error: null,
models: null,
});
expect(
readDetailSections(entry({ status: "error", error: "spawn ENOENT" }), notInstalled),
).toEqual({ error: null, models: null });
});
it("hides models and the error for a disabled provider", () => {
expect(
readDetailSections(entry({ enabled: false, status: "error", error: "boom" }), unsupported),
).toEqual({ error: null, models: null });
});
it("gives an error with no message an empty one, so the alert still shows", () => {
expect(readDetailSections(entry({ status: "error" }), unsupported).error).toBe("");
});
});
describe("provider detail installation", () => {
const guide = "https://example.com/install";
const noContract: ProviderInstallationState = { status: "ready", installation: null };
it("says Not installed with the install guide when the host reports nothing about it", () => {
expect(
readShownInstallation({
entry: entry({ status: "unavailable" }),
installation: noContract,
installGuide: guide,
}),
).toEqual({
status: "ready",
installation: { inspection: { status: "not_installed" }, installUrl: guide },
});
});
it("keeps the host's install link over the guide", () => {
const hosted: ProviderInstallationState = {
status: "ready",
installation: {
inspection: { status: "not_installed" },
installUrl: "https://host.example/install",
canUpdate: false,
},
};
expect(
readShownInstallation({
entry: entry({ status: "unavailable" }),
installation: hosted,
installGuide: guide,
}),
).toEqual(hosted);
});
it("gives the host's Not installed the guide when the host has no link", () => {
expect(
readShownInstallation({
entry: entry({ status: "unavailable" }),
installation: notInstalled,
installGuide: guide,
}),
).toEqual({
status: "ready",
installation: {
inspection: { status: "not_installed" },
canUpdate: false,
installUrl: guide,
},
});
});
it("adds nothing for an installed or disabled provider", () => {
expect(
readShownInstallation({ entry: entry(), installation: noContract, installGuide: guide }),
).toEqual(noContract);
expect(
readShownInstallation({
entry: entry({ enabled: false, status: "unavailable" }),
installation: noContract,
installGuide: guide,
}),
).toEqual(noContract);
});
it("says nothing it cannot back with a guide", () => {
expect(
readShownInstallation({
entry: entry({ status: "unavailable" }),
installation: noContract,
installGuide: null,
}),
).toEqual(noContract);
});
it("says Not installed with the guide on a host that cannot report installations", () => {
expect(
readShownInstallation({
entry: entry({ status: "unavailable" }),
installation: unsupported,
installGuide: guide,
}),
).toEqual({
status: "ready",
installation: { inspection: { status: "not_installed" }, installUrl: guide },
});
// Without a guide, or for a provider the host runs, there is nothing to show.
expect(
readShownInstallation({
entry: entry({ status: "unavailable" }),
installation: unsupported,
installGuide: null,
}),
).toEqual(unsupported);
expect(
readShownInstallation({ entry: entry(), installation: unsupported, installGuide: guide }),
).toEqual(unsupported);
});
it("waits while the host is still checking", () => {
const checking: ProviderInstallationState = { status: "loading" };
expect(
readShownInstallation({
entry: entry({ status: "unavailable" }),
installation: checking,
installGuide: guide,
}),
).toEqual(checking);
});
});
describe("provider detail presence", () => {
const loaded = [entry(), entry({ provider: "codex", label: "Codex" })];
it("finds the provider among the host's providers", () => {
expect(
readDetailPresence({
provider: "codex",
connected: true,
entries: loaded,
error: null,
removing: null,
}),
).toEqual({ kind: "found", entry: loaded[1] });
});
it("is loading until the host's providers arrive", () => {
expect(
readDetailPresence({
provider: "codex",
connected: true,
entries: undefined,
error: null,
removing: null,
}),
).toEqual({ kind: "loading" });
});
it("says the provider is missing once the host's providers have arrived without it", () => {
expect(
readDetailPresence({
provider: "gone",
connected: true,
entries: loaded,
error: null,
removing: null,
}),
).toEqual({ kind: "missing" });
});
it("keeps showing a provider this page is removing once it leaves the list", () => {
const gone = entry({ provider: "gone", label: "Gone" });
expect(
readDetailPresence({
provider: "gone",
connected: true,
entries: loaded,
error: null,
removing: gone,
}),
).toEqual({ kind: "found", entry: gone });
});
it("says the host is offline rather than loading forever", () => {
expect(
readDetailPresence({
provider: "codex",
connected: false,
entries: undefined,
error: null,
removing: null,
}),
).toEqual({ kind: "offline" });
});
it("shows why the host's providers could not be read", () => {
expect(
readDetailPresence({
provider: "codex",
connected: true,
entries: undefined,
error: "Request timed out",
removing: null,
}),
).toEqual({ kind: "failed", message: "Request timed out" });
});
});
@@ -0,0 +1,97 @@
import type { ProviderSnapshotEntry } from "@getpaseo/protocol/agent-types";
import type { ProviderInstallationState } from "@/components/provider-installation-section";
export interface DetailSections {
/** The failure the page leads with, or null. Empty when the provider gave no message. */
error: string | null;
/**
* Which models the page lists. The provider reports its own only while it runs; custom models
* live in config, so they stay manageable while it fails.
*/
models: "all" | "custom" | null;
}
/** Which of the detail's state-dependent parts show, so each fact is said once. */
export function readDetailSections(
entry: ProviderSnapshotEntry,
installation: ProviderInstallationState,
): DetailSections {
const notInstalled =
entry.status === "unavailable" ||
(installation.status === "ready" &&
installation.installation?.inspection?.status === "not_installed");
const failing = entry.enabled && entry.status === "error" && !notInstalled;
return {
error: failing ? (entry.error?.trim() ?? "") : null,
models: readShownModels(entry, notInstalled),
};
}
function readShownModels(
entry: ProviderSnapshotEntry,
notInstalled: boolean,
): DetailSections["models"] {
if (!entry.enabled || notInstalled) return null;
return entry.status === "error" ? "custom" : "all";
}
/**
* The installation the page shows. A provider added from the catalog has no installation the
* host can report, so when its CLI is missing the page says so with the catalog's install guide.
* The host's own install link wins over the guide. A host that cannot report installations gets
* the same row, because the guide is the app's own catalog data.
*/
export function readShownInstallation(input: {
entry: ProviderSnapshotEntry;
installation: ProviderInstallationState;
/** The catalog's install guide for this provider, or null. */
installGuide: string | null;
}): ProviderInstallationState {
const { entry, installation, installGuide } = input;
if (!installGuide) return installation;
if (installation.status !== "ready" && installation.status !== "unsupported") return installation;
const reported = installation.status === "ready" ? installation.installation : null;
if (reported?.installUrl) return installation;
const notInstalled =
reported?.inspection?.status === "not_installed" ||
(!reported?.inspection && entry.enabled && entry.status === "unavailable");
if (!notInstalled) return installation;
return {
status: "ready",
installation: {
...reported,
inspection: { status: "not_installed" },
installUrl: installGuide,
},
};
}
export type DetailPresence =
| { kind: "found"; entry: ProviderSnapshotEntry }
| { kind: "loading" }
| { kind: "missing" }
| { kind: "offline" }
| { kind: "failed"; message: string };
/**
* Whether the page has a provider to show. A page opened from its URL renders before the host's
* providers arrive, and its id may name a provider the host no longer has. A provider this page is
* removing leaves the list before the removal answers; the page keeps showing it until it closes.
*/
export function readDetailPresence(input: {
provider: string;
connected: boolean;
entries: ProviderSnapshotEntry[] | undefined;
error: string | null;
/** The provider this page's own Remove is deleting, as it was when the user confirmed. */
removing: ProviderSnapshotEntry | null;
}): DetailPresence {
const entry =
input.entries?.find((candidate) => candidate.provider === input.provider) ??
(input.removing?.provider === input.provider ? input.removing : undefined);
if (entry) return { kind: "found", entry };
if (!input.connected) return { kind: "offline" };
if (input.entries) return { kind: "missing" };
if (input.error) return { kind: "failed", message: input.error };
return { kind: "loading" };
}
@@ -0,0 +1,149 @@
import * as Clipboard from "expo-clipboard";
import { Copy, RotateCw } from "lucide-react-native";
import { useCallback, useEffect, useMemo, useState } from "react";
import { useTranslation } from "react-i18next";
import { Text, View } from "react-native";
import { StyleSheet, withUnistyles } from "react-native-unistyles";
import {
AdaptiveModalSheet,
SheetHeaderIconButton,
type SheetHeader,
} from "@/components/adaptive-modal-sheet";
import { LoadingSpinner } from "@/components/ui/loading-spinner";
import { ScrollableCodeSurface, SurfaceCard } from "@/components/ui/scrollable-code-surface";
import { useToast } from "@/contexts/toast-context";
import { useHostRuntimeClient } from "@/runtime/host-runtime";
import type { Theme } from "@/styles/theme";
const ThemedLoadingSpinner = withUnistyles(LoadingSpinner);
const mutedColorMapping = (theme: Theme) => ({ color: theme.colors.foregroundMuted });
const DIAGNOSTIC_SNAP_POINTS = ["50%", "85%"];
/** The provider's diagnostic report, run on open, with copy and run again. */
export function DiagnosticSheet({
serverId,
provider,
visible,
onClose,
}: {
serverId: string;
provider: string;
visible: boolean;
onClose: () => void;
}) {
const { t } = useTranslation();
const toast = useToast();
const client = useHostRuntimeClient(serverId);
const [diagnostic, setDiagnostic] = useState<string | null>(null);
const [loading, setLoading] = useState(false);
const fetchDiagnostic = useCallback(async () => {
if (!client) return;
setLoading(true);
try {
const result = await client.getProviderDiagnostic(provider);
setDiagnostic(result.diagnostic);
} catch (err) {
setDiagnostic(
err instanceof Error ? err.message : t("settings.providers.diagnostic.failedToFetch"),
);
} finally {
setLoading(false);
}
}, [client, provider, t]);
useEffect(() => {
if (visible) {
void fetchDiagnostic();
} else {
setDiagnostic(null);
}
}, [visible, fetchDiagnostic]);
const handleRefresh = useCallback(() => {
if (loading) return;
void fetchDiagnostic();
}, [fetchDiagnostic, loading]);
const handleCopy = useCallback(() => {
if (!diagnostic) return;
void Clipboard.setStringAsync(diagnostic)
.then(() => toast.copied(t("settings.providers.diagnostic.copyLabel")))
.catch(() => toast.error(t("settings.providers.diagnostic.copyFailed")));
}, [diagnostic, t, toast]);
const header = useMemo<SheetHeader>(
() => ({
title: t("settings.providers.diagnostic.title"),
actions: (
<>
<SheetHeaderIconButton
icon={Copy}
label={t("settings.providers.diagnostic.copyAccessibility")}
onPress={handleCopy}
disabled={!diagnostic}
/>
<SheetHeaderIconButton
icon={RotateCw}
label={
loading
? t("settings.providers.diagnostic.refreshingAccessibility")
: t("settings.providers.diagnostic.refreshAccessibility")
}
onPress={handleRefresh}
busy={loading}
/>
</>
),
}),
[diagnostic, handleCopy, handleRefresh, loading, t],
);
let body: React.ReactNode;
if (loading && !diagnostic) {
body = (
<SurfaceCard>
<View style={styles.placeholder}>
<ThemedLoadingSpinner size="small" uniProps={mutedColorMapping} />
<Text style={styles.mutedText}>{t("settings.providers.diagnostic.running")}</Text>
</View>
</SurfaceCard>
);
} else if (diagnostic) {
body = <ScrollableCodeSurface maxHeight={480}>{diagnostic}</ScrollableCodeSurface>;
} else {
body = (
<SurfaceCard>
<View style={styles.placeholder}>
<Text style={styles.mutedText}>{t("settings.providers.diagnostic.none")}</Text>
</View>
</SurfaceCard>
);
}
return (
<AdaptiveModalSheet
header={header}
visible={visible}
onClose={onClose}
snapPoints={DIAGNOSTIC_SNAP_POINTS}
scrollable={false}
testID="provider-diagnostic-sheet"
>
{body}
</AdaptiveModalSheet>
);
}
const styles = StyleSheet.create((theme) => ({
placeholder: {
paddingVertical: theme.spacing[4],
paddingHorizontal: theme.spacing[4],
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[2],
},
mutedText: {
fontSize: theme.fontSize.base,
color: theme.colors.foregroundMuted,
},
}));
@@ -3,7 +3,7 @@ import type { AgentModelDefinition } from "@getpaseo/protocol/agent-types";
import {
resolveProviderDiscoveredModels,
type ProviderDiscoveredModelsCache,
} from "./provider-diagnostic-models";
} from "./discovered-models";
const piModel: AgentModelDefinition = {
provider: "pi",
@@ -0,0 +1,151 @@
import { useCallback, useRef, useState } from "react";
import { useTranslation } from "react-i18next";
import { Alert } from "react-native";
import { useToast } from "@/contexts/toast-api-context";
import { useDaemonConfig } from "@/hooks/use-daemon-config";
import {
buildAcpProviderConfigPatch,
getAcpProviderCatalog,
type AcpProviderCatalogItem,
} from "@/hooks/use-acp-provider-catalog";
import { useProvidersSnapshot } from "@/hooks/use-providers-snapshot";
import { selectHostFeature, useHostFeature } from "@/runtime/host-features";
import { useSessionStore } from "@/stores/session-store";
import { confirmDialog } from "@/utils/confirm-dialog";
export type ProviderEntry = NonNullable<ReturnType<typeof useProvidersSnapshot>["entries"]>[number];
export interface ProviderConfigActions {
/** The provider whose Enabled switch is being saved. */
togglingProviderId: string | null;
setEnabled: (providerId: string, enabled: boolean) => void;
/** Config owns the provider, so Remove can delete it. */
canRemove: (entry: ProviderEntry) => boolean;
/**
* The provider being removed, as it was when the user confirmed. It stays set once the removal
* succeeds, because whatever shows the provider closes next and keeps showing it until then, and
* ends when the host lists the provider again, as when the user adds it back.
*/
removing: ProviderEntry | null;
/** Asks first; resolves true once the provider is gone from config. */
remove: (entry: ProviderEntry, providerLabel: string) => Promise<boolean>;
/** The catalog provider being written to config. */
addingProviderId: string | null;
/** Writes a catalog provider to config and probes it; resolves true once it is listed. */
add: (entry: AcpProviderCatalogItem) => Promise<boolean>;
}
/** Writes a provider's Enabled flag, adds catalog providers and removes config-owned ones. */
export function useProviderConfigActions(serverId: string): ProviderConfigActions {
const { t } = useTranslation();
const toast = useToast();
const { config, patchConfig } = useDaemonConfig(serverId);
const { entries, refresh } = useProvidersSnapshot(serverId);
const supportsProviderRemoval = useHostFeature(serverId, "providerRemoval");
const [togglingProviderId, setTogglingProviderId] = useState<string | null>(null);
const [removal, setRemoval] = useState<{ entry: ProviderEntry; done: boolean } | null>(null);
const removingRef = useRef<string | null>(null);
const [addingProviderId, setAddingProviderId] = useState<string | null>(null);
const addingRef = useRef<string | null>(null);
const setEnabled = useCallback(
(providerId: string, enabled: boolean) => {
setTogglingProviderId(providerId);
void patchConfig({ providers: { [providerId]: { enabled } } })
.catch((error: unknown) => {
Alert.alert(
t("settings.providers.updateErrorTitle"),
error instanceof Error ? error.message : String(error),
);
})
.finally(() => {
setTogglingProviderId((current) => (current === providerId ? null : current));
});
},
[patchConfig, t],
);
// Config owns derived providers and the opt-in bundled catalog providers.
const canRemove = useCallback(
(entry: ProviderEntry) => {
const providerConfig = config?.providers?.[entry.provider];
if (!supportsProviderRemoval || entry.source !== "custom" || !providerConfig) return false;
return Boolean(
providerConfig.extends ||
getAcpProviderCatalog().some(
(catalogEntry) => catalogEntry.id === entry.provider && catalogEntry.bundledProvider,
),
);
},
[config, supportsProviderRemoval],
);
const remove = useCallback(
async (entry: ProviderEntry, providerLabel: string) => {
if (removingRef.current) return false;
removingRef.current = entry.provider;
try {
const confirmed = await confirmDialog({
title: t("settings.providers.remove.confirmTitle", { name: providerLabel }),
message: t("settings.providers.remove.confirmMessage"),
confirmLabel: t("settings.providers.remove.confirm"),
destructive: true,
});
if (!confirmed) return false;
setRemoval({ entry, done: false });
await patchConfig({ removeProviders: [entry.provider] });
setRemoval({ entry, done: true });
return true;
} catch (error) {
setRemoval(null);
Alert.alert(
t("settings.providers.remove.errorTitle"),
error instanceof Error ? error.message : String(error),
);
return false;
} finally {
removingRef.current = null;
}
},
[patchConfig, t],
);
// A sheet outlives each opening, so a finished removal ends here rather than with the sheet.
if (removal?.done && entries?.some((entry) => entry.provider === removal.entry.provider)) {
setRemoval(null);
}
const add = useCallback(
async (entry: AcpProviderCatalogItem) => {
if (addingRef.current) return false;
addingRef.current = entry.id;
setAddingProviderId(entry.id);
try {
await patchConfig(
buildAcpProviderConfigPatch(entry, (feature) =>
selectHostFeature(useSessionStore.getState(), serverId, feature),
),
);
await refresh([entry.id]);
return true;
} catch (error) {
toast.error(error instanceof Error ? error.message : String(error));
return false;
} finally {
if (addingRef.current === entry.id) addingRef.current = null;
setAddingProviderId((current) => (current === entry.id ? null : current));
}
},
[patchConfig, refresh, serverId, toast],
);
return {
togglingProviderId,
setEnabled,
canRemove,
removing: removal?.entry ?? null,
remove,
addingProviderId,
add,
};
}
@@ -0,0 +1,49 @@
import { useMemo } from "react";
import { useTranslation } from "react-i18next";
import { View } from "react-native";
import { SettingsDetailHeader } from "@/components/settings";
import { ProviderDetail, useProviderDetail } from "./provider-detail";
import { ProviderGlyph } from "./provider-glyph";
/**
* A provider's detail as a Settings page, shaped like a project's: the screen titles it
* "Providers", the page names the provider. On wide layouts the page has no back button of its
* own, so it draws "Back to providers".
*/
export function ProviderDetailPage({
serverId,
provider,
onBack,
showBack,
}: {
serverId: string;
provider: string;
onBack: () => void;
showBack: boolean;
}) {
const { t } = useTranslation();
const detail = useProviderDetail({ serverId, provider, onRemoved: onBack });
const back = useMemo(
() => ({
label: t("settings.providers.detail.backToProviders"),
onPress: onBack,
testID: "provider-detail-back",
}),
[onBack, t],
);
const icon = useMemo(
() => <ProviderGlyph serverId={serverId} provider={provider} />,
[provider, serverId],
);
return (
<View testID="provider-detail-page">
<SettingsDetailHeader
back={showBack ? back : undefined}
icon={icon}
title={detail.label}
titleTestID="provider-detail-title"
/>
<ProviderDetail serverId={serverId} detail={detail} />
</View>
);
}
@@ -0,0 +1,52 @@
import { useMemo } from "react";
import { useTranslation } from "react-i18next";
import { AdaptiveModalSheet, type SheetHeader } from "@/components/adaptive-modal-sheet";
import { ProviderDetail, useProviderDetail } from "./provider-detail";
import { ProviderGlyph } from "./provider-glyph";
import { OVERLAY_SHEET_FRAME, type ProviderSheetFrame } from "./sheet-frame";
/** A provider's detail as a sheet, for surfaces with no Settings route to push. */
export function ProviderDetailSheet({
serverId,
provider,
visible,
onClose,
frame = OVERLAY_SHEET_FRAME,
}: {
serverId: string;
provider: string;
visible: boolean;
onClose: () => void;
frame?: ProviderSheetFrame;
}) {
const { t } = useTranslation();
const detail = useProviderDetail({ serverId, provider, onRemoved: onClose });
const label = detail.label;
const header = useMemo<SheetHeader>(
() => ({
title: label,
leading: <ProviderGlyph serverId={serverId} provider={provider} />,
back: frame.returns
? {
onPress: onClose,
accessibilityLabel: t("settings.providers.detail.backToProviders"),
}
: undefined,
}),
[frame.returns, label, onClose, provider, serverId, t],
);
return (
<AdaptiveModalSheet
header={header}
showCloseButton={!frame.returns}
visible={visible}
onClose={onClose}
snapPoints={frame.snapPoints}
desktopMaxWidth={frame.desktopMaxWidth}
desktopHeight={frame.desktopHeight}
testID="provider-settings-sheet"
>
<ProviderDetail serverId={serverId} detail={detail} />
</AdaptiveModalSheet>
);
}
@@ -0,0 +1,255 @@
import { useCallback, useState } from "react";
import { useTranslation } from "react-i18next";
import { View } from "react-native";
import { ProviderInstallationSection } from "@/components/provider-installation-section";
import { useProviderInstallation } from "@/components/provider-installation";
import {
SettingsCard,
SettingsDetailRow,
SettingsRow,
SettingsSection,
SettingsSwitch,
} from "@/components/settings";
import { Alert } from "@/components/ui/alert";
import { Button } from "@/components/ui/button";
import { readAcpProviderInstallGuide } from "@/hooks/use-acp-provider-catalog";
import { useProvidersSnapshot } from "@/hooks/use-providers-snapshot";
import { useTimeAgo } from "@/hooks/use-time-ago";
import { useHostRuntimeIsConnected } from "@/runtime/host-runtime";
import { settingsStyles } from "@/styles/settings";
import {
readDetailPresence,
readDetailSections,
readShownInstallation,
type DetailPresence,
} from "./detail-sections";
import { DiagnosticSheet } from "./diagnostic-sheet";
import { useProviderConfigActions, type ProviderEntry } from "./provider-config";
import { ProviderModels } from "./provider-models";
import { ProviderNotice } from "./provider-notice";
export interface ProviderDetailState {
provider: string;
/** The provider's name, kept while this page removes it. */
label: string;
presence: DetailPresence;
/** Config owns the provider, so Remove can delete it. */
canRemove: (entry: ProviderEntry) => boolean;
/** This page's Remove is running, or has succeeded and the page is closing. */
removing: boolean;
remove: () => void;
}
/**
* What a provider's detail shows and its Remove, shared by the frame's title and the body. A
* provider this page removes leaves the host's list before the removal answers; both keep showing
* it until the frame closes.
*/
export function useProviderDetail({
serverId,
provider,
onRemoved,
}: {
serverId: string;
provider: string;
/** The provider was removed; leave its detail. */
onRemoved: () => void;
}): ProviderDetailState {
const { entries, error } = useProvidersSnapshot(serverId);
const connected = useHostRuntimeIsConnected(serverId);
const { canRemove, remove, removing } = useProviderConfigActions(serverId);
const presence = readDetailPresence({ provider, connected, entries, error, removing });
const shown = presence.kind === "found" ? presence.entry : null;
const label = shown?.label ?? provider;
const handleRemove = useCallback(() => {
if (!shown) return;
void remove(shown, label).then((removed) => {
if (removed) onRemoved();
return removed;
});
}, [label, onRemoved, remove, shown]);
return {
provider,
label,
presence,
canRemove,
removing: removing?.provider === provider,
remove: handleRemove,
};
}
/**
* Everything about one provider, top to bottom: what is wrong, whether it runs, its installation,
* its models, then the rare actions. The page and the sheet frame the same body.
*/
export function ProviderDetail({
serverId,
detail,
}: {
serverId: string;
detail: ProviderDetailState;
}) {
const { provider, presence, label } = detail;
const { refresh, isRefreshing } = useProvidersSnapshot(serverId);
const installation = useProviderInstallation({ serverId, provider, visible: true });
const refreshInstallation = installation.refresh;
const handleRefresh = useCallback(() => {
void refresh([provider]);
refreshInstallation();
}, [provider, refresh, refreshInstallation]);
if (presence.kind !== "found") return <AbsentProvider presence={presence} />;
const entry = presence.entry;
const shownInstallation = readShownInstallation({
entry,
installation: installation.state,
installGuide: readAcpProviderInstallGuide(provider),
});
const sections = readDetailSections(entry, shownInstallation);
return (
<View testID="provider-detail">
{sections.error !== null ? <ProviderErrorAlert label={label} error={sections.error} /> : null}
<EnabledCard serverId={serverId} entry={entry} />
<ProviderInstallationSection
state={shownInstallation}
updates={installation.updates}
action={installation.action}
/>
{sections.models ? (
<ProviderModels
serverId={serverId}
entry={entry}
discovered={sections.models === "all"}
refresh={refresh}
/>
) : null}
<Troubleshooting
serverId={serverId}
entry={entry}
refreshing={isRefreshing || installation.refreshing}
onRefresh={handleRefresh}
/>
{/* Config no longer owns a provider whose removal has succeeded. */}
{detail.removing || detail.canRemove(entry) ? (
<DangerZone removing={detail.removing} onRemove={detail.remove} />
) : null}
</View>
);
}
function AbsentProvider({ presence }: { presence: Exclude<DetailPresence, { kind: "found" }> }) {
const { t } = useTranslation();
const messages = {
loading: t("settings.providers.loading"),
missing: t("settings.providers.detail.notOnHost"),
offline: t("settings.providers.unavailable"),
};
const message = presence.kind === "failed" ? presence.message : messages[presence.kind];
return <ProviderNotice message={message} testID={`provider-detail-${presence.kind}`} />;
}
function ProviderErrorAlert({ label, error }: { label: string; error: string }) {
const { t } = useTranslation();
return (
<View style={settingsStyles.section}>
<Alert
variant="error"
title={t("settings.providers.detail.unavailableTitle", { name: label })}
description={error || t("settings.providers.diagnostic.unknownError")}
testID="provider-error"
/>
</View>
);
}
function EnabledCard({ serverId, entry }: { serverId: string; entry: ProviderEntry }) {
const { t } = useTranslation();
const { setEnabled, togglingProviderId } = useProviderConfigActions(serverId);
const handleChange = useCallback(
(enabled: boolean) => setEnabled(entry.provider, enabled),
[entry.provider, setEnabled],
);
return (
<View style={settingsStyles.section}>
<SettingsCard>
<SettingsSwitch
label={t("settings.providers.detail.enabled")}
value={entry.enabled}
onValueChange={handleChange}
disabled={togglingProviderId === entry.provider}
/>
</SettingsCard>
</View>
);
}
function Troubleshooting({
serverId,
entry,
refreshing,
onRefresh,
}: {
serverId: string;
entry: ProviderEntry;
refreshing: boolean;
onRefresh: () => void;
}) {
const { t } = useTranslation();
const [diagnosticOpen, setDiagnosticOpen] = useState(false);
const openDiagnostic = useCallback(() => setDiagnosticOpen(true), []);
const closeDiagnostic = useCallback(() => setDiagnosticOpen(false), []);
const checked = useTimeAgo(entry.fetchedAt ? new Date(entry.fetchedAt) : null);
// The probe running again is a refresh too, whoever asked for it.
const busy = refreshing || entry.status === "loading";
return (
<SettingsSection title={t("settings.providers.detail.troubleshooting")}>
<SettingsCard>
<SettingsRow
label={t("settings.providers.detail.status")}
hint={
entry.fetchedAt ? t("settings.providers.detail.checked", { time: checked }) : undefined
}
>
<Button variant="outline" onPress={onRefresh} loading={busy} testID="provider-refresh">
{busy
? t("settings.providers.diagnostic.refreshing")
: t("settings.providers.diagnostic.refresh")}
</Button>
</SettingsRow>
<SettingsDetailRow
label={t("settings.providers.detail.diagnosticReport")}
onPress={openDiagnostic}
testID="provider-diagnostic-report"
/>
</SettingsCard>
<DiagnosticSheet
serverId={serverId}
provider={entry.provider}
visible={diagnosticOpen}
onClose={closeDiagnostic}
/>
</SettingsSection>
);
}
function DangerZone({ removing, onRemove }: { removing: boolean; onRemove: () => void }) {
const { t } = useTranslation();
return (
<SettingsSection title={t("settings.providers.detail.dangerZone")}>
<SettingsCard>
<SettingsRow
label={t("settings.providers.actions.remove")}
hint={t("settings.providers.detail.removeHint")}
>
<Button variant="outline" onPress={onRemove} loading={removing} testID="provider-remove">
{removing
? t("settings.providers.actions.removing")
: t("settings.providers.remove.confirm")}
</Button>
</SettingsRow>
</SettingsCard>
</SettingsSection>
);
}
@@ -0,0 +1,13 @@
import { StyleSheet } from "react-native-unistyles";
import { useProviderIcon } from "@/components/provider-icons";
import { ICON_SIZE } from "@/styles/theme";
/** A provider's icon at row size, drawn in the foreground colour. */
export function ProviderGlyph({ serverId, provider }: { serverId: string; provider: string }) {
const Icon = useProviderIcon(provider, serverId);
return <Icon size={ICON_SIZE.md} color={styles.glyph.color} />;
}
const styles = StyleSheet.create((theme) => ({
glyph: { color: theme.colors.foreground },
}));
@@ -0,0 +1,206 @@
import { Plus } from "lucide-react-native";
import { useCallback, useMemo, useState } from "react";
import { useTranslation } from "react-i18next";
import { View } from "react-native";
import { StyleSheet } from "react-native-unistyles";
import { useProviderInstallation } from "@/components/provider-installation";
import { SettingsAddRow, SettingsCard, SettingsSection } from "@/components/settings";
import { Button } from "@/components/ui/button";
import { SkeletonPulse, useSkeletonPulse } from "@/components/ui/skeleton";
import { useProvidersSnapshot } from "@/hooks/use-providers-snapshot";
import { useHostRuntimeIsConnected } from "@/runtime/host-runtime";
import { settingsStyles } from "@/styles/settings";
import { buildProviderDefinitions } from "@/utils/provider-definitions";
import { AddProviderSheet } from "./add-provider-sheet";
import { useProviderConfigActions, type ProviderEntry } from "./provider-config";
import { ProviderGlyph } from "./provider-glyph";
import { ProviderNotice } from "./provider-notice";
import { ProviderRow } from "./provider-row";
import { readRowSummary } from "./row-summary";
import type { ProviderSheetFrame } from "./sheet-frame";
export interface ProviderListProps {
serverId: string;
/** Opens a provider's detail wherever the host shows it: a Settings page or a sheet. */
onOpenProvider: (providerId: string) => void;
/** Where the sheets the list opens sit. Defaults to a sheet over the current screen. */
sheetFrame?: ProviderSheetFrame;
}
/** The host's providers, each saying how it is, and the way to add one. */
export function ProviderList({ serverId, onOpenProvider, sheetFrame }: ProviderListProps) {
const { t } = useTranslation();
const isConnected = useHostRuntimeIsConnected(serverId) && serverId.length > 0;
const { entries, isLoading } = useProvidersSnapshot(serverId);
const { setEnabled, togglingProviderId } = useProviderConfigActions(serverId);
const definitions = useMemo(() => buildProviderDefinitions(entries), [entries]);
const [adding, setAdding] = useState(false);
const openAdd = useCallback(() => setAdding(true), []);
const closeAdd = useCallback(() => setAdding(false), []);
const handleAdded = useCallback(
(providerId: string) => {
setAdding(false);
onOpenProvider(providerId);
},
[onOpenProvider],
);
const addButton = useMemo(
() =>
isConnected ? (
<Button
variant="ghost"
leftIcon={Plus}
onPress={openAdd}
accessibilityLabel={t("settings.providers.addProvider")}
testID="provider-list-add"
>
{t("settings.providers.list.add")}
</Button>
) : null,
[isConnected, openAdd, t],
);
let body: React.ReactNode;
if (!isConnected) {
body = <ProviderNotice message={t("settings.providers.unavailable")} />;
} else if (isLoading) {
body = <ProviderRowsSkeleton />;
} else {
body = (
<SettingsCard testID="provider-list">
{definitions.map((definition) => {
const entry = entries?.find((candidate) => candidate.provider === definition.id);
if (!entry) return null;
return (
<ListedProvider
key={definition.id}
serverId={serverId}
entry={entry}
label={definition.label}
toggling={togglingProviderId === definition.id}
onOpen={onOpenProvider}
onToggle={setEnabled}
/>
);
})}
<SettingsAddRow
label={t("settings.providers.addProvider")}
onPress={openAdd}
testID="provider-list-add-row"
/>
</SettingsCard>
);
}
return (
<>
<SettingsSection
title={t("settings.providers.title")}
trailing={addButton}
testID="host-page-providers-card"
>
{body}
</SettingsSection>
{isConnected ? (
<AddProviderSheet
serverId={serverId}
visible={adding}
onClose={closeAdd}
onAdded={handleAdded}
frame={sheetFrame}
/>
) : null}
</>
);
}
/** A row reads its provider's installation itself; the detail shares the same requests. */
function ListedProvider({
serverId,
entry,
label,
toggling,
onOpen,
onToggle,
}: {
serverId: string;
entry: ProviderEntry;
label: string;
toggling: boolean;
onOpen: (provider: string) => void;
onToggle: (provider: string, enabled: boolean) => void;
}) {
const installation = useProviderInstallation({
serverId,
provider: entry.provider,
visible: true,
});
const icon = useMemo(
() => <ProviderGlyph serverId={serverId} provider={entry.provider} />,
[entry.provider, serverId],
);
return (
<ProviderRow
provider={entry.provider}
label={label}
icon={icon}
summary={readRowSummary(entry, installation)}
enabled={entry.enabled}
toggling={toggling}
onOpen={onOpen}
onToggle={onToggle}
/>
);
}
const SKELETON_ROW_KEYS = [0, 1, 2, 3].map((index) => `provider-skeleton-row-${index}`);
function ProviderRowsSkeleton() {
const { t } = useTranslation();
const pulse = useSkeletonPulse();
return (
<View
style={settingsStyles.card}
accessibilityLabel={t("settings.providers.loading")}
testID="providers-skeleton"
>
{SKELETON_ROW_KEYS.map((key, index) => (
<View key={key} style={[settingsStyles.row, index > 0 && settingsStyles.rowBorder]}>
<View style={styles.skeletonContent}>
<SkeletonPulse pulse={pulse} style={styles.skeletonIcon} />
<SkeletonPulse pulse={pulse} style={styles.skeletonTitle} />
</View>
<SkeletonPulse pulse={pulse} style={styles.skeletonSwitch} />
</View>
))}
</View>
);
}
const styles = StyleSheet.create((theme) => ({
skeletonContent: {
flex: 1,
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[3],
},
skeletonIcon: {
width: 16,
height: 16,
borderRadius: theme.borderRadius.md,
backgroundColor: theme.colors.surface2,
},
skeletonTitle: {
width: 160,
height: 12,
borderRadius: theme.borderRadius.sm,
backgroundColor: theme.colors.surface2,
},
skeletonSwitch: {
width: 36,
height: 20,
borderRadius: theme.borderRadius.full,
backgroundColor: theme.colors.surface2,
},
}));
@@ -0,0 +1,444 @@
import { Plus, Trash2 } from "lucide-react-native";
import { useCallback, useEffect, useMemo, useRef, useState } from "react";
import { useTranslation } from "react-i18next";
import { Text, View } from "react-native";
import { StyleSheet, withUnistyles } from "react-native-unistyles";
import type { AgentModelDefinition, AgentProvider } from "@getpaseo/protocol/agent-types";
import type { ProviderProfileModel } from "@getpaseo/protocol/provider-config";
import { compareMatchScores, scoreTextFields } from "@getpaseo/protocol/search/text-match";
import {
AdaptiveModalSheet,
AdaptiveTextInput,
type SheetHeader,
} from "@/components/adaptive-modal-sheet";
import { SettingsSection } from "@/components/settings";
import { Button } from "@/components/ui/button";
import { ToolbarButton, paneContentToolbarIconSize } from "@/components/ui/pane-content-toolbar";
import { SearchField } from "@/components/ui/search-field";
import { useIsCompactFormFactor } from "@/constants/layout";
import { isWeb } from "@/constants/platform";
import { useDaemonConfig } from "@/hooks/use-daemon-config";
import { CODE_SURFACE_DATASET } from "@/styles/code-surface";
import { settingsStyles } from "@/styles/settings";
import type { Theme } from "@/styles/theme";
import {
resolveProviderDiscoveredModels,
type ProviderDiscoveredModelsCache,
} from "./discovered-models";
import type { ProviderEntry } from "./provider-config";
const ThemedTrash = withUnistyles(Trash2);
const destructiveColorMapping = (theme: Theme) => ({ color: theme.colors.destructive });
const ThemedTextInput = withUnistyles(AdaptiveTextInput, (theme: Theme) => ({
placeholderTextColor: theme.colors.foregroundMuted,
}));
function rankModels<T>(items: T[], query: string, fields: (item: T) => string[]): T[] {
if (!query) return items;
const scored = items
.map((item) => ({ item, score: scoreTextFields(query, fields(item)) }))
.filter(
(entry): entry is { item: T; score: NonNullable<typeof entry.score> } => entry.score !== null,
);
scored.sort((a, b) => compareMatchScores(a.score, b.score));
return scored.map((entry) => entry.item);
}
/**
* A provider's models: search, the ones it reports, and the ones added by hand. The caller decides
* whether it appears and whether the provider's own models are listed.
*/
export function ProviderModels({
serverId,
entry,
discovered,
refresh,
}: {
serverId: string;
entry: ProviderEntry;
/** List the models the provider reports, with search. Only a running provider reports them. */
discovered: boolean;
refresh: (providers?: AgentProvider[]) => Promise<void>;
}) {
const { t } = useTranslation();
const provider = entry.provider;
const { config, patchConfig } = useDaemonConfig(serverId);
const [query, setQuery] = useState("");
const [addSheetOpen, setAddSheetOpen] = useState(false);
const [deletingModelId, setDeletingModelId] = useState<string | null>(null);
const additionalModels = useMemo(
() => config?.providers?.[provider]?.additionalModels ?? [],
[config?.providers, provider],
);
const loading = entry.status === "loading";
// A refresh briefly empties the snapshot's models; keep the last list on screen meanwhile.
const discoveredCacheRef = useRef<ProviderDiscoveredModelsCache | null>(null);
const { models: discoveredModels, cache } = resolveProviderDiscoveredModels({
serverId,
provider,
currentModels: entry.models,
providerSnapshotRefreshing: loading,
previousCache: discoveredCacheRef.current,
});
discoveredCacheRef.current = cache;
// Search shows only beside the provider's own models; a query typed then must not hide custom ones.
const q = discovered ? query.trim() : "";
const filteredDiscovered = useMemo(
() => rankModels(discoveredModels, q, (m) => [m.label, m.id, m.description ?? ""]),
[discoveredModels, q],
);
const filteredCustom = useMemo(
() => rankModels(additionalModels, q, (m) => [m.label, m.id]),
[additionalModels, q],
);
const handleOpenAddSheet = useCallback(() => setAddSheetOpen(true), []);
const handleCloseAddSheet = useCallback(() => setAddSheetOpen(false), []);
const handleDeleteCustom = useCallback(
(modelId: string) => {
setDeletingModelId(modelId);
void patchConfig({
providers: {
[provider]: {
additionalModels: additionalModels.filter((model) => model.id !== modelId),
},
},
})
.then(() => refresh([provider]))
.finally(() => {
setDeletingModelId((current) => (current === modelId ? null : current));
});
},
[additionalModels, patchConfig, provider, refresh],
);
const customTrailing = useMemo(
() => (
<View style={styles.headerTrailing}>
{additionalModels.length > 0 ? (
<Text style={settingsStyles.sectionHeaderTitle}>{additionalModels.length}</Text>
) : null}
<Button
variant="ghost"
leftIcon={Plus}
onPress={handleOpenAddSheet}
accessibilityLabel={t("settings.providers.models.addModel")}
testID="provider-add-model"
/>
</View>
),
[additionalModels.length, handleOpenAddSheet, t],
);
const discoveredTrailing = useMemo(
() =>
discoveredModels.length > 0 ? (
<Text style={settingsStyles.sectionHeaderTitle}>{discoveredModels.length}</Text>
) : null,
[discoveredModels.length],
);
let discoveredBody: React.ReactNode;
if (discoveredModels.length === 0) {
discoveredBody = (
<MutedRow>
{loading
? t("settings.providers.models.loading")
: t("settings.providers.models.noneDetected")}
</MutedRow>
);
} else if (filteredDiscovered.length === 0) {
discoveredBody = <MutedRow>{t("settings.providers.models.noSearchMatches")}</MutedRow>;
} else {
discoveredBody = filteredDiscovered.map((model, index) => (
<DiscoveredModelRow key={model.id} model={model} first={index === 0} />
));
}
let customBody: React.ReactNode;
if (additionalModels.length === 0) {
customBody = <MutedRow>{t("settings.providers.models.noCustom")}</MutedRow>;
} else if (filteredCustom.length === 0) {
customBody = <MutedRow>{t("settings.providers.models.noSearchMatches")}</MutedRow>;
} else {
customBody = filteredCustom.map((model, index) => (
<CustomModelRow
key={model.id}
model={model}
first={index === 0}
deleting={deletingModelId === model.id}
onDelete={handleDeleteCustom}
/>
));
}
return (
<View testID="provider-models">
{discovered ? (
<>
<View style={styles.searchRail}>
<SearchField
value={query}
onChangeText={setQuery}
placeholder={t("settings.providers.models.searchPlaceholder")}
clearAccessibilityLabel={t("sessions.actions.clearSearch")}
testID="provider-settings-search"
/>
</View>
<SettingsSection
title={t("settings.providers.models.discovered")}
trailing={discoveredTrailing}
>
<View style={settingsStyles.card}>{discoveredBody}</View>
</SettingsSection>
</>
) : null}
<SettingsSection title={t("settings.providers.models.custom")} trailing={customTrailing}>
<View style={settingsStyles.card}>{customBody}</View>
</SettingsSection>
<AddCustomModelSheet
serverId={serverId}
provider={provider}
additionalModels={additionalModels}
visible={addSheetOpen}
onClose={handleCloseAddSheet}
refresh={refresh}
/>
</View>
);
}
function MutedRow({ children }: { children: string }) {
return (
<View style={styles.modelRow}>
<Text style={settingsStyles.sectionHeaderTitle}>{children}</Text>
</View>
);
}
function DiscoveredModelRow({ model, first }: { model: AgentModelDefinition; first: boolean }) {
return (
<View style={[styles.modelRow, !first && settingsStyles.rowBorder]}>
<Text style={styles.modelTitle} numberOfLines={1}>
{model.label}
</Text>
<Text style={styles.monoHint} numberOfLines={1} selectable dataSet={CODE_SURFACE_DATASET}>
{model.id}
</Text>
{model.description ? (
<Text style={styles.descriptionInline} numberOfLines={1}>
{model.description}
</Text>
) : null}
</View>
);
}
function CustomModelRow({
model,
first,
deleting,
onDelete,
}: {
model: ProviderProfileModel;
first: boolean;
deleting: boolean;
onDelete: (modelId: string) => void;
}) {
const { t } = useTranslation();
const compact = useIsCompactFormFactor();
const handleDelete = useCallback(() => onDelete(model.id), [model.id, onDelete]);
return (
<View style={[styles.modelRow, !first && settingsStyles.rowBorder]}>
<Text style={[styles.modelTitle, styles.customModelText]} numberOfLines={1}>
{model.label}
</Text>
<Text
style={[styles.monoHint, styles.customModelText]}
numberOfLines={1}
selectable
dataSet={CODE_SURFACE_DATASET}
>
{model.id}
</Text>
<View style={styles.modelRowFiller} />
<ToolbarButton
label={t("settings.providers.models.removeModel", { id: model.id })}
onPress={handleDelete}
disabled={deleting}
compact={compact}
>
<ThemedTrash
size={paneContentToolbarIconSize(compact)}
uniProps={destructiveColorMapping}
/>
</ToolbarButton>
</View>
);
}
function AddCustomModelSheet({
serverId,
provider,
additionalModels,
visible,
onClose,
refresh,
}: {
serverId: string;
provider: string;
additionalModels: ProviderProfileModel[];
visible: boolean;
onClose: () => void;
refresh: (providers?: AgentProvider[]) => Promise<void>;
}) {
const { t } = useTranslation();
const { patchConfig } = useDaemonConfig(serverId);
const [input, setInput] = useState("");
const [error, setError] = useState<string | null>(null);
const [saving, setSaving] = useState(false);
const trimmed = input.trim();
const canAdd = trimmed.length > 0 && !additionalModels.some((model) => model.id === trimmed);
useEffect(() => {
if (!visible) {
setInput("");
setError(null);
}
}, [visible]);
const handleAdd = useCallback(() => {
if (!canAdd) return;
setError(null);
setSaving(true);
void patchConfig({
providers: {
[provider]: {
additionalModels: [...additionalModels, { id: trimmed, label: trimmed }],
},
},
})
.then(() => refresh([provider]))
.then(() => onClose())
.catch((err: unknown) => {
setError(err instanceof Error ? err.message : t("settings.providers.models.failedToSave"));
})
.finally(() => setSaving(false));
}, [additionalModels, canAdd, onClose, patchConfig, provider, refresh, t, trimmed]);
const header = useMemo<SheetHeader>(
() => ({ title: t("settings.providers.models.addCustomTitle") }),
[t],
);
return (
<AdaptiveModalSheet
header={header}
visible={visible}
onClose={onClose}
desktopMaxWidth={420}
snapPoints={ADD_SNAP_POINTS}
testID="add-custom-model-sheet"
>
<View style={styles.formGroup}>
<Text style={styles.formLabel}>{t("settings.providers.models.modelId")}</Text>
<ThemedTextInput
initialValue={input}
resetKey={`add-custom-${visible}`}
onChangeText={setInput}
onSubmitEditing={handleAdd}
placeholder={t("settings.providers.models.modelIdPlaceholder")}
autoCapitalize="none"
autoCorrect={false}
returnKeyType="done"
// @ts-expect-error - outlineStyle is web-only
style={[styles.formInput, isWeb && { outlineStyle: "none" }]}
/>
{error ? <Text style={styles.errorText}>{error}</Text> : null}
<View style={styles.formActions}>
<Button variant="secondary" onPress={onClose} disabled={saving}>
{t("common.actions.cancel")}
</Button>
<Button variant="default" onPress={handleAdd} disabled={!canAdd} loading={saving}>
{saving ? t("settings.providers.models.adding") : t("settings.providers.models.add")}
</Button>
</View>
</View>
</AdaptiveModalSheet>
);
}
const ADD_SNAP_POINTS = ["40%"];
const styles = StyleSheet.create((theme) => ({
searchRail: {
flexDirection: "row",
marginBottom: theme.spacing[3],
},
headerTrailing: {
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[1],
},
modelRow: {
flexDirection: "row",
alignItems: "center",
paddingVertical: theme.spacing[2],
paddingHorizontal: theme.spacing[4],
gap: theme.spacing[3],
},
modelTitle: {
color: theme.colors.foreground,
fontSize: theme.fontSize.base,
flexShrink: 0,
},
monoHint: {
fontFamily: theme.fontFamily.mono,
fontSize: theme.fontSize.code,
color: theme.colors.foregroundMuted,
flexShrink: 0,
},
descriptionInline: {
flex: 1,
fontSize: theme.fontSize.sm,
color: theme.colors.foregroundMuted,
},
customModelText: {
flexShrink: 1,
minWidth: 0,
},
modelRowFiller: {
flex: 1,
},
formGroup: {
gap: theme.spacing[3],
},
formLabel: {
fontSize: theme.fontSize.base,
fontWeight: theme.fontWeight.medium,
color: theme.colors.foreground,
},
formInput: {
backgroundColor: theme.colors.surface2,
borderRadius: theme.borderRadius.lg,
paddingHorizontal: theme.spacing[4],
paddingVertical: theme.spacing[3],
color: theme.colors.foreground,
borderWidth: 1,
borderColor: theme.colors.border,
fontSize: theme.fontSize.base,
},
errorText: {
fontSize: theme.fontSize.sm,
color: theme.colors.destructive,
},
formActions: {
flexDirection: "row",
justifyContent: "flex-end",
gap: theme.spacing[2],
},
}));
@@ -0,0 +1,23 @@
import { Text, View } from "react-native";
import { StyleSheet } from "react-native-unistyles";
import { settingsStyles } from "@/styles/settings";
/** A card holding one muted line, where a provider list or page has nothing to show yet. */
export function ProviderNotice({ message, testID }: { message: string; testID?: string }) {
return (
<View style={[settingsStyles.card, styles.card]} testID={testID}>
<Text style={styles.text}>{message}</Text>
</View>
);
}
const styles = StyleSheet.create((theme) => ({
card: {
padding: theme.spacing[4],
alignItems: "center",
},
text: {
color: theme.colors.foregroundMuted,
fontSize: theme.fontSize.base,
},
}));
@@ -0,0 +1,178 @@
import React, { act } from "react";
import { createRoot, type Root } from "react-dom/client";
import { within } from "@testing-library/dom";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { Text } from "react-native";
import { i18n as testI18n } from "@/i18n/i18next";
import { ProviderRow } from "./provider-row";
import type { RowSummary } from "./row-summary";
// Load translations so rows expose their real accessible names and copy.
void testI18n;
// App sources compile against the classic JSX runtime, which expects React on the global.
beforeEach(() => vi.stubGlobal("React", React));
const mounted: { root: Root; container: HTMLDivElement }[] = [];
afterEach(() => {
for (const entry of mounted.splice(0)) {
act(() => entry.root.unmount());
entry.container.remove();
}
});
const ICON = <Text testID="provider-icon">*</Text>;
function mount(summary: RowSummary, options: { enabled?: boolean; label?: string } = {}) {
const onOpen = vi.fn();
const onToggle = vi.fn();
const label = options.label ?? "Claude";
const container = document.createElement("div");
document.body.appendChild(container);
const root = createRoot(container);
act(() =>
root.render(
<ProviderRow
provider="claude"
label={label}
icon={ICON}
summary={summary}
enabled={options.enabled ?? true}
toggling={false}
onOpen={onOpen}
onToggle={onToggle}
/>,
),
);
mounted.push({ root, container });
const view = within(container);
return {
view,
onOpen,
onToggle,
row: () => view.getByTestId("provider-row-claude"),
opener: () => view.getByRole("button", { name: `${label} provider details` }),
toggle: () => view.queryByRole("switch", { name: `Enable ${label}` }),
};
}
function pressEnter(target: HTMLElement) {
target.focus();
for (const type of ["keydown", "keyup"]) {
target.dispatchEvent(
new KeyboardEvent(type, { key: "Enter", bubbles: true, cancelable: true }),
);
}
}
function textOrder(row: HTMLElement, texts: string[]): number[] {
const content = row.textContent ?? "";
return texts.map((text) => content.indexOf(text));
}
describe("provider row", () => {
it("names the provider with its label and says Disabled when it is off", () => {
const row = mount({ kind: "disabled" }, { enabled: false, label: "Codex" });
expect(row.row().textContent).toContain("Codex");
expect(row.view.getByText("Disabled")).toBeTruthy();
expect(row.toggle()?.getAttribute("aria-checked")).toBe("false");
});
it("composes the row as icon, label, version and models, then switch", () => {
const row = mount({ kind: "ready", version: "2.1.321", models: 3 });
const element = row.row();
expect(row.view.getByText("2.1.321 · 3 models")).toBeTruthy();
const [icon, label, summary] = textOrder(element, ["*", "Claude", "2.1.321 · 3 models"]);
expect(icon).toBeLessThan(label);
expect(label).toBeLessThan(summary);
const toggle = row.toggle();
expect(toggle).not.toBeNull();
expect(
row.view.getByText("2.1.321 · 3 models").compareDocumentPosition(toggle as Node) &
Node.DOCUMENT_POSITION_FOLLOWING,
).toBeTruthy();
});
it("asks its host to open the provider when the row is pressed", () => {
const row = mount({ kind: "disabled" }, { enabled: false });
act(() => row.opener().click());
expect(row.onOpen).toHaveBeenCalledWith("claude");
});
it("keeps the switch out of the row's button, so Enter on the switch only toggles", () => {
const row = mount({ kind: "ready", version: null, models: 3 });
const toggle = row.toggle() as HTMLElement;
expect(row.opener().contains(toggle)).toBe(false);
// Dispatched in one act, so the test ends before the Switch's animation runs a frame.
act(() => pressEnter(toggle));
expect(row.onToggle).toHaveBeenCalledWith("claude", false);
expect(row.onOpen).not.toHaveBeenCalled();
});
it("toggles the provider from the switch without opening it", () => {
const row = mount({ kind: "ready", version: null, models: 3 });
act(() => row.toggle()?.click());
expect(row.onToggle).toHaveBeenCalledWith("claude", false);
expect(row.onOpen).not.toHaveBeenCalled();
});
it("leaves the state line readable to screen readers, and the name to the row's button", () => {
const row = mount({ kind: "failing", message: "opencode exited with code 1" });
expect(row.view.getByText("opencode exited with code 1").closest("[aria-hidden]")).toBeNull();
expect(row.view.getByText("Claude").closest("[aria-hidden]")).not.toBeNull();
});
it("says an update is available after the version", () => {
const row = mount({ kind: "updateAvailable", version: "2.1.321" });
expect(row.view.getByText("2.1.321 · Update available")).toBeTruthy();
});
it("names the target while an update runs, or says Updating... without one", () => {
expect(
mount({ kind: "updating", target: "1.0.31" }).view.getByText("Updating to 1.0.31..."),
).toBeTruthy();
expect(mount({ kind: "updating", target: null }).view.getByText("Updating...")).toBeTruthy();
});
it("shows the error in the hint", () => {
const row = mount({ kind: "failing", message: "opencode exited with code 1" });
expect(row.view.getByText("opencode exited with code 1")).toBeTruthy();
expect(row.toggle()).not.toBeNull();
});
it("offers no switch on a provider that is not installed", () => {
const row = mount({ kind: "notInstalled" });
expect(row.view.getByText("Not installed")).toBeTruthy();
expect(row.toggle()).toBeNull();
act(() => row.opener().click());
expect(row.onOpen).toHaveBeenCalledWith("claude");
});
it("keeps the row as tall while its line loads as once it has arrived", () => {
const pending = mount({ kind: "pending" }).row().getBoundingClientRect().height;
const ready = mount({ kind: "ready", version: "2.1.321", models: 3 })
.row()
.getBoundingClientRect().height;
const updating = mount({ kind: "updating", target: "1.0.31" })
.row()
.getBoundingClientRect().height;
const failing = mount({ kind: "failing", message: "boom" })
.row()
.getBoundingClientRect().height;
expect(pending).toBe(ready);
expect(updating).toBe(ready);
expect(failing).toBe(ready);
});
it("keeps a long, multi-line error to the row's one line", () => {
const ready = mount({ kind: "ready", version: "2.1.321", models: 3 })
.row()
.getBoundingClientRect().height;
const message = [
"ACP agent process exited before initialization completed (exit code 1)",
"broken-acp: exited with code 1",
].join("\n");
const failing = mount({ kind: "failing", message }).row().getBoundingClientRect().height;
expect(failing).toBe(ready);
});
});
@@ -0,0 +1,110 @@
import type { TFunction } from "i18next";
import { useCallback, useMemo, type ReactNode } from "react";
import { useTranslation } from "react-i18next";
import { SettingsDetailRow, type SettingsRowHintStatus } from "@/components/settings";
import { Switch } from "@/components/ui/switch";
import { rowHasSwitch, type RowSummary } from "./row-summary";
export interface ProviderRowProps {
provider: string;
label: string;
icon: ReactNode;
summary: RowSummary;
enabled: boolean;
/** The Enabled switch is being saved. */
toggling: boolean;
onOpen: (provider: string) => void;
onToggle: (provider: string, enabled: boolean) => void;
}
/**
* One provider in the list: its icon and name, a line saying how it is, the Enabled switch when
* there is something to switch, and the chevron to its detail.
*/
export function ProviderRow({
provider,
label,
icon,
summary,
enabled,
toggling,
onOpen,
onToggle,
}: ProviderRowProps) {
const { t } = useTranslation();
const handleOpen = useCallback(() => onOpen(provider), [onOpen, provider]);
const handleToggle = useCallback(
(value: boolean) => onToggle(provider, value),
[onToggle, provider],
);
const hint = describeRowSummary(summary, t);
const hasSwitch = rowHasSwitch(summary);
const toggle = useMemo(
() =>
hasSwitch ? (
<Switch
value={enabled}
onValueChange={handleToggle}
disabled={toggling}
accessibilityLabel={t("settings.providers.enableProvider", { name: label })}
/>
) : null,
[enabled, handleToggle, hasSwitch, label, t, toggling],
);
return (
<SettingsDetailRow
leading={icon}
label={label}
hint={hint.text}
hintStatus={hint.status}
control={toggle}
accessibilityLabel={t("settings.providers.providerDetails", { name: label })}
onPress={handleOpen}
testID={`provider-row-${provider}`}
/>
);
}
function describeRowSummary(
summary: RowSummary,
t: TFunction,
): { text: string | undefined; status: SettingsRowHintStatus | undefined } {
switch (summary.kind) {
case "pending":
return { text: undefined, status: "pending" };
case "ready": {
const models =
summary.models === 1
? t("settings.providers.models.one")
: t("settings.providers.models.many", { count: summary.models });
const parts = [summary.version, summary.models > 0 ? models : null].filter(Boolean);
return {
text: parts.length ? parts.join(" · ") : t("settings.providers.statuses.available"),
status: undefined,
};
}
case "updateAvailable":
return {
text: [summary.version, t("settings.providers.installation.updateAvailable")]
.filter(Boolean)
.join(" · "),
status: undefined,
};
case "updating":
return {
text: summary.target
? t("settings.providers.list.updatingTo", { version: summary.target })
: t("settings.providers.installation.updating"),
status: "busy",
};
case "failing":
return {
text: summary.message ?? t("settings.providers.diagnostic.unknownError"),
status: "error",
};
case "notInstalled":
return { text: t("settings.providers.statuses.notInstalled"), status: undefined };
case "disabled":
return { text: t("settings.providers.statuses.disabled"), status: undefined };
}
}
@@ -0,0 +1,191 @@
import { describe, expect, it } from "vitest";
import type { ProviderInstallationUpdate } from "@getpaseo/protocol/messages";
import type { ProviderSnapshotEntry } from "@getpaseo/protocol/agent-types";
import type { ProviderInstallationRead } from "@/components/provider-installation";
import { readRowSummary } from "./row-summary";
type Read = Pick<ProviderInstallationRead, "state" | "updates" | "action">;
function entry(overrides: Partial<ProviderSnapshotEntry> = {}): ProviderSnapshotEntry {
return {
provider: "claude",
label: "Claude",
status: "ready",
enabled: true,
modes: [],
models: [
{ provider: "claude", id: "opus", label: "Opus" },
{ provider: "claude", id: "sonnet", label: "Sonnet" },
],
...overrides,
};
}
function installed(version: string | undefined, overrides: Partial<Read> = {}): Read {
return {
state: {
status: "ready",
installation: { inspection: { status: "installed", version }, canUpdate: true },
},
updates: { status: "ready", updateCheck: { status: "current" } },
action: { current: null, starting: false, startError: null, start: () => undefined },
...overrides,
};
}
function update(operation: ProviderInstallationUpdate["operation"]): ProviderInstallationUpdate {
return { operation, output: [] };
}
const oldHost: Read = {
state: { status: "unsupported" },
updates: { status: "hidden" },
action: undefined,
};
describe("provider row summary", () => {
it("reads version and model count for a provider that runs", () => {
expect(readRowSummary(entry(), installed("2.1.321"))).toEqual({
kind: "ready",
version: "2.1.321",
models: 2,
});
});
it("says an update is available after the version", () => {
const read = installed("2.1.321", {
updates: { status: "ready", updateCheck: { status: "available", versions: ["2.1.400"] } },
});
expect(readRowSummary(entry(), read)).toEqual({ kind: "updateAvailable", version: "2.1.321" });
});
it("names the target version while an update runs, when the check reported one", () => {
const running = update({ status: "running", id: "u1", startedAt: "2026-11-14T10:00:00Z" });
const one = installed("1.0.30", {
updates: { status: "ready", updateCheck: { status: "available", versions: ["1.0.31"] } },
action: { current: running, starting: false, startError: null, start: () => undefined },
});
expect(readRowSummary(entry(), one)).toEqual({ kind: "updating", target: "1.0.31" });
const unknown = installed("1.0.30", {
updates: { status: "ready", updateCheck: { status: "available" } },
action: { current: null, starting: true, startError: null, start: () => undefined },
});
expect(readRowSummary(entry(), unknown)).toEqual({ kind: "updating", target: null });
});
it("reports a failed update as the fault", () => {
const failed = update({
status: "failed",
id: "u1",
startedAt: "2026-11-14T10:00:00Z",
finishedAt: "2026-11-14T10:01:00Z",
message: "npm exited with code 1",
});
const read = installed("1.0.30", {
action: { current: failed, starting: false, startError: null, start: () => undefined },
});
expect(readRowSummary(entry(), read)).toEqual({
kind: "failing",
message: "npm exited with code 1",
});
});
it("reads the provider's own state once Refresh drops a failed update", () => {
const failed = update({
status: "failed",
id: "u1",
startedAt: "2026-11-14T10:00:00Z",
finishedAt: "2026-11-14T10:01:00Z",
message: "npm exited with code 1",
});
const stillFailed = { current: failed, starting: false, startError: null, start: () => {} };
// A fresh inspection alone leaves the failure: reopening without Refresh still shows it.
expect(readRowSummary(entry(), installed("2.1.400", { action: stillFailed }))).toEqual({
kind: "failing",
message: "npm exited with code 1",
});
// Refresh drops the failed update, so the row has no current update to report.
const cleared = { current: null, starting: false, startError: null, start: () => {} };
expect(readRowSummary(entry(), installed("2.1.400", { action: cleared }))).toEqual({
kind: "ready",
version: "2.1.400",
models: 2,
});
const pending = installed("2.1.321", {
updates: { status: "ready", updateCheck: { status: "available", versions: ["2.1.400"] } },
action: cleared,
});
expect(readRowSummary(entry(), pending)).toEqual({
kind: "updateAvailable",
version: "2.1.321",
});
});
it("reports the provider's error", () => {
expect(
readRowSummary(entry({ status: "error", error: " opencode exited with code 1 " }), oldHost),
).toEqual({ kind: "failing", message: "opencode exited with code 1" });
expect(readRowSummary(entry({ status: "error" }), oldHost)).toEqual({
kind: "failing",
message: null,
});
});
it("calls a missing CLI Not installed, not a fault", () => {
expect(readRowSummary(entry({ status: "unavailable" }), oldHost)).toEqual({
kind: "notInstalled",
});
const missing: Read = {
...oldHost,
state: { status: "ready", installation: { inspection: { status: "not_installed" } } },
};
expect(readRowSummary(entry({ status: "error", error: "spawn ENOENT" }), missing)).toEqual({
kind: "notInstalled",
});
});
it("says Disabled for a provider that is off", () => {
expect(readRowSummary(entry({ enabled: false }), installed("2.1.321"))).toEqual({
kind: "disabled",
});
});
it("calls a disabled provider whose CLI is missing Not installed, so turning it on changes nothing", () => {
const missing: Read = {
...oldHost,
state: { status: "ready", installation: { inspection: { status: "not_installed" } } },
};
expect(readRowSummary(entry({ enabled: false, status: "unavailable" }), missing)).toEqual({
kind: "notInstalled",
});
// A disabled provider is never probed, so without an inspection it is only Disabled.
expect(readRowSummary(entry({ enabled: false, status: "unavailable" }), oldHost)).toEqual({
kind: "disabled",
});
});
it("holds the line until the installation is read", () => {
const reading: Read = { ...oldHost, state: { status: "loading" } };
expect(readRowSummary(entry(), reading)).toEqual({ kind: "pending" });
});
it("holds the line while the provider's first probe runs", () => {
expect(readRowSummary(entry({ status: "loading", models: [] }), oldHost)).toEqual({
kind: "pending",
});
});
it("keeps the last count while the provider is probed again", () => {
expect(readRowSummary(entry({ status: "loading" }), installed("2.1.321"))).toEqual({
kind: "ready",
version: "2.1.321",
models: 2,
});
});
it("reads a count alone on hosts that cannot report installations", () => {
expect(readRowSummary(entry(), oldHost)).toEqual({ kind: "ready", version: null, models: 2 });
});
});
@@ -0,0 +1,69 @@
import type { ProviderInstallationRead } from "@/components/provider-installation";
import { filterSelectableModels } from "@/provider-selection/model-catalog";
import type { ProviderEntry } from "./provider-config";
/** What a provider's list row says under its name. */
export type RowSummary =
/** Not known yet; the row holds the line's space. */
| { kind: "pending" }
| { kind: "ready"; version: string | null; models: number }
| { kind: "updateAvailable"; version: string | null }
| { kind: "updating"; target: string | null }
/** The provider or its last update failed. A null message has no detail to show. */
| { kind: "failing"; message: string | null }
| { kind: "notInstalled" }
| { kind: "disabled" };
type InstallationFacts = Pick<ProviderInstallationRead, "state" | "updates" | "action">;
/**
* One line per provider, from the snapshot and the installation read. A running update leads
* because the user just started it; then whatever keeps the provider from running, where a missing
* CLI is not a fault; then the version and update state once the host has answered.
*/
export function readRowSummary(entry: ProviderEntry, facts: InstallationFacts): RowSummary {
return readRunningUpdate(facts) ?? readBlocker(entry, facts) ?? readSettled(entry, facts);
}
function readRunningUpdate({ updates, action }: InstallationFacts): RowSummary | null {
if (!action || !(action.starting || action.current?.operation.status === "running")) return null;
const updateCheck = updates.status === "ready" ? updates.updateCheck : null;
const versions = updateCheck?.status === "available" ? updateCheck.versions : undefined;
return { kind: "updating", target: versions?.length === 1 ? versions[0] : null };
}
function readBlocker(
entry: ProviderEntry,
{ state, action }: InstallationFacts,
): RowSummary | null {
// A missing CLI wins over Disabled, so the row offers no switch that turning on would take away.
// Without an inspection a disabled provider is only Disabled: the host never probes it.
const inspection = state.status === "ready" ? state.installation?.inspection : undefined;
if (inspection?.status === "not_installed") return { kind: "notInstalled" };
if (!entry.enabled) return { kind: "disabled" };
if (entry.status === "unavailable") return { kind: "notInstalled" };
if (entry.status === "error") return { kind: "failing", message: entry.error?.trim() || null };
const operation = action?.current?.operation;
if (operation?.status === "failed") {
return { kind: "failing", message: operation.message.trim() || null };
}
return null;
}
function readSettled(entry: ProviderEntry, { state, updates }: InstallationFacts): RowSummary {
const models = filterSelectableModels(entry.models ?? null)?.length ?? 0;
// The last count stays while the provider is probed again; only a first probe holds the line.
if (state.status === "loading" || (entry.status === "loading" && models === 0)) {
return { kind: "pending" };
}
const inspection = state.status === "ready" ? state.installation?.inspection : undefined;
const version = inspection?.status === "installed" ? (inspection.version ?? null) : null;
const updateCheck = updates.status === "ready" ? updates.updateCheck : null;
if (updateCheck?.status === "available") return { kind: "updateAvailable", version };
return { kind: "ready", version, models };
}
/** A provider that is not installed has nothing to switch: the picker leaves it out already. */
export function rowHasSwitch(summary: RowSummary): boolean {
return summary.kind !== "notInstalled";
}
@@ -0,0 +1,15 @@
import type { DimensionValue } from "react-native";
/**
* Where a provider sheet sits, decided by the surface that opens it. Setup passes its own card's
* size so the sheet covers the card exactly and reads as a page of setup.
*/
export interface ProviderSheetFrame {
desktopMaxWidth?: number;
desktopHeight?: DimensionValue;
snapPoints?: string[];
/** A back arrow replaces the close button: the sheet stands in for a page of the surface below. */
returns?: boolean;
}
export const OVERLAY_SHEET_FRAME: ProviderSheetFrame = { snapPoints: ["65%", "92%"] };
@@ -1008,7 +1008,9 @@ export function openScheduleForm(snapshot: ScheduleFormSnapshot): ScheduleFormMo
}
publish({
...resolved,
modelSelectorProviders: buildSelectableProviderSelectorProviders(providerEntries),
modelSelectorProviders: buildSelectableProviderSelectorProviders(providerEntries, {
selectedProvider: resolved.selectedProvider,
}),
providerResolutionByServerId,
providerSnapshotRequest: isPendingResolution ? null : state.providerSnapshotRequest,
});
@@ -5,7 +5,7 @@ import { Pressable, Text, View } from "react-native";
import { useFocusEffect } from "expo-router/react-navigation";
import { StyleSheet } from "react-native-unistyles";
import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { ArrowLeft, MoreVertical, Pencil, Plus } from "lucide-react-native";
import { MoreVertical, Pencil, Plus } from "lucide-react-native";
import { ProjectIconView } from "@/components/project-icon-view";
import type {
PaseoConfigRaw,
@@ -29,6 +29,7 @@ import { EditingTextInput as TextInput } from "@/components/ui/text-input";
import { SettingsTextAreaCard } from "@/components/settings-textarea";
import { SettingsGroup } from "@/components/settings/headings/settings-group";
import { SettingsSection } from "@/components/settings/headings/settings-section";
import { SettingsBackLink, SettingsDetailHeader } from "@/components/settings";
import { settingsStyles } from "@/styles/settings";
import { useProjects } from "@/hooks/use-projects";
import type { ProjectEditFormSnapshot } from "@/projects/edit-form";
@@ -170,16 +171,11 @@ function NoEditableTarget({
function BackToProjectsButton({ onPress }: { onPress: () => void }) {
const { t } = useTranslation();
return (
<Button
testID="project-settings-back-link"
accessibilityLabel={t("settings.project.backToProjects")}
<SettingsBackLink
label={t("settings.project.backToProjects")}
onPress={onPress}
variant="ghost"
leftIcon={ArrowLeft}
style={styles.backButton}
>
{t("settings.project.backToProjects")}
</Button>
testID="project-settings-back-link"
/>
);
}
@@ -260,33 +256,51 @@ function ProjectSettingsBody({
const handleReload = useCallback(() => {
void readQuery.refetch();
}, [readQuery]);
const backLink = useMemo(
() =>
showBackToProjects
? {
label: t("settings.project.backToProjects"),
onPress: onBackToProjects,
testID: "project-settings-back-link",
}
: undefined,
[onBackToProjects, showBackToProjects, t],
);
const titleIcon = useMemo(
() => (
<ProjectTitleIcon
iconDataUri={projectIconDataUri}
projectName={selectedHost.projectName}
projectViewKey={project.viewKey}
/>
),
[project.viewKey, projectIconDataUri, selectedHost.projectName],
);
const editButton = useMemo(
() => (
<Pressable
testID="project-edit-button"
accessibilityRole="button"
accessibilityLabel={t("settings.project.edit.title")}
onPress={openEditSheet}
hitSlop={8}
style={styles.editButton}
>
<Pencil size={ICON_SIZE} color={styles.iconColor.color} />
</Pressable>
),
[openEditSheet, t],
);
return (
<View role="main" style={styles.body}>
{showBackToProjects ? <BackToProjectsButton onPress={onBackToProjects} /> : null}
<View style={styles.headerBlock}>
<View style={styles.titleRow}>
<ProjectTitleIcon
iconDataUri={projectIconDataUri}
projectName={selectedHost.projectName}
projectViewKey={project.viewKey}
/>
<Text style={styles.projectTitle} numberOfLines={1}>
{selectedHost.projectName}
</Text>
<Pressable
testID="project-edit-button"
accessibilityRole="button"
accessibilityLabel={t("settings.project.edit.title")}
onPress={openEditSheet}
hitSlop={8}
style={styles.editButton}
>
<Pencil size={ICON_SIZE} color={styles.iconColor.color} />
</Pressable>
</View>
</View>
<SettingsDetailHeader
back={backLink}
icon={titleIcon}
title={selectedHost.projectName}
trailing={editButton}
/>
<ProjectEditSheet
// A new instance per open seeds the form from the project as it stands now.
@@ -1108,26 +1122,6 @@ const styles = StyleSheet.create((theme) => ({
padding: theme.spacing[4],
gap: theme.spacing[2],
},
backButton: {
alignSelf: "flex-start",
paddingHorizontal: 0,
},
headerBlock: {
marginTop: theme.spacing[2],
marginBottom: theme.spacing[4],
gap: theme.spacing[2],
},
titleRow: {
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[3],
},
projectTitle: {
color: theme.colors.foreground,
fontSize: theme.fontSize.base,
fontWeight: theme.fontWeight.medium,
flexShrink: 1,
},
editButton: {
padding: theme.spacing[1],
},
+21 -3
View File
@@ -118,6 +118,7 @@ import { MetadataGenerationPage } from "@/screens/settings/metadata-generation-p
import { HostVoicePage } from "@/screens/settings/voice/voice-page";
import ProjectsScreen from "@/screens/projects-screen";
import ProjectSettingsScreen from "@/screens/project-settings-screen";
import { ProviderDetailPage } from "@/provider-settings";
import {
SETTINGS_DESKTOP_DETAIL_MIN_WIDTH,
SETTINGS_DESKTOP_SIDEBAR_WIDTH,
@@ -990,6 +991,7 @@ function SettingsSidebar({
let selectedHostSection: HostSectionSlug | null = null;
if (view.kind === "host") selectedHostSection = view.section;
if (view.kind === "project") selectedHostSection = "projects";
if (view.kind === "provider") selectedHostSection = "providers";
if (view.kind === "plugin" || view.kind === "pluginListing") selectedHostSection = "plugins";
const sidebarBody = (
@@ -1137,7 +1139,8 @@ export default function SettingsScreen({ view }: SettingsScreenProps) {
view.kind === "host" ||
view.kind === "project" ||
view.kind === "plugin" ||
view.kind === "pluginListing"
view.kind === "pluginListing" ||
view.kind === "provider"
)
return view.serverId;
return resolveActiveHostServerId({
@@ -1216,8 +1219,12 @@ export default function SettingsScreen({ view }: SettingsScreenProps) {
const handleSelectHost = useCallback(
(serverId: string) => {
selectSettingsHost(serverId);
if (view.kind === "project") {
const target = buildSettingsHostSectionRoute(serverId, "projects");
if (view.kind === "project" || view.kind === "provider") {
// The detail belongs to the old host; open the same list on the new one.
const target = buildSettingsHostSectionRoute(
serverId,
view.kind === "project" ? "projects" : "providers",
);
if (isCompactLayout) {
router.push(target);
} else {
@@ -1296,6 +1303,7 @@ export default function SettingsScreen({ view }: SettingsScreenProps) {
if (view.kind === "project") {
return t("settings.projects");
}
if (view.kind === "provider") return t("settings.hostSections.providers");
return undefined;
})();
@@ -1331,6 +1339,16 @@ export default function SettingsScreen({ view }: SettingsScreenProps) {
/>
);
}
if (view.kind === "provider") {
return (
<ProviderDetailPage
serverId={view.serverId}
provider={view.providerId}
onBack={handleBackFromDetail}
showBack={!isCompactLayout}
/>
);
}
if (view.kind === "section") {
const item = SIDEBAR_SECTION_ITEMS.find((candidate) => candidate.id === view.section);
if (!item || !isSectionAvailable(item, isDesktopApp, hardwareKeyboardPresent)) return null;
@@ -49,7 +49,8 @@ import {
useHostRuntimeSnapshot,
useHosts,
} from "@/runtime/host-runtime";
import { ProvidersSection } from "@/screens/settings/providers-section";
import { ProviderList } from "@/provider-settings";
import { openProviderSettings } from "@/navigation/settings-navigation";
import { HostUsageSection } from "@/usage";
import { HostAppearanceSection } from "@/screens/settings/host-appearance-section";
import { SettingsSection } from "@/components/settings/headings/settings-section";
@@ -334,6 +335,10 @@ export function HostWorkspacesPage({ serverId }: { serverId: string }) {
export function HostProvidersPage({ serverId }: { serverId: string }) {
const host = useHostProfile(serverId);
const openProvider = useCallback(
(providerId: string) => openProviderSettings(serverId, providerId),
[serverId],
);
if (!host) {
return <HostNotFound />;
@@ -341,7 +346,7 @@ export function HostProvidersPage({ serverId }: { serverId: string }) {
return (
<View>
<ProvidersSection serverId={serverId} />
<ProviderList serverId={serverId} onOpenProvider={openProvider} />
</View>
);
}
@@ -19,12 +19,15 @@ export function MetadataGenerationPage({ serverId }: { serverId: string }) {
const { t } = useTranslation();
const { config, isLoading: isConfigLoading, patchConfig } = useDaemonConfig(serverId);
const snapshot = useProvidersSnapshot(serverId);
const providers = useMemo(
() => buildSelectableProviderSelectorProviders(snapshot.entries),
[snapshot.entries],
);
const configuredProviders = config?.metadataGeneration.providers;
const configuredProvider = configuredProviders?.[0] ?? null;
const providers = useMemo(
() =>
buildSelectableProviderSelectorProviders(snapshot.entries, {
selectedProvider: configuredProvider?.provider ?? null,
}),
[configuredProvider?.provider, snapshot.entries],
);
const savedMode: SelectionMode = configuredProvider ? "preferred" : "automatic";
const [draftMode, setDraftMode] = useState<SelectionMode | null>(null);
const [isSaving, setIsSaving] = useState(false);
@@ -1,453 +0,0 @@
/**
* @vitest-environment jsdom
*/
import React, { act } from "react";
import { createRoot, type Root } from "react-dom/client";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import type { ProviderSnapshotEntry } from "@getpaseo/protocol/agent-types";
import type { MutableDaemonConfig } from "@getpaseo/protocol/messages";
import { ToastApiProvider } from "@/contexts/toast-api-context";
const { snapshotState, configState, patchConfigMock, openProviderSettingsMock } = vi.hoisted(
() => ({
snapshotState: {
entries: undefined as ProviderSnapshotEntry[] | undefined,
isLoading: false,
isRefreshing: false,
},
configState: {
config: null as MutableDaemonConfig | null,
},
patchConfigMock: vi.fn(async () => undefined),
openProviderSettingsMock: vi.fn(),
}),
);
vi.mock("react-native", async (importOriginal) => ({
...(await importOriginal<typeof import("react-native")>()),
View: ({ children, testID }: { children?: React.ReactNode; testID?: string }) =>
React.createElement("div", { "data-testid": testID }, children),
Text: ({ children }: { children?: React.ReactNode }) =>
React.createElement("span", null, children),
Pressable: ({
children,
onPress,
onHoverIn,
onHoverOut,
accessibilityRole,
accessibilityLabel,
disabled,
testID,
}: {
children?:
| React.ReactNode
| ((state: { pressed: boolean; hovered: boolean }) => React.ReactNode);
onPress?: (event: React.MouseEvent) => void;
onHoverIn?: () => void;
onHoverOut?: () => void;
accessibilityRole?: string;
accessibilityLabel?: string;
disabled?: boolean;
testID?: string;
}) =>
React.createElement(
"div",
{
role: accessibilityRole,
"aria-label": accessibilityLabel,
"aria-disabled": disabled ? "true" : undefined,
"data-testid": testID,
onClick: disabled ? undefined : onPress,
onMouseEnter: onHoverIn,
onMouseLeave: onHoverOut,
},
typeof children === "function" ? children({ pressed: false, hovered: false }) : children,
),
ActivityIndicator: () => React.createElement("span", { "data-testid": "activity-indicator" }),
}));
vi.mock("lucide-react-native", () => {
const icon = (name: string) => () => React.createElement("span", { "data-icon": name });
return {
ChevronRight: icon("ChevronRight"),
MoreHorizontal: icon("MoreHorizontal"),
Trash2: icon("Trash2"),
};
});
vi.mock("react-i18next", () => ({
useTranslation: () => ({
t: (key: string, values?: Record<string, string | number>) =>
(
({
"settings.providers.providerDetails": "{{name}} provider details",
"settings.providers.enableProvider": "Enable {{name}}",
"settings.providers.statuses.disabled": "Disabled",
"settings.providers.statuses.available": "Available",
"settings.providers.statuses.loading": "Loading",
"settings.providers.statuses.error": "Error",
"settings.providers.statuses.notInstalled": "Not installed",
"settings.providers.models.one": "1 model",
"settings.providers.models.many": "{{count}} models",
"settings.providers.addErrorTitle": "Unable to add provider",
"settings.providers.updateErrorTitle": "Unable to update provider",
"settings.providers.actions.menu": "{{name}} actions",
"settings.providers.actions.remove": "Remove provider",
"settings.providers.actions.removing": "Removing...",
"settings.providers.remove.confirmTitle": "Remove {{name}}?",
"settings.providers.remove.confirmMessage":
"This deletes the provider entry from config.json. It cannot be undone.",
"settings.providers.remove.confirm": "Remove",
"settings.providers.remove.errorTitle": "Unable to remove provider",
})[key] ?? key
)
.replaceAll("{{name}}", String(values?.name ?? ""))
.replaceAll("{{count}}", String(values?.count ?? "")),
}),
}));
vi.mock("@/components/ui/switch", () => ({
Switch: ({
value,
onValueChange,
disabled,
accessibilityLabel,
testID,
}: {
value: boolean;
onValueChange?: (next: boolean) => void;
disabled?: boolean;
accessibilityLabel?: string;
testID?: string;
}) =>
React.createElement("div", {
role: "switch",
"aria-checked": value ? "true" : "false",
"aria-disabled": disabled ? "true" : undefined,
"aria-label": accessibilityLabel,
"data-testid": testID ?? "provider-switch",
onClick: (event: React.MouseEvent) => {
event.stopPropagation();
if (disabled) return;
onValueChange?.(!value);
},
}),
}));
vi.mock("@/components/ui/loading-spinner", () => ({
LoadingSpinner: () => React.createElement("span", { "data-testid": "loading-spinner" }),
}));
vi.mock("@/components/settings/headings/settings-info-tip", () => ({
SettingsInfoTip: () => null,
}));
vi.mock("@/components/ui/external-link", () => ({
ExternalLink: () => null,
ExternalLinkLabel: () => null,
}));
vi.mock("@/components/ui/dropdown-menu", () => ({
DropdownMenu: ({ children }: { children?: React.ReactNode }) =>
React.createElement("div", null, children),
DropdownMenuTrigger: ({
children,
onPressIn,
accessibilityRole,
accessibilityLabel,
testID,
}: {
children?:
| React.ReactNode
| ((state: { pressed: boolean; hovered: boolean; open: boolean }) => React.ReactNode);
onPressIn?: (event: { stopPropagation: () => void }) => void;
accessibilityRole?: string;
accessibilityLabel?: string;
testID?: string;
}) =>
React.createElement(
"button",
{
type: "button",
role: accessibilityRole,
"aria-label": accessibilityLabel,
"data-testid": testID,
onMouseDown: (event: React.MouseEvent) => onPressIn?.(event),
onClick: (event: React.MouseEvent) => event.stopPropagation(),
},
typeof children === "function"
? children({ pressed: false, hovered: false, open: false })
: children,
),
DropdownMenuContent: ({ children }: { children?: React.ReactNode }) =>
React.createElement("div", null, children),
DropdownMenuItem: ({
children,
onSelect,
status,
pendingLabel,
testID,
}: {
children?: React.ReactNode;
onSelect?: () => void;
status?: "idle" | "pending" | "success";
pendingLabel?: string;
testID?: string;
}) =>
React.createElement(
"button",
{
type: "button",
"data-testid": testID,
disabled: status === "pending" || status === "success",
onClick: (event: React.MouseEvent) => {
event.stopPropagation();
onSelect?.();
},
},
status === "pending" ? pendingLabel : children,
),
}));
vi.mock("@/components/provider-icons", () => ({
useProviderIcon: (provider: string) => () =>
React.createElement("span", { "data-icon": `provider-${provider}` }),
}));
vi.mock("@/stores/provider-settings-store", () => ({
useProviderSettingsStore: (selector: (state: unknown) => unknown) =>
selector({ open: openProviderSettingsMock }),
}));
vi.mock("@/components/provider-catalog-list", () => ({
ProviderCatalogList: () => null,
}));
vi.mock("@/hooks/use-providers-snapshot", () => ({
useProvidersSnapshot: () => ({
entries: snapshotState.entries,
isLoading: snapshotState.isLoading,
isFetching: false,
isRefreshing: snapshotState.isRefreshing,
error: null,
supportsSnapshot: true,
refresh: vi.fn(async () => {}),
refetchIfStale: vi.fn(),
}),
}));
vi.mock("@/hooks/use-daemon-config", () => ({
useDaemonConfig: () => ({
config: configState.config,
isLoading: false,
patchConfig: patchConfigMock,
}),
}));
vi.mock("@/runtime/host-runtime", () => ({
useHostRuntimeIsConnected: () => true,
}));
vi.mock("@/runtime/host-features", () => ({
useHostFeature: () => false,
}));
vi.mock("@/utils/confirm-dialog", () => ({
confirmDialog: vi.fn(async () => true),
}));
import { ProvidersSection } from "./providers-section";
function unexpectedToast(): never {
throw new Error("Provider row interactions should not display a toast");
}
const toastApi = { show: unexpectedToast, copied: unexpectedToast, error: unexpectedToast };
const claudeEntry: ProviderSnapshotEntry = {
provider: "claude",
status: "ready",
enabled: true,
label: "Claude",
description: "Claude Code",
defaultModeId: null,
modes: [],
models: [
{ provider: "claude", id: "claude-opus-4-7", label: "Claude Opus 4.7" },
{ provider: "claude", id: "claude-sonnet-4-6", label: "Claude Sonnet 4.6" },
{ provider: "claude", id: "claude-haiku-4-5", label: "Claude Haiku 4.5" },
],
};
const disabledCodexEntry: ProviderSnapshotEntry = {
provider: "codex",
status: "unavailable",
enabled: false,
label: "Codex",
description: "OpenAI Codex",
defaultModeId: null,
modes: [],
};
function makeConfig(providers: MutableDaemonConfig["providers"] = {}): MutableDaemonConfig {
return {
relay: { enabled: false },
mcp: { injectIntoAgents: false },
browserTools: { enabled: false },
providers,
metadataGeneration: { providers: [] },
autoArchiveAfterMerge: false,
enableTerminalAgentHooks: false,
appendSystemPrompt: "",
};
}
function descendants(el: HTMLElement): HTMLElement[] {
return Array.from(el.querySelectorAll<HTMLElement>("*"));
}
function indexOfMatches(nodes: HTMLElement[], selector: string): number {
return nodes.findIndex((node) => node.matches(selector));
}
function indexOfText(nodes: HTMLElement[], text: string): number {
return nodes.findIndex((node) => node.textContent?.trim() === text);
}
describe("ProvidersSection", () => {
let root: Root | null = null;
let container: HTMLElement | null = null;
beforeEach(() => {
vi.stubGlobal("React", React);
vi.stubGlobal("IS_REACT_ACT_ENVIRONMENT", true);
container = document.createElement("div");
document.body.appendChild(container);
root = createRoot(container);
snapshotState.entries = undefined;
snapshotState.isLoading = false;
snapshotState.isRefreshing = false;
configState.config = null;
patchConfigMock.mockReset();
patchConfigMock.mockResolvedValue(undefined);
openProviderSettingsMock.mockReset();
});
afterEach(() => {
if (root) {
act(() => {
root?.unmount();
});
}
root = null;
container?.remove();
container = null;
vi.unstubAllGlobals();
});
function render(): void {
act(() => {
root?.render(
<ToastApiProvider api={toastApi}>
<ProvidersSection serverId="server-1" />
</ToastApiProvider>,
);
});
}
function findRow(accessibilityLabel: string): HTMLElement {
const row = container?.querySelector<HTMLElement>(
`[role="button"][aria-label="${accessibilityLabel}"]`,
);
if (!row) throw new Error(`Expected row with aria-label "${accessibilityLabel}"`);
return row;
}
it("renders the disabled provider with its server-provided label in snapshot order", () => {
snapshotState.entries = [claudeEntry, disabledCodexEntry];
configState.config = makeConfig({ codex: { enabled: false } });
render();
const rows = Array.from(
container?.querySelectorAll<HTMLElement>('[role="button"][aria-label$="provider details"]') ??
[],
);
expect(rows.map((row) => row.getAttribute("aria-label"))).toEqual([
"Claude provider details",
"Codex provider details",
]);
const codexRow = findRow("Codex provider details");
const codexNodes = descendants(codexRow);
expect(indexOfText(codexNodes, "Codex")).toBeGreaterThanOrEqual(0);
expect(indexOfText(codexNodes, "codex")).toBe(-1);
expect(indexOfText(codexNodes, "Disabled")).toBeGreaterThanOrEqual(0);
});
it("composes the row as chevron, icon, label, status, model count, then switch", () => {
snapshotState.entries = [claudeEntry];
configState.config = makeConfig();
render();
const row = findRow("Claude provider details");
const nodes = descendants(row);
const chevron = indexOfMatches(nodes, '[data-icon="ChevronRight"]');
const icon = indexOfMatches(nodes, '[data-icon="provider-claude"]');
const label = indexOfText(nodes, "Claude");
const status = indexOfText(nodes, "Available");
const modelCount = indexOfText(nodes, "3 models");
const switchEl = indexOfMatches(nodes, '[role="switch"]');
expect(chevron).toBeGreaterThanOrEqual(0);
expect(icon).toBeGreaterThan(chevron);
expect(label).toBeGreaterThan(icon);
expect(status).toBeGreaterThan(label);
expect(modelCount).toBeGreaterThan(status);
expect(switchEl).toBeGreaterThan(modelCount);
});
it("opens the diagnostic sheet when the outer row is pressed for a disabled provider", () => {
snapshotState.entries = [disabledCodexEntry];
configState.config = makeConfig({ codex: { enabled: false } });
render();
expect(openProviderSettingsMock).not.toHaveBeenCalled();
const row = findRow("Codex provider details");
act(() => {
row.dispatchEvent(new window.MouseEvent("click", { bubbles: true }));
});
expect(openProviderSettingsMock).toHaveBeenCalledTimes(1);
expect(openProviderSettingsMock).toHaveBeenCalledWith({
serverId: "server-1",
provider: "codex",
});
});
it("toggles the provider enabled flag through patchConfig when the switch is pressed", async () => {
snapshotState.entries = [claudeEntry];
configState.config = makeConfig();
render();
const row = findRow("Claude provider details");
const switchEl = row.querySelector<HTMLElement>('[role="switch"]');
expect(switchEl).not.toBeNull();
expect(switchEl?.getAttribute("aria-checked")).toBe("true");
await act(async () => {
switchEl?.dispatchEvent(new window.MouseEvent("click", { bubbles: true }));
});
expect(patchConfigMock).toHaveBeenCalledTimes(1);
expect(patchConfigMock).toHaveBeenCalledWith({
providers: { claude: { enabled: false } },
});
});
});
@@ -1,622 +0,0 @@
import { useCallback, useMemo, useRef, useState } from "react";
import type { TFunction } from "i18next";
import { useTranslation } from "react-i18next";
import {
Alert,
Pressable,
Text,
View,
type GestureResponderEvent,
type PressableStateCallbackType,
} from "react-native";
import { StyleSheet, useUnistyles } from "react-native-unistyles";
import { useIsCompactFormFactor } from "@/constants/layout";
import { useToast } from "@/contexts/toast-api-context";
import { settingsStyles } from "@/styles/settings";
import { useHostRuntimeIsConnected } from "@/runtime/host-runtime";
import { selectHostFeature, useHostFeature } from "@/runtime/host-features";
import { useSessionStore } from "@/stores/session-store";
import { useProvidersSnapshot } from "@/hooks/use-providers-snapshot";
import { useDaemonConfig } from "@/hooks/use-daemon-config";
import { buildProviderDefinitions } from "@/utils/provider-definitions";
import {
buildAcpProviderConfigPatch,
getAcpProviderCatalog,
type AcpProviderCatalogItem,
} from "@/hooks/use-acp-provider-catalog";
import { ProviderCatalogList } from "@/components/provider-catalog-list";
import { useProviderIcon } from "@/components/provider-icons";
import { LoadingSpinner } from "@/components/ui/loading-spinner";
import { SkeletonPulse, useSkeletonPulse } from "@/components/ui/skeleton";
import { Switch } from "@/components/ui/switch";
import {
DropdownMenu,
DropdownMenuContent,
DropdownMenuItem,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu";
import { SettingsSection } from "@/components/settings/headings/settings-section";
import { useProviderSettingsStore } from "@/stores/provider-settings-store";
import { confirmDialog } from "@/utils/confirm-dialog";
import { filterSelectableModels } from "@/provider-selection/model-catalog";
import { ChevronRight, MoreHorizontal, Trash2 } from "lucide-react-native";
type ProviderDefinition = ReturnType<typeof buildProviderDefinitions>[number];
type ProviderEntry = NonNullable<ReturnType<typeof useProvidersSnapshot>["entries"]>[number];
type StatusTone = "success" | "warning" | "danger" | "muted" | "loading";
interface ProviderStatus {
tone: StatusTone;
label: string;
modelCount: number | null;
}
function getProviderStatus(
status: string,
enabled: boolean,
modelCount: number,
t: TFunction,
): ProviderStatus {
if (!enabled)
return { tone: "muted", label: t("settings.providers.statuses.disabled"), modelCount: null };
if (status === "loading") {
return { tone: "loading", label: t("settings.providers.statuses.loading"), modelCount: null };
}
if (status === "error") {
return { tone: "danger", label: t("settings.providers.statuses.error"), modelCount: null };
}
if (status === "ready") {
return {
tone: "success",
label: t("settings.providers.statuses.available"),
modelCount: modelCount > 0 ? modelCount : null,
};
}
return {
tone: "warning",
label: t("settings.providers.statuses.notInstalled"),
modelCount: null,
};
}
interface ProviderRowProps {
serverId: string;
def: ProviderDefinition;
entry: ProviderEntry;
enabled: boolean;
isToggling: boolean;
isRemoving: boolean;
canRemove: boolean;
isFirst: boolean;
onPress: (providerId: string) => void;
onToggleEnabled: (providerId: string, enabled: boolean) => void;
onRemove: (providerId: string, providerLabel: string) => void;
}
function stopPressInPropagation(event: GestureResponderEvent) {
event.stopPropagation();
}
interface ProviderActionsMenuProps {
providerId: string;
providerLabel: string;
isRemoving: boolean;
iconSize: number;
foregroundColor: string;
foregroundMutedColor: string;
dangerColor: string;
onRemove: (providerId: string, providerLabel: string) => void;
}
function ProviderActionsMenu({
providerId,
providerLabel,
isRemoving,
iconSize,
foregroundColor,
foregroundMutedColor,
dangerColor,
onRemove,
}: ProviderActionsMenuProps) {
const { t } = useTranslation();
const handleRemove = useCallback(() => {
onRemove(providerId, providerLabel);
}, [onRemove, providerId, providerLabel]);
const triggerStyle = useCallback(
({
pressed,
hovered,
open,
}: PressableStateCallbackType & { hovered?: boolean; open?: boolean }) => [
styles.menuButton,
(hovered || open) && styles.menuButtonHovered,
pressed && styles.menuButtonPressed,
],
[],
);
const trashLeading = useMemo(() => <Trash2 size={16} color={dangerColor} />, [dangerColor]);
return (
<DropdownMenu>
<DropdownMenuTrigger
disabled={isRemoving}
hitSlop={8}
onPressIn={stopPressInPropagation}
style={triggerStyle}
accessibilityRole="button"
accessibilityLabel={t("settings.providers.actions.menu", { name: providerLabel })}
testID={`provider-actions-${providerId}`}
>
{({ hovered, open }) => (
<MoreHorizontal
size={iconSize}
color={hovered || open ? foregroundColor : foregroundMutedColor}
/>
)}
</DropdownMenuTrigger>
<DropdownMenuContent align="end" width={220}>
<DropdownMenuItem
destructive
leading={trashLeading}
onSelect={handleRemove}
status={isRemoving ? "pending" : "idle"}
pendingLabel={t("settings.providers.actions.removing")}
testID={`provider-remove-${providerId}`}
>
{t("settings.providers.actions.remove")}
</DropdownMenuItem>
</DropdownMenuContent>
</DropdownMenu>
);
}
const SKELETON_ROW_KEYS = [0, 1, 2, 3].map((index) => `provider-skeleton-row-${index}`);
function ProviderRowsSkeleton() {
const { t } = useTranslation();
const pulse = useSkeletonPulse();
return (
<View
style={settingsStyles.card}
accessibilityLabel={t("settings.providers.loading")}
testID="providers-skeleton"
>
{SKELETON_ROW_KEYS.map((key, index) => (
<View
key={key}
style={[settingsStyles.row, index > 0 && settingsStyles.rowBorder, styles.row]}
>
<View style={styles.rowContent}>
<SkeletonPulse pulse={pulse} style={styles.skeletonIcon} />
<SkeletonPulse pulse={pulse} style={styles.skeletonTitle} />
</View>
<SkeletonPulse pulse={pulse} style={styles.skeletonSwitch} />
</View>
))}
</View>
);
}
function ProviderRow({
serverId,
def,
entry,
enabled,
isToggling,
isRemoving,
canRemove,
isFirst,
onPress,
onToggleEnabled,
onRemove,
}: ProviderRowProps) {
const { t } = useTranslation();
const { theme } = useUnistyles();
const isCompact = useIsCompactFormFactor();
const ProviderIcon = useProviderIcon(def.id, serverId);
const providerError =
enabled &&
entry.status === "error" &&
typeof entry.error === "string" &&
entry.error.trim().length > 0
? entry.error.trim()
: null;
const modelCount = filterSelectableModels(entry.models ?? null)?.length ?? 0;
const providerStatus = getProviderStatus(entry.status, enabled, modelCount, t);
const handlePress = useCallback(() => {
onPress(def.id);
}, [def.id, onPress]);
const handleToggleValueChange = useCallback(
(value: boolean) => {
onToggleEnabled(def.id, value);
},
[def.id, onToggleEnabled],
);
const rowStyle = useCallback(
({ pressed, hovered }: PressableStateCallbackType & { hovered?: boolean }) => [
settingsStyles.row,
!isFirst && settingsStyles.rowBorder,
styles.row,
hovered && styles.rowHovered,
pressed && styles.rowPressed,
],
[isFirst],
);
return (
<Pressable
style={rowStyle}
onPress={handlePress}
accessibilityRole="button"
accessibilityLabel={t("settings.providers.providerDetails", { name: def.label })}
>
{({ hovered }: PressableStateCallbackType & { hovered?: boolean }) => (
<>
<View style={styles.rowContent}>
<ChevronRight
size={theme.iconSize.sm}
color={hovered ? theme.colors.foreground : theme.colors.foregroundMuted}
/>
<ProviderIcon size={theme.iconSize.md} color={theme.colors.foreground} />
<View style={styles.textColumn}>
<View style={styles.titleRow}>
<Text style={settingsStyles.rowTitle} numberOfLines={1}>
{def.label}
</Text>
{!isCompact ? <Text style={styles.separator}>·</Text> : null}
<StatusIndicator status={providerStatus} compact={isCompact} />
</View>
{providerError && !isCompact ? (
<Text style={styles.errorText} numberOfLines={3}>
{providerError}
</Text>
) : null}
</View>
</View>
{/* The menu leads the switch, so every switch sits on the row's right edge without
rows that have no menu reserving room for one. */}
<View style={styles.trailingControls}>
{canRemove ? (
<ProviderActionsMenu
providerId={def.id}
providerLabel={def.label}
isRemoving={isRemoving}
iconSize={theme.iconSize.sm}
foregroundColor={theme.colors.foreground}
foregroundMutedColor={theme.colors.foregroundMuted}
dangerColor={theme.colors.statusDanger}
onRemove={onRemove}
/>
) : null}
<Switch
value={enabled}
onValueChange={handleToggleValueChange}
disabled={isToggling || isRemoving}
accessibilityLabel={t("settings.providers.enableProvider", { name: def.label })}
/>
</View>
</>
)}
</Pressable>
);
}
function getDotColor(tone: StatusTone, theme: ReturnType<typeof useUnistyles>["theme"]): string {
switch (tone) {
case "success":
return theme.colors.statusSuccess;
case "warning":
return theme.colors.statusWarning;
case "danger":
return theme.colors.statusDanger;
default:
return theme.colors.foregroundMuted;
}
}
function StatusIndicator({ status, compact }: { status: ProviderStatus; compact: boolean }) {
const { t } = useTranslation();
const { theme } = useUnistyles();
const dotStyle = useMemo(
() => [styles.statusDot, { backgroundColor: getDotColor(status.tone, theme) }],
[status.tone, theme],
);
return (
<View style={styles.statusRow}>
{status.tone === "loading" ? (
<LoadingSpinner size={10} color={theme.colors.foregroundMuted} />
) : (
<View style={dotStyle} />
)}
{!compact ? (
<>
<Text style={styles.statusLabel}>{status.label}</Text>
{status.modelCount !== null ? (
<>
<Text style={styles.separator}>·</Text>
<Text style={styles.statusLabel}>
{status.modelCount === 1
? t("settings.providers.models.one")
: t("settings.providers.models.many", { count: status.modelCount })}
</Text>
</>
) : null}
</>
) : null}
</View>
);
}
export interface ProvidersSectionProps {
serverId: string;
}
export function ProvidersSection({ serverId }: ProvidersSectionProps) {
const { t } = useTranslation();
const toast = useToast();
const isConnected = useHostRuntimeIsConnected(serverId);
const supportsProviderRemoval = useHostFeature(serverId, "providerRemoval");
const { entries, isLoading, refresh } = useProvidersSnapshot(serverId);
const { config, patchConfig } = useDaemonConfig(serverId);
const openProviderSettings = useProviderSettingsStore((state) => state.open);
const [pendingProviderId, setPendingProviderId] = useState<string | null>(null);
const [removingProviderId, setRemovingProviderId] = useState<string | null>(null);
const removingProviderIdRef = useRef<string | null>(null);
const [installingProviderId, setInstallingProviderId] = useState<string | null>(null);
const providerDefinitions = useMemo(() => buildProviderDefinitions(entries), [entries]);
const hasServer = serverId.length > 0;
/** Config owns derived providers and opt-in bundled catalog providers. */
const isConfigOwnedProvider = useCallback(
(providerId: string) =>
Boolean(
config?.providers?.[providerId] &&
(config.providers[providerId].extends ||
getAcpProviderCatalog().some(
(entry) => entry.id === providerId && entry.bundledProvider,
)),
),
[config],
);
const handleOpenProviderSettings = useCallback(
(providerId: string) => {
openProviderSettings({ serverId, provider: providerId });
},
[openProviderSettings, serverId],
);
const handleToggleEnabled = useCallback(
async (providerId: string, enabled: boolean) => {
setPendingProviderId(providerId);
try {
await patchConfig({ providers: { [providerId]: { enabled } } });
} catch (error) {
Alert.alert(
t("settings.providers.updateErrorTitle"),
error instanceof Error ? error.message : String(error),
);
} finally {
setPendingProviderId((current) => (current === providerId ? null : current));
}
},
[patchConfig, t],
);
const handleRemoveProvider = useCallback(
async (providerId: string, providerLabel: string) => {
if (removingProviderIdRef.current) return;
removingProviderIdRef.current = providerId;
setRemovingProviderId(providerId);
try {
const confirmed = await confirmDialog({
title: t("settings.providers.remove.confirmTitle", { name: providerLabel }),
message: t("settings.providers.remove.confirmMessage"),
confirmLabel: t("settings.providers.remove.confirm"),
destructive: true,
});
if (!confirmed) {
return;
}
await patchConfig({ removeProviders: [providerId] });
} catch (error) {
Alert.alert(
t("settings.providers.remove.errorTitle"),
error instanceof Error ? error.message : String(error),
);
} finally {
if (removingProviderIdRef.current === providerId) {
removingProviderIdRef.current = null;
}
setRemovingProviderId((current) => (current === providerId ? null : current));
}
},
[patchConfig, t],
);
const handleInstall = useCallback(
async (entry: AcpProviderCatalogItem) => {
if (installingProviderId) return;
setInstallingProviderId(entry.id);
try {
await patchConfig(
buildAcpProviderConfigPatch(entry, (feature) =>
selectHostFeature(useSessionStore.getState(), serverId, feature),
),
);
await refresh([entry.id]);
} catch (error) {
toast.error(error instanceof Error ? error.message : String(error));
} finally {
setInstallingProviderId((current) => (current === entry.id ? null : current));
}
},
[installingProviderId, patchConfig, refresh, serverId, toast],
);
return (
<>
<SettingsSection
title={t("settings.providers.title")}
testID="host-page-providers-card"
style={styles.sectionSpacing}
>
{!hasServer || !isConnected ? (
<View style={[settingsStyles.card, styles.emptyCard]}>
<Text style={styles.emptyText}>{t("settings.providers.unavailable")}</Text>
</View>
) : null}
{hasServer && isConnected && isLoading ? <ProviderRowsSkeleton /> : null}
{hasServer && isConnected && !isLoading && providerDefinitions.length > 0 ? (
<View style={settingsStyles.card}>
{providerDefinitions.map((def, index) => {
const entry = entries?.find((candidate) => candidate.provider === def.id);
if (!entry) return null;
return (
<ProviderRow
key={def.id}
serverId={serverId}
def={def}
entry={entry}
enabled={entry.enabled ?? true}
isToggling={pendingProviderId === def.id}
isRemoving={removingProviderId === def.id}
canRemove={
supportsProviderRemoval &&
entry.source === "custom" &&
isConfigOwnedProvider(def.id)
}
isFirst={index === 0}
onPress={handleOpenProviderSettings}
onToggleEnabled={handleToggleEnabled}
onRemove={handleRemoveProvider}
/>
);
})}
</View>
) : null}
</SettingsSection>
{hasServer && isConnected ? (
<SettingsSection
title={t("settings.providers.addProvider")}
testID="host-page-add-provider-card"
style={styles.addProviderSection}
>
<ProviderCatalogList
serverId={serverId}
installingProviderId={installingProviderId}
onInstall={handleInstall}
/>
</SettingsSection>
) : null}
</>
);
}
const styles = StyleSheet.create((theme) => ({
sectionSpacing: {
marginBottom: theme.spacing[4],
},
addProviderSection: {
marginTop: theme.spacing[4],
},
emptyCard: {
padding: theme.spacing[4],
alignItems: "center",
},
emptyText: {
color: theme.colors.foregroundMuted,
fontSize: theme.fontSize.base,
},
row: {
gap: theme.spacing[3],
minHeight: 56,
},
rowHovered: {
backgroundColor: theme.colors.surface2,
},
skeletonIcon: {
width: 20,
height: 20,
marginLeft: theme.spacing[6],
borderRadius: theme.borderRadius.md,
backgroundColor: theme.colors.surface2,
},
skeletonTitle: {
width: 160,
height: 12,
borderRadius: theme.borderRadius.sm,
backgroundColor: theme.colors.surface2,
},
skeletonSwitch: {
width: 36,
height: 20,
borderRadius: theme.borderRadius.full,
backgroundColor: theme.colors.surface2,
},
rowPressed: {
backgroundColor: theme.colors.surface3,
},
rowContent: {
flex: 1,
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[2],
},
textColumn: {
flex: 1,
minWidth: 0,
},
titleRow: {
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[2],
},
statusRow: {
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[1.5],
},
statusDot: {
width: 8,
height: 8,
borderRadius: 4,
},
statusLabel: {
color: theme.colors.foregroundMuted,
fontSize: theme.fontSize.base,
},
separator: {
color: theme.colors.foregroundMuted,
fontSize: theme.fontSize.base,
},
errorText: {
color: theme.colors.palette.red[300],
fontSize: theme.fontSize.sm,
marginTop: theme.spacing[1],
},
trailingControls: {
flexDirection: "row",
alignItems: "center",
gap: theme.spacing[1],
},
menuButton: {
width: 32,
height: 32,
borderRadius: theme.borderRadius.lg,
alignItems: "center",
justifyContent: "center",
},
menuButtonHovered: {
backgroundColor: theme.colors.surface2,
},
menuButtonPressed: {
backgroundColor: theme.colors.surface3,
},
}));
@@ -17,6 +17,7 @@ import {
isSettingsSectionSlug,
normalizeHostSectionSlug,
normalizeProjectSettingsRouteId,
buildProviderSettingsRoute,
parseHostAgentRouteFromPathname,
parseHostWorkspaceOpenIntentFromPathname,
parseHostWorkspaceRouteFromPathname,
@@ -199,6 +200,14 @@ describe("projects settings routes", () => {
});
});
describe("provider settings routes", () => {
it("buildProviderSettingsRoute addresses one provider on a host", () => {
expect(buildProviderSettingsRoute("host a", "acp/gemini")).toBe(
"/settings/hosts/host%20a/providers/acp%2Fgemini",
);
});
});
describe("global routes", () => {
it("buildSessionsRoute returns the all-host Sessions route", () => {
expect(buildSessionsRoute()).toBe("/sessions");
+7
View File
@@ -584,6 +584,13 @@ export function buildProjectSettingsRoute(serverId: string, projectId: string) {
return `/settings/hosts/${encodeSegment(serverId)}/projects/${encodeSegment(projectId)}` as const;
}
export function buildProviderSettingsRoute(serverId: string, providerId: string) {
if (!serverId.trim() || !providerId.trim()) {
throw new Error("buildProviderSettingsRoute requires a serverId and providerId");
}
return `/settings/hosts/${encodeSegment(serverId)}/providers/${encodeSegment(providerId)}` as const;
}
export function normalizeProjectSettingsRouteId(value: string | string[] | undefined): string {
const id = Array.isArray(value) ? value[0] : value;
return typeof id === "string" ? id : "";
@@ -4,7 +4,10 @@ import { lightTheme } from "../src/styles/theme";
const pinnedTheme = {
colorScheme: "light",
// The light theme's colours, so a `withUnistyles` mapping finds every key it reads, with the
// values below pinned so a test can name the colour it expects.
colors: {
...lightTheme.colors,
syntax: lightHighlightColors,
foreground: "#111111",
foregroundMuted: "#666666",
@@ -157,12 +160,16 @@ export const StyleSheet = {
type UniPropsMapping = (theme: typeof testTheme, runtime: object) => Record<string, unknown>;
/** Applies `uniProps` with the test theme, the way Unistyles maps theme values onto props. */
export const withUnistyles = <T>(Component: T): T => {
/**
* Applies the theme mapping and `uniProps` with the test theme, the way Unistyles maps theme values
* onto props: mapped props first, then `uniProps`, then the props the caller passed.
*/
export const withUnistyles = <T>(Component: T, mapping?: UniPropsMapping): T => {
function ThemedComponent({ uniProps, ...props }: { uniProps?: UniPropsMapping }) {
// Explicit props win over mapped ones, as in Unistyles' `deepMergeObjects(mappings, uniProps, props)`.
return createElement(Component as ElementType, {
...(uniProps ? uniProps(testTheme, {}) : {}),
...mapping?.(testTheme, {}),
...uniProps?.(testTheme, {}),
...props,
});
}
+1 -1
View File
@@ -99,7 +99,7 @@ paseo provider diagnostic codex --json
paseo --host devbox:6767 provider diagnostic opencode
```
The diagnostic includes the configured command, daemon `PATH` and shell, matching binaries, resolved path, version, model count, and provider status. Use the global `--host` option for a remote daemon. This is the same diagnostic shown under **Settings → your host → Providers → provider → Diagnostic**.
The diagnostic includes the configured command, daemon `PATH` and shell, matching binaries, resolved path, version, model count, and provider status. Use the global `--host` option for a remote daemon. This is the same diagnostic shown under **Settings → your host → Providers → provider → Diagnostic report**.
## Running agents
+1 -1
View File
@@ -96,7 +96,7 @@ paseo provider diagnostic codex --json
paseo --host devbox:6767 provider diagnostic opencode
```
诊断信息包括配置的命令、daemon 的 `PATH` 和 shell、匹配到的二进制文件、解析出的路径、版本、模型数量和 Provider 状态。对于远程 daemon,请使用全局的 `--host` 选项。这与 **设置 → 你的主机 → Providers → 对应 Provider → 诊断** 下显示的诊断相同。
诊断信息包括配置的命令、daemon 的 `PATH` 和 shell、匹配到的二进制文件、解析出的路径、版本、模型数量和 Provider 状态。对于远程 daemon,请使用全局的 `--host` 选项。这与 **设置 → 你的主机 → Providers → 对应 Provider → 诊断报告** 下显示的诊断相同。
## 运行 Agent {#running-agents}
+1 -1
View File
@@ -460,7 +460,7 @@ interface ProviderInstallation {
| Member | Called | Deadline | Answer kept |
| ----------------- | ------------------------------------------------------------ | -------- | ------------------------------------------------ |
| `inspect` | When provider settings open | 20 s | 30 s |
| `inspect` | When the provider list or a provider's page shows | 20 s | 30 s |
| `checkForUpdates` | After `inspect` answers `installed`, or without `inspect` | 25 s | 1 hour for `current` or `available`, else 30 s |
| `update` | When the user selects **Update**, one at a time per provider | None | Paseo reads both answers again after `succeeded` |
+1 -1
View File
@@ -14,7 +14,7 @@ Run fx, the coding agent from Vercel Labs, in Paseo with your existing fx instal
1. [Install fx](https://fx.sh/docs/getting-started/installation) on your daemon host.
2. [Connect fx to a model provider](https://fx.sh/docs/getting-started/authentication), for example with `fx login`.
3. In Paseo, open **Settings → Hosts → your host → Providers**, find **fx** in the catalog, and choose **Add**.
3. In Paseo, open **Settings → Hosts → your host → Providers**, select **+ Provider**, find **fx**, and choose **Add**.
Paseo launches `fx acp` and uses your fx credentials and settings. Until fx has credentials, the provider reports the sign-in message from fx.
+1 -1
View File
@@ -12,7 +12,7 @@ nav: fx
1. 在 daemon 主机上[安装 fx](https://fx.sh/docs/getting-started/installation)。
2. [为 fx 连接一个模型提供方](https://fx.sh/docs/getting-started/authentication),例如运行 `fx login`。
3. 在 Paseo 中打开 **设置 → Hosts → 你的主机 → Providers**,在目录里找到 **fx** 并选择 **添加**。
3. 在 Paseo 中打开 **设置 → Hosts → 你的主机 → Providers**,选择 **+ Provider**,找到 **fx** 并选择 **添加**。
Paseo 会启动 `fx acp`,并使用你的 fx 凭据和设置。在 fx 拿到凭据之前,该 Provider 会显示 fx 给出的登录提示。
+1 -1
View File
@@ -14,7 +14,7 @@ Run Hoplite's cloud coding agent in Paseo through the Hoplite CLI on your daemon
1. Install the [Hoplite CLI](https://hoplite.sh/docs/cli) on your daemon host.
2. Run `hoplite login`.
3. In Paseo, open **Settings → Hosts → your host → Providers**, find **Hoplite** in the catalog, and choose **Add**.
3. In Paseo, open **Settings → Hosts → your host → Providers**, select **+ Provider**, find **Hoplite**, and choose **Add**.
Paseo launches `hoplite acp`. See [Hoplite's ACP guide](https://hoplite.sh/docs/cli/acp) for authentication and project setup.
@@ -12,7 +12,7 @@ nav: Hoplite
1. 在 daemon 主机上安装 [Hoplite CLI](https://hoplite.sh/docs/cli)。
2. 运行 `hoplite login`。
3. 在 Paseo 中打开 **设置 → Hosts → 你的主机 → Providers**,在目录里找到 **Hoplite** 并选择 **添加**。
3. 在 Paseo 中打开 **设置 → Hosts → 你的主机 → Providers**,选择 **+ Provider**,找到 **Hoplite** 并选择 **添加**。
Paseo 会启动 `hoplite acp`。认证和项目设置见 [Hoplite 的 ACP 指南](https://hoplite.sh/docs/cli/acp)。
+1 -1
View File
@@ -29,7 +29,7 @@ Paseo ships an integration for each of these agents.
Paseo runs any agent that speaks the [Agent Client Protocol](https://agentclientprotocol.com) (ACP). The in-app catalog lists the agents below.
To add one, open **Settings → Hosts → your host → Providers**, find the agent in the catalog, and choose **Add**. Entries that launch through `npx` or `uvx` need only that tool on your daemon host. For the other entries, install the CLI of the agent first. Each entry links to its install instructions.
To add one, open **Settings → Hosts → your host → Providers**, select **+ Provider**, find the agent, and choose **Add**. Entries that launch through `npx` or `uvx` need only that tool on your daemon host. For the other entries, install the CLI of the agent first. If the CLI is missing, the page of the provider says **Not installed**, and **Install** opens its install instructions.
- [Agoragentic](https://agoragentic.com), agent marketplace with 174+ AI capabilities.
- [Amp](https://github.com/tao12345666333/amp-acp), frontier coding agent.
@@ -27,7 +27,7 @@ Paseo 为以下每个 Agent 都提供了集成。
Paseo 可以运行任何使用 [Agent Client Protocol](https://agentclientprotocol.com)(ACP)的 Agent。应用内目录列出了以下 Agent。
要添加其中一个,请打开 **设置 → Hosts → 你的主机 → Providers**,在目录里找到该 Agent 并选择 **添加**。通过 `npx` 或 `uvx` 启动的条目只需要 daemon 主机上有该工具。其他条目请先安装该 Agent 的 CLI。每个条目都附有安装说明的链接。
要添加其中一个,请打开 **设置 → Hosts → 你的主机 → Providers**,选择 **+ Provider**,找到该 Agent 并选择 **添加**。通过 `npx` 或 `uvx` 启动的条目只需要 daemon 主机上有该工具。其他条目请先安装该 Agent 的 CLI。如果缺少 CLI,该 provider 的页面会显示 **未安装**,**安装** 会打开它的安装说明。
- [Agoragentic](https://agoragentic.com):拥有 174 种以上 AI 能力的 Agent 市场。
- [Amp](https://github.com/tao12345666333/amp-acp):前沿的编程 Agent。
+1 -1
View File
@@ -33,7 +33,7 @@ Paseo launches the agent CLIs you've already installed, it doesn't bundle them (
### See what Paseo sees
Open **Settings → your host → Providers**, tap the provider, then tap **Diagnostic**. The rows that matter:
Open **Settings → your host → Providers**, tap the provider, then tap **Diagnostic report**. The rows that matter:
- **Resolved path** — where Paseo found the binary, or `not found`.
- **Daemon PATH** — the `PATH` Paseo is searching. Compare it to `echo $PATH` in a fresh terminal.
+1 -1
View File
@@ -31,7 +31,7 @@ Paseo 启动的是你已经安装的 Agent CLI,它并不自带这些 CLI(参
### 查看 Paseo 看到的内容 {#see-what-paseo-sees}
打开 **设置 → 你的主机 → Providers**,点击该 Provider,然后点击 **诊断**。重要的几行:
打开 **设置 → 你的主机 → Providers**,点击该 Provider,然后点击 **诊断报告**。重要的几行:
- **Resolved path**:Paseo 找到二进制文件的位置,或 `not found`。
- **Daemon PATH**:Paseo 正在搜索的 `PATH`。把它和新终端中 `echo $PATH` 的结果进行比较。