@yc-tech/agent-connect-bot

Telegram bot, Fastify management API, hook router, and SQLite-backed runtime state for Agent Connect.

This package ships both:

• The full service (used internally by @yc-tech/agent-connect-cli — most users want the CLI, not this package directly).
• A small library surface for advanced embedding scenarios.

Library exports

import { runHookClient } from "@yc-tech/agent-connect-bot/hookClient";
import { installAllHooks } from "@yc-tech/agent-connect-bot/hookInstaller";
import { runBotService } from "@yc-tech/agent-connect-bot/service";

| Export | Purpose | |---|---| | . | High-level entry (main) used by the CLI. | | ./hookClient | Reads a Claude/Codex hook payload from stdin and POSTs it to a running bot. | | ./hookInstaller | Writes ~/.claude/settings.json and ~/.codex/hooks.json so agents fire agc hook per event. | | ./service | Starts the Fastify server, multi-bot runtime, SessionRegistry, HookRouter. |

Architecture

Telegram Forum Topic
  → thread_bindings (SQLite)
  → tmux window ID
  → Claude / Codex session
  → agent hook → POST /hook/events
  → HookRouter (per-window queue)
  → drainTranscript (per-session lock, reads transcript from offset)
  → MessageQueueManager → Telegram

See the main README for the full design.

Requirements

• Node.js >= 22
• tmux available on $PATH
• Native deps: better-sqlite3 (prebuilt binaries for most platforms) and sharp

License

MIT — see LICENSE.