@haibun/mcp 1.67.0

package/README.md

@@ -0,0 +1,164 @@
+# Haibun MCP Module
+
+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:
+
+```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:
+
+```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"
+  }'
+```
+
+### Starting an MCP Server
+
+The MCP Server is a Haibun stepper. For a basic example with representative steppers:
+
+```bash
+# Basic local execution
+HAIBUN_O_WEBPLAYWRIGHT_STORAGE=StorageMem \
+node modules/cli/build/cli.js --cwd modules/mcp/runtime local
+```
+
+Or with remote execution enabled:
+
+```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
+```
+
+### 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.
+```
+
+## MCP Client
+
+The **MCP Client** allows Haibun features to connect to external MCP servers and discover their available tools.
+
+### Client Usage from Haibun Features
+```gherkin
+Feature: External MCP Integration
+  Scenario: List tools from external server
+    When I list mcp tools
+
+    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\": {}}"
+  }
+}
+```
+
+## Examples
+
+## 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

package/build/example-usage.d.ts

@@ -0,0 +1,9 @@
+import { Prompter } from '@haibun/core/build/lib/prompter.js';
+/**
+ * Example of how to add an MCP client as a subscriber to handle prompts.
+ * This allows external MCP servers to respond to interactive prompts in Haibun.
+ */
+declare const prompter: Prompter;
+declare const mcpPrompter: import("./mcp-client-prompter.js").MCPClientPrompter;
+export { prompter, mcpPrompter };
+//# sourceMappingURL=example-usage.d.ts.map

package/build/example-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-usage.d.ts","sourceRoot":"","sources":["../src/example-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAG9D;;;GAGG;AAGH,QAAA,MAAM,QAAQ,UAAiB,CAAC;AAIhC,QAAA,MAAM,WAAW,sDAKhB,CAAC;AAwBF,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}

package/build/example-usage.js

@@ -0,0 +1,34 @@
+import { Prompter } from '@haibun/core/build/lib/prompter.js';
+import { createMCPClientPrompter } from './mcp-client-prompter.js';
+/**
+ * Example of how to add an MCP client as a subscriber to handle prompts.
+ * This allows external MCP servers to respond to interactive prompts in Haibun.
+ */
+// Create a prompter instance
+const prompter = new Prompter();
+// Create an MCP client prompter that connects to an MCP server
+// The MCP server should implement a tool called "PromptHandler-handlePrompt"
+const mcpPrompter = createMCPClientPrompter('node', // Command to run the MCP server
+['path/to/your/mcp-server.js'], // Arguments for the MCP server
+{}, // Environment variables
+'haibun-prompt-client' // Client name
+);
+// Subscribe the MCP client as a prompter
+prompter.subscribe(mcpPrompter);
+// Now when prompter.prompt() is called, it will try the MCP client first,
+// and if that fails or returns undefined, it will fall back to other prompters
+// like the ReadlinePrompter
+// Example usage:
+async function examplePrompt() {
+    const response = await prompter.prompt({
+        message: "Please select an option",
+        options: ["Yes", "No", "Cancel"]
+    });
+    console.log("User response:", response);
+}
+// Clean up when done
+process.on('exit', () => {
+    mcpPrompter.close();
+});
+export { prompter, mcpPrompter };
+//# sourceMappingURL=example-usage.js.map

package/build/example-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-usage.js","sourceRoot":"","sources":["../src/example-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;GAGG;AAEH,6BAA6B;AAC7B,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;AAEhC,+DAA+D;AAC/D,6EAA6E;AAC7E,MAAM,WAAW,GAAG,uBAAuB,CAC1C,MAAM,EAAG,gCAAgC;AACzC,CAAC,4BAA4B,CAAC,EAAG,+BAA+B;AAChE,EAAE,EAAG,wBAAwB;AAC7B,sBAAsB,CAAE,cAAc;CACtC,CAAC;AAEF,yCAAyC;AACzC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;AAEhC,0EAA0E;AAC1E,+EAA+E;AAC/E,4BAA4B;AAE5B,iBAAiB;AACjB,KAAK,UAAU,aAAa;IAC3B,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACtC,OAAO,EAAE,yBAAyB;QAClC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC;KAChC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,qBAAqB;AACrB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;IACvB,WAAW,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}

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

@@ -0,0 +1,20 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { AStepper } from "@haibun/core/build/lib/astepper.js";
+import { TWorld } from "@haibun/core/build/lib/defs.js";
+interface RemoteExecutorConfig {
+    url: string;
+    accessToken?: string;
+}
+export declare class MCPExecutorServer {
+    private steppers;
+    private world;
+    private remoteConfig?;
+    server: McpServer;
+    constructor(steppers: AStepper[], world: TWorld, remoteConfig?: RemoteExecutorConfig);
+    start(): Promise<void>;
+    registerSteppers(): void;
+    private createToolHandler;
+    private executeViaRemoteApi;
+}
+export {};
+//# sourceMappingURL=mcp-executor-server.d.ts.map

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

@@ -0,0 +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,oCAAoC,CAAC;AAG9D,OAAO,EAAE,MAAM,EAA6B,MAAM,gCAAgC,CAAC;AAMnF,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"}

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

