@arizeai/phoenix-cli 0.10.0 → 0.11.0

package/README.md

@@ -99,6 +99,49 @@ px trace abc123def456 --file trace.json
 
 ---
 
+### `px spans [file]`
+
+Fetch spans for the configured project with filtering options. Output is JSON.
+
+```bash
+px spans --limit 50                                    # stdout (pretty)
+px spans --span-kind LLM --limit 20                    # only LLM spans
+px spans --status-code ERROR --format raw --no-progress # pipe-friendly error spans
+px spans --name chat_completion --trace-id abc123       # filter by name and trace
+px spans --parent-id null                               # root spans only
+px spans spans.json --limit 100 --include-annotations   # save to file with annotations
+px spans --last-n-minutes 30 --span-kind TOOL RETRIEVER # multiple span kinds
+```
+
+| Option                      | Description                                                                                                                      | Default  |
+| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | -------- |
+| `[file]`                    | Save spans as JSON to file                                                                                                       | stdout   |
+| `-n, --limit <number>`      | Maximum number of spans (newest first)                                                                                           | `100`    |
+| `--last-n-minutes <number>` | Only spans from the last N minutes                                                                                               | —        |
+| `--since <timestamp>`       | Spans since ISO timestamp                                                                                                        | —        |
+| `--span-kind <kinds...>`    | Filter by span kind (`LLM`, `CHAIN`, `TOOL`, `RETRIEVER`, `EMBEDDING`, `AGENT`, `RERANKER`, `GUARDRAIL`, `EVALUATOR`, `UNKNOWN`) | —        |
+| `--status-code <codes...>`  | Filter by status code (`OK`, `ERROR`, `UNSET`)                                                                                   | —        |
+| `--name <names...>`         | Filter by span name(s)                                                                                                           | —        |
+| `--trace-id <ids...>`       | Filter by trace ID(s)                                                                                                            | —        |
+| `--parent-id <id>`          | Filter by parent span ID (use `"null"` for root spans only)                                                                      | —        |
+| `--include-annotations`     | Include span annotations in the output                                                                                           | —        |
+| `--format <format>`         | `pretty`, `json`, or `raw`                                                                                                       | `pretty` |
+| `--no-progress`             | Suppress progress output                                                                                                         | —        |
+
+```bash
+# Find all ERROR spans
+px spans --status-code ERROR --format raw --no-progress | jq '.[] | {name, status_code}'
+
+# Get LLM spans with token counts
+px spans --span-kind LLM --format raw --no-progress | \
+  jq '.[] | {name, model: .attributes["llm.model_name"], tokens: (.attributes["llm.token_count.prompt"] + .attributes["llm.token_count.completion"])}'
+
+# Root spans only, sorted by name
+px spans --parent-id null --format raw --no-progress | jq 'sort_by(.name)'
+```
+
+---
+
 ### `px datasets`
 
 List all datasets.
@@ -176,6 +219,78 @@ px prompt my-evaluator --tag production --format json | jq '.template'
 
 ---
 
