@battlegrid/mcp-server 31.2.79 → 31.2.81

package/README.md

@@ -24,6 +24,99 @@ 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 — v99 (your arena entries are one owner-only history)
+
+**Breaking at v99: four tools are retired, two are added, and `get_agent_journal` loses a field.** v99 is
+the contract on top of v98.
+
+Every Market Grid entry you made — by your deployed agent, an agent you asked for, an MCP client,
+Commander, a grid you built or dice you rolled — is now read from one history, and only by you.
+
+### Removed tools
+
+- **`get_agent_game_history`, `get_user_agent_game_history`, `get_public_agent_game_history` and
+  `get_mcp_reasoning_journal`** are gone, with no alias; a call gets an unknown-tool error. The
+  replacements:
+  - `get_agent_game_history { agentId }` → `list_my_market_grid_entries { agentId }`;
+  - `get_user_agent_game_history` → `list_my_market_grid_entries` with no `agentId`;
+  - `get_public_agent_game_history` → none: arena entry history is owner-only, so no public read
+    replaces it;
+  - `get_mcp_reasoning_journal { sessionId }` → `get_my_market_grid_entry { sessionId }`, whose
+    `reasoning` is the reasoning recorded with the entry's picks.
+
+### Added tools
+
+- **`list_my_market_grid_entries { window?, outcome?, source?, agentId?, cursor?, limit? }`** (`mcp:read`)
+  pages every entry you made, newest first by its first submission. `outcome` is `PLAYED` (the default:
+  every entry except a cancelled one), `IN_PLAY`, `PAID` (a payout above zero), `NOT_PAID` or
+  `CANCELLED`; `source` and `agentId` filter by the entry's original author. The same read returns one
+  count per outcome, a summary (paid rate, totals, net, averages) and the agents you can filter by. Page
+  with `nextCursor`.
+- **`get_my_market_grid_entry { sessionId }`** (`mcp:read`) returns your entry in one session — the same
+  record a list row carries. A session you never entered is `NOT_FOUND`.
+- Each entry carries its `entryState` (`WON`, `PLACED`, `NO_WIN`, `VOID_NO_SUBMISSION`, `IN_PLAY` or
+  `CANCELLED`), its `entryFee` and signed `netPnl` (null while in play or cancelled), a cancelled entry's
+  `refundState`, its `originalSource` and original `agent`, and `edited` — true once another author has
+  rewritten the picks. `reasoning` is null on an edited entry, because the record no longer describes the
+  picks. Neither tool accepts a user identity: both read the authenticated account's own entries.
+
+### Narrowed output
+
+- **`get_agent_journal` no longer returns `recentGames`.** An agent's arena entries are read with
+  `list_my_market_grid_entries { agentId }`.
+
+A client that calls a retired tool, or reads `recentGames`, breaks at v99 — hence the MAJOR.
+
+## Contract history — v98 (a clause can read the bar before)
+
+**Breaking at v98: a condition clause accepts six operators that compare a column with its own previous
+completed bar, and a clause's evidence gains a second shape.** v98 is the contract on top of v97.
+
+### Widened input — something new you can send
+
+- A condition clause on `stage_strategy_draft` and `preview_strategy_report` accepts:
+  - `crossesAbove` / `crossesBelow` with a number `value` — TRUE when the value is above (below) it on the
+    decided bar and was at or below (at or above) it on the bar before. A bar landing exactly on the level
+    has not crossed.
+  - `increased` / `decreased` with **no** literal — strictly above (below) the prior bar's reading. A
+    `value` beside them is refused.
+  - `enters` / `exits` with one `label` — the label read now and not on the bar before, or the reverse.
+- Numeric headers take the crossings and changes; classification, direction and boolean headers take the
+  transitions; event and rank headers take none of them. A strategy's served `conditionOperators`
+  (`preview_strategy_report` at `detail: "detailed"`, and the scalar vocabulary) lists exactly what each
+  header admits on that strategy; `get_strategy_column_contract`, which reads no strategy's stored history,
+  lists the operators the header's kind takes.
+- Each of the six reads two completed bars, never the forming one, on every basis, so its reading is never
+  provisional. A failed read on either bar is `UNRESOLVED`; a bar with no value reads `FALSE`.
+
+### Narrowed acceptance — the same request, refused where it cannot be read
+
+- A header whose stored history keeps only one bar (`conditionHold.maxWindow` 1) admits none of the six:
+  the clause is refused with `CONDITION_OPERATOR_UNSUPPORTED`, and every operator refusal's
+  `allowedDomain` now lists the operators that header admits.
+- `crossesAbove`, `crossesBelow`, `enters` and `exits` are edges: a hold with `atLeast` above 1 is refused
+  (`CONDITION_HOLD_ILLEGAL`) — hold them "within n closes". A prior-bar clause's largest window is one bar
+  less than its header's, and the frame-read budget counts the bar before.
+
+### Reshaped output — a clause's evidence has two shapes
+
+- A prior-bar clause's evidence carries **`priorOperand`** — the same column's reading on the bar before —
+  and a **`decidedBar` that is never null**. It appears on `preview_strategy_report`,
+  `get_radar_close_decisions`, `list_gate_blocks`, `preview_radar_resolution`, `get_signal_log`,
+  `get_agent_coin_qualification` (a condition level's clauses) and the trade register an agent reads.
+- A current-bar clause's evidence is unchanged and carries no `priorOperand`; every record written before
+  v98 reads as it was written.
+- Rendered evidence lines read prior before current: `RSI14_now crosses above 50 (49.6 → 50.4)`.
+
+### Widened output
+
+- A condition series' `BOUND` threshold `op` widens to `crossesAbove` / `crossesBelow`, drawn at the level
+  crossed. A change or a transition draws no threshold.
+- The authoring contract digest gains `domains.conditionOperator`, the thirteen operator names.
+
+A clause reader that assumed one evidence shape, or an operator vocabulary of seven, breaks on the same
+call at v98 — hence the MAJOR.
+
 ## Contract history — v97 (a signal records the evidence it decided on)
 
 **Breaking at v97: an evaluated signal's evidence keys move, `BB_TOUCH` touches by %B, and a crossing is

package/dist/index.d.ts

@@ -49,7 +49,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.79";
+export declare const PACKAGE_VERSION = "31.2.81";
 export declare const DEFAULT_URL = "https://mcp.battlegrid.trade/mcp";
 export interface EnvConfig {
     apiKeys: string[];

package/dist/index.js

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