@@ -0,0 +1,134 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { namedInterpolation } from "@haibun/core/build/lib/namedVars.js";
+import { currentVersion as version } from '@haibun/core/build/currentVersion.js';
+import { constructorName } from "@haibun/core/build/lib/util/index.js";
+import { resolveAndExecuteStatement } from "@haibun/core/build/lib/util/resolveAndExecuteStatement.js";
+export class MCPExecutorServer {
+    steppers;
+    world;
+    remoteConfig;
+    server;
+    constructor(steppers, world, remoteConfig) {
+        this.steppers = steppers;
+        this.world = world;
+        this.remoteConfig = remoteConfig;
+    }
+    async start() {
+        this.server = new McpServer({
+            name: "haibun-mcp",
+            version,
+            capabilities: {
+                resources: {},
+                tools: {},
+            },
+        });
+        this.registerSteppers();
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+    }
+    registerSteppers() {
+        for (const stepper of this.steppers) {
+            const stepperName = constructorName(stepper);
+            for (const [stepName, stepDef] of Object.entries(stepper.steps)) {
+                const variables = {};
+                if (stepDef.gwta) {
+                    const { stepVariables } = namedInterpolation(stepDef.gwta);
+                    if (Array.isArray(stepVariables)) {
+                        for (const v of stepVariables) {
+                            variables[v.name] = v.type === 'number' ? z.number() : z.string();
+                        }
+                    }
+                }
+                const toolDescription = {
+                    description: stepName,
+                    title: (stepDef.gwta || stepDef.match?.toString() || stepDef.exact || stepName),
+                };
+                if (Object.keys(variables).length > 0) {
+                    toolDescription.inputSchema = variables;
+                }
+                const toolName = `${stepperName}-${stepName}`;
+                this.server.registerTool(toolName, toolDescription, this.createToolHandler(stepperName, stepName, stepDef));
+            }
+        }
+    }
+    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) {
+                    for (const [key, value] of Object.entries(input)) {
+                        const pattern = new RegExp(`\\{${key}(:[^}]*)?\\}`, 'g');
+                        statement = statement.replace(pattern, String(value));
+                    }
+                }
+                const stepResult = this.remoteConfig
+                    ? await this.executeViaRemoteApi(statement, `/mcp/${stepperName}-${stepName}`)
+                    : await resolveAndExecuteStatement(statement, `/mcp/${stepperName}-${stepName}`, this.steppers, this.world);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                stepName,
+                                stepperName,
+                                input,
+                                result: stepResult,
+                                success: stepResult.ok !== false
+                            }, null, 2)
+                        }]
+                };
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                stepName,
+                                stepperName,
+                                input,
+                                error: errorMessage,
+                                success: false
+                            }, null, 2)
+                        }]
+                };
+            }
+        };
+    }
+    async executeViaRemoteApi(statement, source) {
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (this.remoteConfig.accessToken) {
+            headers.Authorization = `Bearer ${this.remoteConfig.accessToken}`;
+        }
+        const maxRetries = 3;
+        const retryDelay = 1000;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                const response = await fetch(`${this.remoteConfig.url}/execute-step`, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify({ statement, source })
+                });
+                if (!response.ok) {
+                    const errorText = await response.text();
+                    throw new Error(`Remote execution failed: ${response.status} ${errorText}`);
+                }
+                const responseData = await response.json();
+                return responseData;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                if (attempt === maxRetries) {
+                    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...`);
+                await new Promise(resolve => setTimeout(resolve, retryDelay));
+            }
+        }
+    }
+}
+//# sourceMappingURL=mcp-executor-server.js.map

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

@@ -0,0 +1 @@
+{"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-prompter.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-client-prompter.d.ts.map

package/build/mcp-client-prompter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client-prompter.d.ts","sourceRoot":"","sources":["../src/mcp-client-prompter.ts"],"names":[],"mappings":""}

package/build/mcp-client-prompter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-client-prompter.js.map

package/build/mcp-client-prompter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client-prompter.js","sourceRoot":"","sources":["../src/mcp-client-prompter.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,85 @@
+import { StdioServerParameters } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { BasePromptManager } from '@haibun/core/build/lib/base-prompt-manager.js';
+import { AStepper, IHasCycles, IHasOptions } from '@haibun/core/build/lib/astepper.js';
+import { TWorld, TNamed, TFeatureStep, IStepperCycles } from '@haibun/core/build/lib/defs.js';
+import { TPrompt, TPromptResponse } from '@haibun/core/build/lib/prompter.js';
+declare class MCPClientPrompter extends BasePromptManager {
+    private serverParameters;
+    private client?;
+    private isConnected;
+    constructor(serverParameters: StdioServerParameters);
+    protected showPrompt(prompt: TPrompt): void;
+    protected hidePrompt(id: string): void;
+    private ensureConnection;
+    prompt(prompt: TPrompt): Promise<TPromptResponse>;
+    close(): Promise<void>;
+}
+declare class MCPClientStepper extends AStepper implements IHasOptions, IHasCycles {
+    static SERVER: string;
+    cycles: IStepperCycles;
+    options: {
+        [MCPClientStepper.SERVER]: {
+            desc: string;
+            parse: (input: string) => {
+                parseError: string;
+                result?: undefined;
+            } | {
+                result: string;
+                parseError?: undefined;
+            };
+        };
+    };
+    serverParameters: StdioServerParameters;
+    client?: Client<{
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+                progressToken?: string | number;
+            };
+        };
+    }, {
+        method: string;
+        params?: {
+            [x: string]: unknown;
+            _meta?: {
+                [x: string]: unknown;
+            };
+        };
+    }, {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+        };
+    }>;
+    isConnected: boolean;
+    mcpPrompter?: MCPClientPrompter;
+    setWorld(world: TWorld, steppers: AStepper[]): Promise<void>;
+    private ensureConnection;
+    steps: {
+        registerMcpPrompter: {
+            gwta: string;
+            action: (named: TNamed, featureStep: TFeatureStep) => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult | import("@haibun/core/build/lib/defs.js").TNotOKActionResult>;
+        };
+        unregisterMcpPrompter: {
+            gwta: string;
+            action: (named: TNamed, featureStep: TFeatureStep) => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult | import("@haibun/core/build/lib/defs.js").TNotOKActionResult>;
+        };
+        listMcpTools: {
+            gwta: string;
+            action: (named: TNamed, featureStep: TFeatureStep) => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult | import("@haibun/core/build/lib/defs.js").TNotOKActionResult>;
+        };
+        promptViaMcp: {
+            gwta: string;
+            action: ({ message, options }: TNamed, featureStep: TFeatureStep) => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult | import("@haibun/core/build/lib/defs.js").TNotOKActionResult>;
+        };
+        promptViaMcpWithContext: {
+            gwta: string;
+            action: ({ message, context, options }: TNamed, featureStep: TFeatureStep) => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult | import("@haibun/core/build/lib/defs.js").TNotOKActionResult>;
+        };
+    };
+}
+export default MCPClientStepper;
+//# sourceMappingURL=mcp-client-stepper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client-stepper.d.ts","sourceRoot":"","sources":["../src/mcp-client-stepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AACxG,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAI9F,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE9E,cAAM,iBAAkB,SAAQ,iBAAiB;IAIpC,OAAO,CAAC,gBAAgB;IAHpC,OAAO,CAAC,MAAM,CAAC,CAAwB;IACvC,OAAO,CAAC,WAAW,CAAS;gBAER,gBAAgB,EAAE,qBAAqB;IAI3D,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAC3C,SAAS,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;YAExB,gBAAgB;IAWxB,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAqCjD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO5B;AAiBD,cAAM,gBAAiB,SAAQ,QAAS,YAAW,WAAW,EAAE,UAAU;IACzE,MAAM,CAAC,MAAM,SAAY;IACzB,MAAM,iBAAgB;IACtB,OAAO;QACN,CAAC,gBAAgB,CAAC,MAAM,CAAC;;2BAET,MAAM;;;;;;;UACrB;MACD;IACD,gBAAgB,EAAE,qBAAqB,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE;gBAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;gBAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;aAAE,CAAC;SAAE,CAAC;KAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;YAAC,KAAK,CAAC,EAAE;gBAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;aAAE,CAAC;SAAE,CAAC;KAAE,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE;YAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;SAAE,CAAC;KAAE,CAAC,CAAC;IACvS,WAAW,UAAS;IACpB,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE;YAUpC,gBAAgB;IAW9B,KAAK;;;4BAGmB,MAAM,eAAe,YAAY;;;;4BAmBjC,MAAM,eAAe,YAAY;;;;4BAoBjC,MAAM,eAAe,YAAY;;;;2CAelB,MAAM,eAAe,YAAY;;;;oDAoDxB,MAAM,eAAe,YAAY;;MA0DhF;CACD;AAED,eAAe,gBAAgB,CAAC"}

package/build/mcp-client-stepper.js

@@ -0,0 +1,280 @@
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { BasePromptManager } from '@haibun/core/build/lib/base-prompt-manager.js';
+import { AStepper } from '@haibun/core/build/lib/astepper.js';
+import { actionNotOK, actionOK, getStepperOption, stringOrError } from '@haibun/core/build/lib/util/index.js';
+import { currentVersion as version } from '@haibun/core/build/currentVersion.js';
+import { EExecutionMessageType } from '@haibun/core/build/lib/interfaces/logger.js';
+class MCPClientPrompter extends BasePromptManager {
+    serverParameters;
+    client;
+    isConnected = false;
+    constructor(serverParameters) {
+        super();
+        this.serverParameters = serverParameters;
+    }
+    showPrompt(prompt) { }
+    hidePrompt(id) { }
+    async ensureConnection() {
+        if (this.isConnected && this.client) {
+            return;
+        }
+        this.client = new Client({ name: "haibun-mcp-prompter", version });
+        const transport = new StdioClientTransport(this.serverParameters);
+        await this.client.connect(transport);
+        this.isConnected = true;
+    }
+    async prompt(prompt) {
+        try {
+            await this.ensureConnection();
+            if (!this.client) {
+                return undefined;
+            }
+            const result = await this.client.callTool({
+                name: 'handlePrompt',
+                arguments: {
+                    message: prompt.message,
+                    context: prompt.context ? JSON.stringify(prompt.context) : undefined,
+                    options: prompt.options || []
+                }
+            });
+            if (result.content && Array.isArray(result.content) && result.content.length > 0) {
+                const content = result.content[0];
+                if (content.type === 'text') {
+                    try {
+                        const responseData = JSON.parse(content.text);
+                        return responseData.response;
+                    }
+                    catch {
+                        return content.text;
+                    }
+                }
+            }
+            return undefined;
+        }
+        catch (error) {
+            console.debug(`MCP prompter failed: ${error}`);
+            return undefined;
+        }
+    }
+    async close() {
+        if (this.client && this.isConnected) {
+            await this.client.close();
+            this.isConnected = false;
+            this.client = undefined;
+        }
+    }
+}
+const cycles = (mcs) => ({
+    async endFeature() {
+        if (mcs.client && mcs.isConnected) {
+            await this.client.close();
+            mcs.isConnected = false;
+            mcs.client = undefined;
+        }
+        if (mcs.mcpPrompter) {
+            await mcs.mcpPrompter.close();
+            mcs.mcpPrompter = undefined;
+        }
+    }
+});
+class MCPClientStepper extends AStepper {
+    static SERVER = 'SERVER';
+    cycles = cycles(this);
+    options = {
+        [MCPClientStepper.SERVER]: {
+            desc: `MCP server to start (stdio)`,
+            parse: (input) => stringOrError(input)
+        },
+    };
+    serverParameters;
+    client;
+    isConnected = false;
+    mcpPrompter;
+    async setWorld(world, steppers) {
+        await super.setWorld(world, steppers);
+        const serverJson = getStepperOption(this, MCPClientStepper.SERVER, this.world.moduleOptions);
+        try {
+            this.serverParameters = JSON.parse(serverJson);
+        }
+        catch (e) {
+            throw new Error(`Failed to parse ${MCPClientStepper.SERVER} option: ${e}`);
+        }
+    }
+    async ensureConnection() {
+        if (this.isConnected && this.client) {
+            return;
+        }
+        this.client = new Client({ name: "haibun-mcp-client", version });
+        const transport = new StdioClientTransport(this.serverParameters);
+        await this.client.connect(transport);
+        this.isConnected = true;
+    }
+    steps = {
+        registerMcpPrompter: {
+            gwta: `register mcp prompter`,
+            action: async (named, featureStep) => {
+                try {
+                    if (!this.mcpPrompter) {
+                        this.mcpPrompter = new MCPClientPrompter(this.serverParameters);
+                        this.world.prompter.subscribe(this.mcpPrompter);
+                    }
+                    const messageContext = {
+                        incident: EExecutionMessageType.ACTION,
+                        incidentDetails: { registered: true }
+                    };
+                    return actionOK({ messageContext });
+                }
+                catch (e) {
+                    console.error(e);
+                    return actionNotOK(`Failed to register MCP prompter: ${e}`);
+                }
+            }
+        },
+        unregisterMcpPrompter: {
+            gwta: `unregister mcp prompter`,
+            action: async (named, featureStep) => {
+                try {
+                    if (this.mcpPrompter) {
+                        this.world.prompter.unsubscribe(this.mcpPrompter);
+                        await this.mcpPrompter.close();
+                        this.mcpPrompter = undefined;
+                    }
+                    const messageContext = {
+                        incident: EExecutionMessageType.ACTION,
+                        incidentDetails: { unregistered: true }
+                    };
+                    return actionOK({ messageContext });
+                }
+                catch (e) {
+                    console.error(e);
+                    return actionNotOK(`Failed to unregister MCP prompter: ${e}`);
+                }
+            }
+        },
+        listMcpTools: {
+            gwta: `list mcp tools`,
+            action: async (named, featureStep) => {
+                try {
+                    await this.ensureConnection();
+                    const toolsResult = await this.client.listTools();
+                    const tools = Array.isArray(toolsResult) ? toolsResult : (toolsResult.tools || []);
+                    const messageContext = { incident: EExecutionMessageType.ACTION, incidentDetails: { tools } };
+                    return actionOK({ messageContext });
+                }
+                catch (e) {
+                    console.error(e);
+                    return actionNotOK(`Failed to list MCP tools: ${e}`);
+                }
+            }
+        },
+        promptViaMcp: {
+            gwta: `prompt via mcp {message} with options {options}`,
+            action: async ({ message, options }, featureStep) => {
+                try {
+                    await this.ensureConnection();
+                    const prompt = {
+                        id: 'test-' + Math.random().toString(36).slice(2),
+                        message,
+                        options: options ? options.split(',').map(o => o.trim()) : undefined
+                    };
+                    // Try to call a prompt handling tool on the MCP server
+                    const result = await this.client.callTool({
+                        name: 'handlePrompt',
+                        arguments: {
+                            message: prompt.message,
+                            context: prompt.context ? JSON.stringify(prompt.context) : undefined,
+                            options: prompt.options || []
+                        }
+                    });
+                    // Parse the response from the MCP tool
+                    if (result.content && Array.isArray(result.content) && result.content.length > 0) {
+                        const content = result.content[0];
+                        if (content.type === 'text') {
+                            try {
+                                const responseData = JSON.parse(content.text);
+                                const messageContext = {
+                                    incident: EExecutionMessageType.ACTION,
+                                    incidentDetails: { response: responseData.response }
+                                };
+                                return actionOK({ messageContext });
+                            }
+                            catch {
+                                // If parsing fails, return the text directly
+                                const messageContext = {
+                                    incident: EExecutionMessageType.ACTION,
+                                    incidentDetails: { response: content.text }
+                                };
+                                return actionOK({ messageContext });
+                            }
+                        }
+                    }
+                    return actionNotOK('No response received from MCP server');
+                }
+                catch (e) {
+                    console.error(e);
+                    return actionNotOK(`Failed to prompt via MCP: ${e}`);
+                }
+            }
+        },
+        promptViaMcpWithContext: {
+            gwta: `prompt via mcp {message} with context {context} and options {options}`,
+            action: async ({ message, context, options }, featureStep) => {
+                try {
+                    await this.ensureConnection();
+                    let parsedContext;
+                    try {
+                        parsedContext = JSON.parse(context);
+                    }
+                    catch {
+                        parsedContext = context;
+                    }
+                    const prompt = {
+                        id: 'test-' + Math.random().toString(36).slice(2),
+                        message,
+                        context: parsedContext,
+                        options: options ? options.split(',').map(o => o.trim()) : undefined
+                    };
+                    // Try to call a prompt handling tool on the MCP server
+                    const result = await this.client.callTool({
+                        name: 'handlePrompt',
+                        arguments: {
+                            message: prompt.message,
+                            context: JSON.stringify(prompt.context),
+                            options: prompt.options || []
+                        }
+                    });
+                    // Parse the response from the MCP tool
+                    if (result.content && Array.isArray(result.content) && result.content.length > 0) {
+                        const content = result.content[0];
+                        if (content.type === 'text') {
+                            try {
+                                const responseData = JSON.parse(content.text);
+                                const messageContext = {
+                                    incident: EExecutionMessageType.ACTION,
+                                    incidentDetails: { response: responseData.response }
+                                };
+                                return actionOK({ messageContext });
+                            }
+                            catch {
+                                // If parsing fails, return the text directly
+                                const messageContext = {
+                                    incident: EExecutionMessageType.ACTION,
+                                    incidentDetails: { response: content.text }
+                                };
+                                return actionOK({ messageContext });
+                            }
+                        }
+                    }
+                    return actionNotOK('No response received from MCP server');
+                }
+                catch (e) {
+                    console.error(e);
+                    return actionNotOK(`Failed to prompt via MCP: ${e}`);
+                }
+            }
+        }
+    };
+}
+export default MCPClientStepper;
+//# sourceMappingURL=mcp-client-stepper.js.map

package/build/mcp-client-stepper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client-stepper.js","sourceRoot":"","sources":["../src/mcp-client-stepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAyB,MAAM,2CAA2C,CAAC;AACxG,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,QAAQ,EAA2B,MAAM,oCAAoC,CAAC;AAEvF,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC9G,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAmB,MAAM,6CAA6C,CAAC;AAGrG,MAAM,iBAAkB,SAAQ,iBAAiB;IAI5B;IAHZ,MAAM,CAAyB;IAC/B,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAoB,gBAAuC;QAC1D,KAAK,EAAE,CAAC;QADW,qBAAgB,GAAhB,gBAAgB,CAAuB;IAE3D,CAAC;IAES,UAAU,CAAC,MAAe,IAAS,CAAC;IACpC,UAAU,CAAC,EAAU,IAAS,CAAC;IAEjC,KAAK,CAAC,gBAAgB;QAC7B,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACrC,OAAO;QACR,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,CAAC,CAAC;QACnE,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAClE,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAe;QAC3B,IAAI,CAAC;YACJ,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAE9B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO,SAAS,CAAC;YAClB,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;gBACzC,IAAI,EAAE,cAAc;gBACpB,SAAS,EAAE;oBACV,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;oBACpE,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;iBAC7B;aACD,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAClF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAClC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBAC7B,IAAI,CAAC;wBACJ,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;wBAC9C,OAAO,YAAY,CAAC,QAAQ,CAAC;oBAC9B,CAAC;oBAAC,MAAM,CAAC;wBACR,OAAO,OAAO,CAAC,IAAI,CAAC;oBACrB,CAAC;gBACF,CAAC;YACF,CAAC;YAED,OAAO,SAAS,CAAC;QAElB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,KAAK,CAAC,wBAAwB,KAAK,EAAE,CAAC,CAAC;YAC/C,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IAED,KAAK,CAAC,KAAK;QACV,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACzB,CAAC;IACF,CAAC;CACD;AAED,MAAM,MAAM,GAAG,CAAC,GAAqB,EAAkB,EAAE,CAAC,CAAC;IAC1D,KAAK,CAAC,UAAU;QACf,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YACnC,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1B,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC;YACxB,GAAG,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,CAAC;QAED,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;YAC9B,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AAEH,MAAM,gBAAiB,SAAQ,QAAQ;IACtC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC;IACzB,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,GAAG;QACT,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE;YAC1B,IAAI,EAAE,6BAA6B;YACnC,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC;SAC9C;KACD,CAAA;IACD,gBAAgB,CAAwB;IACxC,MAAM,CAAiS;IACvS,WAAW,GAAG,KAAK,CAAC;IACpB,WAAW,CAAqB;IAChC,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,QAAoB;QACjD,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC7F,IAAI,CAAC;YACJ,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,mBAAmB,gBAAgB,CAAC,MAAM,YAAY,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,gBAAgB;QAC7B,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACrC,OAAO;QACR,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAClE,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,KAAK,GAAG;QACP,mBAAmB,EAAE;YACpB,IAAI,EAAE,uBAAuB;YAC7B,MAAM,EAAE,KAAK,EAAE,KAAa,EAAE,WAAyB,EAAE,EAAE;gBAC1D,IAAI,CAAC;oBACJ,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;wBACvB,IAAI,CAAC,WAAW,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;wBAChE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;oBACjD,CAAC;oBACD,MAAM,cAAc,GAAoB;wBACvC,QAAQ,EAAE,qBAAqB,CAAC,MAAM;wBACtC,eAAe,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE;qBACrC,CAAA;oBACD,OAAO,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;gBACrC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACZ,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACjB,OAAO,WAAW,CAAC,oCAAoC,CAAC,EAAE,CAAC,CAAC;gBAC7D,CAAC;YACF,CAAC;SACD;QACD,qBAAqB,EAAE;YACtB,IAAI,EAAE,yBAAyB;YAC/B,MAAM,EAAE,KAAK,EAAE,KAAa,EAAE,WAAyB,EAAE,EAAE;gBAC1D,IAAI,CAAC;oBACJ,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;wBACtB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;wBAClD,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;wBAC/B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;oBAC9B,CAAC;oBACD,MAAM,cAAc,GAAoB;wBACvC,QAAQ,EAAE,qBAAqB,CAAC,MAAM;wBACtC,eAAe,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;qBACvC,CAAA;oBACD,OAAO,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;gBACrC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACZ,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACjB,OAAO,WAAW,CAAC,sCAAsC,CAAC,EAAE,CAAC,CAAC;gBAC/D,CAAC;YACF,CAAC;SACD;QACD,YAAY,EAAE;YACb,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,KAAK,EAAE,KAAa,EAAE,WAAyB,EAAE,EAAE;gBAC1D,IAAI,CAAC;oBACJ,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBAC9B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,MAAO,CAAC,SAAS,EAAE,CAAC;oBACnD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;oBACnF,MAAM,cAAc,GAAoB,EAAE,QAAQ,EAAE,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,EAAE,CAAA;oBAC9G,OAAO,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;gBACrC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACZ,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACjB,OAAO,WAAW,CAAC,6BAA6B,CAAC,EAAE,CAAC,CAAC;gBACtD,CAAC;YACF,CAAC;SACD;QACD,YAAY,EAAE;YACb,IAAI,EAAE,iDAAiD;YACvD,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAU,EAAE,WAAyB,EAAE,EAAE;gBACzE,IAAI,CAAC;oBACJ,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBAE9B,MAAM,MAAM,GAAY;wBACvB,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;wBACjD,OAAO;wBACP,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;qBACpE,CAAC;oBAEF,uDAAuD;oBACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAO,CAAC,QAAQ,CAAC;wBAC1C,IAAI,EAAE,cAAc;wBACpB,SAAS,EAAE;4BACV,OAAO,EAAE,MAAM,CAAC,OAAO;4BACvB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;4BACpE,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;yBAC7B;qBACD,CAAC,CAAC;oBAEH,uCAAuC;oBACvC,IAAI,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAClF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;wBAClC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;4BAC7B,IAAI,CAAC;gCACJ,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gCAC9C,MAAM,cAAc,GAAoB;oCACvC,QAAQ,EAAE,qBAAqB,CAAC,MAAM;oCACtC,eAAe,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE;iCACpD,CAAA;gCACD,OAAO,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;4BACrC,CAAC;4BAAC,MAAM,CAAC;gCACR,6CAA6C;gCAC7C,MAAM,cAAc,GAAoB;oCACvC,QAAQ,EAAE,qBAAqB,CAAC,MAAM;oCACtC,eAAe,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE;iCAC3C,CAAA;gCACD,OAAO,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;4BACrC,CAAC;wBACF,CAAC;oBACF,CAAC;oBAED,OAAO,WAAW,CAAC,sCAAsC,CAAC,CAAC;gBAE5D,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACZ,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACjB,OAAO,WAAW,CAAC,6BAA6B,CAAC,EAAE,CAAC,CAAC;gBACtD,CAAC;YACF,CAAC;SACD;QACD,uBAAuB,EAAE;YACxB,IAAI,EAAE,uEAAuE;YAC7E,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAU,EAAE,WAAyB,EAAE,EAAE;gBAClF,IAAI,CAAC;oBACJ,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBAE9B,IAAI,aAAa,CAAC;oBAClB,IAAI,CAAC;wBACJ,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBACrC,CAAC;oBAAC,MAAM,CAAC;wBACR,aAAa,GAAG,OAAO,CAAC;oBACzB,CAAC;oBAED,MAAM,MAAM,GAAY;wBACvB,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;wBACjD,OAAO;wBACP,OAAO,EAAE,aAAa;wBACtB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;qBACpE,CAAC;oBAEF,uDAAuD;oBACvD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAO,CAAC,QAAQ,CAAC;wBAC1C,IAAI,EAAE,cAAc;wBACpB,SAAS,EAAE;4BACV,OAAO,EAAE,MAAM,CAAC,OAAO;4BACvB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;4BACvC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;yBAC7B;qBACD,CAAC,CAAC;oBAEH,uCAAuC;oBACvC,IAAI,MAAM,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAClF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;wBAClC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;4BAC7B,IAAI,CAAC;gCACJ,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gCAC9C,MAAM,cAAc,GAAoB;oCACvC,QAAQ,EAAE,qBAAqB,CAAC,MAAM;oCACtC,eAAe,EAAE,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE;iCACpD,CAAA;gCACD,OAAO,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;4BACrC,CAAC;4BAAC,MAAM,CAAC;gCACR,6CAA6C;gCAC7C,MAAM,cAAc,GAAoB;oCACvC,QAAQ,EAAE,qBAAqB,CAAC,MAAM;oCACtC,eAAe,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE;iCAC3C,CAAA;gCACD,OAAO,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;4BACrC,CAAC;wBACF,CAAC;oBACF,CAAC;oBAED,OAAO,WAAW,CAAC,sCAAsC,CAAC,CAAC;gBAE5D,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACZ,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACjB,OAAO,WAAW,CAAC,6BAA6B,CAAC,EAAE,CAAC,CAAC;gBACtD,CAAC;YACF,CAAC;SACD;KACD,CAAA;;AAGF,eAAe,gBAAgB,CAAC"}

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

@@ -0,0 +1,37 @@
+import { AStepper, IHasOptions } from '@haibun/core/build/lib/astepper.js';
+import { TWorld } from '@haibun/core/build/lib/defs.js';
+import { MCPExecutorServer } from './lib/mcp-executor-server.js';
+declare class MCPServerStepper extends AStepper implements IHasOptions {
+    steppers: AStepper[];
+    mcpServer: MCPExecutorServer;
+    remotePort: number;
+    accessToken: string;
+    options: {
+        REMOTE_PORT: {
+            desc: string;
+            parse: (port: string) => {
+                result: number;
+            };
+        };
+        ACCESS_TOKEN: {
+            desc: string;
+            parse: (token: string) => {
+                result: string;
+            };
+        };
+    };
+    setWorld(world: TWorld, steppers: AStepper[]): Promise<void>;
+    private getRemoteConfig;
+    steps: {
+        startMcpTools: {
+            gwta: string;
+            action: () => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult>;
+        };
+        stopMcpTools: {
+            gwta: string;
+            action: () => Promise<import("@haibun/core/build/lib/defs.js").TOKActionResult | import("@haibun/core/build/lib/defs.js").TNotOKActionResult>;
+        };
+    };
+}
+export default MCPServerStepper;
+//# sourceMappingURL=mcp-server-stepper.d.ts.map

package/build/mcp-server-stepper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server-stepper.d.ts","sourceRoot":"","sources":["../src/mcp-server-stepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAM,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,cAAM,gBAAiB,SAAQ,QAAS,YAAW,WAAW;IAC7D,QAAQ,EAAE,QAAQ,EAAE,CAAC;IACrB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,OAAO;;;0BAGS,MAAM;;;;;;2BAIL,MAAM;;;;MAErB;IAEI,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE;IAYlD,OAAO,CAAC,eAAe;IAWvB,KAAK;;;;;;;;;MAuBJ;CACD;AAED,eAAe,gBAAgB,CAAC"}

package/build/mcp-server-stepper.js

@@ -0,0 +1,64 @@
+import { AStepper } from '@haibun/core/build/lib/astepper.js';
+import { OK } from '@haibun/core/build/lib/defs.js';
+import { actionNotOK, getStepperOption, intOrError } from '@haibun/core/build/lib/util/index.js';
+import { MCPExecutorServer } from './lib/mcp-executor-server.js';
+class MCPServerStepper extends AStepper {
+    steppers;
+    mcpServer;
+    remotePort;
+    accessToken;
+    options = {
+        REMOTE_PORT: {
+            desc: 'Port for remote execution API',
+            parse: (port) => ({ result: parseInt(port, 10) }),
+        },
+        ACCESS_TOKEN: {
+            desc: 'Access token for remote execution API authentication',
+            parse: (token) => ({ result: token }),
+        },
+    };
+    async setWorld(world, steppers) {
+        await super.setWorld(world, steppers);
+        this.steppers = steppers;
+        this.remotePort = intOrError(getStepperOption(this, 'REMOTE_PORT', world.moduleOptions) || '').result || NaN;
+        this.accessToken = getStepperOption(this, 'ACCESS_TOKEN', world.moduleOptions);
+        if (!isNaN(this.remotePort) && !this.accessToken) {
+            throw new Error('ACCESS_TOKEN is required when REMOTE_PORT is configured for remote execution');
+        }
+    }
+    getRemoteConfig() {
+        if (!isNaN(this.remotePort)) {
+            return {
+                url: `http://localhost:${this.remotePort}`,
+                accessToken: this.accessToken
+            };
+        }
+        return undefined;
+    }
+    steps = {
+        startMcpTools: {
+            gwta: `serve mcp tools from steppers`,
+            action: async () => {
+                const remoteConfig = this.getRemoteConfig();
+                this.mcpServer = new MCPExecutorServer(this.steppers, this.world, remoteConfig);
+                void this.mcpServer.start();
+                return Promise.resolve(OK);
+            }
+        },
+        stopMcpTools: {
+            gwta: `stop mcp tools`,
+            action: async () => {
+                if (this.mcpServer) {
+                    await this.mcpServer.server.close();
+                    this.mcpServer = undefined;
+                    return OK;
+                }
+                else {
+                    return actionNotOK('MCP server is not running');
+                }
+            }
+        }
+    };
+}
+export default MCPServerStepper;
+//# sourceMappingURL=mcp-server-stepper.js.map

