@vtxmacro/cli 2026.9.66 → 2026.9.67

package/README.md

@@ -305,6 +305,7 @@ agent chooses its own cadence and may request zero, one, or many data calls:
 
 ```bash
 vtx inference-host agent-assignment-next --wait-seconds 50 --json
+vtx inference-host agent-review-begin --json
 vtx inference-host agent-data-call --json
 vtx inference-host agent-decision-submit --json
 vtx inference-host agent-decision-status --json

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.66",
+  package_version: "2026.9.67",
   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.66",
+      package_version: "2026.9.67",
       codex_package_name: "@openai/codex",
       codex_version: "0.155.0",
       copilot_sdk_package_name: "@github/copilot-sdk",
@@ -20773,7 +20773,7 @@ var init_mcp_transport = __esm({
 });
 
 // lib/inference-host/mcp-client.ts
-var EXTERNAL_INFERENCE_MCP_PROTOCOL_VERSION, EXTERNAL_INFERENCE_AUTOMATED_HOST_TOOLS, EXTERNAL_INFERENCE_OPERATIONAL_TOOLS, ClaimTiming, ExternalInferenceMcpError, DEFAULT_REQUEST_TIMEOUT_MS, MAX_RETRY_AFTER_MS, PUBLIC_TOOL_ERROR_PREFIX, parseRetryAfterMs, identifierSchema2, safeCodeSchema2, publicFailureCodeSchema, publicToolErrorSchema, structuredPublicToolErrorSchema, parsePublicToolError, hostMutationResultSchema, attemptStartResultSchema, agentConnectResultSchema, agentHeartbeatResultSchema, timestampSchema2, positiveGenerationSchema, jsonObjectSchema, agentAssignmentNextArgumentsSchema, agentDataCapabilityDescriptorSchema, agentAssignmentNextResultSchema, agentAssignmentHeartbeatArgumentsSchema, agentAssignmentHeartbeatResultSchema, agentDataCallArgumentsSchema, agentDataCallResultSchema, agentDecisionSubmitArgumentsSchema, agentDecisionSubmitResultSchema, agentDecisionStatusArgumentsSchema, agentDecisionStatusResultSchema, agentAssignmentReleaseArgumentsSchema, agentAssignmentReleaseResultSchema, jobCompletionResultSchema, jobFailureResultSchema, toolContracts, discoveryResultSchema, toolListResultSchema, inlineStructuredContentSchema, protocolMeta, parseJsonDocument, parseSseDocuments, parseResponseDocuments, exactOperationalInventory, exactJson, invalidBoundResult, verifyToolResult, ExternalInferenceMcpClient;
+var EXTERNAL_INFERENCE_MCP_PROTOCOL_VERSION, EXTERNAL_INFERENCE_AUTOMATED_HOST_TOOLS, EXTERNAL_INFERENCE_OPERATIONAL_TOOLS, ClaimTiming, ExternalInferenceMcpError, DEFAULT_REQUEST_TIMEOUT_MS, MAX_RETRY_AFTER_MS, PUBLIC_TOOL_ERROR_PREFIX, parseRetryAfterMs, identifierSchema2, safeCodeSchema2, publicFailureCodeSchema, publicToolErrorSchema, structuredPublicToolErrorSchema, parsePublicToolError, hostMutationResultSchema, attemptStartResultSchema, agentConnectResultSchema, agentHeartbeatResultSchema, timestampSchema2, positiveGenerationSchema, jsonObjectSchema, agentAssignmentNextArgumentsSchema, agentDataCapabilityDescriptorSchema, agentAssignmentNextResultSchema, agentAssignmentHeartbeatArgumentsSchema, agentAssignmentHeartbeatResultSchema, agentDataCallArgumentsSchema, agentDataCallResultSchema, agentDecisionTimingSchema, agentDecisionSubmitArgumentsSchema, agentDecisionSubmitResultSchema, agentDecisionStatusArgumentsSchema, agentDecisionStatusResultSchema, agentAssignmentReleaseArgumentsSchema, agentAssignmentReleaseResultSchema, jobCompletionResultSchema, jobFailureResultSchema, toolContracts, discoveryResultSchema, toolListResultSchema, inlineStructuredContentSchema, protocolMeta, parseJsonDocument, parseSseDocuments, parseResponseDocuments, exactOperationalInventory, exactJson, invalidBoundResult, verifyToolResult, ExternalInferenceMcpClient;
 var init_mcp_client = __esm({
   "lib/inference-host/mcp-client.ts"() {
     "use strict";
@@ -21096,13 +21096,23 @@ var init_mcp_client = __esm({
       warnings: external_exports.array(external_exports.unknown()),
       sources: external_exports.array(external_exports.unknown())
     });
+    agentDecisionTimingSchema = external_exports.strictObject({
+      analysis_started_at: timestampSchema2,
+      model_latency_ms: external_exports.number().int().nonnegative().nullable(),
+      model_latency_source: external_exports.literal("harness_invocation").nullable()
+    }).refine((timing) => timing.model_latency_ms === null === (timing.model_latency_source === null), {
+      message: "Model latency and its measurement source must be supplied together."
+    });
     agentDecisionSubmitArgumentsSchema = external_exports.strictObject({
       assignment_id: identifierSchema2,
       assignment_generation: positiveGenerationSchema,
       operation_id: identifierSchema2,
       candidate: jsonObjectSchema,
       observed_at: timestampSchema2,
+      timing: agentDecisionTimingSchema.optional(),
       provenance: jsonObjectSchema.nullable().optional()
+    }).refine((request) => !request.timing || Date.parse(request.timing.analysis_started_at) <= Date.parse(request.observed_at), {
+      message: "Analysis start must precede decision observation."
     });
     agentDecisionSubmitResultSchema = external_exports.strictObject({
       assignment_id: identifierSchema2,
@@ -30840,7 +30850,7 @@ async function clearInferenceAgentNextState(statePath) {
     "Agent-driven inference next recovery state"
   );
 }
-var inferenceAgentAttemptStatePath, inferenceAgentNextStatePath, inferenceAgentRuntimeStatePath, inferenceAgentFailureFencePath, isIsoTimestamp, assertPlainObject, hasExactKeys, assertInferenceAgentFailureFence, assertInferenceAgentRuntimeState, readCodexAgentRuntimeState, clearCodexAgentRuntimeState, foregroundAgentControlStatePath, assertRuntimeAssignment, assertForegroundAgentControlState, assertNextState, assertAttemptState;
+var inferenceAgentAttemptStatePath, inferenceAgentNextStatePath, assertDecisionTiming, inferenceAgentRuntimeStatePath, inferenceAgentFailureFencePath, isIsoTimestamp, assertPlainObject, hasExactKeys, assertInferenceAgentFailureFence, assertInferenceAgentRuntimeState, readCodexAgentRuntimeState, clearCodexAgentRuntimeState, foregroundAgentControlStatePath, assertRuntimeAssignment, assertForegroundAgentControlState, assertNextState, assertAttemptState;
 var init_agent_state = __esm({
   "lib/inference-host/agent-state.ts"() {
     "use strict";
@@ -30851,6 +30861,10 @@ var init_agent_state = __esm({
     init_external_inference_contract();
     inferenceAgentAttemptStatePath = (statePath) => `${statePath}.agent-attempt.json`;
     inferenceAgentNextStatePath = (statePath) => `${statePath}.agent-next.json`;
+    assertDecisionTiming = (value, observedAt, message) => {
+      const timing = assertPlainObject(value, message);
+      if (!hasExactKeys(timing, ["analysis_started_at", "model_latency_ms", "model_latency_source"]) || !isIsoTimestamp(timing.analysis_started_at) || Date.parse(timing.analysis_started_at) > Date.parse(String(observedAt)) || (timing.model_latency_ms === null ? timing.model_latency_source !== null : !Number.isSafeInteger(timing.model_latency_ms) || Number(timing.model_latency_ms) < 0 || timing.model_latency_source !== "harness_invocation")) throw new Error(message);
+    };
     inferenceAgentRuntimeStatePath = (statePath) => `${statePath}.codex-agent-runtime.json`;
     inferenceAgentFailureFencePath = (statePath) => `${statePath}.agent-failure-fence.json`;
     isIsoTimestamp = (value) => typeof value === "string" && Number.isFinite(Date.parse(value));
@@ -30962,9 +30976,14 @@ var init_agent_state = __esm({
           "observed_at",
           "provenance",
           "first_transmit_at",
-          "last_status_check_at"
+          "last_status_check_at",
+          ..."timing" in pending3 ? ["timing"] : []
         ]) || typeof pending3.operation_id !== "string" || !pending3.operation_id || !pending3.candidate || typeof pending3.candidate !== "object" || Array.isArray(pending3.candidate) || !isIsoTimestamp(pending3.observed_at) || pending3.provenance !== null && (typeof pending3.provenance !== "object" || Array.isArray(pending3.provenance)) || pending3.first_transmit_at !== null && !isIsoTimestamp(pending3.first_transmit_at) || pending3.last_status_check_at !== null && !isIsoTimestamp(pending3.last_status_check_at)) throw new Error(message);
       }
+      if (state.pending_decision && "timing" in state.pending_decision) {
+        const pending3 = state.pending_decision;
+        assertDecisionTiming(pending3.timing, pending3.observed_at, message);
+      }
       return state;
     };
     readCodexAgentRuntimeState = readInferenceAgentRuntimeState;
@@ -31012,9 +31031,15 @@ var init_agent_state = __esm({
         "pending_next",
         "pending_decision",
         "next_wake_at",
-        "updated_at"
+        "updated_at",
+        ..."review" in state ? ["review"] : []
       ]) || state.schema_version !== "vtx_foreground_agent_control_v1" || typeof state.host_id !== "string" || !state.host_id || state.next_wake_at !== null && !isIsoTimestamp(state.next_wake_at) || !isIsoTimestamp(state.updated_at)) throw new Error(message);
       if (state.assignment !== null) assertRuntimeAssignment(state.assignment, message);
+      if (state.review !== void 0 && state.review !== null) {
+        const review = assertPlainObject(state.review, message);
+        const assignment = state.assignment;
+        if (!hasExactKeys(review, ["assignment_id", "assignment_generation", "analysis_started_at"]) || !assignment || review.assignment_id !== assignment.assignment_id || review.assignment_generation !== assignment.assignment_generation || !isIsoTimestamp(review.analysis_started_at)) throw new Error(message);
+      }
       if (state.pending_next !== null) {
         const pending3 = assertPlainObject(state.pending_next, message);
         if (!hasExactKeys(pending3, ["operation_id", "requested_at"]) || typeof pending3.operation_id !== "string" || !pending3.operation_id || !isIsoTimestamp(pending3.requested_at)) throw new Error(message);
@@ -31028,13 +31053,15 @@ var init_agent_state = __esm({
           "last_status_check_at"
         ])) throw new Error(message);
         const request = assertPlainObject(pending3.request, message);
+        if ("timing" in request) assertDecisionTiming(request.timing, request.observed_at, message);
         if (!hasExactKeys(request, [
           "assignment_id",
           "assignment_generation",
           "operation_id",
           "candidate",
           "observed_at",
-          "provenance"
+          "provenance",
+          ..."timing" in request ? ["timing"] : []
         ]) || request.assignment_id !== state.assignment.assignment_id || request.assignment_generation !== state.assignment.assignment_generation || typeof request.operation_id !== "string" || !request.operation_id || !request.candidate || typeof request.candidate !== "object" || Array.isArray(request.candidate) || !isIsoTimestamp(request.observed_at) || !request.provenance || typeof request.provenance !== "object" || Array.isArray(request.provenance) || pending3.first_transmit_at !== null && !isIsoTimestamp(pending3.first_transmit_at) || pending3.last_status_check_at !== null && !isIsoTimestamp(pending3.last_status_check_at)) throw new Error(message);
       }
       return state;
@@ -34956,6 +34983,11 @@ var init_runner = __esm({
                   operation_id: randomUUID(),
                   candidate,
                   observed_at: nowIso(),
+                  timing: {
+                    analysis_started_at: state.pending_turn.started_at,
+                    model_latency_ms: null,
+                    model_latency_source: null
+                  },
                   provenance: {
                     source: "external_agent",
                     agent_run_id: liveThread.threadId,
@@ -34993,6 +35025,7 @@ var init_runner = __esm({
                     operation_id: pending3.operation_id,
                     candidate: pending3.candidate,
                     observed_at: pending3.observed_at,
+                    ...pending3.timing ? { timing: pending3.timing } : {},
                     provenance: pending3.provenance
                   }, { signal: turnAbort.signal });
                 } catch {
@@ -44537,6 +44570,13 @@ async function runInferenceHostCli(argv2, env = process.env, dependencies = {})
         dependencies
       );
     }
+    if (parsed.command === "agent-review-begin") {
+      return await withAgentCommandLock(
+        config2,
+        async () => await foregroundReviewBegin(config2, parsed, dependencies, warnings),
+        dependencies
+      );
+    }
     if (parsed.command === "agent-data-call") {
       return await foregroundDataCall(config2, parsed, dependencies, warnings);
     }
@@ -44597,7 +44637,7 @@ async function runInferenceHostCli(argv2, env = process.env, dependencies = {})
       return await cleanupLogin(config2, parsed, dependencies, warnings, true);
     }
     throw new Error(
-      "Usage: vtx inference-host <login|codex-login|grok-login|deepseek-login|pi-login|exo-login|run|agent-connect|agent-run|agent-next|agent-complete|agent-fail|agent-assignment-next|agent-assignment-heartbeat|agent-data-call|agent-decision-submit|agent-decision-status|agent-assignment-release|service|status|doctor|logout|codex-logout|grok-logout|deepseek-logout|pi-logout|exo-logout|revoke> [--json]"
+      "Usage: vtx inference-host <login|codex-login|grok-login|deepseek-login|pi-login|exo-login|run|agent-connect|agent-run|agent-next|agent-complete|agent-fail|agent-assignment-next|agent-assignment-heartbeat|agent-review-begin|agent-data-call|agent-decision-submit|agent-decision-status|agent-assignment-release|service|status|doctor|logout|codex-logout|grok-logout|deepseek-logout|pi-logout|exo-logout|revoke> [--json]"
     );
   } catch (error48) {
     return {
@@ -44608,7 +44648,7 @@ async function runInferenceHostCli(argv2, env = process.env, dependencies = {})
     };
   }
 }
-var INFERENCE_HOST_CLI_VERSION, runtimeReceiptPath, codexRecoveryPath, codexGuardianReceiptRoot, revocationCheckpointPath, foregroundHostLockPath, credentialLifecycleLockPath, serviceRecoveryCommandLockPath, AGENT_HEARTBEAT_INTERVAL_MS, AGENT_HEARTBEAT_MAX_RETRY_DELAY_MS, retryableAgentHeartbeatError, assertRevocationCheckpoint, readRevocationCheckpoint, writeRevocationCheckpoint, clearRevocationCheckpoint, render, INFERENCE_HOST_HELP, parseHostConcurrency, parseInferenceHostArgs, resolveDurableServiceDisplayName, defaultOpenBrowser, registerInferenceHostServiceControlInput, defaultRegisterLifecycleSignalHandlers, lifecycleCancellation, configuredCredentialStore, restoreInferenceHostCredentialContext, recoverInferenceHostCredentialContextTransition, accountKeyForState, assertCredentialMatchesState2, revocationCheckpointForCredential, assertRevocationCheckpointMatchesLocalIdentity, fileExistsPrivately, inspectCodexAuthentication, clearLocalRuntimeArtifacts, assertDurableServiceUninstalled, assertLocalRuntimeArtifactsMayBeDiscarded, defaultRunForeground, preparePortableDurableAdapter, prepareExoAdapter, defaultRunPortableDurableAdapter, login, codexLogin, codexLogout, grokAuthentication, deepSeekCredentialStore, deepSeekLogin, deepSeekLogout, piLogin, piLogout, exoLogin, exoLogout, localStatus, doctor, cleanupLogin, runHost, defaultReadStdin, parseAgentStdin, parseOptionalAgentStdin, agentOperationId, agentSession, agentConnect, foregroundAgentControlState, requireForegroundAgentState, assignmentFromClaim, foregroundAssignmentNext, foregroundAssignmentHeartbeat, foregroundDataCall, foregroundDecisionStatusRequest, foregroundAssignmentLeaseEnded, handleForegroundCancelledAssignment, foregroundDecisionFollowup, foregroundDecisionStatus, foregroundDecisionSubmit, foregroundAssignmentRelease, agentRun, agentNext, agentComplete, agentFail, withAgentCommandLock, recoveryBackupPath, serviceRecoveryTransactionPath, readServiceRecoveryTransaction, assertResumableCodexRecoveryEvidence, recoverInstalledCodexService, serviceCommand, hasExplicitCredentialStoreConfiguration, credentialEnvironmentForIdentity, commandRequiresRetainedCredentialStore, commandUsesInstalledServiceCredentials, resolveInferenceHostCommandConfig;
+var INFERENCE_HOST_CLI_VERSION, runtimeReceiptPath, codexRecoveryPath, codexGuardianReceiptRoot, revocationCheckpointPath, foregroundHostLockPath, credentialLifecycleLockPath, serviceRecoveryCommandLockPath, AGENT_HEARTBEAT_INTERVAL_MS, AGENT_HEARTBEAT_MAX_RETRY_DELAY_MS, retryableAgentHeartbeatError, assertRevocationCheckpoint, readRevocationCheckpoint, writeRevocationCheckpoint, clearRevocationCheckpoint, render, INFERENCE_HOST_HELP, parseHostConcurrency, parseInferenceHostArgs, resolveDurableServiceDisplayName, defaultOpenBrowser, registerInferenceHostServiceControlInput, defaultRegisterLifecycleSignalHandlers, lifecycleCancellation, configuredCredentialStore, restoreInferenceHostCredentialContext, recoverInferenceHostCredentialContextTransition, accountKeyForState, assertCredentialMatchesState2, revocationCheckpointForCredential, assertRevocationCheckpointMatchesLocalIdentity, fileExistsPrivately, inspectCodexAuthentication, clearLocalRuntimeArtifacts, assertDurableServiceUninstalled, assertLocalRuntimeArtifactsMayBeDiscarded, defaultRunForeground, preparePortableDurableAdapter, prepareExoAdapter, defaultRunPortableDurableAdapter, login, codexLogin, codexLogout, grokAuthentication, deepSeekCredentialStore, deepSeekLogin, deepSeekLogout, piLogin, piLogout, exoLogin, exoLogout, localStatus, doctor, cleanupLogin, runHost, defaultReadStdin, parseAgentStdin, parseOptionalAgentStdin, agentOperationId, agentSession, agentConnect, foregroundAgentControlState, requireForegroundAgentState, assignmentFromClaim, foregroundAssignmentNext, foregroundAssignmentHeartbeat, foregroundReviewBegin, foregroundDataCall, foregroundDecisionStatusRequest, foregroundAssignmentLeaseEnded, handleForegroundCancelledAssignment, foregroundDecisionFollowup, foregroundDecisionStatus, foregroundDecisionSubmit, foregroundAssignmentRelease, agentRun, agentNext, agentComplete, agentFail, withAgentCommandLock, recoveryBackupPath, serviceRecoveryTransactionPath, readServiceRecoveryTransaction, assertResumableCodexRecoveryEvidence, recoverInstalledCodexService, serviceCommand, hasExplicitCredentialStoreConfiguration, credentialEnvironmentForIdentity, commandRequiresRetainedCredentialStore, commandUsesInstalledServiceCredentials, resolveInferenceHostCommandConfig;
 var init_cli = __esm({
   "lib/inference-host/cli.ts"() {
     "use strict";
@@ -44729,6 +44769,7 @@ Commands:
   agent-fail      Submit one truthful agent failure from stdin
   agent-assignment-next       Claim the assigned Main bot for Agent control
   agent-assignment-heartbeat  Renew the current Agent assignment
+  agent-review-begin          Record review start before reading decision context
   agent-data-call             Request allowed assignment-scoped VTX data
   agent-decision-submit       Submit the normal structured trading decision
   agent-decision-status       Read a submitted decision outcome or recover uncertain submission
@@ -46446,6 +46487,7 @@ Waiting for approval...
             state = {
               ...state,
               assignment,
+              review: state.assignment?.assignment_id === assignment.assignment_id && state.assignment?.assignment_generation === assignment.assignment_generation ? state.review ?? null : null,
               pending_next: null,
               next_wake_at: null,
               updated_at: now().toISOString()
@@ -46462,7 +46504,8 @@ Waiting for approval...
             exitCode: 0,
             stdout: render({
               ...result2,
-              instructions: "Use your harness scheduler for the requested cadence and keep agent-run open for liveness. Use agent-data-call for canonical VTX data and your authorized native Insights/external tools. Trading JSON is optional; submit a decision only when you choose, using the exact output_schema. The keeper does not schedule or restart your harness.",
+              instructions: "Use your harness scheduler for the requested cadence and keep agent-run open for liveness. Call agent-review-begin before each review to record its actual analysis start. Use agent-data-call for canonical VTX data and your authorized native Insights/external tools. Trading JSON is optional; submit a decision only when you choose, using the exact output_schema. The keeper does not schedule or restart your harness.",
+              review_begin_command: "vtx inference-host agent-review-begin --json",
               data_command: "vtx inference-host agent-data-call --json",
               decision_command: "vtx inference-host agent-decision-submit --json",
               decision_input: {
@@ -46532,6 +46575,31 @@ Waiting for approval...
 ` : ""
       };
     };
