@arcreflex/agent-transcripts 0.1.1

package/src/utils/summary.ts

@@ -0,0 +1,43 @@
+/**
+ * Extract one-line summaries from tool call inputs.
+ */
+
+function truncate(str: string, maxLen: number): string {
+  if (str.length <= maxLen) return str;
+  return str.slice(0, maxLen - 3) + "...";
+}
+
+type ToolInput = Record<string, unknown>;
+
+const extractors: Record<string, (input: ToolInput) => string> = {
+  Read: (i) => String(i.file_path || ""),
+  Write: (i) => String(i.file_path || ""),
+  Edit: (i) => String(i.file_path || ""),
+  Bash: (i) => {
+    if (i.description) return String(i.description);
+    if (i.command) return truncate(String(i.command), 60);
+    return "";
+  },
+  Grep: (i) => {
+    const pattern = String(i.pattern || "");
+    const path = i.path ? ` in ${i.path}` : "";
+    return truncate(pattern + path, 80);
+  },
+  Glob: (i) => String(i.pattern || ""),
+  WebFetch: (i) => String(i.url || ""),
+  WebSearch: (i) => String(i.query || ""),
+  Task: (i) => truncate(String(i.description || i.prompt || ""), 60),
+  TodoWrite: () => "update todos",
+  AskUserQuestion: () => "ask user",
+  NotebookEdit: (i) => String(i.notebook_path || ""),
+};
+
+export function extractToolSummary(toolName: string, input: ToolInput): string {
+  const extractor = extractors[toolName];
+  if (extractor) {
+    const summary = extractor(input);
+    if (summary) return summary;
+  }
+  // Fallback: just use tool name
+  return "";
+}

package/test/fixtures/claude/basic-conversation.input.jsonl

@@ -0,0 +1,4 @@
+{"type": "user", "uuid": "msg-1", "message": {"role": "user", "content": "Hello, can you help me with a coding question?"}, "timestamp": "2024-01-15T10:00:00Z"}
+{"type": "assistant", "uuid": "msg-2", "parentUuid": "msg-1", "message": {"role": "assistant", "content": [{"type": "text", "text": "Of course! I'd be happy to help. What's your question?"}]}, "timestamp": "2024-01-15T10:00:05Z"}
+{"type": "user", "uuid": "msg-3", "parentUuid": "msg-2", "message": {"role": "user", "content": "How do I reverse a string in Python?"}, "timestamp": "2024-01-15T10:00:30Z"}
+{"type": "assistant", "uuid": "msg-4", "parentUuid": "msg-3", "message": {"role": "assistant", "content": [{"type": "text", "text": "You can reverse a string in Python using slicing:\n\n```python\nreversed_string = original[::-1]\n```\n\nThe `[::-1]` slice notation means start from the end and step backwards."}]}, "timestamp": "2024-01-15T10:00:35Z"}

package/test/fixtures/claude/basic-conversation.output.md

@@ -0,0 +1,28 @@
+# Transcript
+
+**Source**: `test/fixtures/claude/basic-conversation.input.jsonl`
+**Adapter**: claude-code
+
+---
+
+## User
+
+Hello, can you help me with a coding question?
+
+## Assistant
+
+Of course! I'd be happy to help. What's your question?
+
+## User
+
+How do I reverse a string in Python?
+
+## Assistant
+
+You can reverse a string in Python using slicing:
+
+```python
+reversed_string = original[::-1]
+```
+
+The `[::-1]` slice notation means start from the end and step backwards.

package/test/fixtures/claude/multiple-tools.input.jsonl

@@ -0,0 +1,2 @@
+{"type": "user", "uuid": "msg-1", "message": {"role": "user", "content": "Check the files"}, "timestamp": "2024-01-15T10:00:00Z"}
+{"type": "assistant", "uuid": "msg-2", "parentUuid": "msg-1", "message": {"role": "assistant", "content": [{"type": "tool_use", "id": "tool-1", "name": "Read", "input": {"file_path": "/src/main.ts"}}, {"type": "tool_use", "id": "tool-2", "name": "Glob", "input": {"pattern": "**/*.test.ts"}}, {"type": "tool_use", "id": "tool-3", "name": "Bash", "input": {"command": "ls -la", "description": "List files"}}]}, "timestamp": "2024-01-15T10:00:02Z"}

package/test/fixtures/claude/multiple-tools.output.md

@@ -0,0 +1,15 @@
+# Transcript
+
+**Source**: `test/fixtures/claude/multiple-tools.input.jsonl`
+**Adapter**: claude-code
+
+---
+
+## User
+
+Check the files
+
+**Tools**:
+- Read `/src/main.ts`
+- Glob `**/*.test.ts`
+- Bash `List files`

