zubo 0.1.0

package/docs/ROADMAP.md

@@ -0,0 +1,490 @@
+# Zubo Roadmap
+
+> What makes OpenClaw a 145k-star project: multi-LLM with failover, 14+ channels
+> through one agent, a skills ecosystem, local-first gateway, and progressive
+> onboarding. Zubo takes the same ideas but stays lean — no gateway daemon,
+> no monorepo, just a single Bun process you can run anywhere.
+
+---
+
+## Phase 1 — Multi-LLM Provider System
+
+**Goal:** Use any LLM — Claude, GPT, Ollama, LM Studio, Groq, Together — through
+one config. Swap models without touching code.
+
+### 1.1 OpenAI-Compatible Provider
+
+The OpenAI chat completions API is the lingua franca. Ollama, LM Studio, Together,
+Groq, and OpenRouter all expose it. One provider covers them all.
+
+**Files:**
+
+| File | Action |
+|---|---|
+| `src/llm/provider.ts` | Add `providerName` field to interface |
+| `src/llm/openai-compat.ts` | **New.** OpenAI-compatible provider (no SDK — raw `fetch`) |
+| `src/llm/claude.ts` | Add `providerName = "anthropic"` |
+
+**`src/llm/openai-compat.ts` design:**
+
+```ts
+export class OpenAICompatProvider implements LlmProvider {
+  providerName: string;
+
+  constructor(opts: {
+    name: string;          // "openai" | "ollama" | "groq" | "lmstudio" | ...
+    baseUrl: string;       // "https://api.openai.com/v1" or "http://localhost:11434/v1"
+    apiKey: string;        // or "ollama" for local
+    model: string;         // "gpt-4o" | "llama3.3" | "qwen2.5-coder:32b"
+    maxTokens?: number;
+    streaming?: boolean;   // default true, false for Ollama tool-use bug
+  })
+
+  async chat(request: LlmRequest): Promise<LlmResponse> {
+    // POST /chat/completions
+    // Map LlmToolDef[] → OpenAI function format
+    // Map response → LlmResponse (text + tool_use blocks)
+  }
+}
+```
+
+**Why raw fetch instead of the OpenAI SDK:** Fewer deps, works with every
+OpenAI-compatible endpoint, and we control retry/timeout behavior.
+
+### 1.2 Provider Factory + Config
+
+Decide which provider to instantiate from config alone.
+
+**Files:**
+
+| File | Action |
+|---|---|
+| `src/config/schema.ts` | New `providers` + `activeModel` fields |
+| `src/llm/factory.ts` | **New.** `createProvider(config) → LlmProvider` |
+| `src/start.ts` | Use factory instead of hardcoded `new ClaudeProvider()` |
+| `src/setup.ts` | Ask which provider during setup |
+
+**Config shape:**
+
+```jsonc
+{
+  // ... existing fields ...
+
+  "providers": {
+    "anthropic": {
+      "apiKey": "sk-ant-...",
+      "model": "claude-sonnet-4-5-20250929"
+    },
+    "openai": {
+      "apiKey": "sk-...",
+      "baseUrl": "https://api.openai.com/v1",
+      "model": "gpt-4o"
+    },
+    "ollama": {
+      "baseUrl": "http://localhost:11434/v1",
+      "apiKey": "ollama",
+      "model": "qwen2.5-coder:32b",
+      "streaming": false
+    },
+    "groq": {
+      "apiKey": "gsk_...",
+      "baseUrl": "https://api.groq.com/openai/v1",
+      "model": "llama-3.3-70b-versatile"
+    }
+  },
+
+  "activeProvider": "anthropic",
+
+  "failover": ["openai", "ollama"]  // optional fallback chain
+}
+```
+
+**`src/llm/factory.ts` logic:**
+
+```
+1. Look up config.providers[config.activeProvider]
+2. If provider name is "anthropic" → new ClaudeProvider(...)
+3. Anything else → new OpenAICompatProvider({ name, baseUrl, apiKey, model })
+4. Wrap in FailoverProvider if config.failover exists
+```
+
+### 1.3 Failover Wrapper
+
+**File:** `src/llm/failover.ts` (new)
+
+```ts
+export class FailoverProvider implements LlmProvider {
+  constructor(
+    private primary: LlmProvider,
+    private fallbacks: LlmProvider[],
+  ) {}
+
+  async chat(request: LlmRequest): Promise<LlmResponse> {
+    try {
+      return await this.primary.chat(request);
+    } catch (err) {
+      logger.warn(`Primary provider failed, trying fallback`, { error: err.message });
+      for (const fb of this.fallbacks) {
+        try { return await fb.chat(request); } catch {}
+      }
+      throw err; // all failed
+    }
+  }
+}
+```
+
+### 1.4 Ollama Auto-Discovery (optional, nice-to-have)
+
+**File:** `src/llm/ollama-discover.ts` (new)
+
+```
+GET http://localhost:11434/api/tags → list models
+GET http://localhost:11434/api/show { name } → check tool support
+Auto-populate config.providers.ollama.model with best available
+```
+
+Run during `bun run setup` if user picks Ollama — show available models and let
+them choose.
+
+### 1.5 `bun run model` CLI command
+
+Quick model switching without editing config.json:
+
+```bash
+bun run model                    # show current model
+bun run model ollama/llama3.3    # switch active provider+model
+bun run model --list             # list configured providers
+```
+
+**File:** `src/model.ts` (new) + wire in `index.ts`
+
+---
+
+## Phase 2 — More Channels
+
+**Goal:** Same agent on WhatsApp, Discord, and a local web UI. One memory,
+one personality, many surfaces.
+
+### 2.1 Channel Architecture Refinement
+
+Current `ChannelAdapter` interface is already clean. We add:
+
+**Files:**
+
+| File | Action |
+|---|---|
+| `src/channels/adapter.ts` | Add `channelName`, `isGroup` to InboundMessage |
+| `src/config/schema.ts` | Per-channel config section |
+
+### 2.2 Discord Channel
+
+**Dep:** `discord.js` or lighter `@discordjs/rest` + gateway
+
+**File:** `src/channels/discord.ts` (new)
+
+- Bot token from config
+- Listen for mentions + DMs
+- Group mode: only respond when @mentioned
+- Message splitting for 2000-char limit
+
+### 2.3 WhatsApp via Baileys
+
+**Dep:** `@whiskeysockets/baileys` (no official API needed)
+
+**File:** `src/channels/whatsapp.ts` (new)
+
+- QR code pairing during setup
+- Store auth state in `~/.zubo/channels/whatsapp/`
+- Handle text messages, ignore media for now
+
+### 2.4 WebChat (local HTTP UI)
+
+**No deps.** Bun's built-in HTTP server + a single HTML file.
+
+**Files:**
+- `src/channels/webchat.ts` — HTTP server + SSE for streaming
+- `src/channels/webchat.html` — Minimal chat UI (inline, no build step)
+
+Serves on `http://localhost:3000`. Good for testing without Telegram.
+
+### 2.5 Channel Router Improvements
+
+**File:** `src/channels/router.ts`
+
+- Register multiple adapters (not just one)
+- Route replies to correct channel by `sessionKey` prefix
+- Cross-channel session access (read Telegram history from WebChat)
+
+---
+
+## Phase 3 — Skills / Plugin System
+
+**Goal:** Let users drop a folder into `~/.zubo/workspace/skills/` and the agent
+gains new abilities. No code changes, no restart.
+
+### 3.1 Skill Format
+
+```
+~/.zubo/workspace/skills/
+  web-search/
+    SKILL.md        # Description, when to use, tool schema
+    handler.ts      # Bun-loadable module exporting tool handler
+  weather/
+    SKILL.md
+    handler.ts
+```
+
+**SKILL.md example:**
+
+```markdown
+# Web Search
+
+Search the web for current information.
+
+## Tool: web_search
+- query (string, required): Search query
+
+## When to use
+When the user asks about current events, prices, news, or anything
+that requires up-to-date information beyond your training data.
+```
+
+**handler.ts contract:**
+
+```ts
+export default async function(input: Record<string, unknown>): Promise<string> {
+  const { query } = input as { query: string };
+  // ... do the thing ...
+  return JSON.stringify(results);
+}
+```
+
+### 3.2 Skill Loader
+
+**File:** `src/tools/skill-loader.ts` (new)
+
+```
+1. Scan ~/.zubo/workspace/skills/*/
+2. Parse each SKILL.md for tool name + schema + description
+3. Dynamic import() each handler.ts
+4. Register via existing registerTool()
+```
+
+Called at startup. Hot-reload on file change is a future nice-to-have.
+
+### 3.3 Built-in Skills to Ship
+
+| Skill | What it does |
+|---|---|
+| `web-search` | DuckDuckGo/Brave Search API |
+| `url-fetch` | Fetch URL, convert to markdown, summarize |
+| `shell` | Run shell command (with confirmation) |
+| `file-read` | Read file from disk |
+| `file-write` | Write file to disk |
+| `http-request` | Generic HTTP request (GET/POST) |
+
+These live in `src/tools/builtin/` but follow the same SKILL.md pattern
+so users can override them.
+
+---
+
+## Phase 4 — Agent Improvements
+
+**Goal:** Smarter agent loop — thinking, streaming, multi-agent delegation.
+
+### 4.1 Streaming Responses
+
+Stream tokens to the channel as they arrive instead of waiting for completion.
+
+**Files:**
+- `src/llm/provider.ts` — Add `chatStream()` returning `AsyncIterable<LlmChunk>`
+- `src/llm/claude.ts` — Implement streaming via Anthropic SDK
+- `src/llm/openai-compat.ts` — Implement SSE parsing
+- `src/agent/loop.ts` — Stream-aware loop
+- `src/channels/telegram.ts` — Edit message in-place as tokens arrive
+
+### 4.2 Extended Thinking / Reasoning
+
+For models that support it (Claude with extended thinking, DeepSeek-R1, QwQ):
+
+- Detect `thinking` blocks in response
+- Don't send thinking to user (unless asked)
+- Use thinking for better tool-use decisions
+- Config toggle: `thinking: true/false` per provider
+
+### 4.3 Cost + Token Tracking
+
+**File:** `src/agent/usage.ts` (new)
+
+- Track per-message input/output tokens
+- Track per-session cumulative cost
+- Store in DB (new `usage` table)
+- Surface in `bun run status`
+
+```sql
+CREATE TABLE usage (
+  id INTEGER PRIMARY KEY,
+  session_key TEXT,
+  provider TEXT,
+  model TEXT,
+  input_tokens INTEGER,
+  output_tokens INTEGER,
+  cost_usd REAL,
+  created_at TEXT DEFAULT (datetime('now'))
+);
+```
+
+### 4.4 Context Window Awareness
+
+Different models have different context windows. Compaction should respect this.
+
+**File:** `src/agent/compaction.ts`
+
+- Provider reports `contextWindow` size
+- Compaction targets 66% of that (not hardcoded 100k)
+- Small local models (8k context) get aggressive compaction
+
+---
+
+## Phase 5 — Proactive Agent + Automation
+
+**Goal:** Zubo doesn't just respond — it acts on its own.
+
+### 5.1 Webhook Inbound
+
+**File:** `src/scheduler/webhooks.ts` (new)
+
+- Bun HTTP server on configurable port
+- Routes like `POST /webhook/:name` → trigger agent with payload
+- Use case: GitHub push → Zubo summarizes commit
+- Use case: IFTTT/Zapier integration
+
+### 5.2 Agent-Managed Cron
+
+Let the agent create/edit/delete cron jobs via tools (not just DB):
+
+**New tools:**
+- `cron_create` — Create a scheduled task
+- `cron_list` — List all cron jobs
+- `cron_delete` — Remove a job
+
+Now the user can say "remind me every Monday at 9am to review PRs" and the
+agent handles it end-to-end.
+
+### 5.3 Daily Digest
+
+A built-in cron job (opt-in) that:
+
+1. Reads recent memories from the past 24h
+2. Checks calendar/weather (if skills installed)
+3. Composes a morning briefing
+4. Sends to user's primary channel
+
+---
+
+## Phase 6 — Security + Permissions
+
+### 6.1 Tool Approval
+
+Some tools are dangerous (shell, file-write). Before executing:
+
+```
+Agent wants to run: shell("rm -rf /tmp/old-data")
+[Approve] [Deny] [Always allow shell]
+```
+
+**File:** `src/tools/permissions.ts` (new)
+
+- Permission levels: `auto` (memory_search), `confirm` (shell), `deny`
+- Per-tool config in `~/.zubo/workspace/PERMISSIONS.md` or config.json
+- Channel adapters render approval buttons (Telegram inline keyboard)
+
+### 6.2 Message Pairing / Auth
+
+For channels where anyone can message the bot:
+
+- First message from unknown user → pairing code
+- User must confirm in a trusted channel (or CLI)
+- Prevents prompt injection from strangers
+
+---
+
+## Phase 7 — Companion Interfaces
+
+### 7.1 TUI (Terminal UI)
+
+**File:** `src/channels/tui.ts` (new)
+
+Interactive terminal chat using Bun's readline or `ink`:
+
+```bash
+bun run chat
+```
+
+Full chat experience without any external service. Best for testing and
+local-only use. Essential for Ollama-only setups where you don't need Telegram.
+
+### 7.2 Web Dashboard
+
+**Files:**
+- `src/dashboard/server.ts` — Bun HTTP server
+- `src/dashboard/index.html` — Single-page app
+
+Shows:
+- Live conversation view
+- Memory browser (search + edit)
+- Cron job management
+- Provider/model status
+- Usage/cost charts
+
+---
+
+## Implementation Priority
+
+What to build first, based on impact vs. effort:
+
+```
+HIGH IMPACT, LOW EFFORT (do first)
+├── Phase 1.1  OpenAI-compatible provider        ★★★★★
+├── Phase 1.2  Provider factory + config          ★★★★★
+├── Phase 1.5  `bun run model` command            ★★★★
+├── Phase 7.1  TUI / `bun run chat`              ★★★★
+├── Phase 4.3  Cost + token tracking              ★★★★
+└── Phase 5.2  Agent-managed cron tools           ★★★★
+
+HIGH IMPACT, MEDIUM EFFORT (do second)
+├── Phase 1.3  Failover wrapper                   ★★★★
+├── Phase 3.1  Skill format + loader              ★★★★
+├── Phase 3.3  web-search + url-fetch skills      ★★★★
+├── Phase 2.4  WebChat (local HTTP UI)            ★★★★
+├── Phase 4.1  Streaming responses                ★★★
+└── Phase 4.4  Context window awareness           ★★★
+
+MEDIUM IMPACT, MEDIUM EFFORT (do third)
+├── Phase 2.2  Discord channel                    ★★★
+├── Phase 2.3  WhatsApp channel                   ★★★
+├── Phase 5.1  Webhook inbound                    ★★★
+├── Phase 6.1  Tool approval / permissions        ★★★
+└── Phase 5.3  Daily digest                       ★★★
+
+NICE TO HAVE (do when stable)
+├── Phase 1.4  Ollama auto-discovery              ★★
+├── Phase 4.2  Extended thinking                  ★★
+├── Phase 6.2  Message pairing / auth             ★★
+└── Phase 7.2  Web dashboard                      ★★
+```
+
+---
+
+## Next Concrete Step
+
+**Phase 1.1 + 1.2**: Multi-LLM support. One session of work:
+
+1. Create `src/llm/openai-compat.ts` — OpenAI-compatible provider
+2. Create `src/llm/factory.ts` — Provider factory
+3. Update `src/config/schema.ts` — New provider config fields
+4. Update `src/start.ts` — Use factory
+5. Update `src/setup.ts` — Provider selection in wizard
+6. Test with Ollama locally
+
+This single change makes Zubo usable with any model, which unlocks everything else.

