@metamask/client-mcp-core 0.1.0

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

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setToolRegistry = setToolRegistry;
+exports.getToolRegistry = getToolRegistry;
+exports.hasToolRegistry = hasToolRegistry;
+exports.setToolValidator = setToolValidator;
+exports.getToolValidator = getToolValidator;
+exports.handleRunSteps = handleRunSteps;
+const session_manager_js_1 = require("../session-manager.cjs");
+const types_1 = require("../types/index.cjs");
+const utils_1 = require("../utils/index.cjs");
+/**
+ * Maps includeObservations string to observation policy override.
+ *
+ * @param value The observation policy string ('none', 'failures', 'all', or undefined)
+ * @returns The mapped observation policy override
+ */
+function mapIncludeObservationsToPolicy(value) {
+    switch (value) {
+        case 'none':
+            return 'none';
+        case 'failures':
+            return 'failures';
+        case 'all':
+        default:
+            return 'default';
+    }
+}
+let _toolRegistry = {};
+let _toolValidator;
+/**
+ * Sets the global tool registry for batch execution.
+ *
+ * @param registry Tool registry mapping names to handlers
+ */
+function setToolRegistry(registry) {
+    _toolRegistry = registry;
+}
+/**
+ * Gets the current global tool registry.
+ *
+ * @returns The current tool registry
+ */
+function getToolRegistry() {
+    return _toolRegistry;
+}
+/**
+ * Checks if the tool registry has any registered handlers.
+ *
+ * @returns True if registry contains handlers, false otherwise
+ */
+function hasToolRegistry() {
+    return Object.keys(_toolRegistry).length > 0;
+}
+/**
+ * Sets the global tool validator for batch execution.
+ *
+ * @param validator Validator function to validate tool arguments
+ */
+function setToolValidator(validator) {
+    _toolValidator = validator;
+}
+/**
+ * Gets the current global tool validator.
+ *
+ * @returns The current tool validator or undefined if not set
+ */
+function getToolValidator() {
+    return _toolValidator;
+}
+/**
+ * Executes multiple tool steps in sequence with optional validation and error handling.
+ *
+ * @param input Steps to execute with optional stop-on-error and observation policy
+ * @param options Optional handler configuration and observation policy override
+ * @returns Promise resolving to MCP response with step results and summary
+ */
+async function handleRunSteps(input, options) {
+    const batchStartTime = Date.now();
+    const sessionManager = (0, session_manager_js_1.getSessionManager)();
+    const sessionId = sessionManager.getSessionId();
+    if (!sessionManager.hasActiveSession()) {
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_NO_ACTIVE_SESSION, 'No active session. Call launch first.', { input }, undefined, batchStartTime);
+    }
+    const { steps: stepInputs, stopOnError = false, includeObservations } = input;
+    const observationPolicy = mapIncludeObservationsToPolicy(includeObservations);
+    const stepResults = [];
+    let succeeded = 0;
+    let failed = 0;
+    const toolHandlers = getToolRegistry();
+    const toolValidator = getToolValidator();
+    for (const stepInput of stepInputs) {
+        const stepStartTime = Date.now();
+        const { tool, args = {} } = stepInput;
+        const handler = toolHandlers[tool];
+        if (!handler) {
+            const result = {
+                tool,
+                ok: false,
+                error: {
+                    code: types_1.ErrorCodes.MM_UNKNOWN_TOOL,
+                    message: `Unknown tool: ${tool}`,
+                },
+                meta: {
+                    durationMs: Date.now() - stepStartTime,
+                    timestamp: new Date().toISOString(),
+                },
+            };
+            stepResults.push(result);
+            failed += 1;
+            if (stopOnError) {
+                break;
+            }
+            continue;
+        }
+        if (toolValidator) {
+            const validation = toolValidator(tool, args);
+            if (!validation.success) {
+                const result = {
+                    tool,
+                    ok: false,
+                    error: {
+                        code: types_1.ErrorCodes.MM_INVALID_INPUT,
+                        message: `Invalid input: ${validation.error.message}`,
+                    },
+                    meta: {
+                        durationMs: Date.now() - stepStartTime,
+                        timestamp: new Date().toISOString(),
+                    },
+                };
+                stepResults.push(result);
+                failed += 1;
+                if (stopOnError) {
+                    break;
+                }
+                continue;
+            }
+        }
+        try {
+            const stepOptions = {
+                ...options,
+                observationPolicy,
+            };
+            const response = await handler(args, stepOptions);
+            const result = {
+                tool,
+                ok: response.ok,
+                result: response.ok ? response.result : undefined,
+                error: response.ok ? undefined : response.error,
+                meta: {
+                    durationMs: Date.now() - stepStartTime,
+                    timestamp: new Date().toISOString(),
+                },
+            };
+            stepResults.push(result);
+            if (response.ok) {
+                succeeded += 1;
+            }
+            else {
+                failed += 1;
+                if (stopOnError) {
+                    break;
+                }
+            }
+        }
+        catch (error) {
+            const message = (0, utils_1.extractErrorMessage)(error);
+            const result = {
+                tool,
+                ok: false,
+                error: {
+                    code: types_1.ErrorCodes.MM_INTERNAL_ERROR,
+                    message: `Unexpected error: ${message}`,
+                },
+                meta: {
+                    durationMs: Date.now() - stepStartTime,
+                    timestamp: new Date().toISOString(),
+                },
+            };
+            stepResults.push(result);
+            failed += 1;
+            if (stopOnError) {
+                break;
+            }
+        }
+    }
+    const batchResult = {
+        steps: stepResults,
+        summary: {
+            ok: failed === 0,
+            total: stepResults.length,
+            succeeded,
+            failed,
+            durationMs: Date.now() - batchStartTime,
+        },
+    };
+    return (0, utils_1.createSuccessResponse)(batchResult, sessionId, batchStartTime);
+}
+//# sourceMappingURL=batch.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.cjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/batch.ts"],"names":[],"mappings":"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","sourcesContent":["import { getSessionManager } from '../session-manager.js';\nimport type {\n  McpResponse,\n  HandlerOptions,\n  RunStepsInput,\n  RunStepsResult,\n  StepResult,\n  ObservationPolicyOverride,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport {\n  createSuccessResponse,\n  createErrorResponse,\n  extractErrorMessage,\n} from '../utils';\n\n/**\n * Maps includeObservations string to observation policy override.\n *\n * @param value The observation policy string ('none', 'failures', 'all', or undefined)\n * @returns The mapped observation policy override\n */\nfunction mapIncludeObservationsToPolicy(\n  value: 'none' | 'failures' | 'all' | undefined,\n): ObservationPolicyOverride {\n  switch (value) {\n    case 'none':\n      return 'none';\n    case 'failures':\n      return 'failures';\n    case 'all':\n    default:\n      return 'default';\n  }\n}\n\n/**\n * Handler function type for executing MCP tools.\n *\n * @param input Tool arguments as key-value pairs\n * @param options Optional handler configuration\n * @returns Promise resolving to MCP response with tool result\n */\nexport type ToolHandler = (\n  input: Record<string, unknown>,\n  options?: HandlerOptions,\n) => Promise<McpResponse<unknown>>;\n\n/**\n * Registry mapping tool names to their handler functions.\n *\n * @returns Record of tool name to handler function mappings\n */\nexport type ToolRegistry = Record<string, ToolHandler>;\n\n/**\n * Validator function type for validating tool arguments before execution.\n *\n * @param tool Tool name being validated\n * @param args Tool arguments to validate\n * @returns Validation result with success status and optional error details\n */\nexport type ToolValidator = (\n  tool: string,\n  args: Record<string, unknown>,\n) =>\n  | {\n      /**\n       * Validation succeeded\n       */\n      success: true;\n    }\n  | {\n      /**\n       * Validation failed\n       */\n      success: false;\n      /**\n       * Error details when validation fails\n       */\n      error: {\n        /**\n         * Error message describing validation failure\n         */\n        message: string;\n      };\n    };\n\nlet _toolRegistry: ToolRegistry = {};\nlet _toolValidator: ToolValidator | undefined;\n\n/**\n * Sets the global tool registry for batch execution.\n *\n * @param registry Tool registry mapping names to handlers\n */\nexport function setToolRegistry(registry: ToolRegistry): void {\n  _toolRegistry = registry;\n}\n\n/**\n * Gets the current global tool registry.\n *\n * @returns The current tool registry\n */\nexport function getToolRegistry(): ToolRegistry {\n  return _toolRegistry;\n}\n\n/**\n * Checks if the tool registry has any registered handlers.\n *\n * @returns True if registry contains handlers, false otherwise\n */\nexport function hasToolRegistry(): boolean {\n  return Object.keys(_toolRegistry).length > 0;\n}\n\n/**\n * Sets the global tool validator for batch execution.\n *\n * @param validator Validator function to validate tool arguments\n */\nexport function setToolValidator(validator: ToolValidator): void {\n  _toolValidator = validator;\n}\n\n/**\n * Gets the current global tool validator.\n *\n * @returns The current tool validator or undefined if not set\n */\nexport function getToolValidator(): ToolValidator | undefined {\n  return _toolValidator;\n}\n\n/**\n * Executes multiple tool steps in sequence with optional validation and error handling.\n *\n * @param input Steps to execute with optional stop-on-error and observation policy\n * @param options Optional handler configuration and observation policy override\n * @returns Promise resolving to MCP response with step results and summary\n */\nexport async function handleRunSteps(\n  input: RunStepsInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<RunStepsResult>> {\n  const batchStartTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n\n  if (!sessionManager.hasActiveSession()) {\n    return createErrorResponse(\n      ErrorCodes.MM_NO_ACTIVE_SESSION,\n      'No active session. Call launch first.',\n      { input },\n      undefined,\n      batchStartTime,\n    );\n  }\n\n  const { steps: stepInputs, stopOnError = false, includeObservations } = input;\n  const observationPolicy = mapIncludeObservationsToPolicy(includeObservations);\n  const stepResults: StepResult[] = [];\n  let succeeded = 0;\n  let failed = 0;\n\n  const toolHandlers = getToolRegistry();\n  const toolValidator = getToolValidator();\n\n  for (const stepInput of stepInputs) {\n    const stepStartTime = Date.now();\n    const { tool, args = {} } = stepInput;\n\n    const handler = toolHandlers[tool];\n    if (!handler) {\n      const result: StepResult = {\n        tool,\n        ok: false,\n        error: {\n          code: ErrorCodes.MM_UNKNOWN_TOOL,\n          message: `Unknown tool: ${tool}`,\n        },\n        meta: {\n          durationMs: Date.now() - stepStartTime,\n          timestamp: new Date().toISOString(),\n        },\n      };\n      stepResults.push(result);\n      failed += 1;\n\n      if (stopOnError) {\n        break;\n      }\n      continue;\n    }\n\n    if (toolValidator) {\n      const validation = toolValidator(tool, args);\n      if (!validation.success) {\n        const result: StepResult = {\n          tool,\n          ok: false,\n          error: {\n            code: ErrorCodes.MM_INVALID_INPUT,\n            message: `Invalid input: ${validation.error.message}`,\n          },\n          meta: {\n            durationMs: Date.now() - stepStartTime,\n            timestamp: new Date().toISOString(),\n          },\n        };\n        stepResults.push(result);\n        failed += 1;\n\n        if (stopOnError) {\n          break;\n        }\n        continue;\n      }\n    }\n\n    try {\n      const stepOptions: HandlerOptions = {\n        ...options,\n        observationPolicy,\n      };\n      const response = await handler(args, stepOptions);\n\n      const result: StepResult = {\n        tool,\n        ok: response.ok,\n        result: response.ok ? response.result : undefined,\n        error: response.ok ? undefined : response.error,\n        meta: {\n          durationMs: Date.now() - stepStartTime,\n          timestamp: new Date().toISOString(),\n        },\n      };\n\n      stepResults.push(result);\n\n      if (response.ok) {\n        succeeded += 1;\n      } else {\n        failed += 1;\n        if (stopOnError) {\n          break;\n        }\n      }\n    } catch (error) {\n      const message = extractErrorMessage(error);\n      const result: StepResult = {\n        tool,\n        ok: false,\n        error: {\n          code: ErrorCodes.MM_INTERNAL_ERROR,\n          message: `Unexpected error: ${message}`,\n        },\n        meta: {\n          durationMs: Date.now() - stepStartTime,\n          timestamp: new Date().toISOString(),\n        },\n      };\n      stepResults.push(result);\n      failed += 1;\n\n      if (stopOnError) {\n        break;\n      }\n    }\n  }\n\n  const batchResult: RunStepsResult = {\n    steps: stepResults,\n    summary: {\n      ok: failed === 0,\n      total: stepResults.length,\n      succeeded,\n      failed,\n      durationMs: Date.now() - batchStartTime,\n    },\n  };\n\n  return createSuccessResponse(batchResult, sessionId, batchStartTime);\n}\n"]}

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