package/build/mcp-server-stepper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server-stepper.js","sourceRoot":"","sources":["../src/mcp-server-stepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAe,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,EAAE,EAAU,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AACjG,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,gBAAiB,SAAQ,QAAQ;IACtC,QAAQ,CAAa;IACrB,SAAS,CAAoB;IAC7B,UAAU,CAAS;IACnB,WAAW,CAAS;IAEpB,OAAO,GAAG;QACT,WAAW,EAAE;YACZ,IAAI,EAAE,+BAA+B;YACrC,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;SACzD;QACD,YAAY,EAAE;YACb,IAAI,EAAE,sDAAsD;YAC5D,KAAK,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;SAC7C;KACD,CAAC;IAEF,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,QAAoB;QACjD,MAAM,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAEzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;QAC7G,IAAI,CAAC,WAAW,GAAG,gBAAgB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;QAE/E,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;YACjD,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;SAChG;IACF,CAAC;IAEO,eAAe;QACtB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;YAC5B,OAAO;gBACN,GAAG,EAAE,oBAAoB,IAAI,CAAC,UAAU,EAAE;gBAC1C,WAAW,EAAE,IAAI,CAAC,WAAW;aAC7B,CAAC;SACF;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,KAAK,GAAG;QACP,aAAa,EAAE;YACd,IAAI,EAAE,+BAA+B;YACrC,MAAM,EAAE,KAAK,IAAI,EAAE;gBAClB,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;gBAE5C,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;gBAChF,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;gBAC5B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;SACD;QACD,YAAY,EAAE;YACb,IAAI,EAAE,gBAAgB;YACtB,MAAM,EAAE,KAAK,IAAI,EAAE;gBAClB,IAAI,IAAI,CAAC,SAAS,EAAE;oBACnB,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBACpC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;oBAC3B,OAAO,EAAE,CAAC;iBACV;qBAAM;oBACN,OAAO,WAAW,CAAC,2BAA2B,CAAC,CAAC;iBAChD;YACF,CAAC;SACD;KACD,CAAA;CACD;AAED,eAAe,gBAAgB,CAAC"}

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

