claude-deck 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,292 @@
+export interface Usage {
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_input_tokens: number;
+    cache_creation_input_tokens: number;
+    cache_creation?: {
+        ephemeral_5m_input_tokens?: number;
+        ephemeral_1h_input_tokens?: number;
+    };
+    service_tier?: string;
+}
+export interface ToolUseBlock {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface TextBlock {
+    type: "text";
+    text: string;
+}
+export interface ToolResultBlock {
+    type: "tool_result";
+    tool_use_id: string;
+    content?: unknown;
+}
+export type ContentBlock = ToolUseBlock | TextBlock | ToolResultBlock;
+export interface AssistantMessage {
+    id?: string;
+    role: "assistant";
+    content: ContentBlock[];
+    model: string;
+    usage: Usage;
+}
+export interface ToolUseResult {
+    type?: string;
+    stdout?: string;
+    stderr?: string;
+    exitCode?: number;
+    file?: string;
+    filePath?: string;
+    content?: string;
+    structuredPatch?: unknown;
+    originalFile?: string;
+    matches?: unknown[];
+    status?: string;
+    agentId?: string;
+    totalDurationMs?: number;
+    totalTokens?: number;
+    totalToolUseCount?: number;
+    usage?: Usage;
+}
+export interface UserMessage {
+    role: "user";
+    content: ContentBlock[] | string;
+}
+export interface AssistantRecord {
+    type: "assistant";
+    message: AssistantMessage;
+    timestamp: string;
+}
+export interface UserRecord {
+    type: "user";
+    message: UserMessage;
+    userType?: "external" | "internal";
+    toolUseResult?: ToolUseResult;
+    toolUseID?: string;
+    timestamp: string;
+}
+export interface SystemRecord {
+    type: "system";
+    subtype?: string;
+    compactMetadata?: unknown;
+    timestamp: string;
+}
+export type JsonlRecord = AssistantRecord | UserRecord | SystemRecord | {
+    type: string;
+    timestamp?: string;
+};
+export interface CompactBoundaryRecord {
+    type: "system";
+    subtype: "compact_boundary";
+    timestamp: string;
+    compactMetadata: {
+        trigger: string;
+        preTokens: number;
+    };
+}
+export interface ParsedSession {
+    id: string;
+    project: string;
+    projectHash: string;
+    firstPrompt: string | null;
+    model: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreateTokens: number;
+    estimatedCostUsd: number;
+    messageCount: number;
+    toolCallCount: number;
+    subagentCount: number;
+    turnCount: number;
+    peakContextTokens: number;
+    startedAt: string | null;
+    endedAt: string | null;
+    durationMs: number | null;
+    jsonlPath: string;
+    jsonlMtime: string;
+    toolCalls: ParsedToolCall[];
+    messages: ParsedMessage[];
+    subagents: ParsedSubagent[];
+    compactions: ParsedCompaction[];
+}
+export interface ParsedToolCall {
+    toolUseId: string | null;
+    toolName: string;
+    toolInput: string;
+    toolResponse: string | null;
+    status: string;
+    timestamp: string;
+    subagentId: string | null;
+}
+export interface ParsedMessage {
+    role: "user" | "assistant";
+    content: string;
+    timestamp: string;
+    model: string | null;
+    costUsd: number | null;
+}
+export interface ParsedCompaction {
+    timestamp: string;
+    trigger: string;
+    preTokens: number;
+}
+export interface ParsedSubagent {
+    id: string;
+    agentType: string | null;
+    model: string | null;
+    prompt: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreateTokens: number;
+    estimatedCostUsd: number;
+    toolCallCount: number;
+    durationMs: number | null;
+    resultSummary: string | null;
+}
+export interface SessionRow {
+    id: string;
+    project: string;
+    project_hash: string;
+    first_prompt: string | null;
+    model: string | null;
+    status: string;
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_tokens: number;
+    cache_create_tokens: number;
+    estimated_cost_usd: number;
+    message_count: number;
+    tool_call_count: number;
+    subagent_count: number;
+    turn_count: number;
+    started_at: string | null;
+    ended_at: string | null;
+    duration_ms: number | null;
+    peak_context_tokens: number;
+    compaction_count: number;
+    peak_context_pct: number;
+    synced_at: string;
+    jsonl_path: string;
+    jsonl_mtime: string;
+}
+export interface ToolCallRow {
+    id: number;
+    session_id: string;
+    subagent_id: string | null;
+    tool_use_id: string | null;
+    tool_name: string;
+    tool_input: string | null;
+    tool_response: string | null;
+    status: string;
+    timestamp: string;
+}
+export interface MessageRow {
+    id: number;
+    session_id: string;
+    role: string;
+    content: string;
+    timestamp: string;
+    model: string | null;
+    cost_usd: number | null;
+}
+export interface SubagentRow {
+    id: string;
+    session_id: string;
+    agent_type: string | null;
+    model: string | null;
+    prompt: string | null;
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_tokens: number;
+    cache_create_tokens: number;
+    estimated_cost_usd: number;
+    tool_call_count: number;
+    duration_ms: number | null;
+    result_summary: string | null;
+}
+export interface CompactionRow {
+    id: number;
+    session_id: string;
+    trigger: string;
+    pre_tokens: number;
+    timestamp: string;
+}
+export interface FileReadPattern {
+    file: string;
+    count: number;
+}
+export interface SessionPhase {
+    name: string;
+    category: "explore" | "research" | "write" | "execute" | "other";
+    toolCount: number;
+    durationMs: number;
+}
+export interface WebFetchDetail {
+    tool: string;
+    url: string;
+    timestamp: string;
+    isError: boolean;
+    errorDetail: string;
+}
+export interface WebFetchStats {
+    total: number;
+    errors: number;
+    successRate: number;
+    details: WebFetchDetail[];
+}
+export interface CompactionInfo {
+    count: number;
+    compactions: {
+        timestamp: string;
+        trigger: string;
+        preTokens: number;
+    }[];
+}
+export interface SessionInsights {
+    fileReads: FileReadPattern[];
+    phases: SessionPhase[];
+    webFetches: WebFetchStats;
+    toolDistribution: {
+        tool: string;
+        count: number;
+    }[];
+    totalToolCalls: number;
+    sessionDurationMs: number;
+    compaction: CompactionInfo;
+}
+export interface StatsResponse {
+    totalSessions: number;
+    totalCost: number;
+    totalTokens: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheCreateTokens: number;
+    avgCostPerSession: number;
+    byModel: {
+        model: string;
+        sessions: number;
+        cost: number;
+        tokens: number;
+    }[];
+    byProject: {
+        project: string;
+        sessions: number;
+        cost: number;
+        tokens: number;
+    }[];
+    byDay: {
+        date: string;
+        sessions: number;
+        cost: number;
+        tokens: number;
+    }[];
+    topTools: {
+        tool: string;
+        count: number;
+    }[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+// ─── JSONL record types (what we read from files) ───
+export {};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "claude-deck",
+  "version": "0.1.0",
+  "description": "Dashboard for browsing and searching Claude Code sessions",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "claude-deck": "./dist/cli.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "dashboard",
+    "sessions",
+    "anthropic"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gypsum-org/claude-deck.git"
+  },
+  "scripts": {
+    "dev": "concurrently -n server,ui -c blue,magenta \"tsx watch src/cli.ts --no-open\" \"cd ui && npm run dev -- --open\"",
+    "dev:server": "tsx watch src/cli.ts",
+    "dev:ui": "cd ui && npm run dev",
+    "build": "tsc && cd ui && npm run build",
+    "postbuild": "chmod +x dist/cli.js",
+    "build:server": "tsc",
+    "build:ui": "cd ui && npm run build",
+    "prepublishOnly": "npm run build",
+    "format": "prettier --write \"src/**/*.ts\" \"ui/src/**/*.{ts,tsx,css}\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"ui/src/**/*.{ts,tsx,css}\""
+  },
+  "dependencies": {
+    "@fastify/cors": "^10.0.2",
+    "@fastify/static": "^8.1.0",
+    "better-sqlite3": "^11.7.0",
+    "commander": "^13.1.0",
+    "fastify": "^5.2.1",
+    "open": "^10.1.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^22.10.10",
+    "concurrently": "^9.2.1",
+    "prettier": "^3.8.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  },
+  "files": [
+    "dist/",
+    "dashboard/"
+  ]
+}