monomind 1.9.16 → 1.10.0

package/packages/@monomind/cli/dist/src/mcp/deprecation-injector.js

@@ -1,48 +0,0 @@
-/**
- * Deprecation Injector (Task 31)
- *
- * Injects deprecation warnings into MCP tool responses when the
- * invoked tool has been marked as deprecated in the ToolRegistry.
- */
-/**
- * Injects deprecation metadata into MCP responses.
- */
-export class DeprecationInjector {
-    registry;
-    constructor(registry) {
-        this.registry = registry;
-    }
-    /**
-     * If `toolName` is deprecated, augment the response with a warning.
-     *
-     * Returns the original response unmodified when the tool is not
-     * deprecated. When deprecated, adds `_deprecation` metadata.
-     *
-     * Warning format:
-     *   [DEPRECATED] Tool "<name>" is deprecated. <message>. Use "<successor>" instead.
-     */
-    inject(response, toolName) {
-        const tool = this.registry.getVersion(toolName);
-        if (!tool || !tool.deprecated) {
-            return response;
-        }
-        const parts = [`[DEPRECATED] Tool "${toolName}" is deprecated.`];
-        if (tool.deprecationMessage) {
-            parts.push(tool.deprecationMessage + '.');
-        }
-        if (tool.successor) {
-            parts.push(`Use "${tool.successor}" instead.`);
-        }
-        const warning = parts.join(' ');
-        return {
-            ...response,
-            _deprecation: {
-                warning,
-                deprecated: true,
-                successor: tool.successor ?? null,
-                deprecatedAt: tool.deprecatedAt ?? null,
-            },
-        };
-    }
-}
-//# sourceMappingURL=deprecation-injector.js.map

package/packages/@monomind/cli/dist/src/mcp/tool-registry.d.ts

@@ -1,61 +0,0 @@
-/**
- * Tool Registry (Task 31)
- *
- * Manages semver versioning for MCP tools with deprecation tracking
- * and tool-to-agent impact analysis. Uses JSONL file storage.
- */
-import type { VersionedMCPTool, ToolVersionEntry } from '../../../shared/src/types/tool-version.js';
-/**
- * Registry for versioned MCP tools.
- *
- * Stores tool metadata and version history in a JSONL file.
- * Supports deprecation marking and agent impact analysis.
- */
-export declare class ToolRegistry {
-    private tools;
-    private history;
-    private readonly storagePath;
-    constructor(storagePath?: string);
-    /**
-     * Register a new tool or update an existing one.
-     */
-    register(tool: VersionedMCPTool): void;
-    /**
-     * Mark a tool as deprecated with an optional successor.
-     */
-    deprecate(toolName: string, message: string, successor?: string): void;
-    /**
-     * Get the current version info for a tool.
-     * Returns null if the tool is not registered.
-     */
-    getVersion(toolName: string): VersionedMCPTool | null;
-    /**
-     * List all deprecated tools.
-     */
-    listDeprecated(): VersionedMCPTool[];
-    /**
-     * Find agents that reference the given tool.
-     *
-     * Scans agent markdown files under the provided agents directory
-     * and returns slugs of agents whose `tools:` frontmatter or body
-     * mention the tool name.
-     */
-    getImpactedAgents(toolName: string, agentsDir?: string): string[];
-    /**
-     * Get the full version history for a tool, or all tools if no name given.
-     */
-    getHistory(toolName?: string): ToolVersionEntry[];
-    /**
-     * Get all registered tools.
-     */
-    listAll(): VersionedMCPTool[];
-    /**
-     * Load existing entries from the JSONL file on disk.
-     */
-    private loadFromDisk;
-    /**
-     * Append a version history entry and the current tool state to disk.
-     */
-    private appendEntry;
-}
-//# sourceMappingURL=tool-registry.d.ts.map

package/packages/@monomind/cli/dist/src/mcp/tool-registry.js