@@ -0,0 +1,9 @@
+import { AStepper } from '@haibun/core/build/lib/astepper.js';
+import { TStepperStep } from '@haibun/core/build/lib/defs.js';
+declare class TestStepper extends AStepper {
+    steps: {
+        [name: string]: TStepperStep;
+    };
+}
+export default TestStepper;
+//# sourceMappingURL=mcp-test-stepper.d.ts.map

package/build/mcp-test-stepper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-test-stepper.d.ts","sourceRoot":"","sources":["../src/mcp-test-stepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAM,MAAM,gCAAgC,CAAC;AAElE,cAAM,WAAY,SAAQ,QAAQ;IACjC,KAAK,EAAE;QAAE,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;KAAE,CAatC;CACF;AAED,eAAe,WAAW,CAAC"}

package/build/mcp-test-stepper.js

@@ -0,0 +1,20 @@
+import { AStepper } from '@haibun/core/build/lib/astepper.js';
+import { OK } from '@haibun/core/build/lib/defs.js';
+class TestStepper extends AStepper {
+    steps = {
+        yourTestPhrasePasses: {
+            gwta: 'your test phrase passes',
+            action: async () => {
+                return Promise.resolve(OK);
+            },
+        },
+        yourTestPhraseFails: {
+            gwta: 'your test phrase fails',
+            action: async () => {
+                return Promise.resolve(OK);
+            },
+        },
+    };
+}
+export default TestStepper;
+//# sourceMappingURL=mcp-test-stepper.js.map