package/test/fixtures/claude/with-thinking.input.jsonl

@@ -0,0 +1,2 @@
+{"type": "user", "uuid": "msg-1", "message": {"role": "user", "content": "What's 17 * 23?"}, "timestamp": "2024-01-15T10:00:00Z"}
+{"type": "assistant", "uuid": "msg-2", "parentUuid": "msg-1", "message": {"role": "assistant", "content": [{"type": "thinking", "thinking": "Let me calculate 17 * 23.\n17 * 23 = 17 * 20 + 17 * 3\n       = 340 + 51\n       = 391"}, {"type": "text", "text": "17 * 23 = 391"}]}, "timestamp": "2024-01-15T10:00:02Z"}

package/test/fixtures/claude/with-thinking.output.md

@@ -0,0 +1,24 @@
+# Transcript
+
+**Source**: `test/fixtures/claude/with-thinking.input.jsonl`
+**Adapter**: claude-code
+
+---
+
+## User
+
+What's 17 * 23?
+
+## Assistant
+
+
+<details>
+<summary>Thinking...</summary>
+
+Let me calculate 17 * 23.
+17 * 23 = 17 * 20 + 17 * 3
+       = 340 + 51
+       = 391
+</details>
+
+17 * 23 = 391

package/test/fixtures/claude/with-tools.input.jsonl

@@ -0,0 +1,2 @@
+{"type": "user", "uuid": "msg-1", "message": {"role": "user", "content": "Read the config file"}, "timestamp": "2024-01-15T10:00:00Z"}
+{"type": "assistant", "uuid": "msg-2", "parentUuid": "msg-1", "message": {"role": "assistant", "content": [{"type": "text", "text": "I'll read the config file for you."}, {"type": "tool_use", "id": "tool-1", "name": "Read", "input": {"file_path": "/project/config.json"}}]}, "timestamp": "2024-01-15T10:00:02Z"}

package/test/fixtures/claude/with-tools.output.md

@@ -0,0 +1,16 @@
+# Transcript
+
+**Source**: `test/fixtures/claude/with-tools.input.jsonl`
+**Adapter**: claude-code
+
+---
+
+## User
+
+Read the config file
+
+## Assistant
+
+I'll read the config file for you.
+
+**Tool**: Read `/project/config.json`

package/test/snapshots.test.ts

@@ -0,0 +1,67 @@
+import { describe, expect, it } from "bun:test";
+import { join, dirname } from "path";
+import { Glob } from "bun";
+
+const fixturesDir = join(dirname(import.meta.path), "fixtures/claude");
+const binPath = join(dirname(import.meta.path), "../bin/agent-transcripts");
+
+// Find all input fixtures
+const inputFiles: string[] = [];
+const glob = new Glob("*.input.jsonl");
+for await (const file of glob.scan(fixturesDir)) {
+  inputFiles.push(file);
+}
+inputFiles.sort();
+
+describe("snapshot tests", () => {
+  for (const inputFile of inputFiles) {
+    const name = inputFile.replace(".input.jsonl", "");
+
+    it(name, async () => {
+      const inputPath = join(fixturesDir, inputFile);
+      const expectedPath = inputPath.replace(".input.jsonl", ".output.md");
+      // Use relative path for consistent Source: field in output
+      const relativeInputPath = `test/fixtures/claude/${inputFile}`;
+
+      const expectedOutput = await Bun.file(expectedPath).text();
+
+      // Run the CLI: parse to temp JSON, then render to temp MD
+      const tempJson = `/tmp/test-${name}-${Date.now()}.json`;
+      const tempMd = `/tmp/test-${name}-${Date.now()}.md`;
+
+      // Parse
+      const parseResult = Bun.spawnSync([
+        binPath,
+        "parse",
+        relativeInputPath,
+        "--adapter",
+        "claude-code",
+        "-o",
+        tempJson,
+      ]);
+      expect(parseResult.exitCode).toBe(0);
+
+      // Render
+      const renderResult = Bun.spawnSync([
+        binPath,
+        "render",
+        tempJson,
+        "-o",
+        tempMd,
+      ]);
+      expect(renderResult.exitCode).toBe(0);
+
+      // Compare output
+      const actualOutput = await Bun.file(tempMd).text();
+      expect(actualOutput.trimEnd()).toBe(expectedOutput.trimEnd());
+
+      // Cleanup
+      await Bun.file(tempJson)
+        .delete()
+        .catch(() => {});
+      await Bun.file(tempMd)
+        .delete()
+        .catch(() => {});
+    });
+  }
+});

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "types": ["bun"],
+    "strict": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"]
+}