@continuumdao/continuum-node-sdk 1.3.0 → 1.3.1

package/dist/mcp/resources/technical-indicators.md

@@ -0,0 +1,86 @@
+# Technical indicators (continuum-mcp)
+
+Tools on the builtin **continuum-mcp** server wrapping [fast-technical-indicators](https://www.npmjs.com/package/fast-technical-indicators). Call **`list_technical_indicators`** first to see required input profiles, then **`calculate_technical_indicator`**.
+
+## Input profiles
+
+| Profile | Provide in `input` |
+|---------|-------------------|
+| `close_series` | `values` or `close`, or `candles[]` (close extracted) |
+| `ohl_series` | `high`, `low` |
+| `ohlc_series` | `high`, `low`, `close` |
+| `hlcv_series` | `high`, `low`, `close`, `volume` |
+| `ohlcv_series` | `open`, `high`, `low`, `close`, `volume` |
+| `close_volume_series` | `close` (or `values`), `volume` |
+| `candle_objects` | `candles[]` with `{ open, high, low, close, volume? }` |
+| `range_scalar` | `range: { high, low, trend? }` |
+| `dual_series` | `valuesA`, `valuesB` |
+| `special` | `renko`: `candles[]` + `params.brickSize`; `fibonacciProjection`: `values`/`close` + `swingPoints` |
+
+All array fields must have equal length where applicable. Max series length defaults to **50_000** (`TA_MCP_MAX_SERIES_LENGTH`).
+
+## Warmup
+
+Many indicators return `undefined` for initial bars until enough history exists. The response includes **`warmupCount`**. Set **`options.trimWarmup: true`** to drop leading empty slots from **`result`**.
+
+## Examples
+
+### SMA (close series)
+
+```json
+{
+  "indicator": "sma",
+  "params": { "period": 3 },
+  "input": { "values": [1, 2, 3, 4, 5] },
+  "options": { "trimWarmup": true }
+}
+```
+
+### Stochastic (OHLC)
+
+```json
+{
+  "indicator": "stochastic",
+  "params": { "period": 14, "signalPeriod": 3 },
+  "input": {
+    "high": [48.7, 48.9, 49.0],
+    "low": [47.8, 48.1, 48.2],
+    "close": [48.2, 48.6, 48.8]
+  }
+}
+```
+
+### MACD (objects output)
+
+```json
+{
+  "indicator": "macd",
+  "input": { "values": [44, 44.5, 45, 44.8, 45.2] }
+}
+```
+
+### Fibonacci retracement (levels)
+
+```json
+{
+  "indicator": "fibonacci",
+  "input": { "range": { "high": 100, "low": 80, "trend": "up" } }
+}
+```
+
+### Doji pattern (booleans)
+
+```json
+{
+  "indicator": "doji",
+  "input": {
+    "candles": [
+      { "open": 10, "high": 11, "low": 9, "close": 10.05 }
+    ]
+  }
+}
+```
+
+## Aliases
+
+Some indicators accept alternate names (e.g. `ichimokucloud` → `ichimokukinkouhyou`, `keltnerchannels` → `keltnerchannel`, `fibonacciretracement` → `fibonacci`). The response **`indicator`** field always uses the canonical id.

package/dist/mcp/resources/vpn.md

@@ -0,0 +1,41 @@
+# VPN (admin + egress)
+
+WireGuard admin VPN and peer egress flows on the attached node. Read tools use GET management API routes; write and download tools POST management-signed bodies with the preferred Ed25519 management key (same as agent skills and cron jobs).
+
+Prerequisites: local management private key in `added_keys/` (see `management-signer.md`), node attached via SDK config.
+
+Download tools write client files to **user_folder** (default `MPC_AUTH_USER_FOLDER=/app/user_folder`, host bind mount in Docker). Override with optional `userFolder` on download inputs.
+
+## Admin VPN
+
+- `get_vpn_status`
+  - GET `/vpn/status` — availability, active profile, obfuscation, billing summary.
+- `set_vpn_enabled`
+  - POST `/vpn/setEnabled` — `enabled` true/false; when enabling: optional `profile` (`split`|`full`, default `full`), optional `obfuscation`.
+  - Triggers host systemd automation via pending VPN file (same as node app Enable/Disable).
+- `download_vpn_admin_client_config`
+  - POST `/vpn/clientConfig` — optional `profile`, `obfuscation` (when obfuscated), optional `userFolder`.
+  - Saves WireGuard `.conf` (and transport proxy file when obfuscated) under user_folder.
+  - Returns `wireGuardPath`, optional `transportPath`, and `setupInstructions` when provided.
+
+## Egress (provider + consumer)
+
+- `get_vpn_egress_status`
+  - GET `/vpn/egress/status` on **this** node when acting as an egress provider.
+- `set_vpn_egress_sharing`
+  - POST `/vpn/egress/setSharing` — `enabled`, optional `obfuscation`, optional `defaultRateLimitMbps`.
+- `revoke_vpn_egress_peer`
+  - POST `/vpn/egress/revokePeer` — `consumerNodeKey` (128-char hex, lowercase).
+- `list_vpn_egress_exits`
+  - GET `/vpn/egress/availableExits` — exit routes discovered from other nodes (`address`, `publicKey`, country, obfuscation, billing fields).
+- `download_vpn_egress_client_config`
+  - POST `/vpn/egress/requestClientConfig` — `targetAddress` from an exit row, optional `obfuscation`, optional `userFolder`.
+  - Saves `cont-egress.conf` (and transport file when needed) to user_folder.
+
+## Typical flows
+
+**Admin connect:** `get_vpn_status` → ensure billing month active (MPA VPN tools in `mpc.md`) → `set_vpn_enabled` `{ enabled: true, profile: "full" }` → wait for active status → `download_vpn_admin_client_config`.
+
+**Consumer egress:** `list_vpn_egress_exits` → pick `address` → `download_vpn_egress_client_config` `{ targetAddress: "…" }`.
+
+**Provider sharing:** `set_vpn_egress_sharing` `{ enabled: true, defaultRateLimitMbps: 20 }` → revoke with `revoke_vpn_egress_peer` when access should end.

package/dist/mcp/ta/register.d.ts

@@ -1,6 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { mcpStructuredContent } from '../tool-utils.js';
 export declare function registerTaTools(server: McpServer): void;
+export declare function registerTaResources(server: McpServer): void;
 export declare function createTaMcpServer(): McpServer;
 export { mcpStructuredContent };
 //# sourceMappingURL=register.d.ts.map

package/dist/mcp/ta/register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/mcp/ta/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAclE,OAAO,EAAC,oBAAoB,EAA4B,MAAM,kBAAkB,CAAC;AAIjF,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuBvD;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAuC7C;AAED,OAAO,EAAC,oBAAoB,EAAC,CAAC"}
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/mcp/ta/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAYlE,OAAO,EAAC,oBAAoB,EAA4B,MAAM,kBAAkB,CAAC;AAEjF,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuBvD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAO3D;AAED,wBAAgB,iBAAiB,IAAI,SAAS,CAiB7C;AAED,OAAO,EAAC,oBAAoB,EAAC,CAAC"}

package/dist/mcp/ta/register.js

@@ -1,12 +1,9 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { promises as fs } from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
 import { z } from 'zod';
 import { calculateTechnicalIndicator, listTechnicalIndicators, } from '../../core/ta/calculate.js';
 import { CalculateTechnicalIndicatorInputSchema, CalculateTechnicalIndicatorOutputSchema, ListTechnicalIndicatorsOutputSchema, } from '../../core/ta/schemas.js';
+import { registerMcpMarkdownResource } from '../mcp-resources.js';
 import { mcpStructuredContent, sdkResultToCallToolResult } from '../tool-utils.js';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
 export function registerTaTools(server) {
     server.registerTool('list_technical_indicators', {
         description: 'List technical indicators available via calculate_technical_indicator: id, category, inputProfile, defaultParams, outputKind. Call this before computing.',
@@ -19,6 +16,9 @@ export function registerTaTools(server) {
         outputSchema: CalculateTechnicalIndicatorOutputSchema,
     }, async (input) => sdkResultToCallToolResult(calculateTechnicalIndicator(input)));
 }
+export function registerTaResources(server) {
+    registerMcpMarkdownResource(server, 'technical_indicators_docs', 'technical-indicators.md', 'Technical indicators: input profiles, warmup semantics, and examples.');
+}
 export function createTaMcpServer() {
     const server = new McpServer({
         name: 'continuum-ta-mcp',
@@ -29,22 +29,7 @@ export function createTaMcpServer() {
         },
     });
     registerTaTools(server);
-    const resourcePath = path.join(__dirname, 'resources', 'indicators.md');
-    server.registerResource('technical-indicators', 'docs://technical-indicators', {
-        description: 'Technical indicators MCP usage: input profiles, warmup semantics, and examples.',
-        mimeType: 'text/markdown',
-    }, async () => {
-        const text = await fs.readFile(resourcePath, 'utf8');
-        return {
-            contents: [
-                {
-                    uri: 'docs://technical-indicators',
-                    mimeType: 'text/markdown',
-                    text,
-                },
-            ],
-        };
-    });
+    registerTaResources(server);
     return server;
 }
 export { mcpStructuredContent };

package/dist/mcp/ta/register.js.map

@@ -1 +1 @@
-{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/mcp/ta/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAClE,OAAO,EAAC,QAAQ,IAAI,EAAE,EAAC,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AACvC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EACN,2BAA2B,EAC3B,uBAAuB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACN,sCAAsC,EACtC,uCAAuC,EACvC,mCAAmC,GACnC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAC,oBAAoB,EAAE,yBAAyB,EAAC,MAAM,kBAAkB,CAAC;AAEjF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,UAAU,eAAe,CAAC,MAAiB;IAChD,MAAM,CAAC,YAAY,CAClB,2BAA2B,EAC3B;QACC,WAAW,EACV,2JAA2J;QAC5J,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;QAClC,YAAY,EAAE,mCAAmC;KACjD,EACD,KAAK,IAAI,EAAE,CAAC,yBAAyB,CAAC,uBAAuB,EAAE,CAAC,CAChE,CAAC;IAEF,MAAM,CAAC,YAAY,CAClB,+BAA+B,EAC/B;QACC,WAAW,EACV,iNAAiN;QAClN,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,uCAAuC;KACrD,EACD,KAAK,EAAE,KAA6D,EAAE,EAAE,CACvE,yBAAyB,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC,CAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC3B;QACC,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO;KAChB,EACD;QACC,YAAY,EAAE;YACb,KAAK,EAAE,EAAE;SACT;KACD,CACD,CAAC;IAEF,eAAe,CAAC,MAAM,CAAC,CAAC;IAExB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;IACxE,MAAM,CAAC,gBAAgB,CACtB,sBAAsB,EACtB,6BAA6B,EAC7B;QACC,WAAW,EACV,iFAAiF;QAClF,QAAQ,EAAE,eAAe;KACzB,EACD,KAAK,IAAI,EAAE;QACV,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACrD,OAAO;YACN,QAAQ,EAAE;gBACT;oBACC,GAAG,EAAE,6BAA6B;oBAClC,QAAQ,EAAE,eAAe;oBACzB,IAAI;iBACJ;aACD;SACD,CAAC;IACH,CAAC,CACD,CAAC;IAEF,OAAO,MAAM,CAAC;AACf,CAAC;AAED,OAAO,EAAC,oBAAoB,EAAC,CAAC"}
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/mcp/ta/register.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAC;AAClE,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AACtB,OAAO,EACN,2BAA2B,EAC3B,uBAAuB,GACvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACN,sCAAsC,EACtC,uCAAuC,EACvC,mCAAmC,GACnC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAC,2BAA2B,EAAC,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAC,oBAAoB,EAAE,yBAAyB,EAAC,MAAM,kBAAkB,CAAC;AAEjF,MAAM,UAAU,eAAe,CAAC,MAAiB;IAChD,MAAM,CAAC,YAAY,CAClB,2BAA2B,EAC3B;QACC,WAAW,EACV,2JAA2J;QAC5J,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;QAClC,YAAY,EAAE,mCAAmC;KACjD,EACD,KAAK,IAAI,EAAE,CAAC,yBAAyB,CAAC,uBAAuB,EAAE,CAAC,CAChE,CAAC;IAEF,MAAM,CAAC,YAAY,CAClB,+BAA+B,EAC/B;QACC,WAAW,EACV,iNAAiN;QAClN,WAAW,EAAE,sCAAsC;QACnD,YAAY,EAAE,uCAAuC;KACrD,EACD,KAAK,EAAE,KAA6D,EAAE,EAAE,CACvE,yBAAyB,CAAC,2BAA2B,CAAC,KAAK,CAAC,CAAC,CAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACpD,2BAA2B,CAC1B,MAAM,EACN,2BAA2B,EAC3B,yBAAyB,EACzB,uEAAuE,CACvE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAChC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC3B;QACC,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO;KAChB,EACD;QACC,YAAY,EAAE;YACb,KAAK,EAAE,EAAE;SACT;KACD,CACD,CAAC;IAEF,eAAe,CAAC,MAAM,CAAC,CAAC;IACxB,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAE5B,OAAO,MAAM,CAAC;AACf,CAAC;AAED,OAAO,EAAC,oBAAoB,EAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@continuumdao/continuum-node-sdk",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "JSON SDK for the Continuum node client management API",
   "keywords": [],
   "homepage": "https://github.com/ContinuumDAO/continuum-node-sdk#readme",
@@ -31,7 +31,7 @@
   "scripts": {
     "prebuild": "bash scripts/prebuild-sync-defi.sh",
     "build": "tsc",
-    "postbuild": "mkdir -p dist/mcp/ta/resources && cp src/mcp/ta/resources/indicators.md dist/mcp/ta/resources/indicators.md",
+    "postbuild": "mkdir -p dist/mcp/resources && cp -r src/mcp/resources/. dist/mcp/resources/",
     "prepublishOnly": "npm run build",
     "test": "npm run build && node --experimental-strip-types --test 'test/**/*.test.ts'",
     "mcp:start": "node dist/mcp/server/index.js",