actual-mcp-server 0.6.56 → 0.7.3

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "actual-mcp-server",
   "displayName": "Actual MCP Server",
-  "version": "0.6.56",
+  "version": "0.7.3",
   "engines": {
-    "node": ">=20.0.0",
+    "node": ">=22.0.0",
     "npm": ">=10.0.0"
   },
   "description": "MCP server with 71 tools for AI-driven financial management with Actual Budget. HTTP and stdio transports for LibreChat, Claude Desktop, Cursor, VS Code, Gemini CLI",
@@ -30,7 +30,7 @@
     "verify-tools": "npm run build && node scripts/verify-tools.js",
     "check:coverage": "node scripts/list-actual-api-methods.mjs",
     "direct-sync": "node scripts/direct-sync/bank-sync-direct.mjs",
-    "test:unit-js": "node tests/unit/transactions_create.test.js && node tests/unit/generated_tools.smoke.test.js && node tests/unit/schema_validation.test.js && node tests/unit/config_https_validation.test.js && node tests/unit/config_data_dir.test.js && node tests/unit/config_drift.test.js && node tests/unit/port_alignment.test.js && node tests/unit/dockerfile_data_dir_alignment.test.js && node tests/unit/compose_profile_sync.test.js && node tests/unit/advertised_tools_sync.test.js && node tests/unit/knip_config.test.js && node tests/unit/node_polyfill_order.test.js && node tests/unit/config_insecure_upstream.test.js && node tests/unit/auth-acl.test.js && node tests/unit/bug76.test.js && node tests/unit/budgets_setAmount.test.js && node tests/unit/budgets_transfer.test.js && node tests/unit/transactions_uncategorized.test.js && node tests/unit/httpServer_session_init.test.js && node tests/unit/httpServer_session_not_found.test.js && node tests/unit/manual_mcp_client_retry.test.js && node tests/unit/manual_mcp_client_session.test.js && node tests/unit/manual_mcp_client_circuit.test.js && node tests/unit/manual_runner_killswitch.test.js && node tests/unit/adapter_auth_rate_limit.test.js && node tests/unit/adapter_session_reuse.test.js && node tests/unit/retry_classifier.test.js && node tests/unit/adapter_module_surface.test.js && node tests/unit/adapter_nonidempotent_no_retry.test.js && node tests/unit/pool_liveness.test.js && node tests/unit/pool_shutdown_all.test.js && node tests/unit/query_where_operators.test.js && node tests/unit/query_run_validation.test.js && node tests/unit/adapter_with_write_session.test.js && node tests/unit/category_groups_delete.test.js && node tests/unit/rules_delete.test.js && node tests/unit/schedules_delete.test.js && node tests/unit/payees_delete.test.js && node tests/unit/rules_create_or_update.test.js && node tests/unit/unhandled-rejection.test.js && node tests/unit/rejection-allowlist-purity.test.js && node tests/unit/httpServer_bearer_auth.test.js && node tests/unit/httpServer_oidc_audience.test.js && node tests/unit/httpServer_oidc_auth_verification.test.js && node tests/unit/httpServer_body_limit.test.js && node tests/unit/adapter_write_pool_cooperation.test.js && node tests/unit/budget_acl_enforcement.test.js && node tests/unit/budget_preference_store.test.js && node tests/unit/budget_preference_restore.test.js && node tests/unit/tags_list.test.js && node tests/unit/tags_create.test.js && node tests/unit/tags_update.test.js && node tests/unit/tags_delete.test.js && node tests/unit/notes_get.test.js && node tests/unit/notes_update.test.js && node tests/unit/payees_common_list.test.js && node tests/unit/transactions_update_guard.test.js && node tests/unit/entities_search.test.js && node tests/unit/transactions_import_schema.test.js && node tests/unit/tool_schema_shape.test.js && node tests/unit/zod_error_format.test.js && node tests/unit/tool_count_sync.test.js && node tests/unit/stdio_transport.test.js && node tests/unit/logger_structured.test.js && node tests/unit/logger_redaction.test.js && node tests/unit/logger_correlation.test.js && node tests/unit/check_coverage.test.js",
+    "test:unit-js": "node tests/unit/transactions_create.test.js && node tests/unit/generated_tools.smoke.test.js && node tests/unit/schema_validation.test.js && node tests/unit/config_https_validation.test.js && node tests/unit/config_data_dir.test.js && node tests/unit/config_drift.test.js && node tests/unit/port_alignment.test.js && node tests/unit/dockerfile_data_dir_alignment.test.js && node tests/unit/compose_profile_sync.test.js && node tests/unit/advertised_tools_sync.test.js && node tests/unit/knip_config.test.js && node tests/unit/readme_stats_sync.test.js && node tests/unit/config_insecure_upstream.test.js && node tests/unit/auth-acl.test.js && node tests/unit/bug76.test.js && node tests/unit/budgets_setAmount.test.js && node tests/unit/budgets_transfer.test.js && node tests/unit/transactions_uncategorized.test.js && node tests/unit/httpServer_session_init.test.js && node tests/unit/httpServer_session_not_found.test.js && node tests/unit/manual_mcp_client_retry.test.js && node tests/unit/manual_mcp_client_session.test.js && node tests/unit/manual_mcp_client_circuit.test.js && node tests/unit/manual_runner_killswitch.test.js && node tests/unit/adapter_auth_rate_limit.test.js && node tests/unit/adapter_session_reuse.test.js && node tests/unit/retry_classifier.test.js && node tests/unit/adapter_module_surface.test.js && node tests/unit/adapter_nonidempotent_no_retry.test.js && node tests/unit/pool_liveness.test.js && node tests/unit/pool_shutdown_all.test.js && node tests/unit/query_where_operators.test.js && node tests/unit/query_run_validation.test.js && node tests/unit/adapter_with_write_session.test.js && node tests/unit/category_groups_delete.test.js && node tests/unit/rules_delete.test.js && node tests/unit/schedules_delete.test.js && node tests/unit/payees_delete.test.js && node tests/unit/rules_create_or_update.test.js && node tests/unit/unhandled-rejection.test.js && node tests/unit/rejection-allowlist-purity.test.js && node tests/unit/httpServer_bearer_auth.test.js && node tests/unit/httpServer_oidc_audience.test.js && node tests/unit/httpServer_oidc_auth_verification.test.js && node tests/unit/httpServer_body_limit.test.js && node tests/unit/adapter_write_pool_cooperation.test.js && node tests/unit/budget_acl_enforcement.test.js && node tests/unit/budget_preference_store.test.js && node tests/unit/budget_preference_restore.test.js && node tests/unit/tags_list.test.js && node tests/unit/tags_create.test.js && node tests/unit/tags_update.test.js && node tests/unit/tags_delete.test.js && node tests/unit/notes_get.test.js && node tests/unit/notes_update.test.js && node tests/unit/payees_common_list.test.js && node tests/unit/transactions_update_guard.test.js && node tests/unit/entities_search.test.js && node tests/unit/transactions_import_schema.test.js && node tests/unit/tool_schema_shape.test.js && node tests/unit/zod_error_format.test.js && node tests/unit/tool_count_sync.test.js && node tests/unit/stdio_transport.test.js && node tests/unit/logger_structured.test.js && node tests/unit/logger_redaction.test.js && node tests/unit/logger_correlation.test.js && node tests/unit/check_coverage.test.js",
     "test:adapter": "npm run build && node dist/src/tests_adapter_runner.js",
     "test:e2e": "npx playwright test",
     "test:e2e:docker": "./tests/e2e/run-docker-e2e.sh",
