@gravitee/apim-mcp-server 0.2.0

package/esm/mcp-server/cli/serve/command.js

@@ -0,0 +1,128 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { buildCommand } from "@stricli/core";
+import { numberParser } from "@stricli/core";
+import * as z from "zod";
+import { ServerProtocol } from "../../../lib/config.js";
+import { consoleLoggerLevels } from "../../console-logger.js";
+import { mcpScopes } from "../../scopes.js";
+export const serveCommand = buildCommand({
+    loader: async () => {
+        const { main } = await import("./impl.js");
+        return main;
+    },
+    parameters: {
+        flags: {
+            port: {
+                kind: "parsed",
+                brief: "The port to listen on for Streamable HTTP connections",
+                default: "2718",
+                parse: (val) => z.coerce.number().int().gte(0).lt(65536).parse(val),
+            },
+            "disable-static-auth": {
+                kind: "boolean",
+                brief: "Disable static authentication, allowing credentials to be passed via request headers only",
+                default: false,
+            },
+            tool: {
+                kind: "parsed",
+                brief: "Specify tools to mount on the server",
+                optional: true,
+                variadic: true,
+                parse: (value) => {
+                    return z.string().parse(value);
+                },
+            },
+            mode: {
+                kind: "enum",
+                brief: "Server mode (dynamic: expose list_tools, describe_tool_input, and execute_tool instead of individual tools)",
+                values: ["dynamic"],
+                optional: true,
+            },
+            "tool-annotations": {
+                kind: "parsed",
+                brief: "Filter tools by annotations (comma-separated: readOnly, destructive, idempotent, openWorld). Listed = required true, unlisted = required false.",
+                optional: true,
+                parse: (value) => value.split(",").map(s => s.trim()),
+            },
+            scope: {
+                kind: "enum",
+                brief: "Mount tools/resources that match given scope (repeatable flag)",
+                values: mcpScopes,
+                variadic: true,
+                optional: true,
+            },
+            "bearer-auth": {
+                kind: "parsed",
+                brief: "Sets the bearerAuth auth field for the API",
+                optional: true,
+                parse: (value) => {
+                    return z.string().parse(value);
+                },
+            },
+            "server-url": {
+                kind: "parsed",
+                brief: "Overrides the default server URL used by the SDK",
+                optional: true,
+                parse: (value) => new URL(value).toString(),
+            },
+            "server-index": {
+                kind: "parsed",
+                brief: "Selects a predefined server used by the SDK",
+                optional: true,
+                parse: numberParser,
+            },
+            protocol: {
+                kind: "enum",
+                brief: "Sets the protocol variable for url substitution",
+                optional: true,
+                values: Object.values(ServerProtocol),
+            },
+            "management-api-host": {
+                kind: "parsed",
+                brief: "Sets the managementAPIHost variable for url substitution",
+                optional: true,
+                parse: (value) => value,
+            },
+            "org-id": {
+                kind: "parsed",
+                brief: "Sets the orgId variable for url substitution",
+                optional: true,
+                parse: (value) => value,
+            },
+            "log-level": {
+                kind: "enum",
+                brief: "The log level to use for the server",
+                default: "info",
+                values: consoleLoggerLevels,
+            },
+            env: {
+                kind: "parsed",
+                brief: "Environment variables made available to the server",
+                optional: true,
+                variadic: true,
+                parse: (val) => {
+                    const sepIdx = val.indexOf("=");
+                    if (sepIdx === -1) {
+                        throw new Error("Invalid environment variable format");
+                    }
+                    const key = val.slice(0, sepIdx);
+                    const value = val.slice(sepIdx + 1);
+                    return [
+                        z.string().nonempty({
+                            message: "Environment variable key must be a non-empty string",
+                        }).parse(key),
+                        z.string().nonempty({
+                            message: "Environment variable value must be a non-empty string",
+                        }).parse(value),
+                    ];
+                },
+            },
+        },
+    },
+    docs: {
+        brief: "Run the MCP server with Streamable HTTP transport",
+    },
+});
+//# sourceMappingURL=command.js.map

package/esm/mcp-server/cli/serve/command.js.map

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

package/esm/mcp-server/cli/serve/impl.d.ts