@@ -1,246 +0,0 @@
-/**
- * Tool Registry (Task 31)
- *
- * Manages semver versioning for MCP tools with deprecation tracking
- * and tool-to-agent impact analysis. Uses JSONL file storage.
- */
-import { appendFileSync, readFileSync, existsSync, mkdirSync, readdirSync, lstatSync, } from 'fs';
-import { join, dirname, extname, resolve, sep } from 'path';
-/** Default JSONL storage path relative to project root. */
-const DEFAULT_STORAGE_PATH = '.monomind/tool-versions.jsonl';
-/**
- * Registry for versioned MCP tools.
- *
- * Stores tool metadata and version history in a JSONL file.
- * Supports deprecation marking and agent impact analysis.
- */
-export class ToolRegistry {
-    tools = new Map();
-    history = [];
-    storagePath;
-    constructor(storagePath = DEFAULT_STORAGE_PATH) {
-        const resolvedPath = resolve(storagePath);
-        const allowedRoot = process.env.MONOMIND_DATA_DIR
-            ? resolve(process.env.MONOMIND_DATA_DIR)
-            : resolve(process.cwd());
-        if (resolvedPath !== allowedRoot && !resolvedPath.startsWith(allowedRoot + sep)) {
-            throw new Error(`Tool registry storagePath escapes allowed root: ${resolvedPath}`);
-        }
-        this.storagePath = resolvedPath;
-        this.loadFromDisk();
-    }
-    /**
-     * Register a new tool or update an existing one.
-     */
-    register(tool) {
-        const existing = this.tools.get(tool.toolName);
-        const changeType = existing
-            ? 'updated'
-            : 'added';
-        this.tools.set(tool.toolName, { ...tool });
-        const entry = {
-            toolName: tool.toolName,
-            version: tool.version,
-            changeType,
-            changedAt: new Date().toISOString(),
-            description: changeType === 'added'
-                ? `Registered tool ${tool.toolName} v${tool.version}`
-                : `Updated tool ${tool.toolName} to v${tool.version}`,
-        };
-        this.history.push(entry);
-        this.appendEntry(entry);
-    }
-    /**
-     * Mark a tool as deprecated with an optional successor.
-     */
-    deprecate(toolName, message, successor) {
-        const tool = this.tools.get(toolName);
-        if (!tool) {
-            throw new Error(`Tool "${toolName}" not found in registry`);
-        }
-        tool.deprecated = true;
-        tool.deprecationMessage = message;
-        tool.deprecatedAt = new Date().toISOString();
-        if (successor) {
-            tool.successor = successor;
-        }
-        const entry = {
-            toolName,
-            version: tool.version,
-            changeType: 'deprecated',
-            changedAt: tool.deprecatedAt,
-            description: message,
-        };
-        this.history.push(entry);
-        this.appendEntry(entry);
-    }
-    /**
-     * Get the current version info for a tool.
-     * Returns null if the tool is not registered.
-     */
-    getVersion(toolName) {
-        return this.tools.get(toolName) ?? null;
-    }
-    /**
-     * List all deprecated tools.
-     */
-    listDeprecated() {
-        const result = [];
-        for (const tool of this.tools.values()) {
-            if (tool.deprecated) {
-                result.push({ ...tool });
-            }
-        }
-        return result;
-    }
-    /**
-     * Find agents that reference the given tool.
-     *
-     * Scans agent markdown files under the provided agents directory
-     * and returns slugs of agents whose `tools:` frontmatter or body
-     * mention the tool name.
-     */
-    getImpactedAgents(toolName, agentsDir = 'agents') {
-        // Reject empty or short tool names — `content.includes('')` returns true
-        // for every file, turning the registry into a directory enumerator.
-        if (typeof toolName !== 'string' || toolName.length < 2 || !/^[a-zA-Z0-9_.-]+$/.test(toolName)) {
-            return [];
-        }
-        const impacted = [];
-        const mdFiles = collectMdFiles(agentsDir);
-        for (const filePath of mdFiles) {
-            let content;
-            try {
-                content = readFileSync(filePath, 'utf-8');
-            }
-            catch {
-                continue;
-            }
-            if (content.includes(toolName)) {
-                // Derive slug from filename (strip .md extension)
-                const parts = filePath.split('/');
-                const filename = parts[parts.length - 1];
-                const slug = filename.replace(/\.md$/, '');
-                impacted.push(slug);
-            }
-        }
-        return impacted;
-    }
-    /**
-     * Get the full version history for a tool, or all tools if no name given.
-     */
-    getHistory(toolName) {
-        if (!toolName) {
-            return [...this.history];
-        }
-        return this.history.filter((e) => e.toolName === toolName);
-    }
-    /**
-     * Get all registered tools.
-     */
-    listAll() {
-        return Array.from(this.tools.values()).map((t) => ({ ...t }));
-    }
-    // ---- Private helpers ----
-    /**
-     * Load existing entries from the JSONL file on disk.
-     */
-    loadFromDisk() {
-        if (!existsSync(this.storagePath)) {
-            return;
-        }
-        let raw;
-        try {
-            raw = readFileSync(this.storagePath, 'utf-8');
-        }
-        catch {
-            return;
-        }
-        const NAME_RE = /^[a-zA-Z0-9_.-]{1,128}$/;
-        const STR_MAX = 500;
-        for (const line of raw.split('\n')) {
-            const trimmed = line.trim();
-            if (!trimmed)
-                continue;
-            try {
-                const record = JSON.parse(trimmed);
-                if (!record || typeof record !== 'object')
-                    continue;
-                // Validate fields before storage. The JSONL file lives on disk; an
-                // attacker with local write access could otherwise plant attacker-controlled
-                // strings (e.g. malicious deprecationMessage with markup) that reach
-                // downstream renderers (DOT visualizer, deprecation-injector warnings).
-                if (record._type === 'tool') {
-                    if (typeof record.toolName !== 'string' || !NAME_RE.test(record.toolName))
-                        continue;
-                    if (record.successor !== undefined && (typeof record.successor !== 'string' || !NAME_RE.test(record.successor)))
-                        continue;
-                    if (record.deprecationMessage !== undefined && (typeof record.deprecationMessage !== 'string' || record.deprecationMessage.length > STR_MAX))
-                        continue;
-                    this.tools.set(record.toolName, record);
-                }
-                else if (record._type === 'history') {
-                    if (typeof record.toolName !== 'string' || !NAME_RE.test(record.toolName))
-                        continue;
-                    this.history.push(record);
-                }
-            }
-            catch {
-                // Skip malformed lines
-            }
-        }
-    }
-    /**
-     * Append a version history entry and the current tool state to disk.
-     */
-    appendEntry(entry) {
-        const dir = dirname(this.storagePath);
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-        const tool = this.tools.get(entry.toolName);
-        const lines = [];
-        if (tool) {
-            lines.push(JSON.stringify({ _type: 'tool', ...tool }));
-        }
-        lines.push(JSON.stringify({ _type: 'history', ...entry }));
-        appendFileSync(this.storagePath, lines.join('\n') + '\n', 'utf-8');
-    }
-}
-/**
- * Recursively collect all `.md` files under a directory.
- */
-function collectMdFiles(root) {
-    const results = [];
-    let entries;
-    try {
-        entries = readdirSync(root);
-    }
-    catch {
-        return results;
-    }
-    for (const entry of entries) {
-        const full = join(root, entry);
-        let stat;
-        try {
-            // Use lstatSync so symlinks aren't followed — otherwise a symlink under
-            // `agentsDir` could redirect this scan into arbitrary filesystem
-            // locations, which combined with `getImpactedAgents` becomes a content
-            // oracle that fingerprints arbitrary text files outside the project.
-            stat = lstatSync(full);
-        }
-        catch {
-            continue;
-        }
-        if (stat.isSymbolicLink())
-            continue;
-        if (stat.isDirectory()) {
-            results.push(...collectMdFiles(full));
-        }
-        else if (stat.isFile() && extname(entry) === '.md') {
-            results.push(full);
-        }
-    }
-    return results;
-}
-//# sourceMappingURL=tool-registry.js.map

