@rainfall-devkit/sdk 0.1.8 → 0.2.1

package/dist/daemon/index.d.mts

@@ -0,0 +1,168 @@
+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
+ *
+ * Provides:
+ * - WebSocket server for MCP clients (Claude, Cursor, etc.)
+ * - OpenAI-compatible /v1/chat/completions endpoint
+ * - Hot-loaded tools from Rainfall SDK
+ * - Networked execution for distributed workflows
+ * - Persistent context and memory
+ * - Passive listeners (file watchers, cron triggers)
+ */
+
+interface DaemonConfig {
+    port?: number;
+    openaiPort?: number;
+    rainfallConfig?: RainfallConfig;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Networked executor options */
+    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: {
+        memoriesCached: number;
+        activeSessions: number;
+        currentSession?: string;
+        executionHistorySize: number;
+    };
+    listeners: {
+        fileWatchers: number;
+        cronTriggers: number;
+        recentEvents: number;
+    };
+}
+declare class RainfallDaemon {
+    private wss?;
+    private openaiApp;
+    private rainfall?;
+    private port;
+    private openaiPort;
+    private rainfallConfig?;
+    private tools;
+    private toolSchemas;
+    private clients;
+    private debug;
+    private networkedExecutor?;
+    private context?;
+    private listeners?;
+    private mcpProxy?;
+    private enableMcpProxy;
+    private mcpNamespacePrefix;
+    constructor(config?: DaemonConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Get the networked executor for distributed job management
+     */
+    getNetworkedExecutor(): RainfallNetworkedExecutor | undefined;
+    /**
+     * Get the context for memory/session management
+     */
+    getContext(): RainfallDaemonContext | undefined;
+    /**
+     * 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;
+    private startWebSocketServer;
+    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
+     * Maps OpenAI-style underscore names to Rainfall tool IDs
+     */
+    private buildLocalToolMap;
+    /**
+     * Find a local Rainfall tool by name (OpenAI underscore format or original)
+     */
+    private findLocalTool;
+    /**
+     * Execute a local Rainfall tool
+     */
+    private executeLocalTool;
+    /**
+     * Parse XML-style tool calls from model output
+     * Handles formats like: <function=name><parameter=key>value</parameter></function>
+     */
+    private parseXMLToolCalls;
+    /**
+     * Call the LLM via Rainfall backend, LM Studio, RunPod, or other providers
+     *
+     * Provider priority:
+     * 1. Config file (llm.provider, llm.baseUrl)
+     * 2. Environment variables (OPENAI_API_KEY, OLLAMA_HOST, etc.)
+     * 3. Default to Rainfall (credits-based)
+     */
+    private callLLM;
+    /**
+     * Call external LLM provider (OpenAI, Anthropic) via their OpenAI-compatible APIs
+     */
+    private callExternalLLM;
+    /**
+     * Call a local LLM (LM Studio, Ollama, etc.)
+     */
+    private callLocalLLM;
+    /**
+     * Stream a response to the client (converts non-streaming to SSE format)
+     */
+    private streamResponse;
+    /**
+     * Update context with conversation history
+     */
+    private updateContext;
+    private getOpenAITools;
+    private buildResponseContent;
+    getStatus(): DaemonStatus;
+    private log;
+}
+declare function startDaemon(config?: DaemonConfig): Promise<RainfallDaemon>;
+declare function stopDaemon(): Promise<void>;
+declare function getDaemonStatus(): DaemonStatus | null;
+declare function getDaemonInstance(): RainfallDaemon | null;
+
+export { type DaemonConfig, type DaemonStatus, MCPClientConfig, MCPProxyHub, RainfallDaemon, getDaemonInstance, getDaemonStatus, startDaemon, stopDaemon };

package/dist/daemon/index.d.ts

@@ -0,0 +1,168 @@
+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
+ *
+ * Provides:
+ * - WebSocket server for MCP clients (Claude, Cursor, etc.)
+ * - OpenAI-compatible /v1/chat/completions endpoint
+ * - Hot-loaded tools from Rainfall SDK
+ * - Networked execution for distributed workflows
+ * - Persistent context and memory
+ * - Passive listeners (file watchers, cron triggers)
+ */
+
+interface DaemonConfig {
+    port?: number;
+    openaiPort?: number;
+    rainfallConfig?: RainfallConfig;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Networked executor options */
+    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: {
+        memoriesCached: number;
+        activeSessions: number;
+        currentSession?: string;
+        executionHistorySize: number;
+    };
+    listeners: {
+        fileWatchers: number;
+        cronTriggers: number;
+        recentEvents: number;
+    };
+}
+declare class RainfallDaemon {
+    private wss?;
+    private openaiApp;
+    private rainfall?;
+    private port;
+    private openaiPort;
+    private rainfallConfig?;
+    private tools;
+    private toolSchemas;
+    private clients;
+    private debug;
+    private networkedExecutor?;
+    private context?;
+    private listeners?;
+    private mcpProxy?;
+    private enableMcpProxy;
+    private mcpNamespacePrefix;
+    constructor(config?: DaemonConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Get the networked executor for distributed job management
+     */
+    getNetworkedExecutor(): RainfallNetworkedExecutor | undefined;
+    /**
+     * Get the context for memory/session management
+     */
+    getContext(): RainfallDaemonContext | undefined;
+    /**
+     * 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;
+    private startWebSocketServer;
+    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
+     * Maps OpenAI-style underscore names to Rainfall tool IDs
+     */
+    private buildLocalToolMap;
+    /**
+     * Find a local Rainfall tool by name (OpenAI underscore format or original)
+     */
+    private findLocalTool;
+    /**
+     * Execute a local Rainfall tool
+     */
+    private executeLocalTool;
+    /**
+     * Parse XML-style tool calls from model output
+     * Handles formats like: <function=name><parameter=key>value</parameter></function>
+     */
+    private parseXMLToolCalls;
+    /**
+     * Call the LLM via Rainfall backend, LM Studio, RunPod, or other providers
+     *
+     * Provider priority:
+     * 1. Config file (llm.provider, llm.baseUrl)
+     * 2. Environment variables (OPENAI_API_KEY, OLLAMA_HOST, etc.)
+     * 3. Default to Rainfall (credits-based)
+     */
+    private callLLM;
+    /**
+     * Call external LLM provider (OpenAI, Anthropic) via their OpenAI-compatible APIs
+     */
+    private callExternalLLM;
+    /**
+     * Call a local LLM (LM Studio, Ollama, etc.)
+     */
+    private callLocalLLM;
+    /**
+     * Stream a response to the client (converts non-streaming to SSE format)
+     */
+    private streamResponse;
+    /**
+     * Update context with conversation history
+     */
+    private updateContext;
+    private getOpenAITools;
+    private buildResponseContent;
+    getStatus(): DaemonStatus;
+    private log;
+}
+declare function startDaemon(config?: DaemonConfig): Promise<RainfallDaemon>;
+declare function stopDaemon(): Promise<void>;
+declare function getDaemonStatus(): DaemonStatus | null;
+declare function getDaemonInstance(): RainfallDaemon | null;
+
+export { type DaemonConfig, type DaemonStatus, MCPClientConfig, MCPProxyHub, RainfallDaemon, getDaemonInstance, getDaemonStatus, startDaemon, stopDaemon };