@arizeai/phoenix-cli 1.0.4 → 1.1.0

package/build/commands/span.js

@@ -1,11 +1,16 @@
 import * as fs from "fs";
+import { addSpanNote } from "@arizeai/phoenix-client/spans";
 import { Command } from "commander";
 import { createPhoenixClient, resolveProjectId } from "../client.js";
 import { getConfigErrorMessage, resolveConfig, validateConfig, } from "../config.js";
 import { assertDeletesEnabled, confirmOrExit } from "../confirm.js";
 import { ExitCode, getExitCodeForError } from "../exitCodes.js";
 import { writeError, writeOutput, writeProgress } from "../io.js";
-import { formatSpansOutput } from "./formatSpans.js";
+import { buildAnnotationMutationResult, getAnnotationMutationHelpText, getResponseErrorMessage, normalizeAnnotationInput, } from "./annotationMutationUtils.js";
+import { formatAnnotationMutationOutput, } from "./formatAnnotationMutation.js";
+import { formatNoteMutationOutput, } from "./formatNoteMutation.js";
+import { formatSpansOutput, } from "./formatSpans.js";
+import { buildNoteMutationResult, NOTE_ANNOTATION_NAME, normalizeNoteText, } from "./noteMutationUtils.js";
 import { fetchSpanAnnotations } from "./spanAnnotations.js";
 /**
  * Fetch spans for a project with optional filters
@@ -131,6 +136,7 @@ async function spanListHandler(file, options) {
                 client,
                 projectIdentifier: projectId,
                 spanIds,
+                excludeAnnotationNames: [NOTE_ANNOTATION_NAME],
             });
             const annotationsBySpanId = new Map();
             for (const annotation of annotations) {
@@ -150,6 +156,38 @@ async function spanListHandler(file, options) {
                 }
             }
         }
+        if (options.includeNotes) {
+            writeProgress({
+                message: "Fetching span notes...",
+                noProgress: !options.progress,
+            });
+            const spanIds = spans
+                .map((span) => span.context?.span_id)
+                .filter((spanId) => Boolean(spanId));
+            const notes = await fetchSpanAnnotations({
+                client,
+                projectIdentifier: projectId,
+                spanIds,
+                includeAnnotationNames: [NOTE_ANNOTATION_NAME],
+            });
+            const notesBySpanId = new Map();
+            for (const note of notes) {
+                const spanId = note.span_id;
+                if (!notesBySpanId.has(spanId)) {
+                    notesBySpanId.set(spanId, []);
+                }
+                notesBySpanId.get(spanId).push(note);
+            }
+            for (const span of spans) {
+                const spanId = span.context?.span_id;
+                if (!spanId)
+                    continue;
+                const spanNotes = notesBySpanId.get(spanId);
+                if (spanNotes) {
+                    span.notes = spanNotes;
+                }
+            }
+        }
         // Output spans
         if (file) {
             if (userSpecifiedFormat && options.format && options.format !== "json") {
@@ -197,8 +235,162 @@ export function createSpanListCommand() {
         .option("--trace-id <ids...>", "Filter by trace ID(s)")
         .option("--parent-id <id>", 'Filter by parent span ID (use "null" for root spans only)')
         .option("--include-annotations", "Include span annotations in the output")
+        .option("--include-notes", "Include span notes in the output")
         .action(spanListHandler);
 }
+/**
+ * Handler for `span annotate`
+ */
+async function spanAnnotateHandler(spanId, options) {
+    try {
+        const config = resolveConfig({
+            cliOptions: {
+                endpoint: options.endpoint,
+                apiKey: options.apiKey,
+            },
+        });
+        const validation = validateConfig({ config, projectRequired: false });
+        if (!validation.valid) {
+            writeError({
+                message: getConfigErrorMessage({ errors: validation.errors }),
+            });
+            process.exit(ExitCode.INVALID_ARGUMENT);
+        }
+        const annotationInput = normalizeAnnotationInput({
+            targetType: "span",
+            name: options.name,
+            label: options.label,
+            score: options.score,
+            explanation: options.explanation,
+            annotatorKind: options.annotatorKind,
+        });
+        const client = createPhoenixClient({ config });
+        writeProgress({
+            message: `Annotating span ${spanId}...`,
+            noProgress: !options.progress,
+        });
+        const response = await client.POST("/v1/span_annotations", {
+            params: {
+                query: {
+                    sync: true,
+                },
+            },
+            body: {
+                data: [
+                    {
+                        span_id: spanId,
+                        name: annotationInput.name,
+                        annotator_kind: annotationInput.annotatorKind,
+                        result: annotationInput.result,
+                        identifier: "",
+                    },
+                ],
+            },
+        });
+        if (response.error) {
+            throw new Error(getResponseErrorMessage(response.error));
+        }
+        const insertedAnnotation = response.data?.data?.[0];
+        if (!insertedAnnotation) {
+            throw new Error("Phoenix did not return the inserted span annotation ID.");
+        }
+        const annotation = buildAnnotationMutationResult({
+            id: insertedAnnotation.id,
+            targetType: "span",
+            targetId: spanId,
+            annotationInput,
+        });
+        const output = formatAnnotationMutationOutput({
+            annotation,
+            format: options.format,
+        });
+        writeOutput({ message: output });
+    }
+    catch (error) {
+        writeError({
+            message: `Error annotating span: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        process.exit(getExitCodeForError(error));
+    }
+}
+export function createSpanAnnotateCommand() {
+    return new Command("annotate")
+        .description("Annotate a span by OpenTelemetry span ID")
+        .argument("<span-id>", "OpenTelemetry span ID")
+        .option("--endpoint <url>", "Phoenix API endpoint")
+        .option("--api-key <key>", "Phoenix API key for authentication")
+        .option("--name <name>", "Annotation name")
+        .option("--label <label>", "Annotation label")
+        .option("--score <number>", "Annotation score")
+        .option("--explanation <text>", "Annotation explanation")
+        .option("--annotator-kind <kind>", "Annotation kind: HUMAN, LLM, or CODE")
+        .option("--format <format>", "Output format: pretty, json, or raw", "pretty")
+        .option("--no-progress", "Disable progress indicators")
+        .addHelpText("after", getAnnotationMutationHelpText({ targetType: "span" }))
+        .action(spanAnnotateHandler);
+}
+async function spanAddNoteHandler(spanId, options) {
+    try {
+        const config = resolveConfig({
+            cliOptions: {
+                endpoint: options.endpoint,
+                apiKey: options.apiKey,
+            },
+        });
+        const validation = validateConfig({ config, projectRequired: false });
+        if (!validation.valid) {
+            writeError({
+                message: getConfigErrorMessage({ errors: validation.errors }),
+            });
+            process.exit(ExitCode.INVALID_ARGUMENT);
+        }
+        const noteText = normalizeNoteText({
+            targetType: "span",
+            text: options.text,
+        });
+        const client = createPhoenixClient({ config });
+        writeProgress({
+            message: `Adding note to span ${spanId}...`,
+            noProgress: !options.progress,
+        });
+        const result = await addSpanNote({
+            client,
+            spanNote: {
+                spanId,
+                note: noteText,
+            },
+        });
+        const note = buildNoteMutationResult({
+            id: result.id,
+            targetType: "span",
+            targetId: spanId,
+            text: noteText,
+        });
+        writeOutput({
+            message: formatNoteMutationOutput({
+                note,
+                format: options.format,
+            }),
+        });
+    }
+    catch (error) {
+        writeError({
+            message: `Error adding span note: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        process.exit(getExitCodeForError(error));
+    }
+}
+export function createSpanAddNoteCommand() {
+    return new Command("add-note")
+        .description("Add a note to a span by OpenTelemetry span ID")
+        .argument("<span-id>", "OpenTelemetry span ID")
+        .option("--endpoint <url>", "Phoenix API endpoint")
+        .option("--api-key <key>", "Phoenix API key for authentication")
+        .option("--text <text>", "Note text")
+        .option("--format <format>", "Output format: pretty, json, or raw", "pretty")
+        .option("--no-progress", "Disable progress indicators")
+        .action(spanAddNoteHandler);
+}
 /**
  * Handler for `span delete`
  */
@@ -266,6 +458,8 @@ export function createSpanCommand() {
     const command = new Command("span");
     command.description("Manage Phoenix spans");
     command.addCommand(createSpanListCommand());
+    command.addCommand(createSpanAnnotateCommand());
+    command.addCommand(createSpanAddNoteCommand());
     command.addCommand(createSpanDeleteCommand());
     return command;
 }

package/build/commands/span.js.map

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

package/build/commands/trace.d.ts

@@ -1,6 +1,7 @@
 import { Command } from "commander";
 export declare function createTraceGetCommand(): Command;
 export declare function createTraceListCommand(): Command;
+export declare function createTraceAnnotateCommand(): Command;
 export declare function createTraceDeleteCommand(): Command;
 /**
  * Create the `trace` command with subcommands

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

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4gBpC,wBAAgB,qBAAqB,IAAI,OAAO,CAmB/C;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAoChD;AAsED,wBAAgB,wBAAwB,IAAI,OAAO,CAYlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAO5C"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/commands/trace.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAspBpC,wBAAgB,qBAAqB,IAAI,OAAO,CAoB/C;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAqChD;AA2FD,wBAAgB,0BAA0B,IAAI,OAAO,CAsBpD;AAsED,wBAAgB,wBAAwB,IAAI,OAAO,CAYlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAQ5C"}

package/build/commands/trace.js

@@ -6,10 +6,70 @@ import { getConfigErrorMessage, resolveConfig, validateConfig, } from "../config
 import { assertDeletesEnabled, confirmOrExit } from "../confirm.js";
 import { ExitCode, getExitCodeForError } from "../exitCodes.js";
 import { writeError, writeOutput, writeProgress } from "../io.js";
-import { buildTrace, groupSpansByTrace } from "../trace.js";
-import { formatTraceOutput } from "./formatTraces.js";
-import { formatTracesOutput } from "./formatTraces.js";
+import { buildTrace, groupSpansByTrace, } from "../trace.js";
+import { buildAnnotationMutationResult, getAnnotationMutationHelpText, getResponseErrorMessage, normalizeAnnotationInput, } from "./annotationMutationUtils.js";
+import { formatAnnotationMutationOutput, } from "./formatAnnotationMutation.js";
+import { formatTraceOutput, formatTracesOutput, } from "./formatTraces.js";
+import { NOTE_ANNOTATION_NAME } from "./noteMutationUtils.js";
 import { fetchSpanAnnotations } from "./spanAnnotations.js";
+import { fetchTraceAnnotations, } from "./traceAnnotations.js";
+function attachSpanAnnotationsToSpans(spans, annotations) {
+    const annotationsBySpanId = new Map();
+    for (const annotation of annotations) {
+        const spanId = annotation.span_id;
+        if (!annotationsBySpanId.has(spanId)) {
+            annotationsBySpanId.set(spanId, []);
+        }
+        annotationsBySpanId.get(spanId).push(annotation);
+    }
+    for (const span of spans) {
+        const spanId = span.context?.span_id;
+        if (!spanId)
+            continue;
+        const spanAnnotations = annotationsBySpanId.get(spanId);
+        if (spanAnnotations) {
+            span.annotations = spanAnnotations;
+        }
+    }
+}
+function attachTraceAnnotationsToTraces(traces, annotations) {
+    const annotationsByTraceId = new Map();
+    for (const annotation of annotations) {
+        const traceId = annotation.trace_id;
+        if (!annotationsByTraceId.has(traceId)) {
+            annotationsByTraceId.set(traceId, []);
+        }
+        annotationsByTraceId.get(traceId).push(annotation);
+    }
+    for (const trace of traces) {
+        const traceAnnotations = annotationsByTraceId.get(trace.traceId);
+        if (traceAnnotations) {
+            trace.annotations = traceAnnotations;
+        }
+    }
+}
+function attachSpanNotesToSpans(spans, notes) {
+    const notesBySpanId = new Map();
+    for (const note of notes) {
+        const spanId = note.span_id;
+        if (!notesBySpanId.has(spanId)) {
+            notesBySpanId.set(spanId, []);
+        }
+        notesBySpanId.get(spanId).push(note);
+    }
+    for (const span of spans) {
+        const spanId = span.context?.span_id;
+        if (!spanId)
+            continue;
+        const spanNotes = notesBySpanId.get(spanId);
+        if (spanNotes) {
+            span.notes = spanNotes;
+        }
+    }
+}
+function getResolvedTraceId(spans) {
+    return spans[0]?.context?.trace_id;
+}
 /**
  * Fetch spans for a project within a time range
  */
@@ -205,35 +265,52 @@ async function traceGetHandler(traceId, options) {
             message: `Found ${spans.length} span(s)`,
             noProgress: !options.progress,
         });
+        const traceSpans = spans;
+        const resolvedTraceId = getResolvedTraceId(spans);
+        let traceAnnotations;
         if (options.includeAnnotations) {
-            const spanIds = spans
+            writeProgress({
+                message: "Fetching trace and span annotations...",
+                noProgress: !options.progress,
+            });
+            traceAnnotations = await fetchTraceAnnotations({
+                client,
+                projectIdentifier: projectId,
+                traceIds: resolvedTraceId ? [resolvedTraceId] : [traceId],
+                excludeAnnotationNames: [NOTE_ANNOTATION_NAME],
+            });
+            const spanIds = traceSpans
                 .map((span) => span.context?.span_id)
                 .filter((spanId) => Boolean(spanId));
-            const annotations = await fetchSpanAnnotations({
+            const spanAnnotations = await fetchSpanAnnotations({
                 client,
                 projectIdentifier: projectId,
                 spanIds,
+                excludeAnnotationNames: [NOTE_ANNOTATION_NAME],
             });
-            const annotationsBySpanId = new Map();
-            for (const annotation of annotations) {
-                const spanId = annotation.span_id;
-                if (!annotationsBySpanId.has(spanId)) {
-                    annotationsBySpanId.set(spanId, []);
-                }
-                annotationsBySpanId.get(spanId).push(annotation);
-            }
-            for (const span of spans) {
-                const spanId = span.context?.span_id;
-                if (!spanId)
-                    continue;
-                const spanAnnotations = annotationsBySpanId.get(spanId);
-                if (spanAnnotations) {
-                    span.annotations = spanAnnotations;
-                }
-            }
+            attachSpanAnnotationsToSpans(traceSpans, spanAnnotations);
+        }
+        if (options.includeNotes) {
+            writeProgress({
+                message: "Fetching span notes...",
+                noProgress: !options.progress,
+            });
+            const spanIds = traceSpans
+                .map((span) => span.context?.span_id)
+                .filter((spanId) => Boolean(spanId));
+            const spanNotes = await fetchSpanAnnotations({
+                client,
+                projectIdentifier: projectId,
+                spanIds,
+                includeAnnotationNames: [NOTE_ANNOTATION_NAME],
+            });
+            attachSpanNotesToSpans(traceSpans, spanNotes);
         }
         // Build trace
-        const trace = buildTrace({ spans });
+        const trace = buildTrace({ spans: traceSpans });
+        if (traceAnnotations?.length) {
+            trace.annotations = traceAnnotations;
+        }
         // Output trace
         const outputFormat = options.file
             ? "json"
@@ -319,37 +396,50 @@ async function traceListHandler(directory, options) {
         });
         if (options.includeAnnotations) {
             writeProgress({
-                message: "Fetching span annotations...",
+                message: "Fetching trace and span annotations...",
                 noProgress: !options.progress,
             });
+            const traceAnnotations = await fetchTraceAnnotations({
+                client,
+                projectIdentifier: projectId,
+                traceIds: traces.map((trace) => trace.traceId),
+                excludeAnnotationNames: [NOTE_ANNOTATION_NAME],
+                maxConcurrent: options.maxConcurrent,
+            });
+            attachTraceAnnotationsToTraces(traces, traceAnnotations);
             const spanIds = traces
                 .flatMap((trace) => trace.spans)
                 .map((span) => span.context?.span_id)
                 .filter((spanId) => Boolean(spanId));
-            const annotations = await fetchSpanAnnotations({
+            const spanAnnotations = await fetchSpanAnnotations({
                 client,
                 projectIdentifier: projectId,
                 spanIds,
+                excludeAnnotationNames: [NOTE_ANNOTATION_NAME],
                 maxConcurrent: options.maxConcurrent,
             });
-            const annotationsBySpanId = new Map();
-            for (const annotation of annotations) {
-                const spanId = annotation.span_id;
-                if (!annotationsBySpanId.has(spanId)) {
-                    annotationsBySpanId.set(spanId, []);
-                }
-                annotationsBySpanId.get(spanId).push(annotation);
+            for (const trace of traces) {
+                attachSpanAnnotationsToSpans(trace.spans, spanAnnotations);
             }
+        }
+        if (options.includeNotes) {
+            writeProgress({
+                message: "Fetching span notes...",
+                noProgress: !options.progress,
+            });
+            const spanIds = traces
+                .flatMap((trace) => trace.spans)
+                .map((span) => span.context?.span_id)
+                .filter((spanId) => Boolean(spanId));
+            const spanNotes = await fetchSpanAnnotations({
+                client,
+                projectIdentifier: projectId,
+                spanIds,
+                includeAnnotationNames: [NOTE_ANNOTATION_NAME],
+                maxConcurrent: options.maxConcurrent,
+            });
             for (const trace of traces) {
-                for (const span of trace.spans) {
-                    const spanId = span.context?.span_id;
-                    if (!spanId)
-                        continue;
-                    const spanAnnotations = annotationsBySpanId.get(spanId);
-                    if (spanAnnotations) {
-                        span.annotations = spanAnnotations;
-                    }
-                }
+                attachSpanNotesToSpans(trace.spans, spanNotes);
             }
         }
         if (directory) {
@@ -393,7 +483,8 @@ export function createTraceGetCommand() {
         .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")
-        .option("--include-annotations", "Include span annotations in the trace export")
+        .option("--include-annotations", "Include trace and span annotations in the trace export")
+        .option("--include-notes", "Include span notes in the trace export")
         .action(traceGetHandler);
 }
 export function createTraceListCommand() {
@@ -409,9 +500,101 @@ export function createTraceListCommand() {
         .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", (v) => parseInt(v, 10), 10)
-        .option("--include-annotations", "Include span annotations in the trace export")
+        .option("--include-annotations", "Include trace and span annotations in the trace export")
+        .option("--include-notes", "Include span notes in the trace export")
         .action(traceListHandler);
 }
+/**
+ * Handler for `trace annotate`
+ */
+async function traceAnnotateHandler(traceId, options) {
+    try {
+        const config = resolveConfig({
+            cliOptions: {
+                endpoint: options.endpoint,
+                apiKey: options.apiKey,
+            },
+        });
+        const validation = validateConfig({ config, projectRequired: false });
+        if (!validation.valid) {
+            writeError({
+                message: getConfigErrorMessage({ errors: validation.errors }),
+            });
+            process.exit(ExitCode.INVALID_ARGUMENT);
+        }
+        const annotationInput = normalizeAnnotationInput({
+            targetType: "trace",
+            name: options.name,
+            label: options.label,
+            score: options.score,
+            explanation: options.explanation,
+            annotatorKind: options.annotatorKind,
+        });
+        const client = createPhoenixClient({ config });
+        writeProgress({
+            message: `Annotating trace ${traceId}...`,
+            noProgress: !options.progress,
+        });
+        const response = await client.POST("/v1/trace_annotations", {
+            params: {
+                query: {
+                    sync: true,
+                },
+            },
+            body: {
+                data: [
+                    {
+                        trace_id: traceId,
+                        name: annotationInput.name,
+                        annotator_kind: annotationInput.annotatorKind,
+                        result: annotationInput.result,
+                        identifier: "",
+                    },
+                ],
+            },
+        });
+        if (response.error) {
+            throw new Error(getResponseErrorMessage(response.error));
+        }
+        const insertedAnnotation = response.data?.data?.[0];
+        if (!insertedAnnotation) {
+            throw new Error("Phoenix did not return the inserted trace annotation ID.");
+        }
+        const annotation = buildAnnotationMutationResult({
+            id: insertedAnnotation.id,
+            targetType: "trace",
+            targetId: traceId,
+            annotationInput,
+        });
+        const output = formatAnnotationMutationOutput({
+            annotation,
+            format: options.format,
+        });
+        writeOutput({ message: output });
+    }
+    catch (error) {
+        writeError({
+            message: `Error annotating trace: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        process.exit(getExitCodeForError(error));
+    }
+}
+export function createTraceAnnotateCommand() {
+    return new Command("annotate")
+        .description("Annotate a trace by OpenTelemetry trace ID")
+        .argument("<trace-id>", "OpenTelemetry trace ID")
+        .option("--endpoint <url>", "Phoenix API endpoint")
+        .option("--api-key <key>", "Phoenix API key for authentication")
+        .option("--name <name>", "Annotation name")
+        .option("--label <label>", "Annotation label")
+        .option("--score <number>", "Annotation score")
+        .option("--explanation <text>", "Annotation explanation")
+        .option("--annotator-kind <kind>", "Annotation kind: HUMAN, LLM, or CODE")
+        .option("--format <format>", "Output format: pretty, json, or raw", "pretty")
+        .option("--no-progress", "Disable progress indicators")
+        .addHelpText("after", getAnnotationMutationHelpText({ targetType: "trace" }))
+        .action(traceAnnotateHandler);
+}
 /**
  * Handler for `trace delete`
  */
@@ -480,6 +663,7 @@ export function createTraceCommand() {
     command.description("Manage Phoenix traces");
     command.addCommand(createTraceListCommand());
     command.addCommand(createTraceGetCommand());
+    command.addCommand(createTraceAnnotateCommand());
     command.addCommand(createTraceDeleteCommand());
     return command;
 }