nodebench-mcp 2.6.0 → 2.8.0

package/dist/tools/toolRegistry.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Tool Registry — Central metadata catalog for all NodeBench MCP tools.
+ *
+ * Every tool gets: category, tags (for hybrid search), quickRef (what to do next),
+ * relatedTools, and phase (which methodology phase it belongs to).
+ *
+ * The progressive disclosure system uses this to:
+ * 1. Score tools by relevance (hybrid: keyword + tag + category matching)
+ * 2. Append quickRefs to every tool response (so agents always know what to do next)
+ * 3. Build tool chains (recommended sequences for common workflows)
+ */
+export interface ToolQuickRef {
+    /** 1-2 sentence guidance on what to do after calling this tool */
+    nextAction: string;
+    /** Tools commonly used after this one */
+    nextTools: string[];
+    /** Which methodology to consult for full guidance */
+    methodology?: string;
+    /** Short tip for effective use */
+    tip?: string;
+}
+export interface ToolRegistryEntry {
+    name: string;
+    category: string;
+    tags: string[];
+    quickRef: ToolQuickRef;
+    /** Where this tool sits in a typical workflow: research, implement, test, verify, ship */
+    phase: "research" | "implement" | "test" | "verify" | "ship" | "meta" | "utility";
+}
+/** Map of tool name → registry entry for O(1) lookup */
+export declare const TOOL_REGISTRY: Map<string, ToolRegistryEntry>;
+/** All registry entries as array */
+export declare const ALL_REGISTRY_ENTRIES: ToolRegistryEntry[];
+/** Get quick ref for a tool, with fallback for unregistered tools */
+export declare function getQuickRef(toolName: string): ToolQuickRef | null;
+/** Get all tools in a category */
+export declare function getToolsByCategory(category: string): ToolRegistryEntry[];
+/** Get all tools in a workflow phase */
+export declare function getToolsByPhase(phase: ToolRegistryEntry["phase"]): ToolRegistryEntry[];
+export interface SearchResult {
+    name: string;
+    description: string;
+    category: string;
+    score: number;
+    quickRef: ToolQuickRef;
+    phase: string;
+    tags: string[];
+}
+/**
+ * Hybrid search: scores tools by relevance using keyword matching across
+ * name, tags, description, and category. Returns sorted results.
+ */
+export declare function hybridSearch(query: string, tools: Array<{
+    name: string;
+    description: string;
+}>, options?: {
+    category?: string;
+    phase?: string;
+    limit?: number;
+}): SearchResult[];
+export interface WorkflowChain {
+    name: string;
+    description: string;
+    steps: Array<{
+        tool: string;
+        action: string;
+    }>;
+}
+/** Pre-built workflow chains for common tasks */
+export declare const WORKFLOW_CHAINS: Record<string, WorkflowChain>;