@arizeai/phoenix-cli 0.1.0 → 0.3.0

package/README.md

@@ -22,7 +22,7 @@
     <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 retrieving trace data from [Arize Phoenix](https://github.com/Arize-ai/phoenix). Fetch, debug, and export traces 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, 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.
 
 ## Installation
 
@@ -96,6 +96,7 @@ px traces --format raw --no-progress | jq     # Pipe to jq
 | `--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>`
 
@@ -107,6 +108,74 @@ px trace abc123def456 --file trace.json      # Save to file
 px trace abc123def456 --format raw | jq      # Pipe to jq
 ```
 
+| 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.
+
+```bash
+px datasets
+px datasets --format json                    # JSON output
+px datasets --format raw --no-progress | jq  # Pipe to jq
+```
+
+| 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'
+```
+
+| 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.
+
+```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
+```
+
+| 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.
+
+```bash
+px experiment RXhwZXJpbWVudDox
+px experiment RXhwZXJpbWVudDox --file exp.json   # Save to file
+px experiment RXhwZXJpbWVudDox --format json     # JSON output
+```
+
 | Option              | Description                    | Default  |
 | ------------------- | ------------------------------ | -------- |
 | `--file <path>`     | Save to file instead of stdout | stdout   |
@@ -196,6 +265,39 @@ px traces --limit 50 --format raw --no-progress | \
 px traces --limit 100 --format raw --no-progress | jq '[.[] | select(.status == "ERROR")] | length'
 ```
 
+### List datasets and experiments
+
+```bash
+# List all datasets
+px datasets --format raw --no-progress | jq '.[].name'
+# Output: "query_response"
+
+# 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}
+
+# Export all experiment data for a dataset to a directory
+px experiments --dataset query_response ./experiments/
+```
+
+### Analyze experiment results
+
+```bash
+# Get input queries and latency from an experiment
+px experiment RXhwZXJpbWVudDox --format raw --no-progress | \
+  jq '.[] | {query: .input.query, latency_ms, trace_id}'
+
+# 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..."}
+
+# Calculate average latency across runs
+px experiment RXhwZXJpbWVudDox --format raw --no-progress | \
+  jq '[.[].latency_ms] | add / length'
+```
+
 ---
 
 ## Community

package/build/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAWA,wBAAgB,IAAI,SAmBnB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAeA,wBAAgB,IAAI,SAuBnB"}

package/build/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { createProjectsCommand, createTraceCommand, createTracesCommand, } from "./commands/index.js";
+import { createDatasetCommand, createDatasetsCommand, createExperimentCommand, createExperimentsCommand, createProjectsCommand, createTraceCommand, createTracesCommand, } from "./commands/index.js";
 import { Command } from "commander";
 // Phoenix CLI Main Logic
 export function main() {
@@ -12,6 +12,10 @@ export function main() {
     program.addCommand(createProjectsCommand());
     program.addCommand(createTracesCommand());
     program.addCommand(createTraceCommand());
+    program.addCommand(createDatasetsCommand());
+    program.addCommand(createDatasetCommand());
+    program.addCommand(createExperimentsCommand());
+    program.addCommand(createExperimentCommand());
     // 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,qBAAqB,EACrB,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,qBAAqB,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAEzC,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,EACL,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,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,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;IAE9C,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/client.d.ts

@@ -28,4 +28,22 @@ export interface ResolveProjectIdOptions {
  * If the identifier looks like a Phoenix project ID (hex string), returns it as-is; otherwise fetches by name.
  */
 export declare function resolveProjectId({ client, projectIdentifier, }: ResolveProjectIdOptions): Promise<string>;
+export interface ResolveDatasetIdOptions {
+    /**
+     * Phoenix API client.
+     */
+    client: PhoenixClient;
+    /**
+     * Dataset identifier to resolve.
+     *
+     * Phoenix dataset IDs are hex-encoded strings. If `datasetIdentifier` looks like a hex string,
+     * it's treated as an ID; otherwise it's treated as a name and resolved via the API.
+     */
+    datasetIdentifier: string;
+}
+/**
+ * Resolve dataset identifier to dataset ID
+ * If the identifier looks like a Phoenix dataset ID (hex string), returns it as-is; otherwise fetches by name.
+ */
+export declare function resolveDatasetId({ client, datasetIdentifier, }: ResolveDatasetIdOptions): Promise<string>;
 //# sourceMappingURL=client.d.ts.map

package/build/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,GACP,EAAE,0BAA0B,GAAG,aAAa,CAqB5C;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAWD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,MAAM,EACN,iBAAiB,GAClB,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B3C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,MAAM,GACP,EAAE,0BAA0B,GAAG,aAAa,CAqB5C;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAWD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,MAAM,EACN,iBAAiB,GAClB,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B3C;AAED,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;IACtB;;;;;OAKG;IACH,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAWD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,EACrC,MAAM,EACN,iBAAiB,GAClB,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiC3C"}

package/build/client.js

@@ -54,4 +54,43 @@ export async function resolveProjectId({ client, projectIdentifier, }) {
         throw new Error(`Failed to resolve project "${projectIdentifier}": ${error instanceof Error ? error.message : String(error)}`);
     }
 }
+function looksLikePhoenixDatasetId(datasetIdentifier) {
+    // Dataset IDs are hex-encoded strings (e.g., "a1b2c3d4e5f6...")
+    const trimmed = datasetIdentifier.trim();
+    if (!trimmed)
+        return false;
+    // Check if the string is a valid hex string (only 0-9, a-f, A-F)
+    return /^[0-9a-fA-F]+$/.test(trimmed);
+}
+/**
+ * Resolve dataset identifier to dataset ID
+ * If the identifier looks like a Phoenix dataset ID (hex string), returns it as-is; otherwise fetches by name.
+ */
+export async function resolveDatasetId({ client, datasetIdentifier, }) {
+    if (looksLikePhoenixDatasetId(datasetIdentifier)) {
+        return datasetIdentifier;
+    }
+    // Otherwise, fetch the dataset by name to get its ID
+    try {
+        const response = await client.GET("/v1/datasets", {
+            params: {
+                query: {
+                    name: datasetIdentifier,
+                    limit: 1,
+                },
+            },
+        });
+        if (response.error || !response.data) {
+            throw new Error(`Failed to resolve dataset "${datasetIdentifier}": ${response.error}`);
+        }
+        const datasets = response.data.data;
+        if (datasets.length === 0) {
+            throw new Error(`Dataset not found: "${datasetIdentifier}"`);
+        }
+        return datasets[0].id;
+    }
+    catch (error) {
+        throw new Error(`Failed to resolve dataset "${datasetIdentifier}": ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
 //# sourceMappingURL=client.js.map

package/build/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsB,MAAM,yBAAyB,CAAC;AAW3E;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAClC,MAAM,GACqB;IAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC;IAEhC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;KAC1B,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,MAAM,CAAC,MAAM,EAAE,CAAC;IACvD,CAAC;IAED,OAAO,YAAY,CAAC;QAClB,OAAO,EAAE;YACP,OAAO;YACP,OAAO;SACR;KACF,CAAC,CAAC;AACL,CAAC;AAgBD,SAAS,yBAAyB,CAAC,iBAAyB;IAC1D,gEAAgE;IAChE,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,iEAAiE;IACjE,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EACrC,MAAM,EACN,iBAAiB,GACO;IACxB,IAAI,yBAAyB,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACjD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,qDAAqD;IACrD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,mCAAmC,EAAE;YACrE,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,kBAAkB,EAAE,iBAAiB;iBACtC;aACF;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CACb,8BAA8B,iBAAiB,MAAM,QAAQ,CAAC,KAAK,EAAE,CACtE,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,8BAA8B,iBAAiB,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC9G,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/build/commands/dataset.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "commander";
+/**
+ * Create the dataset command
+ */
+export declare function createDatasetCommand(): Command;
+//# sourceMappingURL=dataset.d.ts.map

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

@@ -0,0 +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"}

package/build/commands/dataset.js

@@ -0,0 +1,153 @@
+import { createPhoenixClient, resolveDatasetId } from "../client.js";
+import { getConfigErrorMessage, resolveConfig } from "../config.js";
+import { writeError, writeOutput, writeProgress } from "../io.js";
+import { formatDatasetExamplesOutput, } from "./formatDataset.js";
+import { Command } from "commander";
+import * as fs from "fs";
+/**
+ * Fetch dataset examples from Phoenix
+ */
+async function fetchDatasetExamples(client, datasetId, options = {}) {
+    const response = await client.GET("/v1/datasets/{id}/examples", {
+        params: {
+            path: {
+                id: datasetId,
+            },
+            query: {
+                version_id: options.versionId,
+                split: options.splits,
+            },
+        },
+    });
+    if (response.error || !response.data) {
+        throw new Error(`Failed to fetch dataset examples: ${response.error}`);
+    }
+    return response.data.data;
+}
+/**
+ * Fetch dataset metadata for display name
+ */
+async function fetchDatasetName(client, datasetId) {
+    try {
+        const response = await client.GET("/v1/datasets/{id}", {
+            params: {
+                path: {
+                    id: datasetId,
+                },
+            },
+        });
+        if (response.error || !response.data) {
+            return undefined;
+        }
+        return response.data.data.name;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Dataset command handler
+ */
+async function datasetHandler(datasetIdentifier, options) {
+    try {
+        const userSpecifiedFormat = process.argv.includes("--format") ||
+            process.argv.some((arg) => arg.startsWith("--format="));
+        // Resolve configuration
+        const config = resolveConfig({
+            cliOptions: {
+                endpoint: options.endpoint,
+                apiKey: options.apiKey,
+            },
+        });
+        // Validate that we have endpoint
+        if (!config.endpoint) {
+            const errors = [
+                "Phoenix endpoint not configured. Set PHOENIX_HOST environment variable or use --endpoint flag.",
+            ];
+            writeError({ message: getConfigErrorMessage({ errors }) });
+            process.exit(1);
+        }
+        // Create client
+        const client = createPhoenixClient({ config });
+        writeProgress({
+            message: `Resolving dataset: ${datasetIdentifier}`,
+            noProgress: !options.progress,
+        });
+        // Resolve dataset ID
+        const datasetId = await resolveDatasetId({
+            client,
+            datasetIdentifier,
+        });
+        // Fetch dataset name for display
+        const datasetName = await fetchDatasetName(client, datasetId);
+        writeProgress({
+            message: `Fetching examples from dataset ${datasetName || datasetId}...`,
+            noProgress: !options.progress,
+        });
+        // Fetch dataset examples
+        const data = await fetchDatasetExamples(client, datasetId, {
+            versionId: options.version,
+            splits: options.split,
+        });
+        writeProgress({
+            message: `Found ${data.examples.length} example(s)`,
+            noProgress: !options.progress,
+        });
+        // Determine output format
+        const outputFormat = options.file
+            ? "json"
+            : options.format || "pretty";
+        if (options.file && userSpecifiedFormat && options.format !== "json") {
+            writeError({
+                message: `Warning: --format is ignored when writing to a file; writing JSON to ${options.file}`,
+            });
+        }
+        // Format output
+        const output = formatDatasetExamplesOutput({
+            data,
+            datasetName,
+            format: outputFormat,
+        });
+        if (options.file) {
+            fs.writeFileSync(options.file, output, "utf-8");
+            writeProgress({
+                message: `Wrote dataset to ${options.file}`,
+                noProgress: !options.progress,
+            });
+        }
+        else {
+            writeOutput({ message: output });
+        }
+    }
+    catch (error) {
+        writeError({
+            message: `Error fetching dataset: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        process.exit(1);
+    }
+}
+/**
+ * Collect multiple --split options into an array
+ */
+function collectSplits(value, previous) {
+    return previous.concat([value]);
+}
+/**
+ * Create the dataset command
+ */
+export function createDatasetCommand() {
+    const command = new Command("dataset");
+    command
+        .description("Fetch examples from a dataset")
+        .argument("<dataset-identifier>", "Dataset name or ID")
+        .option("--endpoint <url>", "Phoenix API endpoint")
+        .option("--api-key <key>", "Phoenix API key for authentication")
+        .option("--format <format>", "Output format: pretty, json, or raw", "pretty")
+        .option("--no-progress", "Disable progress indicators")
+        .option("--file <path>", "Save output to file instead of stdout")
+        .option("--split <name>", "Filter by split name (can be used multiple times)", collectSplits, [])
+        .option("--version <id>", "Fetch from a specific dataset version")
+        .action(datasetHandler);
+    return command;
+}
+//# sourceMappingURL=dataset.js.map

package/build/commands/dataset.js.map

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

package/build/commands/datasets.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "commander";
+/**
+ * Create the datasets command
+ */
+export declare function createDatasetsCommand(): Command;
+//# sourceMappingURL=datasets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"datasets.d.ts","sourceRoot":"","sources":["../../src/commands/datasets.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuGpC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAiB/C"}

package/build/commands/datasets.js

@@ -0,0 +1,97 @@
+import { createPhoenixClient } from "../client.js";
+import { getConfigErrorMessage, resolveConfig } from "../config.js";
+import { writeError, writeOutput, writeProgress } from "../io.js";
+import { formatDatasetsOutput } from "./formatDatasets.js";
+import { Command } from "commander";
+/**
+ * Fetch all datasets from Phoenix
+ */
+async function fetchDatasets(client, options = {}) {
+    const allDatasets = [];
+    let cursor;
+    const pageLimit = options.limit || 100;
+    do {
+        const response = await client.GET("/v1/datasets", {
+            params: {
+                query: {
+                    cursor,
+                    limit: pageLimit,
+                },
+            },
+        });
+        if (response.error || !response.data) {
+            throw new Error(`Failed to fetch datasets: ${response.error}`);
+        }
+        allDatasets.push(...response.data.data);
+        cursor = response.data.next_cursor || undefined;
+        // If we've fetched enough for the requested limit, stop
+        if (options.limit && allDatasets.length >= options.limit) {
+            break;
+        }
+    } while (cursor);
+    return allDatasets;
+}
+/**
+ * Datasets command handler
+ */
+async function datasetsHandler(options) {
+    try {
+        // Resolve configuration
+        const config = resolveConfig({
+            cliOptions: {
+                endpoint: options.endpoint,
+                apiKey: options.apiKey,
+            },
+        });
+        // Validate that we have endpoint
+        if (!config.endpoint) {
+            const errors = [
+                "Phoenix endpoint not configured. Set PHOENIX_HOST environment variable or use --endpoint flag.",
+            ];
+            writeError({ message: getConfigErrorMessage({ errors }) });
+            process.exit(1);
+        }
+        // Create client
+        const client = createPhoenixClient({ config });
+        writeProgress({
+            message: "Fetching datasets...",
+            noProgress: !options.progress,
+        });
+        // Fetch datasets
+        const datasets = await fetchDatasets(client, {
+            limit: options.limit,
+        });
+        writeProgress({
+            message: `Found ${datasets.length} dataset(s)`,
+            noProgress: !options.progress,
+        });
+        // Output datasets
+        const output = formatDatasetsOutput({
+            datasets,
+            format: options.format,
+        });
+        writeOutput({ message: output });
+    }
+    catch (error) {
+        writeError({
+            message: `Error fetching datasets: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        process.exit(1);
+    }
+}
+/**
+ * Create the datasets command
+ */
+export function createDatasetsCommand() {
+    const command = new Command("datasets");
+    command
+        .description("List all available Phoenix datasets")
+        .option("--endpoint <url>", "Phoenix API endpoint")
+        .option("--api-key <key>", "Phoenix API key for authentication")
+        .option("--format <format>", "Output format: pretty, json, or raw", "pretty")
+        .option("--no-progress", "Disable progress indicators")
+        .option("--limit <number>", "Maximum number of datasets to fetch", parseInt)
+        .action(datasetsHandler);
+    return command;
+}
+//# sourceMappingURL=datasets.js.map

package/build/commands/datasets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasets.js","sourceRoot":"","sources":["../../src/commands/datasets.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,EAAE,oBAAoB,EAAqB,MAAM,kBAAkB,CAAC;AAE3E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC;;GAEG;AACH,KAAK,UAAU,aAAa,CAC1B,MAAqB,EACrB,UAA8B,EAAE;IAEhC,MAAM,WAAW,GAAc,EAAE,CAAC;IAClC,IAAI,MAA0B,CAAC;IAC/B,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC;IAEvC,GAAG,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE;YAChD,MAAM,EAAE;gBACN,KAAK,EAAE;oBACL,MAAM;oBACN,KAAK,EAAE,SAAS;iBACjB;aACF;SACF,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QACjE,CAAC;QAED,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;QAEhD,wDAAwD;QACxD,IAAI,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACzD,MAAM;QACR,CAAC;IACH,CAAC,QAAQ,MAAM,EAAE;IAEjB,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,OAAwB;IACrD,IAAI,CAAC;QACH,wBAAwB;QACxB,MAAM,MAAM,GAAG,aAAa,CAAC;YAC3B,UAAU,EAAE;gBACV,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB;SACF,CAAC,CAAC;QAEH,iCAAiC;QACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG;gBACb,gGAAgG;aACjG,CAAC;YACF,UAAU,CAAC,EAAE,OAAO,EAAE,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,gBAAgB;QAChB,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/C,aAAa,CAAC;YACZ,OAAO,EAAE,sBAAsB;YAC/B,UAAU,EAAE,CAAC,OAAO,CAAC,QAAQ;SAC9B,CAAC,CAAC;QAEH,iBAAiB;QACjB,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE;YAC3C,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QAEH,aAAa,CAAC;YACZ,OAAO,EAAE,SAAS,QAAQ,CAAC,MAAM,aAAa;YAC9C,UAAU,EAAE,CAAC,OAAO,CAAC,QAAQ;SAC9B,CAAC,CAAC;QAEH,kBAAkB;QAClB,MAAM,MAAM,GAAG,oBAAoB,CAAC;YAClC,QAAQ;YACR,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,UAAU,CAAC;YACT,OAAO,EAAE,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SAC9F,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC;IAExC,OAAO;SACJ,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,CAAC;SAClD,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;SAC/D,MAAM,CACL,mBAAmB,EACnB,qCAAqC,EACrC,QAAQ,CACT;SACA,MAAM,CAAC,eAAe,EAAE,6BAA6B,CAAC;SACtD,MAAM,CAAC,kBAAkB,EAAE,qCAAqC,EAAE,QAAQ,CAAC;SAC3E,MAAM,CAAC,eAAe,CAAC,CAAC;IAE3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/build/commands/experiment.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "commander";
+/**
+ * Create the experiment command
+ */
+export declare function createExperimentCommand(): Command;
+//# sourceMappingURL=experiment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"experiment.d.ts","sourceRoot":"","sources":["../../src/commands/experiment.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiHpC;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAkBjD"}

package/build/commands/experiment.js

@@ -0,0 +1,106 @@
+import { createPhoenixClient } from "../client.js";
+import { getConfigErrorMessage, resolveConfig } from "../config.js";
+import { writeError, writeOutput, writeProgress } from "../io.js";
+import { formatExperimentJsonOutput, } from "./formatExperiment.js";
+import { Command } from "commander";
+import * as fs from "fs";
+/**
+ * Download experiment JSON data
+ */
+async function downloadExperimentJson(client, experimentId) {
+    const response = await client.GET("/v1/experiments/{experiment_id}/json", {
+        params: {
+            path: {
+                experiment_id: experimentId,
+            },
+        },
+        parseAs: "text",
+    });
+    if (response.error || response.data === undefined) {
+        throw new Error(`Failed to download experiment: ${response.error}`);
+    }
+    return response.data;
+}
+/**
+ * Experiment command handler
+ */
+async function experimentHandler(experimentId, options) {
+    try {
+        const userSpecifiedFormat = process.argv.includes("--format") ||
+            process.argv.some((arg) => arg.startsWith("--format="));
+        // Resolve configuration
+        const config = resolveConfig({
+            cliOptions: {
+                endpoint: options.endpoint,
+                apiKey: options.apiKey,
+            },
+        });
+        // Validate that we have endpoint
+        if (!config.endpoint) {
+            const errors = [
+                "Phoenix endpoint not configured. Set PHOENIX_HOST environment variable or use --endpoint flag.",
+            ];
+            writeError({ message: getConfigErrorMessage({ errors }) });
+            process.exit(1);
+        }
+        // Create client
+        const client = createPhoenixClient({ config });
+        writeProgress({
+            message: `Fetching experiment ${experimentId}...`,
+            noProgress: !options.progress,
+        });
+        // Download experiment JSON
+        const jsonData = await downloadExperimentJson(client, experimentId);
+        writeProgress({
+            message: `Downloaded experiment data`,
+            noProgress: !options.progress,
+        });
+        // Determine output format
+        const outputFormat = options.file
+            ? "json"
+            : options.format || "pretty";
+        if (options.file && userSpecifiedFormat && options.format !== "json") {
+            writeError({
+                message: `Warning: --format is ignored when writing to a file; writing JSON to ${options.file}`,
+            });
+        }
+        // Format output
+        const output = formatExperimentJsonOutput({
+            jsonData,
+            format: outputFormat,
+        });
+        if (options.file) {
+            fs.writeFileSync(options.file, output, "utf-8");
+            writeProgress({
+                message: `Wrote experiment to ${options.file}`,
+                noProgress: !options.progress,
+            });
+        }
+        else {
+            writeOutput({ message: output });
+        }
+    }
+    catch (error) {
+        writeError({
+            message: `Error fetching experiment: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        process.exit(1);
+    }
+}
+/**
+ * Create the experiment command
+ */
+export function createExperimentCommand() {
+    const command = new Command("experiment");
+    command
+        .description("Fetch a specific experiment by ID with all run data")
+        .argument("<experiment-id>", "Experiment identifier")
+        .option("--endpoint <url>", "Phoenix API endpoint")
+        .option("--api-key <key>", "Phoenix API key for authentication")
+        .option("--format <format>", "Output format: pretty, json, or raw", "pretty")
+        .option("--no-progress", "Disable progress indicators")
+        .option("--file <path>", "Save experiment to file instead of stdout")
+        .action(experimentHandler);
+    return command;
+}
+//# sourceMappingURL=experiment.js.map