@arizeai/phoenix-cli 1.9.1 → 1.10.0

package/build/setup/mcp/runSetupMcp.js

@@ -0,0 +1,235 @@
+/**
+ * `px setup mcp` — register the Phoenix remote MCP server (`<base-url>/mcp`)
+ * with a coding agent's config. This module receives the already-resolved
+ * endpoint from the command layer.
+ *
+ * Auth defaults to OAuth (URL-only config; the agent handles browser login on
+ * first use). `--header` adds an API-key bearer fallback for headless clients,
+ * applied per agent (see {@link ./agents}).
+ *
+ * Without `--agent` the command prompts for scope then agent, after confirming
+ * the endpoint. A headless run requires `--agent` and defaults to global scope.
+ */
+import { ENDPOINT_REQUIREMENT, isEndpointUrl, normalizeEndpoint, } from "../../validation/endpoint.js";
+import { detectAgents } from "../agents/registry.js";
+import { HeadlessInputError, SetupFatalError } from "../errors.js";
+import { getMcpAgent, MCP_AGENTS, MCP_AGENT_IDS, PHOENIX_MCP_SERVER_NAME, } from "./agents.js";
+import { runMcpInstall } from "./install.js";
+export const COPY = {
+    endpointPrompt: "Phoenix endpoint",
+    endpointInvalid: "Enter a full http:// or https:// URL (e.g. http://localhost:6006).",
+    endpointUnusable: (value) => `The resolved endpoint "${value}" ${ENDPOINT_REQUIREMENT}. ` +
+        "Fix PHOENIX_HOST or the active profile, or pass --endpoint <url>.",
+    usingEndpoint: (url) => `Registering the Phoenix MCP server at ${url}`,
+    scopePrompt: "Where should the MCP server be configured?",
+    scopeGlobalLabel: "Global",
+    scopeGlobalHint: "available across all your projects",
+    scopeLocalLabel: "This repo",
+    scopeLocalHint: "written into this project's config, checked in with it",
+    agentPrompt: "Which coding agent?",
+    detectedHint: "detected",
+    headlessNeedsAgent: `--agent is required with --no-input. Pass one of: ${MCP_AGENT_IDS.join(", ")}.`,
+    localNeedsRepo: "--local must run inside a git repository. Re-run from your project, or use --global.",
+    globalOnly: (agentLabel) => `${agentLabel} reads only a global config, so it is always configured globally.`,
+    globalOnlyHeadless: (agentLabel) => `${agentLabel} has no repo-scoped config. Drop --local (${agentLabel} is always global).`,
+    homeUnknown: (agentLabel) => `Could not find your home directory (HOME/USERPROFILE is unset), ` +
+        `where the global ${agentLabel} config lives. Set HOME, or use --local.`,
+    scopeUnsupported: (agentLabel, scope) => `${agentLabel} does not support ${scope} MCP configuration.`,
+    headersUnsupported: (agentLabel, dropped) => `${agentLabel} can't store this header (${dropped
+        .map((header) => header.name)
+        .join(", ")}) — it only accepts a bearer token via env var. Pass ` +
+        `--header "Authorization: Bearer \${VAR}", or omit --header to use OAuth.`,
+    configuredCli: (agentLabel) => `Registered the Phoenix MCP server with ${agentLabel}.`,
+    configuredFile: (agentLabel, file) => `Wrote the Phoenix MCP server to ${file} for ${agentLabel}.`,
+    installFailed: (agentLabel, reason) => `Could not configure ${agentLabel}: ${reason}`,
+    nextStepOAuth: (agentLabel) => `Open ${agentLabel} and run /mcp (or use the ${PHOENIX_MCP_SERVER_NAME} server) — it will open a browser to log in to Phoenix on first use.`,
+    nextStepHeader: "The server is configured with your bearer header — no browser login needed.",
+};
+// ---------------------------------------------------------------------------
+// Entry
+// ---------------------------------------------------------------------------
+export async function runSetupMcp(deps, inputs) {
+    const endpoint = await resolveEndpoint(deps, inputs);
+    const url = `${endpoint}/mcp`;
+    const scope = await resolveScope(deps, inputs);
+    const agent = await resolveAgent(deps, inputs);
+    const effectiveScope = await reconcileScope(deps, agent, scope, inputs);
+    // A local install must land at the repo root — `px` may be running in a
+    // subdirectory, where a repo-scoped config would never be picked up.
+    const installCwd = effectiveScope === "local" ? await resolveRepoRoot(deps) : deps.context.cwd;
+    const action = agent.install[effectiveScope];
+    if (!action) {
+        // reconcileScope already handles codex; this covers any future scope gap.
+        throw new SetupFatalError(COPY.scopeUnsupported(agent.label, effectiveScope));
+    }
+    // Refuse headers the agent can't actually persist rather than writing a
+    // config that reports `auth: "header"` but carries no credential.
+    if (action.kind === "cli" && action.droppedHeaders) {
+        const dropped = action.droppedHeaders(inputs.headers);
+        if (dropped.length > 0) {
+            throw new HeadlessInputError(COPY.headersUnsupported(agent.label, dropped));
+        }
+    }
+    const installContext = {
+        home: resolveHome(deps),
+        cwd: installCwd,
+    };
+    // A global file install writes under the home directory; without one the
+    // path would be relative and the failure message an internal invariant.
+    if (action.kind === "file" &&
+        effectiveScope === "global" &&
+        !installContext.home) {
+        throw new SetupFatalError(COPY.homeUnknown(agent.label));
+    }
+    const result = await runMcpInstall(deps, {
+        action,
+        url,
+        headers: inputs.headers,
+        installContext,
+    });
+    if (result.outcome === "failed") {
+        throw new SetupFatalError(COPY.installFailed(agent.label, result.reason ?? "unknown error"));
+    }
+    const auth = inputs.headers.length > 0 ? "header" : "oauth";
+    if (!inputs.headless) {
+        deps.prompter.line(result.file
+            ? COPY.configuredFile(agent.label, result.file)
+            : COPY.configuredCli(agent.label));
+        deps.prompter.line(auth === "oauth" ? COPY.nextStepOAuth(agent.label) : COPY.nextStepHeader);
+    }
+    return {
+        endpoint,
+        url,
+        serverName: PHOENIX_MCP_SERVER_NAME,
+        agent: agent.id,
+        scope: effectiveScope,
+        auth,
+        ...(result.file ? { file: result.file } : {}),
+    };
+}
+// ---------------------------------------------------------------------------
+// Endpoint
+// ---------------------------------------------------------------------------
+async function resolveEndpoint(deps, inputs) {
+    // Headless, or endpoint pinned by flag: take the resolved value as-is.
+    if (inputs.headless || inputs.endpointExplicit) {
+        // The value may come from PHOENIX_HOST or a profile, which nothing has
+        // validated yet — refuse it as bad input rather than let
+        // `normalizeEndpoint`'s TypeError get misreported as a network error.
+        if (!isEndpointUrl(inputs.endpoint)) {
+            throw new HeadlessInputError(COPY.endpointUnusable(inputs.endpoint));
+        }
+        return normalizeEndpoint(inputs.endpoint);
+    }
+    // Interactive: show the inferred endpoint as the default and let the user
+    // accept it (Enter) or point somewhere else.
+    const entered = await deps.prompter.textInput({
+        message: COPY.endpointPrompt,
+        defaultValue: inputs.endpoint,
+        validate: (value) => isEndpointUrl(value) ? undefined : COPY.endpointInvalid,
+    });
+    const endpoint = normalizeEndpoint(entered);
+    deps.prompter.line(COPY.usingEndpoint(`${endpoint}/mcp`));
+    return endpoint;
+}
+// ---------------------------------------------------------------------------
+// Scope
+// ---------------------------------------------------------------------------
+async function resolveScope(deps, inputs) {
+    if (inputs.scope) {
+        return inputs.scope;
+    }
+    // Headless defaults to global — the safe, agent-agnostic choice, and the one
+    // scope every agent supports.
+    if (inputs.headless) {
+        return "global";
+    }
+    return deps.prompter.select({
+        message: COPY.scopePrompt,
+        options: [
+            {
+                value: "global",
+                label: COPY.scopeGlobalLabel,
+                hint: COPY.scopeGlobalHint,
+            },
+            {
+                value: "local",
+                label: COPY.scopeLocalLabel,
+                hint: COPY.scopeLocalHint,
+            },
+        ],
+    });
+}
+/**
+ * Codex has no repo-scoped config. When `--local` names it, a headless run
+ * errors on the unsupported scope; an interactive run warns and falls back to
+ * global.
+ */
+async function reconcileScope(deps, agent, scope, inputs) {
+    if (agent.install[scope]) {
+        return scope;
+    }
+    if (scope === "local" && agent.install.global) {
+        if (inputs.headless) {
+            throw new HeadlessInputError(COPY.globalOnlyHeadless(agent.label));
+        }
+        deps.prompter.line(COPY.globalOnly(agent.label));
+        return "global";
+    }
+    throw new SetupFatalError(COPY.scopeUnsupported(agent.label, scope));
+}
+/** The repo root a local install writes into; errors outside a git repo. */
+async function resolveRepoRoot(deps) {
+    const check = await deps.processes.exec({
+        command: "git",
+        args: ["rev-parse", "--show-toplevel"],
+        cwd: deps.context.cwd,
+    });
+    const root = check.stdout.trim();
+    if (check.exitCode !== 0 || !root) {
+        // Same class either mode: it's a bad invocation, not a runtime failure.
+        throw new HeadlessInputError(COPY.localNeedsRepo);
+    }
+    return root;
+}
+// ---------------------------------------------------------------------------
+// Agent
+// ---------------------------------------------------------------------------
+async function resolveAgent(deps, inputs) {
+    if (inputs.agent) {
+        const agent = getMcpAgent(inputs.agent);
+        if (!agent) {
+            // Unreachable: the command layer validates --agent against MCP_AGENT_IDS.
+            throw new HeadlessInputError(COPY.headlessNeedsAgent);
+        }
+        return agent;
+    }
+    if (inputs.headless) {
+        throw new HeadlessInputError(COPY.headlessNeedsAgent);
+    }
+    const detected = await detectAgents(deps, MCP_AGENTS);
+    const detectedIds = new Set(detected.map((agent) => agent.id));
+    // Detected agents first (with a hint), then the rest — so a user can still
+    // configure an agent whose binary isn't on PATH (e.g. the VS Code app without
+    // the `code` shell command).
+    const ordered = [
+        ...MCP_AGENTS.filter((agent) => detectedIds.has(agent.id)),
+        ...MCP_AGENTS.filter((agent) => !detectedIds.has(agent.id)),
+    ];
+    const chosen = await deps.prompter.select({
+        message: COPY.agentPrompt,
+        options: ordered.map((agent) => ({
+            value: agent.id,
+            label: agent.label,
+            ...(detectedIds.has(agent.id) ? { hint: COPY.detectedHint } : {}),
+        })),
+    });
+    // `chosen` is one of MCP_AGENTS' ids by construction.
+    return getMcpAgent(chosen);
+}
+/** The user's home directory, read only through the run context's env copy. */
+function resolveHome(deps) {
+    const { env } = deps.context;
+    return env.HOME ?? env.USERPROFILE ?? "";
+}
+//# sourceMappingURL=runSetupMcp.js.map

