@arizeai/phoenix-cli 0.0.4 → 0.1.0

package/README.md

@@ -1,44 +1,207 @@
-# @arizeai/phoenix-cli
-
-A command-line interface for [Arize Phoenix](https://github.com/Arize-ai/phoenix).
-
-> **Note:** This package is currently under development and not yet ready for use.
+<h1 align="center" style="border-bottom: none">
+    <div>
+        <a href="https://phoenix.arize.com/?utm_medium=github&utm_content=header_img&utm_campaign=phoenix-cli">
+            <picture>
+                <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/Arize-ai/phoenix-assets/refs/heads/main/logos/Phoenix/phoenix.svg">
+                <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/Arize-ai/phoenix-assets/refs/heads/main/logos/Phoenix/phoenix-white.svg">
+                <img alt="Arize Phoenix logo" src="https://raw.githubusercontent.com/Arize-ai/phoenix-assets/refs/heads/main/logos/Phoenix/phoenix.svg" width="100" />
+            </picture>
+        </a>
+        <br>
+        @arizeai/phoenix-cli
+    </div>
+</h1>
+
+<p align="center">
+    <a href="https://www.npmjs.com/package/@arizeai/phoenix-cli">
+        <img src="https://img.shields.io/npm/v/%40arizeai%2Fphoenix-cli" alt="NPM Version">
+    </a>
+    <a href="https://arize.com/docs/phoenix/">
+        <img src="https://img.shields.io/badge/docs-blue?logo=typescript&logoColor=white" alt="Documentation">
+    </a>
+    <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.
 
 ## Installation
 
 ```bash
-# Install globally
 npm install -g @arizeai/phoenix-cli
+```
 
-# Or use with npx
+Or run directly with npx:
+
+```bash
 npx @arizeai/phoenix-cli
 ```
 
-## Usage
+## Quick Start
 
 ```bash
-# View help
-phoenix-cli --help
+# 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
 
-# TODO: Add usage examples here
+# 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 take priority over environment variables.
+
 ## Commands
 
-> **Coming Soon:** Commands will be added to interact with Phoenix prompts, datasets, experiments, and more.
+### `px projects`
+
+List all available projects.
+
+```bash
+px projects
+px projects --format raw  # JSON output for piping
+```
+
+### `px traces [directory]`
+
+Fetch recent traces from the configured project.
+
+```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
+```
+
+| 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                   | —        |
+
+### `px trace <trace-id>`
+
+Fetch a specific trace by ID.
 
-## Development
+```bash
+px trace abc123def456
+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` |
+
+## Output Formats
+
+**`pretty`** (default) — Human-readable tree view:
+
+```
+┌─ 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
+└─
+```
+
+**`json`** — Formatted JSON with indentation.
+
+**`raw`** — Compact JSON for piping to `jq` or other tools.
+
+## JSON Structure
+
+```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"
+}
+```
+
+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.*`.
 
-This package is part of the Phoenix monorepo and uses the existing `@arizeai/phoenix-client` library.
+## Examples
 
-### Building
+### Debug failed traces
 
 ```bash
-pnpm build
+px traces --limit 20 --format raw --no-progress | jq '.[] | select(.status == "ERROR")'
 ```
 
-### Testing
+### Find slowest traces
 
 ```bash
-pnpm test
+px traces --limit 10 --format raw --no-progress | jq 'sort_by(-.duration) | .[0:3]'
 ```
