@haibun/mcp 1.68.0 → 1.70.0

package/README.md

@@ -2,163 +2,92 @@
 
 Enables agents to interact with Haibun steppers through the standardized [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).
 
-This module provides both server and client capabilities for MCP integration with Haibun.
-
-## MCP Server
-
-The **MCP Server** automatically exposes all available Haibun steppers as MCP tools, allowing external agents to:
-
-- **Discover available steppers** through MCP's tool listing protocol
-- **Execute any stepper functionality** available in your workspace
-
-### Remote Execution Support
-
-The MCP server can connect to a remote Haibun execution context via HTTP. This is particularly useful when:
-
-- You want to pause execution and interact via an IDE or other tools
-- Multiple agents need to share the same execution context
-
-#### Configuration
-
-⚠️ **Security Requirement**: ACCESS_TOKEN is mandatory when enabling remote execution. The system will fail fast if a port is configured without proper authentication.
-
-To enable remote execution, configure both the HTTP executor and MCP server with matching ports and tokens:
+## Quick Start
 
+### 1. Run exampe external HTTP executor
 ```bash
-# Start Haibun with remote executor enabled and access token
-HAIBUN_O_WEBPLAYWRIGHT_STORAGE=StorageMem \
-HAIBUN_O_HTTPEXECUTORSTEPPER_LISTEN_PORT=8124 \
-HAIBUN_O_HTTPEXECUTORSTEPPER_ACCESS_TOKEN=your-secret-token \
-node modules/cli/build/cli.js --cwd modules/mcp/runtime cli
-```
 
-If you want the MCP server to connect to a remote execution endpoint, configure it explicitly:
+./run-mcp-with-monitor.sh
 
-```bash
-# Configure MCP server to use remote execution
-HAIBUN_O_MCPSERVERSTEPPER_REMOTE_PORT=8124 \
-HAIBUN_O_MCPSERVERSTEPPER_ACCESS_TOKEN=your-secret-token \
-node modules/cli/build/cli.js --cwd modules/mcp/test tests
 ```
-#### Remote Execution API
-
-When the HTTP executor is running, you can interact with it directly via HTTP API. All requests require authentication via the ACCESS_TOKEN.
 
-**Execute a step:**
-```bash
-curl -X POST http://localhost:8124/execute-step \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer your-secret-token" \
-  -d '{
-    "statement": "I set MY_VAR to hello world",
-    "source": "curl"
-  }'
+### 2. VS Code MCP Configuration
+Add to your VS Code `mcp.json`:
+```json
+{
+  "servers": {
+    "haibun-mcp": {
+      "type": "stdio",
+      "command": "node",
+      "cwd": "/path/to/haibun",
+      "args": [
+        "modules/cli/build/cli.js",
+        "-c",
+        "./modules/mcp/runtime/agent/config.json",
+        "./modules/mcp/runtime/agent"
+      ],
+      "env": {
+        "HAIBUN_O_WEBPLAYWRIGHT_STORAGE": "StorageMem",
+        "HAIBUN_O_MCPSERVERSTEPPER_REMOTE_PORT": "8125",
+        "HAIBUN_O_MCPSERVERSTEPPER_ACCESS_TOKEN": "localTest"
+      }
+    }
+  }
+}
 ```
 
-### Starting an MCP Server
+### 3. Use MCP Tools
+Available tools automatically expose all Haibun steppers:
+- `WebPlaywright-gotoPage` - Navigate to web pages  
+- `WebPlaywright-click` - Click elements
+- `WebPlaywright-shouldSeeText` - Verify page content
+- `VariablesStepper-set` - Set variables
+- `Haibun-pauseSeconds` - Add delays
+- And all other loaded steppers
 
-The MCP Server is a Haibun stepper. For a basic example with representative steppers:
+## Architecture
 
-```bash
-# Basic local execution
-HAIBUN_O_WEBPLAYWRIGHT_STORAGE=StorageMem \
-node modules/cli/build/cli.js --cwd modules/mcp/runtime local
-```
+**External Runtime** 
+- Runs HTTP executor with monitoring
+- Provides step execution API on port 8125
+- Browser automation visible in monitor
+
+**MCP Agent** 
+- Lightweight process that connects to external runtime
+- Exposes remote steppers as MCP tools via stdio
+- Acts as bridge between eg VS Code and your tests
 
-Or with remote execution enabled:
+## Advanced Usage
 
+### Local MCP Server (no external runtime)
 ```bash
