@battlegrid/mcp-server 32.0.96 → 32.0.99

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,89 @@ 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 — v179 (radar tools name a coin by its ticker)
42
+
43
+ **v179 is MAJOR: fifteen radar tools rename the input that names a coin, and two reshape their result.** Nothing else
44
+ moves, and every other tool accepts what v178 accepted.
45
+
46
+ A radar tool that addresses a coin now takes the coin as the player names it — its ticker or exchange symbol, in any
47
+ case (`SOL`, `AAPL`, `kPEPE`) — and the server resolves it. No `get_coin_metadata` read comes first. A HIP-3 coin's
48
+ id is not its ticker (`xyz_aapl` for `AAPL`), so a guessed id used to fail on those coins.
49
+
50
+ ### Rejected input — the reason v179 is MAJOR
51
+
52
+ - **`coinId` is refused; name `coinTicker`.** On `get_radar_deployment`, `pause_radar_deployment`,
53
+ `resume_radar_deployment`, `delete_radar_deployment`, `preview_radar_resolution`, `get_radar_activity`,
54
+ `get_radar_activity_summary`, `get_radar_close_decisions`, `stage_radar_deployment_draft`,
55
+ `get_radar_deployment_draft`, `commit_radar_deployment_draft` and `discard_radar_deployment_draft`. Every input is
56
+ strict, so a call still naming `coinId` is refused as an unrecognized key.
57
+ - **`coinIds` is refused; name `coinTickers`.** On `preview_agent_radar_deploy`.
58
+ - **Each entry names `coinTicker`.** Each `deploy_agent_to_radar` coin and each `withdraw_agent_from_radar` holding.
59
+ - **A coin the platform does not list is refused naming its field.** A list resolves whole, so one unknown ticker
60
+ refuses the call, and two spellings of one coin in one list are refused as a repeat.
61
+ - **Name the coin on `commit_radar_deployment_draft` exactly as on the draft read.** The approval a player sees pairs
62
+ the two by the value you named.
63
+
64
+ ### Reshaped output
65
+
66
+ - **`stage_radar_deployment_draft` and `discard_radar_deployment_draft` name `coinTicker`** — the coin's canonical
67
+ ticker — in place of `coinId`. Every other radar output keeps `coinId`.
68
+
69
+ ### Added output — officer runs only
70
+
71
+ - **A Radar target in the officer's review context serves `coinTicker`** beside `teamId` and `coinId`. Only
72
+ BattleGrid's officer runs read that context; no connected client is offered `get_officer_review_context`.
73
+
74
+ ### Changed text
75
+
76
+ - **`get_agents_hub`** tells you to pass a radar row's `symbol` as `coinTicker`, with its `teamId`, to
77
+ `get_radar_deployment`.
78
+
79
+ ## Contract history — v176 (a strategy is private or published)
80
+
81
+ **v176 is MAJOR: one enum member leaves served outputs, and two public reads are reshaped.** No input schema moves,
82
+ and everything v175 accepted is still accepted.
83
+
84
+ A strategy now has two visibilities. `UNLISTED` is private: it has no page and no name on any public read, and its
85
+ agents' public signal logs say nothing of it. `PUBLIC` is published: its page carries the whole strategy, which is
86
+ what a fork copies, and its agents' public signal logs carry its reasoning. `PROTECTED`, which published a strategy
87
+ with its reasoning withheld, is gone, and so is the plan entitlement that gated it.
88
+
89
+ ### Narrowed output — one reason v176 is MAJOR
90
+
91
+ - **A strategy's `visibility` is `UNLISTED` or `PUBLIC`.** `get_strategy`, `list_strategies`, `archive_strategy`,
92
+ `restore_strategy` and `commit_strategy_draft` no longer serve `PROTECTED`.
93
+ - **The strategy reference a public read names has two arms:** `{ visibility: "PUBLIC", id, name }` and
94
+ `{ visibility: "UNLISTED" }`. It is served by `get_agent_explorer` and `get_public_agent_signal_log_detail`;
95
+ `get_public_strategy_library`'s row `ref` is the `PUBLIC` arm alone.
96
+
97
+ ### Reshaped output — the other reasons
98
+
99
+ - **`get_public_strategy` is one object and carries the strategy in full.** It has no `visibility`: the read serves
100
+ published strategies only, and a private or unknown id is not found. Beside the identity it now serves
101
+ `marketReadText`, `conditions`, `sections` in the shape `get_strategy` serves (a custom section with its subject,
102
+ note and columns), `entry`, the trade-level policy (`minAtrPct`, `minStopLossAtrMultiple`,
103
+ `maxStopLossAtrMultiple`, `minRiskRewardRatio`, `tradeLevelMenu`) and the thirteen exit-policy fields.
104
+ `sectionTitles` names each section's kind, key and title in order; `columnContracts` carries the contract of every
105
+ custom section's columns, positional over the custom sections; `forkable` stays. It carries none of its owner's
106
+ agent or position counts. A client that discriminated on `visibility`, or whose decoder closes the object, refuses
107
+ this read.
108
+ - **`get_public_agent_signal_log_detail` says nothing of a private strategy outside `reasoning`.** Removed from the
109
+ common shape: `candidateLevels`; `reasoning` on `pipeline.decision` and on `linkedEntryDecision`;
110
+ `closeTriggerConditionKey` on `pipeline.outcome`; `setupOptions` on `pipeline.attempt`; and every key of a reason
111
+ detail except its six figures (`atrPct`, `minAtrPct`, `closestSlDistancePct`, `minSlDistancePct`, `bestRiskReward`,
112
+ `minRiskReward`). The `FULL` arm of `reasoning`, served exactly when the recorded strategy is `PUBLIC`, gains
113
+ `decisionReasoning`, `setupOptions`, `candidateLevels`, `rrRejectedPairs` and `closeTriggerConditionKey`. Under a
114
+ private strategy, or none recorded, the arm is `WITHHELD` and the detail carries the trade alone: direction,
115
+ conviction, chosen levels, execution and outcome. `get_signal_log`, the owner's read, is unchanged.
116
+
117
+ ### Changed text
118
+
119
+ - **The notice that another player's prose is data** now also names a published strategy's description and its custom
120
+ section titles and notes. It is carried by `get_public_strategy_library`, `get_public_strategy` and `fork_strategy`.
121
+ - **`fork_strategy`, `get_public_strategy`, `get_public_strategy_library`, `get_agent_explorer` and
122
+ `get_public_agent_signal_log_detail`** describe the two visibilities.
123
+
41
124
  ## Contract history — v175 (a Developing read decides at the decided close)
42
125
 
43
126
  **v175 is MAJOR: a published output vocabulary gains a member.** No input schema moves, and everything v174
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.96";
50
+ export declare const PACKAGE_VERSION = "32.0.99";
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.96';
52
+ export const PACKAGE_VERSION = '32.0.99';
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.96",
3
+ "version": "32.0.99",
4
4
  "description": "BattleGrid MCP server — play crypto prediction games from AI agents",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",