@battlegrid/mcp-server 32.0.84 → 32.0.85

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -38,6 +38,80 @@ Seeing package `31.x` alongside handshake `battlegrid@33.x` — the package **be
38
38
 
39
39
  **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.
40
40
 
41
+ ## Contract history — v155 (every breakdown section serves its highlights)
42
+
43
+ **v155 is MAJOR: every breakdown envelope gains a required field.** Inputs are unchanged.
44
+
45
+ ### Reshaped output — the reason v155 is MAJOR
46
+
47
+ - **Every breakdown envelope carries `highlights`.** This covers the agent and breakdown doors of Cost Economics,
48
+ LLM spend, pipeline blocks, review slices, conditions, Entry Discipline, Decision Quality and Conviction
49
+ Calibration.
50
+ - `highlights` is the section's server-computed findings, in policy order, empty when none fires.
51
+ - Each finding is `{ policy, kind, subject, value, sampleSize }`.
52
+ - `kind` is one of `LARGEST_CONTRIBUTOR`, `PULLS_PARENT_NEGATIVE`, `DEVIATION`, `NEGATIVE_EDGE` or `HALTED`.
53
+ - `subject` is an agent, a brain row (agent and model) or a condition row (strategy, revision, condition, and
54
+ whether you may open that strategy).
55
+ - `value` is the figure the policy read, in the policy's unit, and `sampleSize` is its population (null for a halt).
56
+ - A highlight fires only above its section's readiness gate. Entry Discipline serves an empty list.
57
+ - A strict client validating the envelope must admit the field. Nothing else moves.
58
+
59
+ ## Contract history — v154 (Decision Quality and Calibration compare agents and models, in R)
60
+
61
+ **v154 is MAJOR: two published outputs are reshaped and lose fields.** Two tools are added.
62
+
63
+ ### Reshaped output — the reason v154 is MAJOR
64
+
65
+ - **`get_agent_decision_quality` answers the brain comparison envelope.** It carries `scope`, `window` (the evidence
66
+ window), `anchor` (`DECIDED`), `minSampleSize` and `rows`.
67
+ - There is one row per model the agent's decisions ran on, never pooled. Each row carries `agent`, `model`, and
68
+ `isCurrentModel`.
69
+ - `rank` is 1-based among the ready rows; it is `null` below the gate.
70
+ - `figures` is the old figure set without `windowDays`.
71
+ - The exit block gains `unmeasuredCount`, `meanExitR`, `meanGrossR` (the ranking figure) and `grossOfCosts`.
72
+ - Read the row with `isCurrentModel`.
73
+ - **`get_agent_conviction_calibration` answers the same envelope** with `anchor` `CLOSED`.
74
+ - `figures` loses `windowDays` and gains `brierScore`, the ranking figure, where lower is better.
75
+ - Every band and deployment-rule group loses `averageNetPnlUsd` and gains `averageGrossR`, with `rTradeCount`.
76
+ Compare groups in R, not dollars.
77
+
78
+ ### Added tools
79
+
80
+ - **`get_decision_quality_breakdown` and `get_conviction_calibration_breakdown`** serve the same envelopes. They take
81
+ `{ teamId?, strategyId?, fromRevision?, toRevision?, agentId? }`, for the account, one team, or a strategy cohort
82
+ narrowed to a team or an agent. The result has one row per (agent, model) and takes no period and no grouping.
83
+
84
+ ## Contract history — v153 (strategy revision cohorts and one evidence window)
85
+
86
+ **v153 is MAJOR: published outputs lose fields, one tool's input is replaced, and a finding input is narrowed.** Three
87
+ tools are added.
88
+
89
+ ### Refused input — one reason v153 is MAJOR
90
+
91
+ - **`get_agent_entry_discipline` takes `{ agentId }` alone.** `windowStartAt` and `windowEndAt` are refused. The read
92
+ covers the evidence window, the last 90 days ending at the read.
93
+ - **`submit_officer_review`'s CONDITION finding requires `strategyId` and `strategyRevision`**, copied from the
94
+ `get_agent_conditions` row it cites. A finding naming no row of the agent's condition evidence is refused.
95
+
96
+ ### Reshaped output — the other reason v153 is MAJOR
97
+
98
+ - **`get_agent_entry_discipline` answers the scoped-section envelope `{ entryDiscipline }`.** Its `adoption` is one
99
+ row per strategy revision the decisions were read under, and it gains `unstampedDecisions`.
100
+ - **`get_agent_review_analytics` drops `condition`.** Cited conditions are `get_agent_conditions`' rows, keyed by
101
+ strategy revision. Its flat window fields give way to `window`.
102
+ - **Every breakdown envelope's `window` gains `policy`.** It is `PERIOD` or `EVIDENCE`.
103
+ - **Every breakdown envelope's `scope` gains a `STRATEGY` arm.** The arm carries the cohort, every stored revision
104
+ with the axes it changed, and an optional team or agent narrowing.
105
+ - **The pipeline blocks figures' `railRefusals` and `halt` are nullable.** They are null at a strategy scope. The
106
+ figures gain `unstampedBlocks`.
107
+
108
+ ### Added tools
109
+
110
+ - **`get_agent_conditions`** and **`get_conditions_breakdown`** serve one row per (strategy, revision, condition key):
111
+ the checklist verdict against what each citing decision became.
112
+ - **`get_entry_discipline_breakdown`** serves Entry Discipline at a strategy cohort.
113
+ - **`get_pipeline_blocks_breakdown`** also accepts a strategy cohort. It then serves only the conditions stage.
114
+
41
115
  ## Contract history — v152 (LLM spend, pipeline blocks and the review's market slices are scoped sections)
42
116
 
43
117
  **v152 is MAJOR: two published outputs lose fields, and one tool refuses a call it used to answer.** Six tools are
package/dist/index.d.ts CHANGED
@@ -47,7 +47,7 @@ import { Client, StreamableHTTPClientTransport } from '@modelcontextprotocol/cli
47
47
  * being asked. Move it for a change to THIS package — a proxy fix, a dependency bump, a docs
48
48
  * correction. Never move it to track the server.
49
49
  */
50
- export declare const PACKAGE_VERSION = "32.0.84";
50
+ export declare const PACKAGE_VERSION = "32.0.85";
51
51
  export declare const DEFAULT_URL = "https://mcp.battlegrid.trade/mcp";
52
52
  export interface EnvConfig {
53
53
  apiKeys: string[];
package/dist/index.js CHANGED
@@ -49,7 +49,7 @@ import { Client, SdkHttpError, StreamableHTTPClientTransport } from '@modelconte
49
49
  * being asked. Move it for a change to THIS package — a proxy fix, a dependency bump, a docs
50
50
  * correction. Never move it to track the server.
51
51
  */
52
- export const PACKAGE_VERSION = '32.0.84';
52
+ export const PACKAGE_VERSION = '32.0.85';
53
53
  export const DEFAULT_URL = 'https://mcp.battlegrid.trade/mcp';
54
54
  const MAX_RETRIES = 3;
55
55
  const RETRY_DELAYS_MS = [2000, 4000, 8000];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@battlegrid/mcp-server",
3
- "version": "32.0.84",
3
+ "version": "32.0.85",
4
4
  "description": "BattleGrid MCP server — play crypto prediction games from AI agents",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",