@descent-vtt/spec-guard 0.11.0 → 0.12.0

package/dist/vendor/spec-core/jsonrpc/mcp.js

@@ -0,0 +1,353 @@
+/**
+ * The Model Context Protocol over JSON-RPC 2.0, without an SDK.
+ *
+ * MCP over stdio is JSON-RPC 2.0, one message per line, and what a server must
+ * get right fits here: framing, the two eras of the protocol, and the methods
+ * that serve tools, resources and prompts. The official SDK brings a schema
+ * library and a dependency tree to do the same; every spec-* tool promises no
+ * runtime dependencies. Moved here from spec-guard (its ADR-0012), where it
+ * was first written and measured, so that a second server does not relearn it.
+ *
+ * Two eras, served side by side. Revisions up to 2025-11-25 open with an
+ * `initialize` handshake; 2026-07-28 has none, and every request carries its
+ * protocol version in `_meta`. Clients of both are in use - the newest
+ * revision is not yet the one most clients speak - so each request is
+ * classified on its own, by the rule the TypeScript SDK's server applies: a
+ * request that claims a version in `_meta` is modern and its claim is
+ * validated; anything else, `initialize` included, is legacy.
+ *
+ * Nothing here touches a stream or a file. A server is a function from one
+ * parsed message to the message owed back; `serveLines` binds one to any
+ * source of bytes with `on('data')`, which on Node is `process.stdin`.
+ */
+/** Revisions that carry their version on every request. Newest first. */
+export const MODERN_PROTOCOL_VERSIONS = ['2026-07-28'];
+/** Revisions negotiated by `initialize`, newest first - the SDK's own list. */
+export const LEGACY_PROTOCOL_VERSIONS = ['2025-11-25', '2025-06-18', '2025-03-26', '2024-11-05', '2024-10-07'];
+export const PROTOCOL_VERSION_KEY = 'io.modelcontextprotocol/protocolVersion';
+export const CLIENT_CAPABILITIES_KEY = 'io.modelcontextprotocol/clientCapabilities';
+export const CLIENT_INFO_KEY = 'io.modelcontextprotocol/clientInfo';
+export const SERVER_INFO_KEY = 'io.modelcontextprotocol/serverInfo';
+export const PARSE_ERROR = -32700;
+export const INVALID_REQUEST = -32600;
+export const METHOD_NOT_FOUND = -32601;
+export const INVALID_PARAMS = -32602;
+export const INTERNAL_ERROR = -32603;
+/** Resource not found before 2026-07-28, which forbids it in favour of -32602. */
+export const LEGACY_RESOURCE_NOT_FOUND = -32002;
+export const UNSUPPORTED_PROTOCOL_VERSION = -32022;
+/** An error that becomes a JSON-RPC error response with its code. */
+export class ProtocolError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.name = 'ProtocolError';
+        this.code = code;
+        this.data = data;
+    }
+}
+export function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** JSON-RPC allows a null id; MCP does not, and wants an integer if a number. */
+export function isRequestId(value) {
+    return typeof value === 'string' || Number.isInteger(value);
+}
+/**
+ * What is wrong with a request's `_meta` once it claims a protocol version,
+ * or `undefined`. A claim is never ignored: a malformed one is an error, not
+ * a reason to fall back to the legacy handling.
+ */
+export function envelopeIssue(meta) {
+    if (!(CLIENT_CAPABILITIES_KEY in meta))
+        return `${CLIENT_CAPABILITIES_KEY}: missing`;
+    if (typeof meta[PROTOCOL_VERSION_KEY] !== 'string')
+        return `${PROTOCOL_VERSION_KEY}: expected a string`;
+    if (!isObject(meta[CLIENT_CAPABILITIES_KEY]))
+        return `${CLIENT_CAPABILITIES_KEY}: expected an object`;
+    const info = meta[CLIENT_INFO_KEY];
+    if (info !== undefined && !(isObject(info) && typeof info['name'] === 'string' && typeof info['version'] === 'string')) {
+        return `${CLIENT_INFO_KEY}: expected an object with a string name and version`;
+    }
+    return undefined;
+}
+/**
+ * The era a request belongs to, or the error that answers it instead.
+ *
+ * `initialize` is the legacy handshake unless it carries a valid modern claim.
+ * Any other request is modern exactly when `_meta` holds the version key - its
+ * presence is the claim, whatever its value - and legacy otherwise.
+ */
+export function classifyRequest(method, params) {
+    const meta = params?.['_meta'];
+    const claimed = isObject(meta) && PROTOCOL_VERSION_KEY in meta;
+    if (!claimed)
+        return 'legacy';
+    const issue = envelopeIssue(meta);
+    const version = meta[PROTOCOL_VERSION_KEY];
+    const supported = issue === undefined && MODERN_PROTOCOL_VERSIONS.includes(version);
+    if (method === 'initialize' && !supported)
+        return 'legacy';
+    if (issue !== undefined)
+        throw new ProtocolError(INVALID_PARAMS, `Invalid _meta envelope: ${issue}`);
+    if (!supported) {
+        throw new ProtocolError(UNSUPPORTED_PROTOCOL_VERSION, 'Unsupported protocol version', {
+            supported: [...MODERN_PROTOCOL_VERSIONS],
+            requested: version,
+        });
+    }
+    return 'modern';
+}
+/** The version `initialize` settles on: the one asked for, or the newest legacy one. */
+export function negotiateLegacyVersion(requested) {
+    return LEGACY_PROTOCOL_VERSIONS.includes(requested) ? requested : LEGACY_PROTOCOL_VERSIONS[0];
+}
+/** A tool's failure, reported to the model rather than as a protocol error it cannot read. */
+export function toolError(text) {
+    return { text, isError: true };
+}
+/**
+ * Arguments a tool does not declare, which the model should hear about rather
+ * than have silently dropped. `undefined` when there are none.
+ */
+export function unknownArguments(args, allowed) {
+    const unknown = Object.keys(args).filter((name) => !allowed.includes(name));
+    if (unknown.length === 0)
+        return undefined;
+    const list = unknown.map((name) => `"${name}"`).join(', ');
+    const takes = allowed.length === 0
+        ? 'no arguments'
+        : allowed.length === 1
+            ? allowed[0]
+            : `${allowed.slice(0, -1).join(', ')} and ${allowed[allowed.length - 1]}`;
+    return toolError(`Unknown argument${unknown.length === 1 ? '' : 's'} ${list}; this tool takes ${takes}.`);
+}
+/**
+ * Builds the function that answers one parsed JSON-RPC message: the message
+ * to send back, or `null` when nothing is owed - a notification, or a
+ * response the client should not have sent.
+ */
+export function createMcpServer(definition) {
+    const serverInfo = { name: definition.name, version: definition.version };
+    const tools = definition.tools ?? [];
+    const prompts = definition.prompts ?? [];
+    const capabilities = {
+        ...(tools.length > 0 ? { tools: {} } : {}),
+        ...(definition.resources !== undefined ? { resources: {} } : {}),
+        ...(prompts.length > 0 ? { prompts: {} } : {}),
+    };
+    const refuseCursor = (params) => {
+        if (params?.['cursor'] !== undefined)
+            throw new ProtocolError(INVALID_PARAMS, 'Invalid cursor: this server does not paginate.');
+    };
+    const callTool = async (params) => {
+        const name = params['name'];
+        if (typeof name !== 'string')
+            throw new ProtocolError(INVALID_PARAMS, 'tools/call needs the name of a tool.');
+        const tool = tools.find((candidate) => candidate.descriptor.name === name);
+        if (tool === undefined)
+            throw new ProtocolError(INVALID_PARAMS, `Unknown tool: ${name}`);
+        const args = params['arguments'] ?? {};
+        if (!isObject(args))
+            throw new ProtocolError(INVALID_PARAMS, 'Tool arguments must be an object.');
+        let outcome;
+        try {
+            outcome = await tool.call(args);
+        }
+        catch (error) {
+            outcome = toolError(`${definition.name} failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return {
+            content: [{ type: 'text', text: outcome.text }],
+            ...(outcome.structured === undefined ? {} : { structuredContent: outcome.structured }),
+            ...(outcome.isError === true ? { isError: true } : {}),
+        };
+    };
+    const readResource = async (params, era) => {
+        const uri = params['uri'];
+        if (typeof uri !== 'string')
+            throw new ProtocolError(INVALID_PARAMS, 'resources/read needs a uri.');
+        const contents = await definition.resources.read(uri);
+        if (contents === null) {
+            throw new ProtocolError(era === 'modern' ? INVALID_PARAMS : LEGACY_RESOURCE_NOT_FOUND, 'Resource not found', { uri });
+        }
+        return { contents: [...contents] };
+    };
+    const getPrompt = async (params) => {
+        const name = params['name'];
+        if (typeof name !== 'string')
+            throw new ProtocolError(INVALID_PARAMS, 'prompts/get needs the name of a prompt.');
+        const prompt = prompts.find((candidate) => candidate.descriptor.name === name);
+        if (prompt === undefined)
+            throw new ProtocolError(INVALID_PARAMS, `Unknown prompt: ${name}`);
+        const args = params['arguments'] ?? {};
+        if (!isObject(args) || !Object.values(args).every((value) => typeof value === 'string')) {
+            throw new ProtocolError(INVALID_PARAMS, 'Prompt arguments must be an object of strings.');
+        }
+        return prompt.get(args);
+    };
+    const dispatch = async (method, params, era) => {
+        const given = params ?? {};
+        if (era === 'legacy') {
+            if (method === 'initialize') {
+                return {
+                    protocolVersion: negotiateLegacyVersion(given['protocolVersion']),
+                    capabilities,
+                    serverInfo,
+                    instructions: definition.instructions,
+                };
+            }
+            if (method === 'ping')
+                return {};
+        }
+        else if (method === 'server/discover') {
+            return { supportedVersions: [...MODERN_PROTOCOL_VERSIONS], capabilities, instructions: definition.instructions };
+        }
+        // A method for a capability the server did not declare does not exist on
+        // it: the answer is the one for any unknown method, not an empty list that
+        // reads as "declared, and empty".
+        const family = method.slice(0, method.indexOf('/') + 1);
+        if ((family === 'tools/' && tools.length === 0) ||
+            (family === 'resources/' && definition.resources === undefined) ||
+            (family === 'prompts/' && prompts.length === 0)) {
+            throw new ProtocolError(METHOD_NOT_FOUND, 'Method not found');
+        }
+        switch (method) {
+            case 'tools/list':
+                refuseCursor(params);
+                return { tools: tools.map((tool) => tool.descriptor) };
+            case 'tools/call':
+                return callTool(given);
+            case 'resources/list':
+                refuseCursor(params);
+                return { resources: [...(await definition.resources.list())] };
+            case 'resources/templates/list':
+                refuseCursor(params);
+                return { resourceTemplates: [...(definition.resources.templates ?? [])] };
+            case 'resources/read':
+                return readResource(given, era);
+            case 'prompts/list':
+                refuseCursor(params);
+                return { prompts: prompts.map((prompt) => prompt.descriptor) };
+            case 'prompts/get':
+                return getPrompt(given);
+            default:
+                throw new ProtocolError(METHOD_NOT_FOUND, 'Method not found');
+        }
+    };
+    /** The 2026-07-28 shape: a result type, caching hints where required, and identity. */
+    const modernResult = (method, result) => {
+        const cacheable = method !== 'tools/call';
+        return {
+            resultType: 'complete',
+            ...result,
+            ...(cacheable ? { ttlMs: definition.cacheTtlMs ?? 0, cacheScope: 'private' } : {}),
+            _meta: { [SERVER_INFO_KEY]: serverInfo },
+        };
+    };
+    return async (message) => {
+        if (!isObject(message)) {
+            return {
+                jsonrpc: '2.0',
+                error: {
+                    code: INVALID_REQUEST,
+                    message: Array.isArray(message) ? 'Invalid Request: batches are not supported' : 'Invalid Request',
+                },
+            };
+        }
+        const { id, method, params } = message;
+        if (message['jsonrpc'] === '2.0' && method === undefined && isRequestId(id) && ('result' in message || 'error' in message)) {
+            return null;
+        }
+        if (message['jsonrpc'] !== '2.0' || typeof method !== 'string' || (id !== undefined && !isRequestId(id))) {
+            return { jsonrpc: '2.0', ...(isRequestId(id) ? { id } : {}), error: { code: INVALID_REQUEST, message: 'Invalid Request' } };
+        }
+        if (id === undefined)
+            return null;
+        try {
+            if (params !== undefined && !isObject(params))
+                throw new ProtocolError(INVALID_PARAMS, 'params must be an object.');
+            const era = classifyRequest(method, params);
+            const result = await dispatch(method, params, era);
+            return { jsonrpc: '2.0', id, result: era === 'modern' ? modernResult(method, result) : result };
+        }
+        catch (error) {
+            const failure = error instanceof ProtocolError
+                ? { code: error.code, message: error.message, data: error.data }
+                : { code: INTERNAL_ERROR, message: `Internal error: ${error instanceof Error ? error.message : String(error)}` };
+            return { jsonrpc: '2.0', id, error: failure };
+        }
+    };
+}
+/** The key a request is tracked under: `1` and `"1"` are different ids. */
+function trackingKey(id) {
+    return `${typeof id}:${id}`;
+}
+/**
+ * Serves a handler over newline-delimited JSON-RPC until the input ends.
+ *
+ * Messages are split on `\n`; a CRLF line keeps its `\r`, which JSON reads
+ * as whitespace. Blank lines are skipped, and every response is written as a
+ * single line - `JSON.stringify` never emits a raw newline, which is what the
+ * binding requires. Requests are answered concurrently, in whatever order
+ * they finish. A request the client cancels gets no response. When the input
+ * closes, requests still running finish and then this resolves.
+ */
+export function serveLines(input, write, handle) {
+    return new Promise((resolve, reject) => {
+        const decoder = new TextDecoder();
+        let buffer = '';
+        let running = 0;
+        let ended = false;
+        const inFlight = new Set();
+        const cancelled = new Set();
+        const settle = () => {
+            if (ended && running === 0)
+                resolve();
+        };
+        const receive = (line) => {
+            if (line.trim() === '')
+                return;
+            let message;
+            try {
+                message = JSON.parse(line);
+            }
+            catch {
+                write(JSON.stringify({ jsonrpc: '2.0', error: { code: PARSE_ERROR, message: 'Parse error' } }));
+                return;
+            }
+            if (isObject(message) && message['method'] === 'notifications/cancelled') {
+                const requestId = isObject(message['params']) ? message['params']['requestId'] : undefined;
+                if (isRequestId(requestId) && inFlight.has(trackingKey(requestId)))
+                    cancelled.add(trackingKey(requestId));
+                return;
+            }
+            const key = isObject(message) && typeof message['method'] === 'string' ? trackingKey(message['id']) : undefined;
+            inFlight.add(key);
+            running += 1;
+            void handle(message).then((response) => {
+                running -= 1;
+                inFlight.delete(key);
+                if (!cancelled.delete(key) && response !== null)
+                    write(JSON.stringify(response));
+                settle();
+            });
+        };
+        input.on('data', (chunk) => {
+            buffer += decoder.decode(chunk, { stream: true });
+            for (let newline = buffer.indexOf('\n'); newline !== -1; newline = buffer.indexOf('\n')) {
+                const line = buffer.slice(0, newline);
+                buffer = buffer.slice(newline + 1);
+                receive(line);
+            }
+        });
+        input.once('end', () => {
+            ended = true;
+            receive(buffer + decoder.decode());
+            settle();
+        });
+        input.once('error', reject);
+    });
+}
+//# sourceMappingURL=mcp.js.map

package/dist/vendor/spec-core/jsonrpc/mcp.js.map

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

package/dist/vendor/spec-core/markdown/frontmatter.d.ts

@@ -0,0 +1,104 @@
+/**
+ * A reader and editor for the front matter the spec-* tools use: a flat bag
+ * of YAML scalars and lists, and optionally one level of nested mapping.
+ *
+ * Supported: `key: value` lines; plain, single-quoted and double-quoted
+ * scalars; inline `[a, b]` sequences; block `- item` sequences; `#` comments.
+ * Plain scalars follow the YAML 1.2 core schema, so `yes` is a word and `035`
+ * keeps its leading zero for whoever reads it as text. With `nested`, a key
+ * whose value is an indented block of keys is read as `parent.child` entries.
+ *
+ * Anything richer - deeper nesting, block scalars, anchors, tags, a value
+ * continued onto the next line - is recognised and reported as unsupported
+ * rather than guessed at. A YAML library would parse more, but it would not
+ * give back the line and the offset of every value, and a report has to point
+ * at the value it is about, and an edit has to leave every other line of the
+ * file as it was.
+ */
+import type { FrontMatterKind } from './types.js';
+export interface YamlScalar {
+    readonly text: string;
+    readonly quoted: boolean;
+}
+export type YamlValue = {
+    readonly kind: 'scalar';
+    readonly scalar: YamlScalar;
+} | {
+    readonly kind: 'list';
+    readonly items: readonly YamlScalar[];
+} | {
+    readonly kind: 'unsupported';
+    readonly reason: string;
+};
+export interface FrontMatterEntry {
+    /** The key as written; a nested key is its parent's and its own, joined by a dot. */
+    readonly key: string;
+    /** The key compared: {@link keyName} of `key`, so `depends-on` is `dependsOn`. */
+    readonly name: string;
+    /** The parent key as written, for a nested key; `null` at the top level. */
+    readonly parent: string | null;
+    /** 0-based line of the key. */
+    readonly line: number;
+    /** 0-based line after the entry's last line. */
+    readonly end: number;
+    /** Offset of the key in the text read. */
+    readonly keyStart: number;
+    /**
+     * Offsets of the value as written: a quoted scalar with its quotes, an
+     * inline list with its brackets, a block list from its first item's text to
+     * its last item's. An empty value is the empty range just past the colon.
+     */
+    readonly valueStart: number;
+    readonly valueEnd: number;
+    readonly value: YamlValue;
+}
+export interface FrontMatterProblem {
+    /** 0-based line. */
+    readonly line: number;
+    readonly message: string;
+}
+export interface FrontMatter {
+    readonly kind: FrontMatterKind;
+    /** 0-based line of the closing delimiter, or -1 when the block is never closed. */
+    readonly close: number;
+    readonly entries: readonly FrontMatterEntry[];
+    readonly problems: readonly FrontMatterProblem[];
+}
+export interface ReadOptions {
+    /**
+     * Read one level of nested mapping as `parent.child` entries, instead of
+     * reporting the parent's value as unsupported.
+     */
+    readonly nested?: boolean;
+}
+/** The kind of front matter a document's first line opens, or `null` when it opens none. */
+export declare function frontMatterKind(firstLine: string): FrontMatterKind | null;
+/** Whether a line closes front matter of a kind: `---` or `...` for YAML, `+++` for TOML. */
+export declare function frontMatterCloses(line: string, kind: FrontMatterKind): boolean;
+export declare function keyName(key: string): string;
+/**
+ * Reads the front matter at the top of a text, or `null` when there is none.
+ *
+ * A leading byte-order mark is not part of the text read: offsets count from
+ * the character after it, as a scan's do.
+ */
+export declare function readFrontMatter(source: string, options?: ReadOptions): FrontMatter | null;
+/** Parses a value written on the key's own line. `text` is trimmed and non-empty. */
+export declare function parseInline(text: string): YamlValue;
+/** Null in the YAML 1.2 core schema: empty, `~` or `null` in any of its three spellings. */
+export declare function isNull(scalar: YamlScalar): boolean;
+/** Renders a string as a scalar that reads back as the same string. */
+export declare function renderScalar(value: string): string;
+export declare function findEntry(frontMatter: FrontMatter | null, key: string): FrontMatterEntry | undefined;
+/**
+ * Sets one key, leaving every other line as it was.
+ *
+ * `lines` are the lines of the text the front matter was read from, as
+ * `splitLines` gives them. An existing entry keeps the spelling and the
+ * indentation of its key; a new one goes last, at the top level. A text with
+ * no front matter gains a block.
+ */
+export declare function setEntry(lines: readonly string[], frontMatter: FrontMatter | null, key: string, rendered: string): string[];
+/** Removes one key and its value lines; a key that is absent changes nothing. */
+export declare function removeEntry(lines: readonly string[], frontMatter: FrontMatter | null, key: string): string[];
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/vendor/spec-core/markdown/frontmatter.d.ts.map

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