@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/core/remote/iroh/handshake-reader.js

@@ -0,0 +1,91 @@
+import { Buffer } from "node:buffer";
+import { DEFAULT_IROH_READ_LIMIT, serializeJsonLine, } from "../../rpc/index.js";
+export const DEFAULT_IROH_REMOTE_HANDSHAKE_MAX_LINE_BYTES = 16 * 1024;
+export const DEFAULT_IROH_REMOTE_HANDSHAKE_TIMEOUT_MS = 15_000;
+export async function readIrohRemoteHandshakeLine(recv, options = {}) {
+    const timeoutMs = options.timeoutMs ?? DEFAULT_IROH_REMOTE_HANDSHAKE_TIMEOUT_MS;
+    return withTimeout(readBoundedIrohLine(recv, options), timeoutMs, "Iroh remote handshake timed out", () => {
+        try {
+            const stopResult = recv.stop?.(options.timeoutStopErrorCode ?? 0n);
+            if (stopResult) {
+                void Promise.resolve(stopResult).catch(() => { });
+            }
+        }
+        catch {
+            // Timeout cleanup is best-effort; callers should receive the timeout error.
+        }
+    });
+}
+export async function writeIrohRemoteHello(send, hello) {
+    await send.writeAll(textToBytes(serializeJsonLine(hello)));
+}
+export async function writeIrohRemoteHandshakeResponse(send, response) {
+    await send.writeAll(textToBytes(serializeJsonLine(response)));
+}
+async function readBoundedIrohLine(recv, options) {
+    const maxLineBytes = normalizePositiveInteger(options.maxLineBytes ?? DEFAULT_IROH_REMOTE_HANDSHAKE_MAX_LINE_BYTES, "maxLineBytes");
+    const requestedReadLimit = normalizePositiveInteger(options.readLimit ?? DEFAULT_IROH_READ_LIMIT, "readLimit");
+    const readLimit = Math.min(requestedReadLimit, maxLineBytes + 1);
+    let buffer = options.initialInput ? bytesToBuffer(options.initialInput) : Buffer.alloc(0);
+    while (true) {
+        const newlineIndex = buffer.indexOf(10);
+        if (newlineIndex !== -1) {
+            let lineBuffer = buffer.subarray(0, newlineIndex);
+            if (lineBuffer.length > 0 && lineBuffer[lineBuffer.length - 1] === 13) {
+                lineBuffer = lineBuffer.subarray(0, lineBuffer.length - 1);
+            }
+            assertLineWithinLimit(lineBuffer.length, maxLineBytes);
+            return {
+                line: lineBuffer.toString("utf8"),
+                rest: buffer.subarray(newlineIndex + 1),
+            };
+        }
+        assertLineWithinLimit(buffer.length, maxLineBytes);
+        const chunk = await recv.read(readLimit);
+        if (!chunk || chunk.length === 0) {
+            return { line: undefined, rest: buffer };
+        }
+        buffer = Buffer.concat([buffer, bytesToBuffer(chunk)]);
+    }
+}
+function assertLineWithinLimit(length, maxLineBytes) {
+    if (length > maxLineBytes) {
+        throw new Error(`Iroh remote handshake line exceeds maximum size of ${maxLineBytes} bytes`);
+    }
+}
+function normalizePositiveInteger(value, label) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new Error(`${label} must be a positive integer`);
+    }
+    return value;
+}
+async function withTimeout(promise, timeoutMs, message, onTimeout) {
+    normalizePositiveInteger(timeoutMs, "timeoutMs");
+    let timeout;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_resolve, reject) => {
+                timeout = setTimeout(() => {
+                    reject(new Error(message));
+                    onTimeout();
+                }, timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timeout) {
+            clearTimeout(timeout);
+        }
+    }
+}
+function bytesToBuffer(bytes) {
+    if (Buffer.isBuffer(bytes)) {
+        return bytes;
+    }
+    return Buffer.from(Array.from(bytes));
+}
+function textToBytes(text) {
+    return Array.from(Buffer.from(text, "utf8"));
+}
+//# sourceMappingURL=handshake-reader.js.map

package/dist/core/remote/iroh/handshake-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake-reader.js","sourceRoot":"","sources":["../../../../src/core/remote/iroh/handshake-reader.ts"],"names":[],"mappings":"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","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport {\n\tDEFAULT_IROH_READ_LIMIT,\n\ttype IrohBytes,\n\ttype IrohRecvStreamLike,\n\ttype IrohSendStreamLike,\n\tserializeJsonLine,\n} from \"../../rpc/index.ts\";\nimport type { IrohRemoteHandshakeResponse, IrohRemoteHello } from \"./handshake.ts\";\n\nexport const DEFAULT_IROH_REMOTE_HANDSHAKE_MAX_LINE_BYTES = 16 * 1024;\nexport const DEFAULT_IROH_REMOTE_HANDSHAKE_TIMEOUT_MS = 15_000;\n\nexport interface IrohRemoteHandshakeLineReadOptions {\n\tinitialInput?: IrohBytes;\n\tmaxLineBytes?: number;\n\treadLimit?: number;\n\ttimeoutStopErrorCode?: bigint;\n\ttimeoutMs?: number;\n}\n\nexport interface IrohRemoteHandshakeLineReadResult {\n\tline: string | undefined;\n\trest: IrohBytes;\n}\n\nexport async function readIrohRemoteHandshakeLine(\n\trecv: IrohRecvStreamLike,\n\toptions: IrohRemoteHandshakeLineReadOptions = {},\n): Promise<IrohRemoteHandshakeLineReadResult> {\n\tconst timeoutMs = options.timeoutMs ?? DEFAULT_IROH_REMOTE_HANDSHAKE_TIMEOUT_MS;\n\treturn withTimeout(readBoundedIrohLine(recv, options), timeoutMs, \"Iroh remote handshake timed out\", () => {\n\t\ttry {\n\t\t\tconst stopResult = recv.stop?.(options.timeoutStopErrorCode ?? 0n);\n\t\t\tif (stopResult) {\n\t\t\t\tvoid Promise.resolve(stopResult).catch(() => {});\n\t\t\t}\n\t\t} catch {\n\t\t\t// Timeout cleanup is best-effort; callers should receive the timeout error.\n\t\t}\n\t});\n}\n\nexport async function writeIrohRemoteHello(send: IrohSendStreamLike, hello: IrohRemoteHello): Promise<void> {\n\tawait send.writeAll(textToBytes(serializeJsonLine(hello)));\n}\n\nexport async function writeIrohRemoteHandshakeResponse(\n\tsend: IrohSendStreamLike,\n\tresponse: IrohRemoteHandshakeResponse,\n): Promise<void> {\n\tawait send.writeAll(textToBytes(serializeJsonLine(response)));\n}\n\nasync function readBoundedIrohLine(\n\trecv: IrohRecvStreamLike,\n\toptions: IrohRemoteHandshakeLineReadOptions,\n): Promise<IrohRemoteHandshakeLineReadResult> {\n\tconst maxLineBytes = normalizePositiveInteger(\n\t\toptions.maxLineBytes ?? DEFAULT_IROH_REMOTE_HANDSHAKE_MAX_LINE_BYTES,\n\t\t\"maxLineBytes\",\n\t);\n\tconst requestedReadLimit = normalizePositiveInteger(options.readLimit ?? DEFAULT_IROH_READ_LIMIT, \"readLimit\");\n\tconst readLimit = Math.min(requestedReadLimit, maxLineBytes + 1);\n\tlet buffer = options.initialInput ? bytesToBuffer(options.initialInput) : Buffer.alloc(0);\n\n\twhile (true) {\n\t\tconst newlineIndex = buffer.indexOf(10);\n\t\tif (newlineIndex !== -1) {\n\t\t\tlet lineBuffer = buffer.subarray(0, newlineIndex);\n\t\t\tif (lineBuffer.length > 0 && lineBuffer[lineBuffer.length - 1] === 13) {\n\t\t\t\tlineBuffer = lineBuffer.subarray(0, lineBuffer.length - 1);\n\t\t\t}\n\t\t\tassertLineWithinLimit(lineBuffer.length, maxLineBytes);\n\t\t\treturn {\n\t\t\t\tline: lineBuffer.toString(\"utf8\"),\n\t\t\t\trest: buffer.subarray(newlineIndex + 1),\n\t\t\t};\n\t\t}\n\n\t\tassertLineWithinLimit(buffer.length, maxLineBytes);\n\t\tconst chunk = await recv.read(readLimit);\n\t\tif (!chunk || chunk.length === 0) {\n\t\t\treturn { line: undefined, rest: buffer };\n\t\t}\n\t\tbuffer = Buffer.concat([buffer, bytesToBuffer(chunk)]);\n\t}\n}\n\nfunction assertLineWithinLimit(length: number, maxLineBytes: number): void {\n\tif (length > maxLineBytes) {\n\t\tthrow new Error(`Iroh remote handshake line exceeds maximum size of ${maxLineBytes} bytes`);\n\t}\n}\n\nfunction normalizePositiveInteger(value: number, label: string): number {\n\tif (!Number.isInteger(value) || value <= 0) {\n\t\tthrow new Error(`${label} must be a positive integer`);\n\t}\n\treturn value;\n}\n\nasync function withTimeout<T>(\n\tpromise: Promise<T>,\n\ttimeoutMs: number,\n\tmessage: string,\n\tonTimeout: () => void,\n): Promise<T> {\n\tnormalizePositiveInteger(timeoutMs, \"timeoutMs\");\n\tlet timeout: NodeJS.Timeout | undefined;\n\ttry {\n\t\treturn await Promise.race([\n\t\t\tpromise,\n\t\t\tnew Promise<T>((_resolve, reject) => {\n\t\t\t\ttimeout = setTimeout(() => {\n\t\t\t\t\treject(new Error(message));\n\t\t\t\t\tonTimeout();\n\t\t\t\t}, timeoutMs);\n\t\t\t}),\n\t\t]);\n\t} finally {\n\t\tif (timeout) {\n\t\t\tclearTimeout(timeout);\n\t\t}\n\t}\n}\n\nfunction bytesToBuffer(bytes: IrohBytes): Buffer {\n\tif (Buffer.isBuffer(bytes)) {\n\t\treturn bytes;\n\t}\n\treturn Buffer.from(Array.from(bytes));\n}\n\nfunction textToBytes(text: string): Array<number> {\n\treturn Array.from(Buffer.from(text, \"utf8\"));\n}\n"]}

