@battlegrid/mcp-server 31.2.108 → 31.2.110

package/README.md

@@ -24,10 +24,36 @@ Seeing package `31.x` alongside handshake `battlegrid@33.x` — the package **be
 
 **What this changes for you:** nothing about how you call anything. Upgrading the package no longer waits on a server deploy, and a server deploy no longer strands you on a package that names the wrong contract — reconnect and the announcement follows. **Contract breaking-change notes are no longer keyed to package versions**, since a contract move is no longer a release here; the v11-and-earlier notes below are kept as history, and the live vocabulary is always discovery.
 
+## Contract history — v111.1 (every read fits hosted Claude, and a large one says so)
+
+**One refusal is added at v111.1; nothing you send is refused that was accepted.** v111.1 is the contract on top of
+v111. Reconnect the proxy, or restart it, so discovery reads the new schemas and the new resource.
+
+### Refusal vocabulary
+
+- **`RESULT_TOO_LARGE`.** A read-only tool whose result would serialize past the server's result-character cap
+  (at most 150,000, hosted Claude's tool-result cap) is refused whole, never cut, with details
+  `{ limit: "result_chars", actual, maximum }`. `get_market_context` (fewer `modules`), and `get_agent_journal`,
+  `list_gate_blocks` and `list_market_grid_sessions` (a smaller `limit`) add `nextAct: "narrow"`; a read with no
+  input that asks for less adds none. A tool that writes is never refused this way. The code also joins the draft
+  diagnostics' `code` enum.
+
+### Behaviour behind unchanged schemas
+
+- **The server instructions are an index within 4,096 characters**, the length Claude reads: the rules every session
+  needs, then one routing line per workflow naming its entry tool and skills. The workflow cards move to the
+  `battlegrid://guide/workflows` resource, and the grid format stays in `battlegrid://reference/grid-format`.
+- **Ten large reads declare `_meta["anthropic/maxResultSizeChars"]`** equal to the server's cap, so Claude Code keeps
+  their results in the conversation rather than moving them to a file.
+- **Input schemas hold each reused or recursive shape once, under named `$defs`**, where they pointed into a sibling
+  property; they accept exactly what they accepted. No schema publishes `{ "not": {} }`, and four strategy outputs
+  stop publishing `conditionVerdicts`, a property no response carried.
+- **Descriptions name their parameters instead of listing the members of an input enum**; the enum is the list.
+
 ## Contract history — v111 (the draft tools take their arguments at the top level)
 
 **Breaking at v111: every draft-lifecycle tool takes its id, `draftVersion` and payload as top-level
-arguments.** v111 is the contract on top of v110.12. Reconnect the proxy, or restart it, so discovery
+arguments.** v111 is the contract on top of v110.13. Reconnect the proxy, or restart it, so discovery
 reads the new schemas.
 
 ### Rejected input — something you send is no longer accepted
@@ -3635,8 +3661,9 @@ you reach over MCP:
 > fails CI on a hand edit. Change the skill upstream and let the export lane bring it here.
 
 A client connected to BattleGrid's remote server directly receives its `initialize` instructions:
-the rules that span tools and one routing card per workflow, each naming the `battlegrid-*` skill
-above that holds the full procedure. This proxy does not relay those instructions; the skills
+the rules that span tools and one routing line per workflow, each naming the `battlegrid-*` skill
+above that holds the full procedure, with the workflow cards in the `battlegrid://guide/workflows`
+resource. This proxy does not relay those instructions; the skills
 installed beside it carry the same workflows.
 
 ## License

package/dist/index.d.ts

@@ -48,7 +48,7 @@ import { type Implementation, type Prompt, type Resource } from '@modelcontextpr
  * being asked. Move it for a change to THIS package — a proxy fix, a dependency bump, a docs
  * correction. Never move it to track the server.
  */
-export declare const PACKAGE_VERSION = "31.2.108";
+export declare const PACKAGE_VERSION = "31.2.110";
 export declare const DEFAULT_URL = "https://mcp.battlegrid.trade/mcp";
 export interface EnvConfig {
     apiKeys: string[];

package/dist/index.js

@@ -51,7 +51,7 @@ import { ListToolsRequestSchema, CallToolRequestSchema, ListPromptsRequestSchema
  * being asked. Move it for a change to THIS package — a proxy fix, a dependency bump, a docs
  * correction. Never move it to track the server.
  */
-export const PACKAGE_VERSION = '31.2.108';
+export const PACKAGE_VERSION = '31.2.110';
 export const DEFAULT_URL = 'https://mcp.battlegrid.trade/mcp';
 const MAX_RETRIES = 3;
 const RETRY_DELAYS_MS = [2000, 4000, 8000];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@battlegrid/mcp-server",
-  "version": "31.2.108",
+  "version": "31.2.110",
   "description": "BattleGrid MCP server — play crypto prediction games from AI agents",
   "type": "module",
   "main": "dist/index.js",

package/skills/EXPORT.json

@@ -1,17 +1,17 @@
 {
   "generator": "battlegrid-app/server/scripts/export-mcp-skills.mjs",
-  "contractVersion": "110.10.0",
+  "contractVersion": "110.13.0",
   "files": {
     "battlegrid-agent-management/SKILL.md": "9dc151c32c3578d06e8895c6752d7a64959bff6a6681a01d62ab65e1ea1590d1",
-    "battlegrid-agent-management/references/agent-stage-examples.md": "d47555906ce8dedf4c17422f8f5d60187f2d6b3c0af5d9545617a10a5bdb59a1",
-    "battlegrid-arena-play/SKILL.md": "88534714cdbaa31344e1798b2b3f18836bf543f5610d118d76095d1a0dbea502",
-    "battlegrid-arena-play/references/entry-stage-examples.md": "3bc62f9faca7b5529d51a9794e162333216acb23f0d7f644d5180b9cbc696fca",
+    "battlegrid-agent-management/references/agent-stage-examples.md": "dffcc353d61dfc7b5bb6a2b3077fc6bf8c760a34c287cafb3b59b99306f24195",
+    "battlegrid-arena-play/SKILL.md": "2e37970a66b8738ffbc445a23da90651c1f41b56ce4eef551582ab123517ef74",
+    "battlegrid-arena-play/references/entry-stage-examples.md": "0223f3743171ff213e943789d27590b2f65648398e85e10cd24938d5eb6af665",
     "battlegrid-market-analysis/SKILL.md": "fcbe98e30e1edce39bb170c224cdf20181934f62b5f3a26b293787c70eeb6229",
-    "battlegrid-radar-deployment/SKILL.md": "652325c4923d79b9c9b78026a5493bfaaedf01f600641511438a9c4bf497c0b1",
-    "battlegrid-radar-deployment/references/arena-stage-examples.md": "f605aaa266a291ef1b6d02a0e8885ad5df2fea88c800be2b6625cd629cd741f2",
-    "battlegrid-radar-deployment/references/radar-stage-examples.md": "1ddad4a11f021dd65234ee65cc12d7d1561fe9acfd61cb021f4352080d4cecd5",
-    "battlegrid-strategy-authoring/SKILL.md": "5ce41e11d50658226230cfccb70a5c5f08e52755ef737c528d98872f239b3d4e",
-    "battlegrid-strategy-authoring/references/strategy-stage-examples.md": "9822cc2bcc8975a3e436c2a960b10e03c95e6e6b4b04bc2206e0ac90688cab66",
+    "battlegrid-radar-deployment/SKILL.md": "dfe8f354ac3dd426eedeac1ec080ac518e9c8cbfefdd26036afa61f80c08295c",
+    "battlegrid-radar-deployment/references/arena-stage-examples.md": "d27cfed1f4663f267c4a7ecebe4a6e65a450fc74bd14ce8987fb61af5bbf2ca5",
+    "battlegrid-radar-deployment/references/radar-stage-examples.md": "e3805f5c1b243135a7f25fb3a8cc6093dd242f8ad67b7e6b242bbdefa58a0735",
+    "battlegrid-strategy-authoring/SKILL.md": "39cfa46b1f640e6800edb7e85a8f2c4b6b8786cddf71bb8244d172a44fc11d75",
+    "battlegrid-strategy-authoring/references/strategy-stage-examples.md": "f10ecdc91f3660a708eee7a7bacefce2acbb46c9cf7e0ac1454bd54f839f39fd",
     "battlegrid-strategy-doctor/SKILL.md": "e34e055b0cc9b355bc1adeb5d49d464eaa0756ca3f48dc89ca2ccdda94e1311f",
     "battlegrid-strategy-examples/SKILL.md": "597ddacdfc00955fcfd5a1afcc40b5ea72a0f658acbbebc8264afeecc46d2306",
     "battlegrid-strategy-examples/references/playbooks.md": "2309eb7e8324f563c5b1b51e05da931b37c542484135a2be749eff6ef78aa40f",

package/skills/battlegrid-agent-management/references/agent-stage-examples.md

@@ -21,14 +21,12 @@ platform seed.
 
 ```json stage_agent_draft
 {
-  "request": {
-    "draftVersion": 0,
-    "axes": {
-      "IDENTITY": { "displayName": "Breakout Scout" },
-      "BEHAVIOR": { "behavior": { "risk": "MODERATE", "outlook": "REALIST", "conviction": "MEASURED" } },
-      "MODEL": { "modelId": "<MODEL_ID>" },
-      "STRATEGY_BINDING": { "strategyId": "<STRATEGY_ID>" }
-    }
+  "draftVersion": 0,
+  "axes": {
+    "IDENTITY": { "displayName": "Breakout Scout" },
+    "BEHAVIOR": { "behavior": { "risk": "MODERATE", "outlook": "REALIST", "conviction": "MEASURED" } },
+    "MODEL": { "modelId": "<MODEL_ID>" },
+    "STRATEGY_BINDING": { "strategyId": "<STRATEGY_ID>" }
   }
 }
 ```
@@ -39,12 +37,10 @@ BEHAVIOR is sent whole: all three of risk, outlook and conviction, even when onl
 
 ```json stage_agent_draft
 {
-  "request": {
-    "agentId": "<AGENT_ID>",
-    "draftVersion": 4,
-    "axes": {
-      "BEHAVIOR": { "behavior": { "risk": "CONSERVATIVE", "outlook": "REALIST", "conviction": "CAUTIOUS" } }
-    }
+  "agentId": "<AGENT_ID>",
+  "draftVersion": 4,
+  "axes": {
+    "BEHAVIOR": { "behavior": { "risk": "CONSERVATIVE", "outlook": "REALIST", "conviction": "CAUTIOUS" } }
   }
 }
 ```
@@ -53,12 +49,10 @@ BEHAVIOR is sent whole: all three of risk, outlook and conviction, even when onl
 
 ```json stage_agent_draft
 {
-  "request": {
-    "agentId": "<AGENT_ID>",
-    "draftVersion": 4,
-    "axes": {
-      "STRATEGY_BINDING": { "strategyId": "<STRATEGY_ID>" }
-    }
+  "agentId": "<AGENT_ID>",
+  "draftVersion": 4,
+  "axes": {
+    "STRATEGY_BINDING": { "strategyId": "<STRATEGY_ID>" }
   }
 }
 ```

package/skills/battlegrid-arena-play/SKILL.md

@@ -48,8 +48,10 @@ the enablement path there.
 
 ### 2. Workflow A reads, in order
 
-1. `list_market_grid_sessions` with status `PENDING` — the sessions still enterable. **The
-   `sessionId` you use comes from here; never fabricate one.**
+1. `list_market_grid_sessions` with status `PENDING`. A session accepts entries while it is PENDING
+   **and** its `lockAt` is still ahead — the status turns LIVE some time after the lock, so a session
+   can still read PENDING once entries have closed. **The `sessionId` you use comes from here; never
+   fabricate one.**
 2. `get_market_grid_session` — the coin pool (note each coin's `id`), the entry fee, the pool and
    the session's three instants: `startsAt` (the **Opening Bell** — the open of the one candle it
    scores), `lockAt` (entries close) and `settleAt` (the candle closes). Entries stay open through
@@ -60,13 +62,21 @@ the enablement path there.
 4. `check_market_grid_submission` — **before composing anything.** If a submission already exists,
    report it (with its id and time); while the session is still PENDING, a commit of the draft
    replaces its picks. Never compose a duplicate.
-5. `get_market_grid_entry_draft({ request: { sessionId } })` — what the draft holds now, the player's
+5. `get_market_grid_entry_draft({ sessionId })` — what the draft holds now, the player's
    own picks included, with the `draftVersion` and `committedRevision` your stage and commit name.
    Answer "what does my grid look like" from this read, never from a pick count.
 
+**Know the window before you spend it.** The first read already carries each session's `lockAt`:
+compare it with the current time — in Commander, every player turn carries the time it was sent — and
+tell the player how long remains before the rest of the reads use it up. A staged grid still needs the
+player's PLACE ENTRY, or your commit, before the lock. A `lockAt` already behind the current time
+means the session is **closed to entries even though it reads PENDING**: say so and point at the next
+session rather than composing for it — a stage or commit there is refused `CONFLICT` as closed to
+entries.
+
 ### 3. Compose — stage into the draft, and the reasoning is yours to get right
 
-`stage_market_grid_entry_draft({ request: { sessionId, draftVersion, axes } })`, naming the
+`stage_market_grid_entry_draft({ sessionId, draftVersion, axes })`, naming the
 `draftVersion` the read returned. Each cell axis is `{ cell: { coinId, prediction } }` — `coinId` the
 pool coin's `id` — or `{ cell: null }` to empty it. **Compose on top of what the draft holds**: a cell
 you do not stage keeps the player's pick, and you never discard their picks to start over unless they
@@ -103,7 +113,7 @@ say that rather than inventing a bar), whether it meets the threshold, and the p
 `impact` — `ENTER` with the `entryFee` the commit charges, or `REPLACE` for none. One confirmation
 naming **the session, that fee, and the confidence** — then commit on an explicit pick.
 
-- Direct → `commit_market_grid_entry_draft({ request: { sessionId, draftVersion, expectedRevision } })`,
+- Direct → `commit_market_grid_entry_draft({ sessionId, draftVersion, expectedRevision })`,
   naming exactly the `draftVersion` and `committedRevision` the last read returned (`null` with no
   entry). A refusal naming `get_draft` means the draft or the entry moved: read again and confirm
   again — never retry with a bumped number.
@@ -126,7 +136,8 @@ player's, and the attribution is part of what was scored.
 ### 5. After settlement
 
 - A session moves PENDING → LIVE → RESOLVING → SETTLED. It stays PENDING through the Opening Bell
-  window and goes LIVE at `lockAt`. Two states sit off that path: CANCELLED
+  window and turns LIVE once its lock has passed; entries close at `lockAt` itself, whatever the
+  status reads. Two states sit off that path: CANCELLED
   (entry fees refunded) and SETTLEMENT_QUARANTINED (settlement exhausted its retries and awaits an
   operator). Either one is the answer — report it as the status.
 - `get_market_grid_results` — available only once the session is SETTLED. Before that it returns a

package/skills/battlegrid-arena-play/references/entry-stage-examples.md

@@ -21,23 +21,21 @@ enter, each citing the market context you read.
 
 ```json stage_market_grid_entry_draft
 {
-  "request": {
-    "sessionId": "<SESSION_ID>",
-    "draftVersion": 0,
-    "axes": {
-      "CELL_0": { "cell": { "coinId": "<COIN_ID>", "prediction": "UP" } },
-      "CELL_1": { "cell": { "coinId": "<SECOND_COIN_ID>", "prediction": "DOWN" } },
-      "CELL_2": { "cell": { "coinId": "<THIRD_COIN_ID>", "prediction": "UP" } },
-      "RATIONALE": {
-        "reasoning": "The leader is breaking out on rising volume while the second coin rejects its range high.",
-        "confidenceScore": 0.7,
-        "modelName": "your-model-name",
-        "pickReasoning": [
-          { "coinId": "<COIN_ID>", "reasoning": "Breaking resistance on rising volume.", "confidence": 0.8 },
-          { "coinId": "<SECOND_COIN_ID>", "reasoning": "Bearish divergence at the range high.", "confidence": 0.6 },
-          { "coinId": "<THIRD_COIN_ID>", "reasoning": "Holding its trend above the session open.", "confidence": 0.6 }
-        ]
-      }
+  "sessionId": "<SESSION_ID>",
+  "draftVersion": 0,
+  "axes": {
+    "CELL_0": { "cell": { "coinId": "<COIN_ID>", "prediction": "UP" } },
+    "CELL_1": { "cell": { "coinId": "<SECOND_COIN_ID>", "prediction": "DOWN" } },
+    "CELL_2": { "cell": { "coinId": "<THIRD_COIN_ID>", "prediction": "UP" } },
+    "RATIONALE": {
+      "reasoning": "The leader is breaking out on rising volume while the second coin rejects its range high.",
+      "confidenceScore": 0.7,
+      "modelName": "your-model-name",
+      "pickReasoning": [
+        { "coinId": "<COIN_ID>", "reasoning": "Breaking resistance on rising volume.", "confidence": 0.8 },
+        { "coinId": "<SECOND_COIN_ID>", "reasoning": "Bearish divergence at the range high.", "confidence": 0.6 },
+        { "coinId": "<THIRD_COIN_ID>", "reasoning": "Holding its trend above the session open.", "confidence": 0.6 }
+      ]
     }
   }
 }
@@ -51,12 +49,10 @@ that coin changed.
 
 ```json stage_market_grid_entry_draft
 {
-  "request": {
-    "sessionId": "<SESSION_ID>",
-    "draftVersion": 4,
-    "axes": {
-      "CELL_1": { "cell": { "coinId": "<SECOND_COIN_ID>", "prediction": "UP" } }
-    }
+  "sessionId": "<SESSION_ID>",
+  "draftVersion": 4,
+  "axes": {
+    "CELL_1": { "cell": { "coinId": "<SECOND_COIN_ID>", "prediction": "UP" } }
   }
 }
 ```
@@ -65,21 +61,19 @@ that coin changed.
 
 ```json stage_market_grid_entry_draft
 {
-  "request": {
-    "sessionId": "<SESSION_ID>",
-    "draftVersion": 5,
-    "axes": {
-      "CELL_1": { "cell": { "coinId": "<SECOND_COIN_ID>", "prediction": "UP" } },
-      "RATIONALE": {
-        "reasoning": "The second coin reclaimed its range high, so it now runs with the leader.",
-        "confidenceScore": 0.65,
-        "modelName": "your-model-name",
-        "pickReasoning": [
-          { "coinId": "<COIN_ID>", "reasoning": "Breaking resistance on rising volume.", "confidence": 0.8 },
-          { "coinId": "<SECOND_COIN_ID>", "reasoning": "Reclaimed the range high on the last close.", "confidence": 0.6 },
-          { "coinId": "<THIRD_COIN_ID>", "reasoning": "Holding its trend above the session open.", "confidence": 0.6 }
-        ]
-      }
+  "sessionId": "<SESSION_ID>",
+  "draftVersion": 5,
+  "axes": {
+    "CELL_1": { "cell": { "coinId": "<SECOND_COIN_ID>", "prediction": "UP" } },
+    "RATIONALE": {
+      "reasoning": "The second coin reclaimed its range high, so it now runs with the leader.",
+      "confidenceScore": 0.65,
+      "modelName": "your-model-name",
+      "pickReasoning": [
+        { "coinId": "<COIN_ID>", "reasoning": "Breaking resistance on rising volume.", "confidence": 0.8 },
+        { "coinId": "<SECOND_COIN_ID>", "reasoning": "Reclaimed the range high on the last close.", "confidence": 0.6 },
+        { "coinId": "<THIRD_COIN_ID>", "reasoning": "Holding its trend above the session open.", "confidence": 0.6 }
+      ]
     }
   }
 }

package/skills/battlegrid-radar-deployment/SKILL.md

@@ -105,8 +105,8 @@ is test-routing a regime. Never carry a fact from a radar conversation into it,
    on duty, whether it trades once committed, and for a first deployment the coin cap
    (`admission.coinCapReached` true means the commit will be refused until a coin is un-deployed).
    Do not confirm a draft whose diagnostics carry an error: stage a fix.
-3. `preview_radar_resolution` with `request: { kind: "DRAFT", draftVersion }` at the version that read
-   returned. It composes the draft over the deployed policy **exactly as the commit will write it**,
+3. `preview_radar_resolution({ coinId, request: { kind: "DRAFT", draftVersion } })` at the version that
+   read returned. It composes the draft over the deployed policy **exactly as the commit will write it**,
    and refuses a draft no longer at that version with `DRAFT_VERSION_MOVED`.
 
 To try a slot set without touching the draft, preview `{ kind: "SLOTS", slots }` — it resolves
@@ -134,8 +134,8 @@ choose. Complete stage payloads for every row are in `references/radar-stage-exa
    and `REGIME_ANCHOR` (the anchor override, or null to inherit the arena's). Pausing is never staged.
 2. `get_deployment_policy_draft` — its `draftVersion`, `committedRevision`, diff, `diagnostics` and
    `impact` (the next session's resolution and whether it will play), exactly as for Radar.
-3. `preview_deployment_resolution` with `request: { kind: "DRAFT", draftVersion }` at the version
-   that read returned.
+3. `preview_deployment_resolution({ presetId, request: { kind: "DRAFT", draftVersion } })` at the
+   version that read returned.
 
 A draft that would hold no rule and no catch-all is a withdrawal, which a commit never does — that is
 `delete_deployment_policy` (step 4).
@@ -239,11 +239,11 @@ the reason — and **names what the change does to the stored policy**, read fro
 
 Then:
 
-- **Radar** → `commit_radar_deployment_draft({ request: { coinId, draftVersion, expectedRevision } })`,
+- **Radar** → `commit_radar_deployment_draft({ coinId, draftVersion, expectedRevision })`,
   naming exactly the `draftVersion` and `committedRevision` your draft read returned — the version
   your preview resolved. Ask with `ask_user` first and commit only after an explicit confirming pick.
   The axes it published leave the draft.
-- **Arena** → `commit_deployment_policy_draft({ request: { presetId, draftVersion, expectedRevision } })`,
+- **Arena** → `commit_deployment_policy_draft({ presetId, draftVersion, expectedRevision })`,
   the same way.
 
 **On `DRAFT_VERSION_MOVED` or a CONFLICT: re-read, re-preview, re-confirm.** In that order, and all
@@ -256,7 +256,7 @@ ask for again.
 
 **Pause a coin's Radar** → `pause_radar_deployment({ coinId })`. No preview and no revision: stopping
 never waits on a read. The player's draft keeps its content and is re-based onto the paused revision.
-**Resume** → preview the deployed policy with `request: { kind: "COMMITTED" }`, tell the player which
+**Resume** → preview the deployed policy with `preview_radar_resolution({ coinId, request: { kind: "COMMITTED" } })`, tell the player which
 agents will go on duty again, and on their word
 `resume_radar_deployment({ coinId, expectedPolicyId, expectedRevision })` naming the `policyId` and
 `revision` that preview returned — so it re-arms the policy the player was shown, or nothing.
@@ -274,8 +274,8 @@ same cancellation and refund as their own Cancel button. Say nothing is cancelle
 
 **Discard a draft** only on the player's word. Read it first and tell the player what it holds and
 when and from where it was last written; then
-`discard_radar_deployment_draft({ request: { coinId, draftVersion } })` or
-`discard_deployment_policy_draft({ request: { presetId, draftVersion } })` at **the version you read**.
+`discard_radar_deployment_draft({ coinId, draftVersion })` or
+`discard_deployment_policy_draft({ presetId, draftVersion })` at **the version you read**.
 If the draft moved since, it is refused with `DRAFT_VERSION_MOVED` and nothing is removed — read it
 again and show them.
 

package/skills/battlegrid-radar-deployment/references/arena-stage-examples.md

@@ -17,13 +17,11 @@ axis you omit keeps the value the draft already has.
 
 ```json stage_deployment_policy_draft
 {
-  "request": {
-    "presetId": "<PRESET_ID>",
-    "draftVersion": 0,
-    "axes": {
-      "DEFAULT_SLOT": {
-        "defaultSlot": { "agentId": "<AGENT_ID>", "minConfidence": null }
-      }
+  "presetId": "<PRESET_ID>",
+  "draftVersion": 0,
+  "axes": {
+    "DEFAULT_SLOT": {
+      "defaultSlot": { "agentId": "<AGENT_ID>", "minConfidence": null }
     }
   }
 }
@@ -33,19 +31,17 @@ axis you omit keeps the value the draft already has.
 
 ```json stage_deployment_policy_draft
 {
-  "request": {
-    "presetId": "<PRESET_ID>",
-    "draftVersion": 0,
-    "axes": {
-      "RULES": {
-        "rules": [
-          {
-            "agentId": "<AGENT_ID>",
-            "minConfidence": null,
-            "conditions": [{ "kind": "regime", "regimes": ["bull_expansion", "bull_ranging"] }]
-          }
-        ]
-      }
+  "presetId": "<PRESET_ID>",
+  "draftVersion": 0,
+  "axes": {
+    "RULES": {
+      "rules": [
+        {
+          "agentId": "<AGENT_ID>",
+          "minConfidence": null,
+          "conditions": [{ "kind": "regime", "regimes": ["bull_expansion", "bull_ranging"] }]
+        }
+      ]
     }
   }
 }
@@ -58,21 +54,19 @@ session occurrence, never both.
 
 ```json stage_deployment_policy_draft
 {
-  "request": {
-    "presetId": "<PRESET_ID>",
-    "draftVersion": 0,
-    "axes": {
-      "RULES": {
-        "rules": [
-          {
-            "agentId": "<AGENT_ID>",
-            "minConfidence": 0.6,
-            "conditions": [
-              { "kind": "session_start", "startTimes": ["14:00:00", "15:00:00"], "days": [1, 2, 3, 4, 5] }
-            ]
-          }
-        ]
-      }
+  "presetId": "<PRESET_ID>",
+  "draftVersion": 0,
+  "axes": {
+    "RULES": {
+      "rules": [
+        {
+          "agentId": "<AGENT_ID>",
+          "minConfidence": 0.6,
+          "conditions": [
+            { "kind": "session_start", "startTimes": ["14:00:00", "15:00:00"], "days": [1, 2, 3, 4, 5] }
+          ]
+        }
+      ]
     }
   }
 }
@@ -82,22 +76,20 @@ session occurrence, never both.
 
 ```json stage_deployment_policy_draft
 {
-  "request": {
-    "presetId": "<PRESET_ID>",
-    "draftVersion": 0,
-    "axes": {
-      "RULES": {
-        "rules": [
-          {
-            "agentId": "<AGENT_ID>",
-            "minConfidence": null,
-            "conditions": [
-              { "kind": "regime", "regimes": ["volatile"] },
-              { "kind": "session_start", "startTimes": ["14:00:00"], "days": [1, 2, 3, 4, 5] }
-            ]
-          }
-        ]
-      }
+  "presetId": "<PRESET_ID>",
+  "draftVersion": 0,
+  "axes": {
+    "RULES": {
+      "rules": [
+        {
+          "agentId": "<AGENT_ID>",
+          "minConfidence": null,
+          "conditions": [
+            { "kind": "regime", "regimes": ["volatile"] },
+            { "kind": "session_start", "startTimes": ["14:00:00"], "days": [1, 2, 3, 4, 5] }
+          ]
+        }
+      ]
     }
   }
 }
@@ -110,12 +102,10 @@ come together, or not at all.
 
 ```json stage_deployment_policy_draft
 {
-  "request": {
-    "presetId": "<PRESET_ID>",
-    "draftVersion": 2,
-    "axes": {
-      "REGIME_ANCHOR": { "regimeAnchor": { "regimeReferenceCoinId": "<COIN_ID>", "regimeTimeframe": "4h" } }
-    }
+  "presetId": "<PRESET_ID>",
+  "draftVersion": 2,
+  "axes": {
+    "REGIME_ANCHOR": { "regimeAnchor": { "regimeReferenceCoinId": "<COIN_ID>", "regimeTimeframe": "4h" } }
   }
 }
 ```
@@ -126,12 +116,10 @@ The arena's own anchor applies again.
 
 ```json stage_deployment_policy_draft
 {
-  "request": {
-    "presetId": "<PRESET_ID>",
-    "draftVersion": 2,
-    "axes": {
-      "REGIME_ANCHOR": { "regimeAnchor": null }
-    }
+  "presetId": "<PRESET_ID>",
+  "draftVersion": 2,
+  "axes": {
+    "REGIME_ANCHOR": { "regimeAnchor": null }
   }
 }
 ```

package/skills/battlegrid-radar-deployment/references/radar-stage-examples.md

@@ -21,12 +21,10 @@ on this coin" with no condition named.
 
 ```json stage_radar_deployment_draft
 {
-  "request": {
-    "coinId": "<COIN_ID>",
-    "draftVersion": 0,
-    "axes": {
-      "DEFAULT_SLOT": { "defaultSlot": { "agentId": "<AGENT_ID>", "minConviction": null } }
-    }
+  "coinId": "<COIN_ID>",
+  "draftVersion": 0,
+  "axes": {
+    "DEFAULT_SLOT": { "defaultSlot": { "agentId": "<AGENT_ID>", "minConviction": null } }
   }
 }
 ```
@@ -38,21 +36,19 @@ regime condition is the regime-reading floor, and must be a level one of the sel
 
 ```json stage_radar_deployment_draft
 {
-  "request": {
-    "coinId": "<COIN_ID>",
-    "draftVersion": 0,
-    "axes": {
-      "RULES": {
-        "rules": [
-          {
-            "agentId": "<AGENT_ID>",
-            "minConviction": null,
-            "conditions": [
-              { "kind": "regime", "regimes": ["bull_expansion", "bull_ranging"], "minConviction": "high" }
-            ]
-          }
-        ]
-      }
+  "coinId": "<COIN_ID>",
+  "draftVersion": 0,
+  "axes": {
+    "RULES": {
+      "rules": [
+        {
+          "agentId": "<AGENT_ID>",
+          "minConviction": null,
+          "conditions": [
+            { "kind": "regime", "regimes": ["bull_expansion", "bull_ranging"], "minConviction": "high" }
+          ]
+        }
+      ]
     }
   }
 }
@@ -64,21 +60,19 @@ Hours are UTC, 0–23. Days run 0 (Sunday) to 6. Each is listed once.
 
 ```json stage_radar_deployment_draft
 {
-  "request": {
-    "coinId": "<COIN_ID>",
-    "draftVersion": 0,
-    "axes": {
-      "RULES": {
-        "rules": [
-          {
-            "agentId": "<AGENT_ID>",
-            "minConviction": null,
-            "conditions": [
-              { "kind": "hours", "hours": [13, 14, 15, 16, 17, 18, 19, 20], "days": [1, 2, 3, 4, 5] }
-            ]
-          }
-        ]
-      }
+  "coinId": "<COIN_ID>",
+  "draftVersion": 0,
+  "axes": {
+    "RULES": {
+      "rules": [
+        {
+          "agentId": "<AGENT_ID>",
+          "minConviction": null,
+          "conditions": [
+            { "kind": "hours", "hours": [13, 14, 15, 16, 17, 18, 19, 20], "days": [1, 2, 3, 4, 5] }
+          ]
+        }
+      ]
     }
   }
 }
@@ -88,22 +82,20 @@ Hours are UTC, 0–23. Days run 0 (Sunday) to 6. Each is listed once.
 
 ```json stage_radar_deployment_draft
 {
-  "request": {
-    "coinId": "<COIN_ID>",
-    "draftVersion": 0,
-    "axes": {
-      "RULES": {
-        "rules": [
-          {
-            "agentId": "<AGENT_ID>",
-            "minConviction": 0.6,
-            "conditions": [
-              { "kind": "hours", "hours": [13, 14, 15, 16], "days": [1, 2, 3, 4, 5] },
-              { "kind": "regime", "regimes": ["volatile"] }
-            ]
-          }
-        ]
-      }
+  "coinId": "<COIN_ID>",
+  "draftVersion": 0,
+  "axes": {
+    "RULES": {
+      "rules": [
+        {
+          "agentId": "<AGENT_ID>",
+          "minConviction": 0.6,
+          "conditions": [
+            { "kind": "hours", "hours": [13, 14, 15, 16], "days": [1, 2, 3, 4, 5] },
+            { "kind": "regime", "regimes": ["volatile"] }
+          ]
+        }
+      ]
     }
   }
 }
@@ -117,21 +109,19 @@ first agent's regimes.
 
 ```json stage_radar_deployment_draft
 {
-  "request": {
-    "coinId": "<COIN_ID>",
-    "draftVersion": 0,
-    "axes": {
-      "RULES": {
-        "rules": [
-          {
-            "agentId": "<AGENT_ID>",
-            "minConviction": null,
-            "conditions": [{ "kind": "regime", "regimes": ["bear_expansion", "bear_ranging"] }]
-          }
-        ]
-      },
-      "DEFAULT_SLOT": { "defaultSlot": { "agentId": "<OTHER_AGENT_ID>", "minConviction": null } }
-    }
+  "coinId": "<COIN_ID>",
+  "draftVersion": 0,
+  "axes": {
+    "RULES": {
+      "rules": [
+        {
+          "agentId": "<AGENT_ID>",
+          "minConviction": null,
+          "conditions": [{ "kind": "regime", "regimes": ["bear_expansion", "bear_ranging"] }]
+        }
+      ]
+    },
+    "DEFAULT_SLOT": { "defaultSlot": { "agentId": "<OTHER_AGENT_ID>", "minConviction": null } }
   }
 }
 ```
@@ -144,12 +134,10 @@ returned.
 
 ```json stage_radar_deployment_draft
 {
-  "request": {
-    "coinId": "<COIN_ID>",
-    "draftVersion": 3,
-    "axes": {
-      "DEFAULT_SLOT": { "defaultSlot": null }
-    }
+  "coinId": "<COIN_ID>",
+  "draftVersion": 3,
+  "axes": {
+    "DEFAULT_SLOT": { "defaultSlot": null }
   }
 }
 ```

package/skills/battlegrid-strategy-authoring/SKILL.md

@@ -185,13 +185,13 @@ skill stays the authority on the flow.
 
 ### 4. Stage, and iterate on the diagnostics
 
-**Every change goes through the strategy's draft.** `stage_strategy_draft` takes, inside its
-`request`, the `strategyId`, the `draftVersion` your last read returned (0 when there was none) and
-the `axes` you propose. It writes those axes into the player's draft — attributed to you, landing in
-their builder as unsaved changes — and commits nothing. Each stage returns the draft's new
-`version`: that is the `draftVersion` your next stage names. Stage each change once, and never fire
-two stages in parallel against one draft. Complete stage payloads showing the envelope are in
-`references/strategy-stage-examples.md`.
+**Every change goes through the strategy's draft.**
+`stage_strategy_draft({ strategyId, draftVersion, axes })` takes the `strategyId`, the `draftVersion`
+your last read returned (0 when there was none) and the `axes` you propose. It writes those axes into
+the player's draft — attributed to you, landing in their builder as unsaved changes — and commits
+nothing. Each stage returns the draft's new `version`: that is the `draftVersion` your next stage
+names. Stage each change once, and never fire two stages in parallel against one draft. Complete
+stage payloads are in `references/strategy-stage-examples.md`.
 
 **A new strategy is a create draft.** Omit `strategyId` and send `draftVersion: 0` on the first
 stage; the response carries the id minted for it, which every later call names. A create needs

package/skills/battlegrid-strategy-authoring/references/strategy-stage-examples.md

@@ -1,10 +1,11 @@
 # Strategy stage examples
 
-`strategyId` and `draftVersion` sit beside `axes`, inside `request` — never inside `axes`. Every example below is
-checked in CI against the live `stage_strategy_draft` schema; a create example is also checked for the axes a new
-strategy needs. Its shape is current.
+Each example is the tool's whole input: `strategyId` and `draftVersion` sit at the top level beside `axes`, never
+inside `axes`. Every example below is checked in CI against the live
+`stage_strategy_draft` schema; a create example is also checked for the axes a new strategy needs. Its shape is
+current.
 
-These examples show the envelope and the small axes. A full composition (report sections, conditions, trade
+These examples show the input's shape and the small axes. A full composition (report sections, conditions, trade
 levels) is in `strategy-examples`' playbooks, which have their own compile gate.
 
 Every `<UPPER_SNAKE>` value is a placeholder: `<STRATEGY_ID>` is the id a read returned. Never send a placeholder as
@@ -19,16 +20,14 @@ and TIMEFRAME_PROFILE before it can be created.
 
 ```json stage_strategy_draft
 {
-  "request": {
-    "draftVersion": 0,
-    "axes": {
-      "IDENTITY": {
-        "name": "Squeeze Breakout",
-        "description": "Enters when a volatility squeeze resolves upward on rising volume.",
-        "tagline": "Buys the release of a tight range"
-      },
-      "TIMEFRAME_PROFILE": { "timeframe": "1h" }
-    }
+  "draftVersion": 0,
+  "axes": {
+    "IDENTITY": {
+      "name": "Squeeze Breakout",
+      "description": "Enters when a volatility squeeze resolves upward on rising volume.",
+      "tagline": "Buys the release of a tight range"
+    },
+    "TIMEFRAME_PROFILE": { "timeframe": "1h" }
   }
 }
 ```
@@ -40,16 +39,14 @@ a coin must clear before any condition is read; the other three are the stop-los
 
 ```json stage_strategy_draft
 {
-  "request": {
-    "strategyId": "<STRATEGY_ID>",
-    "draftVersion": 2,
-    "axes": {
-      "TRADE_LEVEL_POLICY": {
-        "minStopLossAtrMultiple": 1,
-        "maxStopLossAtrMultiple": 2,
-        "minRiskRewardRatio": 1.5,
-        "minAtrPct": 0.8
-      }
+  "strategyId": "<STRATEGY_ID>",
+  "draftVersion": 2,
+  "axes": {
+    "TRADE_LEVEL_POLICY": {
+      "minStopLossAtrMultiple": 1,
+      "maxStopLossAtrMultiple": 2,
+      "minRiskRewardRatio": 1.5,
+      "minAtrPct": 0.8
     }
   }
 }