@axplusb/kepler 0.0.1 → 1.0.1

package/pulse/app/api/tools/route.ts

@@ -0,0 +1,160 @@
+import path from 'path'
+import { NextResponse } from 'next/server'
+import { getSessions, listProjectSlugs, listProjectJSONLFiles, readJSONLLines } from '@/lib/claude-reader'
+import { categorizeTool, isMcpTool, parseMcpTool } from '@/lib/tool-categories'
+import type { ToolsAnalytics, ToolSummary, McpServerSummary, VersionRecord } from '@/types/claude'
+
+export const dynamic = 'force-dynamic'
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type AnyLine = Record<string, any>
+
+export async function GET() {
+  const sessions = await getSessions()
+  const totalSessions = sessions.length
+
+  // ── Aggregate tool counts across all sessions ──────────────────────────────
+  const toolTotals = new Map<string, number>()
+  const toolSessionCount = new Map<string, Set<string>>()
+  const mcpServerCalls = new Map<string, Map<string, number>>()
+  const mcpServerSessions = new Map<string, Set<string>>()
+  const errorCategories: Record<string, number> = {}
+  let totalErrors = 0
+
+  for (const s of sessions) {
+    const sid = s.session_id
+    for (const [tool, count] of Object.entries(s.tool_counts ?? {})) {
+      toolTotals.set(tool, (toolTotals.get(tool) ?? 0) + count)
+      if (!toolSessionCount.has(tool)) toolSessionCount.set(tool, new Set())
+      toolSessionCount.get(tool)!.add(sid)
+
+      if (isMcpTool(tool)) {
+        const parsed = parseMcpTool(tool)
+        if (parsed) {
+          if (!mcpServerCalls.has(parsed.server)) mcpServerCalls.set(parsed.server, new Map())
+          if (!mcpServerSessions.has(parsed.server)) mcpServerSessions.set(parsed.server, new Set())
+          const srv = mcpServerCalls.get(parsed.server)!
+          srv.set(parsed.tool, (srv.get(parsed.tool) ?? 0) + count)
+          mcpServerSessions.get(parsed.server)!.add(sid)
+        }
+      }
+    }
+
+    // Error categories
+    for (const [cat, count] of Object.entries(s.tool_error_categories ?? {})) {
+      errorCategories[cat] = (errorCategories[cat] ?? 0) + count
+      totalErrors += count
+    }
+  }
+
+  // ── Build ToolSummary list ─────────────────────────────────────────────────
+  const tools: ToolSummary[] = [...toolTotals.entries()]
+    .map(([name, total_calls]) => ({
+      name,
+      category: categorizeTool(name),
+      total_calls,
+      session_count: toolSessionCount.get(name)?.size ?? 0,
+      error_count: 0,
+    }))
+    .sort((a, b) => b.total_calls - a.total_calls)
+
+  const totalToolCalls = tools.reduce((s, t) => s + t.total_calls, 0)
+
+  // ── MCP server summaries ───────────────────────────────────────────────────
+  const mcp_servers: McpServerSummary[] = [...mcpServerCalls.entries()]
+    .map(([server_name, toolMap]) => {
+      const toolArr = [...toolMap.entries()]
+        .map(([name, calls]) => ({ name, calls }))
+        .sort((a, b) => b.calls - a.calls)
+      const total_calls = toolArr.reduce((s, t) => s + t.calls, 0)
+      return {
+        server_name,
+        tools: toolArr,
+        total_calls,
+        session_count: mcpServerSessions.get(server_name)?.size ?? 0,
+      }
+    })
+    .sort((a, b) => b.total_calls - a.total_calls)
+
+  // ── Feature adoption ──────────────────────────────────────────────────────
+  const featureSessions = {
+    task_agents: sessions.filter(s => s.uses_task_agent || (s.tool_counts?.Task ?? 0) > 0).length,
+    mcp: sessions.filter(s => s.uses_mcp || Object.keys(s.tool_counts ?? {}).some(isMcpTool)).length,
+    web_search: sessions.filter(s => s.uses_web_search || (s.tool_counts?.WebSearch ?? 0) > 0).length,
+    web_fetch: sessions.filter(s => s.uses_web_fetch || (s.tool_counts?.WebFetch ?? 0) > 0).length,
+    plan_mode: sessions.filter(s => (s.tool_counts?.EnterPlanMode ?? 0) > 0).length,
+    git_commits: sessions.filter(s => (s.git_commits ?? 0) > 0).length,
+  }
+
+  const feature_adoption: Record<string, { sessions: number; pct: number }> = {}
+  for (const [key, count] of Object.entries(featureSessions)) {
+    feature_adoption[key] = { sessions: count, pct: totalSessions > 0 ? count / totalSessions : 0 }
+  }
+
+  // ── Version + branch info from JSONL ─────────────────────────────────────
+  const versionData = new Map<string, { sessions: Set<string>; dates: string[] }>()
+  const branchTurns = new Map<string, number>()
+
+  const slugs = await listProjectSlugs()
+  await Promise.all(
+    slugs.map(async (slug) => {
+      const files = await listProjectJSONLFiles(slug)
+      await Promise.all(
+        files.map(async (f) => {
+          const sessionId = path.basename(f, '.jsonl')
+          let fileVersion: string | undefined
+          let fileDate: string | undefined
+
+          await readJSONLLines(f, (line: AnyLine) => {
+            if (!fileVersion && line.version) {
+              fileVersion = line.version
+              fileDate = line.timestamp
+            }
+            if (line.gitBranch && line.gitBranch !== 'HEAD') {
+              branchTurns.set(line.gitBranch, (branchTurns.get(line.gitBranch) ?? 0) + 1)
+            }
+          })
+
+          if (fileVersion) {
+            if (!versionData.has(fileVersion)) {
+              versionData.set(fileVersion, { sessions: new Set(), dates: [] })
+            }
+            const vd = versionData.get(fileVersion)!
+            vd.sessions.add(sessionId)
+            if (fileDate) vd.dates.push(fileDate)
+          }
+        })
+      )
+    })
+  )
+
+  const versions: VersionRecord[] = [...versionData.entries()]
+    .map(([version, data]) => {
+      const sortedDates = data.dates.sort()
+      return {
+        version,
+        session_count: data.sessions.size,
+        first_seen: sortedDates[0] ?? '',
+        last_seen: sortedDates[sortedDates.length - 1] ?? '',
+      }
+    })
+    .sort((a, b) => b.last_seen.localeCompare(a.last_seen))
+
+  const branches = [...branchTurns.entries()]
+    .map(([branch, turns]) => ({ branch, turns }))
+    .sort((a, b) => b.turns - a.turns)
+    .slice(0, 15)
+
+  const result: ToolsAnalytics = {
+    tools,
+    mcp_servers,
+    feature_adoption,
+    versions,
+    branches,
+    error_categories: errorCategories,
+    total_tool_calls: totalToolCalls,
+    total_errors: totalErrors,
+  }
+
+  return NextResponse.json(result)
+}

