@arizeai/phoenix-cli 1.8.0 → 1.9.0

package/build/setup/steps/establishConnection.js

@@ -0,0 +1,143 @@
+/**
+ * Establish the connection.
+ *
+ * The project itself is never created here — Phoenix creates a project on
+ * first ingestion, so setup only needs to settle on a *name* and hand it
+ * to the app via `PHOENIX_PROJECT_NAME`. What remains is credential
+ * acquisition: the auth-on lanes verify the key with a read-only probe so a
+ * bad paste is caught here rather than at first trace. Future OAuth
+ * acquisition plugs into the auth-on interactive lane unchanged.
+ */
+import * as path from "node:path";
+import { HttpError } from "@arizeai/phoenix-client";
+import * as COPY from "../copy.js";
+import { HeadlessInputError, SetupFatalError } from "../errors.js";
+import { redactForDisplay } from "../util/redact.js";
+const REST_TIMEOUT_MS = 10_000;
+// ---------------------------------------------------------------------------
+// Project name
+// ---------------------------------------------------------------------------
+/** Names are used as URL path identifiers; '/', '?', '#' are invalid. */
+export function validateProjectName(value) {
+    const trimmed = value.trim();
+    if (!trimmed || /[/?#]/.test(trimmed)) {
+        return COPY.CONNECT.projectNameInvalid;
+    }
+    return undefined;
+}
+export function defaultProjectName(cwd) {
+    const base = path.basename(cwd).replace(/[/?#]/g, "-").trim();
+    return base || "default";
+}
+async function promptForProjectName(deps, inputs) {
+    const name = inputs.project ??
+        (await deps.prompter.textInput({
+            message: COPY.CONNECT.projectNameMessage,
+            defaultValue: defaultProjectName(deps.context.cwd),
+            validate: validateProjectName,
+        }));
+    return name.trim();
+}
+/**
+ * Read-only probe: list one project. Only the credential matters here — an
+ * instance with no projects yet still answers 200.
+ */
+async function checkApiKey(deps, endpoint, apiKey) {
+    const client = deps.createClient({ endpoint, apiKey });
+    try {
+        await client.GET("/v1/projects", {
+            params: { query: { limit: 1 } },
+            signal: AbortSignal.timeout(REST_TIMEOUT_MS),
+        });
+        return { kind: "ok" };
+    }
+    catch (error) {
+        if (error instanceof HttpError) {
+            if (error.status === 401 || error.status === 403) {
+                return { kind: "rejected", status: error.status };
+            }
+            return { kind: "error", detail: `HTTP ${error.status}` };
+        }
+        return { kind: "error", detail: redactForDisplay(String(error)) };
+    }
+}
+// ---------------------------------------------------------------------------
+// Interactive lanes
+// ---------------------------------------------------------------------------
+async function connectAuthOff(deps, endpoint, inputs) {
+    const projectName = await promptForProjectName(deps, inputs);
+    deps.prompter.line(COPY.CONNECT.usingProject(projectName));
+    return { endpoint, projectName };
+}
+/** Prompt for an API key without echoing it to the terminal. */
+async function promptForApiKey(deps) {
+    const apiKey = await deps.prompter.passwordInput({
+        message: COPY.API_KEY.pasteKeyMessage,
+        validate: (value) => value.trim() ? undefined : COPY.API_KEY.pasteKeyInvalid,
+    });
+    return apiKey.trim();
+}
+/**
+ * A rejected key returns to the masked credential prompt without asking for
+ * the project name again.
+ */
+async function connectAuthOnInteractive(deps, endpoint, inputs) {
+    deps.prompter.note(COPY.API_KEY.instructions, COPY.API_KEY.instructionsTitle);
+    let apiKey = await promptForApiKey(deps);
+    const projectName = await promptForProjectName(deps, inputs);
+    for (;;) {
+        const result = await checkApiKey(deps, endpoint, apiKey);
+        if (result.kind === "ok") {
+            deps.prompter.line(COPY.CONNECT.usingProject(projectName));
+            return { endpoint, projectName, apiKey };
+        }
+        if (result.kind === "rejected") {
+            deps.prompter.line(COPY.API_KEY.pasteKeyRejected);
+            apiKey = await promptForApiKey(deps);
+            continue;
+        }
+        throw new SetupFatalError(COPY.CONNECT.connectFailed(result.detail));
+    }
+}
+// ---------------------------------------------------------------------------
+// Headless lane
+// ---------------------------------------------------------------------------
+async function connectHeadless(deps, endpoint, authEnabled, inputs) {
+    if (!inputs.project) {
+        throw new HeadlessInputError(COPY.CONNECT.headlessNeedsProject);
+    }
+    const projectName = inputs.project.trim();
+    if (!authEnabled) {
+        return { endpoint, projectName };
+    }
+    const apiKey = inputs.apiKey;
+    if (!apiKey) {
+        throw new HeadlessInputError(COPY.CONNECT.headlessNeedsApiKey);
+    }
+    const result = await checkApiKey(deps, endpoint, apiKey);
+    if (result.kind === "rejected") {
+        throw new SetupFatalError(COPY.CONNECT.headlessAuthRejected);
+    }
+    if (result.kind === "error") {
+        throw new SetupFatalError(COPY.CONNECT.connectFailed(result.detail));
+    }
+    return { endpoint, projectName, apiKey };
+}
+export async function establishConnection(deps, { endpoint, authEnabled, inputs }) {
+    // A --project / env-provided name bypasses the prompt in every lane, so
+    // enforce here the same rule the prompt validates interactively.
+    if (inputs.project !== undefined) {
+        const nameError = validateProjectName(inputs.project);
+        if (nameError) {
+            throw new HeadlessInputError(nameError);
+        }
+    }
+    if (inputs.headless) {
+        return connectHeadless(deps, endpoint, authEnabled, inputs);
+    }
+    if (!authEnabled) {
+        return connectAuthOff(deps, endpoint, inputs);
+    }
+    return connectAuthOnInteractive(deps, endpoint, inputs);
+}
+//# sourceMappingURL=establishConnection.js.map

package/build/setup/steps/establishConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"establishConnection.js","sourceRoot":"","sources":["../../../src/setup/steps/establishConnection.ts"],"names":[],"mappings":"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"}

package/build/setup/steps/installTooling.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Install the tooling: the global `px` CLI, and the Phoenix skills.
+ *
+ * Runs after traces are verified — the peak-motivation moment — and offers
+ * the tooling that turns "traces are flowing" into "I can look at them":
+ * a global `px` install when setup is running without `px` on PATH
+ * (the `npx @arizeai/phoenix-cli setup` case), and the Phoenix skills for
+ * the user's coding agent via `npx skills add` (no `--skill` pins — the
+ * skills CLI's own picker lists the repo's skills and target agents). Both
+ * installs are spawned on the terminal so their own output and prompts show
+ * through; failures are non-fatal warnings with the command to retry by hand.
+ */
+import type { SetupDeps } from "../deps/index.js";
+/** What an install offer did — reported in the setup summary. */
+export type ToolingOutcome = "installed" | "failed" | "declined" | "skipped";
+export interface ToolingResult {
+    cli: ToolingOutcome;
+    skills: ToolingOutcome;
+}
+export declare function offerToolingInstalls(deps: Pick<SetupDeps, "context" | "processes" | "prompter">, { pxOnPath, skills, canPrompt, }: {
+    /** Started at setup launch so the probe never blocks this prompt. */
+    pxOnPath: Promise<boolean>;
+    /** `--skills` / `--no-skills`; undefined means ask (when we can). */
+    skills?: boolean;
+    /** False in a headless run: there is no terminal to ask on. */
+    canPrompt: boolean;
+}): Promise<ToolingResult>;
+//# sourceMappingURL=installTooling.d.ts.map

package/build/setup/steps/installTooling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installTooling.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/installTooling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,SAAS,CAAC;AAiCtD,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,cAAc,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;CACxB;AAiCD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC,EAC3D,EACE,QAAQ,EACR,MAAM,EACN,SAAS,GACV,EAAE;IACD,qEAAqE;IACrE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+DAA+D;IAC/D,SAAS,EAAE,OAAO,CAAC;CACpB,GACA,OAAO,CAAC,aAAa,CAAC,CAoBxB"}

package/build/setup/steps/installTooling.js

@@ -0,0 +1,79 @@
+/**
+ * Install the tooling: the global `px` CLI, and the Phoenix skills.
+ *
+ * Runs after traces are verified — the peak-motivation moment — and offers
+ * the tooling that turns "traces are flowing" into "I can look at them":
+ * a global `px` install when setup is running without `px` on PATH
+ * (the `npx @arizeai/phoenix-cli setup` case), and the Phoenix skills for
+ * the user's coding agent via `npx skills add` (no `--skill` pins — the
+ * skills CLI's own picker lists the repo's skills and target agents). Both
+ * installs are spawned on the terminal so their own output and prompts show
+ * through; failures are non-fatal warnings with the command to retry by hand.
+ */
+import * as COPY from "../copy.js";
+import { selectBoolean } from "../ui/selectBoolean.js";
+const CLI_INSTALL_SPEC = {
+    command: "npm",
+    args: ["install", "-g", "@arizeai/phoenix-cli"],
+};
+/**
+ * `npx skills add`, as spawned. The leading `-y` is npx's own — install the
+ * `skills` package without asking.
+ *
+ * Unattended, the skills CLI needs its `--yes` too: it is interactive by
+ * default (a skill picker, an agent picker, a final confirm) and a missing TTY
+ * does not suppress those prompts, so without the flag a headless run hangs on
+ * stdin. With it, the installer takes every skill in the repo for the agents it
+ * detects. Interactively we leave it off, so the user drives those pickers.
+ */
+function skillsAddSpec(unattended) {
+    return {
+        command: "npx",
+        args: [
+            "-y",
+            "skills",
+            "add",
+            COPY.SKILLS_SOURCE,
+            ...(unattended ? ["--yes"] : []),
+        ],
+    };
+}
+/**
+ * Install, honoring a decision the caller already made. `decided` short-circuits
+ * the prompt: `true` installs (`--skills`), `false` skips (`--no-skills`), and
+ * `undefined` asks — so a headless run, which has no terminal to ask on, must
+ * arrive here already decided.
+ */
+async function offerInstall(deps, copy, spec, decided) {
+    const optedIn = decided ??
+        (await selectBoolean({
+            prompter: deps.prompter,
+            message: copy.message,
+            yesLabel: copy.yes,
+            noLabel: copy.no,
+        }));
+    if (!optedIn) {
+        return "declined";
+    }
+    const { exitCode } = await deps.processes.spawnInteractive({
+        ...spec,
+        cwd: deps.context.cwd,
+    });
+    deps.prompter.line(exitCode === 0 ? copy.installed : copy.failed);
+    return exitCode === 0 ? "installed" : "failed";
+}
+export async function offerToolingInstalls(deps, { pxOnPath, skills, canPrompt, }) {
+    // The global CLI install is prompt-only — it is offered when `px` is missing
+    // (an `npx` run), and skipped outright when we cannot ask, because installing
+    // a global npm package is not something to do to an unattended caller.
+    const cli = !canPrompt || (await pxOnPath)
+        ? "skipped"
+        : await offerInstall(deps, COPY.TOOLING.cli, CLI_INSTALL_SPEC);
+    // With no prompt to fall back on, an unflagged skills install defaults to
+    // going ahead: the only reason to invoke this lane unattended is to install.
+    // `--no-skills` still declines. This default lives here, next to `canPrompt`,
+    // rather than in each caller.
+    const skillsOutcome = await offerInstall(deps, COPY.TOOLING.skills, skillsAddSpec(!canPrompt), canPrompt ? skills : (skills ?? true));
+    return { cli, skills: skillsOutcome };
+}
+//# sourceMappingURL=installTooling.js.map

package/build/setup/steps/installTooling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installTooling.js","sourceRoot":"","sources":["../../../src/setup/steps/installTooling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,gBAAgB,GAA6B;IACjD,OAAO,EAAE,KAAK;IACd,IAAI,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,sBAAsB,CAAC;CAChD,CAAC;AAEF;;;;;;;;;GASG;AACH,SAAS,aAAa,CAAC,UAAmB;IACxC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE;YACJ,IAAI;YACJ,QAAQ;YACR,KAAK;YACL,IAAI,CAAC,aAAa;YAClB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;SACjC;KACF,CAAC;AACJ,CAAC;AAYD;;;;;GAKG;AACH,KAAK,UAAU,YAAY,CACzB,IAA2D,EAC3D,IAAsB,EACtB,IAA8B,EAC9B,OAAiB;IAEjB,MAAM,OAAO,GACX,OAAO;QACP,CAAC,MAAM,aAAa,CAAC;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,GAAG;YAClB,OAAO,EAAE,IAAI,CAAC,EAAE;SACjB,CAAC,CAAC,CAAC;IACN,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC;QACzD,GAAG,IAAI;QACP,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;KACtB,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClE,OAAO,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAA2D,EAC3D,EACE,QAAQ,EACR,MAAM,EACN,SAAS,GAQV;IAED,6EAA6E;IAC7E,8EAA8E;IAC9E,uEAAuE;IACvE,MAAM,GAAG,GACP,CAAC,SAAS,IAAI,CAAC,MAAM,QAAQ,CAAC;QAC5B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAEnE,0EAA0E;IAC1E,6EAA6E;IAC7E,8EAA8E;IAC9E,8BAA8B;IAC9B,MAAM,aAAa,GAAG,MAAM,YAAY,CACtC,IAAI,EACJ,IAAI,CAAC,OAAO,CAAC,MAAM,EACnB,aAAa,CAAC,CAAC,SAAS,CAAC,EACzB,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,CACtC,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AACxC,CAAC"}

package/build/setup/steps/instrumentApp.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Instrumentation hand-off.
+ *
+ * Lanes, in order of preference: launch a detected coding agent directly
+ * (prompt pre-loaded, credentials injected via env), copy the prompt for an
+ * agent the user runs themselves, or manual via the quickstart docs. All
+ * lanes converge on the trace-verification step — setup's definition of
+ * done is API-verified data flow, not agent self-report.
+ *
+ * `--agent` pre-answers the lane, which is what makes an unattended run
+ * possible: with no TTY there is no prompt to pick a lane from, and the agent
+ * runs in background mode (no TUI to hand the terminal to).
+ */
+import { type AgentRunMode, type CodingAgent, type CodingAgentId } from "../agents/registry.js";
+import type { DocsPrefetchResult, SetupDeps } from "../deps/index.js";
+import type { Connection } from "./establishConnection.js";
+export interface InstrumentAppArgs {
+    authEnabled: boolean;
+    /** Started at setup launch so the probes never block this prompt. */
+    agentDetection: Promise<CodingAgent[]>;
+    /** `--agent`: skip the lane prompt and launch this agent. */
+    agent?: CodingAgentId;
+    /** `--language`: passed through so the agent skips its own detection. */
+    languages: string[];
+    /** How to run the agent — see {@link AgentRunMode}. */
+    mode: AgentRunMode;
+    /** Where the prefetched docs landed, when the docs step ran. */
+    docs?: DocsPrefetchResult;
+}
+/** Which lane instrumentation actually took — reported in the summary. */
+export type InstrumentationLane = {
+    kind: "agent";
+    agent: CodingAgentId;
+    exitCode: number;
+} | {
+    kind: "clipboard";
+} | {
+    kind: "manual";
+};
+export declare function instrumentApp(deps: Pick<SetupDeps, "context" | "processes" | "prompter" | "writeClipboard">, connection: Connection, args: InstrumentAppArgs): Promise<InstrumentationLane>;
+//# sourceMappingURL=instrumentApp.d.ts.map

package/build/setup/steps/instrumentApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentApp.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/instrumentApp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,kBAAkB,EAAgB,SAAS,EAAE,MAAM,SAAS,CAAC;AAG3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAQxD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,cAAc,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACvC,6DAA6D;IAC7D,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,yEAAyE;IACzE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,uDAAuD;IACvD,IAAI,EAAE,YAAY,CAAC;IACnB,gEAAgE;IAChE,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAED,0EAA0E;AAC1E,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC;AAEvB,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,CACR,SAAS,EACT,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,gBAAgB,CACxD,EACD,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAgG9B"}

package/build/setup/steps/instrumentApp.js

@@ -0,0 +1,131 @@
+/**
+ * Instrumentation hand-off.
+ *
+ * Lanes, in order of preference: launch a detected coding agent directly
+ * (prompt pre-loaded, credentials injected via env), copy the prompt for an
+ * agent the user runs themselves, or manual via the quickstart docs. All
+ * lanes converge on the trace-verification step — setup's definition of
+ * done is API-verified data flow, not agent self-report.
+ *
+ * `--agent` pre-answers the lane, which is what makes an unattended run
+ * possible: with no TTY there is no prompt to pick a lane from, and the agent
+ * runs in background mode (no TUI to hand the terminal to).
+ */
+import { buildLaunchSpec, getCodingAgent, probeBinary, } from "../agents/registry.js";
+import * as COPY from "../copy.js";
+import { SetupFatalError } from "../errors.js";
+import { buildInstrumentationPrompt } from "../prompts/instrumentationPrompt.js";
+import { tracesUrl } from "./verifyTraces.js";
+const DEFAULT_LOCAL_ENDPOINT = "http://localhost:6006";
+export async function instrumentApp(deps, connection, args) {
+    const { authEnabled, agentDetection, languages, mode } = args;
+    const prompt = buildInstrumentationPrompt({
+        projectName: connection.projectName,
+        endpoint: connection.endpoint,
+        isDefaultEndpoint: connection.endpoint === DEFAULT_LOCAL_ENDPOINT,
+        docs: {
+            quickstartPython: COPY.DOCS.quickstartPython,
+            quickstartTypeScript: COPY.DOCS.quickstartTypeScript,
+            phoenixOtelSetup: COPY.DOCS.phoenixOtelSetup,
+            integrationsIndex: COPY.DOCS.integrationsIndex,
+        },
+        tracesUrl: tracesUrl(connection),
+        authEnabled,
+        languages,
+        // Only advertise the local docs dir when it holds pages — an empty one
+        // (docs site down, over-narrow workflow filter) would send the agent to
+        // read a directory with nothing in it instead of the web.
+        ...(args.docs?.hasPagesOnDisk ? { localDocsDir: args.docs.outputDir } : {}),
+    });
+    // `--agent` short-circuits the lane prompt. The binary is probed rather
+    // than taken from the detection sweep so a named-but-missing agent fails
+    // with "not on your PATH" instead of silently dropping to another lane.
+    if (args.agent) {
+        const agent = getCodingAgent(args.agent);
+        if (!agent) {
+            throw new SetupFatalError(COPY.INSTRUMENTATION.unknownAgent(args.agent));
+        }
+        if (!(await probeBinary(deps, agent.binary))) {
+            throw new SetupFatalError(COPY.INSTRUMENTATION.agentNotFound(agent.label, agent.binary));
+        }
+        return launchAgent(deps, connection, { agent, prompt, mode });
+    }
+    const detectedAgents = await agentDetection;
+    const options = [
+        ...detectedAgents.map((agent) => ({
+            value: `agent:${agent.id}`,
+            label: COPY.INSTRUMENTATION.launchLabel(agent.label),
+            hint: COPY.INSTRUMENTATION.launchHint,
+        })),
+        {
+            value: "clipboard",
+            label: COPY.INSTRUMENTATION.clipboardLabel,
+            hint: COPY.INSTRUMENTATION.clipboardHint,
+        },
+        {
+            value: "manual",
+            label: COPY.INSTRUMENTATION.manualLabel,
+            hint: COPY.INSTRUMENTATION.manualHint,
+        },
+    ];
+    const choice = await deps.prompter.select({
+        message: COPY.INSTRUMENTATION.modeMessage,
+        options,
+    });
+    const chosenAgent = detectedAgents.find((agent) => choice === `agent:${agent.id}`);
+    if (chosenAgent) {
+        return launchAgent(deps, connection, { agent: chosenAgent, prompt, mode });
+    }
+    if (choice === "clipboard") {
+        const copied = await deps.writeClipboard(prompt);
+        if (copied) {
+            deps.prompter.line(COPY.INSTRUMENTATION.promptCopied);
+        }
+        else {
+            deps.prompter.line(COPY.INSTRUMENTATION.promptCopyFailed);
+            deps.prompter.note(prompt);
+        }
+        await deps.prompter.select({
+            message: COPY.INSTRUMENTATION.clipboardDoneMessage,
+            options: [
+                { value: true, label: COPY.INSTRUMENTATION.clipboardDoneLabel },
+            ],
+        });
+        return { kind: "clipboard" };
+    }
+    deps.prompter.line(COPY.INSTRUMENTATION.manualDocs(COPY.DOCS.instrumentationIndex));
+    await deps.prompter.select({
+        message: COPY.INSTRUMENTATION.manualDoneMessage,
+        options: [{ value: true, label: COPY.INSTRUMENTATION.manualDoneLabel }],
+    });
+    return { kind: "manual" };
+}
+/**
+ * Run the agent with the prompt pre-loaded. A non-zero exit is a warning, not
+ * a failure: the agent may have instrumented the app and then exited badly,
+ * and trace verification — not the agent's exit code — decides whether setup
+ * succeeded.
+ */
+async function launchAgent(deps, connection, { agent, prompt, mode, }) {
+    // Without its TUI *and* without permission bypass, an agent stalls on the
+    // first approval it wants, with no terminal to approve it on — the run then
+    // dies at the verification timeout with nothing to show. Say so up front.
+    if (mode.background && !mode.bypassPermissions) {
+        deps.prompter.line(COPY.INSTRUMENTATION.backgroundNeedsYolo(agent.label));
+    }
+    deps.prompter.line(mode.background
+        ? COPY.INSTRUMENTATION.launchingBackground(agent.label)
+        : COPY.INSTRUMENTATION.launching(agent.label));
+    const spec = buildLaunchSpec(agent, {
+        prompt,
+        cwd: deps.context.cwd,
+        connection,
+        mode,
+    });
+    const { exitCode } = await deps.processes.spawnInteractive(spec);
+    if (exitCode !== 0) {
+        deps.prompter.line(COPY.INSTRUMENTATION.agentExitWarning(agent.label));
+    }
+    return { kind: "agent", agent: agent.id, exitCode };
+}
+//# sourceMappingURL=instrumentApp.js.map

package/build/setup/steps/instrumentApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentApp.js","sourceRoot":"","sources":["../../../src/setup/steps/instrumentApp.ts"],"names":[],"mappings":"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"}

package/build/setup/steps/offerPxProfile.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Offer to point `px` at the project setup just connected.
+ *
+ * Because setup *is* px, everything here is in-process — the profile
+ * (including the API key, when auth is on) is written through px's own
+ * settings module (`~/.px/settings.json`, dir 0700, file 0600). No argv or
+ * subprocess ever carries the secret. Any failure is a non-fatal warning;
+ * setup proceeds regardless.
+ */
+import type { SetupDeps } from "../deps/index.js";
+import type { Connection } from "./establishConnection.js";
+/** `local` for localhost, else the host with dots and colons → dashes. */
+export declare function profileNameForEndpoint(endpoint: string): string;
+export interface PxProfileArgs {
+    connection: Connection;
+    /** Override the settings file path (tests). */
+    settingsPath?: string;
+}
+export declare function offerPxProfile(deps: Pick<SetupDeps, "prompter">, { connection, settingsPath }: PxProfileArgs): Promise<void>;
+//# sourceMappingURL=offerPxProfile.d.ts.map

package/build/setup/steps/offerPxProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offerPxProfile.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/offerPxProfile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,0EAA0E;AAC1E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAO/D;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,UAAU,CAAC;IACvB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EACjC,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,aAAa,GAC1C,OAAO,CAAC,IAAI,CAAC,CAoFf"}

package/build/setup/steps/offerPxProfile.js

@@ -0,0 +1,95 @@
+/**
+ * Offer to point `px` at the project setup just connected.
+ *
+ * Because setup *is* px, everything here is in-process — the profile
+ * (including the API key, when auth is on) is written through px's own
+ * settings module (`~/.px/settings.json`, dir 0700, file 0600). No argv or
+ * subprocess ever carries the secret. Any failure is a non-fatal warning;
+ * setup proceeds regardless.
+ */
+import { getSettingsPath, getStoredActiveProfile, loadSettings, saveSettings, SettingsFileError, } from "../../settings.js";
+import * as COPY from "../copy.js";
+import { SetupCancelledError } from "../errors.js";
+import { redactForDisplay } from "../util/redact.js";
+/** `local` for localhost, else the host with dots and colons → dashes. */
+export function profileNameForEndpoint(endpoint) {
+    // URL.hostname keeps the brackets on IPv6 literals (e.g. "[::1]").
+    const host = new URL(endpoint).hostname;
+    if (host === "localhost" || host === "127.0.0.1" || host === "[::1]") {
+        return "local";
+    }
+    return host.replace(/^\[|\]$/g, "").replace(/[.:]/g, "-");
+}
+export async function offerPxProfile(deps, { connection, settingsPath }) {
+    // Strict, and on its own: a settings file whose contents don't parse must not
+    // degrade to the empty profiles record a lenient load returns, which the save
+    // below would then write over whatever the user had. A file that is simply
+    // absent is not an error — the load returns fresh settings for it.
+    let settings;
+    try {
+        settings = loadSettings({ settingsPath, strict: true });
+    }
+    catch (error) {
+        // Only a file we can't parse gets sent here. `px profile create`, the
+        // remedy the generic failure suggests, loads the same file the same strict
+        // way — so for this one failure it is no remedy at all, and the file itself
+        // is what has to be dealt with.
+        if (error instanceof SettingsFileError) {
+            deps.prompter.line(COPY.PX_PROFILE.unreadableSettings(settingsPath ?? getSettingsPath(), redactForDisplay(error.message)));
+            return;
+        }
+        deps.prompter.line(COPY.PX_PROFILE.failed(redactForDisplay(String(error))));
+        return;
+    }
+    try {
+        const active = getStoredActiveProfile(settings);
+        // A fully-configured active profile pointing elsewhere is a conflict —
+        // ask before switching, never clobber silently. A partially configured
+        // profile (missing endpoint or project) is non-conflicting.
+        const conflicting = active !== undefined &&
+            Boolean(active.entry.endpoint) &&
+            Boolean(active.entry.project) &&
+            (active.entry.endpoint !== connection.endpoint ||
+                active.entry.project !== connection.projectName);
+        const optedIn = await deps.prompter.select(conflicting && active
+            ? {
+                message: COPY.PX_PROFILE.conflictMessage(active.name, active.entry.endpoint ?? ""),
+                options: [
+                    { value: false, label: COPY.PX_PROFILE.conflictNo },
+                    { value: true, label: COPY.PX_PROFILE.conflictYes },
+                ],
+            }
+            : {
+                message: COPY.PX_PROFILE.optInMessage,
+                options: [
+                    { value: true, label: COPY.PX_PROFILE.optInYes },
+                    { value: false, label: COPY.PX_PROFILE.optInNo },
+                ],
+            });
+        if (!optedIn) {
+            return;
+        }
+        const profileName = profileNameForEndpoint(connection.endpoint);
+        const entry = {
+            endpoint: connection.endpoint,
+            project: connection.projectName,
+        };
+        if (connection.apiKey) {
+            entry.apiKey = connection.apiKey;
+        }
+        settings.profiles[profileName] = {
+            ...settings.profiles[profileName],
+            ...entry,
+        };
+        settings.activeProfile = profileName;
+        saveSettings(settings, { settingsPath });
+        deps.prompter.line(COPY.PX_PROFILE.created(profileName));
+    }
+    catch (error) {
+        if (error instanceof SetupCancelledError) {
+            throw error;
+        }
+        deps.prompter.line(COPY.PX_PROFILE.failed(redactForDisplay(String(error))));
+    }
+}
+//# sourceMappingURL=offerPxProfile.js.map

package/build/setup/steps/offerPxProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offerPxProfile.js","sourceRoot":"","sources":["../../../src/setup/steps/offerPxProfile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,iBAAiB,GAGlB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,0EAA0E;AAC1E,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,mEAAmE;IACnE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC;IACxC,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrE,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAiC,EACjC,EAAE,UAAU,EAAE,YAAY,EAAiB;IAE3C,8EAA8E;IAC9E,8EAA8E;IAC9E,2EAA2E;IAC3E,mEAAmE;IACnE,IAAI,QAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,QAAQ,GAAG,YAAY,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,sEAAsE;QACtE,2EAA2E;QAC3E,4EAA4E;QAC5E,gCAAgC;QAChC,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;YACvC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAChC,YAAY,IAAI,eAAe,EAAE,EACjC,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAChC,CACF,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAEhD,uEAAuE;QACvE,uEAAuE;QACvE,4DAA4D;QAC5D,MAAM,WAAW,GACf,MAAM,KAAK,SAAS;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;YAC7B,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,UAAU,CAAC,QAAQ;gBAC5C,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,UAAU,CAAC,WAAW,CAAC,CAAC;QAErD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CACxC,WAAW,IAAI,MAAM;YACnB,CAAC,CAAC;gBACE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,eAAe,CACtC,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAC5B;gBACD,OAAO,EAAE;oBACP,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE;oBACnD,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE;iBACpD;aACF;YACH,CAAC,CAAC;gBACE,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,YAAY;gBACrC,OAAO,EAAE;oBACP,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE;oBAChD,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE;iBACjD;aACF,CACN,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,sBAAsB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAChE,MAAM,KAAK,GAAiB;YAC1B,QAAQ,EAAE,UAAU,CAAC,QAAQ;YAC7B,OAAO,EAAE,UAAU,CAAC,WAAW;SAChC,CAAC;QACF,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QACnC,CAAC;QACD,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG;YAC/B,GAAG,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC;YACjC,GAAG,KAAK;SACT,CAAC;QACF,QAAQ,CAAC,aAAa,GAAG,WAAW,CAAC;QACrC,YAAY,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,mBAAmB,EAAE,CAAC;YACzC,MAAM,KAAK,CAAC;QACd,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC"}

package/build/setup/steps/prefetchDocs.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Prefetch the Phoenix docs into the repo, so the instrumentation agent reads
+ * package names and APIs from disk instead of fetching URLs mid-run.
+ *
+ * Runs only when instrumentation runs — the docs exist to serve the agent, so
+ * a registration-only run has no reason to write them. Never fatal: a docs
+ * site that is slow or down degrades to the agent fetching pages itself, which
+ * is what it did before this step existed.
+ *
+ * Must run after the git-safety gate: the download writes untracked files
+ * under `.px/`, which a fast headless run could otherwise mistake for
+ * pre-existing user changes.
+ */
+import { type DocsPrefetchOptions, type DocsPrefetchResult, type SetupDeps } from "../deps/index.js";
+/**
+ * Download the docs and gitignore what they wrote. A failure is reported and
+ * dropped: the connection and hand-off files are real work worth keeping, and
+ * the agent can still read the docs from the web.
+ */
+export declare function prefetchDocs(deps: Pick<SetupDeps, "fetchDocs" | "prompter" | "context">, { docs, isGitRepository, }: {
+    docs: DocsPrefetchOptions;
+    isGitRepository: boolean;
+}): Promise<DocsPrefetchResult | undefined>;
+//# sourceMappingURL=prefetchDocs.d.ts.map

package/build/setup/steps/prefetchDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetchDocs.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/prefetchDocs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACf,MAAM,SAAS,CAAC;AAMjB;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC,EAC3D,EACE,IAAI,EACJ,eAAe,GAChB,EAAE;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,eAAe,EAAE,OAAO,CAAA;CAAE,GACzD,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CA6BzC"}