whale-code 6.5.5 → 6.5.7

package/dist/cli/serve-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-mode.js","names":["createServer","WebSocketServer","WebSocket","runAgentLoop","setModel","setPermissionMode","resetSessionState","getModel","estimateCostUsd","AgentEventEmitter","resolveConfig","createClient","getValidToken","createAuthenticatedClient","loadServerToolDefinitions","LOCAL_TOOL_DEFINITIONS","createRequire","require","import","meta","url","PKG_VERSION","version","supabase","supabaseCreatedAt","SUPABASE_TTL_MS","getSupabase","now","Date","config","supabaseUrl","supabaseKey","process","env","SUPABASE_SERVICE_ROLE_KEY","auth","autoRefreshToken","persistSession","token","createConversation","storeId","title","agentName","db","data","error","from","insert","store_id","substring","metadata","source","status","select","single","console","message","id","err","appendMessage","conversationId","role","content","tokenCount","toolNames","conversation_id","type","text","is_tool_use","length","tool_names","token_count","updateConversationMetadata","eq","existing","update","updated_at","toISOString","loadConversation","messages","listConversations","limit","order","ascending","map","c","agentId","agent_id","messageCount","turn_count","createdAt","created_at","updatedAt","getToolList","tools","t","push","name","description","category","serverTools","some","send","ws","readyState","OPEN","JSON","stringify","sendDebug","level","handleQuery","session","msg","opts","prompt","rawAttachments","attachments","images","filter","att","media_type","base64","mediaType","requestedConvId","clientHistory","conversationHistory","m","trim","model","conversation","abortController","AbortController","totalIn","totalOut","lastCostUsd","fullText","toolsUsed","startTime","emitter","forwardTypes","Set","eventHandler","event","has","on","callbacks","onText","onToolStart","input","includes","tool","onToolResult","success","result","_input","durationMs","wireResult","undefined","duration_ms","onUsage","input_tokens","output_tokens","_thinking_tokens","_model","costUsd","onDone","finalMessages","onError","onAutoCompact","before","after","tokensSaved","loopOpts","abortSignal","signal","maxTurns","maxBudgetUsd","effort","allowedTools","enabledTools","disallowedTools","fallbackModel","totalInputTokens","totalOutputTokens","totalCost","lastTurnTokens","output","lastToolCalls","lastDurationMs","usage","inputTokens","outputTokens","errorMsg","Error","String","aborted","off","handleConnection","verbose","log","toString","parse","abort","toolList","conversations","convs","convId","conv","runServeMode","permissionMode","port","host","server","req","res","method","writeHead","end","uptime","Math","floor","wss","shutdown","clients","forEach","client","close","exit","setTimeout","then","Promise","resolve","reject","code","listen","d","B","r"],"sources":["../../src/cli/serve-mode.ts"],"sourcesContent":["/**\n * Serve Mode — WebSocket agent server for WhaleChat desktop app\n *\n * Speaks the exact bidirectional JSON protocol that AgentClient.swift expects.\n * Runs the full agent loop with all local + server tools.\n *\n * Usage:\n *   whale serve                     Start on default port 3847\n *   whale serve --port 6090         Custom port\n *   whale serve --host 0.0.0.0      Bind to all interfaces\n *\n * Protocol: WebSocket (ws://host:port)\n *\n * Client → Server messages:\n *   query, abort, ping, get_tools, new_conversation, load_conversation, get_conversations\n *\n * Server → Client messages:\n *   ready, started, text, tool_start, tool_result, done, error, aborted,\n *   pong, tools, debug, conversation_created, conversations, conversation_loaded,\n *   subagent_start, subagent_progress, subagent_done, subagent_tool_start, subagent_tool_end,\n *   team_start, team_progress, team_task, team_done\n */\n\nimport { createServer } from \"http\";\nimport { WebSocketServer, WebSocket } from \"ws\";\nimport type Anthropic from \"@anthropic-ai/sdk\";\nimport {\n  runAgentLoop,\n  setModel,\n  setPermissionMode,\n  resetSessionState,\n  getModel,\n  estimateCostUsd,\n  AgentEventEmitter,\n  type AgentLoopCallbacks,\n  type AgentLoopOptions,\n} from \"./services/agent-loop.js\";\nimport { resolveConfig } from \"./services/config-store.js\";\nimport { createClient, type SupabaseClient } from \"@supabase/supabase-js\";\nimport { getValidToken, createAuthenticatedClient } from \"./services/auth-service.js\";\nimport { loadServerToolDefinitions } from \"./services/server-tools.js\";\nimport { LOCAL_TOOL_DEFINITIONS } from \"./services/local-tools.js\";\nimport { createRequire } from \"module\";\n\nconst require = createRequire(import.meta.url);\nconst PKG_VERSION: string = require(\"../../package.json\").version;\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\nexport interface ServeModeOptions {\n  port: number;\n  host: string;\n  model?: string;\n  permissionMode?: string;\n  effort?: string;\n  allowedTools?: string[];\n  disallowedTools?: string[];\n  maxTurns?: number;\n  maxBudgetUsd?: number;\n  fallbackModel?: string;\n  debug?: boolean;\n  verbose?: boolean;\n}\n\ninterface ClientSession {\n  ws: WebSocket;\n  abortController: AbortController | null;\n  conversationHistory: Anthropic.MessageParam[];\n  conversationId: string | null;\n  totalInputTokens: number;\n  totalOutputTokens: number;\n}\n\n// ============================================================================\n// SUPABASE CLIENT (for conversation persistence)\n// ============================================================================\n\nlet supabase: SupabaseClient | null = null;\nlet supabaseCreatedAt = 0;\nconst SUPABASE_TTL_MS = 45 * 60 * 1000; // Refresh client every 45 min (JWT expires ~60 min)\n\nasync function getSupabase(): Promise<SupabaseClient | null> {\n  const now = Date.now();\n\n  // Return cached client if still fresh\n  if (supabase && (now - supabaseCreatedAt) < SUPABASE_TTL_MS) return supabase;\n\n  // Invalidate stale client\n  supabase = null;\n\n  const config = resolveConfig();\n\n  // Tier 1: Service role key (never expires)\n  if (config.supabaseUrl && config.supabaseKey && process.env.SUPABASE_SERVICE_ROLE_KEY) {\n    supabase = createClient(config.supabaseUrl, config.supabaseKey, {\n      auth: { autoRefreshToken: false, persistSession: false },\n    });\n    supabaseCreatedAt = now;\n    return supabase;\n  }\n\n  // Tier 2: User JWT — always get a fresh token\n  try {\n    const token = await getValidToken();\n    if (token) {\n      supabase = createAuthenticatedClient(token);\n      supabaseCreatedAt = now;\n      return supabase;\n    }\n  } catch {\n    // Fall through\n  }\n\n  return null;\n}\n\n// ============================================================================\n// CONVERSATION PERSISTENCE\n// ============================================================================\n\nasync function createConversation(\n  storeId: string | null,\n  title: string,\n  agentName?: string,\n): Promise<string | null> {\n  const db = await getSupabase();\n  if (!db) return null;\n\n  try {\n    const { data, error } = await db\n      .from(\"ai_conversations\")\n      .insert({\n        store_id: storeId || null,\n        title: title.substring(0, 100),\n        metadata: {\n          source: \"whale-serve\",\n          agentName: agentName || \"whale\",\n        },\n        status: \"active\",\n      })\n      .select(\"id\")\n      .single();\n\n    if (error) {\n      console.error(\"[serve] Failed to create conversation:\", error.message);\n      return null;\n    }\n    return data?.id || null;\n  } catch (err) {\n    console.error(\"[serve] Conversation create error:\", err);\n    return null;\n  }\n}\n\nasync function appendMessage(\n  conversationId: string,\n  role: \"user\" | \"assistant\",\n  content: string,\n  tokenCount?: number,\n  toolNames?: string[],\n): Promise<void> {\n  const db = await getSupabase();\n  if (!db || !conversationId) return;\n\n  try {\n    // Insert into ai_messages for individual message tracking\n    await db.from(\"ai_messages\").insert({\n      conversation_id: conversationId,\n      role,\n      content: [{ type: \"text\", text: content }],\n      is_tool_use: (toolNames && toolNames.length > 0) || false,\n      tool_names: toolNames || [],\n      token_count: tokenCount || 0,\n    });\n  } catch {\n    // Non-fatal — persistence is best-effort\n  }\n}\n\nasync function updateConversationMetadata(\n  conversationId: string,\n  metadata: Record<string, unknown>,\n): Promise<void> {\n  const db = await getSupabase();\n  if (!db || !conversationId) return;\n\n  try {\n    // Fetch current metadata, merge, and update\n    const { data } = await db\n      .from(\"ai_conversations\")\n      .select(\"metadata\")\n      .eq(\"id\", conversationId)\n      .single();\n\n    const existing = (data?.metadata as Record<string, unknown>) || {};\n    await db\n      .from(\"ai_conversations\")\n      .update({ metadata: { ...existing, ...metadata }, updated_at: new Date().toISOString() })\n      .eq(\"id\", conversationId);\n  } catch {\n    // Non-fatal\n  }\n}\n\nasync function loadConversation(\n  conversationId: string,\n): Promise<{ id: string; title: string; messages: Record<string, unknown>[] } | null> {\n  const db = await getSupabase();\n  if (!db) return null;\n\n  try {\n    const { data, error } = await db\n      .from(\"ai_conversations\")\n      .select(\"id, title, messages\")\n      .eq(\"id\", conversationId)\n      .single();\n\n    if (error || !data) return null;\n    return {\n      id: data.id,\n      title: data.title || \"Untitled\",\n      messages: (data.messages as Record<string, unknown>[]) || [],\n    };\n  } catch {\n    return null;\n  }\n}\n\nasync function listConversations(\n  storeId: string,\n  limit: number = 20,\n): Promise<Record<string, unknown>[]> {\n  const db = await getSupabase();\n  if (!db) return [];\n\n  try {\n    const { data, error } = await db\n      .from(\"ai_conversations\")\n      .select(\"id, title, agent_id, metadata, turn_count, created_at, updated_at\")\n      .eq(\"store_id\", storeId)\n      .order(\"updated_at\", { ascending: false })\n      .limit(limit);\n\n    if (error || !data) return [];\n    return data.map((c) => ({\n      id: c.id,\n      title: c.title || \"Untitled\",\n      agentId: c.agent_id || null,\n      agentName: (c.metadata as Record<string, unknown>)?.agentName || null,\n      messageCount: c.turn_count || 0,\n      createdAt: c.created_at,\n      updatedAt: c.updated_at,\n    }));\n  } catch {\n    return [];\n  }\n}\n\n// ============================================================================\n// TOOL LIST (for ready/tools messages)\n// ============================================================================\n\nasync function getToolList(): Promise<{ id: string; name: string; description: string; category: string }[]> {\n  const tools: { id: string; name: string; description: string; category: string }[] = [];\n\n  // Local tools\n  for (const t of LOCAL_TOOL_DEFINITIONS) {\n    tools.push({\n      id: `local-${t.name}`,\n      name: t.name,\n      description: t.description,\n      category: \"local\",\n    });\n  }\n\n  // Server tools\n  try {\n    const serverTools = await loadServerToolDefinitions();\n    for (const t of serverTools) {\n      if (!tools.some((existing) => existing.name === t.name)) {\n        tools.push({\n          id: `server-${t.name}`,\n          name: t.name,\n          description: t.description || \"\",\n          category: \"server\",\n        });\n      }\n    }\n  } catch {\n    // Server tools unavailable — local-only mode\n  }\n\n  return tools;\n}\n\n// ============================================================================\n// WEBSOCKET MESSAGE HELPERS\n// ============================================================================\n\nfunction send(ws: WebSocket, message: Record<string, unknown>): void {\n  if (ws.readyState === WebSocket.OPEN) {\n    ws.send(JSON.stringify(message));\n  }\n}\n\nfunction sendDebug(ws: WebSocket, level: string, message: string, data?: Record<string, unknown>): void {\n  send(ws, { type: \"debug\", level, message, data });\n}\n\n// ============================================================================\n// QUERY HANDLER — runs the full agent loop\n// ============================================================================\n\nasync function handleQuery(\n  session: ClientSession,\n  msg: Record<string, unknown>,\n  opts: ServeModeOptions,\n): Promise<void> {\n  const { ws } = session;\n  const prompt = msg.prompt as string;\n  if (!prompt) {\n    send(ws, { type: \"error\", error: \"Missing 'prompt' field\" });\n    return;\n  }\n\n  // Extract image attachments sent by WhaleChat\n  const rawAttachments = (msg.attachments as Array<{ type: string; media_type?: string; data?: string }>) || [];\n  const images = rawAttachments\n    .filter(att => att.type === \"image\" && att.media_type && att.data)\n    .map(att => ({ base64: att.data!, mediaType: att.media_type! }));\n\n  const storeId = (msg.storeId as string) || resolveConfig().storeId || null;\n  const config = (msg.config as Record<string, unknown>) || {};\n  const requestedConvId = (msg.conversationId as string) || session.conversationId;\n\n  // Restore conversation history from client if session is fresh (new WS connection)\n  const clientHistory = msg.conversationHistory as Array<{ role: string; content: string }> | undefined;\n  if (session.conversationHistory.length === 0 && clientHistory && clientHistory.length > 0) {\n    session.conversationHistory = clientHistory\n      .filter((m) => m.content && m.content.trim().length > 0)\n      .map((m) => ({\n        role: m.role as \"user\" | \"assistant\",\n        content: m.content,\n      })) as Anthropic.MessageParam[];\n  }\n\n  // Apply model from config or server defaults\n  const model = (config.model as string) || opts.model;\n  if (model) setModel(model);\n\n  // Create or continue conversation\n  let conversationId = requestedConvId;\n  if (!conversationId) {\n    conversationId = await createConversation(storeId, prompt, config.agentName as string);\n    if (conversationId) {\n      send(ws, {\n        type: \"conversation_created\",\n        conversation: {\n          id: conversationId,\n          title: prompt.substring(0, 100),\n          agentId: config.agentId || null,\n          agentName: config.agentName || \"whale\",\n          messageCount: 0,\n          createdAt: new Date().toISOString(),\n          updatedAt: new Date().toISOString(),\n        },\n      });\n    }\n  }\n  session.conversationId = conversationId;\n\n  // Persist user message\n  if (conversationId) {\n    appendMessage(conversationId, \"user\", prompt);\n  }\n\n  // Signal started\n  send(ws, {\n    type: \"started\",\n    model: getModel(),\n    conversationId,\n  });\n\n  // Set up abort controller\n  const abortController = new AbortController();\n  session.abortController = abortController;\n\n  let totalIn = 0;\n  let totalOut = 0;\n  let lastCostUsd = 0;\n  let fullText = \"\";\n  const toolsUsed: string[] = [];\n  const startTime = Date.now();\n\n  // Create event emitter for subagent/team events → forward to WebSocket\n  const emitter = new AgentEventEmitter();\n  const forwardTypes = new Set([\n    \"subagent_start\", \"subagent_progress\", \"subagent_done\",\n    \"subagent_tool_start\", \"subagent_tool_end\",\n    \"team_start\", \"team_progress\", \"team_task\", \"team_done\",\n  ]);\n  const eventHandler = (event: { type: string; [key: string]: unknown }) => {\n    if (event.type === \"text\") {\n      // Emitter captures text events — forward them to WebSocket + accumulate\n      const text = event.text as string;\n      if (text) { fullText += text; send(ws, { type: \"text\", text }); }\n    } else if (forwardTypes.has(event.type)) {\n      send(ws, event as Record<string, unknown>);\n    }\n  };\n  emitter.on(\"event\", eventHandler);\n\n  try {\n    const callbacks: AgentLoopCallbacks = {\n      onText: (text: string) => {\n        fullText += text;\n        send(ws, { type: \"text\", text });\n      },\n\n      onToolStart: (name: string, input?: Record<string, unknown>) => {\n        if (!toolsUsed.includes(name)) toolsUsed.push(name);\n        send(ws, { type: \"tool_start\", tool: name, input: input || {} });\n      },\n\n      onToolResult: (\n        name: string,\n        success: boolean,\n        result: unknown,\n        _input?: Record<string, unknown>,\n        durationMs?: number,\n      ) => {\n        // Truncate large results for the wire\n        let wireResult = result;\n        if (typeof result === \"string\" && result.length > 10000) {\n          wireResult = result.substring(0, 10000) + \"\\n... (truncated)\";\n        }\n        send(ws, {\n          type: \"tool_result\",\n          tool: name,\n          success,\n          result: wireResult,\n          error: success ? undefined : (typeof result === \"string\" ? result : \"Tool failed\"),\n          duration_ms: durationMs,\n        });\n      },\n\n      onUsage: (input_tokens: number, output_tokens: number, _thinking_tokens?: number, _model?: string, costUsd?: number) => {\n        totalIn += input_tokens;\n        totalOut += output_tokens;\n        if (costUsd != null) lastCostUsd = costUsd;\n      },\n\n      onDone: (finalMessages: Anthropic.MessageParam[]) => {\n        session.conversationHistory = finalMessages;\n      },\n\n      onError: (error: string) => {\n        send(ws, { type: \"error\", error });\n      },\n\n      onAutoCompact: (before: number, after: number, tokensSaved: number) => {\n        sendDebug(ws, \"info\", `Context compacted: ${before} → ${after} messages (saved ~${tokensSaved} tokens)`);\n      },\n    };\n\n    const loopOpts: AgentLoopOptions = {\n      message: prompt,\n      images: images.length > 0 ? images : undefined,\n      conversationHistory: session.conversationHistory,\n      callbacks,\n      abortSignal: abortController.signal,\n      emitter,\n      maxTurns: (config.maxTurns as number) || opts.maxTurns,\n      maxBudgetUsd: opts.maxBudgetUsd,\n      effort: (opts.effort || \"medium\") as \"low\" | \"medium\" | \"high\",\n      allowedTools: (config.enabledTools as string[]) || opts.allowedTools,\n      disallowedTools: opts.disallowedTools,\n      fallbackModel: opts.fallbackModel,\n    };\n\n    await runAgentLoop(loopOpts);\n\n    // Calculate cost\n    session.totalInputTokens += totalIn;\n    session.totalOutputTokens += totalOut;\n    const totalCost = lastCostUsd || estimateCostUsd(session.totalInputTokens, session.totalOutputTokens);\n    const durationMs = Date.now() - startTime;\n\n    // Persist assistant response\n    if (conversationId && fullText) {\n      appendMessage(conversationId, \"assistant\", fullText, totalOut, toolsUsed);\n    }\n\n    // Update conversation metadata\n    if (conversationId) {\n      updateConversationMetadata(conversationId, {\n        lastTurnTokens: { input: totalIn, output: totalOut },\n        lastToolCalls: toolsUsed,\n        lastDurationMs: durationMs,\n        model: getModel(),\n      });\n    }\n\n    // Send done\n    send(ws, {\n      type: \"done\",\n      status: \"complete\",\n      conversationId: conversationId || \"\",\n      usage: {\n        inputTokens: session.totalInputTokens,\n        outputTokens: session.totalOutputTokens,\n        totalCost,\n      },\n    });\n  } catch (err) {\n    const errorMsg = err instanceof Error ? err.message : String(err);\n    if (abortController.signal.aborted) {\n      send(ws, { type: \"aborted\" });\n    } else {\n      send(ws, { type: \"error\", error: errorMsg });\n    }\n  } finally {\n    emitter.off(\"event\", eventHandler);\n    session.abortController = null;\n  }\n}\n\n// ============================================================================\n// CONNECTION HANDLER\n// ============================================================================\n\nasync function handleConnection(ws: WebSocket, opts: ServeModeOptions): Promise<void> {\n  const session: ClientSession = {\n    ws,\n    abortController: null,\n    conversationHistory: [],\n    conversationId: null,\n    totalInputTokens: 0,\n    totalOutputTokens: 0,\n  };\n\n  // Send ready with tool list\n  const tools = await getToolList();\n  send(ws, {\n    type: \"ready\",\n    version: PKG_VERSION,\n    tools,\n  });\n\n  if (opts.verbose) {\n    console.log(\"[serve] Client connected, sent ready with\", tools.length, \"tools\");\n  }\n\n  ws.on(\"message\", async (data: Buffer | string) => {\n    let msg: Record<string, unknown>;\n    try {\n      const text = typeof data === \"string\" ? data : data.toString(\"utf-8\");\n      msg = JSON.parse(text) as Record<string, unknown>;\n    } catch {\n      send(ws, { type: \"error\", error: \"Invalid JSON\" });\n      return;\n    }\n\n    const type = msg.type as string;\n    if (!type) {\n      send(ws, { type: \"error\", error: \"Missing 'type' field\" });\n      return;\n    }\n\n    switch (type) {\n      case \"query\":\n        await handleQuery(session, msg, opts);\n        break;\n\n      case \"abort\":\n        if (session.abortController) {\n          session.abortController.abort();\n          // aborted message is sent by handleQuery's catch block\n        }\n        break;\n\n      case \"ping\":\n        send(ws, { type: \"pong\" });\n        break;\n\n      case \"get_tools\": {\n        const toolList = await getToolList();\n        send(ws, { type: \"tools\", tools: toolList });\n        break;\n      }\n\n      case \"new_conversation\":\n        session.conversationHistory = [];\n        session.conversationId = null;\n        session.totalInputTokens = 0;\n        session.totalOutputTokens = 0;\n        resetSessionState(); // Reset module-level token counters, caches\n        if (opts.verbose) {\n          console.log(\"[serve] New conversation started\");\n        }\n        break;\n\n      case \"get_conversations\": {\n        const storeId = msg.storeId as string;\n        const limit = (msg.limit as number) || 20;\n        if (!storeId) {\n          send(ws, { type: \"conversations\", conversations: [] });\n          break;\n        }\n        const convs = await listConversations(storeId, limit);\n        send(ws, { type: \"conversations\", conversations: convs });\n        break;\n      }\n\n      case \"load_conversation\": {\n        const convId = msg.conversationId as string;\n        if (!convId) {\n          send(ws, { type: \"error\", error: \"Missing conversationId\" });\n          break;\n        }\n        const conv = await loadConversation(convId);\n        if (conv) {\n          session.conversationId = conv.id;\n          send(ws, {\n            type: \"conversation_loaded\",\n            conversationId: conv.id,\n            title: conv.title,\n            messages: conv.messages,\n          });\n        } else {\n          send(ws, { type: \"error\", error: `Conversation not found: ${convId}` });\n        }\n        break;\n      }\n\n      default:\n        if (opts.verbose) {\n          console.log(\"[serve] Unknown message type:\", type);\n        }\n        break;\n    }\n  });\n\n  ws.on(\"close\", () => {\n    // Abort any running query when client disconnects\n    if (session.abortController) {\n      session.abortController.abort();\n    }\n    if (opts.verbose) {\n      console.log(\"[serve] Client disconnected\");\n    }\n  });\n\n  ws.on(\"error\", (err: Error) => {\n    console.error(\"[serve] WebSocket error:\", err.message);\n    if (session.abortController) {\n      session.abortController.abort();\n    }\n  });\n}\n\n// ============================================================================\n// SERVER STARTUP\n// ============================================================================\n\nexport async function runServeMode(opts: ServeModeOptions): Promise<void> {\n  // Apply global settings\n  if (opts.model) setModel(opts.model);\n  setPermissionMode((opts.permissionMode as \"default\" | \"plan\" | \"yolo\") || \"yolo\");\n\n  const port = opts.port;\n  const host = opts.host;\n\n  // HTTP server for health check + WebSocket upgrade\n  const server = createServer((req, res) => {\n    // Health check endpoint\n    if (req.method === \"GET\" && (req.url === \"/health\" || req.url === \"/\")) {\n      res.writeHead(200, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          status: \"ok\",\n          version: PKG_VERSION,\n          model: getModel(),\n          port,\n          uptime: Math.floor(process.uptime()),\n        }),\n      );\n      return;\n    }\n\n    // Everything else: 404\n    res.writeHead(404, { \"Content-Type\": \"application/json\" });\n    res.end(JSON.stringify({ error: \"Not found. Connect via WebSocket.\" }));\n  });\n\n  // WebSocket server\n  const wss = new WebSocketServer({ server });\n\n  wss.on(\"connection\", (ws: WebSocket) => {\n    handleConnection(ws, opts);\n  });\n\n  // Graceful shutdown\n  const shutdown = () => {\n    console.log(\"\\n[serve] Shutting down...\");\n    wss.clients.forEach((client) => {\n      if (client.readyState === WebSocket.OPEN) {\n        client.close(1001, \"Server shutting down\");\n      }\n    });\n    server.close(() => {\n      console.log(\"[serve] Server stopped.\");\n      process.exit(0);\n    });\n    // Force exit after 3s\n    setTimeout(() => process.exit(0), 3000);\n  };\n\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n\n  // Verify Supabase connectivity (non-blocking)\n  getSupabase().then((db) => {\n    if (db) {\n      console.log(\"[serve] Supabase connected — conversation persistence enabled\");\n    } else {\n      console.log(\"[serve] Supabase not configured — conversations are session-only\");\n    }\n  });\n\n  // Start listening\n  return new Promise<void>((resolve, reject) => {\n    server.on(\"error\", (err: NodeJS.ErrnoException) => {\n      if (err.code === \"EADDRINUSE\") {\n        console.error(`[serve] Port ${port} is already in use.`);\n        console.error(`[serve] Try: whale serve --port ${port + 1}`);\n        process.exit(1);\n      }\n      reject(err);\n    });\n\n    server.listen(port, host, () => {\n      const d = \"\\x1b[2m\";\n      const B = \"\\x1b[1m\";\n      const r = \"\\x1b[0m\";\n      const c = \"\\x1b[38;2;99;102;241m\";\n\n      console.log();\n      console.log(`  ${c}${B}◆ whale serve${r}  ${d}v${PKG_VERSION}${r}`);\n      console.log();\n      console.log(`  ${B}WebSocket${r}  ${d}ws://${host}:${port}${r}`);\n      console.log(`  ${B}Health${r}     ${d}http://${host}:${port}/health${r}`);\n      console.log(`  ${B}Model${r}      ${d}${getModel()}${r}`);\n      console.log(`  ${B}Mode${r}       ${d}yolo (local server trusts local client)${r}`);\n      console.log();\n      console.log(`  ${d}WhaleChat will auto-connect on port 3847${r}`);\n      console.log(`  ${d}Press Ctrl+C to stop${r}`);\n      console.log();\n\n      resolve();\n    });\n  });\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/cli/services/__tests__/agent-definitions.test.js

