monomind 2.7.5 → 2.7.6

package/packages/@monomind/cli/dist/src/interactive/interrupt.d.ts

@@ -1,22 +0,0 @@
-export type InterruptDecision = 'approved' | 'rejected' | 'edited';
-export interface InterruptPromptResult {
-    decision: InterruptDecision;
-    editedTask?: string;
-}
-export interface InterruptConfig {
-    interruptBefore: string[];
-    confidenceThreshold?: number;
-    autoApprove?: boolean;
-}
-export declare class InterruptRegistry {
-    private config;
-    load(config: InterruptConfig): void;
-    shouldInterrupt(agentSlug: string, confidence?: number): boolean;
-    getConfig(): InterruptConfig;
-}
-export declare const interruptRegistry: InterruptRegistry;
-export declare class InterruptController {
-    prompt(agentSlug: string, taskDescription: string, checkpointId: string): Promise<InterruptPromptResult>;
-}
-export declare const interruptController: InterruptController;
-//# sourceMappingURL=interrupt.d.ts.map

package/packages/@monomind/cli/dist/src/interactive/interrupt.js

@@ -1,71 +0,0 @@
-import * as readline from 'node:readline';
-export class InterruptRegistry {
-    config = { interruptBefore: [] };
-    load(config) {
-        this.config = config;
-    }
-    shouldInterrupt(agentSlug, confidence) {
-        if (this.config.autoApprove)
-            return false;
-        if (this.config.interruptBefore.includes(agentSlug))
-            return true;
-        if (confidence !== undefined &&
-            this.config.confidenceThreshold !== undefined &&
-            confidence < this.config.confidenceThreshold) {
-            return true;
-        }
-        return false;
-    }
-    getConfig() {
-        return { ...this.config };
-    }
-}
-export const interruptRegistry = new InterruptRegistry();
-export class InterruptController {
-    async prompt(agentSlug, taskDescription, checkpointId) {
-        // Non-TTY / CI mode
-        if (!process.stdin.isTTY || process.env.CI_AUTO_APPROVE === '1') {
-            return { decision: 'approved' };
-        }
-        const rl = readline.createInterface({
-            input: process.stdin,
-            output: process.stdout,
-        });
-        // Strip control characters from interpolated fields. ANSI escape sequences
-        // in any of these fields would let a malicious agent or LLM-generated task
-        // description redraw the screen and trick the user into approving an
-        // entirely different action than the one shown — defeating this very gate.
-        const safe = (s) => String(s ?? '').replace(/[\x00-\x1f\x7f-\x9f]/g, '?').slice(0, 500);
-        console.log('\n' + '='.repeat(60));
-        console.log('[MONOMIND] Interrupt — Human approval required');
-        console.log(`  Agent:      ${safe(agentSlug)}`);
-        console.log(`  Task:       ${safe(taskDescription)}`);
-        console.log(`  Checkpoint: ${safe(checkpointId)}`);
-        console.log('='.repeat(60));
-        console.log('  Options: [y] approve  [n] reject  [e] edit task');
-        return new Promise((resolve) => {
-            rl.question('  Choice (y/n/e): ', (answer) => {
-                rl.close();
-                const trimmed = answer.trim().toLowerCase();
-                if (trimmed === 'y' || trimmed === 'yes') {
-                    resolve({ decision: 'approved' });
-                }
-                else if (trimmed === 'e' || trimmed === 'edit') {
-                    const rl2 = readline.createInterface({
-                        input: process.stdin,
-                        output: process.stdout,
-                    });
-                    rl2.question('  New task description: ', (newTask) => {
-                        rl2.close();
-                        resolve({ decision: 'edited', editedTask: newTask });
-                    });
-                }
-                else {
-                    resolve({ decision: 'rejected' });
-                }
-            });
-        });
-    }
-}
-export const interruptController = new InterruptController();
-//# sourceMappingURL=interrupt.js.map

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

@@ -1,25 +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.
- */
-import type { ToolRegistry } from './tool-registry.js';
-/**
- * Injects deprecation metadata into MCP responses.
- */
-export declare class DeprecationInjector {
-    private readonly registry;
-    constructor(registry: ToolRegistry);
-    /**
-     * 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: Record<string, unknown>, toolName: string): Record<string, unknown>;
-}
-//# sourceMappingURL=deprecation-injector.d.ts.map

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-tools/a2a-tools.d.ts

@@ -1,14 +0,0 @@
-/**
- * A2A Agent Card MCP Tools
- *
- * Implements the Agent-to-Agent (A2A) Protocol's Agent Card specification.
- * Each agent type exposes a JSON card at a well-known endpoint so other
- * agents can discover its capabilities and communicate via SSE transport.
- *
- * Source: https://a2a-protocol.org
- *
- * @module v1/cli/mcp-tools/a2a-tools
- */
-import type { MCPTool } from './types.js';
-export declare const a2aTools: MCPTool[];
-//# sourceMappingURL=a2a-tools.d.ts.map