Files
PaperClipAI/tests/ai-connections-app/app.spec.ts
DottaandPaperclip e38d6d16b6 feat(connections): add advanced provider setup and live browser qualification (#15341)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work.
> - Users connect accounts and choose an agent harness and model.
> - The runtime change in #14970 supports custom providers on those
connections.
> - Normal setup must stay simple while advanced users can choose a
compatible gateway.
> - Shared connector rows and access controls keep these choices
consistent.
> - This pull request refines the agent setup UI and adds review stories
and repeatable browser qualification.
> - The qualification checks real tools and downloaded outputs, not only
a successful run status.

## Linked Issues or Issue Description

Refs #14970, #37, #13083, #14104, #14565, #12692.

The core implementation in #14970 is merged. This branch incorporates
its squash commit and targets `master`. Both PRs contain our
implementation. #14016 is a reference only and is not a dependency. This
PR has 96 changed files.

## What Changed

- Complete model-provider connector presentation beside other
connectors. Each row uses the existing Connect action and connection
list. Tags are stored without category UI. The base PR includes the
provider forms and routes.
- Show persistent Subscription, API Key, and Advanced choices. Label
Advanced as Custom Gateway. Reuse provider logos, connection lists, and
permissions controls. Default access to the organization and all agents
when permitted; keep narrowing controls under Advanced.
- Keep Configure reachable before subscription sign-in, so users can
select a supported environment when the default cannot sign in. Testing
and saving still require a connection. Show the execution environment in
Configure. Preserve the confirmed Connect choice. Editing a method,
credential, saved account, or advanced choice requires that current
choice to connect before testing or saving. Use matching model and
thinking-effort dropdowns and retain connection icons in selected
values.
- Preserve the new harness model default when switching an existing
OpenCode agent to Codex or Claude, and resolve user-selected model names
with the effective harness.
- Load popular OpenRouter models through the shared connection-model
discovery path. Keep explicit model lists and manual model entry
available.
- Group onboarding, connection setup, agent runtime, management,
recovery, and production-component stories under AI Connections /
Provider routing.
- Add an explicit-only provider-connections browser suite for managed
local or existing local/staging targets. Use private browser profiles
and credential handoffs. Support human-assisted subscription sign-in
without sharing passwords or tokens in reports.
- Verify persisted connection identity, runtime probes, tool execution,
exact artifact bytes, completion, and context-dependent follow-up.
Retain source/model provenance, cost bounds, closed error diagnostics,
original failures, and cleanup evidence.
- Add Gemini startup-model and skill-root fixes, Grok private-history
detection, ACP filesystem regression fixtures, selected-workspace
handling for local Hermes, and artifact-helper workspace fallback.
- Keep managed Grok runtime homes disposable. Remove host-side
transcript retention/restoration because private file modes do not
isolate same-user agent processes. Ignore earlier development archives
and use a fresh task handoff when history is unavailable. Verify the
absence of restored transcripts with a separate same-user process.
- Capture stopped-run diagnostics before deleting an attached-company
fixture agent. Track creation and owned sign-in receipts; revoke only
this attempt's accounts and never adopt a concurrent campaign's newly
created account. Preserve failure signals and final status through
cleanup.
- Require the requested environment in the saved agent and every run,
including follow-ups. Reject a forced incompatible target. Keep one
cancellation state through startup, every cell, reporting, and teardown
for SIGINT, SIGTERM, and SIGHUP. Stop further paid cells after
interruption. Document qualification limits.

## Verification

- Current head `b3bb3e94d577d43d9965a6b9daba039f599b2e49` includes
master `d9f600043`. The security fix in `a758fde31` passes full
workspace typecheck, production build, and 119 connection/Grok
regressions. The unchanged UI passes all 126
configuration/model-discovery tests and token gates. The final
published-guide correction passes Grok adapter typecheck. Earlier head
`eebd8225c` passed the complete deterministic runner suite (1,404 Vitest
tests and 128 Node tests) and all CI jobs. Current-head CI run
`37520147514` passed all 47 jobs, including the full sharded Vitest and
browser matrix, production build, and canary dry run. All 55 checks
completed: 53 successes and two expected skips. The current-head
security scan passed, Greptile is 5/5, and no review threads remain
open.
- A separate same-user process reproduced reading a restored Grok
transcript before the security fix. The regression now finds no
transcript. Existing fresh-session fallback and ordinary session
metadata behavior pass.
- The final account-choice and cleanup fixes pass 85 setup tests and 26
qualification-harness tests. Regressions verify that editing a
connection invalidates confirmation, Configure remains reachable before
sign-in, diagnostics are captured before fixture deletion, and
concurrent campaigns cannot adopt or revoke each other's accounts. UI
and E2E typechecks pass.
- The Storybook build and actual Chromium production-component stories
passed during this change. Review the neighboring AI Connections /
Provider routing stories, regular connector rows, three connection
modes, model discovery, and the single execution-environment control in
Configure.
- Cancellation smoke verified authenticated cleanup before browser close
for SIGINT, SIGTERM, and SIGHUP. Regressions cover interruption during
startup and reporting, missing-file ACP resource errors, and preserved
permission denials. Both ACP runtime versions and 54 ACPX/Grok
regressions passed. The deterministic connection-intent browser suite
passed two tests.
- Historical local qualification retained 43 passing API/gateway cells
out of 46, with downloaded outputs and follow-up receipts. These
attempts span earlier builds; they do not qualify this exact commit or
staging. Subscription combinations, Gemini overloads, and the unresolved
follow-up failure remain recorded rather than counted as passing.
- Use `pnpm test:e2e:runner -- --list --suite provider-connections` to
inspect the matrix. Follow `tests/runner-e2e/PROVIDER-CONNECTIONS.md`
for credentials, target URL, sign-in assistance, budget, evidence, and
cleanup. Paid live tests remain opt-in.

## Risks

- The core implementation in #14970 is merged. This PR adds no database
migration of its own.
- Subscription login needs an interactive provider session. Dedicated
accounts and staging qualification remain follow-up work; this PR does
not certify every login combination for production.
- Managed Grok transcript resume is deferred until provider history has
an OS isolation or authorized broker solution. Follow-ups start fresh
with Paperclip task context; earlier live Grok results do not qualify
this behavior.
- Gemini CLI 0.58.0 has an upstream ACP new-file error conversion
defect. Live overloads and one unresolved follow-up timeout remain
recorded. The stock CLI is unchanged, and those cases are not marked as
passing.
- Real-provider tests spend credits and use private credential/evidence
directories. The launcher requires explicit selection and checks target
ownership. It must not attach to a developer's database by accident.
- OpenClaw Gateway, Hermes Gateway, Claude Managed, AWS AgentCore,
Process, HTTP, and legacy ACPX local remain outside custom provider
setup.

## Model Used

OpenAI GPT-6 through Codex, with reasoning, repository tools, code
execution, and browser testing. The exact deployment model ID and
context window size were not exposed in this session.

## Checklist


- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have searched GitHub for duplicate or related PRs and linked
them above
- [x] I have either (a) linked existing issues with `Fixes: #` / `Closes
#` / `Refs #` OR (b) described the issue in-PR following the relevant
issue template
- [x] I have not referenced internal/instance-local Paperclip issues or
links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip`
URLs)
- [x] My branch name describes the change (e.g. `docs/...`, `fix/...`)
and contains no internal Paperclip ticket id or instance-derived details
- [x] I have run tests locally and they pass
- [x] I have added or updated tests where applicable
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [x] All Paperclip CI gates are green
- [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups
- [x] I will address all Greptile and reviewer comments before
requesting merge

---------

Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-10-06 15:21:22 -05:00

224 lines
16 KiB
TypeScript
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
import { test, expect } from "@playwright/test";
// Opt in against an isolated test drive; never seed or modify a production account.
const companyId = process.env.AI_CONNECTIONS_TEST_COMPANY_ID;
test.skip(!companyId, "Provide the isolated test-drive company ID");
let prefix: string;
test.beforeAll(async ({ request }) => {
const response = await request.get(`/api/companies/${companyId}`);
expect(response.ok()).toBe(true);
prefix = (await response.json()).issuePrefix;
});
test("existing Connections lists AI providers and keeps account management compact", async ({ page, request }, testInfo) => {
await page.goto(`/${prefix}/apps`);
for (const provider of ["Anthropic", "OpenAI", "OpenRouter", "Grok"]) {
await expect(page.getByRole("button", { name: new RegExp(`^(Add account|Connect) ${provider}$`) })).toBeVisible();
}
const { connections } = await (await request.get(`/api/companies/${companyId}/ai-connections`)).json();
const account = connections.find((entry: { ownership: string }) => entry.ownership === "personal");
expect(account, "The isolated drive should include an imported personal account").toBeTruthy();
await page.goto(`/${prefix}/apps/${account.id}/permissions`);
await expect(page.getByRole("heading", { name: account.name, exact: true })).toBeVisible();
await expect(page.getByRole("heading", { name: "Personal default", exact: true })).toBeVisible();
await expect(page.getByRole("heading", { name: "Agent usage", exact: true })).toHaveCount(0);
await expect(page.getByRole("button", { name: "Back to Connectors", exact: true })).toHaveCount(0);
await expect(page.getByRole("heading", { name: "Which humans can use this credential?" })).toBeVisible();
await expect(page.getByRole("heading", { name: "Which agents can use this connection?" })).toBeVisible();
await expect(page.getByText("Authorized use for other users’ tasks", { exact: true })).toHaveCount(0);
await expect(page.getByRole("combobox", { name: "Authorize an agent" })).toHaveCount(0);
await page.screenshot({ path: testInfo.outputPath("account-details.png"), fullPage: true });
await page.getByRole("button", { name: "Reconnect", exact: true }).last().click();
await expect(page.getByText("Step 1 of 1", { exact: true })).toBeVisible();
await expect(page.getByLabel("Connection name")).toBeDisabled();
await expect(page.getByRole("heading", { name: "Which humans can use this credential?" })).toHaveCount(0);
await page.getByRole("button", { name: "Cancel", exact: true }).last().click();
});
test("rejected API credentials do not create a connection, and cancellation returns to Connections", async ({ page, request }, testInfo) => {
const before = await (await request.get(`/api/companies/${companyId}/ai-connections`)).json();
await page.goto(`/${prefix}/apps/connect?source=openrouter&method=ai-api_key`);
await page.getByRole("button", { name: /^(Save and continue|Continue)$/ }).click();
await page.getByLabel("Connection name").fill("Rejected browser test account");
await page.getByRole("textbox", { name: "API key", exact: true }).fill("invalid-ai-connection-browser-test");
await page.getByRole("button", { name: "Connect", exact: true }).click();
await expect(page.getByRole("alert")).toContainText(/rejected|Could not verify|could not verify/);
await expect(page.getByRole("textbox", { name: "API key", exact: true })).toHaveValue("");
const after = await (await request.get(`/api/companies/${companyId}/ai-connections`)).json();
expect(after.connections.map((entry: { id: string }) => entry.id).sort()).toEqual(before.connections.map((entry: { id: string }) => entry.id).sort());
await page.getByRole("button", { name: "Cancel", exact: true }).last().click();
await expect(page).toHaveURL(new RegExp(`/${prefix}/apps$`));
});
test("legacy adoption and inline account cancellation preserve the agent configuration", async ({ page, request }, testInfo) => {
const agents = await (await request.get(`/api/companies/${companyId}/agents`)).json();
const agent = agents.find((entry: { adapterType: string; runtimeConfig: { aiConnection?: unknown } }) => ["claude_local", "codex_local", "grok_local"].includes(entry.adapterType) && !entry.runtimeConfig.aiConnection);
expect(agent, "The drive should include a legacy agent for adoption review").toBeTruthy();
await page.goto(`/${prefix}/agents/${agent.urlKey ?? agent.id}/runtime`);
await page.getByRole("button", { name: "Choose a managed connection", exact: true }).click();
await expect(page.getByRole("region", { name: "AI connection", exact: true })).toBeVisible();
await expect(page.getByText("Your personal accounts", { exact: true })).toHaveCount(0);
await page.getByRole("button", { name: "Connect another account", exact: true }).click();
await expect(page.getByRole("dialog")).toBeVisible();
await page.getByRole("dialog").getByRole("button", { name: "Back", exact: true }).click();
await expect(page.getByRole("dialog")).toHaveCount(0);
await expect(page.getByRole("button", { name: "Connect another account", exact: true })).toBeFocused();
await page.screenshot({ path: testInfo.outputPath("agent-ai-connection.png"), fullPage: true });
await page.getByRole("button", { name: /Responsible user’s connection/ }).click();
await expect(page.getByRole("dialog")).toContainText(`Adopt Connections for ${agent.name}`);
await page.getByRole("dialog").getByRole("button", { name: "Cancel", exact: true }).click();
const after = await (await request.get(`/api/agents/${agent.id}`)).json();
expect(after.adapterType).toBe(agent.adapterType);
expect(after.adapterConfig).toEqual(agent.adapterConfig);
expect(after.runtimeConfig).toEqual(agent.runtimeConfig);
});
test("connection setup waits for provider details before enabling Continue", async ({ page }) => {
let release!: () => void;
const held = new Promise<void>(resolve => { release = resolve; });
await page.route(`**/api/companies/${companyId}/tools/gallery`, async route => {
await held;
await route.continue();
});
await page.goto(`/${prefix}/apps/connect?source=openrouter&method=ai-api_key`);
const next = page.getByRole("button", { name: /^(Save and continue|Continue)$/ });
await expect(next).toBeDisabled();
release();
await next.click();
await expect(page.getByLabel("Connection name")).toBeVisible();
await expect(page).toHaveURL(/stage=setup/);
});
test("new OpenRouter agents use the visible binding and provider model catalog", async ({ page }) => {
let tested: { aiConnection?: unknown; adapterConfig?: { model?: string } } | undefined;
await page.route(`**/api/companies/${companyId}/adapters/opencode_local/models*`, async route => {
expect(new URL(route.request().url()).searchParams.get("provider")).toBe("openrouter");
await route.fulfill({ json: [{ id: "openrouter/anthropic/claude-sonnet-4.5", label: "Claude Sonnet 4.5" }] });
});
await page.route(`**/api/companies/${companyId}/adapters/opencode_local/test-environment`, async route => {
tested = route.request().postDataJSON();
await route.fulfill({ json: { status: "pass", checks: [], testedAt: new Date().toISOString() } });
});
await page.goto(`/${prefix}/agents/new?name=OpenRouter+binding+regression&adapterType=opencode_local`);
await expect(page.getByText("Existing authentication — not managed by Connections", { exact: true })).toHaveCount(0);
await expect(page.getByRole("button", { name: /Responsible user’s connection/ })).toHaveAttribute("aria-pressed", "true");
await page.getByRole("button", { name: "Select model (required)", exact: true }).click();
await page.getByRole("button", { name: "anthropic/claude-sonnet-4.5", exact: true }).click();
await page.getByRole("button", { name: "Run test", exact: true }).click();
await expect.poll(() => tested).toBeTruthy();
expect(tested?.aiConnection).toEqual({ provider: "openrouter", method: "api_key", mode: "responsible_user" });
expect(tested?.adapterConfig?.model).toBe("openrouter/anthropic/claude-sonnet-4.5");
});
test("ordinary Anthropic setup keeps the existing tool method available", async ({ page }) => {
await page.goto(`/${prefix}/apps/connect?source=anthropic`);
await page.getByRole("button", { name: /^(Save and continue|Continue)$/ }).click();
await expect(page.getByText("How do you want to connect?", { exact: true })).toBeVisible();
await page.getByRole("radio", { name: "Use an API key", exact: true }).click();
await expect(page.getByLabel("Your Anthropic key", { exact: true })).toBeVisible();
await expect(page.getByRole("radiogroup", { name: "Connect your model provider" })).toHaveCount(0);
await page.getByRole("button", { name: "Cancel", exact: true }).first().click();
await expect(page).toHaveURL(new RegExp(`/${prefix}/apps$`));
});
test("explicit OpenAI API method survives continuing and reloading", async ({ page }) => {
await page.goto(`/${prefix}/apps/connect?source=openai&method=ai-api_key`);
await page.getByRole("button", { name: /^(Save and continue|Continue)$/ }).click();
await expect(page).toHaveURL(/method=ai-api_key/);
await page.reload();
await page.getByRole("radio", { name: /OpenAI/ }).click();
await expect(page.getByLabel("API key", { exact: true })).toBeVisible();
await expect(page.getByText(/CODEX_HOME=/)).toHaveCount(0);
await page.getByRole("button", { name: "Cancel", exact: true }).first().click();
});
for (const [provider, label] of [["anthropic", "Claude"], ["openai", "OpenAI"]]) {
test(`Connections reuses the local browser sign-in step for ${label} (simulated auth)`, async ({ page }, testInfo) => {
// UI contract only: real subscription qualification is provider-connections.
const base = `/api/companies/${companyId}/ai-connections/local`;
const sessionId = "22222222-2222-4222-8222-222222222222";
await page.route(`**${base}/attempts`, route => route.fulfill({ json: { sessionId, expiresAt: new Date(Date.now() + 300000).toISOString() } }));
await page.route(`**${base}/check`, route => route.fulfill({ json: { status: "sign_in_required", authorizationUrl: "https://provider.example/authorize", ...(provider === "openai" ? { code: "ABCD-EFGH" } : {}) } }));
await page.route(`**${base}/attempts/${sessionId}`, route => route.fulfill({ json: { ok: true } }));
await page.goto(`/${prefix}/apps/connect?source=${provider}&method=ai-subscription`);
await expect(page.getByRole("radiogroup", { name: "Connect your model provider" })).toBeVisible();
await expect(page.getByRole("button", { name: "Connect for tool access instead" })).toHaveCount(0);
await page.getByRole("radio", { name: new RegExp(label) }).click();
await expect(page.getByRole("link", { name: `Sign in to ${label}`, exact: true })).toHaveAttribute("href", "https://provider.example/authorize");
await expect(page.getByText(/CODEX_HOME=|claude auth login|existing terminal login/)).toHaveCount(0);
if (provider === "anthropic") await expect(page.getByRole("button", { name: "Submit code", exact: true })).toBeDisabled();
else await expect(page.getByText("ABCD-EFGH", { exact: true })).toBeVisible();
await expect(page.getByRole("button", { name: "Connect", exact: true })).toBeDisabled();
// Let the shared tile-collapse and card-enter animations settle for visual review.
await page.waitForTimeout(1000);
await page.screenshot({ path: testInfo.outputPath(`${provider}-shared-provider-step.png`), fullPage: true });
await page.getByRole("button", { name: "Back", exact: true }).click();
await page.getByRole("button", { name: "Use API key instead", exact: true }).click();
await page.getByRole("radio", { name: new RegExp(label) }).click();
await expect(page.getByLabel("API key", { exact: true })).toBeVisible();
await expect(page.getByText(/Provide your .* API key to connect/)).toBeVisible();
await page.getByRole("button", { name: "Cancel", exact: true }).first().click();
await expect(page).toHaveURL(new RegExp(`/${prefix}/apps$`));
});
}
// Exercise the real onboarding login controllers; only provider/server replies
// are simulated. No credentials, sandbox leases or accounts are created here.
for (const [provider, label, adapter] of [["anthropic", "Claude", "claude_local"], ["openai", "OpenAI", "codex_local"]]) {
test(`Connections uses onboarding browser sign-in for ${label}`, async ({ page }, testInfo) => {
const environmentId = "11111111-1111-4111-8111-111111111111";
const sessionId = "22222222-2222-4222-8222-222222222222";
const base = `/api/companies/${companyId}`;
const sessions = provider === "anthropic" ? `${base}/setup-token-login-sessions` : `${base}/adapters/${adapter}/login-sessions`;
let starts = 0;
let cancels = 0;
let intent: Record<string, unknown> | undefined;
const session = () => ({ sessionId, environmentId, adapterType: adapter, status: provider === "anthropic" ? "awaiting_code" : "awaiting_user", expiresAt: new Date(Date.now() + 300000).toISOString(), aiConnection: intent, prompt: provider === "anthropic" ? { authorizationUrl: "https://provider.example/authorize" } : { url: "https://provider.example/authorize", code: "ABCD-EFGH" } });
await page.route(`**${base}/environments`, route => route.fulfill({ json: [{ id: environmentId, name: "Browser sign-in test sandbox", driver: "sandbox", status: "active", config: { provider: "browser-test" } }] }));
await page.route(`**${base}/environments/capabilities`, route => route.fulfill({ json: { sandboxProviders: { "browser-test": { supportsLoginPty: true } } } }));
await page.route(`**${sessions}**`, async route => {
const path = new URL(route.request().url()).pathname;
if (path.endsWith("/active")) return route.fulfill(starts ? { json: session() } : { status: 404, json: { error: "Not found" } });
if (path.endsWith("/cancel")) { cancels++; return route.fulfill({ json: {} }); }
if (path.endsWith("/prompt")) return route.fulfill({ json: { authorizationUrl: "https://provider.example/authorize" } });
if (path === sessions && route.request().method() === "POST") {
starts++;
const payload = route.request().postDataJSON();
expect(payload.environmentId).toBe(environmentId);
expect(payload.aiConnection.provider).toBe(provider);
intent = payload.aiConnection;
}
return route.fulfill({ json: session() });
});
await page.addInitScript(() => { window.open = (url) => { (window as unknown as { loginDestination: string }).loginDestination = String(url); return null; }; });
await page.goto(`/${prefix}/apps/connect?source=${provider}&method=ai-subscription`);
await page.getByRole("button", { name: /^(Save and continue|Continue)$/ }).click();
await page.getByRole("radio", { name: new RegExp(label) }).click();
const signIn = page.getByRole("button", { name: `Sign in to ${label}`, exact: true });
await expect(signIn).toBeEnabled();
await expect(page.getByText(/login on this machine/)).toHaveCount(0);
if (provider === "anthropic") await expect(page.locator('input[type="password"]')).toBeVisible();
else await expect(page.getByText("ABCD-EFGH", { exact: true })).toBeVisible();
await signIn.click();
expect(await page.evaluate(() => (window as unknown as { loginDestination: string }).loginDestination)).toBe("https://provider.example/authorize");
await expect(page.getByRole("button", { name: "Waiting for code", exact: true })).toBeDisabled();
// The shared footer label animates; capture after it has settled.
await page.waitForTimeout(600);
await page.screenshot({ path: testInfo.outputPath(`${provider}-onboarding-browser-login.png`), fullPage: true });
if (provider === "anthropic") {
const submitted = page.waitForRequest(request => request.url().endsWith(`${sessionId}/code`) && request.method() === "POST");
await page.locator('input[type="password"]').fill("storybook-fixture-code");
await page.locator('input[type="password"]').press("Enter");
await submitted;
await expect(page.getByRole("button", { name: "Connecting", exact: true })).toBeDisabled();
}
await page.getByRole("button", { name: "Back", exact: true }).click();
await page.getByRole("radio", { name: new RegExp(label) }).click();
await expect(page.getByRole("button", { name: `Sign in to ${label}`, exact: true })).toBeEnabled();
expect(starts).toBe(1);
expect(cancels).toBe(0);
});
}