npm - @cephalization/phoenix-insight - Versions diffs - 0.4.0 → 1.0.2 - Mend

@cephalization/phoenix-insight 0.4.0 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (76) hide show

package/README.md +195 -1
package/dist/chunk-KEQDYZIE.js +237 -0
package/dist/chunk-KEQDYZIE.js.map +1 -0
package/dist/cli.d.ts +1 -0
package/dist/cli.js +3950 -642
package/dist/cli.js.map +1 -0
package/dist/index.d.ts +108 -0
package/dist/index.js +13 -1
package/dist/index.js.map +1 -0
package/dist/ui/assets/code-block-F6WJLWQG-BTdTzfvl.js +154 -0
package/dist/ui/assets/code-block-F6WJLWQG-BTdTzfvl.js.map +1 -0
package/dist/ui/assets/index-CX8aDatf.css +1 -0
package/dist/ui/assets/index-DjZuAW6Y.js +63 -0
package/dist/ui/assets/index-DjZuAW6Y.js.map +1 -0
package/dist/ui/assets/vendor-data-r1ZEkUds.js +40 -0
package/dist/ui/assets/vendor-data-r1ZEkUds.js.map +1 -0
package/dist/ui/assets/vendor-react-Cgg2GOmP.js +2 -0
package/dist/ui/assets/vendor-react-Cgg2GOmP.js.map +1 -0
package/dist/ui/assets/vendor-render-DoMl5bum.js +381 -0
package/dist/ui/assets/vendor-render-DoMl5bum.js.map +1 -0
package/dist/ui/assets/vendor-ui-Cg-YC4hK.js +46 -0
package/dist/ui/assets/vendor-ui-Cg-YC4hK.js.map +1 -0
package/dist/ui/index.html +18 -0
package/dist/ui/vite.svg +1 -0
package/package.json +14 -15
package/dist/agent/index.js +0 -230
package/dist/commands/index.js +0 -2
package/dist/commands/px-fetch-more-spans.js +0 -98
package/dist/commands/px-fetch-more-trace.js +0 -110
package/dist/config/index.js +0 -165
package/dist/config/loader.js +0 -141
package/dist/config/schema.js +0 -53
package/dist/modes/index.js +0 -17
package/dist/modes/local.js +0 -134
package/dist/modes/sandbox.js +0 -121
package/dist/modes/types.js +0 -1
package/dist/observability/index.js +0 -65
package/dist/progress.js +0 -209
package/dist/prompts/index.js +0 -1
package/dist/prompts/system.js +0 -30
package/dist/snapshot/client.js +0 -74
package/dist/snapshot/context.js +0 -441
package/dist/snapshot/datasets.js +0 -68
package/dist/snapshot/experiments.js +0 -135
package/dist/snapshot/index.js +0 -262
package/dist/snapshot/projects.js +0 -44
package/dist/snapshot/prompts.js +0 -199
package/dist/snapshot/spans.js +0 -104
package/dist/snapshot/utils.js +0 -112
package/dist/tsconfig.esm.tsbuildinfo +0 -1
package/src/agent/index.ts +0 -323
package/src/cli.ts +0 -854
package/src/commands/index.ts +0 -8
package/src/commands/px-fetch-more-spans.ts +0 -174
package/src/commands/px-fetch-more-trace.ts +0 -183
package/src/config/index.ts +0 -225
package/src/config/loader.ts +0 -173
package/src/config/schema.ts +0 -66
package/src/index.ts +0 -1
package/src/modes/index.ts +0 -21
package/src/modes/local.ts +0 -163
package/src/modes/sandbox.ts +0 -144
package/src/modes/types.ts +0 -31
package/src/observability/index.ts +0 -90
package/src/progress.ts +0 -239
package/src/prompts/index.ts +0 -1
package/src/prompts/system.ts +0 -31
package/src/snapshot/client.ts +0 -129
package/src/snapshot/context.ts +0 -587
package/src/snapshot/datasets.ts +0 -132
package/src/snapshot/experiments.ts +0 -246
package/src/snapshot/index.ts +0 -403
package/src/snapshot/projects.ts +0 -58
package/src/snapshot/prompts.ts +0 -267
package/src/snapshot/spans.ts +0 -163
package/src/snapshot/utils.ts +0 -140

