@arizeai/phoenix-cli 1.8.1 → 1.9.0

package/build/setup/deps/buildDefaultDeps.js

@@ -0,0 +1,29 @@
+/**
+ * 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 { createClackPrompter } from "../ui/clackPrompter.js";
+import { createSystemClipboardWriter } from "./clipboard.js";
+import { createSystemClock } from "./clock.js";
+import { captureRunContext } from "./context.js";
+import { fetchDocs } from "./docs.js";
+import { createPhoenixClientFactory } from "./phoenixClient.js";
+import { createSystemProcessRunner } from "./processes.js";
+export function buildDefaultDeps({ apiUrl, } = {}) {
+    const processes = createSystemProcessRunner();
+    return {
+        context: captureRunContext(),
+        prompter: createClackPrompter(),
+        processes,
+        clock: createSystemClock(),
+        // The clipboard is itself composed from the process runner: pbcopy & co
+        // are subprocesses.
+        writeClipboard: createSystemClipboardWriter(processes.exec),
+        createClient: createPhoenixClientFactory({ apiUrl }),
+        fetchDocs,
+    };
+}
+//# sourceMappingURL=buildDefaultDeps.js.map

package/build/setup/deps/buildDefaultDeps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildDefaultDeps.js","sourceRoot":"","sources":["../../../src/setup/deps/buildDefaultDeps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACnC,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAGxD,MAAM,UAAU,gBAAgB,CAAC,EAC/B,MAAM,GACP,GAGG,EAAE;IACJ,MAAM,SAAS,GAAG,yBAAyB,EAAE,CAAC;IAC9C,OAAO;QACL,OAAO,EAAE,iBAAiB,EAAE;QAC5B,QAAQ,EAAE,mBAAmB,EAAE;QAC/B,SAAS;QACT,KAAK,EAAE,iBAAiB,EAAE;QAC1B,wEAAwE;QACxE,oBAAoB;QACpB,cAAc,EAAE,2BAA2B,CAAC,SAAS,CAAC,IAAI,CAAC;QAC3D,YAAY,EAAE,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC;QACpD,SAAS;KACV,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * The clipboard capability. The system implementation is composed from the
+ * process runner — pbcopy & co are subprocesses, not a second effect channel.
+ */
+import type { ProcessRunner } from "./processes.js";
+/**
+ * Write text to the system clipboard. Resolves false on failure — callers
+ * fall back to printing the text.
+ */
+export type ClipboardWriter = (text: string) => Promise<boolean>;
+export declare function createSystemClipboardWriter(exec: ProcessRunner["exec"]): ClipboardWriter;
+//# sourceMappingURL=clipboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/setup/deps/clipboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAe,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEjE,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAC1B,eAAe,CAwBjB"}

package/build/setup/deps/clipboard.js

@@ -0,0 +1,30 @@
+/**
+ * The clipboard capability. The system implementation is composed from the
+ * process runner — pbcopy & co are subprocesses, not a second effect channel.
+ */
+import * as process from "node:process";
+export function createSystemClipboardWriter(exec) {
+    return async (text) => {
+        const platform = process.platform;
+        const candidates = platform === "darwin"
+            ? [{ command: "pbcopy", args: [], stdin: text }]
+            : platform === "win32"
+                ? [{ command: "clip", args: [], stdin: text }]
+                : [
+                    { command: "wl-copy", args: [], stdin: text },
+                    {
+                        command: "xclip",
+                        args: ["-selection", "clipboard"],
+                        stdin: text,
+                    },
+                ];
+        for (const candidate of candidates) {
+            const result = await exec(candidate);
+            if (result.exitCode === 0) {
+                return true;
+            }
+        }
+        return false;
+    };
+}
+//# sourceMappingURL=clipboard.js.map

package/build/setup/deps/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../../src/setup/deps/clipboard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAUxC,MAAM,UAAU,2BAA2B,CACzC,IAA2B;IAE3B,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE;QACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,MAAM,UAAU,GACd,QAAQ,KAAK,QAAQ;YACnB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YAChD,CAAC,CAAC,QAAQ,KAAK,OAAO;gBACpB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;gBAC9C,CAAC,CAAC;oBACE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;oBAC7C;wBACE,OAAO,EAAE,OAAO;wBAChB,IAAI,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;wBACjC,KAAK,EAAE,IAAI;qBACZ;iBACF,CAAC;QACV,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;YACrC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * The time capability: reading the clock and waiting on it. Injectable so
+ * trace-verification polling tests run instantly against a scripted clock.
+ */
+export interface Clock {
+    now(): number;
+    sleep(ms: number): Promise<void>;
+}
+export declare function createSystemClock(): Clock;
+//# sourceMappingURL=clock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../../src/setup/deps/clock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,KAAK;IACpB,GAAG,IAAI,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,wBAAgB,iBAAiB,IAAI,KAAK,CAKzC"}