+### `px projects`
+
+List all available Phoenix projects.
+
+```bash
+px projects                                           # pretty output
+px projects --format raw --no-progress | jq '.[].name'
+px projects --limit 5
+```
+
+| Option              | Description                         | Default  |
+| ------------------- | ----------------------------------- | -------- |
+| `--limit <number>`  | Maximum number of projects per page | —        |
+| `--format <format>` | `pretty`, `json`, or `raw`          | `pretty` |
+| `--no-progress`     | Suppress progress output            | —        |
+
+---
+
+### `px sessions`
+
+List sessions for a project.
+
+```bash
+px sessions                                            # latest 10 sessions
+px sessions --limit 20 --order asc                     # oldest first
+px sessions --format raw --no-progress | jq '.[].session_id'
+```
+
+| Option                 | Description                 | Default  |
+| ---------------------- | --------------------------- | -------- |
+| `-n, --limit <number>` | Maximum number of sessions  | `10`     |
+| `--order <order>`      | Sort order: `asc` or `desc` | `desc`   |
+| `--format <format>`    | `pretty`, `json`, or `raw`  | `pretty` |
+| `--no-progress`        | Suppress progress output    | —        |
+
+---
+
+### `px session <session-id>`
+
+View a session's conversation flow.
+
+```bash
+px session my-session-id
+px session my-session-id --file session.json
+px session my-session-id --include-annotations --format raw | jq '.traces'
+```
+
+| Option                  | Description                            | Default  |
+| ----------------------- | -------------------------------------- | -------- |
+| `--file <path>`         | Save session to file instead of stdout | —        |
+| `--include-annotations` | Include session annotations            | —        |
+| `--format <format>`     | `pretty`, `json`, or `raw`             | `pretty` |
+| `--no-progress`         | Suppress progress output               | —        |
+
+---
+
+### `px auth status`
+
+Show current Phoenix authentication status, including the configured endpoint, whether you are authenticated or anonymous, and an obscured API key.
+
+```bash
+px auth status
+px auth status --endpoint http://localhost:6006
+```
+
+| Option             | Description          | Default |
+| ------------------ | -------------------- | ------- |
+| `--endpoint <url>` | Phoenix API endpoint | —       |
+| `--api-key <key>`  | Phoenix API key      | —       |
+
+---
+
 ### `px api graphql <query>`
 
 Make authenticated GraphQL queries against the Phoenix API. Output is `{"data": {...}}` JSON — pipe with `jq '.data.<field>'` to extract values. Only queries are permitted; mutations and subscriptions are rejected.
@@ -184,6 +299,22 @@ Make authenticated GraphQL queries against the Phoenix API. Output is `{"data":
 px api graphql '<query>' [--endpoint <url>] [--api-key <key>]
 ```
 
