@studiometa/forge-mcp 0.0.1 → 0.1.0

package/dist/index.js

@@ -0,0 +1,127 @@
+#!/usr/bin/env node
+import { a as INSTRUCTIONS, i as executeToolWithCredentials, n as STDIO_ONLY_TOOLS, r as TOOLS, t as VERSION } from "./version-Cw8OGt4r.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { getToken, setToken } from "@studiometa/forge-api";
+/**
+* Get all available tools (including stdio-only configuration tools).
+*/
+function getAvailableTools() {
+	return [...TOOLS, ...STDIO_ONLY_TOOLS];
+}
+/**
+* Handle the forge_configure tool.
+*/
+function handleConfigureTool(args) {
+	if (!args.apiToken || typeof args.apiToken !== "string" || args.apiToken.trim().length === 0) return {
+		content: [{
+			type: "text",
+			text: "Error: apiToken is required and must be a non-empty string."
+		}],
+		isError: true
+	};
+	setToken(args.apiToken);
+	return { content: [{
+		type: "text",
+		text: JSON.stringify({
+			success: true,
+			message: "Laravel Forge API token configured successfully",
+			apiToken: `***${args.apiToken.slice(-4)}`
+		}, null, 2)
+	}] };
+}
+/**
+* Handle the forge_get_config tool.
+*/
+function handleGetConfigTool() {
+	const token = getToken();
+	return { content: [{
+		type: "text",
+		text: JSON.stringify({
+			apiToken: token ? `***${token.slice(-4)}` : "not configured",
+			configured: !!token
+		}, null, 2)
+	}] };
+}
+/**
+* Handle a tool call request.
+*/
+async function handleToolCall(name, args) {
+	if (name === "forge_configure") return handleConfigureTool(args);
+	if (name === "forge_get_config") return handleGetConfigTool();
+	const apiToken = getToken();
+	if (!apiToken) return {
+		content: [{
+			type: "text",
+			text: "Error: Forge API token not configured. Use \"forge_configure\" tool or set FORGE_API_TOKEN environment variable."
+		}],
+		isError: true
+	};
+	return executeToolWithCredentials(name, args, { apiToken });
+}
+/**
+* Forge MCP Server — Stdio Transport
+*
+* This is the local execution mode using stdio transport.
+* For remote HTTP deployment, use server.ts instead.
+*
+* Usage:
+*   npx @studiometa/forge-mcp
+*
+* Or in Claude Desktop config:
+*   {
+*     "mcpServers": {
+*       "forge": {
+*         "command": "forge-mcp",
+*         "env": { "FORGE_API_TOKEN": "your-token" }
+*       }
+*     }
+*   }
+*/
+/**
+* Create and configure the MCP server.
+*/
+function createStdioServer() {
+	const server = new Server({
+		name: "forge-mcp",
+		version: VERSION
+	}, {
+		capabilities: { tools: {} },
+		instructions: INSTRUCTIONS
+	});
+	server.setRequestHandler(ListToolsRequestSchema, async () => {
+		return { tools: getAvailableTools() };
+	});
+	server.setRequestHandler(CallToolRequestSchema, async (request) => {
+		const { name, arguments: args } = request.params;
+		try {
+			return await handleToolCall(name, args ?? {});
+		} catch (error) {
+			return {
+				content: [{
+					type: "text",
+					text: `Error: ${error instanceof Error ? error.message : String(error)}`
+				}],
+				isError: true
+			};
+		}
+	});
+	return server;
+}
+/**
+* Start the stdio server.
+*/
+async function startStdioServer() {
+	const server = createStdioServer();
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+	console.error(`Forge MCP server v${VERSION} running on stdio`);
+}
+if (import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith("/forge-mcp") || process.argv[1]?.endsWith("\\forge-mcp")) startStdioServer().catch((error) => {
+	console.error("Fatal error:", error);
+	process.exit(1);
+});
+export { createStdioServer, startStdioServer };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/stdio.ts","../src/index.ts"],"sourcesContent":["import { getToken, setToken } from \"@studiometa/forge-api\";\n\nimport type { ToolResult } from \"./handlers/types.ts\";\n\nimport { executeToolWithCredentials } from \"./handlers/index.ts\";\nimport { STDIO_ONLY_TOOLS, TOOLS } from \"./tools.ts\";\n\nexport type { ToolResult };\n\n/**\n * Get all available tools (including stdio-only configuration tools).\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function getAvailableTools(): any[] {\n  return [...TOOLS, ...STDIO_ONLY_TOOLS];\n}\n\n/**\n * Handle the forge_configure tool.\n */\nexport function handleConfigureTool(args: { apiToken: string }): ToolResult {\n  if (!args.apiToken || typeof args.apiToken !== \"string\" || args.apiToken.trim().length === 0) {\n    return {\n      content: [\n        {\n          type: \"text\",\n          text: \"Error: apiToken is required and must be a non-empty string.\",\n        },\n      ],\n      isError: true,\n    };\n  }\n\n  setToken(args.apiToken);\n\n  return {\n    content: [\n      {\n        type: \"text\",\n        text: JSON.stringify(\n          {\n            success: true,\n            message: \"Laravel Forge API token configured successfully\",\n            apiToken: `***${args.apiToken.slice(-4)}`,\n          },\n          null,\n          2,\n        ),\n      },\n    ],\n  };\n}\n\n/**\n * Handle the forge_get_config tool.\n */\nexport function handleGetConfigTool(): ToolResult {\n  const token = getToken();\n\n  return {\n    content: [\n      {\n        type: \"text\",\n        text: JSON.stringify(\n          {\n            apiToken: token ? `***${token.slice(-4)}` : \"not configured\",\n            configured: !!token,\n          },\n          null,\n          2,\n        ),\n      },\n    ],\n  };\n}\n\n/**\n * Handle a tool call request.\n */\nexport async function handleToolCall(\n  name: string,\n  args: Record<string, unknown>,\n): Promise<ToolResult> {\n  if (name === \"forge_configure\") {\n    return handleConfigureTool(args as { apiToken: string });\n  }\n\n  if (name === \"forge_get_config\") {\n    return handleGetConfigTool();\n  }\n\n  // Get API token\n  const apiToken = getToken();\n  if (!apiToken) {\n    return {\n      content: [\n        {\n          type: \"text\",\n          text: 'Error: Forge API token not configured. Use \"forge_configure\" tool or set FORGE_API_TOKEN environment variable.',\n        },\n      ],\n      isError: true,\n    };\n  }\n\n  return executeToolWithCredentials(name, args, { apiToken });\n}\n","#!/usr/bin/env node\n\n/**\n * Forge MCP Server — Stdio Transport\n *\n * This is the local execution mode using stdio transport.\n * For remote HTTP deployment, use server.ts instead.\n *\n * Usage:\n *   npx @studiometa/forge-mcp\n *\n * Or in Claude Desktop config:\n *   {\n *     \"mcpServers\": {\n *       \"forge\": {\n *         \"command\": \"forge-mcp\",\n *         \"env\": { \"FORGE_API_TOKEN\": \"your-token\" }\n *       }\n *     }\n *   }\n */\n\nimport { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { CallToolRequestSchema, ListToolsRequestSchema } from \"@modelcontextprotocol/sdk/types.js\";\n\nimport { INSTRUCTIONS } from \"./instructions.ts\";\nimport { getAvailableTools, handleToolCall } from \"./stdio.ts\";\nimport { VERSION } from \"./version.ts\";\n\n/**\n * Create and configure the MCP server.\n */\nexport function createStdioServer(): Server {\n  const server = new Server(\n    {\n      name: \"forge-mcp\",\n      version: VERSION,\n    },\n    {\n      capabilities: {\n        tools: {},\n      },\n      instructions: INSTRUCTIONS,\n    },\n  );\n\n  server.setRequestHandler(ListToolsRequestSchema, async () => {\n    return { tools: getAvailableTools() };\n  });\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const { name, arguments: args } = request.params;\n\n    try {\n      const result = await handleToolCall(name, (args as Record<string, unknown>) ?? {});\n      return result as unknown as Record<string, unknown>;\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      return {\n        content: [{ type: \"text\" as const, text: `Error: ${message}` }],\n        isError: true,\n      };\n    }\n  });\n\n  return server;\n}\n\n/**\n * Start the stdio server.\n */\nexport async function startStdioServer(): Promise<void> {\n  const server = createStdioServer();\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  console.error(`Forge MCP server v${VERSION} running on stdio`);\n}\n\n// Start server when run directly\nconst isMainModule =\n  import.meta.url === `file://${process.argv[1]}` ||\n  process.argv[1]?.endsWith(\"/forge-mcp\") ||\n  process.argv[1]?.endsWith(\"\\\\forge-mcp\");\n\nif (isMainModule) {\n  startStdioServer().catch((error) => {\n    console.error(\"Fatal error:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;;;;AAaA,SAAgB,oBAA2B;AACzC,QAAO,CAAC,GAAG,OAAO,GAAG,iBAAiB;;;;;AAMxC,SAAgB,oBAAoB,MAAwC;AAC1E,KAAI,CAAC,KAAK,YAAY,OAAO,KAAK,aAAa,YAAY,KAAK,SAAS,MAAM,CAAC,WAAW,EACzF,QAAO;EACL,SAAS,CACP;GACE,MAAM;GACN,MAAM;GACP,CACF;EACD,SAAS;EACV;AAGH,UAAS,KAAK,SAAS;AAEvB,QAAO,EACL,SAAS,CACP;EACE,MAAM;EACN,MAAM,KAAK,UACT;GACE,SAAS;GACT,SAAS;GACT,UAAU,MAAM,KAAK,SAAS,MAAM,GAAG;GACxC,EACD,MACA,EACD;EACF,CACF,EACF;;;;;AAMH,SAAgB,sBAAkC;CAChD,MAAM,QAAQ,UAAU;AAExB,QAAO,EACL,SAAS,CACP;EACE,MAAM;EACN,MAAM,KAAK,UACT;GACE,UAAU,QAAQ,MAAM,MAAM,MAAM,GAAG,KAAK;GAC5C,YAAY,CAAC,CAAC;GACf,EACD,MACA,EACD;EACF,CACF,EACF;;;;;AAMH,eAAsB,eACpB,MACA,MACqB;AACrB,KAAI,SAAS,kBACX,QAAO,oBAAoB,KAA6B;AAG1D,KAAI,SAAS,mBACX,QAAO,qBAAqB;CAI9B,MAAM,WAAW,UAAU;AAC3B,KAAI,CAAC,SACH,QAAO;EACL,SAAS,CACP;GACE,MAAM;GACN,MAAM;GACP,CACF;EACD,SAAS;EACV;AAGH,QAAO,2BAA2B,MAAM,MAAM,EAAE,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;ACxE7D,SAAgB,oBAA4B;CAC1C,MAAM,SAAS,IAAI,OACjB;EACE,MAAM;EACN,SAAS;EACV,EACD;EACE,cAAc,EACZ,OAAO,EAAE,EACV;EACD,cAAc;EACf,CACF;AAED,QAAO,kBAAkB,wBAAwB,YAAY;AAC3D,SAAO,EAAE,OAAO,mBAAmB,EAAE;GACrC;AAEF,QAAO,kBAAkB,uBAAuB,OAAO,YAAY;EACjE,MAAM,EAAE,MAAM,WAAW,SAAS,QAAQ;AAE1C,MAAI;AAEF,UADe,MAAM,eAAe,MAAO,QAAoC,EAAE,CAAC;WAE3E,OAAO;AAEd,UAAO;IACL,SAAS,CAAC;KAAE,MAAM;KAAiB,MAAM,UAF3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;KAEN,CAAC;IAC/D,SAAS;IACV;;GAEH;AAEF,QAAO;;;;;AAMT,eAAsB,mBAAkC;CACtD,MAAM,SAAS,mBAAmB;CAClC,MAAM,YAAY,IAAI,sBAAsB;AAC5C,OAAM,OAAO,QAAQ,UAAU;AAC/B,SAAQ,MAAM,qBAAqB,QAAQ,mBAAmB;;AAShE,IAJE,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,QAC3C,QAAQ,KAAK,IAAI,SAAS,aAAa,IACvC,QAAQ,KAAK,IAAI,SAAS,cAAc,CAGxC,mBAAkB,CAAC,OAAO,UAAU;AAClC,SAAQ,MAAM,gBAAgB,MAAM;AACpC,SAAQ,KAAK,EAAE;EACf"}

