bcs-mcp 0.2.5

package/dist/helpers.js

@@ -0,0 +1,144 @@
+import { BcsApiError } from "./client.js";
+// Single reusable formatter (creating one per call is the costly part of toLocaleString)
+const MSK_FMT = new Intl.DateTimeFormat("sv-SE", {
+    timeZone: "Europe/Moscow",
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+    hour: "2-digit",
+    minute: "2-digit",
+    second: "2-digit",
+    hour12: false,
+});
+/**
+ * Date/string → ISO string in Moscow wall-time with the ACTUAL offset for that date
+ * (UTC+4/DST before 2014). null/undefined → ""; an unparseable string is returned
+ * AS IS (information is never lost — the convention every call site relies on).
+ */
+export function toMsk(d) {
+    if (!d)
+        return "";
+    const date = typeof d === "string" ? new Date(d) : d;
+    if (isNaN(date.getTime()))
+        return typeof d === "string" ? d : "";
+    const wall = MSK_FMT.format(date).replace(" ", "T"); // "2026-06-12T13:58:22"
+    // offset = (wall interpreted as UTC) − actual instant; correct for any historical MSK offset
+    const offsetMin = Math.round((Date.parse(wall + "Z") - date.getTime()) / 60_000);
+    const sign = offsetMin < 0 ? "-" : "+";
+    const abs = Math.abs(offsetMin);
+    const hh = String(Math.floor(abs / 60)).padStart(2, "0");
+    const mm = String(abs % 60).padStart(2, "0");
+    return `${wall}${sign}${hh}:${mm}`;
+}
+/** ISO string → Date, with fallback for omitted params */
+export function parseDate(s, fallback) {
+    if (!s)
+        return fallback;
+    const d = new Date(s);
+    if (isNaN(d.getTime())) {
+        throw new Error(`Invalid date: "${s}" (expected ISO 8601, e.g. 2026-01-31)`);
+    }
+    return d;
+}
+export function daysFromNow(days) {
+    return new Date(Date.now() + days * 86_400_000);
+}
+export function ok(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data ?? null, null, 2) }] };
+}
+/** Hints for common HTTP statuses from the BCS Trade API */
+const HTTP_HINTS = {
+    400: "Bad request: check parameter values (ticker/classCode/dates).",
+    401: "Unauthenticated: the refresh token is invalid or expired (BCS tokens live 90 days) — reissue it in the BCS web app (Профиль → Токены API).",
+    403: "Permission denied: the token lacks the required scope (a read-only token cannot trade), or API trading is not enabled for this trade code — BCS enables it separately.",
+    404: "Not found: check ticker/classCode/orderId (use find_instrument to verify instruments).",
+    429: "Rate limit exceeded: wait a few seconds and retry.",
+};
+/**
+ * Error → ToolResult with an actionable hint. `extraHints` lets a tool override
+ * the hint for a specific status (e.g. a 404 that means "endpoint not rolled out").
+ */
+export function fail(error, extraHints = {}) {
+    let msg = error instanceof Error ? error.message : String(error);
+    if (error instanceof BcsApiError) {
+        if (error.kind === "too-large") {
+            msg += " — the response exceeds the BCS backend's ~4 MB message cap (this is NOT a rate limit; retrying will not help) — narrow the time window (from/to) or request fewer records.";
+        }
+        else if (extraHints[error.status]) {
+            msg += ` — ${extraHints[error.status]}`;
+        }
+        else if (error.kind === "no-data" && error.status === 404) {
+            // The API wraps 400/403/422 in the same displayOptions JSON — the
+            // "no data right now" reading is only true for a 404
+            msg += " — the API reports no data for this request right now (e.g. outside the trading session); this is usually not a wrong parameter.";
+        }
+        else if (error.kind === "no-route" && error.status === 404) {
+            msg += " — the route does not exist on this service (the API may have moved the endpoint).";
+        }
+        else if (HTTP_HINTS[error.status]) {
+            msg += ` — ${HTTP_HINTS[error.status]}`;
+        }
+    }
+    return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
+}
+/** Unwrap a possibly-enveloped list response: bare array or { <key>: [...] } */
+export function pickList(res, key) {
+    if (Array.isArray(res))
+        return res;
+    const wrapped = res?.[key];
+    return Array.isArray(wrapped) ? wrapped : [];
+}
+/** Shallow copy without the listed keys */
+export function omit(obj, keys) {
+    const out = { ...obj };
+    for (const k of keys)
+        delete out[k];
+    return out;
+}
+/**
+ * Map over items with bounded concurrency (caps parallel API fan-out on large batches).
+ * The first rejection aborts remaining work — no background calls keep firing
+ * after the tool has already returned an error.
+ */
+export async function mapPool(items, limit, fn) {
+    const out = new Array(items.length);
+    let next = 0;
+    let aborted = false;
+    const worker = async () => {
+        for (let i = next++; i < items.length && !aborted; i = next++) {
+            try {
+                out[i] = await fn(items[i], i);
+            }
+            catch (e) {
+                aborted = true;
+                throw e;
+            }
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
+    return out;
+}
+/** Best-effort MCP progress notification (no-op when the client sent no progressToken) */
+export async function notifyProgress(extra, progress, total, message) {
+    const progressToken = extra._meta?.progressToken;
+    if (progressToken == null)
+        return;
+    try {
+        await extra.sendNotification({
+            method: "notifications/progress",
+            params: { progressToken, progress, ...(total != null ? { total } : {}), message },
+        });
+    }
+    catch {
+        // progress is cosmetic — never fail the call
+    }
+}
+/** Split [from, to] into chunks of at most maxMs (for the 1000-bars-per-request candle limit) */
+export function computeChunks(from, to, maxMs) {
+    const chunks = [];
+    for (let t = from.getTime(); t < to.getTime(); t += maxMs) {
+        chunks.push({ from: new Date(t), to: new Date(Math.min(t + maxMs, to.getTime())) });
+    }
+    return chunks;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+/**
+ * MCP server for BCS Trade API (БКС Мир инвестиций).
+ *
+ * Env:
+ *   BCS_REFRESH_TOKEN   — required, refresh token from the BCS web app (Профиль → Токены API)
+ *   BCS_ALLOW_TRADING   — "true" to register place_order/edit_order/cancel_order (needs a trade+read token)
+ *   BCS_CONFIRM         — "off" to disable the elicitation trade confirmation (not recommended: no sandbox at BCS)
+ *   BCS_OUTPUT_DIR      — root for outputPath file dumps (default: server cwd)
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { config } from "./client.js";
+import { registerReadTools } from "./tools/read.js";
+import { registerTradingTools } from "./tools/trading.js";
+import { registerInfoTools } from "./tools/info.js";
+import { registerPrompts } from "./prompts.js";
+import { registerResources } from "./resources.js";
+import { VERSION } from "./version.js";
+if (!config.refreshToken) {
+    console.error("ERROR: BCS_REFRESH_TOKEN environment variable is required");
+    process.exit(1);
+}
+const server = new McpServer({ name: "bcs-mcp-server", version: VERSION });
+registerReadTools(server);
+registerInfoTools(server);
+registerPrompts(server);
+registerResources(server);
+if (config.allowTrading)
+    registerTradingTools(server);
+await server.connect(new StdioServerTransport());
+console.error(`bcs-mcp: trading=${config.allowTrading ? "ENABLED (real account!)" : "disabled"}`);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;IACzB,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAE3E,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,eAAe,CAAC,MAAM,CAAC,CAAC;AACxB,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,IAAI,MAAM,CAAC,YAAY;IAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAEtD,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;AACjD,OAAO,CAAC,KAAK,CAAC,oBAAoB,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC"}

package/dist/instruments-cache.js

@@ -0,0 +1,119 @@
+import { API } from "./endpoints.js";
+import { bcsFetch } from "./client.js";
+import { pickList, mapPool } from "./helpers.js";
+const TTL_MS = 24 * 60 * 60 * 1000;
+const MAX_ENTRIES = 5000;
+const BATCH_SIZE = 50; // /instruments/by-tickers batch limit
+/** POST /instruments/by-tickers returns a bare array of instrument cards */
+export async function fetchInstruments(tickers) {
+    const res = await bcsFetch(API.information, "/instruments/by-tickers", { method: "POST", body: { tickers } });
+    return pickList(res, "instruments");
+}
+function toRef(raw) {
+    // The same ticker can be listed on several exchanges/boards — prefer the
+    // instrument's primaryBoard on MOEX (GAZP has an SMAL small-lot board too)
+    const boards = raw.boards ?? [];
+    const board = boards.find((b) => b.exchange === "MOEX" && b.classCode === raw.primaryBoard) ??
+        boards.find((b) => b.exchange === "MOEX") ??
+        boards.find((b) => b.classCode === raw.primaryBoard) ??
+        boards[0] ??
+        {};
+    return {
+        ticker: raw.ticker ?? "",
+        name: raw.displayName ?? "",
+        classCode: board.classCode ?? "",
+        exchange: board.exchange ?? "",
+        instrumentType: raw.instrumentType ?? "",
+        lotSize: raw.lotSize ?? 1,
+        faceValue: raw.faceValue ?? null,
+        isin: raw.isin ?? "",
+    };
+}
+/**
+ * Preference among several cards of one instrument: MOEX cards first, then the
+ * card that itself carries its primaryBoard. GAZP comes as SMAL + TQBR + SPBRU
+ * cards with primaryBoard=TQBR on all of them — a plain "first MOEX" pick would
+ * land on the SMAL small-lot board.
+ */
+export function pickPrimaryCard(cards) {
+    const read = (c) => c;
+    const moex = cards.filter((c) => read(c).boards?.some((b) => b.exchange === "MOEX"));
+    const pool = moex.length ? moex : cards;
+    return (pool.find((c) => {
+        const r = read(c);
+        return !!r.primaryBoard && !!r.boards?.some((b) => b.classCode === r.primaryBoard);
+    }) ?? pool[0]);
+}
+/** Several cards per ticker are possible (MOEX + SPB listings) — prefer the primary MOEX one */
+function pickCard(cards, ticker) {
+    return pickPrimaryCard(cards.filter((i) => i.ticker?.toUpperCase() === ticker));
+}
+// Cache the in-flight promise (not the resolved value) so concurrent lookups of the
+// same ticker share one request. Resolves to null for a genuine not-found; rejects on API error.
+const cache = new Map();
+function store(key, promise) {
+    promise.catch(() => cache.delete(key)); // failures don't stick — next call retries
+    // delete-then-set keeps Map insertion order meaningful: the FIRST key really is
+    // the least recently written one, so eviction below removes the right entry
+    cache.delete(key);
+    cache.set(key, { promise, at: Date.now() });
+    if (cache.size > MAX_ENTRIES) {
+        const oldest = cache.keys().next().value;
+        if (oldest !== undefined)
+            cache.delete(oldest);
+    }
+}
+async function load(ticker) {
+    const hit = pickCard(await fetchInstruments([ticker]), ticker);
+    return hit ? toRef(hit) : null;
+}
+function cached(ticker) {
+    const key = ticker.toUpperCase();
+    const hit = cache.get(key);
+    if (hit && Date.now() - hit.at < TTL_MS)
+        return hit.promise;
+    const promise = load(key);
+    store(key, promise);
+    return promise;
+}
+/** ticker → basic instrument info, memoized. Best-effort: returns null on not-found AND on API error. */
+export async function getInstrumentRef(ticker) {
+    try {
+        return await cached(ticker);
+    }
+    catch {
+        return null; // enrichment is best-effort, never fail the parent tool
+    }
+}
+/** Resolve classCode for a ticker, using the explicit value when given */
+export async function resolveClassCode(ticker, classCode) {
+    if (classCode)
+        return classCode;
+    const ref = await cached(ticker);
+    if (!ref?.classCode) {
+        throw new Error(`Cannot resolve classCode for "${ticker}" — pass classCode explicitly (e.g. TQBR for MOEX shares)`);
+    }
+    return ref.classCode;
+}
+/**
+ * Batch variant for tools that take many tickers: uncached tickers are fetched in
+ * chunks of ${BATCH_SIZE} via ONE by-tickers request per chunk (not N single requests),
+ * the cache is seeded, and per-index explicit classCodes are honored.
+ * Throws when any ticker cannot be resolved (same contract as resolveClassCode).
+ */
+export async function resolveClassCodes(tickers, classCodes) {
+    const missing = tickers.filter((t, i) => !classCodes?.[i] && !cache.has(t.toUpperCase()));
+    const chunks = [];
+    for (let i = 0; i < missing.length; i += BATCH_SIZE)
+        chunks.push(missing.slice(i, i + BATCH_SIZE));
+    await mapPool(chunks, 2, async (chunk) => {
+        const cards = await fetchInstruments(chunk);
+        for (const t of chunk) {
+            const key = t.toUpperCase();
+            const card = pickCard(cards, key);
+            store(key, Promise.resolve(card ? toRef(card) : null));
+        }
+    });
+    return mapPool(tickers, 8, (t, i) => resolveClassCode(t, classCodes?.[i]));
+}
+//# sourceMappingURL=instruments-cache.js.map

package/dist/instruments-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruments-cache.js","sourceRoot":"","sources":["../src/instruments-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAajD,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACnC,MAAM,WAAW,GAAG,IAAI,CAAC;AACzB,MAAM,UAAU,GAAG,EAAE,CAAC,CAAC,sCAAsC;AAc7D,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAiB;IACtD,MAAM,GAAG,GAAG,MAAM,QAAQ,CACxB,GAAG,CAAC,WAAW,EACf,yBAAyB,EACzB,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,CACtC,CAAC;IACF,OAAO,QAAQ,CAAgB,GAAG,EAAE,aAAa,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,KAAK,CAAC,GAAkB;IAC/B,yEAAyE;IACzE,2EAA2E;IAC3E,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GACT,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,IAAI,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,YAAY,CAAC;QAC7E,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,YAAY,CAAC;QACpD,MAAM,CAAC,CAAC,CAAC;QACT,EAAE,CAAC;IACL,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;QACxB,IAAI,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;QAC3B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE;QAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE;QACxC,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,CAAC;QACzB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,IAAI;QAChC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;KACrB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAI,KAAU;IAC3C,MAAM,IAAI,GAAG,CAAC,CAAI,EAAwF,EAAE,CAC1G,CAAyF,CAAC;IAC5F,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IACxC,OAAO,CACL,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;QACd,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC;IACrF,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CACd,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,SAAS,QAAQ,CAAC,KAAsB,EAAE,MAAc;IACtD,OAAO,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,oFAAoF;AACpF,iGAAiG;AACjG,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkE,CAAC;AAExF,SAAS,KAAK,CAAC,GAAW,EAAE,OAAsC;IAChE,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,2CAA2C;IACnF,gFAAgF;IAChF,4EAA4E;IAC5E,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAClB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;QACzC,IAAI,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI,CAAC,MAAc;IAChC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/D,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,SAAS,MAAM,CAAC,MAAc;IAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,EAAE,GAAG,MAAM;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yGAAyG;AACzG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc;IACnD,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,CAAC,wDAAwD;IACvE,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc,EAAE,SAAkB;IACvE,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,2DAA2D,CAAC,CAAC;IACtH,CAAC;IACD,OAAO,GAAG,CAAC,SAAS,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAiB,EAAE,UAAqB;IAC9E,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC1F,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,UAAU;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IACnG,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACvC,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAClC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/output.js

@@ -0,0 +1,139 @@
+import { mkdir, writeFile, realpath, lstat, open, unlink } from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { ok } from "./helpers.js";
+/** Inline responses larger than this get a hint to use outputPath */
+const HINT_THRESHOLD = 25_000;
+/** Shared schema fragment: every read tool accepts optional file output */
+export const outputParams = {
+    outputPath: z
+        .string()
+        .optional()
+        .describe("Write the full result to this file (path relative to the output root: BCS_OUTPUT_DIR or server cwd) instead of returning it inline. The response becomes a short summary {savedTo, records, bytes, sample}. Use for bulk data to keep the context clean. For get_candles this also enables full-history fetching (chunking beyond the 1000-bar API limit)."),
+    outputFormat: z
+        .enum(["json", "csv"])
+        .optional()
+        .describe("File format; default json (or csv if outputPath ends with .csv). csv writes the main flat array of the response."),
+};
+export function outputRoot() {
+    return process.env.BCS_OUTPUT_DIR || process.cwd();
+}
+/** Resolve a user-supplied relative path strictly inside the output root (no .. / symlink escapes) */
+async function resolveSafe(rel) {
+    const root = path.resolve(outputRoot());
+    const target = path.resolve(root, rel);
+    if (target !== root && !target.startsWith(root + path.sep)) {
+        throw new Error(`outputPath escapes the output root (${root}) — use a relative path inside it`);
+    }
+    await mkdir(path.dirname(target), { recursive: true });
+    const [realParent, realRoot] = await Promise.all([realpath(path.dirname(target)), realpath(root)]);
+    if (realParent !== realRoot && !realParent.startsWith(realRoot + path.sep)) {
+        throw new Error("outputPath escapes the output root via a symlink");
+    }
+    const finalPath = path.join(realParent, path.basename(target));
+    // Refuse to write THROUGH a symlink at the final component (it could point outside the root)
+    try {
+        const st = await lstat(finalPath);
+        if (st.isSymbolicLink()) {
+            throw new Error("outputPath refers to a symlink — refusing to write through it");
+        }
+        if (st.isDirectory()) {
+            throw new Error("outputPath points to a directory — include a file name (e.g. data/report.json)");
+        }
+    }
+    catch (e) {
+        if (e.code !== "ENOENT")
+            throw e; // non-existent target is fine
+    }
+    return finalPath;
+}
+export function toCsv(rows) {
+    if (!rows.length)
+        return "";
+    // Union of keys across ALL rows — heterogeneous rows (e.g. found/not-found) keep every column
+    const cols = [];
+    const seen = new Set();
+    for (const row of rows) {
+        for (const k of Object.keys(row)) {
+            if (!seen.has(k)) {
+                seen.add(k);
+                cols.push(k);
+            }
+        }
+    }
+    const esc = (v) => {
+        if (v == null)
+            return "";
+        const s = typeof v === "object" ? JSON.stringify(v) : String(v);
+        return /[",\r\n]/.test(s) ? `"${s.replace(/"/g, '""')}"` : s;
+    };
+    return [cols.join(","), ...rows.map((r) => cols.map((c) => esc(r[c])).join(","))].join("\n");
+}
+/** Write raw text into the output root */
+export async function writeRaw(rel, body) {
+    const file = await resolveSafe(rel);
+    await writeFile(file, body, "utf8");
+    return { savedTo: file, bytes: Buffer.byteLength(body, "utf8") };
+}
+/**
+ * Streaming writer for large outputs: write chunks incrementally so peak memory stays small.
+ * close() returns total bytes; remove() deletes the file (e.g. on rollback / empty result).
+ */
+export async function createSafeWriter(rel) {
+    const file = await resolveSafe(rel);
+    const fh = await open(file, "w");
+    let bytes = 0;
+    let closed = false;
+    return {
+        savedTo: file,
+        write: async (chunk) => {
+            const buf = Buffer.from(chunk, "utf8");
+            await fh.write(buf);
+            bytes += buf.length;
+        },
+        close: async () => {
+            if (!closed) {
+                closed = true;
+                await fh.close();
+            }
+            return bytes;
+        },
+        remove: async () => {
+            await unlink(file).catch(() => { });
+        },
+    };
+}
+/**
+ * Deliver a tool result: inline (with a size hint) or to a file with a compact summary.
+ * `rows` is the flat array used for csv and record counting; null = csv unsupported.
+ */
+export async function deliver(data, rows, out, extras = {}) {
+    if (!out.outputPath) {
+        const res = ok(data);
+        if (res.content[0].text.length > HINT_THRESHOLD) {
+            // separate content item — keeps content[0].text valid JSON for programmatic consumers
+            res.content.push({
+                type: "text",
+                text: "NOTE: large response — pass outputPath to write it to a file and keep the context clean.",
+            });
+        }
+        return res;
+    }
+    // Nested responses (rows === null) default to json even for *.csv paths — but an
+    // EXPLICIT csv request still fails loudly below instead of silently writing JSON.
+    const format = out.outputFormat ?? (rows && out.outputPath.endsWith(".csv") ? "csv" : "json");
+    if (format === "csv" && !rows) {
+        throw new Error("csv is not supported for this tool's nested response — use outputFormat: json");
+    }
+    // compact JSON for files (pretty-print can double memory / hit V8's string length cap on big data)
+    const body = format === "csv" ? toCsv(rows) + "\n" : JSON.stringify(data) + "\n";
+    const { savedTo, bytes } = await writeRaw(out.outputPath, body);
+    return ok({
+        savedTo,
+        format,
+        ...(rows ? { records: rows.length, sample: rows.slice(0, 2) } : {}),
+        bytes,
+        ...extras,
+    });
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"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"}