@1mcp/agent 0.37.0 → 0.38.1

package/build/gateway/adapters/modern/modernOutboundEraAdapter.js

@@ -0,0 +1,75 @@
+import { createEffectiveRequestAuthority, createGatewayFailure, gatewayFailureFromUnknown, toImmutableJsonValue, } from '../../contracts/index.js';
+import { requireModernPin } from './modernPin.js';
+/** Modern-only outbound shell. It is intentionally unattached to a backend factory. */
+export class ModernOutboundEraAdapter {
+    role = 'outbound';
+    pin;
+    #callbacks;
+    #now;
+    #activeRequestIds = new Set();
+    #cancelledRequestIds = new Set();
+    constructor(options) {
+        this.pin = requireModernPin(options.revision);
+        this.#callbacks = Object.freeze({
+            request: options.request,
+            cancel: options.cancel,
+            ...(options.close === undefined ? {} : { close: options.close }),
+        });
+        this.#now = options.now ?? Date.now;
+        Object.freeze(this);
+    }
+    async request(request) {
+        const frame = toImmutableJsonValue({
+            requestId: request.requestId,
+            operation: request.operation,
+            ...(request.params === undefined ? {} : { params: request.params }),
+            authority: createEffectiveRequestAuthority(request.authority),
+            deadlineUnixMs: request.deadlineUnixMs,
+        });
+        if (this.#activeRequestIds.has(request.requestId)) {
+            throw createGatewayFailure({
+                kind: 'invalid-request',
+                code: 'modern_outbound_duplicate_request',
+                message: 'The modern outbound request id is already active',
+            });
+        }
+        if (request.deadlineUnixMs <= this.#now()) {
+            throw createGatewayFailure({
+                kind: 'deadline-exceeded',
+                code: 'gateway_deadline_exceeded',
+                message: 'The gateway request deadline has expired',
+            });
+        }
+        this.#activeRequestIds.add(request.requestId);
+        try {
+            return toImmutableJsonValue(await this.#callbacks.request(frame));
+        }
+        catch (error) {
+            throw gatewayFailureFromUnknown(error, 'transport');
+        }
+        finally {
+            this.#activeRequestIds.delete(request.requestId);
+            this.#cancelledRequestIds.delete(request.requestId);
+        }
+    }
+    async cancel(requestId) {
+        if (!this.#activeRequestIds.has(requestId) || this.#cancelledRequestIds.has(requestId))
+            return;
+        this.#cancelledRequestIds.add(requestId);
+        try {
+            await this.#callbacks.cancel(requestId);
+        }
+        catch (error) {
+            throw gatewayFailureFromUnknown(error, 'transport');
+        }
+    }
+    async close() {
+        try {
+            await this.#callbacks.close?.();
+        }
+        catch (error) {
+            throw gatewayFailureFromUnknown(error, 'transport');
+        }
+    }
+}
+//# sourceMappingURL=modernOutboundEraAdapter.js.map

package/build/gateway/adapters/modern/modernOutboundEraAdapter.js.map

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

package/build/gateway/adapters/modern/modernPin.d.ts

@@ -0,0 +1,9 @@
+import { type ProtocolEraPin } from '../../contracts/index.js';
+/**
+ * Validates the only era supported by the modern adapters.
+ *
+ * A rejected modern classification is thrown as the frozen, plain gateway
+ * failure returned by the shared classifier. Callers must treat it as terminal.
+ */
+export declare function requireModernPin(revision: unknown): ProtocolEraPin;
+//# sourceMappingURL=modernPin.d.ts.map

package/build/gateway/adapters/modern/modernPin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modernPin.d.ts","sourceRoot":"","sources":["../../../../src/gateway/adapters/modern/modernPin.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAEzG;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,cAAc,CAIlE"}

package/build/gateway/adapters/modern/modernPin.js

@@ -0,0 +1,14 @@
+import { classifyProtocolEra } from '../../contracts/index.js';
+/**
+ * Validates the only era supported by the modern adapters.
+ *
+ * A rejected modern classification is thrown as the frozen, plain gateway
+ * failure returned by the shared classifier. Callers must treat it as terminal.
+ */
+export function requireModernPin(revision) {
+    const classified = classifyProtocolEra({ syntax: 'modern', revision });
+    if (!classified.ok)
+        throw classified.failure;
+    return classified.value;
+}
+//# sourceMappingURL=modernPin.js.map

package/build/gateway/adapters/modern/modernPin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"modernPin.js","sourceRoot":"","sources":["../../../../src/gateway/adapters/modern/modernPin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAA4C,MAAM,0BAA0B,CAAC;AAEzG;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,MAAM,UAAU,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,UAAU,CAAC,EAAE;QAAE,MAAM,UAAU,CAAC,OAAgC,CAAC;IACtE,OAAO,UAAU,CAAC,KAAK,CAAC;AAC1B,CAAC"}

package/build/gateway/contracts/effectiveRequestAuthority.d.ts

@@ -0,0 +1,12 @@
+export interface EffectiveRequestAuthority {
+    readonly connectionIds: readonly string[];
+    readonly provenance: readonly string[];
+}
+export declare function createEffectiveRequestAuthority(input: {
+    connectionIds: readonly string[];
+    provenance?: readonly string[];
+}): EffectiveRequestAuthority;
+/** Returns an authority no broader than the parent, regardless of requested identifiers. */
+export declare function narrowEffectiveRequestAuthority(parent: EffectiveRequestAuthority, requestedConnectionIds: readonly string[], provenance?: readonly string[]): EffectiveRequestAuthority;
+export declare function authorityAllows(authority: EffectiveRequestAuthority, connectionId: string): boolean;
+//# sourceMappingURL=effectiveRequestAuthority.d.ts.map

package/build/gateway/contracts/effectiveRequestAuthority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectiveRequestAuthority.d.ts","sourceRoot":"","sources":["../../../src/gateway/contracts/effectiveRequestAuthority.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAcD,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,GAAG,yBAAyB,CAK5B;AAED,4FAA4F;AAC5F,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,yBAAyB,EACjC,sBAAsB,EAAE,SAAS,MAAM,EAAE,EACzC,UAAU,GAAE,SAAS,MAAM,EAAO,GACjC,yBAAyB,CAM3B;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAEnG"}

package/build/gateway/contracts/effectiveRequestAuthority.js

@@ -0,0 +1,30 @@
+function canonicalStrings(values, name) {
+    if (!Array.isArray(values))
+        throw new TypeError(`${name} must contain non-empty strings`);
+    const strings = [];
+    for (const value of values) {
+        if (typeof value !== 'string' || value.length === 0) {
+            throw new TypeError(`${name} must contain non-empty strings`);
+        }
+        strings.push(value);
+    }
+    return Object.freeze([...new Set(strings)].sort((left, right) => (left < right ? -1 : left > right ? 1 : 0)));
+}
+export function createEffectiveRequestAuthority(input) {
+    return Object.freeze({
+        connectionIds: canonicalStrings(input.connectionIds, 'connectionIds'),
+        provenance: canonicalStrings(input.provenance ?? [], 'provenance'),
+    });
+}
+/** Returns an authority no broader than the parent, regardless of requested identifiers. */
+export function narrowEffectiveRequestAuthority(parent, requestedConnectionIds, provenance = []) {
+    const allowed = new Set(parent.connectionIds);
+    return createEffectiveRequestAuthority({
+        connectionIds: requestedConnectionIds.filter((connectionId) => allowed.has(connectionId)),
+        provenance: [...parent.provenance, ...provenance],
+    });
+}
+export function authorityAllows(authority, connectionId) {
+    return authority.connectionIds.includes(connectionId);
+}
+//# sourceMappingURL=effectiveRequestAuthority.js.map

package/build/gateway/contracts/effectiveRequestAuthority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectiveRequestAuthority.js","sourceRoot":"","sources":["../../../src/gateway/contracts/effectiveRequestAuthority.ts"],"names":[],"mappings":"AAKA,SAAS,gBAAgB,CAAC,MAAe,EAAE,IAAY;IACrD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,iCAAiC,CAAC,CAAC;IAC1F,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAmB,EAAE,CAAC;QACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,SAAS,CAAC,GAAG,IAAI,iCAAiC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChH,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,KAG/C;IACC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,aAAa,EAAE,gBAAgB,CAAC,KAAK,CAAC,aAAa,EAAE,eAAe,CAAC;QACrE,UAAU,EAAE,gBAAgB,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,EAAE,YAAY,CAAC;KACnE,CAAC,CAAC;AACL,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,+BAA+B,CAC7C,MAAiC,EACjC,sBAAyC,EACzC,aAAgC,EAAE;IAElC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC9C,OAAO,+BAA+B,CAAC;QACrC,aAAa,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACzF,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,GAAG,UAAU,CAAC;KAClD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAoC,EAAE,YAAoB;IACxF,OAAO,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AACxD,CAAC"}

package/build/gateway/contracts/gatewayFailure.d.ts

@@ -0,0 +1,25 @@
+import { type ImmutableJsonValue } from './immutableJson.js';
+export type GatewayFailureKind = 'protocol' | 'invalid-request' | 'authorization' | 'deadline-exceeded' | 'cancelled' | 'transport' | 'internal';
+export interface GatewayFailure {
+    readonly kind: GatewayFailureKind;
+    readonly code: string;
+    readonly message: string;
+    readonly data?: ImmutableJsonValue;
+}
+export declare function createGatewayFailure(input: {
+    kind: GatewayFailureKind;
+    code: string;
+    message: string;
+    data?: unknown;
+}): GatewayFailure;
+export declare function gatewayFailureFromUnknown(error: unknown, kind?: GatewayFailureKind): GatewayFailure;
+export type GatewayResult<T> = Readonly<{
+    ok: true;
+    value: T;
+}> | Readonly<{
+    ok: false;
+    failure: GatewayFailure;
+}>;
+export declare function gatewaySuccess<T>(value: T): GatewayResult<T>;
+export declare function gatewayFailure<T = never>(failure: GatewayFailure): GatewayResult<T>;
+//# sourceMappingURL=gatewayFailure.d.ts.map

package/build/gateway/contracts/gatewayFailure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatewayFailure.d.ts","sourceRoot":"","sources":["../../../src/gateway/contracts/gatewayFailure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAwB,MAAM,oBAAoB,CAAC;AAEnF,MAAM,MAAM,kBAAkB,GAC5B,UAAU,GAAG,iBAAiB,GAAG,eAAe,GAAG,mBAAmB,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAalH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;CACpC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,cAAc,CAajB;AAWD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,kBAA+B,GAAG,cAAc,CA2B/G;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,QAAQ,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,GAAG,QAAQ,CAAC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAAC,CAAC;AAEnH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAE5D;AAED,wBAAgB,cAAc,CAAC,CAAC,GAAG,KAAK,EAAE,OAAO,EAAE,cAAc,GAAG,aAAa,CAAC,CAAC,CAAC,CAEnF"}

package/build/gateway/contracts/gatewayFailure.js

@@ -0,0 +1,72 @@
+import { toImmutableJsonValue } from './immutableJson.js';
+const GATEWAY_FAILURE_KINDS = [
+    'protocol',
+    'invalid-request',
+    'authorization',
+    'deadline-exceeded',
+    'cancelled',
+    'transport',
+    'internal',
+];
+const knownGatewayFailures = new WeakSet();
+export function createGatewayFailure(input) {
+    if (!GATEWAY_FAILURE_KINDS.includes(input.kind))
+        throw new TypeError('Gateway failure kind is invalid');
+    if (typeof input.code !== 'string' || !input.code || typeof input.message !== 'string' || !input.message) {
+        throw new TypeError('Gateway failure code and message are required');
+    }
+    const failure = Object.freeze({
+        kind: input.kind,
+        code: input.code,
+        message: input.message,
+        ...(input.data === undefined ? {} : { data: toImmutableJsonValue(input.data) }),
+    });
+    knownGatewayFailures.add(failure);
+    return failure;
+}
+function ownDataValue(record, key) {
+    try {
+        const descriptor = Object.getOwnPropertyDescriptor(record, key);
+        return descriptor && 'value' in descriptor ? descriptor.value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function gatewayFailureFromUnknown(error, kind = 'internal') {
+    const record = typeof error === 'object' && error !== null ? error : undefined;
+    const trustedKind = record && knownGatewayFailures.has(record) ? ownDataValue(record, 'kind') : undefined;
+    const failureKind = GATEWAY_FAILURE_KINDS.includes(trustedKind)
+        ? trustedKind
+        : kind;
+    const rawCode = record ? ownDataValue(record, 'code') : undefined;
+    const code = typeof rawCode === 'string' || typeof rawCode === 'number' ? String(rawCode) : 'gateway_internal_error';
+    const rawMessage = record ? ownDataValue(record, 'message') : undefined;
+    let message = typeof rawMessage === 'string' ? rawMessage : 'Unknown gateway failure';
+    if (rawMessage === undefined && !record) {
+        try {
+            message = String(error);
+        }
+        catch {
+            message = 'Unknown gateway failure';
+        }
+    }
+    let data;
+    const rawData = record ? ownDataValue(record, 'data') : undefined;
+    if (rawData !== undefined) {
+        try {
+            data = toImmutableJsonValue(rawData);
+        }
+        catch {
+            data = undefined;
+        }
+    }
+    return createGatewayFailure({ kind: failureKind, code, message, ...(data === undefined ? {} : { data }) });
+}
+export function gatewaySuccess(value) {
+    return Object.freeze({ ok: true, value });
+}
+export function gatewayFailure(failure) {
+    return Object.freeze({ ok: false, failure });
+}
+//# sourceMappingURL=gatewayFailure.js.map

package/build/gateway/contracts/gatewayFailure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatewayFailure.js","sourceRoot":"","sources":["../../../src/gateway/contracts/gatewayFailure.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAKnF,MAAM,qBAAqB,GAAkC;IAC3D,UAAU;IACV,iBAAiB;IACjB,eAAe;IACf,mBAAmB;IACnB,WAAW;IACX,WAAW;IACX,UAAU;CACX,CAAC;AACF,MAAM,oBAAoB,GAAG,IAAI,OAAO,EAAU,CAAC;AASnD,MAAM,UAAU,oBAAoB,CAAC,KAKpC;IACC,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;IACxG,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACzG,MAAM,IAAI,SAAS,CAAC,+CAA+C,CAAC,CAAC;IACvE,CAAC;IACD,MAAM,OAAO,GAAmB,MAAM,CAAC,MAAM,CAAC;QAC5C,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;KAChF,CAAC,CAAC;IACH,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,MAAc,EAAE,GAAW;IAC/C,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChE,OAAO,UAAU,IAAI,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,KAAc,EAAE,OAA2B,UAAU;IAC7F,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,MAAM,WAAW,GAAG,MAAM,IAAI,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1G,MAAM,WAAW,GAAG,qBAAqB,CAAC,QAAQ,CAAC,WAAiC,CAAC;QACnF,CAAC,CAAE,WAAkC;QACrC,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC;IACrH,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,IAAI,OAAO,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,yBAAyB,CAAC;IACtF,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,yBAAyB,CAAC;QACtC,CAAC;IACH,CAAC;IACD,IAAI,IAAoC,CAAC;IACzC,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,IAAI,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,oBAAoB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;AAC7G,CAAC;AAID,MAAM,UAAU,cAAc,CAAI,KAAQ;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,cAAc,CAAY,OAAuB;IAC/D,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/build/gateway/contracts/gatewayRequest.d.ts

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+import { type EffectiveRequestAuthority } from './effectiveRequestAuthority.js';
+import { type ImmutableJsonValue } from './immutableJson.js';
+import { type ProtocolEraPin } from './protocolEra.js';
+export declare const gatewayOperationSchema: z.ZodEnum<{
+    "completion/complete": "completion/complete";
+    "prompts/get": "prompts/get";
+    "prompts/list": "prompts/list";
+    "resources/list": "resources/list";
+    "resources/templates/list": "resources/templates/list";
+    "resources/read": "resources/read";
+    "tools/call": "tools/call";
+    "tools/list": "tools/list";
+}>;
+export type GatewayOperation = z.infer<typeof gatewayOperationSchema>;
+export interface GatewayRequestEnvelope {
+    readonly requestId: string;
+    readonly operation: GatewayOperation;
+    readonly targetConnectionId: string;
+    readonly params?: ImmutableJsonValue;
+    readonly authority: EffectiveRequestAuthority;
+    readonly inbound: ProtocolEraPin;
+    readonly outbound: ProtocolEraPin;
+    readonly deadlineUnixMs: number;
+}
+export declare function createGatewayRequestEnvelope(input: GatewayRequestEnvelope): GatewayRequestEnvelope;
+export interface GatewayCancellation {
+    readonly type: 'cancel';
+    readonly requestId: string;
+}
+export declare function createGatewayCancellation(requestId: string): GatewayCancellation;
+//# sourceMappingURL=gatewayRequest.d.ts.map

package/build/gateway/contracts/gatewayRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatewayRequest.d.ts","sourceRoot":"","sources":["../../../src/gateway/contracts/gatewayRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAmC,KAAK,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AACjH,OAAO,EAAE,KAAK,kBAAkB,EAAwB,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE5E,eAAO,MAAM,sBAAsB;;;;;;;;;EASjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,sBAAsB,GAAG,sBAAsB,CA4BlG;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,CAGhF"}

package/build/gateway/contracts/gatewayRequest.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { createEffectiveRequestAuthority } from './effectiveRequestAuthority.js';
+import { toImmutableJsonValue } from './immutableJson.js';
+import { classifyProtocolEra } from './protocolEra.js';
+export const gatewayOperationSchema = z.enum([
+    'tools/list',
+    'tools/call',
+    'prompts/list',
+    'prompts/get',
+    'resources/list',
+    'resources/templates/list',
+    'resources/read',
+    'completion/complete',
+]);
+export function createGatewayRequestEnvelope(input) {
+    if (typeof input.requestId !== 'string' ||
+        !input.requestId ||
+        typeof input.targetConnectionId !== 'string' ||
+        !input.targetConnectionId) {
+        throw new TypeError('Gateway request identifiers are required');
+    }
+    const operation = gatewayOperationSchema.safeParse(input.operation);
+    if (!operation.success)
+        throw new TypeError(`Unsupported gateway operation: ${String(input.operation)}`);
+    if (!Number.isSafeInteger(input.deadlineUnixMs) || input.deadlineUnixMs <= 0) {
+        throw new TypeError('Gateway deadline must be a positive Unix millisecond timestamp');
+    }
+    const inbound = classifyProtocolEra({ syntax: input.inbound.era, revision: input.inbound.revision });
+    const outbound = classifyProtocolEra({ syntax: input.outbound.era, revision: input.outbound.revision });
+    if (!inbound.ok)
+        throw inbound.failure;
+    if (!outbound.ok)
+        throw outbound.failure;
+    return Object.freeze({
+        requestId: input.requestId,
+        operation: operation.data,
+        targetConnectionId: input.targetConnectionId,
+        ...(input.params === undefined ? {} : { params: toImmutableJsonValue(input.params) }),
+        authority: createEffectiveRequestAuthority(input.authority),
+        inbound: inbound.value,
+        outbound: outbound.value,
+        deadlineUnixMs: input.deadlineUnixMs,
+    });
+}
+export function createGatewayCancellation(requestId) {
+    if (!requestId)
+        throw new TypeError('Gateway cancellation request id is required');
+    return Object.freeze({ type: 'cancel', requestId });
+}
+//# sourceMappingURL=gatewayRequest.js.map

package/build/gateway/contracts/gatewayRequest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatewayRequest.js","sourceRoot":"","sources":["../../../src/gateway/contracts/gatewayRequest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,+BAA+B,EAAkC,MAAM,gCAAgC,CAAC;AACjH,OAAO,EAA2B,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAuB,MAAM,kBAAkB,CAAC;AAE5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3C,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,aAAa;IACb,gBAAgB;IAChB,0BAA0B;IAC1B,gBAAgB;IAChB,qBAAqB;CACtB,CAAC,CAAC;AAcH,MAAM,UAAU,4BAA4B,CAAC,KAA6B;IACxE,IACE,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QACnC,CAAC,KAAK,CAAC,SAAS;QAChB,OAAO,KAAK,CAAC,kBAAkB,KAAK,QAAQ;QAC5C,CAAC,KAAK,CAAC,kBAAkB,EACzB,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,SAAS,GAAG,sBAAsB,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACpE,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,MAAM,IAAI,SAAS,CAAC,kCAAkC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACzG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,SAAS,CAAC,gEAAgE,CAAC,CAAC;IACxF,CAAC;IACD,MAAM,OAAO,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrG,MAAM,QAAQ,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxG,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,OAAO,CAAC,OAAO,CAAC;IACvC,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,QAAQ,CAAC,OAAO,CAAC;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,SAAS,EAAE,SAAS,CAAC,IAAI;QACzB,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACrF,SAAS,EAAE,+BAA+B,CAAC,KAAK,CAAC,SAAS,CAAC;QAC3D,OAAO,EAAE,OAAO,CAAC,KAAK;QACtB,QAAQ,EAAE,QAAQ,CAAC,KAAK;QACxB,cAAc,EAAE,KAAK,CAAC,cAAc;KACrC,CAAC,CAAC;AACL,CAAC;AAOD,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,6CAA6C,CAAC,CAAC;IACnF,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/build/gateway/contracts/immutableJson.d.ts

@@ -0,0 +1,6 @@
+export type ImmutableJsonValue = null | boolean | number | string | readonly ImmutableJsonValue[] | {
+    readonly [key: string]: ImmutableJsonValue;
+};
+/** Detaches, validates, and recursively freezes a value crossing the gateway boundary. */
+export declare function toImmutableJsonValue(value: unknown): ImmutableJsonValue;
+//# sourceMappingURL=immutableJson.d.ts.map

package/build/gateway/contracts/immutableJson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"immutableJson.d.ts","sourceRoot":"","sources":["../../../src/gateway/contracts/immutableJson.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,kBAAkB,GAC5B,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,kBAAkB,EAAE,GAAG;IAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAE,CAAC;AAUpH,0FAA0F;AAC1F,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAEvE"}

package/build/gateway/contracts/immutableJson.js

@@ -0,0 +1,14 @@
+import { toJsonValue } from '../../sdk/contracts/jsonValue.js';
+function freezeValue(value) {
+    if (Array.isArray(value))
+        return Object.freeze(value.map(freezeValue));
+    if (value !== null && typeof value === 'object') {
+        return Object.freeze(Object.fromEntries(Object.entries(value).map(([key, child]) => [key, freezeValue(child)])));
+    }
+    return value;
+}
+/** Detaches, validates, and recursively freezes a value crossing the gateway boundary. */
+export function toImmutableJsonValue(value) {
+    return freezeValue(toJsonValue(value));
+}
+//# sourceMappingURL=immutableJson.js.map

package/build/gateway/contracts/immutableJson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"immutableJson.js","sourceRoot":"","sources":["../../../src/gateway/contracts/immutableJson.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAK9E,SAAS,WAAW,CAAC,KAAgB;IACnC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/build/gateway/contracts/index.d.ts

@@ -0,0 +1,6 @@
+export * from './effectiveRequestAuthority.js';
+export * from './gatewayFailure.js';
+export * from './gatewayRequest.js';
+export * from './immutableJson.js';
+export * from './protocolEra.js';
+//# sourceMappingURL=index.d.ts.map

package/build/gateway/contracts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gateway/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/build/gateway/contracts/index.js

@@ -0,0 +1,6 @@
+export * from './effectiveRequestAuthority.js';
+export * from './gatewayFailure.js';
+export * from './gatewayRequest.js';
+export * from './immutableJson.js';
+export * from './protocolEra.js';
+//# sourceMappingURL=index.js.map

package/build/gateway/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gateway/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/build/gateway/contracts/protocolEra.d.ts

@@ -0,0 +1,22 @@
+import { type GatewayResult } from './gatewayFailure.js';
+export declare const MODERN_PROTOCOL_REVISION = "2026-07-28";
+export declare const LEGACY_PROTOCOL_REVISIONS: readonly ["2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05", "2024-10-07"];
+export type ProtocolEra = 'legacy' | 'modern';
+export type ProtocolLeg = 'inbound' | 'outbound';
+export interface ProtocolEraPin {
+    readonly era: ProtocolEra;
+    readonly revision: string;
+}
+export interface ProtocolEraEvidence {
+    /** The era-specific adapter owns syntax detection. Modern syntax is terminal. */
+    readonly syntax: ProtocolEra;
+    readonly revision: unknown;
+}
+export declare function classifyProtocolEra(evidence: ProtocolEraEvidence): GatewayResult<ProtocolEraPin>;
+export declare class IndependentEraPins {
+    private inbound?;
+    private outbound?;
+    get(leg: ProtocolLeg): ProtocolEraPin | undefined;
+    pin(leg: ProtocolLeg, evidence: ProtocolEraEvidence): GatewayResult<ProtocolEraPin>;
+}
+//# sourceMappingURL=protocolEra.d.ts.map

package/build/gateway/contracts/protocolEra.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocolEra.d.ts","sourceRoot":"","sources":["../../../src/gateway/contracts/protocolEra.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,aAAa,EAAkB,MAAM,qBAAqB,CAAC;AAE/G,eAAO,MAAM,wBAAwB,eAAe,CAAC;AACrD,eAAO,MAAM,yBAAyB,iFAM3B,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC9C,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;AAEjD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,aAAa,CAAC,cAAc,CAAC,CAsChG;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAElC,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,cAAc,GAAG,SAAS;IAIjD,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,mBAAmB,GAAG,aAAa,CAAC,cAAc,CAAC;CAsBpF"}

package/build/gateway/contracts/protocolEra.js

@@ -0,0 +1,68 @@
+import { createGatewayFailure, gatewayFailure, gatewaySuccess } from './gatewayFailure.js';
+export const MODERN_PROTOCOL_REVISION = '2026-07-28';
+export const LEGACY_PROTOCOL_REVISIONS = Object.freeze([
+    '2025-11-25',
+    '2025-06-18',
+    '2025-03-26',
+    '2024-11-05',
+    '2024-10-07',
+]);
+export function classifyProtocolEra(evidence) {
+    if (evidence.syntax !== 'legacy' && evidence.syntax !== 'modern') {
+        return gatewayFailure(createGatewayFailure({
+            kind: 'protocol',
+            code: 'protocol_evidence_invalid',
+            message: 'Protocol era evidence is malformed',
+        }));
+    }
+    if (evidence.syntax === 'modern') {
+        if (evidence.revision !== MODERN_PROTOCOL_REVISION) {
+            return gatewayFailure(createGatewayFailure({
+                kind: 'protocol',
+                code: 'modern_protocol_invalid',
+                message: 'Modern protocol evidence is malformed or unsupported',
+                data: { observedEra: 'modern' },
+            }));
+        }
+        return gatewaySuccess(Object.freeze({ era: 'modern', revision: MODERN_PROTOCOL_REVISION }));
+    }
+    if (typeof evidence.revision !== 'string' ||
+        !LEGACY_PROTOCOL_REVISIONS.includes(evidence.revision)) {
+        return gatewayFailure(createGatewayFailure({
+            kind: 'protocol',
+            code: 'legacy_protocol_invalid',
+            message: 'Legacy protocol evidence is malformed or unsupported',
+            data: { observedEra: 'legacy' },
+        }));
+    }
+    return gatewaySuccess(Object.freeze({ era: 'legacy', revision: evidence.revision }));
+}
+export class IndependentEraPins {
+    inbound;
+    outbound;
+    get(leg) {
+        return leg === 'inbound' ? this.inbound : this.outbound;
+    }
+    pin(leg, evidence) {
+        const classified = classifyProtocolEra(evidence);
+        if (!classified.ok)
+            return classified;
+        const current = this.get(leg);
+        if (current && (current.era !== classified.value.era || current.revision !== classified.value.revision)) {
+            return gatewayFailure(createGatewayFailure({
+                kind: 'protocol',
+                code: 'protocol_era_pin_conflict',
+                message: `The ${leg} protocol era is already pinned`,
+                data: { leg, pinnedEra: current.era, pinnedRevision: current.revision },
+            }));
+        }
+        if (!current) {
+            if (leg === 'inbound')
+                this.inbound = classified.value;
+            else
+                this.outbound = classified.value;
+        }
+        return gatewaySuccess(this.get(leg));
+    }
+}
+//# sourceMappingURL=protocolEra.js.map

package/build/gateway/contracts/protocolEra.js.map

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

package/build/gateway/core/gatewayDispatcher.d.ts

@@ -0,0 +1,15 @@
+import { type GatewayRequestEnvelope, type GatewayResult, type ImmutableJsonValue } from '../contracts/index.js';
+import type { OutboundEraAdapter } from '../ports/index.js';
+export interface GatewayDispatcherDependencies {
+    resolveOutbound(connectionId: string): OutboundEraAdapter | undefined;
+    now?: () => number;
+}
+export declare class GatewayDispatcher {
+    private readonly dependencies;
+    private readonly active;
+    private readonly now;
+    constructor(dependencies: GatewayDispatcherDependencies);
+    dispatch(request: GatewayRequestEnvelope): Promise<GatewayResult<ImmutableJsonValue>>;
+    cancel(requestId: string): Promise<boolean>;
+}
+//# sourceMappingURL=gatewayDispatcher.d.ts.map

package/build/gateway/core/gatewayDispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gatewayDispatcher.d.ts","sourceRoot":"","sources":["../../../src/gateway/core/gatewayDispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAElB,KAAK,kBAAkB,EAGxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAA0B,MAAM,mBAAmB,CAAC;AAEpF,MAAM,WAAW,6BAA6B;IAC5C,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IACtE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAMD,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAHzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyC;IAChE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEN,YAAY,EAAE,6BAA6B;IAIlE,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAkErF,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAMlD"}

package/build/gateway/core/gatewayDispatcher.js

@@ -0,0 +1,77 @@
+import { authorityAllows, createGatewayFailure, gatewayFailure, gatewayFailureFromUnknown, gatewaySuccess, toImmutableJsonValue, } from '../contracts/index.js';
+function pinsEqual(left, right) {
+    return left.era === right.era && left.revision === right.revision;
+}
+export class GatewayDispatcher {
+    dependencies;
+    active = new Map();
+    now;
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+        this.now = dependencies.now ?? Date.now;
+    }
+    async dispatch(request) {
+        if (this.active.has(request.requestId)) {
+            return gatewayFailure(createGatewayFailure({
+                kind: 'invalid-request',
+                code: 'gateway_request_already_active',
+                message: 'The gateway request id is already active',
+            }));
+        }
+        if (!authorityAllows(request.authority, request.targetConnectionId)) {
+            return gatewayFailure(createGatewayFailure({
+                kind: 'authorization',
+                code: 'gateway_target_not_authorized',
+                message: 'The request target is outside the effective authority',
+            }));
+        }
+        if (request.deadlineUnixMs <= this.now()) {
+            return gatewayFailure(createGatewayFailure({
+                kind: 'deadline-exceeded',
+                code: 'gateway_deadline_exceeded',
+                message: 'The gateway request deadline has expired',
+            }));
+        }
+        const outbound = this.dependencies.resolveOutbound(request.targetConnectionId);
+        if (!outbound) {
+            return gatewayFailure(createGatewayFailure({
+                kind: 'transport',
+                code: 'gateway_target_unavailable',
+                message: 'No outbound adapter is available',
+            }));
+        }
+        if (!pinsEqual(outbound.pin, request.outbound)) {
+            return gatewayFailure(createGatewayFailure({
+                kind: 'protocol',
+                code: 'gateway_outbound_pin_mismatch',
+                message: 'The outbound adapter does not match the request era pin',
+            }));
+        }
+        const outboundRequest = Object.freeze({
+            requestId: request.requestId,
+            operation: request.operation,
+            ...(request.params === undefined ? {} : { params: request.params }),
+            authority: request.authority,
+            deadlineUnixMs: request.deadlineUnixMs,
+        });
+        this.active.set(request.requestId, outbound);
+        try {
+            return gatewaySuccess(toImmutableJsonValue(await outbound.request(outboundRequest)));
+        }
+        catch (error) {
+            return gatewayFailure(gatewayFailureFromUnknown(error, 'transport'));
+        }
+        finally {
+            if (this.active.get(request.requestId) === outbound)
+                this.active.delete(request.requestId);
+        }
+    }
+    async cancel(requestId) {
+        const outbound = this.active.get(requestId);
+        if (!outbound)
+            return false;
+        await outbound.cancel(requestId);
+        return true;
+    }
+}
+//# sourceMappingURL=gatewayDispatcher.js.map