package/build/mcp-test-stepper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-test-stepper.js","sourceRoot":"","sources":["../src/mcp-test-stepper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAC9D,OAAO,EAAgB,EAAE,EAAE,MAAM,gCAAgC,CAAC;AAElE,MAAM,WAAY,SAAQ,QAAQ;IACjC,KAAK,GAAsC;QAC1C,oBAAoB,EAAE;YACrB,IAAI,EAAE,yBAAyB;YAC/B,MAAM,EAAE,KAAK,IAAI,EAAE;gBAClB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;SACD;QACD,mBAAmB,EAAE;YACpB,IAAI,EAAE,wBAAwB;YAC9B,MAAM,EAAE,KAAK,IAAI,EAAE;gBAClB,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;SACD;KACD,CAAC;CACF;AAED,eAAe,WAAW,CAAC"}

package/build/mcp-test-utils.d.ts

@@ -0,0 +1,12 @@
+export declare const runtimeStdio: (port?: number) => string;
+export declare const TEST_PORTS: {
+    readonly MCP_REMOTE_EXECUTOR: 12300;
+    readonly MCP_REMOTE_EXECUTION: 12310;
+    readonly MCP_CLIENT_LIST_TOOLS: 12342;
+    readonly MCP_CLIENT_PROMPTER: 12341;
+    readonly MCP_TOOL_EXECUTION: 12350;
+    readonly MCP_TOOL_EXECUTION_ALT: 12351;
+    readonly MCP_CLIENT_LIFECYCLE: 12360;
+    readonly MCP_HTTP_PROMPTER_TEST: 12370;
+};
+//# sourceMappingURL=mcp-test-utils.d.ts.map