@@ -0,0 +1,12 @@
+import { LocalContext } from "../../cli.js";
+import { ConsoleLoggerLevel } from "../../console-logger.js";
+import { MCPServerFlags } from "../../flags.js";
+interface ServeCommandFlags extends MCPServerFlags {
+    readonly port: number;
+    readonly "disable-static-auth": boolean;
+    readonly "log-level": ConsoleLoggerLevel;
+    readonly env?: [string, string][];
+}
+export declare function main(this: LocalContext, flags: ServeCommandFlags): Promise<void>;
+export {};
+//# sourceMappingURL=impl.d.ts.map

package/esm/mcp-server/cli/serve/impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impl.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/cli/serve/impl.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKhD,UAAU,iBAAkB,SAAQ,cAAc;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CACnC;AAiDD,wBAAsB,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,iBAMtE"}

package/esm/mcp-server/cli/serve/impl.js

@@ -0,0 +1,131 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import express from "express";
+import { createConsoleLogger, } from "../../console-logger.js";
+import { createMCPServer } from "../../server.js";
+import { buildAnnotationFilter } from "../../tools.js";
+import { buildSDK } from "../../tools.js";
+function isJsonObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isJsonRpcClientMessage(value) {
+    if (!isJsonObject(value)) {
+        return false;
+    }
+    return value["jsonrpc"] === "2.0" && typeof value["method"] === "string";
+}
+function parseStreamableHttpPayload(value) {
+    if (Array.isArray(value)) {
+        if (value.length > 0 && value.every(isJsonRpcClientMessage)) {
+            return { ok: true, payload: value };
+        }
+        return { ok: false };
+    }
+    if (isJsonRpcClientMessage(value)) {
+        return { ok: true, payload: value };
+    }
+    return { ok: false };
+}
+function sendInvalidRequest(res) {
+    res.status(400).json({
+        jsonrpc: "2.0",
+        error: {
+            code: -32600,
+            message: "Invalid JSON-RPC request payload",
+        },
+        id: null,
+    });
+}
+function getParsedJsonBody(req) {
+    return Reflect.get(req, "body");
+}
+export async function main(flags) {
+    flags.env?.forEach(([key, value]) => {
+        process.env[key] = value;
+    });
+    await startStreamableHTTP(flags);
+}
+async function startStreamableHTTP(cliFlags) {
+    const logger = createConsoleLogger(cliFlags["log-level"]);
+    const app = express();
+    // Enable CORS for cross-origin requests
+    app.use((req, res, next) => {
+        res.header("Access-Control-Allow-Origin", "*");
+        res.header("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+        res.header("Access-Control-Allow-Headers", "*");
+        if (req.method === "OPTIONS") {
+            res.sendStatus(204);
+            return;
+        }
+        next();
+    });
+    app.use(express.json({ limit: "1mb" }));
+    app.post("/mcp", async (req, res) => {
+        const headers = new Headers();
+        for (const [key, value] of Object.entries(req.headers)) {
+            if (Array.isArray(value)) {
+                for (const v of value)
+                    headers.append(key, v);
+            }
+            else if (value !== undefined) {
+                headers.set(key, value);
+            }
+        }
+        const transport = new StreamableHTTPServerTransport({});
+        const { server: mcpServer } = createMCPServer({
+            logger,
+            allowedTools: cliFlags.tool,
+            dynamic: cliFlags.mode === "dynamic",
+            annotationFilter: buildAnnotationFilter(cliFlags["tool-annotations"]),
+            scopes: cliFlags.scope,
+            serverURL: cliFlags["server-url"],
+            getSDK: () => buildSDK(headers, cliFlags, cliFlags["disable-static-auth"], logger),
+            serverIdx: cliFlags["server-index"],
+            protocol: cliFlags.protocol,
+            managementAPIHost: cliFlags["management-api-host"],
+            orgId: cliFlags["org-id"],
+        });
+        mcpServer.server.onerror = (error) => {
+            logger.error("MCP protocol error", {
+                error: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+        };
+        const parsedPayload = parseStreamableHttpPayload(getParsedJsonBody(req));
+        if (!parsedPayload.ok) {
+            sendInvalidRequest(res);
+            return;
+        }
+        await mcpServer.connect(transport);
+        await transport.handleRequest(req, res, parsedPayload.payload);
+    });
+    app.get("/", (_req, res) => {
+        res.json({
+            name: "Gravitee APIM MCP Server",
+            transport: "streamable-http",
+            endpoint: "/mcp",
+        });
+    });
+    const httpServer = app.listen(cliFlags.port, "0.0.0.0", () => {
+        const ha = httpServer.address();
+        const host = typeof ha === "string" ? ha : `${ha?.address}:${ha?.port}`;
+        logger.info("MCP Streamable HTTP server started", { host });
+    });
+    const shutdown = () => {
+        logger.info("Shutting down HTTP server");
+        const timer = setTimeout(() => {
+            logger.info("Forcing shutdown");
+            process.exit(1);
+        }, 5000);
+        httpServer.close(() => {
+            clearTimeout(timer);
+            logger.info("Graceful shutdown complete");
+            process.exit(0);
+        });
+    };
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+}
+//# sourceMappingURL=impl.js.map

package/esm/mcp-server/cli/serve/impl.js.map

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

package/esm/mcp-server/cli/start/command.d.ts

@@ -0,0 +1,2 @@
+export declare const startCommand: import("@stricli/core").Command<import("../../cli.js").LocalContext>;
+//# sourceMappingURL=command.d.ts.map

package/esm/mcp-server/cli/start/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/cli/start/command.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,YAAY,sEA2HvB,CAAC"}

package/esm/mcp-server/cli/start/command.js

@@ -0,0 +1,129 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { buildCommand } from "@stricli/core";
+import { numberParser } from "@stricli/core";
+import * as z from "zod";
+import { ServerProtocol } from "../../../lib/config.js";
+import { consoleLoggerLevels } from "../../console-logger.js";
+import { mcpScopes } from "../../scopes.js";
+export const startCommand = buildCommand({
+    loader: async () => {
+        const { main } = await import("./impl.js");
+        return main;
+    },
+    parameters: {
+        flags: {
+            transport: {
+                kind: "enum",
+                brief: "The transport to use for communicating with the server",
+                default: "stdio",
+                values: ["stdio", "sse"],
+            },
+            port: {
+                kind: "parsed",
+                brief: "The port to use when the SSE transport is enabled",
+                default: "2718",
+                parse: (val) => z.coerce.number().int().gte(0).lt(65536).parse(val),
+            },
+            tool: {
+                kind: "parsed",
+                brief: "Specify tools to mount on the server",
+                optional: true,
+                variadic: true,
+                parse: (value) => {
+                    return z.string().parse(value);
+                },
+            },
+            mode: {
+                kind: "enum",
+                brief: "Server mode (dynamic: expose list_tools, describe_tool_input, and execute_tool instead of individual tools)",
+                values: ["dynamic"],
+                optional: true,
+            },
+            "tool-annotations": {
+                kind: "parsed",
+                brief: "Filter tools by annotations (comma-separated: readOnly, destructive, idempotent, openWorld). Listed = required true, unlisted = required false.",
+                optional: true,
+                parse: (value) => value.split(",").map(s => s.trim()),
+            },
+            scope: {
+                kind: "enum",
+                brief: "Mount tools/resources that match given scope (repeatable flag)",
+                values: mcpScopes,
+                variadic: true,
+                optional: true,
+            },
+            "bearer-auth": {
+                kind: "parsed",
+                brief: "Sets the bearerAuth auth field for the API",
+                optional: true,
+                parse: (value) => {
+                    return z.string().parse(value);
+                },
+            },
+            "server-url": {
+                kind: "parsed",
+                brief: "Overrides the default server URL used by the SDK",
+                optional: true,
+                parse: (value) => new URL(value).toString(),
+            },
+            "server-index": {
+                kind: "parsed",
+                brief: "Selects a predefined server used by the SDK",
+                optional: true,
+                parse: numberParser,
+            },
+            protocol: {
+                kind: "enum",
+                brief: "Sets the protocol variable for url substitution",
+                optional: true,
+                values: Object.values(ServerProtocol),
+            },
+            "management-api-host": {
+                kind: "parsed",
+                brief: "Sets the managementAPIHost variable for url substitution",
+                optional: true,
+                parse: (value) => value,
+            },
+            "org-id": {
+                kind: "parsed",
+                brief: "Sets the orgId variable for url substitution",
+                optional: true,
+                parse: (value) => value,
+            },
+            "log-level": {
+                kind: "enum",
+                brief: "The log level to use for the server",
+                default: "info",
+                values: consoleLoggerLevels,
+            },
+            env: {
+                kind: "parsed",
+                brief: "Environment variables made available to the server",
+                optional: true,
+                variadic: true,
+                parse: (val) => {
+                    const sepIdx = val.indexOf("=");
+                    if (sepIdx === -1) {
+                        throw new Error("Invalid environment variable format");
+                    }
+                    const key = val.slice(0, sepIdx);
+                    const value = val.slice(sepIdx + 1);
+                    return [
+                        z.string().nonempty({
+                            message: "Environment variable key must be a non-empty string",
+                        }).parse(key),
+                        z.string().nonempty({
+                            message: "Environment variable value must be a non-empty string",
+                        }).parse(value),
+                    ];
+                },
+            },
+        },
+    },
+    docs: {
+        brief: "Run the Model Context Protocol server",
+    },
+});
+//# sourceMappingURL=command.js.map

package/esm/mcp-server/cli/start/command.js.map

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

package/esm/mcp-server/cli/start/impl.d.ts

@@ -0,0 +1,12 @@
+import { LocalContext } from "../../cli.js";
+import { ConsoleLoggerLevel } from "../../console-logger.js";
+import { MCPServerFlags } from "../../flags.js";
+interface StartCommandFlags extends MCPServerFlags {
+    readonly transport: "stdio" | "sse";
+    readonly port: number;
+    readonly "log-level": ConsoleLoggerLevel;
+    readonly env?: [string, string][];
+}
+export declare function main(this: LocalContext, flags: StartCommandFlags): Promise<void>;
+export {};
+//# sourceMappingURL=impl.d.ts.map

package/esm/mcp-server/cli/start/impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impl.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/cli/start/impl.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EACL,kBAAkB,EAEnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIhD,UAAU,iBAAkB,SAAQ,cAAc;IAChD,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,KAAK,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CACnC;AAQD,wBAAsB,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,iBAAiB,iBAetE"}

package/esm/mcp-server/cli/start/impl.js

@@ -0,0 +1,175 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import express from "express";
+import { createConsoleLogger, } from "../../console-logger.js";
+import { createMCPServer } from "../../server.js";
+import { buildAnnotationFilter } from "../../tools.js";
+export async function main(flags) {
+    flags.env?.forEach(([key, value]) => {
+        process.env[key] = value;
+    });
+    switch (flags.transport) {
+        case "stdio":
+            await startStdio(flags);
+            break;
+        case "sse":
+            await startSSE(flags);
+            break;
+        default:
+            throw new Error(`Invalid transport: ${flags.transport}`);
+    }
+}
+async function startStdio(flags) {
+    const logger = createConsoleLogger(flags["log-level"]);
+    const transport = new StdioServerTransport();
+    const { server } = createMCPServer({
+        logger,
+        allowedTools: flags.tool,
+        dynamic: flags.mode === "dynamic",
+        annotationFilter: buildAnnotationFilter(flags["tool-annotations"]),
+        scopes: flags.scope,
+        security: { bearerAuth: flags["bearer-auth"] ?? "" },
+        serverURL: flags["server-url"],
+        serverIdx: flags["server-index"],
+        protocol: flags.protocol,
+        managementAPIHost: flags["management-api-host"],
+        orgId: flags["org-id"],
+    });
+    await server.connect(transport);
+    const abort = async () => {
+        await server.close();
+        process.exit(0);
+    };
+    process.on("SIGTERM", abort);
+    process.on("SIGINT", abort);
+}
+async function startSSE(cliFlags) {
+    const logger = createConsoleLogger(cliFlags["log-level"]);
+    const app = express();
+    const sessions = new Map();
+    const controller = new AbortController();
+    app.get("/sse", async (req, res) => {
+        const sessionId = crypto.randomUUID();
+        logger.info("SSE connection initiated", {
+            sessionId,
+            userAgent: req.headers["user-agent"],
+        });
+        // Track early disconnection
+        let connectionClosed = false;
+        res.on("close", () => {
+            if (!connectionClosed) {
+                logger.info("Connection closed early", { sessionId });
+            }
+            connectionClosed = true;
+        });
+        // Merge CLI flags with header overrides for security credentials
+        const flags = {
+            ...cliFlags,
+            // Security fields can be overridden via headers
+            "bearer-auth": req.headers["bearerauth"]
+                ?? cliFlags["bearer-auth"],
+        };
+        // Create a new MCP server for this connection with its auth
+        const { server: mcpServer } = createMCPServer({
+            logger,
+            allowedTools: flags.tool,
+            dynamic: flags.mode === "dynamic",
+            annotationFilter: buildAnnotationFilter(flags["tool-annotations"]),
+            scopes: flags.scope,
+            security: { bearerAuth: flags["bearer-auth"] ?? "" },
+            serverURL: flags["server-url"],
+            serverIdx: flags["server-index"],
+            protocol: flags.protocol,
+            managementAPIHost: flags["management-api-host"],
+            orgId: flags["org-id"],
+        });
+        // Message path includes session ID for routing
+        const transport = new SSEServerTransport(`/message/${sessionId}`, res);
+        const cleanup = async () => {
+            await mcpServer.close();
+        };
+        sessions.set(sessionId, { mcpServer, transport, cleanup });
+        logger.info("Session created", { sessionId, totalSessions: sessions.size });
+        controller.signal.addEventListener("abort", cleanup);
+        // Log server-side errors for debugging (e.g. tools/list handler failures)
+        mcpServer.server.onerror = (error) => {
+            logger.error("MCP protocol error", {
+                sessionId,
+                error: error instanceof Error ? error.message : String(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+        };
+        // Wrap transport.send to log error responses for debugging
+        const originalSend = transport.send.bind(transport);
+        transport.send = async (message) => {
+            if ("error" in message && message.error) {
+                logger.error("MCP sending error response", {
+                    sessionId,
+                    id: message.id,
+                    errorCode: message.error.code,
+                    errorMessage: message.error.message,
+                });
+            }
+            return originalSend(message);
+        };
+        await mcpServer.connect(transport);
+        mcpServer.server.onclose = async () => {
+            connectionClosed = true;
+            controller.signal.removeEventListener("abort", cleanup);
+            sessions.delete(sessionId);
+            logger.info("Session closed", {
+                sessionId,
+                totalSessions: sessions.size,
+            });
+            res.end();
+        };
+    });
+    app.post("/message/:sessionId", async (req, res) => {
+        const session = sessions.get(req.params.sessionId);
+        if (!session) {
+            res.status(404).send("Session not found");
+            return;
+        }
+        await session.transport.handlePostMessage(req, res);
+    });
+    app.get("/", (_req, res) => {
+        res.json({
+            name: "Gravitee APIM MCP Server",
+            transport: "sse",
+            endpoints: {
+                sse: "/sse",
+                message: "/message/{sessionId}",
+            },
+        });
+    });
+    const httpServer = app.listen(cliFlags.port, "0.0.0.0", () => {
+        const ha = httpServer.address();
+        const host = typeof ha === "string" ? ha : `${ha?.address}:${ha?.port}`;
+        logger.info("MCP HTTP server started", { host });
+    });
+    let closing = false;
+    controller.signal.addEventListener("abort", async () => {
+        if (closing) {
+            logger.info("Received second signal. Forcing shutdown.");
+            process.exit(1);
+        }
+        closing = true;
+        logger.info("Shutting down HTTP server");
+        const timer = setTimeout(() => {
+            logger.info("Forcing shutdown");
+            process.exit(1);
+        }, 5000);
+        httpServer.close(() => {
+            clearTimeout(timer);
+            logger.info("Graceful shutdown complete");
+            process.exit(0);
+        });
+    });
+    const abort = () => controller.abort();
+    process.on("SIGTERM", abort);
+    process.on("SIGINT", abort);
+}
+//# sourceMappingURL=impl.js.map

package/esm/mcp-server/cli/start/impl.js.map

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

package/esm/mcp-server/cli.d.ts

@@ -0,0 +1,6 @@
+import { CommandContext, StricliProcess } from "@stricli/core";
+export interface LocalContext extends CommandContext {
+    readonly process: StricliProcess;
+}
+export declare function buildContext(process: NodeJS.Process): LocalContext;
+//# sourceMappingURL=cli.d.ts.map

package/esm/mcp-server/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/mcp-server/cli.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/D,MAAM,WAAW,YAAa,SAAQ,cAAc;IAClD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,YAAY,CAElE"}