+    foregroundReviewBegin = async (config2, parsed, dependencies, warnings) => {
+      const session = await agentSession(config2, dependencies, warnings);
+      const state = await requireForegroundAgentState(config2, session.localState.host_id);
+      if (state.pending_decision || state.pending_next) {
+        throw new Error("Resolve the pending Agent operation before beginning a review.");
+      }
+      await parseOptionalAgentStdin(dependencies, []);
+      const startedAt = (dependencies.now ?? (() => /* @__PURE__ */ new Date()))().toISOString();
+      const review = {
+        assignment_id: state.assignment.assignment_id,
+        assignment_generation: state.assignment.assignment_generation,
+        analysis_started_at: startedAt
+      };
+      await writeInferenceForegroundAgentControlState(config2.statePath, {
+        ...state,
+        review,
+        updated_at: startedAt
+      });
+      return { exitCode: 0, stdout: render({
+        ...review,
+        model_latency_ms: null,
+        model_latency_source: null
+      }, parsed.json), stderr: warnings.length ? `${warnings.join("\n")}
+` : "" };
+    };
     foregroundDataCall = async (config2, parsed, dependencies, warnings) => {
       const session = await agentSession(config2, dependencies, warnings);
       const state = await withAgentCommandLock(
@@ -46671,6 +46739,7 @@ Waiting for approval...
         const observedAt = now().toISOString();
         state = {
           ...state,
+          review: null,
           pending_decision: {
             request: {
               assignment_id: state.assignment.assignment_id,
@@ -46678,6 +46747,11 @@ Waiting for approval...
               operation_id: agentOperationId("agent-decision-submit"),
               candidate: input.candidate,
               observed_at: observedAt,
+              ...state.review ? { timing: {
+                analysis_started_at: state.review.analysis_started_at,
+                model_latency_ms: null,
+                model_latency_source: null
+              } } : {},
               provenance: input.provenance
             },
             first_transmit_at: null,

package/package.json

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