feat: add plugin system with events and hooks

[steven1522]

Summary

Add a lightweight plugin system to TinyClaw that enables:

• Events: Broadcast state changes so plugins can visualize (e.g., 3D avatar watching Claude work)
• Hooks: Transform messages between LLM and channels (e.g., convert **bold** to channel-specific formatting)

Plugins auto-discover from .tinyclaw/plugins/ folder.

Changes

Plugin System (new)

• src/lib/plugins.ts - Core plugin loader, event broadcasting, and hook runner
• Plugins export activate(ctx) function and/or hooks object from index.ts
• Events broadcast to registered handlers when emitEvent() is called
• Hooks can return metadata (e.g., parseMode: 'MarkdownV2' for Telegram)

Integration

• src/lib/logging.ts - Broadcasts events to plugin handlers
• src/queue-processor.ts - Loads plugins at startup, runs incoming/outgoing hooks
• src/channels/telegram-client.ts - Supports metadata.parseMode for rich formatting
• src/lib/types.ts - Added metadata field to ResponseData

Bug Fixes (found during testing)

• src/lib/invoke.ts - Strip CLAUDECODE env var so CLI works inside Claude Code sessions
• .agents/.../send_message.ts - Remove message truncation, let channel clients chunk
• src/queue-processor.ts - Remove handleLongResponse() truncation

Other

• .gitignore - Expanded patterns for runtime files, secrets, plugins

Plugin API

// .tinyclaw/plugins/my-plugin/index.ts
import type { PluginContext, Hooks } from '../../src/lib/plugins';

// Subscribe to events
export function activate(ctx: PluginContext): void {
  ctx.on('chain_step_start', (e) => { /* agent thinking */ });
  ctx.on('response_ready', (e) => { /* agent done */ });
}

// Transform messages
export const hooks: Hooks = {
  transformOutgoing(message, ctx) {
    if (ctx.channel !== 'telegram') return message;
    return { text: formatted, metadata: { parseMode: 'MarkdownV2' } };
  }
};

Test Plan

• Build compiles without errors
• Tested on separate device with Telegram channel
• Long messages properly chunked into multiple sends
• Plugin loading works with empty/missing plugins folder

[jlia0]

@codex review this PR for adding plugin system

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.