@toa.io/extensions.exposition 1.0.0-alpha.282 → 1.0.0-alpha.284

package/transpiled/HTTP/formats/index.d.ts

@@ -1,8 +1,16 @@
+/** What a reply may be encoded as, and so what `accept` is negotiated against. */
 export declare const formats: Record<string, Format>;
 export declare const types: string[];
-export interface Format {
+/**
+ * What a request body may arrive as. Everything a reply may be, and a form besides — which
+ * is read and never written, so it is not something a reply can be asked for.
+ */
+export declare const decoders: Record<string, Decoder>;
+export interface Decoder {
     readonly type: string;
+    decode: (buffer: Buffer, charset?: string) => any;
+}
+export interface Format extends Decoder {
     readonly multipart: string;
     encode: (value: any) => Buffer;
-    decode: (buffer: Buffer, charset?: string) => any;
 }

package/transpiled/HTTP/formats/index.js

@@ -2,6 +2,8 @@ import * as json from './json.js';
 import * as yaml from './yaml.js';
 import * as msgpack from './msgpack.js';
 import * as text from './text.js';
+import * as form from './form.js';
+/** What a reply may be encoded as, and so what `accept` is negotiated against. */
 export const formats = {
     [json.type]: json,
     [yaml.type]: yaml,
@@ -9,4 +11,12 @@ export const formats = {
     [msgpack.type]: msgpack
 };
 export const types = Object.keys(formats);
+/**
+ * What a request body may arrive as. Everything a reply may be, and a form besides — which
+ * is read and never written, so it is not something a reply can be asked for.
+ */
+export const decoders = {
+    ...formats,
+    [form.type]: form
+};
 //# sourceMappingURL=index.js.map

package/transpiled/HTTP/formats/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/HTTP/formats/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,MAAM,CAAC,MAAM,OAAO,GAA2B;IAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;IACjB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;IACjB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;IACjB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO;CACxB,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../source/HTTP/formats/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,OAAO,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AACjC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,kFAAkF;AAClF,MAAM,CAAC,MAAM,OAAO,GAA2B;IAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;IACjB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;IACjB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;IACjB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO;CACxB,CAAA;AAED,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAA4B;IAC/C,GAAG,OAAO;IACV,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI;CAClB,CAAA"}

package/transpiled/HTTP/messages.d.ts

@@ -1,6 +1,12 @@
 import { Readable } from 'node:stream';
 import type { Context } from './Context.js';
 import type { ServerResponse } from './types.js';
+/**
+ * Applies what the request accumulated in `pipelines.response` — an `io:output` restriction,
+ * a `vary` a `map` directive owes. Separate from `write` because a message is not always
+ * written: one call of several produces a value the reply is assembled from.
+ */
+export declare function shape(context: Context, message: OutgoingMessage): Promise<void>;
 export declare function write(context: Context, response: ServerResponse, message: OutgoingMessage): Promise<void>;
 export declare function read(context: Context): Promise<any>;
 /**
@@ -14,6 +20,12 @@ export interface OutgoingMessage {
     body?: any;
     /** tag the response with a hash of the encoded body, see `conditional` */
     etag?: boolean;
+    /**
+     * Built by the gateway rather than returned by an operation, as a request is `authentic`
+     * when it was made by one: what is in it is the gateway's own, and the checks that answer
+     * for what an operation returns have nothing to say about it.
+     */
+    authentic?: boolean;
 }
 export interface Query {
     [key: string]: string | number | undefined;

package/transpiled/HTTP/messages.js

@@ -4,15 +4,23 @@ import { pipeline } from 'node:stream/promises';
 import { createHash } from 'node:crypto';
 import * as contentType from 'content-type';
 import { console } from 'openspan';
-import { formats } from './formats/index.js';
+import { decoders } from './formats/index.js';
 import { BadRequest, NotAcceptable, UnsupportedMediaType } from './exceptions.js';
 const server = `Exposition/${JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version}` +
     ((process.env.TOA_CONTEXT === undefined ? '' : ` ${process.env.TOA_CONTEXT}`) +
         (process.env.TOA_ENV === undefined ? '' : `/${process.env.TOA_ENV}`));
 const pending = new Map();
-export async function write(context, response, message) {
+/**
+ * Applies what the request accumulated in `pipelines.response` — an `io:output` restriction,
+ * a `vary` a `map` directive owes. Separate from `write` because a message is not always
+ * written: one call of several produces a value the reply is assembled from.
+ */
+export async function shape(context, message) {
     for (const transform of context.pipelines.response)
         await transform(message);
+}
+export async function write(context, response, message) {
+    await shape(context, message);
     if (message?.status !== undefined)
         response.statusCode = message.status;
     response.setHeader('server', server);
@@ -33,9 +41,9 @@ export async function read(context) {
     if (header === undefined)
         return undefined;
     const { type, parameters } = contentType.parse(header);
-    if (!(type in formats))
+    if (!(type in decoders))
         throw new UnsupportedMediaType();
-    const format = formats[type];
+    const format = decoders[type];
     const buf = await context.buffer();
     try {
         return format.decode(buf, parameters.charset);

package/transpiled/HTTP/messages.js.map

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

package/transpiled/Interception.d.ts

@@ -1,11 +1,14 @@
+import type * as http from './HTTP/index.js';
 import type { Input, Output } from './io.js';
 export declare class Interception implements Interceptor {
     private readonly interceptors;
-    constructor(interceptors: Interceptor[]);
+    constructor(interceptors: Interceptor[], options: http.Options);
     intercept(input: Input): Promise<Output>;
 }
 export interface Interceptor {
     intercept: (input: Input) => Output | Promise<Output>;
     /** Discards whatever the interceptor accumulated while serving. */
     reset?: () => void;
+    /** What the annotation says, for an interceptor that answers from it. */
+    mount?: (options: http.Options) => void;
 }

package/transpiled/Interception.js

@@ -1,11 +1,13 @@
 export class Interception {
     interceptors;
-    constructor(interceptors) {
+    constructor(interceptors, options) {
         this.interceptors = interceptors;
         // interceptors are module singletons, so a second gateway in one process —
         // which is how the features run — would otherwise inherit the first one's state
-        for (const interceptor of interceptors)
+        for (const interceptor of interceptors) {
             interceptor.reset?.();
+            interceptor.mount?.(options);
+        }
     }
     async intercept(input) {
         for (const interceptor of this.interceptors) {

package/transpiled/Interception.js.map

@@ -1 +1 @@
-{"version":3,"file":"Interception.js","sourceRoot":"","sources":["../source/Interception.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAY;IACN,YAAY,CAAe;IAE5C,YAAoB,YAA2B;QAC7C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAEhC,2EAA2E;QAC3E,gFAAgF;QAChF,KAAK,MAAM,WAAW,IAAI,YAAY;YACpC,WAAW,CAAC,KAAK,EAAE,EAAE,CAAA;IACzB,CAAC;IAEM,KAAK,CAAC,SAAS,CAAE,KAAY;QAClC,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YAEjD,IAAI,MAAM,KAAK,IAAI;gBACjB,OAAO,MAAM,CAAA;QACjB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}
+{"version":3,"file":"Interception.js","sourceRoot":"","sources":["../source/Interception.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACN,YAAY,CAAe;IAE5C,YAAoB,YAA2B,EAAE,OAAqB;QACpE,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAEhC,2EAA2E;QAC3E,gFAAgF;QAChF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;YACvC,WAAW,CAAC,KAAK,EAAE,EAAE,CAAA;YACrB,WAAW,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,CAAA;QAC9B,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,SAAS,CAAE,KAAY;QAClC,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YAEjD,IAAI,MAAM,KAAK,IAAI;gBACjB,OAAO,MAAM,CAAA;QACjB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/transpiled/Introspection.d.ts

@@ -1,9 +1,49 @@
 import type { Remote } from '@toa.io/core';
 export interface Introspection {
+    /**
+     * What the route states this method is. The operation states what it is too, and that is
+     * not this: an operation is written without knowledge of any route, and a method is an
+     * operation and a route together — the same operation mounted twice is two methods, and
+     * one sentence cannot be true of both. The operation's own is for the Introspection.
+     */
+    description?: string;
     route?: Record<string, Schema>;
     query?: Record<string, Schema>;
+    /** what a request header carries, which is therefore not the body's to send */
+    headers?: Record<string, Sourced>;
     input?: Schema;
     output?: Schema;
     errors?: string[];
 }
+/** A property the gateway reads from somewhere else, and the schema it was declared with. */
+export interface Sourced {
+    header: string;
+    [keyword: string]: unknown;
+}
 export type Schema = Awaited<ReturnType<Remote['explain']>>['input'];
+/**
+ * The same, in the order the shape states — whatever order the families that filled it ran
+ * in. What a resource says about itself is read, so it is written the way it is documented.
+ */
+export declare function order(introspection: Introspection): Introspection;
+/**
+ * The schema of one input property, taken out of it: a property another family fills is
+ * not the caller's to send, and what took it says where it comes from instead.
+ */
+export declare function take(carrier: Carrier, property: string): Schema | undefined;
+/**
+ * A schema restricted to the properties a whitelist admits, and an array's items where it
+ * describes an array. What is not an object of properties is left alone: a whitelist has
+ * nothing to say about a string.
+ */
+export declare function restrict(schema: Schema | undefined, allowed: Set<string>): Schema | undefined;
+/**
+ * What a schema is read as here: the keywords these narrow, and whatever else it carries.
+ * `Schema` as core declares it requires `properties`, which a schema of a string has not,
+ * so the two are cast through rather than assigned.
+ */
+/** Whatever states an input: an explanation as the operation gave it, or as a route left it. */
+interface Carrier {
+    input?: Schema;
+}
+export {};

package/transpiled/Introspection.js

@@ -1,2 +1,51 @@
-export {};
+/**
+ * The same, in the order the shape states — whatever order the families that filled it ran
+ * in. What a resource says about itself is read, so it is written the way it is documented.
+ */
+export function order(introspection) {
+    const ordered = {};
+    for (const key of KEYS)
+        if (introspection[key] !== undefined)
+            ordered[key] = introspection[key];
+    return ordered;
+}
+const KEYS = ['description', 'route', 'query', 'headers', 'input', 'output', 'errors'];
+/**
+ * The schema of one input property, taken out of it: a property another family fills is
+ * not the caller's to send, and what took it says where it comes from instead.
+ */
+export function take(carrier, property) {
+    const input = carrier.input;
+    const properties = input?.properties;
+    if (input === undefined || input === null || properties === undefined ||
+        !(property in properties))
+        return undefined;
+    const schema = properties[property];
+    delete properties[property];
+    if (input.required !== undefined)
+        input.required = input.required.filter((name) => name !== property);
+    return schema;
+}
+/**
+ * A schema restricted to the properties a whitelist admits, and an array's items where it
+ * describes an array. What is not an object of properties is left alone: a whitelist has
+ * nothing to say about a string.
+ */
+export function restrict(schema, allowed) {
+    const shape = schema;
+    if (shape === undefined || shape === null)
+        return schema;
+    if (shape.items !== undefined)
+        return { ...shape, items: restrict(shape.items, allowed) };
+    if (shape.properties === undefined)
+        return schema;
+    const properties = {};
+    for (const [name, property] of Object.entries(shape.properties))
+        if (allowed.has(name))
+            properties[name] = property;
+    const restricted = { ...shape, properties };
+    if (shape.required !== undefined)
+        restricted.required = shape.required.filter((name) => allowed.has(name));
+    return restricted;
+}
 //# sourceMappingURL=Introspection.js.map

package/transpiled/Introspection.js.map

@@ -1 +1 @@
-{"version":3,"file":"Introspection.js","sourceRoot":"","sources":["../source/Introspection.ts"],"names":[],"mappings":""}
+{"version":3,"file":"Introspection.js","sourceRoot":"","sources":["../source/Introspection.ts"],"names":[],"mappings":"AA4BA;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAE,aAA4B;IACjD,MAAM,OAAO,GAAkB,EAAE,CAAA;IAEjC,KAAK,MAAM,GAAG,IAAI,IAAI;QACpB,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,SAAS;YACjC,OAAO,CAAC,GAAG,CAAa,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IAElD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAA;AAE/F;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAE,OAAgB,EAAE,QAAgB;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAiC,CAAA;IACvD,MAAM,UAAU,GAAG,KAAK,EAAE,UAAU,CAAA;IAEpC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS;QACnE,CAAC,CAAC,QAAQ,IAAI,UAAU,CAAC;QACzB,OAAO,SAAS,CAAA;IAElB,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IAEnC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAA;IAE3B,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC9B,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAA;IAErE,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAE,MAA0B,EAAE,OAAoB;IACxE,MAAM,KAAK,GAAG,MAAkC,CAAA;IAEhD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QACvC,OAAO,MAAM,CAAA;IAEf,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAC3B,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,EAAuB,CAAA;IAEjF,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAChC,OAAO,MAAM,CAAA;IAEf,MAAM,UAAU,GAA2B,EAAE,CAAA;IAE7C,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;QAC7D,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;YACnB,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAA;IAE/B,MAAM,UAAU,GAAU,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,CAAA;IAElD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC9B,UAAU,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IAE1E,OAAO,UAA+B,CAAA;AACxC,CAAC"}

package/transpiled/MCP/Server.d.ts

@@ -0,0 +1,41 @@
+import * as http from '../HTTP/index.js';
+import type { Tree } from '../RTD/index.js';
+import type { MCP } from '../Annotation.js';
+/**
+ * The Model Context Protocol, as one endpoint that remembers nothing between requests.
+ *
+ * Two revisions are answered from it. The modern one carries the version and the client's
+ * capabilities in every request; the one before it opens with `initialize`, which is what
+ * most clients still send. Neither needs a session, and neither needs a stream: every method
+ * here answers one object, which is why this can exist in a package that serves no SSE.
+ */
+export declare class Server {
+    private readonly options;
+    private readonly tree;
+    private readonly discovery;
+    private readonly origins;
+    constructor(options: MCP, tree: Tree);
+    process(context: http.Context, route: http.Processor): Promise<http.OutgoingMessage>;
+    /** Who may reach the endpoint at all, before anything it carries is read. */
+    private admit;
+    private answer;
+    private tool;
+    /**
+     * Every result of the modern revision says what kind it is, and who answered it. Where the
+     * revision names the operation as one whose result may be held, it says that too, and must.
+     */
+    private complete;
+    private serverInfo;
+    /**
+     * Which revision this request is of. `initialize` is one by itself; otherwise the header
+     * says, and a request that names none is of a revision that did not send one.
+     */
+    private version;
+    /**
+     * What the modern revision mirrors into headers, so that what routes a request and what
+     * answers it cannot be told two different things.
+     */
+    private mirrored;
+    /** A body the decoder refuses is a parse error; a media type it does not know is not. */
+    private read;
+}

package/transpiled/MCP/Server.js

@@ -0,0 +1,180 @@
+import { console } from 'openspan';
+import { BRANCH_TTL } from '../const.js';
+import * as http from '../HTTP/index.js';
+import { discovery } from './discover.js';
+import { call, list } from './tools.js';
+import { HEADER_MISMATCH, INVALID_PARAMS, INVALID_REQUEST, METHOD_NOT_FOUND, PARSE, UNSUPPORTED_VERSION, failure, response } from './errors.js';
+import { CLIENT_CAPABILITIES, JSONRPC, LEGACY, MODERN, PROTOCOL_VERSION, SERVER_INFO, VERSIONS } from './types.js';
+/**
+ * The Model Context Protocol, as one endpoint that remembers nothing between requests.
+ *
+ * Two revisions are answered from it. The modern one carries the version and the client's
+ * capabilities in every request; the one before it opens with `initialize`, which is what
+ * most clients still send. Neither needs a session, and neither needs a stream: every method
+ * here answers one object, which is why this can exist in a package that serves no SSE.
+ */
+export class Server {
+    options;
+    tree;
+    discovery;
+    origins;
+    constructor(options, tree) {
+        this.options = options;
+        this.tree = tree;
+        this.discovery = discovery(options);
+        this.origins = new Set(options.origins ?? []);
+    }
+    async process(context, route) {
+        if (context.request.method !== 'POST')
+            throw new http.MethodNotAllowed(new Headers({ allow: 'POST' }));
+        this.admit(context);
+        const message = await this.read(context);
+        const version = this.version(context, message);
+        const modern = version === MODERN;
+        if (modern)
+            this.mirrored(context, message);
+        const result = await this.answer({ context, route, tree: this.tree }, message, modern);
+        // a notification is answered by not answering, and there is nothing here to remember
+        if (message.id === undefined)
+            return { status: ACCEPTED };
+        return {
+            status: OK,
+            body: { jsonrpc: JSONRPC, id: message.id, result },
+            headers: new Headers({ 'cache-control': 'no-store' })
+        };
+    }
+    /** Who may reach the endpoint at all, before anything it carries is read. */
+    admit(context) {
+        const origin = context.request.headers.origin;
+        // the revision requires this against DNS rebinding; a request without one is no browser's
+        if (origin !== undefined && !this.origins.has(origin))
+            throw new http.Forbidden('Origin is not allowed');
+        if (this.options.anonymous === true)
+            return;
+        if (context.identity == null)
+            throw new http.Unauthorized();
+    }
+    async answer(scope, message, modern) {
+        const params = message.params ?? {};
+        switch (message.method) {
+            case 'server/discover':
+                return this.complete(this.discovery.modern, modern, DISCOVERY_CACHE);
+            case 'tools/list':
+                return this.complete({ tools: await list(this.tree, scope.context) }, modern, TOOLS_CACHE);
+            case 'tools/call':
+                return this.complete(await this.tool(scope, params), modern);
+            // what a client of an earlier revision opens with; no session is made and none is named
+            case 'initialize':
+                return this.discovery.legacy(declared(params));
+            case 'notifications/initialized':
+                return null;
+            case 'ping':
+                return {};
+            default:
+                throw new http.NotFound(response(message.id ?? null, failure(METHOD_NOT_FOUND, `'${message.method}' is not a method this server answers`)));
+        }
+    }
+    async tool(scope, params) {
+        const named = params.name;
+        if (typeof named !== 'string')
+            throw new http.BadRequest(response(null, failure(INVALID_PARAMS, '`tools/call` states the tool it calls by name')));
+        const args = params.arguments ?? {};
+        if (typeof args !== 'object' || args === null || Array.isArray(args))
+            throw new http.BadRequest(response(null, failure(INVALID_PARAMS, '`arguments` must be an object')));
+        return await console.span({ name: named }, async () => await call(scope, named, args));
+    }
+    /**
+     * Every result of the modern revision says what kind it is, and who answered it. Where the
+     * revision names the operation as one whose result may be held, it says that too, and must.
+     */
+    complete(result, modern, cache) {
+        return modern
+            ? { ...result, ...cache, resultType: 'complete', _meta: { [SERVER_INFO]: this.serverInfo() } }
+            : result;
+    }
+    serverInfo() {
+        return this.discovery.modern._meta[SERVER_INFO];
+    }
+    /**
+     * Which revision this request is of. `initialize` is one by itself; otherwise the header
+     * says, and a request that names none is of a revision that did not send one.
+     */
+    version(context, message) {
+        if (message.method === 'initialize')
+            return LEGACY;
+        const header = context.request.headers['mcp-protocol-version'];
+        const stated = declared(message.params ?? {});
+        if (header !== undefined && stated !== undefined && header !== stated)
+            throw new http.BadRequest(response(message.id ?? null, failure(HEADER_MISMATCH, `'MCP-Protocol-Version' says '${String(header)}' and the body says '${stated}'`)));
+        const value = header ?? stated;
+        if (value === undefined)
+            return LEGACY;
+        if (!VERSIONS.includes(value))
+            throw new http.BadRequest(response(message.id ?? null, failure(UNSUPPORTED_VERSION, 'Unsupported protocol version', { supported: VERSIONS, requested: value })));
+        return value;
+    }
+    /**
+     * What the modern revision mirrors into headers, so that what routes a request and what
+     * answers it cannot be told two different things.
+     */
+    mirrored(context, message) {
+        const meta = metadata(message.params ?? {});
+        if (meta?.[PROTOCOL_VERSION] === undefined || meta[CLIENT_CAPABILITIES] === undefined)
+            throw new http.BadRequest(response(message.id ?? null, failure(INVALID_PARAMS, `'_meta' states '${PROTOCOL_VERSION}' and '${CLIENT_CAPABILITIES}'`)));
+        const id = message.id ?? null;
+        mirrors(context, { id, header: 'mcp-method', value: message.method });
+        if (message.method === 'tools/call')
+            mirrors(context, { id, header: 'mcp-name', value: (message.params ?? {}).name });
+    }
+    /** A body the decoder refuses is a parse error; a media type it does not know is not. */
+    async read(context) {
+        let body;
+        try {
+            body = await context.body();
+        }
+        catch (exception) {
+            if (exception instanceof http.BadRequest)
+                throw new http.BadRequest(response(null, failure(PARSE, 'Parse error')));
+            throw exception;
+        }
+        if (typeof body !== 'object' || body === null || Array.isArray(body) ||
+            body.jsonrpc !== JSONRPC || typeof body.method !== 'string')
+            throw new http.BadRequest(response(null, failure(INVALID_REQUEST, 'A request carries one JSON-RPC message')));
+        return body;
+    }
+}
+/** What a header says must be what the body says, or what routes and what answers differ. */
+function mirrors(context, mirror) {
+    const { id, header, value } = mirror;
+    const stated = context.request.headers[header];
+    if (stated === undefined)
+        throw new http.BadRequest(response(id, failure(HEADER_MISMATCH, `'${header}' is required`)));
+    if (decode(String(stated)) !== value)
+        throw new http.BadRequest(response(id, failure(HEADER_MISMATCH, `'${header}' says '${String(stated)}' and the body says '${String(value)}'`)));
+}
+function metadata(params) {
+    const meta = params._meta;
+    return typeof meta === 'object' && meta !== null
+        ? meta
+        : undefined;
+}
+function declared(params) {
+    const stated = metadata(params)?.[PROTOCOL_VERSION];
+    return typeof stated === 'string' ? stated : undefined;
+}
+/** What a header value that could not be written as ASCII was encoded as. */
+function decode(value) {
+    if (!value.startsWith(SENTINEL) || !value.endsWith(TERMINATOR))
+        return value;
+    const encoded = value.slice(SENTINEL.length, -TERMINATOR.length);
+    return Buffer.from(encoded, 'base64').toString('utf8');
+}
+/** A tool list is what the tree holds, which stands until a branch of it expires. */
+const TOOLS_CACHE = { ttlMs: BRANCH_TTL, cacheScope: 'private' };
+/** What the annotation says, which is the same for every caller until the application is redeployed. */
+const DISCOVERY_CACHE = { ttlMs: BRANCH_TTL, cacheScope: 'public' };
+const OK = 200;
+const ACCEPTED = 202;
+const SENTINEL = '=?base64?';
+const TERMINATOR = '?=';
+//# sourceMappingURL=Server.js.map

package/transpiled/MCP/Server.js.map

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

package/transpiled/MCP/discover.d.ts

@@ -0,0 +1,13 @@
+import type { MCP } from '../Annotation.js';
+/**
+ * What a client is told before it calls anything: the revisions served, what is served, and
+ * who serves it. It is a function of the annotation alone, so it is built once and answered
+ * as it is.
+ */
+export interface Discovery {
+    /** `server/discover`, which the modern revision has replaced the handshake with. */
+    modern: object;
+    /** `initialize`, in the shape a client of an earlier revision reads. */
+    legacy: (offered: string | undefined) => object;
+}
+export declare function discovery(options: MCP): Discovery;

package/transpiled/MCP/discover.js

@@ -0,0 +1,29 @@
+import { readFileSync } from 'node:fs';
+import { LEGACY, MODERN, SERVER_INFO, VERSIONS } from './types.js';
+export function discovery(options) {
+    const info = { name: options.name, version: VERSION };
+    // `listChanged` is a stream a client holds open, and this endpoint holds none
+    const capabilities = { tools: {} };
+    const modern = {
+        supportedVersions: VERSIONS,
+        capabilities,
+        _meta: { [SERVER_INFO]: info }
+    };
+    if (options.instructions !== undefined)
+        modern.instructions = options.instructions;
+    function legacy(offered) {
+        const value = {
+            // what the client asked for where that is served, and the newest handshake otherwise
+            protocolVersion: offered !== undefined && offered !== MODERN ? offered : LEGACY,
+            capabilities,
+            serverInfo: info
+        };
+        if (options.instructions !== undefined)
+            value.instructions = options.instructions;
+        return value;
+    }
+    return { modern, legacy };
+}
+/** What this gateway is, which is what answers however an application names itself. */
+const VERSION = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version;
+//# sourceMappingURL=discover.js.map

package/transpiled/MCP/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../../source/MCP/discover.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAgBlE,MAAM,UAAU,SAAS,CAAE,OAAY;IACrC,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;IAErD,8EAA8E;IAC9E,MAAM,YAAY,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAA;IAElC,MAAM,MAAM,GAA4B;QACtC,iBAAiB,EAAE,QAAQ;QAC3B,YAAY;QACZ,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE;KAC/B,CAAA;IAED,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QACpC,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;IAE5C,SAAS,MAAM,CAAE,OAA2B;QAC1C,MAAM,KAAK,GAA4B;YACrC,qFAAqF;YACrF,eAAe,EAAE,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;YAC/E,YAAY;YACZ,UAAU,EAAE,IAAI;SACjB,CAAA;QAED,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;YACpC,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;QAE3C,OAAO,KAAK,CAAA;IACd,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AAC3B,CAAC;AAED,uFAAuF;AACvF,MAAM,OAAO,GAAW,IAAI,CAAC,KAAK,CAChC,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA"}

package/transpiled/MCP/errors.d.ts

@@ -0,0 +1,24 @@
+import * as http from '../HTTP/index.js';
+import { type Failure, type Response } from './types.js';
+export declare const PARSE = -32700;
+export declare const INVALID_REQUEST = -32600;
+export declare const METHOD_NOT_FOUND = -32601;
+export declare const INVALID_PARAMS = -32602;
+export declare const INTERNAL = -32603;
+export declare const HEADER_MISMATCH = -32020;
+export declare const MISSING_CAPABILITY = -32021;
+export declare const UNSUPPORTED_VERSION = -32022;
+export declare function failure(code: number, message: string, data?: unknown): Failure;
+export declare function response(id: string | number | null, error: Failure): Response;
+/**
+ * What an exception says as a JSON-RPC error.
+ *
+ * The readable text is `body`, never `message`: `http.Exception` calls `super()` with no
+ * argument, so every one of them carries an empty `message`.
+ */
+export declare function of(exception: unknown): Failure;
+/**
+ * What the call was refused with, which a model reads and may correct itself by: what the
+ * operation said, where it said anything, and otherwise what the status means here.
+ */
+export declare function refusal(exception: http.ClientError): string;