@evercam/mcp 0.0.1

package/dist/src/tools/snapshots.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Evercam } from "@evercam/sdk";
+export declare function registerSnapshotTools(server: McpServer, evercam: Evercam): void;
+//# sourceMappingURL=snapshots.d.ts.map

package/dist/src/tools/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../../src/tools/snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAItC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA6H/E"}

package/dist/src/tools/snapshots.js

@@ -0,0 +1,83 @@
+import { z } from "zod";
+import { imageContent, safeText } from "../utils/toolOutput.js";
+export function registerSnapshotTools(server, evercam) {
+    server.tool("get-live-snapshot-url", "Get the live snapshot URL for a camera", {
+        cameraExid: z.string().describe("Camera exid"),
+    }, async ({ cameraExid }) => {
+        const camera = await evercam.getCamera(cameraExid);
+        const url = camera.getSnapshotUrl({ timestamp: new Date() });
+        return safeText({ url });
+    });
+    server.tool("get-snapshot-image", "Get a camera snapshot as MCP image content (base64) or as a URL", {
+        cameraExid: z.string().describe("Camera exid"),
+        timestamp: z.string().optional().describe("Optional ISO 8601 timestamp"),
+        mode: z.enum(["image", "url"]).optional().describe("Return mode: image (base64) or url"),
+        maxBytes: z
+            .number()
+            .optional()
+            .describe("Maximum allowed image size in bytes (default: 2,000,000)"),
+    }, async ({ cameraExid, timestamp, mode, maxBytes }) => {
+        const camera = await evercam.getCamera(cameraExid);
+        const snapTime = timestamp ? new Date(timestamp) : new Date();
+        const url = camera.getSnapshotUrl({ timestamp: snapTime });
+        const selectedMode = mode ?? "image";
+        if (selectedMode === "url") {
+            return safeText({ url, cameraExid, timestamp: snapTime.toISOString() });
+        }
+        const axiosInstance = evercam.axios ?? evercam.api?.axios;
+        const response = await axiosInstance.get(url, { responseType: "arraybuffer" });
+        const bytes = Buffer.from(response.data);
+        const limit = maxBytes ?? 2_000_000;
+        if (bytes.length > limit) {
+            throw new Error(`Snapshot too large (${bytes.length} bytes). Increase maxBytes or use mode=url`);
+        }
+        const mimeType = response.headers["content-type"] ?? "image/jpeg";
+        return imageContent(bytes.toString("base64"), mimeType);
+    });
+    server.tool("get-snapshot-at", "Get the recorded snapshot nearest to a given timestamp", {
+        cameraExid: z.string().describe("Camera exid"),
+        timestamp: z.string().describe("ISO 8601 timestamp"),
+    }, async ({ cameraExid, timestamp }) => {
+        const data = await evercam.api.recordings.nearest(cameraExid, timestamp);
+        return safeText(data);
+    });
+    server.tool("get-latest-snapshot", "Get the most recent recorded snapshot for a camera", {
+        cameraExid: z.string().describe("Camera exid"),
+    }, async ({ cameraExid }) => {
+        const data = await evercam.api.recordings.latest(cameraExid);
+        return safeText(data);
+    });
+    server.tool("get-oldest-snapshot", "Get the oldest recorded snapshot for a camera", {
+        cameraExid: z.string().describe("Camera exid"),
+    }, async ({ cameraExid }) => {
+        const data = await evercam.api.recordings.oldest(cameraExid);
+        return safeText(data);
+    });
+    server.tool("list-available-days", "List days that have recorded snapshots for a camera in a given month", {
+        cameraExid: z.string().describe("Camera exid"),
+        year: z.number().describe("Year (e.g. 2024)"),
+        month: z.number().describe("Month 1-12"),
+    }, async ({ cameraExid, year, month }) => {
+        const data = await evercam.api.recordings.availableDays({
+            cameraId: cameraExid,
+            year: String(year),
+            month: String(month),
+        });
+        return safeText(data);
+    });
+    server.tool("list-available-hours", "List hours within a specific day that have recordings for a camera", {
+        cameraExid: z.string().describe("Camera exid"),
+        year: z.number().describe("Year (e.g. 2024)"),
+        month: z.number().describe("Month 1-12"),
+        day: z.number().describe("Day 1-31"),
+    }, async ({ cameraExid, year, month, day }) => {
+        const data = await evercam.api.recordings.availableHours({
+            cameraId: cameraExid,
+            year: String(year),
+            month: String(month),
+            day: String(day),
+        });
+        return safeText(data);
+    });
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/src/tools/snapshots.js.map

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

package/dist/src/tools/weather.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { Evercam } from "@evercam/sdk";
+export declare function registerWeatherTools(server: McpServer, evercam: Evercam): void;
+//# sourceMappingURL=weather.d.ts.map

package/dist/src/tools/weather.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather.d.ts","sourceRoot":"","sources":["../../../src/tools/weather.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAItC,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAY9E"}

package/dist/src/tools/weather.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import { safeText } from "../utils/toolOutput.js";
+export function registerWeatherTools(server, evercam) {
+    server.tool("get-project-weather", "Get current weather conditions at a project site", {
+        projectExid: z.string().describe("Project exid"),
+    }, async ({ projectExid }) => {
+        const data = await evercam.weather.current(projectExid, {});
+        return safeText(data);
+    });
+}
+//# sourceMappingURL=weather.js.map

package/dist/src/tools/weather.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weather.js","sourceRoot":"","sources":["../../../src/tools/weather.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,OAAgB;IACtE,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,kDAAkD,EAClD;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;KACjD,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAS,CAAC,CAAA;QAClE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAA;IACvB,CAAC,CACF,CAAA;AACH,CAAC"}

package/dist/src/transports/http.d.ts

@@ -0,0 +1,24 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Evercam } from "@evercam/sdk";
+export type HttpOptions = {
+    port?: number;
+    /** Origins allowed for browser requests. Defaults to * — change in production. */
+    allowedOrigins?: string | string[];
+    /** Tool call timeout in milliseconds. Defaults to 30 000. */
+    timeout?: number;
+    /**
+     * If set, all /tools and /mcp requests must include:
+     *   Authorization: ApiKey <apiKey>
+     */
+    apiKey?: string;
+    /** If set, only these tool names are callable via the HTTP REST endpoint. */
+    allowedTools?: string[];
+    /** Tool names blocked from the HTTP REST endpoint. */
+    deniedTools?: string[];
+    /** Rate limit for POST /tools/:toolName. Defaults to 60 req/min per IP. */
+    rateLimit?: {
+        maxPerMinute: number;
+    };
+};
+export declare function startHttp(server: McpServer, evercam: Evercam | null, portOrOptions?: number | HttpOptions): Promise<void>;
+//# sourceMappingURL=http.d.ts.map

