@metamask/client-mcp-core 0.1.0

package/dist/mcp-server/tools/run-tool.mjs

@@ -0,0 +1,137 @@
+import { knowledgeStore } from "../knowledge-store.mjs";
+import { getSessionManager } from "../session-manager.mjs";
+import { collectObservation } from "./helpers.mjs";
+import { ErrorCodes } from "../types/index.mjs";
+import { createSuccessResponse, createErrorResponse, extractErrorMessage, debugWarn } from "../utils/index.mjs";
+/**
+ * Creates an empty observation object for step recording.
+ *
+ * @returns Empty observation with default state, testIds, and a11y nodes
+ */
+function createEmptyObservation() {
+    return {
+        state: {},
+        testIds: [],
+        a11y: { nodes: [] },
+    };
+}
+/**
+ * Type guard to check if result is a ToolExecuteResult with observation.
+ *
+ * @param result The result to check
+ * @returns True if result is a ToolExecuteResult with observation property
+ */
+function isToolExecuteResult(result) {
+    return (typeof result === 'object' &&
+        result !== null &&
+        'result' in result &&
+        Object.prototype.hasOwnProperty.call(result, 'result'));
+}
+/**
+ * Executes a tool with error handling, observation collection, and knowledge store recording.
+ *
+ * @param config The tool execution configuration with input, execute function, and error handling
+ * @returns Promise resolving to MCP response with tool result or error information
+ */
+export async function runTool(config) {
+    const startTime = Date.now();
+    const sessionManager = getSessionManager();
+    const sessionId = sessionManager.getSessionId();
+    const requiresSession = config.requiresSession ?? true;
+    const effectivePolicy = config.options?.observationPolicy ?? config.observationPolicy ?? 'default';
+    try {
+        if (requiresSession && !sessionManager.hasActiveSession()) {
+            return createErrorResponse(ErrorCodes.MM_NO_ACTIVE_SESSION, 'No active session. Call launch first.', { input: config.input }, undefined, startTime);
+        }
+        const context = {
+            sessionId,
+            page: requiresSession ? sessionManager.getPage() : undefined,
+            refMap: requiresSession ? sessionManager.getRefMap() : new Map(),
+            startTime,
+        };
+        const executeResult = await config.execute(context);
+        let result;
+        let customObservation;
+        if (isToolExecuteResult(executeResult)) {
+            result = executeResult.result;
+            customObservation = executeResult.observation;
+        }
+        else {
+            result = executeResult;
+        }
+        let observation;
+        if (effectivePolicy === 'custom' && customObservation) {
+            observation = customObservation;
+        }
+        else if (effectivePolicy === 'default' && requiresSession) {
+            observation = await collectObservation(context.page, 'full');
+        }
+        else if ((effectivePolicy === 'none' || effectivePolicy === 'failures') &&
+            requiresSession) {
+            observation = await collectObservation(context.page, 'minimal');
+        }
+        if (sessionId) {
+            const recordInput = config.sanitizeInputForRecording
+                ? config.sanitizeInputForRecording(config.input)
+                : config.input;
+            await knowledgeStore.recordStep({
+                sessionId,
+                toolName: config.toolName,
+                input: recordInput,
+                target: config.getTarget?.(config.input),
+                outcome: { ok: true },
+                observation: observation ?? createEmptyObservation(),
+                durationMs: Date.now() - startTime,
+                context: sessionManager.getEnvironmentMode(),
+            });
+        }
+        return createSuccessResponse(result, sessionId, startTime);
+    }
+    catch (error) {
+        const errorInfo = config.classifyError?.(error) ?? {
+            code: `MM_${config.toolName.toUpperCase().replace(/^MM_/u, '')}_FAILED`,
+            message: extractErrorMessage(error),
+        };
+        let failureObservation = createEmptyObservation();
+        if (requiresSession && sessionManager.hasActiveSession()) {
+            if (effectivePolicy === 'failures' || effectivePolicy === 'default') {
+                try {
+                    const page = sessionManager.getPage();
+                    failureObservation = await collectObservation(page, 'full');
+                }
+                catch (collectError) {
+                    debugWarn('run-tool.collectObservation', collectError);
+                    failureObservation = await collectObservation(undefined, 'minimal');
+                }
+            }
+            else if (effectivePolicy === 'none') {
+                try {
+                    failureObservation = await collectObservation(undefined, 'minimal');
+                }
+                catch (collectError) {
+                    debugWarn('run-tool.collectObservation', collectError);
+                }
+            }
+        }
+        if (sessionId) {
+            const recordInput = config.sanitizeInputForRecording
+                ? config.sanitizeInputForRecording(config.input)
+                : config.input;
+            await knowledgeStore.recordStep({
+                sessionId,
+                toolName: config.toolName,
+                input: recordInput,
+                target: config.getTarget?.(config.input),
+                outcome: {
+                    ok: false,
+                    error: { code: errorInfo.code, message: errorInfo.message },
+                },
+                observation: failureObservation,
+                durationMs: Date.now() - startTime,
+                context: sessionManager.getEnvironmentMode(),
+            });
+        }
+        return createErrorResponse(errorInfo.code, errorInfo.message, { input: config.input }, sessionId, startTime);
+    }
+}
+//# sourceMappingURL=run-tool.mjs.map

