@arizeai/phoenix-cli 1.8.1 → 1.9.1

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,60 @@
+/**
+ * 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.
+ *
+ * The lane is resolved before anything docs-related happens: the docs MCP
+ * offer targets exactly the agent being launched, and taking it replaces the
+ * `.px/docs` download outright — the agent searches the docs server on demand
+ * instead of reading prefetched pages. The clipboard and manual lanes have no
+ * known agent to configure, so they keep the prefetch.
+ *
+ * `--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 { DocsPrefetchOptions, DocsPrefetchResult, SetupDeps } from "../deps/index.js";
+import type { Connection } from "./establishConnection.js";
+import { type DocsMcpResult } from "./offerDocsMcp.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;
+    /** Docs prefetch options; the download runs unless the MCP replaces it. */
+    docs: DocsPrefetchOptions;
+    /** `--docs-mcp` / `--no-docs-mcp`; undefined means ask (when we can). */
+    docsMcp?: boolean;
+    headless: boolean;
+    /** Gates the prefetch's .gitignore append, as in the docs step itself. */
+    isGitRepository: boolean;
+}
+/** Which lane instrumentation actually took — reported in the summary. */
+export type InstrumentationLane = {
+    kind: "agent";
+    agent: CodingAgentId;
+    exitCode: number;
+} | {
+    kind: "clipboard";
+} | {
+    kind: "manual";
+};
+export interface InstrumentAppResult {
+    lane: InstrumentationLane;
+    /** The docs download, when it ran (the MCP taking its place omits it). */
+    docs?: DocsPrefetchResult;
+    /** The docs MCP offer, when a launched agent was there to make it to. */
+    docsMcp?: DocsMcpResult;
+}
+export declare function instrumentApp(deps: Pick<SetupDeps, "context" | "processes" | "prompter" | "writeClipboard" | "fetchDocs">, connection: Connection, args: InstrumentAppArgs): Promise<InstrumentAppResult>;
+//# 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;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EAElB,SAAS,EACV,MAAM,SAAS,CAAC;AAGjB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AASlE,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,2EAA2E;IAC3E,IAAI,EAAE,mBAAmB,CAAC;IAC1B,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,eAAe,EAAE,OAAO,CAAC;CAC1B;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,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,yEAAyE;IACzE,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,CACR,SAAS,EACT,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,gBAAgB,GAAG,WAAW,CACtE,EACD,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAuI9B"}

package/build/setup/steps/instrumentApp.js

