@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 +70 -0
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/package.json +1 -1
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.
|
|
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.
|
|
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];
|