package/dist/mcp-server/tools/run-tool.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-tool.mjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/run-tool.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Page } from '@playwright/test';\n\nimport type { ExtensionState } from '../../capabilities/types.js';\nimport { knowledgeStore } from '../knowledge-store.js';\nimport { getSessionManager } from '../session-manager.js';\nimport { collectObservation } from './helpers.js';\nimport type {\n  McpResponse,\n  HandlerOptions,\n  StepRecordObservation,\n  ErrorCode,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport {\n  createSuccessResponse,\n  createErrorResponse,\n  extractErrorMessage,\n  debugWarn,\n} from '../utils';\n\n/**\n * Creates an empty observation object for step recording.\n *\n * @returns Empty observation with default state, testIds, and a11y nodes\n */\nfunction createEmptyObservation(): StepRecordObservation {\n  return {\n    state: {} as ExtensionState,\n    testIds: [],\n    a11y: { nodes: [] },\n  };\n}\n\nexport type ObservationPolicy = 'none' | 'default' | 'custom' | 'failures';\n\nexport type ToolExecutionContext = {\n  sessionId: string | undefined;\n  page: Page;\n  refMap: Map<string, string>;\n  startTime: number;\n};\n\nexport type ToolExecuteResult<TResult> = {\n  result: TResult;\n  observation?: StepRecordObservation;\n};\n\nexport type ToolExecutionConfig<TInput, TResult> = {\n  toolName: string;\n  input: TInput;\n  options?: HandlerOptions;\n  requiresSession?: boolean;\n  observationPolicy?: ObservationPolicy;\n  execute: (\n    context: ToolExecutionContext,\n  ) => Promise<TResult | ToolExecuteResult<TResult>>;\n  classifyError?: (error: unknown) => {\n    code: string;\n    message: string;\n  };\n  getTarget?: (input: TInput) =>\n    | {\n        testId?: string;\n        selector?: string;\n        a11yRef?: string;\n      }\n    | undefined;\n  sanitizeInputForRecording?: (input: TInput) => Record<string, unknown>;\n};\n\n/**\n * Type guard to check if result is a ToolExecuteResult with observation.\n *\n * @param result The result to check\n * @returns True if result is a ToolExecuteResult with observation property\n */\nfunction isToolExecuteResult<TResult>(\n  result: TResult | ToolExecuteResult<TResult>,\n): result is ToolExecuteResult<TResult> {\n  return (\n    typeof result === 'object' &&\n    result !== null &&\n    'result' in result &&\n    Object.prototype.hasOwnProperty.call(result, 'result')\n  );\n}\n\n/**\n * Executes a tool with error handling, observation collection, and knowledge store recording.\n *\n * @param config The tool execution configuration with input, execute function, and error handling\n * @returns Promise resolving to MCP response with tool result or error information\n */\nexport async function runTool<TInput, TResult>(\n  config: ToolExecutionConfig<TInput, TResult>,\n): Promise<McpResponse<TResult>> {\n  const startTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n  const requiresSession = config.requiresSession ?? true;\n\n  const effectivePolicy =\n    config.options?.observationPolicy ?? config.observationPolicy ?? 'default';\n\n  try {\n    if (requiresSession && !sessionManager.hasActiveSession()) {\n      return createErrorResponse(\n        ErrorCodes.MM_NO_ACTIVE_SESSION,\n        'No active session. Call launch first.',\n        { input: config.input },\n        undefined,\n        startTime,\n      );\n    }\n\n    const context: ToolExecutionContext = {\n      sessionId,\n      page: requiresSession ? sessionManager.getPage() : (undefined as never),\n      refMap: requiresSession ? sessionManager.getRefMap() : new Map(),\n      startTime,\n    };\n\n    const executeResult = await config.execute(context);\n\n    let result: TResult;\n    let customObservation: StepRecordObservation | undefined;\n\n    if (isToolExecuteResult<TResult>(executeResult)) {\n      result = executeResult.result;\n      customObservation = executeResult.observation;\n    } else {\n      result = executeResult;\n    }\n\n    let observation: StepRecordObservation | undefined;\n\n    if (effectivePolicy === 'custom' && customObservation) {\n      observation = customObservation;\n    } else if (effectivePolicy === 'default' && requiresSession) {\n      observation = await collectObservation(context.page, 'full');\n    } else if (\n      (effectivePolicy === 'none' || effectivePolicy === 'failures') &&\n      requiresSession\n    ) {\n      observation = await collectObservation(context.page, 'minimal');\n    }\n\n    if (sessionId) {\n      const recordInput = config.sanitizeInputForRecording\n        ? config.sanitizeInputForRecording(config.input)\n        : (config.input as Record<string, unknown>);\n\n      await knowledgeStore.recordStep({\n        sessionId,\n        toolName: config.toolName,\n        input: recordInput,\n        target: config.getTarget?.(config.input),\n        outcome: { ok: true },\n        observation: observation ?? createEmptyObservation(),\n        durationMs: Date.now() - startTime,\n        context: sessionManager.getEnvironmentMode(),\n      });\n    }\n\n    return createSuccessResponse<TResult>(result, sessionId, startTime);\n  } catch (error) {\n    const errorInfo = config.classifyError?.(error) ?? {\n      code: `MM_${config.toolName.toUpperCase().replace(/^MM_/u, '')}_FAILED`,\n      message: extractErrorMessage(error),\n    };\n\n    let failureObservation: StepRecordObservation = createEmptyObservation();\n\n    if (requiresSession && sessionManager.hasActiveSession()) {\n      if (effectivePolicy === 'failures' || effectivePolicy === 'default') {\n        try {\n          const page = sessionManager.getPage();\n          failureObservation = await collectObservation(page, 'full');\n        } catch (collectError) {\n          debugWarn('run-tool.collectObservation', collectError);\n          failureObservation = await collectObservation(undefined, 'minimal');\n        }\n      } else if (effectivePolicy === 'none') {\n        try {\n          failureObservation = await collectObservation(undefined, 'minimal');\n        } catch (collectError) {\n          debugWarn('run-tool.collectObservation', collectError);\n        }\n      }\n    }\n\n    if (sessionId) {\n      const recordInput = config.sanitizeInputForRecording\n        ? config.sanitizeInputForRecording(config.input)\n        : (config.input as Record<string, unknown>);\n\n      await knowledgeStore.recordStep({\n        sessionId,\n        toolName: config.toolName,\n        input: recordInput,\n        target: config.getTarget?.(config.input),\n        outcome: {\n          ok: false,\n          error: { code: errorInfo.code, message: errorInfo.message },\n        },\n        observation: failureObservation,\n        durationMs: Date.now() - startTime,\n        context: sessionManager.getEnvironmentMode(),\n      });\n    }\n\n    return createErrorResponse(\n      errorInfo.code as ErrorCode,\n      errorInfo.message,\n      { input: config.input },\n      sessionId,\n      startTime,\n    );\n  }\n}\n"]}

package/dist/mcp-server/tools/screenshot.cjs

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleScreenshot = handleScreenshot;
+const session_manager_js_1 = require("../session-manager.cjs");
+const error_classification_js_1 = require("./error-classification.cjs");
+const run_tool_js_1 = require("./run-tool.cjs");
+/**
+ * Handles the screenshot tool request.
+ *
+ * @param input - The screenshot input parameters.
+ * @param options - Handler options including abort signal.
+ * @returns Response with screenshot path and dimensions.
+ */
+async function handleScreenshot(input, options) {
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_screenshot',
+        input,
+        options,
+        observationPolicy: 'none',
+        /**
+         * Executes the screenshot capture.
+         *
+         * @returns The screenshot result.
+         */
+        execute: async () => {
+            const sessionManager = (0, session_manager_js_1.getSessionManager)();
+            const result = await sessionManager.screenshot({
+                name: input.name,
+                fullPage: input.fullPage ?? true,
+                selector: input.selector,
+            });
+            const response = {
+                path: result.path,
+                width: result.width,
+                height: result.height,
+            };
+            if (input.includeBase64) {
+                response.base64 = result.base64;
+            }
+            return response;
+        },
+        classifyError: error_classification_js_1.classifyScreenshotError,
+        /**
+         * Sanitizes input for knowledge store recording.
+         *
+         * @returns Sanitized input object.
+         */
+        sanitizeInputForRecording: () => ({
+            name: input.name,
+            fullPage: input.fullPage,
+            selector: input.selector,
+        }),
+    });
+}
+//# sourceMappingURL=screenshot.cjs.map

