@agimon-ai/browse-tool 0.2.0 → 0.2.2

package/dist/index.d.cts

@@ -1,309 +0,0 @@
-import { Container } from "inversify";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-import { z } from "zod";
-
-//#region src/constants/playwright-types.d.ts
-
-/**
- * InversifyJS DI container binding tokens.
- * Maps service names to unique Symbol identifiers for dependency injection.
- *
- * DESIGN PATTERNS:
- * - Token map pattern for IoC container bindings
- * - Uses named constants from service-ids to avoid magic strings
- * - Frozen object (as const) to prevent runtime modification
- *
- * CODING STANDARDS:
- * - Import service ID constants instead of using inline strings
- * - Keep in sync with container module registrations
- * - Use Symbol.for() for cross-module symbol sharing
- *
- * AVOID:
- * - Adding entries without corresponding container bindings
- * - Using Symbol() instead of Symbol.for() (breaks cross-module resolution)
- */
-declare const PLAYWRIGHT_TYPES: {
-  readonly ProfileService: symbol;
-  readonly PageRegistry: symbol;
-  readonly BrowserService: symbol;
-  readonly ElementLocatorService: symbol;
-  readonly PageMonitorService: symbol;
-  readonly PauseController: symbol;
-  readonly AutomationRunner: symbol;
-  readonly SpecRunner: symbol;
-  readonly SpecBundlerService: symbol;
-  readonly SpecDiscoveryService: symbol;
-  readonly SpecMetadataService: symbol;
-  readonly SetupRunner: symbol;
-  readonly WebServerManager: symbol;
-  readonly Logger: symbol;
-  readonly HttpServerHealthCheck: symbol;
-  readonly HttpServerManager: symbol;
-  readonly HttpBrowserClient: symbol;
-  readonly RemoteToolExecutor: symbol;
-  readonly ExtensionTaskQueue: symbol;
-  readonly ExtensionToolDelegator: symbol;
-  readonly ToolExecutor: symbol;
-  readonly StealthLauncher: symbol;
-  readonly BrowserLockManager: symbol;
-  readonly ExtensionSessionRegistry: symbol;
-  readonly ExtensionPageProxy: symbol;
-  readonly ExtensionSpecRunner: symbol;
-  readonly McpSessionTracker: symbol;
-  readonly ChromeForTestingService: symbol;
-  readonly WebSocketHub: symbol;
-  readonly IdleCleanupService: symbol;
-  readonly PortRegistryService: symbol;
-  readonly Tool: symbol;
-};
-//#endregion
-//#region src/container/index.d.ts
-
-/**
- * @deprecated Use createMcpContainer() or createHttpContainer() instead.
- */
-declare const container: Container;
-/**
- * @deprecated Use createMcpContainer() or createHttpContainer() instead.
- */
-declare function createContainer(): Container;
-//#endregion
-//#region src/server/index.d.ts
-
-/** Logger interface for dependency injection */
-interface Logger {
-  debug(message: string, context?: Record<string, unknown>): void;
-  info(message: string, context?: Record<string, unknown>): void;
-  warn(message: string, context?: Record<string, unknown>): void;
-  error(message: string, context?: Record<string, unknown>): void;
-}
-/**
- * Error thrown when an unknown tool is requested.
- * Provides error code, recovery suggestion, and available tools list.
- */
-declare class UnknownToolError extends Error {
-  readonly code = "UNKNOWN_TOOL";
-  readonly recovery = "Use ListTools to see available tools.";
-  readonly availableTools: string[];
-  constructor(toolName: string, availableTools: string[], options?: ErrorOptions);
-}
-/**
- * Error thrown when tool execution fails.
- * Provides error code, tool name context, and recovery suggestion.
- */
-declare class ToolExecutionError extends Error {
-  readonly code = "TOOL_EXECUTION_ERROR";
-  readonly recovery: string;
-  readonly toolName: string;
-  constructor(toolName: string, message: string, options?: ErrorOptions & {
-    recovery?: string;
-  });
-}
-/**
- * Configuration options for the MCP server.
- */
-interface ServerConfig {
-  /** Optional IoC container (defaults to the shared container) */
-  container?: Container;
-  /** Optional logger for debugging and error tracking */
-  logger?: Logger;
-}
-/**
- * Creates a new MCP server instance with tools from the IoC container.
- * @param config - Optional server configuration
- * @returns Configured MCP Server instance
- */
-declare function createServer(config?: ServerConfig): Server;
-//#endregion
-//#region src/transports/stdio.d.ts
-/**
- * Stdio transport handler for MCP server
- * Used for command-line and direct integrations
- */
-declare class StdioTransportHandler {
-  private server;
-  private transport;
-  constructor(server: Server);
-  start(): Promise<void>;
-  stop(): Promise<void>;
-}
-//#endregion
-//#region src/validation/tool-definition.d.ts
-declare const JSON_SCHEMA_TYPES: readonly ["object", "string", "number", "boolean", "array", "integer", "null"];
-declare const ToolDefinitionSchema: z.ZodObject<{
-  name: z.ZodString;
-  description: z.ZodString;
-  inputSchema: z.ZodObject<{
-    type: z.ZodEnum<{
-      string: "string";
-      number: "number";
-      boolean: "boolean";
-      object: "object";
-      array: "array";
-      integer: "integer";
-      null: "null";
-    }>;
-    properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    required: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    additionalProperties: z.ZodOptional<z.ZodBoolean>;
-  }, z.core.$strip>;
-}, z.core.$strip>;
-//#endregion
-//#region src/types/spec.d.ts
-/**
- * Spec Types - Type definitions for enhanced spec execution
- *
- * DESIGN PATTERNS:
- * - Interface-based type definitions for type safety
- * - Separation of concerns: metadata, config, filtering, project info
- *
- * CODING STANDARDS:
- * - All interfaces have JSDoc documentation
- * - Types use 'interface' for object shapes
- * - Optional properties marked with '?'
- *
- * AVOID:
- * - Using 'type' for object shapes (prefer interface)
- * - Using 'any' type
- */
-/**
- * Generic schema interface for argument validation.
- * Compatible with Zod schemas - uses parse method for validation.
- */
-interface ArgsSchema {
-  /** Parse and validate input data, throws on invalid input */
-  parse(data: unknown): Record<string, unknown>;
-  /** Safe parse that returns success/error result */
-  safeParse?(data: unknown): {
-    success: boolean;
-    data?: Record<string, unknown>;
-    error?: unknown;
-  };
-}
-/**
- * Metadata extracted from a spec file.
- * Contains information about dynamic arguments and environment prefix.
- */
-interface SpecMetadata {
-  /** Schema for spec arguments validation (compatible with Zod) */
-  argsSchema: ArgsSchema | null;
-  /** Environment variable prefix for argument parsing (e.g., 'SPEC_LOGIN_') */
-  envPrefix: string | null;
-  /** Whether the spec has dynamic arguments */
-  hasDynamicArgs: boolean;
-}
-/**
- * Web server configuration for starting a dev server before running specs.
- * Compatible with Playwright's webServer config.
- */
-interface WebServerConfig {
-  /** Command to start the server (e.g., 'npm run dev') */
-  command: string;
-  /** URL to wait for before running tests */
-  url: string;
-  /** Whether to reuse an existing server if one is running */
-  reuseExistingServer?: boolean;
-  /** Timeout in milliseconds to wait for the server to start */
-  timeout?: number;
-  /** Working directory for the server command */
-  cwd?: string;
-}
-/**
- * Playwright MCP configuration extracted from playwright.config.ts.
- * Contains MCP-specific settings for spec execution.
- */
-interface PlaywrightMcpConfig {
-  /** Base URL for relative navigation */
-  baseURL?: string;
-  /** Path to setup file to run before specs */
-  setupFile?: string;
-  /** Export name in setup file (default: 'default') */
-  setupExport?: string;
-  /** Web server configuration */
-  webServer?: WebServerConfig;
-}
-/**
- * Filter options for selecting which tests to run.
- * Multiple filters are combined with AND logic.
- */
-interface TestFilter {
-  /** Filter by exact test name */
-  testName?: string;
-  /** Filter by regex pattern on full test title */
-  testPattern?: string;
-  /** Run only tests marked with test.only() */
-  onlyMarked?: boolean;
-  /** Filter by describe block name pattern */
-  describeFilter?: string;
-}
-/**
- * E2E project configuration for multi-project test setups.
- * Represents a logical grouping of specs within a project.
- */
-interface E2EProject {
-  /** Project name (e.g., 'desktop', 'mobile') */
-  name: string;
-  /** Project root path */
-  path: string;
-  /** Path to playwright.config.ts */
-  configPath?: string;
-  /** Test directory relative to project path */
-  testDir?: string;
-  /** List of spec files in this project */
-  specs: SpecInfo[];
-}
-/**
- * Information about a single spec file.
- * Used for listing and selecting specs to run.
- */
-interface SpecInfo {
-  /** Spec file name without path */
-  name: string;
-  /** Absolute path to the spec file */
-  path: string;
-  /** Path relative to project root */
-  relativePath: string;
-  /** Whether the spec exports an argsSchema */
-  hasArgsSchema: boolean;
-  /** Number of tests in the spec */
-  testCount: number;
-}
-//#endregion
-//#region src/types/index.d.ts
-/**
- * JSON Schema type values supported in tool input schemas
- */
-type JsonSchemaType = (typeof JSON_SCHEMA_TYPES)[number];
-/**
- * Tool definition for MCP, derived from Zod schema
- */
-type ToolDefinition = z.infer<typeof ToolDefinitionSchema>;
-/**
- * Structured success result from tool execution
- */
-interface ToolSuccessResult extends CallToolResult {
-  isError: false;
-}
-/**
- * Structured failure result from tool execution
- */
-interface ToolFailureResult extends CallToolResult {
-  isError: true;
-}
-/**
- * Discriminated union for tool execution outcomes
- */
-type ToolResult = ToolSuccessResult | ToolFailureResult;
-/**
- * Base tool interface following MCP SDK patterns.
- * Returns CallToolResult for SDK compatibility.
- * Use ToolResult to narrow success/failure when isError is set.
- */
-interface Tool<TInput = unknown> {
-  getDefinition(): ToolDefinition;
-  execute(input: TInput): Promise<CallToolResult>;
-}
-//#endregion
-export { type ArgsSchema, type E2EProject, JsonSchemaType, type Logger, PLAYWRIGHT_TYPES, type PlaywrightMcpConfig, type ServerConfig, type SpecInfo, type SpecMetadata, StdioTransportHandler, type TestFilter, Tool, ToolDefinition, ToolExecutionError, ToolFailureResult, ToolResult, ToolSuccessResult, UnknownToolError, type WebServerConfig, container, createContainer, createServer };
-//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/constants/playwright-types.ts","../src/container/index.ts","../src/server/index.ts","../src/transports/stdio.ts","../src/validation/tool-definition.ts","../src/types/spec.ts","../src/types/index.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.d.mts

