Files
nanoclaw/.claude/skills/add-telegram/modify/src/index.ts.intent.md
gavrielc 51788de3b9 Skills engine v0.1 + multi-channel infrastructure (#307)
* refactor: multi-channel infrastructure with explicit channel/is_group tracking

- Add channels[] array and findChannel() routing in index.ts, replacing
  hardcoded whatsapp.* calls with channel-agnostic callbacks
- Add channel TEXT and is_group INTEGER columns to chats table with
  COALESCE upsert to protect existing values from null overwrites
- is_group defaults to 0 (safe: unknown chats excluded from groups)
- WhatsApp passes explicit channel='whatsapp' and isGroup to onChatMetadata
- getAvailableGroups filters on is_group instead of JID pattern matching
- findChannel logs warnings instead of silently dropping unroutable JIDs
- Migration backfills channel/is_group from JID patterns for existing DBs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: skills engine v0.1 — deterministic skill packages with rerere resolution

Three-way merge engine for applying skill packages on top of a core
codebase. Skills declare which files they add/modify, and the engine
uses git merge-file for conflict detection with git rerere for
automatic resolution of previously-seen conflicts.

Key components:
- apply: three-way merge with backup/rollback safety net
- replay: clean-slate replay for uninstall and rebase
- update: core version updates with deletion detection
- rebase: bake applied skills into base (one-way)
- manifest: validation with path traversal protection
- resolution-cache: pre-computed rerere resolutions
- structured: npm deps, env vars, docker-compose merging
- CI: per-skill test matrix with conflict detection

151 unit tests covering merge, rerere, backup, replay, uninstall,
update, rebase, structured ops, and edge cases.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add Discord and Telegram skill packages

Skill packages for adding Discord and Telegram channels to NanoClaw.
Each package includes:
- Channel implementation (add/src/channels/)
- Three-way merge targets for index.ts, config.ts, routing.test.ts
- Intent docs explaining merge invariants
- Standalone integration tests
- manifest.yaml with dependency/conflict declarations

Applied via: npx tsx scripts/apply-skill.ts .claude/skills/add-discord
These are inert until applied — no runtime impact.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* remove unused docs (skills-system-status, implementation-guide)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-19 01:55:00 +02:00

2.2 KiB

Intent: src/index.ts modifications

What changed

Refactored from single WhatsApp channel to multi-channel architecture using the Channel interface.

Key sections

Imports (top of file)

  • Added: TelegramChannel from ./channels/telegram.js
  • Added: TELEGRAM_BOT_TOKEN, TELEGRAM_ONLY from ./config.js
  • Added: findChannel from ./router.js
  • Added: Channel type from ./types.js

Module-level state

  • Added: const channels: Channel[] = [] — array of all active channels
  • Kept: let whatsapp: WhatsAppChannel — still needed for syncGroupMetadata reference

processGroupMessages()

  • Added: findChannel(channels, chatJid) lookup at the start
  • Changed: whatsapp.setTyping()channel.setTyping?.() (optional chaining)
  • Changed: whatsapp.sendMessage()channel.sendMessage() in output callback

getAvailableGroups()

  • Unchanged: uses c.is_group filter from base (Telegram channels pass isGroup=true via onChatMetadata)

startMessageLoop()

  • Added: findChannel(channels, chatJid) lookup per group in message processing
  • Changed: whatsapp.setTyping()channel.setTyping?.() for typing indicators

main()

  • Changed: shutdown disconnects all channels via for (const ch of channels)
  • Added: shared channelOpts object for channel callbacks
  • Added: conditional WhatsApp creation (if (!TELEGRAM_ONLY))
  • Added: conditional Telegram creation (if (TELEGRAM_BOT_TOKEN))
  • Changed: scheduler sendMessage uses findChannel()channel.sendMessage()
  • Changed: IPC sendMessage uses findChannel()channel.sendMessage()

Invariants

  • All existing message processing logic (triggers, cursors, idle timers) is preserved
  • The runAgent function is completely unchanged
  • State management (loadState/saveState) is unchanged
  • Recovery logic is unchanged
  • Apple Container check is unchanged (ensureContainerSystemRunning)

Must-keep

  • The escapeXml and formatMessages re-exports
  • The _setRegisteredGroups test helper
  • The isDirectRun guard at bottom
  • All error handling and cursor rollback logic in processGroupMessages
  • The outgoing queue flush and reconnection logic (in WhatsAppChannel, not here)