@decibelsystems/tools 2.0.0

package/dist/tools/coordinator/index.js

@@ -0,0 +1,381 @@
+// ============================================================================
+// Coordinator Domain Tools (ADR-0004)
+// ============================================================================
+// Minimal multi-chat coordination: locks, agents, event log.
+// Design: single-writer per resource, fail loud on conflicts.
+// ============================================================================
+import { toolSuccess, toolError, requireFields, withRunTracking } from '../shared/index.js';
+import { coordRegister, coordHeartbeat, coordLock, coordUnlock, coordStatus, coordLog, coordSend, coordInbox, coordAck, isCoordError, } from './coordinator.js';
+// ============================================================================
+// coord_register
+// ============================================================================
+export const coordRegisterTool = {
+    definition: {
+        name: 'coord_register',
+        description: 'Register an agent with the coordinator. Call this when an agent starts up to announce its presence and capabilities.',
+        annotations: {
+            title: 'Register Agent',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: {
+                    type: 'string',
+                    description: 'Unique identifier for this agent (e.g., "cymoril-code", "cymoril-test")',
+                },
+                capabilities: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'What this agent can do (e.g., ["code", "architecture", "refactor"])',
+                },
+                project_id: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+            },
+            required: ['agent_id', 'capabilities'],
+        },
+    },
+    handler: withRunTracking(async (args) => {
+        const input = args;
+        requireFields(input, 'agent_id', 'capabilities');
+        const result = await coordRegister(input);
+        if (isCoordError(result)) {
+            return toolError(result.error, result.message);
+        }
+        return toolSuccess(result);
+    }, { toolName: 'coord_register' }),
+};
+// ============================================================================
+// coord_heartbeat
+// ============================================================================
+export const coordHeartbeatTool = {
+    definition: {
+        name: 'coord_heartbeat',
+        description: 'Send a heartbeat to keep agent alive and optionally update status. Also cleans up stale agents and releases their locks. Call every 60s.',
+        annotations: {
+            title: 'Agent Heartbeat',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: {
+                    type: 'string',
+                    description: 'The agent sending the heartbeat',
+                },
+                current_task: {
+                    type: 'string',
+                    description: 'What the agent is currently working on',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['active', 'busy', 'idle'],
+                    description: 'Current agent status',
+                },
+                project_id: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+            },
+            required: ['agent_id'],
+        },
+    },
+    handler: withRunTracking(async (args) => {
+        const input = args;
+        requireFields(input, 'agent_id');
+        const result = await coordHeartbeat(input);
+        if (isCoordError(result)) {
+            return toolError(result.error, result.message);
+        }
+        return toolSuccess(result);
+    }, { toolName: 'coord_heartbeat' }),
+};
+// ============================================================================
+// coord_lock
+// ============================================================================
+export const coordLockTool = {
+    definition: {
+        name: 'coord_lock',
+        description: 'Acquire an exclusive lock on a resource. FAILS LOUD if already held by another agent. Locks expire after 10 minutes. Re-locking same resource by same agent refreshes the lock (idempotent).',
+        annotations: {
+            title: 'Acquire Lock',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: {
+                    type: 'string',
+                    description: 'The agent requesting the lock',
+                },
+                resource: {
+                    type: 'string',
+                    description: 'Resource to lock (file path, tool name, or domain like "domain:testing")',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'Why you need this lock (for audit trail)',
+                },
+                project_id: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+            },
+            required: ['agent_id', 'resource'],
+        },
+    },
+    handler: withRunTracking(async (args) => {
+        const input = args;
+        requireFields(input, 'agent_id', 'resource');
+        const result = await coordLock(input);
+        if (isCoordError(result)) {
+            return toolError(result.error, result.message);
+        }
+        return toolSuccess(result);
+    }, { toolName: 'coord_lock' }),
+};
+// ============================================================================
+// coord_unlock
+// ============================================================================
+export const coordUnlockTool = {
+    definition: {
+        name: 'coord_unlock',
+        description: 'Release a lock on a resource. Only the lock owner can release it. No-op if not held (idempotent).',
+        annotations: {
+            title: 'Release Lock',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: {
+                    type: 'string',
+                    description: 'The agent releasing the lock',
+                },
+                resource: {
+                    type: 'string',
+                    description: 'Resource to unlock',
+                },
+                project_id: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+            },
+            required: ['agent_id', 'resource'],
+        },
+    },
+    handler: withRunTracking(async (args) => {
+        const input = args;
+        requireFields(input, 'agent_id', 'resource');
+        const result = await coordUnlock(input);
+        if (isCoordError(result)) {
+            return toolError(result.error, result.message);
+        }
+        return toolSuccess(result);
+    }, { toolName: 'coord_unlock' }),
+};
+// ============================================================================
+// coord_status
+// ============================================================================
+export const coordStatusTool = {
+    definition: {
+        name: 'coord_status',
+        description: 'Get current coordination status: all registered agents, active locks, and stale agents.',
+        annotations: {
+            title: 'Coordination Status',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+            },
+            required: [],
+        },
+    },
+    handler: withRunTracking(async (args) => {
+        const input = args;
+        const result = await coordStatus(input);
+        if (isCoordError(result)) {
+            return toolError(result.error, result.message);
+        }
+        return toolSuccess(result);
+    }, { toolName: 'coord_status' }),
+};
+// ============================================================================
+// coord_log
+// ============================================================================
+export const coordLogTool = {
+    definition: {
+        name: 'coord_log',
+        description: 'Query coordination event log. Returns recent events, optionally filtered by agent or action type.',
+        annotations: {
+            title: 'Query Event Log',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: {
+                    type: 'string',
+                    description: 'Optional project identifier. Uses default project if not specified.',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum events to return (default: 50)',
+                },
+                agent_id: {
+                    type: 'string',
+                    description: 'Filter by agent ID',
+                },
+                action: {
+                    type: 'string',
+                    description: 'Filter by action (e.g., "lock_acquired", "lock_denied", "registered")',
+                },
+            },
+            required: [],
+        },
+    },
+    handler: withRunTracking(async (args) => {
+        const input = args;
+        const result = await coordLog(input);
+        if (isCoordError(result)) {
+            return toolError(result.error, result.message);
+        }
+        return toolSuccess(result);
+    }, { toolName: 'coord_log' }),
+};
+// ============================================================================
+// coord_send (4a: agent messaging)
+// ============================================================================
+export const coordSendTool = {
+    definition: {
+        name: 'coord_send',
+        description: 'Send a message to another agent\'s persistent inbox. Messages persist across restarts. Use reply_to for request-reply patterns.',
+        annotations: {
+            title: 'Send Message',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                to: { type: 'string', description: 'Target agent ID' },
+                from: { type: 'string', description: 'Sender agent ID' },
+                intent: { type: 'string', description: 'Message intent (e.g., "delegate_task", "request_review", "notify")' },
+                payload: { type: 'object', description: 'Message payload (action-specific data)', additionalProperties: true },
+                reply_to: { type: 'string', description: 'Message ID this is replying to (for request-reply)' },
+                ttl_ms: { type: 'number', description: 'Time-to-live in ms (default: 24 hours)' },
+                project_id: { type: 'string', description: 'Optional project identifier' },
+            },
+            required: ['to', 'from', 'intent', 'payload'],
+        },
+    },
+    handler: withRunTracking(async (args) => {
+        const input = args;
+        requireFields(input, 'to', 'from', 'intent', 'payload');
+        const result = await coordSend(input);
+        if (isCoordError(result))
+            return toolError(result.error, result.message);
+        return toolSuccess(result);
+    }, { toolName: 'coord_send' }),
+};
+// ============================================================================
+// coord_inbox (4a: agent messaging)
+// ============================================================================
+export const coordInboxTool = {
+    definition: {
+        name: 'coord_inbox',
+        description: 'Check an agent\'s message inbox. Returns pending messages by default. Filter by status to see acked or completed messages.',
+        annotations: {
+            title: 'Check Inbox',
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agent_id: { type: 'string', description: 'Agent whose inbox to check' },
+                status: { type: 'string', enum: ['pending', 'acked', 'completed'], description: 'Filter by message status' },
+                limit: { type: 'number', description: 'Max messages to return (default: 20)' },
+                project_id: { type: 'string', description: 'Optional project identifier' },
+            },
+            required: ['agent_id'],
+        },
+    },
+    handler: withRunTracking(async (args) => {
+        const input = args;
+        requireFields(input, 'agent_id');
+        const result = await coordInbox(input);
+        if (isCoordError(result))
+            return toolError(result.error, result.message);
+        return toolSuccess(result);
+    }, { toolName: 'coord_inbox' }),
+};
+// ============================================================================
+// coord_ack (4a: agent messaging)
+// ============================================================================
+export const coordAckTool = {
+    definition: {
+        name: 'coord_ack',
+        description: 'Acknowledge a message and optionally post a result. Status goes pending→acked (no result) or pending→completed (with result). Can also complete a previously acked message.',
+        annotations: {
+            title: 'Acknowledge Message',
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                message_id: { type: 'string', description: 'ID of the message to acknowledge' },
+                agent_id: { type: 'string', description: 'Agent acknowledging the message' },
+                result: { type: 'object', description: 'Optional result to attach (marks message as completed)', additionalProperties: true },
+                project_id: { type: 'string', description: 'Optional project identifier' },
+            },
+            required: ['message_id', 'agent_id'],
+        },
+    },
+    handler: withRunTracking(async (args) => {
+        const input = args;
+        requireFields(input, 'message_id', 'agent_id');
+        const result = await coordAck(input);
+        if (isCoordError(result))
+            return toolError(result.error, result.message);
+        return toolSuccess(result);
+    }, { toolName: 'coord_ack' }),
+};
+// ============================================================================
+// Export All Tools
+// ============================================================================
+export const coordinatorTools = [
+    coordRegisterTool,
+    coordHeartbeatTool,
+    coordLockTool,
+    coordUnlockTool,
+    coordStatusTool,
+    coordLogTool,
+    coordSendTool,
+    coordInboxTool,
+    coordAckTool,
+];
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,5 @@
+import { ToolSpec } from '../types.js';
+export declare const corpusSearchTool: ToolSpec;
+export declare const corpusStatusTool: ToolSpec;
+export declare const corpusTools: ToolSpec[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/corpus/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAoBvC,eAAO,MAAM,gBAAgB,EAAE,QAoD9B,CAAC;AAMF,eAAO,MAAM,gBAAgB,EAAE,QA8B9B,CAAC;AAMF,eAAO,MAAM,WAAW,EAAE,QAAQ,EAGjC,CAAC"}

package/dist/tools/corpus/index.js

@@ -0,0 +1,105 @@
+// ============================================================================
+// Corpus Domain Tools
+// ============================================================================
+// MCP tools for searching decibel-corpus - the shared knowledge base.
+// Enables cross-project learning from patterns, playbooks, and field notes.
+// ============================================================================
+import { toolSuccess, toolError, requireFields } from '../shared/index.js';
+import { corpusSearch, getCorpusPath, corpusExists, } from '../corpus.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const VALID_TYPES = ['pattern', 'playbook', 'field-note', 'all'];
+// ============================================================================
+// Corpus Search Tool
+// ============================================================================
+export const corpusSearchTool = {
+    definition: {
+        name: 'corpus_search',
+        description: `Search decibel-corpus for patterns, playbooks, and field notes. Use when you encounter problems that may have been solved before (DB collisions, auth patterns, deployment issues, webhook retries, etc.). Returns matching documents with snippets and relevance scores.`,
+        annotations: {
+            title: 'Search Corpus',
+            readOnlyHint: true,
+            destructiveHint: false,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search terms (e.g., "duplicate key", "advisory lock", "webhook retry", "rate limit")',
+                },
+                type: {
+                    type: 'string',
+                    enum: ['pattern', 'playbook', 'field-note', 'all'],
+                    description: 'Filter by content type. Patterns are reusable solutions, playbooks are step-by-step guides, field-notes are lessons learned. Default: all',
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum results to return (default: 5)',
+                },
+            },
+            required: ['query'],
+        },
+    },
+    handler: async (args) => {
+        try {
+            const input = args;
+            requireFields(input, 'query');
+            if (input.type && !VALID_TYPES.includes(input.type)) {
+                throw new Error(`Invalid type: ${input.type}. Must be one of: ${VALID_TYPES.join(', ')}`);
+            }
+            // Check if corpus exists
+            if (!await corpusExists()) {
+                return toolError(`Corpus not found at ${getCorpusPath()}`, 'Clone decibel-corpus to ~/Documents/GitHub/decibel-corpus or set DECIBEL_CORPUS_PATH');
+            }
+            const result = await corpusSearch(input);
+            return toolSuccess(result);
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Corpus Status Tool (for debugging)
+// ============================================================================
+export const corpusStatusTool = {
+    definition: {
+        name: 'corpus_status',
+        description: 'Check the status of decibel-corpus. Shows location and whether it exists.',
+        annotations: {
+            title: 'Corpus Status',
+            readOnlyHint: true,
+            destructiveHint: false,
+        },
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    handler: async () => {
+        try {
+            const path = getCorpusPath();
+            const exists = await corpusExists();
+            return toolSuccess({
+                corpus_path: path,
+                exists,
+                hint: exists
+                    ? 'Corpus is available. Use corpus_search to find patterns.'
+                    : 'Clone decibel-corpus to this path or set DECIBEL_CORPUS_PATH env var.',
+            });
+        }
+        catch (err) {
+            return toolError(err instanceof Error ? err.message : String(err));
+        }
+    },
+};
+// ============================================================================
+// Export All Tools
+// ============================================================================
+export const corpusTools = [
+    corpusSearchTool,
+    corpusStatusTool,
+];
+//# sourceMappingURL=index.js.map

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

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

package/dist/tools/corpus.d.ts

@@ -0,0 +1,33 @@
+export type CorpusContentType = 'pattern' | 'playbook' | 'field-note';
+export interface CorpusSearchInput {
+    query: string;
+    type?: CorpusContentType | 'all';
+    limit?: number;
+}
+export interface CorpusMatch {
+    id: string;
+    path: string;
+    type: CorpusContentType;
+    title: string;
+    snippet: string;
+    relevance: number;
+}
+export interface CorpusSearchResult {
+    matches: CorpusMatch[];
+    query: string;
+    searched: number;
+    corpus_path: string;
+}
+/**
+ * Search the decibel-corpus for patterns, playbooks, and field notes
+ */
+export declare function corpusSearch(input: CorpusSearchInput): Promise<CorpusSearchResult>;
+/**
+ * Get the corpus path for display/debugging
+ */
+export declare function getCorpusPath(): string;
+/**
+ * Check if corpus exists at the configured path
+ */
+export declare function corpusExists(): Promise<boolean>;
+//# sourceMappingURL=corpus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"corpus.d.ts","sourceRoot":"","sources":["../../src/tools/corpus.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,iBAAiB,GAAG,KAAK,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAyHD;;GAEG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA6DxF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAOrD"}