@metamask/client-mcp-core 0.1.0

package/dist/capabilities/types.d.mts

@@ -0,0 +1,152 @@
+import type { Page, BrowserContext } from "@playwright/test";
+export type StateMode = 'default' | 'onboarding' | 'custom';
+export type NetworkMode = 'localhost' | 'fork' | 'custom';
+export type NetworkConfig = {
+    mode?: NetworkMode;
+    chainId?: number;
+    rpcUrl?: string;
+    forkBlockNumber?: number;
+    chainName?: string;
+    nativeCurrency?: {
+        symbol: string;
+        decimals: number;
+    };
+};
+export type FixtureData = {
+    data: Record<string, unknown>;
+    meta?: {
+        version: number;
+    };
+};
+export type PortsConfig = {
+    anvil?: number;
+    fixtureServer?: number;
+};
+export type ScreenshotOptions = {
+    name: string;
+    fullPage?: boolean;
+    selector?: string;
+    timestamp?: boolean;
+    page?: Page;
+};
+export type ScreenshotResult = {
+    path: string;
+    base64: string;
+    width: number;
+    height: number;
+};
+export type ScreenName = 'unlock' | 'home' | 'onboarding-welcome' | 'onboarding-import' | 'onboarding-create' | 'onboarding-srp' | 'onboarding-password' | 'onboarding-complete' | 'onboarding-metametrics' | 'settings' | 'send' | 'swap' | 'bridge' | 'confirm-transaction' | 'confirm-signature' | 'notification' | 'unknown';
+export type ExtensionState = {
+    isLoaded: boolean;
+    currentUrl: string;
+    extensionId: string;
+    isUnlocked: boolean;
+    currentScreen: ScreenName;
+    accountAddress: string | null;
+    networkName: string | null;
+    chainId: number | null;
+    balance: string | null;
+};
+export type LaunchOptions = {
+    extensionPath?: string;
+    viewportWidth?: number;
+    viewportHeight?: number;
+    slowMo?: number;
+    autoBuild?: boolean;
+    stateMode?: StateMode;
+    fixture?: FixtureData;
+    ports?: PortsConfig;
+    seedContracts?: string[];
+};
+export type BrowserSession = {
+    context: BrowserContext;
+    extensionPage: Page;
+    extensionId: string;
+};
+export type BuildOptions = {
+    buildType?: string;
+    force?: boolean;
+};
+export type BuildResult = {
+    success: boolean;
+    extensionPath: string;
+    durationMs: number;
+    error?: string;
+};
+export type WalletState = FixtureData;
+export type DeployOptions = {
+    hardfork?: string;
+    deployerOptions?: {
+        fromAddress?: string;
+        fromPrivateKey?: string;
+    };
+};
+export type ContractDeployment = {
+    name: string;
+    address: string;
+    deployedAt: string;
+};
+export type ContractInfo = {
+    name: string;
+    address: string;
+    deployedAt: string;
+};
+export type StateSnapshot = ExtensionState;
+export type StateOptions = {
+    extensionId?: string;
+    chainId?: number;
+};
+export type OnboardOptions = {
+    seedPhrase?: string;
+    password?: string;
+};
+export type Observation = {
+    state: ExtensionState;
+    testIds: string[];
+    a11yNodes: unknown[];
+};
+export type BuildCapability = {
+    build(options?: BuildOptions): Promise<BuildResult>;
+    getExtensionPath(): string;
+    isBuilt(): Promise<boolean>;
+};
+export type FixtureCapability = {
+    start(state: WalletState): Promise<void>;
+    stop(): Promise<void>;
+    getDefaultState(): WalletState;
+    getOnboardingState(): WalletState;
+    resolvePreset(presetName: string): WalletState;
+};
+export type ChainCapability = {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+    setPort(port: number): void;
+};
+export type ContractSeedingCapability = {
+    deployContract(name: string, options?: DeployOptions): Promise<ContractDeployment>;
+    deployContracts(names: string[], options?: DeployOptions): Promise<{
+        deployed: ContractDeployment[];
+        failed: {
+            name: string;
+            error: string;
+        }[];
+    }>;
+    getContractAddress(name: string): string | null;
+    listDeployedContracts(): ContractInfo[];
+    getAvailableContracts(): string[];
+    clearRegistry(): void;
+    initialize(): void;
+};
+export type StateSnapshotCapability = {
+    getState(page: Page, options: StateOptions): Promise<StateSnapshot>;
+    detectCurrentScreen(page: Page): Promise<string>;
+};
+export type MockServerCapability = {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    isRunning(): boolean;
+    getServer(): unknown;
+    getPort(): number;
+};
+//# sourceMappingURL=types.d.mts.map

package/dist/capabilities/types.d.mts.map

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

package/dist/capabilities/types.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.mjs.map

