@vtxmacro/cli 2026.8.48 → 2026.8.50

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +14 -5
  2. package/bin/vtx.js +7152 -376
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -64,6 +64,13 @@ and VTX grant. VTX resolves the package-owned pinned Copilot platform runtime
64
64
  explicitly and rejects an `auto`-only catalog because it cannot prove the
65
65
  effective model.
66
66
 
67
+ An explicitly capable Codex model can also control Main in **Agent** mode using
68
+ the same VTX OAuth grant and private Codex login. VTX assigns the running bot but
69
+ does not send a VTX-authored prompt or set the analysis cadence. Codex keeps a
70
+ durable Agent thread, chooses when to wake, requests only the assignment-scoped
71
+ VTX data it needs (or none), and submits the normal structured decision for VTX
72
+ to validate and execute. Review and Screener remain Provider-only.
73
+
67
74
  Before the first Codex login, enable **Device code authorization for Codex** in
68
75
  ChatGPT Security settings. Only enter a device code from a login you initiated,
69
76
  and never share it. The automated host reads the authenticated Codex model
@@ -124,10 +131,12 @@ The command never kills an arbitrary process, logs either account out, changes
124
131
  VTX profile settings, or controls a Trader. If any package-owned VTX automation
125
132
  is still live, recovery fails closed and preserves its evidence.
126
133
 
127
- For each VTX profile and lane, **Subscription #1** is tried first and later
128
- compatible subscriptions follow in the saved Account cascade order.
129
- Quota/credits exhaustion, unusable authentication, and exhausted recoverable
130
- provider failures can advance the same logical call. VTX never changes
134
+ For each VTX profile and lane, **Host #1** is tried first and later compatible
135
+ hosts follow in the saved Host cascade order. Distinct computers may use the
136
+ same authenticated subscription; provider quota remains account-level.
137
+ Quota/credits exhaustion can advance only to a later host reporting a different
138
+ account identity. Unusable authentication and exhausted recoverable host failures
139
+ can advance the same logical call. VTX never changes
131
140
  provider, model, effort, or response mode, and never cascades a bad request,
132
141
  policy rejection, or uncertain dispatch outcome.
133
142
 
@@ -212,7 +221,7 @@ specific limitation instead of treating headless support alone as durability.
212
221
  Keep `agent-run` open in a separate terminal and keep calling `agent-next`
213
222
  while the host should remain available. The independent keeper preserves
214
223
  truthful liveness while the harness reasons. This same loop
215
- supports Main, Review, and Screener; Provider and Decision;
224
+ supports Main, Review, and Screener in Provider mode;
216
225
  and normally running VTX Client Mode or Server Mode bots. Server Mode keeps the
217
226
  normal VTX call fee. Client Mode has no VTX platform fee. Neither mode falls back
218
227
  to another model when the agent host is unavailable.