botschat 0.1.20 → 0.1.21

package/packages/api/src/protocol-v2.ts

@@ -1,154 +0,0 @@
-/**
- * BotsChat v2 Multi-Agent Protocol
- *
- * Core Protocol: all agent bridges MUST implement these message types.
- * Provider Extensions: optional, provider-specific messages (OpenClaw cron, etc.)
- *
- * Agent = Type (engine) × Role (persona). Each agent connects via a separate
- * WebSocket and authenticates with its own agentId.
- */
-
-// ── Agent metadata shared across protocol ──
-
-export type AgentType = "openclaw" | "cursor_cli" | "cursor_cloud" | "claude_code" | "mock";
-
-export type AgentInfo = {
-  id: string;
-  name: string;
-  type: AgentType;
-  role: string;
-  capabilities: string[];
-  status: "connected" | "disconnected";
-};
-
-// ── Core Protocol: Agent → Cloud (outbound) ──
-
-export type CoreOutbound =
-  | {
-      type: "auth";
-      token: string;
-      agentId?: string;
-      agentType?: AgentType;
-      agents?: string[];
-      model?: string;
-    }
-  | {
-      type: "agent.text";
-      agentId?: string;
-      sessionKey: string;
-      text: string;
-      requestId?: string;
-      replyToId?: string;
-      threadId?: string;
-      encrypted?: boolean;
-      messageId?: string;
-      notifyPreview?: string;
-    }
-  | {
-      type: "agent.media";
-      agentId?: string;
-      sessionKey: string;
-      mediaUrl: string;
-      caption?: string;
-      replyToId?: string;
-      threadId?: string;
-      encrypted?: boolean;
-      mediaEncrypted?: boolean;
-      messageId?: string;
-      notifyPreview?: string;
-    }
-  | { type: "agent.stream.start"; agentId?: string; sessionKey: string; runId: string }
-  | { type: "agent.stream.chunk"; agentId?: string; sessionKey: string; runId: string; text: string }
-  | { type: "agent.stream.end"; agentId?: string; sessionKey: string; runId: string }
-  | { type: "status"; connected: boolean; agents?: string[]; model?: string }
-  | { type: "pong" };
-
-// ── Core Protocol: Cloud → Agent (inbound) ──
-
-export type CoreInbound =
-  | {
-      type: "auth.ok";
-      userId: string;
-      agentId?: string;
-      availableAgents?: AgentInfo[];
-    }
-  | { type: "auth.fail"; reason: string }
-  | {
-      type: "user.message";
-      sessionKey: string;
-      text: string;
-      userId: string;
-      messageId: string;
-      targetAgentId?: string;
-      mediaUrl?: string;
-      parentMessageId?: string;
-      parentText?: string;
-      parentSender?: string;
-      parentEncrypted?: number;
-    }
-  | { type: "user.media"; sessionKey: string; mediaUrl: string; userId: string }
-  | { type: "user.action"; sessionKey: string; action: string; params: Record<string, unknown> }
-  | { type: "user.command"; sessionKey: string; command: string; args?: string }
-  | { type: "ping" };
-
-// ── Agent-to-Agent Delegation ──
-
-export type AgentRequestMessage = {
-  type: "agent.request";
-  agentId: string;
-  targetAgentId: string;
-  sessionKey: string;
-  text: string;
-  requestId: string;
-  depth: number;
-  context?: {
-    summary: string;
-    constraints?: string[];
-    expectedOutput?: string;
-  };
-  ephemeral?: boolean;
-};
-
-export type AgentResponseMessage = {
-  type: "agent.response";
-  requestId: string;
-  fromAgentId: string;
-  text: string;
-  sessionKey: string;
-  error?: string;
-};
-
-// ── Verbose Trace (lv2/lv3 execution traces) ──
-
-export type AgentTraceMessage = {
-  type: "agent.trace";
-  agentId: string;
-  sessionKey: string;
-  messageId: string;
-  verboseLevel: 2 | 3;
-  traceType: string;
-  // lv2: "thinking" | "planning" | "reasoning" | "decision"
-  // lv3: "file_read" | "file_write" | "command_exec" | "search_result" | "tool_call" | "reference"
-  content: string;
-  metadata?: Record<string, unknown>;
-  encrypted?: boolean;
-};
-
-// ── Combined v2 Protocol Types ──
-
-export type V2Outbound = CoreOutbound | AgentRequestMessage | AgentTraceMessage;
-export type V2Inbound = CoreInbound | AgentResponseMessage;
-
-// ── Delegation safety constants ──
-
-export const MAX_DELEGATION_DEPTH = 5;
-export const DELEGATION_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
-
-// ── Pending request tracking (used by ConnectionDO) ──
-
-export type PendingRequest = {
-  fromAgentId: string;
-  sessionKey: string;
-  depth: number;
-  createdAt: number;
-};