@@ -0,0 +1,179 @@
+/**
+ * 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.
+ *
+ * The lane is resolved before anything docs-related happens: the docs MCP
+ * offer targets exactly the agent being launched, and taking it replaces the
+ * `.px/docs` download outright — the agent searches the docs server on demand
+ * instead of reading prefetched pages. The clipboard and manual lanes have no
+ * known agent to configure, so they keep the prefetch.
+ *
+ * `--agent` pre-answers the lane, which is what makes an unattended run
+ * possible: with no TTY there is no prompt to pick a lane from, and the agent
+ * runs in background mode (no TUI to hand the terminal to).
+ */
+import { buildLaunchSpec, getCodingAgent, probeBinary, } from "../agents/registry.js";
+import * as COPY from "../copy.js";
+import { SetupFatalError } from "../errors.js";
+import { buildInstrumentationPrompt } from "../prompts/instrumentationPrompt.js";
+import { offerDocsMcp } from "./offerDocsMcp.js";
+import { prefetchDocs } from "./prefetchDocs.js";
+import { tracesUrl } from "./verifyTraces.js";
+const DEFAULT_LOCAL_ENDPOINT = "http://localhost:6006";
+export async function instrumentApp(deps, connection, args) {
+    const { authEnabled, agentDetection, languages, mode } = args;
+    // Resolve the lane before the docs steps: the MCP offer needs to know which
+    // agent is doing the work, and only then can "skip the download" be decided.
+    let chosenAgent;
+    let fallbackLane = "manual";
+    if (args.agent) {
+        // `--agent` short-circuits the lane prompt. The binary is probed rather
+        // than taken from the detection sweep so a named-but-missing agent fails
+        // with "not on your PATH" instead of silently dropping to another lane.
+        const agent = getCodingAgent(args.agent);
+        if (!agent) {
+            throw new SetupFatalError(COPY.INSTRUMENTATION.unknownAgent(args.agent));
+        }
+        if (!(await probeBinary(deps, agent.binary))) {
+            throw new SetupFatalError(COPY.INSTRUMENTATION.agentNotFound(agent.label, agent.binary));
+        }
+        chosenAgent = agent;
+    }
+    else {
+        const detectedAgents = await agentDetection;
+        const options = [
+            ...detectedAgents.map((agent) => ({
+                value: `agent:${agent.id}`,
+                label: COPY.INSTRUMENTATION.launchLabel(agent.label),
+                hint: COPY.INSTRUMENTATION.launchHint,
+            })),
+            {
+                value: "clipboard",
+                label: COPY.INSTRUMENTATION.clipboardLabel,
+                hint: COPY.INSTRUMENTATION.clipboardHint,
+            },
+            {
+                value: "manual",
+                label: COPY.INSTRUMENTATION.manualLabel,
+                hint: COPY.INSTRUMENTATION.manualHint,
+            },
+        ];
+        const choice = await deps.prompter.select({
+            message: COPY.INSTRUMENTATION.modeMessage,
+            options,
+        });
+        chosenAgent = detectedAgents.find((agent) => choice === `agent:${agent.id}`);
+        fallbackLane = choice === "clipboard" ? "clipboard" : "manual";
+    }
+    // The offer is an optimization and never takes setup down with it — that
+    // contract lives inside offerDocsMcp, which reports any failure and returns
+    // "failed" instead of throwing. Only a user cancel unwinds.
+    let docsMcp;
+    if (chosenAgent) {
+        docsMcp = await offerDocsMcp(deps, {
+            docsMcp: args.docsMcp,
+            agent: chosenAgent,
+            headless: args.headless,
+            docsEnabled: args.docs.enabled,
+        });
+    }
+    else if (args.docsMcp === true) {
+        // An explicit --docs-mcp deserves a word when the lane can't honor it,
+        // same as a pinned agent with no MCP install path.
+        deps.prompter.line(COPY.DOCS_MCP.noAgentLane);
+    }
+    const docs = docsMcp?.outcome === "configured"
+        ? undefined
+        : await prefetchDocs(deps, {
+            docs: args.docs,
+            isGitRepository: args.isGitRepository,
+        });
+    const prompt = buildInstrumentationPrompt({
+        projectName: connection.projectName,
+        endpoint: connection.endpoint,
+        isDefaultEndpoint: connection.endpoint === DEFAULT_LOCAL_ENDPOINT,
+        docs: {
+            quickstartPython: COPY.DOCS.quickstartPython,
+            quickstartTypeScript: COPY.DOCS.quickstartTypeScript,
+            phoenixOtelSetup: COPY.DOCS.phoenixOtelSetup,
+            integrationsIndex: COPY.DOCS.integrationsIndex,
+        },
+        tracesUrl: tracesUrl(connection),
+        authEnabled,
+        languages,
+        // Only advertise the local docs dir when it holds pages — an empty one
+        // (docs site down, over-narrow workflow filter) would send the agent to
+        // read a directory with nothing in it instead of the web.
+        ...(docs?.hasPagesOnDisk ? { localDocsDir: docs.outputDir } : {}),
+        ...(docsMcp?.outcome === "configured" ? { docsMcpConfigured: true } : {}),
+    });
+    if (chosenAgent) {
+        const lane = await launchAgent(deps, connection, {
+            agent: chosenAgent,
+            prompt,
+            mode,
+        });
+        return {
+            lane,
+            ...(docs ? { docs } : {}),
+            ...(docsMcp ? { docsMcp } : {}),
+        };
+    }
+    if (fallbackLane === "clipboard") {
+        const copied = await deps.writeClipboard(prompt);
+        if (copied) {
+            deps.prompter.line(COPY.INSTRUMENTATION.promptCopied);
+        }
+        else {
+            deps.prompter.line(COPY.INSTRUMENTATION.promptCopyFailed);
+            deps.prompter.note(prompt);
+        }
+        await deps.prompter.select({
+            message: COPY.INSTRUMENTATION.clipboardDoneMessage,
+            options: [
+                { value: true, label: COPY.INSTRUMENTATION.clipboardDoneLabel },
+            ],
+        });
+        return { lane: { kind: "clipboard" }, ...(docs ? { docs } : {}) };
+    }
+    deps.prompter.line(COPY.INSTRUMENTATION.manualDocs(COPY.DOCS.instrumentationIndex));
+    await deps.prompter.select({
+        message: COPY.INSTRUMENTATION.manualDoneMessage,
+        options: [{ value: true, label: COPY.INSTRUMENTATION.manualDoneLabel }],
+    });
+    return { lane: { kind: "manual" }, ...(docs ? { docs } : {}) };
+}
+/**
+ * Run the agent with the prompt pre-loaded. A non-zero exit is a warning, not
+ * a failure: the agent may have instrumented the app and then exited badly,
+ * and trace verification — not the agent's exit code — decides whether setup
+ * succeeded.
+ */
+async function launchAgent(deps, connection, { agent, prompt, mode, }) {
+    // Without its TUI *and* without permission bypass, an agent stalls on the
+    // first approval it wants, with no terminal to approve it on — the run then
+    // dies at the verification timeout with nothing to show. Say so up front.
+    if (mode.background && !mode.bypassPermissions) {
+        deps.prompter.line(COPY.INSTRUMENTATION.backgroundNeedsYolo(agent.label));
+    }
+    deps.prompter.line(mode.background
+        ? COPY.INSTRUMENTATION.launchingBackground(agent.label)
+        : COPY.INSTRUMENTATION.launching(agent.label));
+    const spec = buildLaunchSpec(agent, {
+        prompt,
+        cwd: deps.context.cwd,
+        connection,
+        mode,
+    });
+    const { exitCode } = await deps.processes.spawnInteractive(spec);
+    if (exitCode !== 0) {
+        deps.prompter.line(COPY.INSTRUMENTATION.agentExitWarning(agent.label));
+    }
+    return { kind: "agent", agent: agent.id, exitCode };
+}
+//# sourceMappingURL=instrumentApp.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * Offer to connect the Phoenix docs MCP server to the coding agent taking the
+ * hand-off, instead of downloading the docs.
+ *
+ * Taking the offer is the fast path: one small config step replaces the
+ * ~100-page `.px/docs` download, and the agent then searches the docs server
+ * on demand — pulling only the sections it needs instead of reading whole
+ * pages. Declining (or any failure) degrades to the docs prefetch, which is
+ * what setup did before this step existed.
+ *
+ * The offer is an optimization and must never take setup down with it:
+ * whatever goes wrong (an agent CLI whose flags drifted, a config format we
+ * no longer understand), this step reports it, returns a "failed" result, and
+ * the caller carries on with the docs download. The only throw that leaves
+ * this function is a user cancel.
+ *
+ * The offer targets exactly one agent — the lane the user chose (or `--agent`
+ * pinned) — so setup never sprays MCP config for agents that aren't doing the
+ * work. How the entry lands is the agent's own affair ({@link DocsMcpInstall}):
+ * agents with an MCP subcommand register it through their own CLI, the rest
+ * get a merge into their documented config file. Headless runs never touch
+ * agent config unless `--docs-mcp` asked for it.
+ */
+import { type CodingAgent } from "../agents/registry.js";
+import type { SetupDeps } from "../deps/index.js";
+export type DocsMcpOutcome = "configured" | "declined" | "skipped" | "failed";
+/** What the offer did — reported in the setup summary. */
+export interface DocsMcpResult {
+    outcome: DocsMcpOutcome;
+    /** Agents whose config now names the server. */
+    agents: CodingAgent["id"][];
+    /** Repo-relative config files written (empty for a CLI-side install). */
+    files: string[];
+}
+export interface OfferDocsMcpArgs {
+    /** `--docs-mcp` / `--no-docs-mcp`; undefined means ask (when we can). */
+    docsMcp?: boolean;
+    /** The agent taking the hand-off — the only one the offer configures. */
+    agent: CodingAgent;
+    headless: boolean;
+    /**
+     * Whether the docs prefetch would actually run on decline/failure — with
+     * `--no-docs` it won't, and the offer must not promise a download.
+     */
+    docsEnabled: boolean;
+}
+export declare function offerDocsMcp(deps: Pick<SetupDeps, "context" | "prompter" | "processes">, args: OfferDocsMcpArgs): Promise<DocsMcpResult>;
+//# sourceMappingURL=offerDocsMcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"offerDocsMcp.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/offerDocsMcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAKzC,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9E,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,CAAC;IACxB,gDAAgD;IAChD,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;IAC5B,yEAAyE;IACzE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAOD,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC,EAC3D,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,aAAa,CAAC,CAaxB"}

