@toolgrain/mcp 0.0.0-stage → 0.1.0

package/dist/pending-requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-requests.d.ts","sourceRoot":"","sources":["../src/pending-requests.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,OAAO;IAGvD,KAAK,KAAK,SAAS;;;;;IAYnB,MAAM,KAAK,SAAS;IAKpB,KAAK;EAMR"}

package/dist/pending-requests.js

@@ -0,0 +1,30 @@
+/** Owns duplicate detection and cancellation signals for in-flight requests. */
+export function createPendingRequests(isOpen) {
+    const pending = new Map();
+    return {
+        begin(id) {
+            if (pending.has(id))
+                return;
+            const controller = new AbortController();
+            pending.set(id, controller);
+            return {
+                signal: controller.signal,
+                isActive: () => isOpen() && !controller.signal.aborted,
+                finish: () => {
+                    pending.delete(id);
+                },
+            };
+        },
+        cancel(id) {
+            pending
+                .get(id)
+                ?.abort(new DOMException("Request cancelled by client", "AbortError"));
+        },
+        clear() {
+            for (const controller of pending.values())
+                controller.abort(new DOMException("Connection closed", "AbortError"));
+            pending.clear();
+        },
+    };
+}
+//# sourceMappingURL=pending-requests.js.map

package/dist/pending-requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pending-requests.js","sourceRoot":"","sources":["../src/pending-requests.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,UAAU,qBAAqB,CAAC,MAAqB;IACzD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;IACtD,OAAO;QACL,KAAK,CAAC,EAAa;YACjB,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO;YAC5B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAC5B,OAAO;gBACL,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO;gBACtD,MAAM,EAAE,GAAG,EAAE;oBACX,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACrB,CAAC;aACF,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,EAAa;YAClB,OAAO;iBACJ,GAAG,CAAC,EAAE,CAAC;gBACR,EAAE,KAAK,CAAC,IAAI,YAAY,CAAC,6BAA6B,EAAE,YAAY,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,KAAK;YACH,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE;gBACvC,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC,CAAC;YACxE,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/protocol/decode.d.ts

@@ -0,0 +1,21 @@
+import { type JSONRPCErrorResponse, type RequestId } from "@toolgrain/protocol";
+import { type Notification, type Request } from "./messages.js";
+type Incoming = {
+    kind: "request";
+    request: Request;
+} | {
+    kind: "cancel";
+    id: RequestId;
+} | {
+    kind: "notification";
+    notification: Notification;
+} | {
+    kind: "ignore";
+} | {
+    kind: "error";
+    response: JSONRPCErrorResponse;
+};
+/** Decode the envelope; method parameters are validated by the dispatcher. */
+export declare function decode(message: unknown): Incoming;
+export {};
+//# sourceMappingURL=decode.d.ts.map

package/dist/protocol/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/protocol/decode.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,OAAO,EAEb,MAAM,eAAe,CAAC;AAGvB,KAAK,QAAQ,GACT;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,SAAS,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,YAAY,EAAE,YAAY,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IACE,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,oBAAoB,CAAC;CAChC,CAAC;AAEN,8EAA8E;AAC9E,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAgCjD"}

package/dist/protocol/decode.js

@@ -0,0 +1,40 @@
+import { INVALID_REQUEST, } from "@toolgrain/protocol";
+import { cancellation, envelope, requestId, } from "./messages.js";
+import { protocolError } from "./responses.js";
+/** Decode the envelope; method parameters are validated by the dispatcher. */
+export function decode(message) {
+    const parsed = envelope.safeParse(message);
+    if (!parsed.success) {
+        if (typeof message === "object" &&
+            message !== null &&
+            !Array.isArray(message) &&
+            (("method" in message && !Object.hasOwn(message, "id")) ||
+                isResponse(message)))
+            return { kind: "ignore" };
+        const id = typeof message === "object" && message !== null && "id" in message
+            ? requestId.safeParse(message.id)
+            : undefined;
+        return {
+            kind: "error",
+            response: protocolError(INVALID_REQUEST, "Invalid request", id?.success ? id.data : undefined),
+        };
+    }
+    if (parsed.data.id !== undefined)
+        return { kind: "request", request: { ...parsed.data, id: parsed.data.id } };
+    if (parsed.data.method === "notifications/cancelled") {
+        const params = cancellation.safeParse(parsed.data.params);
+        if (params.success)
+            return { kind: "cancel", id: params.data.requestId };
+        return { kind: "ignore" };
+    }
+    return { kind: "notification", notification: parsed.data };
+}
+/** Servers send no requests, so a client response has nothing to answer. */
+function isResponse(message) {
+    return ("jsonrpc" in message &&
+        message.jsonrpc === "2.0" &&
+        !Object.hasOwn(message, "method") &&
+        Object.hasOwn(message, "id") &&
+        Object.hasOwn(message, "result") !== Object.hasOwn(message, "error"));
+}
+//# sourceMappingURL=decode.js.map