package/packages/api/src/routes/agents-v2.ts

@@ -1,192 +0,0 @@
-import { Hono } from "hono";
-import type { Env } from "../env.js";
-import { generateId } from "../utils/id.js";
-
-/**
- * Agents v2 API — agents are first-class entities (team members),
- * independent of channels. Each agent has a type (engine) and role (persona).
- */
-const agentsV2 = new Hono<{ Bindings: Env; Variables: { userId: string } }>();
-
-export type AgentType = "openclaw" | "cursor_cli" | "cursor_cloud" | "claude_code" | "mock";
-
-export type AgentV2 = {
-  id: string;
-  name: string;
-  type: AgentType;
-  role: string;
-  systemPrompt: string;
-  skills: Array<{ name: string; description: string }>;
-  capabilities: string[];
-  status: "connected" | "disconnected";
-  lastConnectedAt: number | null;
-  createdAt: number;
-  updatedAt: number;
-};
-
-const CAPABILITIES_BY_TYPE: Record<AgentType, string[]> = {
-  openclaw: ["chat", "streaming", "cron", "a2ui", "media", "code_edit", "delegate"],
-  cursor_cli: ["chat", "streaming", "code_edit"],
-  cursor_cloud: ["chat", "code_edit"],
-  claude_code: ["chat", "streaming", "code_edit"],
-  mock: ["chat", "streaming"],
-};
-
-function dbRowToAgent(row: Record<string, unknown>): AgentV2 {
-  return {
-    id: row.id as string,
-    name: row.name as string,
-    type: row.type as AgentType,
-    role: row.role as string,
-    systemPrompt: row.system_prompt as string,
-    skills: JSON.parse((row.skills_json as string) || "[]"),
-    capabilities: JSON.parse((row.capabilities as string) || "[]"),
-    status: (row.status as "connected" | "disconnected") ?? "disconnected",
-    lastConnectedAt: row.last_connected_at as number | null,
-    createdAt: row.created_at as number,
-    updatedAt: row.updated_at as number,
-  };
-}
-
-/** GET /api/v2/agents — list all agents for the current user */
-agentsV2.get("/", async (c) => {
-  const userId = c.get("userId");
-  const { results } = await c.env.DB.prepare(
-    `SELECT id, name, type, role, system_prompt, skills_json, capabilities,
-            status, last_connected_at, created_at, updated_at
-     FROM agents WHERE user_id = ? ORDER BY created_at ASC`,
-  )
-    .bind(userId)
-    .all();
-
-  return c.json({ agents: (results ?? []).map(dbRowToAgent) });
-});
-
-/** POST /api/v2/agents — create a new agent */
-agentsV2.post("/", async (c) => {
-  const userId = c.get("userId");
-  const body = await c.req.json<{
-    name: string;
-    type: AgentType;
-    role?: string;
-    systemPrompt?: string;
-    skills?: Array<{ name: string; description: string }>;
-    pairingToken?: string;
-    apiKey?: string;
-    config?: Record<string, unknown>;
-  }>();
-
-  if (!body.name?.trim()) return c.json({ error: "Agent name is required" }, 400);
-  if (!body.type) return c.json({ error: "Agent type is required" }, 400);
-
-  const id = generateId("agt_");
-  const capabilities = CAPABILITIES_BY_TYPE[body.type] ?? ["chat"];
-
-  await c.env.DB.prepare(
-    `INSERT INTO agents (id, user_id, name, type, role, system_prompt, skills_json,
-      pairing_token, api_key, config_json, capabilities)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
-  )
-    .bind(
-      id,
-      userId,
-      body.name.trim(),
-      body.type,
-      body.role ?? "general",
-      body.systemPrompt?.trim() ?? "",
-      JSON.stringify(body.skills ?? []),
-      body.pairingToken ?? null,
-      body.apiKey ?? null,
-      JSON.stringify(body.config ?? {}),
-      JSON.stringify(capabilities),
-    )
-    .run();
-
-  const row = await c.env.DB.prepare(
-    `SELECT id, name, type, role, system_prompt, skills_json, capabilities,
-            status, last_connected_at, created_at, updated_at
-     FROM agents WHERE id = ?`,
-  )
-    .bind(id)
-    .first();
-
-  return c.json(dbRowToAgent(row!), 201);
-});
-
-/** GET /api/v2/agents/:id — get a single agent */
-agentsV2.get("/:id", async (c) => {
-  const userId = c.get("userId");
-  const agentId = c.req.param("id");
-
-  const row = await c.env.DB.prepare(
-    `SELECT id, name, type, role, system_prompt, skills_json, capabilities,
-            status, last_connected_at, created_at, updated_at
-     FROM agents WHERE id = ? AND user_id = ?`,
-  )
-    .bind(agentId, userId)
-    .first();
-
-  if (!row) return c.json({ error: "Agent not found" }, 404);
-  return c.json(dbRowToAgent(row));
-});
-
-/** PATCH /api/v2/agents/:id — update an agent */
-agentsV2.patch("/:id", async (c) => {
-  const userId = c.get("userId");
-  const agentId = c.req.param("id");
-  const body = await c.req.json<{
-    name?: string;
-    role?: string;
-    systemPrompt?: string;
-    skills?: Array<{ name: string; description: string }>;
-    config?: Record<string, unknown>;
-  }>();
-
-  const sets: string[] = [];
-  const values: unknown[] = [];
-
-  if (body.name !== undefined) { sets.push("name = ?"); values.push(body.name.trim()); }
-  if (body.role !== undefined) { sets.push("role = ?"); values.push(body.role); }
-  if (body.systemPrompt !== undefined) { sets.push("system_prompt = ?"); values.push(body.systemPrompt.trim()); }
-  if (body.skills !== undefined) { sets.push("skills_json = ?"); values.push(JSON.stringify(body.skills)); }
-  if (body.config !== undefined) { sets.push("config_json = ?"); values.push(JSON.stringify(body.config)); }
-
-  if (sets.length === 0) return c.json({ error: "No fields to update" }, 400);
-
-  sets.push("updated_at = unixepoch()");
-  values.push(agentId, userId);
-
-  await c.env.DB.prepare(
-    `UPDATE agents SET ${sets.join(", ")} WHERE id = ? AND user_id = ?`,
-  )
-    .bind(...values)
-    .run();
-
-  const row = await c.env.DB.prepare(
-    `SELECT id, name, type, role, system_prompt, skills_json, capabilities,
-            status, last_connected_at, created_at, updated_at
-     FROM agents WHERE id = ? AND user_id = ?`,
-  )
-    .bind(agentId, userId)
-    .first();
-
-  if (!row) return c.json({ error: "Agent not found" }, 404);
-  return c.json(dbRowToAgent(row));
-});
-
-/** DELETE /api/v2/agents/:id — delete an agent */
-agentsV2.delete("/:id", async (c) => {
-  const userId = c.get("userId");
-  const agentId = c.req.param("id");
-
-  const { meta } = await c.env.DB.prepare(
-    "DELETE FROM agents WHERE id = ? AND user_id = ?",
-  )
-    .bind(agentId, userId)
-    .run();
-
-  if (!meta.changes) return c.json({ error: "Agent not found" }, 404);
-  return c.json({ ok: true });
-});
-
-export { agentsV2 };

package/packages/api/src/routes/history-v2.ts

@@ -1,221 +0,0 @@
-import { Hono } from "hono";
-import type { Env } from "../env.js";
-
-/**
- * History Query API v2 — supports verbose-level filtering, agent filtering,
- * trace type filtering, and keyword search across messages + message_traces.
- *
- * GET /api/v2/messages/query?sessionKey=...&verboseLevel=1&limit=50
- */
-const historyV2 = new Hono<{ Bindings: Env; Variables: { userId: string } }>();
-
-historyV2.get("/query", async (c) => {
-  const userId = c.get("userId");
-  const sessionKey = c.req.query("sessionKey");
-  if (!sessionKey) return c.json({ error: "sessionKey required" }, 400);
-
-  const verboseLevel = Math.min(Number(c.req.query("verboseLevel") ?? 1), 3);
-  const limit = Math.min(Number(c.req.query("limit") ?? 50), 200);
-  const senderFilter = c.req.query("senderFilter"); // "user" | "agent" | undefined
-  const agentIdFilter = c.req.query("agentIdFilter");
-  const traceTypeFilter = c.req.query("traceTypeFilter");
-  const keyword = c.req.query("keyword");
-  const beforeMessageId = c.req.query("beforeMessageId");
-
-  // Build lv1 query (messages table)
-  const conditions: string[] = ["m.session_key = ?", "m.user_id = ?"];
-  const params: unknown[] = [sessionKey, userId];
-
-  if (senderFilter === "user" || senderFilter === "agent") {
-    conditions.push("m.sender = ?");
-    params.push(senderFilter);
-  }
-  if (agentIdFilter) {
-    conditions.push("(m.sender_agent_id = ? OR m.target_agent_id = ?)");
-    params.push(agentIdFilter, agentIdFilter);
-  }
-  if (keyword) {
-    conditions.push("m.text LIKE ?");
-    params.push(`%${keyword}%`);
-  }
-  if (beforeMessageId) {
-    conditions.push("m.created_at < (SELECT created_at FROM messages WHERE id = ?)");
-    params.push(beforeMessageId);
-  }
-
-  params.push(limit);
-
-  const { results: messages } = await c.env.DB.prepare(
-    `SELECT m.id, m.sender, m.sender_agent_id, m.target_agent_id, m.text, m.media_url, m.encrypted, m.created_at
-     FROM messages m
-     WHERE ${conditions.join(" AND ")}
-     ORDER BY m.created_at DESC
-     LIMIT ?`,
-  )
-    .bind(...params)
-    .all<{
-      id: string;
-      sender: string;
-      sender_agent_id: string | null;
-      target_agent_id: string | null;
-      text: string;
-      media_url: string | null;
-      encrypted: number;
-      created_at: number;
-    }>();
-
-  // Resolve agent names
-  const agentIds = new Set<string>();
-  for (const m of messages ?? []) {
-    if (m.sender_agent_id) agentIds.add(m.sender_agent_id);
-    if (m.target_agent_id) agentIds.add(m.target_agent_id);
-  }
-
-  const agentNames: Record<string, string> = {};
-  if (agentIds.size > 0) {
-    const placeholders = [...agentIds].map(() => "?").join(",");
-    const { results: agents } = await c.env.DB.prepare(
-      `SELECT id, name FROM agents WHERE id IN (${placeholders})`,
-    )
-      .bind(...agentIds)
-      .all<{ id: string; name: string }>();
-    for (const a of agents ?? []) {
-      agentNames[a.id] = a.name;
-    }
-  }
-
-  // Build response
-  type MessageResponse = {
-    id: string;
-    sender: string;
-    senderAgentId?: string;
-    senderAgentName?: string;
-    targetAgentId?: string;
-    text: string;
-    mediaUrl?: string;
-    encrypted: boolean;
-    timestamp: number;
-    traces?: Array<{
-      verboseLevel: number;
-      traceType: string;
-      content: string;
-      metadata?: Record<string, unknown>;
-    }>;
-  };
-
-  const result: MessageResponse[] = [];
-  const messageIds = (messages ?? []).map((m) => m.id);
-
-  // Fetch traces if verboseLevel >= 2
-  let tracesByMessageId: Record<string, Array<{ verbose_level: number; trace_type: string; content: string; metadata_json: string }>> = {};
-
-  if (verboseLevel >= 2 && messageIds.length > 0) {
-    const traceConds: string[] = ["message_id IN (" + messageIds.map(() => "?").join(",") + ")"];
-    const traceParams: unknown[] = [...messageIds];
-
-    traceConds.push("verbose_level <= ?");
-    traceParams.push(verboseLevel);
-
-    if (traceTypeFilter) {
-      traceConds.push("trace_type = ?");
-      traceParams.push(traceTypeFilter);
-    }
-    if (agentIdFilter) {
-      traceConds.push("agent_id = ?");
-      traceParams.push(agentIdFilter);
-    }
-
-    const { results: traces } = await c.env.DB.prepare(
-      `SELECT message_id, verbose_level, trace_type, content, metadata_json
-       FROM message_traces
-       WHERE ${traceConds.join(" AND ")}
-       ORDER BY created_at ASC`,
-    )
-      .bind(...traceParams)
-      .all<{ message_id: string; verbose_level: number; trace_type: string; content: string; metadata_json: string }>();
-
-    for (const t of traces ?? []) {
-      if (!tracesByMessageId[t.message_id]) tracesByMessageId[t.message_id] = [];
-      tracesByMessageId[t.message_id].push(t);
-    }
-  }
-
-  for (const m of messages ?? []) {
-    const msg: MessageResponse = {
-      id: m.id,
-      sender: m.sender,
-      senderAgentId: m.sender_agent_id ?? undefined,
-      senderAgentName: m.sender_agent_id ? agentNames[m.sender_agent_id] : undefined,
-      targetAgentId: m.target_agent_id ?? undefined,
-      text: typeof m.text === "string" ? m.text : "",
-      mediaUrl: m.media_url ?? undefined,
-      encrypted: !!m.encrypted,
-      timestamp: m.created_at,
-    };
-
-    if (verboseLevel >= 2 && tracesByMessageId[m.id]) {
-      msg.traces = tracesByMessageId[m.id].map((t) => ({
-        verboseLevel: t.verbose_level,
-        traceType: t.trace_type,
-        content: typeof t.content === "string" ? t.content : "",
-        metadata: t.metadata_json ? JSON.parse(t.metadata_json) : undefined,
-      }));
-    }
-
-    result.push(msg);
-  }
-
-  // Return in chronological order (query was DESC for LIMIT, reverse for output)
-  result.reverse();
-
-  return c.json({ messages: result, hasMore: (messages?.length ?? 0) === limit });
-});
-
-/** GET /api/v2/messages/traces/:messageId — fetch traces for a specific message */
-historyV2.get("/traces/:messageId", async (c) => {
-  const userId = c.get("userId");
-  const messageId = c.req.param("messageId");
-  const verboseLevel = Math.min(Number(c.req.query("verboseLevel") ?? 3), 3);
-
-  // Verify message belongs to user
-  const msg = await c.env.DB.prepare(
-    "SELECT id FROM messages WHERE id = ? AND user_id = ?",
-  )
-    .bind(messageId, userId)
-    .first();
-
-  if (!msg) return c.json({ error: "Message not found" }, 404);
-
-  const { results: traces } = await c.env.DB.prepare(
-    `SELECT id, verbose_level, trace_type, content, metadata_json, agent_id, encrypted, created_at
-     FROM message_traces
-     WHERE message_id = ? AND verbose_level <= ?
-     ORDER BY created_at ASC`,
-  )
-    .bind(messageId, verboseLevel)
-    .all<{
-      id: string;
-      verbose_level: number;
-      trace_type: string;
-      content: string;
-      metadata_json: string;
-      agent_id: string;
-      encrypted: number;
-      created_at: number;
-    }>();
-
-  return c.json({
-    traces: (traces ?? []).map((t) => ({
-      id: t.id,
-      verboseLevel: t.verbose_level,
-      traceType: t.trace_type,
-      content: typeof t.content === "string" ? t.content : "",
-      metadata: t.metadata_json ? JSON.parse(t.metadata_json) : undefined,
-      agentId: t.agent_id,
-      encrypted: !!t.encrypted,
-      timestamp: t.created_at,
-    })),
-  });
-});
-
-export { historyV2 };

package/packages/api/src/routes/migrate-v2.ts

@@ -1,110 +0,0 @@
-import { Hono } from "hono";
-import type { Env } from "../env.js";
-import { generateId } from "../utils/id.js";
-
-/**
- * One-time migration endpoint: converts legacy pairing_tokens into agents,
- * backfills channels.default_agent_id, and sets messages.sender_agent_id.
- *
- * POST /api/v2/migrate — idempotent, safe to run multiple times.
- * Only available in development mode.
- */
-const migrateV2 = new Hono<{ Bindings: Env; Variables: { userId: string } }>();
-
-migrateV2.post("/", async (c) => {
-  if (c.env.ENVIRONMENT !== "development") {
-    return c.json({ error: "Migration endpoint only available in development" }, 403);
-  }
-
-  const userId = c.get("userId");
-  const stats = { agentsCreated: 0, channelsUpdated: 0, messagesUpdated: 0, skipped: 0 };
-
-  // Step 1: Migrate pairing_tokens → agents (skip if agent with same token already exists)
-  const { results: tokens } = await c.env.DB.prepare(
-    "SELECT id, token, label, last_connected_at, last_ip, connection_count FROM pairing_tokens WHERE user_id = ? AND revoked_at IS NULL",
-  )
-    .bind(userId)
-    .all<{
-      id: string;
-      token: string;
-      label: string | null;
-      last_connected_at: number | null;
-      last_ip: string | null;
-      connection_count: number;
-    }>();
-
-  let defaultAgentId: string | null = null;
-
-  for (const pt of tokens ?? []) {
-    const existing = await c.env.DB.prepare(
-      "SELECT id FROM agents WHERE pairing_token = ?",
-    )
-      .bind(pt.token)
-      .first<{ id: string }>();
-
-    if (existing) {
-      if (!defaultAgentId) defaultAgentId = existing.id;
-      stats.skipped++;
-      continue;
-    }
-
-    const agentId = generateId("agt_");
-    await c.env.DB.prepare(
-      `INSERT INTO agents (id, user_id, name, type, role, pairing_token, capabilities,
-        status, last_connected_at, last_ip, connection_count)
-       VALUES (?, ?, ?, 'openclaw', 'general', ?, '["chat","streaming","cron","a2ui","media","code_edit","delegate"]',
-        'disconnected', ?, ?, ?)`,
-    )
-      .bind(
-        agentId,
-        userId,
-        pt.label ?? "OpenClaw",
-        pt.token,
-        pt.last_connected_at,
-        pt.last_ip,
-        pt.connection_count ?? 0,
-      )
-      .run();
-
-    if (!defaultAgentId) defaultAgentId = agentId;
-    stats.agentsCreated++;
-  }
-
-  // If no pairing tokens exist but user has no agents, skip backfill
-  if (!defaultAgentId) {
-    const anyAgent = await c.env.DB.prepare(
-      "SELECT id FROM agents WHERE user_id = ? LIMIT 1",
-    )
-      .bind(userId)
-      .first<{ id: string }>();
-    defaultAgentId = anyAgent?.id ?? null;
-  }
-
-  // Step 2: Backfill channels.default_agent_id (set to first agent if null)
-  if (defaultAgentId) {
-    const { meta } = await c.env.DB.prepare(
-      "UPDATE channels SET default_agent_id = ?, updated_at = unixepoch() WHERE user_id = ? AND default_agent_id IS NULL",
-    )
-      .bind(defaultAgentId, userId)
-      .run();
-    stats.channelsUpdated = meta.changes ?? 0;
-  }
-
-  // Step 3: Backfill messages.sender_agent_id for agent messages (set to default agent)
-  if (defaultAgentId) {
-    const { meta } = await c.env.DB.prepare(
-      "UPDATE messages SET sender_agent_id = ? WHERE user_id = ? AND sender = 'agent' AND sender_agent_id IS NULL",
-    )
-      .bind(defaultAgentId, userId)
-      .run();
-    stats.messagesUpdated = meta.changes ?? 0;
-  }
-
-  return c.json({
-    ok: true,
-    defaultAgentId,
-    stats,
-  });
-});
-
-export { migrateV2 };