package/build/setup/deps/clock.js

@@ -0,0 +1,11 @@
+/**
+ * The time capability: reading the clock and waiting on it. Injectable so
+ * trace-verification polling tests run instantly against a scripted clock.
+ */
+export function createSystemClock() {
+    return {
+        now: () => Date.now(),
+        sleep: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+    };
+}
+//# sourceMappingURL=clock.js.map

package/build/setup/deps/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../../src/setup/deps/clock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;KACjE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * The ambient facts of a run, captured once at startup.
+ *
+ * Plain data, not behavior: steps read these values, they never call through
+ * them. Keeping the snapshot in one place is what stops `process.env` and
+ * `process.cwd()` reads from leaking into steps.
+ */
+export interface RunContext {
+    cwd: string;
+    env: Record<string, string | undefined>;
+    /**
+     * How PATH is spelled in {@link env}. `process.env` resolves names
+     * case-insensitively on Windows, where the variable is conventionally
+     * "Path"; the plain copy below is an ordinary object and does not, so the
+     * spelling is resolved once here rather than by each reader. Read PATH as
+     * `env[pathKey]`, and when overriding it for a child process use this key —
+     * spawning with "PATH" while the inherited environment carries "Path" hands
+     * the child two of them.
+     */
+    pathKey: string;
+    stdinIsTTY: boolean;
+    /** Override the px settings file location (tests only). */
+    settingsPath?: string;
+}
+/** The key PATH is spelled under, or "PATH" when the env carries none. */
+export declare function resolvePathKey(env: Record<string, string | undefined>): string;
+export declare function captureRunContext(): RunContext;
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/setup/deps/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC;;;;;;;;OAQG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GACtC,MAAM,CAER;AAED,wBAAgB,iBAAiB,IAAI,UAAU,CAU9C"}

package/build/setup/deps/context.js

@@ -0,0 +1,24 @@
+/**
+ * The ambient facts of a run, captured once at startup.
+ *
+ * Plain data, not behavior: steps read these values, they never call through
+ * them. Keeping the snapshot in one place is what stops `process.env` and
+ * `process.cwd()` reads from leaking into steps.
+ */
+import * as process from "node:process";
+/** The key PATH is spelled under, or "PATH" when the env carries none. */
+export function resolvePathKey(env) {
+    return Object.keys(env).find((key) => key.toUpperCase() === "PATH") ?? "PATH";
+}
+export function captureRunContext() {
+    // Copied, not aliased — a mid-run mutation of process.env (a spawned
+    // tool, a late dotenv load) must not change what this run resolved.
+    const env = { ...process.env };
+    return {
+        cwd: process.cwd(),
+        env,
+        pathKey: resolvePathKey(env),
+        stdinIsTTY: Boolean(process.stdin.isTTY),
+    };
+}
+//# sourceMappingURL=context.js.map

