@phaseo/devtools-viewer 0.2.1 → 0.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Phaseo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,5 +1,323 @@
-# Phaseo DevTools Viewer
+# @phaseo/devtools-viewer
 
-Phaseo is the new name for AI Stats.
+Web-based viewer for Phaseo DevTools telemetry data.
 
-This package reserves `@phaseo/devtools-viewer` and forwards to the current DevTools viewer from `@ai-stats/devtools-viewer` during the package migration.
+## Overview
+
+The DevTools Viewer provides a beautiful, real-time web interface for inspecting API requests captured by Phaseo SDKs. It features:
+
+- **Live telemetry updates** - Auto-refreshes every 2 seconds
+- **Adaptive UI** - Different views for chat, images, audio, video, etc.
+- **Analytics dashboard** - Aggregate stats by endpoint, model, cost, tokens
+- **Export functionality** - Export telemetry as JSON or JSONL
+
+## Installation
+
+```bash
+npm install @phaseo/sdk
+# or
+pnpm add @phaseo/sdk
+```
+
+The DevTools CLI ships with the TypeScript SDK. You can also install it separately:
+
+```bash
+npm install -g @phaseo/devtools-viewer
+# or
+pnpm add -g @phaseo/devtools-viewer
+# or
+npx @phaseo/devtools-viewer start
+```
+
+## Usage
+
+### Start the Viewer
+
+```bash
+# Start with defaults (port 4983, directory .phaseo-devtools)
+phaseo-devtools start
+
+# Custom port
+phaseo-devtools start -p 3000
+
+# Custom directory
+phaseo-devtools start -d /path/to/devtools
+
+# Both
+phaseo-devtools start -p 8080 -d ./my-devtools
+
+# If installed locally (recommended)
+pnpm exec phaseo-devtools start
+```
+
+Then open http://localhost:4983 in your browser.
+
+### Environment Variables
+
+```bash
+# Set devtools directory
+export PHASEO_DEVTOOLS_DIR=/path/to/devtools
+
+# Set port
+export PORT=3000
+
+# Start server
+phaseo-devtools start
+```
+
+## Features
+
+### Generations View
+
+- **Sidebar list** - All captured API requests sorted by timestamp
+- **Adaptive detail view** - Specialized views for different endpoint types:
+  - **Chat Completions** - Messages, tool calls, reasoning blocks
+  - **Images** - Generated images, prompts, revised prompts
+  - **Audio** - Audio player, transcriptions, translations
+  - **Video** - Video player, generation parameters
+  - **Generic** - JSON view for all other endpoints
+- **Error highlighting** - Failed requests clearly marked
+- **Metadata display** - Model, provider, duration, cost, tokens
+
+### Stats Dashboard
+
+- **Overview cards** - Total requests, cost, tokens, avg duration
+- **By Endpoint table** - Breakdown by endpoint type
+- **By Model table** - Breakdown by model
+- **Error rate tracking** - Monitor API failures
+- **Export buttons** - Download data as JSON or JSONL
+
+### Real-time Updates
+
+The viewer automatically polls for new telemetry every 2 seconds, so you see API requests appear in real-time as your application makes them.
+
+## API Endpoints
+
+The viewer exposes these HTTP endpoints:
+
+- `GET /api/generations` - Get all generations (with filtering)
+- `GET /api/generations/:id` - Get specific generation
+- `GET /api/stats` - Get aggregate statistics
+- `GET /api/metadata` - Get session metadata
+- `GET /api/export?format=json|jsonl` - Export telemetry
+- `GET /assets/*` - Serve binary assets (images, audio, video)
+
+### Query Parameters for `/api/generations`
+
+```bash
+# Filter by endpoint type
+/api/generations?type=chat.completions
+
+# Filter by model
+/api/generations?model=gpt-4
+
+# Filter errors only
+/api/generations?hasError=true
+
+# Pagination
+/api/generations?limit=50&offset=100
+```
+
+## Development
+
+### Build
+
+```bash
+# Build server
+pnpm run build:server
+
+# Build UI
+pnpm run build:ui
+
+# Build both
+pnpm run build
+```
+
+### Development Mode
+
+```bash
+# Run both server and UI with hot reloading
+pnpm run dev
+```
+
+This will:
+1. Start the API server on port 4984 with auto-restart on changes
+2. Start the Vite dev server on port 4983 with HMR (Hot Module Replacement)
+3. Proxy all `/api` requests from the UI to the server
+
+**How it works:**
+- UI changes reload instantly in the browser (React Fast Refresh)
+- Server changes trigger an automatic restart
+- No need to rebuild or manually refresh
+
+**Accessing the dev environment:**
+- Open http://localhost:4983 in your browser
+- Check the console for any errors
+- Server logs appear in the terminal
+
+**Troubleshooting:**
+- If port 4984 is busy, the server won't start. Kill the process or change the port.
+- If port 4983 is busy, the UI dev server won't start. Same solution.
+- If you see `ENOENT` errors, make sure `.phaseo-devtools` directory exists with sample data
+- Check browser DevTools console (F12) for client-side errors
+- Check terminal output for server-side errors
+
+## Architecture
+
+### Tech Stack
+
+- **Server**: Hono (fast web framework)
+- **UI**: React + TanStack Query
+- **Styling**: Tailwind CSS
+- **Build**: Vite (UI) + TypeScript (server)
+
+### File Structure
+
+```
+packages/devtools/devtools-viewer/
+├── src/
+│   ├── server/           # Hono server
+│   │   └── index.ts      # API routes, static serving
+│   ├── ui/               # React frontend
+│   │   ├── components/   # UI components
+│   │   │   ├── endpoints/  # Endpoint-specific views
+│   │   │   ├── GenerationsList.tsx
+│   │   │   ├── GenerationDetail.tsx
+│   │   │   └── StatsOverview.tsx
+│   │   ├── App.tsx       # Main app
+│   │   ├── main.tsx      # Entry point
+│   │   └── index.css     # Tailwind styles
+│   └── cli/              # CLI tool
+│       └── index.ts      # Command-line interface
+├── public/               # Built UI assets
+└── dist/                 # Compiled server code
+```
+
+## Telemetry Format
+
+The viewer reads JSONL (JSON Lines) files from the devtools directory:
+
+```
+.phaseo-devtools/
+├── generations.jsonl     # Main telemetry log
+├── metadata.json         # Session info
+└── assets/               # Binary assets
+    ├── images/{uuid}.png
+    ├── audio/{uuid}.mp3
+    └── video/{uuid}.mp4
+```
+
+Each line in `generations.jsonl` is a JSON object with this structure:
+
+```typescript
+{
+  id: string;
+  type: "chat.completions" | "images.generations" | ...;
+  timestamp: number;
+  duration_ms: number;
+  request: { ... };
+  response: { ... } | null;
+  error: { message: string } | null;
+  metadata: {
+    sdk: "typescript" | "python" | ...;
+    sdk_version: string;
+    stream: boolean;
+    usage?: { ... };
+    cost?: { ... };
+    model?: string;
+    provider?: string;
+  };
+}
+```
+
+## Troubleshooting
+
+### Blank Screen When Clicking on Generations
+
+If the screen goes blank when you click on a generation:
+
+1. **Open Browser DevTools** (F12) and check the Console tab for errors
+2. **Check the Network tab** to see if the API call to `/api/generations/{id}` is failing
+3. **Look for component errors** - the ErrorBoundary will now show detailed error messages
+4. **Check data format** - ensure your generations.jsonl has valid JSON on each line
+5. **Try the "Try Again" button** that appears after errors
+
+Recent fixes:
+- Added comprehensive error boundaries with stack traces
+- Improved null checking in all view components
+- Added debug logging to identify rendering issues
+
+### Dev Server Issues
+
+**Port conflicts:**
+```bash
+# Find and kill processes on ports 4983/4984
+# On Windows:
+netstat -ano | findstr :4983
+taskkill /PID <pid> /F
+
+# On Linux/Mac:
+lsof -ti:4983 | xargs kill -9
+```
+
+**Missing dependencies:**
+```bash
+cd packages/devtools/devtools-viewer
+pnpm install
+```
+
+**Stale build artifacts:**
+```bash
+pnpm run clean
+pnpm run build
+```
+
+### No Data Showing
+
+1. **Check devtools directory exists:**
+   ```bash
+   ls -la .phaseo-devtools/
+   ```
+
+2. **Verify files are present:**
+   - `generations.jsonl` should exist and have content
+   - `metadata.json` should exist
+
+3. **Test with sample data:**
+   ```bash
+   # Create test entry
+   echo '{"id":"test-1","type":"chat.completions","timestamp":1234567890,"duration_ms":100,"request":{"messages":[{"role":"user","content":"test"}]},"response":null,"error":null,"metadata":{"sdk":"test"}}' >> .phaseo-devtools/generations.jsonl
+   ```
+
+## Quick Development Workflow
+
+```bash
+# 1. Navigate to devtools viewer
+cd packages/devtools/devtools-viewer
+
+# 2. Install dependencies (if needed)
+pnpm install
+
+# 3. Start dev servers
+pnpm run dev
+
+# 4. Open browser
+# Navigate to http://localhost:4983
+
+# 5. Make changes to components
+# - Edit files in src/ui/components/
+# - Changes reflect immediately (Hot Module Replacement)
+# - No need to rebuild or refresh
+
+# 6. Check for errors
+# - Browser console (F12 → Console)
+# - Terminal output (server logs)
+
+# 7. Test with real data
+# - Run your app with Phaseo SDK
+# - Watch requests appear in real-time
+```
+
+## License
+
+MIT

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import { startServer } from "../server/index.js";
+import * as process from "process";
+const args = process.argv.slice(2);
+const command = args[0] || "start";
+function printHelp() {
+    console.log(`
+Phaseo DevTools Viewer
+
+Usage:
+  phaseo-devtools [command] [options]
+
+Commands:
+  start              Start the devtools viewer server (default)
+  help               Show this help message
+
+Options:
+  -p, --port <port>  Port to run the server on (default: 4983)
+  -d, --dir <path>   Path to devtools directory (default: .phaseo-devtools)
+  -h, --help         Show this help message
+
+Examples:
+  phaseo-devtools start
+  phaseo-devtools start -p 3000
+  phaseo-devtools start -d /path/to/devtools
+  phaseo-devtools --port 8080 --dir ./my-devtools
+
+Environment Variables:
+  PHASEO_DEVTOOLS_DIR  Path to devtools directory
+  PORT                   Port to run the server on
+`);
+}
+function parseArgs() {
+    const config = {
+        port: parseInt(process.env.PORT || "4983", 10),
+        directory: process.env.PHASEO_DEVTOOLS_DIR || ".phaseo-devtools"
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "-h" || arg === "--help") {
+            printHelp();
+            process.exit(0);
+        }
+        if (arg === "-p" || arg === "--port") {
+            config.port = parseInt(args[++i], 10);
+            if (isNaN(config.port)) {
+                console.error("Error: Port must be a number");
+                process.exit(1);
+            }
+        }
+        if (arg === "-d" || arg === "--dir" || arg === "--directory") {
+            config.directory = args[++i];
+            if (!config.directory) {
+                console.error("Error: Directory path is required");
+                process.exit(1);
+            }
+        }
+    }
+    return config;
+}
+async function main() {
+    if (command === "help" || command === "--help" || command === "-h") {
+        printHelp();
+        return;
+    }
+    if (command === "start" || !command || command.startsWith("-")) {
+        const config = parseArgs();
+        // Set environment variables for the server
+        process.env.PHASEO_DEVTOOLS_DIR = config.directory;
+        process.env.PORT = config.port.toString();
+        startServer(config.port);
+        return;
+    }
+    console.error(`Unknown command: ${command}`);
+    console.error('Run "phaseo-devtools help" for usage information');
+    process.exit(1);
+}
+main().catch((error) => {
+    console.error("Error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/core.d.ts

@@ -0,0 +1,118 @@
+export type EndpointType = "chat.completions" | "messages" | "images.generations" | "images.edits" | "audio.speech" | "audio.transcriptions" | "audio.translations" | "video.generations" | "video.list" | "video.retrieve" | "video.cancel" | "music.generations" | "music.retrieve" | "embeddings" | "ocr" | "rerank" | "moderations" | "responses" | "responses.websocket" | "batches.create" | "batches.retrieve" | "batches.cancel" | "files.list" | "files.retrieve" | "files.upload" | "endpoints.list" | "organisations.list" | "pricing.models" | "pricing.calculate" | "key.current" | "models.list" | "providers" | "providers.derank" | "credits" | "activity" | "health" | "analytics" | "generations.retrieve" | "provisioning.keys.list" | "provisioning.keys.create" | "provisioning.keys.get" | "provisioning.keys.update" | "provisioning.keys.delete" | "provisioning.workspaces.list" | "provisioning.workspaces.get" | "provisioning.workspaces.create" | "provisioning.workspaces.update" | "provisioning.workspaces.delete" | "agent.run" | "agent.continue";
+export type SdkIdentifier = "typescript" | "python" | "go" | "csharp" | "ruby" | "php" | "java" | "rust" | "cpp";
+export type ErrorInfo = {
+    message: string;
+    code?: string;
+    status?: number;
+    stack?: string;
+};
+export type UsageInfo = {
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    images_generated?: number;
+    audio_seconds?: number;
+    video_seconds?: number;
+    cache_creation_input_tokens?: number;
+    cache_read_input_tokens?: number;
+};
+export type CostInfo = {
+    input_cost?: number;
+    output_cost?: number;
+    cache_creation_cost?: number;
+    cache_read_cost?: number;
+    total_cost: number;
+};
+export type ProviderAttempt = {
+    provider: string;
+    provider_label?: string;
+    request_id?: string;
+    status_code?: number;
+    status_text?: string;
+    outcome?: string;
+    duration_ms?: number;
+    latency_ms?: number;
+    generation_ms?: number;
+    throughput?: number;
+    started_at?: number;
+    completed_at?: number;
+    error_code?: string;
+    error_message?: string;
+};
+export type Metadata = {
+    sdk: SdkIdentifier;
+    sdk_version: string;
+    stream: boolean;
+    chunk_count?: number;
+    usage?: UsageInfo;
+    cost?: CostInfo;
+    model?: string;
+    provider?: string;
+    request_id?: string;
+    session_id?: string;
+    upstream_request_id?: string;
+    native_response_id?: string;
+    status_code?: number;
+    latency_ms?: number;
+    generation_ms?: number;
+    throughput?: number;
+    finish_reason?: string;
+    pricing_lines?: Array<Record<string, any> | string | number | boolean | null>;
+    provider_attempts?: ProviderAttempt[];
+    agent_id?: string;
+    run_id?: string;
+    run_status?: string;
+    step_count?: number;
+    tool_count?: number;
+    headers?: Record<string, string>;
+};
+export type DevToolsEntry = {
+    id: string;
+    type: EndpointType;
+    timestamp: number;
+    duration_ms: number;
+    request: Record<string, any>;
+    response: Record<string, any> | null;
+    error: ErrorInfo | null;
+    metadata: Metadata;
+};
+export type SessionMetadata = {
+    session_id: string;
+    started_at: number;
+    sdk: SdkIdentifier;
+    sdk_version: string;
+    platform?: string;
+    node_version?: string;
+};
+export type Stats = {
+    total_requests: number;
+    total_errors: number;
+    total_cost: number;
+    total_tokens: number;
+    total_duration_ms: number;
+    by_endpoint: Record<string, {
+        count: number;
+        errors: number;
+        avg_duration_ms: number;
+        total_cost: number;
+    }>;
+    by_model: Record<string, {
+        count: number;
+        tokens: number;
+        cost: number;
+    }>;
+};
+export declare class DevToolsWriter {
+    private readonly directory;
+    private readonly generationsFile;
+    private readonly metadataFile;
+    private readonly assetsDir;
+    constructor(directory?: string);
+    ensureDirectory(): void;
+    writeEntry(entry: DevToolsEntry): void;
+    writeEntries(entries: DevToolsEntry[]): void;
+    writeSessionMetadata(metadata: SessionMetadata): void;
+    readEntries(): DevToolsEntry[];
+    readSessionMetadata(): SessionMetadata | null;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

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

package/dist/core.js

@@ -0,0 +1,55 @@
+import * as fs from "fs";
+import * as path from "path";
+export class DevToolsWriter {
+    directory;
+    generationsFile;
+    metadataFile;
+    assetsDir;
+    constructor(directory = ".phaseo-devtools") {
+        this.directory = directory;
+        this.generationsFile = path.join(directory, "generations.jsonl");
+        this.metadataFile = path.join(directory, "metadata.json");
+        this.assetsDir = path.join(directory, "assets");
+    }
+    ensureDirectory() {
+        if (!fs.existsSync(this.directory)) {
+            fs.mkdirSync(this.directory, { recursive: true });
+        }
+        if (!fs.existsSync(this.assetsDir)) {
+            fs.mkdirSync(path.join(this.assetsDir, "images"), { recursive: true });
+            fs.mkdirSync(path.join(this.assetsDir, "audio"), { recursive: true });
+            fs.mkdirSync(path.join(this.assetsDir, "video"), { recursive: true });
+        }
+    }
+    writeEntry(entry) {
+        this.ensureDirectory();
+        const line = JSON.stringify(entry) + "\n";
+        fs.appendFileSync(this.generationsFile, line, "utf-8");
+    }
+    writeEntries(entries) {
+        if (entries.length === 0)
+            return;
+        this.ensureDirectory();
+        const lines = entries.map((entry) => JSON.stringify(entry) + "\n").join("");
+        fs.appendFileSync(this.generationsFile, lines, "utf-8");
+    }
+    writeSessionMetadata(metadata) {
+        this.ensureDirectory();
+        fs.writeFileSync(this.metadataFile, JSON.stringify(metadata, null, 2), "utf-8");
+    }
+    readEntries() {
+        if (!fs.existsSync(this.generationsFile)) {
+            return [];
+        }
+        const content = fs.readFileSync(this.generationsFile, "utf-8");
+        const lines = content.split("\n").filter((line) => line.trim());
+        return lines.map((line) => JSON.parse(line));
+    }
+    readSessionMetadata() {
+        if (!fs.existsSync(this.metadataFile)) {
+            return null;
+        }
+        return JSON.parse(fs.readFileSync(this.metadataFile, "utf-8"));
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/server/index.d.ts

@@ -0,0 +1,8 @@
+import { Hono } from "hono";
+declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+/**
+ * Start server
+ */
+export declare function startServer(port?: number): void;
+export { app };
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAQ5B,QAAA,MAAM,GAAG,4EAAa,CAAC;AAqQvB;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,GAAE,MAAqB,QAuBtD;AAsBD,OAAO,EAAE,GAAG,EAAE,CAAC"}