@@ -0,0 +1,153 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { vol } from "memfs";
+
+// ============================================================================
+// Mocks
+// ============================================================================
+
+vi.mock("fs", async () => {
+  const memfs = await import("memfs");
+  return {
+    ...memfs.fs,
+    default: memfs.fs
+  };
+});
+vi.mock("os", () => ({
+  homedir: () => "/home/testuser"
+}));
+import { loadAgentDefinitions, getAgentDefinition } from "../agent-definitions.js";
+
+// ============================================================================
+// Setup
+// ============================================================================
+
+const GLOBAL_DIR = "/home/testuser/.whale/agents";
+beforeEach(() => {
+  vol.reset();
+  // Default cwd
+  vi.spyOn(process, "cwd").mockReturnValue("/tmp/project");
+});
+
+// ============================================================================
+// loadAgentDefinitions
+// ============================================================================
+
+describe("loadAgentDefinitions", () => {
+  it("returns empty array when no agent dirs exist", () => {
+    expect(loadAgentDefinitions()).toEqual([]);
+  });
+  it("loads global agents from ~/.whale/agents/", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/reviewer.md`]: "You are a code reviewer."
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents.length).toBe(1);
+    expect(agents[0].name).toBe("reviewer");
+    expect(agents[0].prompt).toBe("You are a code reviewer.");
+    expect(agents[0].source).toBe("global");
+  });
+  it("loads local agents from .whale/agents/", () => {
+    vol.fromJSON({
+      "/tmp/project/.whale/agents/tester.md": "You are a test writer."
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents.length).toBe(1);
+    expect(agents[0].name).toBe("tester");
+    expect(agents[0].source).toBe("local");
+  });
+  it("parses frontmatter description and tools", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/security.md`]: `---
+description: Reviews code for security issues
+tools: read_file, glob, grep
+---
+You are a security agent.`
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents[0].description).toBe("Reviews code for security issues");
+    expect(agents[0].tools).toEqual(["read_file", "glob", "grep"]);
+    expect(agents[0].prompt).toBe("You are a security agent.");
+  });
+  it("handles frontmatter without description or tools", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/simple.md`]: `---
+description: Simple agent
+---
+Do things.`
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents[0].description).toBe("Simple agent");
+    expect(agents[0].tools).toBeUndefined();
+  });
+  it("handles files without frontmatter", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/bare.md`]: "Just plain content."
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents[0].prompt).toBe("Just plain content.");
+    expect(agents[0].description).toBeUndefined();
+  });
+  it("local agents override global agents with same name", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/reviewer.md`]: "Global reviewer",
+      "/tmp/project/.whale/agents/reviewer.md": "Local reviewer"
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents.length).toBe(1);
+    expect(agents[0].prompt).toBe("Local reviewer");
+    expect(agents[0].source).toBe("local");
+  });
+  it("merges global and local agents and sorts by name", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/zebra.md`]: "Z agent",
+      [`${GLOBAL_DIR}/alpha.md`]: "A agent",
+      "/tmp/project/.whale/agents/middle.md": "M agent"
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents.map(a => a.name)).toEqual(["alpha", "middle", "zebra"]);
+  });
+  it("only loads .md files", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/valid.md`]: "Agent",
+      [`${GLOBAL_DIR}/invalid.txt`]: "Not an agent",
+      [`${GLOBAL_DIR}/also-invalid.json`]: "{}"
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents.length).toBe(1);
+    expect(agents[0].name).toBe("valid");
+  });
+  it("handles broken frontmatter (no closing ---)", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/broken.md`]: "---\ndescription: Broken\nSome content"
+    });
+    const agents = loadAgentDefinitions();
+    expect(agents[0].prompt).toBe("---\ndescription: Broken\nSome content");
+  });
+});
+
+// ============================================================================
+// getAgentDefinition
+// ============================================================================
+
+describe("getAgentDefinition", () => {
+  it("returns agent by name", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/reviewer.md`]: "Review code"
+    });
+    const agent = getAgentDefinition("reviewer");
+    expect(agent).toBeDefined();
+    expect(agent.name).toBe("reviewer");
+  });
+  it("returns undefined for non-existent agent", () => {
+    expect(getAgentDefinition("nonexistent")).toBeUndefined();
+  });
+  it("prefers local over global when both exist", () => {
+    vol.fromJSON({
+      [`${GLOBAL_DIR}/reviewer.md`]: "Global",
+      "/tmp/project/.whale/agents/reviewer.md": "Local"
+    });
+    const agent = getAgentDefinition("reviewer");
+    expect(agent.prompt).toBe("Local");
+    expect(agent.source).toBe("local");
+  });
+});

package/dist/cli/services/__tests__/agent-events-global.test.js

@@ -0,0 +1,39 @@
+import { describe, it, expect, afterEach, vi } from "vitest";
+import { AgentEventEmitter, getGlobalEmitter, setGlobalEmitter, clearGlobalEmitter } from "../agent-events.js";
+
+// ============================================================================
+// Global Emitter Singleton (split from agent-events.test.ts)
+// ============================================================================
+
+describe("Global Emitter", () => {
+  afterEach(() => {
+    clearGlobalEmitter();
+  });
+  it("getGlobalEmitter lazily creates an emitter", () => {
+    const emitter = getGlobalEmitter();
+    expect(emitter).toBeInstanceOf(AgentEventEmitter);
+  });
+  it("getGlobalEmitter returns the same instance", () => {
+    const a = getGlobalEmitter();
+    const b = getGlobalEmitter();
+    expect(a).toBe(b);
+  });
+  it("setGlobalEmitter replaces the global emitter", () => {
+    const custom = new AgentEventEmitter();
+    setGlobalEmitter(custom);
+    expect(getGlobalEmitter()).toBe(custom);
+  });
+  it("clearGlobalEmitter destroys and nulls the emitter", () => {
+    const emitter = getGlobalEmitter();
+    const spy = vi.spyOn(emitter, "destroy");
+    clearGlobalEmitter();
+    expect(spy).toHaveBeenCalled();
+    // Next call creates a new one
+    const next = getGlobalEmitter();
+    expect(next).not.toBe(emitter);
+  });
+  it("clearGlobalEmitter is safe when no emitter exists", () => {
+    clearGlobalEmitter(); // nothing to destroy
+    clearGlobalEmitter(); // still safe
+  });
+});

package/dist/cli/services/__tests__/agent-events.part2.test.js

@@ -0,0 +1,113 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { AgentEventEmitter } from "../agent-events.js";
+
+// ============================================================================
+// AgentEventEmitter — subagent & team events
+// ============================================================================
+
+describe("AgentEventEmitter — subagent & team events", () => {
+  let emitter;
+  let events;
+  beforeEach(() => {
+    emitter = new AgentEventEmitter();
+    events = [];
+    emitter.onEvent(e => events.push(e));
+  });
+  afterEach(() => {
+    emitter.destroy();
+  });
+  it("emitSubagentStart emits subagent_start event", () => {
+    emitter.emitSubagentStart("sa-1", "code", "opus", "Fix a bug");
+    const e = events[0];
+    expect(e.type).toBe("subagent_start");
+    expect(e.id).toBe("sa-1");
+    expect(e.agentType).toBe("code");
+    expect(e.model).toBe("opus");
+    expect(e.description).toBe("Fix a bug");
+  });
+  it("emitSubagentProgress emits subagent_progress event", () => {
+    emitter.emitSubagentProgress("sa-1", "code", "reading file...", 2, "read_file");
+    const e = events[0];
+    expect(e.type).toBe("subagent_progress");
+    expect(e.id).toBe("sa-1");
+    expect(e.message).toBe("reading file...");
+    expect(e.turn).toBe(2);
+    expect(e.toolName).toBe("read_file");
+  });
+  it("emitSubagentDone emits subagent_done event", () => {
+    emitter.emitSubagentDone("sa-1", "code", true, "done", {
+      input: 100,
+      output: 50
+    }, ["read_file"], 5000);
+    const e = events[0];
+    expect(e.type).toBe("subagent_done");
+    expect(e.success).toBe(true);
+    expect(e.output).toBe("done");
+    expect(e.tokens).toEqual({
+      input: 100,
+      output: 50
+    });
+    expect(e.tools).toEqual(["read_file"]);
+    expect(e.durationMs).toBe(5000);
+  });
+  it("emitSubagentToolStart emits subagent_tool_start event", () => {
+    emitter.emitSubagentToolStart("sa-1", "bash", {
+      command: "ls"
+    });
+    const e = events[0];
+    expect(e.type).toBe("subagent_tool_start");
+    expect(e.agentId).toBe("sa-1");
+    expect(e.toolName).toBe("bash");
+    expect(e.toolInput).toEqual({
+      command: "ls"
+    });
+  });
+  it("emitSubagentToolEnd emits subagent_tool_end event", () => {
+    emitter.emitSubagentToolEnd("sa-1", "bash", true, 250);
+    const e = events[0];
+    expect(e.type).toBe("subagent_tool_end");
+    expect(e.agentId).toBe("sa-1");
+    expect(e.success).toBe(true);
+    expect(e.durationMs).toBe(250);
+  });
+  it("emitTeamStart emits team_start event", () => {
+    emitter.emitTeamStart("tm-1", "refactor", 3, 5);
+    const e = events[0];
+    expect(e.type).toBe("team_start");
+    expect(e.teamId).toBe("tm-1");
+    expect(e.name).toBe("refactor");
+    expect(e.teammateCount).toBe(3);
+    expect(e.taskCount).toBe(5);
+  });
+  it("emitTeamProgress emits team_progress event", () => {
+    emitter.emitTeamProgress("tm-1", "mate-1", "Alice", "working on task", "task-1");
+    const e = events[0];
+    expect(e.type).toBe("team_progress");
+    expect(e.teamId).toBe("tm-1");
+    expect(e.teammateId).toBe("mate-1");
+    expect(e.teammateName).toBe("Alice");
+    expect(e.message).toBe("working on task");
+    expect(e.taskId).toBe("task-1");
+  });
+  it("emitTeamTask emits team_task event", () => {
+    emitter.emitTeamTask("tm-1", "mate-1", "task-1", "Fix tests", "completed", "all green");
+    const e = events[0];
+    expect(e.type).toBe("team_task");
+    expect(e.status).toBe("completed");
+    expect(e.result).toBe("all green");
+  });
+  it("emitTeamDone emits team_done event", () => {
+    emitter.emitTeamDone("tm-1", true, "All done", 4, 5, {
+      input: 500,
+      output: 300
+    }, 60000);
+    const e = events[0];
+    expect(e.type).toBe("team_done");
+    expect(e.teamId).toBe("tm-1");
+    expect(e.success).toBe(true);
+    expect(e.summary).toBe("All done");
+    expect(e.tasksCompleted).toBe(4);
+    expect(e.tasksTotal).toBe(5);
+    expect(e.durationMs).toBe(60000);
+  });
+});

package/dist/cli/services/__tests__/agent-events.test.js

@@ -0,0 +1,157 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { AgentEventEmitter } from "../agent-events.js";
+
+// ============================================================================
+// AgentEventEmitter — core events
+// ============================================================================
+
+describe("AgentEventEmitter — core events", () => {
+  let emitter;
+  let events;
+  beforeEach(() => {
+    emitter = new AgentEventEmitter();
+    events = [];
+    emitter.onEvent(e => events.push(e));
+  });
+  afterEach(() => {
+    emitter.destroy();
+  });
+  it("emitText emits a text event", () => {
+    emitter.emitText("hello");
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("text");
+    expect(e.text).toBe("hello");
+    expect(e.accumulated).toBe("");
+  });
+  it("emitText emits multiple text events in sequence", () => {
+    emitter.emitText("a");
+    emitter.emitText("b");
+    emitter.emitText("c");
+    expect(events).toHaveLength(3);
+    expect(events[0].text).toBe("a");
+    expect(events[1].text).toBe("b");
+    expect(events[2].text).toBe("c");
+  });
+  it("emitText handles empty string", () => {
+    emitter.emitText("");
+    expect(events).toHaveLength(1);
+    expect(events[0].text).toBe("");
+  });
+  it("flushText is a no-op", () => {
+    emitter.flushText();
+    expect(events).toHaveLength(0);
+  });
+  it("emitToolStart emits a tool_start event", () => {
+    emitter.emitToolStart("tool-1", "read_file");
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("tool_start");
+    expect(e.id).toBe("tool-1");
+    expect(e.name).toBe("read_file");
+  });
+  it("emitToolEnd emits a tool_end event with all fields", () => {
+    emitter.emitToolEnd("tool-1", "read_file", true, "contents", {
+      path: "/a"
+    }, 120);
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("tool_end");
+    expect(e.id).toBe("tool-1");
+    expect(e.name).toBe("read_file");
+    expect(e.success).toBe(true);
+    expect(e.result).toBe("contents");
+    expect(e.input).toEqual({
+      path: "/a"
+    });
+    expect(e.durationMs).toBe(120);
+  });
+  it("emitToolEnd handles undefined result/input", () => {
+    emitter.emitToolEnd("t", "bash", false, undefined, undefined, 0);
+    const e = events[0];
+    expect(e.result).toBeUndefined();
+    expect(e.input).toBeUndefined();
+  });
+  it("emitUsage emits a usage event", () => {
+    emitter.emitUsage(100, 200, "claude-3", 0.05, 50, 10);
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("usage");
+    expect(e.inputTokens).toBe(100);
+    expect(e.outputTokens).toBe(200);
+    expect(e.model).toBe("claude-3");
+    expect(e.costUsd).toBe(0.05);
+    expect(e.cacheReadTokens).toBe(50);
+    expect(e.cacheCreationTokens).toBe(10);
+  });
+  it("emitUsage handles optional parameters", () => {
+    emitter.emitUsage(10, 20);
+    const e = events[0];
+    expect(e.model).toBeUndefined();
+    expect(e.costUsd).toBeUndefined();
+  });
+  it("emitDone emits a done event", () => {
+    const msgs = [{
+      role: "user",
+      content: "hi"
+    }];
+    emitter.emitDone("final text", msgs);
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("done");
+    expect(e.text).toBe("final text");
+    expect(e.messages).toEqual(msgs);
+  });
+  it("emitError emits an error event", () => {
+    emitter.emitError("something broke");
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("error");
+    expect(e.error).toBe("something broke");
+  });
+  it("emitCompact emits a compact event", () => {
+    emitter.emitCompact(10000, 5000, 5000);
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("compact");
+    expect(e.before).toBe(10000);
+    expect(e.after).toBe(5000);
+    expect(e.tokensSaved).toBe(5000);
+  });
+  it("emitToolOutput emits a tool_output event", () => {
+    emitter.emitToolOutput("bash", "line of output");
+    expect(events).toHaveLength(1);
+    const e = events[0];
+    expect(e.type).toBe("tool_output");
+    expect(e.toolName).toBe("bash");
+    expect(e.line).toBe("line of output");
+  });
+  it("onEvent returns unsubscribe function", () => {
+    const localEvents = [];
+    const unsub = emitter.onEvent(e => localEvents.push(e));
+    emitter.emitText("first");
+    expect(localEvents).toHaveLength(1);
+    unsub();
+    emitter.emitText("second");
+    expect(localEvents).toHaveLength(1);
+  });
+  it("supports multiple concurrent subscribers", () => {
+    const sub1 = [];
+    const sub2 = [];
+    emitter.onEvent(e => sub1.push(e));
+    emitter.onEvent(e => sub2.push(e));
+    emitter.emitText("test");
+    expect(sub1).toHaveLength(1);
+    expect(sub2).toHaveLength(1);
+  });
+  it("destroy removes all listeners", () => {
+    emitter.destroy();
+    emitter.emitText("after destroy");
+    expect(events).toHaveLength(0);
+  });
+  it("destroy is idempotent", () => {
+    emitter.destroy();
+    emitter.destroy();
+    expect(emitter.listenerCount("event")).toBe(0);
+  });
+});