package/dist/capabilities/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/capabilities/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Page, BrowserContext } from '@playwright/test';\n\nexport type StateMode = 'default' | 'onboarding' | 'custom';\n\nexport type NetworkMode = 'localhost' | 'fork' | 'custom';\n\nexport type NetworkConfig = {\n  mode?: NetworkMode;\n  chainId?: number;\n  rpcUrl?: string;\n  forkBlockNumber?: number;\n  chainName?: string;\n  nativeCurrency?: {\n    symbol: string;\n    decimals: number;\n  };\n};\n\nexport type FixtureData = {\n  data: Record<string, unknown>;\n  meta?: {\n    version: number;\n  };\n};\n\nexport type PortsConfig = {\n  anvil?: number;\n  fixtureServer?: number;\n};\n\nexport type ScreenshotOptions = {\n  name: string;\n  fullPage?: boolean;\n  selector?: string;\n  timestamp?: boolean;\n  page?: Page;\n};\n\nexport type ScreenshotResult = {\n  path: string;\n  base64: string;\n  width: number;\n  height: number;\n};\n\nexport type ScreenName =\n  | 'unlock'\n  | 'home'\n  | 'onboarding-welcome'\n  | 'onboarding-import'\n  | 'onboarding-create'\n  | 'onboarding-srp'\n  | 'onboarding-password'\n  | 'onboarding-complete'\n  | 'onboarding-metametrics'\n  | 'settings'\n  | 'send'\n  | 'swap'\n  | 'bridge'\n  | 'confirm-transaction'\n  | 'confirm-signature'\n  | 'notification'\n  | 'unknown';\n\nexport type ExtensionState = {\n  isLoaded: boolean;\n  currentUrl: string;\n  extensionId: string;\n  isUnlocked: boolean;\n  currentScreen: ScreenName;\n  accountAddress: string | null;\n  networkName: string | null;\n  chainId: number | null;\n  balance: string | null;\n};\n\nexport type LaunchOptions = {\n  extensionPath?: string;\n  viewportWidth?: number;\n  viewportHeight?: number;\n  slowMo?: number;\n  autoBuild?: boolean;\n  stateMode?: StateMode;\n  fixture?: FixtureData;\n  ports?: PortsConfig;\n  seedContracts?: string[];\n};\n\nexport type BrowserSession = {\n  context: BrowserContext;\n  extensionPage: Page;\n  extensionId: string;\n};\n\nexport type BuildOptions = {\n  buildType?: string;\n  force?: boolean;\n};\n\nexport type BuildResult = {\n  success: boolean;\n  extensionPath: string;\n  durationMs: number;\n  error?: string;\n};\n\nexport type WalletState = FixtureData;\n\nexport type DeployOptions = {\n  hardfork?: string;\n  deployerOptions?: {\n    fromAddress?: string;\n    fromPrivateKey?: string;\n  };\n};\n\nexport type ContractDeployment = {\n  name: string;\n  address: string;\n  deployedAt: string;\n};\n\nexport type ContractInfo = {\n  name: string;\n  address: string;\n  deployedAt: string;\n};\n\nexport type StateSnapshot = ExtensionState;\n\nexport type StateOptions = {\n  extensionId?: string;\n  chainId?: number;\n};\n\nexport type OnboardOptions = {\n  seedPhrase?: string;\n  password?: string;\n};\n\nexport type Observation = {\n  state: ExtensionState;\n  testIds: string[];\n  a11yNodes: unknown[];\n};\n\nexport type BuildCapability = {\n  build(options?: BuildOptions): Promise<BuildResult>;\n  getExtensionPath(): string;\n  isBuilt(): Promise<boolean>;\n};\n\nexport type FixtureCapability = {\n  start(state: WalletState): Promise<void>;\n  stop(): Promise<void>;\n  getDefaultState(): WalletState;\n  getOnboardingState(): WalletState;\n  resolvePreset(presetName: string): WalletState;\n};\n\nexport type ChainCapability = {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  isRunning(): boolean;\n  setPort(port: number): void;\n};\n\nexport type ContractSeedingCapability = {\n  deployContract(\n    name: string,\n    options?: DeployOptions,\n  ): Promise<ContractDeployment>;\n  deployContracts(\n    names: string[],\n    options?: DeployOptions,\n  ): Promise<{\n    deployed: ContractDeployment[];\n    failed: {\n      name: string;\n      error: string;\n    }[];\n  }>;\n  getContractAddress(name: string): string | null;\n  listDeployedContracts(): ContractInfo[];\n  getAvailableContracts(): string[];\n  clearRegistry(): void;\n  initialize(): void;\n};\n\nexport type StateSnapshotCapability = {\n  getState(page: Page, options: StateOptions): Promise<StateSnapshot>;\n  detectCurrentScreen(page: Page): Promise<string>;\n};\n\nexport type MockServerCapability = {\n  start(): Promise<void>;\n  stop(): Promise<void>;\n  isRunning(): boolean;\n  getServer(): unknown;\n  getPort(): number;\n};\n"]}

package/dist/index.cjs

