@arizeai/phoenix-cli 0.5.2 → 0.7.0

package/README.md

@@ -22,287 +22,280 @@
     <img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=8e8e8b34-7900-43fa-a38f-1f070bd48c64&page=js/packages/phoenix-cli/README.md" />
 </p>
 
-A command-line interface for [Arize Phoenix](https://github.com/Arize-ai/phoenix). Fetch traces, list datasets, and export experiment results directly from your terminal—or pipe them into AI coding agents like Claude Code, Cursor, Codex, and Gemini CLI.
+A command-line interface for [Arize Phoenix](https://github.com/Arize-ai/phoenix). Fetch traces, inspect datasets, query experiments, and access prompts directly from your terminal—or pipe them into AI coding agents like Claude Code, Cursor, Codex, and Gemini CLI.
 
 ## Installation
 
 ```bash
 npm install -g @arizeai/phoenix-cli
-```
-
-Or run directly with npx:
-
-```bash
+# or run without installing:
 npx @arizeai/phoenix-cli
 ```
 
-## Quick Start
+## Configuration
 
 ```bash
-# Configure your Phoenix instance
 export PHOENIX_HOST=http://localhost:6006
 export PHOENIX_PROJECT=my-project
 export PHOENIX_API_KEY=your-api-key  # if authentication is enabled
-
-# Fetch the most recent trace
-px traces --limit 1
-
-# Fetch a specific trace by ID
-px trace abc123def456
-
-# Export traces to a directory
-px traces ./my-traces --limit 50
 ```
 
-## Environment Variables
-
-| Variable                 | Description                                          |
-| ------------------------ | ---------------------------------------------------- |
-| `PHOENIX_HOST`           | Phoenix API endpoint (e.g., `http://localhost:6006`) |
-| `PHOENIX_PROJECT`        | Project name or ID                                   |
-| `PHOENIX_API_KEY`        | API key for authentication (if required)             |
-| `PHOENIX_CLIENT_HEADERS` | Custom headers as JSON string                        |
+CLI flags (`--endpoint`, `--project`, `--api-key`) override environment variables.
 
-CLI flags take priority over environment variables.
+| Variable                 | Description                   |
+| ------------------------ | ----------------------------- |
+| `PHOENIX_HOST`           | Phoenix API endpoint          |
+| `PHOENIX_PROJECT`        | Project name or ID            |
+| `PHOENIX_API_KEY`        | API key (if auth is enabled)  |
+| `PHOENIX_CLIENT_HEADERS` | Custom headers as JSON string |
 
 ## Commands
 
-### `px projects`
+### `px traces [directory]`
 
-List all available projects.
+Fetch recent traces from the configured project. All output is JSON.
 
 ```bash
-px projects
-px projects --format raw  # JSON output for piping
+px traces --limit 10                          # stdout (pretty)
+px traces --format raw --no-progress | jq    # pipe-friendly compact JSON
+px traces ./my-traces --limit 50             # save as JSON files to directory
+px traces --last-n-minutes 60 --limit 20     # filter by time window
+px traces --since 2026-01-13T10:00:00Z       # since ISO timestamp
 ```
 
-### `px traces [directory]`
-
-Fetch recent traces from the configured project.
+| Option                      | Description                            | Default  |
+| --------------------------- | -------------------------------------- | -------- |
+| `[directory]`               | Save traces as JSON files to directory | stdout   |
+| `-n, --limit <number>`      | Number of traces (newest first)        | 10       |
+| `--last-n-minutes <number>` | Only traces from the last N minutes    | —        |
+| `--since <timestamp>`       | Traces since ISO timestamp             | —        |
+| `--format <format>`         | `pretty`, `json`, or `raw`             | `pretty` |
+| `--no-progress`             | Suppress progress output               | —        |
+| `--include-annotations`     | Include span annotations               | —        |
 
 ```bash
-px traces --limit 10                          # Output to stdout
-px traces ./my-traces --limit 10              # Save to directory
-px traces --last-n-minutes 60 --limit 20      # Filter by time
-px traces --since 2026-01-13T10:00:00Z        # Since timestamp
-px traces --format raw --no-progress | jq     # Pipe to jq
+# Find ERROR traces
+px traces --limit 50 --format raw --no-progress | jq '.[] | select(.status == "ERROR")'
+
+# Sort by duration, take top 5 slowest
+px traces --limit 20 --format raw --no-progress | jq 'sort_by(-.duration) | .[0:5]'
+
+# Extract LLM model names used
+px traces --limit 50 --format raw --no-progress | \
+  jq -r '.[].spans[] | select(.span_kind == "LLM") | .attributes["llm.model_name"]' | sort -u
 ```
 
-| Option                      | Description                               | Default  |
-| --------------------------- | ----------------------------------------- | -------- |
-| `[directory]`               | Save traces as JSON files to directory    | stdout   |
-| `-n, --limit <number>`      | Number of traces to fetch (newest first)  | 10       |
-| `--last-n-minutes <number>` | Only fetch traces from the last N minutes | —        |
-| `--since <timestamp>`       | Fetch traces since ISO timestamp          | —        |
-| `--format <format>`         | `pretty`, `json`, or `raw`                | `pretty` |
-| `--no-progress`             | Disable progress output                   | —        |
-| `--include-annotations`     | Include span annotations in trace export  | —        |
+---
 
 ### `px trace <trace-id>`
 
-Fetch a specific trace by ID.
+Fetch a single trace by ID.
 
 ```bash
 px trace abc123def456
-px trace abc123def456 --file trace.json      # Save to file
-px trace abc123def456 --format raw | jq      # Pipe to jq
+px trace abc123def456 --format raw | jq '.spans[] | select(.status_code != "OK")'
+px trace abc123def456 --file trace.json
 ```
 
-| Option                  | Description                              | Default  |
-| ----------------------- | ---------------------------------------- | -------- |
-| `--file <path>`         | Save to file instead of stdout           | stdout   |
-| `--format <format>`     | `pretty`, `json`, or `raw`               | `pretty` |
-| `--include-annotations` | Include span annotations in trace export | —        |
+---
 
 ### `px datasets`
 
-List all available datasets.
+List all datasets.
 
 ```bash
-px datasets
-px datasets --format json                    # JSON output
-px datasets --format raw --no-progress | jq  # Pipe to jq
+px datasets --format raw --no-progress | jq '.[].name'
 ```
 
-| Option              | Description                | Default  |
-| ------------------- | -------------------------- | -------- |
-| `--format <format>` | `pretty`, `json`, or `raw` | `pretty` |
-| `--limit <number>`  | Maximum number of datasets | —        |
+---
 
 ### `px dataset <dataset-identifier>`
 
 Fetch examples from a dataset.
 
 ```bash
-px dataset query_response                        # Fetch all examples
-px dataset query_response --split train          # Filter by split
-px dataset query_response --split train --split test  # Multiple splits
-px dataset query_response --version <version-id> # Specific version
-px dataset query_response --file dataset.json    # Save to file
-px dataset query_response --format raw | jq '.examples[].input'
+px dataset my-dataset --format raw | jq '.examples[].input'
+px dataset my-dataset --split train --split test
+px dataset my-dataset --version <version-id>
+px dataset my-dataset --file dataset.json
 ```
 
-| Option           | Description                              | Default  |
-| ---------------- | ---------------------------------------- | -------- |
-| `--split <name>` | Filter by split (can be used repeatedly) | —        |
-| `--version <id>` | Fetch from specific dataset version      | latest   |
-| `--file <path>`  | Save to file instead of stdout           | stdout   |
-| `--format <fmt>` | `pretty`, `json`, or `raw`               | `pretty` |
+---
 
 ### `px experiments --dataset <name-or-id>`
 
-List experiments for a dataset, optionally exporting full data to files.
+List experiments for a dataset.
 
 ```bash
-px experiments --dataset my-dataset                 # List experiments
-px experiments --dataset my-dataset --format json   # JSON output
-px experiments --dataset my-dataset ./experiments   # Export to directory
+px experiments --dataset my-dataset --format raw --no-progress | \
+  jq '.[] | {id, successful_run_count, failed_run_count}'
 ```
 
-| Option                   | Description                               | Default  |
-| ------------------------ | ----------------------------------------- | -------- |
-| `--dataset <name-or-id>` | Dataset name or ID (required)             | —        |
-| `[directory]`            | Export experiment JSON files to directory | stdout   |
-| `--format <format>`      | `pretty`, `json`, or `raw`                | `pretty` |
-| `--limit <number>`       | Maximum number of experiments             | —        |
+---
 
 ### `px experiment <experiment-id>`
 
-Fetch a single experiment with all run data.
+Fetch a single experiment with all run data (inputs, outputs, evaluations, trace IDs).
 
 ```bash
-px experiment RXhwZXJpbWVudDox
-px experiment RXhwZXJpbWVudDox --file exp.json   # Save to file
-px experiment RXhwZXJpbWVudDox --format json     # JSON output
+# Find failed runs
+px experiment RXhwZXJpbWVudDox --format raw --no-progress | \
+  jq '.[] | select(.error != null) | {input, error}'
+
+# Average latency
+px experiment RXhwZXJpbWVudDox --format raw --no-progress | \
+  jq '[.[].latency_ms] | add / length'
 ```
 
-| Option              | Description                    | Default  |
-| ------------------- | ------------------------------ | -------- |
-| `--file <path>`     | Save to file instead of stdout | stdout   |
-| `--format <format>` | `pretty`, `json`, or `raw`     | `pretty` |
+---
 
-## Output Formats
+### `px prompts`
 
-**`pretty`** (default) — Human-readable tree view:
+List all prompts.
 
-```
-┌─ Trace: abc123def456
-│
-│  Input: What is the weather in San Francisco?
-│  Output: The weather is currently sunny...
-│
-│  Spans:
-│  └─ ✓ agent_run (CHAIN) - 1250ms
-│     ├─ ✓ llm_call (LLM) - 800ms
-│     └─ ✓ tool_execution (TOOL) - 400ms
-└─
+```bash
+px prompts --format raw --no-progress | jq '.[].name'
 ```
 
-**`json`** — Formatted JSON with indentation.
+---
 
-**`raw`** — Compact JSON for piping to `jq` or other tools.
+### `px prompt <prompt-identifier>`
 
-## JSON Structure
+Fetch a prompt. The `text` format is ideal for piping to AI assistants.
 
-```json
-{
-  "traceId": "abc123def456",
-  "spans": [
-    {
-      "name": "chat_completion",
-      "context": {
-        "trace_id": "abc123def456",
-        "span_id": "span-1"
-      },
-      "span_kind": "LLM",
-      "parent_id": null,
-      "start_time": "2026-01-17T10:00:00.000Z",
-      "end_time": "2026-01-17T10:00:01.250Z",
-      "status_code": "OK",
-      "attributes": {
-        "llm.model_name": "gpt-4",
-        "llm.token_count.prompt": 512,
-        "llm.token_count.completion": 256,
-        "input.value": "What is the weather?",
-        "output.value": "The weather is sunny..."
-      }
-    }
-  ],
-  "rootSpan": { ... },
-  "startTime": "2026-01-17T10:00:00.000Z",
-  "endTime": "2026-01-17T10:00:01.250Z",
-  "duration": 1250,
-  "status": "OK"
-}
+```bash
+px prompt my-evaluator --format text --no-progress | claude -p "Review this prompt"
+px prompt my-evaluator --tag production --format json | jq '.template'
 ```
 
-Spans include [OpenInference](https://github.com/Arize-ai/openinference) semantic attributes like `llm.model_name`, `llm.token_count.*`, `input.value`, `output.value`, `tool.name`, and `exception.*`.
+| Option              | Description                        | Default  |
+| ------------------- | ---------------------------------- | -------- |
+| `--tag <name>`      | Get version by tag                 | —        |
+| `--version <id>`    | Get specific version               | latest   |
+| `--format <format>` | `pretty`, `json`, `raw`, or `text` | `pretty` |
 
-## Examples
+---
+
+### `px api graphql <query>`
 
-### Debug failed traces
+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.
 
 ```bash
-px traces --limit 20 --format raw --no-progress | jq '.[] | select(.status == "ERROR")'
+px api graphql '<query>' [--endpoint <url>] [--api-key <key>]
 ```
 
-### Find slowest traces
+Use introspection to discover what fields are available:
 
 ```bash
-px traces --limit 10 --format raw --no-progress | jq 'sort_by(-.duration) | .[0:3]'
+$ px api graphql '{ __schema { queryType { fields { name } } } }' | jq '.data.__schema.queryType.fields[].name'
+"projects"
+"datasets"
+"prompts"
+"evaluators"
+"projectCount"
+"datasetCount"
+...
+
+$ px api graphql '{ __type(name: "Experiment") { fields { name type { name } } } }' | \
+    jq '.data.__type.fields[] | {name, type: .type.name}'
+{"name":"id","type":"ID"}
+{"name":"name","type":"String"}
+{"name":"runCount","type":"Int"}
+{"name":"errorRate","type":"Float"}
+{"name":"averageRunLatencyMs","type":"Float"}
 ```
 
-### Extract LLM models used
+**Projects:**
 
 ```bash
-px traces --limit 50 --format raw --no-progress | \
-  jq -r '.[].spans[] | select(.span_kind == "LLM") | .attributes["llm.model_name"]' | sort -u
+$ px api graphql '{ projects { edges { node { name traceCount tokenCountTotal } } } }' | \
+    jq '.data.projects.edges[].node'
+{"name": "default", "traceCount": 1482, "tokenCountTotal": 219083}
 ```
 
-### Count errors
+**Datasets:**
 
 ```bash
-px traces --limit 100 --format raw --no-progress | jq '[.[] | select(.status == "ERROR")] | length'
+$ px api graphql '{ datasets { edges { node { name exampleCount experimentCount } } } }' | \
+    jq '.data.datasets.edges[].node'
+{"name": "eval-golden-set", "exampleCount": 120, "experimentCount": 4}
+{"name": "rag-test-cases", "exampleCount": 50, "experimentCount": 1}
 ```
 
-### List datasets and experiments
+**Experiments:**
 
 ```bash
-# List all datasets
-px datasets --format raw --no-progress | jq '.[].name'
-# Output: "query_response"
+# List experiments per dataset with error rate and avg latency
+$ px api graphql '{
+  datasets {
+    edges {
+      node {
+        name
+        experiments {
+          edges {
+            node { name runCount errorRate averageRunLatencyMs }
+          }
+        }
+      }
+    }
+  }
+}' | jq '.data.datasets.edges[].node | {dataset: .name, experiments: [.experiments.edges[].node]}'
 
-# List experiments for a dataset
-px experiments --dataset query_response --format raw --no-progress | \
-  jq '.[] | {id, successful_run_count, failed_run_count}'
-# Output: {"id":"RXhwZXJpbWVudDox","successful_run_count":249,"failed_run_count":1}
+# Find experiments with failures
+$ px api graphql '{
+  datasets { edges { node { name experiments { edges { node { name errorRate runCount } } } } } }
+}' | jq '.. | objects | select(.errorRate? > 0) | {name, errorRate, runCount}'
+```
+
+**Counts at a glance:**
 
-# Export all experiment data for a dataset to a directory
-px experiments --dataset query_response ./experiments/
+```bash
+$ px api graphql '{ projectCount datasetCount promptCount evaluatorCount }'
+{"data": {"projectCount": 1, "datasetCount": 12, "promptCount": 3, "evaluatorCount": 2}}
 ```
 
-### Analyze experiment results
+---
+
+## JSON output shape
+
+All commands output JSON. Use `--format raw` for compact JSON and `--no-progress` to suppress stderr when piping:
 
 ```bash
-# Get input queries and latency from an experiment
-px experiment RXhwZXJpbWVudDox --format raw --no-progress | \
-  jq '.[] | {query: .input.query, latency_ms, trace_id}'
+px traces --format raw --no-progress | jq ...
+px datasets --format raw --no-progress | jq ...
+```
 
-# Find failed runs in an experiment
-px experiment RXhwZXJpbWVudDox --format raw --no-progress | \
-  jq '.[] | select(.error != null) | {query: .input.query, error}'
-# Output: {"query":"looking for complex fodmap meal ideas","error":"peer closed connection..."}
+Trace JSON structure:
 
-# Calculate average latency across runs
-px experiment RXhwZXJpbWVudDox --format raw --no-progress | \
-  jq '[.[].latency_ms] | add / length'
+```json
+{
+  "traceId": "abc123def456",
+  "status": "OK",
+  "duration": 1250,
+  "spans": [
+    {
+      "name": "chat_completion",
+      "span_kind": "LLM",
+      "status_code": "OK",
+      "attributes": {
+        "llm.model_name": "gpt-4",
+        "llm.token_count.prompt": 512,
+        "llm.token_count.completion": 256,
+        "input.value": "What is the weather?",
+        "output.value": "The weather is sunny..."
+      }
+    }
+  ]
+}
 ```
 
+`px api graphql` output always wraps results in `{"data": {...}}`. Pipe with `jq '.data.<field>'` to extract.
+
 ---
 
 ## Community
 
-- 🌍 [Slack community](https://arize-ai.slack.com/join/shared_invite/zt-11t1vbu4x-xkBIHmOREQnYnYDH1GDfCg)
+- 🌍 [Slack community](https://join.slack.com/t/arize-ai/shared_invite/zt-3r07iavnk-ammtATWSlF0pSrd1DsMW7g)
 - 📚 [Documentation](https://arize.com/docs/phoenix)
 - 🌟 [GitHub](https://github.com/Arize-ai/phoenix)
 - 🐞 [Report bugs](https://github.com/Arize-ai/phoenix/issues)

package/build/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAkBA,wBAAgB,IAAI,SA0BnB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAqBA,wBAAgB,IAAI,SA6BnB"}

package/build/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { createAuthCommand, createDatasetCommand, createDatasetsCommand, createExperimentCommand, createExperimentsCommand, createProjectsCommand, createPromptCommand, createPromptsCommand, createTraceCommand, createTracesCommand, } from "./commands/index.js";
 import { Command } from "commander";
+import { createApiCommand, createAuthCommand, createDatasetCommand, createDatasetsCommand, createExperimentCommand, createExperimentsCommand, createProjectsCommand, createPromptCommand, createPromptsCommand, createSessionCommand, createSessionsCommand, createTraceCommand, createTracesCommand, } from "./commands/index.js";
 // Phoenix CLI Main Logic
 export function main() {
     const program = new Command();
@@ -15,10 +15,13 @@ export function main() {
     program.addCommand(createTraceCommand());
     program.addCommand(createDatasetsCommand());
     program.addCommand(createDatasetCommand());
+    program.addCommand(createSessionsCommand());
+    program.addCommand(createSessionCommand());
     program.addCommand(createExperimentsCommand());
     program.addCommand(createExperimentCommand());
     program.addCommand(createPromptsCommand());
     program.addCommand(createPromptCommand());
+    program.addCommand(createApiCommand());
     // Show help if no command provided
     if (process.argv.length === 2) {
         program.help();

package/build/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,yBAAyB;AACzB,MAAM,UAAU,IAAI;IAClB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,IAAI,CAAC;SACV,WAAW,CAAC,sDAAsD,CAAC;SACnE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,oBAAoB;IACpB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAE1C,mCAAmC;IACnC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,yBAAyB;AACzB,MAAM,UAAU,IAAI;IAClB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,IAAI,CAAC;SACV,WAAW,CAAC,sDAAsD,CAAC;SACnE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,oBAAoB;IACpB,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEvC,mCAAmC;IACnC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,EAAE,CAAC;IACjB,CAAC;IAED,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/build/commands/api.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "commander";
+/**
+ * Returns true if the query string is a GraphQL mutation or subscription.
+ * Strips # comments first to avoid false positives.
+ */
+export declare function isNonQuery({ query }: {
+    query: string;
+}): boolean;
+export declare function createApiCommand(): Command;
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/commands/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAGhE;AA+GD,wBAAgB,gBAAgB,IAAI,OAAO,CAK1C"}

package/build/commands/api.js

@@ -0,0 +1,103 @@
+import { Command } from "commander";
+import { getConfigErrorMessage, resolveConfig } from "../config.js";
+import { writeError, writeOutput } from "../io.js";
+/**
+ * Returns true if the query string is a GraphQL mutation or subscription.
+ * Strips # comments first to avoid false positives.
+ */
+export function isNonQuery({ query }) {
+    const stripped = query.replace(/#[^\n]*/g, "");
+    return /^\s*(mutation|subscription)[\s({]/m.test(stripped);
+}
+async function apiGraphqlHandler(query, options) {
+    try {
+        // 1. Reject mutations and subscriptions
+        if (isNonQuery({ query })) {
+            writeError({
+                message: "Error: Only queries are permitted. Mutations and subscriptions are not allowed.",
+            });
+            process.exit(1);
+        }
+        // 2. Resolve config (endpoint only — no project required)
+        const config = resolveConfig({
+            cliOptions: { endpoint: options.endpoint, apiKey: options.apiKey },
+        });
+        if (!config.endpoint) {
+            writeError({
+                message: getConfigErrorMessage({
+                    errors: [
+                        "Phoenix endpoint not configured. Set PHOENIX_HOST environment variable or use --endpoint flag.",
+                    ],
+                }),
+            });
+            process.exit(1);
+        }
+        // 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}`;
+        }
+        // 4. POST using Node 22 built-in fetch
+        const response = await fetch(graphqlUrl, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({ query }),
+        });
+        if (!response.ok) {
+            writeError({
+                message: `Error: HTTP ${response.status} ${response.statusText} from ${graphqlUrl}`,
+            });
+            process.exit(1);
+        }
+        // 5. Parse and output response
+        const json = (await response.json());
+        if (json.errors && json.errors.length > 0) {
+            const msgs = json.errors.map((e) => `  • ${e.message}`).join("\n");
+            writeError({ message: `GraphQL Errors:\n${msgs}` });
+        }
+        // Always write full response to stdout (2-space indent, pipeable)
+        writeOutput({ message: JSON.stringify(json, null, 2) });
+        if (json.errors && json.errors.length > 0 && json.data == null) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        writeError({
+            message: `Error: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        process.exit(1);
+    }
+}
+function createApiGraphqlCommand() {
+    return new Command("graphql")
+        .description("Execute a GraphQL query against the Phoenix API.\n" +
+        "\n" +
+        "  Only queries are permitted — mutations are rejected.\n" +
+        "\n" +
+        "  Examples:\n" +
+        "\n" +
+        "    # List project names\n" +
+        "    px api graphql '{ projects { edges { node { name } } } }'\n" +
+        "\n" +
+        "    # Filter inline\n" +
+        "    px api graphql '{ datasets(first: 5) { edges { node { name } } } }'\n" +
+        "\n" +
+        "    # Pipe to jq to extract fields\n" +
+        "    px api graphql '{ projects { edges { node { name } } } }' | \\\n" +
+        "      jq '.data.projects.edges[].node.name'")
+        .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)")
+        .action(apiGraphqlHandler);
+}
+export function createApiCommand() {
+    const command = new Command("api");
+    command.description("Make authenticated requests to the Phoenix API");
+    command.addCommand(createApiGraphqlCommand());
+    return command;
+}
+//# sourceMappingURL=api.js.map

package/build/commands/api.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKpD;AAqDD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAS3C"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKpD;AAqDD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAS3C"}

package/build/commands/auth.js

@@ -1,6 +1,6 @@
+import { Command } from "commander";
 import { resolveConfig } from "../config.js";
 import { writeError, writeOutput } from "../io.js";
-import { Command } from "commander";
 /**
  * Obscure an API key for display using asterisks.
  * Shows a fixed number of asterisks regardless of key length for security.

package/build/commands/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,sCAAsC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,OAA0B;IACzD,wBAAwB;IACxB,MAAM,MAAM,GAAG,aAAa,CAAC;QAC3B,UAAU,EAAE;YACV,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB;KACF,CAAC,CAAC;IAEH,kCAAkC;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,UAAU,CAAC;YACT,OAAO,EAAE,2DAA2D;SACrE,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,mBAAmB;IACnB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE5B,yBAAyB;IACzB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,gBAAgB,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC7D,CAAC;IAED,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB;IAC9B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEtC,OAAO;SACJ,WAAW,CAAC,4CAA4C,CAAC;SACzD,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;SAClD,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;SAC/D,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAE7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpC,OAAO,CAAC,WAAW,CAAC,+BAA+B,CAAC,CAAC;IAErD,kBAAkB;IAClB,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAE9C,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/commands/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAOhD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,sCAAsC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAAC,OAA0B;IACzD,wBAAwB;IACxB,MAAM,MAAM,GAAG,aAAa,CAAC;QAC3B,UAAU,EAAE;YACV,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB;KACF,CAAC,CAAC;IAEH,kCAAkC;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,UAAU,CAAC;YACT,OAAO,EAAE,2DAA2D;SACrE,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,mBAAmB;IACnB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAE5B,yBAAyB;IACzB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,gBAAgB,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC7D,CAAC;IAED,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAS,uBAAuB;IAC9B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEtC,OAAO;SACJ,WAAW,CAAC,4CAA4C,CAAC;SACzD,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;SAClD,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;SAC/D,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAE7B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEpC,OAAO,CAAC,WAAW,CAAC,+BAA+B,CAAC,CAAC;IAErD,kBAAkB;IAClB,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAC,CAAC;IAE9C,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"dataset.d.ts","sourceRoot":"","sources":["../../src/commands/dataset.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6KpC;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAyB9C"}
+{"version":3,"file":"dataset.d.ts","sourceRoot":"","sources":["../../src/commands/dataset.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqLpC;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAyB9C"}