nodebench-mcp 2.70.0 → 3.0.0

package/dist/tools/profilerTools.js

@@ -0,0 +1,364 @@
+/**
+ * profilerTools.ts — Founder Operating Profiler
+ *
+ * Intercepts MCP tool calls, logs cost/latency/patterns, and surfaces
+ * optimization intelligence. This is the meta-layer that makes NodeBench
+ * indispensable for agent-native builders.
+ *
+ * What it profiles:
+ * - Tool call sequences (what chains do users run)
+ * - Cost patterns (which tools/models are expensive, which are redundant)
+ * - Context reuse (what gets rebuilt that should be cached)
+ * - Query patterns (repeated questions, similar intents)
+ * - Workflow efficiency (shortest valid path vs actual path)
+ *
+ * Architecture principle:
+ * - LLM for interpretation (pattern detection, optimization suggestions)
+ * - Deterministic code for control (logging, storage, budget enforcement)
+ */
+import { genId } from "../db.js";
+// ── Cost estimates per tool category ──────────────────────────────────
+const COST_PER_CALL = {
+    web_search: 0.008,
+    fetch_url: 0.002,
+    enrich_entity: 0.015,
+    run_deep_sim: 0.05,
+    build_claim_graph: 0.03,
+    extract_variables: 0.02,
+    generate_countermodels: 0.04,
+    rank_interventions: 0.02,
+    score_compounding: 0.02,
+    render_decision_memo: 0.01,
+    founder_local_weekly_reset: 0.005,
+    founder_local_synthesize: 0.01,
+    founder_local_gather: 0.003,
+    discover_tools: 0.001,
+    get_tool_quick_ref: 0.001,
+    // Default for unknown tools
+    _default: 0.005,
+};
+function estimateCost(toolName) {
+    return COST_PER_CALL[toolName] ?? COST_PER_CALL._default;
+}
+// ── In-memory profiling store (bounded) ──────────────────────────────
+const MAX_RECORDS = 5000;
+const MAX_SESSIONS = 200;
+const toolCallLog = [];
+const sessionProfiles = new Map();
+function addToolCall(record) {
+    toolCallLog.push(record);
+    if (toolCallLog.length > MAX_RECORDS) {
+        toolCallLog.splice(0, toolCallLog.length - MAX_RECORDS);
+    }
+}
+function getOrCreateSession(sessionId) {
+    let profile = sessionProfiles.get(sessionId);
+    if (!profile) {
+        if (sessionProfiles.size >= MAX_SESSIONS) {
+            // Evict oldest session
+            const oldest = sessionProfiles.keys().next().value;
+            if (oldest)
+                sessionProfiles.delete(oldest);
+        }
+        profile = {
+            sessionId,
+            totalCalls: 0,
+            totalDurationMs: 0,
+            totalCostUsd: 0,
+            uniqueTools: [],
+            toolChain: [],
+            redundantCalls: 0,
+            reusedContext: 0,
+            optimizationScore: 100,
+        };
+        sessionProfiles.set(sessionId, profile);
+    }
+    return profile;
+}
+// ── Redundancy detection ─────────────────────────────────────────────
+function isRedundant(toolName, args, sessionId) {
+    const recentCalls = toolCallLog
+        .filter(r => r.sessionId === sessionId && r.toolName === toolName)
+        .slice(-10);
+    const argsStr = JSON.stringify(args);
+    const thirtyMinAgo = Date.now() - 30 * 60 * 1000;
+    return recentCalls.some(r => r.startMs > thirtyMinAgo && JSON.stringify(r.args) === argsStr);
+}
+// ── Pattern detection ────────────────────────────────────────────────
+function detectPatterns(sessionId) {
+    const suggestions = [];
+    const session = sessionProfiles.get(sessionId);
+    if (!session || session.totalCalls < 3)
+        return suggestions;
+    // 1. Redundant calls
+    if (session.redundantCalls > 0) {
+        suggestions.push({
+            type: "redundant_call",
+            description: `${session.redundantCalls} tool calls were identical to recent calls. Results could be cached.`,
+            estimatedSavings: {
+                calls: session.redundantCalls,
+                costUsd: session.redundantCalls * 0.005,
+                latencyMs: session.redundantCalls * 2000,
+            },
+            confidence: 90,
+            actionable: "Enable NodeBench result caching for repeated queries within 30-minute windows.",
+        });
+    }
+    // 2. Repeated tool chains
+    const chain = session.toolChain;
+    if (chain.length >= 6) {
+        // Look for repeated subsequences of length 3+
+        for (let len = 3; len <= Math.min(5, Math.floor(chain.length / 2)); len++) {
+            const last = chain.slice(-len).join(",");
+            const prior = chain.slice(-(len * 2), -len).join(",");
+            if (last === prior) {
+                suggestions.push({
+                    type: "workflow_shortcut",
+                    description: `Detected repeated ${len}-step sequence: ${chain.slice(-len).join(" → ")}. This can be automated.`,
+                    estimatedSavings: { calls: len, latencyMs: len * 1500 },
+                    confidence: 75,
+                    actionable: "Save this as a reusable workflow in NodeBench.",
+                });
+                break;
+            }
+        }
+    }
+    // 3. Expensive tool usage
+    const expensiveCalls = toolCallLog
+        .filter(r => r.sessionId === sessionId && r.costEstimateUsd > 0.02)
+        .length;
+    if (expensiveCalls > 3) {
+        suggestions.push({
+            type: "cheaper_model",
+            description: `${expensiveCalls} calls used expensive tools. Some may work with Gemini Flash Lite instead.`,
+            estimatedSavings: {
+                costUsd: expensiveCalls * 0.015,
+                tokens: expensiveCalls * 500,
+            },
+            confidence: 60,
+            actionable: "Consider using lighter models for classification and extraction tasks.",
+        });
+    }
+    return suggestions;
+}
+// ── Query pattern analysis ───────────────────────────────────────────
+function getQueryPatterns() {
+    // Find repeated queries (by tool args similarity)
+    const queryMap = new Map();
+    for (const record of toolCallLog) {
+        if (record.toolName === "web_search" || record.toolName === "enrich_entity") {
+            const key = `${record.toolName}:${JSON.stringify(record.args).substring(0, 100)}`;
+            queryMap.set(key, (queryMap.get(key) ?? 0) + 1);
+        }
+    }
+    const repeatedQueries = Array.from(queryMap.entries())
+        .filter(([, count]) => count > 1)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10)
+        .map(([query, count]) => ({ query, count }));
+    // Top tools by usage
+    const toolStats = new Map();
+    for (const record of toolCallLog) {
+        const stats = toolStats.get(record.toolName) ?? { count: 0, totalLatency: 0, totalCost: 0 };
+        stats.count++;
+        stats.totalLatency += record.durationMs;
+        stats.totalCost += record.costEstimateUsd;
+        toolStats.set(record.toolName, stats);
+    }
+    const topTools = Array.from(toolStats.entries())
+        .sort((a, b) => b[1].count - a[1].count)
+        .slice(0, 15)
+        .map(([tool, stats]) => ({
+        tool,
+        count: stats.count,
+        avgLatencyMs: Math.round(stats.totalLatency / stats.count),
+        totalCostUsd: Math.round(stats.totalCost * 1000) / 1000,
+    }));
+    return { repeatedQueries, topTools };
+}
+// ── MCP Tools ────────────────────────────────────────────────────────
+export const profilerTools = [
+    {
+        name: "log_tool_call",
+        description: "Log an MCP tool call for profiling. Called automatically by the NodeBench gateway to track tool usage patterns, cost, and latency. Returns whether the call was redundant.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                sessionId: { type: "string", description: "Session or conversation ID" },
+                toolName: { type: "string", description: "Name of the MCP tool called" },
+                args: { type: "object", description: "Tool input arguments" },
+                durationMs: { type: "number", description: "How long the call took" },
+                success: { type: "boolean", description: "Whether the call succeeded" },
+                modelUsed: { type: "string", description: "LLM model used (if applicable)" },
+                tokenEstimate: { type: "number", description: "Estimated tokens consumed" },
+            },
+            required: ["sessionId", "toolName", "durationMs", "success"],
+        },
+        handler: async (args) => {
+            const sessionId = String(args.sessionId ?? "unknown");
+            const toolName = String(args.toolName ?? "unknown");
+            const toolArgs = args.args ?? {};
+            const durationMs = Number(args.durationMs ?? 0);
+            const success = Boolean(args.success);
+            const modelUsed = args.modelUsed ? String(args.modelUsed) : undefined;
+            const tokenEstimate = args.tokenEstimate ? Number(args.tokenEstimate) : undefined;
+            const redundant = isRedundant(toolName, toolArgs, sessionId);
+            const costEstimate = estimateCost(toolName);
+            const record = {
+                id: genId("prof"),
+                sessionId,
+                toolName,
+                args: toolArgs,
+                result: { success, tokenEstimate },
+                startMs: Date.now() - durationMs,
+                durationMs,
+                costEstimateUsd: costEstimate,
+                modelUsed,
+                timestamp: new Date().toISOString(),
+            };
+            addToolCall(record);
+            // Update session profile
+            const session = getOrCreateSession(sessionId);
+            session.totalCalls++;
+            session.totalDurationMs += durationMs;
+            session.totalCostUsd += costEstimate;
+            session.toolChain.push(toolName);
+            if (session.toolChain.length > 100)
+                session.toolChain.splice(0, 50);
+            if (!session.uniqueTools.includes(toolName))
+                session.uniqueTools.push(toolName);
+            if (redundant)
+                session.redundantCalls++;
+            return {
+                logged: true,
+                redundant,
+                callNumber: session.totalCalls,
+                sessionCostSoFar: Math.round(session.totalCostUsd * 1000) / 1000,
+                suggestion: redundant ? "This call is identical to a recent one. Consider caching." : null,
+            };
+        },
+    },
+    {
+        name: "get_session_profile",
+        description: "Get the efficiency profile for the current session. Shows total calls, cost, latency, redundancy, and optimization suggestions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                sessionId: { type: "string", description: "Session ID to profile" },
+            },
+            required: ["sessionId"],
+        },
+        handler: async (args) => {
+            const sessionId = String(args.sessionId ?? "unknown");
+            const session = sessionProfiles.get(sessionId);
+            if (!session) {
+                return { error: false, message: "No profile data yet. Use tools to build a profile.", totalCalls: 0 };
+            }
+            const suggestions = detectPatterns(sessionId);
+            return {
+                ...session,
+                totalCostUsd: Math.round(session.totalCostUsd * 1000) / 1000,
+                suggestions,
+                efficiency: {
+                    redundancyRate: session.totalCalls > 0 ? Math.round((session.redundantCalls / session.totalCalls) * 100) : 0,
+                    avgLatencyMs: session.totalCalls > 0 ? Math.round(session.totalDurationMs / session.totalCalls) : 0,
+                    costPerCall: session.totalCalls > 0 ? Math.round((session.totalCostUsd / session.totalCalls) * 1000) / 1000 : 0,
+                },
+            };
+        },
+    },
+    {
+        name: "get_usage_insights",
+        description: "Get aggregate usage insights across all sessions. Shows top tools, repeated queries, cost breakdown, and optimization opportunities. This is the founder operating intelligence layer.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                daysBack: { type: "number", description: "How many days of data to analyze (default: 7)" },
+            },
+        },
+        handler: async (args) => {
+            const patterns = getQueryPatterns();
+            const totalSessions = sessionProfiles.size;
+            const totalCalls = toolCallLog.length;
+            const totalCost = toolCallLog.reduce((sum, r) => sum + r.costEstimateUsd, 0);
+            const totalLatency = toolCallLog.reduce((sum, r) => sum + r.durationMs, 0);
+            const redundantTotal = Array.from(sessionProfiles.values()).reduce((sum, s) => sum + s.redundantCalls, 0);
+            // Find the most common tool chains
+            const chainCounts = new Map();
+            for (const session of sessionProfiles.values()) {
+                const chain = session.toolChain;
+                for (let i = 0; i < chain.length - 2; i++) {
+                    const triplet = `${chain[i]} → ${chain[i + 1]} → ${chain[i + 2]}`;
+                    chainCounts.set(triplet, (chainCounts.get(triplet) ?? 0) + 1);
+                }
+            }
+            const topChains = Array.from(chainCounts.entries())
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 5)
+                .map(([chain, count]) => ({ chain, count }));
+            return {
+                overview: {
+                    totalSessions,
+                    totalCalls,
+                    totalCostUsd: Math.round(totalCost * 1000) / 1000,
+                    totalLatencyMs: totalLatency,
+                    avgCallsPerSession: totalSessions > 0 ? Math.round(totalCalls / totalSessions) : 0,
+                    redundantCallRate: totalCalls > 0 ? Math.round((redundantTotal / totalCalls) * 100) : 0,
+                },
+                topTools: patterns.topTools,
+                repeatedQueries: patterns.repeatedQueries,
+                topChains,
+                recommendations: [
+                    redundantTotal > 5 ? `${redundantTotal} redundant calls detected. Enable caching to save ~$${Math.round(redundantTotal * 0.005 * 100) / 100}/week.` : null,
+                    patterns.topTools.some(t => t.avgLatencyMs > 5000) ? `Some tools average >5s. Consider async dispatch or cheaper model alternatives.` : null,
+                    topChains.length > 0 ? `Most common workflow: ${topChains[0].chain} (${topChains[0].count}x). Save as reusable template.` : null,
+                ].filter(Boolean),
+            };
+        },
+    },
+    {
+        name: "suggest_optimizations",
+        description: "Analyze the current session and suggest specific optimizations: cheaper models, cached results, workflow shortcuts, and reusable patterns.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                sessionId: { type: "string", description: "Session to optimize" },
+            },
+            required: ["sessionId"],
+        },
+        handler: async (args) => {
+            const sessionId = String(args.sessionId ?? "unknown");
+            const suggestions = detectPatterns(sessionId);
+            const session = sessionProfiles.get(sessionId);
+            if (!session || session.totalCalls < 2) {
+                return {
+                    suggestions: [],
+                    message: "Keep using tools — optimization suggestions appear after 3+ tool calls.",
+                };
+            }
+            // Calculate potential savings
+            const totalPotentialSavings = suggestions.reduce((sum, s) => ({
+                calls: sum.calls + (s.estimatedSavings.calls ?? 0),
+                costUsd: sum.costUsd + (s.estimatedSavings.costUsd ?? 0),
+                latencyMs: sum.latencyMs + (s.estimatedSavings.latencyMs ?? 0),
+            }), { calls: 0, costUsd: 0, latencyMs: 0 });
+            return {
+                sessionStats: {
+                    totalCalls: session.totalCalls,
+                    totalCostUsd: Math.round(session.totalCostUsd * 1000) / 1000,
+                    redundancyRate: `${Math.round((session.redundantCalls / session.totalCalls) * 100)}%`,
+                },
+                suggestions,
+                potentialSavings: {
+                    calls: totalPotentialSavings.calls,
+                    costUsd: Math.round(totalPotentialSavings.costUsd * 1000) / 1000,
+                    latencyMs: totalPotentialSavings.latencyMs,
+                    summary: totalPotentialSavings.calls > 0
+                        ? `Save ${totalPotentialSavings.calls} calls, ~$${Math.round(totalPotentialSavings.costUsd * 100) / 100}, ~${Math.round(totalPotentialSavings.latencyMs / 1000)}s per session`
+                        : "No optimizations needed — your workflow is efficient.",
+                },
+            };
+        },
+    },
+];
+//# sourceMappingURL=profilerTools.js.map

