@arizeai/phoenix-cli 1.8.1 → 1.9.0

package/build/setup/agents/registry.js

@@ -0,0 +1,129 @@
+/**
+ * Known coding agents setup can hand off to.
+ *
+ * Detection is a parallel `<binary> --version` probe — binary-on-PATH is the
+ * only signal, and a detected agent becomes a "Hand off to …" lane in the
+ * instrumentation step. Launching is interactive: the agent takes over the
+ * terminal with the setup prompt pre-loaded and Phoenix credentials injected
+ * via environment variables; setup resumes when it exits.
+ */
+import * as path from "node:path";
+export const CODING_AGENTS = [
+    {
+        id: "claude",
+        label: "Claude Code",
+        binary: "claude",
+        launchArgs: (prompt, mode) => [
+            ...(mode.background ? ["-p"] : []),
+            ...(mode.bypassPermissions ? ["--dangerously-skip-permissions"] : []),
+            prompt,
+        ],
+    },
+    {
+        id: "codex",
+        label: "Codex",
+        binary: "codex",
+        // `codex exec` is the non-interactive entry point; flags belong after it.
+        launchArgs: (prompt, mode) => [
+            ...(mode.background ? ["exec"] : []),
+            ...(mode.bypassPermissions
+                ? ["--dangerously-bypass-approvals-and-sandbox"]
+                : []),
+            prompt,
+        ],
+    },
+    {
+        id: "opencode",
+        label: "OpenCode",
+        binary: "opencode",
+        // `opencode run` is already non-interactive, so background adds nothing.
+        launchArgs: (prompt, mode) => [
+            "run",
+            ...(mode.bypassPermissions ? ["--dangerously-skip-permissions"] : []),
+            prompt,
+        ],
+    },
+    {
+        id: "cursor",
+        label: "Cursor",
+        binary: "cursor-agent",
+        launchArgs: (prompt, mode) => [
+            ...(mode.background ? ["-p"] : []),
+            ...(mode.bypassPermissions ? ["--force"] : []),
+            prompt,
+        ],
+    },
+];
+/** The agent with this id, or undefined when the id is unknown. */
+export function getCodingAgent(id) {
+    return CODING_AGENTS.find((agent) => agent.id === id);
+}
+/** Every id `--agent` accepts, for help text and error messages. */
+export const CODING_AGENT_IDS = CODING_AGENTS.map((agent) => agent.id);
+const PROBE_TIMEOUT_MS = 2_000;
+/**
+ * True when the binary answers `--version` within the timeout. The timeout
+ * kills the child (via the exec seam), so a hung probe counts as not found
+ * without leaving an orphaned subprocess behind.
+ */
+export async function probeBinary(deps, binary, { env } = {}) {
+    const result = await deps.processes.exec({
+        command: binary,
+        args: ["--version"],
+        timeoutMs: PROBE_TIMEOUT_MS,
+        ...(env ? { env } : {}),
+    });
+    return result.exitCode === 0;
+}
+/**
+ * PATH with `node_modules/.bin` entries removed. Package runners (`npx`,
+ * `pnpm dlx`) prepend their package's own bin directory, which would make a
+ * package-provided shim masquerade as a globally installed binary.
+ */
+export function pathWithoutPackageBins(pathValue) {
+    const packageBinMarker = `node_modules${path.sep}.bin`;
+    return pathValue
+        .split(path.delimiter)
+        .filter((entry) => !entry.includes(packageBinMarker))
+        .join(path.delimiter);
+}
+/**
+ * `probeBinary`, but blind to binaries provided by the running package —
+ * used to decide whether `px` is genuinely installed globally when the
+ * setup itself runs under `npx @arizeai/phoenix-cli`.
+ */
+export function probeGlobalBinary(deps, binary) {
+    // Override PATH under the spelling the run context resolved, so the child
+    // does not end up with both a "Path" and a "PATH" on Windows.
+    const { env, pathKey } = deps.context;
+    const pathValue = env[pathKey];
+    return probeBinary(deps, binary, pathValue === undefined
+        ? {}
+        : { env: { [pathKey]: pathWithoutPackageBins(pathValue) } });
+}
+/** Agents whose binary probe succeeds, in registry order. */
+export async function detectCodingAgents(deps) {
+    const probes = await Promise.all(CODING_AGENTS.map((agent) => probeBinary(deps, agent.binary)));
+    return CODING_AGENTS.filter((_, index) => probes[index]);
+}
+/**
+ * Env vars the launched agent's shell inherits so the app under test can
+ * export a verification trace without the agent handling credentials.
+ */
+export function connectionEnv(connection) {
+    return {
+        PHOENIX_COLLECTOR_ENDPOINT: connection.endpoint,
+        PHOENIX_PROJECT_NAME: connection.projectName,
+        ...(connection.apiKey ? { PHOENIX_API_KEY: connection.apiKey } : {}),
+    };
+}
+export function buildLaunchSpec(agent, args) {
+    const mode = args.mode ?? { background: false, bypassPermissions: false };
+    return {
+        command: agent.binary,
+        args: agent.launchArgs(args.prompt, mode),
+        cwd: args.cwd,
+        env: connectionEnv(args.connection),
+    };
+}
+//# sourceMappingURL=registry.js.map

