whale-code 6.5.6 → 6.5.7

package/dist/server/tool-router-discovery.js

@@ -0,0 +1,218 @@
+/**
+ * Tool Router — tool registry loading, discover_tools handler, and caching.
+ */
+
+import { sanitizeToolDescription } from "./lib/prompt-sanitizer.js";
+import { TOOL_CATEGORIES } from "./tool-router-types.js";
+
+// ============================================================================
+// DESCRIPTION TRUNCATION
+// ============================================================================
+
+/** Truncate a description to maxLen characters, ending at a word boundary with ellipsis. */
+export function truncateDescription(desc, maxLen = 150) {
+  if (desc.length <= maxLen) return desc;
+  const cut = desc.lastIndexOf(" ", maxLen - 3);
+  return desc.substring(0, cut > 0 ? cut : maxLen - 3) + "...";
+}
+
+// ============================================================================
+// TOOL REGISTRY (loaded from database)
+// ============================================================================
+
+let cachedResult = null;
+let cacheTime = 0;
+
+/** Pre-computed API-ready tool defs keyed by name. */
+let cachedApiToolDefs = null;
+
+/**
+ * Load tools from ai_tool_registry, split into core (auto_load=true) and extended.
+ */
+export async function loadTools(supabase, forceRefresh = false) {
+  if (!forceRefresh && cachedResult && Date.now() - cacheTime < 60_000) return cachedResult;
+  const {
+    data,
+    error
+  } = await supabase.from("ai_tool_registry").select("name, description, definition, auto_load").eq("is_active", true).neq("tool_mode", "code");
+  if (error || !data) {
+    return cachedResult || {
+      core: [],
+      extended: [],
+      all: []
+    };
+  }
+  const allTools = data.map(t => ({
+    name: t.name,
+    description: sanitizeToolDescription(truncateDescription(t.description || t.definition?.description || t.name)),
+    input_schema: t.definition?.input_schema || {
+      type: "object",
+      properties: {}
+    }
+  }));
+  const core = [];
+  const extended = [];
+  const migrationApplied = data.some(t => t.auto_load === true || t.auto_load === false);
+  if (!migrationApplied) {
+    core.push(...allTools);
+  } else {
+    for (let i = 0; i < data.length; i++) {
+      if (data[i].auto_load) core.push(allTools[i]);else extended.push(allTools[i]);
+    }
+  }
+
+  // Always inject discover_tools into core set
+  if (!core.some(t => t.name === "discover_tools")) {
+    core.push(DISCOVER_TOOLS_DEF);
+  }
+
+  // Pre-compute API-ready tool defs
+  cachedApiToolDefs = new Map();
+  for (const t of [...core, ...extended]) {
+    cachedApiToolDefs.set(t.name, {
+      name: t.name,
+      description: t.description,
+      input_schema: t.input_schema
+    });
+  }
+  cachedResult = {
+    core,
+    extended,
+    all: allTools
+  };
+  cacheTime = Date.now();
+  return cachedResult;
+}
+
+/**
+ * Get pre-computed API-ready tool definitions.
+ */
+export function getCachedToolDefs(tools) {
+  if (cachedApiToolDefs) {
+    const result = [];
+    for (const t of tools) {
+      const cached = cachedApiToolDefs.get(t.name);
+      if (cached) result.push(cached);else result.push({
+        name: t.name,
+        description: truncateDescription(t.description),
+        input_schema: t.input_schema
+      });
+    }
+    return result;
+  }
+  return tools.map(t => ({
+    name: t.name,
+    description: truncateDescription(t.description),
+    input_schema: t.input_schema
+  }));
+}
+
+// ============================================================================
+// DISCOVER_TOOLS META-TOOL
+// ============================================================================
+
+/** discover_tools meta-tool definition */
+export const DISCOVER_TOOLS_DEF = {
+  name: "discover_tools",
+  description: "Load full schemas for extended tools not in your core set. Call this before using a tool that is listed under 'Extended Tools' in your system prompt. You can load tools by name or by category.",
+  input_schema: {
+    type: "object",
+    properties: {
+      names: {
+        type: "array",
+        items: {
+          type: "string"
+        },
+        description: "Specific tool names to load (e.g. ['kali', 'browser', 'voice'])"
+      },
+      category: {
+        type: "string",
+        description: "Load all tools in this category (e.g. 'security', 'media', 'operations')"
+      },
+      refresh: {
+        type: "boolean",
+        description: "Force reload tool definitions from DB (bust cache). Use when tools may have been updated mid-conversation."
+      }
+    }
+  }
+};
+
+// ============================================================================
+// EXTENDED TOOLS CACHE
+// ============================================================================
+
+let _extendedToolsCache = [];
+let _extendedToolsIndex = [];
+export function setExtendedToolsCache(tools) {
+  _extendedToolsCache = tools;
+  _extendedToolsIndex = tools.map(t => ({
+    name: t.name,
+    description: t.description.split(".")[0]
+  }));
+}
+export function getExtendedToolsCache() {
+  return _extendedToolsCache;
+}
+export function getExtendedToolsIndex() {
+  return _extendedToolsIndex;
+}
+export function getFullToolSchemas(toolNames) {
+  if (!toolNames.length || !_extendedToolsCache.length) return [];
+  const nameSet = new Set(toolNames);
+  return _extendedToolsCache.filter(t => nameSet.has(t.name));
+}
+
+// ============================================================================
+// DISCOVER_TOOLS HANDLER
+// ============================================================================
+
+export async function handleDiscoverTools(sb, args) {
+  const names = args.names;
+  const category = args.category;
+  const refresh = args.refresh;
+  if (refresh) {
+    try {
+      const freshResult = await loadTools(sb, true);
+      setExtendedToolsCache(freshResult.extended);
+    } catch {/* continue with stale cache */}
+  }
+  if (!names?.length && !category) {
+    return {
+      success: false,
+      error: "Provide 'names' (array of tool names) or 'category' to discover tools."
+    };
+  }
+  let matching = [];
+  if (names?.length) {
+    const nameSet = new Set(names);
+    matching = _extendedToolsCache.filter(t => nameSet.has(t.name));
+  }
+  if (category) {
+    const cat = category.toLowerCase();
+    const categoryTools = _extendedToolsCache.filter(t => TOOL_CATEGORIES[t.name] === cat);
+    const existingNames = new Set(matching.map(t => t.name));
+    for (const t of categoryTools) {
+      if (!existingNames.has(t.name)) matching.push(t);
+    }
+  }
+  if (matching.length === 0) {
+    const available = _extendedToolsCache.map(t => t.name).join(", ");
+    return {
+      success: false,
+      error: `No matching extended tools found. Available: ${available}`
+    };
+  }
+  return {
+    success: true,
+    data: {
+      tools: matching.map(t => ({
+        name: t.name,
+        description: t.description,
+        input_schema: t.input_schema
+      })),
+      count: matching.length,
+      refreshed: !!refresh
+    }
+  };
+}
+//# sourceMappingURL=tool-router-discovery.js.map

