@gatherthread/dsh-host 0.1.0-alpha.4 → 0.1.0-alpha.6

package/dist/bundle/plugin.js

@@ -432,7 +432,7 @@ var HttpCollaborationClient = class {
   async registerRuntime(runtime) {
     const body = requiredObject2(await this.#request("/runtimes", {
       method: "POST",
-      body: JSON.stringify(toSnakeCase(runtime))
+      body: JSON.stringify(toWireRuntimeRegistration(runtime))
     }));
     return fromWireRuntime(body.runtime ?? body);
   }
@@ -448,12 +448,19 @@ var HttpCollaborationClient = class {
       method: "POST",
       body: JSON.stringify({ runtime_id: runtimeId })
     }));
-    const status = body.status === "completed" ? "completed" : "claimed";
+    if (body.status !== "claimed" && body.status !== "completed") {
+      throw new Error("Collaboration API omitted claim.status");
+    }
+    const attemptCount = body.attempt_count === void 0 ? 1 : requiredNumber(body.attempt_count, "claim.attempt_count");
+    if (attemptCount < 1)
+      throw new Error("Collaboration API omitted claim.attempt_count");
+    const status = body.status;
     return {
       claimed: status === "claimed",
       status,
       requestId: requiredString2(body.request_event_id, "claim.request_event_id"),
-      runtimeId: requiredString2(body.runtime_id, "claim.runtime_id")
+      runtimeId: requiredString2(body.runtime_id, "claim.runtime_id"),
+      attemptCount
     };
   }
   async completeAgentRequest(sessionId, requestId, input) {
@@ -461,6 +468,7 @@ var HttpCollaborationClient = class {
       method: "POST",
       body: JSON.stringify({
         runtime_id: input.runtimeId,
+        ...input.claimAttempt === void 0 ? {} : { claim_attempt: input.claimAttempt },
         idempotency_key: input.idempotencyKey,
         payload: truncateJsonValue(input.payload, 160 * 1024),
         ...input.observedModel === void 0 ? {} : { observed_model: input.observedModel },
@@ -474,6 +482,7 @@ var HttpCollaborationClient = class {
       method: "POST",
       body: JSON.stringify({
         runtime_id: input.runtimeId,
+        ...input.claimAttempt === void 0 ? {} : { claim_attempt: input.claimAttempt },
         idempotency_key: input.idempotencyKey,
         payload: truncateJsonValue(input.payload, 32 * 1024),
         ...input.observedModel === void 0 ? {} : { observed_model: input.observedModel },
@@ -512,10 +521,10 @@ var HttpCollaborationClient = class {
     const body = requiredObject2(await this.#request(`/snapshot-requests/${encodeURIComponent(requestId)}`));
     return fromWireSnapshotRequest(body.snapshot_request ?? body);
   }
-  async createSnapshotRequest(sessionId, kind = "immutable") {
+  async createSnapshotRequest(sessionId, kind = "immutable", targetRuntimeId) {
     const body = requiredObject2(await this.#request(`/sessions/${encodeURIComponent(sessionId)}/snapshot-requests`, {
       method: "POST",
-      body: JSON.stringify({ kind })
+      body: JSON.stringify({ kind, ...targetRuntimeId === void 0 ? {} : { target_runtime_id: targetRuntimeId } })
     }));
     return fromWireSnapshotRequest(body.snapshot_request ?? body);
   }
@@ -595,15 +604,34 @@ function toWireEvent(event) {
     reply_to_event_id: event.replyTo,
     visibility: event.visibility ?? "session",
     runtime_id: event.runtimeId ?? event.runtime?.runtimeId,
+    claim_attempt: event.claimAttempt,
     observed_model: event.observedModel,
     observed_reasoning_effort: event.observedReasoningEffort
   };
 }
-function toSnakeCase(value) {
-  return Object.fromEntries(Object.entries(value).map(([key, item]) => [
-    key.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`),
-    item
-  ]));
+function toWireRuntimeRegistration(runtime) {
+  return {
+    ...runtime.runtimeId === void 0 ? {} : { runtime_id: runtime.runtimeId },
+    session_id: runtime.sessionId,
+    device_id: runtime.deviceId,
+    harness: runtime.harness,
+    provider: runtime.provider,
+    model: runtime.model,
+    ...runtime.executionProfiles === void 0 ? {} : {
+      execution_profiles: runtime.executionProfiles.map((profile) => ({
+        provider: profile.provider,
+        model: profile.model,
+        ...profile.reasoningEfforts === void 0 ? {} : { reasoning_efforts: [...profile.reasoningEfforts] },
+        ...profile.defaultReasoningEffort === void 0 ? {} : {
+          default_reasoning_effort: profile.defaultReasoningEffort
+        }
+      }))
+    },
+    local_session_id: runtime.localSessionId,
+    capture_fidelity: runtime.captureFidelity,
+    ...runtime.capabilities === void 0 ? {} : { capabilities: [...runtime.capabilities] },
+    ...runtime.purpose === void 0 ? {} : { purpose: runtime.purpose }
+  };
 }
 function fromWireEvent(value) {
   const input = requiredObject2(value);
@@ -633,10 +661,22 @@ function fromWireSnapshotRequest(value) {
     message: requiredString2(failureInput.message, "snapshot_request.failure.message")
   } : void 0;
   const createdAt = optionalWireString(input.created_at) ?? optionalWireString(input.requested_at);
+  const kind = requiredString2(input.kind, "snapshot_request.kind");
+  if (![
+    "immutable",
+    "visible_history_replace",
+    "local_sync_status",
+    "local_auto_upload_enable",
+    "local_auto_upload_disable",
+    "local_turn_upload"
+  ].includes(kind)) {
+    throw new Error("Collaboration API returned an invalid snapshot request kind");
+  }
   return {
     id: requiredString2(input.id, "snapshot_request.id"),
     sessionId: requiredString2(input.session_id, "snapshot_request.session_id"),
-    kind: input.kind === "visible_history_replace" ? "visible_history_replace" : "immutable",
+    kind,
+    ...typeof input.target_runtime_id === "string" ? { targetRuntimeId: input.target_runtime_id } : {},
     throughSequence: requiredNumber(input.through_sequence, "snapshot_request.through_sequence"),
     status,
     ...createdAt === void 0 ? {} : { createdAt },
@@ -701,11 +741,61 @@ function fromWireRuntime(value) {
     harness: requiredString2(input.harness, "runtime.harness"),
     provider: requiredString2(input.provider, "runtime.provider"),
     model: requiredString2(input.model, "runtime.model"),
+    ...input.execution_profiles === void 0 || input.execution_profiles === null ? {} : { executionProfiles: fromWireExecutionProfiles(input.execution_profiles) },
     localSessionId: requiredString2(input.local_session_id, "runtime.local_session_id"),
     captureFidelity: requiredString2(input.capture_fidelity, "runtime.capture_fidelity"),
     purpose
   };
 }
+function fromWireExecutionProfiles(value) {
+  if (!Array.isArray(value) || value.length < 1 || value.length > 32) {
+    throw new Error("Collaboration API returned invalid runtime.execution_profiles");
+  }
+  const routes = /* @__PURE__ */ new Set();
+  return value.map((entry, index) => {
+    const profile = requiredObject2(entry);
+    const allowedKeys = /* @__PURE__ */ new Set(["provider", "model", "reasoning_efforts", "default_reasoning_effort"]);
+    if (Object.keys(profile).some((key) => !allowedKeys.has(key))) {
+      throw new Error(`Collaboration API returned invalid runtime.execution_profiles[${index}]`);
+    }
+    const provider = requiredExecutionProfileString(profile.provider, `runtime.execution_profiles[${index}].provider`, 80);
+    const model = requiredExecutionProfileString(profile.model, `runtime.execution_profiles[${index}].model`, 160);
+    const route = `${provider}\0${model}`;
+    if (routes.has(route))
+      throw new Error("Collaboration API returned duplicate runtime.execution_profiles");
+    routes.add(route);
+    const rawEfforts = profile.reasoning_efforts;
+    let reasoningEfforts;
+    if (rawEfforts !== void 0) {
+      if (!Array.isArray(rawEfforts) || rawEfforts.length < 1 || rawEfforts.length > 16) {
+        throw new Error(`Collaboration API returned invalid runtime.execution_profiles[${index}].reasoning_efforts`);
+      }
+      reasoningEfforts = rawEfforts.map((effort, effortIndex) => requiredExecutionProfileString(effort, `runtime.execution_profiles[${index}].reasoning_efforts[${effortIndex}]`, 80));
+      if (new Set(reasoningEfforts).size !== reasoningEfforts.length) {
+        throw new Error(`Collaboration API returned duplicate runtime.execution_profiles[${index}].reasoning_efforts`);
+      }
+    }
+    const defaultReasoningEffort = profile.default_reasoning_effort === void 0 ? void 0 : requiredExecutionProfileString(profile.default_reasoning_effort, `runtime.execution_profiles[${index}].default_reasoning_effort`, 80);
+    if (defaultReasoningEffort !== void 0 && !reasoningEfforts?.includes(defaultReasoningEffort)) {
+      throw new Error(`Collaboration API returned an unadvertised runtime.execution_profiles[${index}].default_reasoning_effort`);
+    }
+    return {
+      provider,
+      model,
+      ...reasoningEfforts === void 0 ? {} : { reasoningEfforts },
+      ...defaultReasoningEffort === void 0 ? {} : { defaultReasoningEffort }
+    };
+  });
+}
+function requiredExecutionProfileString(value, field, maxLength) {
+  if (typeof value !== "string")
+    throw new Error(`Collaboration API omitted ${field}`);
+  const normalized = value.trim();
+  if (!normalized || normalized.length > maxLength || /[\u0000-\u001f\u007f-\u009f]/u.test(normalized)) {
+    throw new Error(`Collaboration API returned invalid ${field}`);
+  }
+  return normalized;
+}
 function fromWireProvenance(value) {
   const input = requiredObject2(value);
   return {
@@ -964,7 +1054,7 @@ function isTerminalClaimConflict(error) {
   if (!error || typeof error !== "object")
     return false;
   const candidate = error;
-  return candidate.status === 409 && (candidate.code === "agent_request_already_claimed" || candidate.code === "agent_request_already_completed");
+  return candidate.status === 409 && (candidate.code === "agent_request_already_claimed" || candidate.code === "agent_request_already_completed" || candidate.code === "agent_request_failed");
 }
 
 // dist/src/connector.js
@@ -991,11 +1081,16 @@ function requestedDshProfile(event) {
   if (profile.provider !== void 0 && !provider) {
     throw new Error("DeepSeek Harness Agent request has an invalid provider target");
   }
+  const reasoningEffort = profile.reasoning_effort === void 0 ? void 0 : safeProfileText(profile.reasoning_effort, 80);
+  if (profile.reasoning_effort !== void 0 && !reasoningEffort) {
+    throw new Error("DeepSeek Harness Agent request has an invalid reasoning effort target");
+  }
   const runtimeId = profile.runtime_id === void 0 ? void 0 : safeRuntimeId(profile.runtime_id);
   return {
     harness,
     ...provider === void 0 ? {} : { provider },
     model,
+    ...reasoningEffort === void 0 ? {} : { reasoningEffort },
     ...runtimeId === void 0 ? {} : { runtimeId }
   };
 }
@@ -1292,6 +1387,7 @@ function asObject2(value) {
 }
 
 // dist/src/connector.js
+var LIVE_PROGRESS_MIN_INTERVAL_MS = 6e4;
 var DshHostConnector = class {
   #config;
   #api;
@@ -1312,11 +1408,15 @@ var DshHostConnector = class {
   #pollPromise;
   #localSyncControlPromise;
   #heartbeatPromise;
+  #liveProgressPromise = Promise.resolve();
+  #lastLiveProgressKey;
+  #lastLiveProgressAt = 0;
   #stopPromise;
   #backgroundFatalError;
   #lifecycleAbort = new AbortController();
   #listenerDisposers = [];
   #activeStatuses = [];
+  #activeExecutionSelection;
   #liveEventSequences = /* @__PURE__ */ new Set();
   #session;
   #visibleState = "connecting";
@@ -1395,6 +1495,14 @@ var DshHostConnector = class {
       const active = this.#state?.activeRequest;
       if (active !== void 0 && event.seq >= active.dshFromSequence) {
         this.#liveEventSequences.add(event.seq);
+        this.#queueLiveProgress(`dsh-live-${String(event.seq)}`, {
+          content: "DeepSeek Harness produced durable work for the active request.",
+          phase: "activity",
+          status: "running",
+          dsh_event_sequence: event.seq,
+          capture_fidelity: "harness_transcript",
+          source_harness: "deepseek-harness"
+        });
       }
       if (active === void 0 && event.type === "turn/end" && turnSettlement([event]) === "completed" && this.#automaticPolling) {
         queueMicrotask(() => {
@@ -1409,8 +1517,9 @@ var DshHostConnector = class {
     this.#listenerDisposers.push(this.#host.onStatus((status) => {
       if (this.#state?.activeRequest === void 0)
         return;
-      if (this.#activeStatuses.at(-1) !== status)
+      if (this.#activeStatuses.at(-1) !== status) {
         this.#activeStatuses.push(status);
+      }
       this.#notifyLifecycle(status);
     }));
     try {
@@ -1441,16 +1550,20 @@ var DshHostConnector = class {
           "canonical_history_projection",
           "bidirectional_local_turns"
         ],
+        ...this.#config.executionProfiles === void 0 ? {} : {
+          executionProfiles: cloneExecutionProfiles(this.#config.executionProfiles)
+        },
         purpose: "execution"
       });
       this.#assertRuntime(this.#runtime);
       this.#notifyLifecycle("idle");
       if (options.schedule !== false)
         this.#scheduleHeartbeat();
-      await this.#flushOutbox(this.#requireState().automaticUpload);
-      await this.#finalizeDeliveredRequest();
       if (this.#state.activeRequest !== void 0) {
         await this.#withExecutionPermit(() => this.#recoverActiveRequest());
+      } else {
+        await this.#flushOutbox(this.#requireState().automaticUpload);
+        await this.#finalizeDeliveredRequest();
       }
       if (options.runImmediately !== false)
         await this.pollOnce();
@@ -1537,12 +1650,12 @@ var DshHostConnector = class {
   }
   async #poll() {
     const state = this.#requireState();
-    await this.#flushOutbox(state.automaticUpload);
-    await this.#finalizeDeliveredRequest();
     if (state.activeRequest !== void 0) {
       await this.#withExecutionPermit(() => this.#recoverActiveRequest());
       return { scanned: 0, claimed: 0, completed: 1 };
     }
+    await this.#flushOutbox(state.automaticUpload);
+    await this.#finalizeDeliveredRequest();
     if (state.automaticUpload) {
       await this.#captureLocalTurns();
       await this.#flushOutbox(true);
@@ -1558,7 +1671,7 @@ var DshHostConnector = class {
         scanCursor = Math.max(scanCursor, event.sequence);
         scanned += 1;
         const profile = requestedDshProfile(event);
-        if (profile === void 0 || event.actorId !== this.#requireRuntime().userId || profile.runtimeId !== void 0 && profile.runtimeId !== this.#requireRuntime().id) {
+        if (profile === void 0 || event.actorId !== this.#requireRuntime().userId || !this.#profileTargetsThisRuntime(profile)) {
           passive.push(event);
           continue;
         }
@@ -1566,13 +1679,8 @@ var DshHostConnector = class {
         if (manualUploadRequired) {
           return { scanned, claimed: 0, completed: 0 };
         }
-        if (profile.provider !== void 0 && profile.provider !== this.#config.provider) {
-          throw new Error("DeepSeek Harness Agent request provider does not match the configured Host binding");
-        }
-        if (profile.model !== this.#config.model) {
-          throw new Error("DeepSeek Harness Agent request model does not match the configured Host binding");
-        }
-        const outcome = await this.#withExecutionPermit(() => this.#executeRequest(event));
+        const selection = this.#resolveExecutionSelection(profile);
+        const outcome = await this.#withExecutionPermit(() => this.#executeRequest(event, selection));
         return {
           scanned,
           claimed: outcome.claimed ? 1 : 0,
@@ -1590,7 +1698,7 @@ var DshHostConnector = class {
     }
     throw new Error("DSH connector stopped during event replay");
   }
-  async #executeRequest(request) {
+  async #executeRequest(request, selection) {
     if (this.#stopped)
       throw new Error("DSH connector stopped before claiming an Agent request");
     const state = this.#requireState();
@@ -1614,17 +1722,20 @@ var DshHostConnector = class {
       requestId: request.id,
       requestSequence: request.sequence,
       dshFromSequence: baseline,
-      promptDigest: digest(prompt)
+      promptDigest: digest(prompt),
+      claimAttempt: claim.attemptCount ?? 1
     };
     this.#activeStatuses = [];
+    this.#activeExecutionSelection = selection;
     this.#liveEventSequences.clear();
     await this.#stateStore.save(state);
-    const result = await this.#host.prompt(prompt);
+    const result = await this.#host.prompt(prompt, selection);
     if (result.fromSequence !== baseline || result.toSequence < result.fromSequence) {
       throw new Error("DSH Host prompt returned an inconsistent durable event range");
     }
+    await this.#liveProgressPromise;
     this.#assertLiveEventsDurable(result);
-    await this.#settleActiveRequest(result.events, result.toSequence);
+    await this.#settleActiveRequest(result.events, result.toSequence, selection);
     return { claimed: true, completed: true };
   }
   async #recoverActiveRequest() {
@@ -1634,6 +1745,46 @@ var DshHostConnector = class {
     const active = state.activeRequest;
     if (active === void 0)
       return;
+    let claim;
+    try {
+      claim = await this.#api.claimAgentRequest(this.#config.sessionId, active.requestId, this.#requireRuntime().id);
+    } catch (error) {
+      if (!isTerminalClaimConflict(error))
+        throw error;
+      state.outbox = state.outbox.filter((operation) => !outboxBelongsToRequest(operation, active.requestId));
+      if (active.dshToSequence !== void 0) {
+        state.publishedDshSequence = Math.max(state.publishedDshSequence, active.dshToSequence);
+      }
+      delete state.activeRequest;
+      this.#activeStatuses = [];
+      this.#activeExecutionSelection = void 0;
+      this.#liveEventSequences.clear();
+      await this.#stateStore.save(state);
+      return;
+    }
+    if (claim.status === "completed" && active.dshToSequence !== void 0) {
+      state.outbox = [];
+      await this.#stateStore.save(state);
+      await this.#finalizeDeliveredRequest();
+      return;
+    }
+    if (!claim.claimed) {
+      throw new Error("Active GatherThread request no longer has a recoverable claim");
+    }
+    const claimAttempt = claim.attemptCount ?? active.claimAttempt ?? 1;
+    active.claimAttempt = claimAttempt;
+    if (active.dshToSequence !== void 0) {
+      state.outbox = state.outbox.map((operation) => {
+        if ((operation.kind === "progress" || operation.kind === "complete") && operation.requestId === active.requestId) {
+          return { ...operation, input: { ...operation.input, claimAttempt } };
+        }
+        if (operation.kind === "append" && operation.input.replyTo === active.requestId) {
+          return { ...operation, input: { ...operation.input, claimAttempt } };
+        }
+        return operation;
+      });
+    }
+    await this.#stateStore.save(state);
     if (active.dshToSequence !== void 0) {
       await this.#flushOutbox();
       await this.#finalizeDeliveredRequest();
@@ -1645,6 +1796,15 @@ var DshHostConnector = class {
       throw new Error("Active GatherThread request is unavailable during DSH resume");
     }
     const prompt = buildDshRequestPrompt(request);
+    const profile = requestedDshProfile(request);
+    if (profile === void 0) {
+      throw new Error("Active GatherThread request lost its DeepSeek Harness execution profile");
+    }
+    if (!this.#profileTargetsThisRuntime(profile)) {
+      throw new Error("Active GatherThread request no longer targets this exact DSH runtime");
+    }
+    const selection = this.#resolveExecutionSelection(profile);
+    this.#activeExecutionSelection = selection;
     const legacyPrompt = buildDshCanonicalPrompt(history, request, this.#requireRuntime().id);
     if (digest(prompt) !== active.promptDigest && digest(legacyPrompt) !== active.promptDigest) {
       throw new Error("Active GatherThread request changed during DSH resume");
@@ -1652,7 +1812,7 @@ var DshHostConnector = class {
     const recovered = this.#host.snapshotFrom(active.dshFromSequence);
     const settlement = turnSettlement(recovered);
     if (settlement === "completed") {
-      await this.#settleActiveRequest(recovered, this.#host.currentSequence());
+      await this.#settleActiveRequest(recovered, this.#host.currentSequence(), selection);
       return;
     }
     if (settlement !== void 0 && settlement !== "interrupted") {
@@ -1670,14 +1830,15 @@ var DshHostConnector = class {
     this.#activeStatuses = [];
     this.#liveEventSequences.clear();
     await this.#stateStore.save(state);
-    const result = await this.#host.prompt(continuation);
+    const result = await this.#host.prompt(continuation, selection);
     if (result.fromSequence !== baseline || result.toSequence < result.fromSequence) {
       throw new Error("DSH Host recovery prompt returned an inconsistent durable event range");
     }
+    await this.#liveProgressPromise;
     this.#assertLiveEventsDurable(result);
-    await this.#settleActiveRequest(result.events, result.toSequence);
+    await this.#settleActiveRequest(result.events, result.toSequence, selection);
   }
-  async #settleActiveRequest(durableEvents, toSequence) {
+  async #settleActiveRequest(durableEvents, toSequence, selection) {
     const state = this.#requireState();
     const active = state.activeRequest;
     if (active === void 0)
@@ -1693,11 +1854,51 @@ var DshHostConnector = class {
     if (state.outbox.length > 0)
       throw new Error("DSH connector outbox was not empty before settlement");
     state.activeRequest = { ...active, dshToSequence: toSequence };
-    state.outbox = this.#outboxFor(mapped, this.#activeStatuses, active.requestId);
+    state.outbox = this.#outboxFor(mapped, this.#activeStatuses, active.requestId, active.claimAttempt ?? 1, selection);
     await this.#stateStore.save(state);
     await this.#flushOutbox();
     await this.#finalizeDeliveredRequest();
   }
+  #queueLiveProgress(idSuffix, payload) {
+    const active = this.#state?.activeRequest;
+    const runtime = this.#runtime;
+    if (active === void 0 || runtime === void 0)
+      return;
+    const requestId = active.requestId;
+    const claimAttempt = active.claimAttempt ?? 1;
+    const progressKey = `${requestId}:${String(claimAttempt)}`;
+    const now = Date.now();
+    if (this.#lastLiveProgressKey === progressKey && now - this.#lastLiveProgressAt < LIVE_PROGRESS_MIN_INTERVAL_MS) {
+      return;
+    }
+    this.#lastLiveProgressKey = progressKey;
+    this.#lastLiveProgressAt = now;
+    const idempotencyKey = `${this.#config.deviceId}:${digest(requestId).slice(0, 24)}:${idSuffix}`;
+    this.#liveProgressPromise = this.#liveProgressPromise.then(async () => {
+      const current = this.#state?.activeRequest;
+      if (current?.requestId !== requestId || (current.claimAttempt ?? 1) !== claimAttempt)
+        return;
+      const selection = this.#activeExecutionSelection;
+      if (selection === void 0)
+        return;
+      await this.#api.appendAgentProgress(this.#config.sessionId, requestId, {
+        runtimeId: runtime.id,
+        claimAttempt,
+        idempotencyKey,
+        payload,
+        observedModel: selection.model,
+        ...selection.reasoningEffort === void 0 ? {} : {
+          observedReasoningEffort: selection.reasoningEffort
+        }
+      });
+    }).catch((error) => {
+      if (this.#lastLiveProgressKey === progressKey) {
+        this.#lastLiveProgressKey = void 0;
+        this.#lastLiveProgressAt = 0;
+      }
+      this.#onBackgroundError?.(publicError(error));
+    });
+  }
   async #projectCanonicalBatch(events, throughSequence) {
     const state = this.#requireState();
     if (throughSequence <= state.projectionCursor)
@@ -1781,7 +1982,7 @@ var DshHostConnector = class {
     }
     await this.#stateStore.save(state);
   }
-  #outboxFor(events, statuses, requestId) {
+  #outboxFor(events, statuses, requestId, claimAttempt, selection) {
     const runtime = this.#requireRuntime();
     const prefix = `${this.#config.deviceId}:${digest(requestId).slice(0, 24)}`;
     const operations = [];
@@ -1793,6 +1994,7 @@ var DshHostConnector = class {
         requestId,
         input: {
           runtimeId: runtime.id,
+          claimAttempt,
           idempotencyKey,
           payload: {
             content: status === "running" ? "DeepSeek Harness started processing the request." : "DeepSeek Harness returned to idle.",
@@ -1801,7 +2003,10 @@ var DshHostConnector = class {
             capture_fidelity: "harness_transcript",
             source_harness: "deepseek-harness"
           },
-          observedModel: this.#config.model
+          observedModel: selection.model,
+          ...selection.reasoningEffort === void 0 ? {} : {
+            observedReasoningEffort: selection.reasoningEffort
+          }
         }
       });
     }
@@ -1835,7 +2040,11 @@ var DshHostConnector = class {
             payload: redactValue(payload),
             replyTo: requestId,
             runtimeId: runtime.id,
-            observedModel: this.#config.model
+            claimAttempt,
+            observedModel: selection.model,
+            ...selection.reasoningEffort === void 0 ? {} : {
+              observedReasoningEffort: selection.reasoningEffort
+            }
           }
         });
       }
@@ -1850,6 +2059,7 @@ var DshHostConnector = class {
       requestId,
       input: {
         runtimeId: runtime.id,
+        claimAttempt,
         idempotencyKey: completionKey,
         payload: {
           text: final.content,
@@ -1858,7 +2068,10 @@ var DshHostConnector = class {
           source_timestamp: final.timestamp,
           dsh_event_sequence: final.sequence
         },
-        observedModel: this.#config.model
+        observedModel: selection.model,
+        ...selection.reasoningEffort === void 0 ? {} : {
+          observedReasoningEffort: selection.reasoningEffort
+        }
       }
     });
     return operations;
@@ -1902,6 +2115,7 @@ var DshHostConnector = class {
     state.publishedDshSequence = Math.max(state.publishedDshSequence, active.dshToSequence);
     delete state.activeRequest;
     this.#activeStatuses = [];
+    this.#activeExecutionSelection = void 0;
     this.#liveEventSequences.clear();
     await this.#stateStore.save(state);
   }
@@ -1987,10 +2201,45 @@ var DshHostConnector = class {
     return stored;
   }
   #assertRuntime(runtime) {
-    if (runtime.sessionId !== this.#config.sessionId || runtime.deviceId !== this.#config.deviceId || runtime.harness !== "deepseek-harness" || runtime.provider !== this.#config.provider || runtime.model !== this.#config.model || runtime.localSessionId !== this.#config.dshSessionId || runtime.captureFidelity !== "harness_transcript" || runtime.purpose !== "execution") {
+    if (runtime.sessionId !== this.#config.sessionId || runtime.deviceId !== this.#config.deviceId || runtime.harness !== "deepseek-harness" || runtime.provider !== this.#config.provider || runtime.model !== this.#config.model || runtime.localSessionId !== this.#config.dshSessionId || runtime.captureFidelity !== "harness_transcript" || !sameExecutionProfiles(runtime.executionProfiles, this.#config.executionProfiles) || runtime.purpose !== "execution") {
       throw new Error("GatherThread returned an incompatible DSH runtime registration");
     }
   }
+  #resolveExecutionSelection(profile) {
+    const provider = profile.provider ?? this.#config.provider;
+    const advertised = this.#config.executionProfiles;
+    if (advertised === void 0) {
+      if (provider !== this.#config.provider) {
+        throw new Error("DeepSeek Harness Agent request provider does not match the configured Host binding");
+      }
+      if (profile.model !== this.#config.model) {
+        throw new Error("DeepSeek Harness Agent request model does not match the configured Host binding");
+      }
+      if (profile.reasoningEffort !== void 0) {
+        throw new Error("DeepSeek Harness fixed runtime did not advertise reasoning effort selection");
+      }
+      return { provider, model: profile.model };
+    }
+    const route = advertised.find((candidate) => candidate.provider === provider && candidate.model === profile.model);
+    if (route === void 0) {
+      throw new Error("DeepSeek Harness Agent request provider/model was not advertised by this runtime");
+    }
+    const reasoningEffort = profile.reasoningEffort ?? route.defaultReasoningEffort;
+    if (reasoningEffort !== void 0 && !route.reasoningEfforts?.includes(reasoningEffort)) {
+      throw new Error("DeepSeek Harness Agent request reasoning effort was not advertised for this model");
+    }
+    return {
+      provider,
+      model: profile.model,
+      ...reasoningEffort === void 0 ? {} : { reasoningEffort }
+    };
+  }
+  #profileTargetsThisRuntime(profile) {
+    const runtimeId = profile.runtimeId;
+    if (runtimeId !== void 0)
+      return runtimeId === this.#requireRuntime().id;
+    return this.#config.executionProfiles === void 0;
+  }
   #validatePage(events, afterSequence) {
     let previous = afterSequence;
     for (const event of events) {
@@ -2090,6 +2339,21 @@ function turnSettlement(events) {
 function digest(value) {
   return createHash3("sha256").update(value).digest("hex");
 }
+function cloneExecutionProfiles(profiles) {
+  return profiles.map((profile) => ({
+    provider: profile.provider,
+    model: profile.model,
+    ...profile.reasoningEfforts === void 0 ? {} : {
+      reasoningEfforts: [...profile.reasoningEfforts]
+    },
+    ...profile.defaultReasoningEffort === void 0 ? {} : {
+      defaultReasoningEffort: profile.defaultReasoningEffort
+    }
+  }));
+}
+function sameExecutionProfiles(actual, expected) {
+  return JSON.stringify(actual ?? null) === JSON.stringify(expected ?? null);
+}
 function publicError(error) {
   if (error instanceof Error)
     return error;
@@ -2189,6 +2453,12 @@ function boundedPublicText(value) {
   }
   return `${redacted.slice(0, low)}${suffix}`;
 }
+function outboxBelongsToRequest(operation, requestId) {
+  if (operation.kind === "progress" || operation.kind === "complete") {
+    return operation.requestId === requestId;
+  }
+  return operation.kind === "append" && operation.input.replyTo === requestId;
+}
 function sessionTimestamp(value) {
   const date = new Date(value);
   if (!Number.isFinite(date.getTime()))
@@ -2265,6 +2535,23 @@ function createDshHostFacade(options) {
     for (const subscriber of statusSubscribers)
       subscriber(status);
   }, { global: true }));
+  const adoptHandle = async (acquire) => {
+    const acquired = await acquire();
+    handle = acquired;
+    if (disposed || lifecycleAbort.signal.aborted) {
+      await releaseHandle();
+      throw new Error("DSH host facade was disposed during open");
+    }
+    if (acquired.agent.session.id !== options.sessionId) {
+      await releaseHandle();
+      throw new Error("DSH Host returned an agent for an unexpected Session identity");
+    }
+  };
+  const releaseHandle = async () => {
+    const owned = handle;
+    handle = void 0;
+    await owned?.dispose();
+  };
   const open2 = () => {
     if (disposed)
       return Promise.reject(new Error("DSH host facade is disposed"));
@@ -2279,13 +2566,12 @@ function createDshHostFacade(options) {
       const stored = liveAgent === void 0 ? await hasPersistedSession(persistence, options.sessionId, lifecycleAbort.signal) : true;
       throwIfDisposed(disposed, lifecycleAbort.signal, "open");
       const mode = stored ? "resumed" : "created";
-      let openedHandle;
       try {
-        openedHandle = liveAgent !== void 0 ? { agent: liveAgent, dispose: async () => void 0 } : stored ? await agents.resume({
+        await adoptHandle(() => liveAgent !== void 0 ? Promise.resolve({ agent: liveAgent, dispose: async () => void 0 }) : stored ? agents.resume({
           resumeSessionId: options.sessionId,
           agentOptions: { provider: options.provider, model: options.model },
           signal: lifecycleAbort.signal
-        }) : await agents.create({
+        }) : agents.create({
           sessionId: options.sessionId,
           meta: {
             cwd: options.workspacePath,
@@ -2293,42 +2579,52 @@ function createDshHostFacade(options) {
           },
           agentOptions: { provider: options.provider, model: options.model },
           signal: lifecycleAbort.signal
-        });
+        }));
       } catch (error) {
         throwIfDisposed(disposed, lifecycleAbort.signal, "open");
         throw error;
       }
-      if (disposed || lifecycleAbort.signal.aborted) {
-        await openedHandle.dispose();
-        throw new Error("DSH host facade was disposed during open");
-      }
-      if (openedHandle.agent.session.id !== options.sessionId) {
-        await openedHandle.dispose();
-        throw new Error("DSH Host returned an agent for an unexpected Session identity");
-      }
       if (sessionTitle !== void 0 && workspaceRegistry !== void 0 && options.sessionTitle !== void 0 && options.workspaceTitle !== void 0) {
         try {
-          await sessionTitle.rename(openedHandle.agent.session, options.sessionTitle);
-          ensureNativeSessionListVisibility(openedHandle.agent.session);
-          await sessions.flush(openedHandle.agent.session);
+          const session = requireAgent(handle).session;
+          if (mode === "created") {
+            await sessionTitle.rename(session, options.sessionTitle);
+            throwIfDisposed(disposed, lifecycleAbort.signal, "open");
+          }
+          const markerWritten = liveAgent === void 0 && ensureNativeSessionListVisibility(session);
+          await sessions.flush(session);
+          throwIfDisposed(disposed, lifecycleAbort.signal, "open");
+          if (markerWritten) {
+            await releaseHandle();
+            throwIfDisposed(disposed, lifecycleAbort.signal, "open");
+            await adoptHandle(() => agents.resume({
+              resumeSessionId: options.sessionId,
+              agentOptions: { provider: options.provider, model: options.model },
+              signal: lifecycleAbort.signal
+            }));
+          }
+          throwIfDisposed(disposed, lifecycleAbort.signal, "open");
           const workspace = await workspaceRegistry.create(options.workspacePath, options.workspaceTitle);
           if (workspace === null || typeof workspace !== "object" || typeof workspace.attachSession !== "function") {
             throw new Error("Pinned DSH workspace registry returned an incompatible Workspace");
           }
+          throwIfDisposed(disposed, lifecycleAbort.signal, "open");
           await workspace.attachSession(options.sessionId);
+          throwIfDisposed(disposed, lifecycleAbort.signal, "open");
           if (options.supersededSessionId !== void 0 && options.supersededSessionId !== options.sessionId && workspace.sessionIds.includes(options.supersededSessionId)) {
             if (typeof workspace.detachSession !== "function") {
               throw new Error("Pinned DSH Workspace detachSession API is unavailable or incompatible");
             }
             await workspace.detachSession(options.supersededSessionId);
+            throwIfDisposed(disposed, lifecycleAbort.signal, "open");
           }
         } catch (error) {
-          await openedHandle.dispose();
+          await releaseHandle();
           throwIfDisposed(disposed, lifecycleAbort.signal, "open");
           throw error;
         }
       }
-      handle = openedHandle;
+      throwIfDisposed(disposed, lifecycleAbort.signal, "open");
       return mode;
     })();
     return openPromise;
@@ -2345,7 +2641,7 @@ function createDshHostFacade(options) {
       return parsed;
     });
   };
