@battlegrid/mcp-server 32.0.29 → 32.0.31

package/dist/index.d.ts

@@ -47,7 +47,7 @@ import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/cli
  * 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 = "32.0.29";
+export declare const PACKAGE_VERSION = "32.0.31";
 export declare const DEFAULT_URL = "https://mcp.battlegrid.trade/mcp";
 export interface EnvConfig {
     apiKeys: string[];

package/dist/index.js

@@ -49,7 +49,7 @@ import { Client, SdkHttpError, StreamableHTTPClientTransport } from '@modelconte
  * 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 = '32.0.29';
+export const PACKAGE_VERSION = '32.0.31';
 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": "32.0.29",
+  "version": "32.0.31",
   "description": "BattleGrid MCP server — play crypto prediction games from AI agents",
   "type": "module",
   "main": "dist/index.js",

package/skills/EXPORT.json

@@ -1,24 +1,24 @@
 {
   "generator": "battlegrid-app/server/scripts/export-mcp-skills.mjs",
-  "contractVersion": "132.0.0",
+  "contractVersion": "135.0.0",
   "files": {
     "battlegrid-agent-management/SKILL.md": "91d1be4de1e33d54e1852c970af66ad176068fd16c30b4326e49053b7a35eb32",
     "battlegrid-agent-management/references/agent-stage-examples.md": "dffcc353d61dfc7b5bb6a2b3077fc6bf8c760a34c287cafb3b59b99306f24195",
     "battlegrid-arena-play/SKILL.md": "fdaabcd2e5ce3946ee96e553ce2e1931a822b84f91b0c94ce86a8bde0cc1d50f",
     "battlegrid-arena-play/references/entry-stage-examples.md": "0223f3743171ff213e943789d27590b2f65648398e85e10cd24938d5eb6af665",
     "battlegrid-market-analysis/SKILL.md": "fcbe98e30e1edce39bb170c224cdf20181934f62b5f3a26b293787c70eeb6229",
-    "battlegrid-officers/SKILL.md": "3fd59ec301d1492c956fbdb4368fef61f29abd137f02f49a6172351c7a563309",
+    "battlegrid-officers/SKILL.md": "0e5b4fd7a11fc1b6643eecd0008dfe1528b915ee00d0a99be9aca1e3934d57f7",
     "battlegrid-officers/references/officer-stage-examples.md": "ef46ba26f4b36c9964b5bde95fdf98e5952c3786b77be5f136056cac792f0aec",
     "battlegrid-radar-deployment/SKILL.md": "42900772033d799ce8eeeea9a433d76dd54fb5b153c83951753f73859dcfc021",
     "battlegrid-radar-deployment/references/arena-stage-examples.md": "d27cfed1f4663f267c4a7ecebe4a6e65a450fc74bd14ce8987fb61af5bbf2ca5",
     "battlegrid-radar-deployment/references/radar-stage-examples.md": "13fc3f55d91d3da9754e1ed7fb27493b7b7ba4d40a6a7e8d1ee0365f90ea10de",
-    "battlegrid-strategy-authoring/SKILL.md": "39cfa46b1f640e6800edb7e85a8f2c4b6b8786cddf71bb8244d172a44fc11d75",
+    "battlegrid-strategy-authoring/SKILL.md": "e2422b0e02de6d240bbab261ed1181b32d175bf877f499d7df556eca31ce5133",
     "battlegrid-strategy-authoring/references/strategy-stage-examples.md": "f10ecdc91f3660a708eee7a7bacefce2acbb46c9cf7e0ac1454bd54f839f39fd",
     "battlegrid-strategy-doctor/SKILL.md": "24c2208cf6832f1fc34e1b1c52acd8dae10f56b9860aaf27b450a62a9fb74634",
-    "battlegrid-strategy-examples/SKILL.md": "9d18bf0e4bf85a28508e2881a4cdf77b823ec831e7cec5d82f82dc251402f41c",
-    "battlegrid-strategy-examples/references/playbooks.md": "a9464789df2e762faf9dbd7845101564bc1847cd193f709f8ac4b6bff08f09dd",
-    "battlegrid-strategy-examples/references/recipes.md": "806aae0b4842408f6e6ed3e108293073f4f31d1c27fa419ad57df9e1134f23e7",
-    "battlegrid-strategy-examples/references/tradingview-ports.md": "c62ce72b741abe5a92e1dec6615f26b19a54959aa1d29542518cd9a189390b98",
+    "battlegrid-strategy-examples/SKILL.md": "0f652d0944b67bc8798d72779e98549ebbf5a3f183b16f1a79a549e6bb96e174",
+    "battlegrid-strategy-examples/references/playbooks.md": "59996c37eea08e7ce398e49304171939e55c968400a1603597d6737faf9e1771",
+    "battlegrid-strategy-examples/references/recipes.md": "95966649a68ec488a232b150328d94e9f80c45eff30be4da92caf305fba20fb0",
+    "battlegrid-strategy-examples/references/tradingview-ports.md": "de7be328c5cfada8fde700793b0c1c095a6660d9bf240cb57fe0026fcb56fea8",
     "battlegrid-trade-analysis/SKILL.md": "140d847f24e98845736d4f0c2e72b318a4d235413f72f072d2fe6d0daa5f64db",
     "battlegrid-trade-proposal/SKILL.md": "bf8f3794478cdecc989020bd775c3c91744f72b440b1a90f88f6700c9a61ca24"
   }

package/skills/battlegrid-officers/SKILL.md

@@ -60,7 +60,8 @@ own model and brief, over the agents its scope covers that closed a decision or
 since its last review — and answers before any review starts:
 
 - `QUEUED` with `agentCount`: the reviews arrive in `list_officer_reviews` as each finishes;
-- `NOTHING_TO_REVIEW`: no agent is under review, and nothing is queued or billed;
+- `NOTHING_TO_REVIEW`: no agent is under review, or the agents with something new are waiting on a proposal pushed
+  into the player's draft, and nothing is queued or billed;
 - `ALREADY_QUEUED`: a run of this officer is waiting or running.
 
 A run is per officer: to run two, call it for each. While one is waiting or running, `pendingRun` on `list_officers`
@@ -68,21 +69,25 @@ and `get_officer` names its state; read it again rather than calling `run_office
 `commanderAccess` from `get_account_state`, not `llmAccess`: show `deniedMessage` when it is not allowed. An
 archived officer is refused.
 
+An officer waits on an agent whose review by it is pushed: the player is adopting that proposal in the draft, so the
+officer reviews that agent again only once the draft is saved or discarded.
+
 **Never write a review.** The officer records its own; a second opinion on one of its reviews is your reading in
 the conversation, never a record.
 
 ## 3. Where each officer stands
 
 Read it, never compute it. `list_officers` serves each officer's `lastRunAt`, `nextRunAt` and `pendingRun`, and
-`list_officer_reviews` serves `openCountByOfficer`, each unarchived officer's open and pushed reviews. Quote them as
-served, through their display names.
+`list_officer_reviews` serves `openCountByOfficer`, each unarchived officer's reviews awaiting the player. Quote
+them as served, through their display names.
 
 ## 4. Work the inbox
 
 - **Read.** `list_officer_reviews`, by officer or by agent, newest first; `includeClosed` adds the applied,
   dismissed and superseded history. Show each review's verdict, findings, diff, impact and warnings exactly as
   served; `applyAvailable` says Apply is offered, `heldAxes` names every axis the target's draft holds and who wrote
-  it, and `baseMoved` says the target was committed since the review.
+  it, and `baseMoved` says the target was committed since the review. `awaitingOwner` says the review waits on the
+  player; a review that proposes no change (lever `NONE`) is for their information and never waits.
 - **Apply** with `apply_officer_proposal` only after an `ask_user` confirmation naming the review, its target and
   its axis, and only on the confirming pick. A client with no `ask_user` asks in its reply and waits for the
   player's word. Apply publishes the proposal to the live target; it needs `mcp:wager`.
@@ -92,7 +97,8 @@ served, through their display names.
 - **A refusal names its recovery** through `details.nextAct`: `BASE_MOVED` — the target moved since the review,
   dismiss it for a re-review; `AXIS_HELD` and `DRAFT_NOT_EMPTY` — the target's draft already holds work, so the
   player saves or discards it, or pushes instead of applying; `TARGET_NOT_OWNED` and `PROPOSAL_INVALID` — the target
-  no longer accepts the proposal, so dismiss it. A dismissed review is not run again until the agent closes a new
+  no longer accepts the proposal, so dismiss it. An action on a closed review is refused with its `reviewStatus`, and
+  a superseded one names its replacement as `supersededBy`: read that review instead. A dismissed review is not run again until the agent closes a new
   decision or the officer's setup changes.
 
 ## Reporting discipline

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

@@ -171,9 +171,13 @@ question you would otherwise guess — and a refusal you would otherwise earn:
   transform (and a chained transform) reads its series: the read shape, the window's unit, the price
   basis and what an absent bar does. `seriesHome` says where the metric's series is kept — `candle`,
   `history`, or `null` when the metric has no series, which is why a series transform does not
-  compose on it. Window and offset carry a declared `minimum` and a served `maximum` on each metric's
-  transform entry — the largest value whose read size fits the lookback cap, or `null` when none
-  does. Stage at most that maximum.
+  compose on it. Window and offset carry a declared `minimum` and a served `maximum` on the transform
+  entry — the largest value whose read size fits the lookback cap, or `null` when none does. For a
+  chained column the outer's declaration is `chainOuterParameters[outer]` (served beside `metric`)
+  and its bound is `chainedOuters[outer].windowMaximum`. The window carries a `unit`
+  (`seriesElements`, `seriesChanges` for `efficiency`, which reads one bar more than its window, or
+  `priorElements` for `pctl`). Stage at most that maximum. A chained column's operands come from
+  `chainedOuters[outer].operands`, never from the metric's full `spreadOperands`.
 - `get_metric_construction_hints` → `rankOrderings`. Present only when rank is composable on that
   metric, already range-gated server-side — read the offered set rather than deriving one from
   the metric's native output.

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

@@ -38,8 +38,13 @@ Before committing a CREATE, every "no" here is a decision to state, not an omiss
 | `spread` | `<base>_<operand>_spread` | `mark_oracle_spread` |
 | `aggregate` wN | `<code>_mean<N>` | `rate_mean24` |
 | `rank` | `<code>_rank_<hi\|lo\|far\|near>` — ordinal, `lte N` = top-N | `bbWidthPct_rank_lo` |
-| `efficiency` wN | `<code>_er` (1 straight, ~0 chop) | `close_ltf_er` |
+| `efficiency` wN | `<code>_er` (1 straight, ~0 chop) — N changes, reading N + 1 bars | `close_ltf_er` |
 | `maxShare` wN | `<code>_maxShare` | `volBase_ltf_maxShare` |
+| `zscore` wN | `<code>_z<N>` (population σ; bands ±1, ±2) | `RSI14_z20` |
+| `stddev` wN | `<code>_sd<N>` (population σ, the input's units) | `close_sd20` |
+| `linregSlope` wN | `<code>_slope<N>` (least-squares slope per bar) | `EMA20_slope20` |
+| `pctl` wN | `<code>_pctl<N>` (0–100 against the N prior bars) | `RSI14_pctl20` |
+| `rollingMin` / `rollingMax` wN | `<code>_min<N>` / `<code>_max<N>` | `low_min20`, `high_max20` |
 | `classifyZone` / `classifyState` | `<code>_zone` / `<code>_state` | `RSI14_zone`, `ADX14_state` |
 | `levelInteraction` | `<code>_lvl`, `<code>_lvl_b<N>` at a buffer of N bps | `bbUpper20_lvl`, `bbUpper20_lvl_b25` |
 | any, stored `"bars": "all"` | `<code>_dev`, then the transform's suffix | `RSI14_dev_t1` |
@@ -69,7 +74,7 @@ columns only for entry timing and risk — daily inputs then move once per daily
 stops and time decay keep managing intraday. **Benchmark sections** (`benchmarkTicker: "BTC"`,
 required-nullable on every custom section) read the benchmark's values on every row — the
 standard market-leader regime gate. Platform `sectionKey`s are their literal keys
-(`includeMtfConfluence`). Custom `sectionKey`s are the **server's** to issue, and which of the two
+(`includeHigherTimeframe`). Custom `sectionKey`s are the **server's** to issue, and which of the two
 things you do depends on the operation: on a **CREATE, omit `sectionKey` entirely** — supplying one
 is refused, since a new strategy owns no custom sections yet; on an **UPDATE or RESTORE, send back
 the keys `get_strategy` returned** for the sections you are keeping, and omit it on a section you
@@ -502,7 +507,8 @@ its side replaces it.
   clause over it reads FALSE.
 - **A swing level does not remember a broken level.** Two to four bars after a break the level steps
   to the next swing, so a retest of the BROKEN level is not a swing-level read.
-- **The two levels take** `distance`, `spread`, `aggregate`, `trajectory`, `efficiency` and
+- **The two levels take** `distance`, `spread`, `aggregate`, `trajectory`, `efficiency`, the
+  statistics (`zscore`, `stddev`, `linregSlope`, `pctl`, `rollingMin`, `rollingMax`) and
   `levelInteraction`, and both rank across the board
   (`dist_fractalHi_rank_near`: the coins closest to their own last swing high).
 - **The break is the crossing toward the level.** `dist_fractalHi crossesAbove 0` is a close through the

package/skills/battlegrid-strategy-examples/references/playbooks.md

@@ -61,13 +61,11 @@ every row reads BTC. Conditions: `BTC_RISK_ON` building block (`MAalign is "bull
 ATR floor 0.6%. PM: BE 1R; trail 1R giveback 45. Ranked cohort ≥ 40 —
 rank conditions need a cohort wider than their thresholds.
 
-### 4 · HTF Trend Pullback — 1h, multi-timeframe confluence
+### 4 · HTF Trend Pullback — 1h, higher-timeframe context
 
-Platform `includeMtfConfluence` (`MAalign_ltf/…/_htf`, `RSI14_*_zone`, `ADX14_*_state` vocab
-weak/developing/trending/extreme), `includeMovingAverages` (`dist_EMA20`, …), `includeRsi`
-(`RSI14_now`, `RSI14_zone`). These three render `MAalign` and `RSI14_zone` twice between them, so
-every condition below reads a suffixed form — never bare `MAalign` or bare `RSI14_zone`, which
-would be ambiguous. Conditions: `HTF_UP` building block (`MAalign_htf is "bullish"` +
+Platform `includeHigherTimeframe` (`MAalign_htf`, `RSI14_htf_zone`, `ADX14_htf_state` vocab
+weak/developing/trending/extreme), `includeMovingAverages` (`dist_EMA20`, `MAalign`, …),
+`includeRsi` (`RSI14_now`, `RSI14_zone`). Conditions: `HTF_UP` building block (`MAalign_htf is "bullish"` +
 `ADX14_htf_state in ["trending","extreme"]`); `HTF_DOWN` mirror; `TREND_PRESENT` **required**
 `ANY[ref HTF_UP, ref HTF_DOWN]` — chop blocks compose-trade entirely, before billing;
 `PULLBACK_LONG` verdict UP (ref HTF_UP + `RSI14_now between 35 55` +

package/skills/battlegrid-strategy-examples/references/recipes.md

@@ -30,7 +30,7 @@ rather than events all live there. This document assumes them.
 | Closed-bar-only trajectory | add `"bars": "closed"` to any trajectory | same, drawn from closed bars |
 | Extension from trend | `{ "metric": "SMA50", "transformId": "distance", "timeframe": { "rel": "anchor" } }` | `dist_SMA50` (signed %) |
 | Funding paid over a day | `{ "metric": "FUNDING_RATE", "transformId": "aggregate", "timeframe": { "rel": "anchor" }, "window": 24 }` | `rate_mean24` |
-| Chop filter on the entry rung | `{ "metric": "CLOSE", "transformId": "efficiency", "timeframe": { "rel": "lower" }, "window": 5, "bars": "closed" }` | `close_ltf_er` (≥0.6 directional) |
+| Chop filter on the entry rung | `{ "metric": "CLOSE", "transformId": "efficiency", "timeframe": { "rel": "lower" }, "window": 4, "bars": "closed" }` | `close_ltf_er` (≥0.6 directional; 4 changes, the last 5 closes) |
 | One-bar volume concentration | `{ "metric": "VOLUME", "transformId": "maxShare", "timeframe": { "rel": "lower" }, "window": 4, "bars": "closed" }` | `volBase_ltf_maxShare` |
 | Room to structure | `{ "metric": "STRUCT_ZONES", "transformId": "nearestZoneDist", "timeframe": { "rel": "regime" }, "side": "resistance" }` | `zones_htf_resist_dist` |
 | Last **closed** daily read | `{ "metric": "RSI14", "transformId": "value", "timeframe": { "abs": "1d" }, "bars": "closed" }` | `RSI14_1d` — the newest completed daily bar |

package/skills/battlegrid-strategy-examples/references/tradingview-ports.md

@@ -15,6 +15,7 @@ engine) and names its substitutions where the catalog lacks a primitive.
 - Pivot highs / lows, HH-HL structure and break of structure
 - Chaikin Money Flow
 - Now native, formerly substituted
+- Statistics over a series' own history
 
 ## TradingView ports — familiar processes, studio vocabulary
 
@@ -115,3 +116,20 @@ rules about the columns themselves, not about porting — they live in the skill
   `PRIOR_SWING_FRACTAL_HIGH`/`PRIOR_SWING_FRACTAL_LOW` and their ages
   `SWING_FRACTAL_HIGH_BARS_AGO`/`SWING_FRACTAL_LOW_BARS_AGO`), and Chaikin Money Flow (`CMF20`). Port
   these directly — do not offer a substitute for a primitive the catalog serves.
+- **Statistics over a series' own history** — the windowed transforms port the common Pine idioms
+  one for one, over any metric with a series and over a `distance` or `spread`:
+  - the `er` function of the common Pine libraries, `math.abs(x - x[n]) / math.sum(math.abs(x - x[1]), n)`,
+    is `x × efficiency` at window `n` — the window counts CHANGES, so `er(close, 10)` is window 10 and
+    reads 11 bars;
+  - the z-score idiom `(x - ta.sma(x, n)) / ta.stdev(x, n)` is `x × zscore` at window `n`
+    (`RSI14_z20`), population σ as `ta.stdev` defaults to, banded at ±1 and ±2;
+  - `ta.stdev(x, n)` is `x × stddev` (`close_sd20`, in the input's own units);
+  - `ta.percentrank(x, n)` is `x × pctl` at window `n` — the `n` bars BEFORE the newest, ties at or below;
+  - `ta.highest(x, n)` / `ta.lowest(x, n)` are `x × rollingMax` / `x × rollingMin` (`high_max20`
+    is `DONCHIAN_UPPER`'s same-bar rail);
+  - a linear-regression slope over `n` bars (TA-Lib's `LINEARREG_SLOPE`) is `x × linregSlope`, the
+    least-squares slope per bar — not Pine's `ta.linreg(x, n, 0) - ta.linreg(x, n, 1)`, which differs
+    two fits.
+
+  Each reads null where its newest or oldest bar holds no value, or where fewer bars exist than the
+  window reads.