whale-code 6.5.6 → 6.5.7

package/dist/server/lib/__tests__/utils-timeout.test.js

@@ -0,0 +1,49 @@
+import { describe, it, expect } from "vitest";
+import { withTimeout } from "../utils.js";
+describe("withTimeout", () => {
+  // --------------------------------------------------------------------------
+  // Plain promise form
+  // --------------------------------------------------------------------------
+
+  it("resolves before timeout — returns value", async () => {
+    const result = await withTimeout(new Promise(resolve => setTimeout(() => resolve("done"), 10)), 500, "fast-task");
+    expect(result).toBe("done");
+  });
+  it("takes too long — throws timeout error", async () => {
+    await expect(withTimeout(new Promise(resolve => setTimeout(() => resolve("late"), 1000)), 50, "slow-task")).rejects.toThrow("Tool slow-task timed out after 50ms");
+  });
+
+  // --------------------------------------------------------------------------
+  // Factory form (receives AbortSignal)
+  // --------------------------------------------------------------------------
+
+  it("factory form: passes AbortSignal to factory", async () => {
+    let receivedSignal;
+    await withTimeout(signal => {
+      receivedSignal = signal;
+      return Promise.resolve("ok");
+    }, 500, "signal-check");
+    expect(receivedSignal).toBeDefined();
+    expect(receivedSignal).toBeInstanceOf(AbortSignal);
+  });
+  it("factory form: signal is aborted when timeout fires", async () => {
+    let capturedSignal;
+    await expect(withTimeout(signal => {
+      capturedSignal = signal;
+      // Never resolves — will be timed out
+      return new Promise(() => {});
+    }, 50, "abort-on-timeout")).rejects.toThrow("timed out");
+    expect(capturedSignal).toBeDefined();
+    expect(capturedSignal.aborted).toBe(true);
+  });
+  it("factory form: signal is NOT aborted when promise resolves before timeout", async () => {
+    let capturedSignal;
+    const result = await withTimeout(signal => {
+      capturedSignal = signal;
+      return Promise.resolve("fast");
+    }, 500, "no-abort");
+    expect(result).toBe("fast");
+    expect(capturedSignal).toBeDefined();
+    expect(capturedSignal.aborted).toBe(false);
+  });
+});

package/dist/server/lib/__tests__/utils.test.js