@@ -0,0 +1,81 @@
+import type { McpResponse, HandlerOptions, RunStepsInput, RunStepsResult } from "../types/index.cjs";
+/**
+ * Handler function type for executing MCP tools.
+ *
+ * @param input Tool arguments as key-value pairs
+ * @param options Optional handler configuration
+ * @returns Promise resolving to MCP response with tool result
+ */
+export type ToolHandler = (input: Record<string, unknown>, options?: HandlerOptions) => Promise<McpResponse<unknown>>;
+/**
+ * Registry mapping tool names to their handler functions.
+ *
+ * @returns Record of tool name to handler function mappings
+ */
+export type ToolRegistry = Record<string, ToolHandler>;
+/**
+ * Validator function type for validating tool arguments before execution.
+ *
+ * @param tool Tool name being validated
+ * @param args Tool arguments to validate
+ * @returns Validation result with success status and optional error details
+ */
+export type ToolValidator = (tool: string, args: Record<string, unknown>) => {
+    /**
+     * Validation succeeded
+     */
+    success: true;
+} | {
+    /**
+     * Validation failed
+     */
+    success: false;
+    /**
+     * Error details when validation fails
+     */
+    error: {
+        /**
+         * Error message describing validation failure
+         */
+        message: string;
+    };
+};
+/**
+ * Sets the global tool registry for batch execution.
+ *
+ * @param registry Tool registry mapping names to handlers
+ */
+export declare function setToolRegistry(registry: ToolRegistry): void;
+/**
+ * Gets the current global tool registry.
+ *
+ * @returns The current tool registry
+ */
+export declare function getToolRegistry(): ToolRegistry;
+/**
+ * Checks if the tool registry has any registered handlers.
+ *
+ * @returns True if registry contains handlers, false otherwise
+ */
+export declare function hasToolRegistry(): boolean;
+/**
+ * Sets the global tool validator for batch execution.
+ *
+ * @param validator Validator function to validate tool arguments
+ */
+export declare function setToolValidator(validator: ToolValidator): void;
+/**
+ * Gets the current global tool validator.
+ *
+ * @returns The current tool validator or undefined if not set
+ */
+export declare function getToolValidator(): ToolValidator | undefined;
+/**
+ * Executes multiple tool steps in sequence with optional validation and error handling.
+ *
+ * @param input Steps to execute with optional stop-on-error and observation policy
+ * @param options Optional handler configuration and observation policy override
+ * @returns Promise resolving to MCP response with step results and summary
+ */
+export declare function handleRunSteps(input: RunStepsInput, options?: HandlerOptions): Promise<McpResponse<RunStepsResult>>;
+//# sourceMappingURL=batch.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.cts","sourceRoot":"","sources":["../../../src/mcp-server/tools/batch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,cAAc,EAGf,2BAAiB;AA4BlB;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AAEnC;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAE3B;IACE;;OAEG;IACH,OAAO,EAAE,IAAI,CAAC;CACf,GACD;IACE;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC;IACf;;OAEG;IACH,KAAK,EAAE;QACL;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAKN;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CA2ItC"}

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