-  const prompt = async (text) => {
+  const prompt = async (text, requestedSelection) => {
     if (disposed)
       throw new Error("DSH host facade is disposed");
     if (!text.trim())
@@ -2358,12 +2654,24 @@ function createDshHostFacade(options) {
     if (projectionActive)
       throw new Error("DSH host facade permits only one active write");
     promptActive = true;
+    let disposeSelection;
+    let selectionRef;
     try {
       await open2();
       throwIfDisposed(disposed, lifecycleAbort.signal, "prompt");
       const agent = requireAgent(handle);
       if (agent.status !== "idle")
         throw new Error("DSH Agent must be idle before a GatherThread prompt");
+      if (requestedSelection !== void 0) {
+        const selection = await resolveDshExecutionSelection(context, requestedSelection, lifecycleAbort.signal);
+        throwIfDisposed(disposed, lifecycleAbort.signal, "prompt");
+        const install = options.modelSelectionInstaller ?? await loadModelSelectionInstaller();
+        selectionRef = { current: selection, assembled: void 0 };
+        disposeSelection = install(agent.ctx, selectionRef);
+        if (typeof disposeSelection !== "function") {
+          throw new Error("Pinned DSH installModelSelection API returned an incompatible disposer");
+        }
+      }
       const fromSequence = agent.session.seq;
       const message = await createUserMessage(text, options);
       throwIfDisposed(disposed, lifecycleAbort.signal, "prompt");
@@ -2379,6 +2687,11 @@ function createDshHostFacade(options) {
         events: snapshotFrom(fromSequence)
       };
     } finally {
+      if (selectionRef !== void 0) {
+        selectionRef.current = void 0;
+        selectionRef.assembled = void 0;
+      }
+      disposeSelection?.();
       promptActive = false;
     }
   };
@@ -2435,18 +2748,32 @@ function createDshHostFacade(options) {
     }
   };
   const dispose = () => {
-    disposePromise ??= (async () => {
-      disposed = true;
-      lifecycleAbort.abort(new Error("DSH host facade disposed"));
-      eventSubscribers.clear();
-      statusSubscribers.clear();
-      for (const stop of listenerDisposers.splice(0))
-        stop();
+    if (disposePromise !== void 0)
+      return disposePromise;
+    disposed = true;
+    lifecycleAbort.abort(new Error("DSH host facade disposed"));
+    eventSubscribers.clear();
+    statusSubscribers.clear();
+    for (const stop of listenerDisposers.splice(0))
+      stop();
+    disposePromise = (async () => {
+      let releaseError;
       try {
-        await handle?.dispose();
-      } finally {
-        handle = void 0;
+        await releaseHandle();
+      } catch (error) {
+        releaseError = error;
+      }
+      try {
+        await openPromise;
+      } catch {
       }
+      try {
+        await releaseHandle();
+      } catch (error) {
+        releaseError ??= error;
+      }
+      if (releaseError !== void 0)
+        throw releaseError;
     })();
     return disposePromise;
   };
@@ -2478,9 +2805,10 @@ function createDshHostFacade(options) {
 function ensureNativeSessionListVisibility(session) {
   const events = session.snapshotEvents(0);
   if (events.some((event) => asSessionEvent(event)?.type === "turn/start"))
-    return;
+    return false;
   session.append("turn/start", { turn: 1 });
   session.append("turn/end", { turn: 1, reason: { kind: "completed" } });
+  return true;
 }
 function throwIfDisposed(disposed, signal, operation) {
   if (disposed || signal.aborted) {
@@ -2560,6 +2888,49 @@ async function createUserMessage(text, options) {
     source: { kind: "user" }
   });
 }
+async function loadModelSelectionInstaller() {
+  const imported = asObject4(await importDshModule("@deepseek-ai/dsh-agent"));
+  if (imported === void 0 || typeof imported.installModelSelection !== "function") {
+    throw new Error("Pinned DSH installModelSelection API is unavailable");
+  }
+  return imported.installModelSelection;
+}
+async function importDshModule(specifier) {
+  return import(specifier);
+}
+async function resolveDshExecutionSelection(context, requested, signal) {
+  const provider = safeSelectionText(requested.provider, "provider", 80);
+  const model = safeSelectionText(requested.model, "model", 160);
+  const reasoningEffort = requested.reasoningEffort === void 0 ? void 0 : safeSelectionText(requested.reasoningEffort, "reasoning effort", 80);
+  const llm = requireService(context, "llm", ["resolveModelInfo"]);
+  const resolved = asObject4(await llm.resolveModelInfo(provider, model, signal));
+  if (resolved === void 0 || resolved.provider !== provider || resolved.id !== model) {
+    throw new Error("DeepSeek Harness did not resolve the requested provider/model exactly");
+  }
+  if (reasoningEffort !== void 0) {
+    const reasoning = asObject4(resolved.reasoning);
+    const efforts = Array.isArray(reasoning?.efforts) ? reasoning.efforts : [];
+    const supported = efforts.some((value) => asObject4(value)?.id === reasoningEffort);
+    if (!supported) {
+      throw new Error(`DeepSeek Harness model ${provider}/${model} does not support reasoning effort ${reasoningEffort}`);
+    }
+  }
+  return {
+    provider,
+    model,
+    ...reasoningEffort === void 0 ? {} : { reasoningEffort }
+  };
+}
+function safeSelectionText(value, label, maximum) {
+  if (typeof value !== "string") {
+    throw new Error(`DeepSeek Harness ${label} selection must be a string`);
+  }
+  const normalized = value.trim();
+  if (!normalized || normalized.length > maximum || /[\u0000-\u001f\u007f-\u009f]/u.test(normalized)) {
+    throw new Error(`DeepSeek Harness ${label} selection is invalid`);
+  }
+  return normalized;
+}
 function requireContext(value) {
   const context = asObject4(value);
   if (context === void 0 || typeof context.get !== "function" || typeof context.on !== "function" || typeof context.effect !== "function") {
@@ -2768,7 +3139,7 @@ function validateConnectorState(value) {
 }
 function parseActiveRequest(value) {
   const active = requiredObject3(value, "state.activeRequest");
-  exactKeys(active, /* @__PURE__ */ new Set(["requestId", "requestSequence", "dshFromSequence", "dshToSequence", "promptDigest"]), "state.activeRequest");
+  exactKeys(active, /* @__PURE__ */ new Set(["requestId", "requestSequence", "dshFromSequence", "dshToSequence", "promptDigest", "claimAttempt"]), "state.activeRequest");
   const parsed = {
     requestId: safeString(active.requestId, "state.activeRequest.requestId", 128),
     requestSequence: positiveInteger(active.requestSequence, "state.activeRequest.requestSequence"),
@@ -2776,7 +3147,10 @@ function parseActiveRequest(value) {
     ...active.dshToSequence === void 0 ? {} : {
       dshToSequence: nonNegativeInteger(active.dshToSequence, "state.activeRequest.dshToSequence")
     },
-    promptDigest: hexDigest(active.promptDigest, "state.activeRequest.promptDigest")
+    promptDigest: hexDigest(active.promptDigest, "state.activeRequest.promptDigest"),
+    ...active.claimAttempt === void 0 ? {} : {
+      claimAttempt: positiveInteger(active.claimAttempt, "state.activeRequest.claimAttempt")
+    }
   };
   if (parsed.dshToSequence !== void 0 && parsed.dshToSequence < parsed.dshFromSequence) {
     throw new Error("state.activeRequest.dshToSequence cannot precede dshFromSequence");
@@ -2861,6 +3235,7 @@ function parseAppendInput(value, label) {
     "replyTo",
     "visibility",
     "runtimeId",
+    "claimAttempt",
     "observedModel",
     "observedReasoningEffort"
   ]), label);
@@ -2874,6 +3249,9 @@ function parseAppendInput(value, label) {
     ...input.replyTo === void 0 ? {} : { replyTo: safeString(input.replyTo, `${label}.replyTo`, 128) },
     ...input.visibility === void 0 ? {} : { visibility: safeString(input.visibility, `${label}.visibility`, 32) },
     ...input.runtimeId === void 0 ? {} : { runtimeId: safeString(input.runtimeId, `${label}.runtimeId`, 128) },
+    ...input.claimAttempt === void 0 ? {} : {
+      claimAttempt: positiveInteger(input.claimAttempt, `${label}.claimAttempt`)
+    },
     ...input.observedModel === void 0 ? {} : { observedModel: safeString(input.observedModel, `${label}.observedModel`, 160) },
     ...input.observedReasoningEffort === void 0 ? {} : {
       observedReasoningEffort: safeString(input.observedReasoningEffort, `${label}.observedReasoningEffort`, 80)
@@ -2882,9 +3260,12 @@ function parseAppendInput(value, label) {
 }
 function parseCompletionInput(value, label) {
   const input = requiredObject3(value, label);
-  exactKeys(input, /* @__PURE__ */ new Set(["runtimeId", "idempotencyKey", "payload", "observedModel", "observedReasoningEffort"]), label);
+  exactKeys(input, /* @__PURE__ */ new Set(["runtimeId", "claimAttempt", "idempotencyKey", "payload", "observedModel", "observedReasoningEffort"]), label);
   return {
     runtimeId: safeString(input.runtimeId, `${label}.runtimeId`, 128),
+    ...input.claimAttempt === void 0 ? {} : {
+      claimAttempt: positiveInteger(input.claimAttempt, `${label}.claimAttempt`)
+    },
     idempotencyKey: safeString(input.idempotencyKey, `${label}.idempotencyKey`, 200),
     payload: jsonValue(input.payload, `${label}.payload`),
     ...input.observedModel === void 0 ? {} : { observedModel: safeString(input.observedModel, `${label}.observedModel`, 160) },
@@ -3393,6 +3774,14 @@ function projectSessionConfig(config, sessionId, nativeSessionId) {
     statePath: path4.join(config.stateRoot, `${dshSessionId}.json`),
     provider: config.provider,
     model: config.model,
+    ...config.executionProfiles === void 0 ? {} : {
+      executionProfiles: config.executionProfiles.map((profile) => ({
+        ...profile,
+        ...profile.reasoningEfforts === void 0 ? {} : {
+          reasoningEfforts: [...profile.reasoningEfforts]
+        }
+      }))
+    },
     pollIntervalMs: config.pollIntervalMs,
     pollLimit: config.pollLimit,
     shareToolEvents: config.shareToolEvents,