ds-harness-remote 0.4.10 → 0.4.12

package/dist/index.js

@@ -13977,8 +13977,51 @@ function uuidV7(now = Date.now()) {
   return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
 }
 
+// src/harness-version.ts
+import { readFile } from "node:fs/promises";
+import { dirname, isAbsolute, join } from "node:path";
+var LEGACY_PLACEHOLDER_VERSION = "0.0.1";
+function normalizeHarnessVersion(value) {
+  if (typeof value !== "string") return void 0;
+  const version = value.trim();
+  if (version.length === 0 || version.length > 64 || /[\u0000-\u001f]/u.test(version)) return void 0;
+  return version;
+}
+function selectHarnessVersion(reportedVersion, distributionVersion) {
+  if (reportedVersion !== void 0 && reportedVersion !== LEGACY_PLACEHOLDER_VERSION) return reportedVersion;
+  return distributionVersion;
+}
+function harnessSessionGeneration(version) {
+  if (version === void 0) return "legacy";
+  const match = /^(?:dsh-)?v?(\d+)\.(\d+)\.(\d+)(?:-|$)/u.exec(version.trim());
+  if (match === null) return "legacy";
+  const major = Number(match[1]);
+  const minor = Number(match[2]);
+  const patch = Number(match[3]);
+  return major === 0 && minor === 1 && patch >= 5 ? "v3" : "legacy";
+}
+async function readHarnessDistributionVersion(entrypoint = process.argv[1]) {
+  if (entrypoint === void 0 || !isAbsolute(entrypoint)) return void 0;
+  let directory = dirname(entrypoint);
+  for (let depth = 0; depth < 8; depth += 1) {
+    try {
+      const manifest = JSON.parse(await readFile(join(directory, "package.json"), "utf8"));
+      if (manifest.name === "@deepseek-ai/dsh") return normalizeHarnessVersion(manifest.version);
+    } catch {
+    }
+    const parent = dirname(directory);
+    if (parent === directory) break;
+    directory = parent;
+  }
+  return void 0;
+}
+
 // src/remote-api-proxy.ts
 var DIRECT_API_CALL_BYTES = 2 * 1024 * 1024;
