@almanak/mcp-server 0.2.7 → 0.2.9

package/dist/tools.js

@@ -137,8 +137,7 @@ const BACKTESTS_RUN_V3_DEFINITION = {
         'run: local or unpushed edits are never used, so commit and push the backtest YAML (and any strategy change) first, ' +
         'then call this with commit_sha set to the pushed commit (git rev-parse HEAD after the push). ' +
         'backtest_config_path names the file; omitted, the only committed backtest.yaml or backtest-economic.yaml at the ' +
-        'repository root is used. Economic mode (`mode: economic`) refuses banded liquidity allocations: a config.yaml with ' +
-        'a `band` allocation is refused before submission (V3_BACKTEST_BAND_UNSUPPORTED). ' +
+        'repository root is used. ' +
         'The call submits the run, renders a live backtest widget in the chat and PAUSES until the run finishes; it then ' +
         'resumes you with the outcome as _widgetResponse. A v3 summary carries no v2 metrics: call backtests_results with ' +
         'the backtest_id for the report (return, drawdown, positions, decision interval) or the runner failure (stage, code, ' +
@@ -147,7 +146,7 @@ const BACKTESTS_RUN_V3_DEFINITION = {
         'Errors carry errorCode: COMMIT_UNRESOLVED (the commit is not in the repository: push it), REPO_ACCESS or ' +
         'GITHUB_UNAVAILABLE (repository access, not a push problem), BACKTEST_CONFIG_NOT_FOUND (file not in that commit), ' +
         'BACKTEST_CONFIG_UNREADABLE, BACKTEST_CONFIG_AMBIGUOUS (several files, pass backtest_config_path), ' +
-        'V3_BACKTEST_INPUT_INVALID, V3_BACKTEST_BAND_UNSUPPORTED, SDK_GENERATION_MISMATCH (the strategy link is not stored as ' +
+        'V3_BACKTEST_INPUT_INVALID, SDK_GENERATION_MISMATCH (the strategy link is not stored as ' +
         'SDK v3; do not add v2 inputs). Users can have at most 10 active backtests; a 429 BACKTEST_CONCURRENCY_LIMIT error ' +
         'means do not retry until one finishes or is cancelled.',
     inputSchema: {
@@ -165,11 +164,12 @@ const BACKTESTS_RUN_V3_DEFINITION = {
             commit_sha: {
                 type: 'string',
                 description: 'Optional 7-40 character hexadecimal commit SHA or unique prefix of a pushed commit; it is resolved to a full SHA ' +
-                    'in the linked repository. Pass the commit you just pushed. Omitted, the head of branch (or the default branch) runs.',
+                    'in the linked repository. Pass the commit you just pushed, and then omit branch. Omitted, the head of branch (or ' +
+                    'the default branch) runs.',
             },
             branch: {
                 type: 'string',
-                description: 'Optional branch whose head runs when commit_sha is omitted. Defaults to the repository default branch.',
+                description: 'Optional branch whose head runs instead of a commit_sha; never pass both. Omitted, the repository default branch runs.',
             },
             show_widget: {
                 const: true,
@@ -876,17 +876,14 @@ class PlatformToolHandler {
                 },
                 required: ['agent_id'],
             },
-        }, (args) => {
-            var _a, _b;
-            return this.fetchAgentLogsToFile({
-                agentId: args.agent_id,
-                navigationMode: (_a = args.navigation_mode) !== null && _a !== void 0 ? _a : 'GO_TO_END',
-                page: (_b = args.page) !== null && _b !== void 0 ? _b : 1,
-                targetTimestamp: args.target_timestamp,
-                severity: args.severity,
-                searchText: args.search_text,
-            });
-        });
+        }, (args) => { var _a, _b; return this.fetchAgentLogsToFile({
+            agentId: args.agent_id,
+            navigationMode: (_a = args.navigation_mode) !== null && _a !== void 0 ? _a : 'GO_TO_END',
+            page: (_b = args.page) !== null && _b !== void 0 ? _b : 1,
+            targetTimestamp: args.target_timestamp,
+            severity: args.severity,
+            searchText: args.search_text,
+        }); });
         this.register('agents', {
             name: 'agents_pnl',
             description: 'Get profit and loss data for an agent including current value, returns, and APY.',
@@ -909,15 +906,12 @@ class PlatformToolHandler {
                 },
                 required: ['agent_id'],
             },
-        }, (args) => {
-            var _a, _b, _c;
-            return this.client.getAgentTransactions({
-                agentId: args.agent_id,
-                page: (_a = args.page) !== null && _a !== void 0 ? _a : 1,
-                offset: (_b = args.offset) !== null && _b !== void 0 ? _b : 25,
-                sort: (_c = args.sort) !== null && _c !== void 0 ? _c : 'desc',
-            });
-        });
+        }, (args) => { var _a, _b, _c; return this.client.getAgentTransactions({
+            agentId: args.agent_id,
+            page: (_a = args.page) !== null && _a !== void 0 ? _a : 1,
+            offset: (_b = args.offset) !== null && _b !== void 0 ? _b : 25,
+            sort: (_c = args.sort) !== null && _c !== void 0 ? _c : 'desc',
+        }); });
         this.register('agents', {
             name: 'agents_sync_status',
             description: 'Check if a deployed agent is in sync with its linked strategy repository. Returns IN_SYNC, OUT_OF_SYNC, or UNKNOWN.',
@@ -1004,16 +998,13 @@ class PlatformToolHandler {
                 },
                 required: ['wallet_id', 'eoa_address', 'chain_id'],
             },
-        }, async (args) => {
-            var _a;
-            return ({
-                wallet_id: args.wallet_id,
-                eoa_address: args.eoa_address,
-                chain_id: args.chain_id,
-                chain_name: (_a = args.chain_name) !== null && _a !== void 0 ? _a : '',
-                show_widget: true,
-            });
-        });
+        }, async (args) => { var _a; return ({
+            wallet_id: args.wallet_id,
+            eoa_address: args.eoa_address,
+            chain_id: args.chain_id,
+            chain_name: (_a = args.chain_name) !== null && _a !== void 0 ? _a : '',
+            show_widget: true,
+        }); });
         // ─── Strategy tools ─────────────────────────────────────────
         this.register('strategies', {
             name: 'strategies_token_funding',
@@ -1040,23 +1031,25 @@ class PlatformToolHandler {
                 },
                 required: ['tokens'],
             },
-        }, async (args) => {
-            var _a, _b;
-            return ({
-                tokens: (_a = args.tokens) !== null && _a !== void 0 ? _a : [],
-                prompt: (_b = args.prompt) !== null && _b !== void 0 ? _b : 'How much (in USD) do you want to allocate per token?',
-                show_widget: true,
-            });
-        });
+        }, async (args) => { var _a, _b; return ({
+            tokens: (_a = args.tokens) !== null && _a !== void 0 ? _a : [],
+            prompt: (_b = args.prompt) !== null && _b !== void 0 ? _b : 'How much (in USD) do you want to allocate per token?',
+            show_widget: true,
+        }); });
         this.register('strategies', {
             name: 'strategies_spec',
-            description: "Show the user an editable Strategy Spec panel to review and approve the strategy's risk posture BEFORE building. Call early — after confirming protocol support, before scaffolding. Pass plainSummary (one-line plain-language money-at-risk), fields (the few user-facing posture choices, each {key,label,description,value,unit}), the full content (the SPEC.json values), optional presets (conservative/balanced/aggressive content variants), and show_widget=true. content must include an `exit` object stating what stop/teardown does (close actions, asset policy), and fields must include an `exit.*` entry so the user sees it. If user constraints conflict with a clean exit, surface the resolution here rather than deciding silently. Give each field the unit that matches its meaning (see fields[].unit): a plain percentage such as an LP range width is `pct`, never `pct_of_balance`. Execution pauses; the user reviews/edits, then the reply is a fenced ```json``` block `{action, content}` — use the returned `content` as the approved build contract (the full SPEC values with the user's edits applied). Surface only genuine posture choices the strategy actually consults — keep safety internals in config.json.",
+            description: "Show the user an editable Strategy Spec panel to review and approve the strategy's risk posture BEFORE building. Call early — after confirming protocol support, before scaffolding. Pass plainSummary (one-line plain-language money-at-risk), fields (the few user-facing posture choices, each {key,label,description,value,unit}), the full content (the SPEC.json values), optional presets (conservative/balanced/aggressive content variants), and show_widget=true. content must include an `exit` object stating what stop/teardown does (close actions, asset policy), and fields must include an `exit.*` entry so the user sees it. If user constraints conflict with a clean exit, surface the resolution here rather than deciding silently. Give each field the unit that matches its meaning (see fields[].unit): a plain percentage such as an LP range width is `pct`, never `pct_of_balance`. Execution pauses; the user reviews/edits, then the reply is a fenced ```json``` block `{action, content}` — use the returned `content` as the approved build contract (the full SPEC values with the user's edits applied). If the reply's action is `revise` it also carries `note` (a change the user asked for) and is NOT an approval: apply the note to `content` (keep fields, `behavior` and `exit` consistent), say in one line what changed or what cannot be done and the closest option, then call strategies_spec again for approval. Surface only genuine posture choices the strategy actually consults — keep safety internals in config.json.",
             inputSchema: {
                 type: 'object',
                 properties: {
                     widgetId: { type: 'string', description: 'Widget identifier (default: "spec").' },
                     plainSummary: { type: 'string', description: 'One-line plain-language summary of what the strategy does and risks.' },
-                    content: { type: 'object', description: 'The SPEC.json values (the build contract).' },
+                    content: {
+                        type: 'object',
+                        description: 'The SPEC.json values (the build contract). Optional `behavior`: an array of 3–6 plain-language ' +
+                            'trigger → action lines (entry, while a position is held, missing data, stop), shown read-only ' +
+                            'under the fields as "How it behaves".',
+                    },
                     fields: {
                         type: 'array',
                         description: 'User-facing posture fields to render. Each references a key in content.',
@@ -1683,19 +1676,20 @@ class PlatformToolHandler {
      * turn into a widget (the error card auto-resolves the gate immediately).
      */
     async runBacktest(args) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1;
-        const strategyLinkId = String((_a = args.strategy_link_id) !== null && _a !== void 0 ? _a : '').trim();
-        const startTime = String((_b = args.start_time) !== null && _b !== void 0 ? _b : '').trim();
+        var _a;
+        var _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1;
+        const strategyLinkId = String((_b = args.strategy_link_id) !== null && _b !== void 0 ? _b : '').trim();
+        const startTime = String((_c = args.start_time) !== null && _c !== void 0 ? _c : '').trim();
         // required[] only checks presence — an empty/whitespace id would call
         // getStrategy('') → GET /github/strategies/ (the list route). Fail early.
         if (!strategyLinkId) {
             return {
                 statusCode: 400,
                 error: 'strategy_link_id is required — pass the linked strategy id (from strategies_list or the strategies_export_workspace result).',
-                backtest_config: { start_time: startTime, end_time: String((_c = args.end_time) !== null && _c !== void 0 ? _c : '').trim(), include_gas_costs: args.include_gas_costs !== false },
+                backtest_config: { start_time: startTime, end_time: String((_d = args.end_time) !== null && _d !== void 0 ? _d : '').trim(), include_gas_costs: args.include_gas_costs !== false },
             };
         }
-        const endTime = String((_d = args.end_time) !== null && _d !== void 0 ? _d : '').trim();
+        const endTime = String((_e = args.end_time) !== null && _e !== void 0 ? _e : '').trim();
         const includeGasCosts = args.include_gas_costs !== false;
         const backtestConfig = { start_time: startTime, end_time: endTime, include_gas_costs: includeGasCosts };
         const fail = (statusCode, error, extra) => ({
@@ -1728,7 +1722,7 @@ class PlatformToolHandler {
         try {
             const strategyRes = await this.client.getStrategy(strategyLinkId);
             if ((strategyRes === null || strategyRes === void 0 ? void 0 : strategyRes.valid) === false || !(strategyRes === null || strategyRes === void 0 ? void 0 : strategyRes.data)) {
-                return fail((_e = strategyRes === null || strategyRes === void 0 ? void 0 : strategyRes.statusCode) !== null && _e !== void 0 ? _e : 404, (_g = (_f = strategyRes === null || strategyRes === void 0 ? void 0 : strategyRes.message) !== null && _f !== void 0 ? _f : strategyRes === null || strategyRes === void 0 ? void 0 : strategyRes.error) !== null && _g !== void 0 ? _g : 'Strategy not found');
+                return fail((_f = strategyRes === null || strategyRes === void 0 ? void 0 : strategyRes.statusCode) !== null && _f !== void 0 ? _f : 404, (_h = (_g = strategyRes === null || strategyRes === void 0 ? void 0 : strategyRes.message) !== null && _g !== void 0 ? _g : strategyRes === null || strategyRes === void 0 ? void 0 : strategyRes.error) !== null && _h !== void 0 ? _h : 'Strategy not found');
             }
             const strategy = strategyRes.data;
             // The stored framework_version is authoritative for which runner family serves the strategy.
@@ -1743,7 +1737,7 @@ class PlatformToolHandler {
                 return await this.runV3Backtest(args, strategyLinkId, strategy);
             }
             if (sessionIsV3) {
-                return fail(400, `The strategy link is stored as SDK ${String((_h = strategy.framework_version) !== null && _h !== void 0 ? _h : 'v2').toLowerCase()}, but this chat session ` +
+                return fail(400, `The strategy link is stored as SDK ${String((_j = strategy.framework_version) !== null && _j !== void 0 ? _j : 'v2').toLowerCase()}, but this chat session ` +
                     'runs the SDK v3 lane. The stored generation decides which backtest runs, and the two disagree, so nothing was ' +
                     'submitted. Do not add SDK v2 window inputs; tell the user the strategy link is not recognised as SDK v3 ' +
                     '(its repository must resolve almanak 3.x and carry strategy.py and config.yaml at the root).', { errorCode: 'SDK_GENERATION_MISMATCH' });
@@ -1778,19 +1772,19 @@ class PlatformToolHandler {
             const refType = explicitSha ? 'commit' : 'branch';
             const refConfigRes = await this.client.getStrategyRefConfig(strategyLinkId, ref, refType);
             if ((refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.valid) === false || !(refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.data)) {
-                const baseError = (_k = (_j = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.message) !== null && _j !== void 0 ? _j : refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.error) !== null && _k !== void 0 ? _k : `Could not resolve ref "${ref}" for the linked strategy repository.`;
+                const baseError = (_l = (_k = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.message) !== null && _k !== void 0 ? _k : refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.error) !== null && _l !== void 0 ? _l : `Could not resolve ref "${ref}" for the linked strategy repository.`;
                 const recoveryGuidance = explicitSha
                     ? ` Omit commit_sha only if the user explicitly approves running the latest commit on ${defaultBranch}; ` +
                         'do not retry with different code automatically.'
                     : '';
-                return fail((_l = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.statusCode) !== null && _l !== void 0 ? _l : 400, `${baseError}${recoveryGuidance}`, {
-                    errorCode: (_m = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.errorCode) !== null && _m !== void 0 ? _m : 'INTERNAL_ERROR',
+                return fail((_m = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.statusCode) !== null && _m !== void 0 ? _m : 400, `${baseError}${recoveryGuidance}`, {
+                    errorCode: (_o = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.errorCode) !== null && _o !== void 0 ? _o : 'INTERNAL_ERROR',
                     retryable: (refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.retryable) === true,
                     ...recoveryContext,
                 });
             }
             const refConfig = refConfigRes.data;
-            const commitSha = (_o = refConfig.github_commit_sha) !== null && _o !== void 0 ? _o : '';
+            const commitSha = (_p = refConfig.github_commit_sha) !== null && _p !== void 0 ? _p : '';
             if (!FULL_COMMIT_SHA_RE.test(commitSha)) {
                 return fail(400, `Could not resolve "${ref}" to a full commit SHA — has the strategy been pushed to its repository?`, {
                     errorCode: 'COMMIT_UNRESOLVED',
@@ -1801,13 +1795,13 @@ class PlatformToolHandler {
             // /ref-config — pin it to the resolved commit so it matches the config.
             const refMetaRes = await this.client.getStrategyRefMetadata(strategyLinkId, commitSha);
             if ((refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.valid) === false || !(refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.data)) {
-                return fail((_p = refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.statusCode) !== null && _p !== void 0 ? _p : 400, (_r = (_q = refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.message) !== null && _q !== void 0 ? _q : refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.error) !== null && _r !== void 0 ? _r : 'Could not load strategy ref metadata');
+                return fail((_q = refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.statusCode) !== null && _q !== void 0 ? _q : 400, (_s = (_r = refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.message) !== null && _r !== void 0 ? _r : refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.error) !== null && _s !== void 0 ? _s : 'Could not load strategy ref metadata');
             }
-            const sdkVersion = (_s = refMetaRes.data.almanak_sdk_version) !== null && _s !== void 0 ? _s : null;
+            const sdkVersion = (_t = refMetaRes.data.almanak_sdk_version) !== null && _t !== void 0 ? _t : null;
             if (!sdkVersion) {
                 return fail(400, 'Could not detect the Almanak SDK version from pyproject.toml at the selected commit.');
             }
-            if (((_u = (_t = parseSdkVersion(sdkVersion)) === null || _t === void 0 ? void 0 : _t.major) !== null && _u !== void 0 ? _u : 0) >= 3) {
+            if (((_u = (_a = parseSdkVersion(sdkVersion)) === null || _a === void 0 ? void 0 : _a.major) !== null && _u !== void 0 ? _u : 0) >= 3) {
                 // The backend refuses a v3 SDK against a V2 record; say why instead of submitting the v2 shape.
                 return fail(400, `Commit ${commitSha.slice(0, 7)} resolves almanak ${sdkVersion} (SDK v3), but the strategy link is stored as SDK v2. ` +
                     'The generations disagree, so nothing was submitted; SDK v2 window inputs cannot backtest an SDK v3 repository.', { errorCode: 'SDK_GENERATION_MISMATCH', commit_sha: commitSha, sdk_version: sdkVersion });
@@ -1857,7 +1851,8 @@ class PlatformToolHandler {
      * throws and every path returns a widget-renderable shape.
      */
     async runV3Backtest(args, strategyLinkId, strategy) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
+        var _a, _b, _c;
+        var _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
         const strategyName = (typeof strategy.display_name === 'string' && strategy.display_name) ||
             (typeof strategy.github_repo_name === 'string' && strategy.github_repo_name) ||
             null;
@@ -1897,7 +1892,8 @@ class PlatformToolHandler {
                 defaultBranch,
             });
         }
-        if (args.branch !== undefined && !(0, backtest_v3_1.isValidBranchName)(branch)) {
+        // An empty string reads as omitted, like an empty commit_sha.
+        if (branch && !(0, backtest_v3_1.isValidBranchName)(branch)) {
             return fail(400, `branch must be a git branch name, got "${branch}".`, { errorCode: 'V3_BACKTEST_INPUT_INVALID' });
         }
         const ref = explicitSha ? explicitSha.toLowerCase() : branch || defaultBranch;
@@ -1905,18 +1901,18 @@ class PlatformToolHandler {
         const recoveryContext = { requestedCommit: explicitSha || null, linkedRepo, defaultBranch };
         try {
             const refConfigRes = await this.client.getStrategyRefConfig(strategyLinkId, ref, refType);
-            const commitSha = (refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.valid) === false ? '' : String((_b = (_a = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.data) === null || _a === void 0 ? void 0 : _a.github_commit_sha) !== null && _b !== void 0 ? _b : '');
+            const commitSha = (refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.valid) === false ? '' : String((_d = (_a = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.data) === null || _a === void 0 ? void 0 : _a.github_commit_sha) !== null && _d !== void 0 ? _d : '');
             if (!FULL_COMMIT_SHA_RE.test(commitSha)) {
-                const baseError = (_d = (_c = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.message) !== null && _c !== void 0 ? _c : refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.error) !== null && _d !== void 0 ? _d : `Could not resolve ${refType} "${ref}" in the linked strategy repository.`;
+                const baseError = (_f = (_e = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.message) !== null && _e !== void 0 ? _e : refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.error) !== null && _f !== void 0 ? _f : `Could not resolve ${refType} "${ref}" in the linked strategy repository.`;
                 // Push advice fits only a ref the repository does not have; access and availability errors keep their own text.
-                const errorCode = (refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.valid) === false ? ((_e = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.errorCode) !== null && _e !== void 0 ? _e : 'INTERNAL_ERROR') : 'COMMIT_UNRESOLVED';
+                const errorCode = (refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.valid) === false ? ((_g = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.errorCode) !== null && _g !== void 0 ? _g : 'INTERNAL_ERROR') : 'COMMIT_UNRESOLVED';
                 const guidance = errorCode !== 'COMMIT_UNRESOLVED'
                     ? ''
                     : explicitSha
                         ? ` Only pushed commits can be backtested: make sure the commit is pushed to ${linkedRepo !== null && linkedRepo !== void 0 ? linkedRepo : 'the linked repository'} ` +
                             '(git push, then git rev-parse HEAD) and call again with that SHA. Do not switch to a different commit without the user.'
                         : ` Push the branch to ${linkedRepo !== null && linkedRepo !== void 0 ? linkedRepo : 'the linked repository'} first.`;
-                return fail((_f = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.statusCode) !== null && _f !== void 0 ? _f : 400, `${baseError}${guidance}`, {
+                return fail((_h = refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.statusCode) !== null && _h !== void 0 ? _h : 400, `${baseError}${guidance}`, {
                     errorCode,
                     retryable: (refConfigRes === null || refConfigRes === void 0 ? void 0 : refConfigRes.retryable) === true,
                     ...recoveryContext,
@@ -1925,7 +1921,7 @@ class PlatformToolHandler {
             context.commit_sha = commitSha;
             const refMetaRes = await this.client.getStrategyRefMetadata(strategyLinkId, commitSha);
             if ((refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.valid) === false || !(refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.data)) {
-                return fail((_g = refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.statusCode) !== null && _g !== void 0 ? _g : 400, (_j = (_h = refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.message) !== null && _h !== void 0 ? _h : refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.error) !== null && _j !== void 0 ? _j : 'Could not load strategy ref metadata');
+                return fail((_j = refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.statusCode) !== null && _j !== void 0 ? _j : 400, (_l = (_k = refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.message) !== null && _k !== void 0 ? _k : refMetaRes === null || refMetaRes === void 0 ? void 0 : refMetaRes.error) !== null && _l !== void 0 ? _l : 'Could not load strategy ref metadata');
             }
             const meta = refMetaRes.data;
             const sdkVersion = typeof meta.almanak_sdk_version === 'string' ? meta.almanak_sdk_version : '';
@@ -1935,7 +1931,7 @@ class PlatformToolHandler {
                 });
             }
             context.sdk_version = sdkVersion;
-            if (((_l = (_k = parseSdkVersion(sdkVersion)) === null || _k === void 0 ? void 0 : _k.major) !== null && _l !== void 0 ? _l : 0) < 3 || !isSdkVersionBacktestable(sdkVersion, backtest_v3_1.MIN_BACKTEST_SDK_VERSION_V3)) {
+            if (((_m = (_b = parseSdkVersion(sdkVersion)) === null || _b === void 0 ? void 0 : _b.major) !== null && _m !== void 0 ? _m : 0) < 3 || !isSdkVersionBacktestable(sdkVersion, backtest_v3_1.MIN_BACKTEST_SDK_VERSION_V3)) {
                 return fail(400, `Hosted SDK v3 backtests need almanak ${backtest_v3_1.MIN_BACKTEST_SDK_VERSION_V3} or newer; commit ${commitSha.slice(0, 7)} resolves ` +
                     `${sdkVersion}. Update the almanak pin (uv.lock / pyproject.toml), commit, push and re-run.`, { errorCode: 'V3_BACKTEST_INPUT_INVALID' });
             }
@@ -1963,36 +1959,27 @@ class PlatformToolHandler {
                 }
             }
             context.backtest_config_path = backtestPath;
-            let backtestYaml = (_m = committed[backtestPath]) !== null && _m !== void 0 ? _m : null;
-            if (backtestYaml === null) {
+            // The file must exist at the commit; its contents are validated by the runner's pinned SDK, not here.
+            if (committed[backtestPath] === undefined) {
                 const fileRes = await this.client.getStrategyFileContent(strategyLinkId, backtestPath, commitSha);
-                const file = (fileRes === null || fileRes === void 0 ? void 0 : fileRes.valid) === false ? null : (_o = fileRes === null || fileRes === void 0 ? void 0 : fileRes.data) === null || _o === void 0 ? void 0 : _o.file;
-                const lookupError = (fileRes === null || fileRes === void 0 ? void 0 : fileRes.valid) === false ? String((_q = (_p = fileRes === null || fileRes === void 0 ? void 0 : fileRes.message) !== null && _p !== void 0 ? _p : fileRes === null || fileRes === void 0 ? void 0 : fileRes.error) !== null && _q !== void 0 ? _q : '') : '';
-                if (typeof (file === null || file === void 0 ? void 0 : file.content) === 'string') {
-                    backtestYaml = file.content;
-                }
-                else if (file) {
+                const file = (fileRes === null || fileRes === void 0 ? void 0 : fileRes.valid) === false ? null : (_c = fileRes === null || fileRes === void 0 ? void 0 : fileRes.data) === null || _c === void 0 ? void 0 : _c.file;
+                const lookupError = (fileRes === null || fileRes === void 0 ? void 0 : fileRes.valid) === false ? String((_p = (_o = fileRes === null || fileRes === void 0 ? void 0 : fileRes.message) !== null && _o !== void 0 ? _o : fileRes === null || fileRes === void 0 ? void 0 : fileRes.error) !== null && _p !== void 0 ? _p : '') : '';
+                if (file && typeof file.content !== 'string') {
                     // The preview refuses some present files (build/dist/venv paths, directories, oversized files) with a reason.
-                    return fail(400, `Could not read ${backtestPath} at ${shortSha}: ${(_r = file.message) !== null && _r !== void 0 ? _r : 'the file is not readable as text'}. Keep the backtest ` +
+                    return fail(400, `Could not read ${backtestPath} at ${shortSha}: ${(_q = file.message) !== null && _q !== void 0 ? _q : 'the file is not readable as text'}. Keep the backtest ` +
                         'YAML a small text file outside build output directories, commit and push it, then call again.', { errorCode: 'BACKTEST_CONFIG_UNREADABLE' });
                 }
-                else if (lookupError !== 'File not found') {
-                    return fail((_s = fileRes === null || fileRes === void 0 ? void 0 : fileRes.statusCode) !== null && _s !== void 0 ? _s : 502, `Could not read ${backtestPath} at ${shortSha}: ${lookupError || 'lookup failed'}`, {
+                else if (!file && lookupError !== 'File not found') {
+                    return fail((_r = fileRes === null || fileRes === void 0 ? void 0 : fileRes.statusCode) !== null && _r !== void 0 ? _r : 502, `Could not read ${backtestPath} at ${shortSha}: ${lookupError || 'lookup failed'}`, {
                         errorCode: 'BACKTEST_CONFIG_UNREADABLE',
                     });
                 }
-                else {
+                else if (!file) {
                     return fail(404, `${backtestPath} is not in commit ${shortSha}. Only committed, pushed files run: commit and push it, then call ` +
                         'again with the pushed commit_sha.' +
                         (discovered.length > 0 ? ` Committed backtest files at that commit: ${discovered.join(', ')}.` : ''), { errorCode: 'BACKTEST_CONFIG_NOT_FOUND', ...(discovered.length > 0 ? { backtest_config_paths: discovered } : {}) });
                 }
             }
-            const configYaml = typeof meta.config_yaml === 'string' ? meta.config_yaml : '';
-            if ((0, backtest_v3_1.backtestMode)(backtestYaml) === 'economic' && (0, backtest_v3_1.declaresBandAllocation)(configYaml)) {
-                return fail(400, `${backtestPath} selects the economic model, and config.yaml at ${shortSha} declares a banded liquidity allocation ` +
-                    `(band). The SDK refuses that combination ("${backtest_v3_1.SDK_BAND_ECONOMIC_REFUSAL}"), so the run was not submitted. ` +
-                    'Tell the user; backtesting this strategy needs a fixed range allocation instead of a band.', { errorCode: 'V3_BACKTEST_BAND_UNSUPPORTED' });
-            }
             const submit = await this.client.submitBacktest({
                 github_strategy_link_id: strategyLinkId,
                 commit_sha: commitSha,
@@ -2001,7 +1988,7 @@ class PlatformToolHandler {
                 backtest_config_path: backtestPath,
             });
             if ((submit === null || submit === void 0 ? void 0 : submit.valid) === false || typeof (submit === null || submit === void 0 ? void 0 : submit.id) !== 'string') {
-                return fail((_t = submit === null || submit === void 0 ? void 0 : submit.statusCode) !== null && _t !== void 0 ? _t : 400, (_v = (_u = submit === null || submit === void 0 ? void 0 : submit.error) !== null && _u !== void 0 ? _u : submit === null || submit === void 0 ? void 0 : submit.message) !== null && _v !== void 0 ? _v : 'Backtest submission failed', {
+                return fail((_s = submit === null || submit === void 0 ? void 0 : submit.statusCode) !== null && _s !== void 0 ? _s : 400, (_u = (_t = submit === null || submit === void 0 ? void 0 : submit.error) !== null && _t !== void 0 ? _t : submit === null || submit === void 0 ? void 0 : submit.message) !== null && _u !== void 0 ? _u : 'Backtest submission failed', {
                     ...(typeof (submit === null || submit === void 0 ? void 0 : submit.errorCode) === 'string' ? { errorCode: submit.errorCode } : {}),
                     ...(typeof (submit === null || submit === void 0 ? void 0 : submit.activeBacktests) === 'number' ? { activeBacktests: submit.activeBacktests } : {}),
                     ...(typeof (submit === null || submit === void 0 ? void 0 : submit.maxActiveBacktests) === 'number' ? { maxActiveBacktests: submit.maxActiveBacktests } : {}),
@@ -2010,14 +1997,14 @@ class PlatformToolHandler {
             }
             return {
                 backtest_id: submit.id,
-                status: (_w = submit.status) !== null && _w !== void 0 ? _w : 'PENDING',
-                created_at: (_x = submit.created_at) !== null && _x !== void 0 ? _x : null,
+                status: (_v = submit.status) !== null && _v !== void 0 ? _v : 'PENDING',
+                created_at: (_w = submit.created_at) !== null && _w !== void 0 ? _w : null,
                 ...context,
                 show_widget: true,
             };
         }
         catch (err) {
-            return fail(502, `Backtest submission failed: ${(_y = err === null || err === void 0 ? void 0 : err.message) !== null && _y !== void 0 ? _y : String(err)}`);
+            return fail(502, `Backtest submission failed: ${(_x = err === null || err === void 0 ? void 0 : err.message) !== null && _x !== void 0 ? _x : String(err)}`);
         }
     }
     /**
@@ -2029,7 +2016,8 @@ class PlatformToolHandler {
      * path returned — equity curves and per-trade detail are read on demand.
      */
     async getBacktestResults(args) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
+        var _a, _b;
+        var _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
         const backtestId = typeof args.backtest_id === 'string' ? args.backtest_id.trim() : '';
         if (!backtestId) {
             return {
@@ -2042,30 +2030,30 @@ class PlatformToolHandler {
             run = await this.client.getBacktest(backtestId);
         }
         catch (err) {
-            return { statusCode: 502, error: `Backtest lookup failed: ${(_a = err === null || err === void 0 ? void 0 : err.message) !== null && _a !== void 0 ? _a : String(err)}` };
+            return { statusCode: 502, error: `Backtest lookup failed: ${(_c = err === null || err === void 0 ? void 0 : err.message) !== null && _c !== void 0 ? _c : String(err)}` };
         }
         if (!run || run.valid === false) {
             return {
-                statusCode: (_b = run === null || run === void 0 ? void 0 : run.statusCode) !== null && _b !== void 0 ? _b : 404,
-                error: (_c = run === null || run === void 0 ? void 0 : run.error) !== null && _c !== void 0 ? _c : 'Backtest run not found',
+                statusCode: (_d = run === null || run === void 0 ? void 0 : run.statusCode) !== null && _d !== void 0 ? _d : 404,
+                error: (_e = run === null || run === void 0 ? void 0 : run.error) !== null && _e !== void 0 ? _e : 'Backtest run not found',
                 backtest_id: backtestId,
             };
         }
         if ((0, backtest_v3_1.isV3BacktestRun)(run)) {
             return this.getV3BacktestResults(backtestId, run);
         }
-        const summaryVerdict = summarizeRunValidity((_d = run.result_summary) === null || _d === void 0 ? void 0 : _d.run_validity);
+        const summaryVerdict = summarizeRunValidity((_a = run.result_summary) === null || _a === void 0 ? void 0 : _a.run_validity);
         const base = {
-            backtest_id: (_e = run.id) !== null && _e !== void 0 ? _e : backtestId,
+            backtest_id: (_f = run.id) !== null && _f !== void 0 ? _f : backtestId,
             status: run.status,
-            created_at: (_f = run.created_at) !== null && _f !== void 0 ? _f : null,
-            completed_at: (_g = run.completed_at) !== null && _g !== void 0 ? _g : null,
-            strategy_link_id: (_h = run.github_strategy_link_id) !== null && _h !== void 0 ? _h : null,
-            commit_sha: (_j = run.commit_sha) !== null && _j !== void 0 ? _j : null,
-            sdk_version: (_k = run.sdk_version) !== null && _k !== void 0 ? _k : null,
-            result_summary: (_l = run.result_summary) !== null && _l !== void 0 ? _l : null,
+            created_at: (_g = run.created_at) !== null && _g !== void 0 ? _g : null,
+            completed_at: (_h = run.completed_at) !== null && _h !== void 0 ? _h : null,
+            strategy_link_id: (_j = run.github_strategy_link_id) !== null && _j !== void 0 ? _j : null,
+            commit_sha: (_k = run.commit_sha) !== null && _k !== void 0 ? _k : null,
+            sdk_version: (_l = run.sdk_version) !== null && _l !== void 0 ? _l : null,
+            result_summary: (_m = run.result_summary) !== null && _m !== void 0 ? _m : null,
             run_validity: summaryVerdict,
-            error_message: (_m = run.error_message) !== null && _m !== void 0 ? _m : null,
+            error_message: (_o = run.error_message) !== null && _o !== void 0 ? _o : null,
         };
         if (run.status !== 'COMPLETED') {
             let hint;
@@ -2094,24 +2082,24 @@ class PlatformToolHandler {
             doc = await this.client.getBacktestResult(backtestId);
         }
         catch (err) {
-            return { ...base, result_fetch_error: `Result fetch failed: ${(_o = err === null || err === void 0 ? void 0 : err.message) !== null && _o !== void 0 ? _o : String(err)}` };
+            return { ...base, result_fetch_error: `Result fetch failed: ${(_p = err === null || err === void 0 ? void 0 : err.message) !== null && _p !== void 0 ? _p : String(err)}` };
         }
         if (!doc || doc.valid === false) {
-            return { ...base, result_fetch_error: (_p = doc === null || doc === void 0 ? void 0 : doc.error) !== null && _p !== void 0 ? _p : 'Backtest result not found' };
+            return { ...base, result_fetch_error: (_q = doc === null || doc === void 0 ? void 0 : doc.error) !== null && _q !== void 0 ? _q : 'Backtest result not found' };
         }
         // Compute the compact inline fields BEFORE artifact persistence, so a
         // failed write degrades to summaries-without-a-file instead of losing
         // the whole (successful) lookup.
-        const result = (_q = doc.result) !== null && _q !== void 0 ? _q : {};
+        const result = (_r = doc.result) !== null && _r !== void 0 ? _r : {};
         const trades = Array.isArray(result.trades) ? result.trades : [];
-        const decisionSummary = (_r = result.decision_summary) !== null && _r !== void 0 ? _r : null;
-        const runValidity = (_s = summarizeRunValidity(result.run_validity)) !== null && _s !== void 0 ? _s : summaryVerdict;
+        const decisionSummary = (_s = result.decision_summary) !== null && _s !== void 0 ? _s : null;
+        const runValidity = (_t = summarizeRunValidity(result.run_validity)) !== null && _t !== void 0 ? _t : summaryVerdict;
         const inline = {
             ...base,
             run_validity: runValidity,
             decision_summary: decisionSummary,
-            decision_input_failures: (_t = result.decision_input_failures) !== null && _t !== void 0 ? _t : [],
-            data_manifest_summary: (_v = (_u = result.data_manifest) === null || _u === void 0 ? void 0 : _u.summary) !== null && _v !== void 0 ? _v : null,
+            decision_input_failures: (_u = result.decision_input_failures) !== null && _u !== void 0 ? _u : [],
+            data_manifest_summary: (_v = (_b = result.data_manifest) === null || _b === void 0 ? void 0 : _b.summary) !== null && _v !== void 0 ? _v : null,
             trades_count: trades.length,
         };
         const passiveHint = (runValidity === null || runValidity === void 0 ? void 0 : runValidity.passive_only) === true