@sharpe-terminal/mcp-server 1.2.0 → 1.5.0

package/dist/composite-tools.d.ts

@@ -1,12 +1,58 @@
 /**
- * Composite tools that call multiple API endpoints concurrently
- * and return formatted markdown. Mirrors the Python server's
- * analyze_coin, market_briefing, and find_opportunities.
+ * Composite tools that call several API endpoints concurrently and return
+ * formatted markdown. Mirrors the Python server's analyze_coin,
+ * market_briefing and find_opportunities line for line.
+ *
+ * Every number a composite prints is a field the API serves, the value the web
+ * page and /api/v1 give for the same request (engine L4 WP-D14): the
+ * rankings, floors, averages and APRs are request parameters and response
+ * fields, never recomputed here. A report ends with the freshness of every
+ * answer it read.
  */
+import { type DataFreshness } from "./api-client.ts";
 export declare function fmtUsd(value: number | null | undefined): string;
 export declare function fmtPct(value: number | null | undefined): string;
 export declare function fmtRate(value: number | null | undefined): string;
+/** An annualized fraction (0.25 = 25%) as a percentage, or N/A. */
+export declare function fmtApr(value: unknown): string;
+/**
+ * The open-interest floor (USD) the composites ask the API to apply: funding
+ * extremes (`min_oi_usd`), the spot-perp perp leg and both cross-exchange legs
+ * (`minOiUsd`, `minVolUsd`). Unfloored, every extreme was a dust market (ESIM
+ * on KuCoin: $33K of OI at -16,862% APR, 2026-09-24 audit). The API applies
+ * it; unknown open interest fails it there.
+ */
+export declare const LIQUIDITY_FLOOR_USD = 1000000;
+/**
+ * `max_age_h` on the funding calls: v1 leaves out rows not written for six
+ * hours (V1_MAX_AGE_HOURS in the funding read model), so a keyless answer
+ * counts the same rows as a keyed one. v1 ignores the parameter.
+ */
+export declare const FUNDING_MAX_AGE_HOURS = 6;
+/** One answer's freshness, as the Python server prints it: `dataset · as of … · status[ · degraded] (warnings)`. */
+export declare function freshnessLine(freshness: DataFreshness): string;
+/**
+ * The report with a closing line naming the freshness of every answer it read
+ * (engine L5 WP-S12), each once, in the order the calls were made. Nothing
+ * changes when no answer said anything.
+ */
+export declare function withFreshnessReport(report: string, answers: unknown[]): string;
 type ApiCaller = (apiPath: string, fallbackPath: string, args: Record<string, unknown>) => Promise<unknown>;
+/**
+ * Find the prediction row for a ticker in the endpoint's own coverage list.
+ *
+ * The price-prediction endpoint is keyed by CoinGecko slug ("bitcoin",
+ * "avalanche-2", "matic-network"), never by ticker, and a lowercased ticker is
+ * not a slug. Guessing one either 404s or — far worse — resolves to whichever
+ * unrelated asset happens to own that slug, and tickers are shared across
+ * thousands of assets in this dataset. So the guess is a silent wrong-coin
+ * risk, never a convenience: it is resolve-or-say-so here.
+ *
+ * The list response (`GET .../price-prediction/data` with no `coin`) carries
+ * both the ticker (`coin`) and the `slug` for every covered asset, so an exact
+ * ticker match against it is the endpoint's own documented contract.
+ */
+export declare function findPredictionRow(payload: unknown, ticker: string): Record<string, unknown> | null;
 export declare function analyzeCoin(callApi: ApiCaller, coin: string): Promise<string>;
 export declare function marketBriefing(callApi: ApiCaller): Promise<string>;
 export declare function findOpportunities(callApi: ApiCaller): Promise<string>;

package/dist/composite-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composite-tools.d.ts","sourceRoot":"","sources":["../src/composite-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAW/D;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAG/D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGhE;AAgBD,KAAK,SAAS,GAAG,CACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;AAuCtB,wBAAsB,WAAW,CAC/B,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAgNjB;AAID,wBAAsB,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CA6LxE;AAID,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAiM3E"}
+{"version":3,"file":"composite-tools.d.ts","sourceRoot":"","sources":["../src/composite-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKlE,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAW/D;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAG/D;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGhE;AAED,mEAAmE;AACnE,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG7C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,UAAY,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAgDvC,oHAAoH;AACpH,wBAAgB,aAAa,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAW9D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAAE,GACjB,MAAM,CAcR;AAID,KAAK,SAAS,GAAG,CACf,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC,OAAO,CAAC,CAAC;AA2CtB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAchC;AAuED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CA2IjB;AAQD,wBAAsB,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CA0KxE;AAaD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAsG3E"}