@arizeai/phoenix-cli 0.11.0 → 0.11.1

package/build/banner.d.ts

@@ -1,5 +1,26 @@
 /**
- * Print the Phoenix CLI banner with connection info aligned to the right of the logo.
+ * Text shown below the Phoenix logo.
  */
-export declare function printBanner(): void;
+export interface BannerInfoLinesOptions {
+    serverUrl: string;
+    project: string;
+    hasApiKey: boolean;
+    currentVersion: string;
+    latestVersion?: string;
+    hasUpdate?: boolean;
+}
+/**
+ * Build the informational text displayed below the Phoenix logo.
+ */
+export declare function getBannerInfoLines({ serverUrl, project, hasApiKey, currentVersion, latestVersion, hasUpdate, }: BannerInfoLinesOptions): string[];
+/**
+ * Render the full banner with the logo first and metadata below it.
+ */
+export declare function renderBanner({ infoLines }: {
+    infoLines: string[];
+}): string;
+/**
+ * Print the Phoenix CLI banner with connection and update info aligned to the right of the logo.
+ */
+export declare function printBanner(): Promise<void>;
 //# sourceMappingURL=banner.d.ts.map

package/build/banner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAiBlC"}
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,SAAS,EACT,OAAO,EACP,SAAS,EACT,cAAc,EACd,aAAa,EACb,SAAS,GACV,EAAE,sBAAsB,GAAG,MAAM,EAAE,CAYnC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,EAAE;IAAE,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAE3E;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAcjD"}

package/build/banner.js

@@ -1,27 +1,49 @@
 import { loadConfigFromEnvironment } from "./config.js";
 import { writeOutput } from "./io.js";
+import { getCliVersionStatus } from "./version.js";
 const LOGO_LINES = [
     "░█▀█░█░█░█▀█░█▀▀░█▀█░▀█▀░█░█",
     "░█▀▀░█▀█░█░█░█▀▀░█░█░░█░░▄▀▄",
     "░▀░░░▀░▀░▀▀▀░▀▀▀░▀░▀░▀▀▀░▀░▀",
 ];
+const TAGLINE = "CLI for interacting with your phoenix server";
 /**
- * Print the Phoenix CLI banner with connection info aligned to the right of the logo.
+ * Build the informational text displayed below the Phoenix logo.
  */