+Preview the exact HTTP request as `curl` without executing it:
+
+```bash
+px api graphql '{ projects { edges { node { name } } } }' --curl
+px api graphql '{ projects { edges { node { name } } } }' --curl --show-token
+```
+
+`--curl` prints the equivalent request to stdout and exits without making a network call. Authorization headers are masked by default, including values supplied through `PHOENIX_API_KEY` or `PHOENIX_CLIENT_HEADERS`. Use `--show-token` only when you explicitly need the raw credential in the generated command.
+
+Current scope and behavior:
+
+- `--curl` is currently implemented for `px api graphql` only.
+- `--curl` prints the request without executing it.
+- `--show-token` is only valid with `--curl`.
+- Authorization masking and header normalization are designed to match the live request behavior used by `fetch`.
+
 Use introspection to discover what fields are available:
 
 ```bash

package/build/commands/api.d.ts

@@ -1,4 +1,5 @@
 import { Command } from "commander";
+import type { PhoenixConfig } from "../config.js";
 /**
  * Returns true if the query string is a GraphQL mutation or subscription.
  * Strips # comments first to avoid false positives.
@@ -6,5 +7,19 @@ import { Command } from "commander";
 export declare function isNonQuery({ query }: {
     query: string;
 }): boolean;
+export interface ApiGraphqlRequest {
+    url: string;
+    method: "POST";
+    headers: Record<string, string>;
+    body: string;
+}
+/**
+ * Builds the exact outbound GraphQL request used by both live execution and
+ * `--curl` preview mode so the two paths cannot drift apart.
+ */
+export declare function buildGraphqlRequest({ query, config, }: {
+    query: string;
+    config: PhoenixConfig;
+}): ApiGraphqlRequest;
 export declare function createApiCommand(): Command;
 //# sourceMappingURL=api.d.ts.map

package/build/commands/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/commands/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAGhE;AAkHD,wBAAgB,gBAAgB,IAAI,OAAO,CAK1C"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/commands/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAM/C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAGhE;AASD,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,KAAK,EACL,MAAM,GACP,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,CAAC;CACvB,GAAG,iBAAiB,CAepB;AA6ID,wBAAgB,gBAAgB,IAAI,OAAO,CAK1C"}

package/build/commands/api.js

@@ -1,5 +1,6 @@
 import { Command } from "commander";
 import { getConfigErrorMessage, resolveConfig } from "../config.js";
+import { renderCurlCommand } from "../curl.js";
 import { ExitCode, getExitCodeForError } from "../exitCodes.js";
 import { writeError, writeOutput } from "../io.js";
 /**
@@ -10,8 +11,33 @@ export function isNonQuery({ query }) {
     const stripped = query.replace(/#[^\n]*/g, "");
     return /^\s*(mutation|subscription)[\s({]/m.test(stripped);
 }
+/**
+ * Builds the exact outbound GraphQL request used by both live execution and
+ * `--curl` preview mode so the two paths cannot drift apart.
+ */
+export function buildGraphqlRequest({ query, config, }) {
+    const headers = {
+        "Content-Type": "application/json",
+        ...(config.headers ?? {}),
+    };
+    if (config.apiKey) {
+        headers["Authorization"] = `Bearer ${config.apiKey}`;
+    }
+    return {
+        url: `${config.endpoint?.replace(/\/$/, "")}/graphql`,
+        method: "POST",
+        headers,
+        body: JSON.stringify({ query }),
+    };
+}
 async function apiGraphqlHandler(query, options) {
     try {
+        if (options.showToken && !options.curl) {
+            writeError({
+                message: "Error: --show-token can only be used with --curl.",
+            });
+            process.exit(ExitCode.INVALID_ARGUMENT);
+        }
         // 1. Reject mutations and subscriptions
         if (isNonQuery({ query })) {
             writeError({
@@ -33,24 +59,31 @@ async function apiGraphqlHandler(query, options) {
             });
             process.exit(ExitCode.INVALID_ARGUMENT);
         }
-        // 3. Build URL and auth headers
-        const graphqlUrl = `${config.endpoint.replace(/\/$/, "")}/graphql`;
-        const headers = {
-            "Content-Type": "application/json",
-            ...(config.headers ?? {}),
-        };
-        if (config.apiKey) {
-            headers["Authorization"] = `Bearer ${config.apiKey}`;
+        const request = buildGraphqlRequest({
+            query,
+            config,
+        });
+        if (options.curl) {
+            writeOutput({
+                message: renderCurlCommand({
+                    method: request.method,
+                    url: request.url,
+                    headers: request.headers,
+                    body: request.body,
+                    maskTokens: !options.showToken,
+                }),
+            });
+            return;
         }
         // 4. POST using Node 22 built-in fetch
-        const response = await fetch(graphqlUrl, {
-            method: "POST",
-            headers,
-            body: JSON.stringify({ query }),
+        const response = await fetch(request.url, {
+            method: request.method,
+            headers: request.headers,
+            body: request.body,
         });
         if (!response.ok) {
             writeError({
-                message: `Error: HTTP ${response.status} ${response.statusText} from ${graphqlUrl}`,
+                message: `Error: HTTP ${response.status} ${response.statusText} from ${request.url}`,
             });
             if (response.status === 401 || response.status === 403) {
                 process.exit(ExitCode.AUTH_REQUIRED);
@@ -92,10 +125,21 @@ function createApiGraphqlCommand() {
         "\n" +
         "    # Pipe to jq to extract fields\n" +
         "    px api graphql '{ projects { edges { node { name } } } }' | \\\n" +
-        "      jq '.data.projects.edges[].node.name'")
+        "      jq '.data.projects.edges[].node.name'\n" +
+        "\n" +
+        "    # Print the equivalent curl command without executing it\n" +
+        "    px api graphql '{ projects { edges { node { name } } } }' --curl\n" +
+        "\n" +
+        "    # Reveal the raw token in curl output\n" +
+        "    px api graphql '{ projects { edges { node { name } } } }' --curl --show-token\n" +
+        "\n" +
+        "  Curl mode prints the request without executing it.\n" +
+        "  Auth tokens are masked by default. Use --show-token with --curl to reveal them.")
         .argument("<query>", "GraphQL query string")
         .option("--endpoint <url>", "Phoenix API endpoint (or set PHOENIX_HOST)")
         .option("--api-key <key>", "Phoenix API key (or set PHOENIX_API_KEY)")
+        .option("--curl", "Print the equivalent curl command instead of executing the request")
+        .option("--show-token", "Show the raw Authorization token in curl output (requires --curl)")
         .action(apiGraphqlHandler);
 }
 export function createApiCommand() {

package/build/commands/api.js.map

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

package/build/curl.d.ts

@@ -0,0 +1,13 @@
+export interface RenderCurlCommandOptions {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: string;
+    maskTokens: boolean;
+}
+/**
+ * Renders a pipe-friendly multiline curl command that matches the request
+ * Phoenix CLI would send over `fetch`.
+ */
+export declare function renderCurlCommand({ method, url, headers, body, maskTokens, }: RenderCurlCommandOptions): string;
+//# sourceMappingURL=curl.d.ts.map

package/build/curl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curl.d.ts","sourceRoot":"","sources":["../src/curl.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;CACrB;AAqDD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAM,EACN,GAAG,EACH,OAAO,EACP,IAAI,EACJ,UAAU,GACX,EAAE,wBAAwB,GAAG,MAAM,CAkBnC"}

package/build/curl.js

@@ -0,0 +1,49 @@
+import { obscureApiKey } from "./commands/auth.js";
+function shellEscape(value) {
+    return "'" + value.replace(/'/g, "'\"'\"'") + "'";
+}
+/**
+ * Normalize headers through the platform `Headers` implementation so curl
+ * output mirrors how `fetch` combines duplicate logical headers such as
+ * `authorization` + `Authorization`.
+ */
+function normalizeHeaders(headers) {
+    const normalizedHeaders = new Headers();
+    const headerNames = new Map();
+    for (const [key, value] of Object.entries(headers)) {
+        normalizedHeaders.append(key, value);
+        headerNames.set(key.toLowerCase(), headerNames.get(key.toLowerCase()) ?? key);
+    }
+    return Array.from(normalizedHeaders.entries()).map(([key, value]) => [
+        headerNames.get(key) ?? key,
+        value,
+    ]);
+}
+function maskHeaderValue({ key, value, maskTokens, }) {
+    if (!maskTokens || key.toLowerCase() !== "authorization") {
+        return value;
+    }
+    const match = value.match(/^(\S+)\s+(.+)$/);
+    if (match) {
+        const [, prefix, token] = match;
+        return `${prefix} ${obscureApiKey(token)}`;
+    }
+    return obscureApiKey(value);
+}
+/**
+ * Renders a pipe-friendly multiline curl command that matches the request
+ * Phoenix CLI would send over `fetch`.
+ */
+export function renderCurlCommand({ method, url, headers, body, maskTokens, }) {
+    const lines = ["curl \\"];
+    lines.push(`  -X ${method.toUpperCase()} \\`);
+    for (const [key, value] of normalizeHeaders(headers)) {
+        lines.push(`  -H ${shellEscape(`${key}: ${maskHeaderValue({ key, value, maskTokens })}`)} \\`);
+    }
+    if (body !== undefined) {
+        lines.push(`  --data-raw ${shellEscape(body)} \\`);
+    }
+    lines.push(`  ${shellEscape(url)}`);
+    return lines.join("\n");
+}
+//# sourceMappingURL=curl.js.map

package/build/curl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"curl.js","sourceRoot":"","sources":["../src/curl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAUhD,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,GAAG,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CACvB,OAA+B;IAE/B,MAAM,iBAAiB,GAAG,IAAI,OAAO,EAAE,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,iBAAiB,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrC,WAAW,CAAC,GAAG,CACb,GAAG,CAAC,WAAW,EAAE,EACjB,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,GAAG,CAC1C,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QACnE,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG;QAC3B,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,EACvB,GAAG,EACH,KAAK,EACL,UAAU,GAKX;IACC,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,eAAe,EAAE,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC5C,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;QAChC,OAAO,GAAG,MAAM,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,MAAM,EACN,GAAG,EACH,OAAO,EACP,IAAI,EACJ,UAAU,GACe;IACzB,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,CAAC;IAE1B,KAAK,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAE9C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QACrD,KAAK,CAAC,IAAI,CACR,QAAQ,WAAW,CAAC,GAAG,GAAG,KAAK,eAAe,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,KAAK,CACnF,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,gBAAgB,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEpC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arizeai/phoenix-cli",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "A command-line interface for Phoenix",
   "keywords": [
     "arize",
@@ -32,8 +32,8 @@
   "dependencies": {
     "@arizeai/openinference-semantic-conventions": "^1.1.0",
     "commander": "^12.1.0",
-    "@arizeai/phoenix-config": "0.1.1",
-    "@arizeai/phoenix-client": "6.5.1"
+    "@arizeai/phoenix-client": "6.5.2",
+    "@arizeai/phoenix-config": "0.1.1"
   },
   "devDependencies": {
     "@types/node": "^18.19.0",