@1mcp/agent 0.37.0 → 0.38.0

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

@@ -0,0 +1,150 @@
+import { createGatewayCancellation, createGatewayFailure, createGatewayRequestEnvelope, gatewayFailureFromUnknown, gatewayOperationSchema, toImmutableJsonValue, } from '../../contracts/index.js';
+import { requireModernPin } from './modernPin.js';
+function invalidModernRequest() {
+    return Object.freeze({
+        type: 'failure',
+        failure: createGatewayFailure({
+            kind: 'invalid-request',
+            code: 'modern_request_invalid',
+            message: 'The modern request frame is malformed or unsupported',
+        }),
+    });
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function requiredString(record, key) {
+    const value = record[key];
+    if (typeof value !== 'string' || value.length === 0)
+        throw new TypeError(`${key} must be a non-empty string`);
+    return value;
+}
+/** Modern-only inbound shell. It is intentionally unattached to a serving route. */
+export class ModernInboundEraAdapter {
+    role = 'inbound';
+    pin;
+    #callbacks;
+    #correlationByRequestId = new Map();
+    #requestIdByCorrelation = new Map();
+    constructor(options) {
+        this.pin = requireModernPin(options.revision);
+        this.#callbacks = Object.freeze({
+            receive: options.receive,
+            requestContext: options.requestContext,
+            respond: options.respond,
+            ...(options.close === undefined ? {} : { close: options.close }),
+        });
+        Object.freeze(this);
+    }
+    async nextEvent() {
+        let raw;
+        try {
+            raw = await this.#callbacks.receive();
+        }
+        catch (error) {
+            return Object.freeze({ type: 'failure', failure: gatewayFailureFromUnknown(error, 'transport') });
+        }
+        if (raw === undefined)
+            return Object.freeze({ type: 'closed' });
+        let frame;
+        try {
+            frame = toImmutableJsonValue(raw);
+        }
+        catch {
+            return invalidModernRequest();
+        }
+        if (!isRecord(frame))
+            return invalidModernRequest();
+        if (frame.type === 'cancel') {
+            try {
+                const requestId = this.#requestIdByCorrelation.get(requiredString(frame, 'correlationId'));
+                return requestId === undefined ? invalidModernRequest() : createGatewayCancellation(requestId);
+            }
+            catch {
+                return invalidModernRequest();
+            }
+        }
+        if (frame.type !== 'request')
+            return invalidModernRequest();
+        let correlationId;
+        let operation;
+        try {
+            correlationId = requiredString(frame, 'correlationId');
+            operation = requiredString(frame, 'operation');
+        }
+        catch {
+            return invalidModernRequest();
+        }
+        const parsedOperation = gatewayOperationSchema.safeParse(operation);
+        if (!parsedOperation.success)
+            return invalidModernRequest();
+        let context;
+        try {
+            context = await this.#callbacks.requestContext(correlationId);
+        }
+        catch (error) {
+            return Object.freeze({ type: 'failure', failure: gatewayFailureFromUnknown(error, 'transport') });
+        }
+        try {
+            const request = createGatewayRequestEnvelope({
+                requestId: context.requestId,
+                operation: parsedOperation.data,
+                targetConnectionId: context.targetConnectionId,
+                ...(frame.params === undefined ? {} : { params: frame.params }),
+                authority: context.authority,
+                inbound: this.pin,
+                outbound: context.outbound,
+                deadlineUnixMs: context.deadlineUnixMs,
+            });
+            if (this.#correlationByRequestId.has(request.requestId) || this.#requestIdByCorrelation.has(correlationId)) {
+                return invalidModernRequest();
+            }
+            this.#correlationByRequestId.set(request.requestId, correlationId);
+            this.#requestIdByCorrelation.set(correlationId, request.requestId);
+            return Object.freeze({ type: 'request', request });
+        }
+        catch {
+            return invalidModernRequest();
+        }
+    }
+    async respond(response) {
+        const correlationId = this.#correlationByRequestId.get(response.requestId);
+        if (correlationId === undefined) {
+            throw createGatewayFailure({
+                kind: 'invalid-request',
+                code: 'modern_response_unknown_request',
+                message: 'The modern response does not match an active request',
+            });
+        }
+        const frame = response.type === 'success'
+            ? toImmutableJsonValue({
+                type: 'success',
+                correlationId,
+                result: response.result,
+            })
+            : toImmutableJsonValue({
+                type: 'failure',
+                correlationId,
+                failure: response.failure,
+            });
+        try {
+            await this.#callbacks.respond(frame);
+        }
+        catch (error) {
+            throw gatewayFailureFromUnknown(error, 'transport');
+        }
+        finally {
+            this.#correlationByRequestId.delete(response.requestId);
+            this.#requestIdByCorrelation.delete(correlationId);
+        }
+    }
+    async close() {
+        try {
+            await this.#callbacks.close?.();
+        }
+        catch (error) {
+            throw gatewayFailureFromUnknown(error, 'transport');
+        }
+    }
+}
+//# sourceMappingURL=modernInboundEraAdapter.js.map

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

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

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

@@ -0,0 +1,24 @@
+import { type ImmutableJsonValue, type ProtocolEraPin } from '../../contracts/index.js';
+import type { OutboundEraAdapter, OutboundGatewayRequest } from '../../ports/index.js';
+export interface ModernOutboundAdapterCallbacks {
+    /** Receives a detached, recursively frozen JSON request frame. */
+    readonly request: (request: ImmutableJsonValue) => Promise<unknown>;
+    /** Receives the exact gateway request id being cancelled. */
+    readonly cancel: (requestId: string) => Promise<void>;
+    readonly close?: () => Promise<void>;
+}
+export interface ModernOutboundEraAdapterOptions extends ModernOutboundAdapterCallbacks {
+    readonly revision: unknown;
+    readonly now?: () => number;
+}
+/** Modern-only outbound shell. It is intentionally unattached to a backend factory. */
+export declare class ModernOutboundEraAdapter implements OutboundEraAdapter {
+    #private;
+    readonly role: "outbound";
+    readonly pin: ProtocolEraPin;
+    constructor(options: ModernOutboundEraAdapterOptions);
+    request(request: OutboundGatewayRequest): Promise<ImmutableJsonValue>;
+    cancel(requestId: string): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=modernOutboundEraAdapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"modernOutboundEraAdapter.d.ts","sourceRoot":"","sources":["../../../../src/gateway/adapters/modern/modernOutboundEraAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EAEpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAGvF,MAAM,WAAW,8BAA8B;IAC7C,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACpE,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,+BAAgC,SAAQ,8BAA8B;IACrF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,uFAAuF;AACvF,qBAAa,wBAAyB,YAAW,kBAAkB;;IACjE,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IACpC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC;gBAMjB,OAAO,EAAE,+BAA+B;IAW9C,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkCrE,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

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":"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"}

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"}