package/build/setup/agents/registry.js.map

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

package/build/setup/copy.d.ts

@@ -0,0 +1,167 @@
+/**
+ * ALL user-facing strings for setup, grouped by the step that emits
+ * them. Control flow references copy; copy never references control flow.
+ * Keep prose here so wording changes never touch step logic.
+ */
+export declare const DOCS: {
+    /** Agent-facing quickstart, Python (arize-phoenix-otel). */
+    readonly quickstartPython: "https://arize.com/docs/phoenix/get-started/get-started-tracing";
+    /** Agent-facing quickstart, TypeScript (@arizeai/phoenix-otel). */
+    readonly quickstartTypeScript: "https://arize.com/docs/phoenix/get-started/ts-get-started-tracing";
+    /** phoenix.otel register() reference for custom setups. */
+    readonly phoenixOtelSetup: "https://arize.com/docs/phoenix/tracing/how-to-tracing/setup-tracing/setup-using-phoenix-otel";
+    /** Per-framework/provider auto-instrumentation guides. */
+    readonly integrationsIndex: "https://arize.com/docs/phoenix/integrations";
+    /** Linked from the verification step. */
+    readonly troubleshooting: "https://arize.com/docs/phoenix/tracing/concepts-tracing/faqs-tracing";
+    /** Linked from the manual lane and headless output. */
+    readonly instrumentationIndex: "https://arize.com/docs/phoenix/quickstart";
+};
+export declare const SUPPORT_LINKS: string;
+export declare const INTRO = "Phoenix tracing setup";
+export declare const INTRO_INSTRUMENT = "Phoenix setup \u2014 instrument this app and verify traces arrive.";
+export declare const INTRO_SKILLS = "Install agent skills";
+export declare const CANCEL_OUTRO: string;
+export declare const OUTRO_TITLE = "You're set up.";
+export declare const OUTRO_BODY: string;
+export declare const GIT: {
+    readonly notARepoMessage: "This directory is not a git repository. Continue anyway?";
+    readonly notARepoYes: "Yes, continue without git";
+    readonly notARepoNo: "No, stop here (recommended)";
+    readonly notARepoNoHint: "Setup may edit files via a coding agent — git is the undo button.";
+    readonly notARepoYesHint: "You will have no easy way to review or revert changes.";
+    readonly dirtyMessage: (fileCount: number) => string;
+    readonly dirtyYes: "Yes, continue with a dirty tree";
+    readonly dirtyNo: "No, stop here so I can commit first (recommended)";
+    readonly dirtyNoHint: "A clean tree keeps agent edits separate from your own edits.";
+    readonly dirtyYesHint: "Agent edits will be tangled with your uncommitted work.";
+    readonly dirtyFileListTitle: "Uncommitted changes";
+    readonly andMore: (count: number) => string;
+    readonly headlessDirty: "Refusing to run headless in a dirty git tree. Commit or stash your changes and re-run.";
+    readonly headlessNotARepo: "Refusing to run headless outside a git repository. Run `git init` (or run setup interactively) and re-run.";
+    readonly stopped: "Stopped. Commit your work, then re-run `px setup`.";
+};
+export declare const ENDPOINT: {
+    readonly selectMessage: "Where is your Phoenix instance running?";
+    readonly localLabel: "Local — http://localhost:6006";
+    readonly localHint: "recommended if you just ran `phoenix serve`";
+    readonly remoteLabel: "Remote — paste your instance URL";
+    readonly remoteHint: "any Phoenix instance reachable by URL";
+    readonly remoteUrlMessage: "Phoenix instance URL";
+    readonly remoteUrlInvalid: "Enter a full http:// or https:// URL, e.g. https://phoenix.example.com";
+    readonly probing: (endpoint: string) => string;
+    readonly unexpectedBody: "unexpected response body";
+    readonly unreachable: (endpoint: string) => string;
+    readonly notPhoenix: (endpoint: string, detail: string) => string;
+    readonly retryMessage: "Try a different URL?";
+    readonly retryYes: "Yes, enter a URL again";
+    readonly retryNo: "No, exit setup";
+    readonly gaveUp: string;
+    readonly authOn: "Authentication is enabled on this instance.";
+    readonly authOff: "Authentication is off — no API key needed.";
+    readonly headlessUnreachable: (endpoint: string) => string;
+    readonly headlessNeedsEndpoint: string;
+};
+export declare const CONNECT: {
+    readonly projectNameMessage: "Phoenix project name for this app's traces";
+    readonly projectNameInvalid: "Project names can't contain '/', '?', or '#' and can't be empty.";
+    readonly usingProject: (name: string) => string;
+    readonly connectFailed: (detail: string) => string;
+    readonly headlessNeedsProject: string;
+    readonly headlessNeedsApiKey: string;
+    readonly headlessAuthRejected: "The API key was rejected. Check PHOENIX_API_KEY.";
+};
+export declare const API_KEY: {
+    readonly instructionsTitle: "Phoenix API key";
+    readonly instructions: string;
+    readonly pasteKeyMessage: "Phoenix API key";
+    readonly pasteKeyInvalid: "API key can't be empty.";
+    readonly pasteKeyRejected: "That API key was rejected by the instance. Try again.";
+};
+export declare const ENV_FILE: {
+    readonly wrote: (names: string[]) => string;
+    readonly gitignored: (names: string[]) => string;
+    readonly fileHeaderEnv: (isoDate: string) => string;
+};
+export declare const INSTRUMENTATION: {
+    readonly modeMessage: "How do you want to instrument this app?";
+    readonly launchLabel: (agentLabel: string) => string;
+    readonly launchHint: "launches here with the setup prompt pre-loaded";
+    readonly unknownAgent: (agent: string) => string;
+    readonly agentNotFound: (agentLabel: string, binary: string) => string;
+    readonly launchingBackground: (agentLabel: string) => string;
+    readonly backgroundNeedsYolo: (agentLabel: string) => string;
+    readonly launching: (agentLabel: string) => string;
+    readonly agentExitWarning: (agentLabel: string) => string;
+    readonly clipboardLabel: "Copy a prompt for my own coding agent";
+    readonly clipboardHint: "paste it into Claude Code, Codex, Cursor — any agent you run yourself";
+    readonly manualLabel: "I'll do it manually";
+    readonly manualHint: "follow the quickstart docs yourself";
+    readonly promptCopied: "Instrumentation prompt copied to your clipboard. Paste it into your agent in this directory.";
+    readonly promptCopyFailed: "Couldn't write to the clipboard — here is the prompt to copy:";
+    readonly clipboardDoneMessage: "When your agent has finished:";
+    readonly clipboardDoneLabel: "I've run the prompt";
+    readonly manualDocs: (url: string) => string;
+    readonly manualDoneMessage: "When you've added instrumentation:";
+    readonly manualDoneLabel: "I've finished instrumenting";
+};
+export declare const VERIFY: {
+    readonly title: "Verifying traces";
+    readonly waitingBody: (tracesUrl: string) => string;
+    readonly received: (tracesUrl: string) => string;
+    readonly timeoutMessage: "No traces have arrived yet. Keep watching?";
+    readonly keepWatchingLabel: "Keep watching";
+    readonly finishLabel: "Finish setup — I'll verify later";
+    readonly finishHint: "everything else is already configured";
+    readonly notVerifiedHeadless: (tracesUrl: string) => string;
+    readonly notVerifiedTitle: "Traces not verified yet";
+    readonly notVerifiedBody: (tracesUrl: string) => string;
+};
+export declare const PRODUCTION: {
+    readonly title: "Production hand-off";
+    readonly bodyAuthOn: string;
+    readonly bodyAuthOff: string;
+};
+export declare const PX_PROFILE: {
+    readonly optInMessage: "Also point the px CLI at this project? (lets you query traces from your terminal)";
+    readonly optInYes: "Yes, create a px profile";
+    readonly optInNo: "No thanks";
+    readonly conflictMessage: (profileName: string, endpoint: string) => string;
+    readonly conflictYes: "Yes, switch px to this project";
+    readonly conflictNo: "No, leave px as-is";
+    readonly created: (profileName: string) => string;
+    readonly failed: (detail: string) => string;
+    readonly unreadableSettings: (settingsPath: string, detail: string) => string;
+};
+/**
+ * The skills repo, named once: the command we spawn and the commands the copy
+ * below tells the user to run by hand have to point at the same place.
+ */
+export declare const SKILLS_SOURCE = "Arize-ai/phoenix";
+/** One copy group per install offer; both share the shape `ToolingOfferCopy`. */
+export declare const TOOLING: {
+    readonly cli: {
+        readonly message: "Install the px CLI globally? (`px` isn't on your PATH — it lets you query traces from any terminal)";
+        readonly yes: "Yes, npm install -g @arizeai/phoenix-cli";
+        readonly no: "No thanks";
+        readonly installed: "px CLI installed. Try `px --help` in a new shell.";
+        readonly failed: "CLI install failed — install later with `npm install -g @arizeai/phoenix-cli`.";
+    };
+    readonly skills: {
+        readonly message: "Install agent skills? (opens a skill picker — query traces, debug failures)";
+        readonly yes: "Yes, run npx skills add Arize-ai/phoenix";
+        readonly no: "No thanks";
+        readonly installed: "Phoenix skills installed. Your coding agent can now query and debug traces.";
+        readonly failed: "Skills install failed — install later with `npx skills add Arize-ai/phoenix`.";
+    };
+};
+export declare const DOCS_PREFETCH: {
+    readonly fetching: "Downloading the Phoenix docs so the agent reads them locally...";
+    readonly wrote: (pages: number, outputDir: string) => string;
+    readonly failed: (reason: string) => string;
+};
+export declare const HEADLESS: {
+    readonly agentRequired: (agentIds: readonly string[]) => string;
+    readonly nextSteps: (tracesUrl: string) => string;
+};
+//# sourceMappingURL=copy.d.ts.map

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

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

