@metamask/client-mcp-core 0.1.0

package/dist/mcp-server/schemas.mjs

@@ -0,0 +1,430 @@
+import { z } from "zod";
+import { SMART_CONTRACT_NAMES, HARDFORKS } from "./types/seeding.mjs";
+export const a11yRefPattern = z
+    .string()
+    .regex(/^e[0-9]+$/u)
+    .describe('Accessibility ref from accessibility_snapshot (e.g., e1, e2). ' +
+    'These refs are ephemeral and only valid within the current screen state.');
+export const targetSelectionSchema = z
+    .object({
+    a11yRef: a11yRefPattern.optional(),
+    testId: z
+        .string()
+        .min(1)
+        .describe('data-testid attribute value (stable, preferred for interactions)')
+        .optional(),
+    selector: z
+        .string()
+        .min(1)
+        .describe('CSS selector (fallback, less stable than testId)')
+        .optional(),
+})
+    .refine((data) => {
+    const provided = [data.a11yRef, data.testId, data.selector].filter(Boolean);
+    return provided.length === 1;
+}, {
+    message: 'Exactly one of a11yRef, testId, or selector must be provided',
+});
+export const knowledgeScopeSchema = z.union([
+    z.literal('current').describe('Only search the active session'),
+    z.literal('all').describe('Search all sessions in the knowledge store'),
+    z
+        .object({
+        sessionId: z.string().min(4).describe('Specific session ID to query'),
+    })
+        .describe('Query a specific prior session by ID'),
+]);
+const smartContractNames = SMART_CONTRACT_NAMES;
+const hardforks = HARDFORKS;
+export const knowledgeFiltersSchema = z
+    .object({
+    flowTag: z
+        .string()
+        .min(1)
+        .describe('Filter by flow tag (e.g., send, swap, connect, sign)')
+        .optional(),
+    tag: z.string().min(1).describe('Filter by free-form tag').optional(),
+    screen: z
+        .string()
+        .min(1)
+        .describe('Filter by screen name (e.g., home, unlock, settings)')
+        .optional(),
+    sinceHours: z
+        .number()
+        .int()
+        .min(1)
+        .max(720)
+        .describe('Only include sessions/steps from the last N hours')
+        .optional(),
+})
+    .optional();
+export const buildInputSchema = z.object({
+    buildType: z
+        .enum(['build:test'])
+        .default('build:test')
+        .describe('Build command to run. Currently only build:test is supported.'),
+    force: z
+        .boolean()
+        .default(false)
+        .describe('Force rebuild even if a build already exists'),
+});
+export const launchInputSchema = z.object({
+    autoBuild: z
+        .boolean()
+        .default(true)
+        .describe('Automatically run build if extension is not found'),
+    stateMode: z
+        .enum(['default', 'onboarding', 'custom'])
+        .default('default')
+        .describe('Wallet state mode: ' +
+        'default = pre-onboarded wallet with 25 ETH, ' +
+        'onboarding = fresh wallet requiring setup, ' +
+        'custom = use provided fixture'),
+    fixturePreset: z
+        .string()
+        .min(1)
+        .describe('Name of preset fixture (e.g., withMultipleAccounts, withERC20Tokens). ' +
+        'Only used when stateMode=custom.')
+        .optional(),
+    fixture: z
+        .record(z.string(), z.unknown())
+        .describe('Direct fixture object for stateMode=custom')
+        .optional(),
+    ports: z
+        .object({
+        anvil: z
+            .number()
+            .int()
+            .min(1)
+            .max(65535)
+            .describe('Port for Anvil local chain (default: 8545)')
+            .optional(),
+        fixtureServer: z
+            .number()
+            .int()
+            .min(1)
+            .max(65535)
+            .describe('Port for fixture server (default: 12345)')
+            .optional(),
+    })
+        .optional(),
+    slowMo: z
+        .number()
+        .int()
+        .min(0)
+        .max(10000)
+        .default(0)
+        .describe('Slow down Playwright actions by N milliseconds (for debugging)'),
+    extensionPath: z
+        .string()
+        .describe('Custom path to built extension directory')
+        .optional(),
+    goal: z
+        .string()
+        .describe('Goal or task description for this session (for knowledge store)')
+        .optional(),
+    flowTags: z
+        .array(z.string())
+        .describe('Flow tags for categorization (e.g., ["send"], ["swap", "confirmation"]). ' +
+        'Used for cross-session knowledge retrieval.')
+        .optional(),
+    tags: z
+        .array(z.string())
+        .describe('Free-form tags for ad-hoc filtering')
+        .optional(),
+    seedContracts: z
+        .array(z.enum(smartContractNames))
+        .describe('Smart contracts to deploy on launch (before extension loads)')
+        .optional(),
+});
+export const cleanupInputSchema = z.object({
+    sessionId: z
+        .string()
+        .describe('Session ID to clean up (optional, defaults to current)')
+        .optional(),
+});
+export const getStateInputSchema = z.object({});
+export const navigateInputSchema = z
+    .object({
+    screen: z
+        .enum(['home', 'settings', 'notification', 'url'])
+        .describe('Target screen: home, settings, notification (popup), or url (custom)'),
+    url: z
+        .string()
+        .min(1)
+        .describe('URL to navigate to (required when screen="url")')
+        .optional(),
+})
+    .refine((data) => {
+    if (data.screen === 'url' && !data.url) {
+        return false;
+    }
+    return true;
+}, {
+    message: 'url is required when screen is "url"',
+    path: ['url'],
+});
+export const waitForNotificationInputSchema = z.object({
+    timeoutMs: z
+        .number()
+        .int()
+        .min(1000)
+        .max(60000)
+        .default(15000)
+        .describe('Timeout in milliseconds to wait for notification popup'),
+});
+export const listTestIdsInputSchema = z.object({
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .default(150)
+        .describe('Maximum number of testIds to return'),
+});
+export const accessibilitySnapshotInputSchema = z.object({
+    rootSelector: z
+        .string()
+        .min(1)
+        .describe('CSS selector to scope the snapshot (optional)')
+        .optional(),
+});
+export const describeScreenInputSchema = z.object({
+    includeScreenshot: z
+        .boolean()
+        .default(false)
+        .describe('Capture and include a screenshot (opt-in for privacy)'),
+    screenshotName: z
+        .string()
+        .min(1)
+        .describe('Name for the screenshot file (without extension)')
+        .optional(),
+    includeScreenshotBase64: z
+        .boolean()
+        .default(false)
+        .describe('Include base64-encoded screenshot in response'),
+});
+export const screenshotInputSchema = z.object({
+    name: z.string().min(1).describe('Screenshot filename (without extension)'),
+    fullPage: z
+        .boolean()
+        .default(true)
+        .describe('Capture full page or just viewport'),
+    selector: z
+        .string()
+        .min(1)
+        .describe('CSS selector to capture specific element')
+        .optional(),
+    includeBase64: z
+        .boolean()
+        .default(false)
+        .describe('Include base64-encoded image in response'),
+});
+export const clickInputSchema = targetSelectionSchema.and(z.object({
+    timeoutMs: z
+        .number()
+        .int()
+        .min(0)
+        .max(60000)
+        .default(15000)
+        .describe('Timeout to wait for element to become visible'),
+}));
+export const typeInputSchema = targetSelectionSchema.and(z.object({
+    text: z.string().describe('Text to type into the element'),
+    timeoutMs: z
+        .number()
+        .int()
+        .min(0)
+        .max(60000)
+        .default(15000)
+        .describe('Timeout to wait for element to become visible'),
+}));
+export const waitForInputSchema = targetSelectionSchema.and(z.object({
+    timeoutMs: z
+        .number()
+        .int()
+        .min(100)
+        .max(120000)
+        .default(15000)
+        .describe('Timeout to wait for element'),
+}));
+export const knowledgeLastInputSchema = z.object({
+    n: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .default(20)
+        .describe('Number of recent steps to retrieve'),
+    scope: knowledgeScopeSchema
+        .default('current')
+        .describe('Scope for retrieval: current session, all sessions, or specific session'),
+    filters: knowledgeFiltersSchema,
+});
+export const knowledgeSearchInputSchema = z.object({
+    query: z
+        .string()
+        .min(1)
+        .max(200)
+        .describe('Search query - matches tool names, screen names, testIds, and a11y names'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(20)
+        .describe('Maximum number of results'),
+    scope: knowledgeScopeSchema
+        .default('all')
+        .describe('Search scope (defaults to all sessions for cross-session learning)'),
+    filters: knowledgeFiltersSchema,
+});
+export const knowledgeSummarizeInputSchema = z.object({
+    sessionId: z
+        .string()
+        .describe('Deprecated: use scope. Session ID to summarize.')
+        .optional(),
+    scope: z
+        .union([
+        z.literal('current'),
+        z.object({
+            sessionId: z.string().min(4),
+        }),
+    ])
+        .default('current')
+        .describe('Session to summarize (cannot use "all")'),
+});
+export const knowledgeSessionsInputSchema = z.object({
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(10)
+        .describe('Maximum number of sessions to list'),
+    filters: knowledgeFiltersSchema,
+});
+export const seedContractInputSchema = z.object({
+    contractName: z.enum(smartContractNames),
+    hardfork: z.enum(hardforks).optional(),
+    deployerOptions: z
+        .object({
+        fromAddress: z.string().optional(),
+        fromPrivateKey: z.string().optional(),
+    })
+        .optional(),
+});
+export const seedContractsInputSchema = z.object({
+    contracts: z.array(z.enum(smartContractNames)).min(1).max(9),
+    hardfork: z.enum(hardforks).optional(),
+});
+export const getContractAddressInputSchema = z.object({
+    contractName: z.enum(smartContractNames),
+});
+export const listDeployedContractsInputSchema = z.object({});
+const tabRoles = ['extension', 'notification', 'dapp', 'other'];
+const closableTabRoles = ['notification', 'dapp', 'other'];
+export const switchToTabInputSchema = z
+    .object({
+    role: z
+        .enum(tabRoles)
+        .describe('Tab role to switch to (extension, notification, dapp, other)')
+        .optional(),
+    url: z
+        .string()
+        .min(1)
+        .describe('URL prefix to match for tab switching')
+        .optional(),
+})
+    .refine((data) => data.role ?? data.url, {
+    message: 'Either role or url must be provided',
+});
+export const closeTabInputSchema = z
+    .object({
+    role: z
+        .enum(closableTabRoles)
+        .describe('Tab role to close (notification, dapp, other). Cannot close extension.')
+        .optional(),
+    url: z
+        .string()
+        .min(1)
+        .describe('URL prefix to match for tab closing')
+        .optional(),
+})
+    .refine((data) => data.role ?? data.url, {
+    message: 'Either role or url must be provided',
+});
+export const runStepsInputSchema = z.object({
+    steps: z
+        .array(z.object({
+        tool: z.string(),
+        args: z.record(z.string(), z.unknown()).optional(),
+    }))
+        .min(1)
+        .max(50)
+        .describe('Array of tool calls to execute in order'),
+    stopOnError: z
+        .boolean()
+        .default(false)
+        .describe('Stop execution on first error (default: false - continue)'),
+    includeObservations: z
+        .enum(['none', 'failures', 'all'])
+        .default('all')
+        .describe('When to include observations in results: ' +
+        'none = never (fastest), failures = only for failed steps, all = always'),
+});
+export const setContextInputSchema = z.object({
+    context: z.enum(['e2e', 'prod']).describe('Target context to switch to'),
+});
+export const getContextInputSchema = z
+    .object({})
+    .describe('No parameters required');
+export const clipboardInputSchema = z
+    .object({
+    action: z
+        .enum(['write', 'read'])
+        .describe('Action to perform: write text to clipboard or read from clipboard'),
+    text: z
+        .string()
+        .describe("Text to write to clipboard (required when action is 'write')")
+        .optional(),
+})
+    .refine((data) => {
+    if (data.action === 'write' && !data.text) {
+        return false;
+    }
+    return true;
+}, {
+    message: "text is required when action is 'write'",
+    path: ['text'],
+});
+export const toolSchemas = {
+    build: buildInputSchema,
+    launch: launchInputSchema,
+    cleanup: cleanupInputSchema,
+    get_state: getStateInputSchema,
+    navigate: navigateInputSchema,
+    wait_for_notification: waitForNotificationInputSchema,
+    switch_to_tab: switchToTabInputSchema,
+    close_tab: closeTabInputSchema,
+    list_testids: listTestIdsInputSchema,
+    accessibility_snapshot: accessibilitySnapshotInputSchema,
+    describe_screen: describeScreenInputSchema,
+    screenshot: screenshotInputSchema,
+    click: clickInputSchema,
+    type: typeInputSchema,
+    wait_for: waitForInputSchema,
+    knowledge_last: knowledgeLastInputSchema,
+    knowledge_search: knowledgeSearchInputSchema,
+    knowledge_summarize: knowledgeSummarizeInputSchema,
+    knowledge_sessions: knowledgeSessionsInputSchema,
+    seed_contract: seedContractInputSchema,
+    seed_contracts: seedContractsInputSchema,
+    get_contract_address: getContractAddressInputSchema,
+    list_contracts: listDeployedContractsInputSchema,
+    run_steps: runStepsInputSchema,
+    set_context: setContextInputSchema,
+    get_context: getContextInputSchema,
+    clipboard: clipboardInputSchema,
+};
+//# sourceMappingURL=schemas.mjs.map

package/dist/mcp-server/schemas.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.mjs","sourceRoot":"","sources":["../../src/mcp-server/schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport { SMART_CONTRACT_NAMES, HARDFORKS } from './types/seeding.js';\n\nexport const a11yRefPattern = z\n  .string()\n  .regex(/^e[0-9]+$/u)\n  .describe(\n    'Accessibility ref from accessibility_snapshot (e.g., e1, e2). ' +\n      'These refs are ephemeral and only valid within the current screen state.',\n  );\n\nexport const targetSelectionSchema = z\n  .object({\n    a11yRef: a11yRefPattern.optional(),\n    testId: z\n      .string()\n      .min(1)\n      .describe(\n        'data-testid attribute value (stable, preferred for interactions)',\n      )\n      .optional(),\n    selector: z\n      .string()\n      .min(1)\n      .describe('CSS selector (fallback, less stable than testId)')\n      .optional(),\n  })\n  .refine(\n    (data) => {\n      const provided = [data.a11yRef, data.testId, data.selector].filter(\n        Boolean,\n      );\n      return provided.length === 1;\n    },\n    {\n      message: 'Exactly one of a11yRef, testId, or selector must be provided',\n    },\n  );\n\nexport const knowledgeScopeSchema = z.union([\n  z.literal('current').describe('Only search the active session'),\n  z.literal('all').describe('Search all sessions in the knowledge store'),\n  z\n    .object({\n      sessionId: z.string().min(4).describe('Specific session ID to query'),\n    })\n    .describe('Query a specific prior session by ID'),\n]);\n\nconst smartContractNames = SMART_CONTRACT_NAMES;\nconst hardforks = HARDFORKS;\n\nexport const knowledgeFiltersSchema = z\n  .object({\n    flowTag: z\n      .string()\n      .min(1)\n      .describe('Filter by flow tag (e.g., send, swap, connect, sign)')\n      .optional(),\n    tag: z.string().min(1).describe('Filter by free-form tag').optional(),\n    screen: z\n      .string()\n      .min(1)\n      .describe('Filter by screen name (e.g., home, unlock, settings)')\n      .optional(),\n    sinceHours: z\n      .number()\n      .int()\n      .min(1)\n      .max(720)\n      .describe('Only include sessions/steps from the last N hours')\n      .optional(),\n  })\n  .optional();\n\nexport const buildInputSchema = z.object({\n  buildType: z\n    .enum(['build:test'])\n    .default('build:test')\n    .describe('Build command to run. Currently only build:test is supported.'),\n  force: z\n    .boolean()\n    .default(false)\n    .describe('Force rebuild even if a build already exists'),\n});\n\nexport const launchInputSchema = z.object({\n  autoBuild: z\n    .boolean()\n    .default(true)\n    .describe('Automatically run build if extension is not found'),\n  stateMode: z\n    .enum(['default', 'onboarding', 'custom'])\n    .default('default')\n    .describe(\n      'Wallet state mode: ' +\n        'default = pre-onboarded wallet with 25 ETH, ' +\n        'onboarding = fresh wallet requiring setup, ' +\n        'custom = use provided fixture',\n    ),\n  fixturePreset: z\n    .string()\n    .min(1)\n    .describe(\n      'Name of preset fixture (e.g., withMultipleAccounts, withERC20Tokens). ' +\n        'Only used when stateMode=custom.',\n    )\n    .optional(),\n  fixture: z\n    .record(z.string(), z.unknown())\n    .describe('Direct fixture object for stateMode=custom')\n    .optional(),\n  ports: z\n    .object({\n      anvil: z\n        .number()\n        .int()\n        .min(1)\n        .max(65535)\n        .describe('Port for Anvil local chain (default: 8545)')\n        .optional(),\n      fixtureServer: z\n        .number()\n        .int()\n        .min(1)\n        .max(65535)\n        .describe('Port for fixture server (default: 12345)')\n        .optional(),\n    })\n    .optional(),\n  slowMo: z\n    .number()\n    .int()\n    .min(0)\n    .max(10000)\n    .default(0)\n    .describe('Slow down Playwright actions by N milliseconds (for debugging)'),\n  extensionPath: z\n    .string()\n    .describe('Custom path to built extension directory')\n    .optional(),\n  goal: z\n    .string()\n    .describe('Goal or task description for this session (for knowledge store)')\n    .optional(),\n  flowTags: z\n    .array(z.string())\n    .describe(\n      'Flow tags for categorization (e.g., [\"send\"], [\"swap\", \"confirmation\"]). ' +\n        'Used for cross-session knowledge retrieval.',\n    )\n    .optional(),\n  tags: z\n    .array(z.string())\n    .describe('Free-form tags for ad-hoc filtering')\n    .optional(),\n  seedContracts: z\n    .array(z.enum(smartContractNames))\n    .describe('Smart contracts to deploy on launch (before extension loads)')\n    .optional(),\n});\n\nexport const cleanupInputSchema = z.object({\n  sessionId: z\n    .string()\n    .describe('Session ID to clean up (optional, defaults to current)')\n    .optional(),\n});\n\nexport const getStateInputSchema = z.object({});\n\nexport const navigateInputSchema = z\n  .object({\n    screen: z\n      .enum(['home', 'settings', 'notification', 'url'])\n      .describe(\n        'Target screen: home, settings, notification (popup), or url (custom)',\n      ),\n    url: z\n      .string()\n      .min(1)\n      .describe('URL to navigate to (required when screen=\"url\")')\n      .optional(),\n  })\n  .refine(\n    (data) => {\n      if (data.screen === 'url' && !data.url) {\n        return false;\n      }\n      return true;\n    },\n    {\n      message: 'url is required when screen is \"url\"',\n      path: ['url'],\n    },\n  );\n\nexport const waitForNotificationInputSchema = z.object({\n  timeoutMs: z\n    .number()\n    .int()\n    .min(1000)\n    .max(60000)\n    .default(15000)\n    .describe('Timeout in milliseconds to wait for notification popup'),\n});\n\nexport const listTestIdsInputSchema = z.object({\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(500)\n    .default(150)\n    .describe('Maximum number of testIds to return'),\n});\n\nexport const accessibilitySnapshotInputSchema = z.object({\n  rootSelector: z\n    .string()\n    .min(1)\n    .describe('CSS selector to scope the snapshot (optional)')\n    .optional(),\n});\n\nexport const describeScreenInputSchema = z.object({\n  includeScreenshot: z\n    .boolean()\n    .default(false)\n    .describe('Capture and include a screenshot (opt-in for privacy)'),\n  screenshotName: z\n    .string()\n    .min(1)\n    .describe('Name for the screenshot file (without extension)')\n    .optional(),\n  includeScreenshotBase64: z\n    .boolean()\n    .default(false)\n    .describe('Include base64-encoded screenshot in response'),\n});\n\nexport const screenshotInputSchema = z.object({\n  name: z.string().min(1).describe('Screenshot filename (without extension)'),\n  fullPage: z\n    .boolean()\n    .default(true)\n    .describe('Capture full page or just viewport'),\n  selector: z\n    .string()\n    .min(1)\n    .describe('CSS selector to capture specific element')\n    .optional(),\n  includeBase64: z\n    .boolean()\n    .default(false)\n    .describe('Include base64-encoded image in response'),\n});\n\nexport const clickInputSchema = targetSelectionSchema.and(\n  z.object({\n    timeoutMs: z\n      .number()\n      .int()\n      .min(0)\n      .max(60000)\n      .default(15000)\n      .describe('Timeout to wait for element to become visible'),\n  }),\n);\n\nexport const typeInputSchema = targetSelectionSchema.and(\n  z.object({\n    text: z.string().describe('Text to type into the element'),\n    timeoutMs: z\n      .number()\n      .int()\n      .min(0)\n      .max(60000)\n      .default(15000)\n      .describe('Timeout to wait for element to become visible'),\n  }),\n);\n\nexport const waitForInputSchema = targetSelectionSchema.and(\n  z.object({\n    timeoutMs: z\n      .number()\n      .int()\n      .min(100)\n      .max(120000)\n      .default(15000)\n      .describe('Timeout to wait for element'),\n  }),\n);\n\nexport const knowledgeLastInputSchema = z.object({\n  n: z\n    .number()\n    .int()\n    .min(1)\n    .max(200)\n    .default(20)\n    .describe('Number of recent steps to retrieve'),\n  scope: knowledgeScopeSchema\n    .default('current')\n    .describe(\n      'Scope for retrieval: current session, all sessions, or specific session',\n    ),\n  filters: knowledgeFiltersSchema,\n});\n\nexport const knowledgeSearchInputSchema = z.object({\n  query: z\n    .string()\n    .min(1)\n    .max(200)\n    .describe(\n      'Search query - matches tool names, screen names, testIds, and a11y names',\n    ),\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(100)\n    .default(20)\n    .describe('Maximum number of results'),\n  scope: knowledgeScopeSchema\n    .default('all')\n    .describe(\n      'Search scope (defaults to all sessions for cross-session learning)',\n    ),\n  filters: knowledgeFiltersSchema,\n});\n\nexport const knowledgeSummarizeInputSchema = z.object({\n  sessionId: z\n    .string()\n    .describe('Deprecated: use scope. Session ID to summarize.')\n    .optional(),\n  scope: z\n    .union([\n      z.literal('current'),\n      z.object({\n        sessionId: z.string().min(4),\n      }),\n    ])\n    .default('current')\n    .describe('Session to summarize (cannot use \"all\")'),\n});\n\nexport const knowledgeSessionsInputSchema = z.object({\n  limit: z\n    .number()\n    .int()\n    .min(1)\n    .max(50)\n    .default(10)\n    .describe('Maximum number of sessions to list'),\n  filters: knowledgeFiltersSchema,\n});\n\nexport const seedContractInputSchema = z.object({\n  contractName: z.enum(smartContractNames),\n  hardfork: z.enum(hardforks).optional(),\n  deployerOptions: z\n    .object({\n      fromAddress: z.string().optional(),\n      fromPrivateKey: z.string().optional(),\n    })\n    .optional(),\n});\n\nexport const seedContractsInputSchema = z.object({\n  contracts: z.array(z.enum(smartContractNames)).min(1).max(9),\n  hardfork: z.enum(hardforks).optional(),\n});\n\nexport const getContractAddressInputSchema = z.object({\n  contractName: z.enum(smartContractNames),\n});\n\nexport const listDeployedContractsInputSchema = z.object({});\n\nconst tabRoles = ['extension', 'notification', 'dapp', 'other'] as const;\nconst closableTabRoles = ['notification', 'dapp', 'other'] as const;\n\nexport const switchToTabInputSchema = z\n  .object({\n    role: z\n      .enum(tabRoles)\n      .describe('Tab role to switch to (extension, notification, dapp, other)')\n      .optional(),\n    url: z\n      .string()\n      .min(1)\n      .describe('URL prefix to match for tab switching')\n      .optional(),\n  })\n  .refine((data) => data.role ?? data.url, {\n    message: 'Either role or url must be provided',\n  });\n\nexport const closeTabInputSchema = z\n  .object({\n    role: z\n      .enum(closableTabRoles)\n      .describe(\n        'Tab role to close (notification, dapp, other). Cannot close extension.',\n      )\n      .optional(),\n    url: z\n      .string()\n      .min(1)\n      .describe('URL prefix to match for tab closing')\n      .optional(),\n  })\n  .refine((data) => data.role ?? data.url, {\n    message: 'Either role or url must be provided',\n  });\n\nexport const runStepsInputSchema = z.object({\n  steps: z\n    .array(\n      z.object({\n        tool: z.string(),\n        args: z.record(z.string(), z.unknown()).optional(),\n      }),\n    )\n    .min(1)\n    .max(50)\n    .describe('Array of tool calls to execute in order'),\n  stopOnError: z\n    .boolean()\n    .default(false)\n    .describe('Stop execution on first error (default: false - continue)'),\n  includeObservations: z\n    .enum(['none', 'failures', 'all'])\n    .default('all')\n    .describe(\n      'When to include observations in results: ' +\n        'none = never (fastest), failures = only for failed steps, all = always',\n    ),\n});\n\nexport const setContextInputSchema = z.object({\n  context: z.enum(['e2e', 'prod']).describe('Target context to switch to'),\n});\n\nexport const getContextInputSchema = z\n  .object({})\n  .describe('No parameters required');\n\nexport const clipboardInputSchema = z\n  .object({\n    action: z\n      .enum(['write', 'read'])\n      .describe(\n        'Action to perform: write text to clipboard or read from clipboard',\n      ),\n    text: z\n      .string()\n      .describe(\"Text to write to clipboard (required when action is 'write')\")\n      .optional(),\n  })\n  .refine(\n    (data) => {\n      if (data.action === 'write' && !data.text) {\n        return false;\n      }\n      return true;\n    },\n    {\n      message: \"text is required when action is 'write'\",\n      path: ['text'],\n    },\n  );\n\nexport type SetContextInputZ = z.infer<typeof setContextInputSchema>;\nexport type GetContextInputZ = z.infer<typeof getContextInputSchema>;\nexport type ClipboardInputZ = z.infer<typeof clipboardInputSchema>;\n\nexport const toolSchemas = {\n  build: buildInputSchema,\n  launch: launchInputSchema,\n  cleanup: cleanupInputSchema,\n  get_state: getStateInputSchema,\n  navigate: navigateInputSchema,\n  wait_for_notification: waitForNotificationInputSchema,\n  switch_to_tab: switchToTabInputSchema,\n  close_tab: closeTabInputSchema,\n  list_testids: listTestIdsInputSchema,\n  accessibility_snapshot: accessibilitySnapshotInputSchema,\n  describe_screen: describeScreenInputSchema,\n  screenshot: screenshotInputSchema,\n  click: clickInputSchema,\n  type: typeInputSchema,\n  wait_for: waitForInputSchema,\n  knowledge_last: knowledgeLastInputSchema,\n  knowledge_search: knowledgeSearchInputSchema,\n  knowledge_summarize: knowledgeSummarizeInputSchema,\n  knowledge_sessions: knowledgeSessionsInputSchema,\n  seed_contract: seedContractInputSchema,\n  seed_contracts: seedContractsInputSchema,\n  get_contract_address: getContractAddressInputSchema,\n  list_contracts: listDeployedContractsInputSchema,\n  run_steps: runStepsInputSchema,\n  set_context: setContextInputSchema,\n  get_context: getContextInputSchema,\n  clipboard: clipboardInputSchema,\n} as const;\n\nexport type ToolName = keyof typeof toolSchemas;\n\nexport type BuildInputZ = z.infer<typeof buildInputSchema>;\nexport type LaunchInputZ = z.infer<typeof launchInputSchema>;\nexport type CleanupInputZ = z.infer<typeof cleanupInputSchema>;\nexport type GetStateInputZ = z.infer<typeof getStateInputSchema>;\nexport type NavigateInputZ = z.infer<typeof navigateInputSchema>;\nexport type WaitForNotificationInputZ = z.infer<\n  typeof waitForNotificationInputSchema\n>;\nexport type ListTestIdsInputZ = z.infer<typeof listTestIdsInputSchema>;\nexport type AccessibilitySnapshotInputZ = z.infer<\n  typeof accessibilitySnapshotInputSchema\n>;\nexport type DescribeScreenInputZ = z.infer<typeof describeScreenInputSchema>;\nexport type ScreenshotInputZ = z.infer<typeof screenshotInputSchema>;\nexport type ClickInputZ = z.infer<typeof clickInputSchema>;\nexport type TypeInputZ = z.infer<typeof typeInputSchema>;\nexport type WaitForInputZ = z.infer<typeof waitForInputSchema>;\nexport type KnowledgeLastInputZ = z.infer<typeof knowledgeLastInputSchema>;\nexport type KnowledgeSearchInputZ = z.infer<typeof knowledgeSearchInputSchema>;\nexport type KnowledgeSummarizeInputZ = z.infer<\n  typeof knowledgeSummarizeInputSchema\n>;\nexport type KnowledgeSessionsInputZ = z.infer<\n  typeof knowledgeSessionsInputSchema\n>;\nexport type KnowledgeScopeZ = z.infer<typeof knowledgeScopeSchema>;\nexport type KnowledgeFiltersZ = z.infer<typeof knowledgeFiltersSchema>;\nexport type RunStepsInputZ = z.infer<typeof runStepsInputSchema>;\nexport type SwitchToTabInputZ = z.infer<typeof switchToTabInputSchema>;\nexport type CloseTabInputZ = z.infer<typeof closeTabInputSchema>;\n"]}

package/dist/mcp-server/server.cjs

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMcpServer = createMcpServer;
+/* eslint-disable @typescript-eslint/explicit-function-return-type */
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const session_manager_js_1 = require("./session-manager.cjs");
+const batch_js_1 = require("./tools/batch.cjs");
+const definitions_js_1 = require("./tools/definitions.cjs");
+const types_1 = require("./types/index.cjs");
+const utils_1 = require("./utils/index.cjs");
+/**
+ * Create a standardized error response for tool execution failures.
+ *
+ * @param code The error code from ErrorCodes enum
+ * @param message Human-readable error message
+ * @param details Optional error details object
+ * @param startTime Timestamp when the operation started
+ * @returns MCP-formatted error response object
+ */
+function createToolErrorResponse(code, message, details, startTime) {
+    const sessionId = (0, session_manager_js_1.hasSessionManager)()
+        ? (0, session_manager_js_1.getSessionManager)().getSessionId()
+        : undefined;
+    const response = (0, utils_1.createErrorResponse)(code, message, details, sessionId, startTime);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(response),
+            },
+        ],
+        isError: true,
+    };
+}
+/**
+ * Create and configure an MCP server instance.
+ *
+ * @param config Server configuration including name, version, and optional cleanup handler
+ * @returns McpServer instance with start/stop methods and tool definitions
+ */
+function createMcpServer(config) {
+    const { name, version, onCleanup, logger = console.error } = config;
+    const toolDefinitions = (0, definitions_js_1.getToolDefinitions)();
+    const toolHandlers = (0, definitions_js_1.buildToolHandlersRecord)();
+    (0, batch_js_1.setToolRegistry)(toolHandlers);
+    const validToolNames = new Set(toolDefinitions.map((tool) => tool.name));
+    const server = new index_js_1.Server({ name, version }, { capabilities: { tools: {} } });
+    let isCleaningUp = false;
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+        tools: toolDefinitions,
+    }));
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request, extra) => {
+        const { name: toolName, arguments: args } = request.params;
+        const startTime = Date.now();
+        const signal = extra?.signal;
+        if (!validToolNames.has(toolName)) {
+            return createToolErrorResponse(types_1.ErrorCodes.MM_INVALID_INPUT, `Unknown tool: ${toolName}`, undefined, startTime);
+        }
+        const validation = (0, definitions_js_1.safeValidateToolInput)(toolName, args);
+        if (!validation.success) {
+            return createToolErrorResponse(types_1.ErrorCodes.MM_INVALID_INPUT, `Invalid input: ${validation.error}`, { providedArgs: args }, startTime);
+        }
+        const handler = (0, definitions_js_1.getToolHandler)(toolName);
+        if (!handler) {
+            return createToolErrorResponse(types_1.ErrorCodes.MM_INVALID_INPUT, `No handler registered for tool: ${toolName}`, undefined, startTime);
+        }
+        const response = await handler(validation.data, {
+            signal,
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify(response),
+                },
+            ],
+            isError: !response.ok,
+        };
+    });
+    /**
+     * Handle process signals (SIGINT, SIGTERM) and perform cleanup.
+     *
+     * @param signal The signal name received (e.g., 'SIGINT', 'SIGTERM')
+     */
+    const handleSignal = async (signal) => {
+        if (isCleaningUp) {
+            return;
+        }
+        isCleaningUp = true;
+        logger(`Received ${signal}, cleaning up...`);
+        try {
+            if (onCleanup) {
+                await onCleanup();
+            }
+            if ((0, session_manager_js_1.hasSessionManager)()) {
+                await (0, session_manager_js_1.getSessionManager)().cleanup();
+            }
+        }
+        catch (error) {
+            logger(`Cleanup error: ${JSON.stringify(error)}`);
+        }
+        process.exit(0);
+    };
+    process.on('SIGINT', () => {
+        handleSignal('SIGINT').catch((error) => logger(`SIGINT error: ${error}`));
+    });
+    process.on('SIGTERM', () => {
+        handleSignal('SIGTERM').catch((error) => logger(`SIGTERM error: ${error}`));
+    });
+    let transport;
+    return {
+        /**
+         * Start the MCP server and connect to stdio transport.
+         *
+         * @returns Promise that resolves when server is running
+         */
+        async start() {
+            transport = new stdio_js_1.StdioServerTransport();
+            await server.connect(transport);
+            logger(`${name} MCP Server v${version} running on stdio`);
+        },
+        /**
+         * Stop the MCP server and close the transport.
+         *
+         * @returns Promise that resolves when server is stopped
+         */
+        async stop() {
+            if (transport) {
+                await server.close();
+            }
+        },
+        /**
+         * Get the underlying MCP Server instance.
+         *
+         * @returns The MCP Server instance
+         */
+        getServer() {
+            return server;
+        },
+        /**
+         * Get all available tool definitions.
+         *
+         * @returns Array of tool definitions
+         */
+        getToolDefinitions() {
+            return toolDefinitions;
+        },
+        /**
+         * Get the tool name prefix (e.g., 'mm_').
+         *
+         * @returns The tool prefix string
+         */
+        getToolPrefix() {
+            return definitions_js_1.TOOL_PREFIX;
+        },
+    };
+}
+//# sourceMappingURL=server.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.cjs","sourceRoot":"","sources":["../../src/mcp-server/server.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\n/* eslint-disable @typescript-eslint/explicit-function-return-type */\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport {\n  CallToolRequestSchema,\n  ListToolsRequestSchema,\n} from '@modelcontextprotocol/sdk/types.js';\n\nimport { getSessionManager, hasSessionManager } from './session-manager.js';\nimport { setToolRegistry } from './tools/batch.js';\nimport {\n  getToolDefinitions,\n  getToolHandler,\n  safeValidateToolInput,\n  buildToolHandlersRecord,\n  TOOL_PREFIX,\n} from './tools/definitions.js';\nimport type { ToolDefinition } from './tools/definitions.js';\nimport { ErrorCodes } from './types';\nimport { createErrorResponse } from './utils';\n\nexport type McpServerConfig = {\n  name: string;\n  version: string;\n  onCleanup?: () => Promise<void>;\n  logger?: (message: string) => void;\n};\n\n/**\n * Create a standardized error response for tool execution failures.\n *\n * @param code The error code from ErrorCodes enum\n * @param message Human-readable error message\n * @param details Optional error details object\n * @param startTime Timestamp when the operation started\n * @returns MCP-formatted error response object\n */\nfunction createToolErrorResponse(\n  code: (typeof ErrorCodes)[keyof typeof ErrorCodes],\n  message: string,\n  details: Record<string, unknown> | undefined,\n  startTime: number,\n) {\n  const sessionId = hasSessionManager()\n    ? getSessionManager().getSessionId()\n    : undefined;\n\n  const response = createErrorResponse(\n    code,\n    message,\n    details,\n    sessionId,\n    startTime,\n  );\n\n  return {\n    content: [\n      {\n        type: 'text' as const,\n        text: JSON.stringify(response),\n      },\n    ],\n    isError: true,\n  };\n}\n\nexport type McpServer = {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  getServer(): Server;\n  getToolDefinitions(): ToolDefinition[];\n  getToolPrefix(): string;\n};\n\n/**\n * Create and configure an MCP server instance.\n *\n * @param config Server configuration including name, version, and optional cleanup handler\n * @returns McpServer instance with start/stop methods and tool definitions\n */\nexport function createMcpServer(config: McpServerConfig): McpServer {\n  const { name, version, onCleanup, logger = console.error } = config;\n\n  const toolDefinitions = getToolDefinitions();\n  const toolHandlers = buildToolHandlersRecord();\n\n  setToolRegistry(toolHandlers);\n\n  const validToolNames = new Set(toolDefinitions.map((tool) => tool.name));\n\n  const server = new Server({ name, version }, { capabilities: { tools: {} } });\n\n  let isCleaningUp = false;\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: toolDefinitions,\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {\n    const { name: toolName, arguments: args } = request.params;\n    const startTime = Date.now();\n    const signal = extra?.signal;\n\n    if (!validToolNames.has(toolName)) {\n      return createToolErrorResponse(\n        ErrorCodes.MM_INVALID_INPUT,\n        `Unknown tool: ${toolName}`,\n        undefined,\n        startTime,\n      );\n    }\n\n    const validation = safeValidateToolInput(toolName, args);\n    if (!validation.success) {\n      return createToolErrorResponse(\n        ErrorCodes.MM_INVALID_INPUT,\n        `Invalid input: ${validation.error}`,\n        { providedArgs: args },\n        startTime,\n      );\n    }\n\n    const handler = getToolHandler(toolName);\n\n    if (!handler) {\n      return createToolErrorResponse(\n        ErrorCodes.MM_INVALID_INPUT,\n        `No handler registered for tool: ${toolName}`,\n        undefined,\n        startTime,\n      );\n    }\n\n    const response = await handler(validation.data as Record<string, unknown>, {\n      signal,\n    });\n\n    return {\n      content: [\n        {\n          type: 'text' as const,\n          text: JSON.stringify(response),\n        },\n      ],\n      isError: !response.ok,\n    };\n  });\n\n  /**\n   * Handle process signals (SIGINT, SIGTERM) and perform cleanup.\n   *\n   * @param signal The signal name received (e.g., 'SIGINT', 'SIGTERM')\n   */\n  const handleSignal = async (signal: string) => {\n    if (isCleaningUp) {\n      return;\n    }\n    isCleaningUp = true;\n\n    logger(`Received ${signal}, cleaning up...`);\n\n    try {\n      if (onCleanup) {\n        await onCleanup();\n      }\n\n      if (hasSessionManager()) {\n        await getSessionManager().cleanup();\n      }\n    } catch (error) {\n      logger(`Cleanup error: ${JSON.stringify(error)}`);\n    }\n\n    process.exit(0);\n  };\n\n  process.on('SIGINT', () => {\n    handleSignal('SIGINT').catch((error) => logger(`SIGINT error: ${error}`));\n  });\n  process.on('SIGTERM', () => {\n    handleSignal('SIGTERM').catch((error) => logger(`SIGTERM error: ${error}`));\n  });\n\n  let transport: StdioServerTransport | undefined;\n\n  return {\n    /**\n     * Start the MCP server and connect to stdio transport.\n     *\n     * @returns Promise that resolves when server is running\n     */\n    async start() {\n      transport = new StdioServerTransport();\n      await server.connect(transport);\n      logger(`${name} MCP Server v${version} running on stdio`);\n    },\n\n    /**\n     * Stop the MCP server and close the transport.\n     *\n     * @returns Promise that resolves when server is stopped\n     */\n    async stop() {\n      if (transport) {\n        await server.close();\n      }\n    },\n\n    /**\n     * Get the underlying MCP Server instance.\n     *\n     * @returns The MCP Server instance\n     */\n    getServer() {\n      return server;\n    },\n\n    /**\n     * Get all available tool definitions.\n     *\n     * @returns Array of tool definitions\n     */\n    getToolDefinitions() {\n      return toolDefinitions;\n    },\n\n    /**\n     * Get the tool name prefix (e.g., 'mm_').\n     *\n     * @returns The tool prefix string\n     */\n    getToolPrefix() {\n      return TOOL_PREFIX;\n    },\n  };\n}\n"]}