mongo.do 0.1.0 → 0.1.1

package/dist/agentfs/vfs.js

@@ -1,469 +0,0 @@
-/**
- * AgentFS Virtual Filesystem Implementation
- *
- * Virtual filesystem stored in mongo.do collections.
- * Provides a file-system-like interface backed by MongoDB/mongo.do.
- *
- * @module agentfs/vfs
- *
- * @example
- * ```typescript
- * import { AgentFilesystem } from './vfs'
- *
- * const fs = new AgentFilesystem(database)
- *
- * // Write and read files
- * await fs.writeFile('/config.json', '{"key": "value"}')
- * const content = await fs.readFile('/config.json')
- *
- * // Directory operations
- * await fs.mkdir('/src')
- * const files = await fs.readdir('/src')
- *
- * // Glob pattern matching
- * const tsFiles = await fs.glob('**\/*.ts')
- * ```
- */
-/**
- * AgentFilesystem - Virtual filesystem backed by mongo.do
- *
- * Implements the FileSystem interface using a MongoDB-compatible database.
- * Uses the file path as the document _id for O(1) lookups.
- *
- * Features:
- * - Files and directories with proper POSIX-like semantics
- * - Implicit parent directory creation
- * - Path normalization (removes duplicate slashes, resolves . and ..)
- * - Glob pattern matching for file discovery
- *
- * Error codes follow POSIX conventions:
- * - ENOENT: File or directory does not exist
- * - EISDIR: Illegal operation on a directory
- * - ENOTDIR: Not a directory
- * - EEXIST: File already exists
- * - ENOTEMPTY: Directory not empty
- * - EPERM: Operation not permitted
- *
- * @example
- * ```typescript
- * const fs = new AgentFilesystem(database)
- *
- * // Create and read files
- * await fs.writeFile('/data/config.json', '{}')
- * const content = await fs.readFile('/data/config.json')
- *
- * // Directories are created implicitly
- * const stat = await fs.stat('/data')
- * // stat.type === 'directory'
- * ```
- */
-export class AgentFilesystem {
-    db;
-    collection = '__agentfs.files';
-    /**
-     * Create a new AgentFilesystem instance.
-     *
-     * @param db - Database backend implementing AgentFSDatabase interface
-     */
-    constructor(db) {
-        this.db = db;
-    }
-    /**
-     * Normalize a path to ensure consistency.
-     *
-     * Normalization rules:
-     * - Always starts with /
-     * - No duplicate slashes (// becomes /)
-     * - No trailing slash (except for root)
-     * - Resolves . (current directory) components
-     * - Resolves .. (parent directory) components
-     *
-     * @param path - Path to normalize
-     * @returns Normalized absolute path
-     * @internal
-     */
-    normalizePath(path) {
-        // Handle empty path
-        if (!path) {
-            return '/';
-        }
-        // Add leading slash if missing (normalize relative paths)
-        if (!path.startsWith('/')) {
-            path = '/' + path;
-        }
-        // Replace multiple slashes with single slash
-        path = path.replace(/\/+/g, '/');
-        // Remove trailing slash (unless it's the root)
-        if (path.length > 1 && path.endsWith('/')) {
-            path = path.slice(0, -1);
-        }
-        // Resolve . and .. components
-        const parts = path.split('/');
-        const resolved = [];
-        for (const part of parts) {
-            if (part === '' || part === '.') {
-                continue;
-            }
-            else if (part === '..') {
-                if (resolved.length > 0) {
-                    resolved.pop();
-                }
-            }
-            else {
-                resolved.push(part);
-            }
-        }
-        return '/' + resolved.join('/') || '/';
-    }
-    /**
-     * Escape special regex characters in a string.
-     *
-     * @param str - String to escape
-     * @returns String with regex special characters escaped
-     * @internal
-     */
-    escapeRegex(str) {
-        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-    }
-    /**
-     * Read file content at the specified path.
-     *
-     * @param path - Absolute path to the file
-     * @returns Promise resolving to the file content as a string
-     * @throws {Error} ENOENT if file does not exist
-     * @throws {Error} EISDIR if path is a directory
-     */
-    async readFile(path) {
-        const normalizedPath = this.normalizePath(path);
-        const doc = await this.db.findOne(this.collection, { _id: normalizedPath });
-        if (!doc) {
-            throw new Error(`ENOENT: no such file or directory, '${normalizedPath}'`);
-        }
-        if (doc.type === 'directory') {
-            throw new Error(`EISDIR: illegal operation on a directory, '${normalizedPath}'`);
-        }
-        return doc.content;
-    }
-    /**
-     * Write content to a file at the specified path.
-     *
-     * Creates parent directories implicitly if they don't exist.
-     * If the file exists, it updates the content and updatedAt timestamp.
-     * If the file doesn't exist, it creates a new file with createdAt set.
-     *
-     * @param path - Absolute path to the file
-     * @param content - Content to write to the file
-     * @throws {Error} EISDIR if path is a directory
-     */
-    async writeFile(path, content) {
-        const normalizedPath = this.normalizePath(path);
-        const now = new Date();
-        // Check if file exists to determine createdAt behavior
-        const existing = await this.db.findOne(this.collection, { _id: normalizedPath });
-        if (existing) {
-            if (existing.type === 'directory') {
-                throw new Error(`EISDIR: illegal operation on a directory, '${normalizedPath}'`);
-            }
-            // Update existing file - preserve createdAt
-            await this.db.updateOne(this.collection, { _id: normalizedPath }, {
-                $set: {
-                    content,
-                    updatedAt: now,
-                },
-            });
-        }
-        else {
-            // Create implicit parent directories
-            await this.createImplicitDirs(normalizedPath);
-            // Insert new file
-            await this.db.insertOne(this.collection, {
-                _id: normalizedPath,
-                path: normalizedPath,
-                content,
-                type: 'file',
-                createdAt: now,
-                updatedAt: now,
-            });
-        }
-    }
-    /**
-     * Create implicit parent directories for a file path.
-     *
-     * Traverses up the path and creates any missing directory entries.
-     *
-     * @param filePath - Absolute path to the file (not the directory)
-     * @internal
-     */
-    async createImplicitDirs(filePath) {
-        const parts = filePath.split('/').filter(Boolean);
-        // Remove the last part (the file itself)
-        parts.pop();
-        let currentPath = '';
-        for (const part of parts) {
-            currentPath += '/' + part;
-            const exists = await this.db.findOne(this.collection, { _id: currentPath });
-            if (!exists) {
-                const now = new Date();
-                await this.db.insertOne(this.collection, {
-                    _id: currentPath,
-                    path: currentPath,
-                    content: '',
-                    type: 'directory',
-                    createdAt: now,
-                    updatedAt: now,
-                });
-            }
-        }
-    }
-    /**
-     * Delete a file at the specified path.
-     *
-     * @param path - Absolute path to the file to delete
-     * @throws {Error} ENOENT if file does not exist
-     * @throws {Error} EISDIR if path is a directory (use rmdir instead)
-     */
-    async deleteFile(path) {
-        const normalizedPath = this.normalizePath(path);
-        // Check if it's a directory
-        const doc = await this.db.findOne(this.collection, { _id: normalizedPath });
-        if (doc && doc.type === 'directory') {
-            throw new Error(`EISDIR: illegal operation on a directory, '${normalizedPath}'`);
-        }
-        const result = await this.db.deleteOne(this.collection, { _id: normalizedPath });
-        if (result.deletedCount === 0) {
-            throw new Error(`ENOENT: no such file or directory, '${normalizedPath}'`);
-        }
-    }
-    /**
-     * List entries in a directory.
-     *
-     * Returns only direct children (not recursively nested).
-     * Results are sorted alphabetically.
-     *
-     * @param path - Absolute path to the directory
-     * @returns Promise resolving to array of entry names (not full paths)
-     * @throws {Error} ENOENT if directory does not exist
-     * @throws {Error} ENOTDIR if path is a file, not a directory
-     */
-    async readdir(path) {
-        const normalizedPath = this.normalizePath(path);
-        // Check if the directory exists (explicit or implicit)
-        const dirDoc = await this.db.findOne(this.collection, { _id: normalizedPath });
-        // Pattern to match entries under this directory
-        const prefix = normalizedPath === '/' ? '' : normalizedPath;
-        // Find all files and directories under this path
-        const allDocs = await this.db.find(this.collection, {
-            path: { $regex: `^${this.escapeRegex(prefix)}/` },
-        });
-        // If directory doesn't exist and no children found
-        if (!dirDoc && allDocs.length === 0) {
-            throw new Error(`ENOENT: no such file or directory, '${normalizedPath}'`);
-        }
-        // If it's a file
-        if (dirDoc && dirDoc.type === 'file') {
-            throw new Error(`ENOTDIR: not a directory, '${normalizedPath}'`);
-        }
-        // Extract direct children only
-        const entries = new Set();
-        for (const doc of allDocs) {
-            const docPath = doc.path;
-            // Remove the prefix and leading slash
-            const relativePath = docPath.substring(prefix.length + 1);
-            // Get the first path segment (direct child)
-            const firstSegment = relativePath.split('/')[0];
-            if (firstSegment) {
-                entries.add(firstSegment);
-            }
-        }
-        return Array.from(entries).sort();
-    }
-    /**
-     * Create a directory at the specified path.
-     *
-     * Creates parent directories implicitly (behaves like mkdir -p).
-     * Idempotent - does not throw if directory already exists.
-     *
-     * @param path - Absolute path to the directory to create
-     * @throws {Error} EEXIST if a file (not directory) already exists at path
-     */
-    async mkdir(path) {
-        const normalizedPath = this.normalizePath(path);
-        const now = new Date();
-        // Check if already exists as a file
-        const existing = await this.db.findOne(this.collection, { _id: normalizedPath });
-        if (existing) {
-            if (existing.type === 'file') {
-                throw new Error(`EEXIST: file already exists, '${normalizedPath}'`);
-            }
-            // Directory already exists - idempotent, just return
-            return;
-        }
-        // Create parent directories first
-        const parts = normalizedPath.split('/').filter(Boolean);
-        let currentPath = '';
-        for (let i = 0; i < parts.length; i++) {
-            currentPath += '/' + parts[i];
-            const exists = await this.db.findOne(this.collection, { _id: currentPath });
-            if (!exists) {
-                await this.db.insertOne(this.collection, {
-                    _id: currentPath,
-                    path: currentPath,
-                    content: '',
-                    type: 'directory',
-                    createdAt: now,
-                    updatedAt: now,
-                });
-            }
-            else if (exists.type === 'file' && i < parts.length - 1) {
-                throw new Error(`EEXIST: file already exists, '${currentPath}'`);
-            }
-        }
-    }
-    /**
-     * Remove an empty directory at the specified path.
-     *
-     * The directory must be empty (no files or subdirectories).
-     * Cannot remove the root directory.
-     *
-     * @param path - Absolute path to the directory to remove
-     * @throws {Error} ENOENT if directory does not exist
-     * @throws {Error} ENOTDIR if path is a file, not a directory
-     * @throws {Error} ENOTEMPTY if directory contains entries
-     * @throws {Error} EPERM if attempting to remove root directory
-     */
-    async rmdir(path) {
-        const normalizedPath = this.normalizePath(path);
-        // Cannot remove root
-        if (normalizedPath === '/') {
-            throw new Error(`EPERM: operation not permitted, '/'`);
-        }
-        // Check if it exists
-        const doc = await this.db.findOne(this.collection, { _id: normalizedPath });
-        if (!doc) {
-            throw new Error(`ENOENT: no such file or directory, '${normalizedPath}'`);
-        }
-        if (doc.type === 'file') {
-            throw new Error(`ENOTDIR: not a directory, '${normalizedPath}'`);
-        }
-        // Check if empty
-        const prefix = normalizedPath;
-        const children = await this.db.find(this.collection, {
-            path: { $regex: `^${this.escapeRegex(prefix)}/` },
-        });
-        if (children.length > 0) {
-            throw new Error(`ENOTEMPTY: directory not empty, '${normalizedPath}'`);
-        }
-        await this.db.deleteOne(this.collection, { _id: normalizedPath });
-    }
-    /**
-     * Get file or directory statistics.
-     *
-     * Returns type, size, and timestamps for the entry.
-     * For directories, size is always 0.
-     * Supports implicit directories (directories inferred from file paths).
-     *
-     * @param path - Absolute path to the file or directory
-     * @returns Promise resolving to FileStat with type, size, createdAt, updatedAt
-     * @throws {Error} ENOENT if path does not exist
-     */
-    async stat(path) {
-        const normalizedPath = this.normalizePath(path);
-        const doc = await this.db.findOne(this.collection, { _id: normalizedPath });
-        if (doc) {
-            return {
-                type: doc.type,
-                size: doc.type === 'file' ? doc.content.length : 0,
-                createdAt: new Date(doc.createdAt),
-                updatedAt: new Date(doc.updatedAt),
-            };
-        }
-        // Check if it's an implicit directory (has files inside)
-        const prefix = normalizedPath === '/' ? '' : normalizedPath;
-        const filesInside = await this.db.find(this.collection, {
-            path: { $regex: `^${this.escapeRegex(prefix)}/` },
-        });
-        if (filesInside.length > 0) {
-            // It's an implicit directory
-            const now = new Date();
-            return {
-                type: 'directory',
-                size: 0,
-                createdAt: now,
-                updatedAt: now,
-            };
-        }
-        throw new Error(`ENOENT: no such file or directory, '${normalizedPath}'`);
-    }
-    /**
-     * Check if a file or directory exists at the specified path.
-     *
-     * Does not throw errors for non-existent paths.
-     *
-     * @param path - Absolute path to check
-     * @returns Promise resolving to true if path exists, false otherwise
-     */
-    async exists(path) {
-        try {
-            await this.stat(path);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Find files matching a glob pattern.
-     *
-     * Supports basic glob patterns:
-     * - `*` matches any characters except /
-     * - `**` matches any characters including /
-     * - `?` matches any single character except /
-     *
-     * Returns only files, not directories.
-     * Results are sorted alphabetically.
-     *
-     * @param pattern - Glob pattern to match against file paths
-     * @returns Promise resolving to array of matching file paths
-     *
-     * @example
-     * ```typescript
-     * const tsFiles = await fs.glob('**\/*.ts')
-     * const srcFiles = await fs.glob('/src/*.js')
-     * ```
-     */
-    async glob(pattern) {
-        // Convert glob pattern to regex
-        const regexPattern = this.globToRegex(pattern);
-        const files = await this.db.find(this.collection, {
-            path: { $regex: regexPattern },
-        });
-        // Filter to only include files, not directories
-        return files
-            .filter((f) => f.type === 'file')
-            .map((f) => f.path)
-            .sort();
-    }
-    /**
-     * Convert a glob pattern to a regex string
-     */
-    globToRegex(pattern) {
-        // Normalize the pattern
-        let normalized = pattern;
-        if (!normalized.startsWith('/')) {
-            normalized = '/' + normalized;
-        }
-        // Escape regex special characters except glob wildcards
-        let regex = normalized
-            .replace(/[.+^${}()|[\]\\]/g, '\\$&')
-            // ** matches any path segments
-            .replace(/\*\*/g, '<<DOUBLE_STAR>>')
-            // * matches any characters except /
-            .replace(/\*/g, '[^/]*')
-            // Restore ** as .*
-            .replace(/<<DOUBLE_STAR>>/g, '.*')
-            // ? matches single character except /
-            .replace(/\?/g, '[^/]');
-        return '^' + regex + '$';
-    }
-}
-//# sourceMappingURL=vfs.js.map

package/dist/agentfs/vfs.js.map

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

package/dist/cli/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;GAWG"}

package/dist/cli/mcp.d.ts

@@ -1,119 +0,0 @@
-/**
- * CLI MCP Command
- *
- * Implements the `mcp` command for the MondoDB CLI.
- * Starts an MCP (Model Context Protocol) server that communicates via stdio.
- *
- * Features:
- * - --connection <url>: Connect to a remote MondoDB Worker
- * - --local <path>: Use a local SQLite database
- *
- * Usage:
- *   mongo.do mcp --connection https://my-worker.workers.dev
- *   mongo.do mcp --local ./data/local.db
- *
- * The MCP server exposes tools for AI agents to interact with the database:
- * - search: Query documents
- * - fetch: Retrieve full documents by ID
- * - do: Execute operations (when enabled)
- *
- * @module cli/mcp
- */
-import type { DatabaseAccess } from '../mcp/types.js';
-/**
- * Options for the MCP command
- */
-export interface McpCommandOptions {
-    /** Remote connection URL (e.g., https://my-worker.workers.dev) */
-    connection?: string;
-    /** Local database file path */
-    local?: string;
-    /** Custom stdin stream (for testing) */
-    stdin?: NodeJS.ReadableStream;
-    /** Custom stdout stream (for testing) */
-    stdout?: NodeJS.WritableStream;
-}
-/**
- * Controller for managing the MCP server lifecycle
- */
-export interface McpServerController {
-    /** Whether the server is currently running */
-    readonly isRunning: boolean;
-    /** Stop the MCP server */
-    stop(): Promise<void>;
-}
-/**
- * Program interface for command registration
- * Compatible with Commander.js Command interface
- */
-export interface McpProgram {
-    command(name: string): McpProgram;
-    description(desc: string): McpProgram;
-    option(flags: string, description?: string, defaultValue?: unknown): McpProgram;
-    action(fn: (...args: unknown[]) => void | Promise<void>): McpProgram;
-}
-/**
- * Register the MCP command with the CLI program
- *
- * @param program - The CLI program to register the command with
- */
-export declare function registerMcpCommand(program: McpProgram): void;
-/**
- * Start the MCP server with the given configuration.
- *
- * The server communicates via stdio using the Model Context Protocol (MCP).
- * It exposes database operations as tools that AI agents can invoke.
- *
- * @param options - Server configuration options
- * @returns Promise resolving to a controller for managing the server lifecycle
- * @throws {Error} If neither --connection nor --local is provided
- * @throws {Error} If both --connection and --local are provided
- * @throws {Error} If the connection URL is invalid
- *
- * @example
- * ```typescript
- * // Remote connection
- * const controller = await startMcpServer({
- *   connection: 'https://my-worker.workers.dev'
- * })
- *
- * // Local SQLite database
- * const controller = await startMcpServer({
- *   local: './data/local.db'
- * })
- *
- * // Graceful shutdown
- * await controller.stop()
- * ```
- */
-export declare function startMcpServer(options: McpCommandOptions): Promise<McpServerController>;
-/**
- * Create a DatabaseAccess instance for the MCP server.
- *
- * This factory function creates the appropriate database access implementation
- * based on the provided options:
- * - Remote: Uses RPC client to communicate with a MondoDB Worker
- * - Local: Uses LocalSQLiteBackend for file-based storage (requires Bun)
- *
- * @param options - Connection options (either connection URL or local path)
- * @returns Promise resolving to a DatabaseAccess instance
- * @throws {Error} If neither connection nor local option is provided
- *
- * @example
- * ```typescript
- * // Remote database access
- * const dbAccess = await createMcpDatabaseAccess({
- *   connection: 'https://my-worker.workers.dev'
- * })
- *
- * // Local database access
- * const dbAccess = await createMcpDatabaseAccess({
- *   local: './data/local.db'
- * })
- * ```
- */
-export declare function createMcpDatabaseAccess(options: {
-    connection?: string | undefined;
-    local?: string | undefined;
-}): Promise<DatabaseAccess>;
-//# sourceMappingURL=mcp.d.ts.map

package/dist/cli/mcp.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/cli/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,iBAAiB,CAAA;AAoBlE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;IAC7B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,0BAA0B;IAC1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;IACjC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAA;IACrC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;IAC/E,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,UAAU,CAAA;CACrE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAkB5D;AAkBD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4D7F;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACvE,OAAO,CAAC,cAAc,CAAC,CAYzB"}