@@ -0,0 +1,322 @@
+import { describe, it, expect } from "vitest";
+import { sanitizeFilterValue, groupBy, escapeCSV, fillTemplate, summarizeResult } from "../utils.js";
+
+// ============================================================================
+// sanitizeFilterValue
+// ============================================================================
+describe("sanitizeFilterValue", () => {
+  it("escapes ILIKE wildcard %", () => {
+    expect(sanitizeFilterValue("100%")).toBe("100\\%");
+  });
+  it("escapes ILIKE wildcard _", () => {
+    expect(sanitizeFilterValue("item_1")).toBe("item\\_1");
+  });
+  it("escapes backslashes", () => {
+    expect(sanitizeFilterValue("path\\to")).toBe("path\\\\to");
+  });
+  it("strips commas", () => {
+    expect(sanitizeFilterValue("a,b,c")).toBe("abc");
+  });
+  it("strips parentheses", () => {
+    expect(sanitizeFilterValue("fn(x)")).toBe("fnx");
+  });
+  it("handles combined special characters", () => {
+    expect(sanitizeFilterValue("100% off (sale), wow_deals\\promo")).toBe("100\\% off sale wow\\_deals\\\\promo");
+  });
+  it("returns empty string for empty input", () => {
+    expect(sanitizeFilterValue("")).toBe("");
+  });
+  it("passes through safe strings unchanged", () => {
+    expect(sanitizeFilterValue("hello world")).toBe("hello world");
+    expect(sanitizeFilterValue("product-name")).toBe("product-name");
+  });
+});
+
+// ============================================================================
+// groupBy
+// ============================================================================
+describe("groupBy", () => {
+  it("groups by a key and counts occurrences", () => {
+    const data = [{
+      type: "order",
+      id: 1
+    }, {
+      type: "order",
+      id: 2
+    }, {
+      type: "refund",
+      id: 3
+    }];
+    expect(groupBy(data, "type")).toEqual({
+      order: 2,
+      refund: 1
+    });
+  });
+  it("uses 'unknown' for missing keys", () => {
+    const data = [{
+      type: "order"
+    }, {
+      id: 1
+    } // no type
+    ];
+    expect(groupBy(data, "type")).toEqual({
+      order: 1,
+      unknown: 1
+    });
+  });
+  it("returns empty object for empty array", () => {
+    expect(groupBy([], "key")).toEqual({});
+  });
+  it("handles single item", () => {
+    expect(groupBy([{
+      status: "active"
+    }], "status")).toEqual({
+      active: 1
+    });
+  });
+});
+
+// ============================================================================
+// escapeCSV
+// ============================================================================
+describe("escapeCSV", () => {
+  it("returns empty string for null", () => {
+    expect(escapeCSV(null)).toBe("");
+  });
+  it("returns empty string for undefined", () => {
+    expect(escapeCSV(undefined)).toBe("");
+  });
+  it("passes through simple strings", () => {
+    expect(escapeCSV("hello")).toBe("hello");
+    expect(escapeCSV("123")).toBe("123");
+  });
+  it("wraps strings containing commas in quotes", () => {
+    expect(escapeCSV("a,b")).toBe('"a,b"');
+  });
+  it("wraps strings containing newlines in quotes", () => {
+    expect(escapeCSV("line1\nline2")).toBe('"line1\nline2"');
+  });
+  it("escapes double quotes by doubling them", () => {
+    expect(escapeCSV('say "hello"')).toBe('"say ""hello"""');
+  });
+  it("converts numbers to strings", () => {
+    expect(escapeCSV(42)).toBe("42");
+    expect(escapeCSV(3.14)).toBe("3.14");
+  });
+  it("converts booleans to strings", () => {
+    expect(escapeCSV(true)).toBe("true");
+    expect(escapeCSV(false)).toBe("false");
+  });
+  it("handles combined special characters", () => {
+    expect(escapeCSV('a,b"c\nd')).toBe('"a,b""c\nd"');
+  });
+});
+
+// ============================================================================
+// fillTemplate
+// ============================================================================
+describe("fillTemplate", () => {
+  it("replaces simple placeholders", () => {
+    expect(fillTemplate("Hello {{name}}!", {
+      name: "World"
+    })).toBe("Hello World!");
+  });
+  it("replaces multiple placeholders", () => {
+    expect(fillTemplate("{{greeting}} {{name}}, you have {{count}} items.", {
+      greeting: "Hi",
+      name: "Alice",
+      count: 5
+    })).toBe("Hi Alice, you have 5 items.");
+  });
+  it("supports dot-notation for nested values", () => {
+    expect(fillTemplate("{{user.name}} ({{user.role}})", {
+      user: {
+        name: "Bob",
+        role: "admin"
+      }
+    })).toBe("Bob (admin)");
+  });
+  it("preserves unresolved placeholders", () => {
+    expect(fillTemplate("{{missing}} value", {})).toBe("{{missing}} value");
+  });
+  it("preserves placeholders for null nested paths", () => {
+    expect(fillTemplate("{{a.b.c}}", {
+      a: null
+    })).toBe("{{a.b.c}}");
+  });
+  it("handles empty template", () => {
+    expect(fillTemplate("", {
+      key: "val"
+    })).toBe("");
+  });
+  it("handles template with no placeholders", () => {
+    expect(fillTemplate("plain text", {
+      key: "val"
+    })).toBe("plain text");
+  });
+  it("converts numeric values to string", () => {
+    expect(fillTemplate("Total: {{amount}}", {
+      amount: 99.5
+    })).toBe("Total: 99.5");
+  });
+  it("handles deeply nested paths", () => {
+    expect(fillTemplate("{{a.b.c}}", {
+      a: {
+        b: {
+          c: "deep"
+        }
+      }
+    })).toBe("deep");
+  });
+});
+
+// ============================================================================
+// summarizeResult
+// ============================================================================
+describe("summarizeResult", () => {
+  describe("analytics tool", () => {
+    it("summarizes 'summary' action with array data", () => {
+      const data = [{
+        totalRevenue: 1000,
+        totalOrders: 50,
+        avgOrderValue: 20
+      }];
+      const result = summarizeResult("analytics", "summary", data);
+      expect(result.total_revenue).toBe(1000);
+      expect(result.total_orders).toBe(50);
+      expect(result.rows).toBe(1);
+    });
+    it("summarizes 'summary' action with object data", () => {
+      const data = {
+        totalRevenue: 5000,
+        totalOrders: 100,
+        avgOrderValue: 50,
+        profitMargin: 0.3,
+        uniqueCustomers: 80
+      };
+      const result = summarizeResult("analytics", "summary", data);
+      expect(result.total_revenue).toBe(5000);
+      expect(result.unique_customers).toBe(80);
+    });
+    it("summarizes 'by_location' action", () => {
+      const data = [{
+        location: "NYC",
+        revenue: 500
+      }, {
+        location: "LA",
+        revenue: 300
+      }];
+      const result = summarizeResult("analytics", "by_location", data);
+      expect(result.locations).toBe(2);
+      expect(result.total_revenue).toBe(800);
+    });
+    it("summarizes 'detailed' action", () => {
+      const result = summarizeResult("analytics", "detailed", [1, 2, 3]);
+      expect(result.rows).toBe(3);
+    });
+    it("summarizes 'by_category' action", () => {
+      const data = {
+        categories: [{
+          name: "food"
+        }, {
+          name: "drinks"
+        }],
+        totalRevenue: 2000,
+        days: 30
+      };
+      const result = summarizeResult("analytics", "by_category", data);
+      expect(result.categories).toBe(2);
+      expect(result.total_revenue).toBe(2000);
+    });
+    it("summarizes 'product_sales' action", () => {
+      const data = {
+        products: [{
+          name: "A"
+        }],
+        totalRevenue: 100,
+        totalUnits: 10,
+        days: 7
+      };
+      const result = summarizeResult("analytics", "product_sales", data);
+      expect(result.products).toBe(1);
+    });
+    it("summarizes 'fraud' action", () => {
+      const data = {
+        totalOrders: 50,
+        highRisk: 3,
+        mediumRisk: 7,
+        avgRiskScore: 0.42
+      };
+      const result = summarizeResult("analytics", "fraud", data);
+      expect(result.total_orders).toBe(50);
+      expect(result.high_risk).toBe(3);
+    });
+    it("handles unknown analytics action", () => {
+      const result = summarizeResult("analytics", "unknown_action", [1, 2]);
+      expect(result.rows).toBe(2);
+    });
+  });
+  describe("other tools", () => {
+    it("summarizes inventory tool", () => {
+      const result = summarizeResult("inventory", "list", [{
+        id: 1
+      }, {
+        id: 2
+      }]);
+      expect(result.action).toBe("list");
+      expect(result.rows).toBe(2);
+    });
+    it("summarizes orders tool", () => {
+      const result = summarizeResult("orders", undefined, {
+        orders: [1, 2, 3]
+      });
+      expect(result.count).toBe(3);
+    });
+    it("summarizes customers tool", () => {
+      const result = summarizeResult("customers", undefined, {
+        customers: [1]
+      });
+      expect(result.count).toBe(1);
+    });
+    it("summarizes products with browse action", () => {
+      const data = {
+        data: {
+          categories: [1, 2],
+          product_status_summary: {
+            active: 5
+          }
+        }
+      };
+      const result = summarizeResult("products", "browse", data);
+      expect(result.categories).toBe(2);
+    });
+    it("summarizes audit_trail tool", () => {
+      const data = {
+        count: 100,
+        days: 30,
+        summary: {
+          create: 50,
+          update: 50
+        }
+      };
+      const result = summarizeResult("audit_trail", undefined, data);
+      expect(result.count).toBe(100);
+      expect(result.actions).toBe(2);
+    });
+    it("summarizes alerts tool", () => {
+      const result = summarizeResult("alerts", undefined, {
+        total: 5
+      });
+      expect(result.total).toBe(5);
+    });
+    it("handles unknown tool", () => {
+      const result = summarizeResult("unknown_tool", undefined, [1, 2, 3]);
+      expect(result.rows).toBe(3);
+    });
+    it("handles exceptions gracefully", () => {
+      // Pass null that will cause property access errors
+      const result = summarizeResult("analytics", "summary", null);
+      expect(result).toBeDefined();
+    });
+  });
+});

