@orka-js/devtools 1.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/collector.ts","../src/server.ts","../src/tracer-hook.ts","../src/index.ts"],"sourcesContent":["import { generateId } from '@orka-js/core';\nimport type {\n  TraceRun,\n  TraceRunType,\n  TraceSession,\n  TraceMetrics,\n  TraceMetadata,\n  TraceEvent,\n  DevToolsConfig,\n} from './types.js';\n\n/**\n * TraceCollector - Collects and manages trace data for DevTools\n */\nexport class TraceCollector {\n  private sessions: Map<string, TraceSession> = new Map();\n  private activeSessionId?: string;\n  private runStack: Map<string, TraceRun[]> = new Map();\n  private maxTraces: number;\n  private retentionMs: number;\n  private listeners: Set<(event: TraceEvent) => void> = new Set();\n\n  constructor(config: DevToolsConfig = {}) {\n    this.maxTraces = config.maxTraces ?? 1000;\n    this.retentionMs = config.retentionMs ?? 24 * 60 * 60 * 1000; // 24 hours\n  }\n\n  /**\n   * Start a new trace session\n   */\n  startSession(name?: string): string {\n    const sessionId = generateId();\n    const session: TraceSession = {\n      id: sessionId,\n      name: name ?? `Session ${this.sessions.size + 1}`,\n      startTime: Date.now(),\n      runs: [],\n    };\n\n    this.sessions.set(sessionId, session);\n    this.activeSessionId = sessionId;\n    this.runStack.set(sessionId, []);\n\n    this.emit({\n      type: 'session:start',\n      timestamp: Date.now(),\n      sessionId,\n    });\n\n    this.cleanup();\n    return sessionId;\n  }\n\n  /**\n   * End the current session\n   */\n  endSession(sessionId?: string): void {\n    const id = sessionId ?? this.activeSessionId;\n    if (!id) return;\n\n    const session = this.sessions.get(id);\n    if (session) {\n      session.endTime = Date.now();\n      this.emit({\n        type: 'session:end',\n        timestamp: Date.now(),\n        sessionId: id,\n      });\n    }\n\n    if (this.activeSessionId === id) {\n      this.activeSessionId = undefined;\n    }\n  }\n\n  /**\n   * Start a new trace run\n   */\n  startRun(\n    type: TraceRunType,\n    name: string,\n    input?: unknown,\n    metadata?: TraceMetadata\n  ): string {\n    const sessionId = this.activeSessionId ?? this.startSession();\n    const session = this.sessions.get(sessionId)!;\n    const stack = this.runStack.get(sessionId)!;\n\n    const run: TraceRun = {\n      id: generateId(),\n      parentId: stack.length > 0 ? stack[stack.length - 1].id : undefined,\n      type,\n      name,\n      startTime: Date.now(),\n      status: 'running',\n      input,\n      metadata,\n      children: [],\n    };\n\n    // Add to parent's children or session root\n    if (stack.length > 0) {\n      stack[stack.length - 1].children.push(run);\n    } else {\n      session.runs.push(run);\n    }\n\n    stack.push(run);\n\n    this.emit({\n      type: 'run:start',\n      timestamp: Date.now(),\n      sessionId,\n      run,\n    });\n\n    return run.id;\n  }\n\n  /**\n   * End a trace run\n   */\n  endRun(runId: string, output?: unknown, metadata?: TraceMetadata): void {\n    const sessionId = this.activeSessionId;\n    if (!sessionId) return;\n\n    const stack = this.runStack.get(sessionId);\n    if (!stack) return;\n\n    const runIndex = stack.findIndex(r => r.id === runId);\n    if (runIndex === -1) return;\n\n    const run = stack[runIndex];\n    run.endTime = Date.now();\n    run.latencyMs = run.endTime - run.startTime;\n    run.status = 'success';\n    run.output = output;\n\n    if (metadata) {\n      run.metadata = { ...run.metadata, ...metadata };\n    }\n\n    // Pop from stack\n    stack.splice(runIndex, 1);\n\n    this.emit({\n      type: 'run:end',\n      timestamp: Date.now(),\n      sessionId,\n      run,\n    });\n  }\n\n  /**\n   * Mark a run as errored\n   */\n  errorRun(runId: string, error: Error | string): void {\n    const sessionId = this.activeSessionId;\n    if (!sessionId) return;\n\n    const stack = this.runStack.get(sessionId);\n    if (!stack) return;\n\n    const runIndex = stack.findIndex(r => r.id === runId);\n    if (runIndex === -1) return;\n\n    const run = stack[runIndex];\n    run.endTime = Date.now();\n    run.latencyMs = run.endTime - run.startTime;\n    run.status = 'error';\n    run.error = error instanceof Error ? error.message : error;\n\n    stack.splice(runIndex, 1);\n\n    this.emit({\n      type: 'run:error',\n      timestamp: Date.now(),\n      sessionId,\n      run,\n      error: run.error,\n    });\n  }\n\n  /**\n   * Get all sessions\n   */\n  getSessions(): TraceSession[] {\n    return Array.from(this.sessions.values());\n  }\n\n  /**\n   * Get a specific session\n   */\n  getSession(sessionId: string): TraceSession | undefined {\n    return this.sessions.get(sessionId);\n  }\n\n  /**\n   * Get metrics for a session or all sessions\n   */\n  getMetrics(sessionId?: string): TraceMetrics {\n    const sessions = sessionId\n      ? [this.sessions.get(sessionId)].filter(Boolean) as TraceSession[]\n      : Array.from(this.sessions.values());\n\n    const metrics: TraceMetrics = {\n      totalRuns: 0,\n      totalLatencyMs: 0,\n      avgLatencyMs: 0,\n      totalTokens: 0,\n      totalCost: 0,\n      errorRate: 0,\n      runsByType: {} as Record<TraceRunType, number>,\n      tokensByModel: {},\n      costByModel: {},\n    };\n\n    let errorCount = 0;\n\n    const processRun = (run: TraceRun) => {\n      metrics.totalRuns++;\n      metrics.totalLatencyMs += run.latencyMs ?? 0;\n\n      if (run.status === 'error') errorCount++;\n\n      // Count by type\n      metrics.runsByType[run.type] = (metrics.runsByType[run.type] ?? 0) + 1;\n\n      // Aggregate token/cost metrics\n      if (run.metadata) {\n        const { totalTokens, cost, model } = run.metadata;\n        if (totalTokens) {\n          metrics.totalTokens += totalTokens;\n          if (model) {\n            metrics.tokensByModel[model] = (metrics.tokensByModel[model] ?? 0) + totalTokens;\n          }\n        }\n        if (cost) {\n          metrics.totalCost += cost;\n          if (model) {\n            metrics.costByModel[model] = (metrics.costByModel[model] ?? 0) + cost;\n          }\n        }\n      }\n\n      // Process children\n      for (const child of run.children) {\n        processRun(child);\n      }\n    };\n\n    for (const session of sessions) {\n      for (const run of session.runs) {\n        processRun(run);\n      }\n    }\n\n    metrics.avgLatencyMs = metrics.totalRuns > 0\n      ? metrics.totalLatencyMs / metrics.totalRuns\n      : 0;\n    metrics.errorRate = metrics.totalRuns > 0\n      ? errorCount / metrics.totalRuns\n      : 0;\n\n    return metrics;\n  }\n\n  /**\n   * Find a run by ID\n   */\n  findRun(runId: string, sessionId?: string): TraceRun | undefined {\n    const sessions = sessionId\n      ? [this.sessions.get(sessionId)].filter(Boolean) as TraceSession[]\n      : Array.from(this.sessions.values());\n\n    const findInRuns = (runs: TraceRun[]): TraceRun | undefined => {\n      for (const run of runs) {\n        if (run.id === runId) return run;\n        const found = findInRuns(run.children);\n        if (found) return found;\n      }\n      return undefined;\n    };\n\n    for (const session of sessions) {\n      const found = findInRuns(session.runs);\n      if (found) return found;\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Subscribe to trace events\n   */\n  subscribe(listener: (event: TraceEvent) => void): () => void {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  /**\n   * Emit an event to all listeners\n   */\n  private emit(event: TraceEvent): void {\n    for (const listener of this.listeners) {\n      try {\n        listener(event);\n      } catch {\n        // Ignore listener errors\n      }\n    }\n  }\n\n  /**\n   * Cleanup old sessions\n   */\n  private cleanup(): void {\n    const now = Date.now();\n    const cutoff = now - this.retentionMs;\n\n    for (const [id, session] of this.sessions) {\n      if (session.endTime && session.endTime < cutoff) {\n        this.sessions.delete(id);\n        this.runStack.delete(id);\n      }\n    }\n\n    // Limit total sessions\n    if (this.sessions.size > this.maxTraces) {\n      const sorted = Array.from(this.sessions.entries())\n        .sort((a, b) => a[1].startTime - b[1].startTime);\n      \n      const toDelete = sorted.slice(0, this.sessions.size - this.maxTraces);\n      for (const [id] of toDelete) {\n        this.sessions.delete(id);\n        this.runStack.delete(id);\n      }\n    }\n  }\n\n  /**\n   * Clear all traces\n   */\n  clear(): void {\n    this.sessions.clear();\n    this.runStack.clear();\n    this.activeSessionId = undefined;\n  }\n\n  /**\n   * Export traces as JSON\n   */\n  export(): string {\n    return JSON.stringify({\n      sessions: Array.from(this.sessions.values()),\n      exportedAt: new Date().toISOString(),\n    }, null, 2);\n  }\n\n  /**\n   * Import traces from JSON\n   */\n  import(json: string): void {\n    const data = JSON.parse(json) as { sessions: TraceSession[] };\n    for (const session of data.sessions) {\n      this.sessions.set(session.id, session);\n    }\n  }\n}\n\n// Global collector instance\nlet globalCollector: TraceCollector | undefined;\n\nexport function getCollector(config?: DevToolsConfig): TraceCollector {\n  if (!globalCollector) {\n    globalCollector = new TraceCollector(config);\n  }\n  return globalCollector;\n}\n\nexport function resetCollector(): void {\n  globalCollector = undefined;\n}\n","import type { TraceCollector } from './collector.js';\nimport type { DevToolsConfig, TraceEvent } from './types.js';\nimport type { Application, Request, Response, NextFunction } from 'express';\nimport type { Server, ServerResponse } from 'http';\n\n/**\n * DevTools Server - Express server for the DevTools dashboard\n */\nexport class DevToolsServer {\n  private collector: TraceCollector;\n  private config: Required<Pick<DevToolsConfig, 'port' | 'host' | 'cors'>>;\n  private server?: Server;\n  private clients: Set<ServerResponse> = new Set();\n\n  constructor(collector: TraceCollector, config: DevToolsConfig = {}) {\n    this.collector = collector;\n    this.config = {\n      port: config.port ?? 3001,\n      host: config.host ?? 'localhost',\n      cors: config.cors ?? true,\n    };\n  }\n\n  /**\n   * Start the DevTools server\n   */\n  async start(): Promise<void> {\n    // Dynamic import for optional express dependency\n    let expressModule: { default: () => Application; json: () => unknown };\n    let httpModule: typeof import('http');\n    \n    try {\n      expressModule = await import('express') as unknown as { default: () => Application; json: () => unknown };\n      httpModule = await import('http');\n    } catch {\n      throw new Error(\n        'Express is required for DevTools server. Install it with: npm install express'\n      );\n    }\n\n    const app = expressModule.default();\n\n    // CORS middleware\n    if (this.config.cors) {\n      app.use((_req: Request, res: Response, next: NextFunction) => {\n        res.header('Access-Control-Allow-Origin', '*');\n        res.header('Access-Control-Allow-Headers', 'Content-Type');\n        res.header('Access-Control-Allow-Methods', 'GET, POST, DELETE');\n        next();\n      });\n    }\n\n    app.use(expressModule.json() as unknown as (req: Request, res: Response, next: NextFunction) => void);\n\n    // API Routes\n    this.setupRoutes(app);\n\n    // Create HTTP server\n    this.server = httpModule.createServer(app);\n\n    // Start listening\n    await new Promise<void>((resolve) => {\n      this.server!.listen(this.config.port, this.config.host, () => {\n        console.log(`\\n🔍 OrkaJS DevTools running at http://${this.config.host}:${this.config.port}\\n`);\n        resolve();\n      });\n    });\n\n    // Subscribe to trace events for SSE\n    this.collector.subscribe((event) => {\n      this.broadcastEvent(event);\n    });\n  }\n\n  /**\n   * Stop the server\n   */\n  async stop(): Promise<void> {\n    if (this.server) {\n      await new Promise<void>((resolve, reject) => {\n        this.server!.close((err) => {\n          if (err) reject(err);\n          else resolve();\n        });\n      });\n      this.server = undefined;\n    }\n  }\n\n  /**\n   * Setup API routes\n   */\n  private setupRoutes(app: Application): void {\n    // Health check\n    app.get('/api/health', (_req: Request, res: Response) => {\n      res.json({ status: 'ok', timestamp: Date.now() });\n    });\n\n    // Get all sessions\n    app.get('/api/sessions', (_req: Request, res: Response) => {\n      const sessions = this.collector.getSessions();\n      res.json(sessions);\n    });\n\n    // Get a specific session\n    app.get('/api/sessions/:id', (req: Request, res: Response) => {\n      const session = this.collector.getSession(req.params.id);\n      if (!session) {\n        res.status(404).json({ error: 'Session not found' });\n        return;\n      }\n      res.json(session);\n    });\n\n    // Get metrics\n    app.get('/api/metrics', (req: Request, res: Response) => {\n      const sessionId = req.query.sessionId as string | undefined;\n      const metrics = this.collector.getMetrics(sessionId);\n      res.json(metrics);\n    });\n\n    // Find a run\n    app.get('/api/runs/:id', (req: Request, res: Response) => {\n      const sessionId = req.query.sessionId as string | undefined;\n      const run = this.collector.findRun(req.params.id, sessionId);\n      if (!run) {\n        res.status(404).json({ error: 'Run not found' });\n        return;\n      }\n      res.json(run);\n    });\n\n    // Clear all traces\n    app.delete('/api/sessions', (_req: Request, res: Response) => {\n      this.collector.clear();\n      res.json({ success: true });\n    });\n\n    // Export traces\n    app.get('/api/export', (_req: Request, res: Response) => {\n      const data = this.collector.export();\n      res.setHeader('Content-Type', 'application/json');\n      res.setHeader('Content-Disposition', 'attachment; filename=orka-traces.json');\n      res.send(data);\n    });\n\n    // Import traces\n    app.post('/api/import', (req: Request, res: Response) => {\n      try {\n        this.collector.import(JSON.stringify(req.body));\n        res.json({ success: true });\n      } catch {\n        res.status(400).json({ error: 'Invalid trace data' });\n      }\n    });\n\n    // Server-Sent Events for real-time updates\n    app.get('/api/events', (req: Request, res: Response) => {\n      res.setHeader('Content-Type', 'text/event-stream');\n      res.setHeader('Cache-Control', 'no-cache');\n      res.setHeader('Connection', 'keep-alive');\n\n      this.clients.add(res as unknown as ServerResponse);\n\n      req.on('close', () => {\n        this.clients.delete(res as unknown as ServerResponse);\n      });\n    });\n\n    // Serve static UI (if available)\n    app.get('/', (_req: Request, res: Response) => {\n      res.send(this.getDashboardHTML());\n    });\n  }\n\n  /**\n   * Broadcast event to all SSE clients\n   */\n  private broadcastEvent(event: TraceEvent): void {\n    const data = JSON.stringify(event);\n    for (const client of this.clients) {\n      client.write(`data: ${data}\\n\\n`);\n    }\n  }\n\n  /**\n   * Get embedded dashboard HTML\n   */\n  private getDashboardHTML(): string {\n    return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>OrkaJS DevTools</title>\n  <script src=\"https://cdn.tailwindcss.com\"></script>\n  <style>\n    .tree-line { border-left: 2px solid #e2e8f0; }\n    .dark .tree-line { border-left-color: #334155; }\n  </style>\n</head>\n<body class=\"bg-slate-50 dark:bg-slate-900 text-slate-900 dark:text-white min-h-screen\">\n  <div id=\"app\" class=\"max-w-7xl mx-auto p-6\">\n    <header class=\"flex items-center justify-between mb-8\">\n      <div class=\"flex items-center gap-3\">\n        <div class=\"w-10 h-10 bg-gradient-to-br from-purple-500 to-pink-500 rounded-lg flex items-center justify-center\">\n          <svg class=\"w-6 h-6 text-white\" fill=\"none\" stroke=\"currentColor\" viewBox=\"0 0 24 24\">\n            <path stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M9.75 17L9 20l-1 1h8l-1-1-.75-3M3 13h18M5 17h14a2 2 0 002-2V5a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z\"/>\n          </svg>\n        </div>\n        <div>\n          <h1 class=\"text-2xl font-bold\">OrkaJS DevTools</h1>\n          <p class=\"text-sm text-slate-500\">Real-time LLM observability</p>\n        </div>\n      </div>\n      <div class=\"flex items-center gap-4\">\n        <span id=\"status\" class=\"flex items-center gap-2 text-sm\">\n          <span class=\"w-2 h-2 bg-green-500 rounded-full animate-pulse\"></span>\n          Connected\n        </span>\n        <button onclick=\"clearTraces()\" class=\"px-3 py-1.5 text-sm bg-red-500/10 text-red-500 rounded-lg hover:bg-red-500/20\">\n          Clear\n        </button>\n        <button onclick=\"exportTraces()\" class=\"px-3 py-1.5 text-sm bg-purple-500/10 text-purple-500 rounded-lg hover:bg-purple-500/20\">\n          Export\n        </button>\n      </div>\n    </header>\n\n    <!-- Metrics -->\n    <div id=\"metrics\" class=\"grid grid-cols-4 gap-4 mb-8\">\n      <div class=\"bg-white dark:bg-slate-800 rounded-xl p-4 shadow-sm\">\n        <p class=\"text-sm text-slate-500 mb-1\">Total Runs</p>\n        <p id=\"metric-runs\" class=\"text-2xl font-bold\">0</p>\n      </div>\n      <div class=\"bg-white dark:bg-slate-800 rounded-xl p-4 shadow-sm\">\n        <p class=\"text-sm text-slate-500 mb-1\">Avg Latency</p>\n        <p id=\"metric-latency\" class=\"text-2xl font-bold\">0ms</p>\n      </div>\n      <div class=\"bg-white dark:bg-slate-800 rounded-xl p-4 shadow-sm\">\n        <p class=\"text-sm text-slate-500 mb-1\">Total Tokens</p>\n        <p id=\"metric-tokens\" class=\"text-2xl font-bold\">0</p>\n      </div>\n      <div class=\"bg-white dark:bg-slate-800 rounded-xl p-4 shadow-sm\">\n        <p class=\"text-sm text-slate-500 mb-1\">Error Rate</p>\n        <p id=\"metric-errors\" class=\"text-2xl font-bold\">0%</p>\n      </div>\n    </div>\n\n    <!-- Sessions & Traces -->\n    <div class=\"grid grid-cols-3 gap-6\">\n      <div class=\"col-span-1\">\n        <h2 class=\"text-lg font-semibold mb-4\">Sessions</h2>\n        <div id=\"sessions\" class=\"space-y-2\"></div>\n      </div>\n      <div class=\"col-span-2\">\n        <h2 class=\"text-lg font-semibold mb-4\">Trace Viewer</h2>\n        <div id=\"traces\" class=\"bg-white dark:bg-slate-800 rounded-xl p-4 shadow-sm min-h-[400px]\">\n          <p class=\"text-slate-500 text-center py-8\">Select a session to view traces</p>\n        </div>\n      </div>\n    </div>\n  </div>\n\n  <script>\n    let selectedSession = null;\n\n    // SSE connection\n    const events = new EventSource('/api/events');\n    events.onmessage = (e) => {\n      const event = JSON.parse(e.data);\n      console.log('Event:', event);\n      refreshData();\n    };\n    events.onerror = () => {\n      document.getElementById('status').innerHTML = '<span class=\"w-2 h-2 bg-red-500 rounded-full\"></span> Disconnected';\n    };\n\n    async function refreshData() {\n      // Fetch metrics\n      const metrics = await fetch('/api/metrics').then(r => r.json());\n      document.getElementById('metric-runs').textContent = metrics.totalRuns;\n      document.getElementById('metric-latency').textContent = Math.round(metrics.avgLatencyMs) + 'ms';\n      document.getElementById('metric-tokens').textContent = metrics.totalTokens.toLocaleString();\n      document.getElementById('metric-errors').textContent = (metrics.errorRate * 100).toFixed(1) + '%';\n\n      // Fetch sessions\n      const sessions = await fetch('/api/sessions').then(r => r.json());\n      renderSessions(sessions);\n\n      if (selectedSession) {\n        const session = await fetch('/api/sessions/' + selectedSession).then(r => r.json());\n        renderTraces(session.runs);\n      }\n    }\n\n    function renderSessions(sessions) {\n      const container = document.getElementById('sessions');\n      container.innerHTML = sessions.map(s => \\`\n        <div onclick=\"selectSession('\\${s.id}')\" class=\"p-3 rounded-lg cursor-pointer \\${selectedSession === s.id ? 'bg-purple-500/20 border border-purple-500' : 'bg-white dark:bg-slate-800 hover:bg-slate-100 dark:hover:bg-slate-700'}\">\n          <p class=\"font-medium\">\\${s.name || 'Session'}</p>\n          <p class=\"text-xs text-slate-500\">\\${s.runs.length} runs • \\${new Date(s.startTime).toLocaleTimeString()}</p>\n        </div>\n      \\`).join('');\n    }\n\n    function selectSession(id) {\n      selectedSession = id;\n      refreshData();\n    }\n\n    function renderTraces(runs, depth = 0) {\n      if (!runs || runs.length === 0) {\n        document.getElementById('traces').innerHTML = '<p class=\"text-slate-500 text-center py-8\">No traces in this session</p>';\n        return;\n      }\n\n      const html = runs.map(run => renderRun(run, depth)).join('');\n      document.getElementById('traces').innerHTML = html;\n    }\n\n    function renderRun(run, depth) {\n      const statusColor = run.status === 'success' ? 'bg-green-500' : run.status === 'error' ? 'bg-red-500' : 'bg-yellow-500';\n      const typeColors = {\n        llm: 'text-purple-500',\n        agent: 'text-blue-500',\n        tool: 'text-orange-500',\n        retrieval: 'text-green-500',\n        chain: 'text-pink-500',\n      };\n\n      return \\`\n        <div class=\"mb-2\" style=\"margin-left: \\${depth * 20}px\">\n          <div class=\"flex items-center gap-2 p-2 rounded-lg hover:bg-slate-100 dark:hover:bg-slate-700\">\n            <span class=\"w-2 h-2 rounded-full \\${statusColor}\"></span>\n            <span class=\"text-xs font-medium \\${typeColors[run.type] || 'text-slate-500'}\">\\${run.type.toUpperCase()}</span>\n            <span class=\"font-medium\">\\${run.name}</span>\n            <span class=\"text-xs text-slate-500 ml-auto\">\\${run.latencyMs ? run.latencyMs + 'ms' : 'running...'}</span>\n            \\${run.metadata?.totalTokens ? '<span class=\"text-xs text-slate-400\">' + run.metadata.totalTokens + ' tokens</span>' : ''}\n          </div>\n          \\${run.children.map(c => renderRun(c, depth + 1)).join('')}\n        </div>\n      \\`;\n    }\n\n    async function clearTraces() {\n      await fetch('/api/sessions', { method: 'DELETE' });\n      selectedSession = null;\n      refreshData();\n    }\n\n    function exportTraces() {\n      window.open('/api/export', '_blank');\n    }\n\n    // Initial load\n    refreshData();\n  </script>\n</body>\n</html>`;\n  }\n}\n","import { getCollector } from './collector.js';\nimport type { TraceRunType, TraceMetadata } from './types.js';\n\n/**\n * Hook interface matching @orka-js/observability\n */\ninterface ObservabilityHook {\n  onTraceStart?: (trace: TracerTrace) => void;\n  onTraceEnd?: (trace: TracerTrace) => void;\n  onEvent?: (event: TracerEvent) => void;\n  onError?: (error: Error, context?: Record<string, unknown>) => void;\n}\n\ninterface TracerTrace {\n  id: string;\n  name: string;\n  startTime: number;\n  endTime?: number;\n  totalLatencyMs?: number;\n  totalTokens?: number;\n  events: TracerEvent[];\n  metadata?: Record<string, unknown>;\n}\n\ninterface TracerEvent {\n  id: string;\n  traceId: string;\n  type: string;\n  name: string;\n  startTime?: number;\n  endTime?: number;\n  latencyMs?: number;\n  input?: unknown;\n  output?: unknown;\n  usage?: {\n    promptTokens?: number;\n    completionTokens?: number;\n    totalTokens?: number;\n  };\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Map Tracer event types to DevTools run types\n */\nfunction mapEventType(type: string): TraceRunType {\n  const typeMap: Record<string, TraceRunType> = {\n    'llm': 'llm',\n    'llm_call': 'llm',\n    'embedding': 'embedding',\n    'retrieval': 'retrieval',\n    'tool': 'tool',\n    'tool_call': 'tool',\n    'agent': 'agent',\n    'agent_step': 'agent',\n    'chain': 'chain',\n    'workflow': 'workflow',\n    'graph': 'graph',\n    'node': 'node',\n  };\n  return typeMap[type.toLowerCase()] ?? 'custom';\n}\n\n/**\n * Create a DevTools hook for the Tracer\n * \n * Usage:\n * ```ts\n * import { Tracer } from '@orka-js/observability';\n * import { createDevToolsHook, devtools } from '@orka-js/devtools';\n * \n * await devtools();\n * \n * const tracer = new Tracer({\n *   hooks: [createDevToolsHook()]\n * });\n * ```\n */\nexport function createDevToolsHook(): ObservabilityHook {\n  const collector = getCollector();\n  const traceToSession = new Map<string, string>();\n  const eventToRun = new Map<string, string>();\n\n  return {\n    onTraceStart(trace: TracerTrace) {\n      // Start a new session for each trace\n      const sessionId = collector.startSession(trace.name);\n      traceToSession.set(trace.id, sessionId);\n    },\n\n    onTraceEnd(trace: TracerTrace) {\n      const sessionId = traceToSession.get(trace.id);\n      if (sessionId) {\n        collector.endSession(sessionId);\n        traceToSession.delete(trace.id);\n      }\n    },\n\n    onEvent(event: TracerEvent) {\n      const runType = mapEventType(event.type);\n      \n      // Build metadata\n      const metadata: TraceMetadata = {\n        ...event.metadata,\n      };\n\n      if (event.usage) {\n        metadata.promptTokens = event.usage.promptTokens;\n        metadata.completionTokens = event.usage.completionTokens;\n        metadata.totalTokens = event.usage.totalTokens;\n      }\n\n      // If event has both start and end time, create a completed run\n      if (event.startTime && event.endTime) {\n        const runId = collector.startRun(runType, event.name, event.input, metadata);\n        collector.endRun(runId, event.output, {\n          ...metadata,\n          // Override latency calculation since we have actual times\n        });\n        eventToRun.set(event.id, runId);\n      } else if (event.startTime && !event.endTime) {\n        // Event is starting\n        const runId = collector.startRun(runType, event.name, event.input, metadata);\n        eventToRun.set(event.id, runId);\n      } else {\n        // Event is ending (find matching start)\n        const runId = eventToRun.get(event.id);\n        if (runId) {\n          collector.endRun(runId, event.output, metadata);\n          eventToRun.delete(event.id);\n        }\n      }\n    },\n\n    onError(error: Error, context?: Record<string, unknown>) {\n      // Find the most recent run and mark it as errored\n      const sessions = collector.getSessions();\n      if (sessions.length > 0) {\n        const lastSession = sessions[sessions.length - 1];\n        if (lastSession.runs.length > 0) {\n          const findRunningRun = (runs: Array<{ id: string; status: string; children: unknown[] }>): string | undefined => {\n            for (const run of runs) {\n              if (run.status === 'running') return run.id;\n              const childRun = findRunningRun(run.children as Array<{ id: string; status: string; children: unknown[] }>);\n              if (childRun) return childRun;\n            }\n            return undefined;\n          };\n\n          const runningRunId = findRunningRun(lastSession.runs as Array<{ id: string; status: string; children: unknown[] }>);\n          if (runningRunId) {\n            collector.errorRun(runningRunId, error);\n          }\n        }\n      }\n\n      // Log context if provided\n      if (context) {\n        console.error('[DevTools] Error context:', context);\n      }\n    },\n  };\n}\n\n/**\n * Convenience function to create a Tracer with DevTools integration\n */\nexport function createTracerWithDevTools(options: {\n  logLevel?: 'debug' | 'info' | 'warn' | 'error';\n  maxTraces?: number;\n  traceTtlMs?: number;\n} = {}): {\n  hook: ObservabilityHook;\n  config: typeof options & { hooks: ObservabilityHook[] };\n} {\n  const hook = createDevToolsHook();\n  return {\n    hook,\n    config: {\n      ...options,\n      hooks: [hook],\n    },\n  };\n}\n","import { TraceCollector, getCollector } from './collector.js';\nimport { DevToolsServer } from './server.js';\nimport type { DevToolsConfig, TraceRunType, TraceMetadata } from './types.js';\n\nexport * from './types.js';\nexport { TraceCollector, getCollector, resetCollector } from './collector.js';\nexport { DevToolsServer } from './server.js';\nexport { createDevToolsHook, createTracerWithDevTools } from './tracer-hook.js';\n\n/**\n * Start the DevTools dashboard\n */\nexport async function devtools(config: DevToolsConfig = {}): Promise<{\n  collector: TraceCollector;\n  server: DevToolsServer;\n  stop: () => Promise<void>;\n}> {\n  const collector = getCollector(config);\n  const server = new DevToolsServer(collector, config);\n  \n  await server.start();\n\n  // Open browser if requested\n  if (config.open !== false) {\n    const url = `http://${config.host ?? 'localhost'}:${config.port ?? 3001}`;\n    try {\n      const { exec } = await import('child_process');\n      const command = process.platform === 'darwin' ? 'open' :\n                      process.platform === 'win32' ? 'start' : 'xdg-open';\n      exec(`${command} ${url}`);\n    } catch {\n      // Ignore if can't open browser\n    }\n  }\n\n  return {\n    collector,\n    server,\n    stop: () => server.stop(),\n  };\n}\n\n/**\n * Create a trace wrapper for any function\n */\nexport function withTrace<T extends (...args: unknown[]) => unknown>(\n  fn: T,\n  options: {\n    name?: string;\n    type?: TraceRunType;\n    collector?: TraceCollector;\n  } = {}\n): T {\n  const collector = options.collector ?? getCollector();\n  const name = options.name ?? fn.name ?? 'anonymous';\n  const type = options.type ?? 'custom';\n\n  return (async (...args: unknown[]) => {\n    const runId = collector.startRun(type, name, args);\n    try {\n      const result = await fn(...args);\n      collector.endRun(runId, result);\n      return result;\n    } catch (error) {\n      collector.errorRun(runId, error as Error);\n      throw error;\n    }\n  }) as T;\n}\n\n/**\n * Decorator for tracing class methods\n */\nexport function Trace(options: {\n  name?: string;\n  type?: TraceRunType;\n} = {}) {\n  return function (\n    _target: unknown,\n    propertyKey: string,\n    descriptor: PropertyDescriptor\n  ) {\n    const originalMethod = descriptor.value;\n    const name = options.name ?? propertyKey;\n    const type = options.type ?? 'custom';\n\n    descriptor.value = async function (...args: unknown[]) {\n      const collector = getCollector();\n      const runId = collector.startRun(type, name, args);\n      try {\n        const result = await originalMethod.apply(this, args);\n        collector.endRun(runId, result);\n        return result;\n      } catch (error) {\n        collector.errorRun(runId, error as Error);\n        throw error;\n      }\n    };\n\n    return descriptor;\n  };\n}\n\n/**\n * Manual tracing helpers\n */\nexport const trace = {\n  start(type: TraceRunType, name: string, input?: unknown, metadata?: TraceMetadata): string {\n    return getCollector().startRun(type, name, input, metadata);\n  },\n  \n  end(runId: string, output?: unknown, metadata?: TraceMetadata): void {\n    getCollector().endRun(runId, output, metadata);\n  },\n  \n  error(runId: string, error: Error | string): void {\n    getCollector().errorRun(runId, error);\n  },\n  \n  session(name?: string): string {\n    return getCollector().startSession(name);\n  },\n  \n  endSession(sessionId?: string): void {\n    getCollector().endSession(sessionId);\n  },\n\n  /**\n   * Wrap an async function with tracing\n   */\n  async wrap<T>(\n    type: TraceRunType,\n    name: string,\n    fn: () => Promise<T>,\n    metadata?: TraceMetadata\n  ): Promise<T> {\n    const runId = getCollector().startRun(type, name, undefined, metadata);\n    try {\n      const result = await fn();\n      getCollector().endRun(runId, result);\n      return result;\n    } catch (error) {\n      getCollector().errorRun(runId, error as Error);\n      throw error;\n    }\n  },\n};\n"],"mappings":"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","names":["trace"]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@orka-js/devtools",
+  "version": "1.1.0",
+  "description": "Visual debugging and observability dashboard for OrkaJS",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "ui"
+  ],
+  "dependencies": {
+    "@orka-js/core": "1.2.1",
+    "@orka-js/observability": "1.0.3"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "express": "^4.18.0"
+  },
+  "peerDependenciesMeta": {
+    "express": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "orkajs",
+    "devtools",
+    "llm",
+    "observability",
+    "tracing",
+    "debugging"
+  ],
+  "author": "OrkaJS Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/orka-ai/orkajs.git",
+    "directory": "packages/devtools"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}