package/build/setup/copy.js

@@ -0,0 +1,290 @@
+/**
+ * ALL user-facing strings for setup, grouped by the step that emits
+ * them. Control flow references copy; copy never references control flow.
+ * Keep prose here so wording changes never touch step logic.
+ */
+// ---------------------------------------------------------------------------
+// Docs contract — the only doc URLs setup emits.
+// ---------------------------------------------------------------------------
+export const DOCS = {
+    /** Agent-facing quickstart, Python (arize-phoenix-otel). */
+    quickstartPython: "https://arize.com/docs/phoenix/get-started/get-started-tracing",
+    /** Agent-facing quickstart, TypeScript (@arizeai/phoenix-otel). */
+    quickstartTypeScript: "https://arize.com/docs/phoenix/get-started/ts-get-started-tracing",
+    /** phoenix.otel register() reference for custom setups. */
+    phoenixOtelSetup: "https://arize.com/docs/phoenix/tracing/how-to-tracing/setup-tracing/setup-using-phoenix-otel",
+    /** Per-framework/provider auto-instrumentation guides. */
+    integrationsIndex: "https://arize.com/docs/phoenix/integrations",
+    /** Linked from the verification step. */
+    troubleshooting: "https://arize.com/docs/phoenix/tracing/concepts-tracing/faqs-tracing",
+    /** Linked from the manual lane and headless output. */
+    instrumentationIndex: "https://arize.com/docs/phoenix/quickstart",
+};
+export const SUPPORT_LINKS = [
+    `Docs:            ${DOCS.instrumentationIndex}`,
+    `Troubleshooting: ${DOCS.troubleshooting}`,
+    "Issues:          https://github.com/Arize-ai/phoenix/issues",
+    "Community:       https://arize-ai.slack.com",
+].join("\n");
+// ---------------------------------------------------------------------------
+// Shell / lifecycle
+// ---------------------------------------------------------------------------
+export const INTRO = "Phoenix tracing setup";
+export const INTRO_INSTRUMENT = "Phoenix setup — instrument this app and verify traces arrive.";
+export const INTRO_SKILLS = "Install agent skills";
+export const CANCEL_OUTRO = [
+    "Setup cancelled. Nothing else was changed.",
+    "",
+    SUPPORT_LINKS,
+].join("\n");
+export const OUTRO_TITLE = "You're set up.";
+export const OUTRO_BODY = SUPPORT_LINKS;
+// ---------------------------------------------------------------------------
+// Confirm git safety
+// ---------------------------------------------------------------------------
+export const GIT = {
+    notARepoMessage: "This directory is not a git repository. Continue anyway?",
+    notARepoYes: "Yes, continue without git",
+    notARepoNo: "No, stop here (recommended)",
+    notARepoNoHint: "Setup may edit files via a coding agent — git is the undo button.",
+    notARepoYesHint: "You will have no easy way to review or revert changes.",
+    dirtyMessage: (fileCount) => `You have ${fileCount} uncommitted change${fileCount === 1 ? "" : "s"}. Continue anyway?`,
+    dirtyYes: "Yes, continue with a dirty tree",
+    dirtyNo: "No, stop here so I can commit first (recommended)",
+    dirtyNoHint: "A clean tree keeps agent edits separate from your own edits.",
+    dirtyYesHint: "Agent edits will be tangled with your uncommitted work.",
+    dirtyFileListTitle: "Uncommitted changes",
+    andMore: (count) => `…and ${count} more`,
+    headlessDirty: "Refusing to run headless in a dirty git tree. Commit or stash your changes and re-run.",
+    headlessNotARepo: "Refusing to run headless outside a git repository. Run `git init` (or run setup interactively) and re-run.",
+    stopped: "Stopped. Commit your work, then re-run `px setup`.",
+};
+// ---------------------------------------------------------------------------
+// Choose endpoint
+// ---------------------------------------------------------------------------
+export const ENDPOINT = {
+    selectMessage: "Where is your Phoenix instance running?",
+    localLabel: "Local — http://localhost:6006",
+    localHint: "recommended if you just ran `phoenix serve`",
+    remoteLabel: "Remote — paste your instance URL",
+    remoteHint: "any Phoenix instance reachable by URL",
+    remoteUrlMessage: "Phoenix instance URL",
+    remoteUrlInvalid: "Enter a full http:// or https:// URL, e.g. https://phoenix.example.com",
+    probing: (endpoint) => `Checking ${endpoint}…`,
+    unexpectedBody: "unexpected response body",
+    unreachable: (endpoint) => [
+        `Could not reach a Phoenix instance at ${endpoint}.`,
+        "If it's local, is `phoenix serve` running? If it's remote, check the",
+        "URL and that you can reach it from this machine (VPN?).",
+    ].join("\n"),
+    notPhoenix: (endpoint, detail) => [
+        `${endpoint} responded, but not like a Phoenix instance (${detail}).`,
+        "Double-check the URL — it should be the Phoenix root URL, without",
+        "a path like /projects.",
+    ].join("\n"),
+    retryMessage: "Try a different URL?",
+    retryYes: "Yes, enter a URL again",
+    retryNo: "No, exit setup",
+    gaveUp: [
+        "Couldn't establish a connection after several attempts.",
+        `Setup docs: ${DOCS.instrumentationIndex}`,
+    ].join("\n"),
+    authOn: "Authentication is enabled on this instance.",
+    authOff: "Authentication is off — no API key needed.",
+    headlessUnreachable: (endpoint) => `Could not reach Phoenix at ${endpoint}. Is it running and reachable from this machine?`,
+    headlessNeedsEndpoint: [
+        "Missing endpoint. Provide one of:",
+        "  --endpoint <url>",
+        "  PHOENIX_HOST=<url> (or PHOENIX_COLLECTOR_ENDPOINT=<url>)",
+    ].join("\n"),
+};
+// ---------------------------------------------------------------------------
+// Connection
+// ---------------------------------------------------------------------------
+export const CONNECT = {
+    projectNameMessage: "Phoenix project name for this app's traces",
+    projectNameInvalid: "Project names can't contain '/', '?', or '#' and can't be empty.",
+    usingProject: (name) => `Using project "${name}" — Phoenix creates it when the first trace arrives.`,
+    connectFailed: (detail) => `Couldn't connect to Phoenix (${detail}).`,
+    headlessNeedsProject: [
+        "Missing project. Provide one of:",
+        "  --project <name>",
+        "  PHOENIX_PROJECT=<name> (or PHOENIX_PROJECT_NAME=<name>)",
+    ].join("\n"),
+    headlessNeedsApiKey: [
+        "This Phoenix instance has authentication enabled. Headless setup needs an API key. Provide:",
+        "  PHOENIX_API_KEY=<key>",
+        "and a project via --project or PHOENIX_PROJECT.",
+    ].join("\n"),
+    headlessAuthRejected: "The API key was rejected. Check PHOENIX_API_KEY.",
+};
+// ---------------------------------------------------------------------------
+// Auth-on credential entry
+// ---------------------------------------------------------------------------
+export const API_KEY = {
+    instructionsTitle: "Phoenix API key",
+    instructions: [
+        "Create or copy an API key in Phoenix under Settings, then paste it here.",
+        "The key is masked while you type and is only written to local credential files.",
+    ].join("\n"),
+    pasteKeyMessage: "Phoenix API key",
+    pasteKeyInvalid: "API key can't be empty.",
+    pasteKeyRejected: "That API key was rejected by the instance. Try again.",
+};
+// ---------------------------------------------------------------------------
+// Env file
+// ---------------------------------------------------------------------------
+export const ENV_FILE = {
+    wrote: (names) => `Wrote ${names.join(" and ")} into this directory (readable only by you).`,
+    gitignored: (names) => `Added ${names.join(", ")} to .gitignore.`,
+    fileHeaderEnv: (isoDate) => [
+        `# Generated by \`px setup\` on ${isoDate}.`,
+        "# Contains a Phoenix API key — do NOT commit this file.",
+        "# Safe to delete once tracing is verified and production is configured.",
+    ].join("\n"),
+};
+// ---------------------------------------------------------------------------
+// Instrumentation
+// ---------------------------------------------------------------------------
+export const INSTRUMENTATION = {
+    modeMessage: "How do you want to instrument this app?",
+    launchLabel: (agentLabel) => `Hand off to ${agentLabel}`,
+    launchHint: "launches here with the setup prompt pre-loaded",
+    unknownAgent: (agent) => `Unknown agent "${agent}".`,
+    agentNotFound: (agentLabel, binary) => `${agentLabel} isn't on your PATH (looked for \`${binary}\`). Install it, or pick another agent with --agent.`,
+    launchingBackground: (agentLabel) => `Running ${agentLabel} in the background — it will add tracing and emit a test trace.`,
+    backgroundNeedsYolo: (agentLabel) => `${agentLabel} runs without a terminal here, so it cannot ask you to approve its edits. Pass --yolo to let it proceed, or it will likely stall until verification times out.`,
+    launching: (agentLabel) => [
+        `Handing off to ${agentLabel} — it will add tracing and emit a test trace.`,
+        "When you exit the agent, setup resumes and verifies traces arrived.",
+    ].join("\n"),
+    agentExitWarning: (agentLabel) => `${agentLabel} exited with an error — continuing to verification anyway.`,
+    clipboardLabel: "Copy a prompt for my own coding agent",
+    clipboardHint: "paste it into Claude Code, Codex, Cursor — any agent you run yourself",
+    manualLabel: "I'll do it manually",
+    manualHint: "follow the quickstart docs yourself",
+    promptCopied: "Instrumentation prompt copied to your clipboard. Paste it into your agent in this directory.",
+    promptCopyFailed: "Couldn't write to the clipboard — here is the prompt to copy:",
+    clipboardDoneMessage: "When your agent has finished:",
+    clipboardDoneLabel: "I've run the prompt",
+    manualDocs: (url) => `Follow the tracing quickstart: ${url}`,
+    manualDoneMessage: "When you've added instrumentation:",
+    manualDoneLabel: "I've finished instrumenting",
+};
+// ---------------------------------------------------------------------------
+// Verification + production hand-off
+// ---------------------------------------------------------------------------
+export const VERIFY = {
+    title: "Verifying traces",
+    waitingBody: (tracesUrl) => [
+        "Watching Phoenix for your first trace…",
+        "",
+        "If nothing has sent a trace yet, in another terminal:",
+        "  1. Export the vars:  set -a; source .env.phoenix; set +a",
+        "  2. Run your app and make one LLM call.",
+        "",
+        `Traces appear at ${tracesUrl}`,
+    ].join("\n"),
+    received: (tracesUrl) => `✓ Traces are flowing. View them: ${tracesUrl}`,
+    timeoutMessage: "No traces have arrived yet. Keep watching?",
+    keepWatchingLabel: "Keep watching",
+    finishLabel: "Finish setup — I'll verify later",
+    finishHint: "everything else is already configured",
+    notVerifiedHeadless: (tracesUrl) => `No trace arrived within the wait window. The connection and hand-off files are in place; check ${tracesUrl} once your app sends one.`,
+    notVerifiedTitle: "Traces not verified yet",
+    notVerifiedBody: (tracesUrl) => [
+        `Your first trace will appear at ${tracesUrl}`,
+        `Not seeing traces? ${DOCS.troubleshooting}`,
+    ].join("\n"),
+};
+export const PRODUCTION = {
+    title: "Production hand-off",
+    bodyAuthOn: [
+        "Set these in your production environment:",
+        "",
+        "  PHOENIX_COLLECTOR_ENDPOINT — same value as in .env.phoenix",
+        "  PHOENIX_API_KEY            — copy from .env.phoenix into your secret store",
+        "",
+        "The project name is set in code, so no extra env var is needed for it.",
+    ].join("\n"),
+    bodyAuthOff: [
+        "This instance has no auth, so your app only needs:",
+        "",
+        "  PHOENIX_COLLECTOR_ENDPOINT — your Phoenix URL",
+        "",
+        "When you deploy Phoenix for real (with auth), also set PHOENIX_API_KEY.",
+    ].join("\n"),
+};
+// ---------------------------------------------------------------------------
+// Offer px profile
+// ---------------------------------------------------------------------------
+export const PX_PROFILE = {
+    optInMessage: "Also point the px CLI at this project? (lets you query traces from your terminal)",
+    optInYes: "Yes, create a px profile",
+    optInNo: "No thanks",
+    conflictMessage: (profileName, endpoint) => `px is currently using profile "${profileName}" → ${endpoint}. Switch to this project?`,
+    conflictYes: "Yes, switch px to this project",
+    conflictNo: "No, leave px as-is",
+    created: (profileName) => `px profile "${profileName}" created and activated. Try: px trace list`,
+    failed: (detail) => `Couldn't write the px profile (${detail}). You can create one later with \`px profile create\`.`,
+    // Distinct from `failed`: nothing was written, the settings file could not be
+    // *read*, and `px profile create` reads it the same strict way — so pointing
+    // there would hand back a remedy that fails identically. Name the file
+    // instead; repairing or removing it is the only way forward.
+    unreadableSettings: (settingsPath, detail) => `Couldn't read ${settingsPath} (${detail}), so px was left alone. Fix or delete that file, then run \`px profile create\`.`,
+};
+// ---------------------------------------------------------------------------
+// Install tooling (CLI + skills)
+// ---------------------------------------------------------------------------
+/**
+ * The skills repo, named once: the command we spawn and the commands the copy
+ * below tells the user to run by hand have to point at the same place.
+ */
+export const SKILLS_SOURCE = "Arize-ai/phoenix";
+/** One copy group per install offer; both share the shape `ToolingOfferCopy`. */
+export const TOOLING = {
+    cli: {
+        message: "Install the px CLI globally? (`px` isn't on your PATH — it lets you query traces from any terminal)",
+        yes: "Yes, npm install -g @arizeai/phoenix-cli",
+        no: "No thanks",
+        installed: "px CLI installed. Try `px --help` in a new shell.",
+        failed: "CLI install failed — install later with `npm install -g @arizeai/phoenix-cli`.",
+    },
+    skills: {
+        message: "Install agent skills? (opens a skill picker — query traces, debug failures)",
+        yes: `Yes, run npx skills add ${SKILLS_SOURCE}`,
+        no: "No thanks",
+        installed: "Phoenix skills installed. Your coding agent can now query and debug traces.",
+        failed: `Skills install failed — install later with \`npx skills add ${SKILLS_SOURCE}\`.`,
+    },
+};
+// ---------------------------------------------------------------------------
+// Docs prefetch
+// ---------------------------------------------------------------------------
+export const DOCS_PREFETCH = {
+    fetching: "Downloading the Phoenix docs so the agent reads them locally...",
+    // The unknown-workflow warning is not here: it is worded once in
+    // `commands/docs`, next to the list of workflows it has to stay true to, and
+    // reaches this step through the docs seam.
+    wrote: (pages, outputDir) => `Downloaded ${pages} doc page(s) to ${outputDir}.`,
+    failed: (reason) => `Couldn't download the docs (${reason}) — the agent will read them from the web instead.`,
+};
+// ---------------------------------------------------------------------------
+// Headless output
+// ---------------------------------------------------------------------------
+export const HEADLESS = {
+    agentRequired: (agentIds) => [
+        "Missing required flag --agent.",
+        "  Headless setup has no prompt to pick an instrumentation lane from, so it must be told which agent to run.",
+        `  px setup --no-input --instrument --agent <${agentIds.join("|")}> --yolo`,
+        "  To register only — endpoint, project, .env.phoenix, no source changes:",
+        "  px setup --no-input",
+    ].join("\n"),
+    nextSteps: (tracesUrl) => [
+        "Next steps:",
+        "  1. Export the vars:   set -a; source .env.phoenix; set +a",
+        `  2. Instrument your app: ${DOCS.instrumentationIndex}`,
+        `  3. Watch for traces:  ${tracesUrl}`,
+    ].join("\n"),
+};
+//# sourceMappingURL=copy.js.map

package/build/setup/copy.js.map

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

package/build/setup/deps/buildDefaultDeps.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The composition root: the one place the capability contracts meet their
+ * real, system-backed implementations. Kept separate from the contract
+ * barrel (`index.ts`) so modules the wiring depends on — like the clack
+ * prompter — can themselves import contracts from `../deps` without forming
+ * a cycle.
+ */
+import type { SetupDeps } from "./index.js";
+export declare function buildDefaultDeps({ apiUrl, }?: {
+    /** Hidden --api-url dev override — see {@link createPhoenixClientFactory}. */
+    apiUrl?: string;
+}): SetupDeps;
+//# sourceMappingURL=buildDefaultDeps.d.ts.map

package/build/setup/deps/buildDefaultDeps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDefaultDeps.d.ts","sourceRoot":"","sources":["../../../src/setup/deps/buildDefaultDeps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,GACP,GAAE;IACD,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,SAAS,CAajB"}