package/dist/protocol/decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../src/protocol/decode.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAGhB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,YAAY,EACZ,QAAQ,EAGR,SAAS,GACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAY/C,8EAA8E;AAC9E,MAAM,UAAU,MAAM,CAAC,OAAgB;IACrC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,IACE,OAAO,OAAO,KAAK,QAAQ;YAC3B,OAAO,KAAK,IAAI;YAChB,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YACvB,CAAC,CAAC,QAAQ,IAAI,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBACrD,UAAU,CAAC,OAAO,CAAC,CAAC;YAEtB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,MAAM,EAAE,GACN,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,IAAI,IAAI,OAAO;YAChE,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO;YACL,IAAI,EAAE,OAAO;YACb,QAAQ,EAAE,aAAa,CACrB,eAAe,EACf,iBAAiB,EACjB,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAClC;SACF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS;QAC9B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC;IAC9E,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,yBAAyB,EAAE,CAAC;QACrD,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,IAAI,MAAM,CAAC,OAAO;YAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACzE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAC7D,CAAC;AAED,4EAA4E;AAC5E,SAAS,UAAU,CAAC,OAAe;IACjC,OAAO,CACL,SAAS,IAAI,OAAO;QACpB,OAAO,CAAC,OAAO,KAAK,KAAK;QACzB,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC;QAC5B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CACrE,CAAC;AACJ,CAAC"}

package/dist/protocol/icon.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export declare const icon: z.ZodObject<{
+    src: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+    sizes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    theme: z.ZodOptional<z.ZodEnum<{
+        dark: "dark";
+        light: "light";
+    }>>;
+}, z.core.$loose>;
+//# sourceMappingURL=icon.d.ts.map

package/dist/protocol/icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.d.ts","sourceRoot":"","sources":["../../src/protocol/icon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,IAAI;;;;;;;;iBAKf,CAAC"}

package/dist/protocol/icon.js

@@ -0,0 +1,8 @@
+import { z } from "zod";
+export const icon = z.looseObject({
+    src: z.string(),
+    mimeType: z.string().optional(),
+    sizes: z.array(z.string()).optional(),
+    theme: z.enum(["light", "dark"]).optional(),
+});
+//# sourceMappingURL=icon.js.map

package/dist/protocol/icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.js","sourceRoot":"","sources":["../../src/protocol/icon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC;IAChC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC"}

package/dist/protocol/messages.d.ts

