ohwow 0.1.13 → 0.2.0

package/LICENSE

@@ -1,21 +1,21 @@
-Business Source License 1.1
+MIT License
 
-Parameters
+Copyright (c) 2026 Jesus David Oñoro Delgado
 
-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
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
 
-For the full BSL 1.1 license text, see https://mariadb.com/bsl11/
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
-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.
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,88 +1,35 @@
 # ohwow
 
-Send me a message for support at ogsus@ohwow.fun
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![npm version](https://img.shields.io/npm/v/ohwow)](https://www.npmjs.com/package/ohwow)
+[![CI](https://github.com/ohwow-fun/ohwow/actions/workflows/ci.yml/badge.svg)](https://github.com/ohwow-fun/ohwow/actions/workflows/ci.yml)
+[![npm downloads](https://img.shields.io/npm/dm/ohwow)](https://www.npmjs.com/package/ohwow)
+[![Discord](https://img.shields.io/badge/Discord-join-5865F2)](https://discord.gg/WUGnGqceeY)
 
-A free and open-source local AI agent runtime. Full-featured out of the box with [Ollama](https://ollama.com) for local models. Cloud features (sync, OAuth integrations, cloud task dispatch, webhook relay) available with an [ohwow.fun](https://ohwow.fun) subscription.
+**Your AI team that runs on your laptop. Agents that learn, message customers, browse the web, and control your desktop. Costs $0.**
 
-## Getting Started
+<p align="center">
+  <img src="docs/demo.gif" alt="ohwow demo" width="800">
+</p>
 
-### Install
+ohwow is an open source AI business operating system. A team of AI agents that live on your laptop, handle your CRM, message your customers on WhatsApp, automate your workflows, browse the web, and now control your desktop. All running locally. All free. No cloud required.
 
-```bash
-npm install ohwow -g
-```
-
-### Requirements
-
-- Node.js 20+
-- [Ollama](https://ollama.com) for 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
+## Quick Start
 
 ```bash
+npm install ohwow -g
 ohwow
 ```
 
-## First Launch
-
-A setup wizard appears in your terminal. Point it at your Ollama instance to get started. To connect to ohwow.fun cloud, enter your license key (from the ohwow.fun dashboard, under Settings > License).
-
-Config is saved to `~/.ohwow/config.json`. You only do this once.
-
-## What Happens at Startup
-
-Once configured, the runtime:
+A setup wizard walks you through connecting to [Ollama](https://ollama.com), picking a model, and selecting agents for your business type. Running in under 5 minutes.
 
-1. Loads config from `~/.ohwow/config.json`
-2. Spawns the daemon process
-3. Initializes the local SQLite database
-4. Starts the execution engine, orchestrator, and model router
-5. Connects messaging channels (WhatsApp, Telegram) if configured
-6. Starts the scheduler, proactive engine, and trigger evaluator
-7. Launches the HTTP server (default port 7700)
-8. Connects to the ohwow.fun control plane (enterprise)
-9. Opens a WebSocket for real-time updates
+<p align="center">
+  <img src="docs/onboarding.gif" alt="ohwow onboarding" width="800">
+</p>
 
-From here, agents execute tasks on your hardware using your own API keys. The dashboard sends the work, your machine does the thinking.
+## Talk to it like a person
 
-## CLI Commands
-
-| Command | What it does |
-|---|---|
-| `ohwow` | Start the TUI (default) |
-| `ohwow --daemon` | Start daemon in foreground (for systemd/launchd/Docker) |
-| `ohwow stop` | Stop the daemon |
-| `ohwow status` | Check daemon status (PID and port) |
-| `ohwow logs` | Tail daemon logs |
-| `ohwow restart` | Restart the daemon |
-
-## TUI
-
-The terminal UI opens into a chat interface with tab navigation. Use arrow keys or tab to switch between:
-
-- **Dashboard** — overview of your workspace
-- **Agents** — manage agent configs, memory, and capabilities
-- **Tasks** — view and manage running/completed tasks
-- **Approvals** — review pending items before execution
-- **Activity** — live feed of everything happening
-- **Automations** — webhook-based automation triggers
-- **Contacts** — CRM with leads, customers, partners
-- **Settings** — config, connections, license
-
-Everything you see in the web dashboard is also here, running locally.
-
-## Web UI
-
-The runtime serves a built-in React app at `http://localhost:7700`. Same capabilities as the TUI. Useful if you prefer a graphical interface or want to share access with your team on the local network. Override the port with the `OHWOW_PORT` env var.
-
-## 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.
-
-You can talk to it naturally:
+The orchestrator is a conversational assistant with 150+ tools. Open the Chat tab and speak naturally:
 
 | What you say | What happens |
 |---|---|
@@ -90,135 +37,142 @@ You can talk to it naturally:
 | "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 |
+| "Open Figma and export the hero banner as PNG" | Takes over your desktop, opens the app, clicks through menus, saves the file |
 | "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. Memories are periodically consolidated to keep context sharp. On future tasks, relevant memories are retrieved via RAG and compiled into the agent's context. Agents improve the more they work. 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.
-
-### Voice
-
-Full voice pipeline with local and cloud options:
-
-- **Speech-to-Text**: Voicebox (Whisper via local FastAPI server), WhisperLocal (via Ollama), or WhisperAPI (OpenAI cloud fallback)
-- **Text-to-Speech**: VoiceboxTTS (local), Piper (local), or OpenAI TTS (cloud fallback)
-
-### A2A Protocol
-
-Connect to external agents using the [A2A protocol](https://google.github.io/A2A/) over JSON-RPC 2.0. Each agent publishes a card at `/.well-known/agent-card.json` describing its capabilities. Trust levels (`read_only`, `execute`, `autonomous`, `admin`) control what external agents can do. Scopes cover tasks, agents, results, and file access. Managed from the A2A tab or through the orchestrator.
-
-### Scheduling and Proactive Engine
-
-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.
-
-The proactive engine runs every 30 minutes and checks for overdue tasks, aging approvals, and idle agents. It generates nudges (suggestions, not auto-executions) so nothing falls through the cracks.
-
-### Goal Planning and Approvals
-
-For complex goals, the orchestrator breaks 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. Rejected tasks can retry with your feedback 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.
-
-### Automations and Triggers
-
-Webhook-based automations that fire on external events. Configure field mapping to extract data from incoming payloads and route it to agents or workflows. Managed from the Automations tab.
+| Category | What you get |
+|---|---|
+| AI Agents | 48 pre-built agents across 6 business types, persistent memory, RAG retrieval |
+| Orchestrator | 150+ tools, natural language chat interface for everything |
+| Desktop Control | Full macOS desktop automation: mouse, keyboard, screen capture. Your agents operate any app on your computer. (macOS only) |
+| Messaging | WhatsApp + Telegram built in, auto-routing to agents |
+| Browser | Local Chromium automation (navigate, click, fill, screenshot, extract) |
+| Voice | Local STT/TTS (Whisper, Piper) with cloud fallbacks |
+| CRM | Contacts, pipeline, events, analytics, all stored locally |
+| Scheduling | Cron schedules + proactive nudge engine every 30 minutes |
+| Workflows | DAG-based multi-agent execution graphs with conditions |
+| Multidevice | Zero-config mDNS mesh, automatic task routing across machines |
+| MCP | External tool integration via Model Context Protocol |
+| A2A | Google Agent-to-Agent protocol over JSON-RPC 2.0 |
+| Sandbox | Isolated JavaScript execution (no fs/net/process access) |
 
-### Workflows
+## Desktop Control
 
-DAG-based multi-agent execution graphs. Define sequences of agent tasks with conditions and branches. Workflows can be triggered manually, on a schedule, or via automation triggers.
+Your agents aren't trapped inside a chat window. They can use your computer.
 
-### MCP Servers
+ohwow agents see your screen, move the mouse, type on the keyboard, and operate any macOS app. Not through brittle scripts or accessibility hacks. They look at what's on screen, reason about what to do next, and act. The same way you would, but without getting distracted.
 
-Integrate external tools via the [Model Context Protocol](https://modelcontextprotocol.io/). Supports stdio (subprocess) and HTTP (Streamable HTTP) transports. Authentication via OAuth 2.1, bearer tokens, or API keys. MCP tools are auto-adapted to the Anthropic SDK format and can be assigned per-agent or globally.
+**How it works:** the agent takes a screenshot, analyzes it with a vision model, decides the next action (click, type, scroll, key press), executes it, then takes another screenshot to see the result. This perception/reasoning/action loop repeats until the task is done.
 
-### Code Sandbox
+```
+You: "Fill out the Q1 expense report in Google Sheets using last month's receipts folder"
+
+ohwow:
+  1. Opens Finder, navigates to the receipts folder
+  2. Opens Google Sheets in Chrome
+  3. Reads each receipt, types the amounts into the right cells
+  4. Double-checks totals
+  5. Done. You were making coffee the whole time.
+```
 
-Agents can execute JavaScript in an isolated sandbox (Node.js `vm` module). No filesystem, network, or process access. 5-second default timeout, 30-second maximum. Safe globals only (Math, JSON, Date, Array, Object, Map, Set, etc.).
+**Safety first.** Desktop control requires your explicit permission before activating. You can stop the agent at any point. Dangerous actions (typing in Terminal, changing system settings) trigger additional approval. An emergency stop halts everything instantly.
 
-### Web Search
+**Works with Dispatch.** Connect to [ohwow.fun](https://ohwow.fun) and trigger desktop tasks from your phone. Start a task on the train, your MacBook at home does the work. Check progress from the dashboard.
 
-Agents with web search enabled can search the web during task execution, powered by Anthropic's built-in search tool.
+> Desktop control currently supports macOS only. All other features (agents, chat, browser automation, voice, CRM, scheduling, MCP) work on macOS, Linux, and Windows. See [Windows Setup Guide](docs/windows-setup.md) for details.
 
-### Local Models with Ollama
+## Who is this for?
 
-If you run [Ollama](https://ollama.com) locally, the runtime routes lightweight tasks (orchestration, memory extraction) to your local model instead of Claude. The model catalog includes 25+ models across 5 memory tiers with device-aware recommendations. Complex work (planning, agent tasks, browser automation) still goes to Claude. If Ollama goes down, everything falls back to Anthropic automatically.
+- **Solo founders** automating marketing, outreach, and ops with zero budget
+- **Busy operators** who want an AI team that handles the repetitive screen work while they focus on growth
+- **Small teams** that need agents coordinating across devices
+- **Agencies** managing operations for multiple clients
+- **Privacy-conscious businesses** that need AI automation without cloud lock-in
+- **Developers** building custom agents with the orchestrator, MCP tools, and desktop control APIs
 
-### Offline Mode
+## Why ohwow?
 
-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.
+| | Zapier | n8n | Make | OpenClaw | **ohwow** |
+|---|---|---|---|---|---|
+| Runs on your machine | No | Self-host option | No | Yes | **Yes, always** |
+| Desktop control | No | No | No | Yes | **Yes, with safety guards** |
+| AI agents with persistent memory | No | Yes (LangChain nodes) | No | Partial | **Yes, agents learn over time** |
+| Cost to start | $20+/mo | Free (self-host) | $10+/mo | Free | **$0 with Ollama** |
+| Pre-built business agents | No | No | No | No | **48 agents, 6 biz types** |
+| WhatsApp + Telegram | Plugin | Plugin | Plugin | No | **Built in** |
+| CRM + contacts | No | No | No | No | **Built in** |
+| Multi-device mesh | No | No | No | No | **Zero-config** |
+| Browser automation | No | Partial | No | Yes | **Built in (Chromium)** |
+| Workflow DAGs | Yes | Yes | Yes | No | **Yes, with conditions + parallel** |
+| Phone dispatch | No | No | No | No | **Yes, via ohwow.fun** |
+| Your data stays local | No | Optional | No | Yes | **Always** |
 
-## Connected Mode (Cloud)
+> Comparison as of March 2026. We love what OpenClaw, n8n, and others are building. ohwow focuses on a different problem: a complete AI business runtime, not just a single agent or workflow tool.
 
-Connect to ohwow.fun to add cloud features on top of the free local runtime.
+## Self-hosting
 
-**Cloud features (require connection):**
-- Cloud sync: agent configs sync from your dashboard
-- Cloud task dispatch: receive tasks dispatched from the web
-- OAuth integrations: Gmail, Slack, and other cloud-based integrations
-- Webhook relay: cloud-proxied webhooks for external services
-- Heartbeats and health monitoring
+| Command | What it does |
+|---|---|
+| `ohwow` | Start the TUI (default) |
+| `ohwow --daemon` | Start daemon in foreground (for systemd/launchd/Docker) |
+| `ohwow stop` | Stop the daemon |
+| `ohwow status` | Check daemon status (PID and port) |
+| `ohwow logs` | Tail daemon logs |
+| `ohwow restart` | Restart the daemon |
 
-**What stays local (always):**
-- 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
+The runtime serves a web UI at `http://localhost:7700`. Override the port with `OHWOW_PORT`.
 
-**How it works:**
+Docker:
 
-Activate with a license key from the ohwow.fun dashboard (Settings > License). The runtime connects to the control plane via long-polling, receives task dispatches, and sends back status updates. Heartbeats confirm the device is online. Each license is locked to a single device. The cloud dashboard gives you a web interface for managing agents, reviewing tasks, and monitoring your workspace without touching the terminal.
+```bash
+docker run -d --name ohwow -p 7700:7700 -v ~/.ohwow:/root/.ohwow ohwow
+```
 
-All local features (agents, scheduling, WhatsApp, Telegram, A2A, browser automation, voice, CRM, automations, approvals) work without a cloud connection.
+## Cloud
 
-## Headless / Daemon Mode
+Connect to [ohwow.fun](https://ohwow.fun) for cloud features on top of the free local runtime:
 
-For servers, containers, or always-on deployments:
+- **Desktop dispatch** from your phone. Assign tasks to your MacBook while you're out.
+- **OAuth integrations** (Gmail, Slack, and more)
+- **Cloud task dispatch** from the web dashboard or mobile
+- **AI site generator** with hosting and custom domains
+- **Webhook relay** for external services
+- **Fleet management** across devices
 
-```bash
-ohwow --daemon
-```
+All local features work without cloud. See [pricing](https://ohwow.fun/pricing) for plans starting at $29/mo.
 
-Runs the daemon in the foreground (no TUI). Suitable for systemd, launchd, or Docker. Set `OHWOW_HEADLESS=1` as an alternative. The web UI still runs normally. Configure through environment variables.
+## Requirements
 
-## Configuration
+- Node.js 20+
+- [Ollama](https://ollama.com) for local models
+- Optional: Anthropic API key (for Claude models)
+- Optional: Playwright browsers (`npx playwright install chromium`) for browser automation
+- Optional: macOS Accessibility permission for desktop control (macOS only)
+- Optional: Visual Studio C++ Build Tools on Windows for `better-sqlite3` native module
 
-Config lives at `~/.ohwow/config.json`. Key environment variables:
+## Troubleshooting
 
-| Variable | Purpose |
-|---|---|
-| `OHWOW_PORT` | HTTP server port (default 7700) |
-| `OHWOW_HEADLESS` | Set to `1` for headless mode |
-| `OHWOW_BROWSER_HEADLESS` | Set to `false` to show the browser |
-| `ANTHROPIC_API_KEY` | Anthropic API key for Claude models |
+| Problem | Solution |
+|---------|----------|
+| `better-sqlite3` build fails | Install build tools: `xcode-select --install` (macOS), `sudo apt install build-essential python3` (Linux), or Visual Studio C++ Build Tools (Windows) |
+| Ollama not detected | Ensure Ollama is running (`ollama serve`) and accessible at `http://localhost:11434` |
+| Port 7700 in use | Set `OHWOW_PORT=7701` or any free port |
+| WhatsApp QR expired | Restart ohwow and scan the new QR within 60 seconds |
+| `EACCES` on global install | Use `npm install ohwow -g --prefix ~/.npm-global` or fix npm permissions |
 
-## Supported Models
+## Community
 
-| Model | Provider |
-|---|---|
-| Claude Opus 4.6 | Anthropic |
-| Claude Sonnet 4.6 | Anthropic |
-| Claude Haiku 4.5 | Anthropic |
-| Any Ollama model | Local |
+- [Discord](https://discord.gg/WUGnGqceeY)
+- [Contributing](./CONTRIBUTING.md)
+- [Architecture](./ARCHITECTURE.md)
+- [Security](./SECURITY.md)
+- [Governance](./GOVERNANCE.md)
+- Email: ogsus@ohwow.fun
 
 ## 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.
+[MIT](./LICENSE)

package/dist/api.d.ts

@@ -0,0 +1,91 @@
+import Database from 'better-sqlite3';
+
+/**
+ * DatabaseAdapter Interface (Runtime Copy)
+ *
+ * Abstracts the query builder pattern used by Supabase's PostgREST client.
+ * Both the Supabase adapter (cloud) and SQLite adapter (local runtime)
+ * implement this interface, allowing all agent services to work with either backend.
+ *
+ * Mirrors the SupabaseClient chaining API: .from(table).select().eq().single()
+ */
+interface DbResult<T> {
+    data: T | null;
+    error: DbError | null;
+    count?: number | null;
+}
+interface DbError {
+    message: string;
+    code?: string;
+    details?: string;
+    hint?: string;
+}
+interface FilterBuilder<T> {
+    eq(column: string, value: unknown): FilterBuilder<T>;
+    neq(column: string, value: unknown): FilterBuilder<T>;
+    gt(column: string, value: unknown): FilterBuilder<T>;
+    gte(column: string, value: unknown): FilterBuilder<T>;
+    lt(column: string, value: unknown): FilterBuilder<T>;
+    lte(column: string, value: unknown): FilterBuilder<T>;
+    in(column: string, values: unknown[]): FilterBuilder<T>;
+    is(column: string, value: null | boolean): FilterBuilder<T>;
+    or(filters: string, options?: {
+        foreignTable?: string;
+    }): FilterBuilder<T>;
+    not(column: string, operator: string, value: unknown): FilterBuilder<T>;
+    order(column: string, options?: {
+        ascending?: boolean;
+    }): FilterBuilder<T>;
+    limit(count: number): FilterBuilder<T>;
+    range(from: number, to: number): FilterBuilder<T>;
+    single(): PromiseLike<DbResult<T>>;
+    maybeSingle(): PromiseLike<DbResult<T | null>>;
+    then<TResult1 = DbResult<T[]>, TResult2 = never>(onfulfilled?: ((value: DbResult<T[]>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
+}
+type SelectBuilder<T> = FilterBuilder<T>;
+interface InsertBuilder<T> {
+    select(columns?: string): FilterBuilder<T>;
+    then<TResult1 = DbResult<null>, TResult2 = never>(onfulfilled?: ((value: DbResult<null>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
+}
+interface UpdateBuilder<T> extends FilterBuilder<T> {
+    eq(column: string, value: unknown): UpdateBuilder<T>;
+    neq(column: string, value: unknown): UpdateBuilder<T>;
+    select(columns?: string): FilterBuilder<T>;
+}
+type DeleteBuilder<T> = FilterBuilder<T>;
+interface TableBuilder<T = Record<string, unknown>> {
+    select(columns?: string, options?: {
+        count?: 'exact';
+        head?: boolean;
+    }): SelectBuilder<T>;
+    insert(data: Partial<T> | Partial<T>[]): InsertBuilder<T>;
+    update(data: Partial<T>): UpdateBuilder<T>;
+    delete(): DeleteBuilder<T>;
+}
+interface DatabaseAdapter {
+    from<T = Record<string, unknown>>(table: string): TableBuilder<T>;
+    rpc<T = unknown>(fn: string, params?: Record<string, unknown>): PromiseLike<DbResult<T>>;
+}
+
+/**
+ * SQLite Adapter
+ *
+ * Implements the DatabaseAdapter interface using better-sqlite3.
+ * Translates the SupabaseClient-shaped query builder API into SQL queries
+ * against a local SQLite database.
+ *
+ * Used by the local runtime for local data plane storage.
+ */
+
+/**
+ * Map of registered RPC functions for the SQLite adapter.
+ * In Supabase, .rpc() calls server-side Postgres functions.
+ * In SQLite, we register JS functions that perform the same logic.
+ */
+type RpcHandler = (params: Record<string, unknown>) => unknown;
+interface SqliteAdapterOptions {
+    rpcHandlers?: Record<string, RpcHandler>;
+}
+declare function createSqliteAdapter(db: Database.Database, options?: SqliteAdapterOptions): DatabaseAdapter;
+
+export { type SqliteAdapterOptions, createSqliteAdapter };

package/dist/api.js

@@ -0,0 +1,2 @@
+import { createRequire } from 'module'; const require = createRequire(import.meta.url);
+function F(s,e){return{message:s,code:e}}function q(s,e){return{data:s,error:null,count:e}}function f(s,e){return{data:null,error:F(s,e)}}function A(s){let e=s.split(","),i=[],o=[];for(let p of e){let c=p.trim().split(".");if(c.length<3)continue;let l=c[0],t=c[1],r=c.slice(2).join(".");switch(t){case"eq":i.push(`${l} = ?`),o.push(r);break;case"neq":i.push(`${l} != ?`),o.push(r);break;case"gt":i.push(`${l} > ?`),o.push(r);break;case"gte":i.push(`${l} >= ?`),o.push(r);break;case"lt":i.push(`${l} < ?`),o.push(r);break;case"lte":i.push(`${l} <= ?`),o.push(r);break;case"is":r==="null"?i.push(`${l} IS NULL`):r==="true"?i.push(`${l} = 1`):r==="false"&&i.push(`${l} = 0`);break;case"ilike":i.push(`${l} LIKE ? COLLATE NOCASE`),o.push(r.replace(/%25/g,"%"));break;case"like":i.push(`${l} LIKE ?`),o.push(r);break;case"in":{let n=r.replace(/^\(/,"").replace(/\)$/,"").split(",");i.push(`${l} IN (${n.map(()=>"?").join(",")})`),o.push(...n)}break;default:i.push(`${l} ${t} ?`),o.push(r)}}return{sql:`(${i.join(" OR ")})`,params:o}}function O(s){if(s.conditions.length===0)return{sql:"",params:[]};let e=[],i=[];for(let o of s.conditions)e.push(o.sql),i.push(...o.params);return{sql:` WHERE ${e.join(" AND ")}`,params:i}}function B(s){return s.orderClauses.length===0?"":` ORDER BY ${s.orderClauses.join(", ")}`}function C(s){if(s.rangeFrom!==void 0&&s.rangeTo!==void 0)return` LIMIT ${s.rangeTo-s.rangeFrom+1} OFFSET ${s.rangeFrom}`;if(s.limitValue!==void 0){let e=s.offsetValue?` OFFSET ${s.offsetValue}`:"";return` LIMIT ${s.limitValue}${e}`}return""}function S(s){if(!s)return s;let e={...s};for(let[i,o]of Object.entries(e))if(typeof o=="string"&&(o.startsWith("{")&&o.endsWith("}")||o.startsWith("[")&&o.endsWith("]")))try{e[i]=JSON.parse(o)}catch{}return e}function y(s,e,i,o,p,c,l){let t={eq(r,n){return e.conditions.push({sql:`${r} = ?`,params:[n]}),t},neq(r,n){return e.conditions.push({sql:`${r} != ?`,params:[n]}),t},gt(r,n){return e.conditions.push({sql:`${r} > ?`,params:[n]}),t},gte(r,n){return e.conditions.push({sql:`${r} >= ?`,params:[n]}),t},lt(r,n){return e.conditions.push({sql:`${r} < ?`,params:[n]}),t},lte(r,n){return e.conditions.push({sql:`${r} <= ?`,params:[n]}),t},in(r,n){if(n.length===0)e.conditions.push({sql:"1 = 0",params:[]});else{let a=n.map(()=>"?").join(", ");e.conditions.push({sql:`${r} IN (${a})`,params:n})}return t},is(r,n){return n===null?e.conditions.push({sql:`${r} IS NULL`,params:[]}):e.conditions.push({sql:`${r} = ?`,params:[n?1:0]}),t},or(r){let n=A(r);return e.conditions.push(n),t},not(r,n,a){switch(n){case"eq":e.conditions.push({sql:`${r} != ?`,params:[a]});break;case"is":a===null&&e.conditions.push({sql:`${r} IS NOT NULL`,params:[]});break;default:e.conditions.push({sql:`NOT (${r} ${n} ?)`,params:[a]})}return t},order(r,n){let a=n?.ascending===!1?"DESC":"ASC";return e.orderClauses.push(`${r} ${a}`),t},limit(r){return e.limitValue=r,t},range(r,n){return e.rangeFrom=r,e.rangeTo=n,t},single(){return{then(r,n){try{let a=w(s,e,i,o,p,c,l),u=a.data;if(!u||Array.isArray(u)&&u.length===0){let d=f("Row not found","PGRST116");return Promise.resolve(d).then(r,n)}if(Array.isArray(u)&&u.length>1){let d=f("Multiple rows returned","PGRST116");return Promise.resolve(d).then(r,n)}let m=Array.isArray(u)?u[0]:u;return Promise.resolve(q(m,a.count)).then(r,n)}catch(a){let u=f(a.message);return n?Promise.resolve(u).then(r,n):Promise.resolve(u).then(r)}}}},maybeSingle(){return{then(r,n){try{let a=w(s,e,i,o,p,c,l),u=a.data;if(!u||Array.isArray(u)&&u.length===0)return Promise.resolve(q(null,a.count)).then(r,n);let m=Array.isArray(u)?u[0]:u;return Promise.resolve(q(m,a.count)).then(r,n)}catch(a){let u=f(a.message);return Promise.resolve(u).then(r,n)}}}},then(r,n){try{let a=w(s,e,i,o,p,c,l);return Promise.resolve(a).then(r,n)}catch(a){let u=f(a.message);return Promise.resolve(u).then(r,n)}}};return t}function w(s,e,i,o,p,c,l){let t=O(e),r=B(e),n=C(e);switch(i){case"select":{let a=o||"*";if(p?.head===!0&&p?.count==="exact"){let g=`SELECT COUNT(*) as count FROM ${e.table}${t.sql}`,h=s.prepare(g).get(...t.params);return{data:[],error:null,count:h.count}}let m=`SELECT ${a} FROM ${e.table}${t.sql}${r}${n}`,d=s.prepare(m).all(...t.params);d=d.map(g=>S(g));let T=null;if(p?.count==="exact"){let g=`SELECT COUNT(*) as count FROM ${e.table}${t.sql}`;T=s.prepare(g).get(...t.params).count}return{data:d,error:null,count:T}}case"insert":{let a=Array.isArray(c)?c:[c],u=[];for(let m of a){let d=m,T=Object.keys(d),g=T.map(R=>{let k=d[R];return k!==null&&typeof k=="object"?JSON.stringify(k):k}),h=T.map(()=>"?").join(", "),$=`INSERT INTO ${e.table} (${T.join(", ")}) VALUES (${h})`;s.prepare($).run(...g);let b=s.prepare("SELECT last_insert_rowid() as id").get(),E=s.prepare(`SELECT * FROM ${e.table} WHERE rowid = ?`).get(b.id);E&&u.push(S(E))}return{data:u,error:null}}case"update":{let a=l,u=Object.keys(a),m=u.map($=>`${$} = ?`).join(", "),d=u.map($=>{let b=a[$];return b!==null&&typeof b=="object"?JSON.stringify(b):b}),T=`UPDATE ${e.table} SET ${m}${t.sql}`;s.prepare(T).run(...d,...t.params);let g=`SELECT * FROM ${e.table}${t.sql}${r}${n}`,h=s.prepare(g).all(...t.params);return h=h.map($=>S($)),{data:h,error:null}}case"delete":{let a=`DELETE FROM ${e.table}${t.sql}`;return s.prepare(a).run(...t.params),{data:[],error:null}}}}function P(s,e){let i=e?.rpcHandlers??{};return{from(o){return{select(p,c){return y(s,{table:o,conditions:[],orderClauses:[]},"select",p,c)},insert(p){let c={table:o,conditions:[],orderClauses:[]};return{select(t){return y(s,c,"insert",t,void 0,p)},then(t,r){try{let n=w(s,c,"insert",void 0,void 0,p);return Promise.resolve({data:null,error:n.error}).then(t,r)}catch(n){let a=f(n.message);return Promise.resolve(a).then(t,r)}}}},update(p){let c={table:o,conditions:[],orderClauses:[]},t=y(s,c,"update",void 0,void 0,void 0,p);return t.select=r=>y(s,c,"update",r,void 0,void 0,p),t},delete(){return y(s,{table:o,conditions:[],orderClauses:[]},"delete")}}},rpc(o,p){let c=i[o];if(!c)return Promise.resolve(f(`RPC function '${o}' not registered`));try{let l=c(p??{});return Promise.resolve(q(l))}catch(l){return Promise.resolve(f(l.message))}}}}export{P as createSqliteAdapter};

package/dist/index.d.ts

@@ -1,91 +1,2 @@
-import Database from 'better-sqlite3';
 
-/**
- * DatabaseAdapter Interface (Runtime Copy)
- *
- * Abstracts the query builder pattern used by Supabase's PostgREST client.
- * Both the Supabase adapter (cloud) and SQLite adapter (enterprise runtime)
- * implement this interface, allowing all agent services to work with either backend.
- *
- * Mirrors the SupabaseClient chaining API: .from(table).select().eq().single()
- */
-interface DbResult<T> {
-    data: T | null;
-    error: DbError | null;
-    count?: number | null;
-}
-interface DbError {
-    message: string;
-    code?: string;
-    details?: string;
-    hint?: string;
-}
-interface FilterBuilder<T> {
-    eq(column: string, value: unknown): FilterBuilder<T>;
-    neq(column: string, value: unknown): FilterBuilder<T>;
-    gt(column: string, value: unknown): FilterBuilder<T>;
-    gte(column: string, value: unknown): FilterBuilder<T>;
-    lt(column: string, value: unknown): FilterBuilder<T>;
-    lte(column: string, value: unknown): FilterBuilder<T>;
-    in(column: string, values: unknown[]): FilterBuilder<T>;
-    is(column: string, value: null | boolean): FilterBuilder<T>;
-    or(filters: string, options?: {
-        foreignTable?: string;
-    }): FilterBuilder<T>;
-    not(column: string, operator: string, value: unknown): FilterBuilder<T>;
-    order(column: string, options?: {
-        ascending?: boolean;
-    }): FilterBuilder<T>;
-    limit(count: number): FilterBuilder<T>;
-    range(from: number, to: number): FilterBuilder<T>;
-    single(): PromiseLike<DbResult<T>>;
-    maybeSingle(): PromiseLike<DbResult<T | null>>;
-    then<TResult1 = DbResult<T[]>, TResult2 = never>(onfulfilled?: ((value: DbResult<T[]>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
-}
-type SelectBuilder<T> = FilterBuilder<T>;
-interface InsertBuilder<T> {
-    select(columns?: string): FilterBuilder<T>;
-    then<TResult1 = DbResult<null>, TResult2 = never>(onfulfilled?: ((value: DbResult<null>) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): PromiseLike<TResult1 | TResult2>;
-}
-interface UpdateBuilder<T> extends FilterBuilder<T> {
-    eq(column: string, value: unknown): UpdateBuilder<T>;
-    neq(column: string, value: unknown): UpdateBuilder<T>;
-    select(columns?: string): FilterBuilder<T>;
-}
-type DeleteBuilder<T> = FilterBuilder<T>;
-interface TableBuilder<T = Record<string, unknown>> {
-    select(columns?: string, options?: {
-        count?: 'exact';
-        head?: boolean;
-    }): SelectBuilder<T>;
-    insert(data: Partial<T> | Partial<T>[]): InsertBuilder<T>;
-    update(data: Partial<T>): UpdateBuilder<T>;
-    delete(): DeleteBuilder<T>;
-}
-interface DatabaseAdapter {
-    from<T = Record<string, unknown>>(table: string): TableBuilder<T>;
-    rpc<T = unknown>(fn: string, params?: Record<string, unknown>): PromiseLike<DbResult<T>>;
-}
-
-/**
- * SQLite Adapter
- *
- * Implements the DatabaseAdapter interface using better-sqlite3.
- * Translates the SupabaseClient-shaped query builder API into SQL queries
- * against a local SQLite database.
- *
- * Used by the enterprise runtime for local data plane storage.
- */
-
-/**
- * Map of registered RPC functions for the SQLite adapter.
- * In Supabase, .rpc() calls server-side Postgres functions.
- * In SQLite, we register JS functions that perform the same logic.
- */
-type RpcHandler = (params: Record<string, unknown>) => unknown;
-interface SqliteAdapterOptions {
-    rpcHandlers?: Record<string, RpcHandler>;
-}
-declare function createSqliteAdapter(db: Database.Database, options?: SqliteAdapterOptions): DatabaseAdapter;
-
-export { type SqliteAdapterOptions, createSqliteAdapter };
+export {  }