tanuki-telemetry 1.4.1 → 1.4.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tanuki-telemetry",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Workflow monitor and telemetry dashboard for Claude Code autonomous agents",
   "type": "module",
   "bin": {

package/skills/commands/record.md

@@ -0,0 +1,55 @@
+---
+description: |
+  Record an agent-browser session as MP4 video. Start recording, perform actions, stop to encode.
+  Videos can be uploaded to telemetry as artifacts.
+allowed-tools: Bash, mcp__telemetry__log_artifact
+---
+
+# /record — Record Agent Browser Session
+
+Records agent-browser screenshots at regular intervals and encodes them into an MP4 video.
+
+## Usage
+
+- `/record` or `/record start` — Start recording (1 frame/sec)
+- `/record start 500` — Start recording at 2 fps (500ms interval)
+- `/record stop` — Stop and encode to MP4
+- `/record stop --upload` — Stop, encode, and upload to telemetry
+- `/record status` — Check recording status
+
+## On Invoke
+
+Parse the argument. Default action is "start".
+
+### Start
+```bash
+~/.claude/scripts/record-browser.sh start "/tmp/browser-recording-$(date +%Y%m%d-%H%M%S).mp4" ${INTERVAL:-1000}
+```
+Then tell the user: "Recording started. Perform your actions, then run `/record stop` when done."
+
+### Stop
+```bash
+~/.claude/scripts/record-browser.sh stop
+```
+The script outputs the path to the MP4 file.
+
+If `--upload` flag is present and a telemetry session is active, upload as artifact:
+```
+mcp__telemetry__log_artifact({
+  session_id: current_session_id,
+  file_path: "/tmp/browser-recording-*.mp4",
+  artifact_type: "recording",
+  description: "Agent browser session recording"
+})
+```
+
+### Status
+```bash
+~/.claude/scripts/record-browser.sh status
+```
+
+## Tips
+- Start recording BEFORE navigating to the page you want to capture
+- Higher fps (lower interval) = smoother video but larger file
+- Default 1fps is good for demos, use 500ms for smoother action
+- Videos are saved to /tmp/ by default — upload to telemetry for persistence

package/skills/scripts/record-browser.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+# Record agent-browser session as MP4 video
+# Usage: record-browser.sh start [output.mp4] [interval_ms]
+#        record-browser.sh stop
+#        record-browser.sh status
+
+PIDFILE="/tmp/browser-recorder.pid"
+FRAMEDIR="/tmp/browser-recording-frames"
+DEFAULT_OUTPUT="/tmp/browser-recording-$(date +%Y%m%d-%H%M%S).mp4"
+DEFAULT_INTERVAL=1000  # 1 screenshot per second
+
+case "${1:-status}" in
+  start)
+    OUTPUT="${2:-$DEFAULT_OUTPUT}"
+    INTERVAL="${3:-$DEFAULT_INTERVAL}"
+
+    if [ -f "$PIDFILE" ] && kill -0 "$(cat "$PIDFILE")" 2>/dev/null; then
+      echo "Recording already in progress (PID $(cat "$PIDFILE"))"
+      exit 0
+    fi
+
+    rm -rf "$FRAMEDIR"
+    mkdir -p "$FRAMEDIR"
+
+    # Background process: take screenshots at interval
+    (
+      FRAME=0
+      while true; do
+        PADDED=$(printf "%06d" $FRAME)
+        agent-browser screenshot "$FRAMEDIR/frame-${PADDED}.png" 2>/dev/null
+        if [ $? -ne 0 ]; then
+          sleep 1
+          continue
+        fi
+        FRAME=$((FRAME + 1))
+        sleep "$(echo "scale=3; $INTERVAL/1000" | bc)"
+      done
+    ) &
+
+    echo $! > "$PIDFILE"
+    echo "$OUTPUT" > /tmp/browser-recording-output
+    echo "Recording started (PID $!) → $OUTPUT"
+    echo "Taking screenshots every ${INTERVAL}ms"
+    echo "Run: record-browser.sh stop  — to finish and create video"
+    ;;
+
+  stop)
+    if [ ! -f "$PIDFILE" ]; then
+      echo "No recording in progress"
+      exit 1
+    fi
+
+    PID=$(cat "$PIDFILE")
+    kill "$PID" 2>/dev/null
+    wait "$PID" 2>/dev/null
+    rm -f "$PIDFILE"
+
+    OUTPUT=$(cat /tmp/browser-recording-output 2>/dev/null || echo "$DEFAULT_OUTPUT")
+    FRAME_COUNT=$(ls "$FRAMEDIR"/frame-*.png 2>/dev/null | wc -l | tr -d ' ')
+
+    if [ "$FRAME_COUNT" -eq 0 ]; then
+      echo "No frames captured — nothing to encode"
+      exit 1
+    fi
+
+    echo "Encoding $FRAME_COUNT frames → $OUTPUT"
+
+    # Use ffmpeg to create video from frames
+    ffmpeg -y -framerate 1 -i "$FRAMEDIR/frame-%06d.png" \
+      -c:v libx264 -pix_fmt yuv420p -preset fast \
+      -vf "scale=trunc(iw/2)*2:trunc(ih/2)*2" \
+      "$OUTPUT" 2>/dev/null
+
+    if [ $? -eq 0 ]; then
+      SIZE=$(du -h "$OUTPUT" | cut -f1)
+      echo "✓ Recording saved: $OUTPUT ($SIZE, $FRAME_COUNT frames)"
+      rm -rf "$FRAMEDIR"
+    else
+      echo "✗ ffmpeg encoding failed"
+      exit 1
+    fi
+    ;;
+
+  status)
+    if [ -f "$PIDFILE" ] && kill -0 "$(cat "$PIDFILE")" 2>/dev/null; then
+      FRAME_COUNT=$(ls "$FRAMEDIR"/frame-*.png 2>/dev/null | wc -l | tr -d ' ')
+      OUTPUT=$(cat /tmp/browser-recording-output 2>/dev/null)
+      echo "Recording in progress (PID $(cat "$PIDFILE"))"
+      echo "  Frames captured: $FRAME_COUNT"
+      echo "  Output: $OUTPUT"
+    else
+      echo "Not recording"
+      rm -f "$PIDFILE" 2>/dev/null
+    fi
+    ;;
+
+  *)
+    echo "Usage: record-browser.sh [start|stop|status] [output.mp4] [interval_ms]"
+    ;;
+esac