package/packages/@monomind/cli/dist/src/mcp-client.d.ts

@@ -1,92 +0,0 @@
-/**
- * CLI MCP Client
- *
- * Thin wrapper for calling MCP tools from CLI commands.
- * Implements ADR-005: MCP-First API Design - CLI as thin wrapper around MCP tools
- *
- * This provides a simple interface for CLI commands to call MCP tools without
- * containing hardcoded business logic. All business logic lives in MCP tool handlers.
- */
-import type { MCPTool } from './mcp-tools/types.js';
-/**
- * MCP Client Error
- */
-export declare class MCPClientError extends Error {
-    toolName: string;
-    cause?: Error | undefined;
-    constructor(message: string, toolName: string, cause?: Error | undefined);
-}
-/**
- * Call an MCP tool by name with input parameters
- *
- * @param toolName - Name of the MCP tool (e.g., 'agent_spawn', 'swarm_init')
- * @param input - Input parameters for the tool
- * @param context - Optional tool context
- * @returns Promise resolving to tool result
- * @throws {MCPClientError} If tool not found or execution fails
- *
- * @example
- * ```typescript
- * // Spawn an agent
- * const result = await callMCPTool('agent_spawn', {
- *   agentType: 'coder',
- *   priority: 'normal'
- * });
- *
- * // Initialize swarm
- * const swarm = await callMCPTool('swarm_init', {
- *   topology: 'hierarchical-mesh',
- *   maxAgents: 15
- * });
- * ```
- */
-export declare function callMCPTool<T = unknown>(toolName: string, input?: Record<string, unknown>, context?: Record<string, unknown>): Promise<T>;
-/**
- * Get tool metadata by name
- *
- * @param toolName - Name of the MCP tool
- * @returns Tool metadata or undefined if not found
- */
-export declare function getToolMetadata(toolName: string): Omit<MCPTool, 'handler'> | undefined;
-/**
- * List all available MCP tools
- *
- * @param category - Optional category filter
- * @returns Array of tool metadata
- */
-export declare function listMCPTools(category?: string): Array<Omit<MCPTool, 'handler'>>;
-/**
- * Check if an MCP tool exists
- *
- * @param toolName - Name of the MCP tool
- * @returns True if tool exists
- */
-export declare function hasTool(toolName: string): boolean;
-/**
- * Get all tool categories
- *
- * @returns Array of unique categories
- */
-export declare function getToolCategories(): string[];
-/**
- * Validate tool input against schema
- *
- * @param toolName - Name of the MCP tool
- * @param input - Input to validate
- * @returns Validation result with errors if any
- */
-export declare function validateToolInput(toolName: string, input: Record<string, unknown>): {
-    valid: boolean;
-    errors?: string[];
-};
-declare const _default: {
-    callMCPTool: typeof callMCPTool;
-    getToolMetadata: typeof getToolMetadata;
-    listMCPTools: typeof listMCPTools;
-    hasTool: typeof hasTool;
-    getToolCategories: typeof getToolCategories;
-    validateToolInput: typeof validateToolInput;
-    MCPClientError: typeof MCPClientError;
-};
-export default _default;
-//# sourceMappingURL=mcp-client.d.ts.map