botschat 0.1.18 → 0.1.20

package/README.md

@@ -3,6 +3,8 @@
 [![npm](https://img.shields.io/npm/v/botschat)](https://www.npmjs.com/package/botschat)
 [![npm](https://img.shields.io/npm/v/@botschat/botschat)](https://www.npmjs.com/package/@botschat/botschat)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
+[![macOS](https://img.shields.io/badge/Download-macOS_App-black?logo=apple&logoColor=white)](https://github.com/botschat-app/botsChat/releases/latest/download/BotsChat-mac.dmg)
+[![iOS](https://img.shields.io/badge/Download-iOS_App-blue?logo=apple&logoColor=white)](https://apps.apple.com/app/botschat-chat-with-agent/id6759292058)
 
 A self-hosted, **end-to-end encrypted** chat interface for [OpenClaw](https://github.com/openclaw/openclaw) AI agents.
 
@@ -103,6 +105,8 @@ BotsChat is **100% open source** — the [same code](https://github.com/botschat
 | **B. Run Locally** | Development, no cloud account | Yes |
 | **C. Deploy to Cloudflare** | Remote access (e.g. from phone) | Yes |
 
+> **Native Apps**: A macOS client is available — [download the latest DMG](https://github.com/botschat-app/botsChat/releases/latest/download/BotsChat-mac.dmg) (signed and notarized, Apple Silicon + Intel). An iOS app is also available on the [App Store](https://apps.apple.com/app/botschat-chat-with-agent/id6759292058).
+
 Pick one below and follow its steps, then continue to [Install the OpenClaw Plugin](#install-the-openclaw-plugin).
 
 ---

package/migrations/0013_agents_table.sql

@@ -0,0 +1,29 @@
+-- Multi-Agent Architecture: agents table
+-- Agent = Type (engine) x Role (persona), independent of channels.
+
+CREATE TABLE IF NOT EXISTS agents (
+  id                TEXT PRIMARY KEY,                -- 'agt_xxx'
+  user_id           TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  name              TEXT NOT NULL,                   -- display name: "OpenClaw", "Cursor", "PM小明"
+  type              TEXT NOT NULL CHECK (type IN ('openclaw', 'cursor_cli', 'cursor_cloud', 'claude_code', 'mock')),
+  -- Role & Skills
+  role              TEXT NOT NULL DEFAULT 'general',  -- 'product_manager', 'developer', 'qa', 'devops', 'general'
+  system_prompt     TEXT NOT NULL DEFAULT '',
+  skills_json       TEXT NOT NULL DEFAULT '[]',       -- JSON: [{"name":"...","description":"..."}]
+  -- Connection credentials (provider-specific, at most one populated)
+  pairing_token     TEXT,                             -- OpenClaw bc_pat_xxx
+  api_key           TEXT,                             -- Cursor / Claude API key
+  config_json       TEXT NOT NULL DEFAULT '{}',       -- extra: { workspace, repository, ref, ... }
+  -- Technical capabilities (derived from type)
+  capabilities      TEXT NOT NULL DEFAULT '["chat"]', -- JSON: ["chat","streaming","cron","a2ui","media","code_edit","delegate"]
+  -- Runtime state
+  status            TEXT NOT NULL DEFAULT 'disconnected' CHECK (status IN ('connected', 'disconnected')),
+  last_connected_at INTEGER,
+  connection_count  INTEGER NOT NULL DEFAULT 0,
+  last_ip           TEXT,
+  created_at        INTEGER NOT NULL DEFAULT (unixepoch()),
+  updated_at        INTEGER NOT NULL DEFAULT (unixepoch())
+);
+CREATE INDEX IF NOT EXISTS idx_agents_user ON agents(user_id);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_agents_pairing_token ON agents(pairing_token) WHERE pairing_token IS NOT NULL;
+CREATE UNIQUE INDEX IF NOT EXISTS idx_agents_api_key ON agents(api_key) WHERE api_key IS NOT NULL;

package/migrations/0014_agent_sessions.sql

@@ -0,0 +1,19 @@
+-- Multi-Agent Architecture: agent_sessions mapping table
+-- Maps BotsChat sessions to each agent's provider-side session identifier.
+-- e.g. BotsChat ses_001 x Cursor agent -> Cursor chatId "abc-123"
+
+CREATE TABLE IF NOT EXISTS agent_sessions (
+  id                    TEXT PRIMARY KEY,       -- 'as_xxx'
+  session_id            TEXT NOT NULL,          -- BotsChat session (ses_xxx)
+  agent_id              TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+  provider_session_id   TEXT,                   -- provider-specific session ID
+  -- OpenClaw: session_key "agent:main:botschat:u_xxx:ses:ses_xxx"
+  -- Cursor CLI: chatId (uuid from `agent create-chat`)
+  -- Cursor Cloud: cloud agent id "bc_xxx"
+  metadata_json         TEXT NOT NULL DEFAULT '{}',
+  created_at            INTEGER NOT NULL DEFAULT (unixepoch()),
+  updated_at            INTEGER NOT NULL DEFAULT (unixepoch()),
+  UNIQUE(session_id, agent_id)
+);
+CREATE INDEX IF NOT EXISTS idx_agent_sessions_session ON agent_sessions(session_id);
+CREATE INDEX IF NOT EXISTS idx_agent_sessions_agent ON agent_sessions(agent_id);

package/migrations/0015_message_traces.sql

@@ -0,0 +1,27 @@
+-- Multi-Agent Architecture: message_traces table
+-- Stores agent execution traces at different verbosity levels.
+-- lv1 = conclusions (stored in messages table)
+-- lv2 = thinking / reasoning process
+-- lv3 = reference material / tool call results
+
+CREATE TABLE IF NOT EXISTS message_traces (
+  id              TEXT PRIMARY KEY,               -- 'mt_xxx'
+  message_id      TEXT NOT NULL,                  -- parent lv1 message (messages.id)
+  user_id         TEXT NOT NULL,
+  session_key     TEXT NOT NULL,
+  agent_id        TEXT NOT NULL REFERENCES agents(id) ON DELETE CASCADE,
+  verbose_level   INTEGER NOT NULL CHECK (verbose_level IN (2, 3)),
+  trace_type      TEXT NOT NULL,
+  -- lv2: 'thinking', 'planning', 'reasoning', 'decision'
+  -- lv3: 'file_read', 'file_write', 'command_exec', 'search_result', 'tool_call', 'reference'
+  content         BLOB NOT NULL,
+  metadata_json   TEXT NOT NULL DEFAULT '{}',
+  -- lv3 file_read:    { "path": "src/auth.ts", "lines": 42 }
+  -- lv3 command_exec: { "command": "npm test", "exitCode": 0 }
+  -- lv3 file_write:   { "path": "src/auth.ts", "linesChanged": 5 }
+  encrypted       INTEGER NOT NULL DEFAULT 0,
+  created_at      INTEGER NOT NULL DEFAULT (unixepoch())
+);
+CREATE INDEX IF NOT EXISTS idx_traces_message ON message_traces(message_id);
+CREATE INDEX IF NOT EXISTS idx_traces_session_level ON message_traces(session_key, verbose_level, created_at);
+CREATE INDEX IF NOT EXISTS idx_traces_agent ON message_traces(agent_id, created_at);

package/migrations/0016_multi_agent_channels_messages.sql

@@ -0,0 +1,9 @@
+-- Multi-Agent Architecture: extend channels and messages for multi-agent support.
+
+-- Channels: add default agent + rename openclaw-specific column
+ALTER TABLE channels ADD COLUMN default_agent_id TEXT REFERENCES agents(id);
+ALTER TABLE channels RENAME COLUMN openclaw_agent_id TO provider_agent_id;
+
+-- Messages: track which agent sent/received each message
+ALTER TABLE messages ADD COLUMN sender_agent_id TEXT REFERENCES agents(id);
+ALTER TABLE messages ADD COLUMN target_agent_id TEXT REFERENCES agents(id);

package/migrations/0017_rename_cron_job_id.sql

@@ -0,0 +1,2 @@
+-- Multi-Agent: rename openclaw_cron_job_id -> provider_job_id in tasks table
+ALTER TABLE tasks RENAME COLUMN openclaw_cron_job_id TO provider_job_id;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botschat",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "A self-hosted chat interface for OpenClaw AI agents",
   "workspaces": [
     "packages/*"