@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 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.94";
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.94';
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];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@battlegrid/mcp-server",
3
- "version": "32.0.94",
3
+ "version": "32.0.97",
4
4
  "description": "BattleGrid MCP server — play crypto prediction games from AI agents",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",