package/build/setup/mcp/runSetupMcp.js.map

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

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

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

package/build/setup/steps/offerDocsMcp.js

@@ -21,6 +21,7 @@
  * get a merge into their documented config file. Headless runs never touch
  * agent config unless `--docs-mcp` asked for it.
  */
+import * as path from "node:path";
 import { DOCS_MCP_SERVER_URL } from "../agents/registry.js";
 import * as COPY from "../copy.js";
 import { SetupCancelledError } from "../errors.js";
@@ -116,8 +117,8 @@ async function runOffer(deps, args) {
     // A write that throws (unparseable existing file, permissions) is handled
     // by the catch-all in offerDocsMcp.
     writeMcpConfig({
-        directory: deps.context.cwd,
-        relativePath: install.relativePath,
+        filePath: path.join(deps.context.cwd, install.relativePath),
+        displayPath: install.relativePath,
         patch: install.patch(DOCS_MCP_SERVER_URL),
         ...(install.createDefaults
             ? { createDefaults: install.createDefaults }

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

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

package/build/setup/util/mcpConfig.d.ts

@@ -7,10 +7,17 @@
  * refused rather than clobbered; the caller degrades to the docs download.
  */
 export interface WriteMcpConfigArgs {
-    /** Repo root the relative config path resolves against. */
-    directory: string;
-    /** Config file path, relative to `directory`. */
-    relativePath: string;
+    /**
+     * Absolute path to the config file to merge into. Callers compose it from a
+     * repo root or the user's home directory before calling — this function does
+     * not join paths.
+     */
+    filePath: string;
+    /**
+     * How the path reads in the "could not be parsed" error: the repo-relative
+     * path where the caller has one, else the absolute `filePath` (the default).
+     */
+    displayPath?: string;
     /**
      * JSON fragment to merge in: container and server-name keys merge, a
      * server entry itself is replaced wholesale.
@@ -27,5 +34,5 @@ export interface WriteMcpConfigArgs {
 export declare class McpConfigUnreadableError extends Error {
     constructor(relativePath: string, detail: string);
 }
-export declare function writeMcpConfig({ directory, relativePath, patch, createDefaults, }: WriteMcpConfigArgs): void;
+export declare function writeMcpConfig({ filePath, displayPath, patch, createDefaults, }: WriteMcpConfigArgs): void;
 //# sourceMappingURL=mcpConfig.d.ts.map

package/build/setup/util/mcpConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcpConfig.d.ts","sourceRoot":"","sources":["../../../src/setup/util/mcpConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AA8BD,mEAAmE;AACnE,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,YAAY,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAG/C;CACF;AAED,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,YAAY,EACZ,KAAK,EACL,cAAc,GACf,EAAE,kBAAkB,GAAG,IAAI,CA8B3B"}
+{"version":3,"file":"mcpConfig.d.ts","sourceRoot":"","sources":["../../../src/setup/util/mcpConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC1C;AA8BD,mEAAmE;AACnE,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,YAAY,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAG/C;CACF;AAED,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,WAAsB,EACtB,KAAK,EACL,cAAc,GACf,EAAE,kBAAkB,GAAG,IAAI,CAgC3B"}

package/build/setup/util/mcpConfig.js

@@ -36,8 +36,10 @@ export class McpConfigUnreadableError extends Error {
         this.name = "McpConfigUnreadableError";
     }
 }
-export function writeMcpConfig({ directory, relativePath, patch, createDefaults, }) {
-    const filePath = path.join(directory, relativePath);
+export function writeMcpConfig({ filePath, displayPath = filePath, patch, createDefaults, }) {
+    if (!path.isAbsolute(filePath)) {
+        throw new Error("writeMcpConfig requires an absolute path");
+    }
     let existing = createDefaults ?? {};
     if (fs.existsSync(filePath)) {
         let parsed;
@@ -45,10 +47,10 @@ export function writeMcpConfig({ directory, relativePath, patch, createDefaults,
             parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
         }
         catch (error) {
-            throw new McpConfigUnreadableError(relativePath, error instanceof Error ? error.message : String(error));
+            throw new McpConfigUnreadableError(displayPath, error instanceof Error ? error.message : String(error));
         }
         if (!isPlainObject(parsed)) {
-            throw new McpConfigUnreadableError(relativePath, "not a JSON object");
+            throw new McpConfigUnreadableError(displayPath, "not a JSON object");
         }
         existing = parsed;
     }

package/build/setup/util/mcpConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcpConfig.js","sourceRoot":"","sources":["../../../src/setup/util/mcpConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAoBlC,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,SAAS,WAAW,CAClB,IAA6B,EAC7B,KAA8B,EAC9B,MAAc;IAEd,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC;YACT,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC;gBACjE,CAAC,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,CAAC;gBAChD,CAAC,CAAC,UAAU,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mEAAmE;AACnE,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,YAAoB,EAAE,MAAc;QAC9C,KAAK,CAAC,GAAG,YAAY,oCAAoC,MAAM,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,EAC7B,SAAS,EACT,YAAY,EACZ,KAAK,EACL,cAAc,GACK;IACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEpD,IAAI,QAAQ,GAA4B,cAAc,IAAI,EAAE,CAAC;IAC7D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,wBAAwB,CAChC,YAAY,EACZ,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,wBAAwB,CAAC,YAAY,EAAE,mBAAmB,CAAC,CAAC;QACxE,CAAC;QACD,QAAQ,GAAG,MAAM,CAAC;IACpB,CAAC;IAED,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,yEAAyE;IACzE,oBAAoB;IACpB,MAAM,QAAQ,GAAG,GAAG,QAAQ,eAAe,CAAC;IAC5C,EAAE,CAAC,aAAa,CACd,QAAQ,EACR,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAC1E,OAAO,CACR,CAAC;IACF,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"mcpConfig.js","sourceRoot":"","sources":["../../../src/setup/util/mcpConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AA2BlC,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;;;;GAKG;AACH,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,SAAS,WAAW,CAClB,IAA6B,EAC7B,KAA8B,EAC9B,MAAc;IAEd,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC;YACT,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,SAAS,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC;gBACjE,CAAC,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,CAAC;gBAChD,CAAC,CAAC,UAAU,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mEAAmE;AACnE,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IACjD,YAAY,YAAoB,EAAE,MAAc;QAC9C,KAAK,CAAC,GAAG,YAAY,oCAAoC,MAAM,GAAG,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,EAC7B,QAAQ,EACR,WAAW,GAAG,QAAQ,EACtB,KAAK,EACL,cAAc,GACK;IACnB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,QAAQ,GAA4B,cAAc,IAAI,EAAE,CAAC;IAC7D,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,wBAAwB,CAChC,WAAW,EACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACvD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,wBAAwB,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;QACvE,CAAC;QACD,QAAQ,GAAG,MAAM,CAAC;IACpB,CAAC;IAED,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,yEAAyE;IACzE,oBAAoB;IACpB,MAAM,QAAQ,GAAG,GAAG,QAAQ,eAAe,CAAC;IAC5C,EAAE,CAAC,aAAa,CACd,QAAQ,EACR,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAC1E,OAAO,CACR,CAAC;IACF,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arizeai/phoenix-cli",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "A command-line interface for Phoenix",
   "keywords": [
     "arize",