package/dist/server/lib/agent-loop-executor.d.ts

@@ -0,0 +1,7 @@
+import type { ToolExecutor } from "../../shared/tool-dispatch.js";
+import type { ToolDef, ServerAgentLoopOptions } from "./agent-loop-types.js";
+export declare function makeToolExecutor(opts: ServerAgentLoopOptions, tools: ToolDef[], allToolNames: string[], subagentTokens: {
+    input: number;
+    output: number;
+    costUsd: number;
+}, discoveredToolNames: Set<string>): ToolExecutor;

package/dist/server/lib/agent-loop-executor.js

@@ -0,0 +1,224 @@
+// agent-loop-executor.ts — Tool executor factory for the server agent loop.
+//
+// Creates a ToolExecutor closure that handles:
+//   - Subagent delegation (delegate_task)
+//   - Regular tool execution with progress callbacks
+//   - Dynamic tool discovery (discover_tools)
+
+import { MODELS } from "../../shared/constants.js";
+import { demoteSubagentModel, AGENT_DEFAULTS } from "../../shared/agent-core.js";
+import { queueSpan, auditRowToSpan } from "./clickhouse-buffer.js";
+import { runServerSubagent } from "./server-subagent.js";
+import { getFullToolSchemas } from "../tool-router.js";
+import { createLogger } from "./logger.js";
+const log = createLogger("agent-loop");
+
+// ============================================================================
+// TOOL EXECUTOR FACTORY — creates executor for dispatchTools with delegation
+// ============================================================================
+
+export function makeToolExecutor(opts, tools, allToolNames, subagentTokens, discoveredToolNames) {
+  const {
+    anthropic,
+    supabase,
+    storeId,
+    traceId,
+    userId,
+    userEmail,
+    conversationId,
+    agentId,
+    executeTool,
+    onToolResult,
+    onToolProgress,
+    onSubagentProgress,
+    clientDisconnected = {
+      value: false
+    },
+    startedAt = Date.now(),
+    maxDurationMs = 15 * 60 * 1000
+  } = opts;
+  return async (name, input) => {
+    allToolNames.push(name);
+
+    // Subagent delegation — demote models to control cost (sub-agents should never run Opus)
+    if (name === "delegate_task") {
+      const subPrompt = String(input.prompt || "");
+      const subModel = demoteSubagentModel(input.model ? String(input.model) : undefined);
+      const defaultSubMaxTurns = opts.subagentMaxTurns ?? AGENT_DEFAULTS.subagentMaxTurns;
+      const subMaxTurns = Math.min(Math.max(1, Number(input.max_turns) || defaultSubMaxTurns), 12);
+      const subTools = tools.filter(t => t.name !== "delegate_task");
+      const subId = `sub-${Date.now().toString(36)}`;
+      onSubagentProgress?.({
+        subagentId: subId,
+        event: "started",
+        model: subModel
+      });
+      const subStartTime = Date.now();
+      const subResult = await runServerSubagent({
+        anthropic,
+        supabase,
+        storeId,
+        prompt: subPrompt,
+        model: subModel,
+        maxTurns: subMaxTurns,
+        tools: subTools,
+        executeTool: async (toolName, args) => executeTool(toolName, args, "server_subagent"),
+        onProgress: onSubagentProgress,
+        clientDisconnected,
+        startedAt,
+        maxDurationMs,
+        maxOutputTokens: opts.subagentMaxTokens,
+        temperature: opts.subagentTemperature
+      });
+      onSubagentProgress?.({
+        subagentId: subId,
+        event: "done",
+        output: subResult.output
+      });
+
+      // Audit log
+      const subDurationMs = Date.now() - subStartTime;
+      const subModelId = subModel === "opus" ? MODELS.OPUS : subModel === "sonnet" ? MODELS.SONNET : MODELS.HAIKU;
+      try {
+        const subEndTime = Date.now();
+        queueSpan(auditRowToSpan({
+          action: "chat.subagent_complete",
+          severity: "info",
+          store_id: storeId || null,
+          resource_type: "chat_subagent",
+          resource_id: agentId || null,
+          request_id: traceId || null,
+          conversation_id: conversationId || null,
+          source: "server_subagent",
+          user_id: userId || null,
+          user_email: userEmail || null,
+          input_tokens: subResult.tokensUsed.input,
+          output_tokens: subResult.tokensUsed.output,
+          total_cost: subResult.costUsd,
+          model: subModelId,
+          duration_ms: subDurationMs,
+          trace_id: traceId || null,
+          span_kind: "INTERNAL",
+          service_name: "agent-server",
+          status_code: subResult.success ? "OK" : "ERROR",
+          start_time: new Date(subEndTime - subDurationMs).toISOString(),
+          end_time: new Date(subEndTime).toISOString(),
+          stop_reason: subResult.stopReason || undefined,
+          turn_number: subResult.turnCount || 1,
+          parent_conversation_id: conversationId || undefined,
+          details: {
+            subagent_model: subModel,
+            turn_count: subResult.turnCount,
+            tool_calls: subResult.toolsUsed.length,
+            tool_names: subResult.toolsUsed,
+            cost_usd: subResult.costUsd,
+            success: subResult.success,
+            prompt_preview: subPrompt.substring(0, 200),
+            "gen_ai.request.model": subModelId,
+            "gen_ai.usage.input_tokens": subResult.tokensUsed.input,
+            "gen_ai.usage.output_tokens": subResult.tokensUsed.output,
+            "gen_ai.usage.cache_read_tokens": subResult.tokensUsed.cacheRead || 0,
+            "gen_ai.usage.cache_creation_tokens": subResult.tokensUsed.cacheCreation || 0,
+            "gen_ai.usage.cost": subResult.costUsd
+          }
+        }));
+      } catch (err) {
+        log.error({
+          err: err.message
+        }, "failed to log subagent delegation audit");
+      }
+      subagentTokens.input += subResult.tokensUsed.input;
+      subagentTokens.output += subResult.tokensUsed.output;
+      subagentTokens.costUsd += subResult.costUsd;
+      allToolNames.push(...subResult.toolsUsed);
+      return {
+        success: subResult.success,
+        output: subResult.output
+      };
+    }
+
+    // Regular tool execution — pass onToolProgress for streaming tools (kali)
+    const result = await executeTool(name, input, undefined, onToolProgress);
+    onToolResult?.(name, result.success, result.success ? result.data : result.error);
+
+    // discover_tools: dynamically add discovered tools to the active set
+    if (name === "discover_tools" && result.success && result.data) {
+      const refreshRequested = !!input.refresh;
+      const discovered = result.data?.tools;
+
+      // If refresh requested, remove previously-discovered tools so they can be re-loaded
+      // with fresh schemas from DB. Core tools and delegate_task are never removed.
+      if (refreshRequested) {
+        const coreNames = new Set((opts.tools || []).map(t => t.name));
+        coreNames.add("delegate_task");
+        for (let i = tools.length - 1; i >= 0; i--) {
+          if (discoveredToolNames.has(tools[i].name) && !coreNames.has(tools[i].name)) {
+            tools.splice(i, 1);
+          }
+        }
+        discoveredToolNames.clear();
+        log.info("discover_tools refresh — cleared previously discovered tools");
+      }
+      if (Array.isArray(discovered)) {
+        // Use getFullToolSchemas as authoritative source — supplements handler response
+        // with any schemas the handler returned, ensuring we have complete definitions.
+        const discoveredNames = discovered.filter(t => t.name).map(t => t.name);
+        const fullSchemas = getFullToolSchemas(discoveredNames);
+        // Build a map for O(1) lookup: prefer full schemas from cache, fall back to handler data
+        const schemaMap = new Map();
+        for (const t of discovered) {
+          if (t.name && t.input_schema) {
+            schemaMap.set(t.name, {
+              name: t.name,
+              description: t.description || t.name,
+              input_schema: t.input_schema
+            });
+          }
+        }
+        for (const t of fullSchemas) {
+          schemaMap.set(t.name, t); // Full cache schemas override handler data (more complete)
+        }
+        const activated = [];
+        const alreadyActive = [];
+        for (const [toolName, toolDef] of schemaMap) {
+          // Track as discovered regardless of whether already active
+          discoveredToolNames.add(toolName);
+          if (!tools.some(existing => existing.name === toolName)) {
+            tools.push(toolDef);
+            activated.push(toolName);
+          } else if (refreshRequested) {
+            // Re-add after refresh cleared it, or update existing schema
+            tools.push(toolDef);
+            activated.push(toolName);
+          } else {
+            alreadyActive.push(toolName);
+          }
+        }
+        if (activated.length > 0) {
+          log.info({
+            activatedTools: activated,
+            refreshed: refreshRequested
+          }, "discover_tools activated");
+        }
+        // Return a cleaner message to the model
+        return {
+          success: true,
+          output: JSON.stringify({
+            activated,
+            already_active: alreadyActive,
+            refreshed: refreshRequested,
+            message: activated.length > 0 ? `Activated ${activated.length} tool(s): ${activated.join(", ")}. You can now use them.` : "Requested tools were already active.",
+            total_discovered: discoveredToolNames.size
+          })
+        };
+      }
+    }
+    return {
+      success: result.success,
+      output: JSON.stringify(result.success ? result.data : {
+        error: result.error
+      })
+    };
+  };
+}
+//# sourceMappingURL=agent-loop-executor.js.map