package/dist/instructions.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP Server Instructions
+ *
+ * These instructions are sent to MCP clients during initialization
+ * and used as context/hints for the LLM. Ensures the AI agent
+ * knows how to properly use the Forge MCP server.
+ *
+ * The content is derived from skills/SKILL.md (without YAML frontmatter).
+ */
+export declare const INSTRUCTIONS: string;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../src/instructions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2BH,eAAO,MAAM,YAAY,QAAqB,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * Forge MCP Server - HTTP Transport (Streamable HTTP)
+ *
+ * Implements the official MCP Streamable HTTP transport specification.
+ * Credentials are passed via Bearer token in the Authorization header.
+ *
+ * Token format: raw Forge API token
+ *
+ * Usage:
+ *   forge-mcp-server
+ *   PORT=3000 forge-mcp-server
+ *
+ * Endpoints:
+ *   POST /mcp   - MCP Streamable HTTP (JSON-RPC messages)
+ *   GET  /mcp   - MCP Streamable HTTP (SSE stream for server notifications)
+ *   DELETE /mcp - MCP Streamable HTTP (session termination)
+ *   GET  /       - Service info
+ *   GET  /health - Health check
+ */
+import { type Server } from "node:http";
+/**
+ * Start the HTTP server with Streamable HTTP transport.
+ */
+export declare function startHttpServer(port?: number, host?: string): Promise<Server>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAStD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,IAAI,GAAE,MAAqB,EAC3B,IAAI,GAAE,MAAqB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAwCjB"}

