@arizeai/phoenix-cli 0.0.4 → 0.1.0

package/build/commands/projects.js

@@ -0,0 +1,87 @@
+import { createPhoenixClient } from "../client.js";
+import { getConfigErrorMessage, resolveConfig } from "../config.js";
+import { writeError, writeOutput } from "../io.js";
+import { formatProjectsOutput } from "./formatProjects.js";
+import { Command } from "commander";
+/**
+ * Fetch all projects from Phoenix
+ */
+async function fetchProjects(client, options = {}) {
+    const allProjects = [];
+    let cursor;
+    const limit = options.limit || 100;
+    do {
+        const response = await client.GET("/v1/projects", {
+            params: {
+                query: {
+                    cursor,
+                    limit,
+                    include_experiment_projects: false,
+                },
+            },
+        });
+        if (response.error || !response.data) {
+            throw new Error(`Failed to fetch projects: ${response.error}`);
+        }
+        allProjects.push(...response.data.data);
+        cursor = response.data.next_cursor || undefined;
+    } while (cursor);
+    return allProjects;
+}
+/**
+ * Projects command handler
+ */
+async function projectsHandler(options) {
+    try {
+        // Resolve configuration
+        const config = resolveConfig({
+            cliOptions: {
+                endpoint: options.endpoint,
+                project: options.project,
+                apiKey: options.apiKey,
+            },
+        });
+        // Validate that we have endpoint (project not required for listing projects)
+        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 });
+        // Fetch projects
+        const projects = await fetchProjects(client, {
+            limit: options.limit,
+        });
+        // Output projects
+        const output = formatProjectsOutput({
+            projects: projects,
+            format: options.format,
+        });
+        writeOutput({ message: output });
+    }
+    catch (error) {
+        writeError({
+            message: `Error fetching projects: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        process.exit(1);
+    }
+}
+/**
+ * Create the projects command
+ */
+export function createProjectsCommand() {
+    const command = new Command("projects");
+    command
+        .description("List all available Phoenix projects")
+        .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 projects to fetch per page", parseInt)
+        .action(projectsHandler);
+    return command;
+}
+//# sourceMappingURL=projects.js.map

package/build/commands/projects.js.map

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

package/build/commands/trace.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwKpC;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAmB5C"}

package/build/commands/trace.js

@@ -0,0 +1,143 @@
+import { createPhoenixClient, resolveProjectId } from "../client.js";
+import { getConfigErrorMessage, resolveConfig, validateConfig, } from "../config.js";
+import { writeError, writeOutput, writeProgress } from "../io.js";
+import { buildTrace } from "../trace.js";
+import { formatTraceOutput } from "./formatTraces.js";
+import { Command } from "commander";
+import * as fs from "fs";
+/**
+ * Fetch spans for a specific trace
+ */
+async function fetchTraceSpans(client, projectIdentifier, traceId) {
+    const allSpans = [];
+    let cursor;
+    // Fetch all spans for the project and filter by trace ID
+    // Note: This is a workaround since there's no direct trace-by-ID endpoint with spans
+    do {
+        const response = await client.GET("/v1/projects/{project_identifier}/spans", {
+            params: {
+                path: {
+                    project_identifier: projectIdentifier,
+                },
+                query: {
+                    cursor,
+                    limit: 1000,
+                },
+            },
+        });
+        if (response.error || !response.data) {
+            throw new Error(`Failed to fetch spans: ${response.error}`);
+        }
+        // Filter spans for this trace
+        const traceSpans = response.data.data.filter((span) => span.context.trace_id === traceId ||
+            span.context.trace_id.startsWith(traceId));
+        allSpans.push(...traceSpans);
+        // If we found spans for this trace, stop searching
+        if (allSpans.length > 0) {
+            break;
+        }
+        cursor = response.data.next_cursor || undefined;
+    } while (cursor);
+    return allSpans;
+}
+/**
+ * Trace command handler
+ */
+async function traceHandler(traceId, options) {
+    try {
+        const userSpecifiedFormat = process.argv.includes("--format") ||
+            process.argv.some((arg) => arg.startsWith("--format="));
+        // Resolve configuration
+        const config = resolveConfig({
+            cliOptions: {
+                endpoint: options.endpoint,
+                project: options.project,
+                apiKey: options.apiKey,
+            },
+        });
+        // Validate configuration
+        const validation = validateConfig({ config });
+        if (!validation.valid) {
+            writeError({
+                message: getConfigErrorMessage({ errors: validation.errors }),
+            });
+            process.exit(1);
+        }
+        // Create client
+        const client = createPhoenixClient({ config });
+        // Resolve project ID
+        const projectIdentifier = config.project;
+        if (!projectIdentifier) {
+            writeError({ message: "Project not configured" });
+            process.exit(1);
+        }
+        writeProgress({
+            message: `Resolving project: ${projectIdentifier}`,
+            noProgress: !options.progress,
+        });
+        const projectId = await resolveProjectId({
+            client,
+            projectIdentifier,
+        });
+        // Fetch trace
+        writeProgress({
+            message: `Fetching trace ${traceId}...`,
+            noProgress: !options.progress,
+        });
+        const spans = await fetchTraceSpans(client, projectId, traceId);
+        if (spans.length === 0) {
+            writeError({ message: `Trace not found: ${traceId}` });
+            process.exit(1);
+        }
+        writeProgress({
+            message: `Found ${spans.length} span(s)`,
+            noProgress: !options.progress,
+        });
+        // Build trace
+        const trace = buildTrace({ spans });
+        // Output trace
+        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}`,
+            });
+        }
+        const output = formatTraceOutput({ trace, format: outputFormat });
+        if (options.file) {
+            fs.writeFileSync(options.file, output, "utf-8");
+            writeProgress({
+                message: `Wrote trace to ${options.file}`,
+                noProgress: !options.progress,
+            });
+        }
+        else {
+            writeOutput({ message: output });
+        }
+    }
+    catch (error) {
+        writeError({
+            message: `Error fetching trace: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        process.exit(1);
+    }
+}
+/**
+ * Create the trace command
+ */
+export function createTraceCommand() {
+    const command = new Command("trace");
+    command
+        .description("Fetch a specific trace by ID")
+        .argument("<trace-id>", "Trace identifier (OTEL trace ID or prefix)")
+        .option("--endpoint <url>", "Phoenix API endpoint")
+        .option("--project <name>", "Project name or ID")
+        .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 trace to file instead of stdout")
+        .action(traceHandler);
+    return command;
+}
+//# sourceMappingURL=trace.js.map

package/build/commands/trace.js.map

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

package/build/commands/traces.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../../src/commands/traces.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiSpC;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAoC7C"}

package/build/commands/traces.js

@@ -0,0 +1,239 @@
+import { createPhoenixClient, resolveProjectId } from "../client.js";
+import { getConfigErrorMessage, resolveConfig, validateConfig, } from "../config.js";
+import { writeError, writeOutput, writeProgress } from "../io.js";
+import { buildTrace, groupSpansByTrace } from "../trace.js";
+import { formatTracesOutput } from "./formatTraces.js";
+import { Command } from "commander";
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * Fetch spans for a project within a time range
+ */
+async function fetchSpans(client, projectIdentifier, options = {}) {
+    const allSpans = [];
+    let cursor;
+    const pageLimit = 1000; // Max per page
+    do {
+        const response = await client.GET("/v1/projects/{project_identifier}/spans", {
+            params: {
+                path: {
+                    project_identifier: projectIdentifier,
+                },
+                query: {
+                    cursor,
+                    limit: pageLimit,
+                    start_time: options.startTime,
+                    end_time: options.endTime,
+                },
+            },
+        });
+        if (response.error || !response.data) {
+            throw new Error(`Failed to fetch spans: ${response.error}`);
+        }
+        allSpans.push(...response.data.data);
+        cursor = response.data.next_cursor || undefined;
+        // Stop if we have enough spans for the requested number of traces
+        if (options.limit && allSpans.length >= options.limit * 10) {
+            break;
+        }
+    } while (cursor);
+    return allSpans;
+}
+/**
+ * Get the last N traces
+ */
+async function getLastNTraces(client, projectIdentifier, limit, options = {}) {
+    // Calculate time range
+    let startTime;
+    if (options.since) {
+        startTime = options.since;
+    }
+    else if (options.lastNMinutes) {
+        const now = new Date();
+        const start = new Date(now.getTime() - options.lastNMinutes * 60 * 1000);
+        startTime = start.toISOString();
+    }
+    // Fetch spans
+    const spans = await fetchSpans(client, projectIdentifier, {
+        startTime,
+        limit,
+    });
+    // Group spans by trace
+    const traceGroups = groupSpansByTrace({ spans });
+    // Build trace objects
+    const traces = [];
+    for (const [traceId, traceSpans] of traceGroups.entries()) {
+        try {
+            const trace = buildTrace({ spans: traceSpans });
+            traces.push(trace);
+        }
+        catch (error) {
+            writeProgress({
+                message: `Warning: Failed to build trace ${traceId}: ${error instanceof Error ? error.message : String(error)}`,
+                noProgress: false,
+            });
+        }
+    }
+    // Sort by start time (newest first)
+    traces.sort((a, b) => {
+        if (!a.startTime || !b.startTime)
+            return 0;
+        return new Date(b.startTime).getTime() - new Date(a.startTime).getTime();
+    });
+    // Return last N traces
+    return traces.slice(0, limit);
+}
+/**
+ * Write traces to directory
+ */
+async function writeTracesToDirectory(traces, directory, options = {}) {
+    // Create directory if it doesn't exist
+    if (!fs.existsSync(directory)) {
+        fs.mkdirSync(directory, { recursive: true });
+    }
+    const maxConcurrent = options.maxConcurrent || 10;
+    const chunks = [];
+    // Split into chunks for concurrent processing
+    for (let i = 0; i < traces.length; i += maxConcurrent) {
+        chunks.push(traces.slice(i, i + maxConcurrent));
+    }
+    let completed = 0;
+    for (const chunk of chunks) {
+        await Promise.all(chunk.map(async (trace) => {
+            try {
+                // Write to file
+                const filename = `${trace.traceId}.json`;
+                const filepath = path.join(directory, filename);
+                // Always write JSON when writing to files.
+                const content = JSON.stringify(trace, null, 2);
+                fs.writeFileSync(filepath, content, "utf-8");
+                completed++;
+                writeProgress({
+                    message: `[${completed}/${traces.length}] Wrote ${filename}`,
+                    noProgress: options.noProgress,
+                });
+            }
+            catch (error) {
+                writeProgress({
+                    message: `Warning: Failed to write trace ${trace.traceId}: ${error instanceof Error ? error.message : String(error)}`,
+                    noProgress: options.noProgress,
+                });
+            }
+        }));
+    }
+}
+/**
+ * Traces command handler
+ */
+async function tracesHandler(directory, options) {
+    try {
+        const userSpecifiedFormat = process.argv.includes("--format") ||
+            process.argv.some((arg) => arg.startsWith("--format="));
+        // Resolve configuration
+        const config = resolveConfig({
+            cliOptions: {
+                endpoint: options.endpoint,
+                project: options.project,
+                apiKey: options.apiKey,
+            },
+        });
+        // Validate configuration
+        const validation = validateConfig({ config });
+        if (!validation.valid) {
+            writeError({
+                message: getConfigErrorMessage({ errors: validation.errors }),
+            });
+            process.exit(1);
+        }
+        // Create client
+        const client = createPhoenixClient({ config });
+        // Resolve project ID
+        const projectIdentifier = config.project;
+        if (!projectIdentifier) {
+            writeError({ message: "Project not configured" });
+            process.exit(1);
+        }
+        writeProgress({
+            message: `Resolving project: ${projectIdentifier}`,
+            noProgress: !options.progress,
+        });
+        const projectId = await resolveProjectId({
+            client,
+            projectIdentifier,
+        });
+        // Fetch traces
+        const limit = options.limit || 10;
+        writeProgress({
+            message: `Fetching last ${limit} trace(s)...`,
+            noProgress: !options.progress,
+        });
+        const traces = await getLastNTraces(client, projectId, limit, {
+            lastNMinutes: options.lastNMinutes,
+            since: options.since,
+        });
+        if (traces.length === 0) {
+            writeProgress({
+                message: "No traces found",
+                noProgress: !options.progress,
+            });
+            return;
+        }
+        writeProgress({
+            message: `Found ${traces.length} trace(s)`,
+            noProgress: !options.progress,
+        });
+        // Output traces
+        if (directory) {
+            if (userSpecifiedFormat && options.format && options.format !== "json") {
+                writeError({
+                    message: `Warning: --format is ignored when writing traces to a directory; writing JSON files to ${directory}`,
+                });
+            }
+            // Write to directory
+            writeProgress({
+                message: `Writing traces to ${directory}...`,
+                noProgress: !options.progress,
+            });
+            await writeTracesToDirectory(traces, directory, {
+                noProgress: !options.progress,
+                maxConcurrent: options.maxConcurrent,
+            });
+            writeProgress({
+                message: `Done! Wrote ${traces.length} trace(s) to ${directory}`,
+                noProgress: !options.progress,
+            });
+        }
+        else {
+            // Write to stdout
+            const output = formatTracesOutput({ traces, format: options.format });
+            writeOutput({ message: output });
+        }
+    }
+    catch (error) {
+        writeError({
+            message: `Error fetching traces: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        process.exit(1);
+    }
+}
+/**
+ * Create the traces command
+ */
+export function createTracesCommand() {
+    const command = new Command("traces");
+    command
+        .description("Fetch recent traces for the configured project")
+        .argument("[directory]", "Directory to write trace files (optional)")
+        .option("--endpoint <url>", "Phoenix API endpoint")
+        .option("--project <name>", "Project name or ID")
+        .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("-n, --limit <number>", "Fetch the last N traces (newest first)", parseInt, 10)
+        .option("--last-n-minutes <number>", "Only fetch traces from the last N minutes", parseInt)
+        .option("--since <timestamp>", "Fetch traces since this ISO timestamp")
+        .option("--max-concurrent <number>", "Maximum concurrent fetches for bulk operations", parseInt, 10)
+        .action(tracesHandler);
+    return command;
+}
+//# sourceMappingURL=traces.js.map

package/build/commands/traces.js.map

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

package/build/config.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Configuration for the Phoenix CLI
+ */
+export interface PhoenixConfig {
+    /**
+     * The Phoenix API endpoint
+     */
+    endpoint?: string;
+    /**
+     * The project name or ID
+     */
+    project?: string;
+    /**
+     * API key for authentication
+     */
+    apiKey?: string;
+    /**
+     * Custom headers
+     */
+    headers?: Record<string, string>;
+}
+/**
+ * Load configuration from environment variables
+ */
+export declare function loadConfigFromEnvironment(): PhoenixConfig;
+/**
+ * Resolve configuration from supported sources
+ * Priority: CLI flags > Environment variables
+ */
+export interface ResolveConfigOptions {
+    /**
+     * CLI-provided config values (typically from Commander). `undefined` values are ignored.
+     */
+    cliOptions: Partial<PhoenixConfig>;
+}
+/**
+ * Resolve configuration from supported sources.
+ * Priority: CLI flags > Environment variables.
+ */
+export declare function resolveConfig({ cliOptions, }: ResolveConfigOptions): PhoenixConfig;
+/**
+ * Validate that required configuration is present
+ */
+export interface ValidateConfigOptions {
+    /**
+     * Resolved Phoenix CLI configuration.
+     */
+    config: PhoenixConfig;
+}
+/**
+ * Validate that required configuration is present.
+ */
+export declare function validateConfig({ config }: ValidateConfigOptions): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Get error message with actionable instructions
+ */
+export interface GetConfigErrorMessageOptions {
+    /**
+     * Validation errors to include in the message.
+     */
+    errors: string[];
+}
+/**
+ * Get error message with actionable instructions.
+ */
+export declare function getConfigErrorMessage({ errors, }: GetConfigErrorMessageOptions): string;
+//# sourceMappingURL=config.d.ts.map

package/build/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,aAAa,CAyBzD;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,UAAU,GACX,EAAE,oBAAoB,GAAG,aAAa,CAatC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,EAAE,qBAAqB,GAAG;IACjE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAkBA;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,MAAM,GACP,EAAE,4BAA4B,GAAG,MAAM,CAiBvC"}