package/dist/tools/profilerTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profilerTools.js","sourceRoot":"","sources":["../../src/tools/profilerTools.ts"],"names":[],"mappings":"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"}

package/dist/tools/savingsTools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Savings Tools — Token/time/cost savings comparison
+ *
+ * Reads analytics DB to compute ROI metrics:
+ * - Total tokens used vs saved (TOON compression)
+ * - Time saved vs manual workflow
+ * - Cost estimates
+ * - Before/after delta between sessions
+ */
+import type { McpTool } from "../types.js";
+export declare const savingsTools: McpTool[];

package/dist/tools/savingsTools.js

@@ -0,0 +1,155 @@
+/**
+ * Savings Tools — Token/time/cost savings comparison
+ *
+ * Reads analytics DB to compute ROI metrics:
+ * - Total tokens used vs saved (TOON compression)
+ * - Time saved vs manual workflow
+ * - Cost estimates
+ * - Before/after delta between sessions
+ */
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+async function getAnalyticsDbSafe() {
+    try {
+        const os = await import("node:os");
+        const path = await import("node:path");
+        const fs = await import("node:fs");
+        const dbPath = path.join(os.homedir(), ".nodebench", "analytics.db");
+        if (!fs.existsSync(dbPath))
+            return null;
+        const Database = (await import("better-sqlite3")).default;
+        return new Database(dbPath, { readonly: true });
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Tools ────────────────────────────────────────────────────────────────────
+export const savingsTools = [
+    {
+        name: "compare_savings",
+        description: "Compare token usage, time savings, and cost estimates. Optionally compare two sessions for before/after ROI. Shows total tool calls, tokens, estimated time saved, and cost.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: {
+                    type: "string",
+                    description: "Specific session to analyze (omit for all-time stats)",
+                },
+                compare_session_id: {
+                    type: "string",
+                    description: "Second session ID for before/after comparison",
+                },
+                days: {
+                    type: "number",
+                    description: "Limit to last N days (default: 30)",
+                },
+            },
+        },
+        annotations: { readOnlyHint: true },
+        handler: async (args) => {
+            const db = await getAnalyticsDbSafe();
+            if (!db) {
+                return {
+                    error: "No analytics data found. Use NodeBench MCP tools first to generate usage data.",
+                    suggestion: "Run some tools, then call compare_savings() to see your ROI.",
+                };
+            }
+            try {
+                const days = args.days ?? 30;
+                const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+                // Check if tool_call_log table exists
+                const tableCheck = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='tool_call_log'").get();
+                if (!tableCheck) {
+                    db.close();
+                    return {
+                        error: "Analytics table not initialized yet. Run some tools first.",
+                    };
+                }
+                // Get column info to handle schema variations
+                const columns = db.prepare("PRAGMA table_info(tool_call_log)").all();
+                const columnNames = new Set(columns.map((c) => c.name));
+                const hasTokens = columnNames.has("tokens_used");
+                const hasDuration = columnNames.has("duration_ms");
+                const hasSession = columnNames.has("session_id");
+                const hasTimestamp = columnNames.has("timestamp") || columnNames.has("called_at");
+                const timestampCol = columnNames.has("timestamp") ? "timestamp" : "called_at";
+                // Build query based on available columns
+                function getStats(sessionFilter) {
+                    let where = hasTimestamp ? `WHERE ${timestampCol} > ?` : "WHERE 1=1";
+                    const params = hasTimestamp ? [cutoff] : [];
+                    if (sessionFilter && hasSession) {
+                        where += " AND session_id = ?";
+                        params.push(sessionFilter);
+                    }
+                    const totalCalls = db.prepare(`SELECT COUNT(*) as cnt FROM tool_call_log ${where}`).get(...params);
+                    let avgDuration = 0;
+                    if (hasDuration) {
+                        const durResult = db.prepare(`SELECT AVG(duration_ms) as avg_dur FROM tool_call_log ${where}`).get(...params);
+                        avgDuration = durResult?.avg_dur ?? 0;
+                    }
+                    let totalTokens = 0;
+                    if (hasTokens) {
+                        const tokResult = db.prepare(`SELECT SUM(tokens_used) as total FROM tool_call_log ${where}`).get(...params);
+                        totalTokens = tokResult?.total ?? 0;
+                    }
+                    // Top tools
+                    const topTools = db.prepare(`SELECT tool_name, COUNT(*) as calls${hasDuration ? ", AVG(duration_ms) as avg_ms" : ""} FROM tool_call_log ${where} GROUP BY tool_name ORDER BY calls DESC LIMIT 10`).all(...params);
+                    // Error rate
+                    const hasSuccess = columnNames.has("success");
+                    let errorRate = 0;
+                    if (hasSuccess) {
+                        const errResult = db.prepare(`SELECT COUNT(*) as errs FROM tool_call_log ${where} AND success = 0`).get(...params);
+                        errorRate = totalCalls.cnt > 0 ? (errResult.errs / totalCalls.cnt) * 100 : 0;
+                    }
+                    return {
+                        totalCalls: totalCalls.cnt,
+                        avgDurationMs: Math.round(avgDuration),
+                        totalTokens,
+                        topTools,
+                        errorRate: Math.round(errorRate * 10) / 10,
+                    };
+                }
+                const stats = getStats(args.session_id);
+                // Cost estimates (rough: $0.003 per 1K tokens for Claude Haiku, $0.015 for Sonnet)
+                const estimatedCost = (stats.totalTokens / 1000) * 0.003;
+                // Time savings estimate (assume 5 min manual per tool call)
+                const manualMinutes = stats.totalCalls * 5;
+                const automatedMinutes = (stats.totalCalls * stats.avgDurationMs) / 60_000;
+                const timeSavedMinutes = Math.max(0, manualMinutes - automatedMinutes);
+                // TOON savings estimate (~40% compression)
+                const toonSavedTokens = Math.round(stats.totalTokens * 0.4);
+                const result = {
+                    period: `Last ${days} days`,
+                    totalToolCalls: stats.totalCalls,
+                    avgLatencyMs: stats.avgDurationMs,
+                    totalTokens: stats.totalTokens,
+                    toonSavedTokens,
+                    estimatedCostUsd: Math.round(estimatedCost * 100) / 100,
+                    timeSavedMinutes: Math.round(timeSavedMinutes),
+                    timeSavedHours: Math.round(timeSavedMinutes / 60 * 10) / 10,
+                    errorRate: `${stats.errorRate}%`,
+                    topTools: stats.topTools,
+                };
+                // Comparison mode
+                if (args.compare_session_id && hasSession) {
+                    const compareStats = getStats(args.compare_session_id);
+                    result.comparison = {
+                        baseSession: args.session_id || "all",
+                        compareSession: args.compare_session_id,
+                        callsDelta: stats.totalCalls - compareStats.totalCalls,
+                        tokensDelta: stats.totalTokens - compareStats.totalTokens,
+                        latencyDelta: stats.avgDurationMs - compareStats.avgDurationMs,
+                        errorRateDelta: stats.errorRate - compareStats.errorRate,
+                    };
+                }
+                db.close();
+                return result;
+            }
+            catch (e) {
+                db.close();
+                return { error: `Analytics query failed: ${e.message}` };
+            }
+        },
+    },
+];
+//# sourceMappingURL=savingsTools.js.map

package/dist/tools/savingsTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"savingsTools.js","sourceRoot":"","sources":["../../src/tools/savingsTools.ts"],"names":[],"mappings":"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"}

package/dist/tools/scenarioCompilerTools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * scenarioCompilerTools.ts — MiroFish-essence scenario compiler.
+ *
+ * Compresses swarm simulation into structured passes:
+ * 1. Map entities, workflows, incentives, timelines
+ * 2. Identify live constraints and tensions
+ * 3. Generate 3-7 future branches (not 3000 agents)
+ * 4. Score each branch by probability, impact, decisiveness
+ *
+ * This is the "preemptive predictive history" layer:
+ * Right context, right order, better odds of right judgment. Never certainty.
+ */
+import type { McpTool } from "../types.js";
+export declare const scenarioCompilerTools: McpTool[];