package/build/mcp-test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-test-utils.d.ts","sourceRoot":"","sources":["../src/mcp-test-utils.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,WAoBzC,CAAA;AAGD,eAAO,MAAM,UAAU;;;;;;;;;CASb,CAAC"}

package/build/mcp-test-utils.js

@@ -0,0 +1,33 @@
+// used to configure the client to start the STUDIO server, which is a Haibun stepper
+export const runtimeStdio = (port) => {
+    const listening = port ? {
+        'HAIBUN_O_HTTPEXECUTORSTEPPER_LISTEN_PORT': port.toString(),
+        'HAIBUN_O_HTTPEXECUTORSTEPPER_ACCESS_TOKEN': 'test-token-client'
+    } : {};
+    const config = {
+        command: process.execPath,
+        env: {
+            'HAIBUN_O_WEBPLAYWRIGHT_STORAGE': 'StorageMem',
+            'HAIBUN_O_WEBPLAYWRIGHT_HEADLESS': 'true',
+            ...listening
+        },
+        args: [
+            "modules/cli/build/cli.js",
+            '--cwd',
+            'modules/mcp/runtime',
+            port ? 'http' : 'local',
+        ],
+    };
+    return JSON.stringify(config, null, 2);
+};
+export const TEST_PORTS = {
+    MCP_REMOTE_EXECUTOR: 12300,
+    MCP_REMOTE_EXECUTION: 12310,
+    MCP_CLIENT_LIST_TOOLS: 12342,
+    MCP_CLIENT_PROMPTER: 12341,
+    MCP_TOOL_EXECUTION: 12350,
+    MCP_TOOL_EXECUTION_ALT: 12351,
+    MCP_CLIENT_LIFECYCLE: 12360,
+    MCP_HTTP_PROMPTER_TEST: 12370,
+};
+//# sourceMappingURL=mcp-test-utils.js.map

