carmoji 0.3.8 → 0.3.10

package/carmoji.js

@@ -570,12 +570,27 @@ function applyTranscriptTokenRecord(state, record) {
   return state;
 }
 
+/** One transcript record's assistant prose, if it carries any. */
+function assistantTextOf(record) {
+  if (record.type === 'assistant') {
+    const texts = (record.message?.content ?? [])
+      .filter((block) => block.type === 'text' && block.text)
+      .map((block) => block.text);
+    if (texts.length) return texts.join('\n');
+  }
+  if (record.payload?.type === 'agent_message' && record.payload.message) {
+    return String(record.payload.message);
+  }
+  return undefined;
+}
+
 /**
- * Cumulative output tokens for this session, counted incrementally from the
- * Claude or Codex transcript JSONL. A per-session byte offset is cached so
- * each hook only parses lines appended since the previous one.
+ * What the transcript gained since the last hook: the session's cumulative
+ * output tokens, plus any assistant prose that appeared — the play-by-play
+ * an agent narrates between tools, and eventually the turn's reply. A
+ * per-session byte offset is cached so each hook only parses new lines.
  */
-function sessionTokens(payload) {
+function sessionTranscriptNews(payload) {
   const transcript = payload.transcript_path;
   const session = payload.session_id;
   if (!transcript || !session) return undefined;
@@ -584,6 +599,7 @@ function sessionTokens(payload) {
   try { state = JSON.parse(readFileSync(statePath, 'utf8')); } catch {}
   if (!Number.isFinite(state.offset) || state.offset < 0) state.offset = 0;
   if (!Number.isFinite(state.total) || state.total < 0) state.total = 0;
+  const texts = [];
   let size;
   try { size = statSync(transcript).size; } catch { return undefined; }
   if (size < state.offset) state = { offset: 0, total: 0 }; // truncated/rotated
@@ -598,9 +614,14 @@ function sessionTokens(payload) {
     const lastNewline = chunk.lastIndexOf(0x0a);
     if (lastNewline >= 0) {
       for (const line of chunk.subarray(0, lastNewline + 1).toString('utf8').split('\n')) {
-        if (!line.includes('"usage"') && !line.includes('"token_count"')) continue;
+        const wantsTokens = line.includes('"usage"') || line.includes('"token_count"');
+        const wantsText = line.includes('"assistant"') || line.includes('agent_message');
+        if (!wantsTokens && !wantsText) continue;
         try {
-          applyTranscriptTokenRecord(state, JSON.parse(line));
+          const record = JSON.parse(line);
+          if (wantsTokens) applyTranscriptTokenRecord(state, record);
+          const text = assistantTextOf(record);
+          if (text && text.trim().length >= 20) texts.push(text);
         } catch { /* ignore malformed lines */ }
       }
       state.offset += lastNewline + 1;
@@ -608,12 +629,48 @@ function sessionTokens(payload) {
       writeFileSync(statePath, JSON.stringify(state));
     }
   }
-  return state.total;
+  return { total: state.total, texts };
+}
+
+/**
+ * The agent's final say for the turn. Hooks never carry assistant text,
+ * but Stop hands over transcript_path, and the JSONL's tail holds the
+ * reply — Claude records {type:"assistant", message:{content:[{type:
+ * "text",text}]}}, Codex rollouts {payload:{type:"agent_message",message}}.
+ */
+function lastAssistantText(payload) {
+  try {
+    const transcript = payload.transcript_path;
+    if (!transcript) return undefined;
+    const size = statSync(transcript).size;
+    const window = Math.min(size, 256 * 1024);
+    if (window === 0) return undefined;
+    const fd = openSync(transcript, 'r');
+    const buffer = Buffer.alloc(window);
+    const bytesRead = readSync(fd, buffer, 0, window, size - window);
+    closeSync(fd);
+    const lines = buffer.subarray(0, bytesRead).toString('utf8').split('\n');
+    for (let i = lines.length - 1; i >= 0; i -= 1) {
+      const line = lines[i];
+      if (!line.includes('"assistant"') && !line.includes('agent_message')) continue;
+      try {
+        const text = assistantTextOf(JSON.parse(line));
+        if (text) return text;
+      } catch { /* the window's first line may be cut mid-record */ }
+    }
+  } catch { /* no transcript, no say */ }
+  return undefined;
 }
 
 const TEST_EVENTS = {
   start: { event: 'session_start' },
-  prompt: { event: 'prompt' },
+  prompt: { event: 'prompt', detail: 'Fix the corner release bug' },
+  say: { event: 'turn_done',
+         detail: 'Done — corners now release on yaw alone with an 8s cap, '
+           + 'and cornerEnded bypasses every gate so the lean never sticks.' },
+  note: { event: 'agent_note',
+          detail: 'Found it — the release threshold on lateral was 0.078g, '
+            + 'which a hand never settles under. Trying a yaw-only exit next.' },
   edit: { event: 'tool_start', tool: 'Edit' },
   read: { event: 'tool_start', tool: 'Read' },
   run: { event: 'tool_start', tool: 'Bash' },
@@ -1377,23 +1434,49 @@ async function main() {
         // sum across them instead of showing whichever reported last.
         const message = { source, session: payload.session_id,
                           host: hostname(), ...event };
-        // Claude and Codex transcripts power the tok/s readout; other formats
-        // quietly produce no token changes.
-        const tokens = sessionTokens(payload);
-        if (tokens !== undefined) message.tokens = tokens;
+        // Claude and Codex transcripts power the tok/s readout and the
+        // play-by-play; other formats quietly produce neither.
+        const news = sessionTranscriptNews(payload);
+        if (news?.total !== undefined) message.tokens = news.total;
         // Gemini and Trae hooks carry no cwd — the hook itself runs in the
         // project directory, so fall back to that.
         const cwd = payload.cwd || process.cwd();
         if (cwd) message.project = basename(cwd);
-        // A snippet of human-readable context for the phone to show.
+
+        // Prose keeps its newlines and is clipped only when abnormally
+        // long; the one-line permission caption stays terse.
+        const clip = (text, cap) =>
+          String(text).replace(/[ \t]+/g, ' ').trim().slice(0, cap);
+
+        // On Stop the newest text block is the turn's reply; anything
+        // before it — and everything on other hooks — is mid-procedure
+        // narration, shipped as agent_note for the live play-by-play.
+        const newTexts = news?.texts ?? [];
+        const isTurnDone = event.event === 'turn_done';
+        const noteTexts = isTurnDone ? newTexts.slice(0, -1) : newTexts;
+        for (const text of noteTexts.slice(-4)) {
+          await sendAll(devices, { source, session: payload.session_id,
+                                   host: hostname(), project: message.project,
+                                   event: 'agent_note',
+                                   detail: clip(text, 2000) });
+        }
+
+        // A snippet of human-readable context for the phone to show. The
+        // turn's reply gets room — it feeds the reviewable chat history,
+        // not just a caption — with the tail-window read as fallback when
+        // the incremental scan saw nothing new.
         const detail = event.event === 'prompt'
           ? firstString(payload.prompt, payload.user_prompt, payload.userPrompt,
                         payload.message, payload.input, payload.text)
           : event.event === 'permission'
             ? firstString(payload.message, payload.detail,
                           payload.tool_input ? summarizeToolInput(payload) : undefined)
-            : undefined;
-        if (detail) message.detail = String(detail).replace(/\s+/g, ' ').slice(0, 140);
+            : isTurnDone
+              ? (newTexts[newTexts.length - 1] ?? lastAssistantText(payload))
+              : undefined;
+        const detailCap = isTurnDone ? 2000
+          : event.event === 'prompt' ? 1000 : 140;
+        if (detail) message.detail = clip(detail, detailCap);
         // Plan-window usage comes from Claude Code's local transcripts;
         // recompute only at turn boundaries.
         if (source === 'claude') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carmoji",
-  "version": "0.3.8",
+  "version": "0.3.10",
   "description": "Bring your CarMoji pet to life from Claude Code / Codex — a LAN bridge that streams coding events to the CarMoji iOS app",
   "type": "module",
   "bin": {