nodebench-mcp 2.70.0 → 3.0.1

package/dist/subconscious/tools.js

@@ -0,0 +1,255 @@
+/**
+ * Subconscious MCP Tools — 10 tools for querying subconscious state + graph.
+ */
+import { getAllBlocks, getBlock, updateBlock, getStaleBlocks, getBlockSummary, ALL_BLOCK_TYPES, } from "./blocks.js";
+import { generateWhisper } from "./whisperPolicy.js";
+import { traverseGraph, findContradictions, traceLineage, resolveEntity, getGraphSummary, } from "./graphEngine.js";
+export const subconsciousTools = [
+    // ── Block Tools ────────────────────────────────────────────────────────
+    {
+        name: "get_company_truth",
+        description: "Get current canonical company truth from subconscious memory blocks. " +
+            "Returns all populated blocks or specific ones by ID. " +
+            "Block types: founder_identity, company_identity, current_wedge, top_priorities, " +
+            "open_contradictions, readiness_gaps, validated_workflows, recent_important_changes, " +
+            "entity_watchlist, agent_preferences, artifact_preferences, packet_lineage.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                blocks: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Specific block IDs to retrieve. Omit for all blocks.",
+                },
+            },
+        },
+        handler: async (args) => {
+            if (args.blocks && args.blocks.length > 0) {
+                const validIds = args.blocks.filter((b) => ALL_BLOCK_TYPES.includes(b));
+                const blocks = validIds.map(getBlock);
+                return { blocks };
+            }
+            return { blocks: getAllBlocks().filter((b) => b.value.length > 0) };
+        },
+    },
+    {
+        name: "update_company_truth",
+        description: "Update a subconscious memory block with new information. " +
+            "Use when the user states company facts, changes direction, or corrects assumptions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                block_id: {
+                    type: "string",
+                    description: "Block ID to update (e.g. 'current_wedge', 'company_identity')",
+                },
+                value: { type: "string", description: "New block content (markdown)" },
+                confidence: {
+                    type: "string",
+                    enum: ["high", "medium", "low"],
+                    description: "Confidence level. Default: medium.",
+                },
+            },
+            required: ["block_id", "value"],
+        },
+        handler: async (args) => {
+            if (!ALL_BLOCK_TYPES.includes(args.block_id)) {
+                return { error: `Invalid block_id. Valid: ${ALL_BLOCK_TYPES.join(", ")}` };
+            }
+            const updated = updateBlock(args.block_id, {
+                value: args.value,
+                confidence: args.confidence ?? "medium",
+                sourceEvent: `manual_update_${Date.now()}`,
+            });
+            return { updated };
+        },
+    },
+    {
+        name: "get_subconscious_hint",
+        description: "Get the subconscious's current guidance for a task. " +
+            "Classifies the prompt, selects relevant memory blocks, checks for " +
+            "contradictions and stale packets, and generates a whisper.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task: { type: "string", description: "Description of the current task" },
+                mode: {
+                    type: "string",
+                    enum: ["whisper", "packet", "full"],
+                    description: "Injection verbosity. Default: whisper.",
+                },
+                session_id: {
+                    type: "string",
+                    description: "Session ID for dedup tracking. Default: anonymous.",
+                },
+            },
+            required: ["task"],
+        },
+        handler: async (args) => {
+            const result = generateWhisper(args.task, args.session_id ?? "anonymous", args.mode ?? "whisper");
+            return {
+                classification: result.classification.classification,
+                confidence: result.classification.confidence,
+                entities: result.classification.entities,
+                whisper: result.whisperText,
+                suppressed: result.suppressed,
+                suppressionReason: result.suppressionReason,
+                contradictions: result.contradictions,
+                stalePackets: result.stalePackets,
+                blocksUsed: result.blockIdsUsed,
+            };
+        },
+    },
+    {
+        name: "list_contradictions",
+        description: "List all open contradictions between memory blocks and graph entities.",
+        inputSchema: { type: "object", properties: {} },
+        handler: async () => {
+            const block = getBlock("open_contradictions");
+            return {
+                blockContent: block.value || "(no contradictions recorded)",
+                version: block.version,
+                confidence: block.confidence,
+                updatedAt: block.updatedAt,
+            };
+        },
+    },
+    {
+        name: "list_stale_packets",
+        description: "List memory blocks and packets that need refresh.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                max_age_days: {
+                    type: "number",
+                    description: "Max age in days before a block is considered stale. Default: 7.",
+                },
+            },
+        },
+        handler: async (args) => {
+            const stale = getStaleBlocks(args.max_age_days ?? 7);
+            return {
+                staleCount: stale.length,
+                staleBlocks: stale.map((b) => ({
+                    id: b.id,
+                    label: b.label,
+                    lastUpdated: b.updatedAt,
+                    version: b.version,
+                })),
+            };
+        },
+    },
+    {
+        name: "refresh_subconscious",
+        description: "Get a summary of all subconscious memory blocks and their status.",
+        inputSchema: { type: "object", properties: {} },
+        handler: async () => {
+            return {
+                summary: getBlockSummary(),
+                staleCount: getStaleBlocks(7).length,
+                totalBlocks: ALL_BLOCK_TYPES.length,
+                populatedBlocks: getAllBlocks().filter((b) => b.value.length > 0).length,
+            };
+        },
+    },
+    // ── Graph Tools ────────────────────────────────────────────────────────
+    {
+        name: "traverse_entity_graph",
+        description: "Find all entities and relationships connected to a starting entity within N hops. " +
+            "Uses BFS traversal on the knowledge graph.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entity: { type: "string", description: "Entity name or ID to start from" },
+                max_depth: {
+                    type: "number",
+                    description: "Max traversal depth (1-3). Default: 2.",
+                },
+                relation_filter: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Filter by relation type (e.g. ['contradicts', 'supports']). Omit for all.",
+                },
+            },
+            required: ["entity"],
+        },
+        handler: async (args) => {
+            const resolved = resolveEntity(args.entity);
+            if (!resolved)
+                return { error: `Entity not found: ${args.entity}` };
+            const results = traverseGraph(resolved.id, Math.min(args.max_depth ?? 2, 3), args.relation_filter);
+            return {
+                startEntity: { id: resolved.id, label: resolved.label, kind: resolved.kind },
+                connected: results.map((r) => ({
+                    entity: { id: r.entity.id, label: r.entity.label, kind: r.entity.kind },
+                    hopDistance: r.hopDistance,
+                    reachedVia: r.reachedVia,
+                    confidence: r.confidence,
+                    pathLength: r.path.length,
+                })),
+                totalResults: results.length,
+            };
+        },
+    },
+    {
+        name: "find_contradictions_for",
+        description: "Find all entities that contradict a given entity or concept.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entity: { type: "string", description: "Entity name or ID" },
+            },
+            required: ["entity"],
+        },
+        handler: async (args) => {
+            const resolved = resolveEntity(args.entity);
+            if (!resolved)
+                return { error: `Entity not found: ${args.entity}` };
+            const contradictions = findContradictions(resolved.id, 2);
+            return {
+                entity: { id: resolved.id, label: resolved.label, kind: resolved.kind },
+                contradictions: contradictions.map((c) => ({
+                    entity: { id: c.entity.id, label: c.entity.label, kind: c.entity.kind },
+                    confidence: c.confidence,
+                    hopDistance: c.hopDistance,
+                })),
+            };
+        },
+    },
+    {
+        name: "get_packet_lineage",
+        description: "Trace the full derivation chain for a packet or entity.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entity: { type: "string", description: "Packet or entity name/ID" },
+                max_depth: { type: "number", description: "Max chain depth. Default: 5." },
+            },
+            required: ["entity"],
+        },
+        handler: async (args) => {
+            const resolved = resolveEntity(args.entity);
+            if (!resolved)
+                return { error: `Entity not found: ${args.entity}` };
+            const lineage = traceLineage(resolved.id, args.max_depth ?? 5);
+            return {
+                entity: { id: resolved.id, label: resolved.label, kind: resolved.kind },
+                lineage: lineage.map((l) => ({
+                    entity: { id: l.entity.id, label: l.entity.label, kind: l.entity.kind },
+                    relation: l.reachedVia,
+                    hopDistance: l.hopDistance,
+                    confidence: l.confidence,
+                })),
+            };
+        },
+    },
+    {
+        name: "get_entity_graph_summary",
+        description: "Get a summary of the knowledge graph: entity counts by type, edge counts by relation, recent additions.",
+        inputSchema: { type: "object", properties: {} },
+        handler: async () => {
+            return getGraphSummary();
+        },
+    },
+];
+//# sourceMappingURL=tools.js.map

