flynn/CHANGELOG.md

# Changelog

All notable changes to Flynn are documented in this file.

## [Unreleased]

### Added

- **Agent Tool: file.patch** -- Multi-file, multi-hunk structured patch tool. Apply
  line-based replacements, insertions, and deletions across multiple files in a single
  tool call. Hunks are applied bottom-up to preserve line numbers. 10 tests.
- **Gmail Pub/Sub Watcher** -- Automation source monitoring Gmail via Google Cloud
  Pub/Sub push notifications with polling fallback. OAuth2 auth, configurable watch
  labels, template rendering with email metadata placeholders (`{{from}}`, `{{subject}}`,
  `{{snippet}}`, `{{date}}`, `{{id}}`, `{{labels}}`). Wired into daemon lifecycle and
  gateway (`POST /gmail/push` endpoint). 16 tests.
- **Inbound Webhooks** -- HTTP endpoints (`POST /webhooks/:name`) that trigger agent
  processing. Config-driven with per-webhook HMAC signature verification, message
  template rendering (`{{body}}`, `{{json.field}}`), and output channel routing.
  Bypasses gateway token auth in favour of per-webhook secrets.
- **Heartbeat Monitor** -- Periodic health check system with 5 configurable checks:
  gateway responsiveness, model router status, channel adapter connectivity, memory
  store accessibility, and disk space. Sends failure notifications after a configurable
  threshold and recovery notifications when health restores.
- **Vector Memory Search** -- Hybrid keyword + semantic search for the memory system.
  Provider-agnostic embeddings (OpenAI, Gemini, Ollama, llama.cpp) stored in SQLite
  with brute-force cosine similarity. Background indexer processes dirty namespaces
  every 30s. Configurable hybrid weighting (0.0 = keyword only, 1.0 = vector only).
  Graceful fallback to keyword search when embeddings are unavailable.
- **Docker Deployment** -- Multi-stage Dockerfile (node:22-alpine build + runtime),
  `.dockerignore`, and `docker-compose.yml`. Native dependency handling for
  `better-sqlite3`. `FLYNN_DATA_DIR` environment variable for configurable data
  directory in container deployments.
- **Agent Tools: sessions.\*** -- 4 new agent-callable tools (`sessions.list`,
  `sessions.history`, `sessions.create`, `sessions.delete`) wrapping SessionManager
  for runtime session management by the AI agent
- **Agent Tools: agents.list** -- New tool exposing AgentConfigRegistry to the agent,
  listing all registered agent configurations with tiers, profiles, and sandbox status
- **Agent Tools: message.send** -- Cross-channel messaging tool allowing the agent to
  proactively send messages to any connected channel (Telegram, Discord, Slack, etc.)
- **Agent Tools: cron.\*** -- 2 new tools (`cron.list`, `cron.trigger`) for runtime
  cron job management, allowing the agent to list and manually trigger scheduled jobs
- **Web UI Dashboard (P7)** -- Full SPA control dashboard at the gateway web UI with
  four pages: Dashboard (health stats, channels, auto-refresh), Chat (session selector,
  streaming tool events, markdown rendering), Sessions (list, history viewer, delete),
  and Settings (hook pattern editor, tool list, config viewer). No build step — vanilla
  JS with ES modules, hash-based routing, and WebSocket JSON-RPC client with auto-reconnect.
- **Gateway: sessions.delete** -- New handler to clear a session's message history
- **Gateway: sessions.switch** -- New handler to switch a WebSocket connection to a
  different session
- **Gateway: system.channels** -- New handler listing active channel adapters and their
  connection status
- **Gateway: system.usage** -- New handler returning aggregated usage stats (uptime,
  sessions, connections, tools)
- **CLI Surface** -- Full command-line interface via `flynn` binary with 6 commands:
  `start`, `tui`, `send`, `sessions`, `doctor`, `config`
- **Doctor Diagnostics** -- `flynn doctor` validates config, YAML parsing, schema,
  env vars, data directory, session DB, model config, Telegram, MCP servers, and skills
- **Cron Scheduling** -- `automation.cron` config for scheduled agent messages with
  output channel routing (e.g. fire a prompt at 9 AM, send the response to Telegram)
- **CronScheduler Channel Adapter** -- Implements `ChannelAdapter` interface for
  cron-triggered messages through the standard agent pipeline
- **CLI Shared Utilities** -- Config loading, data dir resolution, secret redaction,
  status formatting for all CLI commands
- **CronJobConfig Type Export** -- `CronJobConfig` type available from `config/index.ts`
- **Agent Tool: system.info** -- Get current date, time, hostname, platform,
  architecture, OS release, uptime, Node.js version, memory usage, and working
  directory. Available in all tool profiles.
- **Runtime Context Injection** -- System prompt now automatically includes current
  date and time via a `# Runtime Context` section in every session
- **Local Model Tool Calling** -- Ollama and llama.cpp clients now support tool
  calling. Tools are converted to each backend's native format, tool call responses
  are parsed with generated IDs, and `stopReason` is set to `tool_use`. Ollama
  streaming also handles `thinking` fields from reasoning models (deepseek-r1,
  glm-4.7-flash). llama.cpp accumulates streaming tool call deltas across chunks.
  16 tests (8 Ollama + 8 llama.cpp).

### Changed

- **Gateway Server** -- `GatewayServerConfig` now accepts `channelRegistry` for
  channel status reporting; static file server supports `.mjs`, `.png`, `.ico`, `.woff2`
- **Entry Points Refactored** -- `src/index.ts` and `src/tui.ts` now delegate to
  the CLI module (`src/cli/index.ts`) instead of directly starting the daemon/TUI
- **Daemon Wiring** -- CronScheduler auto-registers in the channel registry when
  `automation.cron` jobs are configured; channelRegistry passed to GatewayServer

## [0.1.0] - 2026-02-05

### Added

- **Core Agent** -- NativeAgent with conversation history and iterative tool use
- **Model Providers** -- Anthropic Claude, OpenAI, Ollama, llama.cpp with streaming
- **Model Router** -- Intelligent routing with fallback chains and tier switching
- **Telegram Bot** -- Full Telegram frontend with commands, confirmations, tool status
- **Terminal UI** -- Minimal (readline) and fullscreen (React/Ink) modes with
  markdown rendering, streaming, model switching, and session transfer
- **Session Persistence** -- SQLite-backed sessions with multi-frontend support
- **Hook Engine** -- Pattern-based confirmation system for sensitive tool operations
- **Tool Framework** -- Registry, executor, and builtin tools (shell, file, web-fetch)
- **Channel Abstraction** -- Unified ChannelAdapter interface with Telegram and WebChat
- **WebSocket Gateway** -- JSON-RPC protocol with API key auth and web UI dashboard
- **MCP Integration** -- External tool server support via Model Context Protocol
- **Skills System** -- Extensible capability packages (bundled, managed, workspace tiers)
- **Config System** -- YAML config with Zod validation and env var expansion
- **Daemon Lifecycle** -- Graceful shutdown with ordered cleanup handlers