cc-query 0.1.0 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-query",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "SQL REPL for querying Claude Code session data",
   "type": "module",
   "exports": {
@@ -15,7 +15,7 @@
     "node": ">=24"
   },
   "bin": {
-    "cc-query": "./bin/cc-query.js"
+    "cc-query": "bin/cc-query.js"
   },
   "files": [
     "index.js",

package/src/query-session.js

@@ -39,6 +39,16 @@ function formatResults(result) {
           const ms = Number(val.micros) / 1000;
           return new Date(ms).toISOString().replace("T", " ").replace("Z", "");
         }
+        // Handle DuckDB UUID objects (returned as {hugeint: string})
+        if ("hugeint" in val) {
+          // Convert 128-bit signed decimal to UUID hex string
+          // DuckDB XORs the high bit for sorting, so flip it back
+          let n = BigInt(val.hugeint);
+          if (n < 0n) n += 1n << 128n; // Convert from signed to unsigned
+          n ^= 1n << 127n; // Flip high bit (undo DuckDB's sort optimization)
+          const hex = n.toString(16).padStart(32, "0");
+          return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+        }
         return JSON.stringify(val, (_, v) =>
           typeof v === "bigint" ? v.toString() : v,
         );
@@ -334,6 +344,103 @@ export class QuerySession {
       json as raw
     FROM read_ndjson_objects('${this.#filePattern}', ignore_errors=true)
     WHERE json->>'uuid' IS NOT NULL AND length(json->>'uuid') > 0;
+
+    -- Tool uses: All tool calls with unnested content blocks
+    CREATE OR REPLACE VIEW tool_uses AS
+    SELECT
+      m.uuid,
+      m.timestamp,
+      m.sessionId,
+      m.isAgent,
+      m.agentId,
+      m.project,
+      m.rownum,
+      block->>'name' as tool_name,
+      block->>'id' as tool_id,
+      block->'input' as tool_input,
+      row_number() OVER (PARTITION BY m.uuid ORDER BY (SELECT NULL)) - 1 as block_index
+    FROM assistant_messages m,
+    LATERAL UNNEST(CAST(message->'content' AS JSON[])) as t(block)
+    WHERE block->>'type' = 'tool_use';
+
+    -- Tool results: All tool results with duration
+    CREATE OR REPLACE VIEW tool_results AS
+    WITH array_messages AS (
+      SELECT * FROM user_messages
+      WHERE json_type(message->'content') = 'ARRAY'
+    )
+    SELECT
+      m.uuid,
+      m.timestamp,
+      m.sessionId,
+      m.isAgent,
+      m.agentId,
+      m.project,
+      m.rownum,
+      block->>'tool_use_id' as tool_use_id,
+      CAST(block->>'is_error' AS BOOLEAN) as is_error,
+      block->>'content' as result_content,
+      CAST(m.toolUseResult->>'durationMs' AS INTEGER) as duration_ms,
+      m.sourceToolAssistantUUID
+    FROM array_messages m,
+    LATERAL UNNEST(CAST(message->'content' AS JSON[])) as t(block)
+    WHERE block->>'type' = 'tool_result';
+
+    -- Token usage: Pre-cast token counts
+    CREATE OR REPLACE VIEW token_usage AS
+    SELECT
+      uuid,
+      timestamp,
+      sessionId,
+      isAgent,
+      agentId,
+      project,
+      message->>'model' as model,
+      message->>'stop_reason' as stop_reason,
+      CAST(message->'usage'->>'input_tokens' AS BIGINT) as input_tokens,
+      CAST(message->'usage'->>'output_tokens' AS BIGINT) as output_tokens,
+      CAST(message->'usage'->>'cache_read_input_tokens' AS BIGINT) as cache_read_tokens,
+      CAST(message->'usage'->>'cache_creation_input_tokens' AS BIGINT) as cache_creation_tokens
+    FROM assistant_messages
+    WHERE (message->'usage') IS NOT NULL;
+
+    -- Bash commands: Bash tool uses with extracted command
+    CREATE OR REPLACE VIEW bash_commands AS
+    SELECT
+      uuid,
+      timestamp,
+      sessionId,
+      isAgent,
+      agentId,
+      project,
+      rownum,
+      tool_id,
+      tool_input->>'command' as command,
+      tool_input->>'description' as description,
+      CAST(tool_input->>'timeout' AS INTEGER) as timeout,
+      CAST(tool_input->>'run_in_background' AS BOOLEAN) as run_in_background
+    FROM tool_uses
+    WHERE tool_name = 'Bash';
+
+    -- File operations: Read/Write/Edit/Glob/Grep with extracted paths
+    CREATE OR REPLACE VIEW file_operations AS
+    SELECT
+      uuid,
+      timestamp,
+      sessionId,
+      isAgent,
+      agentId,
+      project,
+      rownum,
+      tool_id,
+      tool_name,
+      COALESCE(
+        tool_input->>'file_path',
+        tool_input->>'path'
+      ) as file_path,
+      tool_input->>'pattern' as pattern
+    FROM tool_uses
+    WHERE tool_name IN ('Read', 'Write', 'Edit', 'Glob', 'Grep');
   `;
   }
 }

package/src/repl.js

@@ -52,15 +52,22 @@ function getHelpText() {
   return `
 Commands:
   .help, .h      Show this help
-  .schema, .s    Show table schema (runs DESCRIBE messages)
+  .schema, .s    Show schemas for all views
   .schema <view> Show schema for a specific view
   .quit, .q      Exit
 
 Views:
   messages            All messages (user, assistant, system)
   user_messages       User messages with user-specific fields
+  human_messages      Human-typed messages (excludes tool results)
   assistant_messages  Assistant messages with error, requestId, etc.
   system_messages     System messages with hooks, retry info, etc.
+  raw_messages        Raw JSON for each message by uuid
+  tool_uses           All tool calls with unnested content blocks
+  tool_results        Tool results with duration and error status
+  token_usage         Token counts per assistant message
+  bash_commands       Bash tool calls with extracted command
+  file_operations     Read/Write/Edit/Glob/Grep with file paths
 
 Example queries:
   -- Count messages by type
@@ -137,7 +144,23 @@ async function handleDotCommand(command, qs) {
   }
 
   if (cmd === ".schema" || cmd === ".s") {
-    await executeQuery(qs, "DESCRIBE messages");
+    const views = [
+      "messages",
+      "user_messages",
+      "human_messages",
+      "assistant_messages",
+      "system_messages",
+      "raw_messages",
+      "tool_uses",
+      "tool_results",
+      "token_usage",
+      "bash_commands",
+      "file_operations",
+    ];
+    for (const view of views) {
+      console.log(`\n=== ${view} ===`);
+      await executeQuery(qs, `DESCRIBE ${view}`);
+    }
     return false;
   }