+
+### Extract LLM models used
+
+```bash
+px traces --limit 50 --format raw --no-progress | \
+  jq -r '.[].spans[] | select(.span_kind == "LLM") | .attributes["llm.model_name"]' | sort -u
+```
+
+### Count errors
+
+```bash
+px traces --limit 100 --format raw --no-progress | jq '[.[] | select(.status == "ERROR")] | length'
+```
+
+---
+
+## Community
+
+- 🌍 [Slack community](https://arize-ai.slack.com/join/shared_invite/zt-11t1vbu4x-xkBIHmOREQnYnYDH1GDfCg)
+- 📚 [Documentation](https://arize.com/docs/phoenix)
+- 🌟 [GitHub](https://github.com/Arize-ai/phoenix)
+- 🐞 [Report bugs](https://github.com/Arize-ai/phoenix/issues)
+- 𝕏 [@ArizePhoenix](https://twitter.com/ArizePhoenix)

package/build/cli.d.ts.map

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

package/build/cli.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { createProjectsCommand, createTraceCommand, createTracesCommand, } from "./commands/index.js";
+import { Command } from "commander";
+// Phoenix CLI Main Logic
+export function main() {
+    const program = new Command();
+    program
+        .name("px")
+        .description("Phoenix CLI - AI observability from the command line")
+        .version("0.0.4");
+    // Register commands
+    program.addCommand(createProjectsCommand());
+    program.addCommand(createTracesCommand());
+    program.addCommand(createTraceCommand());
+    // Show help if no command provided
+    if (process.argv.length === 2) {
+        program.help();
+    }
+    program.parse();
+}
+//# sourceMappingURL=cli.js.map

package/build/cli.js.map

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

package/build/client.d.ts

@@ -0,0 +1,31 @@
+import { type PhoenixClient } from "@arizeai/phoenix-client";
+import type { PhoenixConfig } from "./config.js";
+export interface CreatePhoenixClientOptions {
+    /**
+     * Resolved Phoenix CLI configuration.
+     */
+    config: PhoenixConfig;
+}
+/**
+ * Create a Phoenix client from configuration
+ */
+export declare function createPhoenixClient({ config, }: CreatePhoenixClientOptions): PhoenixClient;
+export interface ResolveProjectIdOptions {
+    /**
+     * Phoenix API client.
+     */
+    client: PhoenixClient;
+    /**
+     * Project identifier to resolve.
+     *
+     * Phoenix project IDs are hex-encoded strings. If `projectIdentifier` looks like a hex string,
+     * it's treated as an ID; otherwise it's treated as a name and resolved via the API.
+     */
+    projectIdentifier: string;
+}
+/**
+ * Resolve project identifier to project ID
+ * 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>;
+//# sourceMappingURL=client.d.ts.map

package/build/client.d.ts.map

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

package/build/client.js

@@ -0,0 +1,57 @@
+import { createClient } from "@arizeai/phoenix-client";
+/**
+ * Create a Phoenix client from configuration
+ */
+export function createPhoenixClient({ config, }) {
+    const baseUrl = config.endpoint;
+    if (!baseUrl) {
+        throw new Error("Phoenix endpoint not configured");
+    }
+    const headers = {
+        ...(config.headers || {}),
+    };
+    if (config.apiKey) {
+        headers["Authorization"] = `Bearer ${config.apiKey}`;
+    }
+    return createClient({
+        options: {
+            baseUrl,
+            headers,
+        },
+    });
+}
+function looksLikePhoenixProjectId(projectIdentifier) {
+    // Project IDs are hex-encoded strings (e.g., "a1b2c3d4e5f6...")
+    const trimmed = projectIdentifier.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 project identifier to project ID
+ * If the identifier looks like a Phoenix project ID (hex string), returns it as-is; otherwise fetches by name.
+ */
+export async function resolveProjectId({ client, projectIdentifier, }) {
+    if (looksLikePhoenixProjectId(projectIdentifier)) {
+        return projectIdentifier;
+    }
+    // Otherwise, fetch the project by name to get its ID
+    try {
+        const response = await client.GET("/v1/projects/{project_identifier}", {
+            params: {
+                path: {
+                    project_identifier: projectIdentifier,
+                },
+            },
+        });
+        if (response.error || !response.data) {
+            throw new Error(`Failed to resolve project "${projectIdentifier}": ${response.error}`);
+        }
+        return response.data.data.id;
+    }
+    catch (error) {
+        throw new Error(`Failed to resolve project "${projectIdentifier}": ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=client.js.map

package/build/client.js.map

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

package/build/commands/formatProjects.d.ts

@@ -0,0 +1,19 @@
+export type OutputFormat = "pretty" | "json" | "raw";
+type ProjectLike = {
+    id: string;
+    name: string;
+    description?: string | null;
+};
+export interface FormatProjectsOutputOptions {
+    /**
+     * Projects to format.
+     */
+    projects: ProjectLike[];
+    /**
+     * Output format. Defaults to `"pretty"`.
+     */
+    format?: OutputFormat;
+}
+export declare function formatProjectsOutput({ projects, format, }: FormatProjectsOutputOptions): string;
+export {};
+//# sourceMappingURL=formatProjects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatProjects.d.ts","sourceRoot":"","sources":["../../src/commands/formatProjects.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAErD,KAAK,WAAW,GAAG;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,MAAM,GACP,EAAE,2BAA2B,GAAG,MAAM,CAqBtC"}

package/build/commands/formatProjects.js

@@ -0,0 +1,21 @@
+export function formatProjectsOutput({ projects, format, }) {
+    const selected = format || "pretty";
+    if (selected === "raw") {
+        return JSON.stringify(projects);
+    }
+    if (selected === "json") {
+        return JSON.stringify(projects, null, 2);
+    }
+    const lines = [];
+    lines.push("Projects:");
+    for (const p of projects) {
+        const desc = p.description === null ||
+            p.description === undefined ||
+            p.description === ""
+            ? ""
+            : ` — ${p.description}`;
+        lines.push(`- ${p.name} (${p.id})${desc}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=formatProjects.js.map

package/build/commands/formatProjects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatProjects.js","sourceRoot":"","sources":["../../src/commands/formatProjects.ts"],"names":[],"mappings":"AAmBA,MAAM,UAAU,oBAAoB,CAAC,EACnC,QAAQ,EACR,MAAM,GACsB;IAC5B,MAAM,QAAQ,GAAG,MAAM,IAAI,QAAQ,CAAC;IACpC,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IACD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,IAAI,GACR,CAAC,CAAC,WAAW,KAAK,IAAI;YACtB,CAAC,CAAC,WAAW,KAAK,SAAS;YAC3B,CAAC,CAAC,WAAW,KAAK,EAAE;YAClB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/build/commands/formatTraces.d.ts

@@ -0,0 +1,25 @@
+import type { Trace } from "../trace.js";
+export type OutputFormat = "pretty" | "json" | "raw";
+export interface FormatTraceOutputOptions {
+    /**
+     * Trace to format.
+     */
+    trace: Trace;
+    /**
+     * Output format. Defaults to `"pretty"`.
+     */
+    format?: OutputFormat;
+}
+export declare function formatTraceOutput({ trace, format, }: FormatTraceOutputOptions): string;
+export interface FormatTracesOutputOptions {
+    /**
+     * Traces to format.
+     */
+    traces: Trace[];
+    /**
+     * Output format. Defaults to `"pretty"`.
+     */
+    format?: OutputFormat;
+}
+export declare function formatTracesOutput({ traces, format, }: FormatTracesOutputOptions): string;
+//# sourceMappingURL=formatTraces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatTraces.d.ts","sourceRoot":"","sources":["../../src/commands/formatTraces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;AAMrD,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;IACb;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,MAAM,GACP,EAAE,wBAAwB,GAAG,MAAM,CASnC;AAED,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,MAAM,GACP,EAAE,yBAAyB,GAAG,MAAM,CAcpC"}

package/build/commands/formatTraces.js

@@ -0,0 +1,165 @@
+const INPUT_VALUE_ATTRIBUTE = "input.value";
+const OUTPUT_VALUE_ATTRIBUTE = "output.value";
+const VALUE_PREVIEW_MAX_CHARS = 200;
+export function formatTraceOutput({ trace, format, }) {
+    const selected = format || "pretty";
+    if (selected === "raw") {
+        return JSON.stringify(trace);
+    }
+    if (selected === "json") {
+        return JSON.stringify(trace, null, 2);
+    }
+    return formatTracePretty(trace);
+}
+export function formatTracesOutput({ traces, format, }) {
+    const selected = format || "pretty";
+    if (selected === "raw") {
+        return JSON.stringify(traces);
+    }
+    if (selected === "json") {
+        return JSON.stringify(traces, null, 2);
+    }
+    if (traces.length === 0) {
+        return "No traces found";
+    }
+    return traces
+        .map((t) => formatTracePretty(t))
+        .join("\n\n" + "=".repeat(80) + "\n\n");
+}
+function formatTracePretty(trace) {
+    const lines = [];
+    lines.push(`┌─ Trace: ${trace.traceId}`);
+    lines.push(`│`);
+    const forest = buildSpanForest(trace.spans);
+    const rootWithIo = forest.find((n) => {
+        const attrs = n.span.attributes;
+        return (previewAttributeValue(attrs?.[INPUT_VALUE_ATTRIBUTE]) !== undefined ||
+            previewAttributeValue(attrs?.[OUTPUT_VALUE_ATTRIBUTE]) !== undefined);
+    });
+    if (rootWithIo) {
+        const inputPreview = previewAttributeValue(rootWithIo.span.attributes?.[INPUT_VALUE_ATTRIBUTE]);
+        const outputPreview = previewAttributeValue(rootWithIo.span.attributes?.[OUTPUT_VALUE_ATTRIBUTE]);
+        if (inputPreview)
+            lines.push(`│  Input: ${inputPreview}`);
+        if (outputPreview)
+            lines.push(`│  Output: ${outputPreview}`);
+        if (inputPreview || outputPreview)
+            lines.push(`│`);
+    }
+    lines.push(`│  Spans:`);
+    for (let i = 0; i < forest.length; i++) {
+        renderSpanNode(lines, forest[i], {
+            ancestors: [],
+            isLast: i === forest.length - 1,
+        });
+    }
+    lines.push(`└─`);
+    return lines.join("\n");
+}
+function buildSpanForest(spans) {
+    const spanIdToSpan = new Map();
+    const spanIdToNode = new Map();
+    const parentIdToChildren = new Map();
+    for (const span of spans) {
+        const spanId = span.context?.span_id;
+        if (!spanId)
+            continue;
+        spanIdToSpan.set(spanId, span);
+    }
+    for (const span of spans) {
+        const parentId = span.parent_id ?? null;
+        if (!parentId)
+            continue;
+        if (!parentIdToChildren.has(parentId)) {
+            parentIdToChildren.set(parentId, []);
+        }
+        parentIdToChildren.get(parentId).push(span);
+    }
+    const getNode = (span) => {
+        const spanId = span.context.span_id;
+        const existing = spanIdToNode.get(spanId);
+        if (existing)
+            return existing;
+        const node = { span, children: [] };
+        spanIdToNode.set(spanId, node);
+        return node;
+    };
+    // roots: no parent_id, or parent_id not present in this trace
+    const roots = [];
+    for (const span of spans) {
+        const parentId = span.parent_id ?? null;
+        if (!parentId || !spanIdToSpan.has(parentId)) {
+            roots.push(span);
+        }
+    }
+    const sortByStartTime = (a, b) => {
+        const aStart = Date.parse(a.start_time);
+        const bStart = Date.parse(b.start_time);
+        if (!Number.isNaN(aStart) && !Number.isNaN(bStart)) {
+            return aStart - bStart;
+        }
+        return String(a.name).localeCompare(String(b.name));
+    };
+    const buildNodeRec = (span) => {
+        const node = getNode(span);
+        const children = parentIdToChildren.get(span.context.span_id) ?? [];
+        children.sort(sortByStartTime);
+        node.children = children.map(buildNodeRec);
+        return node;
+    };
+    roots.sort(sortByStartTime);
+    return roots.map(buildNodeRec);
+}
+function renderSpanNode(lines, node, opts) {
+    const { span, children } = node;
+    const baseIndent = "│  ";
+    const treePrefix = opts.ancestors
+        .map((ancestorIsLast) => (ancestorIsLast ? "   " : "│  "))
+        .join("");
+    const connector = opts.isLast ? "└─" : "├─";
+    const status = span.status_code === "ERROR" ? "✗" : "✓";
+    const kind = span.span_kind;
+    const duration = formatDurationMs(span.start_time, span.end_time);
+    lines.push(`${baseIndent}${treePrefix}${connector} ${status} ${span.name} (${kind}) - ${duration}`);
+    const nextAncestors = [...opts.ancestors, opts.isLast];
+    for (let i = 0; i < children.length; i++) {
+        renderSpanNode(lines, children[i], {
+            ancestors: nextAncestors,
+            isLast: i === children.length - 1,
+        });
+    }
+}
+function formatDurationMs(startTime, endTime) {
+    const startMs = Date.parse(startTime);
+    const endMs = Date.parse(endTime);
+    if (Number.isNaN(startMs) || Number.isNaN(endMs)) {
+        return "n/a";
+    }
+    return `${Math.max(0, endMs - startMs)}ms`;
+}
+function previewAttributeValue(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    let str;
+    if (typeof value === "string") {
+        str = value;
+    }
+    else {
+        try {
+            str = JSON.stringify(value);
+        }
+        catch {
+            str = String(value);
+        }
+    }
+    str = str.replace(/\s+/g, " ").trim();
+    if (!str) {
+        return undefined;
+    }
+    if (str.length > VALUE_PREVIEW_MAX_CHARS) {
+        return `${str.slice(0, VALUE_PREVIEW_MAX_CHARS)}…`;
+    }
+    return str;
+}
+//# sourceMappingURL=formatTraces.js.map

package/build/commands/formatTraces.js.map

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

package/build/commands/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./projects.js";
+export * from "./traces.js";
+export * from "./trace.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/build/commands/index.js

@@ -0,0 +1,4 @@
+export * from "./projects.js";
+export * from "./traces.js";
+export * from "./trace.js";
+//# sourceMappingURL=index.js.map

package/build/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/build/commands/projects.d.ts

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

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

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