@relayrail/server 0.1.2 → 0.1.4

package/dist/index.d.ts

@@ -22,6 +22,8 @@ interface ServerConfig {
     telnyxPhoneNumber?: string;
     /** Base URL for response pages */
     baseUrl: string;
+    /** API key for proxy mode (when email/SMS credentials unavailable locally) */
+    apiKey?: string;
 }
 /**
  * Context passed to tool handlers
@@ -379,11 +381,19 @@ interface RouteResult {
     /** Quota error if send was blocked */
     quotaError?: QuotaError;
 }
+/**
+ * Common interface for message routing
+ * Implemented by both RequestRouter (direct sending) and ProxyRouter (API proxy)
+ */
+interface MessageRouter {
+    routeApproval(params: RouteApprovalParams, user: User, agent: Agent): Promise<RouteResult>;
+    routeNotification(params: RouteNotificationParams, user: User, agent: Agent): Promise<RouteResult>;
+}
 /**
  * Request router that sends requests via the appropriate channel
  * with quota enforcement and overage billing
  */
-declare class RequestRouter {
+declare class RequestRouter implements MessageRouter {
     private emailService;
     private smsService?;
     private usageService;
@@ -412,6 +422,10 @@ declare class RequestRouter {
      */
     private createQuotaErrorResult;
 }
+/**
+ * Create a request router instance
+ */
+declare function createRouter(config: RouterConfig, supabase: TypedSupabaseClient): RequestRouter;
 
 /**
  * HTTP Transport for MCP Server
@@ -504,4 +518,46 @@ declare class HTTPTransport {
  */
 declare function createHTTPTransport(config: HTTPTransportConfig): HTTPTransport;
 
-export { type ApprovalRequestParams, type ApprovalResponse, type AuthResult, type AwaitResponseParams, type AwaitResult, type GetPendingCommandsParams, HTTPTransport, type HTTPTransportConfig, type MCPNotification, type MCPRequest, type MCPResponse, MCP_ERRORS, type NotificationParams, type NotificationResponse, RelayRailServer, type ServerConfig, type ToolContext, type UserCommand, VERSION, authenticateApiKey, createHTTPTransport, createServer, generateApiKey, getApiKeyPrefix, hashApiKey };
+/**
+ * Proxy Router
+ * Routes requests to the hosted RelayRail API for message sending
+ * Used when local email/SMS credentials are not available
+ */
+
+interface ProxyRouterConfig {
+    apiUrl: string;
+    apiKey: string;
+}
+/**
+ * Proxy router that sends messages via the RelayRail API
+ * Implements the same interface as RequestRouter for drop-in replacement
+ */
+declare class ProxyRouter implements MessageRouter {
+    private apiUrl;
+    private apiKey;
+    constructor(config: ProxyRouterConfig);
+    /**
+     * Route an approval request via the API
+     * @param params - Approval parameters
+     * @param _user - User (unused, API handles lookup)
+     * @param _agent - Agent (unused, API handles lookup)
+     */
+    routeApproval(params: RouteApprovalParams, _user: User, _agent: Agent): Promise<RouteResult>;
+    /**
+     * Route a notification via the API
+     * @param params - Notification parameters
+     * @param _user - User (unused, API handles lookup)
+     * @param _agent - Agent (unused, API handles lookup)
+     */
+    routeNotification(params: RouteNotificationParams, _user: User, _agent: Agent): Promise<RouteResult>;
+    /**
+     * Send a message via the RelayRail API
+     */
+    private sendViaApi;
+}
+/**
+ * Create a proxy router instance
+ */
+declare function createProxyRouter(config: ProxyRouterConfig): ProxyRouter;
+
+export { type ApprovalRequestParams, type ApprovalResponse, type AuthResult, type AwaitResponseParams, type AwaitResult, type GetPendingCommandsParams, HTTPTransport, type HTTPTransportConfig, type MCPNotification, type MCPRequest, type MCPResponse, MCP_ERRORS, type MessageRouter, type NotificationParams, type NotificationResponse, ProxyRouter, type ProxyRouterConfig, RelayRailServer, RequestRouter, type RouteApprovalParams, type RouteNotificationParams, type RouteResult, type RouterConfig, type ServerConfig, type ToolContext, type UserCommand, VERSION, authenticateApiKey, createHTTPTransport, createProxyRouter, createRouter, createServer, generateApiKey, getApiKeyPrefix, hashApiKey };

package/dist/index.js

@@ -1,5 +1,3 @@
-#!/usr/bin/env node
-
 // src/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -1497,6 +1495,81 @@ function createRouter(config, supabase) {
   return new RequestRouter(config, supabase);
 }
 
+// src/services/proxy-router.ts
+var ProxyRouter = class {
+  apiUrl;
+  apiKey;
+  constructor(config) {
+    this.apiUrl = config.apiUrl.replace(/\/$/, "");
+    this.apiKey = config.apiKey;
+  }
+  /**
+   * Route an approval request via the API
+   * @param params - Approval parameters
+   * @param _user - User (unused, API handles lookup)
+   * @param _agent - Agent (unused, API handles lookup)
+   */
+  async routeApproval(params, _user, _agent) {
+    return this.sendViaApi(params.requestId, "approval");
+  }
+  /**
+   * Route a notification via the API
+   * @param params - Notification parameters
+   * @param _user - User (unused, API handles lookup)
+   * @param _agent - Agent (unused, API handles lookup)
+   */
+  async routeNotification(params, _user, _agent) {
+    return this.sendViaApi(params.requestId, "notification");
+  }
+  /**
+   * Send a message via the RelayRail API
+   */
+  async sendViaApi(requestId, type) {
+    try {
+      const response = await fetch(`${this.apiUrl}/api/send-message`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${this.apiKey}`
+        },
+        body: JSON.stringify({
+          request_id: requestId,
+          type
+        })
+      });
+      const data = await response.json();
+      if (!response.ok) {
+        console.error(`[ProxyRouter] API error:`, data);
+        return {
+          success: false,
+          channel: "email",
+          error: data.error || `API error: ${response.status}`
+        };
+      }
+      return {
+        success: data.success,
+        channel: data.channel || "email",
+        channel_requested: data.channel_requested,
+        fallback_reason: data.fallback_reason,
+        messageId: data.message_id,
+        error: data.error,
+        quota: data.quota,
+        quotaError: data.quota_error
+      };
+    } catch (error) {
+      console.error(`[ProxyRouter] Network error:`, error);
+      return {
+        success: false,
+        channel: "email",
+        error: error instanceof Error ? error.message : "Network error"
+      };
+    }
+  }
+};
+function createProxyRouter(config) {
+  return new ProxyRouter(config);
+}
+
 // src/server.ts
 var VERSION = "0.1.0";
 var RelayRailServer = class {
@@ -1529,6 +1602,12 @@ var RelayRailServer = class {
         },
         this.supabase
       );
+    } else if (config.apiKey) {
+      console.log("[RelayRail] Using proxy router for message delivery");
+      this.router = createProxyRouter({
+        apiUrl: config.baseUrl,
+        apiKey: config.apiKey
+      });
     }
     this.server = new McpServer({
       name: "relayrail",
@@ -2199,57 +2278,6 @@ var HTTPTransport = class {
 function createHTTPTransport(config) {
   return new HTTPTransport(config);
 }
-
-// src/index.ts
-async function main() {
-  const apiKey = process.env.RELAYRAIL_API_KEY;
-  if (!apiKey) {
-    console.error("Error: RELAYRAIL_API_KEY environment variable is required");
-    console.error("");
-    console.error("Get your API key from https://relayrail.dev/dashboard/agents");
-    console.error("");
-    console.error("Example MCP configuration:");
-    console.error(JSON.stringify({
-      mcpServers: {
-        relayrail: {
-          command: "npx",
-          args: ["@relayrail/server"],
-          env: {
-            RELAYRAIL_API_KEY: "rr_your_api_key_here"
-          }
-        }
-      }
-    }, null, 2));
-    process.exit(1);
-  }
-  const config = {
-    supabaseUrl: process.env.SUPABASE_URL || process.env.NEXT_PUBLIC_SUPABASE_URL || "https://lcmdokppykqmigqcwnol.supabase.co",
-    supabaseServiceRoleKey: process.env.SUPABASE_SERVICE_ROLE_KEY || "sb_secret_cj-1Y1KxjlapuwyXvfSKLA_xBJ0oS8i",
-    baseUrl: process.env.RELAYRAIL_BASE_URL || "https://relayrail.dev",
-    resendApiKey: process.env.RESEND_API_KEY,
-    telnyxApiKey: process.env.TELNYX_API_KEY,
-    telnyxPhoneNumber: process.env.TELNYX_PHONE_NUMBER
-  };
-  try {
-    const server = createServer(config);
-    const authenticated = await server.authenticate(apiKey);
-    if (!authenticated) {
-      console.error("Error: Invalid API key");
-      console.error("");
-      console.error("Please check your RELAYRAIL_API_KEY and try again.");
-      console.error("Get a new API key from https://relayrail.dev/dashboard/agents");
-      process.exit(1);
-    }
-    await server.start();
-  } catch (error) {
-    console.error("Failed to start RelayRail MCP server:", error);
-    process.exit(1);
-  }
-}
-main().catch((error) => {
-  console.error("Unexpected error:", error);
-  process.exit(1);
-});
 export {
   HTTPTransport,
   MCP_ERRORS,
@@ -2257,6 +2285,8 @@ export {
   VERSION,
   authenticateApiKey,
   createHTTPTransport,
+  createProxyRouter,
+  createRouter,
   createServer,
   generateApiKey,
   getApiKeyPrefix,

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@relayrail/server",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "RelayRail MCP Server - SMS/Email connectivity for AI agents",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
-    "relayrail": "./dist/index.js",
-    "relayrail-server": "./dist/index.js"
+    "relayrail": "./dist/cli.js",
+    "relayrail-server": "./dist/cli.js"
   },
   "exports": {
     ".": {