@rainfall-devkit/sdk 0.2.0 → 0.2.1

package/dist/cli/index.mjs

@@ -1,14 +1,18 @@
 #!/usr/bin/env node
+import {
+  createEdgeNodeSecurity
+} from "../chunk-XEQ6U3JQ.mjs";
 import {
   Rainfall
 } from "../chunk-VDPKDC3R.mjs";
 import {
+  getConfigDir,
   loadConfig,
   saveConfig
-} from "../chunk-WOITG5TG.mjs";
+} from "../chunk-NTTAVKRT.mjs";
 
 // src/cli/index.ts
-import { readFileSync } from "fs";
+import { readFileSync, existsSync, mkdirSync, writeFileSync } from "fs";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import { spawn } from "child_process";
@@ -44,6 +48,9 @@ Commands:
   config set <key> <value>      Set configuration value
   config llm                    Show LLM configuration
   
+  edge generate-keys            Generate key pair for edge node encryption
+  edge status                   Show edge node security status
+  
   version                       Show version information
   upgrade                       Upgrade to the latest version
   
@@ -64,6 +71,9 @@ Options for 'run':
 Options for 'daemon start':
   --port <port>                 WebSocket port (default: 8765)
   --openai-port <port>          OpenAI API port (default: 8787)
+  --mcp-proxy                   Enable MCP proxy hub (default: enabled)
+  --no-mcp-proxy                Disable MCP proxy hub
+  --secure                      Enable edge node security (JWT, ACLs, encryption)
   --debug                       Enable verbose debug logging
 
 Examples:
@@ -443,10 +453,13 @@ function configLLM() {
   console.log("  anthropic - Use Anthropic API directly");
   console.log("  ollama    - Use local Ollama instance");
   console.log("  local     - Use any OpenAI-compatible endpoint (LM Studio, etc.)");
+  console.log("  custom    - Use any custom OpenAI-compatible endpoint (RunPod, etc.)");
   console.log();
   console.log("Examples:");
   console.log("  rainfall config set llm.provider local");
   console.log("  rainfall config set llm.baseUrl http://localhost:1234/v1");
+  console.log("  rainfall config set llm.provider custom");
+  console.log("  rainfall config set llm.baseUrl https://your-runpod-endpoint.runpod.net/v1");
   console.log("  rainfall config set llm.provider openai");
   console.log("  rainfall config set llm.apiKey sk-...");
 }
