@battlegrid/mcp-server 32.0.89 → 32.0.93

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,77 @@ 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 — v169.2 to v169.4 (one win-rate rounding; every realized figure exact)
42
+
43
+ **All three are MINOR: the same schemas serve different values.** No input moves, no output narrows, and nothing
44
+ v169.1 accepted is refused. Round money to the cent, and a percent to the decimals you want, when you display it.
45
+
46
+ ### Changed values — the same schemas serve a different value
47
+
48
+ **v169.2 — every closed-trade win rate rounds once.** Wins × 1000 ÷ closed trades, to whole thousandths, served as a
49
+ one-decimal percent or the equal three-decimal fraction.
50
+
51
+ - **`get_agent_explorer`'s `winRatePercent`** on `entries[]`, `stats` and `aggregations.modelVendors[]` is a
52
+ one-decimal percent: 2 of 3 serves `66.7`, where it served `67`.
53
+ - **`get_agent_profile`'s `tradeWinRatePct`** is a one-decimal percent: 2 of 3 serves `66.7`, where it served
54
+ `66.66666666666666`.
55
+ - **`get_public_agent_signal_performance`'s `winRatePercent`** multiplies before it divides: 201 of 400 serves `50.3`,
56
+ where it served `50.2`.
57
+ - **`get_signal_log`'s `log.trackRecord` READY rows' `winRate`**, for a thesis written after the deploy: 201 of 400
58
+ serves `0.503`, where it served `0.502`. A stored record keeps the value its model read.
59
+
60
+ **v169.3 — the remaining realized figures are exact.** Each serves the exact 8-decimal realized sum where it served
61
+ whole cents: trades of `12.345` and `-4.10` serve `8.245`, where they served `8.25`.
62
+
63
+ - **`get_agent_llm_spend` and `get_llm_spend_breakdown`**: `realizedNetUsd` and `netAfterLlmUsd`, pooled and per
64
+ member. Net after LLM is the exact net less the platform spend rounded once to cents. The
65
+ `LLM_SPEND_FLIPS_NET_AFTER_LLM` highlight is decided on, and valued at, that served figure.
66
+ - **`get_account_review_analytics`**: `agents[]` and `totals` `realizedNetUsd` and `netAfterLlmUsd`.
67
+ - **`get_agent_review_analytics`, `get_agent_review_slices` and `get_review_slices_breakdown`**: every row's
68
+ `realizedNetUsd`, and the coin rows' `feesUsd`.
69
+ - **`list_agent_trades`'s `summary.netPnlUsd`**, **`list_strategies`' `viewerPerformance.realizedPnlUsd`** and
70
+ **`get_public_strategy_library`'s `rows[].performance.realizedPnlUsd`**. The library's `TOP` order now separates
71
+ cohorts less than a cent apart.
72
+
73
+ **v169.4 — one closed-trade rollup.** Averages are the exact mean of the total, and best and worst are the persisted
74
+ amounts.
75
+
76
+ - **`get_agents_hub`'s `roster[].closedTrades` and `get_agents_portfolio_pnl`'s `agentTrades[].closedTrades`**:
77
+ `avgNetPnlUsd` is the exact mean of `totalNetPnl` over `closedTradeCount`, and `bestNetPnlUsd` / `worstNetPnlUsd`
78
+ are the persisted amounts. Trades of `5.678, -2.5, 0, 1.004` serve `1.0455`, `5.678` and `-2.5`, where they served
79
+ `1.05`, `5.68` and `-2.5`.
80
+ - **`performance.avgPnl`** on `list_intelligence_agents`, `get_intelligence_agent` and the receipts that carry the
81
+ agent record (`activate_intelligence_agent`, `archive_intelligence_agent`, `commit_agent_draft`): 8 decimals, no
82
+ longer the database's binary-float average (`0.6666666666666666` serves `0.66666667`).
83
+ - **`get_agent_profile`'s `avgNetPnl`**: the same mean.
84
+
85
+ ### Changed text
86
+
87
+ - **`get_agent_llm_spend` and `get_llm_spend_breakdown`** (v169.3) say each spend figure is rounded once to cents,
88
+ and the realized net and net after LLM are exact.
89
+
90
+ ## Contract history — v169 (one exact rule for realized net; the hub's per-agent average is gone)
91
+
92
+ **v169 is MAJOR: one published output loses a field.** No input moves, and nothing v168 accepted is refused.
93
+
94
+ ### Removed output — the reason v169 is MAJOR
95
+
96
+ - **`get_agents_hub` no longer serves `summary.avgPnlPerAgentUsd`.** It was a lifetime average per agent, rounded
97
+ differently from the fleet's. Read `get_agents_portfolio_pnl`'s `avgRealizedNetPnlPerAgentUsd`, the one per-agent
98
+ average, over the period you ask for.
99
+
100
+ ### Changed values — the same schemas serve exact values
101
+
102
+ Realized trade money is now summed by one rule: exact at the persisted 8-decimal scale, never rounded to the cent on
103
+ the server. Round to the cent yourself when you display it.
104
+
105
+ - **`get_agents_hub`'s `summary.totalRealizedNetPnl`** — the roster's lifetime realized net, now described as
106
+ all-time. Rows of `-100` and `30.555` used to total `-69.44`; they now total `-69.445`.
107
+ - **`get_agents_portfolio_pnl`'s `realizedNetPnlUsd`, `avgRealizedNetPnlPerAgentUsd` and every `agentTrades[]`
108
+ `realizedNetPnlUsd`** — they served whole cents and now serve the exact values. The fleet's `LIFETIME` realized net
109
+ equals `get_cost_economics_breakdown`'s `ACCOUNT` pooled `netPnl` at `LIFETIME`. An agent's figure may print one
110
+ cent from the others' total, and from its own `agents[]` `pnlUsd` when it sits exactly on a half cent.
111
+
41
112
  ## Contract history — v156 (a crowd reading no bar can serve is not a condition; trades name their config version)
42
113
 
43
114
  **v156 is MAJOR: writes v155.1 accepted are refused, and one published result narrows.** No input schema moves.
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.89";
50
+ export declare const PACKAGE_VERSION = "32.0.93";
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.89';
52
+ export const PACKAGE_VERSION = '32.0.93';
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.89",
3
+ "version": "32.0.93",
4
4
  "description": "BattleGrid MCP server — play crypto prediction games from AI agents",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",