-# With remote execution capability
 HAIBUN_O_WEBPLAYWRIGHT_STORAGE=StorageMem \
-HAIBUN_O_HTTPEXECUTORSTEPPER_LISTEN_PORT=8124 \
-HAIBUN_O_HTTPEXECUTORSTEPPER_ACCESS_TOKEN=your-secret-token \
-node modules/cli/build/cli.js --cwd modules/mcp/runtime http
+node modules/cli/build/cli.js -c ./modules/mcp/runtime/config.json ./modules/mcp/runtime/local
 ```
 
-### Using from External MCP Clients
-Any MCP-compatible client can discover and call the exposed tools. The exact tools available depend on which Haibun modules are configured in your workspace.
-
-### Server Control from Haibun Features
-```gherkin
-Feature: MCP Server Management
-  Scenario: Start and stop MCP server
-    Given I serve mcp tools from steppers
-
-    The server is now running and exposing tools to external MCP clients.
-
-    When I stop mcp tools
-    The server is stopped.
-
-  Scenario: Enable remote execution API
-    Given I enable remote executor
-
-    Now external MCP servers can connect to this execution context via HTTP.
+### HTTP API Direct Access
+```bash
+curl -X POST http://localhost:8125/execute-step \
+  -H "Authorization: Bearer localTest" \
+  -H "Content-Type: application/json" \
+  -d '{"statement": "pause for 1s", "source": "/api"}'
 ```
 
-## MCP Client
-
-The **MCP Client** allows Haibun features to connect to external MCP servers and discover their available tools.
-
-### Client Usage from Haibun Features
+### Control from Haibun Features
 ```gherkin
-Feature: External MCP Integration
-  Scenario: List tools from external server
-    When I list mcp tools
+Start MCP server.
+serve mcp tools from steppers
 
-    This discovers all tools available from the configured MCP server.
-```
-
-### Client Configuration
-The client requires server connection parameters to be configured via module options:
-```json
-{
-  "MCPClientStepper": {
-    "SERVER": "{\"command\": \"node\", \"args\": [\"server.js\"], \"env\": {}}"
-  }
-}
+Enable remote execution.
+enable remote executor
 ```
 
-## Examples
+## Configuration
 
-## VSCode config
-
-```
- "mcp": {
-    "servers": {
-      "haibun-mcp": {
-        "type": "stdio",
-        "command": "tsx",
-        "cwd": "~",
-        "args": [
-          "modules/cli/build/cli.js",
-          "-c",
-          "./modules/mcp/runtime/config.json",
-          "./modules/mcp/runtime/http"
-        ],
-        "env": {
-          "HAIBUN_O_MCPSERVERSTEPPER_REMOTE_PORT": "8125",
-          "HAIBUN_O_MCPSERVERSTEPPER_ACCESS_TOKEN": "some-great-password",
-          "HAIBUN_O_HTTPEXECUTORSTEPPER_LISTEN_PORT": "8125",
-          "HAIBUN_O_HTTPEXECUTORSTEPPER_ACCESS_TOKEN": "some-great-password",
-          "HAIBUN_O_WEBPLAYWRIGHT_STORAGE": "StorageMem"
-        },
-        "dev": {
-          "watch": "modules/**/build/**/*.js",
-          "debug": {
-            "type": "node"
-          }
-        },
-      },
-			```
-
-### Server Tools
-Depending on which Haibun modules you have configured, you might see tools like:
-
-- `VariablesStepper-set` - Set variable values
-- `VariablesStepper-display` - Display variable values
-- `WebPlaywright-gotoPage` - Navigate to web pages
-- `Haibun-comment` - Add comments
-- Any locally configured steppers
-
-### Client Tools
-- `list mcp tools` - Discover tools available from external MCP servers
+| Environment Variable | Description |
+|---------------------|-------------|
+| `HAIBUN_O_HTTPEXECUTORSTEPPER_LISTEN_PORT` | HTTP API port (e.g., 8125) |
+| `HAIBUN_O_HTTPEXECUTORSTEPPER_ACCESS_TOKEN` | HTTP API auth token |
+| `HAIBUN_O_MCPSERVERSTEPPER_REMOTE_PORT` | Connect to remote HTTP executor |
+| `HAIBUN_O_MCPSERVERSTEPPER_ACCESS_TOKEN` | Remote executor auth token |
+| `HAIBUN_O_WEBPLAYWRIGHT_STORAGE` | Storage backend (StorageMem) |

