@vtxmacro/cli 2026.9.54 → 2026.9.55

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.9.54",
+  package_version: "2026.9.55",
   codex_package_name: "@openai/codex",
   codex_version: "0.155.0",
   copilot_sdk_package_name: "@github/copilot-sdk",

package/bin/vtx.js

@@ -77,7 +77,7 @@ var init_agent_cli_release = __esm({
   "agent-cli-release.json"() {
     agent_cli_release_default = {
       package_name: "@vtxmacro/cli",
-      package_version: "2026.9.54",
+      package_version: "2026.9.55",
       codex_package_name: "@openai/codex",
       codex_version: "0.155.0",
       copilot_sdk_package_name: "@github/copilot-sdk",
@@ -21519,7 +21519,8 @@ var init_mcp_client = __esm({
         this.#initialized = true;
       }
       async callTool(name, argumentsValue, options = {}) {
-        const timing = name === "inference.job.claim" && options.onClaimTiming ? new ClaimTiming() : void 0;
+        const timingObserver = name === "inference.job.claim" ? options.onClaimTiming : name === "inference.host.heartbeat" ? options.onHostHeartbeatTiming : void 0;
+        const timing = timingObserver ? new ClaimTiming() : void 0;
         let outcome = "failure";
         try {
           if (!this.#initialized) {
@@ -21598,7 +21599,7 @@ var init_mcp_client = __esm({
           if (timing) {
             const receipt = Object.freeze({ ...timing.finish(outcome), transport_route: this.#transport.route });
             try {
-              void Promise.resolve(options.onClaimTiming?.(receipt)).catch(() => void 0);
+              void Promise.resolve(timingObserver?.(receipt)).catch(() => void 0);
             } catch {
             }
           }
@@ -32615,6 +32616,39 @@ var init_runner = __esm({
           };
           const hostHeartbeatAbort = new AbortController();
           stopHostHeartbeatLoop = () => hostHeartbeatAbort.abort();
+          const backgroundHostHeartbeat = async (advertisementGeneration, allowOfflineProjection, deadlineAtMs) => {
+            const startedAt = performance.now();
+            let clientTiming;
+            try {
+              await hostHeartbeat("healthy", {
+                signal: hostHeartbeatAbort.signal,
+                // A liveness request must not inherit the general MCP timeout,
+                // which can exceed the server's host-staleness window. Generation
+                // recovery shares this deadline with its first attempt.
+                timeoutMs: settings.hostHeartbeatMs,
+                deadlineAtMs,
+                onHostHeartbeatTiming: (timing) => {
+                  clientTiming = timing;
+                }
+              }, false, allowOfflineProjection, 0, advertisementGeneration);
+            } catch (error48) {
+              if (!hostHeartbeatAbort.signal.aborted && !drainRequested) {
+                emitDiagnostic("host_heartbeat_request_failed", {
+                  elapsed_ms: Math.max(0, Math.round(performance.now() - startedAt)),
+                  request_timeout_ms: settings.hostHeartbeatMs,
+                  advertisement_generation: advertisementGeneration,
+                  failure_code: safeFailureCode(
+                    error48 instanceof ExternalInferenceMcpError ? error48.code : "",
+                    "heartbeat_failed"
+                  ),
+                  http_status_code: error48 instanceof ExternalInferenceMcpError ? error48.httpStatusCode : null,
+                  retry_after_ms: error48 instanceof ExternalInferenceMcpError ? error48.retryAfterMs : null,
+                  ...clientTiming ? { client_timing: clientTiming } : {}
+                });
+              }
+              throw error48;
+            }
+          };
           let nextHostHeartbeatAt = now() + settings.hostHeartbeatMs;
           hostHeartbeatLoop = (async () => {
             while (!drainRequested && !hostHeartbeatAbort.signal.aborted) {
@@ -32643,19 +32677,16 @@ var init_runner = __esm({
                 }
               }
               if (drainRequested || hostHeartbeatAbort.signal.aborted) return;
-              const heartbeatAttemptedAt = now();
+              const heartbeatDeadlineAtMs = Date.now() + settings.hostHeartbeatMs;
               const attemptedAdvertisementGeneration = receipt.advertisement_generation;
               try {
-                await hostHeartbeat(
-                  "healthy",
-                  { signal: hostHeartbeatAbort.signal },
-                  false,
+                await backgroundHostHeartbeat(
+                  attemptedAdvertisementGeneration,
                   // The server evaluates advertisement expiry when it receives
                   // the heartbeat. A request sent just before expiry can therefore
                   // truthfully return offline; the advertisement loop owns repair.
                   true,
-                  0,
-                  attemptedAdvertisementGeneration
+                  heartbeatDeadlineAtMs
                 );
               } catch (error48) {
                 if (hostHeartbeatAbort.signal.aborted || drainRequested) return;
@@ -32664,13 +32695,10 @@ var init_runner = __esm({
                 const recoveryAdvertisementGeneration = receipt.advertisement_generation > attemptedAdvertisementGeneration ? receipt.advertisement_generation : errorCode === "generation_stale" && pendingAdvertisement && pendingAdvertisement.advertisement_generation === attemptedAdvertisementGeneration + 1 ? pendingAdvertisement.advertisement_generation : null;
                 if (errorCode === "generation_stale" && recoveryAdvertisementGeneration !== null) {
                   try {
-                    await hostHeartbeat(
-                      "healthy",
-                      { signal: hostHeartbeatAbort.signal },
-                      false,
+                    await backgroundHostHeartbeat(
+                      recoveryAdvertisementGeneration,
                       false,
-                      0,
-                      recoveryAdvertisementGeneration
+                      heartbeatDeadlineAtMs
                     );
                     if (receipt.advertisement_generation < recoveryAdvertisementGeneration) {
                       await mutateReceipt((current) => current.advertisement_generation >= recoveryAdvertisementGeneration ? current : {
@@ -49839,6 +49867,8 @@ var init_network_debug = __esm({
         kind: input.kind,
         label: input.label,
         transport: "browser",
+        providerTransport: input.kind === "provider" ? input.providerTransport ?? "direct" : null,
+        actualRelayPath: input.kind === "provider" && input.providerTransport === "server_relay" ? "/llm/native-provider-relay" : null,
         method: (input.method || "POST").toUpperCase(),
         targetProtocol,
         targetHost,
@@ -92451,13 +92481,14 @@ var init_constraint_contract = __esm({
 });
 
 // lib/runtime/provider-observability.ts
-var record4, identifier, count3, normalizeProviderDiagnostics;
+var MAX_DIAGNOSTIC_LIST_ITEMS, record4, identifier, count3, normalizeProviderDiagnostics;
 var init_provider_observability = __esm({
   "lib/runtime/provider-observability.ts"() {
     "use strict";
     init_define_VTX_EXO_POLICY();
     init_define_VTX_GROK_POLICY();
     init_define_VTX_PI_MODEL_POLICY();
+    MAX_DIAGNOSTIC_LIST_ITEMS = 16;
     record4 = (v) => v !== null && typeof v === "object" && !Array.isArray(v) ? v : {};
     identifier = (v) => typeof v === "string" && /^[A-Za-z0-9][A-Za-z0-9_.:/-]{0,255}$/.test(v) ? v : void 0;
     count3 = (v) => {
@@ -92479,7 +92510,7 @@ var init_provider_observability = __esm({
         result2.quota_project_source = "provider_quota_subject";
       }
       if (Array.isArray(raw.quota_violations)) {
-        const violations = raw.quota_violations.slice(0, 16).map((item) => {
+        const violations = raw.quota_violations.slice(0, MAX_DIAGNOSTIC_LIST_ITEMS).map((item) => {
           const v = record4(item);
           const out = {};
           const metric = identifier(v.metric), id2 = identifier(v.id), value2 = count3(v.value);
@@ -92493,6 +92524,11 @@ var init_provider_observability = __esm({
         }).filter((v) => Object.keys(v).length > 0);
         if (violations.length) result2.quota_violations = violations;
       }
+      const outputValidation = record4(raw.output_validation);
+      if (Array.isArray(outputValidation.expected_symbols)) {
+        const symbols = outputValidation.expected_symbols.slice(0, MAX_DIAGNOSTIC_LIST_ITEMS).map(identifier).filter((symbol2) => symbol2 !== void 0);
+        if (symbols.length) result2.output_validation = { expected_symbols: [...new Set(symbols)] };
+      }
       return result2;
     };
   }

package/package.json

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