package/dist/src/transports/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/transports/http.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAInE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAK3C,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAClC,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,2EAA2E;IAC3E,SAAS,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;CACrC,CAAA;AA6HD,wBAAsB,SAAS,CAC7B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,OAAO,GAAG,IAAI,EACvB,aAAa,GAAE,MAAM,GAAG,WAAkB,GACzC,OAAO,CAAC,IAAI,CAAC,CAgRf"}

package/dist/src/transports/http.js

@@ -0,0 +1,373 @@
+import express from "express";
+import cors from "cors";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { randomUUID } from "node:crypto";
+import { callToolDirect } from "../utils/callTool.js";
+import { log } from "../utils/logger.js";
+import { normalizeError } from "../utils/errors.js";
+// ── Rate limiter ─────────────────────────────────────────────────────────────
+const rateLimitStore = new Map();
+function checkRateLimit(ip, maxPerMinute) {
+    const now = Date.now();
+    const entry = rateLimitStore.get(ip) ?? { count: 0, windowStart: now };
+    if (now - entry.windowStart > 60_000) {
+        entry.count = 0;
+        entry.windowStart = now;
+    }
+    entry.count++;
+    rateLimitStore.set(ip, entry);
+    return entry.count <= maxPerMinute;
+}
+// ── Circuit breaker ───────────────────────────────────────────────────────────
+const CIRCUIT_FAILURE_THRESHOLD = 5;
+const CIRCUIT_OPEN_MS = 30_000;
+const circuitBreakers = new Map();
+function getCircuit(toolName) {
+    if (!circuitBreakers.has(toolName)) {
+        circuitBreakers.set(toolName, { failures: 0, openUntil: null, halfOpen: false });
+    }
+    return circuitBreakers.get(toolName);
+}
+function isCircuitOpen(toolName) {
+    const cb = getCircuit(toolName);
+    if (!cb.openUntil)
+        return false;
+    if (Date.now() >= cb.openUntil) {
+        cb.halfOpen = true;
+        cb.openUntil = null;
+        return false;
+    }
+    return true;
+}
+function recordCircuitSuccess(toolName) {
+    const cb = getCircuit(toolName);
+    cb.failures = 0;
+    cb.openUntil = null;
+    cb.halfOpen = false;
+}
+function recordCircuitFailure(toolName) {
+    const cb = getCircuit(toolName);
+    cb.failures++;
+    if (cb.failures >= CIRCUIT_FAILURE_THRESHOLD || cb.halfOpen) {
+        cb.openUntil = Date.now() + CIRCUIT_OPEN_MS;
+        cb.halfOpen = false;
+        log("warn", "circuit_open", { tool: toolName, openForMs: CIRCUIT_OPEN_MS });
+    }
+}
+const metrics = new Map();
+function recordMetric(toolName, durationMs, isError) {
+    const m = metrics.get(toolName) ?? { calls: 0, errors: 0, latencySum: 0 };
+    m.calls++;
+    m.latencySum += durationMs;
+    if (isError)
+        m.errors++;
+    metrics.set(toolName, m);
+}
+function renderMetrics(activeSessions) {
+    const lines = [
+        "# HELP tool_calls_total Total tool invocations",
+        "# TYPE tool_calls_total counter",
+        "# HELP tool_errors_total Total tool error responses",
+        "# TYPE tool_errors_total counter",
+        "# HELP tool_latency_ms_sum Sum of tool call latencies in milliseconds",
+        "# TYPE tool_latency_ms_sum counter",
+        "# HELP tool_latency_ms_count Count of observed tool latencies",
+        "# TYPE tool_latency_ms_count counter",
+        "# HELP mcp_sessions_active Active MCP sessions",
+        "# TYPE mcp_sessions_active gauge",
+        `mcp_sessions_active ${activeSessions}`,
+    ];
+    for (const [tool, m] of metrics) {
+        lines.push(`tool_calls_total{tool="${tool}"} ${m.calls}`);
+        lines.push(`tool_errors_total{tool="${tool}"} ${m.errors}`);
+        lines.push(`tool_latency_ms_sum{tool="${tool}"} ${m.latencySum}`);
+        lines.push(`tool_latency_ms_count{tool="${tool}"} ${m.calls}`);
+    }
+    return lines.join("\n") + "\n";
+}
+// ── HTTP status mapping ───────────────────────────────────────────────────────
+function httpStatusFor(err, message) {
+    const normalized = normalizeError(err);
+    if (typeof normalized.status === "number")
+        return normalized.status;
+    if (/unauthorized|invalid token/i.test(message))
+        return 401;
+    if (/forbidden|not allowed|disabled/i.test(message))
+        return 403;
+    if (/not found/i.test(message))
+        return 404;
+    if (/rate limit|too many/i.test(message))
+        return 429;
+    if (err && typeof err === "object" && "response" in err) {
+        const status = err.response?.status;
+        if (typeof status === "number")
+            return status;
+    }
+    if (err && typeof err === "object" && "issues" in err)
+        return 400;
+    return 500;
+}
+// ── API key middleware ────────────────────────────────────────────────────────
+function requireApiKey(apiKey) {
+    return (req, res, next) => {
+        if (req.headers.authorization === `ApiKey ${apiKey}`)
+            return next();
+        res.status(401).json({ error: "Invalid or missing API key" });
+    };
+}
+// ── Main server ───────────────────────────────────────────────────────────────
+export async function startHttp(server, evercam, portOrOptions = 4004) {
+    const options = typeof portOrOptions === "number" ? { port: portOrOptions } : portOrOptions;
+    const port = options.port ?? 4004;
+    const origins = options.allowedOrigins ?? "*";
+    const timeoutMs = options.timeout ?? 30_000;
+    const maxPerMinute = options.rateLimit?.maxPerMinute ?? 60;
+    const app = express();
+    app.use(express.json({ limit: "1mb" }));
+    // ── In-flight tracking for graceful shutdown ────────────────────────────
+    let inFlight = 0;
+    app.use((_req, res, next) => {
+        inFlight++;
+        res.on("finish", () => inFlight--);
+        next();
+    });
+    // ── Request logging middleware ─────────────────────────────────────────
+    app.use((req, res, next) => {
+        const requestId = randomUUID().slice(0, 8);
+        req.__requestId = requestId;
+        res.setHeader("X-Request-Id", requestId);
+        const start = Date.now();
+        res.on("finish", () => {
+            log("info", "http_request", {
+                requestId,
+                method: req.method,
+                path: req.path,
+                status: res.statusCode,
+                durationMs: Date.now() - start,
+            });
+        });
+        next();
+    });
+    app.use(cors({
+        origin: origins,
+        methods: ["GET", "POST", "OPTIONS"],
+        allowedHeaders: ["Content-Type", "Authorization"],
+    }));
+    // Apply API key gate if configured
+    if (options.apiKey) {
+        app.use("/tools", requireApiKey(options.apiKey));
+        app.use("/mcp", requireApiKey(options.apiKey));
+    }
+    const transports = new Map();
+    const sessionLastSeen = new Map();
+    const SESSION_IDLE_TTL_MS = 15 * 60_000;
+    const sessionGcTimer = setInterval(() => {
+        const now = Date.now();
+        for (const [sid, ts] of sessionLastSeen) {
+            if (now - ts > SESSION_IDLE_TTL_MS) {
+                transports.delete(sid);
+                sessionLastSeen.delete(sid);
+                log("warn", "mcp_session_evicted_idle", { sessionId: sid, idleMs: now - ts });
+            }
+        }
+    }, 60_000);
+    sessionGcTimer.unref();
+    // ── Health / readiness ─────────────────────────────────────────────────
+    app.get("/health", async (req, res) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const toolCount = Object.keys(server._registeredTools ?? {}).length;
+        if (req.query.ready === "1" && evercam) {
+            try {
+                await evercam.api.projects.index();
+                res.json({ status: "ready", tools: toolCount });
+            }
+            catch (err) {
+                const msg = normalizeError(err).message;
+                res.status(503).json({ status: "degraded", error: msg, tools: toolCount });
+            }
+        }
+        else {
+            res.json({ status: "ok", tools: toolCount });
+        }
+    });
+    // ── Metrics ────────────────────────────────────────────────────────────
+    app.get("/metrics", (_req, res) => {
+        res.setHeader("Content-Type", "text/plain; version=0.0.4; charset=utf-8");
+        res.send(renderMetrics(transports.size));
+    });
+    // ── Authenticated snapshot proxy ───────────────────────────────────────
+    app.get("/snapshot/:cameraExid", async (req, res) => {
+        if (!evercam) {
+            res.status(503).json({ error: "Evercam not configured" });
+            return;
+        }
+        const { cameraExid } = req.params;
+        try {
+            const camera = await evercam.getCamera(cameraExid);
+            const url = camera.getSnapshotUrl({ timestamp: new Date() });
+            const axiosInstance = evercam.axios ?? evercam.api?.axios;
+            const response = await axiosInstance.get(url, { responseType: "stream" });
+            res.setHeader("Content-Type", response.headers["content-type"] ?? "image/jpeg");
+            res.setHeader("Cache-Control", "public, max-age=10");
+            response.data.pipe(res);
+        }
+        catch {
+            if (!res.headersSent)
+                res.status(404).end();
+        }
+    });
+    // ── REST tool endpoint ─────────────────────────────────────────────────
+    app.post("/tools/:toolName", async (req, res) => {
+        const requestId = req.__requestId;
+        const { toolName } = req.params;
+        const ip = req.ip ?? "unknown";
+        // Rate limit
+        if (!checkRateLimit(ip, maxPerMinute)) {
+            res.status(429).setHeader("Retry-After", "60").json({ error: "Rate limit exceeded" });
+            return;
+        }
+        // Tool allowlist / denylist
+        if (options.allowedTools?.length && !options.allowedTools.includes(toolName)) {
+            res.status(403).json({ error: `Tool '${toolName}' not allowed in HTTP mode` });
+            return;
+        }
+        if (options.deniedTools?.includes(toolName)) {
+            res.status(403).json({ error: `Tool '${toolName}' is disabled in HTTP mode` });
+            return;
+        }
+        // Circuit breaker check
+        if (isCircuitOpen(toolName)) {
+            res
+                .status(503)
+                .json({ error: `Circuit open for tool '${toolName}' — upstream failing, retry in 30s` });
+            return;
+        }
+        const start = Date.now();
+        try {
+            const result = await Promise.race([
+                callToolDirect(server, toolName, req.body ?? {}),
+                new Promise((_, reject) => setTimeout(() => reject(new Error(`Tool call timed out after ${timeoutMs}ms`)), timeoutMs)),
+            ]);
+            const durationMs = Date.now() - start;
+            const isError = !!result?.isError;
+            recordCircuitSuccess(toolName);
+            recordMetric(toolName, durationMs, isError);
+            log("info", "tool_call", {
+                requestId,
+                tool: toolName,
+                durationMs,
+                status: isError ? "error" : "success",
+            });
+            res.json(result);
+        }
+        catch (err) {
+            const durationMs = Date.now() - start;
+            const message = normalizeError(err).message;
+            recordCircuitFailure(toolName);
+            recordMetric(toolName, durationMs, true);
+            log("error", "tool_call_failed", { requestId, tool: toolName, durationMs, error: message });
+            res.status(httpStatusFor(err, message)).json({ error: message });
+        }
+    });
+    // Expose registered tool metadata so clients can render dynamic tool pickers.
+    app.get("/tools", (_req, res) => {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const tools = server._registeredTools;
+        if (!tools) {
+            res.json([]);
+            return;
+        }
+        const list = Object.entries(tools).map(([name, tool]) => ({
+            name,
+            description: tool.description ?? "",
+            inputSchema: tool.inputSchema ?? {},
+            enabled: tool.enabled !== false,
+        }));
+        res.json(list);
+    });
+    // ── MCP Streamable HTTP transport ─────────────────────────────────────
+    app.all("/mcp", async (req, res) => {
+        const sessionId = req.headers["mcp-session-id"];
+        let transport;
+        if (sessionId) {
+            transport = transports.get(sessionId);
+            if (!transport) {
+                res.status(404).json({ error: "Session not found" });
+                return;
+            }
+            sessionLastSeen.set(sessionId, Date.now());
+        }
+        else if (req.method === "POST" && isInitializeRequest(req.body)) {
+            transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: () => randomUUID(),
+                onsessioninitialized: (sid) => {
+                    transports.set(sid, transport);
+                    sessionLastSeen.set(sid, Date.now());
+                },
+            });
+            transport.onclose = () => {
+                const sid = transport?.sessionId;
+                if (sid) {
+                    transports.delete(sid);
+                    sessionLastSeen.delete(sid);
+                }
+            };
+            await server.connect(transport);
+        }
+        else {
+            res.status(400).json({
+                jsonrpc: "2.0",
+                error: { code: -32000, message: "Bad Request: No valid session ID provided" },
+                id: null,
+            });
+            return;
+        }
+        try {
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (err) {
+            const message = normalizeError(err).message;
+            log("error", "mcp_transport_error", { error: message });
+            if (!res.headersSent) {
+                res.status(500).json({ jsonrpc: "2.0", error: { code: -32603, message }, id: null });
+            }
+        }
+    });
+    const httpServer = app.listen(port, () => {
+        log("info", "server_started", { port });
+        console.log(`\nEvercam MCP server listening on http://localhost:${port}`);
+        console.log(`  Health:           GET  http://localhost:${port}/health`);
+        console.log(`  Readiness:        GET  http://localhost:${port}/health?ready=1`);
+        console.log(`  Metrics:          GET  http://localhost:${port}/metrics`);
+        console.log(`  Tools list:       GET  http://localhost:${port}/tools`);
+        console.log(`  Call a tool:      POST http://localhost:${port}/tools/:toolName`);
+        console.log(`  MCP endpoint:     ALL  http://localhost:${port}/mcp\n`);
+    });
+    // ── Graceful shutdown ──────────────────────────────────────────────────
+    const shutdown = () => {
+        log("info", "shutdown_initiated");
+        console.log("\n[evercam-mcp] Shutting down...");
+        httpServer.close();
+        const deadline = Date.now() + 5_000;
+        const poll = () => {
+            if (inFlight === 0 || Date.now() >= deadline) {
+                log("info", "shutdown_complete", { inFlight });
+                clearInterval(sessionGcTimer);
+                process.exit(0);
+            }
+            else {
+                setTimeout(poll, 100);
+            }
+        };
+        poll();
+    };
+    process.on("SIGTERM", shutdown);
+    process.on("SIGINT", shutdown);
+    // Last-resort guard — individual tool errors are caught per-request above.
+    process.on("unhandledRejection", (reason) => {
+        const message = normalizeError(reason).message;
+        log("error", "unhandled_rejection", { error: message });
+    });
+}
+//# sourceMappingURL=http.js.map

