@fnclaude/renderer 0.0.1 → 2.0.1

package/src/__fixtures__/multi-turn.ndjson

@@ -0,0 +1,11 @@
+{"type":"system","subtype":"init","cwd":"/home/tom/src/fnclaude-renderer@fnrhombus+agent-a47e07f49dcd06f94","session_id":"27ef1601-e3b8-470f-8c70-ab2fd9888b06","tools":["Task","AskUserQuestion","Bash","CronCreate","CronDelete","CronList","Edit","EnterPlanMode","EnterWorktree","ExitPlanMode","ExitWorktree","Glob","Grep","Monitor","NotebookEdit","PushNotification","Read","RemoteTrigger","ScheduleWakeup","SendMessage","ShareOnboardingGuide","Skill","TaskCreate","TaskGet","TaskList","TaskOutput","TaskStop","TaskUpdate","TeamCreate","TeamDelete","ToolSearch","WebFetch","WebSearch","Write"],"mcp_servers":[],"model":"claude-opus-4-7[1m]","permissionMode":"bypassPermissions","slash_commands":["done","getitdone","dots","check-usage","update-config","debug","simplify","batch","fewer-permission-prompts","loop","schedule","claude-api","clear","compact","context","heapdump","init","review","security-review","usage-credits","extra-usage","usage","insights","goal","team-onboarding"],"apiKeySource":"none","claude_code_version":"2.1.144","output_style":"default","agents":["claude","Explore","general-purpose","Plan","statusline-setup"],"skills":["done","getitdone","dots","check-usage","update-config","debug","simplify","batch","fewer-permission-prompts","loop","schedule","claude-api"],"plugins":[{"name":"claude-code-worktree-paths","path":"/home/tom/.claude/plugins/cache/fnrhombus-plugins/claude-code-worktree-paths/2.0.0","source":"claude-code-worktree-paths@fnrhombus-plugins"}],"analytics_disabled":false,"uuid":"ca679b84-cbe8-41cf-9d47-9aedfe9ad2cf","memory_paths":{"auto":"/home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/"},"fast_mode_state":"off"}
+{"type":"rate_limit_event","rate_limit_info":{"status":"allowed","resetsAt":1779189600,"rateLimitType":"five_hour","overageStatus":"rejected","overageDisabledReason":"org_level_disabled","isUsingOverage":false},"uuid":"a9f65ca8-97ac-4076-9bdd-f661f78359b7","session_id":"27ef1601-e3b8-470f-8c70-ab2fd9888b06"}
+{"type":"assistant","message":{"model":"claude-opus-4-7","id":"msg_01BJKEQWvicEMbQYuFvpSGxD","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"EvYCClkIDRgCKkBRKvnQ22VmB93LO/oyn6B1oeaqrvtdwBY9qCcq2m8JF9dLWoqNfV+n8fYYIqspFBKbE5u3gMc/R7NpMuJQ/zzQMg9jbGF1ZGUtb3B1cy00LTc4ABIMGYtCp0XOp70z9gbQGgwWba91nWNpbNXWQPoiMCzaj0pEniRQTCAFEPfCfQMgaMEYgKbDKE+0jFmsdD9IzJnjuxR8bC7/sm8I/PqEwCrKATJHtd5XmpywZppkdcLxy5m3OZx/6NA2vKWF59D7c8HNoEkPVT8uXKt9GIAXUCJErDy1/tS3zZBgXIGkqdsRQE2kDtMbpJ5gQw1HutXjeWOcM1QMXkousQhMDHomhKB/0npE2K8WdydpQaMLoebp0AQKC+SWdh47NJAbBT7u+jQlZIsVaImYkKDuEOlmiiEUh+10mPDzGMXBSkL1lUCWfNicsJyugzlik2Ss9ssPUBhHSUtdKw4mR7BVR45MOyBVP33WSNP0ZSk+kKQYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":6,"cache_creation_input_tokens":15625,"cache_read_input_tokens":18675,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":15625},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"27ef1601-e3b8-470f-8c70-ab2fd9888b06","uuid":"6719c203-e388-428a-b1e4-25de020e86fa","request_id":"req_011CbBespu3Jkgva2Qfs6M5h"}
+{"type":"assistant","message":{"model":"claude-opus-4-7","id":"msg_01BJKEQWvicEMbQYuFvpSGxD","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01DEeiUjnGW5zCMBaGwtJ9Kh","name":"Write","input":{"file_path":"/home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/remembered-number.md","content":"---\nname: remembered-number\ndescription: User asked to remember the number 42\nmetadata:\n  type: project\n---\n\nThe user asked to remember the number 42.\n\n**Why:** Explicit user request to remember this value.\n**How to apply:** If the user asks \"what number did I tell you to remember?\" or similar, the answer is 42.\n"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":6,"cache_creation_input_tokens":15625,"cache_read_input_tokens":18675,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":15625},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"27ef1601-e3b8-470f-8c70-ab2fd9888b06","uuid":"8264789a-d8ce-453c-bb04-5650f735f1fb","request_id":"req_011CbBespu3Jkgva2Qfs6M5h"}
+{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01DEeiUjnGW5zCMBaGwtJ9Kh","type":"tool_result","content":"File created successfully at: /home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/remembered-number.md (file state is current in your context — no need to Read it back)"}]},"parent_tool_use_id":null,"session_id":"27ef1601-e3b8-470f-8c70-ab2fd9888b06","uuid":"cdbff9d7-194a-4b1b-8068-e0b3337b812b","timestamp":"2026-05-19T09:00:19.950Z","tool_use_result":{"type":"create","filePath":"/home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/remembered-number.md","content":"---\nname: remembered-number\ndescription: User asked to remember the number 42\nmetadata: \n  node_type: memory\n  type: project\n  originSessionId: 27ef1601-e3b8-470f-8c70-ab2fd9888b06\n---\n\nThe user asked to remember the number 42.\n\n**Why:** Explicit user request to remember this value.\n**How to apply:** If the user asks \"what number did I tell you to remember?\" or similar, the answer is 42.\n","structuredPatch":[],"originalFile":null,"userModified":false}}
+{"type":"assistant","message":{"model":"claude-opus-4-7","id":"msg_01BJKEQWvicEMbQYuFvpSGxD","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_0125Vp8P7JzfkA6Kr3QrmnZE","name":"Read","input":{"file_path":"/home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/MEMORY.md"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":6,"cache_creation_input_tokens":15625,"cache_read_input_tokens":18675,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":15625},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"27ef1601-e3b8-470f-8c70-ab2fd9888b06","uuid":"e57801f6-55d8-46b7-8008-a35df9d1d8eb","request_id":"req_011CbBespu3Jkgva2Qfs6M5h"}
+{"type":"user","message":{"role":"user","content":[{"type":"tool_result","content":"File does not exist. Note: your current working directory is /home/tom/src/fnclaude-renderer@fnrhombus+agent-a47e07f49dcd06f94.","is_error":true,"tool_use_id":"toolu_0125Vp8P7JzfkA6Kr3QrmnZE"}]},"parent_tool_use_id":null,"session_id":"27ef1601-e3b8-470f-8c70-ab2fd9888b06","uuid":"381f4671-88c2-4d61-ab9c-b52f9fbc28e2","timestamp":"2026-05-19T09:00:20.532Z","tool_use_result":"Error: File does not exist. Note: your current working directory is /home/tom/src/fnclaude-renderer@fnrhombus+agent-a47e07f49dcd06f94."}
+{"type":"assistant","message":{"model":"claude-opus-4-7","id":"msg_01DvVr6gkjbq5NsQg7FU9kSu","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_015JJBSAArUEic6FD8HipCd4","name":"Write","input":{"file_path":"/home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/MEMORY.md","content":"- [Remembered number](remembered-number.md) — user asked to remember the number 42\n"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":671,"cache_read_input_tokens":34300,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":671},"output_tokens":67,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"27ef1601-e3b8-470f-8c70-ab2fd9888b06","uuid":"951ff48a-b307-4db8-b23b-7e8af3791e8f","request_id":"req_011CbBetNhEJrsYKWX4AUk8K"}
+{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_015JJBSAArUEic6FD8HipCd4","type":"tool_result","content":"File created successfully at: /home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/MEMORY.md (file state is current in your context — no need to Read it back)"}]},"parent_tool_use_id":null,"session_id":"27ef1601-e3b8-470f-8c70-ab2fd9888b06","uuid":"12b32c64-124e-4493-83c0-2cdf462c6ef8","timestamp":"2026-05-19T09:00:23.763Z","tool_use_result":{"type":"create","filePath":"/home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/MEMORY.md","content":"- [Remembered number](remembered-number.md) — user asked to remember the number 42\n","structuredPatch":[],"originalFile":null,"userModified":false}}
+{"type":"assistant","message":{"model":"claude-opus-4-7","id":"msg_01BDEB7efPq3RYycwnecqF2c","type":"message","role":"assistant","content":[{"type":"text","text":"42"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":243,"cache_read_input_tokens":34971,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":243},"output_tokens":1,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"27ef1601-e3b8-470f-8c70-ab2fd9888b06","uuid":"18fea679-6337-4e12-835e-f7b0c9917bd6","request_id":"req_011CbBetcREL6niwAiuUnpXt"}
+{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":12854,"duration_api_ms":14498,"ttft_ms":4843,"num_turns":4,"result":"42","stop_reason":"end_turn","session_id":"27ef1601-e3b8-470f-8c70-ab2fd9888b06","total_cost_usd":0.16186275,"usage":{"input_tokens":8,"cache_creation_input_tokens":16539,"cache_read_input_tokens":87946,"output_tokens":559,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":16539,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":1,"output_tokens":5,"cache_read_input_tokens":34971,"cache_creation_input_tokens":243,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":243},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-haiku-4-5-20251001":{"inputTokens":441,"outputTokens":13,"cacheReadInputTokens":0,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0005059999999999999,"contextWindow":200000,"maxOutputTokens":32000},"claude-opus-4-7[1m]":{"inputTokens":8,"outputTokens":559,"cacheReadInputTokens":87946,"cacheCreationInputTokens":16539,"webSearchRequests":0,"costUSD":0.16135675,"contextWindow":1000000,"maxOutputTokens":64000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"80ee8191-81c7-40c3-9dd7-4f000a36406e"}

package/src/__fixtures__/slash-command-turn.ndjson

@@ -0,0 +1,3 @@
+{"type":"system","subtype":"init","cwd":"/home/tom/src/fnclaude-renderer@fnrhombus+agent-a47e07f49dcd06f94","session_id":"71f6c824-8978-4f51-8146-12ac68f81faf","tools":["Task","AskUserQuestion","Bash","CronCreate","CronDelete","CronList","Edit","EnterPlanMode","EnterWorktree","ExitPlanMode","ExitWorktree","Glob","Grep","Monitor","NotebookEdit","PushNotification","Read","RemoteTrigger","ScheduleWakeup","SendMessage","ShareOnboardingGuide","Skill","TaskCreate","TaskGet","TaskList","TaskOutput","TaskStop","TaskUpdate","TeamCreate","TeamDelete","ToolSearch","WebFetch","WebSearch","Write"],"mcp_servers":[],"model":"claude-opus-4-7[1m]","permissionMode":"bypassPermissions","slash_commands":["done","getitdone","dots","check-usage","update-config","debug","simplify","batch","fewer-permission-prompts","loop","schedule","claude-api","clear","compact","context","heapdump","init","review","security-review","usage-credits","extra-usage","usage","insights","goal","team-onboarding"],"apiKeySource":"none","claude_code_version":"2.1.144","output_style":"default","agents":["claude","Explore","general-purpose","Plan","statusline-setup"],"skills":["done","getitdone","dots","check-usage","update-config","debug","simplify","batch","fewer-permission-prompts","loop","schedule","claude-api"],"plugins":[{"name":"claude-code-worktree-paths","path":"/home/tom/.claude/plugins/cache/fnrhombus-plugins/claude-code-worktree-paths/2.0.0","source":"claude-code-worktree-paths@fnrhombus-plugins"}],"analytics_disabled":false,"uuid":"708db9b4-b131-4e45-91e6-e0501230f645","memory_paths":{"auto":"/home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/"},"fast_mode_state":"off"}
+{"type":"assistant","message":{"id":"e80f788f-d31f-44a7-aacd-77b8ee63da94","container":null,"model":"<synthetic>","role":"assistant","stop_details":null,"stop_reason":"stop_sequence","stop_sequence":"","type":"message","usage":{"input_tokens":0,"output_tokens":0,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":null,"cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":null,"iterations":null,"speed":null},"content":[{"type":"text","text":"You are currently using your subscription to power your Claude Code usage"}],"context_management":null},"parent_tool_use_id":null,"session_id":"71f6c824-8978-4f51-8146-12ac68f81faf","uuid":"78a39e62-3c83-4b6d-9c4c-e7a3d19e399d"}
+{"type":"result","subtype":"success","is_error":false,"duration_ms":26,"duration_api_ms":0,"num_turns":0,"result":"You are currently using your subscription to power your Claude Code usage","stop_reason":null,"session_id":"71f6c824-8978-4f51-8146-12ac68f81faf","total_cost_usd":0,"usage":{"input_tokens":0,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":0,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[],"speed":"standard"},"modelUsage":{},"permission_denials":[],"fast_mode_state":"off","uuid":"375b7195-e704-47fa-a01a-1a2c461b35ff"}

package/src/__fixtures__/text-turn.ndjson

@@ -0,0 +1,4 @@
+{"type":"system","subtype":"init","cwd":"/home/tom/src/fnclaude-renderer@fnrhombus+agent-a47e07f49dcd06f94","session_id":"4fccc451-18ae-4b51-8af7-0773b6ec0782","tools":["Task","AskUserQuestion","Bash","CronCreate","CronDelete","CronList","Edit","EnterPlanMode","EnterWorktree","ExitPlanMode","ExitWorktree","Glob","Grep","Monitor","NotebookEdit","PushNotification","Read","RemoteTrigger","ScheduleWakeup","SendMessage","ShareOnboardingGuide","Skill","TaskCreate","TaskGet","TaskList","TaskOutput","TaskStop","TaskUpdate","TeamCreate","TeamDelete","ToolSearch","WebFetch","WebSearch","Write"],"mcp_servers":[],"model":"claude-opus-4-7[1m]","permissionMode":"bypassPermissions","slash_commands":["done","getitdone","dots","check-usage","update-config","debug","simplify","batch","fewer-permission-prompts","loop","schedule","claude-api","clear","compact","context","heapdump","init","review","security-review","usage-credits","extra-usage","usage","insights","goal","team-onboarding"],"apiKeySource":"none","claude_code_version":"2.1.144","output_style":"default","agents":["claude","Explore","general-purpose","Plan","statusline-setup"],"skills":["done","getitdone","dots","check-usage","update-config","debug","simplify","batch","fewer-permission-prompts","loop","schedule","claude-api"],"plugins":[{"name":"claude-code-worktree-paths","path":"/home/tom/.claude/plugins/cache/fnrhombus-plugins/claude-code-worktree-paths/2.0.0","source":"claude-code-worktree-paths@fnrhombus-plugins"}],"analytics_disabled":false,"uuid":"3353b9c2-fefd-4d1e-a712-819525fc58fd","memory_paths":{"auto":"/home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/"},"fast_mode_state":"off"}
+{"type":"rate_limit_event","rate_limit_info":{"status":"allowed","resetsAt":1779189600,"rateLimitType":"five_hour","overageStatus":"rejected","overageDisabledReason":"org_level_disabled","isUsingOverage":false},"uuid":"fed98079-e644-4633-92f2-55699274cefd","session_id":"4fccc451-18ae-4b51-8af7-0773b6ec0782"}
+{"type":"assistant","message":{"model":"claude-opus-4-7","id":"msg_012WRAoEU6bvxXL4KifvTuFZ","type":"message","role":"assistant","content":[{"type":"text","text":"Hi there friend"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":6,"cache_creation_input_tokens":15630,"cache_read_input_tokens":18675,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":15630},"output_tokens":5,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"4fccc451-18ae-4b51-8af7-0773b6ec0782","uuid":"fdb973c5-09f1-4b11-9bb3-c130ca19a691","request_id":"req_011CbBepqYuCdeLezyedJPoa"}
+{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":2352,"duration_api_ms":3536,"ttft_ms":2265,"num_turns":1,"result":"Hi there friend","stop_reason":"end_turn","session_id":"4fccc451-18ae-4b51-8af7-0773b6ec0782","total_cost_usd":0.10781400000000001,"usage":{"input_tokens":6,"cache_creation_input_tokens":15630,"cache_read_input_tokens":18675,"output_tokens":10,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":15630,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":6,"output_tokens":10,"cache_read_input_tokens":18675,"cache_creation_input_tokens":15630,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":15630},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-haiku-4-5-20251001":{"inputTokens":444,"outputTokens":13,"cacheReadInputTokens":0,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.000509,"contextWindow":200000,"maxOutputTokens":32000},"claude-opus-4-7[1m]":{"inputTokens":6,"outputTokens":10,"cacheReadInputTokens":18675,"cacheCreationInputTokens":15630,"webSearchRequests":0,"costUSD":0.10730500000000001,"contextWindow":1000000,"maxOutputTokens":64000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"216fbabf-dd6c-47e9-9329-74c48b9cff8d"}

package/src/__fixtures__/tool-use-turn.ndjson

@@ -0,0 +1,6 @@
+{"type":"system","subtype":"init","cwd":"/home/tom/src/fnclaude-renderer@fnrhombus+agent-a47e07f49dcd06f94","session_id":"21548375-838d-4a0b-b5e2-bd8b66f16da0","tools":["Task","AskUserQuestion","Bash","CronCreate","CronDelete","CronList","Edit","EnterPlanMode","EnterWorktree","ExitPlanMode","ExitWorktree","Glob","Grep","Monitor","NotebookEdit","PushNotification","Read","RemoteTrigger","ScheduleWakeup","SendMessage","ShareOnboardingGuide","Skill","TaskCreate","TaskGet","TaskList","TaskOutput","TaskStop","TaskUpdate","TeamCreate","TeamDelete","ToolSearch","WebFetch","WebSearch","Write"],"mcp_servers":[],"model":"claude-opus-4-7[1m]","permissionMode":"bypassPermissions","slash_commands":["done","getitdone","dots","check-usage","update-config","debug","simplify","batch","fewer-permission-prompts","loop","schedule","claude-api","clear","compact","context","heapdump","init","review","security-review","usage-credits","extra-usage","usage","insights","goal","team-onboarding"],"apiKeySource":"none","claude_code_version":"2.1.144","output_style":"default","agents":["claude","Explore","general-purpose","Plan","statusline-setup"],"skills":["done","getitdone","dots","check-usage","update-config","debug","simplify","batch","fewer-permission-prompts","loop","schedule","claude-api"],"plugins":[{"name":"claude-code-worktree-paths","path":"/home/tom/.claude/plugins/cache/fnrhombus-plugins/claude-code-worktree-paths/2.0.0","source":"claude-code-worktree-paths@fnrhombus-plugins"}],"analytics_disabled":false,"uuid":"36e7e37d-6997-4ff7-99d3-6e2a6ba02550","memory_paths":{"auto":"/home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/"},"fast_mode_state":"off"}
+{"type":"rate_limit_event","rate_limit_info":{"status":"allowed","resetsAt":1779189600,"rateLimitType":"five_hour","overageStatus":"rejected","overageDisabledReason":"org_level_disabled","isUsingOverage":false},"uuid":"5728cf2d-aaa7-4f51-967a-44339ecfd3ca","session_id":"21548375-838d-4a0b-b5e2-bd8b66f16da0"}
+{"type":"assistant","message":{"model":"claude-opus-4-7","id":"msg_01DP8fNkG5jYxtVsnSf9ziWm","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01UtPPEinrH1vYAXrzbGrS3y","name":"Bash","input":{"command":"echo hello_tool_test","description":"Echo test string"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":6,"cache_creation_input_tokens":15630,"cache_read_input_tokens":18675,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":15630},"output_tokens":5,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"21548375-838d-4a0b-b5e2-bd8b66f16da0","uuid":"577095eb-8631-464c-9d70-1ac3cfdd7430","request_id":"req_011CbBeqQDg5T2vXSFpLjTSB"}
+{"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01UtPPEinrH1vYAXrzbGrS3y","type":"tool_result","content":"hello_tool_test","is_error":false}]},"parent_tool_use_id":null,"session_id":"21548375-838d-4a0b-b5e2-bd8b66f16da0","uuid":"d4a4322f-3ae1-40dd-abd2-817ec0b54df8","timestamp":"2026-05-19T08:59:44.686Z","tool_use_result":{"stdout":"hello_tool_test","stderr":"","interrupted":false,"isImage":false,"noOutputExpected":false}}
+{"type":"assistant","message":{"model":"claude-opus-4-7","id":"msg_01RcKpMFWehHWKcuutpXCFEb","type":"message","role":"assistant","content":[{"type":"text","text":"hello_tool_test"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":1,"cache_creation_input_tokens":121,"cache_read_input_tokens":34305,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":121},"output_tokens":7,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"21548375-838d-4a0b-b5e2-bd8b66f16da0","uuid":"6626b0a0-ceaf-4bde-9746-7893bfe4164b","request_id":"req_011CbBeqj9xi6mzu3TrkdLeT"}
+{"type":"result","subtype":"success","is_error":false,"api_error_status":null,"duration_ms":6762,"duration_api_ms":7076,"ttft_ms":3259,"num_turns":2,"result":"hello_tool_test","stop_reason":"end_turn","session_id":"21548375-838d-4a0b-b5e2-bd8b66f16da0","total_cost_usd":0.12816775,"usage":{"input_tokens":7,"cache_creation_input_tokens":15751,"cache_read_input_tokens":52980,"output_tokens":107,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":15751,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[{"input_tokens":1,"output_tokens":11,"cache_read_input_tokens":34305,"cache_creation_input_tokens":121,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":121},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-haiku-4-5-20251001":{"inputTokens":444,"outputTokens":16,"cacheReadInputTokens":0,"cacheCreationInputTokens":0,"webSearchRequests":0,"costUSD":0.0005239999999999999,"contextWindow":200000,"maxOutputTokens":32000},"claude-opus-4-7[1m]":{"inputTokens":7,"outputTokens":107,"cacheReadInputTokens":52980,"cacheCreationInputTokens":15751,"webSearchRequests":0,"costUSD":0.12764375,"contextWindow":1000000,"maxOutputTokens":64000}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","uuid":"64058024-128a-4af4-b73f-c7ce7a6ce74f"}

package/src/__fixtures__/unknown-slash-command-turn.ndjson

@@ -0,0 +1,2 @@
+{"type":"system","subtype":"init","cwd":"/home/tom/src/fnclaude-renderer@fnrhombus+agent-a47e07f49dcd06f94","session_id":"6aa97dd9-5b26-489f-ac5c-87978420be75","tools":["Task","AskUserQuestion","Bash","CronCreate","CronDelete","CronList","Edit","EnterPlanMode","EnterWorktree","ExitPlanMode","ExitWorktree","Glob","Grep","Monitor","NotebookEdit","PushNotification","Read","RemoteTrigger","ScheduleWakeup","SendMessage","ShareOnboardingGuide","Skill","TaskCreate","TaskGet","TaskList","TaskOutput","TaskStop","TaskUpdate","TeamCreate","TeamDelete","ToolSearch","WebFetch","WebSearch","Write"],"mcp_servers":[],"model":"claude-opus-4-7[1m]","permissionMode":"bypassPermissions","slash_commands":["done","getitdone","dots","check-usage","update-config","debug","simplify","batch","fewer-permission-prompts","loop","schedule","claude-api","clear","compact","context","heapdump","init","review","security-review","usage-credits","extra-usage","usage","insights","goal","team-onboarding"],"apiKeySource":"none","claude_code_version":"2.1.144","output_style":"default","agents":["claude","Explore","general-purpose","Plan","statusline-setup"],"skills":["done","getitdone","dots","check-usage","update-config","debug","simplify","batch","fewer-permission-prompts","loop","schedule","claude-api"],"plugins":[{"name":"claude-code-worktree-paths","path":"/home/tom/.claude/plugins/cache/fnrhombus-plugins/claude-code-worktree-paths/2.0.0","source":"claude-code-worktree-paths@fnrhombus-plugins"}],"analytics_disabled":false,"uuid":"7eb1461b-03fd-458c-9932-482168a53bf2","memory_paths":{"auto":"/home/tom/.claude/projects/-home-tom-src-fnclaude-renderer-fnrhombus/memory/"},"fast_mode_state":"off"}
+{"type":"result","subtype":"success","is_error":false,"duration_ms":26,"duration_api_ms":0,"num_turns":0,"result":"Unknown command: /foo. Did you mean /loop?","stop_reason":null,"session_id":"6aa97dd9-5b26-489f-ac5c-87978420be75","total_cost_usd":0,"usage":{"input_tokens":0,"cache_creation_input_tokens":0,"cache_read_input_tokens":0,"output_tokens":0,"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":0,"ephemeral_5m_input_tokens":0},"inference_geo":"","iterations":[],"speed":"standard"},"modelUsage":{},"permission_denials":[],"fast_mode_state":"off","uuid":"f974f8e2-ced3-4403-b326-cacb63e93302"}

package/src/claude-process.test.ts

@@ -0,0 +1,196 @@
+/**
+ * Tests for the claude subprocess driver.
+ *
+ * Strategy: inject a mock spawn function rather than invoking the real claude
+ * binary. This makes the tests hermetic and fast — no network calls, no
+ * dependency on a live claude installation, and safe to run in CI where the
+ * binary may not be present or authenticated.
+ *
+ * The mock spawn writes a real fixture file's bytes to a fake stdout pipe
+ * (ReadableStream), then closes it, simulating what claude would emit. The
+ * driver reads from that stream via the parser. We also test that
+ * sendUserTurn serialises the UserTurn shape correctly by inspecting what
+ * was written to the mock stdin.
+ *
+ * The mock surface: `subscribeToClaude` accepts an optional `spawnFn`
+ * parameter of type `SpawnFn`. Callers that omit it get the real
+ * `Bun.spawn`-backed implementation; test code passes a mock.
+ */
+import { describe, expect, test } from "bun:test";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import type { SpawnFn } from "./claude-process.ts";
+import { subscribeToClaude } from "./claude-process.ts";
+import type { AssistantEvent, ResultEvent, SystemEvent } from "./types/events.ts";
+
+const fixtureDir = join(import.meta.dir, "__fixtures__");
+
+function makeFixtureSpawn(fixtureName: string): {
+  spawnFn: SpawnFn;
+  getStdinWrites: () => string[];
+} {
+  const stdinWrites: string[] = [];
+
+  const spawnFn: SpawnFn = (_cmd, _opts) => {
+    const fixtureBytes = readFileSync(join(fixtureDir, fixtureName));
+
+    // Fake stdout: a ReadableStream that immediately emits the fixture.
+    const stdout = new ReadableStream<Uint8Array>({
+      start(controller) {
+        controller.enqueue(new Uint8Array(fixtureBytes));
+        controller.close();
+      },
+    });
+
+    // Fake stdin: a WritableStream that records written strings.
+    const stdin = new WritableStream<Uint8Array>({
+      write(chunk) {
+        stdinWrites.push(new TextDecoder().decode(chunk));
+      },
+    });
+
+    return {
+      stdout,
+      stdin,
+      exited: Promise.resolve(0),
+      kill: () => undefined,
+    };
+  };
+
+  return { spawnFn, getStdinWrites: () => stdinWrites };
+}
+
+describe("subscribeToClaude — text turn", () => {
+  test("yields system, assistant, result events from fixture", async () => {
+    const { spawnFn } = makeFixtureSpawn("text-turn.ndjson");
+    const { events } = subscribeToClaude({ spawnFn });
+
+    const collected = [];
+    for await (const ev of events) {
+      collected.push(ev);
+    }
+
+    const types = collected.map((e) => e.type);
+    expect(types).toContain("system");
+    expect(types).toContain("assistant");
+    expect(types).toContain("result");
+  });
+
+  test("system event has session_id and subtype init", async () => {
+    const { spawnFn } = makeFixtureSpawn("text-turn.ndjson");
+    const { events } = subscribeToClaude({ spawnFn });
+
+    for await (const ev of events) {
+      if (ev.type === "system") {
+        const sys = ev as SystemEvent;
+        expect(sys.subtype).toBe("init");
+        expect(typeof sys.session_id).toBe("string");
+        return;
+      }
+    }
+    throw new Error("no system event");
+  });
+
+  test("result event is success", async () => {
+    const { spawnFn } = makeFixtureSpawn("text-turn.ndjson");
+    const { events } = subscribeToClaude({ spawnFn });
+
+    for await (const ev of events) {
+      if (ev.type === "result") {
+        const res = ev as ResultEvent;
+        expect(res.subtype).toBe("success");
+        expect(res.is_error).toBe(false);
+        return;
+      }
+    }
+    throw new Error("no result event");
+  });
+});
+
+describe("subscribeToClaude — sendUserTurn", () => {
+  test("sendUserTurn writes valid UserTurn JSON followed by newline", async () => {
+    const { spawnFn, getStdinWrites } = makeFixtureSpawn("text-turn.ndjson");
+    const { events, sendUserTurn } = subscribeToClaude({ spawnFn });
+
+    sendUserTurn("hello world");
+
+    // Drain events so the mock finishes.
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    for await (const _ev of events) {
+      /* drain */
+    }
+
+    const writes = getStdinWrites();
+    expect(writes.length).toBeGreaterThan(0);
+    const allWritten = writes.join("");
+    // Must end with a newline.
+    expect(allWritten.endsWith("\n")).toBe(true);
+    // Must parse as valid JSON.
+    const parsed = JSON.parse(allWritten.trim()) as Record<string, unknown>;
+    expect(parsed.type).toBe("user");
+    const msg = parsed.message as Record<string, unknown>;
+    expect(msg.role).toBe("user");
+    const content = msg.content as Array<Record<string, unknown>>;
+    expect(content[0]?.type).toBe("text");
+    expect(content[0]?.text).toBe("hello world");
+  });
+});
+
+describe("subscribeToClaude — close", () => {
+  test("close() resolves and process exits cleanly", async () => {
+    const { spawnFn } = makeFixtureSpawn("text-turn.ndjson");
+    const { events, close } = subscribeToClaude({ spawnFn });
+
+    // Drain so we know the mock stream closed.
+    for await (const _ev of events) {
+      /* drain */
+    }
+
+    const exitCode = await close();
+    expect(exitCode).toBe(0);
+  });
+});
+
+describe("subscribeToClaude — tool-use fixture", () => {
+  test("emits assistant with tool_use and user with tool_result", async () => {
+    const { spawnFn } = makeFixtureSpawn("tool-use-turn.ndjson");
+    const { events } = subscribeToClaude({ spawnFn });
+
+    let sawToolUse = false;
+    let sawToolResult = false;
+
+    for await (const ev of events) {
+      if (ev.type === "assistant") {
+        const ast = ev as AssistantEvent;
+        for (const block of ast.message.content) {
+          if (block.type === "tool_use") sawToolUse = true;
+        }
+      }
+      if (ev.type === "user") {
+        const content = Array.isArray(ev.message.content) ? ev.message.content : [];
+        for (const block of content) {
+          if (block.type === "tool_result") sawToolResult = true;
+        }
+      }
+    }
+
+    expect(sawToolUse).toBe(true);
+    expect(sawToolResult).toBe(true);
+  });
+});
+
+describe("subscribeToClaude — slash command fixture", () => {
+  test("assistant model is <synthetic>", async () => {
+    const { spawnFn } = makeFixtureSpawn("slash-command-turn.ndjson");
+    const { events } = subscribeToClaude({ spawnFn });
+
+    for await (const ev of events) {
+      if (ev.type === "assistant") {
+        const ast = ev as AssistantEvent;
+        expect(ast.message.model).toBe("<synthetic>");
+        return;
+      }
+    }
+    throw new Error("no assistant event");
+  });
+});

package/src/claude-process.ts

@@ -0,0 +1,138 @@
+/**
+ * Claude subprocess driver.
+ *
+ * Spawns `claude --print --verbose --input-format stream-json
+ * --output-format stream-json` via Bun.spawn and exposes an async-iterable
+ * event stream plus a `sendUserTurn` writer.
+ *
+ * Design notes:
+ * - stdin MUST be a pipe, not a file redirect. Passing a file to claude's
+ *   stdin silently produces no output and exits 0 — a painful gotcha
+ *   documented in docs/stream-json-findings.md.
+ * - `SpawnFn` is injectable so tests can pipe fixture bytes through the real
+ *   parser without touching the live binary. Production callers omit it.
+ * - `close()` closes stdin (signals EOF to claude) and awaits the process
+ *   exit. The process exits cleanly ~250ms after stdin close per the findings.
+ */
+import { parseNdjsonStream } from "./event-parser.ts";
+import type { ClaudeEvent, UserTurn } from "./types/events.ts";
+
+export interface SpawnResult {
+  stdout: ReadableStream<Uint8Array>;
+  stdin: WritableStream<Uint8Array>;
+  exited: Promise<number>;
+  kill: () => void;
+}
+
+export type SpawnFn = (cmd: string[], opts: { cwd?: string }) => SpawnResult;
+
+export interface SubscribeOptions {
+  /** Working directory for the claude process. Defaults to process.cwd(). */
+  cwd?: string;
+  /** Extra CLI arguments appended after the required flags. */
+  extraArgs?: string[];
+  /**
+   * Injectable spawn function — omit in production, pass a mock in tests.
+   * See module header comment for rationale.
+   */
+  spawnFn?: SpawnFn;
+}
+
+export interface ClaudeSubscription {
+  events: AsyncIterable<ClaudeEvent>;
+  sendUserTurn: (text: string) => void;
+  close: () => Promise<number>;
+}
+
+const REQUIRED_ARGS = [
+  "--print",
+  "--verbose",
+  "--input-format",
+  "stream-json",
+  "--output-format",
+  "stream-json",
+];
+
+export function subscribeToClaude(opts: SubscribeOptions = {}): ClaudeSubscription {
+  const { cwd, extraArgs = [], spawnFn } = opts;
+
+  const spawn = spawnFn ?? defaultSpawn;
+  const spawnOpts = cwd !== undefined ? { cwd } : {};
+  const proc = spawn(["claude", ...REQUIRED_ARGS, ...extraArgs], spawnOpts);
+
+  const encoder = new TextEncoder();
+  let stdinWriter: WritableStreamDefaultWriter<Uint8Array> | null = proc.stdin.getWriter();
+
+  function sendUserTurn(text: string): void {
+    if (stdinWriter === null) return;
+    const turn: UserTurn = {
+      type: "user",
+      message: {
+        role: "user",
+        content: [{ type: "text", text }],
+      },
+    };
+    const line = `${JSON.stringify(turn)}\n`;
+    // Fire-and-forget write; errors surface as unhandled promise rejections
+    // which is acceptable for a stream writer (the process exiting will close
+    // the stream cleanly).
+    stdinWriter.write(encoder.encode(line)).catch(() => undefined);
+  }
+
+  async function close(): Promise<number> {
+    if (stdinWriter !== null) {
+      try {
+        await stdinWriter.close();
+      } catch {
+        // Already closed — ignore.
+      }
+      stdinWriter = null;
+    }
+    return proc.exited;
+  }
+
+  return {
+    events: parseNdjsonStream(proc.stdout),
+    sendUserTurn,
+    close,
+  };
+}
+
+function defaultSpawn(cmd: string[], opts: { cwd?: string }): SpawnResult {
+  const bunOpts =
+    opts.cwd !== undefined
+      ? {
+          stdin: "pipe" as const,
+          stdout: "pipe" as const,
+          stderr: "inherit" as const,
+          cwd: opts.cwd,
+        }
+      : { stdin: "pipe" as const, stdout: "pipe" as const, stderr: "inherit" as const };
+  const proc = Bun.spawn(cmd, bunOpts);
+
+  // Wrap Bun's ReadableStream and WritableStream in the standard Web streams
+  // API shapes that SpawnResult declares.
+  const stdout = proc.stdout as ReadableStream<Uint8Array>;
+  // Bun.spawn returns a FileSink for stdin when stdin: "pipe".
+  // Wrap it in a WritableStream so the surface is consistent.
+  const sink = proc.stdin;
+
+  const stdin = new WritableStream<Uint8Array>({
+    async write(chunk) {
+      await sink.write(chunk);
+    },
+    async close() {
+      await sink.end();
+    },
+    abort() {
+      sink.end();
+    },
+  });
+
+  return {
+    stdout,
+    stdin,
+    exited: proc.exited,
+    kill: () => proc.kill(),
+  };
+}