package/dist/core/remote/iroh/handshake.d.ts

@@ -0,0 +1,119 @@
+import { IROH_REMOTE_ALPN, IROH_REMOTE_HANDSHAKE_TYPE, IROH_REMOTE_HELLO_TYPE, type IrohRemoteHostHandshakeFailureOutcome, type IrohRemoteOutcome, type IrohRemoteRelayMode } from "./protocol.ts";
+import type { IrohRemoteWorkspaceStatus } from "./workspace.ts";
+export type IrohRemoteConversationTarget = {
+    target: "last";
+} | {
+    target: "new";
+    worktreeId?: string;
+    /** POSIX-style path relative to the registered workspace root. */
+    workingDirectory?: string;
+} | {
+    target: "session";
+    sessionId: string;
+};
+export type IrohRemoteConversationSelection = "resumed" | "created" | "created_missing_last" | "session_rekeyed";
+export interface IrohRemoteConversationHandshakeMetadata {
+    target: IrohRemoteConversationTarget["target"];
+    sessionId: string;
+    selection: IrohRemoteConversationSelection;
+    requestedSessionId?: string;
+    /** Echoed only for worktree-bound conversations (worktrees.v1). */
+    worktreeId?: string;
+    /** POSIX-style path relative to the workspace root. Omitted for workspace root. */
+    workingDirectory?: string;
+}
+export interface IrohRemoteWorkspaceDiscoveryTarget {
+    purpose: "list_sessions";
+}
+export interface IrohRemoteWorkspaceManagementTarget {
+    purpose: "unregister_workspace" | "manage_worktrees";
+}
+export interface IrohRemoteHostHandshakeMetadata {
+    workspace: string;
+    workspaceNames: string[];
+    workspaces: IrohRemoteWorkspaceStatus[];
+    features: string[];
+    hostNodeId?: string;
+    relayMode?: IrohRemoteRelayMode;
+    relayUrls?: string[];
+    hostName?: string;
+    userName?: string;
+    cwd: string;
+}
+export type IrohRemoteHelloMode = {
+    mode: "conversation";
+    conversation: IrohRemoteConversationTarget;
+} | {
+    mode: "workspaceDiscovery";
+    workspaceDiscovery: IrohRemoteWorkspaceDiscoveryTarget;
+} | {
+    mode: "workspaceManagement";
+    workspaceManagement: IrohRemoteWorkspaceManagementTarget;
+};
+interface IrohRemoteHelloBase {
+    type: typeof IROH_REMOTE_HELLO_TYPE;
+    protocol: typeof IROH_REMOTE_ALPN;
+    workspace: string;
+    secret?: string;
+    clientLabel?: string;
+    clientNodeId?: string;
+}
+export type IrohRemoteHello = IrohRemoteHelloBase & IrohRemoteHelloMode;
+export declare const IROH_REMOTE_SESSION_ID_PATTERN: RegExp;
+export interface IrohRemoteHandshakeSuccess {
+    type: typeof IROH_REMOTE_HANDSHAKE_TYPE;
+    success: true;
+    workspace: string;
+    hostNodeId?: string;
+    clientNodeId: string;
+    features?: string[];
+    sessionId?: string;
+    conversation?: IrohRemoteConversationHandshakeMetadata;
+    workspaceDiscovery?: IrohRemoteWorkspaceDiscoveryTarget;
+    workspaceManagement?: IrohRemoteWorkspaceManagementTarget;
+    remoteHost?: IrohRemoteHostHandshakeMetadata;
+    child?: string;
+}
+export interface IrohRemoteHandshakeFailure {
+    type: typeof IROH_REMOTE_HANDSHAKE_TYPE;
+    success: false;
+    outcome?: IrohRemoteOutcome;
+    hostNodeId?: string;
+    workspace?: string;
+    sessionId?: string;
+    retryAfterMs?: number;
+    error: string;
+}
+export type IrohRemoteHandshakeResponse = IrohRemoteHandshakeSuccess | IrohRemoteHandshakeFailure;
+export declare class IrohRemoteHandshakeError extends Error {
+    readonly outcome: IrohRemoteHostHandshakeFailureOutcome;
+    constructor(outcome: IrohRemoteHostHandshakeFailureOutcome, message: string);
+}
+export declare function parseIrohRemoteHelloLine(line: string): IrohRemoteHello;
+export declare function parseIrohRemoteHandshakeResponseLine(line: string): IrohRemoteHandshakeResponse;
+export declare function parseIrohRemoteHello(value: unknown): IrohRemoteHello;
+export declare function parseIrohRemoteHandshakeResponse(value: unknown): IrohRemoteHandshakeResponse;
+export declare function createIrohRemoteHandshakeSuccess(options: {
+    workspace: string;
+    hostNodeId?: string;
+    clientNodeId: string;
+    features?: string[];
+    sessionId?: string;
+    conversation?: IrohRemoteConversationHandshakeMetadata;
+    workspaceDiscovery?: IrohRemoteWorkspaceDiscoveryTarget;
+    workspaceManagement?: IrohRemoteWorkspaceManagementTarget;
+    remoteHost?: IrohRemoteHostHandshakeMetadata;
+    child?: string;
+}): IrohRemoteHandshakeSuccess;
+export declare function createIrohRemoteHandshakeFailure(error: string, options?: {
+    hostNodeId?: string;
+    outcome?: IrohRemoteHostHandshakeFailureOutcome;
+    workspace?: string;
+    sessionId?: string;
+    retryAfterMs?: number;
+}): IrohRemoteHandshakeFailure;
+export declare function assertIrohRemoteHandshakeHostIdentity(response: IrohRemoteHandshakeResponse, expectedHostNodeId: string | undefined): void;
+export declare function isIrohRemoteWorkspaceName(value: unknown): value is string;
+export declare function isIrohRemoteSessionId(value: unknown): value is string;
+export {};
+//# sourceMappingURL=handshake.d.ts.map