package/build/setup/deps/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/setup/deps/context.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAoBxC,0EAA0E;AAC1E,MAAM,UAAU,cAAc,CAC5B,GAAuC;IAEvC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,qEAAqE;IACrE,oEAAoE;IACpE,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC/B,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG;QACH,OAAO,EAAE,cAAc,CAAC,GAAG,CAAC;QAC5B,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;KACzC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,41 @@
+/**
+ * The docs-prefetch capability: the network+fs seam for the docs step.
+ */
+export { unknownWorkflowWarning } from "../../commands/docs.js";
+export interface DocsPrefetchOptions {
+    /** --no-docs turns the prefetch off; it is on by default. */
+    enabled: boolean;
+    /** --workflow: repeatable workflow filter; defaults to the docs defaults. */
+    workflows?: string[];
+    /** --refresh-docs: clear the output directory before downloading. */
+    refresh?: boolean;
+    /** --workers: concurrent downloads. */
+    workers?: number;
+}
+/** What the docs prefetch actually wrote — reported in the setup summary. */
+export interface DocsPrefetchResult {
+    outputDir: string;
+    workflows: string[];
+    written: number;
+    /** Pages the docs site did not serve; the agent falls back to the web for these. */
+    failed: number;
+    /** Paths the step appended to a .gitignore, folded into the setup report. */
+    gitignoreAppended?: string[];
+    /** `--workflow` names that aren't recognized — surfaced as a warning. */
+    unknownWorkflows?: string[];
+    /**
+     * Whether the docs directory holds pages the agent can read — which is not
+     * the same as `written > 0`. A re-run whose downloads all fail still leaves
+     * the previous run's tree in place, and the agent should be pointed at that
+     * rather than back at a docs site that has just failed us.
+     */
+    hasPagesOnDisk: boolean;
+}
+export type DocsFetcher = (options: DocsPrefetchOptions) => Promise<DocsPrefetchResult>;
+/**
+ * Download the docs the same way `px docs fetch` does, into the same
+ * `.px/docs` directory, so a user who later runs the command by hand refreshes
+ * the tree setup already laid down.
+ */
+export declare function fetchDocs(options: DocsPrefetchOptions): Promise<DocsPrefetchResult>;
+//# sourceMappingURL=docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/setup/deps/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgBH,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,MAAM,WAAW,GAAG,CACxB,OAAO,EAAE,mBAAmB,KACzB,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEjC;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAiB7B"}

package/build/setup/deps/docs.js

@@ -0,0 +1,33 @@
+/**
+ * The docs-prefetch capability: the network+fs seam for the docs step.
+ */
+import { existsSync, readdirSync } from "node:fs";
+import { DEFAULT_OUTPUT_DIR, DEFAULT_WORKERS, downloadDocs, fetchDocsIndex, filterByWorkflows, resolveWorkflows, } from "../../commands/docs.js";
+// This module is setup's only door onto the docs command, so the warning the
+// prefetch step prints for a bad `--workflow` comes through here rather than
+// the step reaching into `commands/` for it.
+export { unknownWorkflowWarning } from "../../commands/docs.js";
+/**
+ * Download the docs the same way `px docs fetch` does, into the same
+ * `.px/docs` directory, so a user who later runs the command by hand refreshes
+ * the tree setup already laid down.
+ */
+export async function fetchDocs(options) {
+    const { workflows, unknown } = resolveWorkflows(options.workflows);
+    const entries = filterByWorkflows(await fetchDocsIndex(), workflows);
+    const outputDir = DEFAULT_OUTPUT_DIR;
+    const { succeeded, failed } = await downloadDocs(entries, {
+        outputDir,
+        workers: options.workers ?? DEFAULT_WORKERS,
+        refresh: options.refresh,
+    });
+    return {
+        outputDir,
+        workflows,
+        written: succeeded.length,
+        failed: failed.length,
+        unknownWorkflows: unknown,
+        hasPagesOnDisk: existsSync(outputDir) && readdirSync(outputDir).length > 0,
+    };
+}
+//# sourceMappingURL=docs.js.map

