whale-code 6.5.5 → 6.5.7

package/dist/server/session-manager.js

@@ -0,0 +1,502 @@
+/**
+ * Session Manager — unified orchestration layer for all agent execution paths.
+ *
+ * Wraps runServerAgentLoop() with session lifecycle management:
+ * - Session creation/resume (DB-backed via ai_conversations)
+ * - Identity resolution (customer matching, sender context)
+ * - Memory recall + extraction
+ * - Tool loading + filtering
+ * - System prompt construction
+ * - Turn persistence + telemetry
+ * - Cost budget tracking
+ *
+ * All surfaces (CLI, WhaleChat, channels, workflows, API) delegate to this class
+ * so behavior is consistent and never duplicated.
+ */
+
+import { randomUUID } from "node:crypto";
+import { createLogger } from "./lib/logger.js";
+import { resolveAgentLoopConfig } from "../shared/agent-core.js";
+import { MODELS } from "../shared/constants.js";
+import { runServerAgentLoop } from "./lib/server-agent-loop.js";
+import { loadTools, loadUserTools, getToolsForAgent, executeTool, loadAgentConfig, setExtendedToolsCache, getExtendedToolsIndex } from "./tool-router.js";
+import { getAnthropicClient, compactHistory } from "./server-helpers.js";
+import { buildAgentSystemPrompt } from "./server-agent.js";
+import { persistAgentTurn } from "./server-persist.js";
+import { resolveConversation } from "./handlers/nodes-utils.js";
+const log = createLogger("session-manager");
+
+// ============================================================================
+// SESSION MANAGER
+// ============================================================================
+
+export class SessionManager {
+  constructor(supabase) {
+    this.supabase = supabase;
+  }
+
+  /**
+   * Create a new session or resume an existing one.
+   * Consolidates the conversation creation logic from server-chat.ts and server-executors.ts.
+   */
+  async createSession(opts) {
+    const {
+      storeId,
+      agentId,
+      surface,
+      userId,
+      userEmail,
+      senderContext,
+      message
+    } = opts;
+
+    // Load agent config (validates agent exists)
+    const agent = await loadAgentConfig(this.supabase, agentId, storeId);
+    if (!agent) throw new Error(`Agent ${agentId} not found`);
+
+    // Resolve or create conversation
+    let conversationId;
+    let customerId;
+    let customerName;
+    let isNew = true;
+    if (opts.conversationId) {
+      // Resume existing conversation
+      conversationId = opts.conversationId;
+      isNew = false;
+
+      // Backfill agent_id if missing (channel conversations start without one)
+      if (surface === "channel") {
+        Promise.resolve(this.supabase.from("ai_conversations").update({
+          agent_id: agentId
+        }).eq("id", conversationId).is("agent_id", null)).catch(() => {});
+      }
+    } else if (senderContext?.channelId && senderContext?.senderId) {
+      // Channel conversation — use resolveConversation for customer matching + session reuse
+      const resolved = await resolveConversation(this.supabase, senderContext.channelId, senderContext.senderId, storeId, senderContext.channelType, senderContext.senderName);
+      conversationId = resolved.conversationId;
+      customerId = resolved.customerId || undefined;
+      customerName = resolved.customerName || undefined;
+      isNew = resolved.isNewSession;
+    } else {
+      // New conversation (WhaleChat, CLI, workflow, API)
+      const title = message ? message.substring(0, 100) : "New session";
+      let conv = await this.supabase.from("ai_conversations").insert({
+        store_id: storeId || null,
+        user_id: userId || null,
+        agent_id: agentId,
+        title,
+        metadata: {
+          agentName: agent.name,
+          source: surface
+        }
+      }).select("id").single();
+      if (conv.error) {
+        log.error({
+          err: conv.error.message,
+          storeId,
+          userId,
+          agentId
+        }, "conversation create failed");
+        // Retry without user_id (RLS may block)
+        conv = await this.supabase.from("ai_conversations").insert({
+          store_id: storeId || null,
+          agent_id: agentId,
+          title,
+          metadata: {
+            agentName: agent.name,
+            source: surface,
+            userId,
+            userEmail
+          }
+        }).select("id").single();
+        if (conv.error) log.error({
+          err: conv.error.message
+        }, "conversation retry create failed");
+      }
+      conversationId = conv.data?.id || randomUUID();
+      log.info({
+        conversationId,
+        fromDb: !!conv.data?.id
+      }, "session created");
+    }
+
+    // Propagate sender context customer info
+    if (senderContext) {
+      customerId = customerId || senderContext.customerId || undefined;
+      customerName = customerName || senderContext.customerName || undefined;
+    }
+    const now = new Date().toISOString();
+    return {
+      id: conversationId,
+      store_id: storeId,
+      agent_id: agentId,
+      conversation_id: conversationId,
+      surface,
+      runner: "server",
+      status: "active",
+      user_id: userId,
+      customer_id: customerId,
+      sender_context: senderContext,
+      turn_count: 0,
+      cost_usd: 0,
+      cost_budget_usd: 25,
+      created_at: now,
+      updated_at: now,
+      metadata: {
+        agentName: agent.name,
+        isNew
+      }
+    };
+  }
+
+  /**
+   * Resume an existing session from the database.
+   */
+  async resumeSession(sessionId, surface) {
+    const {
+      data: conv,
+      error
+    } = await this.supabase.from("ai_conversations").select("id, store_id, agent_id, user_id, customer_id, metadata, created_at, updated_at").eq("id", sessionId).single();
+    if (error || !conv) throw new Error(`Session ${sessionId} not found`);
+    const meta = conv.metadata || {};
+    return {
+      id: conv.id,
+      store_id: conv.store_id,
+      agent_id: conv.agent_id,
+      conversation_id: conv.id,
+      surface,
+      runner: "server",
+      status: "active",
+      user_id: conv.user_id || undefined,
+      customer_id: conv.customer_id || undefined,
+      turn_count: 0,
+      cost_usd: meta.session_cost_usd || 0,
+      cost_budget_usd: 25,
+      created_at: conv.created_at,
+      updated_at: conv.updated_at,
+      metadata: meta
+    };
+  }
+
+  /**
+   * Execute a single turn within a session.
+   * This is the core method — consolidates the duplicated agent invocation patterns
+   * from server-chat.ts (lines 82-211) and server-executors.ts (lines 121-211).
+   */
+  async executeTurn(session, opts) {
+    const {
+      message,
+      attachments,
+      conversationHistory,
+      context,
+      streaming,
+      onText,
+      onToolStart,
+      onToolResult,
+      onToolProgress,
+      onSubagentProgress,
+      clientDisconnected
+    } = opts;
+    const {
+      store_id: storeId,
+      agent_id: agentId,
+      conversation_id: conversationId
+    } = session;
+    const userId = session.user_id || "";
+    const userEmail = session.metadata?.userEmail || null;
+    const source = opts.source || session.surface;
+
+    // 1. Load agent config
+    const agent = await loadAgentConfig(this.supabase, agentId, storeId);
+    if (!agent) throw new Error(`Agent ${agentId} not found`);
+
+    // 2. Load tools
+    const {
+      core: coreTools,
+      extended: extendedTools
+    } = await loadTools(this.supabase);
+    setExtendedToolsCache(extendedTools);
+    const {
+      rows: userToolRows,
+      defs: userToolDefs
+    } = storeId ? await loadUserTools(this.supabase, storeId) : {
+      rows: [],
+      defs: []
+    };
+    const tools = getToolsForAgent(agent, coreTools, userToolDefs);
+
+    // 3. Resolve agent loop config
+    const callPath = session.surface === "channel" ? "channel" : session.surface === "workflow" ? "workflow" : "sse";
+    const resolved = resolveAgentLoopConfig(agent, callPath);
+    if (resolved.defaultsUsed.length > 0) {
+      log.info({
+        agentId,
+        callPath,
+        defaults: resolved.defaultsUsed
+      }, "agent config defaults applied");
+    }
+
+    // 4. Build system prompt with memory recall + customer identity
+    const {
+      systemPrompt,
+      dynamicContext
+    } = await buildAgentSystemPrompt(this.supabase, agent, storeId, message, tools, {
+      senderContext: session.sender_context,
+      clientContext: context,
+      userId: userId || undefined,
+      userEmail,
+      extendedTools: getExtendedToolsIndex()
+    });
+
+    // 5. Build message history
+    let messages;
+    if (conversationHistory?.length) {
+      // Client-provided history (WhaleChat, CLI)
+      messages = [...compactHistory(conversationHistory, resolved.maxHistoryChars)];
+    } else if (conversationId && session.surface === "channel") {
+      // Load history from DB (channel agents)
+      let loadedHistory = [];
+      try {
+        const {
+          data: history
+        } = await this.supabase.from("ai_messages").select("role, content").eq("conversation_id", conversationId).order("created_at", {
+          ascending: true
+        }).limit(50);
+        if (history?.length) {
+          const raw = [];
+          for (const m of history) {
+            if (m.role === "user" || m.role === "assistant") {
+              raw.push({
+                role: m.role,
+                content: m.content
+              });
+            }
+          }
+          loadedHistory = compactHistory(raw, resolved.maxHistoryChars);
+        }
+      } catch {/* history not critical */}
+      messages = [...loadedHistory];
+    } else {
+      messages = [];
+    }
+
+    // 6. Build user content — multi-modal if image attachments present
+    let userContent;
+    if (attachments?.length) {
+      const contentBlocks = [];
+      for (const att of attachments) {
+        if (att.type === "image" && att.media_type && att.data) {
+          contentBlocks.push({
+            type: "image",
+            source: {
+              type: "base64",
+              media_type: att.media_type,
+              data: att.data
+            }
+          });
+        }
+      }
+      contentBlocks.push({
+        type: "text",
+        text: message
+      });
+      userContent = contentBlocks;
+    } else {
+      userContent = message;
+    }
+    const contextPrefix = dynamicContext ? `[Context]\n${dynamicContext}\n\n[User Message]\n` : "";
+    const finalUserContent = typeof userContent === "string" ? contextPrefix + userContent : [...(contextPrefix ? [{
+      type: "text",
+      text: contextPrefix
+    }] : []), ...userContent];
+    messages.push({
+      role: "user",
+      content: finalUserContent
+    });
+
+    // 7. Run the agent loop
+    const traceId = randomUUID();
+    const agentModel = agent.model || MODELS.SONNET;
+    const startedAt = Date.now();
+    const result = await runServerAgentLoop({
+      anthropic: getAnthropicClient(agent),
+      supabase: this.supabase,
+      model: agentModel,
+      systemPrompt,
+      messages,
+      tools,
+      extendedTools,
+      maxTurns: opts.maxTurns || resolved.maxTurns,
+      temperature: resolved.temperature,
+      maxTokens: resolved.maxTokens,
+      maxConcurrentTools: resolved.maxConcurrentTools,
+      enableDelegation: resolved.enableDelegation,
+      enableModelRouting: resolved.enableModelRouting,
+      contextOverrides: resolved.contextOverrides,
+      subagentMaxTokens: resolved.subagentMaxTokens,
+      subagentMaxTurns: resolved.subagentMaxTurns,
+      subagentTemperature: resolved.subagentTemperature,
+      loopDetectorConfig: {
+        identicalCallLimit: resolved.loopIdenticalCallLimit,
+        consecutiveErrorLimit: resolved.loopConsecutiveErrorLimit,
+        turnErrorLimit: resolved.loopTurnErrorLimit,
+        window: resolved.loopWindow,
+        sessionToolErrorLimit: resolved.loopSessionToolErrorLimit,
+        consecutiveFailedTurnLimit: resolved.loopConsecutiveFailedTurnLimit,
+        fileReadLimit: resolved.loopFileReadLimit
+      },
+      batchErrorLimit: resolved.loopBatchErrorLimit,
+      storeId,
+      traceId,
+      userId: userId || undefined,
+      userEmail,
+      source,
+      conversationId,
+      agentId,
+      executeTool: async (toolName, args, sourceOverride, onToolProgressCb) => {
+        const toolArgs = {
+          ...args
+        };
+        if (!toolArgs.store_id && storeId) toolArgs.store_id = storeId;
+        const senderUserId = session.sender_context?.customerId || null;
+        const senderUserLabel = session.sender_context?.customerName || session.sender_context?.senderName || (session.sender_context?.senderId ? `${session.sender_context.channelType}:${session.sender_context.senderId}` : null);
+        return executeTool(this.supabase, toolName, toolArgs, storeId, traceId, senderUserId || userId || null, senderUserLabel || userEmail || null, sourceOverride || source, conversationId, userToolRows, agentId, onToolProgressCb, true);
+      },
+      enableStreaming: streaming,
+      onText,
+      onToolStart,
+      onToolResult,
+      onToolProgress,
+      onSubagentProgress: onSubagentProgress,
+      clientDisconnected,
+      startedAt,
+      maxDurationMs: opts.maxDurationMs || resolved.maxDurationMs
+    });
+
+    // 8. Persist turn — messages, audit, memory, cost (fire-and-forget errors)
+    const chatEndTime = Date.now();
+    try {
+      await persistAgentTurn(this.supabase, agent, {
+        conversationId,
+        storeId,
+        agentId,
+        agentModel,
+        traceId,
+        message,
+        result,
+        source,
+        chatStartTime: startedAt,
+        chatEndTime,
+        userId: userId || undefined,
+        userEmail,
+        senderContext: session.sender_context
+      });
+    } catch (err) {
+      log.error({
+        err: err.message,
+        conversationId
+      }, "persist turn failed");
+    }
+
+    // 9. Return unified turn result
+    return {
+      finalText: result.finalText,
+      tokens: {
+        input: result.tokens.input,
+        output: result.tokens.output,
+        cacheRead: result.tokens.cacheRead,
+        cacheCreation: result.tokens.cacheCreation
+      },
+      costUsd: result.costUsd,
+      turnCount: result.turnCount,
+      toolsUsed: result.toolsUsed,
+      toolCallCount: result.toolCallCount,
+      stopReason: result.stopReason,
+      loopDetectorStats: result.loopDetectorStats,
+      turns: result.turns
+    };
+  }
+
+  /**
+   * Get a session by ID from the database.
+   */
+  async getSession(sessionId) {
+    const {
+      data: conv
+    } = await this.supabase.from("ai_conversations").select("id, store_id, agent_id, user_id, customer_id, metadata, created_at, updated_at").eq("id", sessionId).single();
+    if (!conv) return null;
+    const meta = conv.metadata || {};
+    return {
+      id: conv.id,
+      store_id: conv.store_id,
+      agent_id: conv.agent_id,
+      conversation_id: conv.id,
+      surface: meta.source || "whale_chat",
+      runner: "server",
+      status: "active",
+      user_id: conv.user_id || undefined,
+      customer_id: conv.customer_id || undefined,
+      turn_count: 0,
+      cost_usd: meta.session_cost_usd || 0,
+      cost_budget_usd: 25,
+      created_at: conv.created_at,
+      updated_at: conv.updated_at,
+      metadata: meta
+    };
+  }
+
+  /**
+   * List sessions for a store, optionally filtered by status and surface.
+   */
+  async listSessions(storeId, filters) {
+    let query = this.supabase.from("ai_conversations").select("id, store_id, agent_id, user_id, customer_id, metadata, created_at, updated_at").eq("store_id", storeId).order("updated_at", {
+      ascending: false
+    }).limit(filters?.limit || 50);
+    if (filters?.surface) {
+      query = query.contains("metadata", {
+        source: filters.surface
+      });
+    }
+    const {
+      data: convs
+    } = await query;
+    if (!convs?.length) return [];
+    return convs.map(conv => {
+      const meta = conv.metadata || {};
+      return {
+        id: conv.id,
+        store_id: conv.store_id,
+        agent_id: conv.agent_id,
+        conversation_id: conv.id,
+        surface: meta.source || "whale_chat",
+        runner: "server",
+        status: "active",
+        user_id: conv.user_id || undefined,
+        customer_id: conv.customer_id || undefined,
+        turn_count: 0,
+        cost_usd: meta.session_cost_usd || 0,
+        cost_budget_usd: 25,
+        created_at: conv.created_at,
+        updated_at: conv.updated_at,
+        metadata: meta
+      };
+    });
+  }
+
+  /**
+   * Cancel a running session (merges into existing metadata instead of overwriting).
+   */
+  async cancelSession(sessionId) {
+    const {
+      data: conv
+    } = await this.supabase.from("ai_conversations").select("metadata").eq("id", sessionId).single();
+    await this.supabase.from("ai_conversations").update({
+      metadata: {
+        ...(conv?.metadata || {}),
+        status: "cancelled",
+        cancelled_at: new Date().toISOString()
+      }
+    }).eq("id", sessionId);
+  }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/server/session-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.js","names":["randomUUID","createLogger","resolveAgentLoopConfig","MODELS","runServerAgentLoop","loadTools","loadUserTools","getToolsForAgent","executeTool","loadAgentConfig","setExtendedToolsCache","getExtendedToolsIndex","getAnthropicClient","compactHistory","buildAgentSystemPrompt","persistAgentTurn","resolveConversation","log","SessionManager","constructor","supabase","createSession","opts","storeId","agentId","surface","userId","userEmail","senderContext","message","agent","Error","conversationId","customerId","customerName","isNew","Promise","resolve","from","update","agent_id","eq","is","catch","channelId","senderId","resolved","channelType","senderName","undefined","isNewSession","title","substring","conv","insert","store_id","user_id","metadata","agentName","name","source","select","single","error","err","data","id","info","fromDb","now","Date","toISOString","conversation_id","runner","status","customer_id","sender_context","turn_count","cost_usd","cost_budget_usd","created_at","updated_at","resumeSession","sessionId","meta","session_cost_usd","executeTurn","session","attachments","conversationHistory","context","streaming","onText","onToolStart","onToolResult","onToolProgress","onSubagentProgress","clientDisconnected","core","coreTools","extended","extendedTools","rows","userToolRows","defs","userToolDefs","tools","callPath","defaultsUsed","length","defaults","systemPrompt","dynamicContext","clientContext","messages","maxHistoryChars","loadedHistory","history","order","ascending","limit","raw","m","role","push","content","userContent","contentBlocks","att","type","media_type","text","contextPrefix","finalUserContent","traceId","agentModel","model","SONNET","startedAt","result","anthropic","maxTurns","temperature","maxTokens","maxConcurrentTools","enableDelegation","enableModelRouting","contextOverrides","subagentMaxTokens","subagentMaxTurns","subagentTemperature","loopDetectorConfig","identicalCallLimit","loopIdenticalCallLimit","consecutiveErrorLimit","loopConsecutiveErrorLimit","turnErrorLimit","loopTurnErrorLimit","window","loopWindow","sessionToolErrorLimit","loopSessionToolErrorLimit","consecutiveFailedTurnLimit","loopConsecutiveFailedTurnLimit","fileReadLimit","loopFileReadLimit","batchErrorLimit","loopBatchErrorLimit","toolName","args","sourceOverride","onToolProgressCb","toolArgs","senderUserId","senderUserLabel","enableStreaming","maxDurationMs","chatEndTime","chatStartTime","finalText","tokens","input","output","cacheRead","cacheCreation","costUsd","turnCount","toolsUsed","toolCallCount","stopReason","loopDetectorStats","turns","getSession","listSessions","filters","query","contains","convs","map","cancelSession","cancelled_at"],"sources":["../../src/server/session-manager.ts"],"sourcesContent":["/**\n * Session Manager — unified orchestration layer for all agent execution paths.\n *\n * Wraps runServerAgentLoop() with session lifecycle management:\n * - Session creation/resume (DB-backed via ai_conversations)\n * - Identity resolution (customer matching, sender context)\n * - Memory recall + extraction\n * - Tool loading + filtering\n * - System prompt construction\n * - Turn persistence + telemetry\n * - Cost budget tracking\n *\n * All surfaces (CLI, WhaleChat, channels, workflows, API) delegate to this class\n * so behavior is consistent and never duplicated.\n */\n\nimport { randomUUID } from \"node:crypto\";\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\nimport type Anthropic from \"@anthropic-ai/sdk\";\nimport { createLogger } from \"./lib/logger.js\";\nimport { resolveAgentLoopConfig, sanitizeError } from \"../shared/agent-core.js\";\nimport { MODELS } from \"../shared/constants.js\";\nimport { runServerAgentLoop } from \"./lib/server-agent-loop.js\";\nimport type { ServerAgentLoopResult } from \"./lib/server-agent-loop.js\";\nimport {\n  loadTools, loadUserTools, getToolsForAgent, executeTool,\n  loadAgentConfig, setExtendedToolsCache, getExtendedToolsIndex,\n  type ToolDef, type UserToolRow, type AgentConfig,\n} from \"./tool-router.js\";\nimport { getAnthropicClient, compactHistory, sendSSE } from \"./server-helpers.js\";\nimport { buildAgentSystemPrompt } from \"./server-agent.js\";\nimport { persistAgentTurn } from \"./server-persist.js\";\nimport { resolveConversation } from \"./handlers/nodes-utils.js\";\nimport type { SenderContext } from \"./handlers/nodes-utils.js\";\nimport type {\n  Session, SessionSurface, SessionStatus,\n  CreateSessionOpts, ExecuteTurnOpts, TurnResult,\n} from \"./lib/session-types.js\";\n\nconst log = createLogger(\"session-manager\");\n\n// ============================================================================\n// SESSION MANAGER\n// ============================================================================\n\nexport class SessionManager {\n  constructor(private supabase: SupabaseClient) {}\n\n  /**\n   * Create a new session or resume an existing one.\n   * Consolidates the conversation creation logic from server-chat.ts and server-executors.ts.\n   */\n  async createSession(opts: CreateSessionOpts): Promise<Session> {\n    const { storeId, agentId, surface, userId, userEmail, senderContext, message } = opts;\n\n    // Load agent config (validates agent exists)\n    const agent = await loadAgentConfig(this.supabase, agentId, storeId);\n    if (!agent) throw new Error(`Agent ${agentId} not found`);\n\n    // Resolve or create conversation\n    let conversationId: string;\n    let customerId: string | undefined;\n    let customerName: string | undefined;\n    let isNew = true;\n\n    if (opts.conversationId) {\n      // Resume existing conversation\n      conversationId = opts.conversationId;\n      isNew = false;\n\n      // Backfill agent_id if missing (channel conversations start without one)\n      if (surface === \"channel\") {\n        Promise.resolve(\n          this.supabase.from(\"ai_conversations\")\n            .update({ agent_id: agentId })\n            .eq(\"id\", conversationId)\n            .is(\"agent_id\", null)\n        ).catch(() => {});\n      }\n    } else if (senderContext?.channelId && senderContext?.senderId) {\n      // Channel conversation — use resolveConversation for customer matching + session reuse\n      const resolved = await resolveConversation(\n        this.supabase,\n        senderContext.channelId,\n        senderContext.senderId,\n        storeId,\n        senderContext.channelType,\n        senderContext.senderName,\n      );\n      conversationId = resolved.conversationId;\n      customerId = resolved.customerId || undefined;\n      customerName = resolved.customerName || undefined;\n      isNew = resolved.isNewSession;\n    } else {\n      // New conversation (WhaleChat, CLI, workflow, API)\n      const title = message ? message.substring(0, 100) : \"New session\";\n      let conv = await this.supabase.from(\"ai_conversations\").insert({\n        store_id: storeId || null,\n        user_id: userId || null,\n        agent_id: agentId,\n        title,\n        metadata: { agentName: agent.name, source: surface },\n      }).select(\"id\").single();\n\n      if (conv.error) {\n        log.error({ err: conv.error.message, storeId, userId, agentId }, \"conversation create failed\");\n        // Retry without user_id (RLS may block)\n        conv = await this.supabase.from(\"ai_conversations\").insert({\n          store_id: storeId || null,\n          agent_id: agentId,\n          title,\n          metadata: { agentName: agent.name, source: surface, userId, userEmail },\n        }).select(\"id\").single();\n        if (conv.error) log.error({ err: conv.error.message }, \"conversation retry create failed\");\n      }\n      conversationId = conv.data?.id || randomUUID();\n      log.info({ conversationId, fromDb: !!conv.data?.id }, \"session created\");\n    }\n\n    // Propagate sender context customer info\n    if (senderContext) {\n      customerId = customerId || senderContext.customerId || undefined;\n      customerName = customerName || senderContext.customerName || undefined;\n    }\n\n    const now = new Date().toISOString();\n    return {\n      id: conversationId,\n      store_id: storeId,\n      agent_id: agentId,\n      conversation_id: conversationId,\n      surface,\n      runner: \"server\",\n      status: \"active\" as SessionStatus,\n      user_id: userId,\n      customer_id: customerId,\n      sender_context: senderContext,\n      turn_count: 0,\n      cost_usd: 0,\n      cost_budget_usd: 25,\n      created_at: now,\n      updated_at: now,\n      metadata: { agentName: agent.name, isNew },\n    };\n  }\n\n  /**\n   * Resume an existing session from the database.\n   */\n  async resumeSession(sessionId: string, surface: SessionSurface): Promise<Session> {\n    const { data: conv, error } = await this.supabase\n      .from(\"ai_conversations\")\n      .select(\"id, store_id, agent_id, user_id, customer_id, metadata, created_at, updated_at\")\n      .eq(\"id\", sessionId)\n      .single();\n\n    if (error || !conv) throw new Error(`Session ${sessionId} not found`);\n\n    const meta = (conv.metadata || {}) as Record<string, unknown>;\n\n    return {\n      id: conv.id,\n      store_id: conv.store_id,\n      agent_id: conv.agent_id,\n      conversation_id: conv.id,\n      surface,\n      runner: \"server\",\n      status: \"active\",\n      user_id: conv.user_id || undefined,\n      customer_id: conv.customer_id || undefined,\n      turn_count: 0,\n      cost_usd: (meta.session_cost_usd as number) || 0,\n      cost_budget_usd: 25,\n      created_at: conv.created_at,\n      updated_at: conv.updated_at,\n      metadata: meta,\n    };\n  }\n\n  /**\n   * Execute a single turn within a session.\n   * This is the core method — consolidates the duplicated agent invocation patterns\n   * from server-chat.ts (lines 82-211) and server-executors.ts (lines 121-211).\n   */\n  async executeTurn(session: Session, opts: ExecuteTurnOpts): Promise<TurnResult> {\n    const {\n      message, attachments, conversationHistory, context,\n      streaming, onText, onToolStart, onToolResult, onToolProgress,\n      onSubagentProgress, clientDisconnected,\n    } = opts;\n\n    const { store_id: storeId, agent_id: agentId, conversation_id: conversationId } = session;\n    const userId = session.user_id || \"\";\n    const userEmail = (session.metadata?.userEmail as string) || null;\n    const source = opts.source || session.surface;\n\n    // 1. Load agent config\n    const agent = await loadAgentConfig(this.supabase, agentId, storeId);\n    if (!agent) throw new Error(`Agent ${agentId} not found`);\n\n    // 2. Load tools\n    const { core: coreTools, extended: extendedTools } = await loadTools(this.supabase);\n    setExtendedToolsCache(extendedTools);\n    const { rows: userToolRows, defs: userToolDefs } = storeId\n      ? await loadUserTools(this.supabase, storeId)\n      : { rows: [] as UserToolRow[], defs: [] as ToolDef[] };\n    const tools = getToolsForAgent(agent, coreTools, userToolDefs);\n\n    // 3. Resolve agent loop config\n    const callPath = session.surface === \"channel\" ? \"channel\"\n      : session.surface === \"workflow\" ? \"workflow\"\n      : \"sse\";\n    const resolved = resolveAgentLoopConfig(agent, callPath);\n    if (resolved.defaultsUsed.length > 0) {\n      log.info({ agentId, callPath, defaults: resolved.defaultsUsed }, \"agent config defaults applied\");\n    }\n\n    // 4. Build system prompt with memory recall + customer identity\n    const { systemPrompt, dynamicContext } = await buildAgentSystemPrompt(\n      this.supabase, agent, storeId, message, tools, {\n        senderContext: session.sender_context,\n        clientContext: context,\n        userId: userId || undefined,\n        userEmail,\n        extendedTools: getExtendedToolsIndex(),\n      },\n    );\n\n    // 5. Build message history\n    let messages: Anthropic.MessageParam[];\n\n    if (conversationHistory?.length) {\n      // Client-provided history (WhaleChat, CLI)\n      messages = [...compactHistory(conversationHistory, resolved.maxHistoryChars)];\n    } else if (conversationId && session.surface === \"channel\") {\n      // Load history from DB (channel agents)\n      let loadedHistory: Anthropic.MessageParam[] = [];\n      try {\n        const { data: history } = await this.supabase.from(\"ai_messages\")\n          .select(\"role, content\").eq(\"conversation_id\", conversationId)\n          .order(\"created_at\", { ascending: true }).limit(50);\n        if (history?.length) {\n          const raw: Anthropic.MessageParam[] = [];\n          for (const m of history) {\n            if (m.role === \"user\" || m.role === \"assistant\") {\n              raw.push({ role: m.role, content: m.content });\n            }\n          }\n          loadedHistory = compactHistory(raw, resolved.maxHistoryChars);\n        }\n      } catch { /* history not critical */ }\n      messages = [...loadedHistory];\n    } else {\n      messages = [];\n    }\n\n    // 6. Build user content — multi-modal if image attachments present\n    let userContent: Anthropic.MessageParam[\"content\"];\n    if (attachments?.length) {\n      const contentBlocks: any[] = [];\n      for (const att of attachments) {\n        if (att.type === \"image\" && att.media_type && att.data) {\n          contentBlocks.push({\n            type: \"image\",\n            source: { type: \"base64\", media_type: att.media_type, data: att.data },\n          });\n        }\n      }\n      contentBlocks.push({ type: \"text\", text: message });\n      userContent = contentBlocks;\n    } else {\n      userContent = message;\n    }\n\n    const contextPrefix = dynamicContext ? `[Context]\\n${dynamicContext}\\n\\n[User Message]\\n` : \"\";\n    const finalUserContent = typeof userContent === \"string\"\n      ? contextPrefix + userContent\n      : [...(contextPrefix ? [{ type: \"text\" as const, text: contextPrefix }] : []), ...userContent];\n    messages.push({ role: \"user\", content: finalUserContent });\n\n    // 7. Run the agent loop\n    const traceId = randomUUID();\n    const agentModel = agent.model || MODELS.SONNET;\n    const startedAt = Date.now();\n\n    const result = await runServerAgentLoop({\n      anthropic: getAnthropicClient(agent),\n      supabase: this.supabase,\n      model: agentModel,\n      systemPrompt,\n      messages,\n      tools,\n      extendedTools,\n      maxTurns: opts.maxTurns || resolved.maxTurns,\n      temperature: resolved.temperature,\n      maxTokens: resolved.maxTokens,\n      maxConcurrentTools: resolved.maxConcurrentTools,\n      enableDelegation: resolved.enableDelegation,\n      enableModelRouting: resolved.enableModelRouting,\n      contextOverrides: resolved.contextOverrides,\n      subagentMaxTokens: resolved.subagentMaxTokens,\n      subagentMaxTurns: resolved.subagentMaxTurns,\n      subagentTemperature: resolved.subagentTemperature,\n      loopDetectorConfig: {\n        identicalCallLimit: resolved.loopIdenticalCallLimit,\n        consecutiveErrorLimit: resolved.loopConsecutiveErrorLimit,\n        turnErrorLimit: resolved.loopTurnErrorLimit,\n        window: resolved.loopWindow,\n        sessionToolErrorLimit: resolved.loopSessionToolErrorLimit,\n        consecutiveFailedTurnLimit: resolved.loopConsecutiveFailedTurnLimit,\n        fileReadLimit: resolved.loopFileReadLimit,\n      },\n      batchErrorLimit: resolved.loopBatchErrorLimit,\n      storeId,\n      traceId,\n      userId: userId || undefined,\n      userEmail,\n      source,\n      conversationId,\n      agentId,\n      executeTool: async (toolName, args, sourceOverride, onToolProgressCb) => {\n        const toolArgs = { ...args };\n        if (!toolArgs.store_id && storeId) toolArgs.store_id = storeId;\n        const senderUserId = session.sender_context?.customerId || null;\n        const senderUserLabel = session.sender_context?.customerName\n          || session.sender_context?.senderName\n          || (session.sender_context?.senderId\n            ? `${session.sender_context.channelType}:${session.sender_context.senderId}`\n            : null);\n        return executeTool(\n          this.supabase, toolName, toolArgs, storeId, traceId,\n          senderUserId || userId || null, senderUserLabel || userEmail || null,\n          sourceOverride || source, conversationId,\n          userToolRows, agentId, onToolProgressCb, true,\n        );\n      },\n      enableStreaming: streaming,\n      onText,\n      onToolStart,\n      onToolResult,\n      onToolProgress,\n      onSubagentProgress: onSubagentProgress as any,\n      clientDisconnected,\n      startedAt,\n      maxDurationMs: opts.maxDurationMs || resolved.maxDurationMs,\n    });\n\n    // 8. Persist turn — messages, audit, memory, cost (fire-and-forget errors)\n    const chatEndTime = Date.now();\n    try {\n      await persistAgentTurn(this.supabase, agent, {\n        conversationId,\n        storeId,\n        agentId,\n        agentModel,\n        traceId,\n        message,\n        result,\n        source,\n        chatStartTime: startedAt,\n        chatEndTime,\n        userId: userId || undefined,\n        userEmail,\n        senderContext: session.sender_context,\n      });\n    } catch (err) {\n      log.error({ err: (err as Error).message, conversationId }, \"persist turn failed\");\n    }\n\n    // 9. Return unified turn result\n    return {\n      finalText: result.finalText,\n      tokens: {\n        input: result.tokens.input,\n        output: result.tokens.output,\n        cacheRead: result.tokens.cacheRead,\n        cacheCreation: result.tokens.cacheCreation,\n      },\n      costUsd: result.costUsd,\n      turnCount: result.turnCount,\n      toolsUsed: result.toolsUsed,\n      toolCallCount: result.toolCallCount,\n      stopReason: result.stopReason,\n      loopDetectorStats: result.loopDetectorStats,\n      turns: result.turns,\n    };\n  }\n\n  /**\n   * Get a session by ID from the database.\n   */\n  async getSession(sessionId: string): Promise<Session | null> {\n    const { data: conv } = await this.supabase\n      .from(\"ai_conversations\")\n      .select(\"id, store_id, agent_id, user_id, customer_id, metadata, created_at, updated_at\")\n      .eq(\"id\", sessionId)\n      .single();\n\n    if (!conv) return null;\n\n    const meta = (conv.metadata || {}) as Record<string, unknown>;\n    return {\n      id: conv.id,\n      store_id: conv.store_id,\n      agent_id: conv.agent_id,\n      conversation_id: conv.id,\n      surface: (meta.source as any) || \"whale_chat\",\n      runner: \"server\",\n      status: \"active\",\n      user_id: conv.user_id || undefined,\n      customer_id: conv.customer_id || undefined,\n      turn_count: 0,\n      cost_usd: (meta.session_cost_usd as number) || 0,\n      cost_budget_usd: 25,\n      created_at: conv.created_at,\n      updated_at: conv.updated_at,\n      metadata: meta,\n    };\n  }\n\n  /**\n   * List sessions for a store, optionally filtered by status and surface.\n   */\n  async listSessions(\n    storeId: string,\n    filters?: { status?: string; surface?: string; limit?: number },\n  ): Promise<Session[]> {\n    let query = this.supabase\n      .from(\"ai_conversations\")\n      .select(\"id, store_id, agent_id, user_id, customer_id, metadata, created_at, updated_at\")\n      .eq(\"store_id\", storeId)\n      .order(\"updated_at\", { ascending: false })\n      .limit(filters?.limit || 50);\n\n    if (filters?.surface) {\n      query = query.contains(\"metadata\", { source: filters.surface });\n    }\n\n    const { data: convs } = await query;\n    if (!convs?.length) return [];\n\n    return convs.map((conv) => {\n      const meta = (conv.metadata || {}) as Record<string, unknown>;\n      return {\n        id: conv.id,\n        store_id: conv.store_id,\n        agent_id: conv.agent_id,\n        conversation_id: conv.id,\n        surface: (meta.source as any) || \"whale_chat\",\n        runner: \"server\" as const,\n        status: \"active\" as const,\n        user_id: conv.user_id || undefined,\n        customer_id: conv.customer_id || undefined,\n        turn_count: 0,\n        cost_usd: (meta.session_cost_usd as number) || 0,\n        cost_budget_usd: 25,\n        created_at: conv.created_at,\n        updated_at: conv.updated_at,\n        metadata: meta,\n      };\n    });\n  }\n\n  /**\n   * Cancel a running session (merges into existing metadata instead of overwriting).\n   */\n  async cancelSession(sessionId: string): Promise<void> {\n    const { data: conv } = await this.supabase.from(\"ai_conversations\")\n      .select(\"metadata\").eq(\"id\", sessionId).single();\n    await this.supabase.from(\"ai_conversations\")\n      .update({\n        metadata: {\n          ...(conv?.metadata as Record<string, unknown> || {}),\n          status: \"cancelled\",\n          cancelled_at: new Date().toISOString(),\n        },\n      })\n      .eq(\"id\", sessionId);\n  }\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,UAAU,QAAQ,aAAa;AAGxC,SAASC,YAAY,QAAQ,iBAAiB;AAC9C,SAASC,sBAAsB,QAAuB,yBAAyB;AAC/E,SAASC,MAAM,QAAQ,wBAAwB;AAC/C,SAASC,kBAAkB,QAAQ,4BAA4B;AAE/D,SACEC,SAAS,EAAEC,aAAa,EAAEC,gBAAgB,EAAEC,WAAW,EACvDC,eAAe,EAAEC,qBAAqB,EAAEC,qBAAqB,QAExD,kBAAkB;AACzB,SAASC,kBAAkB,EAAEC,cAAc,QAAiB,qBAAqB;AACjF,SAASC,sBAAsB,QAAQ,mBAAmB;AAC1D,SAASC,gBAAgB,QAAQ,qBAAqB;AACtD,SAASC,mBAAmB,QAAQ,2BAA2B;AAO/D,MAAMC,GAAG,GAAGhB,YAAY,CAAC,iBAAiB,CAAC;;AAE3C;AACA;AACA;;AAEA,OAAO,MAAMiB,cAAc,CAAC;EAC1BC,WAAWA,CAASC,QAAwB,EAAE;IAAA,KAA1BA,QAAwB,GAAxBA,QAAwB;EAAG;;EAE/C;AACF;AACA;AACA;EACE,MAAMC,aAAaA,CAACC,IAAuB,EAAoB;IAC7D,MAAM;MAAEC,OAAO;MAAEC,OAAO;MAAEC,OAAO;MAAEC,MAAM;MAAEC,SAAS;MAAEC,aAAa;MAAEC;IAAQ,CAAC,GAAGP,IAAI;;IAErF;IACA,MAAMQ,KAAK,GAAG,MAAMrB,eAAe,CAAC,IAAI,CAACW,QAAQ,EAAEI,OAAO,EAAED,OAAO,CAAC;IACpE,IAAI,CAACO,KAAK,EAAE,MAAM,IAAIC,KAAK,CAAC,SAASP,OAAO,YAAY,CAAC;;IAEzD;IACA,IAAIQ,cAAsB;IAC1B,IAAIC,UAA8B;IAClC,IAAIC,YAAgC;IACpC,IAAIC,KAAK,GAAG,IAAI;IAEhB,IAAIb,IAAI,CAACU,cAAc,EAAE;MACvB;MACAA,cAAc,GAAGV,IAAI,CAACU,cAAc;MACpCG,KAAK,GAAG,KAAK;;MAEb;MACA,IAAIV,OAAO,KAAK,SAAS,EAAE;QACzBW,OAAO,CAACC,OAAO,CACb,IAAI,CAACjB,QAAQ,CAACkB,IAAI,CAAC,kBAAkB,CAAC,CACnCC,MAAM,CAAC;UAAEC,QAAQ,EAAEhB;QAAQ,CAAC,CAAC,CAC7BiB,EAAE,CAAC,IAAI,EAAET,cAAc,CAAC,CACxBU,EAAE,CAAC,UAAU,EAAE,IAAI,CACxB,CAAC,CAACC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;MACnB;IACF,CAAC,MAAM,IAAIf,aAAa,EAAEgB,SAAS,IAAIhB,aAAa,EAAEiB,QAAQ,EAAE;MAC9D;MACA,MAAMC,QAAQ,GAAG,MAAM9B,mBAAmB,CACxC,IAAI,CAACI,QAAQ,EACbQ,aAAa,CAACgB,SAAS,EACvBhB,aAAa,CAACiB,QAAQ,EACtBtB,OAAO,EACPK,aAAa,CAACmB,WAAW,EACzBnB,aAAa,CAACoB,UAChB,CAAC;MACDhB,cAAc,GAAGc,QAAQ,CAACd,cAAc;MACxCC,UAAU,GAAGa,QAAQ,CAACb,UAAU,IAAIgB,SAAS;MAC7Cf,YAAY,GAAGY,QAAQ,CAACZ,YAAY,IAAIe,SAAS;MACjDd,KAAK,GAAGW,QAAQ,CAACI,YAAY;IAC/B,CAAC,MAAM;MACL;MACA,MAAMC,KAAK,GAAGtB,OAAO,GAAGA,OAAO,CAACuB,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,aAAa;MACjE,IAAIC,IAAI,GAAG,MAAM,IAAI,CAACjC,QAAQ,CAACkB,IAAI,CAAC,kBAAkB,CAAC,CAACgB,MAAM,CAAC;QAC7DC,QAAQ,EAAEhC,OAAO,IAAI,IAAI;QACzBiC,OAAO,EAAE9B,MAAM,IAAI,IAAI;QACvBc,QAAQ,EAAEhB,OAAO;QACjB2B,KAAK;QACLM,QAAQ,EAAE;UAAEC,SAAS,EAAE5B,KAAK,CAAC6B,IAAI;UAAEC,MAAM,EAAEnC;QAAQ;MACrD,CAAC,CAAC,CAACoC,MAAM,CAAC,IAAI,CAAC,CAACC,MAAM,CAAC,CAAC;MAExB,IAAIT,IAAI,CAACU,KAAK,EAAE;QACd9C,GAAG,CAAC8C,KAAK,CAAC;UAAEC,GAAG,EAAEX,IAAI,CAACU,KAAK,CAAClC,OAAO;UAAEN,OAAO;UAAEG,MAAM;UAAEF;QAAQ,CAAC,EAAE,4BAA4B,CAAC;QAC9F;QACA6B,IAAI,GAAG,MAAM,IAAI,CAACjC,QAAQ,CAACkB,IAAI,CAAC,kBAAkB,CAAC,CAACgB,MAAM,CAAC;UACzDC,QAAQ,EAAEhC,OAAO,IAAI,IAAI;UACzBiB,QAAQ,EAAEhB,OAAO;UACjB2B,KAAK;UACLM,QAAQ,EAAE;YAAEC,SAAS,EAAE5B,KAAK,CAAC6B,IAAI;YAAEC,MAAM,EAAEnC,OAAO;YAAEC,MAAM;YAAEC;UAAU;QACxE,CAAC,CAAC,CAACkC,MAAM,CAAC,IAAI,CAAC,CAACC,MAAM,CAAC,CAAC;QACxB,IAAIT,IAAI,CAACU,KAAK,EAAE9C,GAAG,CAAC8C,KAAK,CAAC;UAAEC,GAAG,EAAEX,IAAI,CAACU,KAAK,CAAClC;QAAQ,CAAC,EAAE,kCAAkC,CAAC;MAC5F;MACAG,cAAc,GAAGqB,IAAI,CAACY,IAAI,EAAEC,EAAE,IAAIlE,UAAU,CAAC,CAAC;MAC9CiB,GAAG,CAACkD,IAAI,CAAC;QAAEnC,cAAc;QAAEoC,MAAM,EAAE,CAAC,CAACf,IAAI,CAACY,IAAI,EAAEC;MAAG,CAAC,EAAE,iBAAiB,CAAC;IAC1E;;IAEA;IACA,IAAItC,aAAa,EAAE;MACjBK,UAAU,GAAGA,UAAU,IAAIL,aAAa,CAACK,UAAU,IAAIgB,SAAS;MAChEf,YAAY,GAAGA,YAAY,IAAIN,aAAa,CAACM,YAAY,IAAIe,SAAS;IACxE;IAEA,MAAMoB,GAAG,GAAG,IAAIC,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC;IACpC,OAAO;MACLL,EAAE,EAAElC,cAAc;MAClBuB,QAAQ,EAAEhC,OAAO;MACjBiB,QAAQ,EAAEhB,OAAO;MACjBgD,eAAe,EAAExC,cAAc;MAC/BP,OAAO;MACPgD,MAAM,EAAE,QAAQ;MAChBC,MAAM,EAAE,QAAyB;MACjClB,OAAO,EAAE9B,MAAM;MACfiD,WAAW,EAAE1C,UAAU;MACvB2C,cAAc,EAAEhD,aAAa;MAC7BiD,UAAU,EAAE,CAAC;MACbC,QAAQ,EAAE,CAAC;MACXC,eAAe,EAAE,EAAE;MACnBC,UAAU,EAAEX,GAAG;MACfY,UAAU,EAAEZ,GAAG;MACfZ,QAAQ,EAAE;QAAEC,SAAS,EAAE5B,KAAK,CAAC6B,IAAI;QAAExB;MAAM;IAC3C,CAAC;EACH;;EAEA;AACF;AACA;EACE,MAAM+C,aAAaA,CAACC,SAAiB,EAAE1D,OAAuB,EAAoB;IAChF,MAAM;MAAEwC,IAAI,EAAEZ,IAAI;MAAEU;IAAM,CAAC,GAAG,MAAM,IAAI,CAAC3C,QAAQ,CAC9CkB,IAAI,CAAC,kBAAkB,CAAC,CACxBuB,MAAM,CAAC,gFAAgF,CAAC,CACxFpB,EAAE,CAAC,IAAI,EAAE0C,SAAS,CAAC,CACnBrB,MAAM,CAAC,CAAC;IAEX,IAAIC,KAAK,IAAI,CAACV,IAAI,EAAE,MAAM,IAAItB,KAAK,CAAC,WAAWoD,SAAS,YAAY,CAAC;IAErE,MAAMC,IAAI,GAAI/B,IAAI,CAACI,QAAQ,IAAI,CAAC,CAA6B;IAE7D,OAAO;MACLS,EAAE,EAAEb,IAAI,CAACa,EAAE;MACXX,QAAQ,EAAEF,IAAI,CAACE,QAAQ;MACvBf,QAAQ,EAAEa,IAAI,CAACb,QAAQ;MACvBgC,eAAe,EAAEnB,IAAI,CAACa,EAAE;MACxBzC,OAAO;MACPgD,MAAM,EAAE,QAAQ;MAChBC,MAAM,EAAE,QAAQ;MAChBlB,OAAO,EAAEH,IAAI,CAACG,OAAO,IAAIP,SAAS;MAClC0B,WAAW,EAAEtB,IAAI,CAACsB,WAAW,IAAI1B,SAAS;MAC1C4B,UAAU,EAAE,CAAC;MACbC,QAAQ,EAAGM,IAAI,CAACC,gBAAgB,IAAe,CAAC;MAChDN,eAAe,EAAE,EAAE;MACnBC,UAAU,EAAE3B,IAAI,CAAC2B,UAAU;MAC3BC,UAAU,EAAE5B,IAAI,CAAC4B,UAAU;MAC3BxB,QAAQ,EAAE2B;IACZ,CAAC;EACH;;EAEA;AACF;AACA;AACA;AACA;EACE,MAAME,WAAWA,CAACC,OAAgB,EAAEjE,IAAqB,EAAuB;IAC9E,MAAM;MACJO,OAAO;MAAE2D,WAAW;MAAEC,mBAAmB;MAAEC,OAAO;MAClDC,SAAS;MAAEC,MAAM;MAAEC,WAAW;MAAEC,YAAY;MAAEC,cAAc;MAC5DC,kBAAkB;MAAEC;IACtB,CAAC,GAAG3E,IAAI;IAER,MAAM;MAAEiC,QAAQ,EAAEhC,OAAO;MAAEiB,QAAQ,EAAEhB,OAAO;MAAEgD,eAAe,EAAExC;IAAe,CAAC,GAAGuD,OAAO;IACzF,MAAM7D,MAAM,GAAG6D,OAAO,CAAC/B,OAAO,IAAI,EAAE;IACpC,MAAM7B,SAAS,GAAI4D,OAAO,CAAC9B,QAAQ,EAAE9B,SAAS,IAAe,IAAI;IACjE,MAAMiC,MAAM,GAAGtC,IAAI,CAACsC,MAAM,IAAI2B,OAAO,CAAC9D,OAAO;;IAE7C;IACA,MAAMK,KAAK,GAAG,MAAMrB,eAAe,CAAC,IAAI,CAACW,QAAQ,EAAEI,OAAO,EAAED,OAAO,CAAC;IACpE,IAAI,CAACO,KAAK,EAAE,MAAM,IAAIC,KAAK,CAAC,SAASP,OAAO,YAAY,CAAC;;IAEzD;IACA,MAAM;MAAE0E,IAAI,EAAEC,SAAS;MAAEC,QAAQ,EAAEC;IAAc,CAAC,GAAG,MAAMhG,SAAS,CAAC,IAAI,CAACe,QAAQ,CAAC;IACnFV,qBAAqB,CAAC2F,aAAa,CAAC;IACpC,MAAM;MAAEC,IAAI,EAAEC,YAAY;MAAEC,IAAI,EAAEC;IAAa,CAAC,GAAGlF,OAAO,GACtD,MAAMjB,aAAa,CAAC,IAAI,CAACc,QAAQ,EAAEG,OAAO,CAAC,GAC3C;MAAE+E,IAAI,EAAE,EAAmB;MAAEE,IAAI,EAAE;IAAgB,CAAC;IACxD,MAAME,KAAK,GAAGnG,gBAAgB,CAACuB,KAAK,EAAEqE,SAAS,EAAEM,YAAY,CAAC;;IAE9D;IACA,MAAME,QAAQ,GAAGpB,OAAO,CAAC9D,OAAO,KAAK,SAAS,GAAG,SAAS,GACtD8D,OAAO,CAAC9D,OAAO,KAAK,UAAU,GAAG,UAAU,GAC3C,KAAK;IACT,MAAMqB,QAAQ,GAAG5C,sBAAsB,CAAC4B,KAAK,EAAE6E,QAAQ,CAAC;IACxD,IAAI7D,QAAQ,CAAC8D,YAAY,CAACC,MAAM,GAAG,CAAC,EAAE;MACpC5F,GAAG,CAACkD,IAAI,CAAC;QAAE3C,OAAO;QAAEmF,QAAQ;QAAEG,QAAQ,EAAEhE,QAAQ,CAAC8D;MAAa,CAAC,EAAE,+BAA+B,CAAC;IACnG;;IAEA;IACA,MAAM;MAAEG,YAAY;MAAEC;IAAe,CAAC,GAAG,MAAMlG,sBAAsB,CACnE,IAAI,CAACM,QAAQ,EAAEU,KAAK,EAAEP,OAAO,EAAEM,OAAO,EAAE6E,KAAK,EAAE;MAC7C9E,aAAa,EAAE2D,OAAO,CAACX,cAAc;MACrCqC,aAAa,EAAEvB,OAAO;MACtBhE,MAAM,EAAEA,MAAM,IAAIuB,SAAS;MAC3BtB,SAAS;MACT0E,aAAa,EAAE1F,qBAAqB,CAAC;IACvC,CACF,CAAC;;IAED;IACA,IAAIuG,QAAkC;IAEtC,IAAIzB,mBAAmB,EAAEoB,MAAM,EAAE;MAC/B;MACAK,QAAQ,GAAG,CAAC,GAAGrG,cAAc,CAAC4E,mBAAmB,EAAE3C,QAAQ,CAACqE,eAAe,CAAC,CAAC;IAC/E,CAAC,MAAM,IAAInF,cAAc,IAAIuD,OAAO,CAAC9D,OAAO,KAAK,SAAS,EAAE;MAC1D;MACA,IAAI2F,aAAuC,GAAG,EAAE;MAChD,IAAI;QACF,MAAM;UAAEnD,IAAI,EAAEoD;QAAQ,CAAC,GAAG,MAAM,IAAI,CAACjG,QAAQ,CAACkB,IAAI,CAAC,aAAa,CAAC,CAC9DuB,MAAM,CAAC,eAAe,CAAC,CAACpB,EAAE,CAAC,iBAAiB,EAAET,cAAc,CAAC,CAC7DsF,KAAK,CAAC,YAAY,EAAE;UAAEC,SAAS,EAAE;QAAK,CAAC,CAAC,CAACC,KAAK,CAAC,EAAE,CAAC;QACrD,IAAIH,OAAO,EAAER,MAAM,EAAE;UACnB,MAAMY,GAA6B,GAAG,EAAE;UACxC,KAAK,MAAMC,CAAC,IAAIL,OAAO,EAAE;YACvB,IAAIK,CAAC,CAACC,IAAI,KAAK,MAAM,IAAID,CAAC,CAACC,IAAI,KAAK,WAAW,EAAE;cAC/CF,GAAG,CAACG,IAAI,CAAC;gBAAED,IAAI,EAAED,CAAC,CAACC,IAAI;gBAAEE,OAAO,EAAEH,CAAC,CAACG;cAAQ,CAAC,CAAC;YAChD;UACF;UACAT,aAAa,GAAGvG,cAAc,CAAC4G,GAAG,EAAE3E,QAAQ,CAACqE,eAAe,CAAC;QAC/D;MACF,CAAC,CAAC,MAAM,CAAE;MACVD,QAAQ,GAAG,CAAC,GAAGE,aAAa,CAAC;IAC/B,CAAC,MAAM;MACLF,QAAQ,GAAG,EAAE;IACf;;IAEA;IACA,IAAIY,WAA8C;IAClD,IAAItC,WAAW,EAAEqB,MAAM,EAAE;MACvB,MAAMkB,aAAoB,GAAG,EAAE;MAC/B,KAAK,MAAMC,GAAG,IAAIxC,WAAW,EAAE;QAC7B,IAAIwC,GAAG,CAACC,IAAI,KAAK,OAAO,IAAID,GAAG,CAACE,UAAU,IAAIF,GAAG,CAAC/D,IAAI,EAAE;UACtD8D,aAAa,CAACH,IAAI,CAAC;YACjBK,IAAI,EAAE,OAAO;YACbrE,MAAM,EAAE;cAAEqE,IAAI,EAAE,QAAQ;cAAEC,UAAU,EAAEF,GAAG,CAACE,UAAU;cAAEjE,IAAI,EAAE+D,GAAG,CAAC/D;YAAK;UACvE,CAAC,CAAC;QACJ;MACF;MACA8D,aAAa,CAACH,IAAI,CAAC;QAAEK,IAAI,EAAE,MAAM;QAAEE,IAAI,EAAEtG;MAAQ,CAAC,CAAC;MACnDiG,WAAW,GAAGC,aAAa;IAC7B,CAAC,MAAM;MACLD,WAAW,GAAGjG,OAAO;IACvB;IAEA,MAAMuG,aAAa,GAAGpB,cAAc,GAAG,cAAcA,cAAc,sBAAsB,GAAG,EAAE;IAC9F,MAAMqB,gBAAgB,GAAG,OAAOP,WAAW,KAAK,QAAQ,GACpDM,aAAa,GAAGN,WAAW,GAC3B,CAAC,IAAIM,aAAa,GAAG,CAAC;MAAEH,IAAI,EAAE,MAAe;MAAEE,IAAI,EAAEC;IAAc,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,GAAGN,WAAW,CAAC;IAChGZ,QAAQ,CAACU,IAAI,CAAC;MAAED,IAAI,EAAE,MAAM;MAAEE,OAAO,EAAEQ;IAAiB,CAAC,CAAC;;IAE1D;IACA,MAAMC,OAAO,GAAGtI,UAAU,CAAC,CAAC;IAC5B,MAAMuI,UAAU,GAAGzG,KAAK,CAAC0G,KAAK,IAAIrI,MAAM,CAACsI,MAAM;IAC/C,MAAMC,SAAS,GAAGpE,IAAI,CAACD,GAAG,CAAC,CAAC;IAE5B,MAAMsE,MAAM,GAAG,MAAMvI,kBAAkB,CAAC;MACtCwI,SAAS,EAAEhI,kBAAkB,CAACkB,KAAK,CAAC;MACpCV,QAAQ,EAAE,IAAI,CAACA,QAAQ;MACvBoH,KAAK,EAAED,UAAU;MACjBxB,YAAY;MACZG,QAAQ;MACRR,KAAK;MACLL,aAAa;MACbwC,QAAQ,EAAEvH,IAAI,CAACuH,QAAQ,IAAI/F,QAAQ,CAAC+F,QAAQ;MAC5CC,WAAW,EAAEhG,QAAQ,CAACgG,WAAW;MACjCC,SAAS,EAAEjG,QAAQ,CAACiG,SAAS;MAC7BC,kBAAkB,EAAElG,QAAQ,CAACkG,kBAAkB;MAC/CC,gBAAgB,EAAEnG,QAAQ,CAACmG,gBAAgB;MAC3CC,kBAAkB,EAAEpG,QAAQ,CAACoG,kBAAkB;MAC/CC,gBAAgB,EAAErG,QAAQ,CAACqG,gBAAgB;MAC3CC,iBAAiB,EAAEtG,QAAQ,CAACsG,iBAAiB;MAC7CC,gBAAgB,EAAEvG,QAAQ,CAACuG,gBAAgB;MAC3CC,mBAAmB,EAAExG,QAAQ,CAACwG,mBAAmB;MACjDC,kBAAkB,EAAE;QAClBC,kBAAkB,EAAE1G,QAAQ,CAAC2G,sBAAsB;QACnDC,qBAAqB,EAAE5G,QAAQ,CAAC6G,yBAAyB;QACzDC,cAAc,EAAE9G,QAAQ,CAAC+G,kBAAkB;QAC3CC,MAAM,EAAEhH,QAAQ,CAACiH,UAAU;QAC3BC,qBAAqB,EAAElH,QAAQ,CAACmH,yBAAyB;QACzDC,0BAA0B,EAAEpH,QAAQ,CAACqH,8BAA8B;QACnEC,aAAa,EAAEtH,QAAQ,CAACuH;MAC1B,CAAC;MACDC,eAAe,EAAExH,QAAQ,CAACyH,mBAAmB;MAC7ChJ,OAAO;MACP+G,OAAO;MACP5G,MAAM,EAAEA,MAAM,IAAIuB,SAAS;MAC3BtB,SAAS;MACTiC,MAAM;MACN5B,cAAc;MACdR,OAAO;MACPhB,WAAW,EAAE,MAAAA,CAAOgK,QAAQ,EAAEC,IAAI,EAAEC,cAAc,EAAEC,gBAAgB,KAAK;QACvE,MAAMC,QAAQ,GAAG;UAAE,GAAGH;QAAK,CAAC;QAC5B,IAAI,CAACG,QAAQ,CAACrH,QAAQ,IAAIhC,OAAO,EAAEqJ,QAAQ,CAACrH,QAAQ,GAAGhC,OAAO;QAC9D,MAAMsJ,YAAY,GAAGtF,OAAO,CAACX,cAAc,EAAE3C,UAAU,IAAI,IAAI;QAC/D,MAAM6I,eAAe,GAAGvF,OAAO,CAACX,cAAc,EAAE1C,YAAY,IACvDqD,OAAO,CAACX,cAAc,EAAE5B,UAAU,KACjCuC,OAAO,CAACX,cAAc,EAAE/B,QAAQ,GAChC,GAAG0C,OAAO,CAACX,cAAc,CAAC7B,WAAW,IAAIwC,OAAO,CAACX,cAAc,CAAC/B,QAAQ,EAAE,GAC1E,IAAI,CAAC;QACX,OAAOrC,WAAW,CAChB,IAAI,CAACY,QAAQ,EAAEoJ,QAAQ,EAAEI,QAAQ,EAAErJ,OAAO,EAAE+G,OAAO,EACnDuC,YAAY,IAAInJ,MAAM,IAAI,IAAI,EAAEoJ,eAAe,IAAInJ,SAAS,IAAI,IAAI,EACpE+I,cAAc,IAAI9G,MAAM,EAAE5B,cAAc,EACxCuE,YAAY,EAAE/E,OAAO,EAAEmJ,gBAAgB,EAAE,IAC3C,CAAC;MACH,CAAC;MACDI,eAAe,EAAEpF,SAAS;MAC1BC,MAAM;MACNC,WAAW;MACXC,YAAY;MACZC,cAAc;MACdC,kBAAkB,EAAEA,kBAAyB;MAC7CC,kBAAkB;MAClByC,SAAS;MACTsC,aAAa,EAAE1J,IAAI,CAAC0J,aAAa,IAAIlI,QAAQ,CAACkI;IAChD,CAAC,CAAC;;IAEF;IACA,MAAMC,WAAW,GAAG3G,IAAI,CAACD,GAAG,CAAC,CAAC;IAC9B,IAAI;MACF,MAAMtD,gBAAgB,CAAC,IAAI,CAACK,QAAQ,EAAEU,KAAK,EAAE;QAC3CE,cAAc;QACdT,OAAO;QACPC,OAAO;QACP+G,UAAU;QACVD,OAAO;QACPzG,OAAO;QACP8G,MAAM;QACN/E,MAAM;QACNsH,aAAa,EAAExC,SAAS;QACxBuC,WAAW;QACXvJ,MAAM,EAAEA,MAAM,IAAIuB,SAAS;QAC3BtB,SAAS;QACTC,aAAa,EAAE2D,OAAO,CAACX;MACzB,CAAC,CAAC;IACJ,CAAC,CAAC,OAAOZ,GAAG,EAAE;MACZ/C,GAAG,CAAC8C,KAAK,CAAC;QAAEC,GAAG,EAAGA,GAAG,CAAWnC,OAAO;QAAEG;MAAe,CAAC,EAAE,qBAAqB,CAAC;IACnF;;IAEA;IACA,OAAO;MACLmJ,SAAS,EAAExC,MAAM,CAACwC,SAAS;MAC3BC,MAAM,EAAE;QACNC,KAAK,EAAE1C,MAAM,CAACyC,MAAM,CAACC,KAAK;QAC1BC,MAAM,EAAE3C,MAAM,CAACyC,MAAM,CAACE,MAAM;QAC5BC,SAAS,EAAE5C,MAAM,CAACyC,MAAM,CAACG,SAAS;QAClCC,aAAa,EAAE7C,MAAM,CAACyC,MAAM,CAACI;MAC/B,CAAC;MACDC,OAAO,EAAE9C,MAAM,CAAC8C,OAAO;MACvBC,SAAS,EAAE/C,MAAM,CAAC+C,SAAS;MAC3BC,SAAS,EAAEhD,MAAM,CAACgD,SAAS;MAC3BC,aAAa,EAAEjD,MAAM,CAACiD,aAAa;MACnCC,UAAU,EAAElD,MAAM,CAACkD,UAAU;MAC7BC,iBAAiB,EAAEnD,MAAM,CAACmD,iBAAiB;MAC3CC,KAAK,EAAEpD,MAAM,CAACoD;IAChB,CAAC;EACH;;EAEA;AACF;AACA;EACE,MAAMC,UAAUA,CAAC7G,SAAiB,EAA2B;IAC3D,MAAM;MAAElB,IAAI,EAAEZ;IAAK,CAAC,GAAG,MAAM,IAAI,CAACjC,QAAQ,CACvCkB,IAAI,CAAC,kBAAkB,CAAC,CACxBuB,MAAM,CAAC,gFAAgF,CAAC,CACxFpB,EAAE,CAAC,IAAI,EAAE0C,SAAS,CAAC,CACnBrB,MAAM,CAAC,CAAC;IAEX,IAAI,CAACT,IAAI,EAAE,OAAO,IAAI;IAEtB,MAAM+B,IAAI,GAAI/B,IAAI,CAACI,QAAQ,IAAI,CAAC,CAA6B;IAC7D,OAAO;MACLS,EAAE,EAAEb,IAAI,CAACa,EAAE;MACXX,QAAQ,EAAEF,IAAI,CAACE,QAAQ;MACvBf,QAAQ,EAAEa,IAAI,CAACb,QAAQ;MACvBgC,eAAe,EAAEnB,IAAI,CAACa,EAAE;MACxBzC,OAAO,EAAG2D,IAAI,CAACxB,MAAM,IAAY,YAAY;MAC7Ca,MAAM,EAAE,QAAQ;MAChBC,MAAM,EAAE,QAAQ;MAChBlB,OAAO,EAAEH,IAAI,CAACG,OAAO,IAAIP,SAAS;MAClC0B,WAAW,EAAEtB,IAAI,CAACsB,WAAW,IAAI1B,SAAS;MAC1C4B,UAAU,EAAE,CAAC;MACbC,QAAQ,EAAGM,IAAI,CAACC,gBAAgB,IAAe,CAAC;MAChDN,eAAe,EAAE,EAAE;MACnBC,UAAU,EAAE3B,IAAI,CAAC2B,UAAU;MAC3BC,UAAU,EAAE5B,IAAI,CAAC4B,UAAU;MAC3BxB,QAAQ,EAAE2B;IACZ,CAAC;EACH;;EAEA;AACF;AACA;EACE,MAAM6G,YAAYA,CAChB1K,OAAe,EACf2K,OAA+D,EAC3C;IACpB,IAAIC,KAAK,GAAG,IAAI,CAAC/K,QAAQ,CACtBkB,IAAI,CAAC,kBAAkB,CAAC,CACxBuB,MAAM,CAAC,gFAAgF,CAAC,CACxFpB,EAAE,CAAC,UAAU,EAAElB,OAAO,CAAC,CACvB+F,KAAK,CAAC,YAAY,EAAE;MAAEC,SAAS,EAAE;IAAM,CAAC,CAAC,CACzCC,KAAK,CAAC0E,OAAO,EAAE1E,KAAK,IAAI,EAAE,CAAC;IAE9B,IAAI0E,OAAO,EAAEzK,OAAO,EAAE;MACpB0K,KAAK,GAAGA,KAAK,CAACC,QAAQ,CAAC,UAAU,EAAE;QAAExI,MAAM,EAAEsI,OAAO,CAACzK;MAAQ,CAAC,CAAC;IACjE;IAEA,MAAM;MAAEwC,IAAI,EAAEoI;IAAM,CAAC,GAAG,MAAMF,KAAK;IACnC,IAAI,CAACE,KAAK,EAAExF,MAAM,EAAE,OAAO,EAAE;IAE7B,OAAOwF,KAAK,CAACC,GAAG,CAAEjJ,IAAI,IAAK;MACzB,MAAM+B,IAAI,GAAI/B,IAAI,CAACI,QAAQ,IAAI,CAAC,CAA6B;MAC7D,OAAO;QACLS,EAAE,EAAEb,IAAI,CAACa,EAAE;QACXX,QAAQ,EAAEF,IAAI,CAACE,QAAQ;QACvBf,QAAQ,EAAEa,IAAI,CAACb,QAAQ;QACvBgC,eAAe,EAAEnB,IAAI,CAACa,EAAE;QACxBzC,OAAO,EAAG2D,IAAI,CAACxB,MAAM,IAAY,YAAY;QAC7Ca,MAAM,EAAE,QAAiB;QACzBC,MAAM,EAAE,QAAiB;QACzBlB,OAAO,EAAEH,IAAI,CAACG,OAAO,IAAIP,SAAS;QAClC0B,WAAW,EAAEtB,IAAI,CAACsB,WAAW,IAAI1B,SAAS;QAC1C4B,UAAU,EAAE,CAAC;QACbC,QAAQ,EAAGM,IAAI,CAACC,gBAAgB,IAAe,CAAC;QAChDN,eAAe,EAAE,EAAE;QACnBC,UAAU,EAAE3B,IAAI,CAAC2B,UAAU;QAC3BC,UAAU,EAAE5B,IAAI,CAAC4B,UAAU;QAC3BxB,QAAQ,EAAE2B;MACZ,CAAC;IACH,CAAC,CAAC;EACJ;;EAEA;AACF;AACA;EACE,MAAMmH,aAAaA,CAACpH,SAAiB,EAAiB;IACpD,MAAM;MAAElB,IAAI,EAAEZ;IAAK,CAAC,GAAG,MAAM,IAAI,CAACjC,QAAQ,CAACkB,IAAI,CAAC,kBAAkB,CAAC,CAChEuB,MAAM,CAAC,UAAU,CAAC,CAACpB,EAAE,CAAC,IAAI,EAAE0C,SAAS,CAAC,CAACrB,MAAM,CAAC,CAAC;IAClD,MAAM,IAAI,CAAC1C,QAAQ,CAACkB,IAAI,CAAC,kBAAkB,CAAC,CACzCC,MAAM,CAAC;MACNkB,QAAQ,EAAE;QACR,IAAIJ,IAAI,EAAEI,QAAQ,IAA+B,CAAC,CAAC,CAAC;QACpDiB,MAAM,EAAE,WAAW;QACnB8H,YAAY,EAAE,IAAIlI,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC;MACvC;IACF,CAAC,CAAC,CACD9B,EAAE,CAAC,IAAI,EAAE0C,SAAS,CAAC;EACxB;AACF","ignoreList":[]}