package/dist/server/tool-router-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-router-discovery.js","names":["sanitizeToolDescription","TOOL_CATEGORIES","truncateDescription","desc","maxLen","length","cut","lastIndexOf","substring","cachedResult","cacheTime","cachedApiToolDefs","loadTools","supabase","forceRefresh","Date","now","data","error","from","select","eq","neq","core","extended","all","allTools","map","t","name","description","definition","input_schema","type","properties","migrationApplied","some","auto_load","push","i","DISCOVER_TOOLS_DEF","Map","set","getCachedToolDefs","tools","result","cached","get","names","items","category","refresh","_extendedToolsCache","_extendedToolsIndex","setExtendedToolsCache","split","getExtendedToolsCache","getExtendedToolsIndex","getFullToolSchemas","toolNames","nameSet","Set","filter","has","handleDiscoverTools","sb","args","freshResult","success","matching","cat","toLowerCase","categoryTools","existingNames","available","join","count","refreshed"],"sources":["../../src/server/tool-router-discovery.ts"],"sourcesContent":["/**\n * Tool Router — tool registry loading, discover_tools handler, and caching.\n */\n\nimport type { SupabaseClient } from \"@supabase/supabase-js\";\nimport { sanitizeToolDescription } from \"./lib/prompt-sanitizer.js\";\nimport { type ToolDef, type ToolLoadResult, TOOL_CATEGORIES } from \"./tool-router-types.js\";\n\n// ============================================================================\n// DESCRIPTION TRUNCATION\n// ============================================================================\n\n/** Truncate a description to maxLen characters, ending at a word boundary with ellipsis. */\nexport function truncateDescription(desc: string, maxLen = 150): string {\n  if (desc.length <= maxLen) return desc;\n  const cut = desc.lastIndexOf(\" \", maxLen - 3);\n  return desc.substring(0, cut > 0 ? cut : maxLen - 3) + \"...\";\n}\n\n// ============================================================================\n// TOOL REGISTRY (loaded from database)\n// ============================================================================\n\nlet cachedResult: ToolLoadResult | null = null;\nlet cacheTime = 0;\n\n/** Pre-computed API-ready tool defs keyed by name. */\nlet cachedApiToolDefs: Map<string, { name: string; description: string; input_schema: Record<string, unknown> }> | null = null;\n\n/**\n * Load tools from ai_tool_registry, split into core (auto_load=true) and extended.\n */\nexport async function loadTools(supabase: SupabaseClient, forceRefresh = false): Promise<ToolLoadResult> {\n  if (!forceRefresh && cachedResult && Date.now() - cacheTime < 60_000) return cachedResult;\n\n  const { data, error } = await supabase\n    .from(\"ai_tool_registry\")\n    .select(\"name, description, definition, auto_load\")\n    .eq(\"is_active\", true)\n    .neq(\"tool_mode\", \"code\");\n\n  if (error || !data) {\n    return cachedResult || { core: [], extended: [], all: [] };\n  }\n\n  const allTools: ToolDef[] = data.map((t: any) => ({\n    name: t.name,\n    description: sanitizeToolDescription(\n      truncateDescription(t.description || t.definition?.description || t.name),\n    ),\n    input_schema: t.definition?.input_schema || { type: \"object\", properties: {} },\n  }));\n\n  const core: ToolDef[] = [];\n  const extended: ToolDef[] = [];\n\n  const migrationApplied = data.some((t: any) => t.auto_load === true || t.auto_load === false);\n\n  if (!migrationApplied) {\n    core.push(...allTools);\n  } else {\n    for (let i = 0; i < data.length; i++) {\n      if (data[i].auto_load) core.push(allTools[i]);\n      else extended.push(allTools[i]);\n    }\n  }\n\n  // Always inject discover_tools into core set\n  if (!core.some(t => t.name === \"discover_tools\")) {\n    core.push(DISCOVER_TOOLS_DEF);\n  }\n\n  // Pre-compute API-ready tool defs\n  cachedApiToolDefs = new Map();\n  for (const t of [...core, ...extended]) {\n    cachedApiToolDefs.set(t.name, { name: t.name, description: t.description, input_schema: t.input_schema });\n  }\n\n  cachedResult = { core, extended, all: allTools };\n  cacheTime = Date.now();\n  return cachedResult;\n}\n\n/**\n * Get pre-computed API-ready tool definitions.\n */\nexport function getCachedToolDefs(\n  tools: ToolDef[],\n): Array<{ name: string; description: string; input_schema: Record<string, unknown> }> {\n  if (cachedApiToolDefs) {\n    const result: Array<{ name: string; description: string; input_schema: Record<string, unknown> }> = [];\n    for (const t of tools) {\n      const cached = cachedApiToolDefs.get(t.name);\n      if (cached) result.push(cached);\n      else result.push({ name: t.name, description: truncateDescription(t.description), input_schema: t.input_schema });\n    }\n    return result;\n  }\n  return tools.map((t) => ({ name: t.name, description: truncateDescription(t.description), input_schema: t.input_schema }));\n}\n\n// ============================================================================\n// DISCOVER_TOOLS META-TOOL\n// ============================================================================\n\n/** discover_tools meta-tool definition */\nexport const DISCOVER_TOOLS_DEF: ToolDef = {\n  name: \"discover_tools\",\n  description: \"Load full schemas for extended tools not in your core set. Call this before using a tool that is listed under 'Extended Tools' in your system prompt. You can load tools by name or by category.\",\n  input_schema: {\n    type: \"object\",\n    properties: {\n      names: { type: \"array\", items: { type: \"string\" }, description: \"Specific tool names to load (e.g. ['kali', 'browser', 'voice'])\" },\n      category: { type: \"string\", description: \"Load all tools in this category (e.g. 'security', 'media', 'operations')\" },\n      refresh: { type: \"boolean\", description: \"Force reload tool definitions from DB (bust cache). Use when tools may have been updated mid-conversation.\" },\n    },\n  },\n};\n\n// ============================================================================\n// EXTENDED TOOLS CACHE\n// ============================================================================\n\nlet _extendedToolsCache: ToolDef[] = [];\nlet _extendedToolsIndex: Array<{ name: string; description: string }> = [];\n\nexport function setExtendedToolsCache(tools: ToolDef[]): void {\n  _extendedToolsCache = tools;\n  _extendedToolsIndex = tools.map(t => ({ name: t.name, description: t.description.split(\".\")[0] }));\n}\n\nexport function getExtendedToolsCache(): ToolDef[] {\n  return _extendedToolsCache;\n}\n\nexport function getExtendedToolsIndex(): Array<{ name: string; description: string }> {\n  return _extendedToolsIndex;\n}\n\nexport function getFullToolSchemas(toolNames: string[]): ToolDef[] {\n  if (!toolNames.length || !_extendedToolsCache.length) return [];\n  const nameSet = new Set(toolNames);\n  return _extendedToolsCache.filter(t => nameSet.has(t.name));\n}\n\n// ============================================================================\n// DISCOVER_TOOLS HANDLER\n// ============================================================================\n\nexport async function handleDiscoverTools(\n  sb: SupabaseClient,\n  args: Record<string, unknown>,\n): Promise<{ success: boolean; data?: unknown; error?: string }> {\n  const names = args.names as string[] | undefined;\n  const category = args.category as string | undefined;\n  const refresh = args.refresh as boolean | undefined;\n\n  if (refresh) {\n    try {\n      const freshResult = await loadTools(sb, true);\n      setExtendedToolsCache(freshResult.extended);\n    } catch { /* continue with stale cache */ }\n  }\n\n  if (!names?.length && !category) {\n    return { success: false, error: \"Provide 'names' (array of tool names) or 'category' to discover tools.\" };\n  }\n\n  let matching: ToolDef[] = [];\n\n  if (names?.length) {\n    const nameSet = new Set(names);\n    matching = _extendedToolsCache.filter(t => nameSet.has(t.name));\n  }\n\n  if (category) {\n    const cat = category.toLowerCase();\n    const categoryTools = _extendedToolsCache.filter(t => TOOL_CATEGORIES[t.name] === cat);\n    const existingNames = new Set(matching.map(t => t.name));\n    for (const t of categoryTools) {\n      if (!existingNames.has(t.name)) matching.push(t);\n    }\n  }\n\n  if (matching.length === 0) {\n    const available = _extendedToolsCache.map(t => t.name).join(\", \");\n    return { success: false, error: `No matching extended tools found. Available: ${available}` };\n  }\n\n  return {\n    success: true,\n    data: {\n      tools: matching.map(t => ({ name: t.name, description: t.description, input_schema: t.input_schema })),\n      count: matching.length,\n      refreshed: !!refresh,\n    },\n  };\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,91 @@
+/**
+ * Tool Router — types, metrics, and tool handler registry.
+ */
+import type { SupabaseClient } from "@supabase/supabase-js";
+export interface ToolDef {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+export interface UserToolRow {
+    id: string;
+    name: string;
+    display_name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+    execution_type: "rpc" | "http" | "sql";
+    is_read_only: boolean;
+    requires_approval: boolean;
+    http_config: Record<string, unknown> | null;
+    rpc_function: string | null;
+    sql_template: string | null;
+    allowed_tables: string[] | null;
+    max_execution_time_ms: number;
+}
+export interface AgentConfig {
+    id: string;
+    name: string;
+    description: string;
+    system_prompt: string;
+    model: string;
+    max_tokens: number;
+    max_tool_calls: number;
+    temperature: number;
+    enabled_tools: string[];
+    can_query: boolean;
+    can_send: boolean;
+    can_modify: boolean;
+    tone: string;
+    verbosity: string;
+    api_key: string | null;
+    store_id: string | null;
+    context_config: {
+        includeLocations?: boolean;
+        locationIds?: string[];
+        includeCustomers?: boolean;
+        customerSegments?: string[];
+        max_history_chars?: number;
+        max_tool_result_chars?: number;
+        max_message_chars?: number;
+        compaction_trigger_tokens?: number;
+        compaction_total_budget?: number;
+        clear_thinking_keep?: number;
+        clear_tool_uses_trigger?: number;
+        clear_tool_uses_keep?: number;
+        session_cost_budget_usd?: number;
+        max_concurrent_tools?: number;
+        enable_delegation?: boolean;
+        max_duration_ms?: number;
+        enable_model_routing?: boolean;
+        subagent_max_tokens?: number;
+        subagent_max_turns?: number;
+        subagent_temperature?: number;
+    } | null;
+}
+export interface ToolLoadResult {
+    core: ToolDef[];
+    extended: ToolDef[];
+    all: ToolDef[];
+}
+export type ToolProgressCallback = (toolName: string, progress: unknown) => void;
+export type ToolHandler = (sb: SupabaseClient, args: Record<string, unknown>, storeId?: string, onToolProgress?: (progress: unknown) => void) => Promise<{
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}>;
+export interface ToolHandlerEntry {
+    handler: ToolHandler;
+    timeout: number;
+    requiresStore: boolean;
+    supportsProgress?: boolean;
+}
+export declare function getToolMetrics(): Record<string, {
+    invocations: number;
+    errors: number;
+    avgMs: number;
+    lastMs: number;
+}>;
+export declare function recordToolMetric(toolName: string, durationMs: number, success: boolean): void;
+export declare const DEFAULT_TIMEOUT = 30000;
+export declare function buildToolHandlers(handleDiscoverTools: ToolHandler): Record<string, ToolHandlerEntry>;
+export declare const TOOL_CATEGORIES: Record<string, string>;

package/dist/server/tool-router-types.js

@@ -0,0 +1,336 @@
+/**
+ * Tool Router — types, metrics, and tool handler registry.
+ */
+
+import { handleInventory, handleInventoryQuery, handleInventoryAudit } from "./handlers/inventory.js";
+import { handlePurchaseOrders, handleTransfers } from "./handlers/supply-chain.js";
+import { handleProducts, handleCollections } from "./handlers/catalog.js";
+import { handleCustomers, handleOrders } from "./handlers/crm.js";
+import { handleAnalytics } from "./handlers/analytics.js";
+import { handleLocations, handleSuppliers, handleAlerts, handleAuditTrail, handleStore } from "./handlers/operations.js";
+import { handleEmail, handleDocuments } from "./handlers/comms.js";
+import { handleWebSearch, handleTelemetry } from "./handlers/platform.js";
+import { handleBrowser } from "./handlers/browser.js";
+import { handleDiscovery } from "./handlers/discovery.js";
+import { handleVoice } from "./handlers/voice.js";
+import { handleWorkflows } from "./handlers/workflows.js";
+import { handleEmbeddings } from "./handlers/embeddings.js";
+import { handleLLM } from "./handlers/llm-providers.js";
+import { handleImageGen } from "./handlers/image-gen.js";
+import { handleRemoveBg } from "./handlers/remove-bg.js";
+import { handleMedia } from "./handlers/media.js";
+import { handleVideoGen } from "./handlers/video-gen.js";
+import { handleAPIKeys } from "./handlers/api-keys.js";
+import { handleCreations } from "./handlers/creations.js";
+import { handleMetaAds } from "./handlers/meta-ads.js";
+import { handleKali } from "./handlers/kali.js";
+import { handleLocalAgent } from "./handlers/local-agent.js";
+import { handleEnrichment } from "./handlers/enrichment.js";
+import { handleStorefront } from "./handlers/storefront.js";
+import { handleApiDocs } from "./handlers/api-docs.js";
+import { handleClickHouse } from "./handlers/clickhouse.js";
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+// ============================================================================
+// IN-MEMORY EXECUTION METRICS
+// ============================================================================
+
+const toolMetrics = new Map();
+export function getToolMetrics() {
+  const result = {};
+  for (const [name, m] of toolMetrics) {
+    result[name] = {
+      invocations: m.invocations,
+      errors: m.errors,
+      avgMs: m.invocations > 0 ? Math.round(m.totalMs / m.invocations) : 0,
+      lastMs: m.lastMs
+    };
+  }
+  return result;
+}
+export function recordToolMetric(toolName, durationMs, success) {
+  let m = toolMetrics.get(toolName);
+  if (!m) {
+    m = {
+      invocations: 0,
+      errors: 0,
+      totalMs: 0,
+      lastMs: 0
+    };
+    toolMetrics.set(toolName, m);
+  }
+  m.invocations++;
+  m.totalMs += durationMs;
+  m.lastMs = durationMs;
+  if (!success) m.errors++;
+}
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+export const DEFAULT_TIMEOUT = 30_000;
+
+// ============================================================================
+// UNIFIED HANDLER REGISTRY — forward declaration for discover_tools handler
+// ============================================================================
+
+// This is populated by tool-router.ts after handleDiscoverTools is defined there
+// We declare the type and a factory function here
+
+export function buildToolHandlers(handleDiscoverTools) {
+  const handlers = {
+    // --- Business Data ---
+    inventory: {
+      handler: (sb, args, sid) => {
+        const a = args.action || "";
+        if (a.startsWith("audit_")) return handleInventoryAudit(sb, {
+          ...args,
+          action: a.slice(6)
+        }, sid);
+        if (["summary", "velocity", "by_location", "in_stock", "out_of_stock", "by_category"].includes(a)) return handleInventoryQuery(sb, args, sid);
+        return handleInventory(sb, args, sid);
+      },
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    purchase_orders: {
+      handler: handlePurchaseOrders,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    transfers: {
+      handler: handleTransfers,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    products: {
+      handler: handleProducts,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    collections: {
+      handler: handleCollections,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    customers: {
+      handler: handleCustomers,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    orders: {
+      handler: handleOrders,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    analytics: {
+      handler: handleAnalytics,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    locations: {
+      handler: handleLocations,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    suppliers: {
+      handler: handleSuppliers,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    store: {
+      handler: handleStore,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    storefront: {
+      handler: handleStorefront,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    // --- Communication ---
+    email: {
+      handler: handleEmail,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    documents: {
+      handler: handleDocuments,
+      timeout: 120_000,
+      requiresStore: true
+    },
+    // --- Operations ---
+    alerts: {
+      handler: handleAlerts,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    audit_trail: {
+      handler: handleAuditTrail,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    workflows: {
+      handler: handleWorkflows,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    // --- AI & Generation ---
+    voice: {
+      handler: handleVoice,
+      timeout: 120_000,
+      requiresStore: true
+    },
+    image_gen: {
+      handler: handleImageGen,
+      timeout: 60_000,
+      requiresStore: true
+    },
+    remove_bg: {
+      handler: handleRemoveBg,
+      timeout: 60_000,
+      requiresStore: true
+    },
+    media: {
+      handler: handleMedia,
+      timeout: 60_000,
+      requiresStore: true
+    },
+    video_gen: {
+      handler: handleVideoGen,
+      timeout: 600_000,
+      requiresStore: true
+    },
+    llm: {
+      handler: handleLLM,
+      timeout: 120_000,
+      requiresStore: true
+    },
+    embeddings: {
+      handler: handleEmbeddings,
+      timeout: 60_000,
+      requiresStore: true
+    },
+    creations: {
+      handler: handleCreations,
+      timeout: 60_000,
+      requiresStore: true
+    },
+    // --- Platform & Infrastructure ---
+    web_search: {
+      handler: handleWebSearch,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: false
+    },
+    telemetry: {
+      handler: handleTelemetry,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    browser: {
+      handler: handleBrowser,
+      timeout: 120_000,
+      requiresStore: true
+    },
+    discovery: {
+      handler: handleDiscovery,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: false
+    },
+    api_keys: {
+      handler: handleAPIKeys,
+      timeout: DEFAULT_TIMEOUT,
+      requiresStore: true
+    },
+    api_docs: {
+      handler: handleApiDocs,
+      timeout: 5000,
+      requiresStore: false
+    },
+    // --- Advertising ---
+    meta_ads: {
+      handler: handleMetaAds,
+      timeout: 300_000,
+      requiresStore: true
+    },
+    // --- Security & Local ---
+    kali: {
+      handler: handleKali,
+      timeout: 600_000,
+      requiresStore: true,
+      supportsProgress: true
+    },
+    local_agent: {
+      handler: handleLocalAgent,
+      timeout: 600_000,
+      requiresStore: false
+    },
+    // --- Customer Data ---
+    enrichment: {
+      handler: handleEnrichment,
+      timeout: 60_000,
+      requiresStore: true
+    },
+    // --- Observability ---
+    clickhouse: {
+      handler: handleClickHouse,
+      timeout: 60_000,
+      requiresStore: false
+    },
+    // --- Meta: Tool Discovery ---
+    discover_tools: {
+      handler: handleDiscoverTools,
+      timeout: 5000,
+      requiresStore: false
+    }
+  };
+  Object.freeze(handlers);
+  return handlers;
+}
+
+// ============================================================================
+// TOOL CATEGORY HEURISTICS
+// ============================================================================
+
+export const TOOL_CATEGORIES = {
+  inventory: "business",
+  purchase_orders: "business",
+  transfers: "business",
+  products: "business",
+  collections: "business",
+  customers: "business",
+  orders: "business",
+  analytics: "business",
+  locations: "business",
+  suppliers: "business",
+  store: "business",
+  storefront: "business",
+  email: "communication",
+  documents: "communication",
+  alerts: "operations",
+  audit_trail: "operations",
+  workflows: "operations",
+  telemetry: "operations",
+  voice: "media",
+  image_gen: "media",
+  video_gen: "media",
+  remove_bg: "media",
+  media: "media",
+  llm: "ai",
+  embeddings: "ai",
+  creations: "media",
+  web_search: "platform",
+  browser: "platform",
+  discovery: "platform",
+  api_keys: "platform",
+  api_docs: "platform",
+  kali: "security",
+  local_agent: "platform",
+  meta_ads: "advertising",
+  enrichment: "data"
+};
+//# sourceMappingURL=tool-router-types.js.map