@@ -57,7 +57,7 @@
     "release:patch": "npm run version:bump -- patch",
     "tool-count": "node scripts/tool-count.mjs",
     "config-drift": "npm run build && node scripts/config-drift.mjs",
-    "knip": "knip --no-exit-code"
+    "knip": "knip"
   },
   "dependencies": {
     "@actual-app/api": "^26.6.0",

package/dist/src/lib/node-polyfills.js

@@ -1,28 +0,0 @@
-/**
- * Node.js polyfills for browser globals required by @actual-app/api.
- *
- * @actual-app/api v26.3.0 introduced `navigator.platform` usage at the module
- * top level (inside the Electron/browser bundle) which crashes on Node.js with
- * `ReferenceError: navigator is not defined`. v26.6.0 additionally reads
- * `navigator.userAgent` at the top level (`navigator.userAgent.includes(...)`
- * plus a UAParser call), so the polyfill must define `userAgent` too or the
- * bundle throws `Cannot read properties of undefined (reading 'includes')`.
- *
- * Node 21+ ships a native `navigator` that already carries both fields, so this
- * polyfill only fires on Node 20 (still inside the documented "Node.js 20+"
- * support range, and the version several CI workflows run on).
- *
- * This file must be imported BEFORE any `@actual-app/api` import so that the
- * global is defined when the bundle is first evaluated.
- */
-if (typeof globalThis.navigator === 'undefined') {
-    Object.defineProperty(globalThis, 'navigator', {
-        value: {
-            platform: process.platform === 'win32' ? 'Win32' : 'Linux',
-            userAgent: `Node.js/${process.version}`,
-        },
-        writable: true,
-        configurable: true,
-    });
-}
-export {};

package/dist/src/server/httpServer_testing.js

@@ -1,401 +0,0 @@
-import { z } from 'zod';
-import { randomUUID } from 'crypto';
-import express from 'express';
-import { Server } from './streamable-http.js';
-import { StreamableHTTPServerTransport } from './streamable-http.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from './streamable-http.js';
-import logger from '../logger.js';
-// don't log at import time — only log when the server is actually started
-// console.error('Starting Streamable HTTP server...');
-// top-level logging removed so message is not printed at import-time
-// logger.info('Starting Streamable HTTP server (will be logged when startHttpServer is called)');
-export async function startHttpServer(mcp, port, httpPath) {
-    logger.info('Starting Streamable HTTP server (testing)...');
-    const app = express();
-    app.use(express.json());
-    // Map sessionId to transport
-    const transports = new Map();
-    // Tool schemas and types
-    // ToolSchema isn't typed here; we'll cast request params at runtime below
-    // Define tool schemas
-    const HelloWorldSchema = z.object({
-        name: z.string().describe("The name to greet")
-    });
-    const GetServerInfoSchema = z.object({});
-    const LongRunningTestSchema = z.object({
-        duration: z.number().optional().default(30).describe("Duration in seconds (default: 30)"),
-        steps: z.number().optional().default(10).describe("Number of progress steps (default: 10)"),
-        message: z.string().optional().describe("Optional message to include in the response")
-    });
-    const SlowTestSchema = z.object({
-        message: z.string().optional().describe("Optional message to include in the response"),
-        steps: z.number().optional().default(20).describe("Number of progress steps (default: 20)")
-    });
-    // Tool names enum
-    let ToolName;
-    (function (ToolName) {
-        ToolName["HELLO_WORLD"] = "hello_world";
-        ToolName["GET_SERVER_INFO"] = "get_server_info";
-        ToolName["LONG_RUNNING_TEST"] = "long_running_test";
-        ToolName["SLOW_TEST"] = "slow_test";
-    })(ToolName || (ToolName = {}));
-    // Function to create a new MCP server instance
-    function createServerInstance() {
-        const server = new Server({
-            name: "simple-streamable-http-mcp-server",
-            version: "1.0.0",
-        }, {
-            instructions: "A simple test MCP server implemented with Streamable HTTP transport. Supports basic tools and long-running operations with progress updates.",
-            capabilities: {
-                tools: {}
-            }
-        });
-        // Set up the list tools handler
-        server.setRequestHandler(ListToolsRequestSchema, async () => {
-            logger.debug('[TOOLS LIST] Listing available tools');
-            const tools = [
-                {
-                    name: ToolName.HELLO_WORLD,
-                    description: "A simple tool that returns a greeting",
-                    inputSchema: z.toJSONSchema(HelloWorldSchema),
-                },
-                {
-                    name: ToolName.GET_SERVER_INFO,
-                    description: "Get information about the server",
-                    inputSchema: z.toJSONSchema(GetServerInfoSchema),
-                },
-                {
-                    name: ToolName.LONG_RUNNING_TEST,
-                    description: "A test tool that demonstrates long-running operations with progress updates",
-                    inputSchema: z.toJSONSchema(LongRunningTestSchema),
-                },
-                {
-                    name: ToolName.SLOW_TEST,
-                    description: "A test tool that takes 10 minutes to complete and returns timing information",
-                    inputSchema: z.toJSONSchema(SlowTestSchema),
-                }
-            ];
-            return { tools };
-        });
-        // Set up the call tool handler
-        server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
-            const req = request;
-            const params = req?.params ?? {};
-            const name = params.name;
-            const args = params.arguments;
-            logger.debug(`[TOOL CALL] Tool: ${name}, Args: ${JSON.stringify(args, null, 2)}`);
-            debug(`Tool request details: ${JSON.stringify(params, null, 2)}`);
-            if (name === ToolName.HELLO_WORLD) {
-                const validatedArgs = HelloWorldSchema.parse(args);
-                debug(`hello_world tool called with args:`, validatedArgs);
-                await new Promise(resolve => setTimeout(resolve, 200));
-                return {
-                    content: [{
-                            type: "text",
-                            text: `Hello, ${validatedArgs.name}! Welcome to the MCP server.`
-                        }]
-                };
-            }
-            if (name === ToolName.GET_SERVER_INFO) {
-                debug(`get_server_info tool called`);
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                name: "Simple Streamable HTTP MCP Server",
-                                version: "1.0.0",
-                                features: ["tools"],
-                                timestamp: new Date().toISOString()
-                            }, null, 2)
-                        }]
-                };
-            }
-            if (name === ToolName.LONG_RUNNING_TEST) {
-                const validatedArgs = LongRunningTestSchema.parse(args);
-                const { duration = 30, steps = 10, message } = validatedArgs;
-                const startTime = new Date();
-                const startTimestamp = startTime.toISOString();
-                debug(`long_running_test started at: ${startTimestamp}, duration: ${duration}s, steps: ${steps}`);
-                // Get progress token if available
-                const progressToken = params['_meta'] ? params['_meta']?.progressToken : undefined;
-                const stepDurationMs = (duration * 1000) / steps;
-                // Send progress updates
-                for (let i = 1; i <= steps; i++) {
-                    await new Promise(resolve => setTimeout(resolve, stepDurationMs));
-                    if (progressToken !== undefined) {
-                        try {
-                            logger.debug(`[PROGRESS] Sending progress update: ${i}/${steps} for token: ${progressToken}`);
-                            await server.notification({
-                                method: "notifications/progress",
-                                params: {
-                                    progress: i,
-                                    total: steps,
-                                    progressToken,
-                                },
-                            }, { relatedRequestId: (extra && typeof extra === 'object' && 'requestId' in extra ? extra['requestId'] : undefined) });
-                            logger.debug(`[PROGRESS] Successfully sent progress update: ${i}/${steps}`);
-                        }
-                        catch (error) {
-                            logger.error(`[PROGRESS ERROR] Failed to send progress notification: ${String(error)}`);
-                        }
-                    }
-                    else {
-                        debug(`No progress token provided, skipping progress update ${i}/${steps}`);
-                    }
-                }
-                const endTime = new Date();
-                const endTimestamp = endTime.toISOString();
-                const actualDurationMs = endTime.getTime() - startTime.getTime();
-                debug(`long_running_test completed at: ${endTimestamp}`);
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                message: message || "Long-running test completed successfully",
-                                start: startTimestamp,
-                                finish: endTimestamp,
-                                requestedDuration: duration,
-                                actualDuration: {
-                                    milliseconds: actualDurationMs,
-                                    seconds: actualDurationMs / 1000
-                                },
-                                steps: steps
-                            }, null, 2)
-                        }]
-                };
-            }
-            if (name === ToolName.SLOW_TEST) {
-                const validatedArgs = SlowTestSchema.parse(args);
-                const { message, steps = 20 } = validatedArgs;
-                const startTime = new Date();
-                const startTimestamp = startTime.toISOString();
-                debug(`slow_test tool started at: ${startTimestamp}`);
-                // Get progress token if available
-                const progressToken = params['_meta'] ? params['_meta']?.progressToken : undefined;
-                // Wait for 10 minutes (600,000 milliseconds)
-                const tenMinutesMs = 10 * 60 * 1000;
-                const stepDurationMs = tenMinutesMs / steps;
-                // Send progress updates
-                for (let i = 1; i <= steps; i++) {
-                    await new Promise(resolve => setTimeout(resolve, stepDurationMs));
-                    if (progressToken !== undefined) {
-                        try {
-                            logger.debug(`[PROGRESS] Sending progress update: ${i}/${steps} for token: ${progressToken}`);
-                            await server.notification({
-                                method: "notifications/progress",
-                                params: {
-                                    progress: i,
-                                    total: steps,
-                                    progressToken,
-                                },
-                            }, { relatedRequestId: (extra && typeof extra === 'object' && 'requestId' in extra ? extra['requestId'] : undefined) });
-                            logger.debug(`[PROGRESS] Successfully sent progress update: ${i}/${steps}`);
-                        }
-                        catch (error) {
-                            logger.error(`[PROGRESS ERROR] Failed to send progress notification: ${String(error)}`);
-                        }
-                    }
-                    else {
-                        debug(`No progress token provided, skipping progress update ${i}/${steps}`);
-                    }
-                    // Log progress every 5 steps
-                    if (i % 5 === 0) {
-                        const elapsedMinutes = (i / steps) * 10;
-                        logger.info(`[SLOW_TEST] Progress: ${i}/${steps} steps (${elapsedMinutes.toFixed(1)} minutes elapsed)`);
-                    }
-                }
-                const endTime = new Date();
-                const endTimestamp = endTime.toISOString();
-                const durationMs = endTime.getTime() - startTime.getTime();
-                const durationMinutes = durationMs / (60 * 1000);
-                debug(`slow_test tool completed at: ${endTimestamp}`);
-                return {
-                    content: [{
-                            type: "text",
-                            text: JSON.stringify({
-                                message: message || "Slow test completed successfully",
-                                start: startTimestamp,
-                                finish: endTimestamp,
-                                duration: {
-                                    milliseconds: durationMs,
-                                    seconds: durationMs / 1000,
-                                    minutes: durationMinutes
-                                },
-                                steps: steps
-                            }, null, 2)
-                        }]
-                };
-            }
-            throw new Error(`Unknown tool: ${name}`);
-        });
-        return { server };
-    }
-    // Handle POST requests
-    app.post(httpPath, async (req, res) => {
-        logger.debug('Received MCP POST request');
-        logger.debug('Request method: %s', req.body?.method);
-        debug('Headers:', JSON.stringify(req.headers, null, 2));
-        debug('Body:', JSON.stringify(req.body, null, 2));
-        try {
-            // Check for existing session ID
-            const sessionId = req.headers['mcp-session-id'];
-            let transport;
-            if (sessionId && transports.has(sessionId)) {
-                // Reuse existing transport
-                transport = transports.get(sessionId);
-                logger.debug(`[SESSION] Reusing existing transport for session ${sessionId}`);
-            }
-            else if (!sessionId) {
-                // New initialization request
-                logger.debug('[SESSION] Creating new server for initialization request');
-                const { server } = createServerInstance();
-                transport = new StreamableHTTPServerTransport({
-                    sessionIdGenerator: () => randomUUID(),
-                    enableJsonResponse: true,
-                    onsessioninitialized: (sessionId) => {
-                        transports.set(sessionId, transport);
-                    }
-                });
-                // Set up onclose handler to clean up transport when closed
-                server.onclose = async () => {
-                    const sid = transport.sessionId;
-                    if (sid && transports.has(sid)) {
-                        transports.delete(sid);
-                    }
-                };
-                // Connect the transport to the MCP server BEFORE handling the request
-                await server.connect(transport);
-                await transport.handleRequest(req, res, req.body);
-                return; // Already handled
-            }
-            else {
-                // Invalid request - session ID provided but not found
-                res.status(400).json({
-                    jsonrpc: '2.0',
-                    error: {
-                        code: -32000,
-                        message: 'Bad Request: Invalid session ID',
-                    },
-                    id: req?.body?.id,
-                });
-                return;
-            }
-            // Handle the request with existing transport
-            await transport.handleRequest(req, res, req.body);
-        }
-        catch (error) {
-            logger.error('Error handling MCP request: %s', String(error));
-            if (!res.headersSent) {
-                res.status(500).json({
-                    jsonrpc: '2.0',
-                    error: {
-                        code: -32603,
-                        message: 'Internal server error',
-                    },
-                    id: req?.body?.id,
-                });
-            }
-        }
-    });
-    // Handle GET requests for SSE streams
-    app.get(httpPath, async (req, res) => {
-        logger.debug('Received MCP GET request');
-        const sessionId = req.headers['mcp-session-id'];
-        if (!sessionId || !transports.has(sessionId)) {
-            res.status(400).json({
-                jsonrpc: '2.0',
-                error: {
-                    code: -32000,
-                    message: 'Bad Request: No valid session ID provided',
-                },
-                id: null,
-            });
-            return;
-        }
-        const lastEventId = req.headers['last-event-id'];
-        if (lastEventId) {
-            logger.debug(`Client reconnecting with Last-Event-ID: ${lastEventId}`);
-        }
-        else {
-            logger.debug(`Establishing new SSE stream for session ${sessionId}`);
-        }
-        const transport = transports.get(sessionId);
-        await transport.handleRequest(req, res);
-    });
-    // Handle DELETE requests for session termination
-    app.delete(httpPath, async (req, res) => {
-        const sessionId = req.headers['mcp-session-id'];
-        if (!sessionId || !transports.has(sessionId)) {
-            res.status(400).json({
-                jsonrpc: '2.0',
-                error: {
-                    code: -32000,
-                    message: 'Bad Request: No valid session ID provided',
-                },
-                id: null,
-            });
-            return;
-        }
-        logger.debug(`Received session termination request for session ${sessionId}`);
-        try {
-            const transport = transports.get(sessionId);
-            await transport.handleRequest(req, res, req.body);
-        }
-        catch (error) {
-            logger.error('Error handling session termination: %s', String(error));
-            if (!res.headersSent) {
-                res.status(500).json({
-                    jsonrpc: '2.0',
-                    error: {
-                        code: -32603,
-                        message: 'Error handling session termination',
-                    },
-                    id: null,
-                });
-            }
-        }
-    });
-    // Health check endpoint
-    app.get('/health', (req, res) => {
-        res.json({
-            status: 'ok',
-            server: {
-                name: "simple-streamable-http-mcp-server",
-                version: "1.0.0"
-            },
-            transport: 'streamable-http',
-            activeSessions: transports.size
-        });
-    });
-    // Start server
-    app.listen(port, () => {
-        logger.info(`MCP Streamable HTTP Server listening on port ${port}`);
-        logger.info(`📨 MCP endpoint: http://localhost:${port}${httpPath}`);
-        logger.info(`❤️  Health check: http://localhost:${port}/health`);
-        logger.info(`🛠️  Available tools: hello_world, get_server_info, long_running_test, slow_test`);
-    });
-    // Handle server shutdown
-    process.on('SIGINT', async () => {
-        logger.info('Shutting down server...');
-        // Close all active transports
-        for (const [sessionId, transport] of transports) {
-            try {
-                logger.debug(`Closing transport for session ${sessionId}`);
-                await transport.close();
-                transports.delete(sessionId);
-            }
-            catch (error) {
-                logger.error(`Error closing transport for session ${sessionId}: ${String(error)}`);
-            }
-        }
-        logger.info('Server shutdown complete');
-        process.exit(0);
-    });
-}
-const debug = (...args) => {
-    if (process.env.DEBUG === 'true' || process.env.DEBUG === '1') {
-        // safely stringify args to avoid implicit any spread
-        const s = args.map(a => (typeof a === 'string' ? a : JSON.stringify(a))).join(' ');
-        console.debug('[DEBUG]', s);
-    }
-};

