@skenora/tooling 0.1.2

package/dist/mcp-http.js

@@ -0,0 +1,279 @@
+import { SKENORA_MCP_PROTOCOL_VERSION, createSkenoraMcpErrorResponse, getSkenoraMcpRequestProtocolVersion, validateSkenoraMcpModernRequest, } from "./mcp.js";
+const LOOPBACK_HOSTS = Object.freeze(["127.0.0.1", "localhost", "[::1]"]);
+/**
+ * Creates a fetch-compatible MCP 2026-07-28 HTTP handler. It does not open a
+ * socket, own an Editor, or implement an authorization server.
+ */
+export function createSkenoraMcpHttpHandler(server, options = {}) {
+    const path = normalizePath(options.path ?? "/mcp");
+    const allowedHosts = normalizeStringSet(options.allowedHosts ?? LOOPBACK_HOSTS, "allowedHosts");
+    const allowedOrigins = normalizeStringSet(options.allowedOrigins ?? [], "allowedOrigins");
+    const maxBodyBytes = normalizeBodyLimit(options.maxBodyBytes);
+    const authorizationMetadataUrl = normalizeAuthorizationMetadataUrl(options.authorizationMetadataUrl);
+    if (server.authoring && !options.authenticate) {
+        throw new Error("An authoring MCP HTTP handler requires an authenticate callback");
+    }
+    if (server.authoring && !authorizationMetadataUrl) {
+        throw new Error("An authoring MCP HTTP handler requires authorizationMetadataUrl");
+    }
+    return async (request) => {
+        const url = new URL(request.url);
+        if (url.pathname !== path)
+            return textResponse(404, "Not Found");
+        if (request.method !== "POST") {
+            return textResponse(405, "Method Not Allowed", { Allow: "POST" });
+        }
+        if (!allowedHosts.has(url.hostname.toLocaleLowerCase())) {
+            return textResponse(403, "Forbidden host");
+        }
+        const origin = request.headers.get("origin");
+        if (origin && !allowedOrigins.has(origin.toLocaleLowerCase())) {
+            return textResponse(403, "Forbidden origin");
+        }
+        const contentType = request.headers.get("content-type") ?? "";
+        if (mediaType(contentType) !== "application/json") {
+            return jsonRpcResponse(createSkenoraMcpErrorResponse(null, -32600, "Expected application/json"), 415);
+        }
+        const contentLength = parseContentLength(request.headers.get("content-length"));
+        if (contentLength !== null && contentLength > maxBodyBytes) {
+            return jsonRpcResponse(createSkenoraMcpErrorResponse(null, -32600, "Request body too large"), 413);
+        }
+        let principal;
+        if (options.authenticate) {
+            let authenticated;
+            try {
+                authenticated = await options.authenticate(request);
+            }
+            catch {
+                return jsonRpcResponse(createSkenoraMcpErrorResponse(null, -32603, "Internal error"), 500);
+            }
+            if (!authenticated) {
+                return jsonRpcResponse(createSkenoraMcpErrorResponse(null, -32001, "Authorization required"), 401, authorizationHeaders(authorizationMetadataUrl));
+            }
+            try {
+                principal = normalizePrincipal(authenticated);
+            }
+            catch {
+                return jsonRpcResponse(createSkenoraMcpErrorResponse(null, -32603, "Internal error"), 500);
+            }
+        }
+        const bodyBytes = await readBoundedBody(request, maxBodyBytes);
+        if (!bodyBytes) {
+            return jsonRpcResponse(createSkenoraMcpErrorResponse(null, -32600, "Request body too large"), 413);
+        }
+        let body;
+        try {
+            body = new TextDecoder("utf-8", { fatal: true }).decode(bodyBytes);
+        }
+        catch {
+            return jsonRpcResponse(createSkenoraMcpErrorResponse(null, -32700, "Parse error"), 400);
+        }
+        let input;
+        try {
+            input = JSON.parse(body);
+        }
+        catch {
+            return jsonRpcResponse(createSkenoraMcpErrorResponse(null, -32700, "Parse error"), 400);
+        }
+        const protocolIssue = validateModernHeaders(request.headers, input);
+        if (protocolIssue) {
+            return jsonRpcResponse(createSkenoraMcpErrorResponse(requestId(input), protocolIssue.code, protocolIssue.message, protocolIssue.data), 400, { "MCP-Protocol-Version": SKENORA_MCP_PROTOCOL_VERSION });
+        }
+        const response = await server.handle(input, {
+            transport: "http",
+            protocolVersion: SKENORA_MCP_PROTOCOL_VERSION,
+            ...(principal === undefined ? {} : { principal }),
+            signal: request.signal,
+        });
+        if (!response)
+            return new Response(null, { status: 202 });
+        return jsonRpcResponse(response, 200, {
+            "MCP-Protocol-Version": SKENORA_MCP_PROTOCOL_VERSION,
+        });
+    };
+}
+function validateModernHeaders(headers, input) {
+    const notification = isRecord(input) && input.id === undefined;
+    const envelopeIssue = validateSkenoraMcpModernRequest(input);
+    if (notification)
+        return envelopeIssue;
+    const version = headers.get("mcp-protocol-version");
+    const bodyVersion = getSkenoraMcpRequestProtocolVersion(input);
+    if (bodyVersion !== undefined && version !== bodyVersion) {
+        return {
+            code: -32020,
+            message: "MCP protocol version header does not match params._meta",
+        };
+    }
+    if (version !== SKENORA_MCP_PROTOCOL_VERSION) {
+        return version === null
+            ? {
+                code: -32020,
+                message: "MCP-Protocol-Version header is required",
+            }
+            : {
+                code: -32022,
+                message: `Unsupported MCP protocol version: ${version}`,
+                data: { supportedVersions: [SKENORA_MCP_PROTOCOL_VERSION] },
+            };
+    }
+    if (envelopeIssue)
+        return envelopeIssue;
+    if (!isRecord(input) || typeof input.method !== "string")
+        return null;
+    const method = headers.get("mcp-method");
+    if (method !== input.method) {
+        return {
+            code: -32020,
+            message: "Mcp-Method header does not match method",
+        };
+    }
+    const expectedName = requestName(input);
+    if (expectedName !== null && headers.get("mcp-name") !== expectedName) {
+        return {
+            code: -32020,
+            message: "Mcp-Name header does not match request parameters",
+        };
+    }
+    return null;
+}
+async function readBoundedBody(request, maxBodyBytes) {
+    if (!request.body)
+        return new Uint8Array();
+    const reader = request.body.getReader();
+    const chunks = [];
+    let bytes = 0;
+    while (true) {
+        const next = await reader.read();
+        if (next.done)
+            break;
+        bytes += next.value.byteLength;
+        if (bytes > maxBodyBytes) {
+            try {
+                await reader.cancel("Request body too large");
+            }
+            catch {
+                // The limit decision is final even if the producer rejects cancellation.
+            }
+            return null;
+        }
+        chunks.push(next.value);
+    }
+    const body = new Uint8Array(bytes);
+    let offset = 0;
+    for (const chunk of chunks) {
+        body.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return body;
+}
+function requestName(input) {
+    if (!isRecord(input.params))
+        return null;
+    if (input.method === "tools/call") {
+        return typeof input.params.name === "string" ? input.params.name : null;
+    }
+    if (input.method === "resources/read") {
+        return typeof input.params.uri === "string" ? input.params.uri : null;
+    }
+    return null;
+}
+function mediaType(value) {
+    return (value.split(";", 1)[0] ?? "").trim().toLocaleLowerCase();
+}
+function normalizePrincipal(input) {
+    if (!input.subject || input.subject !== input.subject.trim()) {
+        throw new Error("MCP principal subject must be normalized and non-empty");
+    }
+    if (input.scopes &&
+        (!Array.isArray(input.scopes) ||
+            !input.scopes.every((scope) => typeof scope === "string" &&
+                scope === scope.trim() &&
+                scope.length > 0))) {
+        throw new Error("MCP principal scopes must be normalized strings");
+    }
+    return Object.freeze({
+        subject: input.subject,
+        ...(input.scopes
+            ? { scopes: Object.freeze([...new Set(input.scopes)]) }
+            : {}),
+    });
+}
+function normalizePath(value) {
+    if (!value.startsWith("/") || value.includes("?") || value.includes("#")) {
+        throw new Error("MCP HTTP path must be an absolute URL path");
+    }
+    return value;
+}
+function normalizeStringSet(values, name) {
+    if (!Array.isArray(values) ||
+        !values.every((value) => typeof value === "string" && value.trim())) {
+        throw new Error(`${name} must contain non-empty strings`);
+    }
+    return new Set(values.map((value) => value.toLocaleLowerCase()));
+}
+function normalizeBodyLimit(value) {
+    if (value === undefined)
+        return 1024 * 1024;
+    if (!Number.isInteger(value) || value < 1 || value > 16 * 1024 * 1024) {
+        throw new Error("maxBodyBytes must be an integer in 1..16777216");
+    }
+    return value;
+}
+function normalizeAuthorizationMetadataUrl(value) {
+    if (value === undefined)
+        return undefined;
+    const url = new URL(value);
+    const loopback = url.hostname === "127.0.0.1" ||
+        url.hostname === "localhost" ||
+        url.hostname === "[::1]";
+    if ((url.protocol !== "https:" && !(loopback && url.protocol === "http:")) ||
+        url.hash) {
+        throw new Error("authorizationMetadataUrl must be HTTPS, or HTTP on loopback, without a fragment");
+    }
+    return url.href;
+}
+function parseContentLength(value) {
+    if (value === null)
+        return null;
+    const length = Number(value);
+    return Number.isSafeInteger(length) && length >= 0 ? length : null;
+}
+function authorizationHeaders(resourceMetadataUrl) {
+    return resourceMetadataUrl
+        ? {
+            "WWW-Authenticate": `Bearer resource_metadata="${resourceMetadataUrl}"`,
+        }
+        : { "WWW-Authenticate": "Bearer" };
+}
+function jsonRpcResponse(value, status, headers = {}) {
+    return new Response(`${JSON.stringify(value)}\n`, {
+        status,
+        headers: {
+            "Cache-Control": "no-store",
+            "Content-Type": "application/json; charset=utf-8",
+            ...headers,
+        },
+    });
+}
+function textResponse(status, text, headers = {}) {
+    return new Response(`${text}\n`, {
+        status,
+        headers: {
+            "Content-Type": "text/plain; charset=utf-8",
+            ...headers,
+        },
+    });
+}
+function requestId(input) {
+    if (!isRecord(input))
+        return null;
+    const id = input.id;
+    return typeof id === "string" || typeof id === "number" || id === null
+        ? id
+        : null;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=mcp-http.js.map

package/dist/mcp-http.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,79 @@
+export declare const SKENORA_MCP_PROTOCOL_VERSION: "2026-07-28";
+export declare const SKENORA_MCP_LEGACY_PROTOCOL_VERSION: "2025-11-25";
+export interface SkenoraMcpServerInfo {
+    readonly name: string;
+    readonly version: string;
+}
+export interface SkenoraMcpPrincipal {
+    readonly subject: string;
+    readonly scopes?: readonly string[];
+}
+export interface SkenoraMcpRequestContext {
+    readonly transport: "stdio" | "http" | "in-process";
+    readonly protocolVersion?: string;
+    readonly principal?: SkenoraMcpPrincipal;
+    readonly signal?: AbortSignal;
+}
+export interface SkenoraMcpRevisionToken {
+    readonly sceneId: string;
+    readonly sessionEpoch: string;
+    readonly revision: number;
+    readonly documentHash: string;
+}
+export interface SkenoraMcpScenePlanWriteIntent {
+    readonly planHash: string;
+    readonly expectedRevisionToken: SkenoraMcpRevisionToken;
+    readonly idempotencyKey: string;
+    readonly operationId?: string;
+    readonly label?: string;
+    readonly allowVariables: boolean;
+    readonly modelLoadPolicy: "strict";
+}
+export interface SkenoraMcpScenePlanGateway {
+    inspectScene(options?: Readonly<Record<string, unknown>>): unknown | Promise<unknown>;
+    searchResources(query?: Readonly<Record<string, unknown>>): Promise<unknown>;
+    validatePlan(input: unknown, options?: Readonly<Record<string, unknown>>): unknown | Promise<unknown>;
+    applyPlan(input: unknown, options?: Readonly<Record<string, unknown>>): Promise<unknown>;
+    waitOperation(operationId: string, options?: Readonly<Record<string, unknown>>): Promise<unknown> | null;
+}
+export interface SkenoraMcpScenePlanAccessRequest {
+    readonly toolName: string;
+    readonly access: "read" | "write";
+    readonly editorHandle: string;
+    readonly approvalToken?: string;
+    readonly writeIntent?: SkenoraMcpScenePlanWriteIntent;
+}
+export interface SkenoraMcpScenePlanHost {
+    resolve(editorHandle: string, context: SkenoraMcpRequestContext): SkenoraMcpScenePlanGateway | null | Promise<SkenoraMcpScenePlanGateway | null>;
+    authorize(request: SkenoraMcpScenePlanAccessRequest, context: SkenoraMcpRequestContext): void | Promise<void>;
+}
+export interface SkenoraMcpServerOptions {
+    readonly serverInfo?: SkenoraMcpServerInfo;
+    readonly scenePlans?: SkenoraMcpScenePlanHost;
+}
+export interface SkenoraMcpServer {
+    readonly serverInfo: SkenoraMcpServerInfo;
+    readonly authoring: boolean;
+    handle(request: unknown, context?: SkenoraMcpRequestContext): Promise<SkenoraMcpResponse | null>;
+}
+export interface SkenoraMcpResponse {
+    readonly jsonrpc: "2.0";
+    readonly id: string | number | null;
+    readonly result?: unknown;
+    readonly error?: Readonly<{
+        code: number;
+        message: string;
+        data?: unknown;
+    }>;
+}
+export interface SkenoraMcpProtocolIssue {
+    readonly code: number;
+    readonly message: string;
+    readonly data?: unknown;
+}
+export declare function createSkenoraMcpServer(options?: SkenoraMcpServerOptions): SkenoraMcpServer;
+export declare function createSkenoraMcpErrorResponse(id: string | number | null, code: number, message: string, data?: unknown): SkenoraMcpResponse;
+export declare function getSkenoraMcpRequestProtocolVersion(input: unknown): string | undefined;
+export declare function validateSkenoraMcpModernRequest(input: unknown): SkenoraMcpProtocolIssue | null;
+export declare function createSkenoraMcpPlanHash(input: unknown): string;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

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