+var AGENT_PRESET_SETTINGS_NS = "agent-presets";
+var LEGACY_AGENT_PRESET_ALIASES = {
+  code: "ptc"
+};
 var RemoteHarnessApiProxy = class {
   constructor(client) {
     this.client = client;
@@ -14067,7 +14110,7 @@ var RemoteHarnessApiProxy = class {
     const params = {
       method,
       rpcId: String(request.rpcId),
-      payload: request.payload
+      payload: normalizeLegacyRequest(method, request.payload)
     };
     const encoded = new TextEncoder().encode(JSON.stringify(params));
     const response = method === "session.attachment" || encoded.byteLength > DIRECT_API_CALL_BYTES ? await this.callTransferred(encoded, signal) : await this.client.rpc("harness.api.call", params, signal);
@@ -14179,9 +14222,32 @@ function normalizeLegacyResponse(method, response) {
     }
   };
 }
+function normalizeLegacyRequest(method, payload) {
+  if (!isRecord2(payload)) return payload;
+  if (method === "agentPreset.read") return replaceAgentPreset(payload, "agentPreset");
+  if (method === "agentPreset.select") return replaceAgentPreset(payload, "agentPreset");
+  if (method === "agentPreset.copy") return replaceAgentPreset(payload, "from");
+  if (method === "settings.update" || method === "settings.replace" || method === "settings.mutate") {
+    return replaceAgentPresetSettings(payload);
+  }
+  return payload;
+}
+function replaceAgentPreset(payload, key) {
+  const value = payload[key];
+  const replacement = typeof value === "string" ? LEGACY_AGENT_PRESET_ALIASES[value] : void 0;
+  return replacement === void 0 ? payload : { ...payload, [key]: replacement };
+}
+function replaceAgentPresetSettings(payload) {
+  if (payload.ns !== AGENT_PRESET_SETTINGS_NS || !isRecord2(payload.patch)) return payload;
+  const patch = replaceAgentPreset(payload.patch, "default");
+  return patch === payload.patch ? payload : { ...payload, patch };
+}
 function isRemoteDisconnect(error) {
   return error instanceof RemoteClientError && (error.code === "TRANSPORT_CLOSED" || error.code === "CLIENT_CLOSED");
 }
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 var AsyncFrameQueue = class {
   values = [];
   waiters = [];
@@ -14416,16 +14482,16 @@ function routeStreamEvent2(event, streamId, queue) {
     queue.fail(remoteFailure({
       code: typeof failure2?.code === "string" ? failure2.code : "internal",
       message: typeof failure2?.message === "string" ? failure2.message : "The remote Harness stream failed.",
-      details: isRecord2(failure2?.details) ? failure2.details : {}
+      details: isRecord3(failure2?.details) ? failure2.details : {}
     }));
   } else {
     queue.close();
   }
 }
 function parseRpcResult(value) {
-  if (!isRecord2(value)) throw new Error("The remote Host returned an invalid Gateway result.");
+  if (!isRecord3(value)) throw new Error("The remote Host returned an invalid Gateway result.");
   if (value.ok === true) return Object.hasOwn(value, "value") ? { ok: true, value: value.value } : { ok: true };
-  if (value.ok !== false || !isRecord2(value.error) || typeof value.error.code !== "string" || typeof value.error.message !== "string" || !isRecord2(value.error.details)) {
+  if (value.ok !== false || !isRecord3(value.error) || typeof value.error.code !== "string" || typeof value.error.message !== "string" || !isRecord3(value.error.details)) {
     throw new Error("The remote Host returned an invalid Gateway failure.");
   }
   return {
@@ -14459,7 +14525,7 @@ function base64ToBytes3(value) {
   if (bytesToBase643(bytes) !== value) throw new Error("The remote Host returned non-canonical Harness Remote transfer data.");
   return bytes;
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function hasErrorCode(error, code) {
@@ -14510,9 +14576,10 @@ async function discoverCodexVirtualWorkspaces(client, signal) {
   return (await loadCatalog(client, signal)).workspaces;
 }
 var CodexVirtualHarness = class _CodexVirtualHarness {
-  constructor(client, host) {
+  constructor(client, host, sessionGeneration = "legacy") {
     this.client = client;
     this.host = host;
+    this.sessionGeneration = sessionGeneration;
     this.api = this.createApiProxy();
   }
   api;
@@ -14536,8 +14603,8 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
   commandSeq = 0;
   selectedWorkspaceId;
   closed = false;
-  static remote(core, host) {
-    return new _CodexVirtualHarness(new CodexRemoteClient(core), host);
+  static remote(core, host, sessionGeneration = "legacy") {
+    return new _CodexVirtualHarness(new CodexRemoteClient(core), host, sessionGeneration);
   }
   async workspaces(signal) {
     return (await this.refreshCatalog(signal)).workspaces;
@@ -14927,6 +14994,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
       streamedBlocks: /* @__PURE__ */ new Map(),
       nextBlockIndex: 0,
       streamActive: false,
+      assistantStreamRevision: 0,
       liveItems: /* @__PURE__ */ new Map(),
       liveToolOutput: /* @__PURE__ */ new Map(),
       liveToolResultSeq: /* @__PURE__ */ new Map(),
@@ -14950,7 +15018,8 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
           permissions: codexPermissionsProjection(this.permissionSelection(sessionId)),
           imageLimits: codexImageLimitsProjection()
         }
-      }
+      },
+      ...this.sessionGeneration === "v3" ? { assistantStream: { revision: 0 } } : {}
     });
     try {
       const stream = await this.client.subscribe(
@@ -14988,6 +15057,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
     }
     if (frame.method === "turn/started") {
       const turn = record2(params.turn);
+      this.endAssistantAttempt(follow, { kind: "abandoned" });
       this.resetLiveTurn(follow);
       follow.turn += 1;
       follow.activeTurnId = string(turn.id);
@@ -15103,6 +15173,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
       if (follow.stepOpen) {
         this.closeAllStreamBlocks(follow);
         if (follow.streamActive) this.finishStream(follow);
+        this.endAssistantAttempt(follow, { kind: "abandoned" });
         this.pushEvent(follow, "step/end", { turn: follow.turn, step: 1 });
         follow.stepOpen = false;
       }
@@ -15141,6 +15212,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
     this.closeItemStreamBlocks(follow, itemId, itemText2(item));
     if (type === "agentMessage" && follow.streamActive && follow.streamedBlocks.size === 0) this.finishStream(follow);
     const supplementalImages = type === "agentMessage" ? follow.pendingToolImages : [];
+    let assistantMessageSeq;
     for (const event of itemEvents(
       item,
       follow.turn,
@@ -15152,7 +15224,17 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
     )) {
       if (event.type === "tool/call" && follow.startedItems.has(itemId)) continue;
       if (event.type === "tool/result") this.pushToolResult(follow, itemId, event);
-      else this.pushEvent(follow, event.type, event.data, event.view);
+      else {
+        const seq = this.pushEvent(follow, event.type, event.data, event.view);
+        if (event.type === "assistant/message") assistantMessageSeq = seq;
+      }
+    }
+    if (type === "agentMessage" && assistantMessageSeq !== void 0) {
+      this.endAssistantAttempt(follow, {
+        kind: "committed",
+        eventType: "assistant/message",
+        seq: assistantMessageSeq
+      });
     }
     if (type === "agentMessage" && supplementalImages.length > 0) follow.pendingToolImages = [];
     else if (type !== void 0 && isToolItemType2(type)) {
@@ -15169,18 +15251,21 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
       type,
       seq,
       time: Date.now(),
-      data,
+      data: adaptEventData(
+        type,
+        type === "assistant/message" && this.sessionGeneration === "v3" && follow.assistantAttempt !== void 0 ? { ...record2(data), stream: follow.assistantAttempt.stream } : data,
+        this.sessionGeneration
+      ),
       ...isSurfaceEvent(type) ? placement === void 0 ? { surfaceOp: "append" } : {
-        surfaceOp: { op: "replace", start: placement.replaceSeq, end: placement.replaceSeq },
+        surfaceOp: this.sessionGeneration === "v3" ? { op: "replace", startSeq: placement.replaceSeq, endSeq: placement.replaceSeq } : { op: "replace", start: placement.replaceSeq, end: placement.replaceSeq },
         sourceEventSeqs: [placement.replaceSeq]
       } : {}
     };
     this.cacheImageBlocks(follow.sessionId, event.data);
     if (!follow.rcOnly) {
-      const alphaEvent = typeof event.surfaceOp === "object" ? { ...event, surfaceOp: "replace" } : event;
       follow.queue.push({
         type: "event",
-        event: alphaEvent,
+        event,
         ...view === void 0 ? {} : { view }
       });
     }
@@ -15207,52 +15292,105 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
     const block = { itemId, index: follow.nextBlockIndex++, kind, text: "" };
     follow.streamedBlocks.set(key, block);
     follow.streamActive = true;
-    this.pushEvent(follow, "assistant/chunk", {
-      turn: follow.turn,
-      step: 1,
-      chunk: { type: "block-start", index: block.index, blockType: kind }
-    });
+    this.pushAssistantChunk(follow, { type: "block-start", index: block.index, blockType: kind });
     return block;
   }
   appendStreamDelta(follow, key, itemId, kind, delta) {
     const block = this.ensureStreamBlock(follow, key, itemId, kind);
     block.text = appendBoundedText(block.text, delta);
-    this.pushEvent(follow, "assistant/chunk", {
-      turn: follow.turn,
-      step: 1,
-      chunk: { type: kind === "reasoning" ? "reasoning-delta" : "text-delta", index: block.index, text: delta }
+    this.pushAssistantChunk(follow, {
+      type: kind === "reasoning" ? "reasoning-delta" : "text-delta",
+      index: block.index,
+      text: delta
     });
   }
   closeItemStreamBlocks(follow, itemId, fallback) {
     const matches = [...follow.streamedBlocks].filter(([, block]) => block.itemId === itemId);
     for (const [key, block] of matches) {
       const text = block.text || fallback || "";
-      this.pushEvent(follow, "assistant/chunk", {
-        turn: follow.turn,
-        step: 1,
-        chunk: { type: "block-end", index: block.index, block: { type: block.kind, text } }
+      this.pushAssistantChunk(follow, {
+        type: "block-end",
+        index: block.index,
+        block: { type: block.kind, text }
       });
       follow.streamedBlocks.delete(key);
     }
   }
   closeAllStreamBlocks(follow) {
     for (const block of follow.streamedBlocks.values()) {
-      this.pushEvent(follow, "assistant/chunk", {
-        turn: follow.turn,
-        step: 1,
-        chunk: { type: "block-end", index: block.index, block: { type: block.kind, text: block.text } }
+      this.pushAssistantChunk(follow, {
+        type: "block-end",
+        index: block.index,
+        block: { type: block.kind, text: block.text }
       });
     }
     follow.streamedBlocks.clear();
   }
   finishStream(follow) {
-    this.pushEvent(follow, "assistant/chunk", {
-      turn: follow.turn,
-      step: 1,
-      chunk: { type: "finish", reason: { kind: "stop" } }
-    });
+    this.pushAssistantChunk(follow, { type: "finish", reason: { kind: "stop" } });
     follow.streamActive = false;
   }
+  pushAssistantChunk(follow, chunk) {
+    if (this.sessionGeneration !== "v3" || follow.rcOnly === true) {
+      this.pushEvent(follow, "assistant/chunk", { turn: follow.turn, step: 1, chunk });
+      return;
+    }
+    let attempt = follow.assistantAttempt;
+    if (attempt === void 0) {
+      attempt = {
+        attemptId: `codex-attempt:${follow.activeTurnId ?? follow.turn}:${follow.nextSeq}`,
+        startedAfterSeq: follow.nextSeq - 1,
+        nextIndex: 0,
+        stream: []
+      };
+      follow.assistantAttempt = attempt;
+      follow.assistantStreamRevision += 1;
+      follow.queue.push({
+        type: "assistant-stream",
+        frame: {
+          type: "start",
+          attemptId: attempt.attemptId,
+          revision: follow.assistantStreamRevision,
+          startedAfterSeq: attempt.startedAfterSeq,
+          turn: follow.turn,
+          step: 1
+        }
+      });
+    }
+    const time = Date.now();
+    const index = attempt.nextIndex++;
+    attempt.stream.push({ time, chunk });
+    follow.assistantStreamRevision += 1;
+    follow.queue.push({
+      type: "assistant-stream",
+      frame: {
+        type: "chunk",
+        attemptId: attempt.attemptId,
+        revision: follow.assistantStreamRevision,
+        index,
+        time,
+        chunk
+      }
+    });
+  }
+  endAssistantAttempt(follow, outcome) {
+    const attempt = follow.assistantAttempt;
+    if (attempt === void 0) return;
+    follow.assistantAttempt = void 0;
+    follow.assistantStreamRevision += 1;
+    if (this.sessionGeneration === "v3" && follow.rcOnly !== true) {
+      follow.queue.push({
+        type: "assistant-stream",
+        frame: {
+          type: "end",
+          attemptId: attempt.attemptId,
+          revision: follow.assistantStreamRevision,
+          index: attempt.nextIndex,
+          outcome
+        }
+      });
+    }
+  }
   ensureToolStarted(follow, item) {
     const itemId = string(item.id);
     if (itemId === void 0) return;
@@ -15295,6 +15433,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
     follow.streamedBlocks.clear();
     follow.nextBlockIndex = 0;
     follow.streamActive = false;
+    follow.assistantAttempt = void 0;
     follow.liveItems.clear();
     follow.liveToolOutput.clear();
     follow.liveToolResultSeq.clear();
@@ -15307,7 +15446,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
       this.broadcastRcHost({ type: "host/session-status", sessionId, running: args[1] });
     } else if (event === "api-session/removed" && sessionId !== void 0) {
       this.broadcastRcHost({ type: "host/session-removed", sessionId });
-    } else if (event === "api-session/added" && isRecord3(args[0])) {
+    } else if (event === "api-session/added" && isRecord4(args[0])) {
       const summary = args[0];
       this.broadcastRcHost({
         type: "host/session-added",
@@ -15565,7 +15704,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
       const thread = record2(result.thread);
       if (string(thread.id) !== threadId) throw new Error("CodeX returned an invalid Thread history.");
       value = paginateCodexNativeHistory(
-        projectCodexNativeHistory(thread, `codex:${threadId}`),
+        projectCodexNativeHistory(thread, `codex:${threadId}`, this.sessionGeneration),
         {
           beforeSeq: page.beforeSeq,
           throughSeq: page.throughSeq,
@@ -15573,6 +15712,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
         }
       );
     }
+    value = adaptCodexHistoryPage(value, this.sessionGeneration);
     if (!isCodexNativeHistoryPage(value, `codex:${threadId}`)) {
       throw new Error("CodeX Remote returned an invalid paginated History.");
     }
@@ -15640,6 +15780,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
       streamedBlocks: /* @__PURE__ */ new Map(),
       nextBlockIndex: 0,
       streamActive: false,
+      assistantStreamRevision: 0,
       liveItems: /* @__PURE__ */ new Map(),
       liveToolOutput: /* @__PURE__ */ new Map(),
       liveToolResultSeq: /* @__PURE__ */ new Map(),
@@ -15690,7 +15831,7 @@ var CodexVirtualHarness = class _CodexVirtualHarness {
   }
   createApiProxy() {
     const call = (endpoint) => async (request, signal) => {
-      const payload = endpoint === "session.prompt" && isRecord3(request.payload) ? { ...request.payload, requestId: String(request.rpcId) } : request.payload;
+      const payload = endpoint === "session.prompt" && isRecord4(request.payload) ? { ...request.payload, requestId: String(request.rpcId) } : request.payload;
       const result = await this.dispatch(rcEndpoint(endpoint), { args: { request: payload } }, signal ?? new AbortController().signal);
       return {
         rpcId: request.rpcId,
@@ -15922,7 +16063,7 @@ async function loadModelDirectory(client, signal) {
     models
   };
 }
-function projectCodexNativeHistory(thread, sessionId) {
+function projectCodexNativeHistory(thread, sessionId, sessionGeneration = "legacy") {
   const entries = [];
   let seq = 0;
   let turnNumber = 0;
@@ -15935,7 +16076,7 @@ function projectCodexNativeHistory(thread, sessionId) {
         type,
         seq: eventSeq,
         time,
-        data,
+        data: adaptEventData(type, data, sessionGeneration),
         ...sourceEventSeqs === void 0 ? {} : { sourceEventSeqs },
         ...isSurfaceEvent(type) ? { surfaceOp: "append" } : {}
       },
@@ -15988,10 +16129,11 @@ function projectCodexNativeHistory(thread, sessionId) {
   const projected = projectCodexThread(thread);
   return {
     header: {
-      version: 1,
+      version: sessionGeneration === "v3" ? 3 : 1,
       id: sessionId,
       createdAt: projected?.createdAt ?? Date.now(),
-      ...projected?.cwd === void 0 ? {} : { cwd: projected.cwd }
+      ...projected?.cwd === void 0 ? {} : { cwd: projected.cwd },
+      ...sessionGeneration === "v3" ? { isSeeded: false } : {}
     },
     entries,
     lastSeq: seq - 1,
@@ -16024,6 +16166,40 @@ function paginateCodexNativeHistory(history, request) {
     ...history.activeTurnId === void 0 ? {} : { activeTurnId: history.activeTurnId }
   };
 }
+function adaptEventData(type, data, sessionGeneration) {
+  if (sessionGeneration !== "v3" || type !== "assistant/message") return data;
+  const value = record2(data);
+  return Array.isArray(value.stream) ? value : { ...value, stream: [] };
+}
+function adaptCodexHistoryPage(value, sessionGeneration) {
+  if (sessionGeneration !== "v3") return value;
+  const page = record2(value);
+  const sourceHeader = record2(page.header);
+  const { seedLength: _seedLength, ...header } = sourceHeader;
+  const records = Array.isArray(page.records) ? page.records.map((raw) => {
+    const entry = record2(raw);
+    const sourceEvent = record2(entry.event);
+    const sourceSurfaceOp = record2(sourceEvent.surfaceOp);
+    const surfaceOp = sourceEvent.surfaceOp === "append" ? "append" : sourceSurfaceOp.op === "replace" && integer(sourceSurfaceOp.startSeq) !== void 0 && integer(sourceSurfaceOp.endSeq) !== void 0 ? sourceSurfaceOp : sourceSurfaceOp.op === "replace" && integer(sourceSurfaceOp.start) !== void 0 && integer(sourceSurfaceOp.end) !== void 0 ? {
+      op: "replace",
+      startSeq: sourceSurfaceOp.start,
+      endSeq: sourceSurfaceOp.end
+    } : sourceEvent.surfaceOp;
+    return {
+      ...entry,
+      event: {
+        ...sourceEvent,
+        data: adaptEventData(string(sourceEvent.type) ?? "", sourceEvent.data, sessionGeneration),
+        ...surfaceOp === void 0 ? {} : { surfaceOp }
+      }
+    };
+  }) : page.records;
+  return {
+    ...page,
+    header: { ...header, version: 3, isSeeded: sourceHeader.isSeeded === true },
+    records
+  };
+}
 function itemEvents(item, turn, step, requestId, selection = modelSelection(), sessionId = CODEX_SESSION_PREFIX, supplementalImages = []) {
   const type = string(item.type);
   const id2 = string(item.id) ?? `${turn}:${step}:${hashString(JSON.stringify(item))}`;
@@ -16180,7 +16356,7 @@ function collectImageBlocks(value, output = []) {
     for (const item of value) collectImageBlocks(item, output);
     return output;
   }
-  if (!isRecord3(value)) return output;
+  if (!isRecord4(value)) return output;
   if (value.type === "image") output.push(value);
   for (const [key, child] of Object.entries(value)) {
     if (key === "attachment") continue;
@@ -16510,7 +16686,7 @@ function codexPromptInput(content) {
   if (content.length === 0 || content.length > MAX_CODEX_PROMPT_PARTS) return void 0;
   const input2 = [];
   for (const value of content) {
-    if (!isRecord3(value)) return void 0;
+    if (!isRecord4(value)) return void 0;
     if (value.type === "text") {
       if (typeof value.text !== "string" || value.text.length === 0 || value.text.length > MAX_CODEX_PROMPT_TEXT) return void 0;
       input2.push({ type: "text", text: value.text });
@@ -16763,12 +16939,12 @@ function errorCode(error) {
   return "code" in error && typeof error.code === "string" ? error.code : void 0;
 }
 function errorDetails(error) {
-  return "details" in error && isRecord3(error.details) ? error.details : {};
+  return "details" in error && isRecord4(error.details) ? error.details : {};
 }
 function record2(value) {
-  return isRecord3(value) ? value : {};
+  return isRecord4(value) ? value : {};
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function array(value) {
@@ -16982,7 +17158,7 @@ function normalizeServerUrl(value) {
 }
 
 // src/version.ts
-var PLUGIN_VERSION = "0.4.10";
+var PLUGIN_VERSION = "0.4.12";
 
 // src/server-api.ts
 var TERMINAL_CONTROL_CHARACTERS = /[\u0000-\u001f\u007f-\u009f]/u;
@@ -17501,7 +17677,7 @@ var TypertGatewaySwitch = class {
     if (normalized !== void 0) 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 && isRecord4(source.details) ? source.details : {};
+    const details = "details" in source && isRecord5(source.details) ? source.details : {};
     return { code, message: source.message, details };
   }
 };
@@ -17510,7 +17686,7 @@ function requestFromCarrier(endpoint, payload, signal) {
   if (segments.length !== 2 || segments.some((segment) => segment.length === 0)) {
     throw new Error("The Harness Gateway endpoint is invalid.");
   }
-  if (!isRecord4(payload) || !isRecord4(payload.args)) {
+  if (!isRecord5(payload) || !isRecord5(payload.args)) {
     throw new Error("The Harness Gateway payload is invalid.");
   }
   return { namespace: segments[0], method: segments[1], args: payload.args, signal };
@@ -17525,7 +17701,7 @@ function isLocalOnlyEndpoint(endpoint) {
 function isRemoteCommandMethod(method) {
   return REMOTE_COMMAND_METHODS.includes(method);
 }
-function isRecord4(value) {
+function isRecord5(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -17536,7 +17712,7 @@ import { networkInterfaces } from "node:os";
 // src/native-rtc-helper.ts
 import { spawn, spawnSync } from "node:child_process";
 import { existsSync, readdirSync, realpathSync, statSync } from "node:fs";
-import { delimiter, dirname, join } from "node:path";
+import { delimiter, dirname as dirname2, join as join2 } from "node:path";
 import { fileURLToPath } from "node:url";
 var cachedExternalFactory;
 var cachedExternalFactoryResolved = false;
@@ -17587,21 +17763,21 @@ function nodeBinaryCandidates() {
   add3(process.env.DSH_REMOTE_NODE);
   add3(process.env.NODE);
   add3(process.execPath);
-  for (const part of (process.env.PATH ?? "").split(delimiter)) add3(join(part, process.platform === "win32" ? "node.exe" : "node"));
+  for (const part of (process.env.PATH ?? "").split(delimiter)) add3(join2(part, process.platform === "win32" ? "node.exe" : "node"));
   add3("/opt/homebrew/bin/node");
   add3("/usr/local/bin/node");
   add3("/usr/bin/node");
-  add3(join(process.env.HOME ?? "", ".volta", "bin", process.platform === "win32" ? "node.exe" : "node"));
-  add3(join(process.env.HOME ?? "", ".asdf", "shims", process.platform === "win32" ? "node.exe" : "node"));
-  add3(join(process.env.HOME ?? "", ".local", "bin", process.platform === "win32" ? "node.exe" : "node"));
+  add3(join2(process.env.HOME ?? "", ".volta", "bin", process.platform === "win32" ? "node.exe" : "node"));
+  add3(join2(process.env.HOME ?? "", ".asdf", "shims", process.platform === "win32" ? "node.exe" : "node"));
+  add3(join2(process.env.HOME ?? "", ".local", "bin", process.platform === "win32" ? "node.exe" : "node"));
   for (const nvmNode of nvmNodeCandidates()) add3(nvmNode);
   return candidates;
 }
 function nvmNodeCandidates() {
-  const root = join(process.env.HOME ?? "", ".nvm", "versions", "node");
+  const root = join2(process.env.HOME ?? "", ".nvm", "versions", "node");
   if (root === "" || !existsSync(root)) return [];
   try {
-    return readdirSync(root).map((version) => join(root, version, "bin", process.platform === "win32" ? "node.exe" : "node")).sort((left, right) => right.localeCompare(left, "en", { numeric: true }));
+    return readdirSync(root).map((version) => join2(root, version, "bin", process.platform === "win32" ? "node.exe" : "node")).sort((left, right) => right.localeCompare(left, "en", { numeric: true }));
   } catch {
     return [];
   }
@@ -17623,7 +17799,7 @@ function isUsableExternalNode(candidate, requireFrom) {
       "console.log(`node:${process.versions.node}`);"
     ].join("")
   ], {
-    cwd: dirname(requireFrom),
+    cwd: dirname2(requireFrom),
     env,
     encoding: "utf8",
     timeout: 3e3
@@ -17645,7 +17821,7 @@ var ExternalNativePeerConnection = class {
     this.nodeBinary = nodeBinary;
     this.requireFrom = requireFrom;
     this.child = spawn(this.nodeBinary, ["--input-type=module", "--eval", HELPER_SOURCE], {
-      cwd: dirname(this.requireFrom),
+      cwd: dirname2(this.requireFrom),
       env: { ...process.env, DSH_REMOTE_RTC_HELPER_REQUIRE_FROM: this.requireFrom },
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -18855,7 +19031,7 @@ var ClientModeRuntime = class {
     const virtual = CodexVirtualHarness.remote(remote.client, {
       deviceId: remote.target.deviceId,
       name: remote.target.name
-    });
+    }, harnessSessionGeneration(this.host?.localHarnessVersion?.()));
     let workspace;
     try {
       workspace = await virtual.selectWorkspace(workspaceId, signal);
@@ -18972,10 +19148,10 @@ var ClientModeRuntime = class {
       }
     }
     stream.unsubscribe = remote.client.onEvent((event) => {
-      if (event.event === "codex.app.frame" && isRecord5(event.data) && event.data.streamId === value.streamId) {
+      if (event.event === "codex.app.frame" && isRecord6(event.data) && event.data.streamId === value.streamId) {
         this.appendCodexFrame(stream, event.data);
       }
-      if (event.event === "codex.app.stream.closed" && isRecord5(event.data) && event.data.streamId === value.streamId) {
+      if (event.event === "codex.app.stream.closed" && isRecord6(event.data) && event.data.streamId === value.streamId) {
         stream.closed = typeof event.data.reason === "string" ? event.data.reason : "closed";
         stream.wake();
       }
@@ -19002,7 +19178,7 @@ var ClientModeRuntime = class {
     stream.wake();
   };
   appendCodexFrame(stream, data) {
-    if (!isRecord5(data) || !isRecord5(data.frame) || typeof data.frame.method !== "string") return;
+    if (!isRecord6(data) || !isRecord6(data.frame) || typeof data.frame.method !== "string") return;
     if (stream.frames.length >= 256) {
       stream.closed = "overflow";
     } else {
@@ -19087,7 +19263,16 @@ var ClientModeRuntime = class {
   }
   assertRemoteCompatible(remote) {
     const localRemoteGateway = this.gatewaySwitch.supportsCarrier();
-    if (localRemoteGateway && remote.features.remoteGateway || !localRemoteGateway && this.proxySwitch !== void 0 && remote.features.apiProxy) return;
+    if (localRemoteGateway && remote.features.remoteGateway) {
+      const localSessionGeneration = harnessSessionGeneration(this.host?.localHarnessVersion?.());
+      const remoteSessionGeneration = remote.features.sessionFormat === 3 ? "v3" : "legacy";
+      if (localSessionGeneration === remoteSessionGeneration) return;
+      throw new ClientModeError(
+        "HARNESS_VERSION_INCOMPATIBLE",
+        `The local and remote Harness Session formats differ (${localSessionGeneration} vs ${remoteSessionGeneration}).`
+      );
+    }
+    if (!localRemoteGateway && this.proxySwitch !== void 0 && remote.features.apiProxy) return;
     throw new ClientModeError(
       "HARNESS_VERSION_INCOMPATIBLE",
       localRemoteGateway ? "The selected Host does not provide the Harness v0.1.2 Typert Remote Gateway transport." : "The selected Host does not provide the legacy Harness ApiProxy transport."
@@ -19216,7 +19401,8 @@ var ClientModeRuntime = class {
         transport: connectedTransport,
         features,
         progressRunId,
-        ...serverDevice.clientVersion === void 0 ? {} : { clientVersion: serverDevice.clientVersion }
+        ...serverDevice.clientVersion === void 0 ? {} : { clientVersion: serverDevice.clientVersion },
+        ...serverDevice.harnessVersion === void 0 ? {} : { harnessVersion: serverDevice.harnessVersion }
       };
     } catch (error) {
       this.clearConnectionProgress(progressRunId);
@@ -19468,7 +19654,7 @@ function record3(value) {
   }
   return value;
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function ok2(value) {
@@ -19493,11 +19679,11 @@ async function readRemoteWorkspaceBaseline(gateway, signal) {
   const iterator = source[Symbol.asyncIterator]();
   try {
     const first = await iterator.next();
-    if (first.done || !isRecord5(first.value) || first.value.type !== "baseline" || !isRecord5(first.value.value) || !Array.isArray(first.value.value.items)) {
+    if (first.done || !isRecord6(first.value) || first.value.type !== "baseline" || !isRecord6(first.value.value) || !Array.isArray(first.value.value.items)) {
       throw new ClientModeError("INVALID_MESSAGE", "The remote Host returned an invalid Workspace baseline.");
     }
     return first.value.value.items.map((item) => {
-      if (!isRecord5(item) || typeof item.workspaceId !== "string" || typeof item.path !== "string" || typeof item.title !== "string") {
+      if (!isRecord6(item) || typeof item.workspaceId !== "string" || typeof item.path !== "string" || typeof item.title !== "string") {
         throw new ClientModeError("INVALID_MESSAGE", "The remote Host returned an invalid Workspace row.");
       }
       return { workspaceId: item.workspaceId, path: item.path, title: item.title };
@@ -19562,12 +19748,18 @@ async function probeRemoteHostFeatures(client, clientVersion) {
     if (error instanceof Error && "code" in error && error.code === "METHOD_NOT_FOUND") return fallback;
     throw error;
   }
-  if (!isRecord5(value) || !Array.isArray(value.capabilities) || value.capabilities.some((capability) => typeof capability !== "string")) {
+  if (!isRecord6(value) || !Array.isArray(value.capabilities) || value.capabilities.some((capability) => typeof capability !== "string")) {
     throw new ClientModeError("INVALID_MESSAGE", "The remote Host returned invalid transport capabilities.");
   }
   const capabilities = new Set(value.capabilities);
   const apiProxy = capabilities.has("harness.api.v1");
-  const remoteGateway = capabilities.has("harness.remote.v1");
+  const remoteV1 = capabilities.has("harness.remote.v1");
+  const remoteV3 = capabilities.has("harness.remote.v3");
+  if (remoteV1 && remoteV3) {
+    throw new ClientModeError("INVALID_MESSAGE", "The remote Host advertised conflicting Harness Session formats.");
+  }
+  const sessionFormat = remoteV3 ? 3 : void 0;
+  const remoteGateway = remoteV3 || remoteV1;
   if (!apiProxy && !remoteGateway) {
     throw new ClientModeError("FEATURE_NOT_SUPPORTED", "The remote Host exposes no supported Harness transport.");
   }
@@ -19576,6 +19768,7 @@ async function probeRemoteHostFeatures(client, clientVersion) {
     fileViewer: capabilities.has("fileviewer.read.v1"),
     apiProxy,
     remoteGateway,
+    ...sessionFormat === void 0 ? {} : { sessionFormat },
     codex: capabilities.has("codex.appserver.v1")
   };
 }
@@ -19642,9 +19835,9 @@ import { hostname as hostname2 } from "node:os";
 
 // src/identity-store.ts
 import { createHash } from "node:crypto";
-import { chmod, mkdir, readFile, rename, rm, stat, writeFile } from "node:fs/promises";
+import { chmod, mkdir, readFile as readFile2, rename, rm, stat, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { dirname as dirname2, join as join2 } from "node:path";
+import { dirname as dirname3, join as join3 } from "node:path";
 var identitySchema = external_exports.object({
   schemaVersion: external_exports.literal(1),
   deviceId: external_exports.string().uuid(),
@@ -19673,14 +19866,14 @@ var IdentityStore = class {
   peers = /* @__PURE__ */ new Map();
   constructor(options = {}) {
     const env = options.env ?? process.env;
-    const dshHome = env.DSH_HOME || join2(options.homeDirectory ?? homedir(), ".dsh");
-    this.directory = options.directory ?? join2(dshHome, "remote");
+    const dshHome = env.DSH_HOME || join3(options.homeDirectory ?? homedir(), ".dsh");
+    this.directory = options.directory ?? join3(dshHome, "remote");
   }
   async loadOrCreate(deviceName) {
     await mkdir(this.directory, { recursive: true, mode: 448 });
     await chmod(this.directory, 448);
-    const devicePath = join2(this.directory, "device.json");
-    const keyPath = join2(this.directory, "device.key");
+    const devicePath = join3(this.directory, "device.json");
+    const keyPath = join3(this.directory, "device.key");
     const [hasDevice, hasKey] = await Promise.all([exists(devicePath), exists(keyPath)]);
     if (hasDevice !== hasKey) {
       throw new IdentityInvalidError("device identity is incomplete; repair it explicitly before reconnecting");
@@ -19694,8 +19887,8 @@ var IdentityStore = class {
     }
     await assertPrivateMode(keyPath);
     try {
-      let record6 = identitySchema.parse(JSON.parse(await readFile(devicePath, "utf8")));
-      const privateKey = (await readFile(keyPath, "utf8")).trim();
+      let record6 = identitySchema.parse(JSON.parse(await readFile2(devicePath, "utf8")));
+      const privateKey = (await readFile2(keyPath, "utf8")).trim();
       const regenerated = generateKeyPair(fromBase64Url2(privateKey));
       if (regenerated.publicKey !== record6.publicKey) {
         throw new IdentityInvalidError("device public and private keys do not match");
@@ -19749,11 +19942,11 @@ var IdentityStore = class {
     return removed;
   }
   async loadPeers() {
-    const path = join2(this.directory, "trusted-peers.json");
+    const path = join3(this.directory, "trusted-peers.json");
     if (!await exists(path)) {
       await atomicJsonWrite(path, { schemaVersion: 1, peers: [] }, 384);
     }
-    const parsed = trustedPeersSchema.parse(JSON.parse(await readFile(path, "utf8")));
+    const parsed = trustedPeersSchema.parse(JSON.parse(await readFile2(path, "utf8")));
     const peers = /* @__PURE__ */ new Map();
     for (const peer of parsed.peers) {
       if (peer.fingerprint !== fingerprint(peer.publicKey)) {
@@ -19765,7 +19958,7 @@ var IdentityStore = class {
     this.peers = peers;
   }
   async savePeers() {
-    await atomicJsonWrite(join2(this.directory, "trusted-peers.json"), {
+    await atomicJsonWrite(join3(this.directory, "trusted-peers.json"), {
       schemaVersion: 1,
       peers: [...this.peers.values()]
     }, 384);
@@ -19774,7 +19967,7 @@ var IdentityStore = class {
 function serverStorageDirectory(root, serverUrl, role) {
   const origin = new URL(serverUrl).origin;
   const scope = createHash("sha256").update(origin).digest("hex").slice(0, 24);
-  return join2(root, "servers", scope, role);
+  return join3(root, "servers", scope, role);
 }
 function fingerprint(publicKey) {
   const compact = createHash("sha256").update(fromBase64Url2(publicKey)).digest("hex").slice(0, 12).toUpperCase();
@@ -19792,7 +19985,7 @@ async function atomicJsonWrite(path, value, mode) {
 `, mode);
 }
 async function atomicTextWrite(path, value, mode) {
-  await mkdir(dirname2(path), { recursive: true, mode: 448 });
+  await mkdir(dirname3(path), { recursive: true, mode: 448 });
   const temporary = `${path}.${process.pid}.${uuidV7()}.tmp`;
   await writeFile(temporary, value, { encoding: "utf8", mode, flag: "wx" });
   await chmod(temporary, mode);
@@ -19816,8 +20009,8 @@ function safeErrorMessage(error) {
 }
 
 // src/server-credentials.ts
-import { chmod as chmod2, mkdir as mkdir2, readFile as readFile2, rename as rename2, rm as rm2, stat as stat2, writeFile as writeFile2 } from "node:fs/promises";
-import { dirname as dirname3, join as join3 } from "node:path";
+import { chmod as chmod2, mkdir as mkdir2, readFile as readFile3, rename as rename2, rm as rm2, stat as stat2, writeFile as writeFile2 } from "node:fs/promises";
+import { dirname as dirname4, join as join4 } from "node:path";
 var credentialSchema = external_exports.object({
   schemaVersion: external_exports.literal(1),
   serverUrl: external_exports.string().url(),
@@ -19832,14 +20025,14 @@ var credentialSchema = external_exports.object({
 var ServerCredentialStore = class {
   path;
   constructor(directory) {
-    this.path = join3(directory, "server-credentials.json");
+    this.path = join4(directory, "server-credentials.json");
   }
   async load(serverUrl, deviceId) {
     if (!await exists2(this.path)) return void 0;
     await assertPrivateMode2(this.path);
     let parsed;
     try {
-      parsed = credentialSchema.parse(JSON.parse(await readFile2(this.path, "utf8")));
+      parsed = credentialSchema.parse(JSON.parse(await readFile3(this.path, "utf8")));
     } catch (error) {
       throw new ServerCredentialsInvalidError(`server credentials are invalid: ${safeMessage(error)}`);
     }
@@ -19859,7 +20052,7 @@ var ServerCredentialsInvalidError = class extends Error {
   code = "SERVER_CREDENTIALS_INVALID";
 };
 async function atomicWrite(path, contents) {
-  await mkdir2(dirname3(path), { recursive: true, mode: 448 });
+  await mkdir2(dirname4(path), { recursive: true, mode: 448 });
   const temporary = `${path}.${process.pid}.${uuidV7()}.tmp`;
   await writeFile2(temporary, contents, { encoding: "utf8", mode: 384, flag: "wx" });
   await chmod2(temporary, 384);
@@ -20110,11 +20303,11 @@ function editableConfig(config) {
     }
   };
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function record4(value) {
-  if (!isRecord6(value)) throw new ClientModeError("INVALID_MESSAGE", "The control request payload is invalid.");
+  if (!isRecord7(value)) throw new ClientModeError("INVALID_MESSAGE", "The control request payload is invalid.");
   return value;
 }
 function ok3(value) {
@@ -20337,36 +20530,6 @@ function shortId2(value) {
   return value.length <= 12 ? value : `${value.slice(0, 8)}\u2026${value.slice(-4)}`;
 }
 
-// src/harness-version.ts
-import { readFile as readFile3 } from "node:fs/promises";
-import { dirname as dirname4, isAbsolute, join as join4 } from "node:path";
-var LEGACY_PLACEHOLDER_VERSION = "0.0.1";
-function normalizeHarnessVersion(value) {
-  if (typeof value !== "string") return void 0;
-  const version = value.trim();
-  if (version.length === 0 || version.length > 64 || /[\u0000-\u001f]/u.test(version)) return void 0;
-  return version;
-}
-function selectHarnessVersion(reportedVersion, distributionVersion) {
-  if (reportedVersion !== void 0 && reportedVersion !== LEGACY_PLACEHOLDER_VERSION) return reportedVersion;
-  return distributionVersion;
-}
-async function readHarnessDistributionVersion(entrypoint = process.argv[1]) {
-  if (entrypoint === void 0 || !isAbsolute(entrypoint)) return void 0;
-  let directory = dirname4(entrypoint);
-  for (let depth = 0; depth < 8; depth += 1) {
-    try {
-      const manifest = JSON.parse(await readFile3(join4(directory, "package.json"), "utf8"));
-      if (manifest.name === "@deepseek-ai/dsh") return normalizeHarnessVersion(manifest.version);
-    } catch {
-    }
-    const parent = dirname4(directory);
-    if (parent === directory) break;
-    directory = parent;
-  }
-  return void 0;
-}
-
 // src/safe-error.ts
 var RpcError = class extends Error {
   constructor(code, message, details, retryable = false) {
@@ -22721,13 +22884,13 @@ function needsDirectoryFallback(result) {
 }
 function requestArgs(payload) {
   const root = record5(payload);
-  const args = isRecord7(root.args) ? root.args : root;
+  const args = isRecord8(root.args) ? root.args : root;
   return record5(args.request ?? args._request ?? args);
 }
 function record5(value) {
-  return isRecord7(value) ? value : {};
+  return isRecord8(value) ? value : {};
 }
-function isRecord7(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -22921,7 +23084,7 @@ var CodexAppServerClient = class {
       this.handleProcessFailure("CODEX_INVALID_RESPONSE", new Error("Codex App Server emitted invalid JSON."));
       return;
     }
-    if (!isRecord8(value)) {
+    if (!isRecord9(value)) {
       this.handleProcessFailure("CODEX_INVALID_RESPONSE", new Error("Codex App Server emitted an invalid message."));
       return;
     }
@@ -22966,12 +23129,12 @@ var CodexAppServerClient = class {
   }
 };
 function safeUpstreamError(value) {
-  if (!isRecord8(value) || typeof value.message !== "string") return "Codex App Server rejected the request.";
+  if (!isRecord9(value) || typeof value.message !== "string") return "Codex App Server rejected the request.";
   const message = value.message.toLowerCase();
   if (message.includes("active writer")) return "Codex thread already has an active writer.";
   return message.includes("not initialized") ? "Codex App Server is not initialized." : "Codex App Server rejected the request.";
 }
-function isRecord8(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -23341,15 +23504,15 @@ function decodeCanonicalBase643(value) {
   }
   return decoded;
 }
-function isRecord9(value) {
+function isRecord10(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function safeErrorCode2(error) {
-  if (isRecord9(error) && typeof error.code === "string") return error.code;
+  if (isRecord10(error) && typeof error.code === "string") return error.code;
   return "UNKNOWN";
 }
 function safeMethod(input2) {
-  return isRecord9(input2) && typeof input2.method === "string" ? input2.method : "invalid";
+  return isRecord10(input2) && typeof input2.method === "string" ? input2.method : "invalid";
 }
 function concatChunks3(chunks, totalBytes) {
   const output = new Uint8Array(totalBytes);
@@ -23766,14 +23929,14 @@ var CodexRemoteDomain = class {
       await this.assertResultThreadAllowed(result);
       if (codexPermissionPresetFromResponse(result) !== params.permissionPreset) {
         await this.callUpstream("thread/settings/update", { threadId, ...settings });
-        result = { ...isRecord10(result) ? result : {}, ...settings, sandbox: settings.sandboxPolicy };
+        result = { ...isRecord11(result) ? result : {}, ...settings, sandbox: settings.sandboxPolicy };
       }
     }
     await this.publishPermission(threadId, result);
     return result;
   }
   async publishPermission(threadId, value) {
-    const source = isRecord10(value) ? value : {};
+    const source = isRecord11(value) ? value : {};
     const threadSettings = { approvalPolicy: source.approvalPolicy, sandboxPolicy: source.sandboxPolicy ?? source.sandbox };
     await this.handleInbound({ kind: "notification", method: "thread/settings/updated", params: { threadId, threadSettings } });
   }
@@ -23869,9 +24032,9 @@ var CodexRemoteDomain = class {
         itemsView,
         ...cursor2 === void 0 ? {} : { cursor: cursor2 }
       });
-      const pageResult = isRecord10(result) ? result : {};
+      const pageResult = isRecord11(result) ? result : {};
       for (const rawTurn of array2(pageResult.data)) {
-        if (!isRecord10(rawTurn)) continue;
+        if (!isRecord11(rawTurn)) continue;
         const turnId = typeof rawTurn.id === "string" ? rawTurn.id : void 0;
         const items = rawTurn.itemsView === "full" || turnId === void 0 ? array2(rawTurn.items) : await this.readThreadItems(connectionId, threadId, turnId, array2(rawTurn.items));
         turns.push({ ...rawTurn, items });
@@ -23893,9 +24056,9 @@ var CodexRemoteDomain = class {
           sortDirection: "asc",
           ...cursor2 === void 0 ? {} : { cursor: cursor2 }
         });
-        const pageResult = isRecord10(result) ? result : {};
+        const pageResult = isRecord11(result) ? result : {};
         for (const entry of array2(pageResult.data)) {
-          if (isRecord10(entry) && entry.item !== void 0) items.push(entry.item);
+          if (isRecord11(entry) && entry.item !== void 0) items.push(entry.item);
         }
         cursor2 = typeof pageResult.nextCursor === "string" && pageResult.nextCursor.length > 0 ? pageResult.nextCursor : void 0;
         if (cursor2 === void 0) break;
@@ -23959,7 +24122,7 @@ var CodexRemoteDomain = class {
     return [...this.peers.values()].some((peer) => peer.hasThreadSubscription(threadId));
   }
   resolveUpstreamApproval(params) {
-    if (!isRecord10(params) || typeof params.requestId !== "string" && typeof params.requestId !== "number") return;
+    if (!isRecord11(params) || typeof params.requestId !== "string" && typeof params.requestId !== "number") return;
     for (const [handle, approval] of this.approvals) {
       if (approval.upstreamId === params.requestId) this.approvals.delete(handle);
     }
@@ -24176,24 +24339,24 @@ function codexBinaryCandidates(configured, hostPlatform = process.platform, user
   ])];
 }
 function parseCallEnvelope(input2) {
-  if (!isRecord10(input2) || typeof input2.method !== "string" || !("params" in input2) || Object.keys(input2).some((key) => key !== "method" && key !== "params")) {
+  if (!isRecord11(input2) || typeof input2.method !== "string" || !("params" in input2) || Object.keys(input2).some((key) => key !== "method" && key !== "params")) {
     throw new RpcError("INVALID_MESSAGE", "The Codex call envelope is invalid.");
   }
   return { method: input2.method, params: input2.params };
 }
 function parseRespond(input2) {
-  if (!isRecord10(input2) || typeof input2.requestHandle !== "string" || !["accept", "decline", "cancel"].includes(String(input2.decision)) || Object.keys(input2).some((key) => key !== "requestHandle" && key !== "decision")) {
+  if (!isRecord11(input2) || typeof input2.requestHandle !== "string" || !["accept", "decline", "cancel"].includes(String(input2.decision)) || Object.keys(input2).some((key) => key !== "requestHandle" && key !== "decision")) {
     throw new RpcError("INVALID_MESSAGE", "The Codex approval response is invalid.");
   }
   return input2;
 }
 function accountCanRun(result) {
-  if (!isRecord10(result) || typeof result.requiresOpenaiAuth !== "boolean") return false;
-  return result.requiresOpenaiAuth === false || isRecord10(result.account);
+  if (!isRecord11(result) || typeof result.requiresOpenaiAuth !== "boolean") return false;
+  return result.requiresOpenaiAuth === false || isRecord11(result.account);
 }
 function sanitizeAccount(result) {
-  if (!isRecord10(result)) throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned invalid account state.");
-  const account = isRecord10(result.account) ? result.account : void 0;
+  if (!isRecord11(result)) throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned invalid account state.");
+  const account = isRecord11(result.account) ? result.account : void 0;
   return {
     authenticated: account !== void 0 || result.requiresOpenaiAuth === false,
     requiresOpenaiAuth: result.requiresOpenaiAuth === true,
@@ -24206,11 +24369,11 @@ function sanitizeAccount(result) {
   };
 }
 function sanitizeThreadList(result) {
-  if (!isRecord10(result) || !Array.isArray(result.data)) {
+  if (!isRecord11(result) || !Array.isArray(result.data)) {
     throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned an invalid thread list.");
   }
   const data = result.data.flatMap((value) => {
-    if (!isRecord10(value) || typeof value.id !== "string") return [];
+    if (!isRecord11(value) || typeof value.id !== "string") return [];
     return [{
       id: value.id,
       ...typeof value.sessionId === "string" ? { sessionId: value.sessionId } : {},
@@ -24222,7 +24385,7 @@ function sanitizeThreadList(result) {
       ...typeof value.updatedAt === "number" && Number.isFinite(value.updatedAt) ? { updatedAt: value.updatedAt } : {},
       ...typeof value.archived === "boolean" ? { archived: value.archived } : {},
       ...typeof value.isPinned === "boolean" ? { isPinned: value.isPinned } : {},
-      ...isRecord10(value.status) ? { status: value.status } : {}
+      ...isRecord11(value.status) ? { status: value.status } : {}
     }];
   });
   return {
@@ -24232,18 +24395,18 @@ function sanitizeThreadList(result) {
   };
 }
 function filterThreadListByWorkspaceAuthority(result, authority) {
-  if (!isRecord10(result) || !Array.isArray(result.data)) {
+  if (!isRecord11(result) || !Array.isArray(result.data)) {
     throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned an invalid thread list.");
   }
   return {
     ...result,
-    data: result.data.map((record6) => isRecord10(record6) ? record6 : void 0).filter((thread) => thread !== void 0 && isThreadAllowedByWorkspaceAuthority(thread, authority))
+    data: result.data.map((record6) => isRecord11(record6) ? record6 : void 0).filter((thread) => thread !== void 0 && isThreadAllowedByWorkspaceAuthority(thread, authority))
   };
 }
 function sanitizeProject(value) {
-  if (!isRecord10(value) || typeof value.id !== "string" || typeof value.name !== "string") return void 0;
+  if (!isRecord11(value) || typeof value.id !== "string" || typeof value.name !== "string") return void 0;
   const roots = Array.isArray(value.roots) ? value.roots.flatMap((root) => {
-    const path = isRecord10(root) && typeof root.path === "string" && root.path.length > 0 ? root.path : void 0;
+    const path = isRecord11(root) && typeof root.path === "string" && root.path.length > 0 ? root.path : void 0;
     return path === void 0 || !isAbsolute3(path) ? [] : [{ path }];
   }) : [];
   if (roots.length === 0) return void 0;
@@ -24257,7 +24420,7 @@ function sanitizeProject(value) {
   };
 }
 function sanitizeProjectList(result) {
-  if (!isRecord10(result) || !Array.isArray(result.data)) {
+  if (!isRecord11(result) || !Array.isArray(result.data)) {
     throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned an invalid project list.");
   }
   const data = result.data.flatMap((value) => sanitizeProject(value) ?? []);
@@ -24267,7 +24430,7 @@ function sanitizeProjectList(result) {
   };
 }
 function sanitizeProjectCreate(result) {
-  const project = isRecord10(result) ? sanitizeProject(result.project) : void 0;
+  const project = isRecord11(result) ? sanitizeProject(result.project) : void 0;
   if (project === void 0) {
     throw new RpcError("CODEX_INVALID_RESPONSE", "Codex App Server returned an invalid created project.");
   }
@@ -24299,19 +24462,19 @@ function codexDirectoryCrumbs(root, path) {
   return crumbs2;
 }
 function extractThread(result) {
-  return isRecord10(result) && isRecord10(result.thread) ? result.thread : void 0;
+  return isRecord11(result) && isRecord11(result.thread) ? result.thread : void 0;
 }
 function extractTurnId(result) {
-  if (!isRecord10(result)) return void 0;
+  if (!isRecord11(result)) return void 0;
   if (typeof result.turnId === "string" && result.turnId.length > 0) return result.turnId;
-  if (isRecord10(result.turn) && typeof result.turn.id === "string" && result.turn.id.length > 0) return result.turn.id;
+  if (isRecord11(result.turn) && typeof result.turn.id === "string" && result.turn.id.length > 0) return result.turn.id;
   return void 0;
 }
 function extractThreadId(params) {
-  if (!isRecord10(params)) return void 0;
+  if (!isRecord11(params)) return void 0;
   if (typeof params.threadId === "string") return params.threadId;
-  if (isRecord10(params.thread) && typeof params.thread.id === "string") return params.thread.id;
-  if (isRecord10(params.turn) && typeof params.turn.threadId === "string") return params.turn.threadId;
+  if (isRecord11(params.thread) && typeof params.thread.id === "string") return params.thread.id;
+  if (isRecord11(params.turn) && typeof params.turn.threadId === "string") return params.turn.threadId;
   return void 0;
 }
 function optionalInteger2(value) {
@@ -24353,13 +24516,13 @@ function mapCodexImageInputs(params) {
   return {
     ...params,
     input: params.input.map((value) => {
-      if (!isRecord10(value) || value.type !== "image" || typeof value.mediaType !== "string" || typeof value.data !== "string") return value;
+      if (!isRecord11(value) || value.type !== "image" || typeof value.mediaType !== "string" || typeof value.data !== "string") return value;
       return { type: "image", url: `data:${value.mediaType};base64,${value.data}` };
     })
   };
 }
 function sanitizeApprovalParams(params, requestHandle) {
-  if (!isRecord10(params)) return { requestHandle };
+  if (!isRecord11(params)) return { requestHandle };
   const safe = { ...params };
   delete safe.proposedExecpolicyAmendment;
   delete safe.additionalPermissions;
@@ -24390,7 +24553,7 @@ function isProjectListFallbackError(error) {
 function canTryNextBinary(error) {
   return !(error instanceof RpcError) || !["CODEX_AUTH_REQUIRED", "CODEX_CLOSED"].includes(error.code);
 }
-function isRecord10(value) {
+function isRecord11(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function array2(value) {
@@ -24498,6 +24661,9 @@ var HostPluginRuntime = class {
       accountRequired: error === "ACCOUNT_AUTH_REQUIRED" || error === "AUTH_INVALID" || error === "TOKEN_EXPIRED"
     };
   }
+  localHarnessVersion() {
+    return this.harnessVersion;
+  }
   reconnectHost() {
     if (this.closed) throw new Error("remote runtime is closed");
     if (this.serverConnection === void 0) {
@@ -24667,9 +24833,13 @@ var HostPluginRuntime = class {
   }
   hostCapabilities() {
     const capabilities = [];
-    if (this.apiProxy !== void 0) capabilities.push("harness.api.v1", "harness.api.transfer.v1");
     if (this.localGateway?.supportsCarrier === true) {
-      capabilities.push("harness.remote.v1", "harness.remote.transfer.v1");
+      capabilities.push(
+        harnessSessionGeneration(this.harnessVersion) === "v3" ? "harness.remote.v3" : "harness.remote.v1",
+        "harness.remote.transfer.v1"
+      );
+    } else if (this.apiProxy !== void 0) {
+      capabilities.push("harness.api.v1", "harness.api.transfer.v1");
     }
     if (this.fileViewerHost?.() !== void 0) capabilities.push("fileviewer.read.v1");
     if (this.codex.isAvailable()) capabilities.push("codex.appserver.v1", "codex.appserver.transfer.v1");