package/dist/src/server/streamable-http.js

@@ -1,148 +0,0 @@
-// Minimal TypeScript shim for the absent `streamable-http` package.
-// Implements only the surface used by src/server/httpServer.ts.
-import crypto from 'crypto';
-export const ListToolsRequestSchema = Symbol('ListToolsRequestSchema');
-export const CallToolRequestSchema = Symbol('CallToolRequestSchema');
-export const ToolSchema = {};
-export class Server {
-    meta;
-    options;
-    handlers;
-    transports;
-    onclose;
-    constructor(meta = {}, options = {}) {
-        this.meta = meta;
-        this.options = options;
-        this.handlers = new Map();
-        this.transports = new Set();
-    }
-    setRequestHandler(schema, handler) {
-        this.handlers.set(schema, handler);
-    }
-    async connect(transport) {
-        this.transports.add(transport);
-        // Attach reference for test shims (loose typing intentionally preserved here)
-        try {
-            transport.server = this;
-        }
-        catch { }
-    }
-    async notification(payload, opts) {
-        for (const t of this.transports) {
-            if (typeof t.pushNotification === 'function') {
-                try {
-                    await t.pushNotification(payload);
-                }
-                catch {
-                    // ignore
-                }
-            }
-        }
-    }
-    // allow handlers to be invoked by transports (shim convenience)
-    async invokeHandler(schema, req, extra) {
-        const handler = this.handlers.get(schema);
-        if (!handler)
-            throw new Error('Handler not registered');
-        return handler(req, extra);
-    }
-}
-export class StreamableHTTPServerTransport {
-    opts;
-    sessionId;
-    server;
-    closed = false;
-    constructor(opts = {}) {
-        this.opts = opts;
-        this.sessionId = null;
-        this.server = null;
-    }
-    async pushNotification(_payload) {
-        // noop
-    }
-    async handleRequest(req, res, bodyFromCaller) {
-        const payload = (bodyFromCaller && Object.keys(bodyFromCaller).length ? bodyFromCaller : (req.body ?? {}));
-        const method = payload.method;
-        // Always include session ID in response headers if we have one
-        if (this.sessionId) {
-            res.setHeader('MCP-Session-Id', this.sessionId);
-        }
-        if (method === 'initialize') {
-            this.sessionId =
-                typeof this.opts.sessionIdGenerator === 'function'
-                    ? this.opts.sessionIdGenerator()
-                    : crypto.randomUUID?.() ?? `local-${Math.random().toString(36).slice(2, 10)}`;
-            if (typeof this.opts.onsessioninitialized === 'function') {
-                try {
-                    this.opts.onsessioninitialized(this.sessionId);
-                }
-                catch { }
-            }
-            // Provide a robust initialize result with safe defaults so MCP clients
-            // that validate serverInstructions / capabilities / tools won't error.
-            const result = {
-                protocolVersion: '2025-06-18',
-                identifier: 'actual-mcp-server',
-                // capabilities expected to be an object like { tools: { ... } }
-                capabilities: this.server?.options?.capabilities ?? { tools: {} },
-                // some clients expect serverInstructions to exist (object or string)
-                serverInstructions: this.server?.options?.serverInstructions ?? '',
-                // advertise known tools when available
-                tools: this.server?.options?.implementedTools ?? [],
-            };
-            // Set the MCP-Session-Id header so clients can make subsequent requests
-            res.setHeader('MCP-Session-Id', this.sessionId);
-            res.json({ jsonrpc: '2.0', id: payload.id ?? null, result });
-            return;
-        }
-        if (method === 'tools/list') {
-            if (!this.server) {
-                res.status(500).json({ jsonrpc: '2.0', id: payload.id ?? null, error: { message: 'Server not connected' } });
-                return;
-            }
-            try {
-                const r = await this.server.invokeHandler(ListToolsRequestSchema, { params: {} });
-                res.json({ jsonrpc: '2.0', id: payload.id ?? null, result: r });
-                return;
-            }
-            catch (e) {
-                res.status(500).json({ jsonrpc: '2.0', id: payload.id ?? null, error: { message: String(e) } });
-                return;
-            }
-        }
-        if (method === 'tools/call' && payload.params && payload.params.name) {
-            if (!this.server) {
-                res.status(500).json({ jsonrpc: '2.0', id: payload.id ?? null, error: { message: 'Server not connected' } });
-                return;
-            }
-            try {
-                const params = payload.params;
-                const r = await this.server.invokeHandler(CallToolRequestSchema, { params: { name: params.name, arguments: params.arguments ?? {} } }, {});
-                res.json({ jsonrpc: '2.0', id: payload.id ?? null, result: r });
-                return;
-            }
-            catch (e) {
-                res.status(500).json({ jsonrpc: '2.0', id: payload.id ?? null, error: { message: String(e) } });
-                return;
-            }
-        }
-        if (method === 'ping') {
-            if (payload.id !== undefined)
-                res.json({ jsonrpc: '2.0', id: payload.id, result: {} });
-            else
-                res.status(200).end();
-            return;
-        }
-        if (typeof method === 'string' && method.startsWith('notifications/')) {
-            res.status(200).end();
-            return;
-        }
-        res.status(404).json({ jsonrpc: '2.0', id: payload.id ?? null, error: { code: -32601, message: 'Method not found' } });
-    }
-    async close() {
-        this.closed = true;
-        if (this.server && typeof this.server.removeTransport === 'function') {
-            this.server.removeTransport(this);
-        }
-    }
-}