package/dist/mcp-server/tools/screenshot.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.cjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/screenshot.ts"],"names":[],"mappings":";;AAiBA,4CAiDC;AAlED,+DAA0D;AAC1D,wEAAoE;AACpE,gDAAwC;AAQxC;;;;;;GAMG;AACI,KAAK,UAAU,gBAAgB,CACpC,KAAsB,EACtB,OAAwB;IAExB,OAAO,IAAA,qBAAO,EAAwC;QACpD,QAAQ,EAAE,eAAe;QACzB,KAAK;QACL,OAAO;QACP,iBAAiB,EAAE,MAAM;QAEzB;;;;WAIG;QACH,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,cAAc,GAAG,IAAA,sCAAiB,GAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC;gBAC7C,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;gBAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAyB;gBACrC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC;YAEF,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;gBACxB,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAClC,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,aAAa,EAAE,iDAAuB;QAEtC;;;;WAIG;QACH,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC;KACH,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { getSessionManager } from '../session-manager.js';\nimport { classifyScreenshotError } from './error-classification.js';\nimport { runTool } from './run-tool.js';\nimport type {\n  ScreenshotInput,\n  ScreenshotToolResult,\n  McpResponse,\n  HandlerOptions,\n} from '../types';\n\n/**\n * Handles the screenshot tool request.\n *\n * @param input - The screenshot input parameters.\n * @param options - Handler options including abort signal.\n * @returns Response with screenshot path and dimensions.\n */\nexport async function handleScreenshot(\n  input: ScreenshotInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<ScreenshotToolResult>> {\n  return runTool<ScreenshotInput, ScreenshotToolResult>({\n    toolName: 'mm_screenshot',\n    input,\n    options,\n    observationPolicy: 'none',\n\n    /**\n     * Executes the screenshot capture.\n     *\n     * @returns The screenshot result.\n     */\n    execute: async () => {\n      const sessionManager = getSessionManager();\n      const result = await sessionManager.screenshot({\n        name: input.name,\n        fullPage: input.fullPage ?? true,\n        selector: input.selector,\n      });\n\n      const response: ScreenshotToolResult = {\n        path: result.path,\n        width: result.width,\n        height: result.height,\n      };\n\n      if (input.includeBase64) {\n        response.base64 = result.base64;\n      }\n\n      return response;\n    },\n\n    classifyError: classifyScreenshotError,\n\n    /**\n     * Sanitizes input for knowledge store recording.\n     *\n     * @returns Sanitized input object.\n     */\n    sanitizeInputForRecording: () => ({\n      name: input.name,\n      fullPage: input.fullPage,\n      selector: input.selector,\n    }),\n  });\n}\n"]}

package/dist/mcp-server/tools/screenshot.d.cts

@@ -0,0 +1,10 @@
+import type { ScreenshotInput, ScreenshotToolResult, McpResponse, HandlerOptions } from "../types/index.cjs";
+/**
+ * Handles the screenshot tool request.
+ *
+ * @param input - The screenshot input parameters.
+ * @param options - Handler options including abort signal.
+ * @returns Response with screenshot path and dimensions.
+ */
+export declare function handleScreenshot(input: ScreenshotInput, options?: HandlerOptions): Promise<McpResponse<ScreenshotToolResult>>;
+//# sourceMappingURL=screenshot.d.cts.map

package/dist/mcp-server/tools/screenshot.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/tools/screenshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,cAAc,EACf,2BAAiB;AAElB;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CA8C5C"}

package/dist/mcp-server/tools/screenshot.d.mts

@@ -0,0 +1,10 @@
+import type { ScreenshotInput, ScreenshotToolResult, McpResponse, HandlerOptions } from "../types/index.mjs";
+/**
+ * Handles the screenshot tool request.
+ *
+ * @param input - The screenshot input parameters.
+ * @param options - Handler options including abort signal.
+ * @returns Response with screenshot path and dimensions.
+ */
+export declare function handleScreenshot(input: ScreenshotInput, options?: HandlerOptions): Promise<McpResponse<ScreenshotToolResult>>;
+//# sourceMappingURL=screenshot.d.mts.map

package/dist/mcp-server/tools/screenshot.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/tools/screenshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,cAAc,EACf,2BAAiB;AAElB;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CA8C5C"}

package/dist/mcp-server/tools/screenshot.mjs

@@ -0,0 +1,52 @@
+import { getSessionManager } from "../session-manager.mjs";
+import { classifyScreenshotError } from "./error-classification.mjs";
+import { runTool } from "./run-tool.mjs";
+/**
+ * Handles the screenshot tool request.
+ *
+ * @param input - The screenshot input parameters.
+ * @param options - Handler options including abort signal.
+ * @returns Response with screenshot path and dimensions.
+ */
+export async function handleScreenshot(input, options) {
+    return runTool({
+        toolName: 'mm_screenshot',
+        input,
+        options,
+        observationPolicy: 'none',
+        /**
+         * Executes the screenshot capture.
+         *
+         * @returns The screenshot result.
+         */
+        execute: async () => {
+            const sessionManager = getSessionManager();
+            const result = await sessionManager.screenshot({
+                name: input.name,
+                fullPage: input.fullPage ?? true,
+                selector: input.selector,
+            });
+            const response = {
+                path: result.path,
+                width: result.width,
+                height: result.height,
+            };
+            if (input.includeBase64) {
+                response.base64 = result.base64;
+            }
+            return response;
+        },
+        classifyError: classifyScreenshotError,
+        /**
+         * Sanitizes input for knowledge store recording.
+         *
+         * @returns Sanitized input object.
+         */
+        sanitizeInputForRecording: () => ({
+            name: input.name,
+            fullPage: input.fullPage,
+            selector: input.selector,
+        }),
+    });
+}
+//# sourceMappingURL=screenshot.mjs.map

package/dist/mcp-server/tools/screenshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.mjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,+BAA8B;AAC1D,OAAO,EAAE,uBAAuB,EAAE,mCAAkC;AACpE,OAAO,EAAE,OAAO,EAAE,uBAAsB;AAQxC;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAsB,EACtB,OAAwB;IAExB,OAAO,OAAO,CAAwC;QACpD,QAAQ,EAAE,eAAe;QACzB,KAAK;QACL,OAAO;QACP,iBAAiB,EAAE,MAAM;QAEzB;;;;WAIG;QACH,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC;gBAC7C,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;gBAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;aACzB,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAyB;gBACrC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC;YAEF,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;gBACxB,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAClC,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,aAAa,EAAE,uBAAuB;QAEtC;;;;WAIG;QACH,yBAAyB,EAAE,GAAG,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC;KACH,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { getSessionManager } from '../session-manager.js';\nimport { classifyScreenshotError } from './error-classification.js';\nimport { runTool } from './run-tool.js';\nimport type {\n  ScreenshotInput,\n  ScreenshotToolResult,\n  McpResponse,\n  HandlerOptions,\n} from '../types';\n\n/**\n * Handles the screenshot tool request.\n *\n * @param input - The screenshot input parameters.\n * @param options - Handler options including abort signal.\n * @returns Response with screenshot path and dimensions.\n */\nexport async function handleScreenshot(\n  input: ScreenshotInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<ScreenshotToolResult>> {\n  return runTool<ScreenshotInput, ScreenshotToolResult>({\n    toolName: 'mm_screenshot',\n    input,\n    options,\n    observationPolicy: 'none',\n\n    /**\n     * Executes the screenshot capture.\n     *\n     * @returns The screenshot result.\n     */\n    execute: async () => {\n      const sessionManager = getSessionManager();\n      const result = await sessionManager.screenshot({\n        name: input.name,\n        fullPage: input.fullPage ?? true,\n        selector: input.selector,\n      });\n\n      const response: ScreenshotToolResult = {\n        path: result.path,\n        width: result.width,\n        height: result.height,\n      };\n\n      if (input.includeBase64) {\n        response.base64 = result.base64;\n      }\n\n      return response;\n    },\n\n    classifyError: classifyScreenshotError,\n\n    /**\n     * Sanitizes input for knowledge store recording.\n     *\n     * @returns Sanitized input object.\n     */\n    sanitizeInputForRecording: () => ({\n      name: input.name,\n      fullPage: input.fullPage,\n      selector: input.selector,\n    }),\n  });\n}\n"]}

package/dist/mcp-server/tools/seeding.cjs

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSeedContract = handleSeedContract;
+exports.handleSeedContracts = handleSeedContracts;
+exports.handleGetContractAddress = handleGetContractAddress;
+exports.handleListDeployedContracts = handleListDeployedContracts;
+const session_manager_js_1 = require("../session-manager.cjs");
+const error_classification_js_1 = require("./error-classification.cjs");
+const run_tool_js_1 = require("./run-tool.cjs");
+const types_1 = require("../types/index.cjs");
+const utils_1 = require("../utils/index.cjs");
+/**
+ * Validates that the seeding capability is available, returning either the capability or an error response.
+ *
+ * @param toolName The name of the tool requesting the capability
+ * @param input The input provided to the tool
+ * @param options Tool options containing the seeding capability
+ * @param startTime Timestamp when the tool execution started
+ * @returns The seeding capability if available, or an error response if not
+ */
+function checkSeedingCapability(toolName, input, options, startTime) {
+    const sessionManager = (0, session_manager_js_1.getSessionManager)();
+    const sessionId = sessionManager.getSessionId();
+    if (!options?.seedingCapability) {
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_CAPABILITY_NOT_AVAILABLE, `ContractSeedingCapability not available. The ${toolName} tool requires running in e2e mode with the MetaMask extension wrapper, which provides Anvil chain and contract deployment support.`, { capability: 'ContractSeedingCapability', input }, sessionId, startTime);
+    }
+    return options.seedingCapability;
+}
+/**
+ * Type guard to check if a result is a ContractSeedingCapability.
+ *
+ * @param result The value to check
+ * @returns True if result is a ContractSeedingCapability, false if it's an error response
+ */
+function isCapability(result) {
+    return (typeof result === 'object' && result !== null && 'deployContract' in result);
+}
+/**
+ * Handles the mm_seed_contract tool to deploy a single smart contract.
+ *
+ * @param input The contract name and deployment options
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to the deployment result with contract address
+ */
+async function handleSeedContract(input, options) {
+    const startTime = Date.now();
+    const capabilityOrError = checkSeedingCapability('mm_seed_contract', input, options, startTime);
+    if (!isCapability(capabilityOrError)) {
+        return capabilityOrError;
+    }
+    const seedingCapability = capabilityOrError;
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_seed_contract',
+        input,
+        options,
+        observationPolicy: 'none',
+        /**
+         * Executes the contract deployment using the seeding capability.
+         *
+         * @returns The deployed contract details including name, address, and timestamp
+         */
+        execute: async () => {
+            const deployed = await seedingCapability.deployContract(input.contractName, {
+                hardfork: input.hardfork,
+                deployerOptions: input.deployerOptions,
+            });
+            return {
+                contractName: deployed.name,
+                contractAddress: deployed.address,
+                deployedAt: deployed.deployedAt,
+            };
+        },
+        classifyError: error_classification_js_1.classifySeedingError,
+        /**
+         * Sanitizes the input for recording in the knowledge store.
+         *
+         * @returns The sanitized input containing contract name and hardfork
+         */
+        sanitizeInputForRecording: () => ({
+            contractName: input.contractName,
+            hardfork: input.hardfork ?? 'prague',
+        }),
+    });
+}
+/**
+ * Handles the mm_seed_contracts tool to deploy multiple smart contracts.
+ *
+ * @param input The list of contract names and deployment options
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to deployment results with deployed and failed contracts
+ */
+async function handleSeedContracts(input, options) {
+    const startTime = Date.now();
+    const capabilityOrError = checkSeedingCapability('mm_seed_contracts', input, options, startTime);
+    if (!isCapability(capabilityOrError)) {
+        return capabilityOrError;
+    }
+    const seedingCapability = capabilityOrError;
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_seed_contracts',
+        input,
+        options,
+        observationPolicy: 'none',
+        /**
+         * Executes the multi-contract deployment using the seeding capability.
+         *
+         * @returns The deployment results with deployed and failed contract lists
+         */
+        execute: async () => {
+            const seedResult = await seedingCapability.deployContracts(input.contracts, { hardfork: input.hardfork });
+            return {
+                deployed: seedResult.deployed.map((deployedContract) => ({
+                    contractName: deployedContract.name,
+                    contractAddress: deployedContract.address,
+                    deployedAt: deployedContract.deployedAt,
+                })),
+                failed: seedResult.failed.map((failedDeployment) => ({
+                    contractName: failedDeployment.name,
+                    error: failedDeployment.error,
+                })),
+            };
+        },
+        classifyError: error_classification_js_1.classifySeedingError,
+        /**
+         * Sanitizes the input for recording in the knowledge store.
+         *
+         * @returns The sanitized input containing contracts list and hardfork
+         */
+        sanitizeInputForRecording: () => ({
+            contracts: input.contracts,
+            hardfork: input.hardfork ?? 'prague',
+        }),
+    });
+}
+/**
+ * Handles the mm_get_contract_address tool to retrieve a deployed contract's address.
+ *
+ * @param input The contract name to look up
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to the contract address or null if not found
+ */
+async function handleGetContractAddress(input, options) {
+    const startTime = Date.now();
+    const capabilityOrError = checkSeedingCapability('mm_get_contract_address', input, options, startTime);
+    if (!isCapability(capabilityOrError)) {
+        return capabilityOrError;
+    }
+    const seedingCapability = capabilityOrError;
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_get_contract_address',
+        input,
+        options,
+        observationPolicy: 'none',
+        /**
+         * Executes the contract address lookup using the seeding capability.
+         *
+         * @returns The contract name and its deployed address
+         */
+        execute: async () => {
+            const address = seedingCapability.getContractAddress(input.contractName);
+            return {
+                contractName: input.contractName,
+                contractAddress: address,
+            };
+        },
+        classifyError: error_classification_js_1.classifySeedingError,
+        /**
+         * Sanitizes the input for recording in the knowledge store.
+         *
+         * @returns The sanitized input containing the contract name
+         */
+        sanitizeInputForRecording: () => ({
+            contractName: input.contractName,
+        }),
+    });
+}
+/**
+ * Handles the mm_list_contracts tool to list all deployed contracts in the session.
+ *
+ * @param _input Unused input parameter (no input required for this tool)
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to a list of all deployed contracts with their addresses
+ */
+async function handleListDeployedContracts(_input, options) {
+    const startTime = Date.now();
+    const capabilityOrError = checkSeedingCapability('mm_list_contracts', _input, options, startTime);
+    if (!isCapability(capabilityOrError)) {
+        return capabilityOrError;
+    }
+    const seedingCapability = capabilityOrError;
+    return (0, run_tool_js_1.runTool)({
+        toolName: 'mm_list_contracts',
+        input: _input,
+        options,
+        observationPolicy: 'none',
+        /**
+         * Executes the contract listing using the seeding capability.
+         *
+         * @returns The list of all deployed contracts with their details
+         */
+        execute: async () => {
+            const deployed = seedingCapability.listDeployedContracts();
+            return {
+                contracts: deployed.map((deployedContract) => ({
+                    contractName: deployedContract.name,
+                    contractAddress: deployedContract.address,
+                    deployedAt: deployedContract.deployedAt,
+                })),
+            };
+        },
+        classifyError: error_classification_js_1.classifySeedingError,
+    });
+}
+//# sourceMappingURL=seeding.cjs.map