package/pulse/app/costs/page.tsx

@@ -0,0 +1,179 @@
+'use client'
+
+import useSWR from 'swr'
+import { TopBar } from '@/components/layout/top-bar'
+import { CostOverTimeChart } from '@/components/costs/cost-over-time-chart'
+import { CostByProjectChart } from '@/components/costs/cost-by-project-chart'
+import { ModelTokenTable } from '@/components/costs/model-token-table'
+import { CacheEfficiencyPanel } from '@/components/costs/cache-efficiency-panel'
+import { formatCost, formatTokens } from '@/lib/decode'
+import { PRICING } from '@/lib/pricing'
+import type { CostAnalytics } from '@/types/claude'
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+import { Skeleton } from '@/components/ui/skeleton'
+import { Alert, AlertDescription } from '@/components/ui/alert'
+import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@/components/ui/table'
+import { AlertTriangle, TrendingDown, DollarSign, Banknote } from 'lucide-react'
+
+const fetcher = (url: string) =>
+  fetch(url).then(r => { if (!r.ok) throw new Error(`API error ${r.status}`); return r.json() })
+
+export default function CostsPage() {
+  const { data, error, isLoading } = useSWR<CostAnalytics>('/api/costs', fetcher, { refreshInterval: 5_000 })
+
+  return (
+    <div className="flex flex-col min-h-screen">
+      <TopBar title="Costs" subtitle="Estimated spend from ~/.orca/" />
+      <div className="p-6 space-y-6">
+
+        {error && (
+          <Alert variant="destructive">
+            <AlertTriangle className="h-4 w-4" />
+            <AlertDescription>Error loading data: {String(error)}</AlertDescription>
+          </Alert>
+        )}
+
+        {isLoading && (
+          <div className="space-y-4">
+            <div className="grid grid-cols-1 sm:grid-cols-3 gap-4">
+              {Array.from({ length: 3 }).map((_, i) => <Skeleton key={i} className="h-28 rounded-xl" />)}
+            </div>
+            {Array.from({ length: 3 }).map((_, i) => <Skeleton key={i} className="h-56 rounded-xl" />)}
+          </div>
+        )}
+
+        {data && (
+          <>
+            {/* Hero stat cards */}
+            <div className="grid grid-cols-1 sm:grid-cols-3 gap-4">
+              <Card>
+                <CardHeader className="pb-2">
+                  <CardDescription className="flex items-center gap-2">
+                    <DollarSign className="w-4 h-4" /> Total Estimated Cost
+                  </CardDescription>
+                  <CardTitle className="text-3xl font-bold tabular-nums text-[#d97706]">
+                    {formatCost(data.total_cost)}
+                  </CardTitle>
+                </CardHeader>
+                <CardContent>
+                  <p className="text-xs text-muted-foreground">All time spend across all projects</p>
+                </CardContent>
+              </Card>
+
+              <Card>
+                <CardHeader className="pb-2">
+                  <CardDescription className="flex items-center gap-2">
+                    <TrendingDown className="w-4 h-4" /> Cache Savings
+                  </CardDescription>
+                  <CardTitle className="text-3xl font-bold tabular-nums text-[#34d399]">
+                    {formatCost(data.total_savings)}
+                  </CardTitle>
+                </CardHeader>
+                <CardContent>
+                  <p className="text-xs text-muted-foreground">Saved by prompt caching</p>
+                </CardContent>
+              </Card>
+
+              <Card>
+                <CardHeader className="pb-2">
+                  <CardDescription className="flex items-center gap-2">
+                    <Banknote className="w-4 h-4" /> Without Cache
+                  </CardDescription>
+                  <CardTitle className="text-3xl font-bold tabular-nums text-red-400">
+                    {formatCost(data.total_cost + data.total_savings)}
+                  </CardTitle>
+                </CardHeader>
+                <CardContent>
+                  <p className="text-xs text-muted-foreground">What you would have spent</p>
+                </CardContent>
+              </Card>
+            </div>
+
+            {/* Cost over time */}
+            {data.daily.length > 0 && (
+              <Card>
+                <CardHeader>
+                  <CardTitle>Cost Over Time</CardTitle>
+                  <CardDescription>Daily estimated spend</CardDescription>
+                </CardHeader>
+                <CardContent>
+                  <CostOverTimeChart daily={data.daily} />
+                </CardContent>
+              </Card>
+            )}
+
+            {/* Cost by project */}
+            {data.by_project.length > 0 && (
+              <Card>
+                <CardHeader>
+                  <CardTitle>Cost by Project</CardTitle>
+                  <CardDescription>Spend breakdown across projects</CardDescription>
+                </CardHeader>
+                <CardContent>
+                  <CostByProjectChart projects={data.by_project} />
+                </CardContent>
+              </Card>
+            )}
+
+            {/* Per-model table */}
+            <Card>
+              <CardHeader>
+                <CardTitle>Per-Model Token Breakdown</CardTitle>
+                <CardDescription>Token usage and cost by model</CardDescription>
+              </CardHeader>
+              <CardContent>
+                <ModelTokenTable models={data.models} />
+              </CardContent>
+            </Card>
+
+            {/* Cache efficiency */}
+            <Card>
+              <CardHeader>
+                <CardTitle>Cache Efficiency</CardTitle>
+                <CardDescription>How much caching is saving you</CardDescription>
+              </CardHeader>
+              <CardContent>
+                <CacheEfficiencyPanel models={data.models} totalSavings={data.total_savings} />
+              </CardContent>
+            </Card>
+
+            {/* Pricing reference */}
+            <Card>
+              <CardHeader>
+                <CardTitle>Pricing Reference</CardTitle>
+                <CardDescription>
+                  Estimates only — update rates in{' '}
+                  <code className="text-xs bg-muted px-1 rounded">lib/pricing.ts</code>
+                </CardDescription>
+              </CardHeader>
+              <CardContent>
+                <Table>
+                  <TableHeader>
+                    <TableRow>
+                      <TableHead>Model</TableHead>
+                      <TableHead className="text-right">Input /MTok</TableHead>
+                      <TableHead className="text-right">Output /MTok</TableHead>
+                      <TableHead className="text-right">Cache Write /MTok</TableHead>
+                      <TableHead className="text-right">Cache Read /MTok</TableHead>
+                    </TableRow>
+                  </TableHeader>
+                  <TableBody>
+                    {Object.entries(PRICING).map(([model, p]) => (
+                      <TableRow key={model}>
+                        <TableCell className="font-mono text-sm">{model}</TableCell>
+                        <TableCell className="text-right font-mono text-blue-700 dark:text-[#60a5fa]">${(p.input * 1_000_000).toFixed(2)}</TableCell>
+                        <TableCell className="text-right font-mono text-[#d97706]">${(p.output * 1_000_000).toFixed(2)}</TableCell>
+                        <TableCell className="text-right font-mono text-[#a78bfa]">${(p.cacheWrite * 1_000_000).toFixed(2)}</TableCell>
+                        <TableCell className="text-right font-mono text-[#34d399]">${(p.cacheRead * 1_000_000).toFixed(2)}</TableCell>
+                      </TableRow>
+                    ))}
+                  </TableBody>
+                </Table>
+              </CardContent>
+            </Card>
+          </>
+        )}
+      </div>
+    </div>
+  )
+}