@battlegrid/mcp-server 31.2.72 → 31.2.74

package/README.md

@@ -24,6 +24,98 @@ 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 — v92 (every section you read is the JSON the agent reads)
+
+**Breaking at v92: the section fields are reshaped, the report preview's default narrows, and its size is measured
+in characters.** v92 is the contract on top of v91. Every tool that published a section as markdown text publishes
+it as the JSON object the agent reads, and `preview_strategy_report` takes a detail level.
+
+### Reshaped output — a section is its JSON
+
+A **section read** is `{ shape: "table", section }` — `{ id, title, notes, provenance?, anchorTf, groups, columns,
+rows, addendum? }`, rows positional and every cell its raw value, each column stating its `unit`, `precision`, bar
+set (`bars`) and, on a rank column, the ranked set's `universe`, with a key absent where the column has nothing to
+say — or `{ shape: "facts", section }`, `{ id, title, facts, glossary }`. It replaces:
+
+- **`preview_strategy_report.renderedSections[]`**: `{ sectionKey, section: { title, text }, structure,
+  authoredNote }` → `{ sectionKey }` and a section read, or `{ sectionKey, shape: "skipped" }` for a row that
+  rendered nothing. A custom section's authored note is its section's `notes`.
+- **`get_market_context.sections[]`**: `{ kind, title, content, structure }` → `{ kind }` and a section read.
+- **`get_context_source_full_preview.content`** → **`read`**, a section read or `null`.
+- **`get_context_sources_preview`**: each source's `value` → **`section`**, a section read or `null`, a coin-row
+  table sampled to its first five coins.
+- **`get_signal_log.reportSections[]`**: a section read, `skipped`, or `{ sectionKey, shape: "text", title, text }`
+  — a row stored before custom sections carried a structure, kept as its agent read it.
+- **`preview_strategy_report.conditionsTableText`** and **`.tradeConditionsBlockText`** → **`gridConditions`** and
+  **`tradeConditions`**, each `{ glossary, register }`: the glossary prose and the register object the text carried
+  as one JSON line. Each is `null` where its text was.
+
+### Widened output — the register names what decided the verdict
+
+- **`decidedBy`** joins the conditions register: on each `GRID` coin and on the `TRADE` register, the key of the
+  condition the `verdict` came from, `null` when no single condition made the call. It reaches you in
+  `gridConditions.register`, `tradeConditions.register`, and the register `get_agent_prompt_context_preview` shows,
+  and the conditions glossary gains the sentence defining it.
+
+### Narrowed default, new input — `preview_strategy_report` `detail`
+
+- **`detail`** is `"concise"` (the default) or `"detailed"`. A concise preview is exactly what the agent reads.
+- **`conditionColumns`** and **`conditionOutcomes`** leave the top level. With each row's `headerBindings`
+  (`{ sectionKey, columnIndexByHeader }`) they make up **`authoring`**, served only at `"detailed"` and `null`
+  otherwise. If you read either field, ask for `"detailed"` and read it under `authoring`.
+- **`marketReadMarkers[]`** lose `resolvedName` and `resolvedValue`.
+
+### Result size in characters
+
+- **`tokenCountModel`** and **`budgetUsage.estimatedTokens`** leave the preview. **`budgetUsage.resultChars`** is
+  the exact `JSON.stringify` length of the response that carries it, its own digits included, against the cap.
+- **`list_strategy_vocabulary`** drops `budgets.estimatedTokens`, and `previewExecutionLimits.maxResultBytes` is
+  renamed **`maxResultChars`**.
+- A preview over the cap is refused with **`PREVIEW_LIMIT_EXCEEDED`** and `limit: "result_chars"`;
+  `estimated_tokens` and `mcp_result_bytes` are retired. Every preview refusal now carries its `previewErrorCode`
+  and its bound (`deadlineMs`, or `limit`, `actual` and `maximum`) in the error's details.
+- **`preview_strategy_report`**, **`get_market_context`** and **`get_context_sources_preview`** declare the cap as
+  `_meta["anthropic/maxResultSizeChars"]`, so Claude Code keeps a large result inline.
+
+Something read at v91 is reshaped or gone at v92, and a default narrows — hence the MAJOR.
+
+## Contract history — v91 (every data block an agent reads is one JSON object)
+
+**Breaking at v91: one output field is removed, and the published text that is the agent's prompt carries JSON.**
+v91 is the contract on top of v90. Every data block BattleGrid's trading agents read — the strategy's resolved
+conditions, fact sections, and the trade-decision blocks — is one JSON object naming itself with `id` and `title`.
+Instructions stay prose under their `## Title`. The tools that show you the prompt therefore show that JSON.
+
+### Removed output — something you read is gone
+
+- **`promptDataSerialization`** leaves `get_signal_log`'s owner detail. There is one serialization, so a trade
+  record stores none. `reportSections` and `missingData` are unchanged, and a trade recorded before capture still
+  serves both as `null`.
+
+### Reshaped output — the same fields, carrying JSON
+
+- **`preview_strategy_report.conditionsTableText`** is the conditions glossary as a `## Strategy Conditions
+  Glossary` instruction, then the conditions register as one JSON line: `surface: "GRID"`, and `coins[]` each with
+  `outcomes` keyed by condition and `verdict` by display name (`null` when the strategy declares no verdict). It was a
+  markdown table followed by the glossary.
+- **`preview_strategy_report.tradeConditionsBlockText`** is the trade glossary, a blank line, then the target coin's
+  register as one JSON line: `surface: "TRADE"`, `verdict` as `{ name, description }`, and `conditions[]` each with
+  `outcome`, `required`, `provisional`, `counts`, `exitRule` and the evaluator's `evidence`. It was a
+  `## STRATEGY CONDITIONS` heading, a table and evidence bullets.
+- **A fact section's text is its JSON**, `{ id, title, facts, glossary }` with `facts` keyed by label, in
+  `get_market_context.sections[].content`, `get_context_source_full_preview.content`,
+  `preview_strategy_report.renderedSections[].section.text`, and the `get_signal_log` report of trades recorded
+  from v91 on. The session field is a fact section. A table section's text is still its markdown.
+- **`get_agent_prompt_context_preview.promptSections[].content`** is each section as the agent reads it: a data
+  section's JSON, a table's included, and an instruction's prose.
+
+### Widened enum
+
+- **`get_agent_prompt_context_preview.promptSections[].kind`** gains `strategy-conditions-glossary`, the instruction
+  read before the conditions register. The market-context reads exclude it, as they exclude the register.
+
+Something read at v90 is gone or reshaped at v91 — hence the MAJOR.
+
 ## Contract history — v90 (Arena and radar deployments join the draft lifecycle)
 
 **Breaking at v90: input is refused and reshaped, output is reshaped, five error codes are removed.** v90 is the

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