@arizeai/phoenix-cli 1.8.1 → 1.9.1

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":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQpD,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAA2D,EAC3D,EAAE,QAAQ,EAAyB;IAEnC,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1C,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC;QAC5C,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;KACtB,CAAC,CAAC;IACH,MAAM,eAAe,GACnB,SAAS,CAAC,QAAQ,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC;IAEjE,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,8DAA8D;QAC9D,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC;YAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe;YACjC,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU;YAC5B,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc;YAC/B,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW;YAC9B,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,eAAe;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC;IACtC,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC5C,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC;QAClC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;KACtB,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM;SAClC,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC5C,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IACzB,IAAI,UAAU,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAElE,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC;QAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC;QACjD,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO;QACzB,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW;QAC5B,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ;QAC3B,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY;KAC/B,CAAC,CAAC;IACH,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * 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. When the instance runs
+ * the OAuth2 authorization server, the interactive lane offers a streamlined
+ * path first — log in with the browser, mint an API key over REST, revoke the
+ * grant that login created — and every failure along it falls back to the
+ * paste prompt rather than aborting setup.
+ */
+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" | "oauthLogin">, { 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;;;;;;;;;;;;GAYG;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;AA6QD,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,GAAG,YAAY,CAAC,EAC7E,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,uBAAuB,GACzD,OAAO,CAAC,UAAU,CAAC,CAgBrB"}

package/build/setup/steps/establishConnection.js

@@ -0,0 +1,252 @@
+/**
+ * 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. When the instance runs
+ * the OAuth2 authorization server, the interactive lane offers a streamlined
+ * path first — log in with the browser, mint an API key over REST, revoke the
+ * grant that login created — and every failure along it falls back to the
+ * paste prompt rather than aborting setup.
+ */
+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();
+}
+/** A REST failure, as a short phrase to show the user. */
+function describeRestError(error) {
+    if (error instanceof HttpError) {
+        return `HTTP ${error.status}`;
+    }
+    // A 2xx whose body will not parse: something answered, but not the Phoenix
+    // API. The raw parser message would only confuse.
+    if (error instanceof SyntaxError) {
+        return COPY.ENDPOINT.unexpectedBody;
+    }
+    return redactForDisplay(String(error));
+}
+/**
+ * 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 &&
+            (error.status === 401 || error.status === 403)) {
+            return { kind: "rejected", status: error.status };
+        }
+        return { kind: "error", detail: describeRestError(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();
+}
+/**
+ * Log in via the browser, then mint a personal API key over REST. Every
+ * failure returns `undefined` after narrating why, sending the lane to the
+ * paste prompt — the login is a shortcut, never a wall.
+ */
+async function acquireApiKeyViaLogin(deps, endpoint, projectName) {
+    // Ctrl-C here means "give up on the browser", not "abandon setup" — the
+    // paste prompt below is still a way forward, and the project name the user
+    // already gave is still good.
+    const outcome = await deps.prompter.runInterruptible((signal) => deps.oauthLogin.login({
+        endpoint,
+        onAuthorizationUrl: (url) => deps.prompter.note(COPY.CREDENTIALS.authorizationUrl(url)),
+        onBrowserOpenFailed: (detail) => deps.prompter.line(COPY.CREDENTIALS.browserOpenFailed(redactForDisplay(detail))),
+        signal,
+    }));
+    if (outcome.status === "cancelled") {
+        deps.prompter.line(COPY.CREDENTIALS.loginCancelled);
+        return undefined;
+    }
+    if (outcome.status === "error") {
+        deps.prompter.line(COPY.CREDENTIALS.loginFailed(redactForDisplay(outcome.detail)));
+        return undefined;
+    }
+    try {
+        const client = deps.createClient({
+            endpoint,
+            apiKey: outcome.accessToken,
+        });
+        const name = `px-setup ${projectName}`;
+        const response = await client.POST("/v1/user/api_keys", {
+            body: {
+                data: {
+                    name,
+                    description: `Created by px setup for project "${projectName}".`,
+                },
+            },
+            signal: AbortSignal.timeout(REST_TIMEOUT_MS),
+        });
+        const key = response.data?.data.key;
+        if (!key) {
+            deps.prompter.line(COPY.CREDENTIALS.keyCreateFailed("empty key in response"));
+            return undefined;
+        }
+        deps.prompter.line(COPY.CREDENTIALS.keyCreated(name));
+        return key;
+    }
+    catch (error) {
+        deps.prompter.line(COPY.CREDENTIALS.keyCreateFailed(describeRestError(error)));
+        return undefined;
+    }
+    finally {
+        // The access token has served its one purpose. Ending the grant leaves the
+        // key in local files as the only credential this run created — without it,
+        // a refresh token setup no longer holds stays live for its full lifetime
+        // (a week by default). This does not touch an existing `px auth login`.
+        await outcome.revoke().catch(() => { });
+    }
+}
+/**
+ * The project name comes first so the browser-login path can stamp it into
+ * the minted key's name. A rejected key returns to the masked credential
+ * prompt without asking for the project name again.
+ */
+async function connectAuthOnInteractive(deps, endpoint, inputs) {
+    // Start the probe before the prompt so it can run while the user types (when
+    // --project is given there is no prompt, and this is simply awaited below).
+    // The `catch` is not redundant: the contract returns Promise<boolean>, and an
+    // implementation that rejected would otherwise go unhandled on the path where
+    // the prompt throws SetupCancelledError before the await below is reached.
+    const supportsLogin = deps.oauthLogin
+        .isSupported(endpoint)
+        .catch(() => false);
+    const projectName = await promptForProjectName(deps, inputs);
+    if (await supportsLogin) {
+        const method = await deps.prompter.select({
+            message: COPY.CREDENTIALS.methodMessage,
+            options: [
+                {
+                    value: "login",
+                    label: COPY.CREDENTIALS.loginLabel,
+                    hint: COPY.CREDENTIALS.loginHint,
+                },
+                {
+                    value: "paste",
+                    label: COPY.CREDENTIALS.pasteLabel,
+                    hint: COPY.CREDENTIALS.pasteHint,
+                },
+            ],
+        });
+        if (method === "login") {
+            const apiKey = await acquireApiKeyViaLogin(deps, endpoint, projectName);
+            if (apiKey !== undefined) {
+                // The key was just minted by an authenticated call to this same
+                // endpoint, so a probe could only re-prove what the mint proved. It
+                // could, however, fail transiently — and the ephemeral session is
+                // already revoked, so a throw here would strand a live key the user
+                // never received and cannot name.
+                deps.prompter.line(COPY.CONNECT.usingProject(projectName));
+                return { endpoint, projectName, apiKey };
+            }
+        }
+    }
+    deps.prompter.note(COPY.API_KEY.instructions, COPY.API_KEY.instructionsTitle);
+    let apiKey = await promptForApiKey(deps);
+    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