package/dist/server/lib/agent-loop-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop-executor.js","names":["MODELS","demoteSubagentModel","AGENT_DEFAULTS","queueSpan","auditRowToSpan","runServerSubagent","getFullToolSchemas","createLogger","log","makeToolExecutor","opts","tools","allToolNames","subagentTokens","discoveredToolNames","anthropic","supabase","storeId","traceId","userId","userEmail","conversationId","agentId","executeTool","onToolResult","onToolProgress","onSubagentProgress","clientDisconnected","value","startedAt","Date","now","maxDurationMs","name","input","push","subPrompt","String","prompt","subModel","model","undefined","defaultSubMaxTurns","subagentMaxTurns","subMaxTurns","Math","min","max","Number","max_turns","subTools","filter","t","subId","toString","subagentId","event","subStartTime","subResult","maxTurns","toolName","args","onProgress","maxOutputTokens","subagentMaxTokens","temperature","subagentTemperature","output","subDurationMs","subModelId","OPUS","SONNET","HAIKU","subEndTime","action","severity","store_id","resource_type","resource_id","request_id","conversation_id","source","user_id","user_email","input_tokens","tokensUsed","output_tokens","total_cost","costUsd","duration_ms","trace_id","span_kind","service_name","status_code","success","start_time","toISOString","end_time","stop_reason","stopReason","turn_number","turnCount","parent_conversation_id","details","subagent_model","turn_count","tool_calls","toolsUsed","length","tool_names","cost_usd","prompt_preview","substring","cacheRead","cacheCreation","err","error","message","result","data","refreshRequested","refresh","discovered","coreNames","Set","map","add","i","has","splice","clear","info","Array","isArray","discoveredNames","fullSchemas","schemaMap","Map","input_schema","set","description","activated","alreadyActive","toolDef","some","existing","activatedTools","refreshed","JSON","stringify","already_active","join","total_discovered","size"],"sources":["../../../src/server/lib/agent-loop-executor.ts"],"sourcesContent":["// agent-loop-executor.ts — Tool executor factory for the server agent loop.\n//\n// Creates a ToolExecutor closure that handles:\n//   - Subagent delegation (delegate_task)\n//   - Regular tool execution with progress callbacks\n//   - Dynamic tool discovery (discover_tools)\n\nimport type { ToolExecutor } from \"../../shared/tool-dispatch.js\";\nimport { MODELS } from \"../../shared/constants.js\";\nimport { demoteSubagentModel, AGENT_DEFAULTS } from \"../../shared/agent-core.js\";\nimport { queueSpan, auditRowToSpan } from \"./clickhouse-buffer.js\";\nimport { runServerSubagent } from \"./server-subagent.js\";\nimport { getFullToolSchemas } from \"../tool-router.js\";\nimport { createLogger } from \"./logger.js\";\n\nimport type { ToolDef, ServerAgentLoopOptions } from \"./agent-loop-types.js\";\n\nconst log = createLogger(\"agent-loop\");\n\n// ============================================================================\n// TOOL EXECUTOR FACTORY — creates executor for dispatchTools with delegation\n// ============================================================================\n\nexport function makeToolExecutor(\n  opts: ServerAgentLoopOptions,\n  tools: ToolDef[],\n  allToolNames: string[],\n  subagentTokens: { input: number; output: number; costUsd: number },\n  discoveredToolNames: Set<string>,\n): ToolExecutor {\n  const {\n    anthropic,\n    supabase,\n    storeId,\n    traceId,\n    userId,\n    userEmail,\n    conversationId,\n    agentId,\n    executeTool,\n    onToolResult,\n    onToolProgress,\n    onSubagentProgress,\n    clientDisconnected = { value: false },\n    startedAt = Date.now(),\n    maxDurationMs = 15 * 60 * 1000,\n  } = opts;\n\n  return async (name: string, input: Record<string, unknown>) => {\n    allToolNames.push(name);\n\n    // Subagent delegation — demote models to control cost (sub-agents should never run Opus)\n    if (name === \"delegate_task\") {\n      const subPrompt = String(input.prompt || \"\");\n      const subModel = demoteSubagentModel(input.model ? String(input.model) : undefined) as \"haiku\" | \"sonnet\" | \"opus\";\n      const defaultSubMaxTurns = opts.subagentMaxTurns ?? AGENT_DEFAULTS.subagentMaxTurns;\n      const subMaxTurns = Math.min(Math.max(1, Number(input.max_turns) || defaultSubMaxTurns), 12);\n      const subTools = tools.filter((t) => t.name !== \"delegate_task\");\n      const subId = `sub-${Date.now().toString(36)}`;\n\n      onSubagentProgress?.({ subagentId: subId, event: \"started\", model: subModel });\n\n      const subStartTime = Date.now();\n      const subResult = await runServerSubagent({\n        anthropic, supabase, storeId, prompt: subPrompt, model: subModel,\n        maxTurns: subMaxTurns, tools: subTools,\n        executeTool: async (toolName, args) => executeTool(toolName, args, \"server_subagent\"),\n        onProgress: onSubagentProgress, clientDisconnected, startedAt, maxDurationMs,\n        maxOutputTokens: opts.subagentMaxTokens,\n        temperature: opts.subagentTemperature,\n      });\n\n      onSubagentProgress?.({ subagentId: subId, event: \"done\", output: subResult.output });\n\n      // Audit log\n      const subDurationMs = Date.now() - subStartTime;\n      const subModelId = subModel === \"opus\" ? MODELS.OPUS\n        : subModel === \"sonnet\" ? MODELS.SONNET : MODELS.HAIKU;\n      try {\n        const subEndTime = Date.now();\n        queueSpan(auditRowToSpan({\n          action: \"chat.subagent_complete\", severity: \"info\",\n          store_id: storeId || null, resource_type: \"chat_subagent\",\n          resource_id: agentId || null, request_id: traceId || null,\n          conversation_id: conversationId || null, source: \"server_subagent\",\n          user_id: userId || null,\n          user_email: userEmail || null,\n          input_tokens: subResult.tokensUsed.input, output_tokens: subResult.tokensUsed.output,\n          total_cost: subResult.costUsd, model: subModelId, duration_ms: subDurationMs,\n          trace_id: traceId || null,\n          span_kind: \"INTERNAL\",\n          service_name: \"agent-server\",\n          status_code: subResult.success ? \"OK\" : \"ERROR\",\n          start_time: new Date(subEndTime - subDurationMs).toISOString(),\n          end_time: new Date(subEndTime).toISOString(),\n          stop_reason: subResult.stopReason || undefined,\n          turn_number: subResult.turnCount || 1,\n          parent_conversation_id: conversationId || undefined,\n          details: {\n            subagent_model: subModel, turn_count: subResult.turnCount,\n            tool_calls: subResult.toolsUsed.length, tool_names: subResult.toolsUsed,\n            cost_usd: subResult.costUsd, success: subResult.success,\n            prompt_preview: subPrompt.substring(0, 200),\n            \"gen_ai.request.model\": subModelId,\n            \"gen_ai.usage.input_tokens\": subResult.tokensUsed.input,\n            \"gen_ai.usage.output_tokens\": subResult.tokensUsed.output,\n            \"gen_ai.usage.cache_read_tokens\": subResult.tokensUsed.cacheRead || 0,\n            \"gen_ai.usage.cache_creation_tokens\": subResult.tokensUsed.cacheCreation || 0,\n            \"gen_ai.usage.cost\": subResult.costUsd,\n          },\n        }));\n      } catch (err) { log.error({ err: (err as Error).message }, \"failed to log subagent delegation audit\"); }\n\n      subagentTokens.input += subResult.tokensUsed.input;\n      subagentTokens.output += subResult.tokensUsed.output;\n      subagentTokens.costUsd += subResult.costUsd;\n      allToolNames.push(...subResult.toolsUsed);\n\n      return { success: subResult.success, output: subResult.output };\n    }\n\n    // Regular tool execution — pass onToolProgress for streaming tools (kali)\n    const result = await executeTool(name, input, undefined, onToolProgress);\n    onToolResult?.(name, result.success, result.success ? result.data : result.error);\n\n    // discover_tools: dynamically add discovered tools to the active set\n    if (name === \"discover_tools\" && result.success && result.data) {\n      const refreshRequested = !!(input as any).refresh;\n      const discovered = (result.data as any)?.tools;\n\n      // If refresh requested, remove previously-discovered tools so they can be re-loaded\n      // with fresh schemas from DB. Core tools and delegate_task are never removed.\n      if (refreshRequested) {\n        const coreNames = new Set((opts.tools || []).map(t => t.name));\n        coreNames.add(\"delegate_task\");\n        for (let i = tools.length - 1; i >= 0; i--) {\n          if (discoveredToolNames.has(tools[i].name) && !coreNames.has(tools[i].name)) {\n            tools.splice(i, 1);\n          }\n        }\n        discoveredToolNames.clear();\n        log.info(\"discover_tools refresh — cleared previously discovered tools\");\n      }\n\n      if (Array.isArray(discovered)) {\n        // Use getFullToolSchemas as authoritative source — supplements handler response\n        // with any schemas the handler returned, ensuring we have complete definitions.\n        const discoveredNames = discovered.filter((t: any) => t.name).map((t: any) => t.name as string);\n        const fullSchemas = getFullToolSchemas(discoveredNames);\n        // Build a map for O(1) lookup: prefer full schemas from cache, fall back to handler data\n        const schemaMap = new Map<string, ToolDef>();\n        for (const t of discovered) {\n          if (t.name && t.input_schema) {\n            schemaMap.set(t.name, { name: t.name, description: t.description || t.name, input_schema: t.input_schema });\n          }\n        }\n        for (const t of fullSchemas) {\n          schemaMap.set(t.name, t); // Full cache schemas override handler data (more complete)\n        }\n\n        const activated: string[] = [];\n        const alreadyActive: string[] = [];\n        for (const [toolName, toolDef] of schemaMap) {\n          // Track as discovered regardless of whether already active\n          discoveredToolNames.add(toolName);\n\n          if (!tools.some(existing => existing.name === toolName)) {\n            tools.push(toolDef);\n            activated.push(toolName);\n          } else if (refreshRequested) {\n            // Re-add after refresh cleared it, or update existing schema\n            tools.push(toolDef);\n            activated.push(toolName);\n          } else {\n            alreadyActive.push(toolName);\n          }\n        }\n        if (activated.length > 0) {\n          log.info({ activatedTools: activated, refreshed: refreshRequested }, \"discover_tools activated\");\n        }\n        // Return a cleaner message to the model\n        return {\n          success: true,\n          output: JSON.stringify({\n            activated,\n            already_active: alreadyActive,\n            refreshed: refreshRequested,\n            message: activated.length > 0\n              ? `Activated ${activated.length} tool(s): ${activated.join(\", \")}. You can now use them.`\n              : \"Requested tools were already active.\",\n            total_discovered: discoveredToolNames.size,\n          }),\n        };\n      }\n    }\n\n    return {\n      success: result.success,\n      output: JSON.stringify(result.success ? result.data : { error: result.error }),\n    };\n  };\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;;AAGA,SAASA,MAAM,QAAQ,2BAA2B;AAClD,SAASC,mBAAmB,EAAEC,cAAc,QAAQ,4BAA4B;AAChF,SAASC,SAAS,EAAEC,cAAc,QAAQ,wBAAwB;AAClE,SAASC,iBAAiB,QAAQ,sBAAsB;AACxD,SAASC,kBAAkB,QAAQ,mBAAmB;AACtD,SAASC,YAAY,QAAQ,aAAa;AAI1C,MAAMC,GAAG,GAAGD,YAAY,CAAC,YAAY,CAAC;;AAEtC;AACA;AACA;;AAEA,OAAO,SAASE,gBAAgBA,CAC9BC,IAA4B,EAC5BC,KAAgB,EAChBC,YAAsB,EACtBC,cAAkE,EAClEC,mBAAgC,EAClB;EACd,MAAM;IACJC,SAAS;IACTC,QAAQ;IACRC,OAAO;IACPC,OAAO;IACPC,MAAM;IACNC,SAAS;IACTC,cAAc;IACdC,OAAO;IACPC,WAAW;IACXC,YAAY;IACZC,cAAc;IACdC,kBAAkB;IAClBC,kBAAkB,GAAG;MAAEC,KAAK,EAAE;IAAM,CAAC;IACrCC,SAAS,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC;IACtBC,aAAa,GAAG,EAAE,GAAG,EAAE,GAAG;EAC5B,CAAC,GAAGtB,IAAI;EAER,OAAO,OAAOuB,IAAY,EAAEC,KAA8B,KAAK;IAC7DtB,YAAY,CAACuB,IAAI,CAACF,IAAI,CAAC;;IAEvB;IACA,IAAIA,IAAI,KAAK,eAAe,EAAE;MAC5B,MAAMG,SAAS,GAAGC,MAAM,CAACH,KAAK,CAACI,MAAM,IAAI,EAAE,CAAC;MAC5C,MAAMC,QAAQ,GAAGtC,mBAAmB,CAACiC,KAAK,CAACM,KAAK,GAAGH,MAAM,CAACH,KAAK,CAACM,KAAK,CAAC,GAAGC,SAAS,CAAgC;MAClH,MAAMC,kBAAkB,GAAGhC,IAAI,CAACiC,gBAAgB,IAAIzC,cAAc,CAACyC,gBAAgB;MACnF,MAAMC,WAAW,GAAGC,IAAI,CAACC,GAAG,CAACD,IAAI,CAACE,GAAG,CAAC,CAAC,EAAEC,MAAM,CAACd,KAAK,CAACe,SAAS,CAAC,IAAIP,kBAAkB,CAAC,EAAE,EAAE,CAAC;MAC5F,MAAMQ,QAAQ,GAAGvC,KAAK,CAACwC,MAAM,CAAEC,CAAC,IAAKA,CAAC,CAACnB,IAAI,KAAK,eAAe,CAAC;MAChE,MAAMoB,KAAK,GAAG,OAAOvB,IAAI,CAACC,GAAG,CAAC,CAAC,CAACuB,QAAQ,CAAC,EAAE,CAAC,EAAE;MAE9C5B,kBAAkB,GAAG;QAAE6B,UAAU,EAAEF,KAAK;QAAEG,KAAK,EAAE,SAAS;QAAEhB,KAAK,EAAED;MAAS,CAAC,CAAC;MAE9E,MAAMkB,YAAY,GAAG3B,IAAI,CAACC,GAAG,CAAC,CAAC;MAC/B,MAAM2B,SAAS,GAAG,MAAMrD,iBAAiB,CAAC;QACxCU,SAAS;QAAEC,QAAQ;QAAEC,OAAO;QAAEqB,MAAM,EAAEF,SAAS;QAAEI,KAAK,EAAED,QAAQ;QAChEoB,QAAQ,EAAEf,WAAW;QAAEjC,KAAK,EAAEuC,QAAQ;QACtC3B,WAAW,EAAE,MAAAA,CAAOqC,QAAQ,EAAEC,IAAI,KAAKtC,WAAW,CAACqC,QAAQ,EAAEC,IAAI,EAAE,iBAAiB,CAAC;QACrFC,UAAU,EAAEpC,kBAAkB;QAAEC,kBAAkB;QAAEE,SAAS;QAAEG,aAAa;QAC5E+B,eAAe,EAAErD,IAAI,CAACsD,iBAAiB;QACvCC,WAAW,EAAEvD,IAAI,CAACwD;MACpB,CAAC,CAAC;MAEFxC,kBAAkB,GAAG;QAAE6B,UAAU,EAAEF,KAAK;QAAEG,KAAK,EAAE,MAAM;QAAEW,MAAM,EAAET,SAAS,CAACS;MAAO,CAAC,CAAC;;MAEpF;MACA,MAAMC,aAAa,GAAGtC,IAAI,CAACC,GAAG,CAAC,CAAC,GAAG0B,YAAY;MAC/C,MAAMY,UAAU,GAAG9B,QAAQ,KAAK,MAAM,GAAGvC,MAAM,CAACsE,IAAI,GAChD/B,QAAQ,KAAK,QAAQ,GAAGvC,MAAM,CAACuE,MAAM,GAAGvE,MAAM,CAACwE,KAAK;MACxD,IAAI;QACF,MAAMC,UAAU,GAAG3C,IAAI,CAACC,GAAG,CAAC,CAAC;QAC7B5B,SAAS,CAACC,cAAc,CAAC;UACvBsE,MAAM,EAAE,wBAAwB;UAAEC,QAAQ,EAAE,MAAM;UAClDC,QAAQ,EAAE3D,OAAO,IAAI,IAAI;UAAE4D,aAAa,EAAE,eAAe;UACzDC,WAAW,EAAExD,OAAO,IAAI,IAAI;UAAEyD,UAAU,EAAE7D,OAAO,IAAI,IAAI;UACzD8D,eAAe,EAAE3D,cAAc,IAAI,IAAI;UAAE4D,MAAM,EAAE,iBAAiB;UAClEC,OAAO,EAAE/D,MAAM,IAAI,IAAI;UACvBgE,UAAU,EAAE/D,SAAS,IAAI,IAAI;UAC7BgE,YAAY,EAAE1B,SAAS,CAAC2B,UAAU,CAACnD,KAAK;UAAEoD,aAAa,EAAE5B,SAAS,CAAC2B,UAAU,CAAClB,MAAM;UACpFoB,UAAU,EAAE7B,SAAS,CAAC8B,OAAO;UAAEhD,KAAK,EAAE6B,UAAU;UAAEoB,WAAW,EAAErB,aAAa;UAC5EsB,QAAQ,EAAExE,OAAO,IAAI,IAAI;UACzByE,SAAS,EAAE,UAAU;UACrBC,YAAY,EAAE,cAAc;UAC5BC,WAAW,EAAEnC,SAAS,CAACoC,OAAO,GAAG,IAAI,GAAG,OAAO;UAC/CC,UAAU,EAAE,IAAIjE,IAAI,CAAC2C,UAAU,GAAGL,aAAa,CAAC,CAAC4B,WAAW,CAAC,CAAC;UAC9DC,QAAQ,EAAE,IAAInE,IAAI,CAAC2C,UAAU,CAAC,CAACuB,WAAW,CAAC,CAAC;UAC5CE,WAAW,EAAExC,SAAS,CAACyC,UAAU,IAAI1D,SAAS;UAC9C2D,WAAW,EAAE1C,SAAS,CAAC2C,SAAS,IAAI,CAAC;UACrCC,sBAAsB,EAAEjF,cAAc,IAAIoB,SAAS;UACnD8D,OAAO,EAAE;YACPC,cAAc,EAAEjE,QAAQ;YAAEkE,UAAU,EAAE/C,SAAS,CAAC2C,SAAS;YACzDK,UAAU,EAAEhD,SAAS,CAACiD,SAAS,CAACC,MAAM;YAAEC,UAAU,EAAEnD,SAAS,CAACiD,SAAS;YACvEG,QAAQ,EAAEpD,SAAS,CAAC8B,OAAO;YAAEM,OAAO,EAAEpC,SAAS,CAACoC,OAAO;YACvDiB,cAAc,EAAE3E,SAAS,CAAC4E,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC;YAC3C,sBAAsB,EAAE3C,UAAU;YAClC,2BAA2B,EAAEX,SAAS,CAAC2B,UAAU,CAACnD,KAAK;YACvD,4BAA4B,EAAEwB,SAAS,CAAC2B,UAAU,CAAClB,MAAM;YACzD,gCAAgC,EAAET,SAAS,CAAC2B,UAAU,CAAC4B,SAAS,IAAI,CAAC;YACrE,oCAAoC,EAAEvD,SAAS,CAAC2B,UAAU,CAAC6B,aAAa,IAAI,CAAC;YAC7E,mBAAmB,EAAExD,SAAS,CAAC8B;UACjC;QACF,CAAC,CAAC,CAAC;MACL,CAAC,CAAC,OAAO2B,GAAG,EAAE;QAAE3G,GAAG,CAAC4G,KAAK,CAAC;UAAED,GAAG,EAAGA,GAAG,CAAWE;QAAQ,CAAC,EAAE,yCAAyC,CAAC;MAAE;MAEvGxG,cAAc,CAACqB,KAAK,IAAIwB,SAAS,CAAC2B,UAAU,CAACnD,KAAK;MAClDrB,cAAc,CAACsD,MAAM,IAAIT,SAAS,CAAC2B,UAAU,CAAClB,MAAM;MACpDtD,cAAc,CAAC2E,OAAO,IAAI9B,SAAS,CAAC8B,OAAO;MAC3C5E,YAAY,CAACuB,IAAI,CAAC,GAAGuB,SAAS,CAACiD,SAAS,CAAC;MAEzC,OAAO;QAAEb,OAAO,EAAEpC,SAAS,CAACoC,OAAO;QAAE3B,MAAM,EAAET,SAAS,CAACS;MAAO,CAAC;IACjE;;IAEA;IACA,MAAMmD,MAAM,GAAG,MAAM/F,WAAW,CAACU,IAAI,EAAEC,KAAK,EAAEO,SAAS,EAAEhB,cAAc,CAAC;IACxED,YAAY,GAAGS,IAAI,EAAEqF,MAAM,CAACxB,OAAO,EAAEwB,MAAM,CAACxB,OAAO,GAAGwB,MAAM,CAACC,IAAI,GAAGD,MAAM,CAACF,KAAK,CAAC;;IAEjF;IACA,IAAInF,IAAI,KAAK,gBAAgB,IAAIqF,MAAM,CAACxB,OAAO,IAAIwB,MAAM,CAACC,IAAI,EAAE;MAC9D,MAAMC,gBAAgB,GAAG,CAAC,CAAEtF,KAAK,CAASuF,OAAO;MACjD,MAAMC,UAAU,GAAIJ,MAAM,CAACC,IAAI,EAAU5G,KAAK;;MAE9C;MACA;MACA,IAAI6G,gBAAgB,EAAE;QACpB,MAAMG,SAAS,GAAG,IAAIC,GAAG,CAAC,CAAClH,IAAI,CAACC,KAAK,IAAI,EAAE,EAAEkH,GAAG,CAACzE,CAAC,IAAIA,CAAC,CAACnB,IAAI,CAAC,CAAC;QAC9D0F,SAAS,CAACG,GAAG,CAAC,eAAe,CAAC;QAC9B,KAAK,IAAIC,CAAC,GAAGpH,KAAK,CAACiG,MAAM,GAAG,CAAC,EAAEmB,CAAC,IAAI,CAAC,EAAEA,CAAC,EAAE,EAAE;UAC1C,IAAIjH,mBAAmB,CAACkH,GAAG,CAACrH,KAAK,CAACoH,CAAC,CAAC,CAAC9F,IAAI,CAAC,IAAI,CAAC0F,SAAS,CAACK,GAAG,CAACrH,KAAK,CAACoH,CAAC,CAAC,CAAC9F,IAAI,CAAC,EAAE;YAC3EtB,KAAK,CAACsH,MAAM,CAACF,CAAC,EAAE,CAAC,CAAC;UACpB;QACF;QACAjH,mBAAmB,CAACoH,KAAK,CAAC,CAAC;QAC3B1H,GAAG,CAAC2H,IAAI,CAAC,8DAA8D,CAAC;MAC1E;MAEA,IAAIC,KAAK,CAACC,OAAO,CAACX,UAAU,CAAC,EAAE;QAC7B;QACA;QACA,MAAMY,eAAe,GAAGZ,UAAU,CAACvE,MAAM,CAAEC,CAAM,IAAKA,CAAC,CAACnB,IAAI,CAAC,CAAC4F,GAAG,CAAEzE,CAAM,IAAKA,CAAC,CAACnB,IAAc,CAAC;QAC/F,MAAMsG,WAAW,GAAGjI,kBAAkB,CAACgI,eAAe,CAAC;QACvD;QACA,MAAME,SAAS,GAAG,IAAIC,GAAG,CAAkB,CAAC;QAC5C,KAAK,MAAMrF,CAAC,IAAIsE,UAAU,EAAE;UAC1B,IAAItE,CAAC,CAACnB,IAAI,IAAImB,CAAC,CAACsF,YAAY,EAAE;YAC5BF,SAAS,CAACG,GAAG,CAACvF,CAAC,CAACnB,IAAI,EAAE;cAAEA,IAAI,EAAEmB,CAAC,CAACnB,IAAI;cAAE2G,WAAW,EAAExF,CAAC,CAACwF,WAAW,IAAIxF,CAAC,CAACnB,IAAI;cAAEyG,YAAY,EAAEtF,CAAC,CAACsF;YAAa,CAAC,CAAC;UAC7G;QACF;QACA,KAAK,MAAMtF,CAAC,IAAImF,WAAW,EAAE;UAC3BC,SAAS,CAACG,GAAG,CAACvF,CAAC,CAACnB,IAAI,EAAEmB,CAAC,CAAC,CAAC,CAAC;QAC5B;QAEA,MAAMyF,SAAmB,GAAG,EAAE;QAC9B,MAAMC,aAAuB,GAAG,EAAE;QAClC,KAAK,MAAM,CAAClF,QAAQ,EAAEmF,OAAO,CAAC,IAAIP,SAAS,EAAE;UAC3C;UACA1H,mBAAmB,CAACgH,GAAG,CAAClE,QAAQ,CAAC;UAEjC,IAAI,CAACjD,KAAK,CAACqI,IAAI,CAACC,QAAQ,IAAIA,QAAQ,CAAChH,IAAI,KAAK2B,QAAQ,CAAC,EAAE;YACvDjD,KAAK,CAACwB,IAAI,CAAC4G,OAAO,CAAC;YACnBF,SAAS,CAAC1G,IAAI,CAACyB,QAAQ,CAAC;UAC1B,CAAC,MAAM,IAAI4D,gBAAgB,EAAE;YAC3B;YACA7G,KAAK,CAACwB,IAAI,CAAC4G,OAAO,CAAC;YACnBF,SAAS,CAAC1G,IAAI,CAACyB,QAAQ,CAAC;UAC1B,CAAC,MAAM;YACLkF,aAAa,CAAC3G,IAAI,CAACyB,QAAQ,CAAC;UAC9B;QACF;QACA,IAAIiF,SAAS,CAACjC,MAAM,GAAG,CAAC,EAAE;UACxBpG,GAAG,CAAC2H,IAAI,CAAC;YAAEe,cAAc,EAAEL,SAAS;YAAEM,SAAS,EAAE3B;UAAiB,CAAC,EAAE,0BAA0B,CAAC;QAClG;QACA;QACA,OAAO;UACL1B,OAAO,EAAE,IAAI;UACb3B,MAAM,EAAEiF,IAAI,CAACC,SAAS,CAAC;YACrBR,SAAS;YACTS,cAAc,EAAER,aAAa;YAC7BK,SAAS,EAAE3B,gBAAgB;YAC3BH,OAAO,EAAEwB,SAAS,CAACjC,MAAM,GAAG,CAAC,GACzB,aAAaiC,SAAS,CAACjC,MAAM,aAAaiC,SAAS,CAACU,IAAI,CAAC,IAAI,CAAC,yBAAyB,GACvF,sCAAsC;YAC1CC,gBAAgB,EAAE1I,mBAAmB,CAAC2I;UACxC,CAAC;QACH,CAAC;MACH;IACF;IAEA,OAAO;MACL3D,OAAO,EAAEwB,MAAM,CAACxB,OAAO;MACvB3B,MAAM,EAAEiF,IAAI,CAACC,SAAS,CAAC/B,MAAM,CAACxB,OAAO,GAAGwB,MAAM,CAACC,IAAI,GAAG;QAAEH,KAAK,EAAEE,MAAM,CAACF;MAAM,CAAC;IAC/E,CAAC;EACH,CAAC;AACH","ignoreList":[]}