package/build/mcp-test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-test-utils.js","sourceRoot":"","sources":["../src/mcp-test-utils.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAa,EAAE,EAAE;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC;QACxB,0CAA0C,EAAE,IAAI,CAAC,QAAQ,EAAE;QAC3D,2CAA2C,EAAE,mBAAmB;KAChE,CAAC,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,MAAM,GAA0B;QACrC,OAAO,EAAE,OAAO,CAAC,QAAQ;QACzB,GAAG,EAAE;YACJ,gCAAgC,EAAE,YAAY;YAC9C,iCAAiC,EAAE,MAAM;YACzC,GAAG,SAAS;SACZ;QACD,IAAI,EAAE;YACL,0BAA0B;YAC1B,OAAO;YACP,qBAAqB;YACrB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;SACvB;KACD,CAAA;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC,CAAA;AAGD,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,mBAAmB,EAAE,KAAK;IAC1B,oBAAoB,EAAE,KAAK;IAC3B,qBAAqB,EAAE,KAAK;IAC5B,mBAAmB,EAAE,KAAK;IAC1B,kBAAkB,EAAE,KAAK;IACzB,sBAAsB,EAAE,KAAK;IAC7B,oBAAoB,EAAE,KAAK;IAC3B,sBAAsB,EAAE,KAAK;CACpB,CAAC"}