package/build/setup/deps/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/setup/deps/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAE7B,6EAA6E;AAC7E,6EAA6E;AAC7E,6CAA6C;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAqC7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAA4B;IAE5B,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,cAAc,EAAE,EAAE,SAAS,CAAC,CAAC;IACrE,MAAM,SAAS,GAAG,kBAAkB,CAAC;IACrC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE;QACxD,SAAS;QACT,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,eAAe;QAC3C,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IACH,OAAO;QACL,SAAS;QACT,SAAS;QACT,OAAO,EAAE,SAAS,CAAC,MAAM;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,gBAAgB,EAAE,OAAO;QACzB,cAAc,EAAE,UAAU,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC;KAC3E,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * Dependency seam for setup.
+ *
+ * Every side effect setup performs — env access, network, subprocesses,
+ * clipboard, time — goes through `SetupDeps`. No other module under `setup/`
+ * may touch `process.env`, `fetch`, `child_process`, or the clipboard
+ * directly. This is what makes setup unit-testable with fakes.
+ *
+ * Each capability's contract (and, where it is a few lines of system glue,
+ * its real implementation) lives in its own module in this directory. This
+ * barrel re-exports the contracts so consumers address the seam as one
+ * module; it exports types only, so importing it can never form a runtime
+ * cycle. The wiring lives in `buildDefaultDeps.ts`.
+ */
+import type { ClipboardWriter } from "./clipboard.js";
+import type { Clock } from "./clock.js";
+import type { RunContext } from "./context.js";
+import type { DocsFetcher } from "./docs.js";
+import type { PhoenixClientFactory } from "./phoenixClient.js";
+import type { ProcessRunner } from "./processes.js";
+import type { Prompter } from "./prompter.js";
+export interface SetupDeps {
+    /** Ambient facts of the run — data steps read, never call. */
+    context: RunContext;
+    /** Real: clack-backed ui/clackPrompter.ts; tests: scripted answers. */
+    prompter: Prompter;
+    processes: ProcessRunner;
+    clock: Clock;
+    writeClipboard: ClipboardWriter;
+    /** Typed Phoenix client; tests inject a fake transport beneath it. */
+    createClient: PhoenixClientFactory;
+    fetchDocs: DocsFetcher;
+}
+export type { ClipboardWriter } from "./clipboard.js";
+export type { Clock } from "./clock.js";
+export type { RunContext } from "./context.js";
+export { unknownWorkflowWarning } from "./docs.js";
+export type { DocsFetcher, DocsPrefetchOptions, DocsPrefetchResult, } from "./docs.js";
+export type { PhoenixClientArgs, PhoenixClientFactory } from "./phoenixClient.js";
+export type { CommandSpec, ExecResult, ProcessRunner } from "./processes.js";
+export type { Prompter, SelectOption } from "./prompter.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/setup/deps/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,SAAS;IACxB,8DAA8D;IAC9D,OAAO,EAAE,UAAU,CAAC;IACpB,uEAAuE;IACvE,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,aAAa,CAAC;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,cAAc,EAAE,eAAe,CAAC;IAChC,sEAAsE;IACtE,YAAY,EAAE,oBAAoB,CAAC;IACnC,SAAS,EAAE,WAAW,CAAC;CACxB;AAED,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAChD,YAAY,EACV,WAAW,EACX,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC/E,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC1E,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/build/setup/deps/index.js

@@ -0,0 +1,16 @@
+/**
+ * Dependency seam for setup.
+ *
+ * Every side effect setup performs — env access, network, subprocesses,
+ * clipboard, time — goes through `SetupDeps`. No other module under `setup/`
+ * may touch `process.env`, `fetch`, `child_process`, or the clipboard
+ * directly. This is what makes setup unit-testable with fakes.
+ *
+ * Each capability's contract (and, where it is a few lines of system glue,
+ * its real implementation) lives in its own module in this directory. This
+ * barrel re-exports the contracts so consumers address the seam as one
+ * module; it exports types only, so importing it can never form a runtime
+ * cycle. The wiring lives in `buildDefaultDeps.ts`.
+ */
+export { unknownWorkflowWarning } from "./docs.js";
+//# sourceMappingURL=index.js.map

package/build/setup/deps/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/setup/deps/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA0BH,OAAO,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * The Phoenix API capability: a factory for typed clients, so steps never
+ * construct one from ambient config. Tests inject a fake transport beneath
+ * the same real client.
+ */
+import type { PhoenixClient } from "@arizeai/phoenix-client";
+export interface PhoenixClientArgs {
+    /** Normalized origin, no trailing slash. */
+    endpoint: string;
+    /** Omitted for the unauthenticated auth probe. */
+    apiKey?: string;
+}
+export type PhoenixClientFactory = (args: PhoenixClientArgs) => PhoenixClient;
+/**
+ * `apiUrl` is the hidden `--api-url` dev override: it reroutes setup's own
+ * API traffic while user-facing values — hand-off files, px profile, traces
+ * URLs — keep the endpoint the user chose.
+ */
+export declare function createPhoenixClientFactory({ apiUrl, }?: {
+    apiUrl?: string;
+}): PhoenixClientFactory;
+//# sourceMappingURL=phoenixClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phoenixClient.d.ts","sourceRoot":"","sources":["../../../src/setup/deps/phoenixClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAI7D,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,iBAAiB,KAAK,aAAa,CAAC;AAE9E;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,EACzC,MAAM,GACP,GAAE;IACD,MAAM,CAAC,EAAE,MAAM,CAAC;CACZ,GAAG,oBAAoB,CAK5B"}

package/build/setup/deps/phoenixClient.js