@@ -0,0 +1,19 @@
+import { z } from "zod";
+export declare const object: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export declare const requestId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+export declare const envelope: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    method: z.ZodString;
+    id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export declare const cancellation: z.ZodObject<{
+    requestId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    reason: z.ZodOptional<z.ZodString>;
+    _meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export type Request = z.infer<typeof envelope> & {
+    id: z.infer<typeof requestId>;
+};
+export type Notification = z.infer<typeof envelope>;
+//# sourceMappingURL=messages.d.ts.map

package/dist/protocol/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/protocol/messages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,MAAM,wCAAoC,CAAC;AACxD,eAAO,MAAM,SAAS,iDAGpB,CAAC;AACH,eAAO,MAAM,QAAQ;;;;;iBAUlB,CAAC;AACJ,eAAO,MAAM,YAAY;;;;iBAIvB,CAAC;AAEH,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,GAAG;IAC/C,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;CAC/B,CAAC;AACF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/dist/protocol/messages.js

@@ -0,0 +1,21 @@
+import { JSONRPC_VERSION } from "@toolgrain/protocol";
+import { z } from "zod";
+export const object = z.record(z.string(), z.unknown());
+export const requestId = z.union([
+    z.string(),
+    z.number().finite().refine(Number.isInteger, "Request ID must be an integer"),
+]);
+export const envelope = z
+    .looseObject({
+    jsonrpc: z.literal(JSONRPC_VERSION),
+    method: z.string(),
+    id: requestId.optional(),
+    params: object.optional(),
+})
+    .refine((value) => !Object.hasOwn(value, "result") && !Object.hasOwn(value, "error"));
+export const cancellation = z.looseObject({
+    requestId,
+    reason: z.string().optional(),
+    _meta: object.optional(),
+});
+//# sourceMappingURL=messages.js.map

package/dist/protocol/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/protocol/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC;IAC/B,CAAC,CAAC,MAAM,EAAE;IACV,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,+BAA+B,CAAC;CAC9E,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC;KACtB,WAAW,CAAC;IACX,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,EAAE,EAAE,SAAS,CAAC,QAAQ,EAAE;IACxB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;CAC1B,CAAC;KACD,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CACpE,CAAC;AACJ,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC;IACxC,SAAS;IACT,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE;CACzB,CAAC,CAAC"}

package/dist/protocol/responses.d.ts

@@ -0,0 +1,9 @@
+import type { JSONRPCErrorResponse, RequestId } from "@toolgrain/protocol";
+export declare function protocolError(code: number, message: string, id?: RequestId, data?: unknown): JSONRPCErrorResponse;
+/** An internal dispatch failure, converted to a protocol response at the connection boundary. */
+export declare class ProtocolError extends Error {
+    readonly code: number;
+    readonly data?: unknown;
+    constructor(code: number, message: string, data?: unknown);
+}
+//# sourceMappingURL=responses.d.ts.map

package/dist/protocol/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/protocol/responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG3E,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,EAAE,CAAC,EAAE,SAAS,EACd,IAAI,CAAC,EAAE,OAAO,GACb,oBAAoB,CAMtB;AAED,iGAAiG;AACjG,qBAAa,aAAc,SAAQ,KAAK;aAEpB,IAAI,EAAE,MAAM;aAEZ,IAAI,CAAC,EAAE,OAAO;IAHhC,YACkB,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,OAAO,EAI/B;CACF"}

package/dist/protocol/responses.js

@@ -0,0 +1,20 @@
+import { JSONRPC_VERSION } from "@toolgrain/protocol";
+export function protocolError(code, message, id, data) {
+    return {
+        jsonrpc: JSONRPC_VERSION,
+        ...(id === undefined ? {} : { id }),
+        error: { code, message, ...(data === undefined ? {} : { data }) },
+    };
+}
+/** An internal dispatch failure, converted to a protocol response at the connection boundary. */
+export class ProtocolError extends Error {
+    code;
+    data;
+    constructor(code, message, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+        this.name = "ProtocolError";
+    }
+}
+//# sourceMappingURL=responses.js.map

package/dist/protocol/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/protocol/responses.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,OAAe,EACf,EAAc,EACd,IAAc;IAEd,OAAO;QACL,OAAO,EAAE,eAAe;QACxB,GAAG,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;QACnC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE;KAClE,CAAC;AACJ,CAAC;AAED,iGAAiG;AACjG,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEpB,IAAI;IAEJ,IAAI;IAHtB,YACkB,IAAY,EAC5B,OAAe,EACC,IAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAC;oBAJC,IAAI;oBAEJ,IAAI;QAGpB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/protocol/version-metadata.d.ts

@@ -0,0 +1,7 @@
+import { type SupportedProtocolVersion } from "@toolgrain/protocol";
+import type { Request } from "./messages.js";
+export declare function hasProtocolVersionMetadata(request: Request): boolean;
+export declare function metadataMatchesVersion(request: Request, version: SupportedProtocolVersion): boolean;
+/** A transport-selected revision cannot contradict an explicit request revision. */
+export declare function validateVersionContext(request: Request, version?: SupportedProtocolVersion): void;
+//# sourceMappingURL=version-metadata.d.ts.map

package/dist/protocol/version-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-metadata.d.ts","sourceRoot":"","sources":["../../src/protocol/version-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAOpE;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAMT;AAED,oFAAoF;AACpF,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,wBAAwB,GACjC,IAAI,CAUN"}

package/dist/protocol/version-metadata.js

@@ -0,0 +1,21 @@
+import { INVALID_PARAMS, } from "@toolgrain/protocol";
+import { ProtocolError } from "./responses.js";
+export function hasProtocolVersionMetadata(request) {
+    const meta = request.params?._meta;
+    return (typeof meta === "object" &&
+        meta !== null &&
+        Object.hasOwn(meta, "io.modelcontextprotocol/protocolVersion"));
+}
+export function metadataMatchesVersion(request, version) {
+    const meta = request.params?._meta;
+    return (hasProtocolVersionMetadata(request) &&
+        meta["io.modelcontextprotocol/protocolVersion"] === version);
+}
+/** A transport-selected revision cannot contradict an explicit request revision. */
+export function validateVersionContext(request, version) {
+    if (version !== undefined &&
+        hasProtocolVersionMetadata(request) &&
+        !metadataMatchesVersion(request, version))
+        throw new ProtocolError(INVALID_PARAMS, "Protocol version does not match request metadata");
+}
+//# sourceMappingURL=version-metadata.js.map

package/dist/protocol/version-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-metadata.js","sourceRoot":"","sources":["../../src/protocol/version-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,GAEf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC;IACnC,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACb,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,yCAAyC,CAAC,CAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,OAAgB,EAChB,OAAiC;IAEjC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,KAAgC,CAAC;IAC9D,OAAO,CACL,0BAA0B,CAAC,OAAO,CAAC;QACnC,IAAI,CAAC,yCAAyC,CAAC,KAAK,OAAO,CAC5D,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,sBAAsB,CACpC,OAAgB,EAChB,OAAkC;IAElC,IACE,OAAO,KAAK,SAAS;QACrB,0BAA0B,CAAC,OAAO,CAAC;QACnC,CAAC,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC;QAEzC,MAAM,IAAI,aAAa,CACrB,cAAc,EACd,kDAAkD,CACnD,CAAC;AACN,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,35 @@
+import type { ProtocolResponse, Tool as ProtocolTool, SupportedProtocolVersion } from "@toolgrain/protocol";
+import type { AuthMetadata, AuthProvider, AuthScope } from "./auth/types.js";
+import type { RegisteredContextProvider } from "./context/definition.js";
+import { type ErrorHandler } from "./diagnostics.js";
+import type { ToolMap } from "./tools/registry.js";
+import { type RequestTransport, type Transport } from "./transport.js";
+export interface ServerOptions<Tools extends ToolMap = ToolMap> {
+    name: string;
+    version: string;
+    tools: Tools;
+    instructions?: string;
+    /** Tool failures include frozen tool/request details; other diagnostics omit them. */
+    onError?: ErrorHandler;
+    auth?: AuthProvider;
+    context?: readonly RegisteredContextProvider[];
+}
+export interface HandleOptions {
+    signal?: AbortSignal;
+    protocolVersion?: SupportedProtocolVersion;
+    auth?: AuthScope;
+}
+export interface Server {
+    handle(message: unknown, options?: HandleOptions): Promise<ProtocolResponse | undefined>;
+    getToolDefinitions(): ProtocolTool[];
+    getAuthMetadata(): AuthMetadata | undefined;
+    authorize(accessToken: string, options: {
+        resource: string;
+        signal?: AbortSignal;
+    }): Promise<AuthScope>;
+    listen(transport: Transport | RequestTransport): Promise<void>;
+    close(): Promise<void>;
+}
+/** Compose the tool adapter, MCP dispatcher, and transport connection. */
+export declare function createServer<const Tools extends ToolMap>(options: ServerOptions<Tools>): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,IAAI,IAAI,YAAY,EACpB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE7E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEzE,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,kBAAkB,CAAC;AAKlE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,aAAa,CAAC,KAAK,SAAS,OAAO,GAAG,OAAO;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAChD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,wBAAwB,CAAC;IAC3C,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,MAAM,CACJ,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IACzC,kBAAkB,IAAI,YAAY,EAAE,CAAC;IACrC,eAAe,IAAI,YAAY,GAAG,SAAS,CAAC;IAC5C,SAAS,CACP,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAClD,OAAO,CAAC,SAAS,CAAC,CAAC;IACtB,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,KAAK,CAAC,KAAK,SAAS,OAAO,EACtD,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,GAC5B,MAAM,CAyGR"}

package/dist/server.js

@@ -0,0 +1,101 @@
+import { createAuthorization } from "./auth/authorization.js";
+import { AuthError, isAuthError } from "./auth/errors.js";
+import { createConnection } from "./connection.js";
+import { createContextRegistry } from "./context/registry.js";
+import { reportError } from "./diagnostics.js";
+import { createDispatcher, formatErrorResponse } from "./dispatcher.js";
+import { executeRequest } from "./execute-request.js";
+import { decode } from "./protocol/decode.js";
+import { createToolAdapter } from "./tools/adapter.js";
+import { isRequestTransport, } from "./transport.js";
+/** Compose the tool adapter, MCP dispatcher, and transport connection. */
+export function createServer(options) {
+    const authorization = createAuthorization(options.auth);
+    const tools = createToolAdapter(options.tools, options.onError);
+    const dispatch = createDispatcher(tools, { name: options.name, version: options.version }, options.instructions, createContextRegistry(options.context));
+    let closed = false;
+    const running = new Set();
+    const closeIndependent = () => {
+        if (closed)
+            return;
+        closed = true;
+        for (const controller of running)
+            controller.abort(new DOMException("Server closed", "AbortError"));
+        running.clear();
+    };
+    const connection = createConnection(dispatch, options.onError, closeIndependent);
+    const requestController = (signal) => {
+        const controller = new AbortController();
+        const abort = () => controller.abort(signal?.reason);
+        if (signal?.aborted)
+            abort();
+        else
+            signal?.addEventListener("abort", abort, { once: true });
+        running.add(controller);
+        return {
+            signal: controller.signal,
+            finish() {
+                signal?.removeEventListener("abort", abort);
+                running.delete(controller);
+            },
+        };
+    };
+    const server = {
+        async listen(transport) {
+            if (isRequestTransport(transport))
+                return connection.listenRequests(transport, server);
+            if (authorization.metadata())
+                throw new Error("Auth-configured servers require HTTP and cannot listen on a message transport");
+            return connection.listen(transport);
+        },
+        getToolDefinitions: () => tools.list(),
+        getAuthMetadata: authorization.metadata,
+        async authorize(accessToken, { resource, signal }) {
+            if (closed)
+                throw new AuthError("temporarily_unavailable");
+            const pending = requestController(signal);
+            try {
+                return await authorization.authorize(accessToken, resource, pending.signal, pending.finish);
+            }
+            catch (error) {
+                pending.finish();
+                if (!pending.signal.aborted &&
+                    (!isAuthError(error) || error.code === "temporarily_unavailable"))
+                    reportError(options.onError, error);
+                throw error;
+            }
+        },
+        async handle(message, { signal, protocolVersion, auth } = {}) {
+            if (closed)
+                throw new Error("Server is closed");
+            const identity = authorization.consume(auth);
+            if (auth?.signal.aborted)
+                return;
+            const active = () => !closed && !signal?.aborted;
+            if (!active())
+                return;
+            const incoming = decode(message);
+            if (incoming.kind === "error")
+                return formatErrorResponse(incoming.response, protocolVersion);
+            if (incoming.kind !== "request")
+                return;
+            const pending = requestController(signal);
+            // The authorization signal covers verification and body decoding too.
+            const combined = auth
+                ? AbortSignal.any([pending.signal, auth.signal])
+                : pending.signal;
+            try {
+                return await executeRequest(dispatch, incoming.request, { signal: combined, ...(identity ? { auth: identity } : {}) }, options.onError, protocolVersion);
+            }
+            finally {
+                pending.finish();
+            }
+        },
+        close() {
+            closeIndependent();
+            return connection.close();
+        },
+    };
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/adapter.d.ts

@@ -0,0 +1,12 @@
+import type { Tool as ProtocolTool } from "@toolgrain/protocol";
+import { type ErrorHandler } from "../diagnostics.js";
+import type { ToolContext } from "./context.js";
+import { type ToolMap } from "./registry.js";
+import { type ToolExecutionResult } from "./results.js";
+export interface ToolAdapter {
+    has(name: string): boolean;
+    list(): ProtocolTool[];
+    execute(name: string, input: unknown, ctx: ToolContext): Promise<ToolExecutionResult | undefined>;
+}
+export declare function createToolAdapter(tools: ToolMap, onError?: ErrorHandler): ToolAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/tools/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/tools/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,KAAK,YAAY,EAAe,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAEL,KAAK,mBAAmB,EAEzB,MAAM,cAAc,CAAC;AAGtB,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,IAAI,IAAI,YAAY,EAAE,CAAC;IACvB,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;CAC7C;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,YAAY,GACrB,WAAW,CAkDb"}

package/dist/tools/adapter.js

@@ -0,0 +1,45 @@
+import { reportError } from "../diagnostics.js";
+import { ToolInputError } from "./errors.js";
+import { createRegistry } from "./registry.js";
+import { resolveToolResult, toolError, } from "./results.js";
+import { describeTool } from "./schema.js";
+export function createToolAdapter(tools, onError) {
+    const registry = createRegistry(tools);
+    const entries = registry.list();
+    const names = new Set(entries.map(({ name }) => name));
+    const outputs = new Map(entries.map(({ name, output }) => [name, output]));
+    const listed = entries.map((entry) => describeTool(entry.name, entry));
+    return {
+        has: (name) => names.has(name),
+        list: () => structuredClone(listed),
+        async execute(name, input, ctx) {
+            const isActive = () => !ctx.signal.aborted;
+            if (!names.has(name) || !isActive())
+                return;
+            try {
+                const result = await registry.execute(name, input, ctx);
+                if (!isActive())
+                    return;
+                const converted = await resolveToolResult(name, result, outputs.get(name));
+                return isActive() ? converted : undefined;
+            }
+            catch (error) {
+                if (!isActive())
+                    return;
+                try {
+                    if (error instanceof ToolInputError) {
+                        return toolError(error.issues
+                            .map((issue) => `${issue.path.map(String).join(".") || "input"}: ${issue.message}`)
+                            .join("; "));
+                    }
+                }
+                catch {
+                    // Inspecting a thrown value can fail, including revoked or trapped proxies.
+                }
+                reportError(onError, error, Object.freeze({ toolName: name, request: ctx.request }));
+                return isActive() ? toolError("Tool execution failed") : undefined;
+            }
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/tools/adapter.js.map

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

package/dist/tools/call.d.ts

@@ -0,0 +1,8 @@
+import type { ToolAdapter } from "./adapter.js";
+import type { ToolContext } from "./context.js";
+/** Execute an already-validated call through the shared registry. */
+export declare function callTool({ name, arguments: input, }: {
+    name: string;
+    arguments?: Record<string, unknown> | undefined;
+}, tools: ToolAdapter, ctx: ToolContext): Promise<import("./results.js").ToolExecutionResult | undefined>;
+//# sourceMappingURL=call.d.ts.map

package/dist/tools/call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.d.ts","sourceRoot":"","sources":["../../src/tools/call.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,qEAAqE;AACrE,wBAAgB,QAAQ,CACtB,EACE,IAAI,EACJ,SAAS,EAAE,KAAU,GACtB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CAAE,EACpE,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,WAAW,mEAKjB"}

package/dist/tools/call.js

@@ -0,0 +1,9 @@
+import { INVALID_PARAMS } from "@toolgrain/protocol";
+import { ProtocolError } from "../protocol/responses.js";
+/** Execute an already-validated call through the shared registry. */
+export function callTool({ name, arguments: input = {}, }, tools, ctx) {
+    if (!tools.has(name))
+        throw new ProtocolError(INVALID_PARAMS, `Unknown tool: ${name}`);
+    return tools.execute(name, input, ctx);
+}
+//# sourceMappingURL=call.js.map

package/dist/tools/call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.js","sourceRoot":"","sources":["../../src/tools/call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAIzD,qEAAqE;AACrE,MAAM,UAAU,QAAQ,CACtB,EACE,IAAI,EACJ,SAAS,EAAE,KAAK,GAAG,EAAE,GAC6C,EACpE,KAAkB,EAClB,GAAgB;IAEhB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;QAClB,MAAM,IAAI,aAAa,CAAC,cAAc,EAAE,iBAAiB,IAAI,EAAE,CAAC,CAAC;IACnE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC"}