package/migrations/001_init.sql

@@ -0,0 +1,9 @@
+CREATE TABLE IF NOT EXISTS sessions (
+  id TEXT PRIMARY KEY,
+  channel TEXT NOT NULL,
+  user_id TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_sessions_user ON sessions(user_id);

package/migrations/002_memory.sql

@@ -0,0 +1,33 @@
+CREATE TABLE IF NOT EXISTS memory_chunks (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  source_file TEXT NOT NULL,
+  chunk_index INTEGER NOT NULL,
+  content TEXT NOT NULL,
+  embedding BLOB,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(source_file, chunk_index)
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS memory_fts USING fts5(
+  content,
+  source_file,
+  content='memory_chunks',
+  content_rowid='id'
+);
+
+CREATE TRIGGER IF NOT EXISTS memory_chunks_ai AFTER INSERT ON memory_chunks BEGIN
+  INSERT INTO memory_fts(rowid, content, source_file)
+  VALUES (new.id, new.content, new.source_file);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memory_chunks_ad AFTER DELETE ON memory_chunks BEGIN
+  INSERT INTO memory_fts(memory_fts, rowid, content, source_file)
+  VALUES ('delete', old.id, old.content, old.source_file);
+END;
+
+CREATE TRIGGER IF NOT EXISTS memory_chunks_au AFTER UPDATE ON memory_chunks BEGIN
+  INSERT INTO memory_fts(memory_fts, rowid, content, source_file)
+  VALUES ('delete', old.id, old.content, old.source_file);
+  INSERT INTO memory_fts(rowid, content, source_file)
+  VALUES (new.id, new.content, new.source_file);
+END;

package/migrations/003_cron.sql

@@ -0,0 +1,24 @@
+CREATE TABLE IF NOT EXISTS cron_jobs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL UNIQUE,
+  schedule TEXT NOT NULL,
+  task TEXT NOT NULL,
+  enabled INTEGER NOT NULL DEFAULT 1,
+  last_run TEXT,
+  next_run TEXT,
+  retry_count INTEGER NOT NULL DEFAULT 0,
+  max_retries INTEGER NOT NULL DEFAULT 3,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS cron_logs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  job_id INTEGER NOT NULL REFERENCES cron_jobs(id),
+  status TEXT NOT NULL,
+  output TEXT,
+  error TEXT,
+  started_at TEXT NOT NULL DEFAULT (datetime('now')),
+  finished_at TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_cron_logs_job ON cron_logs(job_id);

package/migrations/004_usage.sql

@@ -0,0 +1,12 @@
+CREATE TABLE IF NOT EXISTS usage (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT,
+  provider TEXT NOT NULL,
+  model TEXT NOT NULL,
+  input_tokens INTEGER NOT NULL DEFAULT 0,
+  output_tokens INTEGER NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_usage_provider ON usage(provider);
+CREATE INDEX IF NOT EXISTS idx_usage_created ON usage(created_at);

package/migrations/005_secrets.sql

@@ -0,0 +1,8 @@
+CREATE TABLE secrets (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL UNIQUE,
+  value TEXT NOT NULL,
+  service TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);

package/migrations/006_agents.sql

@@ -0,0 +1 @@
+ALTER TABLE cron_jobs ADD COLUMN agent TEXT;

package/migrations/007_workflows.sql

@@ -0,0 +1,22 @@
+CREATE TABLE IF NOT EXISTS workflow_executions (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  workflow_name TEXT NOT NULL,
+  input TEXT,
+  status TEXT NOT NULL DEFAULT 'running',
+  result TEXT,
+  started_at TEXT NOT NULL DEFAULT (datetime('now')),
+  completed_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS workflow_step_logs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  execution_id INTEGER NOT NULL REFERENCES workflow_executions(id),
+  step_name TEXT NOT NULL,
+  agent_name TEXT NOT NULL,
+  task TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'pending',
+  output TEXT,
+  started_at TEXT,
+  completed_at TEXT,
+  duration_ms INTEGER
+);

package/migrations/008_proactive.sql

@@ -0,0 +1,24 @@
+CREATE TABLE IF NOT EXISTS memory_triggers (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  pattern TEXT NOT NULL,
+  action TEXT NOT NULL,
+  schedule TEXT NOT NULL DEFAULT 'once',
+  last_fired TEXT,
+  enabled INTEGER NOT NULL DEFAULT 1,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS user_preferences (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  key TEXT NOT NULL UNIQUE,
+  value TEXT NOT NULL,
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS proactive_log (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  type TEXT NOT NULL,
+  message TEXT NOT NULL,
+  channel TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);

package/migrations/009_uploads.sql

@@ -0,0 +1,9 @@
+CREATE TABLE IF NOT EXISTS uploads (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  filename TEXT NOT NULL,
+  original_name TEXT NOT NULL,
+  mime_type TEXT NOT NULL,
+  size_bytes INTEGER NOT NULL,
+  chunk_count INTEGER NOT NULL DEFAULT 0,
+  uploaded_at TEXT NOT NULL DEFAULT (datetime('now'))
+);

package/migrations/010_observability.sql

@@ -0,0 +1,22 @@
+-- Enhance usage table with response time and cost
+ALTER TABLE usage ADD COLUMN response_time_ms INTEGER;
+ALTER TABLE usage ADD COLUMN cost_usd REAL;
+
+-- Tool execution metrics
+CREATE TABLE IF NOT EXISTS tool_metrics (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  tool_name TEXT NOT NULL,
+  session_id TEXT,
+  duration_ms INTEGER NOT NULL,
+  success INTEGER NOT NULL DEFAULT 1,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Performance snapshots
+CREATE TABLE IF NOT EXISTS perf_snapshots (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  rss_mb REAL,
+  heap_mb REAL,
+  db_size_mb REAL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);

package/migrations/011_api_keys.sql

@@ -0,0 +1,7 @@
+CREATE TABLE IF NOT EXISTS api_keys (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  label TEXT NOT NULL DEFAULT '',
+  key_hash TEXT NOT NULL UNIQUE,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  last_used_at TEXT
+);

package/migrations/012_indexes.sql

@@ -0,0 +1,5 @@
+-- Performance indexes for dashboard analytics queries
+CREATE INDEX IF NOT EXISTS idx_usage_provider_model ON usage(provider, model);
+CREATE INDEX IF NOT EXISTS idx_tool_metrics_name ON tool_metrics(tool_name);
+CREATE INDEX IF NOT EXISTS idx_tool_metrics_created ON tool_metrics(created_at);
+CREATE INDEX IF NOT EXISTS idx_memory_chunks_source ON memory_chunks(source_file);

package/migrations/013_budget.sql

@@ -0,0 +1,11 @@
+-- Budget configuration
+CREATE TABLE IF NOT EXISTS budget_config (
+  id INTEGER PRIMARY KEY CHECK (id = 1), -- singleton row
+  daily_limit_usd REAL,
+  monthly_limit_usd REAL,
+  alert_threshold REAL DEFAULT 0.8, -- alert at 80% of budget
+  paused INTEGER NOT NULL DEFAULT 0, -- 1 = budget exceeded, agent paused
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+INSERT OR IGNORE INTO budget_config (id) VALUES (1);

package/migrations/014_usage_session_idx.sql

@@ -0,0 +1,2 @@
+-- Index on usage.session_id for analytics queries using COUNT(DISTINCT session_id)
+CREATE INDEX IF NOT EXISTS idx_usage_session_id ON usage(session_id);