@@ -0,0 +1,59 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./capabilities/context.cjs"), exports);
+// MCP Server - Session Manager Interface
+__exportStar(require("./mcp-server/session-manager.cjs"), exports);
+// MCP Server - Server
+__exportStar(require("./mcp-server/server.cjs"), exports);
+// MCP Server - Core Components
+__exportStar(require("./mcp-server/knowledge-store.cjs"), exports);
+__exportStar(require("./mcp-server/discovery.cjs"), exports);
+__exportStar(require("./mcp-server/schemas.cjs"), exports);
+__exportStar(require("./mcp-server/tools/definitions.cjs"), exports);
+__exportStar(require("./mcp-server/tokenization.cjs"), exports);
+// MCP Server - Types
+__exportStar(require("./mcp-server/types/index.cjs"), exports);
+// MCP Server - Utils
+__exportStar(require("./mcp-server/utils/index.cjs"), exports);
+// Shared utilities
+__exportStar(require("./utils/index.cjs"), exports);
+// Launcher utilities
+__exportStar(require("./launcher/extension-id-resolver.cjs"), exports);
+__exportStar(require("./launcher/extension-readiness.cjs"), exports);
+__exportStar(require("./launcher/console-error-buffer.cjs"), exports);
+__exportStar(require("./launcher/retry.cjs"), exports);
+// MCP Server - Tool Handlers
+__exportStar(require("./mcp-server/tools/build.cjs"), exports);
+__exportStar(require("./mcp-server/tools/launch.cjs"), exports);
+__exportStar(require("./mcp-server/tools/cleanup.cjs"), exports);
+__exportStar(require("./mcp-server/tools/state.cjs"), exports);
+__exportStar(require("./mcp-server/tools/seeding.cjs"), exports);
+__exportStar(require("./mcp-server/tools/interaction.cjs"), exports);
+__exportStar(require("./mcp-server/tools/navigation.cjs"), exports);
+__exportStar(require("./mcp-server/tools/discovery-tools.cjs"), exports);
+__exportStar(require("./mcp-server/tools/screenshot.cjs"), exports);
+__exportStar(require("./mcp-server/tools/knowledge.cjs"), exports);
+__exportStar(require("./mcp-server/tools/batch.cjs"), exports);
+__exportStar(require("./mcp-server/tools/context.cjs"), exports);
+__exportStar(require("./mcp-server/tools/clipboard.cjs"), exports);
+// Run tool utility
+__exportStar(require("./mcp-server/tools/run-tool.cjs"), exports);
+// Error classification
+__exportStar(require("./mcp-server/tools/error-classification.cjs"), exports);
+// Helpers
+__exportStar(require("./mcp-server/tools/helpers.cjs"), exports);
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAEA,6DAA0C;AAE1C,yCAAyC;AACzC,mEAAgD;AAEhD,sBAAsB;AACtB,0DAAuC;AAEvC,+BAA+B;AAC/B,mEAAgD;AAChD,6DAA0C;AAC1C,2DAAwC;AACxC,qEAAkD;AAClD,gEAA6C;AAE7C,qBAAqB;AACrB,+DAAmC;AAEnC,qBAAqB;AACrB,+DAAmC;AAEnC,mBAAmB;AACnB,oDAAwB;AAExB,qBAAqB;AACrB,uEAAoD;AACpD,qEAAkD;AAClD,sEAAmD;AACnD,uDAAoC;AAEpC,6BAA6B;AAC7B,+DAA4C;AAC5C,gEAA6C;AAC7C,iEAA8C;AAC9C,+DAA4C;AAC5C,iEAA8C;AAC9C,qEAAkD;AAClD,oEAAiD;AACjD,yEAAsD;AACtD,oEAAiD;AACjD,mEAAgD;AAChD,+DAA4C;AAC5C,iEAA8C;AAC9C,mEAAgD;AAEhD,mBAAmB;AACnB,kEAA+C;AAE/C,uBAAuB;AACvB,8EAA2D;AAE3D,UAAU;AACV,iEAA8C","sourcesContent":["// Capabilities\nexport type * from './capabilities/types.js';\nexport * from './capabilities/context.js';\n\n// MCP Server - Session Manager Interface\nexport * from './mcp-server/session-manager.js';\n\n// MCP Server - Server\nexport * from './mcp-server/server.js';\n\n// MCP Server - Core Components\nexport * from './mcp-server/knowledge-store.js';\nexport * from './mcp-server/discovery.js';\nexport * from './mcp-server/schemas.js';\nexport * from './mcp-server/tools/definitions.js';\nexport * from './mcp-server/tokenization.js';\n\n// MCP Server - Types\nexport * from './mcp-server/types';\n\n// MCP Server - Utils\nexport * from './mcp-server/utils';\n\n// Shared utilities\nexport * from './utils';\n\n// Launcher utilities\nexport * from './launcher/extension-id-resolver.js';\nexport * from './launcher/extension-readiness.js';\nexport * from './launcher/console-error-buffer.js';\nexport * from './launcher/retry.js';\n\n// MCP Server - Tool Handlers\nexport * from './mcp-server/tools/build.js';\nexport * from './mcp-server/tools/launch.js';\nexport * from './mcp-server/tools/cleanup.js';\nexport * from './mcp-server/tools/state.js';\nexport * from './mcp-server/tools/seeding.js';\nexport * from './mcp-server/tools/interaction.js';\nexport * from './mcp-server/tools/navigation.js';\nexport * from './mcp-server/tools/discovery-tools.js';\nexport * from './mcp-server/tools/screenshot.js';\nexport * from './mcp-server/tools/knowledge.js';\nexport * from './mcp-server/tools/batch.js';\nexport * from './mcp-server/tools/context.js';\nexport * from './mcp-server/tools/clipboard.js';\n\n// Run tool utility\nexport * from './mcp-server/tools/run-tool.js';\n\n// Error classification\nexport * from './mcp-server/tools/error-classification.js';\n\n// Helpers\nexport * from './mcp-server/tools/helpers.js';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,33 @@
+export type * from "./capabilities/types.cjs";
+export * from "./capabilities/context.cjs";
+export * from "./mcp-server/session-manager.cjs";
+export * from "./mcp-server/server.cjs";
+export * from "./mcp-server/knowledge-store.cjs";
+export * from "./mcp-server/discovery.cjs";
+export * from "./mcp-server/schemas.cjs";
+export * from "./mcp-server/tools/definitions.cjs";
+export * from "./mcp-server/tokenization.cjs";
+export * from "./mcp-server/types/index.cjs";
+export * from "./mcp-server/utils/index.cjs";
+export * from "./utils/index.cjs";
+export * from "./launcher/extension-id-resolver.cjs";
+export * from "./launcher/extension-readiness.cjs";
+export * from "./launcher/console-error-buffer.cjs";
+export * from "./launcher/retry.cjs";
+export * from "./mcp-server/tools/build.cjs";
+export * from "./mcp-server/tools/launch.cjs";
+export * from "./mcp-server/tools/cleanup.cjs";
+export * from "./mcp-server/tools/state.cjs";
+export * from "./mcp-server/tools/seeding.cjs";
+export * from "./mcp-server/tools/interaction.cjs";
+export * from "./mcp-server/tools/navigation.cjs";
+export * from "./mcp-server/tools/discovery-tools.cjs";
+export * from "./mcp-server/tools/screenshot.cjs";
+export * from "./mcp-server/tools/knowledge.cjs";
+export * from "./mcp-server/tools/batch.cjs";
+export * from "./mcp-server/tools/context.cjs";
+export * from "./mcp-server/tools/clipboard.cjs";
+export * from "./mcp-server/tools/run-tool.cjs";
+export * from "./mcp-server/tools/error-classification.cjs";
+export * from "./mcp-server/tools/helpers.cjs";
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,8CAA6C;AAC7C,2CAA0C;AAG1C,iDAAgD;AAGhD,wCAAuC;AAGvC,iDAAgD;AAChD,2CAA0C;AAC1C,yCAAwC;AACxC,mDAAkD;AAClD,8CAA6C;AAG7C,6CAAmC;AAGnC,6CAAmC;AAGnC,kCAAwB;AAGxB,qDAAoD;AACpD,mDAAkD;AAClD,oDAAmD;AACnD,qCAAoC;AAGpC,6CAA4C;AAC5C,8CAA6C;AAC7C,+CAA8C;AAC9C,6CAA4C;AAC5C,+CAA8C;AAC9C,mDAAkD;AAClD,kDAAiD;AACjD,uDAAsD;AACtD,kDAAiD;AACjD,iDAAgD;AAChD,6CAA4C;AAC5C,+CAA8C;AAC9C,iDAAgD;AAGhD,gDAA+C;AAG/C,4DAA2D;AAG3D,+CAA8C"}

