ohwow 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             ohwow
+Licensed Work:        ohwow runtime (all versions)
+Additional Use Grant: You may use the Licensed Work for any purpose, including
+                      production use, EXCEPT for building or offering a product
+                      or service that competes with ohwow.fun or its features.
+Change Date:          March 2, 2030
+Change License:       Apache License, Version 2.0
+
+For the full BSL 1.1 license text, see https://mariadb.com/bsl11/
+
+Notice
+
+The Licensed Work is (c) 2024-2026 ohwow.
+
+The full text of the Business Source License 1.1 is incorporated by reference
+from the URL above. This file states only the parameters specific to this
+project. In the event of any conflict, the full license text governs.

package/README.md

@@ -0,0 +1,147 @@
+# ohwow
+
+A local AI agent runtime. Free to use with [Ollama](https://ollama.com) for local models. Enterprise features (cloud dashboard sync, WhatsApp, Telegram, scheduling, proactive engine) unlock with an [ohwow.fun](https://ohwow.fun) subscription.
+
+## Getting Started
+
+### Install
+
+```bash
+npm install ohwow -g
+```
+
+### Requirements
+
+- Node.js 20+
+- [Ollama](https://ollama.com) (for free tier / local models)
+- Optional: Anthropic API key (for Claude models)
+- Optional: Playwright browsers (`npx playwright install chromium`) for browser automation
+- Optional: C++ compiler may be needed on some platforms for `better-sqlite3`
+
+### Launch
+
+```bash
+ohwow
+```
+
+On first launch, a setup wizard appears in your terminal. For the free tier, just point it at your Ollama instance. For enterprise features, enter your license key (from the ohwow.fun dashboard, under Settings > License) and your Anthropic API key. These are saved locally so you only do this once.
+
+After setup, the runtime opens into a TUI (terminal UI) with tabs for your dashboard, agents, tasks, approvals, activity, schedules, plans, and a chat interface. Use arrow keys or tab to navigate. Everything you see in the web dashboard is also here, running locally.
+
+### What Happens at Startup
+
+Once configured, the runtime:
+
+1. Initializes a local database
+2. Connects to ohwow.fun and syncs your agent configurations
+3. Starts the orchestrator, scheduler, and proactive engine
+4. Connects messaging channels (WhatsApp, Telegram) if you've set them up
+5. Launches a local web UI
+6. Begins polling for tasks dispatched from the dashboard
+
+From here, agents execute tasks on your hardware using your own API key. The dashboard sends the work, your machine does the thinking.
+
+## Using the Orchestrator
+
+The orchestrator is a conversational assistant built into the runtime with 40+ tools. Open the Chat tab in the TUI, or use the web UI from your browser.
+
+You can talk to it naturally. Some examples of what it can do:
+
+| What you say | What happens |
+|---|---|
+| "Run the content writer on this week's blog post" | Dispatches a task to that agent immediately |
+| "What failed today?" | Lists recent failed tasks with details |
+| "Schedule outreach every weekday at 9am" | Creates a cron schedule for the agent |
+| "Send a WhatsApp to the team: launching Friday" | Sends the message through your connected WhatsApp |
+| "Plan out researching 5 new leads this week" | Creates a multi-step plan with agent assignments, waits for your approval |
+| "Show me the business pulse" | Returns task stats, contact pipeline, costs, and streaks |
+| "Create a project for the website redesign" | Creates a project with a Kanban board |
+| "Move that task to review" | Moves a task between board columns |
+
+The orchestrator covers: agents, tasks, projects, CRM (contacts, pipeline, events), scheduling, messaging (WhatsApp + Telegram), A2A connections, goal planning, deep research, analytics, and workflows. It can also switch your TUI tabs if you ask ("go to approvals").
+
+## Features
+
+### Agent Memory
+
+After each task, key facts, skills, and feedback are extracted and stored locally. These memories are compiled into the agent's context on future tasks. Agents improve the more they work. You can view any agent's memory from the Agents tab.
+
+### Browser Automation
+
+Agents can browse the web using Playwright. Navigation, clicking, form filling, screenshots, and content extraction. The browser launches on first use and runs headless by default. Set `OHWOW_BROWSER_HEADLESS=false` to watch it work.
+
+### WhatsApp and Telegram
+
+Connect WhatsApp through a QR code scan in Settings (no Meta business API needed). Connect Telegram with a bot token. Once connected, incoming messages route to the orchestrator automatically. Your agents can reply, take action, or flag things for your attention. You control which chats are allowed.
+
+### Agent-to-Agent (A2A)
+
+Connect to external agents using the A2A protocol. Each agent publishes a card describing its capabilities. You set trust levels to control what external agents can do. Managed from the A2A tab or through the orchestrator.
+
+### Scheduling
+
+Set agents or workflows to run on cron schedules. Create schedules through conversation ("schedule the analyst every Monday at 8am") or from the Schedules tab. Toggle them on and off as needed.
+
+### Goal Planning
+
+For complex goals, the orchestrator can break them into multi-step plans with agent assignments and dependencies. Plans start as drafts. You review the steps, approve or reject, and track execution from the Plans tab.
+
+### Approval Workflows
+
+Some tasks pause for your sign-off before executing. The Approvals tab shows pending items. Approve to proceed, or reject with feedback. Rejected tasks can retry with your notes included.
+
+### Projects and CRM
+
+Organize tasks into projects with Kanban boards (backlog, todo, in progress, review, done). The built-in CRM tracks contacts (leads, customers, partners), logs events (calls, emails, meetings), and gives you pipeline analytics. All stored locally.
+
+### Local Models with Ollama
+
+If you run [Ollama](https://ollama.com) locally, the runtime can route lightweight tasks to your local model instead of Claude. Complex work still goes to Claude. If Ollama goes down, everything falls back automatically.
+
+### Web Search
+
+Agents with web search enabled can search the web during task execution, powered by Anthropic's built-in search tool.
+
+### Offline Mode
+
+If ohwow.fun becomes unreachable, the runtime continues with cached agent configs. Tasks still execute, results still store locally. When connectivity returns, everything syncs back up.
+
+## What Stays Local
+
+The runtime syncs agent configurations from ohwow.fun and reports back only operational metadata: task titles, status, token counts, and costs. Everything else stays on your machine:
+
+- Prompts and system instructions
+- Agent outputs and full conversations
+- Long-term agent memory
+- CRM contacts and activity history
+- WhatsApp and Telegram message history
+- Browser session data and screenshots
+
+This is the core of the Enterprise plan. Your business data never leaves your infrastructure.
+
+## Web UI
+
+The runtime also serves a web UI accessible from any browser on your network. Same capabilities as the TUI. Useful if you prefer a graphical interface or want to share access with your team locally.
+
+## Headless Mode
+
+For servers, containers, or always-on deployments where you don't need a terminal interface:
+
+```bash
+ohwow --headless
+```
+
+In headless mode, configure through environment variables. The web UI still runs normally. See the [configuration docs](https://ohwow.fun/docs/runtime/configuration) for available options.
+
+## Supported Models
+
+| Model | Provider |
+|-------|----------|
+| Claude Opus 4.6 | Anthropic |
+| Claude Sonnet 4.5 | Anthropic |
+| Claude Haiku 4 | Anthropic |
+| Any Ollama model | Local |
+
+## License
+
+BSL 1.1 (Business Source License). Free to use, including production. You can't use it to build a competing product. Converts to Apache 2.0 on March 2, 2030. See [LICENSE](./LICENSE) for details.

package/bin/ohwow.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/index.js');

package/dist/db/migrations/001-data-plane-tables.sql

@@ -0,0 +1,250 @@
+-- Enterprise Runtime: Data Plane Tables
+-- These are the tables whose data stays local on the customer's machine.
+-- Schema mirrors the Supabase tables but runs on SQLite.
+
+-- ============================================================================
+-- TASKS
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS agent_workforce_tasks (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT,
+  input TEXT, -- JSON
+  output TEXT, -- JSON
+  status TEXT NOT NULL DEFAULT 'pending'
+    CHECK (status IN ('pending', 'in_progress', 'completed', 'failed', 'needs_approval', 'approved', 'rejected')),
+  priority TEXT NOT NULL DEFAULT 'normal'
+    CHECK (priority IN ('low', 'normal', 'high', 'urgent')),
+  model_used TEXT,
+  tokens_used INTEGER NOT NULL DEFAULT 0,
+  cost_cents INTEGER NOT NULL DEFAULT 0,
+  scheduled_for TEXT,
+  started_at TEXT,
+  completed_at TEXT,
+  duration_seconds INTEGER,
+  requires_approval INTEGER NOT NULL DEFAULT 0,
+  approved_by TEXT,
+  approved_at TEXT,
+  rejection_reason TEXT,
+  error_message TEXT,
+  retry_count INTEGER NOT NULL DEFAULT 0,
+  max_retries INTEGER NOT NULL DEFAULT 3,
+  contact_ids TEXT NOT NULL DEFAULT '[]', -- JSON array
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_tasks_workspace ON agent_workforce_tasks(workspace_id);
+CREATE INDEX IF NOT EXISTS idx_tasks_agent ON agent_workforce_tasks(agent_id);
+CREATE INDEX IF NOT EXISTS idx_tasks_status ON agent_workforce_tasks(status);
+CREATE INDEX IF NOT EXISTS idx_tasks_created ON agent_workforce_tasks(created_at);
+
+-- ============================================================================
+-- TASK MESSAGES
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS agent_workforce_task_messages (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  task_id TEXT NOT NULL REFERENCES agent_workforce_tasks(id) ON DELETE CASCADE,
+  role TEXT NOT NULL CHECK (role IN ('user', 'assistant', 'system', 'tool')),
+  content TEXT NOT NULL,
+  metadata TEXT NOT NULL DEFAULT '{}', -- JSON
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_task_messages_task ON agent_workforce_task_messages(task_id);
+
+-- ============================================================================
+-- AGENT MEMORY
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS agent_workforce_agent_memory (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  agent_id TEXT NOT NULL,
+  workspace_id TEXT NOT NULL,
+  memory_type TEXT NOT NULL CHECK (memory_type IN ('fact', 'skill', 'feedback_positive', 'feedback_negative', 'cross_agent')),
+  content TEXT NOT NULL,
+  source_task_id TEXT,
+  source_type TEXT NOT NULL CHECK (source_type IN ('extraction', 'approval', 'rejection', 'manual', 'cross_agent')),
+  relevance_score REAL NOT NULL DEFAULT 0.5,
+  times_used INTEGER NOT NULL DEFAULT 0,
+  last_used_at TEXT,
+  token_count INTEGER NOT NULL DEFAULT 0,
+  is_active INTEGER NOT NULL DEFAULT 1,
+  superseded_by TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_memory_agent ON agent_workforce_agent_memory(agent_id);
+CREATE INDEX IF NOT EXISTS idx_memory_workspace ON agent_workforce_agent_memory(workspace_id);
+CREATE INDEX IF NOT EXISTS idx_memory_active ON agent_workforce_agent_memory(is_active);
+
+-- ============================================================================
+-- MEMORY EXTRACTION LOG
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS agent_workforce_memory_extraction_log (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  task_id TEXT,
+  trigger_type TEXT NOT NULL CHECK (trigger_type IN ('task_completed', 'task_approved', 'task_rejected')),
+  memories_extracted INTEGER NOT NULL DEFAULT 0,
+  extraction_tokens_used INTEGER NOT NULL DEFAULT 0,
+  extraction_cost_cents INTEGER NOT NULL DEFAULT 0,
+  raw_extraction TEXT, -- JSON
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ============================================================================
+-- BROWSER SESSIONS
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS agent_workforce_browser_sessions (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  agent_id TEXT NOT NULL,
+  task_id TEXT NOT NULL,
+  provider_session_id TEXT NOT NULL DEFAULT '',
+  cdp_url TEXT,
+  live_view_url TEXT,
+  status TEXT NOT NULL DEFAULT 'creating'
+    CHECK (status IN ('creating', 'active', 'idle', 'error', 'closed')),
+  current_url TEXT,
+  page_title TEXT,
+  error_message TEXT,
+  started_at TEXT NOT NULL DEFAULT (datetime('now')),
+  last_activity_at TEXT NOT NULL DEFAULT (datetime('now')),
+  closed_at TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_browser_sessions_task ON agent_workforce_browser_sessions(task_id);
+CREATE INDEX IF NOT EXISTS idx_browser_sessions_status ON agent_workforce_browser_sessions(status);
+
+-- ============================================================================
+-- TELEGRAM CHAT MESSAGES
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS telegram_chat_messages (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  chat_id TEXT NOT NULL,
+  telegram_message_id INTEGER,
+  sender TEXT NOT NULL CHECK (sender IN ('user', 'bot')),
+  content TEXT NOT NULL,
+  agent_id TEXT,
+  task_id TEXT,
+  metadata TEXT DEFAULT '{}', -- JSON
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_telegram_messages_workspace ON telegram_chat_messages(workspace_id);
+CREATE INDEX IF NOT EXISTS idx_telegram_messages_chat ON telegram_chat_messages(chat_id);
+
+-- ============================================================================
+-- ORCHESTRATOR CHAT SESSIONS
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS orchestrator_chat_sessions (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  title TEXT,
+  messages TEXT NOT NULL DEFAULT '[]', -- JSON array
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_orchestrator_sessions_workspace ON orchestrator_chat_sessions(workspace_id);
+
+-- ============================================================================
+-- CONTACT EVENTS (data plane portion)
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS agent_workforce_contact_events (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  contact_id TEXT NOT NULL,
+  event_type TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT,
+  agent_id TEXT,
+  task_id TEXT,
+  metadata TEXT DEFAULT '{}', -- JSON
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_contact_events_contact ON agent_workforce_contact_events(contact_id);
+CREATE INDEX IF NOT EXISTS idx_contact_events_workspace ON agent_workforce_contact_events(workspace_id);
+
+-- ============================================================================
+-- BRIEFINGS
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS agent_workforce_briefings (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  briefing_type TEXT NOT NULL DEFAULT 'daily',
+  briefing_date TEXT NOT NULL,
+  content TEXT NOT NULL, -- JSON
+  is_read INTEGER NOT NULL DEFAULT 0,
+  read_at TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_briefings_workspace ON agent_workforce_briefings(workspace_id);
+CREATE INDEX IF NOT EXISTS idx_briefings_date ON agent_workforce_briefings(briefing_date);
+
+-- ============================================================================
+-- LOCAL AGENT CONFIG CACHE
+-- Synced from control plane, stored locally for offline operation
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS local_agent_configs (
+  id TEXT PRIMARY KEY,
+  workspace_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  role TEXT NOT NULL,
+  description TEXT,
+  system_prompt TEXT NOT NULL,
+  config TEXT NOT NULL DEFAULT '{}', -- JSON (AgentConfig)
+  status TEXT NOT NULL DEFAULT 'idle',
+  stats TEXT NOT NULL DEFAULT '{}', -- JSON (AgentStats)
+  department_id TEXT,
+  synced_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ============================================================================
+-- LOCAL SCHEDULE CACHE
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS local_schedule_configs (
+  id TEXT PRIMARY KEY,
+  workspace_id TEXT NOT NULL,
+  agent_id TEXT,
+  workflow_id TEXT,
+  label TEXT,
+  cron TEXT NOT NULL,
+  task_prompt TEXT,
+  enabled INTEGER NOT NULL DEFAULT 1,
+  synced_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ============================================================================
+-- LOCAL WORKFLOW CACHE
+-- ============================================================================
+
+CREATE TABLE IF NOT EXISTS local_workflow_configs (
+  id TEXT PRIMARY KEY,
+  workspace_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  description TEXT,
+  steps TEXT NOT NULL DEFAULT '[]', -- JSON
+  status TEXT NOT NULL DEFAULT 'active',
+  synced_at TEXT NOT NULL DEFAULT (datetime('now'))
+);

package/dist/db/migrations/002-agents-table.sql

@@ -0,0 +1,40 @@
+-- Enterprise Runtime: Agents table (mirrors cloud schema for service compatibility)
+-- This allows shared services to query agent_workforce_agents locally.
+
+CREATE TABLE IF NOT EXISTS agent_workforce_agents (
+  id TEXT PRIMARY KEY,
+  workspace_id TEXT NOT NULL,
+  department_id TEXT,
+  name TEXT NOT NULL,
+  role TEXT NOT NULL,
+  description TEXT,
+  avatar_url TEXT,
+  system_prompt TEXT NOT NULL DEFAULT '',
+  config TEXT NOT NULL DEFAULT '{}', -- JSON
+  status TEXT NOT NULL DEFAULT 'idle',
+  stats TEXT NOT NULL DEFAULT '{}', -- JSON
+  is_preset INTEGER NOT NULL DEFAULT 0,
+  a2a_published INTEGER NOT NULL DEFAULT 0,
+  a2a_skills TEXT NOT NULL DEFAULT '[]', -- JSON
+  memory_document TEXT,
+  memory_token_count INTEGER DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_agents_workspace ON agent_workforce_agents(workspace_id);
+
+-- Activity log table (for rpc compatibility)
+CREATE TABLE IF NOT EXISTS agent_workforce_activity (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  activity_type TEXT NOT NULL,
+  title TEXT NOT NULL,
+  description TEXT,
+  agent_id TEXT,
+  task_id TEXT,
+  metadata TEXT DEFAULT '{}', -- JSON
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_activity_workspace ON agent_workforce_activity(workspace_id);

package/dist/db/migrations/003-orchestrator-a2a.sql

@@ -0,0 +1,111 @@
+-- Migration 003: Orchestrator A2A support
+-- Adds tables for A2A connections, task logs, projects, and schedules
+
+-- A2A connections to external agents
+CREATE TABLE IF NOT EXISTS a2a_connections (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  description TEXT,
+  agent_card_url TEXT NOT NULL,
+  endpoint_url TEXT NOT NULL,
+  auth_type TEXT NOT NULL DEFAULT 'none',
+  auth_config TEXT NOT NULL DEFAULT '{}',
+  trust_level TEXT NOT NULL DEFAULT 'read_only',
+  store_results INTEGER NOT NULL DEFAULT 1,
+  result_retention_hours INTEGER NOT NULL DEFAULT 168,
+  allowed_data_types TEXT NOT NULL DEFAULT '[]',
+  rate_limit_per_minute INTEGER NOT NULL DEFAULT 60,
+  rate_limit_per_hour INTEGER NOT NULL DEFAULT 1000,
+  status TEXT NOT NULL DEFAULT 'pending',
+  last_health_check_at TEXT,
+  last_health_status TEXT,
+  consecutive_failures INTEGER NOT NULL DEFAULT 0,
+  agent_card_cache TEXT,
+  agent_card_fetched_at TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- A2A task audit logs
+CREATE TABLE IF NOT EXISTS a2a_task_logs (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  direction TEXT NOT NULL,
+  a2a_task_id TEXT NOT NULL,
+  method TEXT NOT NULL,
+  api_key_id TEXT,
+  connection_id TEXT,
+  agent_id TEXT,
+  status TEXT NOT NULL DEFAULT 'pending',
+  request_summary TEXT,
+  result_summary TEXT,
+  tokens_used INTEGER NOT NULL DEFAULT 0,
+  cost_cents REAL NOT NULL DEFAULT 0,
+  duration_ms INTEGER,
+  error_code TEXT,
+  error_message TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  completed_at TEXT
+);
+
+-- Local project management
+CREATE TABLE IF NOT EXISTS agent_workforce_projects (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  description TEXT,
+  status TEXT NOT NULL DEFAULT 'active',
+  color TEXT DEFAULT '#6366f1',
+  due_date TEXT,
+  position INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Local cron schedules
+CREATE TABLE IF NOT EXISTS agent_workforce_schedules (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  agent_id TEXT,
+  workflow_id TEXT,
+  label TEXT,
+  cron TEXT NOT NULL,
+  enabled INTEGER NOT NULL DEFAULT 1,
+  next_run_at TEXT,
+  last_run_at TEXT,
+  task_prompt TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Local workflows table
+CREATE TABLE IF NOT EXISTS agent_workforce_workflows (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  name TEXT NOT NULL,
+  description TEXT,
+  status TEXT NOT NULL DEFAULT 'active',
+  steps TEXT NOT NULL DEFAULT '[]',
+  run_count INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Add project_id and board_column to tasks
+-- These use the @statement marker so the migration runner executes them individually
+-- and swallows "duplicate column" errors for idempotency.
+-- @statement
+ALTER TABLE agent_workforce_tasks ADD COLUMN project_id TEXT;
+-- @statement
+ALTER TABLE agent_workforce_tasks ADD COLUMN board_column TEXT DEFAULT 'backlog';
+-- @statement
+ALTER TABLE agent_workforce_tasks ADD COLUMN due_date TEXT;
+-- @statement
+ALTER TABLE agent_workforce_tasks ADD COLUMN labels TEXT DEFAULT '[]';
+-- @statement
+ALTER TABLE agent_workforce_tasks ADD COLUMN parent_task_id TEXT;
+-- @statement
+ALTER TABLE agent_workforce_tasks ADD COLUMN position INTEGER DEFAULT 0;
+-- @statement
+ALTER TABLE agent_workforce_tasks ADD COLUMN archived_at TEXT;

package/dist/db/migrations/004-whatsapp.sql

@@ -0,0 +1,37 @@
+-- Migration 004: WhatsApp integration via Baileys
+-- Adds tables for WhatsApp connections, allowlisted chats, and message history
+
+-- WhatsApp connections (one per runtime)
+CREATE TABLE IF NOT EXISTS whatsapp_connections (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  phone_number TEXT,
+  status TEXT NOT NULL DEFAULT 'disconnected',
+  auth_state TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Allowlisted chats
+CREATE TABLE IF NOT EXISTS whatsapp_allowed_chats (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  connection_id TEXT NOT NULL REFERENCES whatsapp_connections(id) ON DELETE CASCADE,
+  chat_id TEXT NOT NULL,
+  chat_name TEXT,
+  chat_type TEXT DEFAULT 'individual',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(connection_id, chat_id)
+);
+
+-- Chat message history (for orchestrator context)
+CREATE TABLE IF NOT EXISTS whatsapp_chat_messages (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  connection_id TEXT NOT NULL REFERENCES whatsapp_connections(id) ON DELETE CASCADE,
+  chat_id TEXT NOT NULL,
+  sender TEXT,
+  role TEXT NOT NULL DEFAULT 'user',
+  content TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_wa_messages_chat ON whatsapp_chat_messages(connection_id, chat_id, created_at DESC);

package/dist/db/migrations/005-telegram.sql

@@ -0,0 +1,27 @@
+-- Migration 005: Telegram integration via Bot API long-polling
+-- Adds tables for Telegram connections and message history
+
+-- Telegram bot connections
+CREATE TABLE IF NOT EXISTS telegram_connections (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  bot_token TEXT NOT NULL,
+  bot_username TEXT,
+  bot_id TEXT,
+  status TEXT NOT NULL DEFAULT 'disconnected',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(workspace_id)
+);
+
+-- Chat message history (for orchestrator context)
+CREATE TABLE IF NOT EXISTS telegram_chat_messages (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  chat_id TEXT NOT NULL,
+  sender TEXT,
+  role TEXT NOT NULL DEFAULT 'user',
+  content TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_tg_messages_chat ON telegram_chat_messages(chat_id, created_at DESC);

package/dist/db/migrations/006-deferred-actions.sql

@@ -0,0 +1,3 @@
+-- Add deferred_action column to tasks (mirrors Supabase JSONB column as TEXT)
+-- @statement
+ALTER TABLE agent_workforce_tasks ADD COLUMN deferred_action TEXT DEFAULT NULL;

package/dist/db/migrations/007-deliverables.sql

@@ -0,0 +1,23 @@
+-- @statement
+ALTER TABLE agent_workforce_tasks ADD COLUMN response_type TEXT DEFAULT NULL;
+
+-- @statement
+CREATE TABLE IF NOT EXISTS agent_workforce_deliverables (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(16)))),
+  workspace_id TEXT NOT NULL,
+  task_id TEXT NOT NULL REFERENCES agent_workforce_tasks(id),
+  agent_id TEXT,
+  deliverable_type TEXT NOT NULL,
+  provider TEXT,
+  title TEXT NOT NULL,
+  content TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'pending_review',
+  delivery_result TEXT,
+  delivered_at TEXT,
+  reviewed_by TEXT,
+  reviewed_at TEXT,
+  rejection_reason TEXT,
+  retry_of_deliverable_id TEXT,
+  created_at TEXT DEFAULT (datetime('now')),
+  updated_at TEXT DEFAULT (datetime('now'))
+);