package/build/setup/steps/offerDocsMcp.js

@@ -0,0 +1,133 @@
+/**
+ * Offer to connect the Phoenix docs MCP server to the coding agent taking the
+ * hand-off, instead of downloading the docs.
+ *
+ * Taking the offer is the fast path: one small config step replaces the
+ * ~100-page `.px/docs` download, and the agent then searches the docs server
+ * on demand — pulling only the sections it needs instead of reading whole
+ * pages. Declining (or any failure) degrades to the docs prefetch, which is
+ * what setup did before this step existed.
+ *
+ * The offer is an optimization and must never take setup down with it:
+ * whatever goes wrong (an agent CLI whose flags drifted, a config format we
+ * no longer understand), this step reports it, returns a "failed" result, and
+ * the caller carries on with the docs download. The only throw that leaves
+ * this function is a user cancel.
+ *
+ * The offer targets exactly one agent — the lane the user chose (or `--agent`
+ * pinned) — so setup never sprays MCP config for agents that aren't doing the
+ * work. How the entry lands is the agent's own affair ({@link DocsMcpInstall}):
+ * agents with an MCP subcommand register it through their own CLI, the rest
+ * get a merge into their documented config file. Headless runs never touch
+ * agent config unless `--docs-mcp` asked for it.
+ */
+import { DOCS_MCP_SERVER_URL } from "../agents/registry.js";
+import * as COPY from "../copy.js";
+import { SetupCancelledError } from "../errors.js";
+import { selectBoolean } from "../ui/selectBoolean.js";
+import { writeMcpConfig } from "../util/mcpConfig.js";
+const SKIPPED = { outcome: "skipped", agents: [], files: [] };
+/** Registering a server is one config write; a slow CLI start is still fine. */
+const CLI_INSTALL_TIMEOUT_MS = 30_000;
+export async function offerDocsMcp(deps, args) {
+    try {
+        return await runOffer(deps, args);
+    }
+    catch (error) {
+        if (error instanceof SetupCancelledError) {
+            throw error;
+        }
+        return reportFailure(deps, args, error instanceof Error ? error.message : String(error));
+    }
+}
+/** The single failure path: say what broke, say what happens instead. */
+function reportFailure(deps, { agent, docsEnabled }, reason) {
+    deps.prompter.line(COPY.DOCS_MCP.failedFor(agent.label, reason));
+    deps.prompter.line(docsEnabled ? COPY.DOCS_MCP.fallback : COPY.DOCS_MCP.fallbackWithoutDownload);
+    return { outcome: "failed", agents: [], files: [] };
+}
+async function runOffer(deps, args) {
+    const { docsMcp, agent, headless, docsEnabled } = args;
+    if (docsMcp === false) {
+        return SKIPPED;
+    }
+    const install = agent.docsMcpInstall;
+    if (!install) {
+        // Only worth a line when the caller asked by flag — a pinned agent with
+        // no MCP install path (Codex) would otherwise silently ignore it.
+        if (docsMcp === true) {
+            deps.prompter.line(COPY.DOCS_MCP.unsupported(agent.label));
+        }
+        return SKIPPED;
+    }
+    // An unattended run never edits agent config unless --docs-mcp said so.
+    if (docsMcp === undefined && headless) {
+        return SKIPPED;
+    }
+    const optedIn = docsMcp ??
+        (await selectBoolean({
+            prompter: deps.prompter,
+            message: COPY.DOCS_MCP.message(agent.label),
+            yesLabel: COPY.DOCS_MCP.yes,
+            yesHint: COPY.DOCS_MCP.yesHint,
+            noLabel: docsEnabled ? COPY.DOCS_MCP.no : COPY.DOCS_MCP.noWithoutDownload,
+            noHint: docsEnabled
+                ? COPY.DOCS_MCP.noHint
+                : COPY.DOCS_MCP.noWithoutDownloadHint,
+        }));
+    if (!optedIn) {
+        return { outcome: "declined", agents: [], files: [] };
+    }
+    if (install.kind === "cli") {
+        const exec = (execArgs) => deps.processes.exec({
+            command: agent.binary,
+            args: execArgs,
+            cwd: deps.context.cwd,
+            timeoutMs: CLI_INSTALL_TIMEOUT_MS,
+        });
+        // `add` first: the clean path is one registration plus the read-back.
+        // Only when `add` is refused AND the agent's own listing shows an entry
+        // under our name is that entry removed and the add retried — removing
+        // before knowing the add works would destroy a working registration
+        // that a failed retry can't put back.
+        let added = await exec(install.addArgs(DOCS_MCP_SERVER_URL));
+        if (added.exitCode !== 0) {
+            const existing = await exec(install.verifyArgs);
+            if (existing.exitCode !== 0) {
+                return reportFailure(deps, args, added.stderr.trim() || `exit code ${added.exitCode}`);
+            }
+            await exec(install.removeArgs);
+            added = await exec(install.addArgs(DOCS_MCP_SERVER_URL));
+            if (added.exitCode !== 0) {
+                return reportFailure(deps, args, added.stderr.trim() || `exit code ${added.exitCode}`);
+            }
+        }
+        // Don't trust the add's exit code alone: read the entry back through the
+        // agent's own listing, so a drifted command that "succeeds" without
+        // registering anything is caught here instead of silently costing the
+        // agent its docs.
+        const verified = await exec(install.verifyArgs);
+        if (verified.exitCode !== 0) {
+            return reportFailure(deps, args, COPY.DOCS_MCP.verifyFailed);
+        }
+        deps.prompter.line(COPY.DOCS_MCP.configuredCli(agent.label));
+        return { outcome: "configured", agents: [agent.id], files: [] };
+    }
+    // A write that throws (unparseable existing file, permissions) is handled
+    // by the catch-all in offerDocsMcp.
+    writeMcpConfig({
+        directory: deps.context.cwd,
+        relativePath: install.relativePath,
+        patch: install.patch(DOCS_MCP_SERVER_URL),
+        ...(install.createDefaults
+            ? { createDefaults: install.createDefaults }
+            : {}),
+    });
+    deps.prompter.line(COPY.DOCS_MCP.configured([install.relativePath]));
+    return {
+        outcome: "configured",
+        agents: [agent.id],
+        files: [install.relativePath],
+    };
+}
+//# sourceMappingURL=offerDocsMcp.js.map

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

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

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

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

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

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

package/build/setup/steps/offerPxProfile.js

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

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

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

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

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

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

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