@arizeai/phoenix-cli 1.8.1 → 1.9.0

package/build/setup/steps/chooseEndpoint.js

@@ -0,0 +1,125 @@
+/**
+ * Choose the endpoint: where Phoenix is, and whether it wants an API key.
+ *
+ * Two options — Local or Remote ("paste your instance URL"). The probe is
+ * an unauthenticated
+ * `GET /v1/projects?limit=1`: 200 → auth off, 401/403 → auth on, anything
+ * else → troubleshoot copy and re-ask (max 3 attempts).
+ */
+import { HttpError } from "@arizeai/phoenix-client";
+import { isEndpointUrl, normalizeEndpoint } from "../../validation/endpoint.js";
+import * as COPY from "../copy.js";
+import { HeadlessInputError, SetupCancelledError, SetupFatalError, } from "../errors.js";
+import { redactForDisplay } from "../util/redact.js";
+const PROBE_TIMEOUT_MS = 10_000;
+const MAX_ATTEMPTS = 3;
+const DEFAULT_LOCAL_ENDPOINT = "http://localhost:6006";
+/**
+ * Probe an endpoint to determine reachability and whether auth is enabled.
+ */
+export async function probeEndpoint(deps, endpoint) {
+    const client = deps.createClient({ endpoint });
+    try {
+        await client.GET("/v1/projects", {
+            params: { query: { limit: 1 } },
+            signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
+        });
+        return { kind: "authOff" };
+    }
+    catch (error) {
+        if (error instanceof HttpError) {
+            if (error.status === 401 || error.status === 403) {
+                return { kind: "authOn" };
+            }
+            return { kind: "notPhoenix", detail: `HTTP ${error.status}` };
+        }
+        // A 2xx whose body will not parse: something is listening, but it is not
+        // the Phoenix API.
+        if (error instanceof SyntaxError) {
+            return { kind: "notPhoenix", detail: COPY.ENDPOINT.unexpectedBody };
+        }
+        return { kind: "unreachable", detail: redactForDisplay(String(error)) };
+    }
+}
+async function promptForEndpoint(deps) {
+    const choice = await deps.prompter.select({
+        message: COPY.ENDPOINT.selectMessage,
+        options: [
+            {
+                value: "local",
+                label: COPY.ENDPOINT.localLabel,
+                hint: COPY.ENDPOINT.localHint,
+            },
+            {
+                value: "remote",
+                label: COPY.ENDPOINT.remoteLabel,
+                hint: COPY.ENDPOINT.remoteHint,
+            },
+        ],
+    });
+    if (choice === "local") {
+        return DEFAULT_LOCAL_ENDPOINT;
+    }
+    const url = await deps.prompter.textInput({
+        message: COPY.ENDPOINT.remoteUrlMessage,
+        validate: (value) => isEndpointUrl(value) ? undefined : COPY.ENDPOINT.remoteUrlInvalid,
+    });
+    return url;
+}
+export async function chooseEndpoint(deps, { presetEndpoint, headless }) {
+    let attempts = 0;
+    let candidate = presetEndpoint;
+    for (;;) {
+        if (candidate === undefined) {
+            if (headless) {
+                throw new HeadlessInputError(COPY.ENDPOINT.headlessNeedsEndpoint);
+            }
+            candidate = await promptForEndpoint(deps);
+        }
+        let endpoint;
+        try {
+            endpoint = normalizeEndpoint(candidate);
+        }
+        catch {
+            if (headless) {
+                throw new HeadlessInputError(COPY.ENDPOINT.remoteUrlInvalid);
+            }
+            deps.prompter.line(COPY.ENDPOINT.remoteUrlInvalid);
+            candidate = undefined;
+            continue;
+        }
+        deps.prompter.line(COPY.ENDPOINT.probing(endpoint));
+        const outcome = await probeEndpoint(deps, endpoint);
+        if (outcome.kind === "authOff") {
+            deps.prompter.line(COPY.ENDPOINT.authOff);
+            return { endpoint, authEnabled: false };
+        }
+        if (outcome.kind === "authOn") {
+            deps.prompter.line(COPY.ENDPOINT.authOn);
+            return { endpoint, authEnabled: true };
+        }
+        if (headless) {
+            throw new SetupFatalError(COPY.ENDPOINT.headlessUnreachable(endpoint));
+        }
+        attempts += 1;
+        deps.prompter.line(outcome.kind === "unreachable"
+            ? COPY.ENDPOINT.unreachable(endpoint)
+            : COPY.ENDPOINT.notPhoenix(endpoint, outcome.detail));
+        if (attempts >= MAX_ATTEMPTS) {
+            deps.prompter.line(COPY.ENDPOINT.gaveUp);
+            throw new SetupCancelledError();
+        }
+        const retry = await deps.prompter.select({
+            message: COPY.ENDPOINT.retryMessage,
+            options: [
+                { value: true, label: COPY.ENDPOINT.retryYes },
+                { value: false, label: COPY.ENDPOINT.retryNo },
+            ],
+        });
+        if (!retry) {
+            throw new SetupCancelledError();
+        }
+        candidate = undefined;
+    }
+}
+//# sourceMappingURL=chooseEndpoint.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * Confirm git can undo whatever setup is about to do.
+ *
+ * A coding agent may be about to edit files in this directory; git is the
+ * undo button. Both gates are opt-in selects with the safe option first.
+ * Headless mode proceeds only on a clean repo.
+ */
+import type { SetupDeps } from "../deps/index.js";
+export interface GitSafetyResult {
+    isGitRepository: boolean;
+    /** False when the user chose to stop at a gate. */
+    proceed: boolean;
+}
+export declare function confirmGitSafety(deps: Pick<SetupDeps, "context" | "processes" | "prompter">, { headless }: {
+    headless: boolean;
+}): Promise<GitSafetyResult>;
+//# sourceMappingURL=confirmGitSafety.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confirmGitSafety.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/confirmGitSafety.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAIzC,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,OAAO,CAAC;IACzB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC,EAC3D,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GAClC,OAAO,CAAC,eAAe,CAAC,CAmE1B"}

