@1mcp/agent 0.38.1 → 0.39.0-beta.0

package/build/gateway/interactions/interactionBroker.js

@@ -0,0 +1,244 @@
+import { createHash } from 'node:crypto';
+import { types } from 'node:util';
+import { captureJson } from '../../core/validation/schemaPolicy.js';
+import { createGatewayFailure, toImmutableJsonValue } from '../contracts/index.js';
+import { InteractionOwner } from './interactionOwner.js';
+function rejected() {
+    return createGatewayFailure({
+        kind: 'authorization',
+        code: 'interaction_state_invalid',
+        message: 'Interaction continuation rejected',
+    });
+}
+function digest(token) {
+    return createHash('sha256').update(token).digest('hex');
+}
+/** Converts request-local reverse callbacks into MRTR without invoking an operation twice. */
+export class InteractionBroker {
+    options;
+    owner;
+    flows = new Map();
+    tokens = new Map();
+    constructor(options) {
+        this.options = options;
+        this.owner = new InteractionOwner(options.limits);
+    }
+    async start(binding, deadline, invoke, callerSignal) {
+        if (!this.options.authorize(binding))
+            throw rejected();
+        const operation = this.owner.start(binding, deadline);
+        const flow = { ...operation, binding, queue: [], sequence: 0, pendingInputs: 0 };
+        this.flows.set(flow.id, flow);
+        const abort = () => this.owner.cancel(flow.id);
+        callerSignal?.addEventListener('abort', abort, { once: true });
+        flow.signal.addEventListener('abort', () => {
+            if (!this.flows.has(flow.id))
+                return;
+            this.publish(flow, { error: flow.signal.reason });
+            this.forget(flow);
+        }, { once: true });
+        if (callerSignal?.aborted)
+            abort();
+        void Promise.resolve()
+            .then(() => {
+            flow.signal.throwIfAborted();
+            return invoke((input) => this.interact(flow, input), flow.signal, (inputs) => this.interactRound(flow, inputs));
+        })
+            .then((value) => this.complete(flow, { value }), (error) => this.complete(flow, { error }));
+        try {
+            return await this.next(flow);
+        }
+        finally {
+            callerSignal?.removeEventListener('abort', abort);
+        }
+    }
+    async resume(token, binding, responses, callerSignal, reauthorize) {
+        callerSignal?.throwIfAborted();
+        const flow = this.tokens.get(digest(token));
+        const current = flow?.current;
+        if (!flow ||
+            !current ||
+            current.resuming ||
+            !Object.values(current.requests).every((request) => this.options.authorize(binding, request)) ||
+            JSON.stringify(flow.binding) !== JSON.stringify(binding))
+            throw rejected();
+        current.resuming = true;
+        const abort = () => this.owner.cancel(flow.id);
+        callerSignal?.addEventListener('abort', abort, { once: true });
+        try {
+            if (!responses || typeof responses !== 'object' || Array.isArray(responses))
+                throw rejected();
+            const record = captureJson(responses, false).value;
+            const accepted = {
+                ...current.responses,
+            };
+            for (const [key, request] of Object.entries(current.requests)) {
+                if (Object.hasOwn(current.responses, key) || !Object.hasOwn(record, key))
+                    continue;
+                await this.options.validate(request, record[key], binding, flow.signal);
+                Object.defineProperty(accepted, key, {
+                    value: record[key],
+                    enumerable: true,
+                    configurable: true,
+                });
+            }
+            const combined = captureJson(accepted, false).value;
+            callerSignal?.throwIfAborted();
+            let allowed = false;
+            try {
+                allowed =
+                    (!reauthorize || (await reauthorize())) &&
+                        Object.values(current.requests).every((request) => this.options.authorize(binding, request));
+            }
+            catch {
+                allowed = false;
+            }
+            if (!allowed) {
+                this.owner.cancel(flow.id, 'authority_lost');
+                throw rejected();
+            }
+            callerSignal?.throwIfAborted();
+            if (flow.current !== current || this.tokens.get(digest(token)) !== flow)
+                throw rejected();
+            const missing = Object.fromEntries(Object.entries(current.requests).filter(([key]) => !Object.hasOwn(accepted, key)));
+            if (Object.keys(missing).length > 0) {
+                // Keep valid inputs only within this native round; never send partial responses upstream.
+                const successor = this.owner.rotate(token, binding);
+                this.tokens.delete(digest(token));
+                this.tokens.set(digest(successor), flow);
+                flow.current = {
+                    requests: current.requests,
+                    responses: combined,
+                    token: digest(successor),
+                };
+                return toImmutableJsonValue({
+                    resultType: 'input_required',
+                    requestState: successor,
+                    inputRequests: missing,
+                });
+            }
+            this.owner.resume(token, binding, combined);
+            this.tokens.delete(digest(token));
+            delete flow.current;
+            flow.reserved = flow.queue.length > 0;
+            flow.queue.shift()?.();
+            return await this.next(flow);
+        }
+        finally {
+            current.resuming = false;
+            callerSignal?.removeEventListener('abort', abort);
+        }
+    }
+    invalidate(binding) {
+        this.owner.invalidate(binding);
+    }
+    async close() {
+        await this.owner.close();
+    }
+    async interact(flow, input) {
+        const key = String(++flow.sequence);
+        const response = await this.interactRound(flow, { [key]: input });
+        return response[key];
+    }
+    async interactRound(flow, inputs) {
+        flow.signal.throwIfAborted();
+        if (inputs === null ||
+            typeof inputs !== 'object' ||
+            types.isProxy(inputs) ||
+            Array.isArray(inputs) ||
+            (Object.getPrototypeOf(inputs) !== Object.prototype && Object.getPrototypeOf(inputs) !== null))
+            throw rejected();
+        const inputCount = Reflect.ownKeys(inputs).length;
+        if (inputCount === 0)
+            throw rejected();
+        // Reserve actual inputs before copying payloads or suspending behind an active round.
+        if (inputCount > 32 || flow.pendingInputs + inputCount > 32) {
+            this.owner.cancel(flow.id, 'capacity_exceeded');
+            throw rejected();
+        }
+        flow.pendingInputs += inputCount;
+        try {
+            const requests = captureJson(inputs, false).value;
+            const entries = Object.entries(requests);
+            flow.signal.throwIfAborted();
+            if (!entries.every(([, request]) => this.options.authorize(flow.binding, request)))
+                throw rejected();
+            if (flow.current || flow.reserved) {
+                await new Promise((resolve, reject) => {
+                    const abort = () => reject(flow.signal.reason);
+                    flow.signal.addEventListener('abort', abort, { once: true });
+                    flow.queue.push(() => {
+                        flow.signal.removeEventListener('abort', abort);
+                        resolve();
+                    });
+                });
+            }
+            flow.signal.throwIfAborted();
+            flow.reserved = true;
+            try {
+                for (const [, request] of entries)
+                    await this.options.validateRequest?.(request, flow.binding, flow.signal);
+            }
+            catch (error) {
+                this.owner.cancel(flow.id, 'response_invalid');
+                throw error;
+            }
+            flow.signal.throwIfAborted();
+            const round = this.owner.park(flow.id, requests);
+            flow.current = {
+                requests,
+                responses: {},
+                token: digest(round.requestState),
+            };
+            flow.reserved = false;
+            this.tokens.set(digest(round.requestState), flow);
+            this.publish(flow, {
+                value: toImmutableJsonValue({
+                    resultType: 'input_required',
+                    inputRequests: requests,
+                    requestState: round.requestState,
+                }),
+            });
+            return (await round.response);
+        }
+        finally {
+            flow.pendingInputs -= inputCount;
+        }
+    }
+    next(flow) {
+        const result = flow.ready;
+        delete flow.ready;
+        return (result
+            ? Promise.resolve(result)
+            : new Promise((resolve) => {
+                flow.deliver = resolve;
+            })).then((settled) => {
+            if ('error' in settled)
+                throw settled.error;
+            return settled.value;
+        });
+    }
+    publish(flow, result) {
+        if (flow.deliver) {
+            const deliver = flow.deliver;
+            delete flow.deliver;
+            deliver(result);
+        }
+        else
+            flow.ready = result;
+    }
+    complete(flow, result) {
+        if (!this.flows.has(flow.id))
+            return;
+        this.publish(flow, result);
+        this.forget(flow);
+        this.owner.finish(flow.id);
+    }
+    forget(flow) {
+        this.flows.delete(flow.id);
+        if (flow.current)
+            this.tokens.delete(flow.current.token);
+        flow.queue.length = 0;
+    }
+}
+//# sourceMappingURL=interactionBroker.js.map