@@ -0,0 +1,17 @@
+/**
+ * The Phoenix API capability: a factory for typed clients, so steps never
+ * construct one from ambient config. Tests inject a fake transport beneath
+ * the same real client.
+ */
+import { createPhoenixClient } from "../../client.js";
+/**
+ * `apiUrl` is the hidden `--api-url` dev override: it reroutes setup's own
+ * API traffic while user-facing values — hand-off files, px profile, traces
+ * URLs — keep the endpoint the user chose.
+ */
+export function createPhoenixClientFactory({ apiUrl, } = {}) {
+    return ({ endpoint, apiKey }) => createPhoenixClient({
+        config: { endpoint: apiUrl ?? endpoint, apiKey },
+    });
+}
+//# sourceMappingURL=phoenixClient.js.map

package/build/setup/deps/phoenixClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phoenixClient.js","sourceRoot":"","sources":["../../../src/setup/deps/phoenixClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAWnD;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,EACzC,MAAM,GACP,GAEG,EAAE;IACJ,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAC9B,mBAAmB,CAAC;QAClB,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,IAAI,QAAQ,EAAE,MAAM,EAAE;KACjD,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * The subprocess capability: one-shot probes (git checks, agent detection)
+ * and the interactive agent hand-off share these contracts and this runner.
+ */
+export interface CommandSpec {
+    command: string;
+    args: string[];
+    stdin?: string;
+    env?: Record<string, string>;
+    cwd?: string;
+    /** Kill the child and resolve non-zero once this many ms elapse. */
+    timeoutMs?: number;
+}
+export interface ExecResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export interface ProcessRunner {
+    /** One-shot subprocess (git, probes). Never throws on non-zero exit. */
+    exec(spec: CommandSpec): Promise<ExecResult>;
+    /** Interactive subprocess with inherited stdio (agent hand-off). */
+    spawnInteractive(spec: CommandSpec): Promise<{
+        exitCode: number;
+    }>;
+}
+export declare function createSystemProcessRunner(): ProcessRunner;
+//# sourceMappingURL=processes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"processes.d.ts","sourceRoot":"","sources":["../../../src/setup/deps/processes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,oEAAoE;IACpE,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAiDD,wBAAgB,yBAAyB,IAAI,aAAa,CAKzD"}

package/build/setup/deps/processes.js

@@ -0,0 +1,58 @@
+/**
+ * The subprocess capability: one-shot probes (git checks, agent detection)
+ * and the interactive agent hand-off share these contracts and this runner.
+ */
+import * as process from "node:process";
+// cross-spawn resolves .cmd/.bat shims on Windows (npm, npx, agent CLIs),
+// where node's bare spawn fails with ENOENT unless given a shell.
+import spawn from "cross-spawn";
+function execOnce(spec) {
+    return new Promise((resolve) => {
+        const child = spawn(spec.command, spec.args, {
+            cwd: spec.cwd,
+            env: spec.env ? { ...process.env, ...spec.env } : process.env,
+            stdio: ["pipe", "pipe", "pipe"],
+            // Kills the child on expiry — a hung probe must not leave an orphaned
+            // subprocess behind. Surfaces as a non-zero exit via `close`.
+            timeout: spec.timeoutMs,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk.toString("utf-8");
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString("utf-8");
+        });
+        child.on("error", (error) => {
+            // Command not found and similar spawn failures surface as a non-zero
+            // exit with the message on stderr rather than a throw.
+            resolve({ exitCode: 127, stdout, stderr: String(error) });
+        });
+        child.on("close", (code) => {
+            resolve({ exitCode: code ?? 1, stdout, stderr });
+        });
+        if (spec.stdin !== undefined) {
+            child.stdin?.write(spec.stdin);
+        }
+        child.stdin?.end();
+    });
+}
+function spawnInteractiveChild(spec) {
+    return new Promise((resolve) => {
+        const child = spawn(spec.command, spec.args, {
+            cwd: spec.cwd,
+            env: spec.env ? { ...process.env, ...spec.env } : process.env,
+            stdio: "inherit",
+        });
+        child.on("error", () => resolve({ exitCode: 127 }));
+        child.on("close", (code) => resolve({ exitCode: code ?? 1 }));
+    });
+}
+export function createSystemProcessRunner() {
+    return {
+        exec: execOnce,
+        spawnInteractive: spawnInteractiveChild,
+    };
+}
+//# sourceMappingURL=processes.js.map

package/build/setup/deps/processes.js.map

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

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