package/dist/index.d.mts

@@ -0,0 +1,33 @@
+export type * from "./capabilities/types.mjs";
+export * from "./capabilities/context.mjs";
+export * from "./mcp-server/session-manager.mjs";
+export * from "./mcp-server/server.mjs";
+export * from "./mcp-server/knowledge-store.mjs";
+export * from "./mcp-server/discovery.mjs";
+export * from "./mcp-server/schemas.mjs";
+export * from "./mcp-server/tools/definitions.mjs";
+export * from "./mcp-server/tokenization.mjs";
+export * from "./mcp-server/types/index.mjs";
+export * from "./mcp-server/utils/index.mjs";
+export * from "./utils/index.mjs";
+export * from "./launcher/extension-id-resolver.mjs";
+export * from "./launcher/extension-readiness.mjs";
+export * from "./launcher/console-error-buffer.mjs";
+export * from "./launcher/retry.mjs";
+export * from "./mcp-server/tools/build.mjs";
+export * from "./mcp-server/tools/launch.mjs";
+export * from "./mcp-server/tools/cleanup.mjs";
+export * from "./mcp-server/tools/state.mjs";
+export * from "./mcp-server/tools/seeding.mjs";
+export * from "./mcp-server/tools/interaction.mjs";
+export * from "./mcp-server/tools/navigation.mjs";
+export * from "./mcp-server/tools/discovery-tools.mjs";
+export * from "./mcp-server/tools/screenshot.mjs";
+export * from "./mcp-server/tools/knowledge.mjs";
+export * from "./mcp-server/tools/batch.mjs";
+export * from "./mcp-server/tools/context.mjs";
+export * from "./mcp-server/tools/clipboard.mjs";
+export * from "./mcp-server/tools/run-tool.mjs";
+export * from "./mcp-server/tools/error-classification.mjs";
+export * from "./mcp-server/tools/helpers.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,8CAA6C;AAC7C,2CAA0C;AAG1C,iDAAgD;AAGhD,wCAAuC;AAGvC,iDAAgD;AAChD,2CAA0C;AAC1C,yCAAwC;AACxC,mDAAkD;AAClD,8CAA6C;AAG7C,6CAAmC;AAGnC,6CAAmC;AAGnC,kCAAwB;AAGxB,qDAAoD;AACpD,mDAAkD;AAClD,oDAAmD;AACnD,qCAAoC;AAGpC,6CAA4C;AAC5C,8CAA6C;AAC7C,+CAA8C;AAC9C,6CAA4C;AAC5C,+CAA8C;AAC9C,mDAAkD;AAClD,kDAAiD;AACjD,uDAAsD;AACtD,kDAAiD;AACjD,iDAAgD;AAChD,6CAA4C;AAC5C,+CAA8C;AAC9C,iDAAgD;AAGhD,gDAA+C;AAG/C,4DAA2D;AAG3D,+CAA8C"}