package/dist/subconscious/tools.js.map

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

package/dist/subconscious/whisperPolicy.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Whisper Policy — decides what to inject and what to suppress.
+ *
+ * Suppression-first: default is NO whisper unless high-value signal.
+ * Classification-driven: prompt type determines which blocks to inject.
+ */
+import { type BlockType } from "./blocks.js";
+import { type ClassificationResult } from "./classifier.js";
+export type SubconsciousMode = "off" | "whisper" | "packet" | "full" | "review";
+export interface WhisperResult {
+    mode: SubconsciousMode;
+    classification: ClassificationResult;
+    whisperText: string;
+    suppressed: boolean;
+    suppressionReason: string | null;
+    blockIdsUsed: BlockType[];
+    contradictions: string[];
+    stalePackets: string[];
+}
+export declare function generateWhisper(prompt: string, sessionId: string, mode?: SubconsciousMode): WhisperResult;

package/dist/subconscious/whisperPolicy.js

@@ -0,0 +1,171 @@
+/**
+ * Whisper Policy — decides what to inject and what to suppress.
+ *
+ * Suppression-first: default is NO whisper unless high-value signal.
+ * Classification-driven: prompt type determines which blocks to inject.
+ */
+import { getBlocksByIds, getBlock, getStaleBlocks, logWhisper, getRecentWhispers } from "./blocks.js";
+import { classifyPrompt, isTrivialPrompt } from "./classifier.js";
+import { findContradictions, resolveEntity } from "./graphEngine.js";
+// ── Token Budgets ──────────────────────────────────────────────────────────
+const TOKEN_BUDGETS = {
+    off: 0,
+    whisper: 200,
+    packet: 1000,
+    full: 2000,
+    review: 0,
+};
+// ── Main Whisper Generator ─────────────────────────────────────────────────
+export function generateWhisper(prompt, sessionId, mode = "whisper") {
+    const classification = classifyPrompt(prompt);
+    // Mode: off or review → no injection
+    if (mode === "off" || mode === "review") {
+        return {
+            mode,
+            classification,
+            whisperText: "",
+            suppressed: true,
+            suppressionReason: `mode=${mode}`,
+            blockIdsUsed: [],
+            contradictions: [],
+            stalePackets: [],
+        };
+    }
+    // Suppression check: trivial prompts
+    if (isTrivialPrompt(prompt)) {
+        const result = {
+            mode,
+            classification,
+            whisperText: "",
+            suppressed: true,
+            suppressionReason: "trivial_prompt",
+            blockIdsUsed: [],
+            contradictions: [],
+            stalePackets: [],
+        };
+        logWhisper({
+            sessionId,
+            blockIds: [],
+            whisperText: "",
+            classification: classification.classification,
+            suppressed: true,
+            reason: "trivial_prompt",
+        });
+        return result;
+    }
+    // Suppression check: duplicate whisper (same classification <3 prompts ago)
+    const recentWhispers = getRecentWhispers(sessionId, 3);
+    const recentSameClass = recentWhispers.filter((w) => !w.suppressed && w.classification === classification.classification);
+    if (recentSameClass.length >= 2) {
+        const result = {
+            mode,
+            classification,
+            whisperText: "",
+            suppressed: true,
+            suppressionReason: "duplicate_recent",
+            blockIdsUsed: [],
+            contradictions: [],
+            stalePackets: [],
+        };
+        logWhisper({
+            sessionId,
+            blockIds: [],
+            whisperText: "",
+            classification: classification.classification,
+            suppressed: true,
+            reason: "duplicate_recent",
+        });
+        return result;
+    }
+    // Build whisper content
+    const blocks = getBlocksByIds(classification.relevantBlocks);
+    const populatedBlocks = blocks.filter((b) => b.value.length > 0);
+    const lines = [];
+    const blockIdsUsed = [];
+    // Check for contradictions via graph traversal
+    const contradictions = [];
+    for (const entityName of classification.entities) {
+        const entity = resolveEntity(entityName);
+        if (!entity)
+            continue;
+        const contradictionResults = findContradictions(entity.id, 2);
+        for (const cr of contradictionResults.slice(0, 2)) {
+            contradictions.push(`"${entity.label}" contradicts "${cr.entity.label}" (via ${cr.reachedVia}, confidence ${(cr.confidence * 100).toFixed(0)}%)`);
+        }
+    }
+    // Check for stale packets
+    const stalePackets = [];
+    const packetLineage = getBlock("packet_lineage");
+    if (packetLineage.value.length > 0) {
+        const staleBlocks = getStaleBlocks(7);
+        for (const sb of staleBlocks.slice(0, 3)) {
+            stalePackets.push(`${sb.label} (last updated: ${sb.updatedAt.split("T")[0]})`);
+        }
+    }
+    // Build whisper text based on mode
+    if (mode === "whisper") {
+        // 1-3 lines max
+        if (contradictions.length > 0) {
+            lines.push(`Contradiction: ${contradictions[0]}`);
+        }
+        if (populatedBlocks.length > 0) {
+            const topBlock = populatedBlocks[0];
+            const firstLine = topBlock.value.split("\n")[0].slice(0, 100);
+            lines.push(`${topBlock.label}: ${firstLine}`);
+            blockIdsUsed.push(topBlock.id);
+        }
+        if (stalePackets.length > 0) {
+            lines.push(`Stale: ${stalePackets[0]}`);
+        }
+    }
+    else if (mode === "packet" || mode === "full") {
+        // Richer injection
+        if (contradictions.length > 0) {
+            lines.push("Contradictions:");
+            for (const c of contradictions)
+                lines.push(`  - ${c}`);
+        }
+        for (const block of populatedBlocks) {
+            const budget = mode === "full" ? 500 : 200;
+            const truncated = block.value.slice(0, budget);
+            lines.push(`\n[${block.label}] (v${block.version}, ${block.confidence})`);
+            lines.push(truncated);
+            blockIdsUsed.push(block.id);
+        }
+        if (stalePackets.length > 0) {
+            lines.push("\nStale blocks:");
+            for (const sp of stalePackets)
+                lines.push(`  - ${sp}`);
+        }
+    }
+    // Truncate to token budget (rough: 4 chars per token)
+    const budget = TOKEN_BUDGETS[mode];
+    let whisperText = lines.join("\n");
+    if (whisperText.length > budget * 4) {
+        whisperText = whisperText.slice(0, budget * 4) + "\n...";
+    }
+    // Wrap in XML tag for Claude Code injection
+    if (whisperText.length > 0) {
+        whisperText = `<nodebench_whisper>\n${whisperText}\n</nodebench_whisper>`;
+    }
+    // Log
+    logWhisper({
+        sessionId,
+        blockIds: blockIdsUsed,
+        whisperText,
+        classification: classification.classification,
+        suppressed: false,
+        reason: null,
+    });
+    return {
+        mode,
+        classification,
+        whisperText,
+        suppressed: whisperText.length === 0,
+        suppressionReason: whisperText.length === 0 ? "no_relevant_blocks" : null,
+        blockIdsUsed,
+        contradictions,
+        stalePackets,
+    };
+}
+//# sourceMappingURL=whisperPolicy.js.map

