agent-dealer 1.2.4 → 1.2.5

package/bundle/server/static-ui/index.html

@@ -8,8 +8,8 @@
     <link rel="apple-touch-icon" href="/apple-touch-icon.png" />
     <meta name="theme-color" content="#0a0e14" />
     <link rel="preload" href="/fonts/Monaco.ttf" as="font" type="font/ttf" crossorigin />
-    <script type="module" crossorigin src="/assets/index-UO4lHZw4.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-CYqRh_-S.css">
+    <script type="module" crossorigin src="/assets/index-Bq8wWpZm.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-BII-LgB8.css">
   </head>
   <body>
     <div id="root"></div>

package/bundle/shared/dist/agents.d.ts

@@ -13,13 +13,13 @@ export declare const CURSOR_SUBSCRIPTION_MODEL_IDS: readonly ["auto", "composer-
  */
 export declare const MUSE_CODE_CONTRIBUTOR_MODEL = "muse-spark-1.3-contributor";
 export declare const AgentHealthIssue: z.ZodObject<{
-    code: z.ZodEnum<["cli_missing", "runtime_auth", "runtime_unknown", "cursor_keychain", "usage_capped", "deck_offline", "deck_unauthorized", "workspace_missing", "deck_missing", "mcp_not_registered", "github_cli_missing", "github_auth", "github_unreachable"]>;
+    code: z.ZodEnum<["cli_missing", "runtime_auth", "runtime_unknown", "runtime_capability", "cursor_keychain", "usage_capped", "deck_offline", "deck_unauthorized", "workspace_missing", "deck_missing", "mcp_not_registered", "github_cli_missing", "github_auth", "github_unreachable"]>;
     message: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+    code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
     message: string;
 }, {
-    code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+    code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
     message: string;
 }>;
 export type AgentHealthIssue = z.infer<typeof AgentHealthIssue>;
@@ -158,20 +158,20 @@ export declare const AgentWithHealth: z.ZodObject<{
 } & {
     healthy: z.ZodBoolean;
     issues: z.ZodArray<z.ZodObject<{
-        code: z.ZodEnum<["cli_missing", "runtime_auth", "runtime_unknown", "cursor_keychain", "usage_capped", "deck_offline", "deck_unauthorized", "workspace_missing", "deck_missing", "mcp_not_registered", "github_cli_missing", "github_auth", "github_unreachable"]>;
+        code: z.ZodEnum<["cli_missing", "runtime_auth", "runtime_unknown", "runtime_capability", "cursor_keychain", "usage_capped", "deck_offline", "deck_unauthorized", "workspace_missing", "deck_missing", "mcp_not_registered", "github_cli_missing", "github_auth", "github_unreachable"]>;
         message: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+        code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
         message: string;
     }, {
-        code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+        code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
         message: string;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     defaultPlanModel: string | null;
     defaultExecuteModel: string | null;
     issues: {
-        code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+        code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
         message: string;
     }[];
     id: string;
@@ -198,7 +198,7 @@ export declare const AgentWithHealth: z.ZodObject<{
     defaultPlanModel: string | null;
     defaultExecuteModel: string | null;
     issues: {
-        code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+        code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
         message: string;
     }[];
     id: string;
@@ -390,20 +390,20 @@ export declare const AgentsSnapshot: z.ZodObject<{
     } & {
         healthy: z.ZodBoolean;
         issues: z.ZodArray<z.ZodObject<{
-            code: z.ZodEnum<["cli_missing", "runtime_auth", "runtime_unknown", "cursor_keychain", "usage_capped", "deck_offline", "deck_unauthorized", "workspace_missing", "deck_missing", "mcp_not_registered", "github_cli_missing", "github_auth", "github_unreachable"]>;
+            code: z.ZodEnum<["cli_missing", "runtime_auth", "runtime_unknown", "runtime_capability", "cursor_keychain", "usage_capped", "deck_offline", "deck_unauthorized", "workspace_missing", "deck_missing", "mcp_not_registered", "github_cli_missing", "github_auth", "github_unreachable"]>;
             message: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }, {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         issues: {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }[];
         id: string;
@@ -430,7 +430,7 @@ export declare const AgentsSnapshot: z.ZodObject<{
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         issues: {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }[];
         id: string;
@@ -460,7 +460,7 @@ export declare const AgentsSnapshot: z.ZodObject<{
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         issues: {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }[];
         id: string;
@@ -490,7 +490,7 @@ export declare const AgentsSnapshot: z.ZodObject<{
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         issues: {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }[];
         id: string;

package/bundle/shared/dist/agents.js

@@ -24,6 +24,12 @@ export const AgentHealthIssue = z.object({
          * classified auth failure). Reported as unknown rather than guessed at (NOT-178).
          */
         "runtime_unknown",
+        /**
+         * The runtime's reported version changed and its developer capability (Muse Code: shell/write
+         * access) is missing, not yet verified, or could not be verified on the new binary (NOT-277).
+         * The message names the old and new versions and the capability.
+         */
+        "runtime_capability",
         /**
          * Cursor macOS keychain stuck (errSecDuplicateItem / exit 45) — sessions die mid-run
          * even when status briefly looked logged-in (NOT-114 / NOT-103).

package/bundle/shared/dist/index.d.ts

@@ -1953,20 +1953,20 @@ export declare const QueueSnapshot: z.ZodObject<{
     } & {
         healthy: z.ZodBoolean;
         issues: z.ZodArray<z.ZodObject<{
-            code: z.ZodEnum<["cli_missing", "runtime_auth", "runtime_unknown", "cursor_keychain", "usage_capped", "deck_offline", "deck_unauthorized", "workspace_missing", "deck_missing", "mcp_not_registered", "github_cli_missing", "github_auth", "github_unreachable"]>;
+            code: z.ZodEnum<["cli_missing", "runtime_auth", "runtime_unknown", "runtime_capability", "cursor_keychain", "usage_capped", "deck_offline", "deck_unauthorized", "workspace_missing", "deck_missing", "mcp_not_registered", "github_cli_missing", "github_auth", "github_unreachable"]>;
             message: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }, {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         issues: {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }[];
         id: string;
@@ -1993,7 +1993,7 @@ export declare const QueueSnapshot: z.ZodObject<{
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         issues: {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }[];
         id: string;
@@ -2023,7 +2023,7 @@ export declare const QueueSnapshot: z.ZodObject<{
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         issues: {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }[];
         id: string;
@@ -2295,7 +2295,7 @@ export declare const QueueSnapshot: z.ZodObject<{
         defaultPlanModel: string | null;
         defaultExecuteModel: string | null;
         issues: {
-            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
+            code: "cli_missing" | "runtime_auth" | "runtime_unknown" | "runtime_capability" | "cursor_keychain" | "usage_capped" | "deck_offline" | "deck_unauthorized" | "workspace_missing" | "deck_missing" | "mcp_not_registered" | "github_cli_missing" | "github_auth" | "github_unreachable";
             message: string;
         }[];
         id: string;

package/bundle/shared/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-dealer/shared",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/doctor.d.ts

@@ -23,7 +23,7 @@ export declare function describeCursorIndividualLogin(status: {
 export declare function checkCursorIndividualLogin(): Promise<CursorIndividualLoginReport>;
 /** Env override for the Claude cache file (tests/smoke). */
 export declare const CLAUDE_CAPACITY_CACHE_FILE_ENV = "AGENT_DEALER_CLAUDE_CACHE_FILE";
-/** Paid-fallback setting: enabled by default; `off` disables it. */
+/** Refresh setting: enabled by default (free `/usage` check); `off` disables it. */
 export declare const CLAUDE_CAPACITY_REFRESH_ENV = "AGENT_DEALER_CLAUDE_CAPACITY_REFRESH";
 export declare const CLAUDE_CAPACITY_REFRESH_PAID_VALUE = "paid-after-1h";
 export declare const CLAUDE_CAPACITY_REFRESH_OFF_VALUE = "off";
@@ -43,8 +43,12 @@ export declare function describeClaudeCapacitySource(status: {
     ageMs: number | null;
 } | null | undefined): ClaudeCapacitySourceReport;
 /**
- * Map the paid-fallback setting to its warning line, or null when explicitly
- * disabled (or unrecognized). Unset/empty is the paid-after-1h default.
+ * Map the refresh setting to a note, or null when it's enabled (the default
+ * — nothing to flag: the refresh is a free `/usage` local-command call, not
+ * a paid probe, since a 2026-09-27 live proof found and fixed the original
+ * paid-turn design; see docs/RUNTIME_CAPACITY.md). Only when explicitly
+ * disabled (`off`, or any unrecognized value) does this return a note that
+ * the capacity strip may go stale between Dealer-managed runs without it.
  * Pure (no I/O): unit tests pin both states here.
  */
 export declare function describeClaudeProbeOptIn(setting: string | undefined): string | null;

package/dist/doctor.js

@@ -109,9 +109,9 @@ export async function runDoctor() {
         }
         // NOT-268: Claude account capacity source status (informational only —
         // never fails doctor). Reports whether Claude Code's own local 5H/1W
-        // cache exists and how old it is, plus whether the paid fallback probe
-        // is armed. Age labels only: never utilization values, prompts, tokens,
-        // or account ids.
+        // cache exists and how old it is, plus whether the free `/usage` refresh
+        // is disabled. Age labels only: never utilization values, prompts,
+        // tokens, or account ids.
         try {
             console.log((await checkClaudeCapacitySource()).line);
             const probe = describeClaudeProbeOptIn(process.env.AGENT_DEALER_CLAUDE_CAPACITY_REFRESH);
@@ -264,7 +264,7 @@ export async function checkCursorIndividualLogin() {
 // ---------------------------------------------------------------------------
 /** Env override for the Claude cache file (tests/smoke). */
 export const CLAUDE_CAPACITY_CACHE_FILE_ENV = "AGENT_DEALER_CLAUDE_CACHE_FILE";
-/** Paid-fallback setting: enabled by default; `off` disables it. */
+/** Refresh setting: enabled by default (free `/usage` check); `off` disables it. */
 export const CLAUDE_CAPACITY_REFRESH_ENV = "AGENT_DEALER_CLAUDE_CAPACITY_REFRESH";
 export const CLAUDE_CAPACITY_REFRESH_PAID_VALUE = "paid-after-1h";
 export const CLAUDE_CAPACITY_REFRESH_OFF_VALUE = "off";
@@ -282,7 +282,7 @@ export function describeClaudeCapacitySource(status) {
         }
         return {
             kind: "stale",
-            line: `⚠ Claude capacity: local 5H/1W cache stale (${formatCacheAge(status.ageMs)} old — refreshes on the next Claude run)`,
+            line: `⚠ Claude capacity: local 5H/1W cache stale (${formatCacheAge(status.ageMs)} old — Dealer refreshes it for free on the next capacity check, unless AGENT_DEALER_CLAUDE_CAPACITY_REFRESH=off)`,
         };
     }
     return {
@@ -302,16 +302,21 @@ function formatCacheAge(ageMs) {
     return `${Math.floor(hours / 24)}d`;
 }
 /**
- * Map the paid-fallback setting to its warning line, or null when explicitly
- * disabled (or unrecognized). Unset/empty is the paid-after-1h default.
+ * Map the refresh setting to a note, or null when it's enabled (the default
+ * — nothing to flag: the refresh is a free `/usage` local-command call, not
+ * a paid probe, since a 2026-09-27 live proof found and fixed the original
+ * paid-turn design; see docs/RUNTIME_CAPACITY.md). Only when explicitly
+ * disabled (`off`, or any unrecognized value) does this return a note that
+ * the capacity strip may go stale between Dealer-managed runs without it.
  * Pure (no I/O): unit tests pin both states here.
  */
 export function describeClaudeProbeOptIn(setting) {
-    if (setting === undefined || setting === "" || setting === CLAUDE_CAPACITY_REFRESH_PAID_VALUE) {
-        return ("⚠ Claude capacity paid fallback: enabled (one ≤$0.01 Haiku probe after 1h stale — " +
-            `set ${CLAUDE_CAPACITY_REFRESH_ENV}=${CLAUDE_CAPACITY_REFRESH_OFF_VALUE} to disable)`);
-    }
-    return null;
+    const enabled = setting === undefined || setting === "" || setting === CLAUDE_CAPACITY_REFRESH_PAID_VALUE;
+    if (enabled)
+        return null;
+    return ("⚠ Claude capacity auto-refresh disabled " +
+        `(${CLAUDE_CAPACITY_REFRESH_ENV}=${setting}) — the strip may go stale between ` +
+        "Dealer-managed runs; the refresh itself is free (one local `/usage` check, no model call)");
 }
 // ---------------------------------------------------------------------------
 // Muse capacity paid-fallback reporting for doctor.

package/dist/doctor.test.js

@@ -189,16 +189,17 @@ test("describe maps each cache state to its static line", () => {
         assert.match(report.line, /no local 5H\/1W cache/);
     }
 });
-test("probe warning appears for the default and explicit paid value", () => {
+test("refresh note is silent by default; appears only when explicitly disabled", () => {
     for (const setting of [undefined, "", CLAUDE_CAPACITY_REFRESH_PAID_VALUE]) {
-        const armed = describeClaudeProbeOptIn(setting);
-        assert.ok(armed);
-        assert.match(armed, /enabled/);
-        assert.match(armed, /≤\$0\.01/);
-        assert.match(armed, /=off/);
+        assert.equal(describeClaudeProbeOptIn(setting), null);
+    }
+    for (const setting of ["off", "auto"]) {
+        const note = describeClaudeProbeOptIn(setting);
+        assert.ok(note);
+        assert.match(note, /disabled/);
+        assert.match(note, /free/);
+        assert.match(note, new RegExp(`${CLAUDE_CAPACITY_REFRESH_ENV}=${setting}`));
     }
-    assert.equal(describeClaudeProbeOptIn("off"), null);
-    assert.equal(describeClaudeProbeOptIn("auto"), null);
 });
 test("Muse paid-fallback warning matches server defaults and legacy no-spend precedence", () => {
     for (const setting of [undefined, "", MUSE_CAPACITY_REFRESH_PAID_VALUE]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-dealer",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "description": "Human control plane for agent execution — queue, plan approval, audit",
   "license": "MIT",
   "type": "module",