@@ -0,0 +1,81 @@
+import type { McpResponse, HandlerOptions, RunStepsInput, RunStepsResult } from "../types/index.mjs";
+/**
+ * Handler function type for executing MCP tools.
+ *
+ * @param input Tool arguments as key-value pairs
+ * @param options Optional handler configuration
+ * @returns Promise resolving to MCP response with tool result
+ */
+export type ToolHandler = (input: Record<string, unknown>, options?: HandlerOptions) => Promise<McpResponse<unknown>>;
+/**
+ * Registry mapping tool names to their handler functions.
+ *
+ * @returns Record of tool name to handler function mappings
+ */
+export type ToolRegistry = Record<string, ToolHandler>;
+/**
+ * Validator function type for validating tool arguments before execution.
+ *
+ * @param tool Tool name being validated
+ * @param args Tool arguments to validate
+ * @returns Validation result with success status and optional error details
+ */
+export type ToolValidator = (tool: string, args: Record<string, unknown>) => {
+    /**
+     * Validation succeeded
+     */
+    success: true;
+} | {
+    /**
+     * Validation failed
+     */
+    success: false;
+    /**
+     * Error details when validation fails
+     */
+    error: {
+        /**
+         * Error message describing validation failure
+         */
+        message: string;
+    };
+};
+/**
+ * Sets the global tool registry for batch execution.
+ *
+ * @param registry Tool registry mapping names to handlers
+ */
+export declare function setToolRegistry(registry: ToolRegistry): void;
+/**
+ * Gets the current global tool registry.
+ *
+ * @returns The current tool registry
+ */
+export declare function getToolRegistry(): ToolRegistry;
+/**
+ * Checks if the tool registry has any registered handlers.
+ *
+ * @returns True if registry contains handlers, false otherwise
+ */
+export declare function hasToolRegistry(): boolean;
+/**
+ * Sets the global tool validator for batch execution.
+ *
+ * @param validator Validator function to validate tool arguments
+ */
+export declare function setToolValidator(validator: ToolValidator): void;
+/**
+ * Gets the current global tool validator.
+ *
+ * @returns The current tool validator or undefined if not set
+ */
+export declare function getToolValidator(): ToolValidator | undefined;
+/**
+ * Executes multiple tool steps in sequence with optional validation and error handling.
+ *
+ * @param input Steps to execute with optional stop-on-error and observation policy
+ * @param options Optional handler configuration and observation policy override
+ * @returns Promise resolving to MCP response with step results and summary
+ */
+export declare function handleRunSteps(input: RunStepsInput, options?: HandlerOptions): Promise<McpResponse<RunStepsResult>>;
+//# sourceMappingURL=batch.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.mts","sourceRoot":"","sources":["../../../src/mcp-server/tools/batch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,cAAc,EAGf,2BAAiB;AA4BlB;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE,cAAc,KACrB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AAEnC;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAE3B;IACE;;OAEG;IACH,OAAO,EAAE,IAAI,CAAC;CACf,GACD;IACE;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC;IACf;;OAEG;IACH,KAAK,EAAE;QACL;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAKN;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,SAAS,CAE5D;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CA2ItC"}

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

