Files

meeech 211d2b5877 docs: convert all skill instructions from npm to pnpm

Batch update 62 files across .claude/skills/ — SKILL.md, REMOVE.md,
and script files. Conversions: npm run -> pnpm run, npm install ->
pnpm install, npx -> pnpm exec/dlx, npm uninstall -> pnpm uninstall,
package-lock.json -> pnpm-lock.yaml, shebangs updated.

2026-04-17 09:22:45 +03:00

2.9 KiB

Raw Blame History

name, description

name	description
add-reactions	Add WhatsApp emoji reaction support — receive, send, store, and search reactions.

Add Reactions

This skill adds emoji reaction support to NanoClaw's WhatsApp channel: receive and store reactions, send reactions from the container agent via MCP tool, and query reaction history from SQLite.

Phase 1: Pre-flight

Check if already applied

Check if src/status-tracker.ts exists:

test -f src/status-tracker.ts && echo "Already applied" || echo "Not applied"

If already applied, skip to Phase 3 (Verify).

Phase 2: Apply Code Changes

Ensure WhatsApp fork remote

git remote -v

If whatsapp is missing, add it:

git remote add whatsapp https://github.com/qwibitai/nanoclaw-whatsapp.git

Merge the skill branch

git fetch whatsapp skill/reactions
git merge whatsapp/skill/reactions || {
  git checkout --theirs pnpm-lock.yaml
  git add pnpm-lock.yaml
  git merge --continue
}

This adds:

scripts/migrate-reactions.ts (database migration for reactions table with composite PK and indexes)
src/status-tracker.ts (forward-only emoji state machine for message lifecycle signaling, with persistence and retry)
src/status-tracker.test.ts (unit tests for StatusTracker)
container/skills/reactions/SKILL.md (agent-facing documentation for the react_to_message MCP tool)
Reaction support in src/db.ts, src/channels/whatsapp.ts, src/types.ts, src/ipc.ts, src/index.ts, src/group-queue.ts, and container/agent-runner/src/ipc-mcp-stdio.ts

Run database migration

pnpm exec tsx scripts/migrate-reactions.ts

Validate code changes

pnpm test
pnpm run build

All tests must pass and build must be clean before proceeding.

Phase 3: Verify

Build and restart

pnpm run build

Linux:

systemctl --user restart nanoclaw

macOS:

launchctl kickstart -k gui/$(id -u)/com.nanoclaw

Test receiving reactions

Send a message from your phone
React to it with an emoji on WhatsApp
Check the database:

sqlite3 store/messages.db "SELECT * FROM reactions ORDER BY timestamp DESC LIMIT 5;"

Test sending reactions

Ask the agent to react to a message via the react_to_message MCP tool. Check your phone — the reaction should appear on the message.

Troubleshooting

Reactions not appearing in database

Check NanoClaw logs for Failed to process reaction errors
Verify the chat is registered
Confirm the service is running

Migration fails

Ensure store/messages.db exists and is accessible
If "table reactions already exists", the migration already ran — skip it

Agent can't send reactions

Check IPC logs for Unauthorized IPC reaction attempt blocked — the agent can only react in its own group's chat
Verify WhatsApp is connected: check logs for connection status

2.9 KiB Raw Blame History