@battlegrid/mcp-server 32.0.82 → 32.0.84

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,50 @@ 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 — v152 (LLM spend, pipeline blocks and the review's market slices are scoped sections)
42
+
43
+ **v152 is MAJOR: two published outputs lose fields, and one tool refuses a call it used to answer.** Six tools are
44
+ added.
45
+
46
+ ### Reshaped output — one reason v152 is MAJOR
47
+
48
+ - **`get_agent_review_analytics` drops `llm`, `railRefusals` and `halt`.**
49
+ - LLM spend and net after LLM are now `get_agent_llm_spend`'s.
50
+ - Rail refusals and the current halt are now `get_agent_pipeline_blocks`'.
51
+ - Both read over a period. The review's window, slices and conditions are unchanged.
52
+ - **`get_account_review_analytics` serves `window` in place of `windowDays`.** `window` holds `period` and ISO `startAt`
53
+ and `endAt`.
54
+ - Each row's figures cover that window, over the agents counted on My Agents. Realized net, fees, spend, net after
55
+ LLM and closed trades count the closes in the period; win rate counts the trades decided in it.
56
+ - Each row's `halt` gains `kind: 'AGENT'`.
57
+ - `totals` are the account's own pooled figures, not the sum of the rows.
58
+
59
+ ### Refused input — the other reason v152 is MAJOR
60
+
61
+ - **`get_account_review_analytics` requires `period`** (`24H`, `7D`, `30D` or `LIFETIME`). A call naming none is
62
+ refused as `VALIDATION_ERROR`. Pass `30D`, the period the Strategy Officer reads.
63
+
64
+ ### New refusal
65
+
66
+ - **`list_gate_blocks` answers not found** for an agent you cannot access, or for a platform agent that is no longer
67
+ active. It used to serve an empty page.
68
+
69
+ ### Added tools
70
+
71
+ Each is a scoped-section envelope, in the shape v150 gave Cost Economics. The agent doors take `{ agentId, period }`
72
+ and the breakdown doors `{ teamId?, period, groupBy? }`.
73
+
74
+ - **`get_agent_llm_spend` / `get_llm_spend_breakdown`:**
75
+ - spend by billing mode and in total;
76
+ - realized net and net after LLM;
77
+ - at the account, the spend recorded with no agent.
78
+ - **`get_agent_pipeline_blocks` / `get_pipeline_blocks_breakdown`:**
79
+ - gate-block groups by stage;
80
+ - rail refusals;
81
+ - the agent's halt, or the count of halted agents.
82
+ - **`get_agent_review_slices` / `get_review_slices_breakdown`:** the market figures of the decisions made in the
83
+ period — overall, and by regime, hour, weekday and coin.
84
+
41
85
  ## Contract history — v151 (an arena entry is sealed until lock; from lock its author and reasoning are public)
42
86
 
43
87
  **v151 is MAJOR: one published output drops three fields.** Nothing a client sends is refused that v150 accepted.
@@ -63,6 +107,32 @@ Seeing package `31.x` alongside handshake `battlegrid@33.x` — the package **be
63
107
  it beside the grid. Before lock, no other player can read an entry's picks or reasoning, and the lobby's per-coin
64
108
  crowd split stays empty for an open session.
65
109
 
110
+ ## Contract history — v150 (Cost Economics is one scoped section: account, team or agent, over a period)
111
+
112
+ **v150 is MAJOR: one published tool now requires an input it did not, and its output is reshaped.** One tool is added.
113
+
114
+ ### Refused input — one reason v150 is MAJOR
115
+
116
+ - **`get_agent_cost_economics` requires `period`** beside `agentId`: one of `24H`, `7D`, `30D` or `LIFETIME`, the
117
+ trailing span ending at the read. It used to read a fixed 90-day window. A call naming only `agentId` is refused
118
+ as `VALIDATION_ERROR`. Pass a period; `30D` is the longest span inside the old window.
119
+
120
+ ### Reshaped output — the other reason v150 is MAJOR
121
+
122
+ - **`get_agent_cost_economics`' `economics` is the scoped-section envelope.** It carries `scope`
123
+ (`{ kind: 'AGENT', agentId }`), `window` (`period`, ISO `startAt` — `null` for `LIFETIME` — and `endAt`), `groupBy`,
124
+ `pooled`, `members` and `quietMemberCount`. The `rows`, `totals` and `costErodedCount` that sat at the top of
125
+ `economics` now sit under `economics.pooled`. `windowDays` is replaced by `window`. `unreconciledCount` is removed:
126
+ a closed position can no longer lack its money, so every close in the window is counted in its outcome's row.
127
+
128
+ ### Added tools
129
+
130
+ - **`get_cost_economics_breakdown`** serves the same envelope for your whole account, or for one of your teams when
131
+ `teamId` is given, over a required `period`. `groupBy` may be `TEAM` or `AGENT` for the account and `AGENT` for a
132
+ team; anything else is refused as `VALIDATION_ERROR`. `members` lists each member with a close in the window, each
133
+ with its own figures in the pooled shape, and `quietMemberCount` counts the members that had none. A team that is
134
+ not yours answers not found.
135
+
66
136
  ## Contract history — v146.14 (market-structure pivots are LuxAlgo's `leg()` exactly)
67
137
 
68
138
  **Nothing refused at v146.14 that v146.13 accepted at the shipped lookback cap.** One MINOR moves served values and
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.82";
50
+ export declare const PACKAGE_VERSION = "32.0.84";
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.82';
52
+ export const PACKAGE_VERSION = '32.0.84';
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.82",
3
+ "version": "32.0.84",
4
4
  "description": "BattleGrid MCP server — play crypto prediction games from AI agents",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",