@arizeai/phoenix-cli 1.8.1 → 1.9.1

package/build/commands/traceAnnotationsCommand.js

@@ -1,167 +0,0 @@
-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 { writeStructuredError } from "../structuredError.js";
-import { formatAnnotationDeleteOutput, } from "./formatAnnotationDelete.js";
-async function traceAnnotationsDeleteHandler(options) {
-    // Pre-flight checks live OUTSIDE the try/catch so explicit
-    // process.exit(INVALID_ARGUMENT) is not re-mapped to FAILURE by the
-    // catch's getExitCodeForError fallback.
-    try {
-        assertDeletesEnabled();
-    }
-    catch (error) {
-        writeError({
-            message: error instanceof Error ? error.message : String(error),
-        });
-        process.exit(getExitCodeForError(error));
-    }
-    const config = resolveConfig({
-        cliOptions: {
-            endpoint: options.endpoint,
-            project: options.project,
-            apiKey: options.apiKey,
-        },
-    });
-    const validation = validateConfig({ config });
-    if (!validation.valid) {
-        writeError({
-            message: getConfigErrorMessage({ errors: validation.errors }),
-        });
-        process.exit(ExitCode.INVALID_ARGUMENT);
-    }
-    const projectIdentifier = config.project;
-    if (!projectIdentifier) {
-        writeError({ message: "Project not configured" });
-        process.exit(ExitCode.INVALID_ARGUMENT);
-    }
-    // Require either --all or both --start-time and --end-time. Other
-    // narrowers do not authorize the request; match the server contract before
-    // hitting the wire.
-    const hasWindow = options.startTime !== undefined && options.endTime !== undefined;
-    if (!options.all && !hasWindow) {
-        writeStructuredError({
-            format: options.format,
-            message: "Missing required authorization: pass --all to delete every matching row, or pass both --start-time and --end-time to bound the delete to a [start, end) window.",
-            code: "INVALID_ARGUMENT",
-            hint: 'px trace-annotations delete --identifier "$PHOENIX_CODING_IDENTIFIER" --all',
-        });
-        process.exit(ExitCode.INVALID_ARGUMENT);
-    }
-    let annotatorKind;
-    try {
-        annotatorKind = normalizeAnnotatorKind(options.annotatorKind);
-    }
-    catch (error) {
-        writeError({
-            message: error instanceof Error ? error.message : String(error),
-        });
-        process.exit(ExitCode.INVALID_ARGUMENT);
-    }
-    try {
-        const client = createPhoenixClient({ config });
-        writeProgress({
-            message: `Resolving project: ${projectIdentifier}`,
-            noProgress: !options.progress,
-        });
-        const projectId = await resolveProjectId({ client, projectIdentifier });
-        const promptMessage = options.all
-            ? `Delete all matching trace annotations across all time?${describeNarrowers(options)}`
-            : `Delete trace annotations between ${options.startTime} and ${options.endTime}?${describeNarrowers(options)}`;
-        await confirmOrExit({ message: promptMessage, yes: options.yes });
-        writeProgress({
-            message: "Deleting trace annotations...",
-            noProgress: !options.progress,
-        });
-        const response = await client.DELETE("/v1/projects/{project_identifier}/trace_annotations", {
-            params: {
-                path: { project_identifier: projectId },
-                query: {
-                    name: options.name,
-                    identifier: options.identifier,
-                    annotator_kind: annotatorKind,
-                    start_time: options.startTime,
-                    end_time: options.endTime,
-                    delete_all: options.all === true ? true : undefined,
-                },
-            },
-        });
-        if (response.error) {
-            throw new Error(`Failed to delete trace annotations: ${response.error}`);
-        }
-        const filter = {
-            ...(options.identifier !== undefined && {
-                identifier: options.identifier,
-            }),
-            ...(options.name !== undefined && { name: options.name }),
-            ...(annotatorKind !== undefined && { annotator_kind: annotatorKind }),
-            ...(options.startTime !== undefined && { start_time: options.startTime }),
-            ...(options.endTime !== undefined && { end_time: options.endTime }),
-            ...(options.all === true && { all: true }),
-        };
-        writeOutput({
-            message: formatAnnotationDeleteOutput({
-                result: { deleted: true, target: "trace", filter },
-                format: options.format,
-            }),
-        });
-    }
-    catch (error) {
-        writeError({
-            message: `Error deleting trace annotations: ${error instanceof Error ? error.message : String(error)}`,
-        });
-        process.exit(getExitCodeForError(error));
-    }
-}
-function normalizeAnnotatorKind(raw) {
-    if (raw === undefined)
-        return undefined;
-    const value = raw.toUpperCase();
-    if (value === "HUMAN" || value === "LLM" || value === "CODE") {
-        return value;
-    }
-    throw new Error(`Invalid --annotator-kind: ${raw}. Expected one of HUMAN, LLM, CODE.`);
-}
-function describeNarrowers(options) {
-    const parts = [];
-    if (options.identifier)
-        parts.push(`identifier=${options.identifier}`);
-    if (options.name)
-        parts.push(`name=${options.name}`);
-    if (options.annotatorKind)
-        parts.push(`annotator_kind=${options.annotatorKind}`);
-    return parts.length > 0 ? ` (${parts.join(", ")})` : "";
-}
-export function createTraceAnnotationsDeleteCommand() {
-    return new Command("delete")
-        .description("Delete trace annotations for the configured project. Requires --all or both --start-time and --end-time.")
-        .option("--endpoint <url>", "Phoenix API endpoint")
-        .option("--project <name>", "Project name or ID")
-        .option("--api-key <key>", "Phoenix API key for authentication")
-        .option("--identifier <id>", "Narrowing filter — only delete annotations with this identifier")
-        .option("--name <name>", "Narrowing filter — only delete annotations with this name")
-        .option("--annotator-kind <kind>", "Narrowing filter — annotator kind (HUMAN, LLM, or CODE)")
-        .option("--start-time <iso>", "Inclusive lower bound on created_at (ISO-8601). Required together with --end-time unless --all is set.")
-        .option("--end-time <iso>", "Exclusive upper bound on created_at (ISO-8601). Required together with --start-time unless --all is set.")
-        .option("--all", "Authorize the delete without a time window (delete_all=true). Required if --start-time/--end-time are not set.")
-        .option("-y, --yes", "Skip confirmation prompt")
-        .option("--format <format>", "Output format: pretty, json, or raw", "pretty")
-        .option("--no-progress", "Disable progress indicators")
-        .addHelpText("after", "\nExamples:\n" +
-        '  px trace-annotations delete --identifier "$PHOENIX_CODING_IDENTIFIER" --all -y\n' +
-        "  px trace-annotations delete --start-time 2026-01-01T00:00:00Z --end-time 2026-01-02T00:00:00Z\n")
-        .action(traceAnnotationsDeleteHandler);
-}
-/**
- * Create the `trace-annotations` command group.
- */
-export function createTraceAnnotationsCommand() {
-    const command = new Command("trace-annotations");
-    command.description("Manage Phoenix trace annotations");
-    command.addCommand(createTraceAnnotationsDeleteCommand());
-    return command;
-}
-//# sourceMappingURL=traceAnnotationsCommand.js.map

package/build/commands/traceAnnotationsCommand.js.map

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