@vtxmacro/cli 2026.8.56 → 2026.8.57

package/bin/vtx-service-bootstrap.js

@@ -16,7 +16,7 @@ import { fileURLToPath } from "node:url";
 // agent-cli-release.json
 var agent_cli_release_default = {
   package_name: "@vtxmacro/cli",
-  package_version: "2026.8.56",
+  package_version: "2026.8.57",
   codex_package_name: "@openai/codex",
   codex_version: "0.147.0",
   copilot_sdk_package_name: "@github/copilot-sdk",

package/bin/vtx.js

@@ -47,7 +47,7 @@ var init_agent_cli_release = __esm({
   "agent-cli-release.json"() {
     agent_cli_release_default = {
       package_name: "@vtxmacro/cli",
-      package_version: "2026.8.56",
+      package_version: "2026.8.57",
       codex_package_name: "@openai/codex",
       codex_version: "0.147.0",
       copilot_sdk_package_name: "@github/copilot-sdk",
@@ -18756,7 +18756,8 @@ var init_mcp_client = __esm({
           const errorText = (callResult.content ?? []).filter((block) => block.type === "text").map((block) => block.text ?? "").join("\n");
           const definitivelyNotApplied = (name === "inference.host.register" || name === "inference.host.advertise") && (errorText.includes("Advertisement time is outside the allowed clock skew.") || errorText.includes("Advertisement is already expired.")) || (name === "inference.agent.next" || name === "inference.agent.heartbeat") && (errorText.includes("Advertisement time is outside the allowed clock skew.") || errorText.includes("Advertisement is already expired.") || errorText.includes("Heartbeat time is outside the allowed clock skew.")) || name === "inference.host.heartbeat" && errorText.includes("Heartbeat time is outside the allowed clock skew.") || name === "inference.job.claim" && (errorText.includes(
             "External inference claim request was not applied before its generation became stale"
-          ) || errorText.includes("External inference host advertisement is expired or superseded"));
+          ) || errorText.includes("External inference host advertisement is expired or superseded")) || name === "inference.job.complete" && errorText.includes("External inference completion evidence window expired");
+          const completionEvidenceExpired = name === "inference.job.complete" && errorText.includes("External inference completion evidence window expired");
           const retryableInfrastructureRejection = EXTERNAL_INFERENCE_AUTOMATED_HOST_TOOLS.includes(name) && (errorText.includes("External inference polling is at its configured concurrency limit") || errorText.includes("The Insights action reached the response timeout") || errorText.includes("Insights capability failed without exposing private runtime details"));
           const retryableClaimRejection = name === "inference.job.claim" && !definitivelyNotApplied && (retryableInfrastructureRejection || errorText.includes("External inference host is not live enough to claim work") || errorText.includes("External inference host request generation is stale") || errorText.includes("External inference claim runtime fence is stale"));
           const retryableHeartbeatClockSkew = name === "inference.host.heartbeat" && definitivelyNotApplied;
@@ -18766,7 +18767,7 @@ var init_mcp_client = __esm({
             "External inference claim replay is no longer dispatchable"
           );
           throw new ExternalInferenceMcpError(
-            staleHostHeartbeatGeneration ? "generation_stale" : obsoleteClaimReplay ? "claim_replay_obsolete" : "tool_rejected",
+            completionEvidenceExpired ? "completion_evidence_expired" : staleHostHeartbeatGeneration ? "generation_stale" : obsoleteClaimReplay ? "claim_replay_obsolete" : "tool_rejected",
             `Insights MCP rejected ${name}.`,
             {
               definitivelyNotApplied: definitivelyNotApplied || staleHostHeartbeatGeneration,
@@ -32426,7 +32427,7 @@ function createDefaultInferenceHostRunnerDependencies(options) {
     envelopePublicKey: options.envelopePublicKey
   };
 }
-var import_ajv, RUNTIME_RECEIPT_SCHEMA_VERSION, ATTEMPT_RECEIPT_SCHEMA_VERSION, DEFAULT_ADVERTISEMENT_TTL_MS, DEFAULT_ADVERTISEMENT_REFRESH_LEAD_MS, DEFAULT_HOST_HEARTBEAT_MS, DEFAULT_PROVIDER_RATE_LIMIT_REFRESH_MS, DEFAULT_ATTEMPT_HEARTBEAT_MS, DEFAULT_DRAIN_TIMEOUT_MS, DEFAULT_REMOTE_RETRY_LIMIT, MIN_SLEEP_MS, MIN_HOST_HEARTBEAT_GAP_DIAGNOSTIC_MS, HOST_HEARTBEAT_GAP_DIAGNOSTIC_FACTOR, DEFAULT_CODEX_ACCOUNT_COOLDOWN_MS, DEFAULT_AGENT_RATE_LIMIT_COOLDOWN_MS, DEFAULT_AGENT_QUOTA_COOLDOWN_MS, DEFAULT_AGENT_TRANSIENT_COOLDOWN_MS, MIN_CLAIM_START_WINDOW_MS, MAX_ATTEMPT_START_RETRY_DELAY_MS, UNBOUNDED_AVAILABLE_SLOTS, buildInferenceAdvertisedModels, summarizeInferenceHostRuntimeRecovery, FileInferenceHostRuntimeReceiptStore, InferenceHostRecoveryRequiredError, InferenceHostRunnerError, defaultSleep, abortError, settlesWithin, defaultRegisterSignalHandlers, safeInteger, exactObjectKeys, validIso, validateAttemptReceipt, validateRuntimeReceipt, sha256, stableOperationId, buildAttemptStartRequest, isoAt, providerWeeklyQuotaFromRateLimits, finitePositiveOption, validateRunnerOptions, assertLocalCredentialIdentity, retryableRemoteError, remoteRetryAfterMs, controlPlaneFatal, defaultValidateOutput, objectRecord, positiveUtf8ByteLimit, assertCompilableOutputSchema, parseOutputContract, membershipFailureDisposition, safeFailureCode, attemptStartRetryFallbackMs, exactJson2, runnerIdentityMismatch, assertAdvertisementResult, assertHostHeartbeatResult, assertClaimResult, assertStartResult, assertJobHeartbeatResult, assertTerminalResult, classifyFailure, ambiguousHeartbeatTransport, reportedTokenUsage, reportedUsage, InferenceHostRunner, createInferenceAgentControlClient, INFERENCE_AGENT_SYSTEM_PROMPT, INFERENCE_AGENT_WAKE_SCHEMA, parseInferenceAgentWake, InferenceAgentRuntime;
+var import_ajv, RUNTIME_RECEIPT_SCHEMA_VERSION, ATTEMPT_RECEIPT_SCHEMA_VERSION, DEFAULT_ADVERTISEMENT_TTL_MS, DEFAULT_ADVERTISEMENT_REFRESH_LEAD_MS, DEFAULT_HOST_HEARTBEAT_MS, DEFAULT_PROVIDER_RATE_LIMIT_REFRESH_MS, DEFAULT_ATTEMPT_HEARTBEAT_MS, DEFAULT_DRAIN_TIMEOUT_MS, DEFAULT_REMOTE_RETRY_LIMIT, MIN_SLEEP_MS, MIN_HOST_HEARTBEAT_GAP_DIAGNOSTIC_MS, HOST_HEARTBEAT_GAP_DIAGNOSTIC_FACTOR, DEFAULT_CODEX_ACCOUNT_COOLDOWN_MS, DEFAULT_AGENT_RATE_LIMIT_COOLDOWN_MS, DEFAULT_AGENT_QUOTA_COOLDOWN_MS, DEFAULT_AGENT_TRANSIENT_COOLDOWN_MS, MIN_CLAIM_START_WINDOW_MS, MAX_ATTEMPT_START_RETRY_DELAY_MS, UNBOUNDED_AVAILABLE_SLOTS, buildInferenceAdvertisedModels, summarizeInferenceHostRuntimeRecovery, FileInferenceHostRuntimeReceiptStore, InferenceHostRecoveryRequiredError, InferenceHostRunnerError, defaultSleep, abortError, settlesWithin, defaultRegisterSignalHandlers, safeInteger, exactObjectKeys, validIso, validateAttemptReceipt, validateRuntimeReceipt, sha256, stableOperationId, buildAttemptStartRequest, isoAt, providerWeeklyQuotaFromRateLimits, finitePositiveOption, validateRunnerOptions, assertLocalCredentialIdentity, retryableRemoteError, remoteRetryAfterMs, controlPlaneFatal, defaultValidateOutput, objectRecord, positiveUtf8ByteLimit, assertCompilableOutputSchema, parseOutputContract, membershipFailureDisposition, safeFailureCode, attemptStartRetryFallbackMs, exactJson2, runnerIdentityMismatch, assertAdvertisementResult, assertHostHeartbeatResult, assertClaimResult, assertStartResult, assertJobHeartbeatResult, assertTerminalResult, isDefinitiveCompletionEvidenceExpiry, classifyFailure, ambiguousHeartbeatTransport, reportedTokenUsage, reportedUsage, InferenceHostRunner, createInferenceAgentControlClient, INFERENCE_AGENT_SYSTEM_PROMPT, INFERENCE_AGENT_WAKE_SCHEMA, parseInferenceAgentWake, InferenceAgentRuntime;
 var init_runner = __esm({
   "lib/inference-host/runner.ts"() {
     "use strict";
@@ -33050,6 +33051,7 @@ var init_runner = __esm({
         if (failure.state !== request.attempt_status || failure.failure_category !== request.failure_category || failure.failure_code !== request.failure_code) runnerIdentityMismatch("Job failure receipt");
       }
     };
+    isDefinitiveCompletionEvidenceExpiry = (error48, terminal) => terminal?.schema_version === "external_inference_job_complete_v1" && error48 instanceof ExternalInferenceMcpError && error48.code === "completion_evidence_expired" && error48.definitivelyNotApplied;
     classifyFailure = (error48, result2) => {
       if (error48 instanceof CodexAppServerError) {
         const category2 = error48.code === "quota_exceeded" ? "quota" : error48.category;
@@ -33907,10 +33909,19 @@ var init_runner = __esm({
             }
             return attemptId;
           };
-          const removeRecoveredAttempt = async (attemptId) => {
+          const removeRecoveredAttempt = async (recovery) => {
             await mutateReceipt((current) => {
+              const persisted = current.attempts[recovery.attempt_id];
+              const persistedTerminal = persisted?.terminal_request;
+              const recoveryTerminal = recovery.terminal_request;
+              const sameTerminalRequest = Boolean(
+                persistedTerminal && recoveryTerminal && persistedTerminal.schema_version === recoveryTerminal.schema_version && (persistedTerminal.schema_version === "external_inference_job_complete_v1" && recoveryTerminal.schema_version === "external_inference_job_complete_v1" && persistedTerminal.completion_id === recoveryTerminal.completion_id || persistedTerminal.schema_version === "external_inference_job_fail_v1" && recoveryTerminal.schema_version === "external_inference_job_fail_v1" && persistedTerminal.failure_id === recoveryTerminal.failure_id)
+              );
+              if (persisted?.phase !== "terminal_pending" || persisted.job_id !== recovery.job_id || persisted.terminal_operation_id !== recovery.terminal_operation_id || !sameTerminalRequest) {
+                return current;
+              }
               const attempts = { ...current.attempts };
-              delete attempts[attemptId];
+              delete attempts[recovery.attempt_id];
               return { ...current, attempts, updated_at: isoAt(now()) };
             });
           };
@@ -33936,8 +33947,22 @@ var init_runner = __esm({
                   failed += 1;
                 }
                 await this.dependencies.codexAdapter.acknowledgeAttempt?.(recovery.attempt_id);
-                await removeRecoveredAttempt(recovery.attempt_id);
+                await removeRecoveredAttempt(recovery);
               } catch (error48) {
+                if (isDefinitiveCompletionEvidenceExpiry(error48, recovery.terminal_request)) {
+                  await this.dependencies.codexAdapter.acknowledgeAttempt?.(recovery.attempt_id);
+                  await removeRecoveredAttempt(recovery);
+                  failed += 1;
+                  emitDiagnostic("terminal_recovery_retired", {
+                    job_id: recovery.job_id,
+                    attempt_id: recovery.attempt_id,
+                    attempt_phase: recovery.phase,
+                    terminal_operation: "complete",
+                    error_code: error48.code,
+                    definitively_not_applied: true
+                  });
+                  continue;
+                }
                 emitTerminalRecoveryFailure(recovery, error48);
                 requestDrain(controlPlaneFatal(error48) ? "authority_lost" : "attempt_terminal_unconfirmed");
                 break;
@@ -34568,6 +34593,22 @@ var init_runner = __esm({
             assertTerminalResult(completion, completionResult);
             await this.dependencies.codexAdapter.acknowledgeAttempt?.(attemptId);
           } catch (error48) {
+            if (isDefinitiveCompletionEvidenceExpiry(error48, completion)) {
+              await this.dependencies.codexAdapter.acknowledgeAttempt?.(attemptId);
+              await stopHeartbeat();
+              await removeAttempt();
+              options.onAttemptOutcome?.({
+                outcome: "failed",
+                failure_category: "deadline",
+                failure_code: error48.code,
+                retryable: false,
+                dispatch_outcome: completion.outcome.dispatch_outcome,
+                response_outcome: "none",
+                latency_ms: completion.latency_ms,
+                usage: completion.usage
+              });
+              return "failed";
+            }
             throw new InferenceHostRunnerError(
               "terminal_outcome_unconfirmed",
               "The exact completion receipt could not be confirmed; redispatch is fenced.",
@@ -41828,12 +41869,13 @@ var init_hyperliquid_account_state_adapter = __esm({
     buildUserFillsStorageKey = (cacheKey) => {
       return `${USER_FILLS_CACHE_STORAGE_PREFIX}${cacheKey}`;
     };
-    buildAccountStateCacheKey = (apiUrl, walletAddress, symbol2, aggregatePerpDexs, dexNames, includeEffectiveTakerRate, includeExactAccountMode, includeActiveAssetData) => {
+    buildAccountStateCacheKey = (apiUrl, walletAddress, symbol2, aggregatePerpDexs, scopeAccountSummaryToSelectedDex, dexNames, includeEffectiveTakerRate, includeExactAccountMode, includeActiveAssetData) => {
       return [
         apiUrl.replace(/\/$/, "").toLowerCase(),
         walletAddress.trim().toLowerCase(),
         normalizeHyperliquidMarketSymbol(symbol2),
         aggregatePerpDexs ? "aggregate" : "selected",
+        scopeAccountSummaryToSelectedDex ? "selected-summary" : "aggregate-summary",
         includeEffectiveTakerRate ? "with-effective-taker-rate" : "without-effective-taker-rate",
         includeExactAccountMode ? "with-exact-account-mode" : "without-exact-account-mode",
         includeActiveAssetData ? "with-active-asset" : "without-active-asset",
@@ -42505,15 +42547,20 @@ var init_hyperliquid_account_state_adapter = __esm({
       const activeAssetCacheKey = buildActiveAssetCacheKey(apiUrl, walletAddress, symbol2);
       const activeAssetRequestTypes = getBrowserActiveAssetTypeCandidates(apiUrl, walletAddress, symbol2);
       const aggregatePerpDexs = input.aggregatePerpDexs !== false;
+      const scopeAccountSummaryToSelectedDex = input.scopeAccountSummaryToSelectedDex === true;
       const includeEffectiveTakerRate = input.includeEffectiveTakerRate === true;
       const includeExactAccountMode = input.includeExactAccountMode === true;
       const includeActiveAssetData = input.includeActiveAssetData !== false;
       const dexNames = listPerpDexsForAccountState(input.config, dex, aggregatePerpDexs);
+      if (scopeAccountSummaryToSelectedDex && dex && !dexNames.includes(dex)) {
+        dexNames.push(dex);
+      }
       const cacheKey = buildAccountStateCacheKey(
         apiUrl,
         walletAddress,
         symbol2,
         aggregatePerpDexs,
+        scopeAccountSummaryToSelectedDex,
         dexNames,
         includeEffectiveTakerRate,
         includeExactAccountMode,
@@ -42541,6 +42588,7 @@ var init_hyperliquid_account_state_adapter = __esm({
           apiUrl,
           walletAddress,
           symbol: symbol2,
+          selectedDex: dex,
           activeAssetCacheKey,
           activeAssetRequestTypes,
           dexNames,
@@ -42580,6 +42628,7 @@ var init_hyperliquid_account_state_adapter = __esm({
       apiUrl,
       walletAddress,
       symbol: symbol2,
+      selectedDex,
       activeAssetCacheKey,
       activeAssetRequestTypes,
       dexNames,
@@ -42604,11 +42653,22 @@ var init_hyperliquid_account_state_adapter = __esm({
             if (input.includeEffectiveTakerRate === true) {
               requirePromptClearinghouseState(response, dexName);
             }
-            return prefixHip3PositionCoins(response, dexName);
+            return {
+              dex: dexName,
+              payload: prefixHip3PositionCoins(response, dexName)
+            };
           })
         );
+        const selectedPayload = selectedDex ? dexResponses.find((entry) => entry.dex === selectedDex)?.payload : defaultResponse;
+        if (!selectedPayload) {
+          throw new Error(`Missing selected Hyperliquid clearinghouse state for DEX ${selectedDex}.`);
+        }
         return {
-          payload: aggregateClearinghouseResponses([defaultResponse, ...dexResponses]),
+          payload: aggregateClearinghouseResponses([
+            defaultResponse,
+            ...dexResponses.map((entry) => entry.payload)
+          ]),
+          selectedPayload,
           capturedAt: (/* @__PURE__ */ new Date()).toISOString()
         };
       })();
@@ -42691,6 +42751,7 @@ var init_hyperliquid_account_state_adapter = __esm({
         exactAccountModePromise
       ]);
       const perpsResponse = perpsResult.payload;
+      const accountSummaryPerpsResponse = input.scopeAccountSummaryToSelectedDex === true ? perpsResult.selectedPayload : perpsResponse;
       const spotResponse = spotResult.payload;
       const userFeesResponse = userFeesResult?.payload ?? null;
       if (input.includeEffectiveTakerRate === true) {
@@ -42712,16 +42773,33 @@ var init_hyperliquid_account_state_adapter = __esm({
         takerRate = parsedUserCrossRate;
       }
       const accountStateConfig = input.config.client_runtime_hyperliquid_account_state;
-      const summaryPerpsResponse = exactAccountMode ? { ...perpsResponse, accountMode: exactAccountMode.accountMode } : perpsResponse;
+      const summaryPerpsResponse = exactAccountMode ? { ...accountSummaryPerpsResponse, accountMode: exactAccountMode.accountMode } : accountSummaryPerpsResponse;
       const accountSummaryOptions = {
         spotDominatesMinTotalUsd: accountStateConfig?.spot_dominates_min_total_usd,
         spotDominatesPerpsMultiplier: accountStateConfig?.spot_dominates_perps_multiplier,
         mirroredAccountValueAbsoluteToleranceUsd: accountStateConfig?.mirrored_account_value_absolute_tolerance_usd,
         mirroredAccountValueRelativeTolerance: accountStateConfig?.mirrored_account_value_relative_tolerance
       };
-      const normalizedSummary = exactAccountMode ? buildServerPromptRescueAccountSummary(
+      const walletSummary = exactAccountMode && input.scopeAccountSummaryToSelectedDex !== true ? buildServerPromptRescueAccountSummary(
+        perpsResponse,
+        spotResponse,
+        exactAccountMode.accountMode,
+        accountSummaryOptions
+      ) : buildAccountSummaryFromInfoResponses(
         perpsResponse,
         spotResponse,
+        accountSummaryOptions
+      );
+      const normalizedSummary = input.scopeAccountSummaryToSelectedDex === true ? {
+        ...buildAccountSummaryFromInfoResponses(
+          summaryPerpsResponse,
+          {},
+          accountSummaryOptions
+        ),
+        balances: walletSummary.balances
+      } : exactAccountMode ? buildServerPromptRescueAccountSummary(
+        accountSummaryPerpsResponse,
+        spotResponse,
         exactAccountMode.accountMode,
         accountSummaryOptions
       ) : buildAccountSummaryFromInfoResponses(
@@ -42733,7 +42811,7 @@ var init_hyperliquid_account_state_adapter = __esm({
         ...normalizedSummary,
         ...exactAccountMode == null ? {} : { account_mode: exactAccountMode.accountMode, mode_source: "canonical" },
         address: walletAddress,
-        dex: "all",
+        dex: input.scopeAccountSummaryToSelectedDex === true ? selectedDex : "all",
         market_type: "perp"
       };
       const activeAssetPayload = activeAssetResult?.payload ?? null;
@@ -43570,9 +43648,12 @@ async function postClientRuntime(path, profileId, body, options) {
   const numericProfileId = toNumericProfileId(profileId);
   const keepalive = options?.keepalive === true;
   const signal = options?.signal;
+  const parsedRequestTimeoutMs = Number(options?.requestTimeoutMs);
+  const requestTimeoutMs = Number.isFinite(parsedRequestTimeoutMs) && parsedRequestTimeoutMs > 0 ? Math.round(parsedRequestTimeoutMs) : null;
   const maxAttempts = keepalive ? 1 : 3;
   const requestContext = parseClientRuntimeRequestContext(body);
-  const idempotencyKey = shouldAttachRuntimeIdempotencyKey(path) ? createIdempotencyKey(`runtime-${path.replace(/\//g, "-")}`) : null;
+  const explicitIdempotencyKey = String(options?.idempotencyKey ?? "").trim();
+  const idempotencyKey = shouldAttachRuntimeIdempotencyKey(path) ? explicitIdempotencyKey || createIdempotencyKey(`runtime-${path.replace(/\//g, "-")}`) : null;
   const requestHeaders = getProfileHeaders({
     "Content-Type": "application/json"
   }, numericProfileId);
@@ -43589,6 +43670,24 @@ async function postClientRuntime(path, profileId, body, options) {
   let missingRuntimeLeaseRecoveryAttempted = false;
   for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
     let response = null;
+    let requestTimedOut = false;
+    let timeoutId = null;
+    let relayCallerAbort = null;
+    let requestSignal = signal;
+    if (requestTimeoutMs !== null) {
+      const timeoutController = new AbortController();
+      relayCallerAbort = () => timeoutController.abort(signal?.reason);
+      if (signal?.aborted) {
+        relayCallerAbort();
+      } else {
+        signal?.addEventListener("abort", relayCallerAbort, { once: true });
+      }
+      timeoutId = globalThis.setTimeout(() => {
+        requestTimedOut = true;
+        timeoutController.abort(new DOMException("Runtime request timeout reached.", "TimeoutError"));
+      }, requestTimeoutMs);
+      requestSignal = timeoutController.signal;
+    }
     const trace = startRuntimeNetworkDebugTrace({
       kind: "runtime",
       label: "client_runtime_api",
@@ -43601,7 +43700,7 @@ async function postClientRuntime(path, profileId, body, options) {
         method: "POST",
         credentials: "include",
         keepalive,
-        signal,
+        signal: requestSignal,
         headers: { ...requestHeaders },
         body
       });
@@ -43609,7 +43708,11 @@ async function postClientRuntime(path, profileId, body, options) {
         const error48 = await createRuntimeRequestError(response, "Client runtime request failed");
         if (!resolvedRuntimeLeaseToken && !missingRuntimeLeaseRecoveryAttempted && shouldRecoverMissingRuntimeLease(path, requestContext, keepalive) && isMissingRuntimeLeaseError(response.status, error48.message)) {
           missingRuntimeLeaseRecoveryAttempted = true;
-          const recoveredRuntimeLeaseToken = await recoverMissingRuntimeLease(numericProfileId, requestContext);
+          const recoveredRuntimeLeaseToken = await recoverMissingRuntimeLease(
+            numericProfileId,
+            requestContext,
+            requestSignal
+          );
           if (recoveredRuntimeLeaseToken) {
             resolvedRuntimeLeaseToken = recoveredRuntimeLeaseToken;
             attachRuntimeLeaseHeader(requestHeaders, resolvedRuntimeLeaseToken);
@@ -43627,7 +43730,7 @@ async function postClientRuntime(path, profileId, body, options) {
           hadRuntimeLeaseToken: Boolean(resolvedRuntimeLeaseToken),
           leaseCleared: shouldClearLease
         });
-        if (!keepalive && attempt < maxAttempts && !shouldClearLease && shouldRetryClientRuntimeHttpStatus(path, response.status)) {
+        if (!keepalive && attempt < maxAttempts && !shouldClearLease && (shouldRetryClientRuntimeHttpStatus(path, response.status) || isRuntimeIdempotencyInProgressError(response.status, error48.message) || Boolean(idempotencyKey) && isRetryableRuntimeConflictError(response.status, error48))) {
           await sleep2(resolveClientRuntimeRetryDelayMs(attempt, response.headers.get("Retry-After")));
           continue;
         }
@@ -43642,10 +43745,11 @@ async function postClientRuntime(path, profileId, body, options) {
       trace.completeSuccess(response.status);
       return payload;
     } catch (error48) {
-      lastNetworkError = error48;
-      trace.completeError(error48, response?.status ?? null);
-      if (!isTransientNetworkFetchError(error48) || attempt >= maxAttempts) {
-        throw annotateRuntimeRequestError(error48, {
+      const requestError = requestTimedOut && !signal?.aborted ? new TypeError("Runtime request timeout reached.") : error48;
+      lastNetworkError = requestError;
+      trace.completeError(requestError, response?.status ?? null);
+      if (signal?.aborted || !requestTimedOut && !isTransientNetworkFetchError(requestError) || attempt >= maxAttempts) {
+        throw annotateRuntimeRequestError(requestError, {
           path,
           method: "POST",
           attempt,
@@ -43657,6 +43761,13 @@ async function postClientRuntime(path, profileId, body, options) {
       }
       await sleep2(resolveClientRuntimeRetryDelayMs(attempt, null));
       continue;
+    } finally {
+      if (timeoutId !== null) {
+        globalThis.clearTimeout(timeoutId);
+      }
+      if (signal && relayCallerAbort) {
+        signal.removeEventListener("abort", relayCallerAbort);
+      }
     }
   }
   if (lastNetworkError instanceof Error) {
@@ -43859,7 +43970,7 @@ async function reconcileActiveClientRuntimeExchangeMutation(profileId, requestOp
   }
   return rememberCompletedDeferredClientRuntimeStop(profileId, result2);
 }
-var getApiUrl, API_URL, sleep2, isTransientNetworkFetchError, createIdempotencyKey, getErrorMessage, getErrorPayloadOrEmpty, getErrorPayloadOrFallbackDetail, getErrorMessageFromResponse, _activeProfileId, PROFILE_STORAGE_KEY, preferencesWriteQueue, CLIENT_SUPPORTED_PROMPT_CONTRACT_VERSION, completedDeferredClientRuntimeStops, rememberCompletedDeferredClientRuntimeStop, toNumericProfileId, shouldAttachRuntimeIdempotencyKey, attachRuntimeLeaseHeader, resolveRuntimeLeaseToken, persistRuntimeLeaseFromPayload, persistRuntimeLeaseStatusMetadata, shouldClearPersistedRuntimeLeaseOnError, isMissingRuntimeLeaseError, createRuntimeRequestError, parseClientRuntimeRequestContext, recordRuntimeAuthFailureBreadcrumb, classifyRuntimeRequestError, annotateRuntimeRequestError, parseRuntimeRetryAfterMs, shouldRecoverMissingRuntimeLease, recoverMissingRuntimeLease, isRetryableClientRuntimeStatus, shouldRetryClientRuntimeHttpStatus, resolveClientRuntimeRetryDelayMs, CLIENT_EXCHANGE_AUTHORITY_DEVICE_KEY, CLIENT_EXCHANGE_AUTHORITY_SESSION_KEY, getOrCreateClientExchangeAuthorityIdentity, resolveClientExchangeMutationAuthority, clientExchangeMutationAuthorityBody, isPendingClientExchangeMutationError, clientExchangeMutationReconciliationTimers, MAX_CLIENT_EXCHANGE_RECONCILIATION_DELAY_MS, CLIENT_EXCHANGE_RECONCILIATION_CLOCK_SKEW_MS, ClientExchangeMutationRebuildRequiredError, isTerminalClientExchangeMutation, clientExchangeMutationReconciliationKey, clearScheduledClientExchangeMutationReconciliation, snapshotClientExchangeMutationReconciliationAuthority, postClientExchangeMutationReconciliation, scheduleClientExchangeMutationReconciliation;
+var getApiUrl, API_URL, sleep2, isTransientNetworkFetchError, createIdempotencyKey, getErrorMessage, getErrorPayloadOrEmpty, getErrorPayloadOrFallbackDetail, getErrorMessageFromResponse, _activeProfileId, PROFILE_STORAGE_KEY, preferencesWriteQueue, CLIENT_SUPPORTED_PROMPT_CONTRACT_VERSION, completedDeferredClientRuntimeStops, rememberCompletedDeferredClientRuntimeStop, toNumericProfileId, shouldAttachRuntimeIdempotencyKey, attachRuntimeLeaseHeader, resolveRuntimeLeaseToken, persistRuntimeLeaseFromPayload, persistRuntimeLeaseStatusMetadata, shouldClearPersistedRuntimeLeaseOnError, isMissingRuntimeLeaseError, createRuntimeRequestError, parseClientRuntimeRequestContext, recordRuntimeAuthFailureBreadcrumb, classifyRuntimeRequestError, annotateRuntimeRequestError, parseRuntimeRetryAfterMs, shouldRecoverMissingRuntimeLease, recoverMissingRuntimeLease, isRetryableClientRuntimeStatus, shouldRetryClientRuntimeHttpStatus, isRuntimeIdempotencyInProgressError, isRetryableRuntimeConflictError, resolveClientRuntimeRetryDelayMs, CLIENT_EXCHANGE_AUTHORITY_DEVICE_KEY, CLIENT_EXCHANGE_AUTHORITY_SESSION_KEY, getOrCreateClientExchangeAuthorityIdentity, resolveClientExchangeMutationAuthority, clientExchangeMutationAuthorityBody, isPendingClientExchangeMutationError, clientExchangeMutationReconciliationTimers, MAX_CLIENT_EXCHANGE_RECONCILIATION_DELAY_MS, CLIENT_EXCHANGE_RECONCILIATION_CLOCK_SKEW_MS, ClientExchangeMutationRebuildRequiredError, isTerminalClientExchangeMutation, clientExchangeMutationReconciliationKey, clearScheduledClientExchangeMutationReconciliation, snapshotClientExchangeMutationReconciliationAuthority, postClientExchangeMutationReconciliation, scheduleClientExchangeMutationReconciliation;
 var init_api2 = __esm({
   "lib/api.ts"() {
     "use strict";
@@ -44058,7 +44169,9 @@ var init_api2 = __esm({
     };
     isMissingRuntimeLeaseError = (statusCode, message) => statusCode === 401 && String(message ?? "").trim().toLowerCase().includes("runtime lease required");
     createRuntimeRequestError = async (response, defaultMessage) => {
-      const rawMessage = await getErrorMessageFromResponse(response, defaultMessage);
+      const payload = await getErrorPayloadOrEmpty(response);
+      const nestedDetail = payload.detail && typeof payload.detail === "object" && !Array.isArray(payload.detail) ? payload.detail : null;
+      const rawMessage = getErrorMessage(payload, defaultMessage);
       const walletCohortMessage = response.status === 409 ? {
         client_wallet_unavailable: "The active profile wallet is unavailable. Save a wallet for this profile, then try again.",
         client_wallet_mismatch: "The active profile wallet does not match this Client Mode session. Reload the profile, then try again.",
@@ -44067,6 +44180,15 @@ var init_api2 = __esm({
       const message = walletCohortMessage ?? rawMessage;
       const error48 = new Error(message);
       error48.status = response.status;
+      error48.detail = payload.detail;
+      const code = typeof payload.code === "string" ? payload.code.trim() : typeof nestedDetail?.code === "string" ? nestedDetail.code.trim() : "";
+      if (code) {
+        error48.code = code;
+      }
+      const retryable = payload.retryable ?? nestedDetail?.retryable;
+      if (typeof retryable === "boolean") {
+        error48.retryable = retryable;
+      }
       return error48;
     };
     parseClientRuntimeRequestContext = (body) => {
@@ -44167,7 +44289,7 @@ var init_api2 = __esm({
       }
       return path === "/runtime/heartbeat" || path === "/runtime/analyze" || path === "/runtime/prompt-contract/metadata" || path === "/runtime/prompt-contract/derived-context" || path === "/runtime/prompt" || path === "/runtime/decision" || path === "/runtime/error" || path === "/runtime/trade-sync";
     };
-    recoverMissingRuntimeLease = async (profileId, requestContext) => {
+    recoverMissingRuntimeLease = async (profileId, requestContext, signal) => {
       if (!requestContext.sessionId || !requestContext.deviceId) {
         return null;
       }
@@ -44181,6 +44303,7 @@ var init_api2 = __esm({
           method: "POST",
           credentials: "include",
           cache: "no-store",
+          signal,
           headers,
           body: JSON.stringify({
             session_id: requestContext.sessionId,
@@ -44195,7 +44318,10 @@ var init_api2 = __esm({
           return null;
         }
         payload = await response.json();
-      } catch {
+      } catch (error48) {
+        if (signal?.aborted) {
+          throw signal.reason ?? error48;
+        }
         return null;
       }
       persistRuntimeLeaseFromPayload(payload);
@@ -44216,6 +44342,8 @@ var init_api2 = __esm({
       }
       return true;
     };
+    isRuntimeIdempotencyInProgressError = (status, message) => status === 409 && (message.toLowerCase().includes("duplicate request already in progress") || message.toLowerCase().includes("duplicate request in-flight"));
+    isRetryableRuntimeConflictError = (status, error48) => status === 409 && error48.retryable === true && (error48.code === "profile_runtime_contract_busy" || error48.code === "runtime_trade_sync_finalizing");
     resolveClientRuntimeRetryDelayMs = (attempt, retryAfterHeader) => {
       const retryAfterMs = parseRuntimeRetryAfterMs(retryAfterHeader);
       if (retryAfterMs != null) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vtxmacro/cli",
-  "version": "2026.8.56",
+  "version": "2026.8.57",
   "description": "VTX Macro CLI, MCP server, and durable external inference host.",
   "type": "module",
   "license": "UNLICENSED",