-export function printBanner() {
-    const config = loadConfigFromEnvironment();
-    const serverUrl = config.endpoint ?? "not set";
-    const project = config.project ?? "not set";
-    const infoLines = [
-        `  Server:  ${serverUrl}`,
-        `  Project: ${project}`,
-        ...(config.apiKey ? [`  API Key: set`] : []),
+export function getBannerInfoLines({ serverUrl, project, hasApiKey, currentVersion, latestVersion, hasUpdate, }) {
+    return [
+        `Server:  ${serverUrl}`,
+        `Project: ${project}`,
+        ...(hasApiKey ? [`API Key: set`] : []),
+        `Version: v${currentVersion}`,
+        ...(hasUpdate && latestVersion
+            ? [
+                `Update:  v${latestVersion} available. Run npm install -g @arizeai/phoenix-cli`,
+            ]
+            : []),
     ];
-    const output = LOGO_LINES.map((logo, index) => {
-        const info = infoLines[index];
-        return info ? `${logo}${info}` : logo;
+}
+/**
+ * Render the full banner with the logo first and metadata below it.
+ */
+export function renderBanner({ infoLines }) {
+    return [...LOGO_LINES, "", TAGLINE, "", ...infoLines].join("\n");
+}
+/**
+ * Print the Phoenix CLI banner with connection and update info aligned to the right of the logo.
+ */
+export async function printBanner() {
+    const config = loadConfigFromEnvironment();
+    const versionStatus = await getCliVersionStatus();
+    const infoLines = getBannerInfoLines({
+        serverUrl: config.endpoint ?? "not set",
+        project: config.project ?? "not set",
+        hasApiKey: Boolean(config.apiKey),
+        currentVersion: versionStatus.currentVersion,
+        latestVersion: versionStatus.latestVersion,
+        hasUpdate: versionStatus.hasUpdate,
     });
-    writeOutput({ message: output.join("\n") });
+    writeOutput({ message: renderBanner({ infoLines }) });
     writeOutput({ message: "" });
 }
 //# sourceMappingURL=banner.js.map

package/build/banner.js.map

@@ -1 +1 @@
-{"version":3,"file":"banner.js","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,UAAU,GAAG;IACjB,8BAA8B;IAC9B,8BAA8B;IAC9B,8BAA8B;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,MAAM,GAAG,yBAAyB,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC;IAC5C,MAAM,SAAS,GAAG;QAChB,cAAc,SAAS,EAAE;QACzB,cAAc,OAAO,EAAE;QACvB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;IAEF,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,UAAU,GAAG;IACjB,8BAA8B;IAC9B,8BAA8B;IAC9B,8BAA8B;CAC/B,CAAC;AACF,MAAM,OAAO,GAAG,8CAA8C,CAAC;AAc/D;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,EACjC,SAAS,EACT,OAAO,EACP,SAAS,EACT,cAAc,EACd,aAAa,EACb,SAAS,GACc;IACvB,OAAO;QACL,YAAY,SAAS,EAAE;QACvB,YAAY,OAAO,EAAE;QACrB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,aAAa,cAAc,EAAE;QAC7B,GAAG,CAAC,SAAS,IAAI,aAAa;YAC5B,CAAC,CAAC;gBACE,aAAa,aAAa,qDAAqD;aAChF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,SAAS,EAA2B;IACjE,OAAO,CAAC,GAAG,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,MAAM,GAAG,yBAAyB,EAAE,CAAC;IAC3C,MAAM,aAAa,GAAG,MAAM,mBAAmB,EAAE,CAAC;IAClD,MAAM,SAAS,GAAG,kBAAkB,CAAC;QACnC,SAAS,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS;QACvC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,SAAS;QACpC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QACjC,cAAc,EAAE,aAAa,CAAC,cAAc;QAC5C,aAAa,EAAE,aAAa,CAAC,aAAa;QAC1C,SAAS,EAAE,aAAa,CAAC,SAAS;KACnC,CAAC,CAAC;IAEH,WAAW,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACtD,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;AAC/B,CAAC"}

package/build/cli.d.ts

@@ -1,3 +1,7 @@
 #!/usr/bin/env node
-export declare function main(): void;
+import { Command } from "commander";
+export declare function createProgram(): Command;
+export declare function main({ argv, }?: {
+    argv?: string[];
+}): Promise<void>;
 //# sourceMappingURL=cli.d.ts.map

package/build/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAyBA,wBAAgB,IAAI,SA+BnB"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuBpC,wBAAgB,aAAa,IAAI,OAAO,CA0BvC;AAGD,wBAAsB,IAAI,CAAC,EACzB,IAAmB,GACpB,GAAE;IACD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACZ,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrB"}

package/build/cli.js

@@ -2,11 +2,12 @@
 import { Command } from "commander";
 import { printBanner } from "./banner.js";
 import { createAnnotationConfigCommand, createApiCommand, createAuthCommand, createDatasetCommand, createDatasetsCommand, createDocsCommand, createExperimentCommand, createExperimentsCommand, createProjectsCommand, createPromptCommand, createPromptsCommand, createSessionCommand, createSessionsCommand, createSpansCommand, createTraceCommand, createTracesCommand, } from "./commands/index.js";
-// Phoenix CLI Main Logic
-export function main() {
+import { CLI_VERSION } from "./version.js";
+export function createProgram() {
     const program = new Command();
     program.name("px");
     program.enablePositionalOptions();
+    program.version(CLI_VERSION);
     // Register commands
     program.addCommand(createAnnotationConfigCommand());
     program.addCommand(createAuthCommand());
@@ -24,11 +25,17 @@ export function main() {
     program.addCommand(createPromptCommand());
     program.addCommand(createApiCommand());
     program.addCommand(createDocsCommand());
+    return program;
+}
+// Phoenix CLI Main Logic
+export async function main({ argv = process.argv, } = {}) {
+    const program = createProgram();
     // Show banner and help if no command provided
-    if (process.argv.length === 2) {
-        printBanner();
+    if (argv.length === 2) {
+        await printBanner();
         program.help();
+        return;
     }
-    program.parse();
+    await program.parseAsync(argv);
 }
 //# sourceMappingURL=cli.js.map

package/build/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,yBAAyB;AACzB,MAAM,UAAU,IAAI;IAClB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAElC,oBAAoB;IACpB,OAAO,CAAC,UAAU,CAAC,6BAA6B,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,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,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,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;IAC9C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,8CAA8C;IAC9C,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,WAAW,EAAE,CAAC;QACd,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,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EACL,6BAA6B,EAC7B,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAClC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7B,oBAAoB;IACpB,OAAO,CAAC,UAAU,CAAC,6BAA6B,EAAE,CAAC,CAAC;IACpD,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxC,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,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,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;IAC9C,OAAO,CAAC,UAAU,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,UAAU,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC1C,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAExC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yBAAyB;AACzB,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,EACzB,IAAI,GAAG,OAAO,CAAC,IAAI,MAGjB,EAAE;IACJ,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAEhC,8CAA8C;IAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,WAAW,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO;IACT,CAAC;IAED,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/build/commands/prompt.js

@@ -97,7 +97,7 @@ export function createPromptCommand() {
     const command = new Command("prompt");
     command
         .description("Show a Phoenix prompt")
-        .argument("<prompt_identifier>", "Prompt name or ID")
+        .argument("<prompt-identifier>", "Prompt 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, raw, or text", "pretty")

package/build/index.js

@@ -1,6 +1,12 @@
 #!/usr/bin/env node
 // Phoenix CLI Entry Point
 import { main } from "./cli.js";
+import { writeError } from "./io.js";
 // Run CLI when executed directly
-main();
+void main().catch((error) => {
+    writeError({
+        message: `Error: ${error instanceof Error ? error.message : String(error)}`,
+    });
+    process.exit(1);
+});
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,0BAA0B;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAE7B,iCAAiC;AACjC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,0BAA0B;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAElC,iCAAiC;AACjC,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC1B,UAAU,CAAC;QACT,OAAO,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;KAC5E,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/build/version.d.ts

@@ -0,0 +1,44 @@
+type SemanticVersion = {
+    major: number;
+    minor: number;
+    patch: number;
+    prerelease?: string;
+};
+export interface CliVersionStatus {
+    currentVersion: string;
+    latestVersion?: string;
+    hasUpdate?: boolean;
+}
+export interface FetchLatestPublishedCliVersionOptions {
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+}
+export declare const CLI_VERSION: string;
+/**
+ * Returns the CLI version from package metadata.
+ */
+export declare function getCliVersion(): string;
+/**
+ * Parse a semver string so the CLI can compare local and published versions.
+ */
+export declare function parseSemanticVersion({ rawVersion, }: {
+    rawVersion: string;
+}): SemanticVersion | null;
+/**
+ * Compare two semantic versions.
+ * Returns `1` when left is newer, `-1` when right is newer, and `0` when equal.
+ */
+export declare function compareSemanticVersions({ leftVersion, rightVersion, }: {
+    leftVersion: string;
+    rightVersion: string;
+}): number | null;
+/**
+ * Fetch the latest published CLI version from the npm registry.
+ */
+export declare function fetchLatestPublishedCliVersion({ fetchFn, timeoutMs, }?: FetchLatestPublishedCliVersionOptions): Promise<string | undefined>;
+/**
+ * Resolve the current CLI version and, when possible, the latest published version.
+ */
+export declare function getCliVersionStatus({ fetchFn, timeoutMs, }?: FetchLatestPublishedCliVersionOptions): Promise<CliVersionStatus>;
+export {};
+//# sourceMappingURL=version.d.ts.map

package/build/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AASA,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAUF,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,qCAAqC;IACpD,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoCD,eAAO,MAAM,WAAW,QAGH,CAAC;AAEtB;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,UAAU,GACX,EAAE;IACD,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,eAAe,GAAG,IAAI,CAYzB;AA0DD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,WAAW,EACX,YAAY,GACb,EAAE;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,GAAG,IAAI,CAsBhB;AAED;;GAEG;AACH,wBAAsB,8BAA8B,CAAC,EACnD,OAAe,EACf,SAA4C,GAC7C,GAAE,qCAA0C,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuB1E;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,OAAO,EACP,SAAS,GACV,GAAE,qCAA0C,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyBxE"}

package/build/version.js

@@ -0,0 +1,171 @@
+import { readFileSync } from "node:fs";
+const CLI_PACKAGE_NAME = "@arizeai/phoenix-cli";
+const CLI_LATEST_VERSION_URL = `https://registry.npmjs.org/${encodeURIComponent(CLI_PACKAGE_NAME)}/latest`;
+const DEFAULT_VERSION_CHECK_TIMEOUT_MS = 1500;
+const DEFAULT_CLI_VERSION = "unknown";
+const SEMANTIC_VERSION_PATTERN = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?(?:\+[0-9A-Za-z.-]+)?$/;
+function getPackageJsonVersion({ packageJson, }) {
+    if (typeof packageJson.version !== "string") {
+        return undefined;
+    }
+    const version = packageJson.version.trim();
+    return version.length > 0 ? version : undefined;
+}
+function readCliVersionFromPackageJson() {
+    try {
+        const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+        return getPackageJsonVersion({ packageJson });
+    }
+    catch {
+        return undefined;
+    }
+}
+function readCliVersionFromEnvironment() {
+    if (typeof process.env.npm_package_version !== "string") {
+        return undefined;
+    }
+    const version = process.env.npm_package_version.trim();
+    return version.length > 0 ? version : undefined;
+}
+export const CLI_VERSION = readCliVersionFromPackageJson() ??
+    readCliVersionFromEnvironment() ??
+    DEFAULT_CLI_VERSION;
+/**
+ * Returns the CLI version from package metadata.
+ */
+export function getCliVersion() {
+    return CLI_VERSION;
+}
+/**
+ * Parse a semver string so the CLI can compare local and published versions.
+ */
+export function parseSemanticVersion({ rawVersion, }) {
+    const match = rawVersion.trim().match(SEMANTIC_VERSION_PATTERN);
+    if (!match) {
+        return null;
+    }
+    return {
+        major: Number.parseInt(match[1], 10),
+        minor: Number.parseInt(match[2], 10),
+        patch: Number.parseInt(match[3], 10),
+        prerelease: match[4] || undefined,
+    };
+}
+function comparePrereleaseSegments({ leftPrerelease, rightPrerelease, }) {
+    if (leftPrerelease === rightPrerelease) {
+        return 0;
+    }
+    if (!leftPrerelease) {
+        return 1;
+    }
+    if (!rightPrerelease) {
+        return -1;
+    }
+    const leftSegments = leftPrerelease.split(".");
+    const rightSegments = rightPrerelease.split(".");
+    const segmentCount = Math.max(leftSegments.length, rightSegments.length);
+    for (let index = 0; index < segmentCount; index += 1) {
+        const leftSegment = leftSegments[index];
+        const rightSegment = rightSegments[index];
+        if (leftSegment === rightSegment) {
+            continue;
+        }
+        if (leftSegment === undefined) {
+            return -1;
+        }
+        if (rightSegment === undefined) {
+            return 1;
+        }
+        const leftNumber = Number.parseInt(leftSegment, 10);
+        const rightNumber = Number.parseInt(rightSegment, 10);
+        const isLeftNumeric = String(leftNumber) === leftSegment;
+        const isRightNumeric = String(rightNumber) === rightSegment;
+        if (isLeftNumeric && isRightNumeric) {
+            return leftNumber === rightNumber ? 0 : leftNumber > rightNumber ? 1 : -1;
+        }
+        if (isLeftNumeric) {
+            return -1;
+        }
+        if (isRightNumeric) {
+            return 1;
+        }
+        return leftSegment.localeCompare(rightSegment);
+    }
+    return 0;
+}
+/**
+ * Compare two semantic versions.
+ * Returns `1` when left is newer, `-1` when right is newer, and `0` when equal.
+ */
+export function compareSemanticVersions({ leftVersion, rightVersion, }) {
+    const leftParsedVersion = parseSemanticVersion({ rawVersion: leftVersion });
+    const rightParsedVersion = parseSemanticVersion({ rawVersion: rightVersion });
+    if (!leftParsedVersion || !rightParsedVersion) {
+        return null;
+    }
+    if (leftParsedVersion.major !== rightParsedVersion.major) {
+        return leftParsedVersion.major > rightParsedVersion.major ? 1 : -1;
+    }
+    if (leftParsedVersion.minor !== rightParsedVersion.minor) {
+        return leftParsedVersion.minor > rightParsedVersion.minor ? 1 : -1;
+    }
+    if (leftParsedVersion.patch !== rightParsedVersion.patch) {
+        return leftParsedVersion.patch > rightParsedVersion.patch ? 1 : -1;
+    }
+    return comparePrereleaseSegments({
+        leftPrerelease: leftParsedVersion.prerelease,
+        rightPrerelease: rightParsedVersion.prerelease,
+    });
+}
+/**
+ * Fetch the latest published CLI version from the npm registry.
+ */
+export async function fetchLatestPublishedCliVersion({ fetchFn = fetch, timeoutMs = DEFAULT_VERSION_CHECK_TIMEOUT_MS, } = {}) {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetchFn(CLI_LATEST_VERSION_URL, {
+            headers: {
+                Accept: "application/json",
+            },
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            return undefined;
+        }
+        const payload = (await response.json());
+        return typeof payload.version === "string" ? payload.version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+/**
+ * Resolve the current CLI version and, when possible, the latest published version.
+ */
+export async function getCliVersionStatus({ fetchFn, timeoutMs, } = {}) {
+    const currentVersion = getCliVersion();
+    const latestVersion = await fetchLatestPublishedCliVersion({
+        fetchFn,
+        timeoutMs,
+    });
+    if (!latestVersion) {
+        return { currentVersion };
+    }
+    const comparison = compareSemanticVersions({
+        leftVersion: latestVersion,
+        rightVersion: currentVersion,
+    });
+    if (comparison === null) {
+        return { currentVersion };
+    }
+    return {
+        currentVersion,
+        latestVersion,
+        hasUpdate: comparison > 0,
+    };
+}
+//# sourceMappingURL=version.js.map

package/build/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAChD,MAAM,sBAAsB,GAAG,8BAA8B,kBAAkB,CAAC,gBAAgB,CAAC,SAAS,CAAC;AAC3G,MAAM,gCAAgC,GAAG,IAAI,CAAC;AAC9C,MAAM,mBAAmB,GAAG,SAAS,CAAC;AACtC,MAAM,wBAAwB,GAC5B,kEAAkE,CAAC;AA4BrE,SAAS,qBAAqB,CAAC,EAC7B,WAAW,GAGZ;IACC,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3C,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,SAAS,6BAA6B;IACpC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAC5B,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CACjD,CAAC;QAEpB,OAAO,qBAAqB,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,6BAA6B;IACpC,IAAI,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC;IACvD,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GACtB,6BAA6B,EAAE;IAC/B,6BAA6B,EAAE;IAC/B,mBAAmB,CAAC;AAEtB;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,EACnC,UAAU,GAGX;IACC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;QACrC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;QACrC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC;QACrC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAAC,EACjC,cAAc,EACd,eAAe,GAIhB;IACC,IAAI,cAAc,KAAK,eAAe,EAAE,CAAC;QACvC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAED,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAEzE,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,YAAY,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;QACxC,MAAM,YAAY,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAE1C,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,CAAC,CAAC;QACZ,CAAC;QACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACpD,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,WAAW,CAAC;QACzD,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,YAAY,CAAC;QAE5D,IAAI,aAAa,IAAI,cAAc,EAAE,CAAC;YACpC,OAAO,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,CAAC,CAAC,CAAC;QACZ,CAAC;QACD,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,CAAC,CAAC;QACX,CAAC;QAED,OAAO,WAAW,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACjD,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACtC,WAAW,EACX,YAAY,GAIb;IACC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;IAC5E,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC;IAE9E,IAAI,CAAC,iBAAiB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,iBAAiB,CAAC,KAAK,KAAK,kBAAkB,CAAC,KAAK,EAAE,CAAC;QACzD,OAAO,iBAAiB,CAAC,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,iBAAiB,CAAC,KAAK,KAAK,kBAAkB,CAAC,KAAK,EAAE,CAAC;QACzD,OAAO,iBAAiB,CAAC,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,iBAAiB,CAAC,KAAK,KAAK,kBAAkB,CAAC,KAAK,EAAE,CAAC;QACzD,OAAO,iBAAiB,CAAC,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,yBAAyB,CAAC;QAC/B,cAAc,EAAE,iBAAiB,CAAC,UAAU;QAC5C,eAAe,EAAE,kBAAkB,CAAC,UAAU;KAC/C,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,EACnD,OAAO,GAAG,KAAK,EACf,SAAS,GAAG,gCAAgC,MACH,EAAE;IAC3C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAElE,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,sBAAsB,EAAE;YACrD,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;aAC3B;YACD,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA0B,CAAC;QACjE,OAAO,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EACxC,OAAO,EACP,SAAS,MACgC,EAAE;IAC3C,MAAM,cAAc,GAAG,aAAa,EAAE,CAAC;IACvC,MAAM,aAAa,GAAG,MAAM,8BAA8B,CAAC;QACzD,OAAO;QACP,SAAS;KACV,CAAC,CAAC;IAEH,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,UAAU,GAAG,uBAAuB,CAAC;QACzC,WAAW,EAAE,aAAa;QAC1B,YAAY,EAAE,cAAc;KAC7B,CAAC,CAAC;IAEH,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,cAAc;QACd,aAAa;QACb,SAAS,EAAE,UAAU,GAAG,CAAC;KAC1B,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arizeai/phoenix-cli",
-  "version": "0.11.0",
+  "version": "0.11.1",
   "description": "A command-line interface for Phoenix",
   "keywords": [
     "arize",