@blue-soda/dsh-remote 0.4.28

package/dist/typert-gateway-switch.js

@@ -0,0 +1,315 @@
+const REMOTE_COMMAND_METHODS = ['execute', 'list'];
+const LOCAL_ONLY_NAMESPACES = new Set(['dynamicCordisRunner']);
+const ALL_REMOTE_COMMANDS = { execute: true, list: true };
+/** Keeps the official Gateway object stable while its selected Host changes. */
+export class TypertGatewaySwitch {
+    runtime;
+    originalInvoke;
+    localInvoke;
+    originalStream;
+    localStream;
+    originalDispatch;
+    localDispatch;
+    originalOpen;
+    localOpen;
+    remoteInvoke;
+    remoteTarget;
+    remoteSupport = { execute: false, list: false };
+    target;
+    installed = false;
+    /** Defaults to reachable so a caller that never wires this keeps the old behaviour. */
+    remoteAvailability = () => true;
+    constructor(gateway) {
+        this.runtime = gateway;
+        this.originalInvoke = gateway.invoke;
+        this.localInvoke = this.originalInvoke.bind(gateway);
+        this.originalStream = gateway.stream;
+        this.localStream = gateway.stream?.bind(gateway);
+        this.originalDispatch = this.runtime.dispatchRpc;
+        this.localDispatch = this.runtime.dispatchRpc?.bind(gateway);
+        this.originalOpen = this.runtime.openWireStream;
+        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) => {
+            try {
+                const request = requestFromCarrier(endpoint, payload, signal);
+                return { ok: true, value: await this.localInvoke(request) };
+            }
+            catch (error) {
+                return { ok: false, error: this.failure(error) };
+            }
+        });
+        const open = this.localOpen ?? (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 {
+            invoke: this.localInvoke,
+            ...(this.localStream === undefined ? {} : { stream: this.localStream }),
+            dispatch,
+            open,
+            failure: error => this.failure(error),
+            supportsCarrier: this.localDispatch !== undefined && this.localOpen !== undefined,
+        };
+    }
+    supportsCarrier() {
+        return this.localDispatch !== undefined && this.localOpen !== undefined;
+    }
+    status() {
+        return this.remoteInvoke === undefined
+            ? { mode: 'local' }
+            : { mode: 'remote', ...(this.target === undefined ? {} : { target: { ...this.target } }) };
+    }
+    install() {
+        if (this.installed)
+            return;
+        this.runtime.invoke = request => this.selectInvoke(request);
+        if (this.originalStream !== undefined) {
+            this.runtime.stream = request => !this.routesToRemote(endpointOf(request))
+                ? this.localStream(request)
+                : this.withLocalFallback(endpointOf(request), () => this.remoteTarget.open(endpointOf(request), { args: request.args }, request.signal ?? new AbortController().signal), () => this.localStream(request));
+        }
+        if (this.originalDispatch !== undefined) {
+            this.runtime.dispatchRpc = (endpoint, payload, signal) => !this.routesToRemote(endpoint)
+                ? this.localDispatch(endpoint, payload, signal)
+                : this.withLocalFallback(endpoint, () => Promise.resolve(this.remoteTarget.dispatch(endpoint, payload, signal)), () => this.localDispatch(endpoint, payload, signal));
+        }
+        if (this.originalOpen !== undefined) {
+            const open = this.originalOpen;
+            const rc1 = usesRc1Arity(open);
+            this.runtime.openWireStream = (...callArgs) => {
+                const endpoint = callArgs[0];
+                if (!this.routesToRemote(endpoint)) {
+                    return rc1
+                        ? Reflect.apply(open, this.runtime, callArgs)
+                        : open.call(this.runtime, endpoint, callArgs[1], callArgs[2]);
+                }
+                const signal = (rc1 ? callArgs[4] : callArgs[2]);
+                if (!rc1) {
+                    // The legacy carrier returns an iterable, so a rejection cannot be caught and
+                    // the local fallback stays unavailable on that arity.
+                    return this.remoteTarget.open(endpoint, callArgs[1], signal ?? new AbortController().signal);
+                }
+                return this.withLocalFallback(endpoint, () => this.remoteTarget.open(endpoint, callArgs[1], signal ?? new AbortController().signal), () => Reflect.apply(open, this.runtime, callArgs));
+            };
+        }
+        this.installed = true;
+    }
+    selectRemote(remote, support = ALL_REMOTE_COMMANDS, target) {
+        if (!this.installed)
+            throw new Error('The Typert gateway switch is not installed.');
+        this.remoteInvoke = typeof remote === 'function' ? remote : request => remote.invoke(request);
+        this.remoteTarget = typeof remote === 'function' ? undefined : remote;
+        this.remoteSupport = { ...support };
+        this.target = target === undefined ? undefined : { ...target };
+    }
+    selectLocal() {
+        this.remoteInvoke = undefined;
+        this.remoteTarget = undefined;
+        this.remoteSupport = { execute: false, list: false };
+        this.target = undefined;
+    }
+    /**
+     * The local shell's carriers, for a remote target that owns only part of the
+     * endpoint space. The Codex virtual Harness owns the CodeX domain; the shell's own
+     * settings bootstrap, plugin registry and account reads must stay here, or the
+     * window describes the remote Host instead of this installation.
+     * @returns the captured local carriers, absent when the running release has none.
+     */
+    localCarrier() {
+        return {
+            ...(this.localDispatch === undefined ? {} : { dispatch: this.localDispatch }),
+            ...(this.localOpen === undefined ? {} : { open: this.localOpen }),
+        };
+    }
+    restore() {
+        if (!this.installed)
+            return;
+        this.selectLocal();
+        this.runtime.invoke = this.originalInvoke;
+        if (this.originalStream !== undefined)
+            this.runtime.stream = this.originalStream;
+        if (this.originalDispatch !== undefined)
+            this.runtime.dispatchRpc = this.originalDispatch;
+        if (this.originalOpen !== undefined)
+            this.runtime.openWireStream = this.originalOpen;
+        this.installed = false;
+    }
+    /**
+     * Whether the peer a remote target routes to is reachable right now.
+     *
+     * A remote-mode boot still needs its own local services — localizations, theme,
+     * the plugin registry — before any remote work can happen. Routing those to a
+     * peer that is not connected leaves them unanswered, so the whole shell fails to
+     * activate: a dropped connection becomes "the application is unavailable" and
+     * stays that way until the user restarts into local mode. Serve local while the
+     * peer is away; the live session takes over again as soon as it is reachable.
+     */
+    setRemoteAvailability(check) { this.remoteAvailability = check; }
+    routesToRemote(endpoint) {
+        return this.remoteTarget !== undefined && !isLocalOnlyEndpoint(endpoint) && this.remoteAvailability();
+    }
+    selectInvoke(request) {
+        if (isLocalOnlyEndpoint(endpointOf(request)))
+            return this.localInvoke(request);
+        if (this.remoteTarget !== undefined && this.remoteAvailability()) {
+            // A remote-mode boot still issues RPCs only the local shell can answer: the
+            // Desktop asks the local Web server for its locale bootstrap before any remote
+            // work happens. Sweeping those to the peer failed as "desktop welcome: Web RPC
+            // failed", the locale plugin failed with it, and 48 entries never activated.
+            // Serve locally when the peer does not implement the endpoint, or when it went
+            // away mid-call; a business error still propagates.
+            return this.remoteTarget.invoke(request).catch(error => {
+                if (!isUnansweredByPeer(error))
+                    throw error;
+                console.warn(`[dsh-remote] serving ${endpointOf(request)} locally: the peer did not answer it`, error);
+                return this.localInvoke(request);
+            });
+        }
+        if (request.namespace !== 'commands' || !isRemoteCommandMethod(request.method) || this.remoteInvoke === undefined) {
+            return this.localInvoke(request);
+        }
+        if (!this.remoteAvailability())
+            return this.localInvoke(request);
+        if (this.remoteSupport[request.method])
+            return this.remoteInvoke(request);
+        if (request.method === 'list')
+            return Promise.resolve([]);
+        return this.localInvoke(request);
+    }
+    /**
+     * Run a remote call, and answer it locally when the peer turns out not to serve
+     * that endpoint. A remote-mode boot still issues RPCs only the local shell can
+     * answer: the Desktop asks the local Web server for its locale bootstrap over the
+     * remote mux before any remote work happens. Forwarding those swept them to a host
+     * that does not implement them, the locale plugin failed, and every entry
+     * depending on it stayed pending. A genuine business error still propagates.
+     * @param endpoint - endpoint being routed, for the diagnostic warning.
+     * @param remote - the remote carrier call.
+     * @param local - the local call used when the peer could not answer.
+     * @returns the remote or local result.
+     */
+    withLocalFallback(endpoint, remote, local) {
+        return remote().catch(error => {
+            if (!isUnansweredByPeer(error))
+                throw error;
+            console.warn(`[dsh-remote] serving ${endpoint} locally: the peer did not answer it`, error);
+            return local();
+        });
+    }
+    failure(error) {
+        const normalized = this.runtime.wireStream?.failure(error);
+        if (normalized !== undefined)
+            return normalized;
+        const source = error instanceof Error ? error : new Error('The Harness Gateway rejected the request.');
+        const code = 'code' in source && typeof source.code === 'string' ? source.code : 'internal';
+        const details = 'details' in source && isRecord(source.details) ? source.details : {};
+        return { code, message: source.message, details };
+    }
+}
+/**
+ * dsh 0.1.7-rc.1 moved the cancellation signal from the third parameter to the
+ * fifth; legacy releases keep `(endpoint, payload, signal)`.
+ * @param open - carrier opener captured from the running release.
+ * @returns whether the opener follows the rc.1 argument order.
+ */
+function usesRc1Arity(open) {
+    return open.length >= 5;
+}
+/** An uplink nobody sends on, so a read-only stream opens without buffering. */
+function endedUplink() {
+    return {
+        [Symbol.asyncIterator]() {
+            return { next: () => Promise.resolve({ done: true, value: undefined }) };
+        },
+    };
+}
+/** Controller aborted with the logical stream so the rc.1 carrier owns one lifetime. */
+function linkControl(signal) {
+    const control = new AbortController();
+    if (signal.aborted)
+        control.abort(signal.reason);
+    else
+        signal.addEventListener('abort', () => control.abort(signal.reason), { once: true });
+    return control;
+}
+/**
+ * Adapt the running release's carrier opener to the plugin's 3-argument
+ * `(endpoint, payload, signal)` seam without leaking the argument displacement.
+ * @param gateway - official Gateway whose public `wireStream` is the fallback.
+ * @param runtime - Gateway object owning the private `openWireStream` dispatcher.
+ * @returns a local opener that carries the signal to the release's signal slot.
+ */
+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) => open.call(runtime, endpoint, payload, signal);
+    }
+    const wire = gateway.wireStream;
+    if (wire === undefined)
+        return undefined;
+    const wireOpen = wire.open;
+    if (usesRc1Arity(wireOpen)) {
+        const rc1 = wireOpen;
+        return (endpoint, payload, signal) => rc1.call(wire, endpoint, payload, endedUplink(), undefined, signal);
+    }
+    const legacy = wireOpen;
+    return (endpoint, payload, signal) => legacy.call(wire, endpoint, payload, signal);
+}
+function requestFromCarrier(endpoint, payload, signal) {
+    const segments = endpoint.split('/');
+    if (segments.length !== 2 || segments.some(segment => segment.length === 0)) {
+        throw new Error('The Harness Gateway endpoint is invalid.');
+    }
+    if (!isRecord(payload) || !isRecord(payload.args)) {
+        throw new Error('The Harness Gateway payload is invalid.');
+    }
+    return { namespace: segments[0], method: segments[1], args: payload.args, signal };
+}
+function endpointOf(request) {
+    return `${request.namespace}/${request.method}`;
+}
+function isLocalOnlyEndpoint(endpoint) {
+    const separator = endpoint.indexOf('/');
+    return separator > 0 && LOCAL_ONLY_NAMESPACES.has(endpoint.slice(0, separator));
+}
+function isRemoteCommandMethod(method) {
+    return REMOTE_COMMAND_METHODS.includes(method);
+}
+/**
+ * Whether the peer cannot answer this call at all, as opposed to answering with a
+ * refusal. An unimplemented endpoint (a local-only concern the switch forwarded
+ * anyway) and a connection that dropped mid-call are both permissionless to retry
+ * locally; a business error such as a denied permission is not.
+ * @param error - rejection from the remote carrier.
+ * @returns whether the local shell should answer the call instead.
+ */ function isUnansweredByPeer(error) {
+    // A wrapped carrier failure such as "Web RPC failed" often arrives with no code at
+    // all, and refusing to fall back there would leave the local shell unanswered. The
+    // warning emitted at the call site keeps the decision visible in DevTools.
+    if (!isRecord(error))
+        return error instanceof Error;
+    const code = typeof error.code === 'string' ? error.code : '';
+    return code === '' || UNANSWERED_BY_PEER_CODES.has(code);
+}
+const UNANSWERED_BY_PEER_CODES = new Set([
+    'METHOD_NOT_ALLOWED',
+    'METHOD_NOT_FOUND',
+    'method-not-found',
+    'not-implemented',
+    'CONNECTION_FAILED',
+    'CONNECTION_REPLACED',
+    'NOT_CONNECTED',
+    'UNAVAILABLE',
+    'internal',
+]);
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=typert-gateway-switch.js.map