package/dist/core/remote/iroh/handshake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake.d.ts","sourceRoot":"","sources":["../../../../src/core/remote/iroh/handshake.ts"],"names":[],"mappings":"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","sourcesContent":["import { Buffer } from \"node:buffer\";\nimport {\n\tIROH_REMOTE_ALPN,\n\tIROH_REMOTE_CONVERSATION_STREAMS_FEATURE,\n\tIROH_REMOTE_HANDSHAKE_TYPE,\n\tIROH_REMOTE_HELLO_TYPE,\n\tIROH_REMOTE_MULTI_STREAMS_FEATURE,\n\ttype IrohRemoteHostHandshakeFailureOutcome,\n\ttype IrohRemoteOutcome,\n\tIrohRemoteOutcomeError,\n\ttype IrohRemoteRelayMode,\n\tisIrohRemoteOutcome,\n\tisIrohRemoteRelayMode,\n\tisIrohRemoteRelayUrls,\n\tisIrohRemoteWorkingDirectory,\n\tisIrohRemoteWorktreeId,\n} from \"./protocol.ts\";\nimport type { IrohRemoteWorkspaceStatus } from \"./workspace.ts\";\n\nexport type IrohRemoteConversationTarget =\n\t| {\n\t\t\ttarget: \"last\";\n\t  }\n\t| {\n\t\t\ttarget: \"new\";\n\t\t\tworktreeId?: string;\n\t\t\t/** POSIX-style path relative to the registered workspace root. */\n\t\t\tworkingDirectory?: string;\n\t  }\n\t| {\n\t\t\ttarget: \"session\";\n\t\t\tsessionId: string;\n\t  };\n\nexport type IrohRemoteConversationSelection = \"resumed\" | \"created\" | \"created_missing_last\" | \"session_rekeyed\";\n\nexport interface IrohRemoteConversationHandshakeMetadata {\n\ttarget: IrohRemoteConversationTarget[\"target\"];\n\tsessionId: string;\n\tselection: IrohRemoteConversationSelection;\n\trequestedSessionId?: string;\n\t/** Echoed only for worktree-bound conversations (worktrees.v1). */\n\tworktreeId?: string;\n\t/** POSIX-style path relative to the workspace root. Omitted for workspace root. */\n\tworkingDirectory?: string;\n}\n\nexport interface IrohRemoteWorkspaceDiscoveryTarget {\n\tpurpose: \"list_sessions\";\n}\n\nexport interface IrohRemoteWorkspaceManagementTarget {\n\tpurpose: \"unregister_workspace\" | \"manage_worktrees\";\n}\n\nexport interface IrohRemoteHostHandshakeMetadata {\n\tworkspace: string;\n\tworkspaceNames: string[];\n\tworkspaces: IrohRemoteWorkspaceStatus[];\n\tfeatures: string[];\n\thostNodeId?: string;\n\trelayMode?: IrohRemoteRelayMode;\n\trelayUrls?: string[];\n\thostName?: string;\n\tuserName?: string;\n\tcwd: string;\n}\n\nexport type IrohRemoteHelloMode =\n\t| {\n\t\t\tmode: \"conversation\";\n\t\t\tconversation: IrohRemoteConversationTarget;\n\t  }\n\t| {\n\t\t\tmode: \"workspaceDiscovery\";\n\t\t\tworkspaceDiscovery: IrohRemoteWorkspaceDiscoveryTarget;\n\t  }\n\t| {\n\t\t\tmode: \"workspaceManagement\";\n\t\t\tworkspaceManagement: IrohRemoteWorkspaceManagementTarget;\n\t  };\n\ninterface IrohRemoteHelloBase {\n\ttype: typeof IROH_REMOTE_HELLO_TYPE;\n\tprotocol: typeof IROH_REMOTE_ALPN;\n\tworkspace: string;\n\tsecret?: string;\n\tclientLabel?: string;\n\tclientNodeId?: string;\n}\n\nexport type IrohRemoteHello = IrohRemoteHelloBase & IrohRemoteHelloMode;\n\nexport const IROH_REMOTE_SESSION_ID_PATTERN = /^[a-z0-9_-]{1,128}$/;\n\nexport interface IrohRemoteHandshakeSuccess {\n\ttype: typeof IROH_REMOTE_HANDSHAKE_TYPE;\n\tsuccess: true;\n\tworkspace: string;\n\thostNodeId?: string;\n\tclientNodeId: string;\n\tfeatures?: string[];\n\tsessionId?: string;\n\tconversation?: IrohRemoteConversationHandshakeMetadata;\n\tworkspaceDiscovery?: IrohRemoteWorkspaceDiscoveryTarget;\n\tworkspaceManagement?: IrohRemoteWorkspaceManagementTarget;\n\tremoteHost?: IrohRemoteHostHandshakeMetadata;\n\tchild?: string;\n}\n\nexport interface IrohRemoteHandshakeFailure {\n\ttype: typeof IROH_REMOTE_HANDSHAKE_TYPE;\n\tsuccess: false;\n\toutcome?: IrohRemoteOutcome;\n\thostNodeId?: string;\n\tworkspace?: string;\n\tsessionId?: string;\n\tretryAfterMs?: number;\n\terror: string;\n}\n\nexport type IrohRemoteHandshakeResponse = IrohRemoteHandshakeSuccess | IrohRemoteHandshakeFailure;\n\nexport class IrohRemoteHandshakeError extends Error {\n\treadonly outcome: IrohRemoteHostHandshakeFailureOutcome;\n\n\tconstructor(outcome: IrohRemoteHostHandshakeFailureOutcome, message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"IrohRemoteHandshakeError\";\n\t\tthis.outcome = outcome;\n\t}\n}\n\nexport function parseIrohRemoteHelloLine(line: string): IrohRemoteHello {\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(line);\n\t} catch (error: unknown) {\n\t\tthrow new IrohRemoteHandshakeError(\n\t\t\t\"invalid_conversation_target\",\n\t\t\t`Failed to parse Iroh remote handshake: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n\treturn parseIrohRemoteHello(parsed);\n}\n\nexport function parseIrohRemoteHandshakeResponseLine(line: string): IrohRemoteHandshakeResponse {\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(line);\n\t} catch (error: unknown) {\n\t\tthrow new Error(\n\t\t\t`Failed to parse Iroh remote handshake response: ${error instanceof Error ? error.message : String(error)}`,\n\t\t);\n\t}\n\treturn parseIrohRemoteHandshakeResponse(parsed);\n}\n\nexport function parseIrohRemoteHello(value: unknown): IrohRemoteHello {\n\tconst hello = expectRecord(value, \"Iroh remote handshake\");\n\tif (hello.type !== IROH_REMOTE_HELLO_TYPE) {\n\t\tthrow new Error(\"unexpected handshake type\");\n\t}\n\tif (hello.protocol !== IROH_REMOTE_ALPN) {\n\t\tthrow new Error(`unsupported protocol: ${typeof hello.protocol === \"string\" ? hello.protocol : \"<missing>\"}`);\n\t}\n\n\tconst workspace = expectWorkspaceName(hello.workspace, \"handshake workspace\");\n\tconst mode = parseIrohRemoteHelloMode(hello);\n\treturn {\n\t\ttype: IROH_REMOTE_HELLO_TYPE,\n\t\tprotocol: IROH_REMOTE_ALPN,\n\t\tworkspace,\n\t\tsecret: expectOptionalString(hello.secret, \"handshake secret\"),\n\t\tclientLabel: expectOptionalString(hello.clientLabel, \"handshake clientLabel\"),\n\t\tclientNodeId: expectOptionalString(hello.clientNodeId, \"handshake clientNodeId\"),\n\t\t...mode,\n\t};\n}\n\nexport function parseIrohRemoteHandshakeResponse(value: unknown): IrohRemoteHandshakeResponse {\n\tconst response = expectRecord(value, \"Iroh remote handshake response\");\n\tif (response.type !== IROH_REMOTE_HANDSHAKE_TYPE) {\n\t\tthrow new Error(\"unexpected handshake response type\");\n\t}\n\tif (response.success === true) {\n\t\tconst hostNodeId = expectOptionalString(response.hostNodeId, \"handshake response hostNodeId\");\n\t\tconst workspace = expectString(response.workspace, \"handshake response workspace\");\n\t\tconst features = parseOptionalFeatures(response.features);\n\t\tconst modeMetadata = parseOptionalHandshakeSuccessMode(response);\n\t\tconst remoteHost = parseOptionalRemoteHostHandshakeMetadata(response.remoteHost);\n\t\tif (hasHandshakeSuccessModeMetadata(modeMetadata) && hostNodeId === undefined) {\n\t\t\tthrow new Error(\"handshake response hostNodeId is required for stream mode success\");\n\t\t}\n\t\tassertRemoteHostMetadataMatchesHandshake(remoteHost, { hostNodeId, workspace });\n\t\tconst success: IrohRemoteHandshakeSuccess = {\n\t\t\ttype: IROH_REMOTE_HANDSHAKE_TYPE,\n\t\t\tsuccess: true,\n\t\t\tworkspace,\n\t\t\tclientNodeId: expectString(response.clientNodeId, \"handshake response clientNodeId\"),\n\t\t\t...(features === undefined ? {} : { features }),\n\t\t\t...modeMetadata,\n\t\t\t...(remoteHost === undefined ? {} : { remoteHost }),\n\t\t\tchild: expectOptionalString(response.child, \"handshake response child\"),\n\t\t};\n\t\treturn hostNodeId === undefined ? success : { ...success, hostNodeId };\n\t}\n\tif (response.success === false) {\n\t\tconst outcome = expectOptionalOutcome(response.outcome, \"handshake response outcome\");\n\t\tconst hostNodeId = expectOptionalString(response.hostNodeId, \"handshake response hostNodeId\");\n\t\tconst workspace = expectOptionalString(response.workspace, \"handshake response workspace\");\n\t\tconst sessionId = expectOptionalRemoteSessionId(response.sessionId, \"handshake response sessionId\");\n\t\tconst retryAfterMs = expectOptionalNumber(response.retryAfterMs, \"handshake response retryAfterMs\");\n\t\tconst failure: IrohRemoteHandshakeFailure = {\n\t\t\ttype: IROH_REMOTE_HANDSHAKE_TYPE,\n\t\t\tsuccess: false,\n\t\t\terror: expectString(response.error, \"handshake response error\"),\n\t\t};\n\t\treturn {\n\t\t\t...failure,\n\t\t\t...(outcome === undefined ? {} : { outcome }),\n\t\t\t...(hostNodeId === undefined ? {} : { hostNodeId }),\n\t\t\t...(workspace === undefined ? {} : { workspace }),\n\t\t\t...(sessionId === undefined ? {} : { sessionId }),\n\t\t\t...(retryAfterMs === undefined ? {} : { retryAfterMs }),\n\t\t};\n\t}\n\tthrow new Error(\"handshake response success must be a boolean\");\n}\n\nexport function createIrohRemoteHandshakeSuccess(options: {\n\tworkspace: string;\n\thostNodeId?: string;\n\tclientNodeId: string;\n\tfeatures?: string[];\n\tsessionId?: string;\n\tconversation?: IrohRemoteConversationHandshakeMetadata;\n\tworkspaceDiscovery?: IrohRemoteWorkspaceDiscoveryTarget;\n\tworkspaceManagement?: IrohRemoteWorkspaceManagementTarget;\n\tremoteHost?: IrohRemoteHostHandshakeMetadata;\n\tchild?: string;\n}): IrohRemoteHandshakeSuccess {\n\tconst response: IrohRemoteHandshakeSuccess = {\n\t\ttype: IROH_REMOTE_HANDSHAKE_TYPE,\n\t\tsuccess: true,\n\t\tworkspace: options.workspace,\n\t\t...(options.hostNodeId === undefined ? {} : { hostNodeId: options.hostNodeId }),\n\t\tclientNodeId: options.clientNodeId,\n\t\t...(options.features === undefined ? {} : { features: [...options.features] }),\n\t\t...(options.sessionId === undefined ? {} : { sessionId: options.sessionId }),\n\t\t...(options.conversation === undefined ? {} : { conversation: { ...options.conversation } }),\n\t\t...(options.workspaceDiscovery === undefined ? {} : { workspaceDiscovery: { ...options.workspaceDiscovery } }),\n\t\t...(options.workspaceManagement === undefined ? {} : { workspaceManagement: { ...options.workspaceManagement } }),\n\t\t...(options.remoteHost === undefined ? {} : { remoteHost: cloneRemoteHostHandshakeMetadata(options.remoteHost) }),\n\t\tchild: options.child,\n\t};\n\treturn response;\n}\n\nexport function createIrohRemoteHandshakeFailure(\n\terror: string,\n\toptions: {\n\t\thostNodeId?: string;\n\t\toutcome?: IrohRemoteHostHandshakeFailureOutcome;\n\t\tworkspace?: string;\n\t\tsessionId?: string;\n\t\tretryAfterMs?: number;\n\t} = {},\n): IrohRemoteHandshakeFailure {\n\treturn {\n\t\ttype: IROH_REMOTE_HANDSHAKE_TYPE,\n\t\tsuccess: false,\n\t\t...(options.outcome === undefined ? {} : { outcome: options.outcome }),\n\t\t...(options.hostNodeId === undefined ? {} : { hostNodeId: options.hostNodeId }),\n\t\t...(options.workspace === undefined ? {} : { workspace: options.workspace }),\n\t\t...(options.sessionId === undefined ? {} : { sessionId: options.sessionId }),\n\t\t...(options.retryAfterMs === undefined ? {} : { retryAfterMs: options.retryAfterMs }),\n\t\terror,\n\t};\n}\n\nexport function assertIrohRemoteHandshakeHostIdentity(\n\tresponse: IrohRemoteHandshakeResponse,\n\texpectedHostNodeId: string | undefined,\n): void {\n\tif (expectedHostNodeId === undefined) {\n\t\treturn;\n\t}\n\tconst actualHostNodeId = response.hostNodeId;\n\tif (actualHostNodeId !== expectedHostNodeId) {\n\t\tthrow new IrohRemoteOutcomeError(\n\t\t\t\"host_identity_mismatch\",\n\t\t\t`expected ${expectedHostNodeId}, got ${actualHostNodeId ?? \"<missing>\"}`,\n\t\t);\n\t}\n}\n\nfunction cloneRemoteHostHandshakeMetadata(metadata: IrohRemoteHostHandshakeMetadata): IrohRemoteHostHandshakeMetadata {\n\treturn {\n\t\tworkspace: metadata.workspace,\n\t\tworkspaceNames: [...metadata.workspaceNames],\n\t\tworkspaces: metadata.workspaces.map((workspace) => ({ ...workspace })),\n\t\tfeatures: [...metadata.features],\n\t\t...(metadata.hostNodeId === undefined ? {} : { hostNodeId: metadata.hostNodeId }),\n\t\t...(metadata.relayMode === undefined ? {} : { relayMode: metadata.relayMode }),\n\t\t...(metadata.relayUrls === undefined ? {} : { relayUrls: [...metadata.relayUrls] }),\n\t\t...(metadata.hostName === undefined ? {} : { hostName: metadata.hostName }),\n\t\t...(metadata.userName === undefined ? {} : { userName: metadata.userName }),\n\t\tcwd: metadata.cwd,\n\t};\n}\n\nfunction assertRemoteHostMetadataMatchesHandshake(\n\tmetadata: IrohRemoteHostHandshakeMetadata | undefined,\n\tresponse: { hostNodeId: string | undefined; workspace: string },\n): void {\n\tif (metadata === undefined) {\n\t\treturn;\n\t}\n\tif (metadata.workspace !== response.workspace) {\n\t\tthrow new Error(\"handshake response remoteHost workspace must match top-level workspace\");\n\t}\n\tif (\n\t\tmetadata.hostNodeId !== undefined &&\n\t\tresponse.hostNodeId !== undefined &&\n\t\tmetadata.hostNodeId !== response.hostNodeId\n\t) {\n\t\tthrow new Error(\"handshake response remoteHost hostNodeId must match top-level hostNodeId\");\n\t}\n}\n\nfunction expectRecord(value: unknown, label: string): Record<string, unknown> {\n\tif (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n\t\tthrow new Error(`${label} must be an object`);\n\t}\n\treturn value as Record<string, unknown>;\n}\n\nfunction expectRecordForOutcome(\n\tvalue: unknown,\n\tlabel: string,\n\toutcome: IrohRemoteHostHandshakeFailureOutcome,\n): Record<string, unknown> {\n\tif (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n\t\tthrow new IrohRemoteHandshakeError(outcome, `${label} must be an object`);\n\t}\n\treturn value as Record<string, unknown>;\n}\n\nfunction expectString(value: unknown, label: string): string {\n\tif (typeof value !== \"string\" || value.length === 0) {\n\t\tthrow new Error(`${label} must be a non-empty string`);\n\t}\n\treturn value;\n}\n\nfunction expectStringForOutcome(value: unknown, label: string, outcome: IrohRemoteHostHandshakeFailureOutcome): string {\n\tif (typeof value !== \"string\" || value.length === 0) {\n\t\tthrow new IrohRemoteHandshakeError(outcome, `${label} must be a non-empty string`);\n\t}\n\treturn value;\n}\n\nfunction expectOptionalString(value: unknown, label: string): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\treturn expectString(value, label);\n}\n\nfunction expectOptionalNumber(value: unknown, label: string): number | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"number\" || !Number.isFinite(value)) {\n\t\tthrow new Error(`${label} must be a finite number`);\n\t}\n\treturn value;\n}\n\nfunction expectWorkspaceName(value: unknown, label: string): string {\n\tconst workspace = expectStringForOutcome(value, label, \"invalid_workspace\");\n\tconst validationError = getIrohRemoteWorkspaceNameValidationError(workspace, label);\n\tif (validationError) {\n\t\tthrow new IrohRemoteHandshakeError(\"invalid_workspace\", validationError);\n\t}\n\treturn workspace;\n}\n\nexport function isIrohRemoteWorkspaceName(value: unknown): value is string {\n\treturn typeof value === \"string\" && getIrohRemoteWorkspaceNameValidationError(value, \"workspace\") === undefined;\n}\n\nfunction getIrohRemoteWorkspaceNameValidationError(value: string, label: string): string | undefined {\n\tif (value.length === 0) {\n\t\treturn `${label} must be a non-empty string`;\n\t}\n\tif (hasAsciiControlCharacter(value)) {\n\t\treturn `${label} must not contain ASCII control characters`;\n\t}\n\tif (Array.from(value).length > 255 || Buffer.byteLength(value, \"utf8\") > 1024) {\n\t\treturn `${label} exceeds maximum length`;\n\t}\n\treturn undefined;\n}\n\nfunction hasAsciiControlCharacter(value: string): boolean {\n\tfor (const char of value) {\n\t\tconst code = char.charCodeAt(0);\n\t\tif (code <= 0x1f || code === 0x7f) {\n\t\t\treturn true;\n\t\t}\n\t}\n\treturn false;\n}\n\nexport function isIrohRemoteSessionId(value: unknown): value is string {\n\treturn typeof value === \"string\" && IROH_REMOTE_SESSION_ID_PATTERN.test(value);\n}\n\nfunction parseIrohRemoteHelloMode(hello: Record<string, unknown>): IrohRemoteHelloMode {\n\tconst modeKeys = ([\"conversation\", \"workspaceDiscovery\", \"workspaceManagement\"] as const).filter(\n\t\t(key) => hello[key] !== undefined,\n\t);\n\tif (modeKeys.length !== 1) {\n\t\tthrow new IrohRemoteHandshakeError(\n\t\t\t\"invalid_conversation_target\",\n\t\t\t\"Iroh remote hello must include exactly one stream mode\",\n\t\t);\n\t}\n\tconst modeKey = modeKeys[0];\n\tif (modeKey === \"conversation\") {\n\t\treturn { mode: \"conversation\", conversation: parseConversationTarget(hello.conversation) };\n\t}\n\tif (modeKey === \"workspaceDiscovery\") {\n\t\treturn {\n\t\t\tmode: \"workspaceDiscovery\",\n\t\t\tworkspaceDiscovery: parseWorkspaceDiscoveryTarget(hello.workspaceDiscovery),\n\t\t};\n\t}\n\treturn {\n\t\tmode: \"workspaceManagement\",\n\t\tworkspaceManagement: parseWorkspaceManagementTarget(hello.workspaceManagement),\n\t};\n}\n\nfunction parseConversationTarget(value: unknown): IrohRemoteConversationTarget {\n\tconst target = expectRecordForOutcome(value, \"handshake conversation\", \"invalid_conversation_target\");\n\texpectKnownFields(target, \"handshake conversation\", [\"target\", \"sessionId\", \"worktreeId\", \"workingDirectory\"]);\n\tconst targetKind = expectStringForOutcome(\n\t\ttarget.target,\n\t\t\"handshake conversation target\",\n\t\t\"invalid_conversation_target\",\n\t);\n\t// worktreeId is only accepted on target \"new\": resume targets derive the\n\t// worktree from the persisted binding, never from the client.\n\tif (targetKind !== \"new\" && target.worktreeId !== undefined) {\n\t\tthrow new IrohRemoteHandshakeError(\n\t\t\t\"invalid_conversation_target\",\n\t\t\t`handshake conversation ${targetKind} target must not include worktreeId`,\n\t\t);\n\t}\n\tif (targetKind !== \"new\" && target.workingDirectory !== undefined) {\n\t\tthrow new IrohRemoteHandshakeError(\n\t\t\t\"invalid_conversation_target\",\n\t\t\t`handshake conversation ${targetKind} target must not include workingDirectory`,\n\t\t);\n\t}\n\tif (targetKind === \"last\" || targetKind === \"new\") {\n\t\tif (target.sessionId !== undefined) {\n\t\t\tthrow new IrohRemoteHandshakeError(\n\t\t\t\t\"invalid_conversation_target\",\n\t\t\t\t`handshake conversation ${targetKind} target must not include sessionId`,\n\t\t\t);\n\t\t}\n\t\tif (targetKind === \"new\") {\n\t\t\tconst worktreeId =\n\t\t\t\ttarget.worktreeId === undefined\n\t\t\t\t\t? undefined\n\t\t\t\t\t: expectWorktreeId(target.worktreeId, \"handshake conversation worktreeId\");\n\t\t\tconst workingDirectory =\n\t\t\t\ttarget.workingDirectory === undefined\n\t\t\t\t\t? undefined\n\t\t\t\t\t: expectWorkingDirectory(target.workingDirectory, \"handshake conversation workingDirectory\");\n\t\t\treturn {\n\t\t\t\ttarget: \"new\",\n\t\t\t\t...(worktreeId === undefined ? {} : { worktreeId }),\n\t\t\t\t...(workingDirectory === undefined ? {} : { workingDirectory }),\n\t\t\t};\n\t\t}\n\t\treturn { target: targetKind };\n\t}\n\tif (targetKind === \"session\") {\n\t\treturn {\n\t\t\ttarget: \"session\",\n\t\t\tsessionId: expectRemoteSessionId(target.sessionId, \"handshake conversation sessionId\"),\n\t\t};\n\t}\n\tthrow new IrohRemoteHandshakeError(\"invalid_conversation_target\", \"unsupported conversation target\");\n}\n\nfunction parseWorkspaceDiscoveryTarget(value: unknown): IrohRemoteWorkspaceDiscoveryTarget {\n\tconst target = expectRecordForOutcome(value, \"handshake workspaceDiscovery\", \"invalid_conversation_target\");\n\texpectKnownFields(target, \"handshake workspaceDiscovery\", [\"purpose\"]);\n\tconst purpose = expectStringForOutcome(\n\t\ttarget.purpose,\n\t\t\"handshake workspaceDiscovery purpose\",\n\t\t\"invalid_conversation_target\",\n\t);\n\tif (purpose !== \"list_sessions\") {\n\t\tthrow new IrohRemoteHandshakeError(\"invalid_conversation_target\", \"unsupported workspaceDiscovery purpose\");\n\t}\n\treturn { purpose };\n}\n\nfunction parseWorkspaceManagementTarget(value: unknown): IrohRemoteWorkspaceManagementTarget {\n\tconst target = expectRecordForOutcome(value, \"handshake workspaceManagement\", \"invalid_conversation_target\");\n\texpectKnownFields(target, \"handshake workspaceManagement\", [\"purpose\"]);\n\tconst purpose = expectStringForOutcome(\n\t\ttarget.purpose,\n\t\t\"handshake workspaceManagement purpose\",\n\t\t\"invalid_conversation_target\",\n\t);\n\tif (purpose !== \"unregister_workspace\" && purpose !== \"manage_worktrees\") {\n\t\tthrow new IrohRemoteHandshakeError(\"invalid_conversation_target\", \"unsupported workspaceManagement purpose\");\n\t}\n\treturn { purpose };\n}\n\nfunction expectKnownFields(value: Record<string, unknown>, label: string, allowedFields: readonly string[]): void {\n\tconst allowed = new Set(allowedFields);\n\tfor (const field of Object.keys(value)) {\n\t\tif (!allowed.has(field)) {\n\t\t\tthrow new IrohRemoteHandshakeError(\"invalid_conversation_target\", `${label} has unexpected field ${field}`);\n\t\t}\n\t}\n}\n\nfunction expectKnownResponseFields(\n\tvalue: Record<string, unknown>,\n\tlabel: string,\n\tallowedFields: readonly string[],\n): void {\n\tconst allowed = new Set(allowedFields);\n\tfor (const field of Object.keys(value)) {\n\t\tif (!allowed.has(field)) {\n\t\t\tthrow new Error(`${label} has unexpected field ${field}`);\n\t\t}\n\t}\n}\n\nfunction expectRemoteSessionId(value: unknown, label: string): string {\n\tconst sessionId = expectStringForOutcome(value, label, \"invalid_conversation_target\");\n\tif (!isIrohRemoteSessionId(sessionId)) {\n\t\tthrow new IrohRemoteHandshakeError(\n\t\t\t\"invalid_conversation_target\",\n\t\t\t`${label} must match lowercase remote session ID syntax`,\n\t\t);\n\t}\n\treturn sessionId;\n}\n\nfunction expectWorktreeId(value: unknown, label: string): string {\n\tconst worktreeId = expectStringForOutcome(value, label, \"invalid_conversation_target\");\n\tif (!isIrohRemoteWorktreeId(worktreeId)) {\n\t\tthrow new IrohRemoteHandshakeError(\n\t\t\t\"invalid_conversation_target\",\n\t\t\t`${label} must match lowercase worktree id syntax`,\n\t\t);\n\t}\n\treturn worktreeId;\n}\n\nfunction expectWorkingDirectory(value: unknown, label: string): string {\n\tconst workingDirectory = expectStringForOutcome(value, label, \"invalid_conversation_target\");\n\tif (!isIrohRemoteWorkingDirectory(workingDirectory)) {\n\t\tthrow new IrohRemoteHandshakeError(\n\t\t\t\"invalid_conversation_target\",\n\t\t\t`${label} must be a relative POSIX path inside the workspace`,\n\t\t);\n\t}\n\treturn workingDirectory;\n}\n\nfunction expectOptionalRemoteSessionId(value: unknown, label: string): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\treturn expectRemoteSessionIdForResponse(value, label);\n}\n\nfunction expectOptionalOutcome(value: unknown, label: string): IrohRemoteOutcome | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (!isIrohRemoteOutcome(value)) {\n\t\tthrow new Error(`${label} must be a known Iroh remote outcome`);\n\t}\n\treturn value;\n}\n\nfunction parseOptionalFeatures(value: unknown): string[] | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (!Array.isArray(value)) {\n\t\treturn [];\n\t}\n\tconst features: string[] = [];\n\tfor (const entry of value) {\n\t\tif (typeof entry !== \"string\" || entry.length === 0) {\n\t\t\treturn [];\n\t\t}\n\t\tfeatures.push(entry);\n\t}\n\treturn features;\n}\n\nfunction parseRequiredFeatures(value: unknown, label: string): string[] {\n\tconst features = parseOptionalFeatures(value);\n\tif (features === undefined || features.length === 0) {\n\t\tthrow new Error(`${label} must be a non-empty string array`);\n\t}\n\treturn features;\n}\n\nfunction parseOptionalRemoteHostHandshakeMetadata(value: unknown): IrohRemoteHostHandshakeMetadata | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tconst metadata = expectRecord(value, \"handshake response remoteHost\");\n\texpectKnownResponseFields(metadata, \"handshake response remoteHost\", [\n\t\t\"workspace\",\n\t\t\"workspaceNames\",\n\t\t\"workspaces\",\n\t\t\"features\",\n\t\t\"hostNodeId\",\n\t\t\"relayMode\",\n\t\t\"relayUrls\",\n\t\t\"hostName\",\n\t\t\"userName\",\n\t\t\"cwd\",\n\t]);\n\treturn {\n\t\tworkspace: expectWorkspaceNameForResponse(metadata.workspace, \"handshake response remoteHost workspace\"),\n\t\tworkspaceNames: parseRemoteHostWorkspaceNames(metadata.workspaceNames),\n\t\tworkspaces: parseRemoteHostWorkspaces(metadata.workspaces),\n\t\tfeatures: parseRequiredFeatures(metadata.features, \"handshake response remoteHost features\"),\n\t\t...(metadata.hostNodeId === undefined\n\t\t\t? {}\n\t\t\t: { hostNodeId: expectString(metadata.hostNodeId, \"handshake response remoteHost hostNodeId\") }),\n\t\t...(metadata.relayMode === undefined\n\t\t\t? {}\n\t\t\t: { relayMode: expectRelayMode(metadata.relayMode, \"handshake response remoteHost relayMode\") }),\n\t\t...(metadata.relayUrls === undefined\n\t\t\t? {}\n\t\t\t: { relayUrls: expectRelayUrls(metadata.relayUrls, \"handshake response remoteHost relayUrls\") }),\n\t\t...(metadata.hostName === undefined\n\t\t\t? {}\n\t\t\t: { hostName: expectString(metadata.hostName, \"handshake response remoteHost hostName\") }),\n\t\t...(metadata.userName === undefined\n\t\t\t? {}\n\t\t\t: { userName: expectString(metadata.userName, \"handshake response remoteHost userName\") }),\n\t\tcwd: expectString(metadata.cwd, \"handshake response remoteHost cwd\"),\n\t};\n}\n\nfunction parseRemoteHostWorkspaceNames(value: unknown): string[] {\n\tif (!Array.isArray(value)) {\n\t\tthrow new Error(\"handshake response remoteHost workspaceNames must be an array\");\n\t}\n\treturn value.map((entry) => expectWorkspaceNameForResponse(entry, \"handshake response remoteHost workspace name\"));\n}\n\nfunction parseRemoteHostWorkspaces(value: unknown): IrohRemoteWorkspaceStatus[] {\n\tif (!Array.isArray(value)) {\n\t\tthrow new Error(\"handshake response remoteHost workspaces must be an array\");\n\t}\n\treturn value.map((entry) => {\n\t\tconst workspace = expectRecord(entry, \"handshake response remoteHost workspace\");\n\t\texpectKnownResponseFields(workspace, \"handshake response remoteHost workspace\", [\"name\", \"status\"]);\n\t\treturn {\n\t\t\tname: expectWorkspaceNameForResponse(workspace.name, \"handshake response remoteHost workspace name\"),\n\t\t\tstatus: expectWorkspaceStatus(workspace.status, \"handshake response remoteHost workspace status\"),\n\t\t};\n\t});\n}\n\nfunction expectWorkspaceNameForResponse(value: unknown, label: string): string {\n\tconst workspace = expectString(value, label);\n\tconst validationError = getIrohRemoteWorkspaceNameValidationError(workspace, label);\n\tif (validationError) {\n\t\tthrow new Error(validationError);\n\t}\n\treturn workspace;\n}\n\nfunction expectWorkspaceStatus(value: unknown, label: string): IrohRemoteWorkspaceStatus[\"status\"] {\n\tconst status = expectString(value, label);\n\tif (status === \"available\" || status === \"missing\" || status === \"unavailable\") {\n\t\treturn status;\n\t}\n\tthrow new Error(`${label} must be a supported workspace status`);\n}\n\nfunction expectRelayMode(value: unknown, label: string): IrohRemoteRelayMode {\n\tif (isIrohRemoteRelayMode(value)) {\n\t\treturn value;\n\t}\n\tthrow new Error(`${label} must be a supported relay mode`);\n}\n\nfunction expectRelayUrls(value: unknown, label: string): string[] {\n\tif (isIrohRemoteRelayUrls(value)) {\n\t\treturn [...value];\n\t}\n\tthrow new Error(`${label} must be a non-empty array of relay URLs`);\n}\n\nfunction parseOptionalHandshakeSuccessMode(\n\tresponse: Record<string, unknown>,\n): Pick<IrohRemoteHandshakeSuccess, \"sessionId\" | \"conversation\" | \"workspaceDiscovery\" | \"workspaceManagement\"> {\n\tconst modeKeys = ([\"conversation\", \"workspaceDiscovery\", \"workspaceManagement\"] as const).filter(\n\t\t(key) => response[key] !== undefined,\n\t);\n\tif (modeKeys.length === 0) {\n\t\treturn {};\n\t}\n\tif (modeKeys.length !== 1) {\n\t\tthrow new Error(\"handshake response success must include exactly one stream mode\");\n\t}\n\tassertRequiredHandshakeFeatures(parseOptionalFeatures(response.features));\n\tconst modeKey = modeKeys[0];\n\tif (modeKey === \"conversation\") {\n\t\tconst sessionId = expectString(response.sessionId, \"handshake response sessionId\");\n\t\tconst conversation = parseConversationHandshakeMetadata(response.conversation);\n\t\tif (conversation.sessionId !== sessionId) {\n\t\t\tthrow new Error(\"handshake response conversation sessionId must match top-level sessionId\");\n\t\t}\n\t\treturn { sessionId, conversation };\n\t}\n\tif (response.sessionId !== undefined) {\n\t\tthrow new Error(`handshake response ${modeKey} must not include sessionId`);\n\t}\n\tif (modeKey === \"workspaceDiscovery\") {\n\t\treturn { workspaceDiscovery: parseWorkspaceDiscoveryResponseMetadata(response.workspaceDiscovery) };\n\t}\n\treturn { workspaceManagement: parseWorkspaceManagementResponseMetadata(response.workspaceManagement) };\n}\n\nfunction hasHandshakeSuccessModeMetadata(\n\tmetadata: Pick<\n\t\tIrohRemoteHandshakeSuccess,\n\t\t\"sessionId\" | \"conversation\" | \"workspaceDiscovery\" | \"workspaceManagement\"\n\t>,\n): boolean {\n\treturn (\n\t\tmetadata.conversation !== undefined ||\n\t\tmetadata.workspaceDiscovery !== undefined ||\n\t\tmetadata.workspaceManagement !== undefined\n\t);\n}\n\nfunction assertRequiredHandshakeFeatures(features: string[] | undefined): void {\n\tif (\n\t\tfeatures === undefined ||\n\t\t!features.includes(IROH_REMOTE_MULTI_STREAMS_FEATURE) ||\n\t\t!features.includes(IROH_REMOTE_CONVERSATION_STREAMS_FEATURE)\n\t) {\n\t\tthrow new Error(\"handshake response features must include required Iroh remote stream features\");\n\t}\n}\n\nfunction parseConversationHandshakeMetadata(value: unknown): IrohRemoteConversationHandshakeMetadata {\n\tconst metadata = expectRecord(value, \"handshake response conversation\");\n\texpectKnownResponseFields(metadata, \"handshake response conversation\", [\n\t\t\"target\",\n\t\t\"sessionId\",\n\t\t\"selection\",\n\t\t\"requestedSessionId\",\n\t\t\"worktreeId\",\n\t\t\"workingDirectory\",\n\t]);\n\tconst requestedSessionId = expectOptionalRemoteSessionId(\n\t\tmetadata.requestedSessionId,\n\t\t\"handshake response conversation requestedSessionId\",\n\t);\n\tconst worktreeId = expectOptionalWorktreeIdForResponse(\n\t\tmetadata.worktreeId,\n\t\t\"handshake response conversation worktreeId\",\n\t);\n\tconst workingDirectory = expectOptionalWorkingDirectoryForResponse(\n\t\tmetadata.workingDirectory,\n\t\t\"handshake response conversation workingDirectory\",\n\t);\n\tconst conversation: IrohRemoteConversationHandshakeMetadata = {\n\t\ttarget: expectConversationTargetKind(metadata.target, \"handshake response conversation target\"),\n\t\tsessionId: expectRemoteSessionIdForResponse(metadata.sessionId, \"handshake response conversation sessionId\"),\n\t\tselection: expectConversationSelection(metadata.selection, \"handshake response conversation selection\"),\n\t\t...(requestedSessionId === undefined ? {} : { requestedSessionId }),\n\t\t...(worktreeId === undefined ? {} : { worktreeId }),\n\t\t...(workingDirectory === undefined ? {} : { workingDirectory }),\n\t};\n\tassertConversationTargetSelection(conversation);\n\treturn conversation;\n}\n\nfunction expectConversationTargetKind(value: unknown, label: string): IrohRemoteConversationTarget[\"target\"] {\n\tconst target = expectString(value, label);\n\tif (target === \"last\" || target === \"new\" || target === \"session\") {\n\t\treturn target;\n\t}\n\tthrow new Error(`${label} must be a supported conversation target`);\n}\n\nfunction expectConversationSelection(value: unknown, label: string): IrohRemoteConversationSelection {\n\tconst selection = expectString(value, label);\n\tif (\n\t\tselection === \"resumed\" ||\n\t\tselection === \"created\" ||\n\t\tselection === \"created_missing_last\" ||\n\t\tselection === \"session_rekeyed\"\n\t) {\n\t\treturn selection;\n\t}\n\tthrow new Error(`${label} must be a supported conversation selection`);\n}\n\nfunction assertConversationTargetSelection(conversation: IrohRemoteConversationHandshakeMetadata): void {\n\tif (conversation.selection === \"session_rekeyed\") {\n\t\tif (conversation.target !== \"session\") {\n\t\t\tthrow new Error(\"handshake response session_rekeyed selection requires session target\");\n\t\t}\n\t\tif (conversation.requestedSessionId === undefined) {\n\t\t\tthrow new Error(\"handshake response session_rekeyed selection requires requestedSessionId\");\n\t\t}\n\t\tif (conversation.requestedSessionId === conversation.sessionId) {\n\t\t\tthrow new Error(\"handshake response session_rekeyed selection requires a different sessionId\");\n\t\t}\n\t\treturn;\n\t}\n\tif (conversation.requestedSessionId !== undefined) {\n\t\tthrow new Error(\"handshake response requestedSessionId requires session_rekeyed selection\");\n\t}\n\tif (conversation.target === \"new\" && conversation.selection !== \"created\") {\n\t\tthrow new Error(\"handshake response new target must use created selection\");\n\t}\n\tif (conversation.target === \"session\" && conversation.selection !== \"resumed\") {\n\t\tthrow new Error(\"handshake response session target must use resumed selection\");\n\t}\n}\n\nfunction expectOptionalWorkingDirectoryForResponse(value: unknown, label: string): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (!isIrohRemoteWorkingDirectory(value)) {\n\t\tthrow new Error(`${label} must be a relative POSIX path inside the workspace`);\n\t}\n\treturn value;\n}\n\nfunction expectRemoteSessionIdForResponse(value: unknown, label: string): string {\n\tconst sessionId = expectString(value, label);\n\tif (!isIrohRemoteSessionId(sessionId)) {\n\t\tthrow new Error(`${label} must match lowercase remote session ID syntax`);\n\t}\n\treturn sessionId;\n}\n\nfunction expectOptionalWorktreeIdForResponse(value: unknown, label: string): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (!isIrohRemoteWorktreeId(value)) {\n\t\tthrow new Error(`${label} must match lowercase worktree id syntax`);\n\t}\n\treturn value;\n}\n\nfunction parseWorkspaceDiscoveryResponseMetadata(value: unknown): IrohRemoteWorkspaceDiscoveryTarget {\n\tconst metadata = expectRecord(value, \"handshake response workspaceDiscovery\");\n\texpectKnownResponseFields(metadata, \"handshake response workspaceDiscovery\", [\"purpose\"]);\n\tif (metadata.purpose !== \"list_sessions\") {\n\t\tthrow new Error(\"handshake response workspaceDiscovery purpose must be list_sessions\");\n\t}\n\treturn { purpose: \"list_sessions\" };\n}\n\nfunction parseWorkspaceManagementResponseMetadata(value: unknown): IrohRemoteWorkspaceManagementTarget {\n\tconst metadata = expectRecord(value, \"handshake response workspaceManagement\");\n\texpectKnownResponseFields(metadata, \"handshake response workspaceManagement\", [\"purpose\"]);\n\tif (metadata.purpose !== \"unregister_workspace\" && metadata.purpose !== \"manage_worktrees\") {\n\t\tthrow new Error(\"handshake response workspaceManagement purpose must be a supported management purpose\");\n\t}\n\treturn { purpose: metadata.purpose };\n}\n"]}