package/dist/server.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { t as VERSION } from "./version-Cw8OGt4r.js";
+import { a as SessionManager, n as createMcpRequestHandler, t as createHealthApp } from "./http-BJUKoZdb.js";
+import { toNodeHandler } from "h3/node";
+import { createServer } from "node:http";
+/**
+* Forge MCP Server - HTTP Transport (Streamable HTTP)
+*
+* Implements the official MCP Streamable HTTP transport specification.
+* Credentials are passed via Bearer token in the Authorization header.
+*
+* Token format: raw Forge API token
+*
+* Usage:
+*   forge-mcp-server
+*   PORT=3000 forge-mcp-server
+*
+* Endpoints:
+*   POST /mcp   - MCP Streamable HTTP (JSON-RPC messages)
+*   GET  /mcp   - MCP Streamable HTTP (SSE stream for server notifications)
+*   DELETE /mcp - MCP Streamable HTTP (session termination)
+*   GET  /       - Service info
+*   GET  /health - Health check
+*/
+var DEFAULT_PORT = 3e3;
+var DEFAULT_HOST = "0.0.0.0";
+/**
+* Start the HTTP server with Streamable HTTP transport.
+*/
+function startHttpServer(port = DEFAULT_PORT, host = DEFAULT_HOST) {
+	return new Promise((resolve) => {
+		const handleMcp = createMcpRequestHandler(new SessionManager());
+		const healthHandler = toNodeHandler(createHealthApp());
+		const server = createServer(async (req, res) => {
+			const url = req.url ?? "/";
+			if (url === "/mcp" || url.startsWith("/mcp?")) {
+				await handleMcp(req, res);
+				return;
+			}
+			healthHandler(req, res);
+		});
+		server.listen(port, host, () => {
+			const displayHost = host === "0.0.0.0" ? "localhost" : host;
+			console.log(`Forge MCP server v${VERSION}`);
+			console.log(`Node.js ${process.version}`);
+			console.log("");
+			console.log(`Running at http://${displayHost}:${port}`);
+			console.log("");
+			console.log("Endpoints:");
+			console.log(`  POST/GET/DELETE http://${displayHost}:${port}/mcp - MCP Streamable HTTP endpoint`);
+			console.log(`  GET  http://${displayHost}:${port}/health - Health check`);
+			console.log("");
+			console.log("Authentication:");
+			console.log("  Bearer token in Authorization header");
+			console.log("  Token format: your raw Forge API token");
+			console.log("");
+			resolve(server);
+		});
+	});
+}
+if (import.meta.url === `file://${process.argv[1]}` || process.argv[1]?.endsWith("/forge-mcp-server") || process.argv[1]?.endsWith("\\forge-mcp-server")) startHttpServer(Number.parseInt(process.env.PORT || String(DEFAULT_PORT), 10), process.env.HOST || DEFAULT_HOST).catch((error) => {
+	console.error("Fatal error:", error);
+	process.exit(1);
+});
+export { startHttpServer };
+
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","names":[],"sources":["../src/server.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * Forge MCP Server - HTTP Transport (Streamable HTTP)\n *\n * Implements the official MCP Streamable HTTP transport specification.\n * Credentials are passed via Bearer token in the Authorization header.\n *\n * Token format: raw Forge API token\n *\n * Usage:\n *   forge-mcp-server\n *   PORT=3000 forge-mcp-server\n *\n * Endpoints:\n *   POST /mcp   - MCP Streamable HTTP (JSON-RPC messages)\n *   GET  /mcp   - MCP Streamable HTTP (SSE stream for server notifications)\n *   DELETE /mcp - MCP Streamable HTTP (session termination)\n *   GET  /       - Service info\n *   GET  /health - Health check\n */\n\nimport { toNodeHandler } from \"h3/node\";\nimport { createServer, type Server } from \"node:http\";\n\nimport { createHealthApp, createMcpRequestHandler } from \"./http.ts\";\nimport { SessionManager } from \"./sessions.ts\";\nimport { VERSION } from \"./version.ts\";\n\nconst DEFAULT_PORT = 3000;\nconst DEFAULT_HOST = \"0.0.0.0\";\n\n/**\n * Start the HTTP server with Streamable HTTP transport.\n */\nexport function startHttpServer(\n  port: number = DEFAULT_PORT,\n  host: string = DEFAULT_HOST,\n): Promise<Server> {\n  return new Promise((resolve) => {\n    const sessions = new SessionManager();\n    const handleMcp = createMcpRequestHandler(sessions);\n    const healthApp = createHealthApp();\n    const healthHandler = toNodeHandler(healthApp);\n\n    const server = createServer(async (req, res) => {\n      const url = req.url ?? \"/\";\n\n      // Route /mcp to MCP Streamable HTTP transport\n      if (url === \"/mcp\" || url.startsWith(\"/mcp?\")) {\n        await handleMcp(req, res);\n        return;\n      }\n\n      // Everything else goes to h3 (health checks, service info)\n      healthHandler(req, res);\n    });\n\n    server.listen(port, host, () => {\n      const displayHost = host === \"0.0.0.0\" ? \"localhost\" : host;\n      console.log(`Forge MCP server v${VERSION}`);\n      console.log(`Node.js ${process.version}`);\n      console.log(\"\");\n      console.log(`Running at http://${displayHost}:${port}`);\n      console.log(\"\");\n      console.log(\"Endpoints:\");\n      console.log(\n        `  POST/GET/DELETE http://${displayHost}:${port}/mcp - MCP Streamable HTTP endpoint`,\n      );\n      console.log(`  GET  http://${displayHost}:${port}/health - Health check`);\n      console.log(\"\");\n      console.log(\"Authentication:\");\n      console.log(\"  Bearer token in Authorization header\");\n      console.log(\"  Token format: your raw Forge API token\");\n      console.log(\"\");\n      resolve(server);\n    });\n  });\n}\n\n// Start server when run directly\nconst isMainModule =\n  import.meta.url === `file://${process.argv[1]}` ||\n  process.argv[1]?.endsWith(\"/forge-mcp-server\") ||\n  process.argv[1]?.endsWith(\"\\\\forge-mcp-server\");\n\nif (isMainModule) {\n  const port = Number.parseInt(process.env.PORT || String(DEFAULT_PORT), 10);\n  const host = process.env.HOST || DEFAULT_HOST;\n\n  startHttpServer(port, host).catch((error) => {\n    console.error(\"Fatal error:\", error);\n    process.exit(1);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA6BA,IAAM,eAAe;AACrB,IAAM,eAAe;;;;AAKrB,SAAgB,gBACd,OAAe,cACf,OAAe,cACE;AACjB,QAAO,IAAI,SAAS,YAAY;EAE9B,MAAM,YAAY,wBADD,IAAI,gBAAgB,CACc;EAEnD,MAAM,gBAAgB,cADJ,iBAAiB,CACW;EAE9C,MAAM,SAAS,aAAa,OAAO,KAAK,QAAQ;GAC9C,MAAM,MAAM,IAAI,OAAO;AAGvB,OAAI,QAAQ,UAAU,IAAI,WAAW,QAAQ,EAAE;AAC7C,UAAM,UAAU,KAAK,IAAI;AACzB;;AAIF,iBAAc,KAAK,IAAI;IACvB;AAEF,SAAO,OAAO,MAAM,YAAY;GAC9B,MAAM,cAAc,SAAS,YAAY,cAAc;AACvD,WAAQ,IAAI,qBAAqB,UAAU;AAC3C,WAAQ,IAAI,WAAW,QAAQ,UAAU;AACzC,WAAQ,IAAI,GAAG;AACf,WAAQ,IAAI,qBAAqB,YAAY,GAAG,OAAO;AACvD,WAAQ,IAAI,GAAG;AACf,WAAQ,IAAI,aAAa;AACzB,WAAQ,IACN,4BAA4B,YAAY,GAAG,KAAK,qCACjD;AACD,WAAQ,IAAI,iBAAiB,YAAY,GAAG,KAAK,wBAAwB;AACzE,WAAQ,IAAI,GAAG;AACf,WAAQ,IAAI,kBAAkB;AAC9B,WAAQ,IAAI,yCAAyC;AACrD,WAAQ,IAAI,2CAA2C;AACvD,WAAQ,IAAI,GAAG;AACf,WAAQ,OAAO;IACf;GACF;;AASJ,IAJE,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,QAC3C,QAAQ,KAAK,IAAI,SAAS,oBAAoB,IAC9C,QAAQ,KAAK,IAAI,SAAS,qBAAqB,CAM/C,iBAHa,OAAO,SAAS,QAAQ,IAAI,QAAQ,OAAO,aAAa,EAAE,GAAG,EAC7D,QAAQ,IAAI,QAAQ,aAEN,CAAC,OAAO,UAAU;AAC3C,SAAQ,MAAM,gBAAgB,MAAM;AACpC,SAAQ,KAAK,EAAE;EACf"}

