diff --git a/docs/awf-config-spec.md b/docs/awf-config-spec.md
index bf39cf622..8a1cbd364 100644
--- a/docs/awf-config-spec.md
+++ b/docs/awf-config-spec.md
@@ -110,6 +110,7 @@ AWF settings MAY be supplied via config files, including stdin (`--config -`).
 - `apiProxy.maxTurns` → *(config-only; no CLI equivalent)*
 - `apiProxy.maxRuns` → *(deprecated alias for `maxTurns`; maps to `AWF_MAX_RUNS`)*
 - `apiProxy.maxModelMultiplierCap` → `--max-model-multiplier-cap <number>`
+- `apiProxy.maxCacheMisses` → `--max-cache-misses <number>`
 - `apiProxy.maxPermissionDenied` → `--max-permission-denied <number>`
 - `apiProxy.requestedModel` → *(config-only; maps to `AWF_REQUESTED_MODEL` for pre-startup validation)*
 - `apiProxy.modelFallback` → *(config-only; model fallback strategy)*
diff --git a/schemas/token-usage.schema.json b/schemas/token-usage.schema.json
index b48603bb0..39ad7c99a 100644
--- a/schemas/token-usage.schema.json
+++ b/schemas/token-usage.schema.json
@@ -139,6 +139,31 @@
         "rate_reset": { "type": "string", "description": "X-RateLimit-Reset value (Unix timestamp)." }
       },
       "additionalProperties": true
+    },
+    "ai_credits_this_response": {
+      "type": "number",
+      "minimum": 0,
+      "description": "AI credits consumed by this API call. Computed from token counts and per-model pricing. Present only when apiProxy.maxAiCredits is configured."
+    },
+    "ai_credits_total": {
+      "type": "number",
+      "minimum": 0,
+      "description": "Cumulative AI credits consumed since the start of the run. Present only when apiProxy.maxAiCredits is configured."
+    },
+    "effective_tokens_this_response": {
+      "type": "number",
+      "minimum": 0,
+      "description": "Weighted effective tokens consumed by this API call (input×1 + cache_read×0.1 + output×4 + reasoning×4), scaled by the model multiplier. Present only when apiProxy.maxEffectiveTokens is configured."
+    },
+    "effective_tokens_total": {
+      "type": "number",
+      "minimum": 0,
+      "description": "Cumulative weighted effective tokens consumed since the start of the run. Present only when apiProxy.maxEffectiveTokens is configured."
+    },
+    "model_multiplier": {
+      "type": "number",
+      "exclusiveMinimum": 0,
+      "description": "Per-model cost multiplier applied to the effective token calculation for this request. Present only when apiProxy.maxEffectiveTokens is configured."
     }
   }
 }