package/dist/ui/index.html ADDED Viewed

@@ -0,0 +1,18 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="./vite.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>ui</title>
+    <script type="module" crossorigin src="./assets/index-DjZuAW6Y.js"></script>
+    <link rel="modulepreload" crossorigin href="./assets/vendor-react-Cgg2GOmP.js">
+    <link rel="modulepreload" crossorigin href="./assets/vendor-ui-Cg-YC4hK.js">
+    <link rel="modulepreload" crossorigin href="./assets/vendor-data-r1ZEkUds.js">
+    <link rel="modulepreload" crossorigin href="./assets/vendor-render-DoMl5bum.js">
+    <link rel="stylesheet" crossorigin href="./assets/index-CX8aDatf.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/dist/ui/vite.svg ADDED Viewed

@@ -0,0 +1 @@

+ <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cephalization/phoenix-insight",
-  "version": "0.4.0",
+  "version": "1.0.2",
   "description": "A CLI for Arize AI Phoenix data analysis with AI agents",
   "type": "module",
   "exports": {
@@ -17,9 +17,7 @@
     "access": "public"
   },
   "files": [
-    "dist",
-    "src",
-    "package.json"
+    "dist"
   ],
   "keywords": [
     "phoenix",
@@ -29,12 +27,13 @@
     "llmops",
     "ai"
   ],
-  "author": "oss@arize.com",
+  "author": "Tony Powell <powell.anthonyd@proton.me>",
   "license": "Apache-2.0",
