@elizaos/plugin-tunnel 2.0.0-beta.1

package/README.md

@@ -0,0 +1,39 @@
+# @elizaos/plugin-tunnel
+
+Local Tailscale-CLI tunnel backend for elizaOS.
+
+Registers `serviceType = "tunnel"` and exposes:
+
+- **`TUNNEL` action** — dispatcher with `op` parameter-enum (`start | stop | status`). Legacy `TAILSCALE`-prefixed action names are kept as similes.
+- **`TUNNEL_STATE` provider** — reads the active service's `getStatus()` into model state.
+- **`LocalTunnelService`** — wraps `tailscale serve` / `tailscale funnel`.
+
+## Coexistence
+
+`plugin-tunnel`, [`@elizaos/plugin-elizacloud`](../plugin-elizacloud) (hosted headscale + reverse proxy), and [`@elizaos/plugin-ngrok`](https://github.com/elizaos-plugins/plugin-ngrok) all register under `serviceType="tunnel"`. **First active wins** — each plugin's `init` only registers if its credentials are present *and* the slot is free.
+
+```
+character.plugins = [
+  '@elizaos/plugin-elizacloud',  // wins if ELIZAOS_CLOUD_API_KEY set
+  '@elizaos/plugin-tunnel',      // falls back to local tailscale CLI
+  '@elizaos/plugin-ngrok',       // last-resort, if NGROK_AUTHTOKEN set
+];
+```
+
+## Setup
+
+1. Install Tailscale: `brew install tailscale` (or [download](https://tailscale.com/download)).
+2. Authenticate the device once:
+   - Against the public Tailscale tailnet: `tailscale up`
+   - Or against a self-hosted headscale: `tailscale up --login-server=https://headscale.example.com`
+3. Optional: `TUNNEL_FUNNEL=true` to expose publicly via Tailscale Funnel.
+
+## Config
+
+| Env var | Default | Notes |
+|---|---|---|
+| `TUNNEL_TAGS` | `tag:eliza-tunnel` | Comma-separated ACL tags (informational; user authenticates separately) |
+| `TUNNEL_FUNNEL` | `false` | When true, uses `tailscale funnel` instead of `tailscale serve` |
+| `TUNNEL_DEFAULT_PORT` | `3000` | Used when no port is extracted from the user's message |
+
+`TAILSCALE_*` aliases are accepted for one release window.

package/dist/__tests__/TunnelTestSuite.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"TunnelTestSuite.d.ts","sourceRoot":"","sources":["../../src/__tests__/TunnelTestSuite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAKxE,qBAAa,eAAgB,YAAW,SAAS;IAC/C,IAAI,SAAY;IAChB,KAAK,EAAE,QAAQ,EAAE,CAqCf;CACH"}

package/dist/__tests__/TunnelTestSuite.js

@@ -0,0 +1,47 @@
+import { tunnelAction } from '../actions/tunnel';
+import { tunnelStateProvider } from '../providers/tunnel-state';
+import { LocalTunnelService } from '../services/LocalTunnelService';
+export class TunnelTestSuite {
+    name = 'tunnel';
+    tests = [
+        {
+            name: 'LocalTunnelService — service-type contract',
+            fn: (_runtime) => {
+                if (LocalTunnelService.serviceType !== 'tunnel') {
+                    throw new Error('LocalTunnelService.serviceType must be "tunnel"');
+                }
+            },
+        },
+        {
+            name: 'tunnelAction — name and op enum',
+            fn: (_runtime) => {
+                if (tunnelAction.name !== 'TUNNEL') {
+                    throw new Error(`tunnelAction.name must be "TUNNEL", got ${tunnelAction.name}`);
+                }
+                const opParam = tunnelAction.parameters?.find((p) => p.name === 'op');
+                if (!opParam)
+                    throw new Error('tunnelAction must declare an `op` parameter');
+                const enumVals = opParam.schema?.enum;
+                if (!Array.isArray(enumVals))
+                    throw new Error('op parameter must declare a string enum');
+                for (const expected of ['start', 'stop', 'status']) {
+                    if (!enumVals.includes(expected)) {
+                        throw new Error(`op enum missing "${expected}"`);
+                    }
+                }
+            },
+        },
+        {
+            name: 'TUNNEL_STATE provider — name and shape',
+            fn: (_runtime) => {
+                if (tunnelStateProvider.name !== 'TUNNEL_STATE') {
+                    throw new Error(`tunnelStateProvider.name must be "TUNNEL_STATE"`);
+                }
+                if (typeof tunnelStateProvider.get !== 'function') {
+                    throw new Error('tunnelStateProvider must define get()');
+                }
+            },
+        },
+    ];
+}
+//# sourceMappingURL=TunnelTestSuite.js.map

package/dist/__tests__/TunnelTestSuite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TunnelTestSuite.js","sourceRoot":"","sources":["../../src/__tests__/TunnelTestSuite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,MAAM,OAAO,eAAe;IAC1B,IAAI,GAAG,QAAQ,CAAC;IAChB,KAAK,GAAe;QAClB;YACE,IAAI,EAAE,4CAA4C;YAClD,EAAE,EAAE,CAAC,QAAuB,EAAE,EAAE;gBAC9B,IAAI,kBAAkB,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;oBAChD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;SACF;QACD;YACE,IAAI,EAAE,iCAAiC;YACvC,EAAE,EAAE,CAAC,QAAuB,EAAE,EAAE;gBAC9B,IAAI,YAAY,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACnC,MAAM,IAAI,KAAK,CAAC,2CAA2C,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;gBAClF,CAAC;gBACD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;gBACtE,IAAI,CAAC,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;gBAC7E,MAAM,QAAQ,GAAI,OAAO,CAAC,MAA2C,EAAE,IAAI,CAAC;gBAC5E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;gBACzF,KAAK,MAAM,QAAQ,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;oBACnD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;wBACjC,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,GAAG,CAAC,CAAC;oBACnD,CAAC;gBACH,CAAC;YACH,CAAC;SACF;QACD;YACE,IAAI,EAAE,wCAAwC;YAC9C,EAAE,EAAE,CAAC,QAAuB,EAAE,EAAE;gBAC9B,IAAI,mBAAmB,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBAChD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;gBACrE,CAAC;gBACD,IAAI,OAAO,mBAAmB,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;oBAClD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;SACF;KACF,CAAC;CACH"}

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

@@ -0,0 +1,3 @@
+import { type ActionResult, type HandlerCallback, type IAgentRuntime, type Memory, type State } from '@elizaos/core';
+export declare function handleGetTunnelStatus(runtime: IAgentRuntime, _message?: Memory, _state?: State, _options?: Record<string, unknown>, callback?: HandlerCallback): Promise<ActionResult>;
+//# 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,YAAY,EAEjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,KAAK,EACX,MAAM,eAAe,CAAC;AAavB,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,KAAK,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,YAAY,CAAC,CAiCvB"}

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

@@ -0,0 +1,43 @@
+import { elizaLogger, } from '@elizaos/core';
+import { getTunnelService } from '../types';
+function formatUptime(startedAt) {
+    const ms = Date.now() - startedAt.getTime();
+    const minutes = Math.floor(ms / 60_000);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        return `${hours} hour${hours === 1 ? '' : 's'}, ${minutes % 60} minute${minutes % 60 === 1 ? '' : 's'}`;
+    }
+    return `${minutes} minute${minutes === 1 ? '' : 's'}`;
+}
+export async function handleGetTunnelStatus(runtime, _message, _state, _options, callback) {
+    const tunnelService = getTunnelService(runtime);
+    if (!tunnelService) {
+        if (callback) {
+            await callback({ text: 'Tunnel service is not available.' });
+        }
+        return { success: false, error: 'tunnel service unavailable' };
+    }
+    elizaLogger.info('[get-tunnel-status] reading status');
+    const status = tunnelService.getStatus();
+    const uptime = status.startedAt ? formatUptime(status.startedAt) : 'N/A';
+    const responseText = status.active
+        ? `✅ tunnel active (${status.provider}).\n\nURL: ${status.url}\nLocal port: ${status.port}\nUptime: ${uptime}`
+        : '❌ No active tunnel. Say "start tunnel on port [PORT]" to start one.';
+    if (callback) {
+        await callback({ text: responseText });
+    }
+    return {
+        success: true,
+        text: responseText,
+        data: {
+            action: 'tunnel_status',
+            active: status.active,
+            url: status.url ?? '',
+            port: status.port ?? 0,
+            provider: status.provider,
+            backend: status.backend ?? '',
+            uptime,
+        },
+    };
+}
+//# 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":"AAAA,OAAO,EAEL,WAAW,GAKZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,SAAS,YAAY,CAAC,SAAe;IACnC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,OAAO,GAAG,KAAK,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,GAAG,EAAE,UAAU,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IAC1G,CAAC;IACD,OAAO,GAAG,OAAO,UAAU,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAsB,EACtB,QAAiB,EACjB,MAAc,EACd,QAAkC,EAClC,QAA0B;IAE1B,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,kCAAkC,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;IACjE,CAAC;IAED,WAAW,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAEzE,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM;QAChC,CAAC,CAAC,oBAAoB,MAAM,CAAC,QAAQ,cAAc,MAAM,CAAC,GAAG,iBAAiB,MAAM,CAAC,IAAI,aAAa,MAAM,EAAE;QAC9G,CAAC,CAAC,qEAAqE,CAAC;IAE1E,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE;YACJ,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC;YACtB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;YAC7B,MAAM;SACP;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,3 @@
+import { type ActionResult, type HandlerCallback, type IAgentRuntime, type Memory, type State } from '@elizaos/core';
+export declare function handleStartTunnel(runtime: IAgentRuntime, message: Memory, _state?: State, options?: Record<string, unknown>, callback?: HandlerCallback): Promise<ActionResult>;
+//# 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,YAAY,EAEjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,MAAM,EAEX,KAAK,KAAK,EACX,MAAM,eAAe,CAAC;AA0CvB,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,KAAK,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,YAAY,CAAC,CA4DvB"}

package/dist/actions/start-tunnel.js

@@ -0,0 +1,96 @@
+import { elizaLogger, ModelType, } from '@elizaos/core';
+import { z } from 'zod';
+import { getTunnelService } from '../types';
+const portPayloadSchema = z.object({
+    port: z.union([z.number(), z.string().regex(/^\d+$/)]).transform((value) => {
+        const num = typeof value === 'string' ? Number.parseInt(value, 10) : value;
+        return num;
+    }),
+});
+const PORT_PROMPT_TEMPLATE = `Respond with a JSON object containing the port number to start the tunnel on.
+The user said: "{{userMessage}}"
+
+Extract the port number from their message, or use the default port 3000 if not specified.
+
+Response format:
+\`\`\`json
+{ "port": 3000 }
+\`\`\``;
+const DEFAULT_PORT = 3000;
+function isValidPort(value) {
+    return Number.isInteger(value) && value >= 1 && value <= 65535;
+}
+function parsePort(value) {
+    try {
+        const parsed = JSON.parse(value);
+        const result = portPayloadSchema.safeParse(parsed);
+        if (result.success && isValidPort(result.data.port))
+            return result.data.port;
+    }
+    catch {
+        // fall through
+    }
+    const match = value.match(/\b(\d{1,5})\b/);
+    const captured = match?.[1];
+    if (!captured)
+        return DEFAULT_PORT;
+    const num = Number.parseInt(captured, 10);
+    return isValidPort(num) ? num : DEFAULT_PORT;
+}
+export async function handleStartTunnel(runtime, message, _state, options, callback) {
+    const tunnelService = getTunnelService(runtime);
+    if (!tunnelService) {
+        if (callback) {
+            await callback({
+                text: 'Tunnel service is not available. Configure plugin-tunnel, plugin-elizacloud, or plugin-ngrok.',
+            });
+        }
+        return { success: false, error: 'tunnel service unavailable' };
+    }
+    if (tunnelService.isActive()) {
+        if (callback) {
+            await callback({
+                text: 'Tunnel is already active. Stop the existing tunnel before starting a new one.',
+            });
+        }
+        return { success: false, error: 'tunnel already active' };
+    }
+    elizaLogger.info('[start-tunnel] starting tunnel');
+    let port;
+    const explicitPort = options?.port;
+    if (typeof explicitPort === 'number' && isValidPort(explicitPort)) {
+        port = explicitPort;
+    }
+    else if (typeof explicitPort === 'string' && /^\d+$/.test(explicitPort)) {
+        const parsed = Number.parseInt(explicitPort, 10);
+        if (isValidPort(parsed))
+            port = parsed;
+    }
+    if (port === undefined) {
+        const userMessage = message.content.text ?? '';
+        const portResponse = await runtime.useModel(ModelType.TEXT_SMALL, {
+            prompt: PORT_PROMPT_TEMPLATE.replace('{{userMessage}}', userMessage),
+            temperature: 0.3,
+        });
+        port = parsePort(String(portResponse));
+    }
+    const url = await tunnelService.startTunnel(port);
+    const publicUrl = typeof url === 'string' ? url : tunnelService.getUrl();
+    const status = tunnelService.getStatus();
+    if (callback) {
+        await callback({
+            text: `Tunnel started (${status.provider}).\n\nURL: ${publicUrl ?? 'unknown'}\nLocal port: ${port}`,
+        });
+    }
+    return {
+        success: true,
+        text: `Tunnel started on port ${port}`,
+        data: {
+            action: 'tunnel_started',
+            tunnelUrl: publicUrl ?? '',
+            port,
+            provider: status.provider,
+        },
+    };
+}
+//# sourceMappingURL=start-tunnel.js.map

package/dist/actions/start-tunnel.js.map

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

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

@@ -0,0 +1,3 @@
+import { type ActionResult, type HandlerCallback, type IAgentRuntime, type Memory, type State } from '@elizaos/core';
+export declare function handleStopTunnel(runtime: IAgentRuntime, _message?: Memory, _state?: State, _options?: Record<string, unknown>, callback?: HandlerCallback): Promise<ActionResult>;
+//# sourceMappingURL=stop-tunnel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop-tunnel.d.ts","sourceRoot":"","sources":["../../src/actions/stop-tunnel.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,KAAK,EACX,MAAM,eAAe,CAAC;AAGvB,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,KAAK,EACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,QAAQ,CAAC,EAAE,eAAe,GACzB,OAAO,CAAC,YAAY,CAAC,CAyCvB"}

package/dist/actions/stop-tunnel.js

@@ -0,0 +1,41 @@
+import { elizaLogger, } from '@elizaos/core';
+import { getTunnelService } from '../types';
+export async function handleStopTunnel(runtime, _message, _state, _options, callback) {
+    const tunnelService = getTunnelService(runtime);
+    if (!tunnelService) {
+        if (callback) {
+            await callback({ text: 'Tunnel service is not available.' });
+        }
+        return { success: false, error: 'tunnel service unavailable' };
+    }
+    if (!tunnelService.isActive()) {
+        elizaLogger.warn('[stop-tunnel] no active tunnel to stop');
+        if (callback) {
+            await callback({ text: 'No tunnel is currently running.' });
+        }
+        return {
+            success: true,
+            text: 'no active tunnel',
+            data: { action: 'tunnel_not_active' },
+        };
+    }
+    const status = tunnelService.getStatus();
+    const previousUrl = status.url;
+    const previousPort = status.port;
+    await tunnelService.stopTunnel();
+    if (callback) {
+        await callback({
+            text: `Tunnel stopped.\n\nWas running on port: ${previousPort}\nPrevious URL: ${previousUrl}`,
+        });
+    }
+    return {
+        success: true,
+        text: `Tunnel stopped (was on port ${previousPort})`,
+        data: {
+            action: 'tunnel_stopped',
+            previousUrl: previousUrl ?? '',
+            previousPort: previousPort ?? 0,
+        },
+    };
+}
+//# sourceMappingURL=stop-tunnel.js.map

package/dist/actions/stop-tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-tunnel.js","sourceRoot":"","sources":["../../src/actions/stop-tunnel.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,GAKZ,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAsB,EACtB,QAAiB,EACjB,MAAc,EACd,QAAkC,EAClC,QAA0B;IAE1B,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,kCAAkC,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,4BAA4B,EAAE,CAAC;IACjE,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC9B,WAAW,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QAC3D,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE;SACtC,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC;IAC/B,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC;IAEjC,MAAM,aAAa,CAAC,UAAU,EAAE,CAAC;IAEjC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,QAAQ,CAAC;YACb,IAAI,EAAE,2CAA2C,YAAY,mBAAmB,WAAW,EAAE;SAC9F,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,+BAA+B,YAAY,GAAG;QACpD,IAAI,EAAE;YACJ,MAAM,EAAE,gBAAgB;YACxB,WAAW,EAAE,WAAW,IAAI,EAAE;YAC9B,YAAY,EAAE,YAAY,IAAI,CAAC;SAChC;KACF,CAAC;AACJ,CAAC"}

package/dist/actions/tunnel.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @module tunnel
+ * @description Single dispatcher action that fans out to the active
+ * tunnel-service implementation. The action's name is `TUNNEL`; legacy
+ * `TAILSCALE`-prefixed action names are kept as `similes` so older
+ * characters and callers still resolve.
+ *
+ * Sub-ops (selected via the `action` parameter-enum):
+ *   - start  -> handleStartTunnel    (optional `port`, defaults to 3000)
+ *   - stop   -> handleStopTunnel     (no parameters)
+ *   - status -> handleGetTunnelStatus (no parameters)
+ *
+ * The handler accepts both call shapes:
+ *   1. `{ action, ...subParams }`
+ *   2. `{ parameters: { action, parameters: { ...subParams } } }` (LLM extraction)
+ */
+import type { Action } from '@elizaos/core';
+export declare const tunnelAction: Action;
+export default tunnelAction;
+//# sourceMappingURL=tunnel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.d.ts","sourceRoot":"","sources":["../../src/actions/tunnel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,MAAM,EAMP,MAAM,eAAe,CAAC;AAiDvB,eAAO,MAAM,YAAY,EAAE,MAqH1B,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/actions/tunnel.js

@@ -0,0 +1,159 @@
+/**
+ * @module tunnel
+ * @description Single dispatcher action that fans out to the active
+ * tunnel-service implementation. The action's name is `TUNNEL`; legacy
+ * `TAILSCALE`-prefixed action names are kept as `similes` so older
+ * characters and callers still resolve.
+ *
+ * Sub-ops (selected via the `action` parameter-enum):
+ *   - start  -> handleStartTunnel    (optional `port`, defaults to 3000)
+ *   - stop   -> handleStopTunnel     (no parameters)
+ *   - status -> handleGetTunnelStatus (no parameters)
+ *
+ * The handler accepts both call shapes:
+ *   1. `{ action, ...subParams }`
+ *   2. `{ parameters: { action, parameters: { ...subParams } } }` (LLM extraction)
+ */
+import { getTunnelService } from '../types';
+import { handleGetTunnelStatus } from './get-tunnel-status';
+import { handleStartTunnel } from './start-tunnel';
+import { handleStopTunnel } from './stop-tunnel';
+const SUPPORTED_OPS = ['start', 'stop', 'status'];
+function pickRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function resolveDispatch(options) {
+    if (!options) {
+        return { action: null, subOptions: {} };
+    }
+    const nested = pickRecord(options.parameters);
+    const actionSource = nested ?? options;
+    const rawAction = actionSource.action ?? actionSource.subaction ?? actionSource.op;
+    const action = typeof rawAction === 'string' ? rawAction.toLowerCase() : null;
+    let subOptions;
+    if (nested) {
+        const innerParams = pickRecord(nested.parameters);
+        if (innerParams) {
+            subOptions = { ...innerParams };
+        }
+        else {
+            const { action: _omitAction, subaction: _omitSubaction, op: _omitOp, parameters: _omitParams, ...rest } = nested;
+            subOptions = rest;
+        }
+    }
+    else {
+        const { action: _omitAction, subaction: _omitSubaction, op: _omitOp, ...rest } = options;
+        subOptions = rest;
+    }
+    return { action, subOptions };
+}
+export const tunnelAction = {
+    name: 'TUNNEL',
+    similes: [
+        // Legacy action names kept so existing characters/transcripts still resolve.
+        'TAILSCALE',
+        'START_TAILSCALE',
+        'STOP_TAILSCALE',
+        'GET_TAILSCALE_STATUS',
+        'START_TUNNEL',
+        'OPEN_TUNNEL',
+        'CREATE_TUNNEL',
+        'TAILSCALE_UP',
+        'STOP_TUNNEL',
+        'CLOSE_TUNNEL',
+        'TAILSCALE_DOWN',
+        'TAILSCALE_STATUS',
+        'CHECK_TUNNEL',
+        'TUNNEL_INFO',
+        'TUNNEL_STATUS',
+    ],
+    description: 'Tunnel operations dispatched by `action`: start, stop, status. The `start` action accepts an optional `port` (defaults to 3000); `stop` and `status` take no parameters. Backed by whichever tunnel plugin is active (local Tailscale CLI, Eliza Cloud headscale, or ngrok).',
+    parameters: [
+        {
+            name: 'action',
+            description: 'Which tunnel sub-operation to run. One of: start, stop, status.',
+            required: true,
+            schema: {
+                type: 'string',
+                enum: [...SUPPORTED_OPS],
+            },
+        },
+        {
+            name: 'parameters',
+            description: 'Parameters forwarded to the selected sub-op. For `start`, optionally `{ port: number }`. `stop` and `status` take no parameters.',
+            required: false,
+            schema: { type: 'object' },
+        },
+    ],
+    validate: async (runtime) => {
+        return Boolean(getTunnelService(runtime));
+    },
+    handler: async (runtime, message, state, options, callback) => {
+        const { action, subOptions } = resolveDispatch(options);
+        if (!action) {
+            const err = `TUNNEL requires action=start|stop|status`;
+            if (callback)
+                await callback({ text: err });
+            return { success: false, error: err };
+        }
+        switch (action) {
+            case 'start':
+                return handleStartTunnel(runtime, message, state, subOptions, callback);
+            case 'stop':
+                return handleStopTunnel(runtime, message, state, subOptions, callback);
+            case 'status':
+                return handleGetTunnelStatus(runtime, message, state, subOptions, callback);
+            default: {
+                const err = `Unknown TUNNEL action "${action}". Supported: ${SUPPORTED_OPS.join(', ')}`;
+                if (callback)
+                    await callback({ text: err });
+                return { success: false, error: err };
+            }
+        }
+    },
+    examples: [
+        [
+            {
+                name: '{{user1}}',
+                content: { text: 'Start a tunnel on port 8080' },
+            },
+            {
+                name: '{{agentName}}',
+                content: {
+                    text: 'Tunnel started (tailscale).\n\nURL: https://device.tail-scale.ts.net\nLocal port: 8080',
+                    actions: ['TUNNEL'],
+                },
+            },
+        ],
+        [
+            {
+                name: '{{user1}}',
+                content: { text: 'Stop the tunnel' },
+            },
+            {
+                name: '{{agentName}}',
+                content: {
+                    text: 'Tunnel stopped.',
+                    actions: ['TUNNEL'],
+                },
+            },
+        ],
+        [
+            {
+                name: '{{user1}}',
+                content: { text: 'What is the tunnel status?' },
+            },
+            {
+                name: '{{agentName}}',
+                content: {
+                    text: '✅ tunnel active (tailscale).',
+                    actions: ['TUNNEL'],
+                },
+            },
+        ],
+    ],
+};
+export default tunnelAction;
+//# sourceMappingURL=tunnel.js.map

package/dist/actions/tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.js","sourceRoot":"","sources":["../../src/actions/tunnel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAU,CAAC;AAE3D,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,OAA4C;IAInE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,YAAY,GAAG,MAAM,IAAI,OAAO,CAAC;IACvC,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,IAAI,YAAY,CAAC,SAAS,IAAI,YAAY,CAAC,EAAE,CAAC;IACnF,MAAM,MAAM,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAE9E,IAAI,UAAmC,CAAC;IACxC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,WAAW,EAAE,CAAC;YAChB,UAAU,GAAG,EAAE,GAAG,WAAW,EAAE,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,MAAM,EACJ,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,cAAc,EACzB,EAAE,EAAE,OAAO,EACX,UAAU,EAAE,WAAW,EACvB,GAAG,IAAI,EACR,GAAG,MAAM,CAAC;YACX,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;QACzF,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE;QACP,6EAA6E;QAC7E,WAAW;QACX,iBAAiB;QACjB,gBAAgB;QAChB,sBAAsB;QACtB,cAAc;QACd,aAAa;QACb,eAAe;QACf,cAAc;QACd,aAAa;QACb,cAAc;QACd,gBAAgB;QAChB,kBAAkB;QAClB,cAAc;QACd,aAAa;QACb,eAAe;KAChB;IACD,WAAW,EACT,8QAA8Q;IAEhR,UAAU,EAAE;QACV;YACE,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iEAAiE;YAC9E,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,GAAG,aAAa,CAAC;aACzB;SACF;QACD;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,kIAAkI;YACpI,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC3B;KACF;IAED,QAAQ,EAAE,KAAK,EAAE,OAAsB,EAAoB,EAAE;QAC3D,OAAO,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,KAAK,EACZ,OAAsB,EACtB,OAAe,EACf,KAAa,EACb,OAAiC,EACjC,QAA0B,EACH,EAAE;QACzB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAExD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,0CAA0C,CAAC;YACvD,IAAI,QAAQ;gBAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;YAC5C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACxC,CAAC;QAED,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,OAAO;gBACV,OAAO,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC1E,KAAK,MAAM;gBACT,OAAO,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YACzE,KAAK,QAAQ;gBACX,OAAO,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC9E,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,GAAG,GAAG,0BAA0B,MAAM,iBAAiB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxF,IAAI,QAAQ;oBAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;gBAC5C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;YACxC,CAAC;QACH,CAAC;IACH,CAAC;IAED,QAAQ,EAAE;QACR;YACE;gBACE,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,EAAE,IAAI,EAAE,6BAA6B,EAAE;aACjD;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,wFAAwF;oBAC9F,OAAO,EAAE,CAAC,QAAQ,CAAC;iBACpB;aACF;SACF;QACD;YACE;gBACE,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE;aACrC;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,iBAAiB;oBACvB,OAAO,EAAE,CAAC,QAAQ,CAAC;iBACpB;aACF;SACF;QACD;YACE;gBACE,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,EAAE,IAAI,EAAE,4BAA4B,EAAE;aAChD;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE;oBACP,IAAI,EAAE,8BAA8B;oBACpC,OAAO,EAAE,CAAC,QAAQ,CAAC;iBACpB;aACF;SACF;KACF;CACF,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/environment.d.ts

@@ -0,0 +1,18 @@
+import type { IAgentRuntime } from '@elizaos/core';
+import { z } from 'zod';
+/**
+ * Local-CLI tunnel config. The cloud-backed (headscale) flavor lives in
+ * `@elizaos/plugin-elizacloud`; this package only configures the local
+ * `tailscale` CLI.
+ *
+ * `TUNNEL_*` env vars are the canonical names. `TAILSCALE_*` are accepted
+ * as aliases for one release window so existing `.env` files keep working.
+ */
+export declare const tunnelEnvSchema: z.ZodObject<{
+    TUNNEL_TAGS: z.ZodDefault<z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>, z.ZodTransform<string[], string | string[] | undefined>>>;
+    TUNNEL_FUNNEL: z.ZodDefault<z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>>, z.ZodTransform<boolean, string | boolean | undefined>>>;
+    TUNNEL_DEFAULT_PORT: z.ZodDefault<z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>, z.ZodTransform<number, string | number | undefined>>>;
+}, z.core.$strip>;
+export type TunnelConfig = z.infer<typeof tunnelEnvSchema>;
+export declare function validateTunnelConfig(runtime: IAgentRuntime): Promise<TunnelConfig>;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;iBA6B1B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAwB3D,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAOxF"}

package/dist/environment.js

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+/**
+ * Local-CLI tunnel config. The cloud-backed (headscale) flavor lives in
+ * `@elizaos/plugin-elizacloud`; this package only configures the local
+ * `tailscale` CLI.
+ *
+ * `TUNNEL_*` env vars are the canonical names. `TAILSCALE_*` are accepted
+ * as aliases for one release window so existing `.env` files keep working.
+ */
+export const tunnelEnvSchema = z.object({
+    TUNNEL_TAGS: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .transform((value) => {
+        if (Array.isArray(value))
+            return value.filter((tag) => tag.length > 0);
+        if (typeof value === 'string' && value.length > 0)
+            return value
+                .split(',')
+                .map((tag) => tag.trim())
+                .filter((tag) => tag.length > 0);
+        return ['tag:eliza-tunnel'];
+    })
+        .default(['tag:eliza-tunnel']),
+    TUNNEL_FUNNEL: z
+        .union([z.string(), z.boolean()])
+        .optional()
+        .transform((value) => value === true || value === 'true' || value === '1')
+        .default(false),
+    TUNNEL_DEFAULT_PORT: z
+        .union([z.string(), z.number()])
+        .optional()
+        .transform((value) => {
+        if (value === undefined || value === '')
+            return 3000;
+        const num = typeof value === 'string' ? Number.parseInt(value, 10) : value;
+        if (Number.isNaN(num) || num <= 0 || num > 65535)
+            return 3000;
+        return num;
+    })
+        .default(3000),
+});
+function readSetting(runtime, key) {
+    const value = runtime.getSetting(key);
+    if (value === null || value === undefined)
+        return undefined;
+    return String(value);
+}
+/**
+ * Read `TUNNEL_<KEY>` first, then fall back to the legacy `TAILSCALE_<KEY>`.
+ */
+function readWithLegacy(runtime, newKey, legacyKey) {
+    return (readSetting(runtime, newKey) ??
+        readSetting(runtime, legacyKey) ??
+        process.env[newKey] ??
+        process.env[legacyKey]);
+}
+export async function validateTunnelConfig(runtime) {
+    const config = {
+        TUNNEL_TAGS: readWithLegacy(runtime, 'TUNNEL_TAGS', 'TAILSCALE_TAGS'),
+        TUNNEL_FUNNEL: readWithLegacy(runtime, 'TUNNEL_FUNNEL', 'TAILSCALE_FUNNEL'),
+        TUNNEL_DEFAULT_PORT: readWithLegacy(runtime, 'TUNNEL_DEFAULT_PORT', 'TAILSCALE_DEFAULT_PORT'),
+    };
+    return tunnelEnvSchema.parse(config);
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { type Plugin } from '@elizaos/core';
+/**
+ * Local Tailscale-CLI tunnel plugin.
+ *
+ * Registers `serviceType = "tunnel"` ONLY when:
+ *  1. No other tunnel service has already claimed the slot (first-active-wins
+ *     across plugin-tunnel, plugin-elizacloud, plugin-ngrok), AND
+ *  2. The `tailscale` CLI is on PATH.
+ *
+ * The Eliza Cloud (headscale) tunnel lives in `@elizaos/plugin-elizacloud`.
+ * Ngrok lives in `@elizaos/plugin-ngrok`. Enable as many as you like — only
+ * one will bind.
+ */
+export declare const tunnelPlugin: Plugin;
+export default tunnelPlugin;
+export { tunnelAction } from './actions/tunnel';
+export { type TunnelConfig, validateTunnelConfig } from './environment';
+export { tunnelStateProvider } from './providers/tunnel-state';
+export { checkTailscaleInstalled, LocalTunnelService } from './services/LocalTunnelService';
+export { getTunnelService, type ITunnelService, type TunnelProvider, type TunnelStatus, tunnelSlotIsFree, } from './types';
+//# sourceMappingURL=index.d.ts.map