package/dist/src/transports/http.js.map

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

package/dist/src/transports/stdio.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function startStdio(server: McpServer): Promise<void>;
+//# sourceMappingURL=stdio.d.ts.map

package/dist/src/transports/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/transports/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGnE,wBAAsB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjE"}

package/dist/src/transports/stdio.js

@@ -0,0 +1,6 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+export async function startStdio(server) {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=stdio.js.map

package/dist/src/transports/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../../src/transports/stdio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAEhF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAiB;IAChD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;IAC5C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;AACjC,CAAC"}

package/dist/src/utils/callTool.d.ts

@@ -0,0 +1,18 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Call an MCP tool handler directly without going through a transport.
+ * Used by the HTTP REST endpoint (POST /tools/:toolName).
+ *
+ * This function accesses private fields on McpServer (_registeredTools,
+ * validateToolInput, executeToolHandler). These are undocumented internals.
+ * Call validateCallToolInternals() at server startup to catch SDK version
+ * breakage early rather than at runtime.
+ */
+export declare function callToolDirect(server: McpServer, toolName: string, args: unknown): Promise<unknown>;
+/**
+ * Verify that the private MCP SDK fields this module depends on still exist.
+ * Call once after McpServer is created and tools are registered.
+ * Throws with a clear message if the SDK has changed its internals.
+ */
+export declare function validateCallToolInternals(server: McpServer): void;
+//# sourceMappingURL=callTool.d.ts.map

package/dist/src/utils/callTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callTool.d.ts","sourceRoot":"","sources":["../../../src/utils/callTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAIxE;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAajE"}