-  "homepage": "https://github.com/cephalization/phoenix-insight#readme",
+  "homepage": "https://github.com/cephalization/phoenix-insight/tree/main/packages/cli#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/cephalization/phoenix-insight.git"
+    "url": "git+https://github.com/cephalization/phoenix-insight.git",
+    "directory": "packages/cli"
   },
   "bugs": {
     "url": "https://github.com/cephalization/phoenix-insight/issues"
@@ -49,26 +48,26 @@
     "commander": "^12.0.0",
     "just-bash": "^2.2.0",
     "ora": "^9.0.0",
+    "ws": "^8.19.0",
     "zod": "^4.3.5"
   },
   "devDependencies": {
-    "@changesets/cli": "^2.29.8",
     "@faker-js/faker": "^10.2.0",
-    "@types/node": "^18.19.0",
+    "@types/ws": "^8.18.1",
     "msw": "^2.12.7",
-    "rimraf": "^5.0.10",
     "tsc-alias": "^1.8.11",
-    "tsx": "^4.21.0",
-    "typescript": "^5.8.2",
-    "vitest": "^2.1.9"
+    "tsup": "^8.5.1",
+    "@cephalization/phoenix-insight-ui": "1.0.0"
   },
   "engines": {
     "node": ">=18"
   },
   "scripts": {
     "clean": "rimraf dist tsconfig.esm.tsbuildinfo tsconfig.tsbuildinfo",
-    "prebuild": "pnpm run clean",
-    "build": "tsc --build tsconfig.esm.json",
+    "prebuild": "pnpm run clean && pnpm run verify-ui-dist",
+    "verify-ui-dist": "node -e \"const fs = require('fs'); const path = require('path'); const uiDist = path.resolve(__dirname, '../ui/dist/index.html'); if (!fs.existsSync(uiDist)) { console.error('ERROR: UI dist not found. Build UI package first with: pnpm --filter @cephalization/phoenix-insight-ui build'); process.exit(1); } console.log('UI dist verified:', uiDist);\"",
+    "build": "tsup && pnpm run copy-ui-dist",
+    "copy-ui-dist": "node -e \"const fs = require('fs'); const path = require('path'); const src = path.resolve(__dirname, '../ui/dist'); const dest = path.resolve(__dirname, 'dist/ui'); fs.cpSync(src, dest, { recursive: true }); console.log('UI dist copied to:', dest);\"",
     "start": "node dist/cli.js",
     "dev": "tsx src/cli.ts",
     "typecheck": "tsc --noEmit",

package/dist/agent/index.js DELETED Viewed

@@ -1,230 +0,0 @@
-/**
- * Phoenix Insight AI agent setup using Vercel AI SDK
- */
-import { generateText, streamText, tool, stepCountIs, } from "ai";
-import { anthropic } from "@ai-sdk/anthropic";
-import { z } from "zod";
-import { INSIGHT_SYSTEM_PROMPT } from "../prompts/system.js";
-import { fetchMoreSpans, fetchMoreTrace, } from "../commands/index.js";
-import { PhoenixClientError } from "../snapshot/client.js";
-/**
- * Phoenix Insight Agent
- */
-export class PhoenixInsightAgent {
-    mode;
-    client;
-    maxSteps;
-    tools = null;
-    model = anthropic("claude-sonnet-4-5");
-    constructor(config) {
-        this.mode = config.mode;
-        this.client = config.client;
-        this.maxSteps = config.maxSteps || 25;
-    }
-    /**
-     * Initialize the agent tools
-     */
-    async initializeTools() {
-        if (this.tools)
-            return this.tools;
-        // Get the bash tool from the execution mode
-        const bashTool = await this.mode.getBashTool();
-        // Store references in closure for the custom tools
-        const client = this.client;
-        const mode = this.mode;
-        // Create custom px-fetch-more-spans tool using AI SDK's tool function
-        const pxFetchMoreSpans = tool({
-            description: "Fetch additional spans from Phoenix. Use when you need more span data than what's in the snapshot. You must provide both project name and optionally a limit.",
-            inputSchema: z.object({
-                project: z.string().describe("The project name"),
-                limit: z
-                    .number()
-                    .optional()
-                    .describe("Number of spans to fetch (default: 500)"),
-                startTime: z
-                    .string()
-                    .optional()
-                    .describe("Start time filter in ISO format"),
-                endTime: z
-                    .string()
-                    .optional()
-                    .describe("End time filter in ISO format"),
-            }),
-            execute: async (params) => {
-                try {
-                    const options = {
-                        project: params.project,
-                        limit: params.limit || 500,
-                        startTime: params.startTime,
-                        endTime: params.endTime,
-                    };
-                    await fetchMoreSpans(client, mode, options);
-                    return {
-                        success: true,
-                        message: `Fetched additional spans for project ${params.project}. Data saved to /phoenix/projects/${params.project}/spans/`,
-                    };
-                }
-                catch (error) {
-                    return {
-                        success: false,
-                        error: error instanceof Error ? error.message : String(error),
-                    };
-                }
-            },
-        });
-        // Create custom px-fetch-more-trace tool using AI SDK's tool function
-        const pxFetchMoreTrace = tool({
-            description: "Fetch a specific trace by ID from Phoenix. Use when you need to examine a particular trace in detail. You must provide both the trace ID and the project name.",
-            inputSchema: z.object({
-                traceId: z.string().describe("The trace ID to fetch"),
-                project: z.string().describe("The project name to search in"),
-            }),
-            execute: async (params) => {
-                try {
-                    const options = {
-                        traceId: params.traceId,
-                        project: params.project,
-                    };
-                    await fetchMoreTrace(client, mode, options);
-                    return {
-                        success: true,
-                        message: `Fetched trace ${params.traceId}. Data saved to /phoenix/traces/${params.traceId}/`,
-                    };
-                }
-                catch (error) {
-                    return {
-                        success: false,
-                        error: error instanceof Error ? error.message : String(error),
-                    };
-                }
-            },
-        });
-        this.tools = {
-            bash: bashTool,
-            px_fetch_more_spans: pxFetchMoreSpans,
-            px_fetch_more_trace: pxFetchMoreTrace,
-        };
-        return this.tools;
-    }
-    /**
-     * Generate a response for a user query
-     */
-    async generate(userQuery, options) {
-        let tools;
-        try {
-            tools = await this.initializeTools();
-        }
-        catch (error) {
-            throw new Error(`Failed to initialize agent tools: ${error instanceof Error ? error.message : String(error)}`);
-        }
-        try {
-            const result = await generateText({
-                model: this.model,
-                system: INSIGHT_SYSTEM_PROMPT,
-                prompt: userQuery,
-                tools,
-                stopWhen: stepCountIs(this.maxSteps),
-                onStepFinish: options?.onStepFinish,
-                experimental_telemetry: {
-                    isEnabled: true,
-                },
-            });
-            return result;
-        }
-        catch (error) {
-            // Check for specific AI SDK errors
-            if (error instanceof Error) {
-                if (error.message.includes("rate limit")) {
-                    throw new Error("AI model rate limit exceeded. Please wait and try again.");
-                }
-                if (error.message.includes("timeout")) {
-                    throw new Error("AI model request timed out. Please try again.");
-                }
-                if (error.message.includes("authentication") ||
-                    error.message.includes("API key")) {
-                    throw new Error("AI model authentication failed. Check your API key configuration.");
-                }
-            }
-            throw new Error(`AI generation failed: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    /**
-     * Stream a response for a user query
-     */
-    async stream(userQuery, options) {
-        let tools;
-        try {
-            tools = await this.initializeTools();
-        }
-        catch (error) {
-            throw new Error(`Failed to initialize agent tools: ${error instanceof Error ? error.message : String(error)}`);
-        }
-        try {
-            const result = streamText({
-                model: this.model,
-                system: INSIGHT_SYSTEM_PROMPT,
-                prompt: userQuery,
-                tools,
-                stopWhen: stepCountIs(this.maxSteps),
-                onStepFinish: options?.onStepFinish,
-                experimental_telemetry: {
-                    isEnabled: true,
-                },
-            });
-            return result;
-        }
-        catch (error) {
-            // Check for specific AI SDK errors
-            if (error instanceof Error) {
-                if (error.message.includes("rate limit")) {
-                    throw new Error("AI model rate limit exceeded. Please wait and try again.");
-                }
-                if (error.message.includes("timeout")) {
-                    throw new Error("AI model request timed out. Please try again.");
-                }
-                if (error.message.includes("authentication") ||
-                    error.message.includes("API key")) {
-                    throw new Error("AI model authentication failed. Check your API key configuration.");
-                }
-            }
-            throw new Error(`AI streaming failed: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    /**
-     * Clean up resources
-     */
-    async cleanup() {
-        await this.mode.cleanup();
-    }
-}
-/**
- * Creates a Phoenix Insight agent
- */
-export async function createInsightAgent(config) {
-    return new PhoenixInsightAgent(config);
-}
-/**
- * Run a query with the Phoenix Insight agent
- */
-export async function runQuery(agent, userQuery, options) {
-    const { stream = false, ...callbacks } = options || {};
-    if (stream) {
-        return await agent.stream(userQuery, callbacks);
-    }
-    else {
-        return await agent.generate(userQuery, callbacks);
-    }
-}
-/**
- * Create and run a one-shot query
- */
-export async function runOneShotQuery(config, userQuery, options) {
-    const agent = await createInsightAgent(config);
-    try {
-        const result = await runQuery(agent, userQuery, options);
-        return result;
-    }
-    finally {
-        await agent.cleanup();
-    }
-}

package/dist/commands/index.js DELETED Viewed

	@@ -1,2 +0,0 @@
1	- export { fetchMoreSpans, } from "./px-fetch-more-spans.js";
2	- export { fetchMoreTrace, } from "./px-fetch-more-trace.js";

package/dist/commands/px-fetch-more-spans.js DELETED Viewed

@@ -1,98 +0,0 @@
-import { withErrorHandling } from "../snapshot/client.js";
-/**
- * Fetches additional spans for a specific project on-demand
- *
- * @param client - Phoenix client instance
- * @param mode - Execution mode for file operations
- * @param options - Options for fetching spans
- */
-export async function fetchMoreSpans(client, mode, options) {
-    const { project, limit, startTime, endTime } = options;
-    await withErrorHandling(async () => {
-        // Try to read existing metadata to get the last cursor
-        let existingMetadata = null;
-        let existingSpans = [];
-        try {
-            const metadataResult = await mode.exec(`cat /phoenix/projects/${project}/spans/metadata.json`);
-            if (metadataResult.exitCode === 0 && metadataResult.stdout) {
-                existingMetadata = JSON.parse(metadataResult.stdout);
-            }
-        }
-        catch (error) {
-            // Metadata doesn't exist, that's okay
-        }
-        // Try to read existing spans
-        try {
-            const spansResult = await mode.exec(`cat /phoenix/projects/${project}/spans/index.jsonl`);
-            if (spansResult.exitCode === 0 && spansResult.stdout) {
-                existingSpans = spansResult.stdout
-                    .trim()
-                    .split("\n")
-                    .filter((line) => line.length > 0)
-                    .map((line) => JSON.parse(line));
-            }
-        }
-        catch (error) {
-            // Spans file doesn't exist, that's okay
-        }
-        // Fetch new spans
-        const newSpans = [];
-        let cursor = existingMetadata?.lastCursor ?? null;
-        let totalFetched = 0;
-        while (totalFetched < limit) {
-            const query = {
-                limit: Math.min(100, limit - totalFetched), // Fetch in chunks of 100
-            };
-            if (cursor) {
-                query.cursor = cursor;
-            }
-            if (startTime) {
-                query.start_time =
-                    startTime instanceof Date ? startTime.toISOString() : startTime;
-            }
-            if (endTime) {
-                query.end_time =
-                    endTime instanceof Date ? endTime.toISOString() : endTime;
-            }
-            const response = await client.GET("/v1/projects/{project_identifier}/spans", {
-                params: {
-                    path: {
-                        project_identifier: project,
-                    },
-                    query,
-                },
-            });
-            if (response.error)
-                throw response.error;
-            const data = response.data?.data ?? [];
-            newSpans.push(...data);
-            totalFetched += data.length;
-            cursor = response.data?.next_cursor ?? null;
-            // Stop if there's no more data
-            if (!cursor || data.length === 0) {
-                break;
-            }
-        }
-        // Combine existing and new spans
-        const allSpans = [...existingSpans, ...newSpans];
-        // Write updated spans to JSONL file
-        const jsonlContent = allSpans
-            .map((span) => JSON.stringify(span))
-            .join("\n");
-        await mode.writeFile(`/phoenix/projects/${project}/spans/index.jsonl`, jsonlContent);
-        // Update metadata
-        const metadata = {
-            project,
-            spanCount: allSpans.length,
-            startTime: startTime instanceof Date
-                ? startTime.toISOString()
-                : (startTime ?? null),
-            endTime: endTime instanceof Date ? endTime.toISOString() : (endTime ?? null),
-            snapshotTime: new Date().toISOString(),
-            lastCursor: cursor,
-        };
-        await mode.writeFile(`/phoenix/projects/${project}/spans/metadata.json`, JSON.stringify(metadata, null, 2));
-        console.log(`Fetched ${newSpans.length} additional spans for project "${project}"`);
-        console.log(`Total spans for project: ${allSpans.length}`);
-    }, `fetching more spans for project ${project}`);
-}

package/dist/commands/px-fetch-more-trace.js DELETED Viewed

@@ -1,110 +0,0 @@
-import { withErrorHandling } from "../snapshot/client.js";
-/**
- * Fetches all spans for a specific trace ID
- *
- * @param client - Phoenix client instance
- * @param mode - Execution mode for file operations
- * @param options - Options for fetching trace
- */
-export async function fetchMoreTrace(client, mode, options) {
-    const { traceId, project } = options;
-    await withErrorHandling(async () => {
-        // First, check if the project exists in our snapshot
-        const projectsResult = await mode.exec("cat /phoenix/projects/index.jsonl");
-        if (projectsResult.exitCode !== 0 || !projectsResult.stdout) {
-            console.error("No projects found in snapshot. Run a snapshot first.");
-            return;
-        }
-        const projectNames = projectsResult.stdout
-            .trim()
-            .split("\n")
-            .filter((line) => line.length > 0)
-            .map((line) => JSON.parse(line).name);
-        if (!projectNames.includes(project)) {
-            console.error(`Project "${project}" not found. Available projects: ${projectNames.join(", ")}`);
-            return;
-        }
-        // Fetch all spans that belong to this trace
-        const traceSpans = [];
-        let cursor = null;
-        let totalFetched = 0;
-        console.log(`Fetching trace ${traceId} from project "${project}"...`);
-        // We need to fetch spans in batches and filter by trace_id
-        // Since the API doesn't support direct trace_id filtering
-        while (true) {
-            const query = {
-                limit: 100, // Fetch in chunks
-            };
-            if (cursor) {
-                query.cursor = cursor;
-            }
-            const response = await client.GET("/v1/projects/{project_identifier}/spans", {
-                params: {
-                    path: {
-                        project_identifier: project,
-                    },
-                    query,
-                },
-            });
-            if (response.error)
-                throw response.error;
-            const data = response.data?.data ?? [];
-            totalFetched += data.length;
-            // Filter spans that belong to our trace
-            const matchingSpans = data.filter((span) => span.context.trace_id === traceId);
-            traceSpans.push(...matchingSpans);
-            cursor = response.data?.next_cursor ?? null;
-            // Stop if we found spans for the trace or no more data
-            if (traceSpans.length > 0 || !cursor || data.length === 0) {
-                // If we found some spans, continue until we have all spans from the trace
-                // This is because trace spans might be spread across multiple pages
-                if (traceSpans.length > 0 && cursor && data.length > 0) {
-                    console.log(`Found ${traceSpans.length} spans so far, continuing search...`);
-                    continue;
-                }
-                break;
-            }
-            // Show progress for large datasets
-            if (totalFetched % 1000 === 0) {
-                console.log(`Searched ${totalFetched} spans so far...`);
-            }
-        }
-        if (traceSpans.length === 0) {
-            console.log(`No spans found for trace ${traceId} in project "${project}"`);
-            console.log(`Searched through ${totalFetched} spans. The trace might not exist or might be in a different project.`);
-            return;
-        }
-        // Sort spans by start_time to show them in order
-        traceSpans.sort((a, b) => new Date(a.start_time).getTime() - new Date(b.start_time).getTime());
-        // Write trace spans to a dedicated file
-        const jsonlContent = traceSpans
-            .map((span) => JSON.stringify(span))
-            .join("\n");
-        const traceDir = `/phoenix/traces/${traceId}`;
-        await mode.writeFile(`${traceDir}/spans.jsonl`, jsonlContent);
-        // Create trace metadata
-        const rootSpan = traceSpans.find((span) => !span.parent_id);
-        const firstSpan = traceSpans[0];
-        const lastSpan = traceSpans[traceSpans.length - 1];
-        const metadata = {
-            traceId,
-            project,
-            spanCount: traceSpans.length,
-            rootSpan: rootSpan ? { id: rootSpan.id, name: rootSpan.name } : null,
-            startTime: firstSpan?.start_time || null,
-            endTime: lastSpan?.end_time || null,
-            duration: firstSpan && lastSpan
-                ? new Date(lastSpan.end_time).getTime() -
-                    new Date(firstSpan.start_time).getTime()
-                : 0,
-            snapshotTime: new Date().toISOString(),
-        };
-        await mode.writeFile(`${traceDir}/metadata.json`, JSON.stringify(metadata, null, 2));
-        console.log(`\nSuccessfully fetched trace ${traceId}:`);
-        console.log(`- Project: ${project}`);
-        console.log(`- Spans: ${traceSpans.length}`);
-        console.log(`- Root span: ${rootSpan?.name || "Unknown"}`);
-        console.log(`- Duration: ${(metadata.duration / 1000).toFixed(2)} seconds`);
-        console.log(`\nTrace data saved to: ${traceDir}/`);
-    }, `fetching trace ${traceId}`);
-}