ds-harness-remote 0.5.7 → 0.5.10

package/dist/terminal-carrier-compat.js

@@ -0,0 +1,259 @@
+import { z } from 'zod';
+import { RpcError } from './safe-error.js';
+import { uuidV7 } from './ids.js';
+const identity = z.string().regex(/^[A-Za-z0-9_:-]{1,256}$/);
+const attachmentArgs = z.object({ agentId: identity, id: identity, attachmentId: identity }).strict();
+const dimensions = { cols: z.number().int().min(1).max(1000), rows: z.number().int().min(1).max(1000) };
+const input = z.discriminatedUnion('type', [
+    z.object({ type: z.literal('write'), sequence: z.number().int().positive().safe(), data: z.string().max(64 * 1024) }).strict(),
+    z.object({ type: z.literal('resize'), sequence: z.number().int().positive().safe(), ...dimensions }).strict(),
+]);
+/** Fixed terminal API changed in 0.2.1-alpha.3; other streams remain read-only. */
+export function usesDuplexTerminal(version) {
+    const match = /^(?:dsh-)?v?0\.(\d+)\.(\d+)(?:-([^+]+))?(?:\+.*)?$/.exec(version ?? '');
+    if (!match)
+        return false;
+    const minor = Number(match[1]), patch = Number(match[2]);
+    if (minor > 2 || (minor === 2 && patch > 1))
+        return true;
+    if (minor !== 2 || patch !== 1)
+        return false;
+    return match[3] === undefined || !match[3].startsWith('alpha.') || Number(match[3].slice(6)) >= 3;
+}
+/** Bounded single-consumer queue. Closing discards inputs, never replays them. */
+class Queue {
+    maxBytes;
+    maxItems;
+    values = [];
+    bytes = 0;
+    wake;
+    closed = false;
+    error;
+    constructor(maxBytes = 256 * 1024, maxItems = 64) {
+        this.maxBytes = maxBytes;
+        this.maxItems = maxItems;
+    }
+    push(value) {
+        if (this.closed)
+            throw new RpcError('TRANSPORT_CLOSED', 'The terminal attachment closed.');
+        const bytes = new TextEncoder().encode(JSON.stringify(value)).byteLength;
+        if (this.values.length >= this.maxItems || this.bytes + bytes > this.maxBytes)
+            throw new RpcError('RATE_LIMITED', 'The terminal attachment buffer is full.');
+        this.values.push({ value, bytes });
+        this.bytes += bytes;
+        this.wake?.();
+    }
+    close(error, discard = false) {
+        if (this.closed)
+            return;
+        this.closed = true;
+        this.error = error;
+        if (discard) {
+            this.values = [];
+            this.bytes = 0;
+        }
+        this.wake?.();
+    }
+    async *[Symbol.asyncIterator]() {
+        while (true) {
+            const entry = this.values.shift();
+            if (entry) {
+                this.bytes -= entry.bytes;
+                yield entry.value;
+            }
+            else if (this.closed)
+                break;
+            else
+                await new Promise(resolve => { this.wake = resolve; });
+        }
+        if (this.error)
+            throw this.error;
+    }
+}
+/** Existing Remote follow/write/resize calls terminate at the official attach stream. */
+export class TerminalCarrierCompat {
+    gateway;
+    attachments = new Map();
+    constructor(gateway) {
+        this.gateway = gateway;
+    }
+    async open(payload, signal) {
+        signal.throwIfAborted();
+        const args = attachmentArgs.parse(z.object({ args: z.unknown() }).strict().parse(payload).args);
+        const key = `${args.agentId}/${args.id}`;
+        this.attachments.get(key)?.control.abort();
+        const control = new AbortController();
+        const queue = new Queue();
+        const entry = { args, control, queue, sequence: 0, writable: false, pending: new Map() };
+        const lifetime = AbortSignal.any([signal, control.signal]);
+        const close = () => {
+            queue.close(undefined, true);
+            for (const pending of entry.pending.values())
+                pending.reject(new RpcError('TRANSPORT_CLOSED', 'The terminal attachment closed. Input will not be replayed.'));
+            entry.pending.clear();
+            if (this.attachments.get(key) === entry)
+                this.attachments.delete(key);
+        };
+        lifetime.addEventListener('abort', close, { once: true });
+        lifetime.throwIfAborted();
+        this.attachments.set(key, entry);
+        let source;
+        try {
+            source = await this.gateway.open('terminal/attach', { args: { agentId: args.agentId, id: args.id } }, lifetime, queue);
+        }
+        catch (error) {
+            control.abort();
+            throw error;
+        }
+        return (async function* () {
+            try {
+                for await (const value of source) {
+                    if (lifetime.aborted)
+                        break;
+                    if (isRecord(value) && value.type === 'ack') {
+                        const pending = entry.pending.get(Number(value.sequence));
+                        if (!pending)
+                            throw new RpcError('INVALID_MESSAGE', 'Unexpected terminal input acknowledgement.');
+                        entry.pending.delete(Number(value.sequence));
+                        if (value.refusal)
+                            pending.reject(new RpcError('PERMISSION_DENIED', 'Terminal input was refused.'));
+                        else
+                            pending.resolve();
+                    }
+                    else if (isRecord(value) && (value.type === 'snapshot' || value.type === 'state') && isRecord(value.info)) {
+                        entry.writable = value.writable === true;
+                        yield { ...value, info: { ...value.info, ...(entry.writable ? { controllerId: args.attachmentId } : {}) } };
+                    }
+                    else
+                        yield value;
+                }
+            }
+            finally {
+                control.abort();
+                lifetime.removeEventListener('abort', close);
+            }
+        })();
+    }
+    async call(endpoint, payload, signal) {
+        const fields = endpoint === 'terminal/write' ? { data: z.string().max(64 * 1024) } : dimensions;
+        const args = attachmentArgs.extend(fields).parse(z.object({ args: z.unknown() }).strict().parse(payload).args);
+        const entry = this.attachments.get(`${args.agentId}/${args.id}`);
+        if (!entry || entry.args.attachmentId !== args.attachmentId || !entry.writable)
+            throw new RpcError('PERMISSION_DENIED', 'This terminal input attachment is not writable.');
+        if (entry.pending.size >= 32)
+            throw new RpcError('RATE_LIMITED', 'Too many unacknowledged terminal inputs.');
+        signal.throwIfAborted();
+        const sequence = ++entry.sequence;
+        const value = input.parse({ type: endpoint === 'terminal/write' ? 'write' : 'resize', sequence,
+            ...('data' in args ? { data: args.data } : { cols: args.cols, rows: args.rows }) });
+        const abort = () => entry.control.abort();
+        signal.addEventListener('abort', abort, { once: true });
+        try {
+            await new Promise((resolve, reject) => {
+                entry.pending.set(sequence, { resolve, reject });
+                try {
+                    entry.queue.push(value);
+                }
+                catch (error) {
+                    entry.pending.delete(sequence);
+                    entry.control.abort();
+                    reject(error);
+                }
+            });
+            return { ok: true };
+        }
+        finally {
+            signal.removeEventListener('abort', abort);
+        }
+    }
+}
+/** Native RC.1 Client attach stream over the existing encrypted terminal subset. */
+export async function openRemoteTerminal(target, payload, signal, uplink) {
+    const args = z.object({ agentId: identity, id: identity }).strict().parse(z.object({ args: z.unknown() }).strict().parse(payload).args);
+    const attachmentId = uuidV7();
+    const control = new AbortController();
+    const lifetime = AbortSignal.any([signal, control.signal]);
+    const output = new Queue(4 * 1024 * 1024, 256);
+    let writable = false;
+    const iterator = uplink[Symbol.asyncIterator]();
+    const abort = () => { output.close(); void iterator.return?.().catch(() => undefined); };
+    lifetime.addEventListener('abort', abort, { once: true });
+    lifetime.throwIfAborted();
+    let source;
+    try {
+        source = await target.open('terminal/follow', { args: { ...args, attachmentId } }, lifetime);
+    }
+    catch (error) {
+        control.abort();
+        throw error;
+    }
+    let startInput;
+    const ready = new Promise(resolve => { startInput = resolve; });
+    lifetime.addEventListener('abort', startInput, { once: true });
+    if (lifetime.aborted)
+        startInput();
+    void (async () => {
+        try {
+            for await (const value of source) {
+                if (lifetime.aborted)
+                    break;
+                if (isRecord(value) && (value.type === 'snapshot' || value.type === 'state') && isRecord(value.info)) {
+                    writable = value.info.controllerId === attachmentId;
+                    output.push({ ...value, writable });
+                    if (value.type === 'snapshot')
+                        startInput();
+                }
+                else
+                    output.push(value);
+            }
+        }
+        catch (error) {
+            output.close(error);
+        }
+        finally {
+            control.abort();
+        }
+    })();
+    void (async () => {
+        let sequence = 0;
+        try {
+            await ready;
+            while (!lifetime.aborted) {
+                const next = await iterator.next();
+                if (next.done || lifetime.aborted)
+                    break;
+                const value = input.parse(next.value);
+                if (value.sequence !== ++sequence)
+                    throw new RpcError('INVALID_MESSAGE', 'Terminal input sequence is invalid.');
+                if (!writable) {
+                    output.push({ type: 'ack', sequence, refusal: 'read-only' });
+                    continue;
+                }
+                const result = await target.dispatch(`terminal/${value.type}`, { args: { ...args, attachmentId,
+                        ...(value.type === 'write' ? { data: value.data } : { cols: value.cols, rows: value.rows }) } }, lifetime);
+                if (!result.ok)
+                    throw Object.assign(new Error(result.error.message), result.error);
+                if (!lifetime.aborted)
+                    output.push({ type: 'ack', sequence });
+            }
+        }
+        catch (error) {
+            output.close(error);
+            control.abort();
+        }
+    })();
+    return (async function* () {
+        try {
+            yield* output;
+        }
+        finally {
+            control.abort();
+            lifetime.removeEventListener('abort', abort);
+            lifetime.removeEventListener('abort', startInput);
+        }
+    })();
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=terminal-carrier-compat.js.map

package/dist/terminal-carrier-compat.js.map

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

package/dist/terminal-policy.d.ts

@@ -6,15 +6,21 @@ export declare class TerminalPolicy {
     private readonly enabled;
     private readonly deviceId;
     private readonly owners;
+    private static readonly claims;
     private readonly attachments;
+    private readonly claims;
     constructor(enabled: boolean | (() => boolean), deviceId: string, owners: Map<string, string>);
+    /** Host process cleanup releases the exact terminal identity for every connection. */
+    static releaseOwner(owners: Map<string, string>, key: string): void;
     check(endpoint: string, payload: unknown): {
         key?: string;
         created?: boolean;
+        claim?: object;
     };
     result(endpoint: string, payload: unknown, result: TypertRpcResult, reservation: {
         key?: string;
         created?: boolean;
+        claim?: object;
     }): TypertRpcResult;
     private deny;
 }

package/dist/terminal-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-policy.d.ts","sourceRoot":"","sources":["../src/terminal-policy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAGnE,eAAO,MAAM,cAAc,aACoE,CAAA;AAC/F,eAAO,MAAM,gBAAgB,aAAkD,CAAA;AAG/E,kGAAkG;AAClG,qBAAa,cAAc;IAEb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAA6B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACxF,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4B;gBAC3B,OAAO,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,EAAmB,QAAQ,EAAE,MAAM,EAC/E,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAE9C,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE;IA6B9E,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,eAAe;IActI,OAAO,CAAC,IAAI;CACb"}
+{"version":3,"file":"terminal-policy.d.ts","sourceRoot":"","sources":["../src/terminal-policy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAGnE,eAAO,MAAM,cAAc,aACoE,CAAA;AAC/F,eAAO,MAAM,gBAAgB,aAAkD,CAAA;AAG/E,kGAAkG;AAClG,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,OAAO;IAA6B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACxF,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAA0D;IACxF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoD;IAChF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;gBACf,OAAO,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,EAAmB,QAAQ,EAAE,MAAM,EAC/E,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAK9C,sFAAsF;IACtF,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAKnE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IA+B9F,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe;IAkBtJ,OAAO,CAAC,IAAI;CACb"}

package/dist/terminal-policy.js

@@ -10,15 +10,27 @@ export class TerminalPolicy {
     enabled;
     deviceId;
     owners;
+    static claims = new WeakMap();
     attachments = new Map();
+    claims;
     constructor(enabled, deviceId, owners) {
         this.enabled = enabled;
         this.deviceId = deviceId;
         this.owners = owners;
+        this.claims = TerminalPolicy.claims.get(owners) ?? new Map();
+        TerminalPolicy.claims.set(owners, this.claims);
+    }
+    /** Host process cleanup releases the exact terminal identity for every connection. */
+    static releaseOwner(owners, key) {
+        owners.delete(key);
+        TerminalPolicy.claims.get(owners)?.delete(key);
     }
     check(endpoint, payload) {
         if (!(typeof this.enabled === 'function' ? this.enabled() : this.enabled))
             throw new RpcError('TERMINAL_DISABLED', 'Remote terminal is disabled on this Host. Enable Remote terminal in the Host Remote settings; the switch saves and applies immediately. / 远程终端未开启，请在 Host 的 Remote 设置中开启「远程终端」，开关切换后立即保存并生效。');
+        for (const [key, attachment] of this.attachments)
+            if (this.owners.get(key) !== this.deviceId || this.claims.get(key) !== attachment.claim)
+                this.attachments.delete(key);
         const args = z.object({ args: z.record(z.unknown()) }).strict().parse(payload).args;
         const rawSessionId = args.agentId ?? args.sessionId;
         const sessionId = id.parse(rawSessionId);
@@ -38,21 +50,27 @@ export class TerminalPolicy {
                 throw new RpcError('RATE_LIMITED', 'Too many retained remote terminals.');
             const created = !this.owners.has(key);
             this.owners.set(key, this.deviceId);
-            return { key, created };
+            if (created || !this.claims.has(key))
+                this.claims.set(key, {});
+            return { key, created, claim: this.claims.get(key) };
         }
         if (this.owners.get(key) !== this.deviceId)
             this.deny();
         if (endpoint === 'terminal/follow')
-            this.attachments.set(key, id.parse(args.attachmentId));
+            this.attachments.set(key, { id: id.parse(args.attachmentId), claim: this.claims.get(key) });
         if (endpoint === 'terminal/write' || endpoint === 'terminal/resize') {
-            if (this.attachments.get(key) !== id.parse(args.attachmentId))
+            if (this.attachments.get(key)?.id !== id.parse(args.attachmentId))
                 this.deny();
         }
-        return { key };
+        return { key, claim: this.claims.get(key) };
     }
     result(endpoint, payload, result, reservation) {
-        if (reservation.key !== undefined && ((!result.ok && reservation.created) || (result.ok && endpoint === 'terminal/close'))) {
-            this.owners.delete(reservation.key);
+        const releases = (!result.ok && reservation.created && result.error.code !== 'TERMINAL_CLEANUP_FAILED') || (result.ok && endpoint === 'terminal/close');
+        // Cleanup can finish before an older RPC response. Its response must not
+        // release a new allocation that has since claimed the same identity.
+        if (reservation.key !== undefined && releases && this.owners.get(reservation.key) === this.deviceId
+            && this.claims.get(reservation.key) === reservation.claim) {
+            TerminalPolicy.releaseOwner(this.owners, reservation.key);
             this.attachments.delete(reservation.key);
         }
         if (endpoint === 'terminal/list' && result.ok && Array.isArray(result.value)) {

package/dist/terminal-policy.js.map

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

package/dist/typert-gateway-contract.d.ts

@@ -4,6 +4,8 @@ export interface TypertGatewayRequest {
     /** Typert Remote payloads require one plain object under `args`. */
     args: Readonly<Record<string, unknown>>;
     signal?: AbortSignal;
+    peer?: unknown;
+    uplink?: AsyncIterable<unknown>;
 }
 export type TypertRpcResult = {
     ok: true;
@@ -47,13 +49,16 @@ export interface TypertGatewayLike {
 /** Carrier-level face captured from the alpha Gateway before target switching. */
 export interface LocalTypertGateway extends TypertGatewayLike {
     dispatch(endpoint: string, payload: unknown, signal: AbortSignal): Promise<TypertRpcResult>;
-    open(endpoint: string, payload: unknown, signal: AbortSignal): Promise<AsyncIterable<unknown>>;
+    open(endpoint: string, payload: unknown, signal: AbortSignal, uplink?: AsyncIterable<unknown>): Promise<AsyncIterable<unknown>>;
     failure(error: unknown): {
         code: string;
         message: string;
         details: Record<string, unknown>;
     };
     supportsCarrier: boolean;
+    peer?: unknown;
+    createPeer?(): LocalTypertGateway;
+    dispose?(): Promise<void>;
 }
 export interface RemoteTypertGatewayTarget {
     invoke(request: TypertGatewayRequest): Promise<unknown>;

package/dist/typert-gateway-contract.d.ts.map

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

package/dist/typert-gateway-switch.d.ts

@@ -22,7 +22,7 @@ export declare class TypertGatewaySwitch {
     private installed;
     constructor(gateway: TypertGatewayLike);
     /** Original local dispatcher, used by the Host bridge without switch recursion. */
-    local(): LocalTypertGateway;
+    local(peer?: unknown): LocalTypertGateway;
     supportsCarrier(): boolean;
     status(): {
         mode: 'local' | 'remote';
@@ -40,6 +40,7 @@ export declare class TypertGatewaySwitch {
     /** Keep the selected authority after transport loss; only explicit exit returns local. */
     disconnectRemote(): void;
     restore(): void;
+    private openRemote;
     private selectInvoke;
     private failure;
 }

package/dist/typert-gateway-switch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typert-gateway-switch.d.ts","sourceRoot":"","sources":["../src/typert-gateway-switch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,kBAAkB,EAElB,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EAErB,MAAM,8BAA8B,CAAA;AAErC,KAAK,YAAY,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AA2BvE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;CACd;AAID,gFAAgF;AAChF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA0C;IAC1E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAA0C;IACvE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAiB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAiC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAa;IACxC,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,YAAY,CAAC,CAA2B;IAChD,OAAO,CAAC,aAAa,CAAwD;IAC7E,OAAO,CAAC,MAAM,CAAC,CAAoC;IACnD,OAAO,CAAC,SAAS,CAAQ;gBAEb,OAAO,EAAE,iBAAiB;IAYtC,mFAAmF;IACnF,KAAK,IAAI,kBAAkB;IAuB3B,eAAe,IAAI,OAAO;IAI1B,MAAM,IAAI;QAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;IAMnF,OAAO,IAAI,IAAI;IAiCf,YAAY,CACV,MAAM,EAAE,YAAY,GAAG,yBAAyB,EAChD,OAAO,GAAE,oBAA0C,EACnD,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAC1C,IAAI;IAQP,WAAW,IAAI,IAAI;IAOnB,0FAA0F;IAC1F,gBAAgB,IAAI,IAAI;IAexB,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,OAAO;CAQhB"}
+{"version":3,"file":"typert-gateway-switch.d.ts","sourceRoot":"","sources":["../src/typert-gateway-switch.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,kBAAkB,EAElB,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EAErB,MAAM,8BAA8B,CAAA;AAErC,KAAK,YAAY,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AA2BvE,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;CACd;AAID,gFAAgF;AAChF,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA0C;IAC1E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAA0C;IACvE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAiB;IACnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAiC;IAC/D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAa;IACxC,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,OAAO,CAAC,YAAY,CAAC,CAA2B;IAChD,OAAO,CAAC,aAAa,CAAwD;IAC7E,OAAO,CAAC,MAAM,CAAC,CAAoC;IACnD,OAAO,CAAC,SAAS,CAAQ;gBAEb,OAAO,EAAE,iBAAiB;IAYtC,mFAAmF;IACnF,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,kBAAkB;IAyBzC,eAAe,IAAI,OAAO;IAI1B,MAAM,IAAI;QAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;IAMnF,OAAO,IAAI,IAAI;IAsCf,YAAY,CACV,MAAM,EAAE,YAAY,GAAG,yBAAyB,EAChD,OAAO,GAAE,oBAA0C,EACnD,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAC1C,IAAI;IAQP,WAAW,IAAI,IAAI;IAOnB,0FAA0F;IAC1F,gBAAgB,IAAI,IAAI;IAexB,OAAO,IAAI,IAAI;IAUf,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,OAAO;CAQhB"}

package/dist/typert-gateway-switch.js

@@ -1,3 +1,4 @@
+import { openRemoteTerminal } from './terminal-carrier-compat.js';
 const REMOTE_COMMAND_METHODS = ['execute', 'list'];
 const LOCAL_ONLY_NAMESPACES = new Set(['dynamicCordisRunner']);
 const ALL_REMOTE_COMMANDS = { execute: true, list: true };
@@ -29,24 +30,26 @@ export class TypertGatewaySwitch {
         this.localOpen = createLocalOpen(gateway, this.runtime);
     }
     /** Original local dispatcher, used by the Host bridge without switch recursion. */
-    local() {
-        const dispatch = this.localDispatch ?? (async (endpoint, payload, signal) => {
+    local(peer) {
+        const invoke = request => this.localInvoke({ ...request, ...(peer === undefined ? {} : { peer }) });
+        const dispatch = this.localDispatch === undefined ? (async (endpoint, payload, signal) => {
             try {
                 const request = requestFromCarrier(endpoint, payload, signal);
-                return { ok: true, value: await this.localInvoke(request) };
+                return { ok: true, value: await invoke(request) };
             }
             catch (error) {
                 return { ok: false, error: this.failure(error) };
             }
-        });
-        const open = this.localOpen ?? (async (endpoint, payload, signal) => {
+        }) : (endpoint, payload, signal) => this.localDispatch(endpoint, payload, signal, peer);
+        const open = this.localOpen === undefined ? (async (endpoint, payload, signal) => {
             if (this.localStream === undefined)
                 throw new Error('The local Harness Gateway does not support Remote streams.');
-            return this.localStream(requestFromCarrier(endpoint, payload, signal));
-        });
+            return this.localStream({ ...requestFromCarrier(endpoint, payload, signal), ...(peer === undefined ? {} : { peer }) });
+        }) : (endpoint, payload, signal, uplink) => this.localOpen(endpoint, payload, signal, uplink, peer);
         return {
-            invoke: this.localInvoke,
-            ...(this.localStream === undefined ? {} : { stream: this.localStream }),
+            invoke,
+            peer,
+            ...(this.localStream === undefined ? {} : { stream: (request) => this.localStream({ ...request, ...(peer === undefined ? {} : { peer }) }) }),
             dispatch,
             open,
             failure: error => this.failure(error),
@@ -68,12 +71,17 @@ export class TypertGatewaySwitch {
         if (this.originalStream !== undefined) {
             this.runtime.stream = request => this.remoteTarget === undefined || isLocalOnlyEndpoint(endpointOf(request))
                 ? this.localStream(request)
-                : this.remoteTarget.open(endpointOf(request), { args: request.args }, request.signal ?? new AbortController().signal);
+                : this.openRemote(endpointOf(request), { args: request.args }, request.signal ?? new AbortController().signal, request.uplink);
         }
         if (this.originalDispatch !== undefined) {
-            this.runtime.dispatchRpc = (endpoint, payload, signal) => this.remoteTarget === undefined || isLocalOnlyEndpoint(endpoint)
-                ? this.localDispatch(endpoint, payload, signal)
-                : this.remoteTarget.dispatch(endpoint, payload, signal).then(result => workspaceConnectionResult(endpoint, result), error => ({ ok: false, error: this.failure(error) }));
+            this.runtime.dispatchRpc = (...args) => {
+                const [endpoint, payload, signal] = args;
+                // The local Gateway owns the caller's Peer and its lifetime. Preserve
+                // every carrier argument; Peer objects never cross the Remote tunnel.
+                return this.remoteTarget === undefined || isLocalOnlyEndpoint(endpoint)
+                    ? this.localDispatch(...args)
+                    : this.remoteTarget.dispatch(endpoint, payload, signal).then(result => workspaceConnectionResult(endpoint, result), error => ({ ok: false, error: this.failure(error) }));
+            };
         }
         if (this.originalOpen !== undefined) {
             const open = this.originalOpen;
@@ -86,7 +94,7 @@ export class TypertGatewaySwitch {
                         : open.call(this.runtime, endpoint, callArgs[1], callArgs[2]);
                 }
                 const signal = (rc1 ? callArgs[4] : callArgs[2]);
-                return this.remoteTarget.open(endpoint, callArgs[1], signal ?? new AbortController().signal);
+                return this.openRemote(endpoint, callArgs[1], signal ?? new AbortController().signal, rc1 ? callArgs[2] : undefined);
             };
         }
         this.installed = true;
@@ -134,11 +142,16 @@ export class TypertGatewaySwitch {
             this.runtime.openWireStream = this.originalOpen;
         this.installed = false;
     }
+    openRemote(endpoint, payload, signal, uplink) {
+        return endpoint === 'terminal/attach'
+            ? openRemoteTerminal(this.remoteTarget, payload, signal, uplink ?? endedUplink())
+            : this.remoteTarget.open(endpoint, payload, signal);
+    }
     selectInvoke(request) {
         if (isLocalOnlyEndpoint(endpointOf(request)))
             return this.localInvoke(request);
         if (this.remoteTarget !== undefined)
-            return this.remoteTarget.invoke(request);
+            return this.remoteTarget.invoke(request).then(value => normalizeTerminalEnvironment(endpointOf(request), value));
         if (request.namespace !== 'commands' || !isRemoteCommandMethod(request.method) || this.remoteInvoke === undefined) {
             return this.localInvoke(request);
         }
@@ -160,6 +173,8 @@ export class TypertGatewaySwitch {
 }
 /** The local Connection HTTP hop needs the same binary envelope as the native Gateway. */
 function workspaceConnectionResult(endpoint, result) {
+    if (endpoint === 'terminal/environment' && result.ok)
+        return { ...result, value: normalizeTerminalEnvironment(endpoint, result.value) };
     if (endpoint !== 'workspaceFiles/readBytes' && endpoint !== 'officeToPdf/render')
         return result;
     if (!result.ok || !isRecord(result.value) || !(result.value.data instanceof Uint8Array))
@@ -210,8 +225,8 @@ function createLocalOpen(gateway, runtime) {
     const open = runtime.openWireStream;
     if (open !== undefined) {
         return usesRc1Arity(open)
-            ? (endpoint, payload, signal) => open
-                .call(runtime, endpoint, payload, endedUplink(), undefined, signal, linkControl(signal))
+            ? (endpoint, payload, signal, uplink, peer) => open
+                .call(runtime, endpoint, payload, uplink ?? endedUplink(), peer, signal, linkControl(signal))
             : (endpoint, payload, signal) => open.call(runtime, endpoint, payload, signal);
     }
     const wire = gateway.wireStream;
@@ -220,7 +235,7 @@ function createLocalOpen(gateway, runtime) {
     const wireOpen = wire.open;
     if (usesRc1Arity(wireOpen)) {
         const rc1 = wireOpen;
-        return (endpoint, payload, signal) => rc1.call(wire, endpoint, payload, endedUplink(), undefined, signal);
+        return (endpoint, payload, signal, uplink, peer) => rc1.call(wire, endpoint, payload, uplink ?? endedUplink(), peer, signal);
     }
     const legacy = wireOpen;
     return (endpoint, payload, signal) => legacy.call(wire, endpoint, payload, signal);
@@ -248,4 +263,10 @@ function isRemoteCommandMethod(method) {
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }
+/** RC.1 input flow control also applies to older Hosts and CodeX/ACP projections. */
+function normalizeTerminalEnvironment(endpoint, value) {
+    if (endpoint !== 'terminal/environment' || !isRecord(value) || value.maxBufferedBytes !== undefined)
+        return value;
+    return { ...value, maxBufferedBytes: 256 * 1024 };
+}
 //# sourceMappingURL=typert-gateway-switch.js.map