mongo.do 0.1.0

package/dist/mcp/tool-call-auditor.js.map

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

package/dist/mcp/tools/do.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Do Tool for MCP Server
+ *
+ * Executes arbitrary JavaScript code in a sandboxed environment.
+ * This is the "do" capability for AI agents, allowing them to run
+ * custom code with access to database operations.
+ *
+ * The tool uses a CodeLoader interface to execute code in a secure
+ * sandbox (Worker Loader or Miniflare).
+ */
+import type { CodeLoader } from '../server';
+import type { McpToolResponse } from '../types';
+/**
+ * Execute JavaScript code in a sandbox
+ *
+ * @param codeLoader - Code loader interface for executing code
+ * @param code - JavaScript code to execute
+ * @param description - Optional description of what the code does
+ * @returns MCP tool response with DoResult
+ */
+export declare function doTool(codeLoader: CodeLoader, code: string, description?: string): Promise<McpToolResponse>;
+/**
+ * MCP Tool Definition for do
+ */
+export declare const doToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            code: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export default doTool;
+//# sourceMappingURL=do.d.ts.map

package/dist/mcp/tools/do.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"do.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/do.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAY,eAAe,EAAE,MAAM,UAAU,CAAA;AAEzD;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAC1B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC,CAwE1B;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;CA2B5B,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/mcp/tools/do.js

@@ -0,0 +1,113 @@
+/**
+ * Do Tool for MCP Server
+ *
+ * Executes arbitrary JavaScript code in a sandboxed environment.
+ * This is the "do" capability for AI agents, allowing them to run
+ * custom code with access to database operations.
+ *
+ * The tool uses a CodeLoader interface to execute code in a secure
+ * sandbox (Worker Loader or Miniflare).
+ */
+/**
+ * Execute JavaScript code in a sandbox
+ *
+ * @param codeLoader - Code loader interface for executing code
+ * @param code - JavaScript code to execute
+ * @param description - Optional description of what the code does
+ * @returns MCP tool response with DoResult
+ */
+export async function doTool(codeLoader, code, description) {
+    const startTime = Date.now();
+    // Validate code is a non-empty string
+    if (!code || typeof code !== 'string' || code.trim() === '') {
+        const errorResult = {
+            success: false,
+            error: 'Missing required field: code',
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(errorResult),
+                },
+            ],
+            isError: true,
+        };
+    }
+    try {
+        // Execute code using the code loader
+        const executeResult = await codeLoader.execute(code, { description });
+        const duration = Date.now() - startTime;
+        // Format the result as DoResult
+        const result = {
+            success: executeResult.success,
+            result: executeResult.result,
+            duration,
+        };
+        // Include error if present
+        if (executeResult.error) {
+            result.error = executeResult.error;
+        }
+        // Include logs if available (some code loaders may capture console output)
+        if ('logs' in executeResult && Array.isArray(executeResult.logs)) {
+            result.logs = executeResult.logs;
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result),
+                },
+            ],
+            isError: !executeResult.success,
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        // Handle unexpected errors from the code loader itself
+        const errorResult = {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+            duration,
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(errorResult),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * MCP Tool Definition for do
+ */
+export const doToolDefinition = {
+    name: 'do',
+    description: 'Execute JavaScript code in a secure sandbox. The code has access to database operations via the `db` object. Returns the result of the last expression or explicit return statement.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            code: {
+                type: 'string',
+                description: 'JavaScript code to execute. Can include await for async operations. Example: return await db.collection("users").find({})',
+            },
+            description: {
+                type: 'string',
+                description: 'Optional description of what the code does. Useful for logging and auditing.',
+            },
+        },
+        required: ['code'],
+    },
+    annotations: {
+        title: 'Execute Code',
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: false,
+    },
+};
+export default doTool;
+//# sourceMappingURL=do.js.map

package/dist/mcp/tools/do.js.map

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

package/dist/mcp/tools/fetch.d.ts

@@ -0,0 +1,43 @@
+/**
+ * MCP Fetch Tool
+ *
+ * Fetches a document by its ID from MondoDB.
+ * Returns OpenAI Deep Research compatible FetchResult format.
+ *
+ * ID format: database.collection.objectId
+ * Returns: Full document content with metadata
+ */
+import type { DatabaseAccess, McpToolResponse } from '../types';
+/**
+ * Fetch a document by ID
+ *
+ * @param dbAccess - Database access interface
+ * @param id - Document ID in format: database.collection.objectId
+ * @returns MCP tool response with FetchResult or error
+ */
+export declare function fetchTool(dbAccess: DatabaseAccess, id: string): Promise<McpToolResponse>;
+/**
+ * MCP Tool Definition for fetch
+ */
+export declare const fetchToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            id: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+//# sourceMappingURL=fetch.d.ts.map

package/dist/mcp/tools/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAe,MAAM,UAAU,CAAA;AAsB5E;;;;;;GAMG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,cAAc,EACxB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,eAAe,CAAC,CAqD1B;AA6CD;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;CAsB/B,CAAA"}