package/build/lib/http-prompter-client.d.ts

@@ -0,0 +1,19 @@
+/**
+ * HttpPrompterClient - HTTP client for accessing remote prompter service endpoints.
+ * Used by MCP server tools to retrieve and respond to prompts via HTTP API.
+ */
+export declare class HttpPrompterClient {
+    private httpBaseUrl;
+    private accessToken?;
+    constructor(httpBaseUrl: string, accessToken?: string);
+    private getHeaders;
+    /**
+     * Get all pending prompts by calling the HTTP prompter endpoint
+     */
+    getPrompts(): Promise<any>;
+    /**
+     * Respond to a prompt by calling the HTTP prompter endpoint
+     */
+    respondToPrompt(id: string, response: string): Promise<any>;
+}
+//# sourceMappingURL=http-prompter-client.d.ts.map

package/build/lib/http-prompter-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-prompter-client.d.ts","sourceRoot":"","sources":["../../src/lib/http-prompter-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,kBAAkB;IAElB,OAAO,CAAC,WAAW;IAAU,OAAO,CAAC,WAAW,CAAC;gBAAzC,WAAW,EAAE,MAAM,EAAU,WAAW,CAAC,EAAE,MAAM;IAIrE,OAAO,CAAC,UAAU;IAYlB;;OAEG;IACG,UAAU;IAsBhB;;OAEG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAkBlD"}

package/build/lib/http-prompter-client.js