@@ -0,0 +1,42 @@
+/**
+ * The prompting capability: every question setup asks — selects, text,
+ * masked secrets — and every line it narrates between them.
+ *
+ * Contract only. The real terminal implementation is `ui/clackPrompter.ts`
+ * (kept with the rest of the UI, since rendering rules live there); tests
+ * script answers through `scriptedPrompter`.
+ */
+export interface SelectOption<T> {
+    value: T;
+    label: string;
+    hint?: string;
+    /** Rendered unselectable with the reason appended to the label. */
+    disabled?: boolean;
+}
+export interface Prompter {
+    /** Throws SetupCancelledError on Ctrl-C / Escape. */
+    select<T>(args: {
+        message: string;
+        options: Array<SelectOption<T>>;
+    }): Promise<T>;
+    /** Throws SetupCancelledError on Ctrl-C / Escape. */
+    textInput(args: {
+        message: string;
+        defaultValue?: string;
+        validate?: (value: string) => string | undefined;
+    }): Promise<string>;
+    /** Masked input for secrets. Throws SetupCancelledError on Ctrl-C / Escape. */
+    passwordInput(args: {
+        message: string;
+        validate?: (value: string) => string | undefined;
+    }): Promise<string>;
+    /** Non-interactive display of a block of text between prompts. */
+    note(message: string, title?: string): void;
+    /** One-line status/warning between prompts (stderr). */
+    line(message: string): void;
+    /** Open the setup session frame. */
+    intro(message: string): void;
+    /** Close the setup session frame. */
+    outro(message: string): void;
+}
+//# sourceMappingURL=prompter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompter.d.ts","sourceRoot":"","sources":["../../../src/setup/deps/prompter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,qDAAqD;IACrD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;KACjC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACf,qDAAqD;IACrD,SAAS,CAAC,IAAI,EAAE;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;KAClD,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpB,+EAA+E;IAC/E,aAAa,CAAC,IAAI,EAAE;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;KAClD,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpB,kEAAkE;IAClE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,wDAAwD;IACxD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oCAAoC;IACpC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qCAAqC;IACrC,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B"}

package/build/setup/deps/prompter.js

@@ -0,0 +1,10 @@
+/**
+ * The prompting capability: every question setup asks — selects, text,
+ * masked secrets — and every line it narrates between them.
+ *
+ * Contract only. The real terminal implementation is `ui/clackPrompter.ts`
+ * (kept with the rest of the UI, since rendering rules live there); tests
+ * script answers through `scriptedPrompter`.
+ */
+export {};
+//# sourceMappingURL=prompter.js.map

package/build/setup/deps/prompter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompter.js","sourceRoot":"","sources":["../../../src/setup/deps/prompter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/build/setup/errors.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Typed errors for setup.
+ *
+ * `SetupCancelledError` is thrown by the prompter whenever the user cancels
+ * (Ctrl-C / Escape on any prompt) and unwinds the whole of setup to a single
+ * catch site in the command handler, which prints the support outro and
+ * exits with `ExitCode.CANCELLED`.
+ */
+export declare class SetupCancelledError extends Error {
+    constructor();
+}
+/**
+ * Thrown when input supplied via flags or environment variables is missing
+ * (headless mode) or invalid (any mode). Carries the exact remediation text
+ * so the command handler can print it and exit `INVALID_ARGUMENT`.
+ */
+export declare class HeadlessInputError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when a step fails in a way setup cannot recover from
+ * (e.g. headless dirty git tree). Exits `FAILURE`.
+ */
+export declare class SetupFatalError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/setup/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,cAGC;CACF;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}

package/build/setup/errors.js

@@ -0,0 +1,36 @@
+/**
+ * Typed errors for setup.
+ *
+ * `SetupCancelledError` is thrown by the prompter whenever the user cancels
+ * (Ctrl-C / Escape on any prompt) and unwinds the whole of setup to a single
+ * catch site in the command handler, which prints the support outro and
+ * exits with `ExitCode.CANCELLED`.
+ */
+export class SetupCancelledError extends Error {
+    constructor() {
+        super("Setup cancelled by user");
+        this.name = "SetupCancelledError";
+    }
+}
+/**
+ * Thrown when input supplied via flags or environment variables is missing
+ * (headless mode) or invalid (any mode). Carries the exact remediation text
+ * so the command handler can print it and exit `INVALID_ARGUMENT`.
+ */
+export class HeadlessInputError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "HeadlessInputError";
+    }
+}
+/**
+ * Thrown when a step fails in a way setup cannot recover from
+ * (e.g. headless dirty git tree). Exits `FAILURE`.
+ */
+export class SetupFatalError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SetupFatalError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/build/setup/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/setup/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C;QACE,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}