package/dist/mcp-server/tools/seeding.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeding.cjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/seeding.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ContractSeedingCapability } from '../../capabilities/types.js';\nimport { getSessionManager } from '../session-manager.js';\nimport { classifySeedingError } from './error-classification.js';\nimport { runTool } from './run-tool.js';\nimport type {\n  SeedContractInput,\n  SeedContractsInput,\n  GetContractAddressInput,\n  ListDeployedContractsInput,\n  SeedContractResult,\n  SeedContractsResult,\n  GetContractAddressResult,\n  ListDeployedContractsResult,\n  McpResponse,\n  HandlerOptions,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport { createErrorResponse } from '../utils';\n\nexport type SeedingToolOptions = HandlerOptions & {\n  seedingCapability?: ContractSeedingCapability;\n};\n\n/**\n * Validates that the seeding capability is available, returning either the capability or an error response.\n *\n * @param toolName The name of the tool requesting the capability\n * @param input The input provided to the tool\n * @param options Tool options containing the seeding capability\n * @param startTime Timestamp when the tool execution started\n * @returns The seeding capability if available, or an error response if not\n */\nfunction checkSeedingCapability<Type>(\n  toolName: string,\n  input: unknown,\n  options: SeedingToolOptions | undefined,\n  startTime: number,\n): McpResponse<Type> | ContractSeedingCapability {\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n\n  if (!options?.seedingCapability) {\n    return createErrorResponse(\n      ErrorCodes.MM_CAPABILITY_NOT_AVAILABLE,\n      `ContractSeedingCapability not available. The ${toolName} tool requires running in e2e mode with the MetaMask extension wrapper, which provides Anvil chain and contract deployment support.`,\n      { capability: 'ContractSeedingCapability', input },\n      sessionId,\n      startTime,\n    ) as McpResponse<Type>;\n  }\n\n  return options.seedingCapability;\n}\n\n/**\n * Type guard to check if a result is a ContractSeedingCapability.\n *\n * @param result The value to check\n * @returns True if result is a ContractSeedingCapability, false if it's an error response\n */\nfunction isCapability(\n  result: McpResponse<unknown> | ContractSeedingCapability,\n): result is ContractSeedingCapability {\n  return (\n    typeof result === 'object' && result !== null && 'deployContract' in result\n  );\n}\n\n/**\n * Handles the mm_seed_contract tool to deploy a single smart contract.\n *\n * @param input The contract name and deployment options\n * @param options Tool options including seeding capability\n * @returns Promise resolving to the deployment result with contract address\n */\nexport async function handleSeedContract(\n  input: SeedContractInput,\n  options?: SeedingToolOptions,\n): Promise<McpResponse<SeedContractResult>> {\n  const startTime = Date.now();\n  const capabilityOrError = checkSeedingCapability<SeedContractResult>(\n    'mm_seed_contract',\n    input,\n    options,\n    startTime,\n  );\n\n  if (!isCapability(capabilityOrError)) {\n    return capabilityOrError;\n  }\n\n  const seedingCapability = capabilityOrError;\n\n  return runTool<SeedContractInput, SeedContractResult>({\n    toolName: 'mm_seed_contract',\n    input,\n    options,\n    observationPolicy: 'none',\n\n    /**\n     * Executes the contract deployment using the seeding capability.\n     *\n     * @returns The deployed contract details including name, address, and timestamp\n     */\n    execute: async () => {\n      const deployed = await seedingCapability.deployContract(\n        input.contractName,\n        {\n          hardfork: input.hardfork,\n          deployerOptions: input.deployerOptions,\n        },\n      );\n\n      return {\n        contractName: deployed.name,\n        contractAddress: deployed.address,\n        deployedAt: deployed.deployedAt,\n      };\n    },\n\n    classifyError: classifySeedingError,\n\n    /**\n     * Sanitizes the input for recording in the knowledge store.\n     *\n     * @returns The sanitized input containing contract name and hardfork\n     */\n    sanitizeInputForRecording: () => ({\n      contractName: input.contractName,\n      hardfork: input.hardfork ?? 'prague',\n    }),\n  });\n}\n\n/**\n * Handles the mm_seed_contracts tool to deploy multiple smart contracts.\n *\n * @param input The list of contract names and deployment options\n * @param options Tool options including seeding capability\n * @returns Promise resolving to deployment results with deployed and failed contracts\n */\nexport async function handleSeedContracts(\n  input: SeedContractsInput,\n  options?: SeedingToolOptions,\n): Promise<McpResponse<SeedContractsResult>> {\n  const startTime = Date.now();\n  const capabilityOrError = checkSeedingCapability<SeedContractsResult>(\n    'mm_seed_contracts',\n    input,\n    options,\n    startTime,\n  );\n\n  if (!isCapability(capabilityOrError)) {\n    return capabilityOrError;\n  }\n\n  const seedingCapability = capabilityOrError;\n\n  return runTool<SeedContractsInput, SeedContractsResult>({\n    toolName: 'mm_seed_contracts',\n    input,\n    options,\n    observationPolicy: 'none',\n\n    /**\n     * Executes the multi-contract deployment using the seeding capability.\n     *\n     * @returns The deployment results with deployed and failed contract lists\n     */\n    execute: async () => {\n      const seedResult = await seedingCapability.deployContracts(\n        input.contracts,\n        { hardfork: input.hardfork },\n      );\n\n      return {\n        deployed: seedResult.deployed.map((deployedContract) => ({\n          contractName: deployedContract.name,\n          contractAddress: deployedContract.address,\n          deployedAt: deployedContract.deployedAt,\n        })),\n        failed: seedResult.failed.map((failedDeployment) => ({\n          contractName: failedDeployment.name,\n          error: failedDeployment.error,\n        })),\n      };\n    },\n\n    classifyError: classifySeedingError,\n\n    /**\n     * Sanitizes the input for recording in the knowledge store.\n     *\n     * @returns The sanitized input containing contracts list and hardfork\n     */\n    sanitizeInputForRecording: () => ({\n      contracts: input.contracts,\n      hardfork: input.hardfork ?? 'prague',\n    }),\n  });\n}\n\n/**\n * Handles the mm_get_contract_address tool to retrieve a deployed contract's address.\n *\n * @param input The contract name to look up\n * @param options Tool options including seeding capability\n * @returns Promise resolving to the contract address or null if not found\n */\nexport async function handleGetContractAddress(\n  input: GetContractAddressInput,\n  options?: SeedingToolOptions,\n): Promise<McpResponse<GetContractAddressResult>> {\n  const startTime = Date.now();\n  const capabilityOrError = checkSeedingCapability<GetContractAddressResult>(\n    'mm_get_contract_address',\n    input,\n    options,\n    startTime,\n  );\n\n  if (!isCapability(capabilityOrError)) {\n    return capabilityOrError;\n  }\n\n  const seedingCapability = capabilityOrError;\n\n  return runTool<GetContractAddressInput, GetContractAddressResult>({\n    toolName: 'mm_get_contract_address',\n    input,\n    options,\n    observationPolicy: 'none',\n\n    /**\n     * Executes the contract address lookup using the seeding capability.\n     *\n     * @returns The contract name and its deployed address\n     */\n    execute: async () => {\n      const address = seedingCapability.getContractAddress(input.contractName);\n\n      return {\n        contractName: input.contractName,\n        contractAddress: address,\n      };\n    },\n\n    classifyError: classifySeedingError,\n\n    /**\n     * Sanitizes the input for recording in the knowledge store.\n     *\n     * @returns The sanitized input containing the contract name\n     */\n    sanitizeInputForRecording: () => ({\n      contractName: input.contractName,\n    }),\n  });\n}\n\n/**\n * Handles the mm_list_contracts tool to list all deployed contracts in the session.\n *\n * @param _input Unused input parameter (no input required for this tool)\n * @param options Tool options including seeding capability\n * @returns Promise resolving to a list of all deployed contracts with their addresses\n */\nexport async function handleListDeployedContracts(\n  _input: ListDeployedContractsInput,\n  options?: SeedingToolOptions,\n): Promise<McpResponse<ListDeployedContractsResult>> {\n  const startTime = Date.now();\n  const capabilityOrError = checkSeedingCapability<ListDeployedContractsResult>(\n    'mm_list_contracts',\n    _input,\n    options,\n    startTime,\n  );\n\n  if (!isCapability(capabilityOrError)) {\n    return capabilityOrError;\n  }\n\n  const seedingCapability = capabilityOrError;\n\n  return runTool<ListDeployedContractsInput, ListDeployedContractsResult>({\n    toolName: 'mm_list_contracts',\n    input: _input,\n    options,\n    observationPolicy: 'none',\n\n    /**\n     * Executes the contract listing using the seeding capability.\n     *\n     * @returns The list of all deployed contracts with their details\n     */\n    execute: async () => {\n      const deployed = seedingCapability.listDeployedContracts();\n\n      return {\n        contracts: deployed.map(\n          (deployedContract: {\n            /**\n             * The contract name\n             */\n            name: string;\n            /**\n             * The contract's deployed address\n             */\n            address: string;\n            /**\n             * The deployment timestamp\n             */\n            deployedAt: string;\n          }) => ({\n            contractName: deployedContract.name,\n            contractAddress: deployedContract.address,\n            deployedAt: deployedContract.deployedAt,\n          }),\n        ),\n      };\n    },\n\n    classifyError: classifySeedingError,\n  });\n}\n"]}

package/dist/mcp-server/tools/seeding.d.cts

@@ -0,0 +1,38 @@
+import type { ContractSeedingCapability } from "../../capabilities/types.cjs";
+import type { SeedContractInput, SeedContractsInput, GetContractAddressInput, ListDeployedContractsInput, SeedContractResult, SeedContractsResult, GetContractAddressResult, ListDeployedContractsResult, McpResponse, HandlerOptions } from "../types/index.cjs";
+export type SeedingToolOptions = HandlerOptions & {
+    seedingCapability?: ContractSeedingCapability;
+};
+/**
+ * Handles the mm_seed_contract tool to deploy a single smart contract.
+ *
+ * @param input The contract name and deployment options
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to the deployment result with contract address
+ */
+export declare function handleSeedContract(input: SeedContractInput, options?: SeedingToolOptions): Promise<McpResponse<SeedContractResult>>;
+/**
+ * Handles the mm_seed_contracts tool to deploy multiple smart contracts.
+ *
+ * @param input The list of contract names and deployment options
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to deployment results with deployed and failed contracts
+ */
+export declare function handleSeedContracts(input: SeedContractsInput, options?: SeedingToolOptions): Promise<McpResponse<SeedContractsResult>>;
+/**
+ * Handles the mm_get_contract_address tool to retrieve a deployed contract's address.
+ *
+ * @param input The contract name to look up
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to the contract address or null if not found
+ */
+export declare function handleGetContractAddress(input: GetContractAddressInput, options?: SeedingToolOptions): Promise<McpResponse<GetContractAddressResult>>;
+/**
+ * Handles the mm_list_contracts tool to list all deployed contracts in the session.
+ *
+ * @param _input Unused input parameter (no input required for this tool)
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to a list of all deployed contracts with their addresses
+ */
+export declare function handleListDeployedContracts(_input: ListDeployedContractsInput, options?: SeedingToolOptions): Promise<McpResponse<ListDeployedContractsResult>>;
+//# sourceMappingURL=seeding.d.cts.map

package/dist/mcp-server/tools/seeding.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seeding.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/tools/seeding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,qCAAoC;AAI7E,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,2BAA2B,EAC3B,WAAW,EACX,cAAc,EACf,2BAAiB;AAIlB,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG;IAChD,iBAAiB,CAAC,EAAE,yBAAyB,CAAC;CAC/C,CAAC;AA+CF;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAsD1C;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,CAyD3C;AAED;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,uBAAuB,EAC9B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,wBAAwB,CAAC,CAAC,CA8ChD;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,0BAA0B,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC,CAuDnD"}

package/dist/mcp-server/tools/seeding.d.mts

@@ -0,0 +1,38 @@
+import type { ContractSeedingCapability } from "../../capabilities/types.mjs";
+import type { SeedContractInput, SeedContractsInput, GetContractAddressInput, ListDeployedContractsInput, SeedContractResult, SeedContractsResult, GetContractAddressResult, ListDeployedContractsResult, McpResponse, HandlerOptions } from "../types/index.mjs";
+export type SeedingToolOptions = HandlerOptions & {
+    seedingCapability?: ContractSeedingCapability;
+};
+/**
+ * Handles the mm_seed_contract tool to deploy a single smart contract.
+ *
+ * @param input The contract name and deployment options
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to the deployment result with contract address
+ */
+export declare function handleSeedContract(input: SeedContractInput, options?: SeedingToolOptions): Promise<McpResponse<SeedContractResult>>;
+/**
+ * Handles the mm_seed_contracts tool to deploy multiple smart contracts.
+ *
+ * @param input The list of contract names and deployment options
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to deployment results with deployed and failed contracts
+ */
+export declare function handleSeedContracts(input: SeedContractsInput, options?: SeedingToolOptions): Promise<McpResponse<SeedContractsResult>>;
+/**
+ * Handles the mm_get_contract_address tool to retrieve a deployed contract's address.
+ *
+ * @param input The contract name to look up
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to the contract address or null if not found
+ */
+export declare function handleGetContractAddress(input: GetContractAddressInput, options?: SeedingToolOptions): Promise<McpResponse<GetContractAddressResult>>;
+/**
+ * Handles the mm_list_contracts tool to list all deployed contracts in the session.
+ *
+ * @param _input Unused input parameter (no input required for this tool)
+ * @param options Tool options including seeding capability
+ * @returns Promise resolving to a list of all deployed contracts with their addresses
+ */
+export declare function handleListDeployedContracts(_input: ListDeployedContractsInput, options?: SeedingToolOptions): Promise<McpResponse<ListDeployedContractsResult>>;
+//# sourceMappingURL=seeding.d.mts.map