package/build/prompt-handler-stepper.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prompt-handler-stepper.d.ts.map

package/build/prompt-handler-stepper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-handler-stepper.d.ts","sourceRoot":"","sources":["../src/prompt-handler-stepper.ts"],"names":[],"mappings":""}

package/build/prompt-handler-stepper.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=prompt-handler-stepper.js.map

package/build/prompt-handler-stepper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-handler-stepper.js","sourceRoot":"","sources":["../src/prompt-handler-stepper.ts"],"names":[],"mappings":""}

package/build/test-constants.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-constants.d.ts.map

package/build/test-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-constants.d.ts","sourceRoot":"","sources":["../src/test-constants.ts"],"names":[],"mappings":""}

package/build/test-constants.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-constants.js.map

package/build/test-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-constants.js","sourceRoot":"","sources":["../src/test-constants.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@haibun/mcp",
+  "type": "module",
+  "version": "1.67.0",
+  "description": "haibun mcp server and client steppers",
+  "main": "build/mcp-server-stepper.js",
+  "files": ["build/**"],
+  "scripts": {
+    "prepublishOnly": "tsc -b .",
+    "build": "tsc -b .",
+    "build-watch": "tsc -b --watch .",
+    "lint": "eslint -c .eslintrc.json --ext .ts,.js src",
+    "preversion": "npm run lint",
+    "test": "vitest run",
+    "test-watch": "vitest"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@haibun/core": "1.67.0",
+    "@modelcontextprotocol/sdk": "^1.13.0",
+    "zod": "^3.25.67"
+  },
+  "devDependencies": {
+    "@haibun/storage-mem": "1.67.0",
+    "@types/node": "^22.14.0",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "eslint": "^8.57.0",
+    "eslint-config-airbnb-typescript": "^18.0.0",
+    "eslint-config-prettier": "^10.1.1",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-prefer-arrow": "^1.2.3",
+    "eslint-plugin-prettier": "^5.2.6",
+    "prettier": "^3.5.3",
+    "typescript": "^5.8.2",
+    "vitest": "^3.1.1"
+  }
+}