@@ -0,0 +1,191 @@
+import { getSessionManager } from "../session-manager.mjs";
+import { ErrorCodes } from "../types/index.mjs";
+import { createSuccessResponse, createErrorResponse, extractErrorMessage } from "../utils/index.mjs";
+/**
+ * Maps includeObservations string to observation policy override.
+ *
+ * @param value The observation policy string ('none', 'failures', 'all', or undefined)
+ * @returns The mapped observation policy override
+ */
+function mapIncludeObservationsToPolicy(value) {
+    switch (value) {
+        case 'none':
+            return 'none';
+        case 'failures':
+            return 'failures';
+        case 'all':
+        default:
+            return 'default';
+    }
+}
+let _toolRegistry = {};
+let _toolValidator;
+/**
+ * Sets the global tool registry for batch execution.
+ *
+ * @param registry Tool registry mapping names to handlers
+ */
+export function setToolRegistry(registry) {
+    _toolRegistry = registry;
+}
+/**
+ * Gets the current global tool registry.
+ *
+ * @returns The current tool registry
+ */
+export function getToolRegistry() {
+    return _toolRegistry;
+}
+/**
+ * Checks if the tool registry has any registered handlers.
+ *
+ * @returns True if registry contains handlers, false otherwise
+ */
+export function hasToolRegistry() {
+    return Object.keys(_toolRegistry).length > 0;
+}
+/**
+ * Sets the global tool validator for batch execution.
+ *
+ * @param validator Validator function to validate tool arguments
+ */
+export function setToolValidator(validator) {
+    _toolValidator = validator;
+}
+/**
+ * Gets the current global tool validator.
+ *
+ * @returns The current tool validator or undefined if not set
+ */
+export function getToolValidator() {
+    return _toolValidator;
+}
+/**
+ * Executes multiple tool steps in sequence with optional validation and error handling.
+ *
+ * @param input Steps to execute with optional stop-on-error and observation policy
+ * @param options Optional handler configuration and observation policy override
+ * @returns Promise resolving to MCP response with step results and summary
+ */
+export async function handleRunSteps(input, options) {
+    const batchStartTime = Date.now();
+    const sessionManager = getSessionManager();
+    const sessionId = sessionManager.getSessionId();
+    if (!sessionManager.hasActiveSession()) {
+        return createErrorResponse(ErrorCodes.MM_NO_ACTIVE_SESSION, 'No active session. Call launch first.', { input }, undefined, batchStartTime);
+    }
+    const { steps: stepInputs, stopOnError = false, includeObservations } = input;
+    const observationPolicy = mapIncludeObservationsToPolicy(includeObservations);
+    const stepResults = [];
+    let succeeded = 0;
+    let failed = 0;
+    const toolHandlers = getToolRegistry();
+    const toolValidator = getToolValidator();
+    for (const stepInput of stepInputs) {
+        const stepStartTime = Date.now();
+        const { tool, args = {} } = stepInput;
+        const handler = toolHandlers[tool];
+        if (!handler) {
+            const result = {
+                tool,
+                ok: false,
+                error: {
+                    code: ErrorCodes.MM_UNKNOWN_TOOL,
+                    message: `Unknown tool: ${tool}`,
+                },
+                meta: {
+                    durationMs: Date.now() - stepStartTime,
+                    timestamp: new Date().toISOString(),
+                },
+            };
+            stepResults.push(result);
+            failed += 1;
+            if (stopOnError) {
+                break;
+            }
+            continue;
+        }
+        if (toolValidator) {
+            const validation = toolValidator(tool, args);
+            if (!validation.success) {
+                const result = {
+                    tool,
+                    ok: false,
+                    error: {
+                        code: ErrorCodes.MM_INVALID_INPUT,
+                        message: `Invalid input: ${validation.error.message}`,
+                    },
+                    meta: {
+                        durationMs: Date.now() - stepStartTime,
+                        timestamp: new Date().toISOString(),
+                    },
+                };
+                stepResults.push(result);
+                failed += 1;
+                if (stopOnError) {
+                    break;
+                }
+                continue;
+            }
+        }
+        try {
+            const stepOptions = {
+                ...options,
+                observationPolicy,
+            };
+            const response = await handler(args, stepOptions);
+            const result = {
+                tool,
+                ok: response.ok,
+                result: response.ok ? response.result : undefined,
+                error: response.ok ? undefined : response.error,
+                meta: {
+                    durationMs: Date.now() - stepStartTime,
+                    timestamp: new Date().toISOString(),
+                },
+            };
+            stepResults.push(result);
+            if (response.ok) {
+                succeeded += 1;
+            }
+            else {
+                failed += 1;
+                if (stopOnError) {
+                    break;
+                }
+            }
+        }
+        catch (error) {
+            const message = extractErrorMessage(error);
+            const result = {
+                tool,
+                ok: false,
+                error: {
+                    code: ErrorCodes.MM_INTERNAL_ERROR,
+                    message: `Unexpected error: ${message}`,
+                },
+                meta: {
+                    durationMs: Date.now() - stepStartTime,
+                    timestamp: new Date().toISOString(),
+                },
+            };
+            stepResults.push(result);
+            failed += 1;
+            if (stopOnError) {
+                break;
+            }
+        }
+    }
+    const batchResult = {
+        steps: stepResults,
+        summary: {
+            ok: failed === 0,
+            total: stepResults.length,
+            succeeded,
+            failed,
+            durationMs: Date.now() - batchStartTime,
+        },
+    };
+    return createSuccessResponse(batchResult, sessionId, batchStartTime);
+}
+//# sourceMappingURL=batch.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch.mjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/batch.ts"],"names":[],"mappings":"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","sourcesContent":["import { getSessionManager } from '../session-manager.js';\nimport type {\n  McpResponse,\n  HandlerOptions,\n  RunStepsInput,\n  RunStepsResult,\n  StepResult,\n  ObservationPolicyOverride,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport {\n  createSuccessResponse,\n  createErrorResponse,\n  extractErrorMessage,\n} from '../utils';\n\n/**\n * Maps includeObservations string to observation policy override.\n *\n * @param value The observation policy string ('none', 'failures', 'all', or undefined)\n * @returns The mapped observation policy override\n */\nfunction mapIncludeObservationsToPolicy(\n  value: 'none' | 'failures' | 'all' | undefined,\n): ObservationPolicyOverride {\n  switch (value) {\n    case 'none':\n      return 'none';\n    case 'failures':\n      return 'failures';\n    case 'all':\n    default:\n      return 'default';\n  }\n}\n\n/**\n * Handler function type for executing MCP tools.\n *\n * @param input Tool arguments as key-value pairs\n * @param options Optional handler configuration\n * @returns Promise resolving to MCP response with tool result\n */\nexport type ToolHandler = (\n  input: Record<string, unknown>,\n  options?: HandlerOptions,\n) => Promise<McpResponse<unknown>>;\n\n/**\n * Registry mapping tool names to their handler functions.\n *\n * @returns Record of tool name to handler function mappings\n */\nexport type ToolRegistry = Record<string, ToolHandler>;\n\n/**\n * Validator function type for validating tool arguments before execution.\n *\n * @param tool Tool name being validated\n * @param args Tool arguments to validate\n * @returns Validation result with success status and optional error details\n */\nexport type ToolValidator = (\n  tool: string,\n  args: Record<string, unknown>,\n) =>\n  | {\n      /**\n       * Validation succeeded\n       */\n      success: true;\n    }\n  | {\n      /**\n       * Validation failed\n       */\n      success: false;\n      /**\n       * Error details when validation fails\n       */\n      error: {\n        /**\n         * Error message describing validation failure\n         */\n        message: string;\n      };\n    };\n\nlet _toolRegistry: ToolRegistry = {};\nlet _toolValidator: ToolValidator | undefined;\n\n/**\n * Sets the global tool registry for batch execution.\n *\n * @param registry Tool registry mapping names to handlers\n */\nexport function setToolRegistry(registry: ToolRegistry): void {\n  _toolRegistry = registry;\n}\n\n/**\n * Gets the current global tool registry.\n *\n * @returns The current tool registry\n */\nexport function getToolRegistry(): ToolRegistry {\n  return _toolRegistry;\n}\n\n/**\n * Checks if the tool registry has any registered handlers.\n *\n * @returns True if registry contains handlers, false otherwise\n */\nexport function hasToolRegistry(): boolean {\n  return Object.keys(_toolRegistry).length > 0;\n}\n\n/**\n * Sets the global tool validator for batch execution.\n *\n * @param validator Validator function to validate tool arguments\n */\nexport function setToolValidator(validator: ToolValidator): void {\n  _toolValidator = validator;\n}\n\n/**\n * Gets the current global tool validator.\n *\n * @returns The current tool validator or undefined if not set\n */\nexport function getToolValidator(): ToolValidator | undefined {\n  return _toolValidator;\n}\n\n/**\n * Executes multiple tool steps in sequence with optional validation and error handling.\n *\n * @param input Steps to execute with optional stop-on-error and observation policy\n * @param options Optional handler configuration and observation policy override\n * @returns Promise resolving to MCP response with step results and summary\n */\nexport async function handleRunSteps(\n  input: RunStepsInput,\n  options?: HandlerOptions,\n): Promise<McpResponse<RunStepsResult>> {\n  const batchStartTime = Date.now();\n  const sessionManager = getSessionManager();\n  const sessionId = sessionManager.getSessionId();\n\n  if (!sessionManager.hasActiveSession()) {\n    return createErrorResponse(\n      ErrorCodes.MM_NO_ACTIVE_SESSION,\n      'No active session. Call launch first.',\n      { input },\n      undefined,\n      batchStartTime,\n    );\n  }\n\n  const { steps: stepInputs, stopOnError = false, includeObservations } = input;\n  const observationPolicy = mapIncludeObservationsToPolicy(includeObservations);\n  const stepResults: StepResult[] = [];\n  let succeeded = 0;\n  let failed = 0;\n\n  const toolHandlers = getToolRegistry();\n  const toolValidator = getToolValidator();\n\n  for (const stepInput of stepInputs) {\n    const stepStartTime = Date.now();\n    const { tool, args = {} } = stepInput;\n\n    const handler = toolHandlers[tool];\n    if (!handler) {\n      const result: StepResult = {\n        tool,\n        ok: false,\n        error: {\n          code: ErrorCodes.MM_UNKNOWN_TOOL,\n          message: `Unknown tool: ${tool}`,\n        },\n        meta: {\n          durationMs: Date.now() - stepStartTime,\n          timestamp: new Date().toISOString(),\n        },\n      };\n      stepResults.push(result);\n      failed += 1;\n\n      if (stopOnError) {\n        break;\n      }\n      continue;\n    }\n\n    if (toolValidator) {\n      const validation = toolValidator(tool, args);\n      if (!validation.success) {\n        const result: StepResult = {\n          tool,\n          ok: false,\n          error: {\n            code: ErrorCodes.MM_INVALID_INPUT,\n            message: `Invalid input: ${validation.error.message}`,\n          },\n          meta: {\n            durationMs: Date.now() - stepStartTime,\n            timestamp: new Date().toISOString(),\n          },\n        };\n        stepResults.push(result);\n        failed += 1;\n\n        if (stopOnError) {\n          break;\n        }\n        continue;\n      }\n    }\n\n    try {\n      const stepOptions: HandlerOptions = {\n        ...options,\n        observationPolicy,\n      };\n      const response = await handler(args, stepOptions);\n\n      const result: StepResult = {\n        tool,\n        ok: response.ok,\n        result: response.ok ? response.result : undefined,\n        error: response.ok ? undefined : response.error,\n        meta: {\n          durationMs: Date.now() - stepStartTime,\n          timestamp: new Date().toISOString(),\n        },\n      };\n\n      stepResults.push(result);\n\n      if (response.ok) {\n        succeeded += 1;\n      } else {\n        failed += 1;\n        if (stopOnError) {\n          break;\n        }\n      }\n    } catch (error) {\n      const message = extractErrorMessage(error);\n      const result: StepResult = {\n        tool,\n        ok: false,\n        error: {\n          code: ErrorCodes.MM_INTERNAL_ERROR,\n          message: `Unexpected error: ${message}`,\n        },\n        meta: {\n          durationMs: Date.now() - stepStartTime,\n          timestamp: new Date().toISOString(),\n        },\n      };\n      stepResults.push(result);\n      failed += 1;\n\n      if (stopOnError) {\n        break;\n      }\n    }\n  }\n\n  const batchResult: RunStepsResult = {\n    steps: stepResults,\n    summary: {\n      ok: failed === 0,\n      total: stepResults.length,\n      succeeded,\n      failed,\n      durationMs: Date.now() - batchStartTime,\n    },\n  };\n\n  return createSuccessResponse(batchResult, sessionId, batchStartTime);\n}\n"]}

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

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleBuild = handleBuild;
+const types_1 = require("../types/index.cjs");
+const utils_1 = require("../utils/index.cjs");
+/**
+ * Handles the build tool request to build the extension.
+ *
+ * @param input Build configuration with optional buildType and force flag
+ * @param options Optional handler options with build capability
+ * @returns Promise resolving to MCP response with build result
+ */
+async function handleBuild(input, options) {
+    const startTime = Date.now();
+    if (options?.buildCapability) {
+        return handleBuildWithCapability(input, options.buildCapability, startTime);
+    }
+    return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_CAPABILITY_NOT_AVAILABLE, 'BuildCapability not available. The mm_build tool requires either: (1) running in e2e mode with the MetaMask extension wrapper, or (2) running directly in the metamask-extension repository with dependencies installed.', { capability: 'BuildCapability' }, undefined, startTime);
+}
+/**
+ * Handles build using the provided build capability.
+ *
+ * @param input Build configuration with optional buildType and force flag
+ * @param buildCapability Build capability instance for executing the build
+ * @param startTime Timestamp when the operation started
+ * @returns Promise resolving to MCP response with build result
+ */
+async function handleBuildWithCapability(input, buildCapability, startTime) {
+    try {
+        const result = await buildCapability.build({
+            buildType: input.buildType,
+            force: input.force,
+        });
+        if (!result.success) {
+            return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_BUILD_FAILED, `Build failed: ${result.error ?? 'Unknown error'}`, { buildType: input.buildType ?? 'build:test' }, undefined, startTime);
+        }
+        return (0, utils_1.createSuccessResponse)({
+            buildType: input.buildType ?? 'build:test',
+            extensionPathResolved: result.extensionPath,
+        }, undefined, startTime);
+    }
+    catch (error) {
+        const message = (0, utils_1.extractErrorMessage)(error);
+        return (0, utils_1.createErrorResponse)(types_1.ErrorCodes.MM_BUILD_FAILED, `Build failed: ${message}`, { buildType: input.buildType ?? 'build:test' }, undefined, startTime);
+    }
+}
+//# sourceMappingURL=build.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.cjs","sourceRoot":"","sources":["../../../src/mcp-server/tools/build.ts"],"names":[],"mappings":";;AAiCA,kCAiBC;AA3CD,8CAAsC;AACtC,8CAIkB;AAclB;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAC/B,KAAiB,EACjB,OAA0B;IAE1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,OAAO,EAAE,eAAe,EAAE,CAAC;QAC7B,OAAO,yBAAyB,CAAC,KAAK,EAAE,OAAO,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,IAAA,2BAAmB,EACxB,kBAAU,CAAC,2BAA2B,EACtC,0NAA0N,EAC1N,EAAE,UAAU,EAAE,iBAAiB,EAAE,EACjC,SAAS,EACT,SAAS,CACV,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,yBAAyB,CACtC,KAAiB,EACjB,eAAgC,EAChC,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC;YACzC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,IAAA,2BAAmB,EACxB,kBAAU,CAAC,eAAe,EAC1B,iBAAiB,MAAM,CAAC,KAAK,IAAI,eAAe,EAAE,EAClD,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,YAAY,EAAE,EAC9C,SAAS,EACT,SAAS,CACV,CAAC;QACJ,CAAC;QAED,OAAO,IAAA,6BAAqB,EAC1B;YACE,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,YAAY;YAC1C,qBAAqB,EAAE,MAAM,CAAC,aAAa;SAC5C,EACD,SAAS,EACT,SAAS,CACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,IAAA,2BAAmB,EAAC,KAAK,CAAC,CAAC;QAC3C,OAAO,IAAA,2BAAmB,EACxB,kBAAU,CAAC,eAAe,EAC1B,iBAAiB,OAAO,EAAE,EAC1B,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,YAAY,EAAE,EAC9C,SAAS,EACT,SAAS,CACV,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import type { BuildCapability } from '../../capabilities/types.js';\nimport type {\n  BuildInput,\n  BuildToolResult,\n  McpResponse,\n  HandlerOptions,\n} from '../types';\nimport { ErrorCodes } from '../types';\nimport {\n  createSuccessResponse,\n  createErrorResponse,\n  extractErrorMessage,\n} from '../utils';\n\n/**\n * Options for the build tool handler.\n *\n * @returns Handler options with optional build capability\n */\nexport type BuildToolOptions = HandlerOptions & {\n  /**\n   * Optional build capability for extension building\n   */\n  buildCapability?: BuildCapability;\n};\n\n/**\n * Handles the build tool request to build the extension.\n *\n * @param input Build configuration with optional buildType and force flag\n * @param options Optional handler options with build capability\n * @returns Promise resolving to MCP response with build result\n */\nexport async function handleBuild(\n  input: BuildInput,\n  options?: BuildToolOptions,\n): Promise<McpResponse<BuildToolResult>> {\n  const startTime = Date.now();\n\n  if (options?.buildCapability) {\n    return handleBuildWithCapability(input, options.buildCapability, startTime);\n  }\n\n  return createErrorResponse(\n    ErrorCodes.MM_CAPABILITY_NOT_AVAILABLE,\n    'BuildCapability not available. The mm_build tool requires either: (1) running in e2e mode with the MetaMask extension wrapper, or (2) running directly in the metamask-extension repository with dependencies installed.',\n    { capability: 'BuildCapability' },\n    undefined,\n    startTime,\n  );\n}\n\n/**\n * Handles build using the provided build capability.\n *\n * @param input Build configuration with optional buildType and force flag\n * @param buildCapability Build capability instance for executing the build\n * @param startTime Timestamp when the operation started\n * @returns Promise resolving to MCP response with build result\n */\nasync function handleBuildWithCapability(\n  input: BuildInput,\n  buildCapability: BuildCapability,\n  startTime: number,\n): Promise<McpResponse<BuildToolResult>> {\n  try {\n    const result = await buildCapability.build({\n      buildType: input.buildType,\n      force: input.force,\n    });\n\n    if (!result.success) {\n      return createErrorResponse(\n        ErrorCodes.MM_BUILD_FAILED,\n        `Build failed: ${result.error ?? 'Unknown error'}`,\n        { buildType: input.buildType ?? 'build:test' },\n        undefined,\n        startTime,\n      );\n    }\n\n    return createSuccessResponse<BuildToolResult>(\n      {\n        buildType: input.buildType ?? 'build:test',\n        extensionPathResolved: result.extensionPath,\n      },\n      undefined,\n      startTime,\n    );\n  } catch (error) {\n    const message = extractErrorMessage(error);\n    return createErrorResponse(\n      ErrorCodes.MM_BUILD_FAILED,\n      `Build failed: ${message}`,\n      { buildType: input.buildType ?? 'build:test' },\n      undefined,\n      startTime,\n    );\n  }\n}\n"]}