package/build/setup/steps/confirmGitSafety.js

@@ -0,0 +1,73 @@
+/**
+ * Confirm git can undo whatever setup is about to do.
+ *
+ * A coding agent may be about to edit files in this directory; git is the
+ * undo button. Both gates are opt-in selects with the safe option first.
+ * Headless mode proceeds only on a clean repo.
+ */
+import * as COPY from "../copy.js";
+import { SetupFatalError } from "../errors.js";
+import { selectBoolean } from "../ui/selectBoolean.js";
+const MAX_LISTED_FILES = 20;
+export async function confirmGitSafety(deps, { headless }) {
+    const repoCheck = await deps.processes.exec({
+        command: "git",
+        args: ["rev-parse", "--is-inside-work-tree"],
+        cwd: deps.context.cwd,
+    });
+    const isGitRepository = repoCheck.exitCode === 0 && repoCheck.stdout.trim() === "true";
+    if (!isGitRepository) {
+        // `git` missing entirely is treated the same as "not a repo".
+        if (headless) {
+            throw new SetupFatalError(COPY.GIT.headlessNotARepo);
+        }
+        const proceed = await selectBoolean({
+            prompter: deps.prompter,
+            message: COPY.GIT.notARepoMessage,
+            noFirst: true,
+            noLabel: COPY.GIT.notARepoNo,
+            noHint: COPY.GIT.notARepoNoHint,
+            yesLabel: COPY.GIT.notARepoYes,
+            yesHint: COPY.GIT.notARepoYesHint,
+        });
+        if (!proceed) {
+            deps.prompter.line(COPY.GIT.stopped);
+        }
+        return { isGitRepository, proceed };
+    }
+    const statusCheck = await deps.processes.exec({
+        command: "git",
+        args: ["status", "--porcelain=v1"],
+        cwd: deps.context.cwd,
+    });
+    const dirtyPaths = statusCheck.stdout
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean);
+    if (dirtyPaths.length === 0) {
+        return { isGitRepository, proceed: true };
+    }
+    if (headless) {
+        throw new SetupFatalError(COPY.GIT.headlessDirty);
+    }
+    const shown = dirtyPaths.slice(0, MAX_LISTED_FILES);
+    const lines = [...shown];
+    if (dirtyPaths.length > MAX_LISTED_FILES) {
+        lines.push(COPY.GIT.andMore(dirtyPaths.length - MAX_LISTED_FILES));
+    }
+    deps.prompter.note(lines.join("\n"), COPY.GIT.dirtyFileListTitle);
+    const proceed = await selectBoolean({
+        prompter: deps.prompter,
+        message: COPY.GIT.dirtyMessage(dirtyPaths.length),
+        noFirst: true,
+        noLabel: COPY.GIT.dirtyNo,
+        noHint: COPY.GIT.dirtyNoHint,
+        yesLabel: COPY.GIT.dirtyYes,
+        yesHint: COPY.GIT.dirtyYesHint,
+    });
+    if (!proceed) {
+        deps.prompter.line(COPY.GIT.stopped);
+    }
+    return { isGitRepository, proceed };
+}
+//# sourceMappingURL=confirmGitSafety.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * 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 type { SetupDeps } from "../deps/index.js";
+import type { SetupInputs } from "../options.js";
+export interface Connection {
+    /** Normalized origin, no trailing slash. */
+    endpoint: string;
+    projectName: string;
+    /** Present iff auth is enabled on the deployment. */
+    apiKey?: string;
+}
+/** Names are used as URL path identifiers; '/', '?', '#' are invalid. */
+export declare function validateProjectName(value: string): string | undefined;
+export declare function defaultProjectName(cwd: string): string;
+export interface EstablishConnectionArgs {
+    endpoint: string;
+    authEnabled: boolean;
+    inputs: SetupInputs;
+}
+export declare function establishConnection(deps: Pick<SetupDeps, "context" | "createClient" | "prompter">, { endpoint, authEnabled, inputs }: EstablishConnectionArgs): Promise<Connection>;
+//# sourceMappingURL=establishConnection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"establishConnection.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/establishConnection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMrE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGtD;AA+ID,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,cAAc,GAAG,UAAU,CAAC,EAC9D,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,uBAAuB,GACzD,OAAO,CAAC,UAAU,CAAC,CAgBrB"}

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"}