@toa.io/extensions.exposition 1.0.0-alpha.34 → 1.0.0-alpha.340

package/transpiled/HTTP/messages.js

@@ -1,70 +1,223 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.read = exports.write = void 0;
-const node_stream_1 = require("node:stream");
-const consumers_1 = require("node:stream/consumers");
-const formats_1 = require("./formats");
-const exceptions_1 = require("./exceptions");
-function write(context, response, message) {
-    for (const transform of context.pipelines.response)
-        transform(message);
+import { readFileSync } from 'node:fs';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import * as contentType from 'content-type';
+import { console } from 'openspan';
+import { decoders } from './formats/index.js';
+import { BadRequest, NotAcceptable, UnsupportedMediaType } from './exceptions.js';
+import { environment } from '@toa.io/generic';
+import { Encoded } from '@toa.io/core';
+const context = environment.get('TOA_CONTEXT');
+const env = environment.get('TOA_ENV');
+/*
+ * What answered, on every reply: the build of the gateway, and the context and environment
+ * it was deployed with. Under a name of its own rather than `server`, which a CDN in front
+ * takes for itself — Cloudflare pins it to `cloudflare` and refuses to let a rule set it,
+ * so a gateway that said it there said it to nobody. A name like `ray`'s, and it survives
+ * the same hop `ray` does.
+ */
+const exposition = `${JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version}` +
+    ((context === undefined ? '' : ` ${context}`) + (env === undefined ? '' : `/${env}`));
+/**
+ * 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) {
+        const pending = transform(message);
+        // the transforms are synchronous as a rule, and awaiting one that is not still makes a promise
+        if (pending instanceof Promise)
+            await pending;
+    }
+}
+export async function write(context, response, message) {
+    await shape(context, message);
+    if (message?.status !== undefined)
+        response.statusCode = message.status;
+    response.setHeader('exposition', exposition);
     message.headers?.forEach((value, key) => response.setHeader(key, value));
     context.timing.append(response);
-    if (message.body instanceof node_stream_1.Readable)
+    if (response.destroyed) {
+        console.warn('Request destroyed prematurely', { path: context.url.pathname });
+        // nobody reads it now, and its `error` — a reply stream's idle timeout — would be uncaught
+        if (message.body instanceof Readable)
+            message.body.destroy();
+        return;
+    }
+    response.on('error', (exception) => console.warn('HTTP response error', { path: context.url.pathname, exception }));
+    if (message.body instanceof Readable)
         stream(message, context, response);
     else
         send(message, context, response);
 }
-exports.write = write;
-async function read(context) {
-    const type = context.request.headers['content-type'];
-    if (type === undefined)
+export async function read(context) {
+    const header = context.request.headers['content-type'];
+    if (header === undefined)
         return undefined;
-    if (!(type in formats_1.formats))
-        throw new exceptions_1.UnsupportedMediaType();
-    const format = formats_1.formats[type];
-    const buf = await context.timing.capture('buffer', (0, consumers_1.buffer)(context.request));
+    const { type, parameters } = contentType.parse(header);
+    if (!(type in decoders))
+        throw new UnsupportedMediaType();
+    const format = decoders[type];
+    const buf = await context.buffer();
     try {
-        return format.decode(buf);
+        return format.decode(buf, parameters.charset);
     }
-    catch {
-        throw new exceptions_1.BadRequest();
+    catch (error) {
+        console.debug('Failed to decode message', {
+            path: context.url.pathname,
+            error: error?.toString?.()
+        });
+        throw new BadRequest();
     }
 }
-exports.read = read;
 function send(message, context, response) {
     if (message.body === undefined || message.body === null) {
+        // a HEAD reply carries no body but must still report the length a GET would
+        // have returned, so a length already set by a directive is left alone
+        if (!response.hasHeader('content-length'))
+            response.setHeader('content-length', '0');
         response.end();
         return;
     }
     if (context.encoder === null)
-        throw new exceptions_1.NotAcceptable();
-    const buf = context.encoder.encode(message.body);
-    response
-        .setHeader('content-type', context.encoder.type)
-        .appendHeader('vary', 'accept')
-        .end(buf);
+        throw new NotAcceptable();
+    const encoded = Encoded.is(message.body);
+    const buf = encoded ? message.body.bytes : context.encoder.encode(message.body);
+    const type = encoded ? message.body.type : context.encoder.type;
+    const validation = message.validate?.(buf);
+    if (validation !== undefined) {
+        response.setHeader('etag', validation.etag);
+        if (validation.held) {
+            // nothing of the body has been written yet, so a reply the client holds ends here
+            response.statusCode = 304;
+            response.end();
+            return;
+        }
+    }
+    response.setHeader('content-type', type);
+    response.setHeader('content-length', buf.length.toString());
+    response.appendHeader('vary', 'accept');
+    response.end(buf);
 }
 function stream(message, context, response) {
     const encoded = message.headers !== undefined && message.headers.has('content-type');
-    if (encoded)
-        message.body.pipe(response);
-    else
-        multipart(message, context, response);
-    message.body.on('error', (e) => {
-        console.error(e);
-        response.end();
+    const source = encoded ? message.body : multipart(message, context, response);
+    // not awaited: a reply that streams is written long after the request is answered, and a
+    // realtime subscription outlives the span the reply was produced in
+    //
+    // `pipeline` carries an error to every stage and destroys them. `pipe` leaves the stages it
+    // built behind, and an `error` on a stream nobody listens to is an uncaught exception.
+    pipeline(source, response).catch((exception) => {
+        // the client went away, which is how a realtime subscription ends
+        if (exception.code === 'ERR_STREAM_PREMATURE_CLOSE')
+            return;
+        console.warn('Message stream error', { path: context.url.pathname, exception });
     });
 }
-function multipart(message, context, response) {
+/**
+ * Frames an object stream as `multipart/*`: an `ACK` part, the parts themselves, then `FIN`.
+ * The body is a `Readable`; `write` reached here by testing it.
+ */
+export function multipart(message, context, response) {
     if (context.encoder === null)
-        throw new exceptions_1.NotAcceptable();
+        throw new NotAcceptable();
     const encoder = context.encoder;
     response.setHeader('content-type', `${encoder.multipart}; boundary=${BOUNDARY}`);
-    message.body
-        .map((part) => Buffer.concat([CUT, encoder.encode(part), CRLF]))
-        .on('end', () => response.end(FINALCUT))
-        .pipe(response);
+    return new Framing(message.body, encoder, context);
+}
+/**
+ * A part is pulled when the reader takes one, so a slow reader holds the body back.
+ *
+ * Not a generator under `Readable.from`: that one's `return()` waits behind the `next()` it is
+ * suspended in, and a body destroyed with its reply would live on until its next part — a
+ * subscription's, until its next heartbeat. Destroyed, this destroys the body at once.
+ *
+ * Aborted, it ends with `FIN` instead of being cut: the gateway is stopping, and the reader is
+ * told the stream is over rather than left to find out.
+ *
+ * A body that fails ends with `FIN` as well. The parts already written are a prefix of what the
+ * body would have yielded, which is what `FIN` promises a reader of a stream anyway, and a reply
+ * cut instead reaches the reader as a broken connection — through a proxy, a protocol error
+ * that the reader cannot tell from a network failure.
+ */
+class Framing extends Readable {
+    body;
+    parts;
+    encoder;
+    signal;
+    path;
+    pulling = false;
+    stopping = false;
+    finished = false;
+    constructor(body, encoder, context) {
+        super();
+        this.body = body;
+        this.encoder = encoder;
+        this.signal = context.signal;
+        // a request without a URL is one a test made up
+        this.path = context.url?.pathname;
+        this.parts = body[Symbol.asyncIterator]();
+        this.push(Buffer.concat([CUT, CRLF, encoder.encode('ACK'), CRLF, CUT]));
+        if (this.signal.aborted)
+            this.stop();
+        else
+            this.signal.addEventListener('abort', this.stop, { once: true });
+    }
+    _read() {
+        if (this.pulling || this.finished)
+            return;
+        this.pulling = true;
+        this.pull().catch((error) => this.destroy(error));
+    }
+    _destroy(error, callback) {
+        this.signal.removeEventListener('abort', this.stop);
+        this.body.destroy();
+        callback(error);
+    }
+    async pull() {
+        let result;
+        try {
+            result = await this.parts.next();
+        }
+        catch (exception) {
+            // the body was destroyed by `stop`, and that is not an error of the stream
+            if (!this.stopping)
+                console.warn('Message stream error', { path: this.path, exception });
+            this.finish();
+            return;
+        }
+        finally {
+            this.pulling = false;
+        }
+        if (result.done === true || this.stopping)
+            this.finish();
+        else
+            this.push(Buffer.concat([
+                CRLF /* indicates no boundary headers */,
+                // a value the component encoded for this reply is written as it is
+                Encoded.is(result.value)
+                    ? result.value.bytes
+                    : this.encoder.encode(result.value),
+                CRLF,
+                CUT
+            ]));
+    }
+    stop = () => {
+        this.stopping = true;
+        this.body.destroy();
+        // a pull in flight finishes on its own once the body is gone
+        if (!this.pulling)
+            this.finish();
+    };
+    finish() {
+        if (this.finished)
+            return;
+        this.finished = true;
+        this.signal.removeEventListener('abort', this.stop);
+        this.push(Buffer.concat([CRLF, this.encoder.encode('FIN'), CRLF, FINALCUT]));
+        this.push(null);
+    }
 }
 const BOUNDARY = 'cut';
 const CUT = Buffer.from(`--${BOUNDARY}\r\n`);

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/HTTP/types.d.ts

@@ -0,0 +1,38 @@
+import type { Readable, Writable } from 'node:stream';
+import type { OutgoingHttpHeaders } from 'node:http';
+import type { IncomingHttpHeaders } from 'node:http2';
+/**
+ * What Exposition requires of a request. Both `http.IncomingMessage` and
+ * `http2.Http2ServerRequest` satisfy it, so the pipeline is written once.
+ */
+export interface IncomingMessage extends Readable {
+    url: string;
+    method: string;
+    complete: boolean;
+    headers: IncomingHeaders;
+    socket: {
+        remoteAddress?: string | undefined;
+    };
+}
+/**
+ * What Exposition requires of a response.
+ *
+ * `setHeader` and `appendHeader` return `void` because `Http2ServerResponse` returns
+ * nothing from them, so neither can be chained.
+ */
+export interface ServerResponse extends Writable {
+    statusCode: number;
+    writableEnded: boolean;
+    setHeader: (name: string, value: number | string | string[]) => void;
+    appendHeader: (name: string, value: string | string[]) => void;
+    hasHeader: (name: string) => boolean;
+    getHeader: (name: string) => number | string | string[] | undefined;
+    writeHead: (status: number, headers?: OutgoingHttpHeaders) => ServerResponse;
+}
+/**
+ * HTTP/2's header map: HTTP/1.1's, plus the pseudo-headers. `:authority` is typed here
+ * so the authority can be read without narrowing at every call site.
+ */
+export type IncomingHeaders = IncomingHttpHeaders;
+/** `h2c` is cleartext HTTP/2: there is no in-process TLS to negotiate ALPN with. */
+export type Protocol = 'h1' | 'h2c';

package/transpiled/HTTP/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/transpiled/HTTP/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../source/HTTP/types.ts"],"names":[],"mappings":""}

package/transpiled/Interception.d.ts

@@ -1,9 +1,14 @@
-import type { Input, Output } from './io';
+import type * as http from './HTTP/index.ts';
+import type { Input, Output } from './io.ts';
 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,19 +1,24 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Interception = void 0;
-class Interception {
+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) {
+            interceptor.reset?.();
+            interceptor.mount?.(options);
+        }
     }
     async intercept(input) {
         for (const interceptor of this.interceptors) {
-            const output = await interceptor.intercept(input);
+            let output = interceptor.intercept(input);
+            // most answer at once, and awaiting a value that is not a promise still makes one
+            if (output instanceof Promise)
+                output = await output;
             if (output !== null)
                 return output;
         }
         return null;
     }
 }