package/dist/subconscious/whisperPolicy.js.map

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

package/dist/sweep/engine.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Sweep Engine — runs all data source collectors in parallel,
+ * computes deltas, and produces the top signal for auto-fire.
+ *
+ * Pattern: Crucix's briefing.mjs master orchestrator
+ * Architecture: DeerFlow's sub-agent parallel dispatch
+ *
+ * Each source is a self-contained module that exports collect().
+ * The engine runs them all with timeouts, collects signals,
+ * computes what changed since last sweep, and identifies the
+ * top entity for the landing page.
+ */
+import type { SweepSignal, SweepResult, DeltaResult, SourceCollector } from "./types.js";
+export declare function registerSource(name: string, collect: SourceCollector): void;
+export declare function runSweep(): Promise<SweepResult>;
+export declare function computeDelta(current: SweepResult, previous: SweepResult | null): DeltaResult;
+export declare function initSweepTables(): void;
+export declare function getLatestSweep(): SweepResult | null;
+export declare function getPreviousSweep(): SweepResult | null;
+export interface Recommendation {
+    signal: SweepSignal;
+    action: string;
+    reasoning: string;
+    urgency: "act_now" | "this_week" | "monitor";
+    category: "competitive" | "opportunity" | "risk" | "market";
+}
+export declare function generateRecommendations(signals: SweepSignal[]): Recommendation[];