@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 +83 -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,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.
|
|
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.
|
|
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];
|