package/dist/server/tool-router-discovery.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tool Router — tool registry loading, discover_tools handler, and caching.
+ */
+import type { SupabaseClient } from "@supabase/supabase-js";
+import { type ToolDef, type ToolLoadResult } from "./tool-router-types.js";
+/** Truncate a description to maxLen characters, ending at a word boundary with ellipsis. */
+export declare function truncateDescription(desc: string, maxLen?: number): string;
+/**
+ * Load tools from ai_tool_registry, split into core (auto_load=true) and extended.
+ */
+export declare function loadTools(supabase: SupabaseClient, forceRefresh?: boolean): Promise<ToolLoadResult>;
+/**
+ * Get pre-computed API-ready tool definitions.
+ */
+export declare function getCachedToolDefs(tools: ToolDef[]): Array<{
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}>;
+/** discover_tools meta-tool definition */
+export declare const DISCOVER_TOOLS_DEF: ToolDef;
+export declare function setExtendedToolsCache(tools: ToolDef[]): void;
+export declare function getExtendedToolsCache(): ToolDef[];
+export declare function getExtendedToolsIndex(): Array<{
+    name: string;
+    description: string;
+}>;
+export declare function getFullToolSchemas(toolNames: string[]): ToolDef[];
+export declare function handleDiscoverTools(sb: SupabaseClient, args: Record<string, unknown>): Promise<{
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}>;