package/dist/index.mjs

@@ -0,0 +1,43 @@
+export * from "./capabilities/context.mjs";
+// MCP Server - Session Manager Interface
+export * from "./mcp-server/session-manager.mjs";
+// MCP Server - Server
+export * from "./mcp-server/server.mjs";
+// MCP Server - Core Components
+export * from "./mcp-server/knowledge-store.mjs";
+export * from "./mcp-server/discovery.mjs";
+export * from "./mcp-server/schemas.mjs";
+export * from "./mcp-server/tools/definitions.mjs";
+export * from "./mcp-server/tokenization.mjs";
+// MCP Server - Types
+export * from "./mcp-server/types/index.mjs";
+// MCP Server - Utils
+export * from "./mcp-server/utils/index.mjs";
+// Shared utilities
+export * from "./utils/index.mjs";
+// Launcher utilities
+export * from "./launcher/extension-id-resolver.mjs";
+export * from "./launcher/extension-readiness.mjs";
+export * from "./launcher/console-error-buffer.mjs";
+export * from "./launcher/retry.mjs";
+// MCP Server - Tool Handlers
+export * from "./mcp-server/tools/build.mjs";
+export * from "./mcp-server/tools/launch.mjs";
+export * from "./mcp-server/tools/cleanup.mjs";
+export * from "./mcp-server/tools/state.mjs";
+export * from "./mcp-server/tools/seeding.mjs";
+export * from "./mcp-server/tools/interaction.mjs";
+export * from "./mcp-server/tools/navigation.mjs";
+export * from "./mcp-server/tools/discovery-tools.mjs";
+export * from "./mcp-server/tools/screenshot.mjs";
+export * from "./mcp-server/tools/knowledge.mjs";
+export * from "./mcp-server/tools/batch.mjs";
+export * from "./mcp-server/tools/context.mjs";
+export * from "./mcp-server/tools/clipboard.mjs";
+// Run tool utility
+export * from "./mcp-server/tools/run-tool.mjs";
+// Error classification
+export * from "./mcp-server/tools/error-classification.mjs";
+// Helpers
+export * from "./mcp-server/tools/helpers.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,2CAA0C;AAE1C,yCAAyC;AACzC,iDAAgD;AAEhD,sBAAsB;AACtB,wCAAuC;AAEvC,+BAA+B;AAC/B,iDAAgD;AAChD,2CAA0C;AAC1C,yCAAwC;AACxC,mDAAkD;AAClD,8CAA6C;AAE7C,qBAAqB;AACrB,6CAAmC;AAEnC,qBAAqB;AACrB,6CAAmC;AAEnC,mBAAmB;AACnB,kCAAwB;AAExB,qBAAqB;AACrB,qDAAoD;AACpD,mDAAkD;AAClD,oDAAmD;AACnD,qCAAoC;AAEpC,6BAA6B;AAC7B,6CAA4C;AAC5C,8CAA6C;AAC7C,+CAA8C;AAC9C,6CAA4C;AAC5C,+CAA8C;AAC9C,mDAAkD;AAClD,kDAAiD;AACjD,uDAAsD;AACtD,kDAAiD;AACjD,iDAAgD;AAChD,6CAA4C;AAC5C,+CAA8C;AAC9C,iDAAgD;AAEhD,mBAAmB;AACnB,gDAA+C;AAE/C,uBAAuB;AACvB,4DAA2D;AAE3D,UAAU;AACV,+CAA8C","sourcesContent":["// Capabilities\nexport type * from './capabilities/types.js';\nexport * from './capabilities/context.js';\n\n// MCP Server - Session Manager Interface\nexport * from './mcp-server/session-manager.js';\n\n// MCP Server - Server\nexport * from './mcp-server/server.js';\n\n// MCP Server - Core Components\nexport * from './mcp-server/knowledge-store.js';\nexport * from './mcp-server/discovery.js';\nexport * from './mcp-server/schemas.js';\nexport * from './mcp-server/tools/definitions.js';\nexport * from './mcp-server/tokenization.js';\n\n// MCP Server - Types\nexport * from './mcp-server/types';\n\n// MCP Server - Utils\nexport * from './mcp-server/utils';\n\n// Shared utilities\nexport * from './utils';\n\n// Launcher utilities\nexport * from './launcher/extension-id-resolver.js';\nexport * from './launcher/extension-readiness.js';\nexport * from './launcher/console-error-buffer.js';\nexport * from './launcher/retry.js';\n\n// MCP Server - Tool Handlers\nexport * from './mcp-server/tools/build.js';\nexport * from './mcp-server/tools/launch.js';\nexport * from './mcp-server/tools/cleanup.js';\nexport * from './mcp-server/tools/state.js';\nexport * from './mcp-server/tools/seeding.js';\nexport * from './mcp-server/tools/interaction.js';\nexport * from './mcp-server/tools/navigation.js';\nexport * from './mcp-server/tools/discovery-tools.js';\nexport * from './mcp-server/tools/screenshot.js';\nexport * from './mcp-server/tools/knowledge.js';\nexport * from './mcp-server/tools/batch.js';\nexport * from './mcp-server/tools/context.js';\nexport * from './mcp-server/tools/clipboard.js';\n\n// Run tool utility\nexport * from './mcp-server/tools/run-tool.js';\n\n// Error classification\nexport * from './mcp-server/tools/error-classification.js';\n\n// Helpers\nexport * from './mcp-server/tools/helpers.js';\n"]}

