@arizeai/phoenix-cli 1.8.1 → 1.9.0

package/build/setup/steps/instrumentApp.js

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

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

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

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

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

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

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

package/build/setup/steps/offerPxProfile.js

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

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

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

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

package/build/setup/steps/prefetchDocs.js

@@ -0,0 +1,49 @@
+/**
+ * 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 * as COPY from "../copy.js";
+import { unknownWorkflowWarning, } from "../deps/index.js";
+import { ensureGitignored } from "../util/gitignoreCoverage.js";
+/** The docs land under `.px/`, so that is what gets gitignored. */
+const DOCS_GITIGNORE_ENTRY = ".px/";
+/**
+ * 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 async function prefetchDocs(deps, { docs, isGitRepository, }) {
+    if (!docs.enabled) {
+        return undefined;
+    }
+    deps.prompter.line(COPY.DOCS_PREFETCH.fetching);
+    try {
+        const result = await deps.fetchDocs(docs);
+        // A typo'd --workflow filters silently, so name it — otherwise the run
+        // reports "0 pages" with no hint the workflow value was the problem.
+        for (const workflow of result.unknownWorkflows ?? []) {
+            deps.prompter.line(unknownWorkflowWarning(workflow));
+        }
+        const { appended } = ensureGitignored({
+            directory: deps.context.cwd,
+            filenames: [DOCS_GITIGNORE_ENTRY],
+            isGitRepository,
+        });
+        deps.prompter.line(COPY.DOCS_PREFETCH.wrote(result.written, result.outputDir));
+        return { ...result, gitignoreAppended: appended };
+    }
+    catch (error) {
+        deps.prompter.line(COPY.DOCS_PREFETCH.failed(error instanceof Error ? error.message : String(error)));
+        return undefined;
+    }
+}
+//# sourceMappingURL=prefetchDocs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prefetchDocs.js","sourceRoot":"","sources":["../../../src/setup/steps/prefetchDocs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAChC,OAAO,EACL,sBAAsB,GAIvB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,mEAAmE;AACnE,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAEpC;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAA2D,EAC3D,EACE,IAAI,EACJ,eAAe,GACyC;IAE1D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC1C,uEAAuE;QACvE,qEAAqE;QACrE,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,gBAAgB,IAAI,EAAE,EAAE,CAAC;YACrD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,MAAM,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC;YACpC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;YAC3B,SAAS,EAAE,CAAC,oBAAoB,CAAC;YACjC,eAAe;SAChB,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAC3D,CAAC;QACF,OAAO,EAAE,GAAG,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,IAAI,CAAC,aAAa,CAAC,MAAM,CACvB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CACF,CAAC;QACF,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * Wait for the first trace to land.
+ *
+ * Setup verifies data flow itself: it polls the Phoenix span-search API
+ * for a span newer than the start of this run until one arrives. The human is
+ * only consulted at the timeout escape hatch ("keep watching / finish
+ * anyway") — never asked to eyeball the UI as the definition of done.
+ */
+import type { SetupDeps } from "../deps/index.js";
+import type { Connection } from "./establishConnection.js";
+/**
+ * The project may not exist until the first trace lands, so link by name via
+ * the redirect route rather than by an id we no longer have.
+ */
+export declare function tracesUrl(connection: Connection): string;
+/**
+ * True when the project already has spans inside the clock-skew window at
+ * `sinceMs`. Checked before instrumentation begins: any span visible at that
+ * point predates this run, so verification must not credit the skew window.
+ */
+export declare function hasSpansInSkewWindow(deps: Pick<SetupDeps, "createClient">, connection: Connection, { sinceMs }: {
+    sinceMs: number;
+}): Promise<boolean>;
+/**
+ * Watch for the first trace since `sinceMs`. Resolves true when a span is
+ * observed via the API, false when the wait ends without one — the user gave
+ * up at the timeout prompt, or, in a headless run, the first window elapsed.
+ *
+ * The "keep watching?" prompt is the only thing that can extend the wait, so a
+ * headless run gets exactly one window: there is no terminal to ask on, and
+ * looping forever would hang an unattended caller.
+ *
+ * @param args.sinceMs - instrumentation start; only spans after it count.
+ * @param args.allowClockSkew - widen the window by the skew tolerance. Pass
+ * false when the project had spans before instrumentation began (see
+ * `hasSpansInSkewWindow`), so stale spans cannot satisfy verification.
+ * @param args.headless - no prompting; give up after one window.
+ */
+export declare function waitForFirstTrace(deps: Pick<SetupDeps, "clock" | "createClient" | "prompter">, connection: Connection, { sinceMs, allowClockSkew, headless, }: {
+    sinceMs: number;
+    allowClockSkew?: boolean;
+    headless?: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=verifyTraces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verifyTraces.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/verifyTraces.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAQxD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAIxD;AAOD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,EACrC,UAAU,EAAE,UAAU,EACtB,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/B,OAAO,CAAC,OAAO,CAAC,CAMlB;AA0DD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,cAAc,GAAG,UAAU,CAAC,EAC5D,UAAU,EAAE,UAAU,EACtB,EACE,OAAO,EACP,cAAqB,EACrB,QAAgB,GACjB,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GACnE,OAAO,CAAC,OAAO,CAAC,CAoClB"}

package/build/setup/steps/verifyTraces.js

@@ -0,0 +1,119 @@
+/**
+ * Wait for the first trace to land.
+ *
+ * Setup verifies data flow itself: it polls the Phoenix span-search API
+ * for a span newer than the start of this run until one arrives. The human is
+ * only consulted at the timeout escape hatch ("keep watching / finish
+ * anyway") — never asked to eyeball the UI as the definition of done.
+ */
+import * as COPY from "../copy.js";
+const POLL_INTERVAL_MS = 2_000;
+const POLL_WINDOW_MS = 60_000;
+const POLL_REQUEST_TIMEOUT_MS = 5_000;
+/** Tolerance for clock skew between this machine and the span producer. */
+const START_TIME_SKEW_MS = 60_000;
+/**
+ * The project may not exist until the first trace lands, so link by name via
+ * the redirect route rather than by an id we no longer have.
+ */
+export function tracesUrl(connection) {
+    return `${connection.endpoint}/redirects/projects/${encodeURIComponent(connection.projectName)}`;
+}
+/** Inclusive lower bound of the span search, as the API's ISO timestamp. */
+function searchStartTime(sinceMs, skewMs) {
+    return new Date(sinceMs - skewMs).toISOString();
+}
+/**
+ * True when the project already has spans inside the clock-skew window at
+ * `sinceMs`. Checked before instrumentation begins: any span visible at that
+ * point predates this run, so verification must not credit the skew window.
+ */
+export async function hasSpansInSkewWindow(deps, connection, { sinceMs }) {
+    return hasNewSpans(spanSearchClient(deps, connection), connection.projectName, searchStartTime(sinceMs, START_TIME_SKEW_MS));
+}
+function spanSearchClient(deps, connection) {
+    return deps.createClient({
+        endpoint: connection.endpoint,
+        apiKey: connection.apiKey,
+    });
+}
+/**
+ * One span-search request. Any failure is a "not yet": a 404 means the project
+ * has no spans to have created it, and a network hiccup mid-poll should keep
+ * setup watching rather than abort it.
+ */
+async function hasNewSpans(client, projectName, startTime) {
+    try {
+        const { data } = await client.GET("/v1/projects/{project_identifier}/spans", {
+            params: {
+                path: { project_identifier: projectName },
+                query: { limit: 1, start_time: startTime },
+            },
+            signal: AbortSignal.timeout(POLL_REQUEST_TIMEOUT_MS),
+        });
+        return (data?.data.length ?? 0) > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/** Poll until a span arrives or the window elapses. */
+async function pollWindow(deps, client, connection, startTime) {
+    const deadline = deps.clock.now() + POLL_WINDOW_MS;
+    for (;;) {
+        if (await hasNewSpans(client, connection.projectName, startTime)) {
+            return true;
+        }
+        if (deps.clock.now() >= deadline) {
+            return false;
+        }
+        await deps.clock.sleep(POLL_INTERVAL_MS);
+    }
+}
+/**
+ * Watch for the first trace since `sinceMs`. Resolves true when a span is
+ * observed via the API, false when the wait ends without one — the user gave
+ * up at the timeout prompt, or, in a headless run, the first window elapsed.
+ *
+ * The "keep watching?" prompt is the only thing that can extend the wait, so a
+ * headless run gets exactly one window: there is no terminal to ask on, and
+ * looping forever would hang an unattended caller.
+ *
+ * @param args.sinceMs - instrumentation start; only spans after it count.
+ * @param args.allowClockSkew - widen the window by the skew tolerance. Pass
+ * false when the project had spans before instrumentation began (see
+ * `hasSpansInSkewWindow`), so stale spans cannot satisfy verification.
+ * @param args.headless - no prompting; give up after one window.
+ */
+export async function waitForFirstTrace(deps, connection, { sinceMs, allowClockSkew = true, headless = false, }) {
+    const url = tracesUrl(connection);
+    const startTime = searchStartTime(sinceMs, allowClockSkew ? START_TIME_SKEW_MS : 0);
+    const client = spanSearchClient(deps, connection);
+    deps.prompter.note(COPY.VERIFY.waitingBody(url), COPY.VERIFY.title);
+    for (;;) {
+        if (await pollWindow(deps, client, connection, startTime)) {
+            deps.prompter.line(COPY.VERIFY.received(url));
+            return true;
+        }
+        if (headless) {
+            deps.prompter.line(COPY.VERIFY.notVerifiedHeadless(url));
+            return false;
+        }
+        const keepWatching = await deps.prompter.select({
+            message: COPY.VERIFY.timeoutMessage,
+            options: [
+                { value: true, label: COPY.VERIFY.keepWatchingLabel },
+                {
+                    value: false,
+                    label: COPY.VERIFY.finishLabel,
+                    hint: COPY.VERIFY.finishHint,
+                },
+            ],
+        });
+        if (!keepWatching) {
+            deps.prompter.note(COPY.VERIFY.notVerifiedBody(url), COPY.VERIFY.notVerifiedTitle);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=verifyTraces.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Write the hand-off file.
+ *
+ * Writes `.env.phoenix` into cwd (deliberately not the repo root — bounded
+ * blast radius in monorepos), mode 0600, then ensures it is gitignored. The
+ * file emits the SDK env var names — it configures the user's app, not px.
+ */
+import type { SetupDeps } from "../deps/index.js";
+import type { Connection } from "./establishConnection.js";
+export declare const ENV_FILE_NAME = ".env.phoenix";
+export declare function renderEnvFile(connection: Connection, isoDate: string): string;
+export interface WriteEnvFileResult {
+    envFilePath: string;
+    gitignoreAppended: string[];
+}
+export declare function writeEnvFile(deps: Pick<SetupDeps, "clock" | "context">, connection: Connection, { isGitRepository }: {
+    isGitRepository: boolean;
+}): WriteEnvFileResult;
+//# sourceMappingURL=writeEnvFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writeEnvFile.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/writeEnvFile.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAY5C,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAU7E;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC,EAC1C,UAAU,EAAE,UAAU,EACtB,EAAE,eAAe,EAAE,EAAE;IAAE,eAAe,EAAE,OAAO,CAAA;CAAE,GAChD,kBAAkB,CAmBpB"}

package/build/setup/steps/writeEnvFile.js

@@ -0,0 +1,50 @@
+/**
+ * Write the hand-off file.
+ *
+ * Writes `.env.phoenix` into cwd (deliberately not the repo root — bounded
+ * blast radius in monorepos), mode 0600, then ensures it is gitignored. The
+ * file emits the SDK env var names — it configures the user's app, not px.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as COPY from "../copy.js";
+import { ensureGitignored } from "../util/gitignoreCoverage.js";
+export const ENV_FILE_NAME = ".env.phoenix";
+/**
+ * Double-quote a value for a `source`-able env file, escaping the characters
+ * the shell still interprets inside double quotes. Project names may contain
+ * spaces (the default is the cwd basename), and dotenv-style loaders strip
+ * the same quotes.
+ */
+function quoteEnvValue(value) {
+    return `"${value.replace(/[\\"$`]/g, (char) => `\\${char}`)}"`;
+}
+export function renderEnvFile(connection, isoDate) {
+    const lines = [
+        COPY.ENV_FILE.fileHeaderEnv(isoDate),
+        `PHOENIX_COLLECTOR_ENDPOINT=${quoteEnvValue(connection.endpoint)}`,
+        `PHOENIX_PROJECT_NAME=${quoteEnvValue(connection.projectName)}`,
+    ];
+    if (connection.apiKey) {
+        lines.push(`PHOENIX_API_KEY=${quoteEnvValue(connection.apiKey)}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+export function writeEnvFile(deps, connection, { isGitRepository }) {
+    const isoDate = new Date(deps.clock.now()).toISOString();
+    const envFilePath = path.join(deps.context.cwd, ENV_FILE_NAME);
+    fs.writeFileSync(envFilePath, renderEnvFile(connection, isoDate), {
+        encoding: "utf-8",
+        mode: 0o600,
+    });
+    // Rewrites of an existing file keep its old mode — enforce 0600 anyway.
+    fs.chmodSync(envFilePath, 0o600);
+    // Applied in the auth-off case too: the file may later gain a key.
+    const { appended } = ensureGitignored({
+        directory: deps.context.cwd,
+        filenames: [ENV_FILE_NAME],
+        isGitRepository,
+    });
+    return { envFilePath, gitignoreAppended: appended };
+}
+//# sourceMappingURL=writeEnvFile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"writeEnvFile.js","sourceRoot":"","sources":["../../../src/setup/steps/writeEnvFile.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,KAAK,IAAI,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C;;;;;GAKG;AACH,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAsB,EAAE,OAAe;IACnE,MAAM,KAAK,GAAG;QACZ,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC;QACpC,8BAA8B,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;QAClE,wBAAwB,aAAa,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE;KAChE,CAAC;IACF,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,mBAAmB,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAOD,MAAM,UAAU,YAAY,CAC1B,IAA0C,EAC1C,UAAsB,EACtB,EAAE,eAAe,EAAgC;IAEjD,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACzD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IAE/D,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE;QAChE,QAAQ,EAAE,OAAO;QACjB,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IACH,wEAAwE;IACxE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAEjC,mEAAmE;IACnE,MAAM,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC;QACpC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;QAC3B,SAAS,EAAE,CAAC,aAAa,CAAC;QAC1B,eAAe;KAChB,CAAC,CAAC;IAEH,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;AACtD,CAAC"}

package/build/setup/ui/clackPrompter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Clack-backed implementation of setup's `Prompter` seam.
+ *
+ * House rules: setup has no confirm primitive — every
+ * choice, including booleans, is a select. Cancellation (Ctrl-C / Escape)
+ * maps to `SetupCancelledError`, unwinding to the single catch site in the
+ * command handler.
+ */
+import type { Prompter } from "../deps/index.js";
+export declare function createClackPrompter(): Prompter;
+//# sourceMappingURL=clackPrompter.d.ts.map

package/build/setup/ui/clackPrompter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clackPrompter.d.ts","sourceRoot":"","sources":["../../../src/setup/ui/clackPrompter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,SAAS,CAAC;AAWtD,wBAAgB,mBAAmB,IAAI,QAAQ,CAyG9C"}