@@ -0,0 +1,68 @@
+/**
+ * HttpPrompterClient - HTTP client for accessing remote prompter service endpoints.
+ * Used by MCP server tools to retrieve and respond to prompts via HTTP API.
+ */
+export class HttpPrompterClient {
+    httpBaseUrl;
+    accessToken;
+    constructor(httpBaseUrl, accessToken) {
+        this.httpBaseUrl = httpBaseUrl;
+        this.accessToken = accessToken;
+        this.httpBaseUrl = httpBaseUrl;
+    }
+    getHeaders() {
+        const headers = {
+            'Content-Type': 'application/json'
+        };
+        if (this.accessToken) {
+            headers['Authorization'] = `Bearer ${this.accessToken}`;
+        }
+        return headers;
+    }
+    /**
+     * Get all pending prompts by calling the HTTP prompter endpoint
+     */
+    async getPrompts() {
+        const response = await fetch(`${this.httpBaseUrl}/prompts`, {
+            headers: this.getHeaders()
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        const responseData = await response.json();
+        // Handle different response formats:
+        // 1. Direct array: [prompt1, prompt2, ...]
+        // 2. Wrapped object: { prompts: [prompt1, prompt2, ...] }
+        if (Array.isArray(responseData)) {
+            return responseData;
+        }
+        else if (responseData && Array.isArray(responseData.prompts)) {
+            return responseData.prompts;
+        }
+        else {
+            // Return empty array for unexpected formats
+            return [];
+        }
+    }
+    /**
+     * Respond to a prompt by calling the HTTP prompter endpoint
+     */
+    async respondToPrompt(id, response) {
+        try {
+            const httpResponse = await fetch(`${this.httpBaseUrl}/prompts/${id}/respond`, {
+                method: 'POST',
+                headers: this.getHeaders(),
+                body: JSON.stringify({ response }),
+            });
+            if (!httpResponse.ok) {
+                throw new Error(`HTTP ${httpResponse.status}: ${httpResponse.statusText}`);
+            }
+            return await httpResponse.json();
+        }
+        catch (error) {
+            console.warn('Failed to respond to prompt via HTTP prompter:', error);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=http-prompter-client.js.map

package/build/lib/http-prompter-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-prompter-client.js","sourceRoot":"","sources":["../../src/lib/http-prompter-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAEV;IAA6B;IAAjD,YAAoB,WAAmB,EAAU,WAAoB;QAAjD,gBAAW,GAAX,WAAW,CAAQ;QAAU,gBAAW,GAAX,WAAW,CAAS;QACpE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IAChC,CAAC;IAEO,UAAU;QACjB,MAAM,OAAO,GAA2B;YACvC,cAAc,EAAE,kBAAkB;SAClC,CAAC;QAEF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC;QACzD,CAAC;QAED,OAAO,OAAO,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACf,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,UAAU,EAAE;YAC3D,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE3C,qCAAqC;QACrC,2CAA2C;QAC3C,0DAA0D;QAC1D,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,OAAO,YAAY,CAAC;QACrB,CAAC;aAAM,IAAI,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YAChE,OAAO,YAAY,CAAC,OAAO,CAAC;QAC7B,CAAC;aAAM,CAAC;YACP,4CAA4C;YAC5C,OAAO,EAAE,CAAC;QACX,CAAC;IACF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,EAAU,EAAE,QAAgB;QACjD,IAAI,CAAC;YACJ,MAAM,YAAY,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,YAAY,EAAE,UAAU,EAAE;gBAC7E,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE;gBAC1B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;aAClC,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CAAC,QAAQ,YAAY,CAAC,MAAM,KAAK,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC;YAC5E,CAAC;YAED,OAAO,MAAM,YAAY,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,gDAAgD,EAAE,KAAK,CAAC,CAAC;YACtE,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;CACD"}

package/build/lib/mcp-executor-server.d.ts

@@ -1,20 +1,28 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { AStepper } from "@haibun/core/lib/astepper.js";
 import { TWorld } from "@haibun/core/lib/defs.js";
-interface RemoteExecutorConfig {
+import { HttpPrompterClient } from './http-prompter-client.js';
+type IRemoteExecutorConfig = {
     url: string;
     accessToken?: string;
-}
+};
 export declare class MCPExecutorServer {
     private steppers;
     private world;
     private remoteConfig?;
     server: McpServer;
-    constructor(steppers: AStepper[], world: TWorld, remoteConfig?: RemoteExecutorConfig);
+    httpPrompterClient?: HttpPrompterClient;
+    private samplingInterval?;
+    private _isRunning;
+    get isRunning(): boolean;
+    constructor(steppers: AStepper[], world: TWorld, remoteConfig?: IRemoteExecutorConfig);
     start(): Promise<void>;
     registerSteppers(): void;
+    registerPromptTools(): void;
     private createToolHandler;
     private executeViaRemoteApi;
+    startPromptSampling(): void;
+    stopPromptSampling(): void;
 }
 export {};
 //# sourceMappingURL=mcp-executor-server.d.ts.map

package/build/lib/mcp-executor-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-executor-server.d.ts","sourceRoot":"","sources":["../../src/lib/mcp-executor-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAGxD,OAAO,EAAE,MAAM,EAA6B,MAAM,0BAA0B,CAAC;AAM7E,UAAU,oBAAoB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,iBAAiB;IAEjB,OAAO,CAAC,QAAQ;IAAc,OAAO,CAAC,KAAK;IAAU,OAAO,CAAC,YAAY,CAAC;IADtF,MAAM,EAAE,SAAS,CAAC;gBACE,QAAQ,EAAE,QAAQ,EAAE,EAAU,KAAK,EAAE,MAAM,EAAU,YAAY,CAAC,EAAE,oBAAoB;IAEtG,KAAK;IAeX,gBAAgB;IA8BhB,OAAO,CAAC,iBAAiB;YA+CX,mBAAmB;CAyCjC"}
+{"version":3,"file":"mcp-executor-server.d.ts","sourceRoot":"","sources":["../../src/lib/mcp-executor-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,OAAO,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAGxD,OAAO,EAAE,MAAM,EAA6B,MAAM,0BAA0B,CAAC;AAG7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAI/D,KAAK,qBAAqB,GAAG;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,qBAAa,iBAAiB;IAUjB,OAAO,CAAC,QAAQ;IAAc,OAAO,CAAC,KAAK;IAAU,OAAO,CAAC,YAAY,CAAC;IATtF,MAAM,EAAE,SAAS,CAAC;IAClB,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,OAAO,CAAC,gBAAgB,CAAC,CAAiB;IAC1C,OAAO,CAAC,UAAU,CAAkB;IAEpC,IAAI,SAAS,IAAI,OAAO,CAEvB;gBAEmB,QAAQ,EAAE,QAAQ,EAAE,EAAU,KAAK,EAAE,MAAM,EAAU,YAAY,CAAC,EAAE,qBAAqB;IASvG,KAAK;IAgCX,gBAAgB;IA+BhB,mBAAmB;IAsFnB,OAAO,CAAC,iBAAiB;YAoDX,mBAAmB;IAgDjC,mBAAmB;IAInB,kBAAkB;CAGlB"}

package/build/lib/mcp-executor-server.js

@@ -5,26 +5,56 @@ import { namedInterpolation } from "@haibun/core/lib/namedVars.js";
 import { currentVersion as version } from '@haibun/core/currentVersion.js';
 import { constructorName } from "@haibun/core/lib/util/index.js";
 import { resolveAndExecuteStatement } from "@haibun/core/lib/util/resolveAndExecuteStatement.js";
+import { HttpPrompterClient } from './http-prompter-client.js';
 export class MCPExecutorServer {
     steppers;
     world;
     remoteConfig;
     server;
+    httpPrompterClient;
+    samplingInterval;
+    _isRunning = false;
+    get isRunning() {
+        return this._isRunning;
+    }
     constructor(steppers, world, remoteConfig) {
         this.steppers = steppers;
         this.world = world;
         this.remoteConfig = remoteConfig;
+        // Log the execution mode
+        if (remoteConfig) {
+            this.world.logger.log(`🔗 MCPExecutorServer: Remote execution mode - connecting to ${remoteConfig.url}`);
+        }
+        else {
+            this.world.logger.log(`🏠 MCPExecutorServer: Local execution mode`);
+        }
     }
     async start() {
+        this._isRunning = true;
         this.server = new McpServer({
             name: "haibun-mcp",
             version,
             capabilities: {
                 resources: {},
                 tools: {},
+                sampling: {
+                    enabled: true
+                }
             },
         });
+        // Initialize HTTP prompter client for debug prompt access
+        if (!this.remoteConfig?.url) {
+            this.world.logger.warn(`⚠️  MCPExecutorServer: No remote config URL provided - debug prompt tools will not be available`);
+            this.httpPrompterClient = undefined;
+        }
+        else {
+            this.httpPrompterClient = new HttpPrompterClient(this.remoteConfig.url, this.remoteConfig.accessToken);
+            this.world.logger.log(`🤖 MCPExecutorServer: HTTP prompter client initialized for debugging with URL ${this.remoteConfig.url}`);
+            // Prompt notifications now handled by MCPClientPrompter - no sampling needed
+            this.startPromptSampling();
+        }
         this.registerSteppers();
+        this.registerPromptTools();
         const transport = new StdioServerTransport();
         await this.server.connect(transport);
     }
@@ -53,11 +83,99 @@ export class MCPExecutorServer {
             }
         }
     }
+    registerPromptTools() {
+        // Tool to list pending debug prompts
+        this.server.registerTool('listDebugPrompts', {
+            description: 'List all pending debug prompts',
+            title: 'List Debug Prompts'
+        }, async () => {
+            if (!this.httpPrompterClient) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'HttpPrompterClient not initialized - no remote config URL provided',
+                                prompts: [],
+                                count: 0
+                            }, null, 2)
+                        }]
+                };
+            }
+            const prompts = await this.httpPrompterClient.getPrompts();
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            prompts,
+                            count: prompts.length,
+                            message: prompts.length > 0 ?
+                                `Found ${prompts.length} pending debug prompt(s)` :
+                                'No pending debug prompts'
+                        }, null, 2)
+                    }]
+            };
+        });
+        // Tool to respond to debug prompts
+        this.server.registerTool('respondToDebugPrompt', {
+            description: 'Respond to a debug prompt to continue execution',
+            title: 'Respond to Debug Prompt',
+            inputSchema: {
+                promptId: z.string(),
+                response: z.string()
+            }
+        }, async (input) => {
+            if (!this.httpPrompterClient) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: 'HttpPrompterClient not initialized - no remote config URL provided',
+                                promptId: input.promptId
+                            }, null, 2)
+                        }]
+                };
+            }
+            try {
+                const result = await this.httpPrompterClient.respondToPrompt(input.promptId, input.response);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: true,
+                                promptId: input.promptId,
+                                response: input.response,
+                                result,
+                                message: `Debug prompt ${input.promptId} resolved with: "${input.response}"`
+                            }, null, 2)
+                        }]
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                success: false,
+                                error: errorMessage,
+                                promptId: input.promptId
+                            }, null, 2)
+                        }]
+                };
+            }
+        });
+    }
     createToolHandler(stepperName, stepName, stepDef) {
         return async (input) => {
             try {
                 let statement = stepDef.gwta || stepDef.exact || stepDef.match?.toString();
                 if (stepDef.gwta && Object.keys(input).length > 0) {
+                    // First, handle optional parts like ( empty)?
+                    // Remove optional parts that are not used (for now, just remove all optional parts)
+                    statement = statement.replace(/\([^)]*\)\?/g, '');
+                    // Then replace the named variables
                     for (const [key, value] of Object.entries(input)) {
                         const pattern = new RegExp(`\\{${key}(:[^}]*)?\\}`, 'g');
                         statement = statement.replace(pattern, String(value));
@@ -102,6 +220,10 @@ export class MCPExecutorServer {
         };
         if (this.remoteConfig.accessToken) {
             headers.Authorization = `Bearer ${this.remoteConfig.accessToken}`;
+            this.world.logger.log(`🔐 MCPExecutorServer: Using access token for authentication`);
+        }
+        else {
+            this.world.logger.warn(`⚠️  MCPExecutorServer: No access token available for remote API call`);
         }
         const maxRetries = 3;
         const retryDelay = 1000;
@@ -125,10 +247,19 @@ export class MCPExecutorServer {
                     throw new Error(`Remote execution failed after ${maxRetries} attempts: ${errorMessage}`);
                 }
                 // Log retry attempt and wait before retrying
-                console.warn(`Remote execution attempt ${attempt} failed: ${errorMessage}. Retrying in ${retryDelay}ms...`);
+                this.world.logger.warn(`Remote execution attempt ${attempt} failed: ${errorMessage}. Retrying in ${retryDelay}ms...`);
                 await new Promise(resolve => setTimeout(resolve, retryDelay));
             }
         }
     }
+    // REMOVED: Redundant prompt sampling system
+    // Prompt notifications are now handled by MCPClientPrompter's showPrompt/hidePrompt methods
+    // This provides real-time notifications without polling overhead
+    startPromptSampling() {
+        this.world.logger.log('📡 MCP: Prompt notifications handled by MCPClientPrompter - no polling needed');
+    }
+    stopPromptSampling() {
+        this.world.logger.log('📡 MCP: No prompt sampling to stop - using real-time notifications');
+    }
 }
 //# sourceMappingURL=mcp-executor-server.js.map

