@battlegrid/mcp-server 32.0.41 → 32.0.44

package/README.md

@@ -38,6 +38,31 @@ 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 — v137.3 (the bar's traded notional in USD)
+
+**Additive at v137.3: three metrics and one chart-axis family.** v137.3 is the contract on top of v137.2. Nothing a client
+sends is refused that v137.2 accepted. Reconnect the proxy, or restart it, so discovery reads the widened vocabulary.
+
+### Widened input — new metrics
+
+- **`QUOTE_VOL`** (`quoteVol`): the bar's traded notional in USD, the sum of each trade's price × size from the live tape.
+- **`BUY_QUOTE_VOL` and `SELL_QUOTE_VOL`** (`buyQuoteVol`, `sellQuoteVol`): the same, per taker side. The total is
+  always the two sides added.
+- **Each ranks exchange-wide**: one dollar is one dollar on every coin. The metric-key enum and the ranked-metric enum
+  widen on every input and output that carries them.
+- **A bar holding a minute the live tape did not cover reads each one absent, never zero.** An MDS restart opens such a
+  minute, so the bars around one read absent for now.
+
+### Widened output enum
+
+- **The chart-axis family gains `notional`**, the three metrics' own scale, on the output that carries it
+  (`get_agent_coin_qualification`'s `axisFamily`).
+
+### Digest move
+
+- **`vocabularyDigest` and the authoring catalog digest move** with the three metrics. A client caching vocabulary
+  against either re-reads `list_strategy_vocabulary`.
+
 ## Contract history — v137.2 (the anchored VWAP family with σ bands, and week and month profiles)
 
 **Additive at v137.2: sixty-six metrics and five studies, one value withdrawn, and the metric vocabulary named once per
@@ -77,11 +102,12 @@ proxy, or restart it, so discovery reads the widened vocabulary.
 - **`vocabularyDigest` and the authoring catalog digest move** with the sixty-six metrics and five studies. A client
   caching vocabulary against either re-reads `list_strategy_vocabulary`.
 
-## Contract history — v137.1 (a condition exit's evidence and slippage)
+## Contract history — v137.1 (a condition exit's evidence and slippage, and a spot venue's period bar over quiet minutes)
 
-**Additive at v137.1: one owner output field, and one served value moves.** v137.1 is the contract on top of v137.
-Nothing a client sends is refused that v137 accepted. Reconnect the proxy, or restart it, so discovery reads the widened
-output.
+**Additive at v137.1: one owner output field, three glosses re-worded, and served values move.** v137.1 is the
+contract on top of v137, announced once for two changes: a condition exit's evidence (#5809 in BattleGrid) and step 1
+of BattleGrid's spot-coverage fix (#5832). Nothing a client sends is refused that v137 accepted. Reconnect the proxy,
+or restart it, so discovery reads the widened output and the re-worded vocabulary.
 
 ### Widened output — the bars behind a condition exit
 
@@ -98,6 +124,32 @@ output.
 
 - **`slippageExit` on a `CONDITION_EXIT` close** is the exit average fill less the close of the bar the exit rule fired
   on, where it was null. Every other close kind is unchanged. `toolCount` stays 149.
+- **A spot venue's bar exists for a period it covered and traded in, though quiet minutes in it hold no bar.** A venue
+  period used to need a bar in every minute, so a thin coin that went more than its spot-tape freshness target (at
+  least 15 minutes) without a trade inside an hour lost that hour's venue bar. Now the bar exists whenever every minute
+  was covered and the venue traded in the period, or carried its last price through every minute. So
+  `SPOT_CLOSE_CB`, `SPOT_CLOSE_BN`, `SPOT_CLOSE_BYB`, `BUY_PRES_CB`, `BUY_PRES_BN`, `BUY_PRES_BYB`, the
+  `spot.venues.*` members, the five declared venue spreads (`SPOT_CLOSE_CB × spread(SPOT_CLOSE_BN)`,
+  `CLOSE × spread(SPOT_CLOSE_CB|BN|BYB)`, `BUY_PRES_CB × spread(BUY_PRES_BN)`), their exchange-wide ranks and the
+  venue-dislocation template's columns read a value for such a period where they read null.
+- **A closed venue close is that period's close at any age.** It is the venue's last trade in the period, as the
+  venue's own candle closes, even when that trade was early in the period; a closed reading is never aged. A spread
+  against the perp's close can therefore compare two instants on a thin venue. A Developing (forming) venue close is
+  still absent once older than the coin's spot-tape target.
+- **Unchanged:** the composite's flow, `SPOT_CVD`, `SPOT_AVG_TRADE` and `SPOT_DOMINANCE`. A period with a minute the
+  venue's feed and trade history both missed still has no venue bar.
+
+### Re-worded text — the spot close glosses
+
+- **`SPOT_CLOSE_CB`, `SPOT_CLOSE_BN` and `SPOT_CLOSE_BYB`** state when the venue's period bar exists: its close is the
+  venue's last trade in the period, or the price it carried through every minute of a period with no trade; it is
+  absent where a minute of the period went unseen, or where the coin did not trade on the venue and its price was not
+  carried through every minute. Each names its venue's quote currency from BattleGrid's declared quote policy.
+
+### Digest move
+
+- **`vocabularyDigest` and the authoring catalog digest move** with the three glosses. A client caching vocabulary
+  against either re-reads `list_strategy_vocabulary`.
 
 ## Contract history — v137 (TradingView's indicator math, Stoch RSI %K/%D, and a spread in points)
 

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.41";
+export declare const PACKAGE_VERSION = "32.0.44";
 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.41';
+export const PACKAGE_VERSION = '32.0.44';
 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.41",
+  "version": "32.0.44",
   "description": "BattleGrid MCP server — play crypto prediction games from AI agents",
   "type": "module",
   "main": "dist/index.js",

package/skills/EXPORT.json

@@ -1,6 +1,6 @@
 {
   "generator": "battlegrid-app/server/scripts/export-mcp-skills.mjs",
-  "contractVersion": "137.2.0",
+  "contractVersion": "137.3.0",
   "files": {
     "battlegrid-agent-management/SKILL.md": "91d1be4de1e33d54e1852c970af66ad176068fd16c30b4326e49053b7a35eb32",
     "battlegrid-agent-management/references/agent-stage-examples.md": "dffcc353d61dfc7b5bb6a2b3077fc6bf8c760a34c287cafb3b59b99306f24195",