package/dist/sessions.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Session manager for multi-tenant Streamable HTTP transport.
+ *
+ * Each MCP client session gets its own transport + server pair.
+ * Sessions are identified by UUID and tracked in a Map.
+ *
+ * Supports automatic TTL-based cleanup of idle sessions to prevent
+ * memory leaks from abandoned clients.
+ */
+import type { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import type { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+/**
+ * A managed session: transport + MCP server pair.
+ */
+export interface ManagedSession {
+    transport: StreamableHTTPServerTransport;
+    server: Server;
+    createdAt: number;
+    lastActiveAt: number;
+}
+export interface SessionManagerOptions {
+    /**
+     * Maximum idle time in milliseconds before a session is reaped.
+     * Default: 30 minutes. Set to 0 to disable automatic cleanup.
+     */
+    ttl?: number;
+    /**
+     * How often to check for expired sessions, in milliseconds.
+     * Default: 60 seconds.
+     */
+    sweepInterval?: number;
+}
+export declare class SessionManager {
+    private sessions;
+    private sweepTimer;
+    private readonly ttl;
+    constructor(options?: SessionManagerOptions);
+    /**
+     * Register a session after its ID has been assigned by the transport.
+     */
+    register(transport: StreamableHTTPServerTransport, server: Server): void;
+    /**
+     * Look up a session by its ID and refresh its activity timestamp.
+     */
+    get(sessionId: string): ManagedSession | undefined;
+    /**
+     * Remove a session and close its transport + server.
+     */
+    remove(sessionId: string): Promise<void>;
+    /**
+     * Get the number of active sessions.
+     */
+    get size(): number;
+    /**
+     * Sweep expired sessions. Called automatically by the sweep timer.
+     * Returns the number of sessions reaped.
+     */
+    sweep(): number;
+    /**
+     * Close all sessions, stop the sweep timer, and clean up.
+     */
+    closeAll(): Promise<void>;
+}
+//# sourceMappingURL=sessions.d.ts.map

package/dist/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../src/sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACxE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAC;AAExG;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,6BAA6B,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAKD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,UAAU,CAA6C;IAC/D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,OAAO,CAAC,EAAE,qBAAqB;IAa3C;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,6BAA6B,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAaxE;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAQlD;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS9C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACH,KAAK,IAAI,MAAM;IAsBf;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAchC"}

package/dist/stdio.d.ts

@@ -0,0 +1,21 @@
+import type { ToolResult } from "./handlers/types.ts";
+export type { ToolResult };
+/**
+ * Get all available tools (including stdio-only configuration tools).
+ */
+export declare function getAvailableTools(): any[];
+/**
+ * Handle the forge_configure tool.
+ */
+export declare function handleConfigureTool(args: {
+    apiToken: string;
+}): ToolResult;
+/**
+ * Handle the forge_get_config tool.
+ */
+export declare function handleGetConfigTool(): ToolResult;
+/**
+ * Handle a tool call request.
+ */
+export declare function handleToolCall(name: string, args: Record<string, unknown>): Promise<ToolResult>;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../src/stdio.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKtD,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B;;GAEG;AAEH,wBAAgB,iBAAiB,IAAI,GAAG,EAAE,CAEzC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CA+B1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,UAAU,CAkBhD;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,CAwBrB"}

package/dist/tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tool type matching MCP SDK expectations.
+ */
+interface Tool {
+    name: string;
+    description: string;
+    annotations?: Record<string, unknown>;
+    inputSchema: Record<string, unknown>;
+}
+/**
+ * Single consolidated tool for Laravel Forge MCP server.
+ *
+ * The resource/action enums and description are derived from
+ * the shared constants in forge-core — the single source of truth.
+ */
+export declare const TOOLS: Tool[];
+/**
+ * Additional tools only available in stdio mode.
+ */
+export declare const STDIO_ONLY_TOOLS: Tool[];
+export {};
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,UAAU,IAAI;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAgBD;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,IAAI,EA2EvB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,IAAI,EAkClC,CAAC"}