@@ -1,310 +0,0 @@
-import "reflect-metadata/lite";
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-import { Container, ContainerModule } from "inversify";
-import { z } from "zod";
-
-//#region src/constants/playwright-types.d.ts
-
-/**
- * InversifyJS DI container binding tokens.
- * Maps service names to unique Symbol identifiers for dependency injection.
- *
- * DESIGN PATTERNS:
- * - Token map pattern for IoC container bindings
- * - Uses named constants from service-ids to avoid magic strings
- * - Frozen object (as const) to prevent runtime modification
- *
- * CODING STANDARDS:
- * - Import service ID constants instead of using inline strings
- * - Keep in sync with container module registrations
- * - Use Symbol.for() for cross-module symbol sharing
- *
- * AVOID:
- * - Adding entries without corresponding container bindings
- * - Using Symbol() instead of Symbol.for() (breaks cross-module resolution)
- */
-declare const PLAYWRIGHT_TYPES: {
-  readonly ProfileService: symbol;
-  readonly PageRegistry: symbol;
-  readonly BrowserService: symbol;
-  readonly ElementLocatorService: symbol;
-  readonly PageMonitorService: symbol;
-  readonly PauseController: symbol;
-  readonly AutomationRunner: symbol;
-  readonly SpecRunner: symbol;
-  readonly SpecBundlerService: symbol;
-  readonly SpecDiscoveryService: symbol;
-  readonly SpecMetadataService: symbol;
-  readonly SetupRunner: symbol;
-  readonly WebServerManager: symbol;
-  readonly Logger: symbol;
-  readonly HttpServerHealthCheck: symbol;
-  readonly HttpServerManager: symbol;
-  readonly HttpBrowserClient: symbol;
-  readonly RemoteToolExecutor: symbol;
-  readonly ExtensionTaskQueue: symbol;
-  readonly ExtensionToolDelegator: symbol;
-  readonly ToolExecutor: symbol;
-  readonly StealthLauncher: symbol;
-  readonly BrowserLockManager: symbol;
-  readonly ExtensionSessionRegistry: symbol;
-  readonly ExtensionPageProxy: symbol;
-  readonly ExtensionSpecRunner: symbol;
-  readonly McpSessionTracker: symbol;
-  readonly ChromeForTestingService: symbol;
-  readonly WebSocketHub: symbol;
-  readonly IdleCleanupService: symbol;
-  readonly PortRegistryService: symbol;
-  readonly Tool: symbol;
-};
-//#endregion
-//#region src/container/index.d.ts
-
-/**
- * @deprecated Use createMcpContainer() or createHttpContainer() instead.
- */
-declare const container: Container;
-/**
- * @deprecated Use createMcpContainer() or createHttpContainer() instead.
- */
-declare function createContainer(): Container;
-//#endregion
-//#region src/server/index.d.ts
-
-/** Logger interface for dependency injection */
-interface Logger {
-  debug(message: string, context?: Record<string, unknown>): void;
-  info(message: string, context?: Record<string, unknown>): void;
-  warn(message: string, context?: Record<string, unknown>): void;
-  error(message: string, context?: Record<string, unknown>): void;
-}
-/**
- * Error thrown when an unknown tool is requested.
- * Provides error code, recovery suggestion, and available tools list.
- */
-declare class UnknownToolError extends Error {
-  readonly code = "UNKNOWN_TOOL";
-  readonly recovery = "Use ListTools to see available tools.";
-  readonly availableTools: string[];
-  constructor(toolName: string, availableTools: string[], options?: ErrorOptions);
-}
-/**
- * Error thrown when tool execution fails.
- * Provides error code, tool name context, and recovery suggestion.
- */
-declare class ToolExecutionError extends Error {
-  readonly code = "TOOL_EXECUTION_ERROR";
-  readonly recovery: string;
-  readonly toolName: string;
-  constructor(toolName: string, message: string, options?: ErrorOptions & {
-    recovery?: string;
-  });
-}
-/**
- * Configuration options for the MCP server.
- */
-interface ServerConfig {
-  /** Optional IoC container (defaults to the shared container) */
-  container?: Container;
-  /** Optional logger for debugging and error tracking */
-  logger?: Logger;
-}
-/**
- * Creates a new MCP server instance with tools from the IoC container.
- * @param config - Optional server configuration
- * @returns Configured MCP Server instance
- */
-declare function createServer(config?: ServerConfig): Server;
-//#endregion
-//#region src/transports/stdio.d.ts
-/**
- * Stdio transport handler for MCP server
- * Used for command-line and direct integrations
- */
-declare class StdioTransportHandler {
-  private server;
-  private transport;
-  constructor(server: Server);
-  start(): Promise<void>;
-  stop(): Promise<void>;
-}
-//#endregion
-//#region src/validation/tool-definition.d.ts
-declare const JSON_SCHEMA_TYPES: readonly ["object", "string", "number", "boolean", "array", "integer", "null"];
-declare const ToolDefinitionSchema: z.ZodObject<{
-  name: z.ZodString;
-  description: z.ZodString;
-  inputSchema: z.ZodObject<{
-    type: z.ZodEnum<{
-      string: "string";
-      number: "number";
-      boolean: "boolean";
-      object: "object";
-      array: "array";
-      integer: "integer";
-      null: "null";
-    }>;
-    properties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-    required: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    additionalProperties: z.ZodOptional<z.ZodBoolean>;
-  }, z.core.$strip>;
-}, z.core.$strip>;
-//#endregion
-//#region src/types/spec.d.ts
-/**
- * Spec Types - Type definitions for enhanced spec execution
- *
- * DESIGN PATTERNS:
- * - Interface-based type definitions for type safety
- * - Separation of concerns: metadata, config, filtering, project info
- *
- * CODING STANDARDS:
- * - All interfaces have JSDoc documentation
- * - Types use 'interface' for object shapes
- * - Optional properties marked with '?'
- *
- * AVOID:
- * - Using 'type' for object shapes (prefer interface)
- * - Using 'any' type
- */
-/**
- * Generic schema interface for argument validation.
- * Compatible with Zod schemas - uses parse method for validation.
- */
-interface ArgsSchema {
-  /** Parse and validate input data, throws on invalid input */
-  parse(data: unknown): Record<string, unknown>;
-  /** Safe parse that returns success/error result */
-  safeParse?(data: unknown): {
-    success: boolean;
-    data?: Record<string, unknown>;
-    error?: unknown;
-  };
-}
-/**
- * Metadata extracted from a spec file.
- * Contains information about dynamic arguments and environment prefix.
- */
-interface SpecMetadata {
-  /** Schema for spec arguments validation (compatible with Zod) */
-  argsSchema: ArgsSchema | null;
-  /** Environment variable prefix for argument parsing (e.g., 'SPEC_LOGIN_') */
-  envPrefix: string | null;
-  /** Whether the spec has dynamic arguments */
-  hasDynamicArgs: boolean;
-}
-/**
- * Web server configuration for starting a dev server before running specs.
- * Compatible with Playwright's webServer config.
- */
-interface WebServerConfig {
-  /** Command to start the server (e.g., 'npm run dev') */
-  command: string;
-  /** URL to wait for before running tests */
-  url: string;
-  /** Whether to reuse an existing server if one is running */
-  reuseExistingServer?: boolean;
-  /** Timeout in milliseconds to wait for the server to start */
-  timeout?: number;
-  /** Working directory for the server command */
-  cwd?: string;
-}
-/**
- * Playwright MCP configuration extracted from playwright.config.ts.
- * Contains MCP-specific settings for spec execution.
- */
-interface PlaywrightMcpConfig {
-  /** Base URL for relative navigation */
-  baseURL?: string;
-  /** Path to setup file to run before specs */
-  setupFile?: string;
-  /** Export name in setup file (default: 'default') */
-  setupExport?: string;
-  /** Web server configuration */
-  webServer?: WebServerConfig;
-}
-/**
- * Filter options for selecting which tests to run.
- * Multiple filters are combined with AND logic.
- */
-interface TestFilter {
-  /** Filter by exact test name */
-  testName?: string;
-  /** Filter by regex pattern on full test title */
-  testPattern?: string;
-  /** Run only tests marked with test.only() */
-  onlyMarked?: boolean;
-  /** Filter by describe block name pattern */
-  describeFilter?: string;
-}
-/**
- * E2E project configuration for multi-project test setups.
- * Represents a logical grouping of specs within a project.
- */
-interface E2EProject {
-  /** Project name (e.g., 'desktop', 'mobile') */
-  name: string;
-  /** Project root path */
-  path: string;
-  /** Path to playwright.config.ts */
-  configPath?: string;
-  /** Test directory relative to project path */
-  testDir?: string;
-  /** List of spec files in this project */
-  specs: SpecInfo[];
-}
-/**
- * Information about a single spec file.
- * Used for listing and selecting specs to run.
- */
-interface SpecInfo {
-  /** Spec file name without path */
-  name: string;
-  /** Absolute path to the spec file */
-  path: string;
-  /** Path relative to project root */
-  relativePath: string;
-  /** Whether the spec exports an argsSchema */
-  hasArgsSchema: boolean;
-  /** Number of tests in the spec */
-  testCount: number;
-}
-//#endregion
-//#region src/types/index.d.ts
-/**
- * JSON Schema type values supported in tool input schemas
- */
-type JsonSchemaType = (typeof JSON_SCHEMA_TYPES)[number];
-/**
- * Tool definition for MCP, derived from Zod schema
- */
-type ToolDefinition = z.infer<typeof ToolDefinitionSchema>;
-/**
- * Structured success result from tool execution
- */
-interface ToolSuccessResult extends CallToolResult {
-  isError: false;
-}
-/**
- * Structured failure result from tool execution
- */
-interface ToolFailureResult extends CallToolResult {
-  isError: true;
-}
-/**
- * Discriminated union for tool execution outcomes
- */
-type ToolResult = ToolSuccessResult | ToolFailureResult;
-/**
- * Base tool interface following MCP SDK patterns.
- * Returns CallToolResult for SDK compatibility.
- * Use ToolResult to narrow success/failure when isError is set.
- */
-interface Tool<TInput = unknown> {
-  getDefinition(): ToolDefinition;
-  execute(input: TInput): Promise<CallToolResult>;
-}
-//#endregion
-export { type ArgsSchema, type E2EProject, JsonSchemaType, type Logger, PLAYWRIGHT_TYPES, type PlaywrightMcpConfig, type ServerConfig, type SpecInfo, type SpecMetadata, StdioTransportHandler, type TestFilter, Tool, ToolDefinition, ToolExecutionError, ToolFailureResult, ToolResult, ToolSuccessResult, UnknownToolError, type WebServerConfig, container, createContainer, createServer };
-//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/constants/playwright-types.ts","../src/container/index.ts","../src/server/index.ts","../src/transports/stdio.ts","../src/validation/tool-definition.ts","../src/types/spec.ts","../src/types/index.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":["defaultContainer"],"sources":["../src/server/index.ts"],"sourcesContent":["/**\n * MCP Server Setup\n *\n * DESIGN PATTERNS:\n * - Factory pattern for server creation with IoC container\n * - Tool registry pattern for fast lookup\n * - Structured error handling with custom error classes\n *\n * CODING STANDARDS:\n * - Tools are loaded from IoC container on server creation\n * - Proper error handling in all request handlers with custom error classes\n * - Errors include codes, recovery suggestions, and available tools list\n *\n * AVOID:\n * - Hardcoded tool lists (use IoC container)\n * - Missing error handling in handlers\n * - Generic error messages without recovery suggestions\n */\n\nimport { Server } from '@modelcontextprotocol/sdk/server/index.js';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';\nimport type { Container } from 'inversify';\nimport { PLAYWRIGHT_TYPES, container as defaultContainer } from '../container/index.js';\nimport type { Tool } from '../types/index.js';\n\n// ============================================================================\n// Logger Interface\n// ============================================================================\n\n/** Logger interface for dependency injection */\nexport interface Logger {\n  debug(message: string, context?: Record<string, unknown>): void;\n  info(message: string, context?: Record<string, unknown>): void;\n  warn(message: string, context?: Record<string, unknown>): void;\n  error(message: string, context?: Record<string, unknown>): void;\n}\n\n/**\n * Creates a no-op logger for silent operation.\n * @returns A logger implementation that discards all messages\n */\nfunction createNoopLogger(): Logger {\n  const noop = (): void => undefined;\n  return { debug: noop, info: noop, warn: noop, error: noop };\n}\n\n// ============================================================================\n// Error Classes\n// ============================================================================\n\n/**\n * Error thrown when an unknown tool is requested.\n * Provides error code, recovery suggestion, and available tools list.\n */\nexport class UnknownToolError extends Error {\n  readonly code = 'UNKNOWN_TOOL';\n  readonly recovery = 'Use ListTools to see available tools.';\n  readonly availableTools: string[];\n\n  constructor(toolName: string, availableTools: string[], options?: ErrorOptions) {\n    super(\n      `Unknown tool: ${toolName}. Available tools: ${availableTools.slice(0, 5).join(', ')}${availableTools.length > 5 ? `, ... (${availableTools.length} total)` : ''}. Use ListTools to see all available tools.`,\n      options,\n    );\n    this.name = 'UnknownToolError';\n    this.availableTools = availableTools;\n  }\n}\n\n/**\n * Error thrown when tool execution fails.\n * Provides error code, tool name context, and recovery suggestion.\n */\nexport class ToolExecutionError extends Error {\n  readonly code = 'TOOL_EXECUTION_ERROR';\n  readonly recovery: string;\n  readonly toolName: string;\n\n  constructor(toolName: string, message: string, options?: ErrorOptions & { recovery?: string }) {\n    super(`Tool execution failed for '${toolName}': ${message}`, options);\n    this.name = 'ToolExecutionError';\n    this.toolName = toolName;\n    this.recovery = options?.recovery ?? 'Check tool inputs and try again.';\n  }\n}\n\n// ============================================================================\n// Server Configuration\n// ============================================================================\n\n/**\n * Configuration options for the MCP server.\n */\nexport interface ServerConfig {\n  /** Optional IoC container (defaults to the shared container) */\n  container?: Container;\n  /** Optional logger for debugging and error tracking */\n  logger?: Logger;\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Creates a structured error response following MCP conventions.\n * Includes error codes, recovery suggestions, and context metadata.\n * @param error - The error that occurred\n * @param toolName - Name of the tool that failed\n * @returns CallToolResult with isError flag and structured error content\n */\nfunction createErrorResponse(error: unknown, toolName: string): CallToolResult {\n  const message = error instanceof Error ? error.message : 'Unknown error occurred';\n  const code = error instanceof Error && 'code' in error ? (error as { code: string }).code : 'TOOL_EXECUTION_ERROR';\n  const recovery =\n    error instanceof Error && 'recovery' in error\n      ? (error as { recovery: string }).recovery\n      : 'Check tool inputs and try again.';\n\n  const errorResponse = {\n    error: {\n      code,\n      message,\n      toolName,\n      recovery,\n    },\n  };\n\n  return {\n    content: [\n      {\n        type: 'text',\n        text: JSON.stringify(errorResponse, null, 2),\n      },\n    ],\n    isError: true,\n  };\n}\n\n// ============================================================================\n// Server Factory\n// ============================================================================\n\n/**\n * Creates a new MCP server instance with tools from the IoC container.\n * @param config - Optional server configuration\n * @returns Configured MCP Server instance\n */\nexport function createServer(config?: ServerConfig): Server {\n  const iocContainer = config?.container ?? defaultContainer;\n  const logger = config?.logger ?? createNoopLogger();\n\n  const server = new Server(\n    {\n      name: 'browse-tool',\n      version: '0.1.0',\n    },\n    {\n      capabilities: {\n        tools: {},\n      },\n    },\n  );\n\n  // Get all tools from the container\n  const tools = iocContainer.getAll<Tool>(PLAYWRIGHT_TYPES.Tool);\n\n  // Build tool map for fast lookup\n  const toolMap = new Map<string, Tool>();\n  for (const tool of tools) {\n    const def = tool.getDefinition();\n    toolMap.set(def.name, tool);\n  }\n\n  logger.info('MCP server initialized', { toolCount: tools.length });\n\n  // List all available tools\n  server.setRequestHandler(ListToolsRequestSchema, async () => {\n    logger.debug('ListTools request received');\n    return {\n      tools: tools.map((tool) => tool.getDefinition()),\n    };\n  });\n\n  // Execute tool by name\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const { name, arguments: args } = request.params;\n\n    logger.debug('Tool call received', { toolName: name, timestamp: new Date().toISOString() });\n\n    const tool = toolMap.get(name);\n\n    if (!tool) {\n      const availableTools = Array.from(toolMap.keys());\n      logger.warn('Unknown tool requested', { toolName: name, availableTools, timestamp: new Date().toISOString() });\n      throw new UnknownToolError(name, availableTools);\n    }\n\n    try {\n      return await tool.execute(args);\n    } catch (error) {\n      // Wrap in ToolExecutionError for consistent error handling\n      const toolError =\n        error instanceof ToolExecutionError\n          ? error\n          : new ToolExecutionError(name, error instanceof Error ? error.message : String(error), { cause: error });\n\n      logger.error('Tool execution failed', {\n        toolName: name,\n        error: toolError.message,\n        code: toolError.code,\n        timestamp: new Date().toISOString(),\n      });\n      return createErrorResponse(toolError, name);\n    }\n  });\n\n  return server;\n}\n"],"mappings":"+QA0CA,SAAS,GAA2B,CAClC,IAAM,MAAmB,IAAA,GACzB,MAAO,CAAE,MAAO,EAAM,KAAM,EAAM,KAAM,EAAM,MAAO,EAAM,CAW7D,IAAa,EAAb,cAAsC,KAAM,CAC1C,KAAgB,eAChB,SAAoB,wCACpB,eAEA,YAAY,EAAkB,EAA0B,EAAwB,CAC9E,MACE,iBAAiB,EAAS,qBAAqB,EAAe,MAAM,EAAG,EAAE,CAAC,KAAK,KAAK,GAAG,EAAe,OAAS,EAAI,UAAU,EAAe,OAAO,SAAW,GAAG,6CACjK,EACD,CACD,KAAK,KAAO,mBACZ,KAAK,eAAiB,IAQb,EAAb,cAAwC,KAAM,CAC5C,KAAgB,uBAChB,SACA,SAEA,YAAY,EAAkB,EAAiB,EAAgD,CAC7F,MAAM,8BAA8B,EAAS,KAAK,IAAW,EAAQ,CACrE,KAAK,KAAO,qBACZ,KAAK,SAAW,EAChB,KAAK,SAAW,GAAS,UAAY,qCA6BzC,SAAS,EAAoB,EAAgB,EAAkC,CAC7E,IAAM,EAAU,aAAiB,MAAQ,EAAM,QAAU,yBAOnD,EAAgB,CACpB,MAAO,CACL,KARS,aAAiB,OAAS,SAAU,EAAS,EAA2B,KAAO,uBASxF,UACA,WACA,SATF,aAAiB,OAAS,aAAc,EACnC,EAA+B,SAChC,mCAQH,CACF,CAED,MAAO,CACL,QAAS,CACP,CACE,KAAM,OACN,KAAM,KAAK,UAAU,EAAe,KAAM,EAAE,CAC7C,CACF,CACD,QAAS,GACV,CAYH,SAAgB,EAAa,EAA+B,CAC1D,IAAM,EAAe,GAAQ,WAAaA,EACpC,EAAS,GAAQ,QAAU,GAAkB,CAE7C,EAAS,IAAI,EACjB,CACE,KAAM,cACN,QAAS,QACV,CACD,CACE,aAAc,CACZ,MAAO,EAAE,CACV,CACF,CACF,CAGK,EAAQ,EAAa,OAAa,EAAiB,KAAK,CAGxD,EAAU,IAAI,IACpB,IAAK,IAAM,KAAQ,EAAO,CACxB,IAAM,EAAM,EAAK,eAAe,CAChC,EAAQ,IAAI,EAAI,KAAM,EAAK,CA8C7B,OA3CA,EAAO,KAAK,yBAA0B,CAAE,UAAW,EAAM,OAAQ,CAAC,CAGlE,EAAO,kBAAkB,EAAwB,UAC/C,EAAO,MAAM,6BAA6B,CACnC,CACL,MAAO,EAAM,IAAK,GAAS,EAAK,eAAe,CAAC,CACjD,EACD,CAGF,EAAO,kBAAkB,EAAuB,KAAO,IAAY,CACjE,GAAM,CAAE,OAAM,UAAW,GAAS,EAAQ,OAE1C,EAAO,MAAM,qBAAsB,CAAE,SAAU,EAAM,UAAW,IAAI,MAAM,CAAC,aAAa,CAAE,CAAC,CAE3F,IAAM,EAAO,EAAQ,IAAI,EAAK,CAE9B,GAAI,CAAC,EAAM,CACT,IAAM,EAAiB,MAAM,KAAK,EAAQ,MAAM,CAAC,CAEjD,MADA,EAAO,KAAK,yBAA0B,CAAE,SAAU,EAAM,iBAAgB,UAAW,IAAI,MAAM,CAAC,aAAa,CAAE,CAAC,CACxG,IAAI,EAAiB,EAAM,EAAe,CAGlD,GAAI,CACF,OAAO,MAAM,EAAK,QAAQ,EAAK,OACxB,EAAO,CAEd,IAAM,EACJ,aAAiB,EACb,EACA,IAAI,EAAmB,EAAM,aAAiB,MAAQ,EAAM,QAAU,OAAO,EAAM,CAAE,CAAE,MAAO,EAAO,CAAC,CAQ5G,OANA,EAAO,MAAM,wBAAyB,CACpC,SAAU,EACV,MAAO,EAAU,QACjB,KAAM,EAAU,KAChB,UAAW,IAAI,MAAM,CAAC,aAAa,CACpC,CAAC,CACK,EAAoB,EAAW,EAAK,GAE7C,CAEK"}