package/dist/launcher/console-error-buffer.cjs

@@ -0,0 +1,72 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ConsoleErrorBuffer_maxEntries, _ConsoleErrorBuffer_entries;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleErrorBuffer = void 0;
+/**
+ * Ring buffer that stores recent console error entries with a fixed capacity.
+ */
+class ConsoleErrorBuffer {
+    /**
+     * Initialize the console error buffer with a maximum capacity.
+     *
+     * @param maxEntries - Maximum number of error entries to store before discarding oldest
+     */
+    constructor(maxEntries) {
+        _ConsoleErrorBuffer_maxEntries.set(this, void 0);
+        _ConsoleErrorBuffer_entries.set(this, []);
+        __classPrivateFieldSet(this, _ConsoleErrorBuffer_maxEntries, maxEntries, "f");
+    }
+    /**
+     * Add a console error entry to the buffer, removing oldest if at capacity.
+     *
+     * @param entry - The console error entry to add
+     */
+    add(entry) {
+        __classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f").push(entry);
+        if (__classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f").length > __classPrivateFieldGet(this, _ConsoleErrorBuffer_maxEntries, "f")) {
+            __classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f").shift();
+        }
+    }
+    /**
+     * Get all stored console error entries.
+     *
+     * @returns A copy of all stored error entries
+     */
+    getAll() {
+        return [...__classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f")];
+    }
+    /**
+     * Get the most recent console error entries.
+     *
+     * @param count - Number of recent entries to retrieve
+     * @returns The most recent error entries, up to the requested count
+     */
+    getRecent(count) {
+        if (count <= 0) {
+            return [];
+        }
+        return __classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f").slice(-count);
+    }
+    /**
+     * Get the current number of stored error entries.
+     *
+     * @returns The count of error entries currently in the buffer
+     */
+    get size() {
+        return __classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f").length;
+    }
+}
+exports.ConsoleErrorBuffer = ConsoleErrorBuffer;
+_ConsoleErrorBuffer_maxEntries = new WeakMap(), _ConsoleErrorBuffer_entries = new WeakMap();
+//# sourceMappingURL=console-error-buffer.cjs.map

package/dist/launcher/console-error-buffer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-error-buffer.cjs","sourceRoot":"","sources":["../../src/launcher/console-error-buffer.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAMA;;GAEG;AACH,MAAa,kBAAkB;IAK7B;;;;OAIG;IACH,YAAY,UAAkB;QATrB,iDAAoB;QAEpB,sCAAgC,EAAE,EAAC;QAQ1C,uBAAA,IAAI,kCAAe,UAAU,MAAA,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,KAAwB;QAC1B,uBAAA,IAAI,mCAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,uBAAA,IAAI,mCAAS,CAAC,MAAM,GAAG,uBAAA,IAAI,sCAAY,EAAE,CAAC;YAC5C,uBAAA,IAAI,mCAAS,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,CAAC,GAAG,uBAAA,IAAI,mCAAS,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,KAAa;QACrB,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,uBAAA,IAAI,mCAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,IAAI,IAAI;QACN,OAAO,uBAAA,IAAI,mCAAS,CAAC,MAAM,CAAC;IAC9B,CAAC;CACF;AAzDD,gDAyDC","sourcesContent":["export type ConsoleErrorEntry = {\n  timestamp: number;\n  message: string;\n  source: string;\n};\n\n/**\n * Ring buffer that stores recent console error entries with a fixed capacity.\n */\nexport class ConsoleErrorBuffer {\n  readonly #maxEntries: number;\n\n  readonly #entries: ConsoleErrorEntry[] = [];\n\n  /**\n   * Initialize the console error buffer with a maximum capacity.\n   *\n   * @param maxEntries - Maximum number of error entries to store before discarding oldest\n   */\n  constructor(maxEntries: number) {\n    this.#maxEntries = maxEntries;\n  }\n\n  /**\n   * Add a console error entry to the buffer, removing oldest if at capacity.\n   *\n   * @param entry - The console error entry to add\n   */\n  add(entry: ConsoleErrorEntry): void {\n    this.#entries.push(entry);\n    if (this.#entries.length > this.#maxEntries) {\n      this.#entries.shift();\n    }\n  }\n\n  /**\n   * Get all stored console error entries.\n   *\n   * @returns A copy of all stored error entries\n   */\n  getAll(): ConsoleErrorEntry[] {\n    return [...this.#entries];\n  }\n\n  /**\n   * Get the most recent console error entries.\n   *\n   * @param count - Number of recent entries to retrieve\n   * @returns The most recent error entries, up to the requested count\n   */\n  getRecent(count: number): ConsoleErrorEntry[] {\n    if (count <= 0) {\n      return [];\n    }\n\n    return this.#entries.slice(-count);\n  }\n\n  /**\n   * Get the current number of stored error entries.\n   *\n   * @returns The count of error entries currently in the buffer\n   */\n  get size(): number {\n    return this.#entries.length;\n  }\n}\n"]}

package/dist/launcher/console-error-buffer.d.cts

@@ -0,0 +1,43 @@
+export type ConsoleErrorEntry = {
+    timestamp: number;
+    message: string;
+    source: string;
+};
+/**
+ * Ring buffer that stores recent console error entries with a fixed capacity.
+ */
+export declare class ConsoleErrorBuffer {
+    #private;
+    /**
+     * Initialize the console error buffer with a maximum capacity.
+     *
+     * @param maxEntries - Maximum number of error entries to store before discarding oldest
+     */
+    constructor(maxEntries: number);
+    /**
+     * Add a console error entry to the buffer, removing oldest if at capacity.
+     *
+     * @param entry - The console error entry to add
+     */
+    add(entry: ConsoleErrorEntry): void;
+    /**
+     * Get all stored console error entries.
+     *
+     * @returns A copy of all stored error entries
+     */
+    getAll(): ConsoleErrorEntry[];
+    /**
+     * Get the most recent console error entries.
+     *
+     * @param count - Number of recent entries to retrieve
+     * @returns The most recent error entries, up to the requested count
+     */
+    getRecent(count: number): ConsoleErrorEntry[];
+    /**
+     * Get the current number of stored error entries.
+     *
+     * @returns The count of error entries currently in the buffer
+     */
+    get size(): number;
+}
+//# sourceMappingURL=console-error-buffer.d.cts.map

package/dist/launcher/console-error-buffer.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-error-buffer.d.cts","sourceRoot":"","sources":["../../src/launcher/console-error-buffer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB;;IAK7B;;;;OAIG;gBACS,UAAU,EAAE,MAAM;IAI9B;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAOnC;;;;OAIG;IACH,MAAM,IAAI,iBAAiB,EAAE;IAI7B;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQ7C;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/launcher/console-error-buffer.d.mts

@@ -0,0 +1,43 @@
+export type ConsoleErrorEntry = {
+    timestamp: number;
+    message: string;
+    source: string;
+};
+/**
+ * Ring buffer that stores recent console error entries with a fixed capacity.
+ */
+export declare class ConsoleErrorBuffer {
+    #private;
+    /**
+     * Initialize the console error buffer with a maximum capacity.
+     *
+     * @param maxEntries - Maximum number of error entries to store before discarding oldest
+     */
+    constructor(maxEntries: number);
+    /**
+     * Add a console error entry to the buffer, removing oldest if at capacity.
+     *
+     * @param entry - The console error entry to add
+     */
+    add(entry: ConsoleErrorEntry): void;
+    /**
+     * Get all stored console error entries.
+     *
+     * @returns A copy of all stored error entries
+     */
+    getAll(): ConsoleErrorEntry[];
+    /**
+     * Get the most recent console error entries.
+     *
+     * @param count - Number of recent entries to retrieve
+     * @returns The most recent error entries, up to the requested count
+     */
+    getRecent(count: number): ConsoleErrorEntry[];
+    /**
+     * Get the current number of stored error entries.
+     *
+     * @returns The count of error entries currently in the buffer
+     */
+    get size(): number;
+}
+//# sourceMappingURL=console-error-buffer.d.mts.map

package/dist/launcher/console-error-buffer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-error-buffer.d.mts","sourceRoot":"","sources":["../../src/launcher/console-error-buffer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB;;IAK7B;;;;OAIG;gBACS,UAAU,EAAE,MAAM;IAI9B;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAOnC;;;;OAIG;IACH,MAAM,IAAI,iBAAiB,EAAE;IAI7B;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAQ7C;;;;OAIG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/launcher/console-error-buffer.mjs

@@ -0,0 +1,68 @@
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ConsoleErrorBuffer_maxEntries, _ConsoleErrorBuffer_entries;
+/**
+ * Ring buffer that stores recent console error entries with a fixed capacity.
+ */
+export class ConsoleErrorBuffer {
+    /**
+     * Initialize the console error buffer with a maximum capacity.
+     *
+     * @param maxEntries - Maximum number of error entries to store before discarding oldest
+     */
+    constructor(maxEntries) {
+        _ConsoleErrorBuffer_maxEntries.set(this, void 0);
+        _ConsoleErrorBuffer_entries.set(this, []);
+        __classPrivateFieldSet(this, _ConsoleErrorBuffer_maxEntries, maxEntries, "f");
+    }
+    /**
+     * Add a console error entry to the buffer, removing oldest if at capacity.
+     *
+     * @param entry - The console error entry to add
+     */
+    add(entry) {
+        __classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f").push(entry);
+        if (__classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f").length > __classPrivateFieldGet(this, _ConsoleErrorBuffer_maxEntries, "f")) {
+            __classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f").shift();
+        }
+    }
+    /**
+     * Get all stored console error entries.
+     *
+     * @returns A copy of all stored error entries
+     */
+    getAll() {
+        return [...__classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f")];
+    }
+    /**
+     * Get the most recent console error entries.
+     *
+     * @param count - Number of recent entries to retrieve
+     * @returns The most recent error entries, up to the requested count
+     */
+    getRecent(count) {
+        if (count <= 0) {
+            return [];
+        }
+        return __classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f").slice(-count);
+    }
+    /**
+     * Get the current number of stored error entries.
+     *
+     * @returns The count of error entries currently in the buffer
+     */
+    get size() {
+        return __classPrivateFieldGet(this, _ConsoleErrorBuffer_entries, "f").length;
+    }
+}
+_ConsoleErrorBuffer_maxEntries = new WeakMap(), _ConsoleErrorBuffer_entries = new WeakMap();
+//# sourceMappingURL=console-error-buffer.mjs.map

package/dist/launcher/console-error-buffer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-error-buffer.mjs","sourceRoot":"","sources":["../../src/launcher/console-error-buffer.ts"],"names":[],"mappings":";;;;;;;;;;;;AAMA;;GAEG;AACH,MAAM,OAAO,kBAAkB;IAK7B;;;;OAIG;IACH,YAAY,UAAkB;QATrB,iDAAoB;QAEpB,sCAAgC,EAAE,EAAC;QAQ1C,uBAAA,IAAI,kCAAe,UAAU,MAAA,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,KAAwB;QAC1B,uBAAA,IAAI,mCAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,uBAAA,IAAI,mCAAS,CAAC,MAAM,GAAG,uBAAA,IAAI,sCAAY,EAAE,CAAC;YAC5C,uBAAA,IAAI,mCAAS,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,CAAC,GAAG,uBAAA,IAAI,mCAAS,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,KAAa;QACrB,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,uBAAA,IAAI,mCAAS,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,IAAI,IAAI;QACN,OAAO,uBAAA,IAAI,mCAAS,CAAC,MAAM,CAAC;IAC9B,CAAC;CACF","sourcesContent":["export type ConsoleErrorEntry = {\n  timestamp: number;\n  message: string;\n  source: string;\n};\n\n/**\n * Ring buffer that stores recent console error entries with a fixed capacity.\n */\nexport class ConsoleErrorBuffer {\n  readonly #maxEntries: number;\n\n  readonly #entries: ConsoleErrorEntry[] = [];\n\n  /**\n   * Initialize the console error buffer with a maximum capacity.\n   *\n   * @param maxEntries - Maximum number of error entries to store before discarding oldest\n   */\n  constructor(maxEntries: number) {\n    this.#maxEntries = maxEntries;\n  }\n\n  /**\n   * Add a console error entry to the buffer, removing oldest if at capacity.\n   *\n   * @param entry - The console error entry to add\n   */\n  add(entry: ConsoleErrorEntry): void {\n    this.#entries.push(entry);\n    if (this.#entries.length > this.#maxEntries) {\n      this.#entries.shift();\n    }\n  }\n\n  /**\n   * Get all stored console error entries.\n   *\n   * @returns A copy of all stored error entries\n   */\n  getAll(): ConsoleErrorEntry[] {\n    return [...this.#entries];\n  }\n\n  /**\n   * Get the most recent console error entries.\n   *\n   * @param count - Number of recent entries to retrieve\n   * @returns The most recent error entries, up to the requested count\n   */\n  getRecent(count: number): ConsoleErrorEntry[] {\n    if (count <= 0) {\n      return [];\n    }\n\n    return this.#entries.slice(-count);\n  }\n\n  /**\n   * Get the current number of stored error entries.\n   *\n   * @returns The count of error entries currently in the buffer\n   */\n  get size(): number {\n    return this.#entries.length;\n  }\n}\n"]}