decibel-tools-mcp 1.0.6 → 1.0.8

package/dist/tools/registry.js

@@ -0,0 +1,189 @@
+// ============================================================================
+// Registry Tools
+// ============================================================================
+// MCP tools for managing the project registry.
+// ============================================================================
+import { z } from 'zod';
+import { listProjects, registerProject, unregisterProject, addProjectAlias, getRegistryFilePath, resolveProject, } from '../projectRegistry.js';
+// ============================================================================
+// Tool Registration
+// ============================================================================
+export function registerRegistryTools(server) {
+    // -------------------------------------------------------------------------
+    // registry_list - List all registered projects
+    // -------------------------------------------------------------------------
+    server.tool('registry_list', 'List all registered projects in the Decibel registry. Shows project IDs, paths, and aliases.', {}, async () => {
+        const projects = listProjects();
+        const registryPath = getRegistryFilePath();
+        if (projects.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            registryPath,
+                            projects: [],
+                            message: 'No projects registered. Use registry_add to register a project.',
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        registryPath,
+                        projectCount: projects.length,
+                        projects: projects.map((p) => ({
+                            id: p.id,
+                            name: p.name,
+                            path: p.path,
+                            aliases: p.aliases || [],
+                        })),
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    // -------------------------------------------------------------------------
+    // registry_add - Register a new project
+    // -------------------------------------------------------------------------
+    server.tool('registry_add', 'Register a project in the Decibel registry. The project path must contain a .decibel folder.', {
+        id: z.string().describe('Unique project ID (typically the directory name)'),
+        path: z.string().describe('Absolute path to the project root (must contain .decibel/)'),
+        name: z.string().optional().describe('Human-readable project name'),
+        aliases: z
+            .array(z.string())
+            .optional()
+            .describe('Alternative names/shortcuts for this project'),
+    }, async ({ id, path, name, aliases }) => {
+        try {
+            registerProject({ id, path, name, aliases });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            message: `Project "${id}" registered successfully`,
+                            project: { id, path, name, aliases },
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: err instanceof Error ? err.message : String(err),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    });
+    // -------------------------------------------------------------------------
+    // registry_remove - Remove a project from the registry
+    // -------------------------------------------------------------------------
+    server.tool('registry_remove', 'Remove a project from the Decibel registry. Does not delete project files.', {
+        id: z.string().describe('Project ID to remove'),
+    }, async ({ id }) => {
+        const removed = unregisterProject(id);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        success: removed,
+                        message: removed
+                            ? `Project "${id}" removed from registry`
+                            : `Project "${id}" not found in registry`,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    // -------------------------------------------------------------------------
+    // registry_alias - Add an alias to an existing project
+    // -------------------------------------------------------------------------
+    server.tool('registry_alias', 'Add an alias (shortcut name) to an existing project in the registry.', {
+        id: z.string().describe('Project ID to add alias to'),
+        alias: z.string().describe('Alias to add (e.g., "senken" as alias for "senken-trading-agent")'),
+    }, async ({ id, alias }) => {
+        try {
+            addProjectAlias(id, alias);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            message: `Alias "${alias}" added to project "${id}"`,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            error: err instanceof Error ? err.message : String(err),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    });
+    // -------------------------------------------------------------------------
+    // registry_resolve - Test resolution of a project ID
+    // -------------------------------------------------------------------------
+    server.tool('registry_resolve', 'Test resolution of a project ID/alias. Shows which project would be resolved and how.', {
+        projectId: z.string().describe('Project ID, alias, or path to resolve'),
+    }, async ({ projectId }) => {
+        try {
+            const entry = resolveProject(projectId);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            input: projectId,
+                            resolved: {
+                                id: entry.id,
+                                name: entry.name,
+                                path: entry.path,
+                                aliases: entry.aliases,
+                            },
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: false,
+                            input: projectId,
+                            error: err instanceof Error ? err.message : String(err),
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

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

package/dist/tools/toolsIndex.d.ts

@@ -0,0 +1,5 @@
+import { ToolSpec } from './types.js';
+export declare const modularTools: ToolSpec[];
+export declare const modularToolMap: Map<string, ToolSpec>;
+export declare function getModularToolNames(): string[];
+//# sourceMappingURL=toolsIndex.d.ts.map

package/dist/tools/toolsIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolsIndex.d.ts","sourceRoot":"","sources":["../../src/tools/toolsIndex.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAOtC,eAAO,MAAM,YAAY,EAAE,QAAQ,EAelC,CAAC;AAMF,eAAO,MAAM,cAAc,uBAE1B,CAAC;AAMF,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}

package/dist/tools/toolsIndex.js

@@ -0,0 +1,37 @@
+// ============================================================================
+// Tools Aggregator
+// ============================================================================
+// Central registry of all modular tools.
+// Domains are added here as they are migrated from server.ts.
+// ============================================================================
+import { registryTools } from './registry/index.js';
+// ============================================================================
+// Aggregate All Tools
+// ============================================================================
+export const modularTools = [
+    ...registryTools,
+    // Add more domains as they are migrated:
+    // ...sentinelTools,
+    // ...architectTools,
+    // ...dojoTools,
+    // ...designerTools,
+    // ...oracleTools,
+    // ...contextTools,
+    // ...frictionTools,
+    // ...roadmapTools,
+    // ...voiceTools,
+    // ...agenticTools,
+    // ...learningsTools,
+    // ...provenanceTools,
+];
+// ============================================================================
+// Tool Map for Fast Lookup
+// ============================================================================
+export const modularToolMap = new Map(modularTools.map(t => [t.definition.name, t]));
+// ============================================================================
+// Helper to get tool names (for debugging)
+// ============================================================================
+export function getModularToolNames() {
+    return modularTools.map(t => t.definition.name);
+}
+//# sourceMappingURL=toolsIndex.js.map

package/dist/tools/toolsIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolsIndex.js","sourceRoot":"","sources":["../../src/tools/toolsIndex.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAC/E,yCAAyC;AACzC,8DAA8D;AAC9D,+EAA+E;AAG/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAe;IACtC,GAAG,aAAa;IAChB,yCAAyC;IACzC,oBAAoB;IACpB,qBAAqB;IACrB,gBAAgB;IAChB,oBAAoB;IACpB,kBAAkB;IAClB,mBAAmB;IACnB,oBAAoB;IACpB,mBAAmB;IACnB,iBAAiB;IACjB,mBAAmB;IACnB,qBAAqB;IACrB,sBAAsB;CACvB,CAAC;AAEF,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,CACnC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAC9C,CAAC;AAEF,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAE/E,MAAM,UAAU,mBAAmB;IACjC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC"}

package/dist/tools/vector/index.d.ts

@@ -0,0 +1,9 @@
+import { ToolSpec } from '../types.js';
+export declare const vectorCreateRunTool: ToolSpec;
+export declare const vectorLogEventTool: ToolSpec;
+export declare const vectorCompleteRunTool: ToolSpec;
+export declare const vectorListRunsTool: ToolSpec;
+export declare const vectorGetRunTool: ToolSpec;
+export declare const vectorScorePromptTool: ToolSpec;
+export declare const vectorTools: ToolSpec[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/vector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/vector/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAkCvC,eAAO,MAAM,mBAAmB,EAAE,QA+DjC,CAAC;AAMF,eAAO,MAAM,kBAAkB,EAAE,QA+ChC,CAAC;AAMF,eAAO,MAAM,qBAAqB,EAAE,QAsCnC,CAAC;AAMF,eAAO,MAAM,kBAAkB,EAAE,QAqChC,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,QAkC9B,CAAC;AAMF,eAAO,MAAM,qBAAqB,EAAE,QA8BnC,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,QAAQ,EAOjC,CAAC"}

package/dist/tools/vector/index.js

@@ -0,0 +1,299 @@
+// ============================================================================
+// Vector Domain Tools
+// ============================================================================
+// MCP tools for Vector - AI session tracking and analysis.
+// Enables agents to log events, track runs, and calculate inference load.
+// ============================================================================
+import { toolSuccess, toolError, requireFields } from '../shared/index.js';
+import { createRun, logEvent, completeRun, listRuns, getRun, scorePrompt, } from '../vector.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const VALID_AGENT_TYPES = ['claude-code', 'cursor', 'replit', 'chatgpt', 'custom'];
+const VALID_EVENT_TYPES = [
+    'prompt_received', 'plan_proposed', 'assumption_made', 'clarifying_question',
+    'command_ran', 'file_touched', 'test_result', 'backtrack', 'error',
+    'user_correction', 'run_completed'
+];
+// ============================================================================
+// Create Run Tool
+// ============================================================================
+export const vectorCreateRunTool = {
+    definition: {
+        name: 'vector_create_run',
+        description: 'Start a new agent run for Vector tracking. Creates a run folder in .decibel/runs/ with prompt.json and events.jsonl. Use this at the start of any significant agent session to enable drift analysis.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                agent: {
+                    type: 'object',
+                    description: 'Information about the AI agent',
+                    properties: {
+                        type: {
+                            type: 'string',
+                            enum: ['claude-code', 'cursor', 'replit', 'chatgpt', 'custom'],
+                            description: 'The type of AI agent',
+                        },
+                        version: {
+                            type: 'string',
+                            description: 'Optional version string of the agent',
+                        },
+                    },
+                    required: ['type'],
+                },
+                raw_prompt: {
+                    type: 'string',
+                    description: 'The original prompt from the user',
+                },
+                intent: {
+                    type: 'object',
+                    description: 'Optional parsed intent from the prompt',
+                    properties: {
+                        goal: { type: 'string', description: 'What the prompt is trying to achieve' },
+                        scope: { type: 'array', items: { type: 'string' }, description: 'Files/modules in scope' },
+                        non_goals: { type: 'array', items: { type: 'string' }, description: 'Explicit exclusions' },
+                        constraints: { type: 'array', items: { type: 'string' }, description: 'Rules to follow' },
+                        acceptance: { type: 'array', items: { type: 'string' }, description: 'Success criteria' },
+                        risk_posture: { type: 'string', enum: ['safe', 'moderate', 'aggressive'] },
+                    },
+                },
+            },
+            required: ['agent', 'raw_prompt'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'agent', 'raw_prompt');
+            requireFields(input.agent, 'type');
+            if (!VALID_AGENT_TYPES.includes(input.agent.type)) {
+                throw new Error(`Invalid agent type: ${input.agent.type}. Must be one of: ${VALID_AGENT_TYPES.join(', ')}`);
+            }
+            const result = await createRun(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Log Event Tool
+// ============================================================================
+export const vectorLogEventTool = {
+    definition: {
+        name: 'vector_log_event',
+        description: 'Log an event to an existing run. Events are appended to events.jsonl and used by Vector to analyze drift, assumptions, and session flow.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                run_id: {
+                    type: 'string',
+                    description: 'The run ID to log the event to (e.g., "RUN-2026-01-10T...")',
+                },
+                type: {
+                    type: 'string',
+                    enum: [
+                        'plan_proposed', 'assumption_made', 'clarifying_question',
+                        'command_ran', 'file_touched', 'test_result', 'backtrack',
+                        'error', 'user_correction'
+                    ],
+                    description: 'The type of event. Use prompt_received and run_completed via create/complete tools.',
+                },
+                payload: {
+                    type: 'object',
+                    description: 'Event-specific payload data. Structure depends on event type.',
+                },
+            },
+            required: ['run_id', 'type'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'run_id', 'type');
+            if (!VALID_EVENT_TYPES.includes(input.type)) {
+                throw new Error(`Invalid event type: ${input.type}. Must be one of: ${VALID_EVENT_TYPES.join(', ')}`);
+            }
+            const result = await logEvent(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Complete Run Tool
+// ============================================================================
+export const vectorCompleteRunTool = {
+    definition: {
+        name: 'vector_complete_run',
+        description: 'Mark a run as complete with a summary. Creates summary.md and logs the run_completed event. Call this when an agent session ends.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                run_id: {
+                    type: 'string',
+                    description: 'The run ID to complete',
+                },
+                success: {
+                    type: 'boolean',
+                    description: 'Whether the run completed successfully',
+                },
+                summary: {
+                    type: 'string',
+                    description: 'Optional summary of what was accomplished or why it failed',
+                },
+            },
+            required: ['run_id', 'success'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'run_id', 'success');
+            const result = await completeRun(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// List Runs Tool
+// ============================================================================
+export const vectorListRunsTool = {
+    definition: {
+        name: 'vector_list_runs',
+        description: 'List recent runs for a project. Returns run metadata including agent, timestamps, event count, and completion status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                limit: {
+                    type: 'integer',
+                    description: 'Maximum number of runs to return (default: 20)',
+                },
+                agent_type: {
+                    type: 'string',
+                    enum: ['claude-code', 'cursor', 'replit', 'chatgpt', 'custom'],
+                    description: 'Filter runs by agent type',
+                },
+            },
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            if (input.agent_type && !VALID_AGENT_TYPES.includes(input.agent_type)) {
+                throw new Error(`Invalid agent type: ${input.agent_type}. Must be one of: ${VALID_AGENT_TYPES.join(', ')}`);
+            }
+            const result = await listRuns(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Get Run Tool
+// ============================================================================
+export const vectorGetRunTool = {
+    definition: {
+        name: 'vector_get_run',
+        description: 'Get details of a specific run including prompt and optionally all events. Use this to analyze a session for drift and assumptions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                run_id: {
+                    type: 'string',
+                    description: 'The run ID to retrieve',
+                },
+                include_events: {
+                    type: 'boolean',
+                    description: 'Include the full event stream (default: false)',
+                },
+            },
+            required: ['run_id'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'run_id');
+            const result = await getRun(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Score Prompt Tool
+// ============================================================================
+export const vectorScorePromptTool = {
+    definition: {
+        name: 'vector_score_prompt',
+        description: 'Calculate the inference load score for a prompt. Returns a 0-100 score indicating how much the agent will have to guess, with breakdown and suggestions for improvement. Higher score = more risk of drift.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                prompt: {
+                    type: 'string',
+                    description: 'The prompt text to analyze',
+                },
+                projectId: {
+                    type: 'string',
+                    description: 'Optional project identifier for context-aware scoring (future enhancement)',
+                },
+            },
+            required: ['prompt'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'prompt');
+            const result = scorePrompt(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Export All Tools
+// ============================================================================
+export const vectorTools = [
+    vectorCreateRunTool,
+    vectorLogEventTool,
+    vectorCompleteRunTool,
+    vectorListRunsTool,
+    vectorGetRunTool,
+    vectorScorePromptTool,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/vector/index.js.map

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