@arizeai/phoenix-cli 1.8.1 → 1.9.0

package/build/setup/options.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Input resolution for setup.
+ *
+ * Follows px's `resolveConfig()` precedence — flags, then env, then
+ * defaults — additionally accepting `PHOENIX_COLLECTOR_ENDPOINT` and
+ * `PHOENIX_PROJECT_NAME` as endpoint/project aliases (#14131). There are no
+ * setup-specific env vars. Reads env only through `RunContext.env`.
+ *
+ * Note the `--no-input` flag (or a non-TTY stdin) — not the presence of env
+ * vars — is what opts into headless behavior: an ambient `PHOENIX_API_KEY`
+ * in a dev shell never silently short-circuits the interactive flow.
+ */
+import { type CodingAgentId } from "./agents/registry.js";
+import type { DocsPrefetchOptions, RunContext } from "./deps/index.js";
+/**
+ * The parsed `px setup` flags, as the command layer hands them over. Every
+ * choice setup would prompt for has a field here, which is what lets an
+ * unattended caller — CI, or a coding agent — run the same flow a human
+ * clicks through. Raw material for {@link resolveSetupInputs}; steps only
+ * ever see the resolved {@link SetupInputs}.
+ */
+export interface SetupOptions {
+    /** --endpoint: pre-answer the endpoint question */
+    endpoint?: string;
+    /** --project: name or Relay Global ID */
+    project?: string;
+    /** --no-input: headless mode (also auto-on when !stdin.isTTY, per px convention) */
+    noInput?: boolean;
+    /**
+     * Hidden --api-url: base URL for setup's own API calls (dev).
+     * User-facing values — hand-off files, px profile, traces URLs — keep the
+     * endpoint the user chose.
+     */
+    apiUrl?: string;
+    /**
+     * --agent: pre-answer the instrumentation lane with a coding agent id.
+     * Validated against the registry at the command layer. Headless
+     * instrumentation requires it — there is no prompt to fall back to.
+     */
+    agent?: CodingAgentId;
+    /**
+     * --language: languages to instrument. Passed to the agent so it skips its
+     * own detection; empty means "detect it yourself".
+     */
+    languages?: string[];
+    /**
+     * --instrument / --no-instrument: run the instrumentation hand-off.
+     * Undefined means "decide by lane" — interactive asks, headless skips
+     * (registration-only stays the default for an unattended run, so `px setup
+     * --no-input` in CI never edits source that nobody asked it to touch).
+     */
+    instrument?: boolean;
+    /** --skills / --no-skills: offer the coding-agent skills install. */
+    skills?: boolean;
+    /**
+     * --yolo: let the agent run without its own permission prompts. Required in
+     * practice for a background run, which has no terminal to approve on.
+     */
+    bypassPermissions?: boolean;
+    /**
+     * --background: run the agent to completion without its TUI. Implied when
+     * setup itself is headless — there is no terminal to hand over.
+     */
+    background?: boolean;
+    /** Docs prefetch, so the agent instruments against local docs. */
+    docs?: DocsPrefetchOptions;
+}
+export interface SetupInputs {
+    /** Pre-answered endpoint (flag, else env), if any. */
+    endpoint?: string;
+    /** Pre-answered project name or Relay Global ID (flag, else env), if any. */
+    project?: string;
+    /** API key from env — used by the headless auth-on lane only. */
+    apiKey?: string;
+    /** True when --no-input was passed or stdin is not a TTY. */
+    headless: boolean;
+    /** Pre-answered instrumentation lane, if `--agent` named one. */
+    agent?: CodingAgentId;
+    /** Languages to instrument; empty means the agent detects them itself. */
+    languages: string[];
+    /**
+     * Whether to run the instrumentation hand-off. Interactive defaults to
+     * true (it is the point of setup); headless defaults to false, so an
+     * unattended run registers without ever editing source unless asked.
+     */
+    instrument: boolean;
+    /** Whether to offer/install the coding-agent skills; undefined means ask. */
+    skills?: boolean;
+    /** Run the agent without its TUI. Always true when setup is headless. */
+    background: boolean;
+    /** Run the agent without its own permission prompts (`--yolo`). */
+    bypassPermissions: boolean;
+    /** Docs prefetch; only consulted when `instrument` is true. */
+    docs: DocsPrefetchOptions;
+}
+/**
+ * A headless run that instruments must name its agent: there is no prompt to
+ * pick a lane from, and silently falling back to one would be a coin flip over
+ * which agent edits the caller's source.
+ *
+ * `px setup instrument` calls this directly — its lane is instrumentation by
+ * definition, so it never passes `--instrument` for `resolveSetupInputs` to
+ * catch.
+ */
+export declare function assertAgentForHeadlessInstrument({ headless, agent, }: {
+    headless: boolean;
+    agent?: CodingAgentId;
+}): void;
+export declare function resolveSetupInputs({ options, context, }: {
+    options: SetupOptions;
+    context: Pick<RunContext, "env" | "stdinIsTTY">;
+}): SetupInputs;
+//# sourceMappingURL=options.d.ts.map

package/build/setup/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/setup/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAG9D;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kEAAkE;IAClE,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;;OAIG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,UAAU,EAAE,OAAO,CAAC;IACpB,mEAAmE;IACnE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,IAAI,EAAE,mBAAmB,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,EAC/C,QAAQ,EACR,KAAK,GACN,EAAE;IACD,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,GAAG,IAAI,CAIP;AAED,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,OAAO,GACR,EAAE;IACD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,YAAY,CAAC,CAAC;CACjD,GAAG,WAAW,CAqCd"}

package/build/setup/options.js

@@ -0,0 +1,63 @@
+/**
+ * Input resolution for setup.
+ *
+ * Follows px's `resolveConfig()` precedence — flags, then env, then
+ * defaults — additionally accepting `PHOENIX_COLLECTOR_ENDPOINT` and
+ * `PHOENIX_PROJECT_NAME` as endpoint/project aliases (#14131). There are no
+ * setup-specific env vars. Reads env only through `RunContext.env`.
+ *
+ * Note the `--no-input` flag (or a non-TTY stdin) — not the presence of env
+ * vars — is what opts into headless behavior: an ambient `PHOENIX_API_KEY`
+ * in a dev shell never silently short-circuits the interactive flow.
+ */
+import { CODING_AGENT_IDS } from "./agents/registry.js";
+import * as COPY from "./copy.js";
+import { HeadlessInputError } from "./errors.js";
+/**
+ * A headless run that instruments must name its agent: there is no prompt to
+ * pick a lane from, and silently falling back to one would be a coin flip over
+ * which agent edits the caller's source.
+ *
+ * `px setup instrument` calls this directly — its lane is instrumentation by
+ * definition, so it never passes `--instrument` for `resolveSetupInputs` to
+ * catch.
+ */
+export function assertAgentForHeadlessInstrument({ headless, agent, }) {
+    if (headless && agent === undefined) {
+        throw new HeadlessInputError(COPY.HEADLESS.agentRequired(CODING_AGENT_IDS));
+    }
+}
+export function resolveSetupInputs({ options, context, }) {
+    const { env } = context;
+    const endpoint = options.endpoint ??
+        env.PHOENIX_HOST ??
+        env.PHOENIX_COLLECTOR_ENDPOINT ??
+        undefined;
+    const project = options.project ??
+        env.PHOENIX_PROJECT ??
+        env.PHOENIX_PROJECT_NAME ??
+        undefined;
+    const apiKey = env.PHOENIX_API_KEY ?? undefined;
+    const headless = Boolean(options.noInput) || !context.stdinIsTTY;
+    // Interactive setup exists to instrument; an unattended run does not
+    // touch source unless the caller asked for it by name.
+    const instrument = options.instrument ?? !headless;
+    if (instrument) {
+        assertAgentForHeadlessInstrument({ headless, agent: options.agent });
+    }
+    return {
+        endpoint: endpoint?.trim() || undefined,
+        project: project?.trim() || undefined,
+        apiKey: apiKey?.trim() || undefined,
+        headless,
+        agent: options.agent,
+        languages: options.languages ?? [],
+        instrument,
+        skills: options.skills,
+        // A headless run has no terminal to hand to the agent's TUI.
+        background: options.background ?? headless,
+        bypassPermissions: Boolean(options.bypassPermissions),
+        docs: options.docs ?? { enabled: true },
+    };
+}
+//# sourceMappingURL=options.js.map

package/build/setup/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/setup/options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,gBAAgB,EAAsB,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAE/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAqF9C;;;;;;;;GAQG;AACH,MAAM,UAAU,gCAAgC,CAAC,EAC/C,QAAQ,EACR,KAAK,GAIN;IACC,IAAI,QAAQ,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACpC,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EACjC,OAAO,EACP,OAAO,GAIR;IACC,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC;IACxB,MAAM,QAAQ,GACZ,OAAO,CAAC,QAAQ;QAChB,GAAG,CAAC,YAAY;QAChB,GAAG,CAAC,0BAA0B;QAC9B,SAAS,CAAC;IACZ,MAAM,OAAO,GACX,OAAO,CAAC,OAAO;QACf,GAAG,CAAC,eAAe;QACnB,GAAG,CAAC,oBAAoB;QACxB,SAAS,CAAC;IACZ,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,IAAI,SAAS,CAAC;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;IAEjE,qEAAqE;IACrE,uDAAuD;IACvD,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAC;IAEnD,IAAI,UAAU,EAAE,CAAC;QACf,gCAAgC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,SAAS;QACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,SAAS;QACrC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,SAAS;QACnC,QAAQ;QACR,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,UAAU;QACV,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,6DAA6D;QAC7D,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,QAAQ;QAC1C,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC;QACrD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;KACxC,CAAC;AACJ,CAAC"}

package/build/setup/prompts/instrumentationPrompt.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The instrumentation prompt handed to a coding agent.
+ *
+ * One shared template serves the launched-agent and copy-to-clipboard lanes.
+ * Every rule is load-bearing — do not trim a rule without replacing the
+ * protection it provides. The prompt leans
+ * on the docs for package names and APIs (language-scoped quickstarts plus
+ * the integrations index) rather than inlining instructions that go stale.
+ * Setup independently verifies traces against the Phoenix API after the
+ * agent finishes, so the agent's job ends with an emitted trace, not a
+ * self-report.
+ */
+export interface InstrumentationPromptDocs {
+    /** Python quickstart (arize-phoenix-otel). */
+    quickstartPython: string;
+    /** TypeScript quickstart (@arizeai/phoenix-otel). */
+    quickstartTypeScript: string;
+    /** phoenix.otel register() reference. */
+    phoenixOtelSetup: string;
+    /** Per-framework/provider auto-instrumentation guides. */
+    integrationsIndex: string;
+}
+export interface InstrumentationPromptArgs {
+    projectName: string;
+    endpoint: string;
+    isDefaultEndpoint: boolean;
+    docs: InstrumentationPromptDocs;
+    tracesUrl: string;
+    authEnabled: boolean;
+    /**
+     * `--language` values. Non-empty replaces the agent's own language
+     * detection, which is the slowest and least reliable thing it does.
+     */
+    languages?: string[];
+    /**
+     * Directory the docs prefetch wrote, when it ran. The agent reads those
+     * pages from disk instead of fetching the URLs mid-run.
+     */
+    localDocsDir?: string;
+}
+export declare function buildInstrumentationPrompt({ projectName, endpoint, isDefaultEndpoint, docs, tracesUrl, authEnabled, languages, localDocsDir, }: InstrumentationPromptArgs): string;
+//# sourceMappingURL=instrumentationPrompt.d.ts.map

package/build/setup/prompts/instrumentationPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentationPrompt.d.ts","sourceRoot":"","sources":["../../../src/setup/prompts/instrumentationPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,yBAAyB;IACxC,8CAA8C;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,IAAI,EAAE,yBAAyB,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CAAC,EACzC,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,IAAI,EACJ,SAAS,EACT,WAAW,EACX,SAAc,EACd,YAAY,GACb,EAAE,yBAAyB,GAAG,MAAM,CAoDpC"}

package/build/setup/prompts/instrumentationPrompt.js

@@ -0,0 +1,64 @@
+/**
+ * The instrumentation prompt handed to a coding agent.
+ *
+ * One shared template serves the launched-agent and copy-to-clipboard lanes.
+ * Every rule is load-bearing — do not trim a rule without replacing the
+ * protection it provides. The prompt leans
+ * on the docs for package names and APIs (language-scoped quickstarts plus
+ * the integrations index) rather than inlining instructions that go stale.
+ * Setup independently verifies traces against the Phoenix API after the
+ * agent finishes, so the agent's job ends with an emitted trace, not a
+ * self-report.
+ */
+export function buildInstrumentationPrompt({ projectName, endpoint, isDefaultEndpoint, docs, tracesUrl, authEnabled, languages = [], localDocsDir, }) {
+    const credentialVars = authEnabled
+        ? "PHOENIX_COLLECTOR_ENDPOINT and PHOENIX_API_KEY"
+        : "PHOENIX_COLLECTOR_ENDPOINT";
+    const endpointRule = isDefaultEndpoint
+        ? ""
+        : `\n   Also set the collector endpoint in code only if the quickstart says to; it is ${endpoint}.`;
+    const languageRule = languages.length > 0
+        ? `The app's language is ${languages.join(" and ")} — do not spend time detecting it.`
+        : "Detect the app's language, follow the matching quickstart, and use the integration guide\nfor the app's LLM framework or provider.";
+    const localDocsRule = localDocsDir
+        ? `\nThese pages are already downloaded to ${localDocsDir} — read them from disk first, and only\nfetch a URL if the page you need is missing there.`
+        : "";
+    return `You are running as part of the Phoenix setup script. Your ONLY task is to add Phoenix
+tracing to the application in the current working directory and emit one verification
+trace. Do not run setup tools, onboarding scripts, or "px setup" again.
+
+Work from the official docs — do not guess package names or APIs from memory:
+- Python quickstart (arize-phoenix-otel): ${docs.quickstartPython}
+- TypeScript quickstart (@arizeai/phoenix-otel): ${docs.quickstartTypeScript}
+- register() reference: ${docs.phoenixOtelSetup}
+- Auto-instrumentation guides by framework/provider: ${docs.integrationsIndex}${localDocsRule}
+${languageRule}
+
+Rules:
+1. Tracing only. Do not add evals, datasets, prompts, dashboards, or any other feature.
+2. Credentials are provided via environment variables (${credentialVars}), which Phoenix SDKs read
+   automatically. If they are not set in your shell, apply them with
+   \`set -a; source .env.phoenix; set +a\` before the verification run. NEVER print the
+   contents of \`.env.phoenix\`, never print the API key, and never
+   write the API key or any secret into source code, config files, or command arguments.
+3. Configure the Phoenix project name in code: use the SDK's register call with the
+   project name "${projectName}".${endpointRule}
+4. Prefer auto-instrumentation packages over hand-written span wrappers. Make the smallest
+   correct change.
+5. Verify your work by emitting exactly one trace: run the app briefly, or a minimal
+   throwaway script that makes one real LLM call through the instrumented path, then
+   delete any throwaway script. Do not run the full test suite or the build.
+6. Install SDK packages with the project's existing package manager, pinned to the latest
+   stable version you can verify. If this is a monorepo, note the root but only modify
+   files at or below the current working directory.
+7. Keep changes concise and readable. Do not restructure, reformat, or meaningfully modify
+   existing application code.
+8. Do not use the \`px\` CLI.
+
+When finished, end your final message with a one-line summary of the changes you made and
+this link to the project's traces: ${tracesUrl}
+If you could not complete the task or could not emit a verification trace, say so plainly
+with a one-paragraph reason instead.
+`;
+}
+//# sourceMappingURL=instrumentationPrompt.js.map

package/build/setup/prompts/instrumentationPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentationPrompt.js","sourceRoot":"","sources":["../../../src/setup/prompts/instrumentationPrompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAgCH,MAAM,UAAU,0BAA0B,CAAC,EACzC,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,IAAI,EACJ,SAAS,EACT,WAAW,EACX,SAAS,GAAG,EAAE,EACd,YAAY,GACc;IAC1B,MAAM,cAAc,GAAG,WAAW;QAChC,CAAC,CAAC,gDAAgD;QAClD,CAAC,CAAC,4BAA4B,CAAC;IACjC,MAAM,YAAY,GAAG,iBAAiB;QACpC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,sFAAsF,QAAQ,GAAG,CAAC;IACtG,MAAM,YAAY,GAChB,SAAS,CAAC,MAAM,GAAG,CAAC;QAClB,CAAC,CAAC,yBAAyB,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,oCAAoC;QACtF,CAAC,CAAC,oIAAoI,CAAC;IAC3I,MAAM,aAAa,GAAG,YAAY;QAChC,CAAC,CAAC,2CAA2C,YAAY,4FAA4F;QACrJ,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;;4CAKmC,IAAI,CAAC,gBAAgB;mDACd,IAAI,CAAC,oBAAoB;0BAClD,IAAI,CAAC,gBAAgB;uDACQ,IAAI,CAAC,iBAAiB,GAAG,aAAa;EAC3F,YAAY;;;;yDAI2C,cAAc;;;;;;mBAMpD,WAAW,KAAK,YAAY;;;;;;;;;;;;;;qCAcV,SAAS;;;CAG7C,CAAC;AACF,CAAC"}

package/build/setup/runSetup.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The setup step sequence, and nothing else.
+ *
+ * All effects flow through `SetupDeps`; all strings live in `copy.ts`;
+ * cancellation unwinds via `SetupCancelledError` to the command handler.
+ *
+ * Three entry points, composed from the same steps:
+ *   - `runSetup`      — the whole flow (`px setup`)
+ *   - `runInstrument` — register, then instrument and verify (`px setup instrument`)
+ *   - `runSkills`     — the tooling installs alone (`px setup skills`)
+ * Each returns a {@link SetupReport}, which the command layer renders in the
+ * requested `--format`.
+ */
+import type { DocsPrefetchResult, SetupDeps } from "./deps/index.js";
+import type { SetupInputs } from "./options.js";
+import type { Connection } from "./steps/establishConnection.js";
+import { type ToolingResult } from "./steps/installTooling.js";
+import { type InstrumentationLane } from "./steps/instrumentApp.js";
+/** Everything a run did, in the shape the summary and `--format json` print. */
+export interface SetupReport {
+    connection: Connection;
+    authEnabled: boolean;
+    headless: boolean;
+    /** Files setup wrote into the repo. */
+    files: string[];
+    /** Paths appended to a .gitignore. */
+    gitignored: string[];
+    docs?: DocsPrefetchResult;
+    instrumentation?: InstrumentationLane;
+    /** True once the API confirmed a trace arrived after this run started. */
+    tracesVerified?: boolean;
+    tooling?: ToolingResult;
+    tracesUrl: string;
+}
+/** `px setup` — the whole flow. */
+export declare function runSetup(deps: SetupDeps, inputs: SetupInputs): Promise<SetupReport>;
+/**
+ * `px setup instrument` — the instrumentation slice, re-runnable on a repo that
+ * is already registered. Registration still runs: it is idempotent, and it is
+ * what produces the connection the agent and the verification step need.
+ */
+export declare function runInstrument(deps: SetupDeps, resolved: SetupInputs): Promise<SetupReport>;
+/** `px setup skills` — the tooling installs alone; no connection needed. */
+export declare function runSkills(deps: SetupDeps, inputs: SetupInputs): Promise<ToolingResult>;
+//# sourceMappingURL=runSetup.d.ts.map

package/build/setup/runSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runSetup.d.ts","sourceRoot":"","sources":["../../src/setup/runSetup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAUhF,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,sCAAsC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,eAAe,CAAC,EAAE,mBAAmB,CAAC;IACtC,0EAA0E;IAC1E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAeD,mCAAmC;AACnC,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CA8CtB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,WAAW,GACpB,OAAO,CAAC,WAAW,CAAC,CAetB;AAED,4EAA4E;AAC5E,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,CAAC,CAexB"}

package/build/setup/runSetup.js

@@ -0,0 +1,212 @@
+/**
+ * The setup step sequence, and nothing else.
+ *
+ * All effects flow through `SetupDeps`; all strings live in `copy.ts`;
+ * cancellation unwinds via `SetupCancelledError` to the command handler.
+ *
+ * Three entry points, composed from the same steps:
+ *   - `runSetup`      — the whole flow (`px setup`)
+ *   - `runInstrument` — register, then instrument and verify (`px setup instrument`)
+ *   - `runSkills`     — the tooling installs alone (`px setup skills`)
+ * Each returns a {@link SetupReport}, which the command layer renders in the
+ * requested `--format`.
+ */
+import { detectCodingAgents, probeGlobalBinary, } from "./agents/registry.js";
+import * as COPY from "./copy.js";
+import { SetupCancelledError } from "./errors.js";
+import { assertAgentForHeadlessInstrument } from "./options.js";
+import { chooseEndpoint } from "./steps/chooseEndpoint.js";
+import { confirmGitSafety } from "./steps/confirmGitSafety.js";
+import { establishConnection } from "./steps/establishConnection.js";
+import { offerToolingInstalls, } from "./steps/installTooling.js";
+import { instrumentApp } from "./steps/instrumentApp.js";
+import { offerPxProfile } from "./steps/offerPxProfile.js";
+import { prefetchDocs } from "./steps/prefetchDocs.js";
+import { hasSpansInSkewWindow, waitForFirstTrace, tracesUrl, } from "./steps/verifyTraces.js";
+import { ENV_FILE_NAME, writeEnvFile } from "./steps/writeEnvFile.js";
+/**
+ * Detect the installed agents — but only when the lane is still open. `--agent`
+ * pins it, and the pinned agent probes its own binary, so the sweep's four
+ * subprocess spawns would be thrown away. Every headless instrumentation run
+ * names an agent, so that is exactly where the waste would land.
+ */
+function detectAgentsUnlessPinned(deps, inputs) {
+    return inputs.agent ? Promise.resolve([]) : detectCodingAgents(deps);
+}
+/** `px setup` — the whole flow. */
+export async function runSetup(deps, inputs) {
+    // Started before the first prompt so the probes finish behind it; awaited
+    // by the instrumentation and tooling steps.
+    const agentDetection = detectAgentsUnlessPinned(deps, inputs);
+    // Probed with package-runner bin dirs stripped from PATH — under
+    // `npx @arizeai/phoenix-cli setup`, the package's own `px` shim must not
+    // masquerade as a global install and suppress the CLI-install offer.
+    const pxOnPath = probeGlobalBinary(deps, "px");
+    if (!inputs.headless) {
+        deps.prompter.intro(COPY.INTRO);
+    }
+    const report = await registerAndInstrument(deps, inputs, { agentDetection });
+    // A headless run stops here: the tooling offers are prompts, and its stdout
+    // belongs to the summary.
+    if (inputs.headless) {
+        return report;
+    }
+    // Tooling opt-ins come after the verified-trace moment so nothing stands
+    // between launch and first trace: point px at this project, then install the
+    // CLI and skills so the user (and their coding agent) can look at the traces
+    // now flowing.
+    await offerPxProfile(deps, {
+        connection: report.connection,
+        settingsPath: deps.context.settingsPath,
+    });
+    const tooling = await offerToolingInstalls(deps, {
+        pxOnPath,
+        skills: inputs.skills,
+        canPrompt: true,
+    });
+    deps.prompter.note(report.authEnabled
+        ? COPY.PRODUCTION.bodyAuthOn
+        : COPY.PRODUCTION.bodyAuthOff, COPY.PRODUCTION.title);
+    // Untitled: the outro below already says it, and closes the rail.
+    deps.prompter.note(COPY.OUTRO_BODY);
+    deps.prompter.outro(COPY.OUTRO_TITLE);
+    return { ...report, tooling };
+}
+/**
+ * `px setup instrument` — the instrumentation slice, re-runnable on a repo that
+ * is already registered. Registration still runs: it is idempotent, and it is
+ * what produces the connection the agent and the verification step need.
+ */
+export async function runInstrument(deps, resolved) {
+    // This lane instruments by definition, so it never passes `--instrument` for
+    // `resolveSetupInputs` to have guarded — check the headless rule here.
+    assertAgentForHeadlessInstrument(resolved);
+    const inputs = { ...resolved, instrument: true };
+    const agentDetection = detectAgentsUnlessPinned(deps, inputs);
+    if (!inputs.headless) {
+        deps.prompter.intro(COPY.INTRO_INSTRUMENT);
+    }
+    const report = await registerAndInstrument(deps, inputs, { agentDetection });
+    if (!inputs.headless) {
+        deps.prompter.outro(COPY.OUTRO_TITLE);
+    }
+    return report;
+}
+/** `px setup skills` — the tooling installs alone; no connection needed. */
+export async function runSkills(deps, inputs) {
+    const pxOnPath = probeGlobalBinary(deps, "px");
+    if (!inputs.headless) {
+        deps.prompter.intro(COPY.INTRO_SKILLS);
+    }
+    const tooling = await offerToolingInstalls(deps, {
+        pxOnPath,
+        skills: inputs.skills,
+        canPrompt: !inputs.headless,
+    });
+    if (!inputs.headless) {
+        deps.prompter.outro(COPY.OUTRO_TITLE);
+    }
+    return tooling;
+}
+/**
+ * Register, then — when asked — prefetch docs, hand off to the agent, and
+ * verify traces. The shared spine of `px setup` and `px setup instrument`.
+ */
+async function registerAndInstrument(deps, inputs, { agentDetection }) {
+    const registration = await register(deps, inputs);
+    const { connection, authEnabled, gitignoreAppended } = registration;
+    const base = {
+        connection,
+        authEnabled,
+        headless: inputs.headless,
+        files: [ENV_FILE_NAME],
+        gitignored: gitignoreAppended,
+        tracesUrl: tracesUrl(connection),
+    };
+    if (!inputs.instrument) {
+        return base;
+    }
+    // Only after registration's git-safety gate: the docs fetch writes into
+    // `.px/`, which an earlier download can make look like a pre-existing dirty
+    // tree in a fast or cached headless run.
+    const docs = await prefetchDocs(deps, {
+        docs: inputs.docs,
+        isGitRepository: registration.isGitRepository,
+    });
+    const startedAt = deps.clock.now();
+    // Any span already visible inside the clock-skew window predates this run —
+    // verification must then require spans strictly after the start time, or a
+    // pre-existing trace would falsely verify the hand-off.
+    const hadRecentSpans = await hasSpansInSkewWindow(deps, connection, {
+        sinceMs: startedAt,
+    });
+    const instrumentation = await instrumentApp(deps, connection, {
+        authEnabled,
+        agentDetection,
+        agent: inputs.agent,
+        languages: inputs.languages,
+        mode: {
+            background: inputs.background,
+            bypassPermissions: inputs.bypassPermissions,
+        },
+        ...(docs ? { docs } : {}),
+    });
+    // The return value is setup's definition of done — a trace the API confirmed
+    // arriving, not the agent's own claim that it finished. It is reported, not
+    // thrown on: the connection and hand-off files are real work worth keeping
+    // even when no trace showed up.
+    const tracesVerified = await waitForFirstTrace(deps, connection, {
+        sinceMs: startedAt,
+        allowClockSkew: !hadRecentSpans,
+        headless: inputs.headless,
+    });
+    return {
+        ...base,
+        ...(docs ? { docs } : {}),
+        // The docs step gitignores its own output dir, so the report has to fold
+        // those appends in or it under-states what setup touched.
+        gitignored: [...base.gitignored, ...(docs?.gitignoreAppended ?? [])],
+        instrumentation,
+        tracesVerified,
+    };
+}
+/**
+ * Git safety, endpoint, connection, env file — the part every lane shares, and
+ * all a registration-only run performs.
+ */
+async function register(deps, inputs) {
+    const { headless } = inputs;
+    const git = await confirmGitSafety(deps, { headless });
+    if (!git.proceed) {
+        throw new SetupCancelledError();
+    }
+    // The hidden --api-url dev flag never reaches this endpoint — it is applied
+    // as the client's base URL in buildDefaultDeps, so API traffic is rerouted
+    // while hand-off files, the px profile, and traces URLs keep the endpoint
+    // resolved here.
+    const endpointChoice = await chooseEndpoint(deps, {
+        presetEndpoint: inputs.endpoint,
+        headless,
+    });
+    const connection = await establishConnection(deps, {
+        endpoint: endpointChoice.endpoint,
+        authEnabled: endpointChoice.authEnabled,
+        inputs,
+    });
+    const envFile = writeEnvFile(deps, connection, {
+        isGitRepository: git.isGitRepository,
+    });
+    if (!headless) {
+        deps.prompter.line(COPY.ENV_FILE.wrote([ENV_FILE_NAME]));
+        if (envFile.gitignoreAppended.length > 0) {
+            deps.prompter.line(COPY.ENV_FILE.gitignored(envFile.gitignoreAppended));
+        }
+    }
+    return {
+        connection,
+        authEnabled: endpointChoice.authEnabled,
+        gitignoreAppended: envFile.gitignoreAppended,
+        isGitRepository: git.isGitRepository,
+    };
+}
+//# sourceMappingURL=runSetup.js.map

package/build/setup/runSetup.js.map

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

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

@@ -0,0 +1,36 @@
+/**
+ * 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 type { SetupDeps } from "../deps/index.js";
+export interface EndpointChoice {
+    /** Normalized origin, no trailing slash. */
+    endpoint: string;
+    authEnabled: boolean;
+}
+export type ProbeOutcome = {
+    kind: "authOff";
+} | {
+    kind: "authOn";
+} | {
+    kind: "unreachable";
+    detail: string;
+} | {
+    kind: "notPhoenix";
+    detail: string;
+};
+/**
+ * Probe an endpoint to determine reachability and whether auth is enabled.
+ */
+export declare function probeEndpoint(deps: Pick<SetupDeps, "createClient">, endpoint: string): Promise<ProbeOutcome>;
+export interface ChooseEndpointArgs {
+    /** Pre-answered endpoint from --endpoint / env (skips the select). */
+    presetEndpoint?: string;
+    headless: boolean;
+}
+export declare function chooseEndpoint(deps: Pick<SetupDeps, "createClient" | "prompter">, { presetEndpoint, headless }: ChooseEndpointArgs): Promise<EndpointChoice>;
+//# sourceMappingURL=chooseEndpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chooseEndpoint.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/chooseEndpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAQzC,MAAM,WAAW,cAAc;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAMD,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C;;GAEG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EACrC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAsBvB;AA+BD,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,cAAc,GAAG,UAAU,CAAC,EAClD,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,kBAAkB,GAC/C,OAAO,CAAC,cAAc,CAAC,CA+DzB"}