package/build/gateway/interactions/interactionBroker.js.map

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

package/build/gateway/interactions/interactionCapabilities.d.ts

@@ -0,0 +1,4 @@
+import type { GatewayInteractionRequest } from '../ports/outboundEraAdapter.js';
+/** Capability truth is request-local, including the exact interaction subtype. */
+export declare function hasInteractionCapability(capabilities: unknown, request: GatewayInteractionRequest): boolean;
+//# sourceMappingURL=interactionCapabilities.d.ts.map

package/build/gateway/interactions/interactionCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactionCapabilities.d.ts","sourceRoot":"","sources":["../../../src/gateway/interactions/interactionCapabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAMhF,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAuB3G"}

package/build/gateway/interactions/interactionCapabilities.js

@@ -0,0 +1,36 @@
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** Capability truth is request-local, including the exact interaction subtype. */
+export function hasInteractionCapability(capabilities, request) {
+    if (!record(capabilities))
+        return false;
+    const params = record(request.params) ? request.params : {};
+    switch (request.method) {
+        case 'roots/list':
+            return Object.hasOwn(capabilities, 'roots') && record(capabilities.roots);
+        case 'sampling/createMessage': {
+            const sampling = capabilities.sampling;
+            if (!Object.hasOwn(capabilities, 'sampling') || !record(sampling))
+                return false;
+            if (params.tools === undefined && params.toolChoice === undefined)
+                return true;
+            return Object.hasOwn(sampling, 'tools') && record(sampling.tools);
+        }
+        case 'elicitation/create': {
+            const elicitation = capabilities.elicitation;
+            if (!Object.hasOwn(capabilities, 'elicitation') || !record(elicitation))
+                return false;
+            if (params.mode === 'url')
+                return Object.hasOwn(elicitation, 'url') && record(elicitation.url);
+            if (params.mode !== undefined && params.mode !== 'form')
+                return false;
+            if (Object.hasOwn(elicitation, 'form'))
+                return record(elicitation.form);
+            return !Object.hasOwn(elicitation, 'url');
+        }
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=interactionCapabilities.js.map

package/build/gateway/interactions/interactionCapabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactionCapabilities.js","sourceRoot":"","sources":["../../../src/gateway/interactions/interactionCapabilities.ts"],"names":[],"mappings":"AAEA,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,wBAAwB,CAAC,YAAqB,EAAE,OAAkC;IAChG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,YAAY;YACf,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC5E,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC;YACvC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAAE,OAAO,KAAK,CAAC;YAChF,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YAC/E,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACpE,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,CAAC;YAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtF,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK;gBAAE,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAC/F,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM;gBAAE,OAAO,KAAK,CAAC;YACtE,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACxE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;QACD;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/build/gateway/interactions/interactionOwner.d.ts

@@ -0,0 +1,45 @@
+import { type ImmutableJsonValue } from '../contracts/index.js';
+export interface InteractionBinding {
+    readonly principal: string;
+    readonly request: string;
+    readonly route: string;
+    readonly provider?: string;
+    readonly generation: string;
+    readonly inbound: string;
+    readonly outbound: string;
+}
+export interface InteractionLimits {
+    readonly active: number;
+    readonly perOwner: number;
+    readonly perRoute: number;
+    readonly rounds: number;
+    readonly payloadBytes: number;
+    readonly ttlMs: number;
+    readonly drainMs: number;
+}
+/** Owns live promises only. Tokens are unguessable references, never serialized authority. */
+export declare class InteractionOwner {
+    private readonly now;
+    private readonly operations;
+    private readonly tokens;
+    private readonly limits;
+    private closed;
+    constructor(limits?: Partial<InteractionLimits>, now?: () => number);
+    start(binding: InteractionBinding, deadline: number): {
+        id: string;
+        signal: AbortSignal;
+    };
+    park(id: string, input: unknown): {
+        requestState: string;
+        input: ImmutableJsonValue;
+        response: Promise<ImmutableJsonValue>;
+    };
+    resume(token: string, binding: InteractionBinding, input: unknown): string;
+    rotate(token: string, binding: InteractionBinding): string;
+    finish(id: string): void;
+    cancel(id: string, reason?: string): void;
+    invalidate(binding: InteractionBinding): void;
+    close(drain?: () => Promise<void>): Promise<void>;
+    private payload;
+}
+//# sourceMappingURL=interactionOwner.d.ts.map

package/build/gateway/interactions/interactionOwner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactionOwner.d.ts","sourceRoot":"","sources":["../../../src/gateway/interactions/interactionOwner.ts"],"names":[],"mappings":"AAIA,OAAO,EAAwB,KAAK,kBAAkB,EAAwB,MAAM,uBAAuB,CAAC;AAE5G,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AA4DD,8FAA8F;AAC9F,qBAAa,gBAAgB;IAQzB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,MAAM,CAAS;gBAGrB,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM,EACtB,GAAG,eAAW;IAoBjC,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE;IAkCzF,IAAI,CACF,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,GACb;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,kBAAkB,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAA;KAAE;IAoB7F,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM;IAiB1E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,MAAM;IAwB1D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,IAAI;IAa9C,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAOvC,KAAK,CAAC,KAAK,GAAE,MAAM,OAAO,CAAC,IAAI,CAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9E,OAAO,CAAC,OAAO;CAKhB"}

package/build/gateway/interactions/interactionOwner.js

@@ -0,0 +1,203 @@
+import { createHash, randomBytes } from 'node:crypto';
+import { captureJson, SCHEMA_LIMITS } from '../../core/validation/schemaPolicy.js';
+import { createGatewayFailure, toImmutableJsonValue } from '../contracts/index.js';
+// All listener/broker and direct legacy owners share the accepted process capacity.
+const processOperations = new Map();
+const defaults = {
+    active: 128,
+    perOwner: 16,
+    perRoute: 32,
+    rounds: 10,
+    payloadBytes: SCHEMA_LIMITS.inputBytes,
+    ttlMs: 600_000,
+    drainMs: 1000,
+};
+function tokenKey(token) {
+    if (!/^[A-Za-z0-9_-]{43}$/.test(token))
+        throw failure('state_invalid');
+    return createHash('sha256').update(token).digest('hex');
+}
+function failure(code) {
+    return createGatewayFailure({
+        kind: 'invalid-request',
+        code: `interaction_${code}`,
+        message: 'Interaction is unavailable or cannot accept this continuation',
+        data: { outcome: 'unknown' },
+    });
+}
+function bindingKey(binding) {
+    const parts = [
+        binding.principal,
+        binding.request,
+        binding.route,
+        binding.provider ?? binding.route,
+        binding.generation,
+        binding.inbound,
+        binding.outbound,
+    ];
+    if (parts.some((part) => typeof part !== 'string' || !part))
+        throw failure('binding_required');
+    return JSON.stringify(parts);
+}
+/** Owns live promises only. Tokens are unguessable references, never serialized authority. */
+export class InteractionOwner {
+    now;
+    operations = new Map();
+    tokens = new Map();
+    limits;
+    closed = false;
+    constructor(limits = {}, now = Date.now) {
+        this.now = now;
+        this.limits = { ...defaults, ...limits };
+        if (Object.entries(this.limits).some(([key, value]) => !Number.isSafeInteger(value) || value < 0 || (value === 0 && key !== 'ttlMs'))) {
+            throw new TypeError('Interaction limits must be positive integers');
+        }
+        if (this.limits.active > 2048 ||
+            this.limits.perOwner > 128 ||
+            this.limits.perRoute > 512 ||
+            this.limits.rounds > 10 ||
+            this.limits.ttlMs > 3_600_000)
+            throw new TypeError('Interaction hard limit exceeded');
+    }
+    start(binding, deadline) {
+        const key = bindingKey(binding);
+        let ownerCount = 0;
+        let routeCount = 0;
+        for (const operation of processOperations.values()) {
+            if (operation.principal === binding.principal)
+                ownerCount++;
+            if (operation.route === (binding.provider ?? binding.route))
+                routeCount++;
+        }
+        if (this.closed ||
+            processOperations.size >= this.limits.active ||
+            ownerCount >= this.limits.perOwner ||
+            routeCount >= this.limits.perRoute)
+            throw failure('capacity_exceeded');
+        const expires = Math.min(deadline, this.now() + this.limits.ttlMs);
+        if (!Number.isSafeInteger(expires) || expires <= this.now())
+            throw failure('expired');
+        const id = randomBytes(32).toString('base64url');
+        const controller = new AbortController();
+        const timer = setTimeout(() => this.cancel(id, 'expired'), expires - this.now());
+        timer.unref();
+        this.operations.set(id, {
+            binding: key,
+            principal: binding.principal,
+            route: binding.provider ?? binding.route,
+            deadline: expires,
+            controller,
+            timer,
+            rounds: 0,
+        });
+        processOperations.set(id, this.operations.get(id));
+        return { id, signal: controller.signal };
+    }
+    park(id, input) {
+        const operation = this.operations.get(id);
+        if (!operation || operation.deadline <= this.now())
+            throw failure('expired');
+        if (operation.round)
+            throw failure('round_pending');
+        if (operation.rounds >= this.limits.rounds) {
+            this.cancel(id, 'round_limit');
+            throw failure('round_limit');
+        }
+        const value = this.payload(input);
+        const token = randomBytes(32).toString('base64url');
+        const response = new Promise((resolve, reject) => {
+            operation.round = { token: tokenKey(token), resolve, reject };
+        });
+        // A peer may disconnect before the parked callback attaches its await.
+        void response.catch(() => undefined);
+        operation.rounds++;
+        this.tokens.set(tokenKey(token), id);
+        return { requestState: token, input: value, response };
+    }
+    resume(token, binding, input) {
+        const digest = tokenKey(token);
+        const id = this.tokens.get(digest);
+        const operation = id === undefined ? undefined : this.operations.get(id);
+        if (!operation || operation.binding !== bindingKey(binding) || operation.deadline <= this.now()) {
+            throw failure('continuation_rejected');
+        }
+        const round = operation.round;
+        if (!round || round.token !== digest)
+            throw failure('continuation_rejected');
+        const value = this.payload(input);
+        // Consume synchronously before waking the same live operation.
+        this.tokens.delete(digest);
+        delete operation.round;
+        round.resolve(value);
+        return id;
+    }
+    rotate(token, binding) {
+        const previous = tokenKey(token);
+        const id = this.tokens.get(previous);
+        const operation = id === undefined ? undefined : this.operations.get(id);
+        if (!operation ||
+            operation.binding !== bindingKey(binding) ||
+            operation.deadline <= this.now() ||
+            !operation.round ||
+            operation.round.token !== previous)
+            throw failure('continuation_rejected');
+        if (operation.rounds >= this.limits.rounds) {
+            this.cancel(id, 'round_limit');
+            throw failure('round_limit');
+        }
+        const next = randomBytes(32).toString('base64url');
+        this.tokens.delete(previous);
+        operation.round = { ...operation.round, token: tokenKey(next) };
+        operation.rounds++;
+        this.tokens.set(tokenKey(next), id);
+        return next;
+    }
+    finish(id) {
+        this.cancel(id, 'completed');
+    }
+    cancel(id, reason = 'cancelled') {
+        const operation = this.operations.get(id);
+        if (!operation)
+            return;
+        this.operations.delete(id);
+        processOperations.delete(id);
+        clearTimeout(operation.timer);
+        if (operation.round) {
+            this.tokens.delete(operation.round.token);
+            operation.round.reject(failure(reason));
+        }
+        operation.controller.abort(failure(reason));
+    }
+    invalidate(binding) {
+        const key = bindingKey(binding);
+        for (const [id, operation] of this.operations) {
+            if (operation.binding === key)
+                this.cancel(id, 'authority_lost');
+        }
+    }
+    async close(drain = async () => undefined) {
+        this.closed = true;
+        for (const id of this.operations.keys())
+            this.cancel(id, 'interrupted');
+        let timer;
+        try {
+            await Promise.race([
+                drain(),
+                new Promise((resolve) => {
+                    timer = setTimeout(resolve, this.limits.drainMs);
+                }),
+            ]);
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    payload(input) {
+        const value = toImmutableJsonValue(captureJson(input, false).value);
+        if (Buffer.byteLength(JSON.stringify(value)) > this.limits.payloadBytes)
+            throw failure('payload_limit');
+        return value;
+    }
+}
+//# sourceMappingURL=interactionOwner.js.map

package/build/gateway/interactions/interactionOwner.js.map

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

package/build/gateway/interactions/interactionRoute.d.ts

@@ -0,0 +1,16 @@
+import type { GatewayRequestOptions } from '../ports/outboundEraAdapter.js';
+interface InteractionRoute {
+    readonly adapter: object;
+    readonly method: string;
+    readonly identity: string;
+    readonly isCurrent?: () => boolean;
+}
+export declare function withNativeInteractionRound<T>(handler: NonNullable<GatewayRequestOptions['interactionRound']>, operation: () => Promise<T>): Promise<T>;
+export declare function currentNativeInteractionRound(): GatewayRequestOptions['interactionRound'];
+export declare function withInteractionRoute<T>(pin: InteractionRoute, operation: () => Promise<T>): Promise<T>;
+/** A freshly recreated private peer may implement only the already-authorized source route. */
+export declare function withDerivedInteractionRoute<T>(original: object, child: object, operation: () => Promise<T>): Promise<T>;
+/** Runs at the actual provider boundary, after private bridge routing/catalog acquisition. */
+export declare function assertInteractionRoute(adapter: object, method: string, params: unknown): void;
+export {};
+//# sourceMappingURL=interactionRoute.d.ts.map

package/build/gateway/interactions/interactionRoute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactionRoute.d.ts","sourceRoot":"","sources":["../../../src/gateway/interactions/interactionRoute.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,UAAU,gBAAgB;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;CACpC;AAID,wBAAgB,0BAA0B,CAAC,CAAC,EAC1C,OAAO,EAAE,WAAW,CAAC,qBAAqB,CAAC,kBAAkB,CAAC,CAAC,EAC/D,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,wBAAgB,6BAA6B,IAAI,qBAAqB,CAAC,kBAAkB,CAAC,CAEzF;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEtG;AAED,+FAA+F;AAC/F,wBAAgB,2BAA2B,CAAC,CAAC,EAC3C,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,CAAC,CAAC,CAUZ;AAED,8FAA8F;AAC9F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAY7F"}

package/build/gateway/interactions/interactionRoute.js

@@ -0,0 +1,41 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { createGatewayFailure } from '../contracts/index.js';
+const routes = new AsyncLocalStorage();
+const nativeRounds = new AsyncLocalStorage();
+export function withNativeInteractionRound(handler, operation) {
+    return nativeRounds.run(handler, operation);
+}
+export function currentNativeInteractionRound() {
+    return nativeRounds.getStore();
+}
+export function withInteractionRoute(pin, operation) {
+    return routes.run(Object.freeze({ ...pin }), operation);
+}
+/** A freshly recreated private peer may implement only the already-authorized source route. */
+export function withDerivedInteractionRoute(original, child, operation) {
+    const pin = routes.getStore();
+    if (!pin || pin.adapter !== original || pin.isCurrent?.() === false) {
+        throw createGatewayFailure({
+            kind: 'authorization',
+            code: 'interaction_lost',
+            message: 'Interaction route is no longer available',
+        });
+    }
+    return withInteractionRoute({ ...pin, adapter: child }, operation);
+}
+/** Runs at the actual provider boundary, after private bridge routing/catalog acquisition. */
+export function assertInteractionRoute(adapter, method, params) {
+    const pin = routes.getStore();
+    if (!pin || !['tools/call', 'prompts/get', 'resources/read'].includes(method))
+        return;
+    const key = method === 'resources/read' ? 'uri' : 'name';
+    const identity = params && typeof params === 'object' ? params[key] : undefined;
+    if (pin.adapter !== adapter || pin.method !== method || pin.identity !== identity || pin.isCurrent?.() === false) {
+        throw createGatewayFailure({
+            kind: 'authorization',
+            code: 'interaction_lost',
+            message: 'Interaction route is no longer available',
+        });
+    }
+}
+//# sourceMappingURL=interactionRoute.js.map

package/build/gateway/interactions/interactionRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactionRoute.js","sourceRoot":"","sources":["../../../src/gateway/interactions/interactionRoute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAS7D,MAAM,MAAM,GAAG,IAAI,iBAAiB,EAAoB,CAAC;AACzD,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAA0D,CAAC;AAErG,MAAM,UAAU,0BAA0B,CACxC,OAA+D,EAC/D,SAA2B;IAE3B,OAAO,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,YAAY,CAAC,QAAQ,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,GAAqB,EAAE,SAA2B;IACxF,OAAO,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;AAC1D,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,2BAA2B,CACzC,QAAgB,EAChB,KAAa,EACb,SAA2B;IAE3B,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,EAAE,EAAE,KAAK,KAAK,EAAE,CAAC;QACpE,MAAM,oBAAoB,CAAC;YACzB,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,0CAA0C;SACpD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,oBAAoB,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;AACrE,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,MAAc,EAAE,MAAe;IACrF,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,YAAY,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO;IACtF,MAAM,GAAG,GAAG,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACzD,MAAM,QAAQ,GAAG,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAE,MAAkC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7G,IAAI,GAAG,CAAC,OAAO,KAAK,OAAO,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,SAAS,EAAE,EAAE,KAAK,KAAK,EAAE,CAAC;QACjH,MAAM,oBAAoB,CAAC;YACzB,IAAI,EAAE,eAAe;YACrB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,0CAA0C;SACpD,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}