claude-code-kanban 3.10.0 → 4.1.0

package/lib/parsers.js

@@ -118,16 +118,23 @@ const TOOL_RESULT_MAX = 1500;
 const USER_TEXT_MAX = 500;
 const INTERRUPT_MARKER = '[Request interrupted by user]';
 
-function pushUserMessage(messages, text, timestamp, sysLabel) {
+function pushUserMessage(messages, text, timestamp, sysLabel, extras) {
   if (sysLabel === '__skip__') return;
-  const truncated = text.length > USER_TEXT_MAX;
-  messages.push({
+  const safeText = text || '';
+  const truncated = safeText.length > USER_TEXT_MAX;
+  const msg = {
     type: 'user',
-    text: truncated ? text.slice(0, USER_TEXT_MAX) + '...' : text,
-    fullText: truncated ? text : null,
+    text: truncated ? safeText.slice(0, USER_TEXT_MAX) + '...' : safeText,
+    fullText: truncated ? safeText : null,
     timestamp,
     ...(sysLabel && { systemLabel: sysLabel })
-  });
+  };
+  if (extras) {
+    if (extras.uuid) msg.uuid = extras.uuid;
+    if (extras.images && extras.images.length) msg.images = extras.images;
+    if (extras.toolResultRefs && extras.toolResultRefs.length) msg.toolResultRefs = extras.toolResultRefs;
+  }
+  messages.push(msg);
 }
 
 // Cache: jsonlPath -> { scannedUpTo, customTitle }
@@ -532,16 +539,19 @@ function readRecentMessages(jsonlPath, limit = 10) {
               }
               pushUserMessage(messages, t, obj.timestamp, getSystemMessageLabel(t));
             } else if (Array.isArray(obj.message.content)) {
-              const joined = obj.message.content
-                .filter(b => b.type === 'text' && typeof b.text === 'string' && b.text)
-                .map(b => b.text)
-                .join('\n')
-                .trim();
-              if (joined && joined !== INTERRUPT_MARKER) {
-                pushUserMessage(messages, joined, obj.timestamp, getSystemMessageLabel(joined));
-              }
-              for (const block of obj.message.content) {
-                if (block.type === 'tool_result' && block.tool_use_id) {
+              const texts = [];
+              const images = [];
+              const toolResultRefs = [];
+              obj.message.content.forEach((block, idx) => {
+                if (block.type === 'text' && typeof block.text === 'string' && block.text) {
+                  texts.push(block.text);
+                } else if (block.type === 'image' && block.source && block.source.type === 'base64') {
+                  images.push({
+                    blockIndex: idx,
+                    mediaType: block.source.media_type || 'image/png',
+                    dataLen: typeof block.source.data === 'string' ? block.source.data.length : 0
+                  });
+                } else if (block.type === 'tool_result' && block.tool_use_id) {
                   let resultText = '';
                   if (typeof block.content === 'string') {
                     resultText = block.content;
@@ -554,7 +564,23 @@ function readRecentMessages(jsonlPath, limit = 10) {
                   if (resultText) {
                     toolResults.set(block.tool_use_id, resultText);
                   }
+                  toolResultRefs.push({
+                    toolUseId: block.tool_use_id,
+                    preview: resultText ? resultText.slice(0, 200) : ''
+                  });
                 }
+              });
+              const joined = texts.join('\n').trim();
+              const hasText = joined && joined !== INTERRUPT_MARKER;
+              const hasImages = images.length > 0;
+              if (hasText || hasImages) {
+                pushUserMessage(
+                  messages,
+                  joined,
+                  obj.timestamp,
+                  getSystemMessageLabel(joined),
+                  { uuid: obj.uuid, images, toolResultRefs: hasText ? toolResultRefs : [] }
+                );
               }
             }
           }
@@ -620,6 +646,31 @@ function readFullToolResult(jsonlPath, toolUseId) {
   return null;
 }
 
+function readUserImage(jsonlPath, msgUuid, blockIndex) {
+  if (!msgUuid || !jsonlPath) return null;
+  const idx = Number(blockIndex);
+  if (!Number.isInteger(idx) || idx < 0) return null;
+  try {
+    const content = readFileSync(jsonlPath, 'utf8');
+    const lines = content.split('\n');
+    for (const line of lines) {
+      if (!line || line.indexOf(msgUuid) === -1) continue;
+      try {
+        const obj = JSON.parse(line);
+        if (obj?.uuid !== msgUuid) continue;
+        if (!Array.isArray(obj?.message?.content)) continue;
+        const block = obj.message.content[idx];
+        if (!block || block.type !== 'image' || !block.source || block.source.type !== 'base64') return null;
+        return {
+          mediaType: block.source.media_type || 'image/png',
+          data: block.source.data
+        };
+      } catch (_) {}
+    }
+  } catch (_) {}
+  return null;
+}
+
 function readMessagesPage(jsonlPath, limit = 10, beforeTimestamp = null) {
   const fetchLimit = limit + 1;
   const applyFilter = beforeTimestamp
@@ -913,6 +964,7 @@ module.exports = {
   readRecentMessages,
   readMessagesPage,
   readFullToolResult,
+  readUserImage,
   buildAgentProgressMap,
   buildSessionDigest,
   readCompactSummaries,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-kanban",
-  "version": "3.10.0",
+  "version": "4.1.0",
   "description": "A web-based Kanban board for viewing Claude Code tasks with agent teams support",
   "main": "server.js",
   "bin": {

package/plugin/plugins/claude-code-kanban/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "claude-code-kanban",
-  "version": "1.1.5",
+  "version": "2.1.0",
   "description": "Agent activity tracking for claude-code-kanban dashboard"
 }

package/plugin/plugins/claude-code-kanban/hooks/hooks.json

@@ -70,6 +70,16 @@
             "timeout": 5
           }
         ]
+      },
+      {
+        "matcher": "ExitPlanMode",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/agent-spy.sh",
+            "timeout": 5
+          }
+        ]
       }
     ],
     "PostToolUse": [

package/plugin/plugins/claude-code-kanban/scripts/agent-spy.sh

@@ -1,6 +1,7 @@
 #!/bin/bash
-# Tracks subagent lifecycle: one JSON file per agent, grouped by session
-# Layout: ~/.claude/.cck/agent-activity/{sessionId}/{agentId}.json
+# Tracks subagent lifecycle: one append-only JSONL file per agent, grouped by session
+# Layout: ~/.claude/.cck/agent-activity/{sessionId}/{agentId}.jsonl
+# Each line is a lifecycle event (start | idle | stop). Server folds last-line-wins.
 
 INPUT=$(cat)
 
@@ -37,17 +38,17 @@ if [ "$EVENT" = "SessionStart" ]; then
 fi
 
 # PostToolUse / non-waiting PreToolUse: clear waiting state
-if [ "$EVENT" = "PostToolUse" ] || { [ "$EVENT" = "PreToolUse" ] && [ "$TOOL_NAME" != "AskUserQuestion" ]; }; then
+if [ "$EVENT" = "PostToolUse" ] || { [ "$EVENT" = "PreToolUse" ] && [ "$TOOL_NAME" != "AskUserQuestion" ] && [ "$TOOL_NAME" != "ExitPlanMode" ]; }; then
   WFILE="$CCK_ACTIVITY/$SESSION_ID/_waiting.json"
   rm -f "$WFILE"
   [ "$EVENT" = "PostToolUse" ] && exit 0
 fi
 
-# Plan mode tools don't fire PostToolUse — skip to avoid stale markers
-[ "$TOOL_NAME" = "EnterPlanMode" ] || [ "$TOOL_NAME" = "ExitPlanMode" ] && exit 0
+# EnterPlanMode has no waiting semantics — skip
+[ "$TOOL_NAME" = "EnterPlanMode" ] && exit 0
 
 # Waiting-for-user events → write _waiting.json marker
-if [ "$EVENT" = "PermissionRequest" ] || { [ "$EVENT" = "PreToolUse" ] && [ "$TOOL_NAME" = "AskUserQuestion" ]; }; then
+if [ "$EVENT" = "PermissionRequest" ] || { [ "$EVENT" = "PreToolUse" ] && { [ "$TOOL_NAME" = "AskUserQuestion" ] || [ "$TOOL_NAME" = "ExitPlanMode" ]; }; }; then
   DIR="$CCK_ACTIVITY/$SESSION_ID"
   mkdir -p "$DIR"
   KIND="permission"
@@ -70,23 +71,16 @@ if [ "$EVENT" = "TeammateIdle" ] && [ -z "$AGENT_ID" ] && [ -n "$TEAMMATE_NAME"
   [ ! -f "$MAP_FILE" ] && exit 0
   AGENT_ID=$(cat "$MAP_FILE")
   [ -z "$AGENT_ID" ] && exit 0
-  FILE="$DIR/$AGENT_ID.json"
+  FILE="$DIR/$AGENT_ID.jsonl"
   TS=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-  STARTED_AT="$TS"
-  if [ -f "$FILE" ]; then
-    PREV_START=$(jq -r '.startedAt // ""' "$FILE" 2>/dev/null)
-    [ -n "$PREV_START" ] && STARTED_AT="$PREV_START"
-  fi
-  cat > "$FILE" <<EOF
-{"agentId":"$AGENT_ID","type":"$TEAMMATE_NAME","status":"idle","startedAt":"$STARTED_AT","updatedAt":"$TS"}
-EOF
+  echo "{\"agentId\":\"$AGENT_ID\",\"type\":\"$TEAMMATE_NAME\",\"event\":\"idle\",\"status\":\"idle\",\"updatedAt\":\"$TS\"}" >> "$FILE"
   exit 0
 fi
 
 [ -z "$AGENT_ID" ] && exit 0
 
 DIR="$CCK_ACTIVITY/$SESSION_ID"
-FILE="$DIR/$AGENT_ID.json"
+FILE="$DIR/$AGENT_ID.jsonl"
 
 # On Start: skip if no type (internal agents like AskUserQuestion)
 # On Stop/Idle: only skip if no existing file (never tracked)
@@ -102,48 +96,19 @@ mkdir -p "$DIR"
 TS=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
 
 if [ "$EVENT" = "SubagentStart" ]; then
-  cat > "$FILE" <<EOF
-{"agentId":"$AGENT_ID","type":"$AGENT_TYPE_RAW","status":"active","startedAt":"$TS","updatedAt":"$TS"}
-EOF
-  # Write name→id mapping for TeammateIdle resolution
-  # Delete previous file only if not active (idle/stopped = teammate re-spawn, active = parallel subagent)
+  echo "{\"agentId\":\"$AGENT_ID\",\"type\":\"$AGENT_TYPE_RAW\",\"event\":\"start\",\"status\":\"active\",\"startedAt\":\"$TS\",\"updatedAt\":\"$TS\"}" >> "$FILE"
+  # Mapping always points at latest agent of this type (used by TeammateIdle resolution).
   if [ -n "$AGENT_TYPE_RAW" ]; then
-    MAP_FILE="$DIR/_name-${AGENT_TYPE_RAW}.id"
-    if [ -f "$MAP_FILE" ]; then
-      OLD_ID=$(cat "$MAP_FILE")
-      if [ -n "$OLD_ID" ] && [ "$OLD_ID" != "$AGENT_ID" ]; then
-        OLD_FILE="$DIR/$OLD_ID.json"
-        OLD_STATUS=""
-        [ -f "$OLD_FILE" ] && OLD_STATUS=$(jq -r '.status // ""' "$OLD_FILE" 2>/dev/null)
-        [ "$OLD_STATUS" != "active" ] && rm -f "$OLD_FILE"
-      fi
-    fi
-    echo -n "$AGENT_ID" > "$MAP_FILE"
+    echo -n "$AGENT_ID" > "$DIR/_name-${AGENT_TYPE_RAW}.id"
   fi
 
 elif [ "$EVENT" = "SubagentStop" ]; then
-  AGENT_TYPE="$AGENT_TYPE_RAW"
-  STARTED_AT="$TS"
-  if [ -f "$FILE" ]; then
-    eval "$(jq -r '@sh "PREV_TYPE=\(.type // "unknown")", @sh "PREV_START=\(.startedAt // "")"' "$FILE")"
-    [ -z "$AGENT_TYPE" ] && AGENT_TYPE="$PREV_TYPE"
-    [ -n "$PREV_START" ] && STARTED_AT="$PREV_START"
-  fi
   echo "$INPUT" | jq -c \
-    --arg id "$AGENT_ID" --arg type "$AGENT_TYPE" --arg started "$STARTED_AT" --arg ts "$TS" \
-    '{agentId: $id, type: $type, status: "stopped", startedAt: $started,
+    --arg id "$AGENT_ID" --arg type "$AGENT_TYPE_RAW" --arg ts "$TS" \
+    '{agentId: $id, type: $type, event: "stop", status: "stopped",
       lastMessage: (.last_assistant_message // ""), stoppedAt: $ts, updatedAt: $ts}' \
-    > "$FILE"
+    >> "$FILE"
 
 elif [ "$EVENT" = "TeammateIdle" ]; then
-  AGENT_TYPE="$AGENT_TYPE_RAW"
-  STARTED_AT="$TS"
-  if [ -f "$FILE" ]; then
-    eval "$(jq -r '@sh "PREV_TYPE=\(.type // "unknown")", @sh "PREV_START=\(.startedAt // "")"' "$FILE")"
-    [ -z "$AGENT_TYPE" ] && AGENT_TYPE="$PREV_TYPE"
-    [ -n "$PREV_START" ] && STARTED_AT="$PREV_START"
-  fi
-  cat > "$FILE" <<EOF
-{"agentId":"$AGENT_ID","type":"$AGENT_TYPE","status":"idle","startedAt":"$STARTED_AT","updatedAt":"$TS"}
-EOF
+  echo "{\"agentId\":\"$AGENT_ID\",\"type\":\"$AGENT_TYPE_RAW\",\"event\":\"idle\",\"status\":\"idle\",\"updatedAt\":\"$TS\"}" >> "$FILE"
 fi