package/dist/typert-gateway-switch.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+import type { RemoteMessage } from '@dsh-remote/protocol';
+export interface AuthenticatedPeerChannel {
+    /**
+     * Attestation supplied by the Noise/control-plane integration. Implementors
+     * must expose this channel only after both the Noise IK transcript and the
+     * Server membership for this exact connection have been verified.
+     */
+    readonly security: {
+        protocol: 'Noise_IK_25519_ChaChaPoly_SHA256';
+        connectionId: string;
+        membershipId: string;
+    };
+    readonly peerDeviceId: string;
+    readonly peerIdentityKey: string;
+    readonly mode?: 'LAN' | 'P2P' | 'TURN' | 'Relay';
+    send(message: RemoteMessage): Promise<void>;
+    onMessage(handler: (message: RemoteMessage) => void): () => void;
+    close(code?: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE;QACjB,QAAQ,EAAE,kCAAkC,CAAA;QAC5C,YAAY,EAAE,MAAM,CAAA;QACpB,YAAY,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;IAChD,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAChE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/version.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Version of the `ds-harness-remote` distribution.
+ *
+ * This is reported to the Server during device registration (`clientVersion`
+ * in the Device Descriptor) and again in the WebSocket `hello` frame. The
+ * Harness version is read separately from `host.describe` at runtime.
+ * Keep it in sync with `packages/plugin/package.json` (`version`).
+ * If they diverge, `npm scripts` checks in `scripts/verify-version-sync.mjs`
+ * will fail fast during build/check/test.
+ */
+export declare const PLUGIN_VERSION = "0.4.28";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,WAAW,CAAA"}

package/dist/version.js

@@ -0,0 +1,12 @@
+/**
+ * Version of the `ds-harness-remote` distribution.
+ *
+ * This is reported to the Server during device registration (`clientVersion`
+ * in the Device Descriptor) and again in the WebSocket `hello` frame. The
+ * Harness version is read separately from `host.describe` at runtime.
+ * Keep it in sync with `packages/plugin/package.json` (`version`).
+ * If they diverge, `npm scripts` checks in `scripts/verify-version-sync.mjs`
+ * will fail fast during build/check/test.
+ */
+export const PLUGIN_VERSION = '0.4.28';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAA"}

package/dist/werift-rtc.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Node RTC factory (webrtc-implementation-plan.md §6.2).
+ *
+ * Native libwebrtc is preferred when present because its ICE behavior matches
+ * browser Remote Web. werift remains the pure-TypeScript fallback for systems
+ * without a loadable native addon. Both backends are loaded lazily so DSH
+ * startup remains unaffected when WebRTC is unused or `forceRelay` is enabled.
+ */
+import { type NetworkInterfaceInfo } from 'node:os';
+import type { RtcIceCandidateInit, RtcIceServer, RtcPeerConnectionFactory, RtcStats } from '@dsh-remote/webrtc';
+interface WeriftModule {
+    RTCPeerConnection: new (config?: WeriftConfig) => WeriftPeerConnection;
+}
+interface WeriftConfig {
+    iceServers?: Array<{
+        urls: string | string[];
+        username?: string;
+        credential?: string;
+    }>;
+    iceAdditionalHostAddresses?: string[];
+    iceFilterCandidatePair?: (pair: WeriftCandidatePair) => boolean;
+    iceUseIpv4?: boolean;
+    iceUseIpv6?: boolean;
+    iceUseLinkLocalAddress?: boolean;
+    iceInterfaceAddresses?: {
+        udp4?: string;
+        udp6?: string;
+    };
+}
+interface WeriftCandidate {
+    host?: string;
+    type?: string;
+    relatedAddress?: string;
+}
+interface WeriftCandidatePair {
+    localCandidate?: WeriftCandidate;
+}
+interface WeriftPeerConnection {
+    connectionState: string;
+    iceConnectionState: string;
+    iceGatheringState: string;
+    signalingState: string;
+    onconnectionstatechange: (() => void) | null;
+    oniceconnectionstatechange: (() => void) | null;
+    onicegatheringstatechange: (() => void) | null;
+    onicecandidate: ((event: {
+        candidate?: {
+            toJSON(): RtcIceCandidateInit;
+        };
+    }) => void) | null;
+    ondatachannel: ((event: {
+        channel: WeriftDataChannel;
+    }) => void) | null;
+    createDataChannel(label: string, options: {
+        ordered: boolean;
+    }): WeriftDataChannel;
+    createOffer(): Promise<{
+        type: 'offer' | 'answer';
+        sdp: string;
+    }>;
+    createAnswer(): Promise<{
+        type: 'offer' | 'answer';
+        sdp: string;
+    }>;
+    setLocalDescription(description?: {
+        type: string;
+        sdp?: string;
+    }): Promise<unknown>;
+    setRemoteDescription(description: {
+        type: string;
+        sdp?: string;
+    }): Promise<void>;
+    addIceCandidate(candidate?: RtcIceCandidateInit | null): Promise<void>;
+    getStats(): Promise<RtcStats>;
+    close(): Promise<void>;
+}
+interface WeriftDataChannel {
+    readonly label: string;
+    readonly ordered: boolean;
+    readyState: string;
+    bufferedAmount: number;
+    onopen: (() => void) | null;
+    onclose: (() => void) | null;
+    onerror: (() => void) | null;
+    onmessage: ((event: {
+        data: string | Uint8Array;
+    }) => void) | null;
+    send(data: Buffer | string): void;
+    close(): void;
+}
+/**
+ * Node RTC factory used by the Plugin/VS Code clients and Host. Native
+ * libwebrtc is preferred because its ICE behavior matches browser Remote Web;
+ * werift remains the no-native fallback for environments that cannot load it.
+ */
+export declare function loadNodeRtcFactory(options?: WeriftFactoryOptions): Promise<RtcPeerConnectionFactory | undefined>;
+/** Load (once) a werift-backed factory, or `undefined` when it cannot be loaded. */
+export declare function loadWeriftFactory(options?: WeriftFactoryOptions): Promise<RtcPeerConnectionFactory | undefined>;
+export interface WeriftFactoryOptions {
+    interfaces?: NodeJS.Dict<NetworkInterfaceInfo[] | undefined>;
+    preferredHostIpv4Candidates?: readonly string[];
+    routeTargets?: readonly string[];
+    routeProbeTimeoutMs?: number;
+}
+/** Synchronous factory for tests and callers that already resolved werift. */
+export declare function buildWeriftFactory(werift: WeriftModule, options?: WeriftFactoryOptions): RtcPeerConnectionFactory;
+/**
+ * Pick the safe IPv4 host addresses for ICE gathering.
+ *
+ * On macOS a host exposes many interfaces (WiFi `en0`, Thunderbolt `en1-4`,
+ * `bridge*`, Apple Wireless Direct Link `awdl0`/`llw0`, and several VPN `utun*`
+ * tunnels whose small MTUs drop large SCTP packets). Let werift/ICE compare
+ * real physical interfaces, but filter virtual and link-local Host candidates
+ * before they can become nominated paths.
+ */
+export declare function detectHostIpv4Candidates(interfaces: NodeJS.Dict<NetworkInterfaceInfo[] | undefined>, preferredHostIpv4Candidates?: readonly string[]): string[];
+export declare function detectRouteHostIpv4Candidates(targets: readonly string[], timeoutMs?: number): Promise<string[]>;
+export declare function shouldAdvertiseCandidate(candidate: RtcIceCandidateInit, allowedHostIpv4: ReadonlySet<string>): boolean;
+export declare function orderIceServersForWerift(iceServers: readonly RtcIceServer[]): RtcIceServer[];
+export {};
+//# sourceMappingURL=werift-rtc.d.ts.map

package/dist/werift-rtc.d.ts.map

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