package/dist/mcp/tools/fetch.js

@@ -0,0 +1,127 @@
+/**
+ * MCP Fetch Tool
+ *
+ * Fetches a document by its ID from MondoDB.
+ * Returns OpenAI Deep Research compatible FetchResult format.
+ *
+ * ID format: database.collection.objectId
+ * Returns: Full document content with metadata
+ */
+/**
+ * Fetch a document by ID
+ *
+ * @param dbAccess - Database access interface
+ * @param id - Document ID in format: database.collection.objectId
+ * @returns MCP tool response with FetchResult or error
+ */
+export async function fetchTool(dbAccess, id) {
+    try {
+        const parsed = parseId(id);
+        const document = (await dbAccess.findOne(parsed.collection, {
+            _id: parsed.objectId,
+        }));
+        if (!document) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ error: 'Document not found' }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = {
+            id,
+            title: getDocumentTitle(document),
+            url: `mongodb://${parsed.database}/${parsed.collection}/${parsed.objectId}`,
+            text: JSON.stringify(document, null, 2),
+            metadata: {
+                database: parsed.database,
+                collection: parsed.collection,
+                _id: parsed.objectId,
+            },
+        };
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(result),
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: error instanceof Error ? error.message : 'Fetch failed',
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * Parse a document ID into its components
+ *
+ * @param id - ID string in format: database.collection.objectId
+ * @returns Parsed ID components
+ * @throws Error if ID format is invalid
+ */
+function parseId(id) {
+    const parts = id.split('.');
+    if (parts.length < 3) {
+        throw new Error('Invalid ID format. Expected: database.collection.objectId');
+    }
+    // Handle case where ObjectId contains dots
+    const [database, collection, ...objectIdParts] = parts;
+    const objectId = objectIdParts.join('.');
+    if (!database || !collection || !objectId) {
+        throw new Error('Invalid ID format. Expected: database.collection.objectId');
+    }
+    return { database, collection, objectId };
+}
+/**
+ * Extract a title from a document
+ * Checks common title fields and falls back to _id
+ *
+ * @param doc - Document to extract title from
+ * @returns Document title string
+ */
+function getDocumentTitle(doc) {
+    return (doc.title ??
+        doc.name ??
+        doc.subject ??
+        doc.label ??
+        doc._id?.toString() ??
+        'Untitled');
+}
+/**
+ * MCP Tool Definition for fetch
+ */
+export const fetchToolDefinition = {
+    name: 'fetch',
+    description: 'Fetch a document by ID from MondoDB. Returns the full document content.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: {
+                type: 'string',
+                description: 'Document ID in format: database.collection.objectId (e.g., mydb.users.507f1f77bcf86cd799439011)',
+            },
+        },
+        required: ['id'],
+    },
+    annotations: {
+        title: 'Fetch Document',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
+};
+//# sourceMappingURL=fetch.js.map

package/dist/mcp/tools/fetch.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * MCP Tools
+ *
+ * Export all available MCP tools for agent operations.
+ */
+export { doTool, doToolDefinition } from './do';
+export { fetchTool, fetchToolDefinition } from './fetch';
+export { searchTool, searchToolDefinition, type SearchOptions } from './search';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAA"}

package/dist/mcp/tools/index.js

@@ -0,0 +1,9 @@
+/**
+ * MCP Tools
+ *
+ * Export all available MCP tools for agent operations.
+ */
+export { doTool, doToolDefinition } from './do';
+export { fetchTool, fetchToolDefinition } from './fetch';
+export { searchTool, searchToolDefinition } from './search';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAA;AAC/C,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AACxD,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAsB,MAAM,UAAU,CAAA"}

package/dist/mcp/tools/search.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Search Tool for MCP Server
+ *
+ * Implements document search functionality following OpenAI Deep Research format.
+ * Supports JSON filters, collection-prefixed queries, and natural language search.
+ */
+import type { DatabaseAccess, McpToolResponse } from '../types';
+/** Options for search */
+export interface SearchOptions {
+    limit?: number;
+    collection?: string;
+    database?: string;
+}
+/**
+ * Search tool implementation
+ *
+ * @param dbAccess - Database access interface
+ * @param query - Search query (JSON filter, collection:query, or natural language)
+ * @param options - Optional search options
+ * @returns MCP tool response with search results
+ */
+export declare function searchTool(dbAccess: DatabaseAccess, query: string, options?: SearchOptions): Promise<McpToolResponse>;
+/**
+ * MCP Tool Definition for search
+ */
+export declare const searchToolDefinition: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            collection: {
+                type: string;
+                description: string;
+            };
+            database: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+};
+export default searchTool;
+//# sourceMappingURL=search.d.ts.map

package/dist/mcp/tools/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAgB,MAAM,UAAU,CAAA;AAqB7E,yBAAyB;AACzB,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,eAAe,CAAC,CA2C1B;AAoPD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkChC,CAAA;AAED,eAAe,UAAU,CAAA"}