@oobe-protocol-labs/sap-mcp-server 0.9.2 → 0.9.3

package/dist/strategies/strategy-store.js

@@ -0,0 +1,165 @@
+/**
+ * @module strategies/strategy-store
+ * @description File-based strategy store with JSON persistence.
+ *
+ * Strategies are stored as JSON files in ~/.config/sap-mcp/strategies/<category>/<name>.json
+ * Each strategy has a version number, active flag, and arbitrary JSON config.
+ *
+ * The store uses synchronous file I/O (strategies are small JSON files).
+ * The directory structure is:
+ *   ~/.config/sap-mcp/strategies/
+ *     defi/
+ *       jupiter-arb.json
+ *     trading/
+ *       volatility-breakout.json
+ *     meme/
+ *       newlisting-snipe.json
+ *     payments/
+ *       x402-budget.json
+ *     premium/
+ *       pyth-watch.json
+ */
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const STRATEGIES_ROOT = join(homedir(), '.config', 'sap-mcp', 'strategies');
+/**
+ * @name getStrategiesRoot
+ * @description Returns the strategies root directory.
+ */
+export function getStrategiesRoot() {
+    return STRATEGIES_ROOT;
+}
+/**
+ * @name sanitizePathSegment
+ * @description Sanitizes a user-provided path segment to prevent directory traversal.
+ * Rejects segments containing "..", "/", "\", or null bytes. Only allows
+ * alphanumeric, dash, underscore, and dot.
+ * @internal
+ */
+function sanitizePathSegment(segment) {
+    if (!segment || segment.length > 128) {
+        throw new Error('Invalid path segment: must be 1-128 characters.');
+    }
+    // Reject any path traversal characters.
+    if (segment.includes('..') || segment.includes('/') || segment.includes('\\') || segment.includes('\0')) {
+        throw new Error(`Invalid path segment: ${segment} contains forbidden characters.`);
+    }
+    // Only allow safe characters: a-z, A-Z, 0-9, dash, underscore, dot.
+    if (!/^[a-zA-Z0-9._-]+$/.test(segment)) {
+        throw new Error(`Invalid path segment: ${segment} contains invalid characters. Only alphanumeric, dash, underscore, and dot are allowed.`);
+    }
+    return segment;
+}
+/**
+ * @name saveStrategy
+ * @description Saves or updates a strategy JSON file.
+ */
+export function saveStrategy(input) {
+    const safeCategory = sanitizePathSegment(input.category);
+    const safeName = sanitizePathSegment(input.name);
+    const dir = join(STRATEGIES_ROOT, safeCategory);
+    mkdirSync(dir, { recursive: true });
+    const filePath = join(dir, `${safeName}.json`);
+    const exists = existsSync(filePath);
+    // Load existing version if updating.
+    let version = 1;
+    let createdAt = new Date().toISOString();
+    if (exists) {
+        try {
+            const existing = JSON.parse(readFileSync(filePath, 'utf-8'));
+            version = existing.version + 1;
+            createdAt = existing.createdAt;
+        }
+        catch {
+            // Corrupt file — overwrite.
+        }
+    }
+    const record = {
+        category: input.category,
+        name: input.name,
+        config: input.config,
+        version,
+        active: input.active !== false,
+        createdAt,
+        updatedAt: new Date().toISOString(),
+        path: filePath,
+    };
+    writeFileSync(filePath, JSON.stringify(record, null, 2), 'utf-8');
+    return { success: true, path: filePath, version, created: !exists };
+}
+/**
+ * @name loadStrategy
+ * @description Loads a strategy by category and name.
+ */
+export function loadStrategy(category, name) {
+    const safeCategory = sanitizePathSegment(category);
+    const safeName = sanitizePathSegment(name);
+    const filePath = join(STRATEGIES_ROOT, safeCategory, `${safeName}.json`);
+    if (!existsSync(filePath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * @name listStrategies
+ * @description Lists all strategies, optionally filtered by category and active status.
+ */
+export function listStrategies(category, activeOnly = false) {
+    const strategies = [];
+    const safeCategory = category ? sanitizePathSegment(category) : undefined;
+    const categories = safeCategory
+        ? [safeCategory]
+        : existsSync(STRATEGIES_ROOT)
+            ? readdirSync(STRATEGIES_ROOT, { withFileTypes: true })
+                .filter(e => e.isDirectory())
+                .map(e => e.name)
+            : [];
+    for (const cat of categories) {
+        const catDir = join(STRATEGIES_ROOT, cat);
+        if (!existsSync(catDir))
+            continue;
+        const files = readdirSync(catDir, { withFileTypes: true })
+            .filter(e => e.isFile() && e.name.endsWith('.json'))
+            .map(e => join(catDir, e.name));
+        for (const file of files) {
+            try {
+                const record = JSON.parse(readFileSync(file, 'utf-8'));
+                if (activeOnly && !record.active)
+                    continue;
+                strategies.push(record);
+            }
+            catch {
+                // Skip corrupt files.
+            }
+        }
+    }
+    return strategies;
+}
+/**
+ * @name activateStrategy
+ * @description Activates or deactivates a strategy.
+ */
+export function activateStrategy(category, name, active) {
+    const safeCategory = sanitizePathSegment(category);
+    const safeName = sanitizePathSegment(name);
+    const filePath = join(STRATEGIES_ROOT, safeCategory, `${safeName}.json`);
+    if (!existsSync(filePath)) {
+        return { success: false, active: false };
+    }
+    try {
+        const record = JSON.parse(readFileSync(filePath, 'utf-8'));
+        record.active = active;
+        record.updatedAt = new Date().toISOString();
+        writeFileSync(filePath, JSON.stringify(record, null, 2), 'utf-8');
+        return { success: true, active };
+    }
+    catch {
+        return { success: false, active: false };
+    }
+}
+//# sourceMappingURL=strategy-store.js.map

package/dist/strategies/strategy-store.js.map

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

package/dist/tools/agent-start-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-start-tool.d.ts","sourceRoot":"","sources":["../../src/tools/agent-start-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKtD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAgDnF"}
+{"version":3,"file":"agent-start-tool.d.ts","sourceRoot":"","sources":["../../src/tools/agent-start-tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAIxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAQtD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAgLnF"}