package/build/lib/mcp-executor-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-executor-server.js","sourceRoot":"","sources":["../../src/lib/mcp-executor-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-executor-server.js","sourceRoot":"","sources":["../../src/lib/mcp-executor-server.ts"],"names":[],"mappings":"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"}

package/build/mcp-client-stepper.d.ts

@@ -2,18 +2,18 @@ import { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { BasePromptManager } from '@haibun/core/lib/base-prompt-manager.js';
 import { AStepper, IHasCycles, IHasOptions } from '@haibun/core/lib/astepper.js';
-import { TWorld, TNamed, TFeatureStep, IStepperCycles } from '@haibun/core/lib/defs.js';
+import { TWorld, TNamed, IStepperCycles } from '@haibun/core/lib/defs.js';
 import { TPrompt, TPromptResponse } from '@haibun/core/lib/prompter.js';
 declare class MCPClientPrompter extends BasePromptManager {
-    private serverParameters;
-    private client?;
-    private isConnected;
-    constructor(serverParameters: StdioServerParameters);
+    private getClient;
+    private getConnectionStatus;
+    constructor(getClient: () => Client | undefined, getConnectionStatus: () => boolean);
     protected showPrompt(prompt: TPrompt): void;
     protected hidePrompt(id: string): void;
-    private ensureConnection;
     prompt(prompt: TPrompt): Promise<TPromptResponse>;
     close(): Promise<void>;
+    notifyPromptShown(prompt: TPrompt): void;
+    notifyPromptHidden(id: string): void;
 }
 declare class MCPClientStepper extends AStepper implements IHasOptions, IHasCycles {
     static SERVER: string;
@@ -58,26 +58,37 @@ declare class MCPClientStepper extends AStepper implements IHasOptions, IHasCycl
     mcpPrompter?: MCPClientPrompter;
     setWorld(world: TWorld, steppers: AStepper[]): Promise<void>;
     private ensureConnection;
+    getClient(): Promise<Client | undefined>;
+    private fetchDebugPrompts;
+    private checkAndNotifyExistingPrompts;
     steps: {
-        registerMcpPrompter: {
+        checkAndNotifyExistingPrompts: {
             gwta: string;
-            action: (named: TNamed, featureStep: TFeatureStep) => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
+            action: () => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
         };
-        unregisterMcpPrompter: {
+        testRealTimeNotifications: {
             gwta: string;
-            action: (named: TNamed, featureStep: TFeatureStep) => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
+            action: () => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
         };
         listMcpTools: {
             gwta: string;
-            action: (named: TNamed, featureStep: TFeatureStep) => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
+            action: () => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
+        };
+        listDebugPrompts: {
+            gwta: string;
+            action: () => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
+        };
+        respondToDebugPrompt: {
+            gwta: string;
+            action: ({ promptId, response }: TNamed) => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
         };
         promptViaMcp: {
             gwta: string;
-            action: ({ message, options }: TNamed, featureStep: TFeatureStep) => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
+            action: ({ message, options }: TNamed) => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
         };
         promptViaMcpWithContext: {
             gwta: string;
-            action: ({ message, context, options }: TNamed, featureStep: TFeatureStep) => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
+            action: ({ message, context, options }: TNamed) => Promise<import("@haibun/core/lib/defs.js").TOKActionResult | import("@haibun/core/lib/defs.js").TNotOKActionResult>;
         };
     };
 }