-exports.Interception = Interception;
 //# sourceMappingURL=Interception.js.map

package/transpiled/Interception.js.map

@@ -1 +1 @@
-{"version":3,"file":"Interception.js","sourceRoot":"","sources":["../source/Interception.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IACN,YAAY,CAAe;IAE5C,YAAoB,YAA2B;QAC7C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;IAClC,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;AAjBD,oCAiBC"}
+{"version":3,"file":"Interception.js","sourceRoot":"","sources":["../source/Interception.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACN,YAAY,CAAe;IAE5C,YAAmB,YAA2B,EAAE,OAAqB;QACnE,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,CAAC,KAAY;QACjC,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC5C,IAAI,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YAEzC,kFAAkF;YAClF,IAAI,MAAM,YAAY,OAAO;gBAAE,MAAM,GAAG,MAAM,MAAM,CAAA;YAEpD,IAAI,MAAM,KAAK,IAAI;gBAAE,OAAO,MAAM,CAAA;QACpC,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/transpiled/Introspection.d.ts

@@ -0,0 +1,103 @@
+import type { Remote } from '@toa.io/core';
+import type { Context } from './HTTP/index.ts';
+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;
+    /** what a person is shown where a client lists this method, which a name is not */
+    title?: string;
+    /**
+     * whether reaching it takes nothing at all — `auth:anonymous`. Said rather than left
+     * unsaid, because it is also what refuses a caller presenting a credential: a client
+     * cannot know that from an answer that says nothing.
+     */
+    anonymous?: boolean;
+    /** whether reaching it takes being someone, whoever — `auth:anyone` and its like */
+    authenticated?: boolean;
+    /** whether reaching it is being the identity it is about — `auth:id` */
+    private?: boolean;
+    /** whether reaching it takes a role — `auth:role` */
+    protected?: boolean;
+    /** and whether that role is one of the `system` scope */
+    system?: boolean;
+    /**
+     * Whether making this call twice changes state once — the operation declares
+     * [`once`](/documentation/inbox.md). What it means for a client is that a retry it is not
+     * sure about is safe to make, under an `idempotency-key` it repeats.
+     *
+     * Read off the operation rather than off the route: it is the operation that records the
+     * call, and the same one mounted twice is as safe under either.
+     */
+    once?: boolean;
+    /**
+     * Whether the call this method makes may only read — [`io:readonly`](io.md#readonly). Said only
+     * where a route states it: absent, the method says it, and `GET` and `HEAD` are the safe ones.
+     */
+    readonly?: boolean;
+    /** whether the route publishes this method to a model — [`mcp:tool`](mcp.md) */
+    mcp?: boolean;
+    route?: Record<string, Schema>;
+    query?: Record<string, Schema>;
+    /**
+     * What picks the records a call is about — `criteria`, `sort`, `limit`, `omit`, `search`.
+     * Not the parameters the resource declares: those are `query`. Absent where the method
+     * is not queryable.
+     */
+    selection?: Record<string, Schema>;
+    /** what the body is, where it is a file rather than a value — [`octets:put`](octets.md) */
+    octets?: Octets;
+    input?: Schema;
+    output?: Schema;
+    errors?: string[];
+}
+/** What sending a file to a resource takes, which is not something a schema states. */
+export interface Octets {
+    /** what may be sent, in the syntax of an `accept` header; anything where unstated */
+    accept?: string;
+    /** the largest body it takes, as it is written and as a refusal reports it */
+    limit: string;
+    /**
+     * Whether the reply arrives as a stream of parts rather than as one object: a workflow
+     * runs on what was stored, and each step answers as it finishes. The first part is the
+     * entry itself, which is what a caller that wants nothing else reads and stops.
+     */
+    stream?: boolean;
+}
+export type Schema = Awaited<ReturnType<Remote['explain']>>['input'];
+/**
+ * The same request, as a description of a resource rather than a call to one. A directive
+ * that answers differently to the two reads `exploratory` — `Anonymous` is the one that
+ * does, because the rule refusing a credential at an `anonymous` route is about a reply a
+ * cache would hold, and a description is not one.
+ */
+export declare function describing(context: Context): Context;
+/**
+ * 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

@@ -0,0 +1,82 @@
+/**
+ * The same request, as a description of a resource rather than a call to one. A directive
+ * that answers differently to the two reads `exploratory` — `Anonymous` is the one that
+ * does, because the rule refusing a credential at an `anonymous` route is about a reply a
+ * cache would hold, and a description is not one.
+ */
+export function describing(context) {
+    return Object.create(context, {
+        exploratory: { value: true, enumerable: true }
+    });
+}
+/**
+ * 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 = [
+    'title',
+    'description',
+    'anonymous',
+    'authenticated',
+    'private',
+    'protected',
+    'system',
+    'once',
+    'readonly',
+    'mcp',
+    'route',
+    'query',
+    'selection',
+    'octets',
+    '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

@@ -0,0 +1 @@
+{"version":3,"file":"Introspection.js","sourceRoot":"","sources":["../source/Introspection.ts"],"names":[],"mappings":"AAuFA;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE;QAC5B,WAAW,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;KAC/C,CAAY,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAC,aAA4B;IAChD,MAAM,OAAO,GAAkB,EAAE,CAAA;IAEjC,KAAK,MAAM,GAAG,IAAI,IAAI;QACpB,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,SAAS;YAAG,OAAO,CAAC,GAAG,CAAa,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;IAEtF,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,IAAI,GAAG;IACX,OAAO;IACP,aAAa;IACb,WAAW;IACX,eAAe;IACf,SAAS;IACT,WAAW;IACX,QAAQ;IACR,MAAM;IACN,UAAU;IACV,KAAK;IACL,OAAO;IACP,OAAO;IACP,WAAW;IACX,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,QAAQ;CACA,CAAA;AAEV;;;GAGG;AACH,MAAM,UAAU,IAAI,CAAC,OAAgB,EAAE,QAAgB;IACrD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAiC,CAAA;IACvD,MAAM,UAAU,GAAG,KAAK,EAAE,UAAU,CAAA;IAEpC,IACE,KAAK,KAAK,SAAS;QACnB,KAAK,KAAK,IAAI;QACd,UAAU,KAAK,SAAS;QACxB,CAAC,CAAC,QAAQ,IAAI,UAAU,CAAC;QAEzB,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,CACtB,MAA0B,EAC1B,OAAoB;IAEpB,MAAM,KAAK,GAAG,MAAkC,CAAA;IAEhD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAA;IAExD,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;QAAE,OAAO,MAAM,CAAA;IAEjD,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;YAAE,UAAU,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAA;IAEpD,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,57 @@
+import * as http from '../HTTP/index.ts';
+import { Manifest } from './manifest.ts';
+import type { Tree } from '../RTD/index.ts';
+import type { MCPAnnotation as MCP } from '@toa.io/definitions/extensions.exposition';
+/**
+ * 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 origins;
+    /** Built again when the icons of the manifest change; a request reads what it is then. */
+    private discovery;
+    /**
+     * The reader of the application's web manifest, which the gateway connects: none without
+     * one named.
+     */
+    readonly manifest: Manifest | null;
+    /** The hosts this is served at the root of, lowercased as a request's host is. */
+    private readonly roots;
+    constructor(options: MCP, tree: Tree);
+    /** Whether the host is one this endpoint is the root of. */
+    hosted(host: string): boolean;
+    /**
+     * Where a model is pointed on behalf of the authority, where that is a host of its own —
+     * the origin its protected resource document names.
+     */
+    address(authority: string): string | null;
+    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;
+}