@elizaos/plugin-ngrok 2.0.0-beta.1

package/README.md

@@ -0,0 +1,325 @@
+# @elizaos/plugin-ngrok
+
+<img src="images/banner.jpg" alt="Plugin Ngrok Banner" width="100%" />
+
+A powerful ngrok tunnel plugin for ElizaOS that enables agents to expose local services to the internet with a production-ready dashboard.
+
+## Features
+
+- 🌐 **Expose Local Services**: Create secure HTTPS tunnels to your local servers
+- 📊 **Web Dashboard**: Real-time monitoring and management of active tunnels
+- 🔧 **Full API**: RESTful API for programmatic tunnel management
+- 🧪 **100% Test Coverage**: Comprehensive unit, integration, E2E, and Cypress tests
+- 🎯 **TypeScript**: Fully typed for excellent developer experience
+- 🔒 **Secure**: Built-in auth token support and secure tunnel management
+
+## Installation
+
+```bash
+npm install @elizaos/plugin-ngrok
+```
+
+## Quick Start
+
+1. **Get your ngrok auth token** (optional but recommended):
+
+   - Visit [ngrok.com](https://dashboard.ngrok.com/get-started/your-authtoken)
+   - Sign up for a free account
+   - Copy your auth token
+
+2. **Configure your environment**:
+
+   ```bash
+   # .env file
+   NGROK_AUTH_TOKEN=your_auth_token_here  # Optional but recommended
+   NGROK_REGION=us                         # Optional: us, eu, ap, au, sa, jp, in
+   NGROK_SUBDOMAIN=my-app                  # Optional: requires paid plan
+   ```
+
+3. **Use in your agent**:
+
+   ```typescript
+   import ngrokPlugin from '@elizaos/plugin-ngrok';
+
+   const agent = new Agent({
+     plugins: [ngrokPlugin],
+     // ... other config
+   });
+   ```
+
+## Web Dashboard
+
+The plugin includes a beautiful, production-ready web dashboard for managing your tunnels.
+
+### Running the Dashboard
+
+```bash
+# Start both API server and dashboard
+npm run demo:full
+
+# Or run them separately:
+npm run demo:api   # Start API server on port 3001
+npm run dev        # Start dashboard on port 5173
+```
+
+Visit http://localhost:5173 to access the dashboard.
+
+### Dashboard Features
+
+- **Real-time Status**: Monitor active tunnels with live updates
+- **Easy Management**: Start/stop tunnels with a single click
+- **Configuration**: Set port, region, and custom subdomains
+- **Copy URL**: Quick copy button for sharing tunnel URLs
+- **Responsive Design**: Works perfectly on desktop and mobile
+- **Auto-refresh**: Status updates every 5 seconds
+
+## Available Actions
+
+The plugin provides three main actions:
+
+### START_TUNNEL
+
+Starts a new ngrok tunnel on the specified port.
+
+```typescript
+// Example usage in agent
+'Can you start a tunnel on port 3000?';
+'Open ngrok on port 8080 in the EU region';
+"Create a tunnel with subdomain 'my-app' on port 3000";
+```
+
+### STOP_TUNNEL
+
+Stops the currently active tunnel.
+
+```typescript
+'Stop the tunnel';
+'Close ngrok';
+'Shutdown the tunnel';
+```
+
+### GET_TUNNEL_STATUS
+
+Gets the current status of the tunnel.
+
+```typescript
+"What's the tunnel status?";
+'Is ngrok running?';
+'Show me the tunnel URL';
+```
+
+## Testing
+
+This plugin includes comprehensive test coverage across multiple test types:
+
+### Run All Tests
+
+```bash
+# Run all plugin tests (unit + E2E)
+npm test
+
+# Run with coverage report
+npm run test:coverage
+```
+
+### Unit Tests
+
+```bash
+# Run unit tests only
+npm run test:unit
+
+# Run in watch mode
+npm run test:watch
+```
+
+### Integration Tests
+
+```bash
+# Run integration tests (requires ngrok installed)
+npm run test:integration
+```
+
+### E2E Tests
+
+```bash
+# Run E2E tests (uses real ngrok API)
+npm run test:e2e
+```
+
+### Cypress Tests
+
+```bash
+# Run Cypress tests headlessly
+npm run test:cypress
+
+# Open Cypress interactive mode
+npm run cypress:open
+```
+
+## API Reference
+
+### REST API Endpoints
+
+The plugin includes an Express API server for the dashboard:
+
+#### GET /api/tunnel/status
+
+Returns the current tunnel status.
+
+**Response:**
+
+```json
+{
+  "active": true,
+  "url": "https://abc123.ngrok.io",
+  "port": 3000,
+  "startedAt": "2024-01-01T00:00:00.000Z",
+  "provider": "ngrok",
+  "uptime": "15 minutes"
+}
+```
+
+#### POST /api/tunnel/start
+
+Starts a new tunnel.
+
+**Request Body:**
+
+```json
+{
+  "port": 3000,
+  "region": "eu", // optional
+  "subdomain": "my-app" // optional, requires paid plan
+}
+```
+
+#### POST /api/tunnel/stop
+
+Stops the active tunnel.
+
+### TypeScript Types
+
+```typescript
+interface TunnelStatus {
+  active: boolean;
+  url: string | null;
+  port: number | null;
+  startedAt: Date | null;
+  provider: string;
+}
+
+interface TunnelConfig {
+  provider?: 'ngrok' | 'cloudflare' | 'localtunnel';
+  authToken?: string;
+  region?: string;
+  subdomain?: string;
+}
+
+interface ITunnelService {
+  start(port: number): Promise<string>;
+  stop(): Promise<void>;
+  getUrl(): string | null;
+  isActive(): boolean;
+  getStatus(): TunnelStatus;
+}
+```
+
+## Development
+
+### Project Structure
+
+```
+plugin-ngrok/
+├── src/
+│   ├── actions/          # Agent actions
+│   ├── services/         # NgrokService implementation
+│   ├── types/            # TypeScript types
+│   ├── frontend/         # React dashboard
+│   └── __tests__/        # Test suites
+├── demo/                 # Demo applications
+├── cypress/              # Cypress E2E tests
+└── dist/                 # Build output
+```
+
+### Building
+
+```bash
+# Build plugin and dashboard
+npm run build
+
+# Build plugin only
+tsup src/index.ts --format esm --dts
+
+# Build dashboard only
+vite build
+```
+
+### Development Mode
+
+```bash
+# Watch plugin changes
+npm run dev:plugin
+
+# Run dashboard dev server
+npm run dev
+
+# Run everything in dev mode
+npm run demo:full
+```
+
+## Environment Variables
+
+| Variable             | Description                                | Default | Required             |
+| -------------------- | ------------------------------------------ | ------- | -------------------- |
+| `NGROK_AUTH_TOKEN`   | Your ngrok authentication token            | -       | No (but recommended) |
+| `NGROK_REGION`       | Tunnel region (us, eu, ap, au, sa, jp, in) | us      | No                   |
+| `NGROK_SUBDOMAIN`    | Custom subdomain (requires paid plan)      | -       | No                   |
+| `NGROK_DEFAULT_PORT` | Default port for tunnels                   | 3000    | No                   |
+| `API_PORT`           | Port for the API server                    | 3001    | No                   |
+
+## Troubleshooting
+
+### Ngrok not installed
+
+If you see "ngrok is not installed", install it using:
+
+```bash
+# macOS
+brew install ngrok
+
+# Linux
+snap install ngrok
+
+# Windows
+choco install ngrok
+```
+
+### Auth token issues
+
+Without an auth token, tunnels will have limited functionality. Get a free token at [ngrok.com](https://dashboard.ngrok.com/get-started/your-authtoken).
+
+### Port already in use
+
+Make sure the port you're trying to tunnel is actually running a service and is not blocked by a firewall.
+
+## Contributing
+
+Contributions are welcome! Please ensure all tests pass and add tests for new features:
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Write tests for your changes
+4. Ensure all tests pass (`npm test`)
+5. Commit your changes (`git commit -m 'Add amazing feature'`)
+6. Push to the branch (`git push origin feature/amazing-feature`)
+7. Open a Pull Request
+
+## License
+
+This plugin is part of the ElizaOS project. See the main project for license information.
+
+## Support
+
+For issues and feature requests, please use the GitHub issue tracker.
+
+For questions and discussions, join the ElizaOS community on Discord.

package/dist/__tests__/NgrokTestSuite.d.ts

@@ -0,0 +1,6 @@
+import type { TestCase } from '@elizaos/core';
+export declare class NgrokTestSuite {
+    name: string;
+    tests: TestCase[];
+}
+//# sourceMappingURL=NgrokTestSuite.d.ts.map

package/dist/__tests__/NgrokTestSuite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NgrokTestSuite.d.ts","sourceRoot":"","sources":["../../src/__tests__/NgrokTestSuite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG7D,qBAAa,cAAc;IACzB,IAAI,SAAW;IACf,KAAK,EAAE,QAAQ,EAAE,CAuGf;CACH"}

package/dist/__tests__/NgrokTestSuite.js

@@ -0,0 +1,92 @@
+import { NgrokService } from '../services/NgrokService';
+export class NgrokTestSuite {
+    name = 'ngrok';
+    tests = [
+        {
+            name: 'Initialize Ngrok Service',
+            fn: async (runtime) => {
+                // Test service initialization
+                const service = new NgrokService(runtime);
+                // Verify service is initialized
+                if (!service) {
+                    throw new Error('Failed to initialize Ngrok service');
+                }
+                if (!(service instanceof NgrokService)) {
+                    throw new Error('Service is not instance of NgrokService');
+                }
+            },
+        },
+        {
+            name: 'Start and Stop Tunnel',
+            fn: async (runtime) => {
+                const service = new NgrokService(runtime);
+                // Test starting tunnel
+                const url = await service.startTunnel(3000);
+                if (!url?.startsWith('https://')) {
+                    throw new Error('Failed to start tunnel or invalid URL returned');
+                }
+                // Verify tunnel is active
+                if (!service.isActive()) {
+                    throw new Error('Tunnel should be active after starting');
+                }
+                // Test getting status
+                const status = service.getStatus();
+                if (!status.active || status.port !== 3000) {
+                    throw new Error('Invalid tunnel status');
+                }
+                // Test stopping tunnel
+                await service.stopTunnel();
+                // Verify tunnel is stopped
+                if (service.isActive()) {
+                    throw new Error('Tunnel should not be active after stopping');
+                }
+            },
+        },
+        {
+            name: 'Service Registration',
+            fn: async (runtime) => {
+                // Test that service can be registered and retrieved
+                const _service = new NgrokService(runtime);
+                // In a real test, we would register the service with runtime
+                // and then retrieve it to verify registration
+                const serviceType = NgrokService.serviceType;
+                if (serviceType !== 'tunnel') {
+                    throw new Error('Service type should be "tunnel"');
+                }
+            },
+        },
+        {
+            name: 'Tunnel Status When Inactive',
+            fn: async (runtime) => {
+                const service = new NgrokService(runtime);
+                // Get status when tunnel is not active
+                const status = service.getStatus();
+                if (status.active) {
+                    throw new Error('Tunnel should not be active initially');
+                }
+                if (status.url !== null || status.port !== null) {
+                    throw new Error('URL and port should be null when inactive');
+                }
+                if (status.provider !== 'ngrok') {
+                    throw new Error('Provider should always be "ngrok"');
+                }
+            },
+        },
+        {
+            name: 'Multiple Start Attempts',
+            fn: async (runtime) => {
+                const service = new NgrokService(runtime);
+                // Start tunnel
+                const url1 = await service.startTunnel(3000);
+                // Try to start again (should return same URL)
+                const url2 = await service.startTunnel(3000);
+                if (url1 !== url2) {
+                    throw new Error('Starting tunnel twice should return the same URL');
+                }
+                // Clean up
+                await service.stopTunnel();
+            },
+        },
+    ];
+}
+//# sourceMappingURL=NgrokTestSuite.js.map

package/dist/__tests__/NgrokTestSuite.js.map

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

package/dist/actions/get-tunnel-status.d.ts

@@ -0,0 +1,4 @@
+import { type Action } from '@elizaos/core';
+export declare const getTunnelStatusAction: Action;
+export default getTunnelStatusAction;
+//# sourceMappingURL=get-tunnel-status.d.ts.map

package/dist/actions/get-tunnel-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tunnel-status.d.ts","sourceRoot":"","sources":["../../src/actions/get-tunnel-status.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAQZ,MAAM,eAAe,CAAC;AAGvB,eAAO,MAAM,qBAAqB,EAAE,MA2MnC,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

package/dist/actions/get-tunnel-status.js

@@ -0,0 +1,186 @@
+import { elizaLogger, } from '@elizaos/core';
+import { getTunnelService } from '@elizaos/plugin-tunnel';
+export const getTunnelStatusAction = {
+    name: 'GET_TUNNEL_STATUS',
+    similes: ['TUNNEL_STATUS', 'CHECK_TUNNEL', 'NGROK_STATUS', 'TUNNEL_INFO'],
+    description: 'Get the current status of the ngrok tunnel including URL, port, and uptime information. Supports action chaining by providing tunnel metadata for monitoring workflows, health checks, or conditional tunnel management.',
+    validate: async (runtime, _message) => {
+        return !!getTunnelService(runtime);
+    },
+    handler: async (runtime, _message, _state, _options, callback) => {
+        try {
+            elizaLogger.info('Getting ngrok tunnel status...');
+            const tunnelService = getTunnelService(runtime);
+            if (!tunnelService) {
+                throw new Error('Tunnel service not found');
+            }
+            const status = tunnelService.getStatus();
+            let responseText;
+            const response = {
+                ...status,
+                uptime: 'N/A',
+            };
+            if (status.active) {
+                if (status.startedAt) {
+                    const uptimeMs = Date.now() - new Date(status.startedAt).getTime();
+                    const minutes = Math.floor(uptimeMs / 60000);
+                    const hours = Math.floor(minutes / 60);
+                    if (hours > 0) {
+                        response.uptime = `${hours} hour${hours > 1 ? 's' : ''}, ${minutes % 60} minute${minutes % 60 !== 1 ? 's' : ''}`;
+                    }
+                    else {
+                        response.uptime = `${minutes} minute${minutes !== 1 ? 's' : ''}`;
+                    }
+                }
+                responseText = `✅ Ngrok tunnel is active!\n\n🌐 Public URL: ${status.url}\n🔌 Local Port: ${status.port}\n⏱️ Uptime: ${response.uptime}\n🏢 Provider: ${status.provider}\n\nYour local service is accessible from the internet.`;
+            }
+            else {
+                responseText =
+                    '❌ No active ngrok tunnel.\n\nTo start a tunnel, say "start ngrok tunnel on port [PORT]"';
+            }
+            const startedAtIso = status.startedAt ? status.startedAt.toISOString() : null;
+            if (callback) {
+                await callback({
+                    text: responseText,
+                    metadata: {
+                        action: 'tunnel_status',
+                        uptime: response.uptime,
+                        active: status.active,
+                        url: status.url,
+                        port: status.port,
+                        startedAt: startedAtIso,
+                        provider: status.provider,
+                        backend: status.backend ?? null,
+                    },
+                });
+            }
+            return {
+                success: true,
+                text: responseText,
+                values: {
+                    success: true,
+                    isActive: status.active,
+                    tunnelUrl: status.url,
+                    port: status.port,
+                    uptime: response.uptime,
+                    provider: status.provider,
+                },
+                data: {
+                    action: 'GET_TUNNEL_STATUS',
+                    tunnelStatus: {
+                        active: status.active,
+                        url: status.url,
+                        port: status.port,
+                        startedAt: startedAtIso,
+                        provider: status.provider,
+                        backend: status.backend ?? null,
+                        uptime: response.uptime,
+                        checkedAt: new Date().toISOString(),
+                    },
+                },
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const stack = error instanceof Error ? (error.stack ?? null) : null;
+            elizaLogger.error(`Failed to get tunnel status: ${message}`);
+            if (callback) {
+                await callback({
+                    text: `❌ Failed to get tunnel status: ${message}`,
+                    metadata: {
+                        error: message,
+                        action: 'tunnel_status_failed',
+                    },
+                });
+            }
+            return {
+                success: false,
+                text: `❌ Failed to get tunnel status: ${message}`,
+                values: {
+                    success: false,
+                    error: message,
+                },
+                data: {
+                    action: 'GET_TUNNEL_STATUS',
+                    errorType: 'status_check_failed',
+                    errorDetails: stack,
+                },
+            };
+        }
+    },
+    examples: [
+        [
+            {
+                name: '{{user}}',
+                content: {
+                    text: 'What is the tunnel status?',
+                },
+            },
+            {
+                name: '{{agent}}',
+                content: {
+                    text: '✅ Ngrok tunnel is active!\n\n🌐 Public URL: https://abc123.ngrok.io\n🔌 Local Port: 3000\n⏱️ Uptime: 15 minutes\n🏢 Provider: ngrok\n\nYour local service is accessible from the internet.',
+                    actions: ['GET_TUNNEL_STATUS'],
+                },
+            },
+        ],
+        [
+            {
+                name: '{{user}}',
+                content: {
+                    text: "Check tunnel status and restart it if it's been running too long",
+                },
+            },
+            {
+                name: '{{agent}}',
+                content: {
+                    text: "I'll check the current tunnel status and restart it if needed.",
+                    thought: 'User wants me to monitor tunnel uptime and restart if necessary - I should check status first, then decide whether to restart based on uptime.',
+                    actions: ['GET_TUNNEL_STATUS'],
+                },
+            },
+            {
+                name: '{{agent}}',
+                content: {
+                    text: "Tunnel has been running for 2 hours. That seems like a long time - I'll restart it for optimal performance.",
+                    thought: 'Status shows the tunnel has been up for 2 hours, which is quite long. I should stop and restart it as requested.',
+                    actions: ['STOP_TUNNEL'],
+                },
+            },
+            {
+                name: '{{agent}}',
+                content: {
+                    text: 'Tunnel stopped. Now starting a fresh tunnel...',
+                    thought: 'Old tunnel is down, now I can start a new fresh tunnel for optimal performance.',
+                    actions: ['START_TUNNEL'],
+                },
+            },
+        ],
+        [
+            {
+                name: '{{user}}',
+                content: {
+                    text: 'Get tunnel info and then update our webhook URLs',
+                },
+            },
+            {
+                name: '{{agent}}',
+                content: {
+                    text: "I'll check the current tunnel status and then update the webhook URLs.",
+                    thought: 'User needs the current tunnel URL for webhook configuration - I should get the status first, then update webhooks with the public URL.',
+                    actions: ['GET_TUNNEL_STATUS'],
+                },
+            },
+            {
+                name: '{{agent}}',
+                content: {
+                    text: 'Tunnel is active at https://abc123.ngrok.io. Now updating webhook URLs...',
+                    thought: 'I have the current tunnel URL from the status check. I can now update the webhook configurations with this public URL.',
+                    actions: ['UPDATE_WEBHOOKS'],
+                },
+            },
+        ],
+    ],
+};
+export default getTunnelStatusAction;
+//# sourceMappingURL=get-tunnel-status.js.map

package/dist/actions/get-tunnel-status.js.map

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

package/dist/actions/start-tunnel.d.ts

@@ -0,0 +1,4 @@
+import { type Action } from '@elizaos/core';
+export declare const startTunnelAction: Action;
+export default startTunnelAction;
+//# sourceMappingURL=start-tunnel.d.ts.map

package/dist/actions/start-tunnel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-tunnel.d.ts","sourceRoot":"","sources":["../../src/actions/start-tunnel.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EASZ,MAAM,eAAe,CAAC;AAiBvB,eAAO,MAAM,iBAAiB,EAAE,MAiO/B,CAAC;AAEF,eAAe,iBAAiB,CAAC"}