@@ -504,6 +517,7 @@ async function daemonStart(args) {
   let port;
   let openaiPort;
   let debug = false;
+  let enableMcpProxy = true;
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg === "--port") {
@@ -514,11 +528,15 @@ async function daemonStart(args) {
       if (!isNaN(val)) openaiPort = val;
     } else if (arg === "--debug") {
       debug = true;
+    } else if (arg === "--mcp-proxy") {
+      enableMcpProxy = true;
+    } else if (arg === "--no-mcp-proxy") {
+      enableMcpProxy = false;
     }
   }
   const { startDaemon } = await import("../daemon/index.mjs");
   try {
-    await startDaemon({ port, openaiPort, debug });
+    await startDaemon({ port, openaiPort, debug, enableMcpProxy });
     process.on("SIGINT", async () => {
       console.log("\n");
       const { stopDaemon } = await import("../daemon/index.mjs");
@@ -590,6 +608,8 @@ async function daemonStatus() {
   console.log(`  WebSocket port: ${status.port}`);
   console.log(`  OpenAI API port: ${status.openaiPort}`);
   console.log(`  Tools loaded: ${status.toolsLoaded}`);
+  console.log(`  MCP clients: ${status.mcpClients || 0}`);
+  console.log(`  MCP tools: ${status.mcpTools || 0}`);
   console.log(`  Clients connected: ${status.clientsConnected}`);
   console.log(`  Edge Node ID: ${status.edgeNodeId || "local"}`);
   console.log();
@@ -630,6 +650,71 @@ async function workflowRun(args) {
   console.log(`\u{1F6A7} Running workflow: ${workflowId}`);
   console.log("Workflow execution coming soon!");
 }
+async function edgeGenerateKeys() {
+  console.log("\u{1F510} Generating edge node key pair...\n");
+  try {
+    const security = await createEdgeNodeSecurity();
+    const keyPair = await security.generateKeyPair();
+    const configDir = getConfigDir();
+    const keysDir = join(configDir, "keys");
+    if (!existsSync(keysDir)) {
+      mkdirSync(keysDir, { recursive: true });
+    }
+    const publicKeyPath = join(keysDir, "edge-node.pub");
+    const privateKeyPath = join(keysDir, "edge-node.key");
+    writeFileSync(publicKeyPath, keyPair.publicKey, { mode: 420 });
+    writeFileSync(privateKeyPath, keyPair.privateKey, { mode: 384 });
+    console.log("\u2705 Key pair generated successfully!\n");
+    console.log("Public key:", keyPair.publicKey);
+    console.log("\nKey files saved to:");
+    console.log("  Public:", publicKeyPath);
+    console.log("  Private:", privateKeyPath);
+    console.log("\n\u{1F4CB} To register this edge node:");
+    console.log("  1. Copy the public key above");
+    console.log("  2. Register with: rainfall edge register <public-key>");
+    console.log("  3. The backend will return an edgeNodeSecret (JWT)");
+    console.log("  4. Store the secret securely - it expires in 30 days");
+  } catch (error) {
+    console.error("\u274C Failed to generate keys:", error instanceof Error ? error.message : error);
+    process.exit(1);
+  }
+}
+async function edgeStatus() {
+  const configDir = getConfigDir();
+  const keysDir = join(configDir, "keys");
+  const publicKeyPath = join(keysDir, "edge-node.pub");
+  const privateKeyPath = join(keysDir, "edge-node.key");
+  console.log("\u{1F510} Edge Node Security Status\n");
+  const hasPublicKey = existsSync(publicKeyPath);
+  const hasPrivateKey = existsSync(privateKeyPath);
+  console.log("Key Pair:");
+  console.log("  Public key:", hasPublicKey ? "\u2705 Present" : "\u274C Missing");
+  console.log("  Private key:", hasPrivateKey ? "\u2705 Present" : "\u274C Missing");
+  if (hasPublicKey) {
+    const publicKey = readFileSync(publicKeyPath, "utf-8");
+    console.log("\nPublic Key:");
+    console.log("  " + publicKey.substring(0, 50) + "...");
+  }
+  const config = loadConfig();
+  if (config.edgeNodeId) {
+    console.log("\nRegistration:");
+    console.log("  Edge Node ID:", config.edgeNodeId);
+  }
+  if (config.edgeNodeSecret) {
+    console.log("  JWT Secret: \u2705 Present (expires: check with backend)");
+  } else {
+    console.log("  JWT Secret: \u274C Not configured");
+  }
+  console.log("\n\u{1F4DA} Next steps:");
+  if (!hasPublicKey) {
+    console.log("  1. Run: rainfall edge generate-keys");
+  } else if (!config.edgeNodeSecret) {
+    console.log("  1. Register your edge node with the backend");
+    console.log("  2. Store the returned edgeNodeSecret in config");
+  } else {
+    console.log("  Edge node is configured and ready for secure operation");
+  }
+}
 async function main() {
   const args = process.argv.slice(2);
   const command = args[0];
@@ -735,6 +820,20 @@ async function main() {
     case "upgrade":
       await upgrade();
       break;
+    case "edge":
+      switch (subcommand) {
+        case "generate-keys":
+          await edgeGenerateKeys();
+          break;
+        case "status":
+          await edgeStatus();
+          break;
+        default:
+          console.error("Error: Unknown edge subcommand");
+          console.error("\nUsage: rainfall edge <generate-keys|status>");
+          process.exit(1);
+      }
+      break;
     case "help":
     case "--help":
     case "-h":

package/dist/config-7UT7GYSN.mjs

@@ -0,0 +1,16 @@
+import {
+  getConfigDir,
+  getLLMConfig,
+  getProviderBaseUrl,
+  isLocalProvider,
+  loadConfig,
+  saveConfig
+} from "./chunk-NTTAVKRT.mjs";
+export {
+  getConfigDir,
+  getLLMConfig,
+  getProviderBaseUrl,
+  isLocalProvider,
+  loadConfig,
+  saveConfig
+};

package/dist/config-MD45VGWD.mjs

@@ -0,0 +1,14 @@
+import {
+  getLLMConfig,
+  getProviderBaseUrl,
+  isLocalProvider,
+  loadConfig,
+  saveConfig
+} from "./chunk-EI7SJH5K.mjs";
+export {
+  getLLMConfig,
+  getProviderBaseUrl,
+  isLocalProvider,
+  loadConfig,
+  saveConfig
+};

package/dist/daemon/index.d.mts

@@ -1,5 +1,10 @@
-import { e as RainfallConfig } from '../sdk-DD1OeGRJ.mjs';
-import { N as NetworkedExecutorOptions, C as ContextOptions, e as RainfallNetworkedExecutor, R as RainfallDaemonContext, d as RainfallListenerRegistry } from '../listeners-CYI-YwIF.mjs';
+import { R as RainfallConfig, g as MCPClientConfig, h as MCPProxyHub } from '../sdk-4OvXPr8E.mjs';
+export { i as MCPClientInfo, j as MCPToolInfo, k as MCPTransportType } from '../sdk-4OvXPr8E.mjs';
+import { N as NetworkedExecutorOptions, C as ContextOptions, R as RainfallNetworkedExecutor, a as RainfallDaemonContext, b as RainfallListenerRegistry } from '../listeners-MNAnpZj-.mjs';
+import 'ws';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '@modelcontextprotocol/sdk/client/stdio.js';
+import '@modelcontextprotocol/sdk/client/streamableHttp.js';
 
 /**
  * Rainfall Daemon - Local websocket server + OpenAI-compatible proxy
@@ -23,12 +28,20 @@ interface DaemonConfig {
     networkedOptions?: NetworkedExecutorOptions;
     /** Context/memory options */
     contextOptions?: ContextOptions;
+    /** Enable MCP proxy hub (default: true) */
+    enableMcpProxy?: boolean;
+    /** Namespace prefix for MCP tools (default: true) */
+    mcpNamespacePrefix?: boolean;
+    /** Pre-configured MCP clients to connect on startup */
+    mcpClients?: MCPClientConfig[];
 }
 interface DaemonStatus {
     running: boolean;
     port?: number;
     openaiPort?: number;
     toolsLoaded: number;
+    mcpClients?: number;
+    mcpTools?: number;
     clientsConnected: number;
     edgeNodeId?: string;
     context: {
@@ -57,6 +70,9 @@ declare class RainfallDaemon {
     private networkedExecutor?;
     private context?;
     private listeners?;
+    private mcpProxy?;
+    private enableMcpProxy;
+    private mcpNamespacePrefix;
     constructor(config?: DaemonConfig);
     start(): Promise<void>;
     stop(): Promise<void>;
@@ -72,6 +88,18 @@ declare class RainfallDaemon {
      * Get the listener registry for passive triggers
      */
     getListenerRegistry(): RainfallListenerRegistry | undefined;
+    /**
+     * Get the MCP Proxy Hub for managing external MCP clients
+     */
+    getMCPProxy(): MCPProxyHub | undefined;
+    /**
+     * Connect an MCP client dynamically
+     */
+    connectMCPClient(config: MCPClientConfig): Promise<string>;
+    /**
+     * Disconnect an MCP client
+     */
+    disconnectMCPClient(name: string): Promise<void>;
     private initializeRainfall;
     private loadTools;
     private getToolSchema;
@@ -79,6 +107,10 @@ declare class RainfallDaemon {
     private handleMCPMessage;
     private getMCPTools;
     private executeTool;
+    /**
+     * Execute a tool, trying MCP proxy first, then falling back to Rainfall tools
+     */
+    private executeToolWithMCP;
     private startOpenAIProxy;
     /**
      * Build a map of local Rainfall tools for quick lookup
@@ -133,4 +165,4 @@ declare function stopDaemon(): Promise<void>;
 declare function getDaemonStatus(): DaemonStatus | null;
 declare function getDaemonInstance(): RainfallDaemon | null;
 
-export { type DaemonConfig, type DaemonStatus, RainfallDaemon, getDaemonInstance, getDaemonStatus, startDaemon, stopDaemon };
+export { type DaemonConfig, type DaemonStatus, MCPClientConfig, MCPProxyHub, RainfallDaemon, getDaemonInstance, getDaemonStatus, startDaemon, stopDaemon };

package/dist/daemon/index.d.ts

@@ -1,5 +1,10 @@
-import { e as RainfallConfig } from '../sdk-DD1OeGRJ.js';
-import { N as NetworkedExecutorOptions, C as ContextOptions, e as RainfallNetworkedExecutor, R as RainfallDaemonContext, d as RainfallListenerRegistry } from '../listeners-QJeEtLbV.js';
+import { R as RainfallConfig, g as MCPClientConfig, h as MCPProxyHub } from '../sdk-4OvXPr8E.js';
+export { i as MCPClientInfo, j as MCPToolInfo, k as MCPTransportType } from '../sdk-4OvXPr8E.js';
+import { N as NetworkedExecutorOptions, C as ContextOptions, R as RainfallNetworkedExecutor, a as RainfallDaemonContext, b as RainfallListenerRegistry } from '../listeners-B5Vy9Ao5.js';
+import 'ws';
+import '@modelcontextprotocol/sdk/client/index.js';
+import '@modelcontextprotocol/sdk/client/stdio.js';
+import '@modelcontextprotocol/sdk/client/streamableHttp.js';
 
 /**
  * Rainfall Daemon - Local websocket server + OpenAI-compatible proxy
@@ -23,12 +28,20 @@ interface DaemonConfig {
     networkedOptions?: NetworkedExecutorOptions;
     /** Context/memory options */
     contextOptions?: ContextOptions;
+    /** Enable MCP proxy hub (default: true) */
+    enableMcpProxy?: boolean;
+    /** Namespace prefix for MCP tools (default: true) */
+    mcpNamespacePrefix?: boolean;
+    /** Pre-configured MCP clients to connect on startup */
+    mcpClients?: MCPClientConfig[];
 }
 interface DaemonStatus {
     running: boolean;
     port?: number;
     openaiPort?: number;
     toolsLoaded: number;
+    mcpClients?: number;
+    mcpTools?: number;
     clientsConnected: number;
     edgeNodeId?: string;
     context: {
@@ -57,6 +70,9 @@ declare class RainfallDaemon {
     private networkedExecutor?;
     private context?;
     private listeners?;
+    private mcpProxy?;
+    private enableMcpProxy;
+    private mcpNamespacePrefix;
     constructor(config?: DaemonConfig);
     start(): Promise<void>;
     stop(): Promise<void>;
@@ -72,6 +88,18 @@ declare class RainfallDaemon {
      * Get the listener registry for passive triggers
      */
     getListenerRegistry(): RainfallListenerRegistry | undefined;
+    /**
+     * Get the MCP Proxy Hub for managing external MCP clients
+     */
+    getMCPProxy(): MCPProxyHub | undefined;
+    /**
+     * Connect an MCP client dynamically
+     */
+    connectMCPClient(config: MCPClientConfig): Promise<string>;
+    /**
+     * Disconnect an MCP client
+     */
+    disconnectMCPClient(name: string): Promise<void>;
     private initializeRainfall;
     private loadTools;
     private getToolSchema;
@@ -79,6 +107,10 @@ declare class RainfallDaemon {
     private handleMCPMessage;
     private getMCPTools;
     private executeTool;
+    /**
+     * Execute a tool, trying MCP proxy first, then falling back to Rainfall tools
+     */
+    private executeToolWithMCP;
     private startOpenAIProxy;
     /**
      * Build a map of local Rainfall tools for quick lookup
@@ -133,4 +165,4 @@ declare function stopDaemon(): Promise<void>;
 declare function getDaemonStatus(): DaemonStatus | null;
 declare function getDaemonInstance(): RainfallDaemon | null;
 
-export { type DaemonConfig, type DaemonStatus, RainfallDaemon, getDaemonInstance, getDaemonStatus, startDaemon, stopDaemon };
+export { type DaemonConfig, type DaemonStatus, MCPClientConfig, MCPProxyHub, RainfallDaemon, getDaemonInstance, getDaemonStatus, startDaemon, stopDaemon };