@continuumdao/continuum-node-sdk 1.3.20 → 1.3.22

package/dist/mcp/defi/discovery.js

@@ -3,6 +3,7 @@ import { getProtocolModules } from '@continuumdao/ctm-mpc-defi/agent';
 import { z } from 'zod';
 import { resolveChainRegistryEntry } from '../../core/registry/networks.js';
 import { markProtocolLoaded } from './register-protocol-tools.js';
+import { defiOhlcvChartWorkflowReminder, defiProtocolFetchOhlcvToolName, } from './ohlcv-chart-workflow.js';
 import { isUniswapApiKeyConfigured, UNISWAP_API_KEY_ENV, UNISWAP_API_KEY_SIGNUP_URL, } from './uniswap-api-key.js';
 const protocolIdSchema = z.object({
     protocolId: z.string().min(1),
@@ -52,6 +53,7 @@ export function registerDefiDiscoveryTools(server, config, defiContext) {
             advisoryTools: z.array(z.string()),
             skillPreview: z.string().optional(),
             skillHint: z.string().optional(),
+            chartWorkflow: z.string().optional(),
             uniswapApiKeyConfigured: z.boolean().optional(),
             uniswapApiKeyEnvVar: z.string().optional(),
             uniswapApiKeySignupUrl: z.string().optional(),
@@ -72,13 +74,17 @@ export function registerDefiDiscoveryTools(server, config, defiContext) {
                 uniswapApiKeySignupUrl: UNISWAP_API_KEY_SIGNUP_URL,
             }
             : {};
-        if (defiContext.isLoaded(protocolId)) {
+        const fetchOhlcvTool = defiProtocolFetchOhlcvToolName(protocolId);
+        const chartWorkflow = fetchOhlcvTool
+            ? defiOhlcvChartWorkflowReminder(protocolId, fetchOhlcvTool)
+            : undefined;
+        const buildPayload = (toolNames) => {
             const advisor = getProtocolSupportAdvisor(protocolId);
             const skill = getProtocolSkill(protocolId);
-            const payload = {
+            return {
                 loaded: true,
                 protocolId,
-                toolNames: defiContext.getToolNames(protocolId),
+                toolNames,
                 tokenFilter: advisor?.tokenFilter,
                 advisoryTools: [
                     'get_defi_protocol_supported_chains',
@@ -89,32 +95,19 @@ export function registerDefiDiscoveryTools(server, config, defiContext) {
                 skillHint: skill
                     ? 'Call get_defi_protocol_skill for full SKILL.md workflow guidance.'
                     : undefined,
+                ...(chartWorkflow ? { chartWorkflow } : {}),
                 ...uniswapExtras,
             };
+        };
+        if (defiContext.isLoaded(protocolId)) {
+            const payload = buildPayload(defiContext.getToolNames(protocolId));
             return {
                 content: [{ type: 'text', text: JSON.stringify(payload) }],
                 structuredContent: payload,
             };
         }
         const toolNames = markProtocolLoaded(defiContext, protocolId);
-        const advisor = getProtocolSupportAdvisor(protocolId);
-        const skill = getProtocolSkill(protocolId);
-        const payload = {
-            loaded: true,
-            protocolId,
-            toolNames,
-            tokenFilter: advisor?.tokenFilter,
-            advisoryTools: [
-                'get_defi_protocol_supported_chains',
-                'get_defi_protocol_supported_tokens',
-                'get_defi_protocol_skill',
-            ],
-            skillPreview: skill?.slice(0, 500),
-            skillHint: skill
-                ? 'Call get_defi_protocol_skill for full SKILL.md workflow guidance.'
-                : undefined,
-            ...uniswapExtras,
-        };
+        const payload = buildPayload(toolNames);
         void server.server.sendToolListChanged?.().catch(() => undefined);
         return {
             content: [{ type: 'text', text: JSON.stringify(payload) }],

package/dist/mcp/defi/discovery.js.map

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

package/dist/mcp/defi/ohlcv-chart-workflow.d.ts

@@ -0,0 +1,5 @@
+/** First fetch_ohlcv tool for a protocol, if any. */
+export declare function defiProtocolFetchOhlcvToolName(protocolId: string): string | undefined;
+/** Injected on load_defi_protocol so dynamic protocol load carries chart rules in the same tool result. */
+export declare function defiOhlcvChartWorkflowReminder(protocolId: string, fetchTool: string): string;
+//# sourceMappingURL=ohlcv-chart-workflow.d.ts.map

package/dist/mcp/defi/ohlcv-chart-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohlcv-chart-workflow.d.ts","sourceRoot":"","sources":["../../../src/mcp/defi/ohlcv-chart-workflow.ts"],"names":[],"mappings":"AAEA,qDAAqD;AACrD,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErF;AAED,2GAA2G;AAC3G,wBAAgB,8BAA8B,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQ5F"}

package/dist/mcp/defi/ohlcv-chart-workflow.js

@@ -0,0 +1,16 @@
+import { getToolsForProtocol } from './catalog-adapter.js';
+/** First fetch_ohlcv tool for a protocol, if any. */
+export function defiProtocolFetchOhlcvToolName(protocolId) {
+    return getToolsForProtocol(protocolId).find(t => t.name.includes('fetch_ohlcv'))?.name;
+}
+/** Injected on load_defi_protocol so dynamic protocol load carries chart rules in the same tool result. */
+export function defiOhlcvChartWorkflowReminder(protocolId, fetchTool) {
+    return [
+        `Charting ${protocolId} OHLCV (required when the operator asks to chart/graph/plot):`,
+        `1. Call ${fetchTool} for candle rows.`,
+        '2. Same agent turn — call continuum__prepare_chart_from_rows with the full fetch JSON as toolResult and a descriptive title (asset + interval + window).',
+        'Fetching candles does not render a chart. The UI only draws continuum/chart/v1 from the prepare_chart_from_rows MCP result — not assistant markdown.',
+        'Also see node skills chart-defaults and chart-periods (initialLoad). Full protocol detail: get_defi_protocol_skill.',
+    ].join('\n');
+}
+//# sourceMappingURL=ohlcv-chart-workflow.js.map

package/dist/mcp/defi/ohlcv-chart-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ohlcv-chart-workflow.js","sourceRoot":"","sources":["../../../src/mcp/defi/ohlcv-chart-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,mBAAmB,EAAC,MAAM,sBAAsB,CAAC;AAEzD,qDAAqD;AACrD,MAAM,UAAU,8BAA8B,CAAC,UAAkB;IAChE,OAAO,mBAAmB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,CAAC;AACxF,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,8BAA8B,CAAC,UAAkB,EAAE,SAAiB;IACnF,OAAO;QACN,YAAY,UAAU,+DAA+D;QACrF,WAAW,SAAS,mBAAmB;QACvC,0JAA0J;QAC1J,sJAAsJ;QACtJ,qHAAqH;KACrH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/mcp/resources/chart.md

@@ -20,13 +20,30 @@ Each object in **`series[].data`** is normalized before charting. **`prepare_cha
 |--------|------------|---------------------|
 | CoinGecko / agent | `time` (Unix **seconds**) | numbers |
 | Hyperliquid `fetch_ohlcv` | `timestampMs` | strings → coerced |
-| GMX `fetch_ohlcv` | `timestampMs` | strings (no volume on row) |
+| GMX `fetch_ohlcv` | `timestampMs` | strings (no volume on row); top-level `{ symbol, timeframe, candles }` |
 | Binance `get_klines` (JSON) | `openTime` (ms) | strings → coerced |
 | Bybit `getMarketKline` | tuple `[startTime, …]` or `{ startTime, open, … }` | strings → coerced |
 | Bitget REST / MCP | tuple `[ts, o,h,l,c,vol,…]` or `{ timestamp, … }` | strings → coerced |
 | CoinMarketCap OHLCV API | `{ time_open, quote: { USD: { … } } }` | numbers; nested `quote` flattened |
 | Uniswap subgraph (`PoolHourData` / `PoolDayData`) | `periodStartUnix` | `open`/`high`/`low`/`close`, optional `volumeUSD` |
 
+### Generic OHLCV engine (adding a new source)
+
+SDK charting is **vendor-agnostic** after fetch:
+
+1. **`extractOhlcvBarsFromUnknown`** — pulls a bar array from any MCP/tool JSON (nested wrappers, stringified JSON, `{ prices, total_volumes }` spot series). Walks unknown wrapper keys up to depth 6; prefers known keys (`result`, `candles`, `ohlcv`, `klines`, …).
+2. **`normalizeCandleRow`** (`point-normalize.ts`) — single source of truth per bar: time fields (`time`, `timestampMs`, `timestamp`, `openTime`, `t`, `periodStartUnix`, …), OHLC aliases (`o`/`h`/`l`/`c`, `price_*`), nested CMC `quote.USD`, numeric strings → numbers, ms → sec.
+3. **`prepare_chart_from_rows`** / **`prepareChart`** — sort, dedupe, trim, optional volume histogram (only when volume present), default EMA/RSI overlays.
+
+**Volume optional:** rows without `volume` / `v` / tuple index 5 chart as **candles only** (warning in `meta.warnings`; volume pane omitted). GMX is an example.
+
+**New fetch tool checklist:**
+
+- Return bars as an array of objects or OHLC tuples, anywhere in the JSON tree (or add a known wrapper key to `NESTED_BAR_KEYS` in `fetch-result.ts` if you want it prioritized).
+- Prefer `{ title, label, …bars… }` on the fetch payload for chart titles; otherwise `extractChartMetadataFromFetchPayload` infers from common DeFi shapes.
+- Add one **`extractOhlcvBarsFromUnknown` + `prepareChartFromRows`** test with a sample row from your API.
+- Optional: extend **`mapOhlcFieldAliases`** / **`flattenVendorCandleRow`** in `point-normalize.ts` only when the row shape is genuinely new (not covered by existing time/OHLC fields).
+
 - **`ctm_uniswap_v4_*`** MCP tools do **not** return candles — only quotes, swaps, and LP. Pool OHLCV comes from a **subgraph** or third-party indexer; map `poolHourDatas` into **`series[0].data`**.
 - Times in **milliseconds** (>1e12) are converted to **seconds** automatically.
 - **`open` / `high` / `low` / `close` / `volume`** may be numbers or numeric strings.
@@ -261,7 +278,39 @@ First bar: close ≥ open → green volume. Second: close < open → red volume.
 - **`priceScaleId`**: `"left"` | `"right"` — use different scales for unlike units.
 - **`overlay`**: `true` — draw line/area on the main price pane.
 
-When the user asks to graph, plot, or chart data, call **`prepare_chart`** after assembling series — do not rely on markdown tables alone.
+When the user asks to graph, plot, or chart data, call **`prepare_chart_from_rows`** (or **`prepare_chart`**) after assembling series — do not rely on markdown tables alone.
+
+**Where charts appear:** the node app renders charts under the **MCP result** row for `prepare_chart` / `prepare_chart_from_rows`, not inside the assistant text bubble. A prose reply like “chart prepared” without a successful chart tool result means nothing was rendered.
+
+**Hyperliquid / DeFi `fetch_ohlcv`:** returns `{ ohlcv: { coin, interval, candles: [...] } }`. After `fetch_ohlcv`, call `prepare_chart_from_rows` with the **full fetch JSON** as `toolResult` and a descriptive `title`. The node auto-binds the last OHLCV fetch when `prepare_chart_from_rows` is called with only a title.
+
+## Live updates (agent chat + DeFi dialogs)
+
+When `prepare_chart_from_rows` receives a fetch payload the SDK recognizes (Hyperliquid `ohlcv`, GMX flat `{ symbol, timeframe, candles }`, CoinGecko market chart), the output may include optional **`live`**:
+
+```json
+{
+  "kind": "continuum/chart/v1",
+  "chart": { "...": "..." },
+  "live": {
+    "providerId": "hyperliquid.allMids",
+    "bucketSec": 3600,
+    "pollMs": 4000,
+    "maxPoints": 400,
+    "params": { "coin": "ETH", "interval": "1h" }
+  }
+}
+```
+
+The node app polls a **tick adapter** registered for `providerId` every `pollMs` (default **4000**). Each tick is `{ timeMs, price, volume? }`. The SDK merges it into the last OHLCV bar (or appends on bucket rollover) and recomputes overlays locally — **no full OHLCV refetch** on each poll.
+
+| `providerId` | Tick source |
+|--------------|-------------|
+| `hyperliquid.allMids` | Hyperliquid `allMids` for `params.coin` |
+| `gmx.markPrice` | GMX index mark USD for `params.symbol` |
+| `coingecko.simple` | CoinGecko simple price for `params.coinId` |
+
+**Static charts:** KeyGen chart attachments and charts without `live` are never polled. **`prepare_chart`** alone does not attach `live` — pass the original fetch JSON via **`prepare_chart_from_rows`** (`toolResult`) so binding can be inferred.
 
 ## KeyGen orchestration (sub-agents)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@continuumdao/continuum-node-sdk",
-  "version": "1.3.20",
+  "version": "1.3.22",
   "description": "JSON SDK for the Continuum node client management API",
   "keywords": [],
   "homepage": "https://github.com/ContinuumDAO/continuum-node-sdk#readme",
@@ -40,7 +40,7 @@
     "sync-vendor-defi": "bash scripts/sync-vendor-defi.sh"
   },
   "dependencies": {
-    "@continuumdao/ctm-mpc-defi": "^0.2.17",
+    "@continuumdao/ctm-mpc-defi": "^0.2.19",
     "@curvefi/api": "^2.69.2",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "express": "^5.2.1",