titan-agent 7.0.0 → 7.1.0

package/dist/agent/contextManager.js

@@ -9,7 +9,7 @@ import { compressContext } from "./contextCompressor.js";
 const COMPONENT = "Context";
 function calculateBudget(maxContextTokens, systemPrompt, toolDefinitionsCount) {
   const systemTokens = estimateTokens(systemPrompt);
-  const toolTokens = toolDefinitionsCount * 120;
+  const toolTokens = toolDefinitionsCount * 250;
   const reserveForResponse = 2e3;
   return {
     maxTokens: maxContextTokens,

package/dist/agent/contextManager.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent/contextManager.ts"],"sourcesContent":["/**\n * TITAN — Smart Context Manager\n * Intelligent context window management that none of the competitors do well.\n *\n * Problems this solves:\n * - Auto-GPT wastes tokens on irrelevant history (high cost)\n * - CrewAI has prompt sprawl across agents (unpredictable cost)\n * - Open Interpreter has no context management at all\n *\n * TITAN's approach:\n * - Automatic summarization of old conversation history\n * - Priority-based context allocation (recent > relevant > old)\n * - Token budget tracking and enforcement\n * - Smart truncation that preserves tool call context\n */\nimport logger from '../utils/logger.js';\nimport type { ChatMessage } from '../providers/base.js';\nimport { estimateTokens } from '../utils/tokens.js';\nexport { estimateTokens };\nimport { flushMemoryBeforeCompaction } from '../memory/graph.js';\nimport { getRagContext } from '../memory/vectors.js';\nimport { getPlugins } from '../plugins/registry.js';\nimport { runAssemble, runCompact } from '../plugins/contextEngine.js';\nimport { compressContext, type StructuredSummary } from './contextCompressor.js';\n\nconst COMPONENT = 'Context';\n\ninterface ContextBudget {\n    maxTokens: number;\n    systemPromptTokens: number;\n    toolDefinitionTokens: number;\n    remainingForHistory: number;\n}\n\n\n\n/** Calculate the context budget */\nexport function calculateBudget(\n    maxContextTokens: number,\n    systemPrompt: string,\n    toolDefinitionsCount: number,\n): ContextBudget {\n    const systemTokens = estimateTokens(systemPrompt);\n    const toolTokens = toolDefinitionsCount * 120; // ~120 tokens per tool definition\n    const reserveForResponse = 2000; // Reserve for completion\n\n    return {\n        maxTokens: maxContextTokens,\n        systemPromptTokens: systemTokens,\n        toolDefinitionTokens: toolTokens,\n        remainingForHistory: Math.max(0, maxContextTokens - systemTokens - toolTokens - reserveForResponse),\n    };\n}\n\n/** Summarize a batch of messages into a single summary message */\nexport function summarizeMessages(messages: ChatMessage[]): ChatMessage {\n    const userMessages = messages.filter((m) => m.role === 'user').map((m) => m.content).filter(Boolean);\n    const assistantMessages = messages.filter((m) => m.role === 'assistant').map((m) => m.content).filter(Boolean);\n    const toolMessages = messages.filter((m) => m.role === 'tool').length;\n\n    const summary = [\n        `[Earlier conversation summary — ${messages.length} messages, ${toolMessages} tool calls]`,\n        userMessages.length > 0 ? `User discussed: ${userMessages.slice(-3).map((m) => m.slice(0, 80)).join('; ')}` : '',\n        assistantMessages.length > 0 ? `Assistant actions: ${assistantMessages.slice(-2).map((m) => m.slice(0, 80)).join('; ')}` : '',\n    ].filter(Boolean).join('\\n');\n\n    return { role: 'system', content: summary };\n}\n\n/**\n * Compress verbose tool results to save context window space.\n * Keeps the last 5 tool results at full fidelity, summarizes older ones.\n */\nfunction compressToolResults(messages: ChatMessage[]): ChatMessage[] {\n    // Count tool messages from the end to find the cutoff\n    let toolCount = 0;\n    const toolIndices: number[] = [];\n    for (let i = messages.length - 1; i >= 0; i--) {\n        if (messages[i].role === 'tool') {\n            toolCount++;\n            toolIndices.push(i);\n        }\n    }\n\n    // If 5 or fewer tool results, nothing to compress\n    if (toolCount <= 5) return messages;\n\n    // Indices of tool messages to keep at full fidelity (last 5)\n    const keepFullSet = new Set(toolIndices.slice(0, 5));\n\n    return messages.map((msg, i) => {\n        if (msg.role !== 'tool' || keepFullSet.has(i)) return msg;\n        const content = msg.content || '';\n        if (content.length <= 500) return msg;\n\n        // Compress: keep first 150 chars + success/error status\n        const isError = content.toLowerCase().includes('error:');\n        const summary = `[${msg.name || 'tool'}: ${isError ? 'FAILED' : 'OK'}] ${content.slice(0, 150)}... [${content.length} chars compressed]`;\n        return { ...msg, content: summary };\n    });\n}\n\n/** Persistent structured summary for iterative context compression */\nlet currentSummary: StructuredSummary | null = null;\n\n/**\n * TITAN pattern: MAX_CONSECUTIVE_AUTOCOMPACT_FAILURES\n * Disables compaction after 3 consecutive failures per session to prevent\n * wasted API calls (This class of bug can waste 250K+ API calls/day).\n */\nlet consecutiveCompactFailures = 0;\nconst MAX_CONSECUTIVE_COMPACT_FAILURES = 3;\n\n/** Reset compact failure counter (call on new session) */\nexport function resetCompactFailures(): void {\n    consecutiveCompactFailures = 0;\n}\n\n/** Get the current structured summary (for external access) */\nexport function getStructuredSummary(): StructuredSummary | null {\n    return currentSummary;\n}\n\n/** Set the structured summary (e.g., from agent loop state) */\nexport function setStructuredSummary(summary: StructuredSummary | null): void {\n    currentSummary = summary;\n}\n\n/**\n * Smart context builder — fits messages within token budget.\n * Uses the 5-phase compression pipeline (Hermes-inspired):\n * 1. Tool output pruning (no LLM call)\n * 2. Head protection (system + first 3 messages)\n * 3. Tail protection (last N messages, 5% of budget)\n * 4. Structured middle summary\n * 5. Iterative summary updates\n */\nexport function buildSmartContext(\n    messages: ChatMessage[],\n    tokenBudget: number,\n): ChatMessage[] {\n    if (messages.length === 0) return [];\n\n    // TITAN pattern: skip compaction after consecutive failures\n    if (consecutiveCompactFailures >= MAX_CONSECUTIVE_COMPACT_FAILURES) {\n        logger.warn(COMPONENT, `Compaction disabled after ${consecutiveCompactFailures} consecutive failures — returning raw messages`);\n        return messages;\n    }\n\n    let result;\n    try {\n        result = compressContext(messages, tokenBudget, currentSummary);\n        consecutiveCompactFailures = 0; // Reset on success\n    } catch (err) {\n        consecutiveCompactFailures++;\n        logger.warn(COMPONENT, `Compaction failed (${consecutiveCompactFailures}/${MAX_CONSECUTIVE_COMPACT_FAILURES}): ${(err as Error).message}`);\n        return messages; // Return uncompressed on failure\n    }\n\n    // Store summary for iterative updates on next compression\n    if (result.summary) {\n        currentSummary = result.summary;\n    }\n\n    if (result.savedTokens > 0) {\n        logger.debug(COMPONENT, `Smart context: ${messages.length} → ${result.messages.length} messages, saved ~${result.savedTokens} tokens`);\n    }\n\n    return result.messages;\n}\n\n/**\n * Force context compaction (used by /compact command).\n * Uses the 5-phase pipeline with an aggressive budget to maximize compression.\n */\nexport function forceCompactContext(\n    messages: ChatMessage[],\n): { messages: ChatMessage[]; savedTokens: number } {\n    if (messages.length <= 4) {\n        return { messages, savedTokens: 0 };\n    }\n\n    // Flush important context to graph memory before discarding (fire-and-forget)\n    const toFlush = messages.filter(m => m.role !== 'system');\n    flushMemoryBeforeCompaction(toFlush).catch((err) =>\n        logger.warn(COMPONENT, `Memory flush before compaction failed: ${(err as Error).message}`),\n    );\n\n    // Aggressive budget: 4000 tokens forces maximum compression\n    const result = compressContext(messages, 4000, currentSummary);\n\n    if (result.summary) {\n        currentSummary = result.summary;\n    }\n\n    logger.info(COMPONENT, `Force compacted: ${messages.length} → ${result.messages.length} messages, saved ~${result.savedTokens} tokens`);\n    return { messages: result.messages, savedTokens: result.savedTokens };\n}\n\n/** Get context window stats */\nexport function getContextStats(messages: ChatMessage[]): {\n    messageCount: number;\n    estimatedTokens: number;\n    userMessages: number;\n    assistantMessages: number;\n    toolCalls: number;\n} {\n    let tokens = 0;\n    let userMsgs = 0;\n    let assistantMsgs = 0;\n    let toolCalls = 0;\n\n    for (const m of messages) {\n        tokens += estimateTokens(m.content || '');\n        if (m.role === 'user') userMsgs++;\n        if (m.role === 'assistant') assistantMsgs++;\n        if (m.toolCalls) toolCalls += m.toolCalls.length;\n    }\n\n    return {\n        messageCount: messages.length,\n        estimatedTokens: tokens,\n        userMessages: userMsgs,\n        assistantMessages: assistantMsgs,\n        toolCalls,\n    };\n}\n\n/**\n * Inject RAG context into messages before the agent turn.\n * Queries the RAG vector store with the latest user message and prepends\n * relevant chunks as a system message.\n */\nexport async function injectRagContext(\n    messages: ChatMessage[],\n    topK: number = 3,\n): Promise<ChatMessage[]> {\n    // Find the last user message\n    const lastUserMsg = [...messages].reverse().find(m => m.role === 'user');\n    if (!lastUserMsg?.content) return messages;\n\n    try {\n        const ragContext = await getRagContext(lastUserMsg.content, topK);\n        if (!ragContext) return messages;\n\n        logger.debug(COMPONENT, `Injecting RAG context (${ragContext.length} chars) for query: \"${lastUserMsg.content.slice(0, 80)}\"`);\n\n        const ragMessage: ChatMessage = {\n            role: 'system',\n            content: `[Relevant knowledge from ingested documents]\\n${ragContext}`,\n        };\n\n        // Insert RAG context before the last user message\n        const result = [...messages];\n        const lastUserIndex = result.lastIndexOf(lastUserMsg);\n        if (lastUserIndex >= 0) {\n            result.splice(lastUserIndex, 0, ragMessage);\n        } else {\n            result.push(ragMessage);\n        }\n        return result;\n    } catch (e) {\n        logger.debug(COMPONENT, `RAG context injection failed: ${(e as Error).message}`);\n        return messages;\n    }\n}\n\n/**\n * Assemble context with plugin hooks.\n * Runs RAG injection first (built-in), then all registered plugins.\n */\nexport async function assembleContextWithPlugins(\n    messages: ChatMessage[],\n    userMessage: string,\n    ragTopK: number = 3,\n): Promise<ChatMessage[]> {\n    // Built-in RAG injection as first step\n    let result = await injectRagContext(messages, ragTopK);\n\n    // Run registered plugin assemble hooks\n    const plugins = getPlugins();\n    if (plugins.length > 0) {\n        result = await runAssemble(plugins, result, userMessage);\n    }\n\n    return result;\n}\n\n/**\n * Compact context with plugin hooks.\n * Runs built-in smart context first, then all registered plugins.\n */\nexport async function compactContextWithPlugins(\n    messages: ChatMessage[],\n    maxTokens: number,\n): Promise<ChatMessage[]> {\n    // Built-in smart context compaction\n    let result = buildSmartContext(messages, maxTokens);\n\n    // Run registered plugin compact hooks\n    const plugins = getPlugins();\n    if (plugins.length > 0) {\n        result = await runCompact(plugins, result, maxTokens);\n    }\n\n    return result;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/agent/contextManager.ts"],"sourcesContent":["/**\n * TITAN — Smart Context Manager\n * Intelligent context window management that none of the competitors do well.\n *\n * Problems this solves:\n * - Auto-GPT wastes tokens on irrelevant history (high cost)\n * - CrewAI has prompt sprawl across agents (unpredictable cost)\n * - Open Interpreter has no context management at all\n *\n * TITAN's approach:\n * - Automatic summarization of old conversation history\n * - Priority-based context allocation (recent > relevant > old)\n * - Token budget tracking and enforcement\n * - Smart truncation that preserves tool call context\n */\nimport logger from '../utils/logger.js';\nimport type { ChatMessage } from '../providers/base.js';\nimport { estimateTokens } from '../utils/tokens.js';\nexport { estimateTokens };\nimport { flushMemoryBeforeCompaction } from '../memory/graph.js';\nimport { getRagContext } from '../memory/vectors.js';\nimport { getPlugins } from '../plugins/registry.js';\nimport { runAssemble, runCompact } from '../plugins/contextEngine.js';\nimport { compressContext, type StructuredSummary } from './contextCompressor.js';\n\nconst COMPONENT = 'Context';\n\ninterface ContextBudget {\n    maxTokens: number;\n    systemPromptTokens: number;\n    toolDefinitionTokens: number;\n    remainingForHistory: number;\n}\n\n\n\n/** Calculate the context budget */\nexport function calculateBudget(\n    maxContextTokens: number,\n    systemPrompt: string,\n    toolDefinitionsCount: number,\n): ContextBudget {\n    const systemTokens = estimateTokens(systemPrompt);\n    const toolTokens = toolDefinitionsCount * 250; // measured avg 887 chars (~250 tok) per definition — 120 undercounted 4x and blew small contexts\n    const reserveForResponse = 2000; // Reserve for completion\n\n    return {\n        maxTokens: maxContextTokens,\n        systemPromptTokens: systemTokens,\n        toolDefinitionTokens: toolTokens,\n        remainingForHistory: Math.max(0, maxContextTokens - systemTokens - toolTokens - reserveForResponse),\n    };\n}\n\n/** Summarize a batch of messages into a single summary message */\nexport function summarizeMessages(messages: ChatMessage[]): ChatMessage {\n    const userMessages = messages.filter((m) => m.role === 'user').map((m) => m.content).filter(Boolean);\n    const assistantMessages = messages.filter((m) => m.role === 'assistant').map((m) => m.content).filter(Boolean);\n    const toolMessages = messages.filter((m) => m.role === 'tool').length;\n\n    const summary = [\n        `[Earlier conversation summary — ${messages.length} messages, ${toolMessages} tool calls]`,\n        userMessages.length > 0 ? `User discussed: ${userMessages.slice(-3).map((m) => m.slice(0, 80)).join('; ')}` : '',\n        assistantMessages.length > 0 ? `Assistant actions: ${assistantMessages.slice(-2).map((m) => m.slice(0, 80)).join('; ')}` : '',\n    ].filter(Boolean).join('\\n');\n\n    return { role: 'system', content: summary };\n}\n\n/**\n * Compress verbose tool results to save context window space.\n * Keeps the last 5 tool results at full fidelity, summarizes older ones.\n */\nfunction compressToolResults(messages: ChatMessage[]): ChatMessage[] {\n    // Count tool messages from the end to find the cutoff\n    let toolCount = 0;\n    const toolIndices: number[] = [];\n    for (let i = messages.length - 1; i >= 0; i--) {\n        if (messages[i].role === 'tool') {\n            toolCount++;\n            toolIndices.push(i);\n        }\n    }\n\n    // If 5 or fewer tool results, nothing to compress\n    if (toolCount <= 5) return messages;\n\n    // Indices of tool messages to keep at full fidelity (last 5)\n    const keepFullSet = new Set(toolIndices.slice(0, 5));\n\n    return messages.map((msg, i) => {\n        if (msg.role !== 'tool' || keepFullSet.has(i)) return msg;\n        const content = msg.content || '';\n        if (content.length <= 500) return msg;\n\n        // Compress: keep first 150 chars + success/error status\n        const isError = content.toLowerCase().includes('error:');\n        const summary = `[${msg.name || 'tool'}: ${isError ? 'FAILED' : 'OK'}] ${content.slice(0, 150)}... [${content.length} chars compressed]`;\n        return { ...msg, content: summary };\n    });\n}\n\n/** Persistent structured summary for iterative context compression */\nlet currentSummary: StructuredSummary | null = null;\n\n/**\n * TITAN pattern: MAX_CONSECUTIVE_AUTOCOMPACT_FAILURES\n * Disables compaction after 3 consecutive failures per session to prevent\n * wasted API calls (This class of bug can waste 250K+ API calls/day).\n */\nlet consecutiveCompactFailures = 0;\nconst MAX_CONSECUTIVE_COMPACT_FAILURES = 3;\n\n/** Reset compact failure counter (call on new session) */\nexport function resetCompactFailures(): void {\n    consecutiveCompactFailures = 0;\n}\n\n/** Get the current structured summary (for external access) */\nexport function getStructuredSummary(): StructuredSummary | null {\n    return currentSummary;\n}\n\n/** Set the structured summary (e.g., from agent loop state) */\nexport function setStructuredSummary(summary: StructuredSummary | null): void {\n    currentSummary = summary;\n}\n\n/**\n * Smart context builder — fits messages within token budget.\n * Uses the 5-phase compression pipeline (Hermes-inspired):\n * 1. Tool output pruning (no LLM call)\n * 2. Head protection (system + first 3 messages)\n * 3. Tail protection (last N messages, 5% of budget)\n * 4. Structured middle summary\n * 5. Iterative summary updates\n */\nexport function buildSmartContext(\n    messages: ChatMessage[],\n    tokenBudget: number,\n): ChatMessage[] {\n    if (messages.length === 0) return [];\n\n    // TITAN pattern: skip compaction after consecutive failures\n    if (consecutiveCompactFailures >= MAX_CONSECUTIVE_COMPACT_FAILURES) {\n        logger.warn(COMPONENT, `Compaction disabled after ${consecutiveCompactFailures} consecutive failures — returning raw messages`);\n        return messages;\n    }\n\n    let result;\n    try {\n        result = compressContext(messages, tokenBudget, currentSummary);\n        consecutiveCompactFailures = 0; // Reset on success\n    } catch (err) {\n        consecutiveCompactFailures++;\n        logger.warn(COMPONENT, `Compaction failed (${consecutiveCompactFailures}/${MAX_CONSECUTIVE_COMPACT_FAILURES}): ${(err as Error).message}`);\n        return messages; // Return uncompressed on failure\n    }\n\n    // Store summary for iterative updates on next compression\n    if (result.summary) {\n        currentSummary = result.summary;\n    }\n\n    if (result.savedTokens > 0) {\n        logger.debug(COMPONENT, `Smart context: ${messages.length} → ${result.messages.length} messages, saved ~${result.savedTokens} tokens`);\n    }\n\n    return result.messages;\n}\n\n/**\n * Force context compaction (used by /compact command).\n * Uses the 5-phase pipeline with an aggressive budget to maximize compression.\n */\nexport function forceCompactContext(\n    messages: ChatMessage[],\n): { messages: ChatMessage[]; savedTokens: number } {\n    if (messages.length <= 4) {\n        return { messages, savedTokens: 0 };\n    }\n\n    // Flush important context to graph memory before discarding (fire-and-forget)\n    const toFlush = messages.filter(m => m.role !== 'system');\n    flushMemoryBeforeCompaction(toFlush).catch((err) =>\n        logger.warn(COMPONENT, `Memory flush before compaction failed: ${(err as Error).message}`),\n    );\n\n    // Aggressive budget: 4000 tokens forces maximum compression\n    const result = compressContext(messages, 4000, currentSummary);\n\n    if (result.summary) {\n        currentSummary = result.summary;\n    }\n\n    logger.info(COMPONENT, `Force compacted: ${messages.length} → ${result.messages.length} messages, saved ~${result.savedTokens} tokens`);\n    return { messages: result.messages, savedTokens: result.savedTokens };\n}\n\n/** Get context window stats */\nexport function getContextStats(messages: ChatMessage[]): {\n    messageCount: number;\n    estimatedTokens: number;\n    userMessages: number;\n    assistantMessages: number;\n    toolCalls: number;\n} {\n    let tokens = 0;\n    let userMsgs = 0;\n    let assistantMsgs = 0;\n    let toolCalls = 0;\n\n    for (const m of messages) {\n        tokens += estimateTokens(m.content || '');\n        if (m.role === 'user') userMsgs++;\n        if (m.role === 'assistant') assistantMsgs++;\n        if (m.toolCalls) toolCalls += m.toolCalls.length;\n    }\n\n    return {\n        messageCount: messages.length,\n        estimatedTokens: tokens,\n        userMessages: userMsgs,\n        assistantMessages: assistantMsgs,\n        toolCalls,\n    };\n}\n\n/**\n * Inject RAG context into messages before the agent turn.\n * Queries the RAG vector store with the latest user message and prepends\n * relevant chunks as a system message.\n */\nexport async function injectRagContext(\n    messages: ChatMessage[],\n    topK: number = 3,\n): Promise<ChatMessage[]> {\n    // Find the last user message\n    const lastUserMsg = [...messages].reverse().find(m => m.role === 'user');\n    if (!lastUserMsg?.content) return messages;\n\n    try {\n        const ragContext = await getRagContext(lastUserMsg.content, topK);\n        if (!ragContext) return messages;\n\n        logger.debug(COMPONENT, `Injecting RAG context (${ragContext.length} chars) for query: \"${lastUserMsg.content.slice(0, 80)}\"`);\n\n        const ragMessage: ChatMessage = {\n            role: 'system',\n            content: `[Relevant knowledge from ingested documents]\\n${ragContext}`,\n        };\n\n        // Insert RAG context before the last user message\n        const result = [...messages];\n        const lastUserIndex = result.lastIndexOf(lastUserMsg);\n        if (lastUserIndex >= 0) {\n            result.splice(lastUserIndex, 0, ragMessage);\n        } else {\n            result.push(ragMessage);\n        }\n        return result;\n    } catch (e) {\n        logger.debug(COMPONENT, `RAG context injection failed: ${(e as Error).message}`);\n        return messages;\n    }\n}\n\n/**\n * Assemble context with plugin hooks.\n * Runs RAG injection first (built-in), then all registered plugins.\n */\nexport async function assembleContextWithPlugins(\n    messages: ChatMessage[],\n    userMessage: string,\n    ragTopK: number = 3,\n): Promise<ChatMessage[]> {\n    // Built-in RAG injection as first step\n    let result = await injectRagContext(messages, ragTopK);\n\n    // Run registered plugin assemble hooks\n    const plugins = getPlugins();\n    if (plugins.length > 0) {\n        result = await runAssemble(plugins, result, userMessage);\n    }\n\n    return result;\n}\n\n/**\n * Compact context with plugin hooks.\n * Runs built-in smart context first, then all registered plugins.\n */\nexport async function compactContextWithPlugins(\n    messages: ChatMessage[],\n    maxTokens: number,\n): Promise<ChatMessage[]> {\n    // Built-in smart context compaction\n    let result = buildSmartContext(messages, maxTokens);\n\n    // Run registered plugin compact hooks\n    const plugins = getPlugins();\n    if (plugins.length > 0) {\n        result = await runCompact(plugins, result, maxTokens);\n    }\n\n    return result;\n}\n"],"mappings":"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","names":[]}

package/dist/agent/toolSearch.js

@@ -47,8 +47,15 @@ const DEFAULT_CORE_TOOLS = [
   "list_spaces"
 ];
 function buildToolCatalog() {
-  const tools = getRegisteredTools();
-  return tools.filter((t) => t.name !== "tool_search").map((t) => `${t.name}: ${t.description.slice(0, 50)}`).join(" | ");
+  const tools = getRegisteredTools().filter((t) => t.name !== "tool_search");
+  const groups = /* @__PURE__ */ new Map();
+  for (const t of tools) {
+    const ns = t.name.includes("_") ? t.name.split("_")[0] : t.name;
+    const g = groups.get(ns) || [];
+    g.push(t.name);
+    groups.set(ns, g);
+  }
+  return [...groups.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([ns, names]) => names.length === 1 ? names[0] : `${ns}: ${names.join(", ")}`).join(" | ");
 }
 function searchTools(query, metadataOnly = false) {
   const tools = getRegisteredTools();

package/dist/agent/toolSearch.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/agent/toolSearch.ts"],"sourcesContent":["/**\n * TITAN — Tool Search\n *\n * Meta-tool that lets the LLM discover tools on demand instead of seeing\n * all 80+ tool schemas on every request. Reduces input tokens by 60-80%.\n *\n * How it works:\n *   1. Only core tools + tool_search are sent to the LLM (5-8 tools, ~600 tokens)\n *   2. tool_search description includes a compact catalog of ALL available tools\n *   3. When the LLM calls tool_search, matching tools are returned\n *   4. Agent loop adds discovered tools to activeTools for subsequent rounds\n *\n * Inspired by Anthropic's tool search pattern (2025) but works with ALL providers.\n */\nimport { getRegisteredTools, type ToolHandler } from './toolRunner.js';\nimport logger from '../utils/logger.js';\n\nconst COMPONENT = 'ToolSearch';\n\n/** Default core tools — always sent to the LLM without needing search */\nexport const DEFAULT_CORE_TOOLS = [\n    'shell',\n    'read_file',\n    'write_file',\n    'edit_file',\n    'list_dir',\n    'web_search',\n    'web_fetch',\n    'web_act',\n    'smart_form_fill',\n    'weather',\n    'memory',\n    // v7.0: \"remind me at X\" is a core personal-assistant verb — models were\n    // fabricating reminders precisely because this tool wasn't in their view.\n    'reminder',\n    'system_info',\n    'goal_list',\n    'spawn_agent',\n    'tool_search',\n    'tool_expand',\n    'self_doctor',\n    'ha_control',\n    'ha_devices',\n    'ha_status',\n    'gallery_search',\n    'gallery_get',\n    'gallery_list',\n    // v6.0.2 — Canvas widget tools must always be visible so the model\n    // reaches for them on \"build me X\" prompts (the v6.0 thesis). Before\n    // this, only gallery_search was in core; create_widget was only\n    // discoverable via tool_search, which the model rarely called for\n    // novel asks like \"build me a solar system\" — it'd fall through to\n    // shell + mkdir instead. These four tools are cheap (~80 tokens\n    // combined) and they're load-bearing for the Living Canvas pitch.\n    'create_widget',\n    'update_widget',\n    'remove_widget',\n    'list_active_widgets',\n    // Spaces tools — same logic: workspaces are a v6.0 first-class concept,\n    // the model needs to know it can create / switch / list them by name.\n    'create_space',\n    'switch_space',\n    'list_spaces',\n];\n\n/** Build a compact one-line catalog of all tools for the tool_search description */\nexport function buildToolCatalog(): string {\n    const tools = getRegisteredTools();\n    return tools\n        .filter(t => t.name !== 'tool_search')\n        .map(t => `${t.name}: ${t.description.slice(0, 50)}`)\n        .join(' | ');\n}\n\n/**\n * Search registered tools by keyword query.\n *\n * Progressive disclosure mode (Hermes competitive gap fix):\n * When metadataOnly=true, returns tools with truncated descriptions\n * and no parameter schemas — ~20 tokens each instead of ~200.\n * The model then calls tool_expand(name) to get the full schema\n * for just the tools it needs.\n */\nexport function searchTools(query: string, metadataOnly = false): ToolHandler[] {\n    const tools = getRegisteredTools();\n    const terms = query.toLowerCase().split(/\\s+/).filter(Boolean);\n\n    const scored = tools\n        .filter(t => t.name !== 'tool_search' && t.name !== 'tool_expand')\n        .map(t => {\n            const text = `${t.name} ${t.description}`.toLowerCase();\n            const score = terms.reduce((s, term) => s + (text.includes(term) ? 1 : 0), 0);\n            return { tool: t, score };\n        })\n        .filter(({ score }) => score > 0)\n        .sort((a, b) => b.score - a.score)\n        .slice(0, 8);\n\n    if (metadataOnly) {\n        // Return lightweight metadata — just name + one-line description\n        return scored.map(({ tool }) => ({\n            ...tool,\n            description: tool.description.slice(0, 80),\n            parameters: { type: 'object' as const, properties: {}, required: [] },\n        }));\n    }\n\n    return scored.map(({ tool }) => tool);\n}\n\n/**\n * Expand a single tool's full schema by name.\n * Part of the progressive disclosure pattern — model calls tool_search\n * to get names, then tool_expand to get the full schema for just the\n * tools it needs.\n */\nexport function expandTool(name: string): ToolHandler | null {\n    const tools = getRegisteredTools();\n    return tools.find(t => t.name === name) || null;\n}\n\n/** Get the tool_search tool handler */\nexport function getToolSearchHandler(): ToolHandler {\n    const catalog = buildToolCatalog();\n\n    return {\n        name: 'tool_search',\n        description: `Search for tools by keyword to discover capabilities. Call this FIRST when you need a tool not in your current list. Available tools: ${catalog}`,\n        parameters: {\n            type: 'object',\n            properties: {\n                query: {\n                    type: 'string',\n                    description: 'Search query — keywords describing what you need (e.g. \"email send\", \"browser screenshot\", \"github pr\", \"cron schedule\")',\n                },\n            },\n            required: ['query'],\n        },\n        execute: async (args: Record<string, unknown>) => {\n            const query = (args.query as string) || '';\n            if (!query.trim()) {\n                return 'Please provide a search query. Example: tool_search({query: \"email\"})';\n            }\n\n            const results = searchTools(query);\n\n            if (results.length === 0) {\n                return `No tools found matching \"${query}\". Try broader keywords.`;\n            }\n\n            logger.info(COMPONENT, `Search \"${query}\" → ${results.length} tools: [${results.map(t => t.name).join(', ')}]`);\n\n            const formatted = results.map(t => {\n                const params = t.parameters as Record<string, unknown>;\n                const props = (params.properties || {}) as Record<string, unknown>;\n                const paramNames = Object.keys(props).join(', ');\n                return `**${t.name}**(${paramNames}): ${t.description}`;\n            }).join('\\n');\n\n            return `Found ${results.length} tools:\\n${formatted}\\n\\nYou can now call these tools directly.`;\n        },\n    };\n}\n\n/**\n * Get the tool_expand handler — progressive disclosure (Hermes gap fix).\n * Returns the full JSON schema for a single tool by name.\n */\nexport function getToolExpandHandler(): ToolHandler {\n    return {\n        name: 'tool_expand',\n        description: 'Get the full parameter schema for a specific tool. Use after tool_search to see the detailed parameters before calling the tool.',\n        parameters: {\n            type: 'object',\n            properties: {\n                name: {\n                    type: 'string',\n                    description: 'The exact tool name to expand (e.g. \"email_send\", \"freelance_search\")',\n                },\n            },\n            required: ['name'],\n        },\n        execute: async (args: Record<string, unknown>) => {\n            const name = (args.name as string) || '';\n            if (!name.trim()) {\n                return 'Please provide a tool name. Example: tool_expand({name: \"email_send\"})';\n            }\n\n            const tool = expandTool(name);\n            if (!tool) {\n                return `Tool \"${name}\" not found. Use tool_search to find the correct name.`;\n            }\n\n            logger.info(COMPONENT, `Expand \"${name}\" → full schema loaded`);\n\n            const params = tool.parameters as Record<string, unknown>;\n            const props = (params.properties || {}) as Record<string, { type?: string; description?: string }>;\n            const required = (params.required || []) as string[];\n\n            const paramDocs = Object.entries(props).map(([key, val]) => {\n                const req = required.includes(key) ? ' (required)' : '';\n                return `  - **${key}**${req}: ${val.description || val.type || 'any'}`;\n            }).join('\\n');\n\n            return `## ${tool.name}\\n${tool.description}\\n\\n### Parameters\\n${paramDocs || '  (no parameters)'}\\n\\nYou can now call ${tool.name}() with these parameters.`;\n        },\n    };\n}\n"],"mappings":";AAcA,SAAS,0BAA4C;AACrD,OAAO,YAAY;AAEnB,MAAM,YAAY;AAGX,MAAM,qBAAqB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AACJ;AAGO,SAAS,mBAA2B;AACvC,QAAM,QAAQ,mBAAmB;AACjC,SAAO,MACF,OAAO,OAAK,EAAE,SAAS,aAAa,EACpC,IAAI,OAAK,GAAG,EAAE,IAAI,KAAK,EAAE,YAAY,MAAM,GAAG,EAAE,CAAC,EAAE,EACnD,KAAK,KAAK;AACnB;AAWO,SAAS,YAAY,OAAe,eAAe,OAAsB;AAC5E,QAAM,QAAQ,mBAAmB;AACjC,QAAM,QAAQ,MAAM,YAAY,EAAE,MAAM,KAAK,EAAE,OAAO,OAAO;AAE7D,QAAM,SAAS,MACV,OAAO,OAAK,EAAE,SAAS,iBAAiB,EAAE,SAAS,aAAa,EAChE,IAAI,OAAK;AACN,UAAM,OAAO,GAAG,EAAE,IAAI,IAAI,EAAE,WAAW,GAAG,YAAY;AACtD,UAAM,QAAQ,MAAM,OAAO,CAAC,GAAG,SAAS,KAAK,KAAK,SAAS,IAAI,IAAI,IAAI,IAAI,CAAC;AAC5E,WAAO,EAAE,MAAM,GAAG,MAAM;AAAA,EAC5B,CAAC,EACA,OAAO,CAAC,EAAE,MAAM,MAAM,QAAQ,CAAC,EAC/B,KAAK,CAAC,GAAG,MAAM,EAAE,QAAQ,EAAE,KAAK,EAChC,MAAM,GAAG,CAAC;AAEf,MAAI,cAAc;AAEd,WAAO,OAAO,IAAI,CAAC,EAAE,KAAK,OAAO;AAAA,MAC7B,GAAG;AAAA,MACH,aAAa,KAAK,YAAY,MAAM,GAAG,EAAE;AAAA,MACzC,YAAY,EAAE,MAAM,UAAmB,YAAY,CAAC,GAAG,UAAU,CAAC,EAAE;AAAA,IACxE,EAAE;AAAA,EACN;AAEA,SAAO,OAAO,IAAI,CAAC,EAAE,KAAK,MAAM,IAAI;AACxC;AAQO,SAAS,WAAW,MAAkC;AACzD,QAAM,QAAQ,mBAAmB;AACjC,SAAO,MAAM,KAAK,OAAK,EAAE,SAAS,IAAI,KAAK;AAC/C;AAGO,SAAS,uBAAoC;AAChD,QAAM,UAAU,iBAAiB;AAEjC,SAAO;AAAA,IACH,MAAM;AAAA,IACN,aAAa,yIAAyI,OAAO;AAAA,IAC7J,YAAY;AAAA,MACR,MAAM;AAAA,MACN,YAAY;AAAA,QACR,OAAO;AAAA,UACH,MAAM;AAAA,UACN,aAAa;AAAA,QACjB;AAAA,MACJ;AAAA,MACA,UAAU,CAAC,OAAO;AAAA,IACtB;AAAA,IACA,SAAS,OAAO,SAAkC;AAC9C,YAAM,QAAS,KAAK,SAAoB;AACxC,UAAI,CAAC,MAAM,KAAK,GAAG;AACf,eAAO;AAAA,MACX;AAEA,YAAM,UAAU,YAAY,KAAK;AAEjC,UAAI,QAAQ,WAAW,GAAG;AACtB,eAAO,4BAA4B,KAAK;AAAA,MAC5C;AAEA,aAAO,KAAK,WAAW,WAAW,KAAK,YAAO,QAAQ,MAAM,YAAY,QAAQ,IAAI,OAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG;AAE9G,YAAM,YAAY,QAAQ,IAAI,OAAK;AAC/B,cAAM,SAAS,EAAE;AACjB,cAAM,QAAS,OAAO,cAAc,CAAC;AACrC,cAAM,aAAa,OAAO,KAAK,KAAK,EAAE,KAAK,IAAI;AAC/C,eAAO,KAAK,EAAE,IAAI,MAAM,UAAU,MAAM,EAAE,WAAW;AAAA,MACzD,CAAC,EAAE,KAAK,IAAI;AAEZ,aAAO,SAAS,QAAQ,MAAM;AAAA,EAAY,SAAS;AAAA;AAAA;AAAA,IACvD;AAAA,EACJ;AACJ;AAMO,SAAS,uBAAoC;AAChD,SAAO;AAAA,IACH,MAAM;AAAA,IACN,aAAa;AAAA,IACb,YAAY;AAAA,MACR,MAAM;AAAA,MACN,YAAY;AAAA,QACR,MAAM;AAAA,UACF,MAAM;AAAA,UACN,aAAa;AAAA,QACjB;AAAA,MACJ;AAAA,MACA,UAAU,CAAC,MAAM;AAAA,IACrB;AAAA,IACA,SAAS,OAAO,SAAkC;AAC9C,YAAM,OAAQ,KAAK,QAAmB;AACtC,UAAI,CAAC,KAAK,KAAK,GAAG;AACd,eAAO;AAAA,MACX;AAEA,YAAM,OAAO,WAAW,IAAI;AAC5B,UAAI,CAAC,MAAM;AACP,eAAO,SAAS,IAAI;AAAA,MACxB;AAEA,aAAO,KAAK,WAAW,WAAW,IAAI,6BAAwB;AAE9D,YAAM,SAAS,KAAK;AACpB,YAAM,QAAS,OAAO,cAAc,CAAC;AACrC,YAAM,WAAY,OAAO,YAAY,CAAC;AAEtC,YAAM,YAAY,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,GAAG,MAAM;AACxD,cAAM,MAAM,SAAS,SAAS,GAAG,IAAI,gBAAgB;AACrD,eAAO,SAAS,GAAG,KAAK,GAAG,KAAK,IAAI,eAAe,IAAI,QAAQ,KAAK;AAAA,MACxE,CAAC,EAAE,KAAK,IAAI;AAEZ,aAAO,MAAM,KAAK,IAAI;AAAA,EAAK,KAAK,WAAW;AAAA;AAAA;AAAA,EAAuB,aAAa,mBAAmB;AAAA;AAAA,mBAAwB,KAAK,IAAI;AAAA,IACvI;AAAA,EACJ;AACJ;","names":[]}
+{"version":3,"sources":["../../src/agent/toolSearch.ts"],"sourcesContent":["/**\n * TITAN — Tool Search\n *\n * Meta-tool that lets the LLM discover tools on demand instead of seeing\n * all 80+ tool schemas on every request. Reduces input tokens by 60-80%.\n *\n * How it works:\n *   1. Only core tools + tool_search are sent to the LLM (5-8 tools, ~600 tokens)\n *   2. tool_search description includes a compact catalog of ALL available tools\n *   3. When the LLM calls tool_search, matching tools are returned\n *   4. Agent loop adds discovered tools to activeTools for subsequent rounds\n *\n * Inspired by Anthropic's tool search pattern (2025) but works with ALL providers.\n */\nimport { getRegisteredTools, type ToolHandler } from './toolRunner.js';\nimport logger from '../utils/logger.js';\n\nconst COMPONENT = 'ToolSearch';\n\n/** Default core tools — always sent to the LLM without needing search */\nexport const DEFAULT_CORE_TOOLS = [\n    'shell',\n    'read_file',\n    'write_file',\n    'edit_file',\n    'list_dir',\n    'web_search',\n    'web_fetch',\n    'web_act',\n    'smart_form_fill',\n    'weather',\n    'memory',\n    // v7.0: \"remind me at X\" is a core personal-assistant verb — models were\n    // fabricating reminders precisely because this tool wasn't in their view.\n    'reminder',\n    'system_info',\n    'goal_list',\n    'spawn_agent',\n    'tool_search',\n    'tool_expand',\n    'self_doctor',\n    'ha_control',\n    'ha_devices',\n    'ha_status',\n    'gallery_search',\n    'gallery_get',\n    'gallery_list',\n    // v6.0.2 — Canvas widget tools must always be visible so the model\n    // reaches for them on \"build me X\" prompts (the v6.0 thesis). Before\n    // this, only gallery_search was in core; create_widget was only\n    // discoverable via tool_search, which the model rarely called for\n    // novel asks like \"build me a solar system\" — it'd fall through to\n    // shell + mkdir instead. These four tools are cheap (~80 tokens\n    // combined) and they're load-bearing for the Living Canvas pitch.\n    'create_widget',\n    'update_widget',\n    'remove_widget',\n    'list_active_widgets',\n    // Spaces tools — same logic: workspaces are a v6.0 first-class concept,\n    // the model needs to know it can create / switch / list them by name.\n    'create_space',\n    'switch_space',\n    'list_spaces',\n];\n\n/** Build a compact one-line catalog of all tools for the tool_search description */\nexport function buildToolCatalog(): string {\n    // v7.1: names-only, grouped by namespace prefix. The old form embedded a\n    // 50-char description per tool — 18.5KB (~5K tokens) inside tool_search's\n    // OWN description, the single fattest item in every request. Names alone\n    // keep the full surface discoverable (tool_search returns full schemas on\n    // demand) at ~1/5 the size — for every model, local or cloud.\n    const tools = getRegisteredTools().filter(t => t.name !== 'tool_search');\n    const groups = new Map<string, string[]>();\n    for (const t of tools) {\n        const ns = t.name.includes('_') ? t.name.split('_')[0] : t.name;\n        const g = groups.get(ns) || [];\n        g.push(t.name);\n        groups.set(ns, g);\n    }\n    return [...groups.entries()]\n        .sort((a, b) => a[0].localeCompare(b[0]))\n        .map(([ns, names]) => (names.length === 1 ? names[0] : `${ns}: ${names.join(', ')}`))\n        .join(' | ');\n}\n\n/**\n * Search registered tools by keyword query.\n *\n * Progressive disclosure mode (Hermes competitive gap fix):\n * When metadataOnly=true, returns tools with truncated descriptions\n * and no parameter schemas — ~20 tokens each instead of ~200.\n * The model then calls tool_expand(name) to get the full schema\n * for just the tools it needs.\n */\nexport function searchTools(query: string, metadataOnly = false): ToolHandler[] {\n    const tools = getRegisteredTools();\n    const terms = query.toLowerCase().split(/\\s+/).filter(Boolean);\n\n    const scored = tools\n        .filter(t => t.name !== 'tool_search' && t.name !== 'tool_expand')\n        .map(t => {\n            const text = `${t.name} ${t.description}`.toLowerCase();\n            const score = terms.reduce((s, term) => s + (text.includes(term) ? 1 : 0), 0);\n            return { tool: t, score };\n        })\n        .filter(({ score }) => score > 0)\n        .sort((a, b) => b.score - a.score)\n        .slice(0, 8);\n\n    if (metadataOnly) {\n        // Return lightweight metadata — just name + one-line description\n        return scored.map(({ tool }) => ({\n            ...tool,\n            description: tool.description.slice(0, 80),\n            parameters: { type: 'object' as const, properties: {}, required: [] },\n        }));\n    }\n\n    return scored.map(({ tool }) => tool);\n}\n\n/**\n * Expand a single tool's full schema by name.\n * Part of the progressive disclosure pattern — model calls tool_search\n * to get names, then tool_expand to get the full schema for just the\n * tools it needs.\n */\nexport function expandTool(name: string): ToolHandler | null {\n    const tools = getRegisteredTools();\n    return tools.find(t => t.name === name) || null;\n}\n\n/** Get the tool_search tool handler */\nexport function getToolSearchHandler(): ToolHandler {\n    const catalog = buildToolCatalog();\n\n    return {\n        name: 'tool_search',\n        description: `Search for tools by keyword to discover capabilities. Call this FIRST when you need a tool not in your current list. Available tools: ${catalog}`,\n        parameters: {\n            type: 'object',\n            properties: {\n                query: {\n                    type: 'string',\n                    description: 'Search query — keywords describing what you need (e.g. \"email send\", \"browser screenshot\", \"github pr\", \"cron schedule\")',\n                },\n            },\n            required: ['query'],\n        },\n        execute: async (args: Record<string, unknown>) => {\n            const query = (args.query as string) || '';\n            if (!query.trim()) {\n                return 'Please provide a search query. Example: tool_search({query: \"email\"})';\n            }\n\n            const results = searchTools(query);\n\n            if (results.length === 0) {\n                return `No tools found matching \"${query}\". Try broader keywords.`;\n            }\n\n            logger.info(COMPONENT, `Search \"${query}\" → ${results.length} tools: [${results.map(t => t.name).join(', ')}]`);\n\n            const formatted = results.map(t => {\n                const params = t.parameters as Record<string, unknown>;\n                const props = (params.properties || {}) as Record<string, unknown>;\n                const paramNames = Object.keys(props).join(', ');\n                return `**${t.name}**(${paramNames}): ${t.description}`;\n            }).join('\\n');\n\n            return `Found ${results.length} tools:\\n${formatted}\\n\\nYou can now call these tools directly.`;\n        },\n    };\n}\n\n/**\n * Get the tool_expand handler — progressive disclosure (Hermes gap fix).\n * Returns the full JSON schema for a single tool by name.\n */\nexport function getToolExpandHandler(): ToolHandler {\n    return {\n        name: 'tool_expand',\n        description: 'Get the full parameter schema for a specific tool. Use after tool_search to see the detailed parameters before calling the tool.',\n        parameters: {\n            type: 'object',\n            properties: {\n                name: {\n                    type: 'string',\n                    description: 'The exact tool name to expand (e.g. \"email_send\", \"freelance_search\")',\n                },\n            },\n            required: ['name'],\n        },\n        execute: async (args: Record<string, unknown>) => {\n            const name = (args.name as string) || '';\n            if (!name.trim()) {\n                return 'Please provide a tool name. Example: tool_expand({name: \"email_send\"})';\n            }\n\n            const tool = expandTool(name);\n            if (!tool) {\n                return `Tool \"${name}\" not found. Use tool_search to find the correct name.`;\n            }\n\n            logger.info(COMPONENT, `Expand \"${name}\" → full schema loaded`);\n\n            const params = tool.parameters as Record<string, unknown>;\n            const props = (params.properties || {}) as Record<string, { type?: string; description?: string }>;\n            const required = (params.required || []) as string[];\n\n            const paramDocs = Object.entries(props).map(([key, val]) => {\n                const req = required.includes(key) ? ' (required)' : '';\n                return `  - **${key}**${req}: ${val.description || val.type || 'any'}`;\n            }).join('\\n');\n\n            return `## ${tool.name}\\n${tool.description}\\n\\n### Parameters\\n${paramDocs || '  (no parameters)'}\\n\\nYou can now call ${tool.name}() with these parameters.`;\n        },\n    };\n}\n"],"mappings":"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","names":[]}

package/dist/config/schema.js

@@ -575,6 +575,24 @@ const TitanConfigSchema = z.object({
     })).default({})
   }).default({}),
   organism: OrganismConfigSchema.default({}),
+  /** v7.1 MoA — Mixture-of-Agents presets. A preset = N reference advisor
+   *  models (trimmed context, no tools, parallel with timeouts) + 1 acting
+   *  aggregator. Selectable anywhere as the virtual model `moa/<preset>`.
+   *  Local-first: the default `local-council` mixes models across the
+   *  user's own machines for $0 per turn. */
+  moa: z.object({
+    presets: z.record(z.string(), z.object({
+      references: z.array(z.object({
+        model: z.string(),
+        maxTokens: z.number().int().positive().optional(),
+        temperature: z.number().min(0).max(2).optional(),
+        timeoutMs: z.number().int().positive().optional()
+      })).min(1),
+      aggregator: z.string(),
+      enabled: z.boolean().default(true),
+      maxTokens: z.number().int().positive().optional()
+    })).default({})
+  }).default({}),
   /** v7.0 Muscle Memory — automatic, replay-verified skill learning.
    *  Safe to enable by default: proposals never auto-adopt; every learned
    *  skill must pass a deterministic replay exam before it is shown. */