@battlegrid/mcp-server 32.0.94 → 32.0.97
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 +86 -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,92 @@ 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 — v176 (a strategy is private or published)
|
|
42
|
+
|
|
43
|
+
**v176 is MAJOR: one enum member leaves served outputs, and two public reads are reshaped.** No input schema moves,
|
|
44
|
+
and everything v175 accepted is still accepted.
|
|
45
|
+
|
|
46
|
+
A strategy now has two visibilities. `UNLISTED` is private: it has no page and no name on any public read, and its
|
|
47
|
+
agents' public signal logs say nothing of it. `PUBLIC` is published: its page carries the whole strategy, which is
|
|
48
|
+
what a fork copies, and its agents' public signal logs carry its reasoning. `PROTECTED`, which published a strategy
|
|
49
|
+
with its reasoning withheld, is gone, and so is the plan entitlement that gated it.
|
|
50
|
+
|
|
51
|
+
### Narrowed output — one reason v176 is MAJOR
|
|
52
|
+
|
|
53
|
+
- **A strategy's `visibility` is `UNLISTED` or `PUBLIC`.** `get_strategy`, `list_strategies`, `archive_strategy`,
|
|
54
|
+
`restore_strategy` and `commit_strategy_draft` no longer serve `PROTECTED`.
|
|
55
|
+
- **The strategy reference a public read names has two arms:** `{ visibility: "PUBLIC", id, name }` and
|
|
56
|
+
`{ visibility: "UNLISTED" }`. It is served by `get_agent_explorer` and `get_public_agent_signal_log_detail`;
|
|
57
|
+
`get_public_strategy_library`'s row `ref` is the `PUBLIC` arm alone.
|
|
58
|
+
|
|
59
|
+
### Reshaped output — the other reasons
|
|
60
|
+
|
|
61
|
+
- **`get_public_strategy` is one object and carries the strategy in full.** It has no `visibility`: the read serves
|
|
62
|
+
published strategies only, and a private or unknown id is not found. Beside the identity it now serves
|
|
63
|
+
`marketReadText`, `conditions`, `sections` in the shape `get_strategy` serves (a custom section with its subject,
|
|
64
|
+
note and columns), `entry`, the trade-level policy (`minAtrPct`, `minStopLossAtrMultiple`,
|
|
65
|
+
`maxStopLossAtrMultiple`, `minRiskRewardRatio`, `tradeLevelMenu`) and the thirteen exit-policy fields.
|
|
66
|
+
`sectionTitles` names each section's kind, key and title in order; `columnContracts` carries the contract of every
|
|
67
|
+
custom section's columns, positional over the custom sections; `forkable` stays. It carries none of its owner's
|
|
68
|
+
agent or position counts. A client that discriminated on `visibility`, or whose decoder closes the object, refuses
|
|
69
|
+
this read.
|
|
70
|
+
- **`get_public_agent_signal_log_detail` says nothing of a private strategy outside `reasoning`.** Removed from the
|
|
71
|
+
common shape: `candidateLevels`; `reasoning` on `pipeline.decision` and on `linkedEntryDecision`;
|
|
72
|
+
`closeTriggerConditionKey` on `pipeline.outcome`; `setupOptions` on `pipeline.attempt`; and every key of a reason
|
|
73
|
+
detail except its six figures (`atrPct`, `minAtrPct`, `closestSlDistancePct`, `minSlDistancePct`, `bestRiskReward`,
|
|
74
|
+
`minRiskReward`). The `FULL` arm of `reasoning`, served exactly when the recorded strategy is `PUBLIC`, gains
|
|
75
|
+
`decisionReasoning`, `setupOptions`, `candidateLevels`, `rrRejectedPairs` and `closeTriggerConditionKey`. Under a
|
|
76
|
+
private strategy, or none recorded, the arm is `WITHHELD` and the detail carries the trade alone: direction,
|
|
77
|
+
conviction, chosen levels, execution and outcome. `get_signal_log`, the owner's read, is unchanged.
|
|
78
|
+
|
|
79
|
+
### Changed text
|
|
80
|
+
|
|
81
|
+
- **The notice that another player's prose is data** now also names a published strategy's description and its custom
|
|
82
|
+
section titles and notes. It is carried by `get_public_strategy_library`, `get_public_strategy` and `fork_strategy`.
|
|
83
|
+
- **`fork_strategy`, `get_public_strategy`, `get_public_strategy_library`, `get_agent_explorer` and
|
|
84
|
+
`get_public_agent_signal_log_detail`** describe the two visibilities.
|
|
85
|
+
|
|
86
|
+
## Contract history — v175 (a Developing read decides at the decided close)
|
|
87
|
+
|
|
88
|
+
**v175 is MAJOR: a published output vocabulary gains a member.** No input schema moves, and everything v174
|
|
89
|
+
accepted is still accepted. Authoring now accepts compositions v174 refused.
|
|
90
|
+
|
|
91
|
+
A **Developing read** is a column selecting Developing above the strategy timeframe, or a change over a horizon above
|
|
92
|
+
it (`chg4h` on a `1h` strategy, `oiRegime` on a `15m` one). On a decided bar it is now read as the higher-timeframe bar
|
|
93
|
+
stood at the decided bar's final minute, so the radar close step, the trade evaluation and the exit sweep all read
|
|
94
|
+
one value for that bar. At the latest values it is the latest bar in progress.
|
|
95
|
+
|
|
96
|
+
### Widened output — the reason v175 is MAJOR
|
|
97
|
+
|
|
98
|
+
- **`FORMING_CANDLE` joins the per-bar families a decision's missing data names.** It is the higher timeframe's bar
|
|
99
|
+
in progress, read at the decided bar's final minute. A decision waits on it while it is `ABSENT` and misses naming
|
|
100
|
+
it when it is `GONE`. It is served wherever a shortfall's family is: `get_signal_log`,
|
|
101
|
+
`get_public_agent_signal_log_detail`, `list_gate_blocks`, `get_radar_close_decisions`,
|
|
102
|
+
`get_agent_coin_qualification` and `preview_radar_resolution`. A client whose decoder closes the family enum refuses
|
|
103
|
+
these reads.
|
|
104
|
+
|
|
105
|
+
### Widened acceptance
|
|
106
|
+
|
|
107
|
+
- **`stage_strategy_draft` and `commit_strategy_draft` accept a verdict-carrying condition and an exit rule over a
|
|
108
|
+
Developing read**, and a column turning Developing under one. `CONDITION_VERDICT_READ_ILLEGAL` is no longer raised,
|
|
109
|
+
and `CONDITION_EXIT_READ_ILLEGAL` now names only a closure no completed bar moves.
|
|
110
|
+
- **Still refused:** a hold over more than one bar, or a sequence step, over a Developing read (`DEVELOPING`).
|
|
111
|
+
|
|
112
|
+
### Changed values — the same schemas serve a different value
|
|
113
|
+
|
|
114
|
+
- **A Required condition decided by a Developing read gates as evaluated.** It passes on `TRUE` and blocks naming its
|
|
115
|
+
`FALSE` or `UNRESOLVED`, where it used to block as `UNRESOLVED` whatever it read. This moves what
|
|
116
|
+
`list_gate_blocks` records, what `get_agent_coin_qualification` judges, and which picks a Market Grid entry is
|
|
117
|
+
offered.
|
|
118
|
+
- **`get_strategy_column_contract`'s `anchorRelation`** for a Developing column above the anchor serves `readSummary`
|
|
119
|
+
"Includes the bar in progress, read at each strategy close." and `readCost` "Holds one close.".
|
|
120
|
+
|
|
121
|
+
### Changed text
|
|
122
|
+
|
|
123
|
+
- **The rendered report sections' `bars` description** restates `Developing`: the higher-timeframe bar still in
|
|
124
|
+
progress, as it stands at each close of the strategy bar. This is served by `preview_strategy_report`,
|
|
125
|
+
`get_market_context`, `get_context_sources_preview` and `get_context_source_full_preview`.
|
|
126
|
+
|
|
41
127
|
## Contract history — v169.2 to v169.4 (one win-rate rounding; every realized figure exact)
|
|
42
128
|
|
|
43
129
|
**All three are MINOR: the same schemas serve different values.** No input moves, no output narrows, and nothing
|
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.97";
|
|
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.97';
|
|
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];
|