@elizaos/plugin-tunnel 2.0.3-beta.6 → 2.0.3-beta.7

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,CAiEvB"}

package/dist/actions/start-tunnel.js

@@ -0,0 +1,102 @@
+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 (explicitPort !== undefined && port === undefined) {
+        const message = 'Invalid tunnel port. Port must be an integer between 1 and 65535.';
+        if (callback)
+            await callback({ text: message });
+        return { success: false, error: 'invalid tunnel port' };
+    }
+    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`; concrete
+ * providers such as local Tailscale, Eliza Cloud headscale, and ngrok only
+ * register the service backend.
+ *
+ * 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;AA2CvB,eAAO,MAAM,YAAY,EAAE,MAoG1B,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/dist/actions/tunnel.js

@@ -0,0 +1,142 @@
+/**
+ * @module tunnel
+ * @description Single dispatcher action that fans out to the active
+ * tunnel-service implementation. The action's name is `TUNNEL`; concrete
+ * providers such as local Tailscale, Eliza Cloud headscale, and ngrok only
+ * register the service backend.
+ *
+ * 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;
+    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, parameters: _omitParams, ...rest } = nested;
+            subOptions = rest;
+        }
+    }
+    else {
+        const { action: _omitAction, ...rest } = options;
+        subOptions = rest;
+    }
+    return { action, subOptions };
+}
+export const tunnelAction = {
+    name: 'TUNNEL',
+    similes: ['OPEN_TUNNEL', 'CREATE_TUNNEL', 'CLOSE_TUNNEL', 'CHECK_TUNNEL', 'TUNNEL_INFO'],
+    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":"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"}

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;;;;iBA8B1B,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.map((tag) => tag.trim()).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' && /^\d+$/.test(value) ? Number(value) : value;
+        if (typeof num !== 'number' || !Number.isInteger(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

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,MAAM,EAA8B,MAAM,eAAe,CAAC;AAOrF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,EAAE,MAwB1B,CAAC;AAEF,eAAe,YAAY,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,KAAK,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EACL,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,46 @@
+import { elizaLogger, promoteSubactionsToActions } from '@elizaos/core';
+import { TunnelTestSuite } from './__tests__/TunnelTestSuite';
+import { tunnelAction } from './actions/tunnel';
+import { tunnelStateProvider } from './providers/tunnel-state';
+import { checkTailscaleInstalled, LocalTunnelService } from './services/LocalTunnelService';
+import { tunnelSlotIsFree } from './types';
+/**
+ * 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 const tunnelPlugin = {
+    name: 'tunnel',
+    description: 'Local Tailscale-CLI tunnel backend (serve / funnel). Coexists with plugin-elizacloud and plugin-ngrok via first-active-wins registration.',
+    actions: [...promoteSubactionsToActions(tunnelAction)],
+    providers: [tunnelStateProvider],
+    tests: [new TunnelTestSuite()],
+    init: async (_config, runtime) => {
+        if (!tunnelSlotIsFree(runtime)) {
+            elizaLogger.info('[plugin-tunnel] another tunnel service already registered — skipping LocalTunnelService');
+            return;
+        }
+        const installed = await checkTailscaleInstalled();
+        if (!installed) {
+            elizaLogger.info('[plugin-tunnel] tailscale CLI not found on PATH — skipping LocalTunnelService');
+            return;
+        }
+        elizaLogger.info('[plugin-tunnel] registering LocalTunnelService for serviceType="tunnel"');
+        await runtime.registerService(LocalTunnelService);
+    },
+};
+export default tunnelPlugin;
+export { tunnelAction } from './actions/tunnel';
+export { validateTunnelConfig } from './environment';
+export { tunnelStateProvider } from './providers/tunnel-state';
+// Public surface for consumers and sibling tunnel plugins.
+export { checkTailscaleInstalled, LocalTunnelService } from './services/LocalTunnelService';
+export { getTunnelService, tunnelSlotIsFree, } from './types';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAe,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,IAAI,EAAE,QAAQ;IACd,WAAW,EACT,2IAA2I;IAC7I,OAAO,EAAE,CAAC,GAAG,0BAA0B,CAAC,YAAY,CAAC,CAAC;IACtD,SAAS,EAAE,CAAC,mBAAmB,CAAC;IAChC,KAAK,EAAE,CAAC,IAAI,eAAe,EAAE,CAAC;IAC9B,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;QAC/B,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/B,WAAW,CAAC,IAAI,CACd,yFAAyF,CAC1F,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,uBAAuB,EAAE,CAAC;QAClD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,WAAW,CAAC,IAAI,CACd,+EAA+E,CAChF,CAAC;YACF,OAAO;QACT,CAAC;QACD,WAAW,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;QAC5F,MAAM,OAAO,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;IACpD,CAAC;CACF,CAAC;AAEF,eAAe,YAAY,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAqB,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,2DAA2D;AAC3D,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,EACL,gBAAgB,EAIhB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/providers/tunnel-state.d.ts

@@ -0,0 +1,12 @@
+import type { Provider } from '@elizaos/core';
+/**
+ * Surfaces the active tunnel's status into the model's state. Renders a
+ * one-line text summary and exposes the raw status object via `data`.
+ *
+ * Backend-agnostic — works with whichever tunnel implementation
+ * (`LocalTunnelService` here, `CloudTunnelService` in plugin-elizacloud,
+ * the ngrok service, etc.) won the `serviceType="tunnel"` slot.
+ */
+export declare const tunnelStateProvider: Provider;
+export default tunnelStateProvider;
+//# sourceMappingURL=tunnel-state.d.ts.map

package/dist/providers/tunnel-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-state.d.ts","sourceRoot":"","sources":["../../src/providers/tunnel-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAgCjC,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/providers/tunnel-state.js

@@ -0,0 +1,43 @@
+import { getTunnelService } from '../types';
+/**
+ * Surfaces the active tunnel's status into the model's state. Renders a
+ * one-line text summary and exposes the raw status object via `data`.
+ *
+ * Backend-agnostic — works with whichever tunnel implementation
+ * (`LocalTunnelService` here, `CloudTunnelService` in plugin-elizacloud,
+ * the ngrok service, etc.) won the `serviceType="tunnel"` slot.
+ */
+export const tunnelStateProvider = {
+    name: 'TUNNEL_STATE',
+    description: 'Current tunnel status: active flag, public URL, local port, provider, backend.',
+    descriptionCompressed: 'Tunnel: active/url/port/provider/backend',
+    contexts: ['devtools', 'system'],
+    relevanceKeywords: ['tunnel', 'tailscale', 'headscale', 'ngrok', 'serve', 'funnel', 'expose'],
+    position: 200,
+    get: async (runtime, _message) => {
+        const svc = getTunnelService(runtime);
+        if (!svc) {
+            return {
+                text: 'No tunnel service is registered.',
+                data: {
+                    active: false,
+                    available: false,
+                },
+            };
+        }
+        const status = svc.getStatus();
+        const text = status.active
+            ? `Tunnel ACTIVE — ${status.url ?? 'unknown URL'} (port ${status.port}, ${status.provider}${status.backend ? `/${status.backend}` : ''})`
+            : `Tunnel idle (${status.provider} ready).`;
+        return {
+            text,
+            data: {
+                available: true,
+                ...status,
+                startedAt: status.startedAt ? status.startedAt.toISOString() : null,
+            },
+        };
+    },
+};
+export default tunnelStateProvider;
+//# sourceMappingURL=tunnel-state.js.map

package/dist/providers/tunnel-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel-state.js","sourceRoot":"","sources":["../../src/providers/tunnel-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAa;IAC3C,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,gFAAgF;IAC7F,qBAAqB,EAAE,0CAA0C;IACjE,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAChC,iBAAiB,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC7F,QAAQ,EAAE,GAAG;IAEb,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO;gBACL,IAAI,EAAE,kCAAkC;gBACxC,IAAI,EAAE;oBACJ,MAAM,EAAE,KAAK;oBACb,SAAS,EAAE,KAAK;iBACjB;aACF,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM;YACxB,CAAC,CAAC,mBAAmB,MAAM,CAAC,GAAG,IAAI,aAAa,UAAU,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG;YACzI,CAAC,CAAC,gBAAgB,MAAM,CAAC,QAAQ,UAAU,CAAC;QAC9C,OAAO;YACL,IAAI;YACJ,IAAI,EAAE;gBACJ,SAAS,EAAE,IAAI;gBACf,GAAG,MAAM;gBACT,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI;aACpE;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/services/LocalTunnelService.d.ts

@@ -0,0 +1,37 @@
+import { type IAgentRuntime, Service } from '@elizaos/core';
+import type { ITunnelService, TunnelStatus } from '../types';
+export declare function checkTailscaleInstalled(): Promise<boolean>;
+/**
+ * Tunnel service backed by the locally-installed `tailscale` CLI.
+ *
+ * The user is responsible for `tailscale up` (i.e. authenticating with
+ * Tailscale's coordination server, OR with a self-hosted headscale via
+ * `--login-server`). This service just calls `tailscale serve` / `tailscale
+ * funnel` to expose a port and reads `tailscale status --json` to learn the
+ * tailnet DNS name.
+ *
+ * Coexists with `@elizaos/plugin-elizacloud`'s cloud tunnel and
+ * `@elizaos/plugin-ngrok` — only the first one to register `serviceType="tunnel"`
+ * wins. This service registers itself only if the `tailscale` binary is on
+ * `PATH`, gating out machines that have no Tailscale install.
+ */
+export declare class LocalTunnelService extends Service implements ITunnelService {
+    static serviceType: string;
+    readonly capabilityDescription = "Tunnel via the locally-installed `tailscale` CLI (serve / funnel). User authenticates separately with `tailscale up`.";
+    private tunnelUrl;
+    private tunnelPort;
+    private startedAt;
+    private isShuttingDown;
+    private useFunnel;
+    static start(runtime: IAgentRuntime): Promise<Service>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    startTunnel(port?: number): Promise<string | undefined>;
+    stopTunnel(): Promise<void>;
+    getUrl(): string | null;
+    isActive(): boolean;
+    getStatus(): TunnelStatus;
+    private fetchSelfDnsName;
+    private cleanup;
+}
+//# sourceMappingURL=LocalTunnelService.d.ts.map

package/dist/services/LocalTunnelService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalTunnelService.d.ts","sourceRoot":"","sources":["../../src/services/LocalTunnelService.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,aAAa,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGzE,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA2C7D,wBAAgB,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC,CAM1D;AAaD;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,OAAQ,YAAW,cAAc;IACvE,OAAgB,WAAW,SAAY;IACvC,QAAQ,CAAC,qBAAqB,2HAC4F;IAE1H,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,SAAS,CAAS;WAEJ,KAAK,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAM/D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAwDvD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBjC,MAAM,IAAI,MAAM,GAAG,IAAI;IAIvB,QAAQ,IAAI,OAAO;IAInB,SAAS,IAAI,YAAY;YAWX,gBAAgB;IAgB9B,OAAO,CAAC,OAAO;CAMhB"}

package/dist/services/LocalTunnelService.js

@@ -0,0 +1,186 @@
+import { spawn } from 'node:child_process';
+import { elizaLogger, Service } from '@elizaos/core';
+import { z } from 'zod';
+import { validateTunnelConfig } from '../environment';
+const tailscaleStatusPeerSchema = z.object({
+    DNSName: z.string().optional(),
+    Online: z.boolean().optional(),
+});
+const tailscaleStatusSchema = z.object({
+    Self: z
+        .object({
+        DNSName: z.string().optional(),
+    })
+        .optional(),
+    MagicDNSSuffix: z.string().optional(),
+    Peer: z.record(z.string(), tailscaleStatusPeerSchema).optional(),
+});
+function runCommand(cmd, args) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+        const out = [];
+        const err = [];
+        child.stdout.on('data', (chunk) => out.push(chunk));
+        child.stderr.on('data', (chunk) => err.push(chunk));
+        child.on('error', reject);
+        child.on('exit', (code) => resolve({
+            code,
+            stdout: Buffer.concat(out).toString('utf8'),
+            stderr: Buffer.concat(err).toString('utf8'),
+        }));
+    });
+}
+export function checkTailscaleInstalled() {
+    return new Promise((resolve) => {
+        const proc = spawn('which', ['tailscale']);
+        proc.on('exit', (code) => resolve(code === 0));
+        proc.on('error', () => resolve(false));
+    });
+}
+function parseTailscaleStatus(stdout) {
+    let raw;
+    try {
+        raw = JSON.parse(stdout);
+    }
+    catch {
+        return null;
+    }
+    const result = tailscaleStatusSchema.safeParse(raw);
+    return result.success ? result.data : null;
+}
+/**
+ * Tunnel service backed by the locally-installed `tailscale` CLI.
+ *
+ * The user is responsible for `tailscale up` (i.e. authenticating with
+ * Tailscale's coordination server, OR with a self-hosted headscale via
+ * `--login-server`). This service just calls `tailscale serve` / `tailscale
+ * funnel` to expose a port and reads `tailscale status --json` to learn the
+ * tailnet DNS name.
+ *
+ * Coexists with `@elizaos/plugin-elizacloud`'s cloud tunnel and
+ * `@elizaos/plugin-ngrok` — only the first one to register `serviceType="tunnel"`
+ * wins. This service registers itself only if the `tailscale` binary is on
+ * `PATH`, gating out machines that have no Tailscale install.
+ */
+export class LocalTunnelService extends Service {
+    static serviceType = 'tunnel';
+    capabilityDescription = 'Tunnel via the locally-installed `tailscale` CLI (serve / funnel). User authenticates separately with `tailscale up`.';
+    tunnelUrl = null;
+    tunnelPort = null;
+    startedAt = null;
+    isShuttingDown = false;
+    useFunnel = false;
+    static async start(runtime) {
+        const service = new LocalTunnelService(runtime);
+        await service.start();
+        return service;
+    }
+    async start() {
+        elizaLogger.info('[LocalTunnelService] starting');
+        const installed = await checkTailscaleInstalled();
+        if (!installed) {
+            throw new Error('tailscale is not installed. Install from https://tailscale.com/download or run: brew install tailscale');
+        }
+    }
+    async stop() {
+        await this.stopTunnel();
+    }
+    async startTunnel(port) {
+        if (this.isActive()) {
+            elizaLogger.warn('[LocalTunnelService] tunnel already running');
+            return this.tunnelUrl ?? undefined;
+        }
+        if (port === undefined || port === null) {
+            elizaLogger.warn('[LocalTunnelService] startTunnel called without a port — service active but no tunnel started');
+            return;
+        }
+        if (!Number.isInteger(port) || port < 1 || port > 65535) {
+            throw new Error('Invalid port number');
+        }
+        const config = await validateTunnelConfig(this.runtime);
+        this.useFunnel = config.TUNNEL_FUNNEL;
+        elizaLogger.info(`[LocalTunnelService] starting tunnel on port ${port} (funnel=${this.useFunnel})`);
+        if (this.useFunnel) {
+            const result = await runCommand('tailscale', ['funnel', String(port)]);
+            if (result.code !== 0) {
+                throw new Error(`tailscale funnel exited with code ${result.code}: ${result.stderr.trim()}`);
+            }
+        }
+        else {
+            const result = await runCommand('tailscale', [
+                'serve',
+                '--bg',
+                '--https=443',
+                `localhost:${port}`,
+            ]);
+            if (result.code !== 0) {
+                throw new Error(`tailscale serve exited with code ${result.code}: ${result.stderr.trim()}`);
+            }
+        }
+        const dnsName = await this.fetchSelfDnsName();
+        if (!dnsName) {
+            throw new Error('tailscale serve started but no DNSName resolved from `tailscale status --json`');
+        }
+        this.tunnelUrl = `https://${dnsName}`;
+        this.tunnelPort = port;
+        this.startedAt = new Date();
+        elizaLogger.info(`[LocalTunnelService] tunnel started: ${this.tunnelUrl}`);
+        return this.tunnelUrl;
+    }
+    async stopTunnel() {
+        if (!this.isActive()) {
+            elizaLogger.warn('[LocalTunnelService] no active tunnel to stop');
+            return;
+        }
+        this.isShuttingDown = true;
+        elizaLogger.info('[LocalTunnelService] stopping tunnel');
+        if (this.useFunnel) {
+            await runCommand('tailscale', ['funnel', 'reset']);
+        }
+        else {
+            await runCommand('tailscale', ['serve', 'reset']);
+        }
+        this.cleanup();
+        this.isShuttingDown = false;
+        elizaLogger.info('[LocalTunnelService] tunnel stopped');
+    }
+    getUrl() {
+        return this.tunnelUrl;
+    }
+    isActive() {
+        return this.tunnelUrl !== null && !this.isShuttingDown;
+    }
+    getStatus() {
+        return {
+            active: this.isActive(),
+            url: this.tunnelUrl,
+            port: this.tunnelPort,
+            startedAt: this.startedAt,
+            provider: 'tailscale',
+            backend: 'local-cli',
+        };
+    }
+    async fetchSelfDnsName() {
+        const result = await runCommand('tailscale', ['status', '--json']);
+        if (result.code !== 0) {
+            elizaLogger.error(`[LocalTunnelService] tailscale status failed: ${result.stderr.trim()}`);
+            return null;
+        }
+        const status = parseTailscaleStatus(result.stdout);
+        if (!status) {
+            elizaLogger.error('[LocalTunnelService] tailscale status returned malformed JSON');
+            return null;
+        }
+        const raw = status.Self?.DNSName;
+        if (!raw)
+            return null;
+        return raw.replace(/\.$/, '');
+    }
+    cleanup() {
+        this.tunnelUrl = null;
+        this.tunnelPort = null;
+        this.startedAt = null;
+        this.useFunnel = false;
+    }
+}
+//# sourceMappingURL=LocalTunnelService.js.map

package/dist/services/LocalTunnelService.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Tunnel-service contract shared across all elizaOS tunnel plugins.
+ *
+ * All tunnel plugins (`@elizaos/plugin-tunnel`, `@elizaos/plugin-elizacloud`'s
+ * cloud tunnel, `@elizaos/plugin-ngrok`) register under
+ * `serviceType = "tunnel"` so consumers stay backend-agnostic via
+ * `runtime.getService("tunnel")`. The runtime returns the FIRST registered
+ * service for a given type, so plugins coordinate via conditional
+ * registration: each plugin's `init` only registers if its credentials are
+ * present and no other tunnel service has already claimed the slot.
+ */
+import type { IAgentRuntime } from '@elizaos/core';
+declare module '@elizaos/core' {
+    interface ServiceTypeRegistry {
+        TUNNEL: 'tunnel';
+    }
+}
+export type TunnelProvider = 'tailscale' | 'headscale' | 'ngrok';
+export interface TunnelStatus {
+    active: boolean;
+    url: string | null;
+    port: number | null;
+    startedAt: Date | null;
+    provider: TunnelProvider;
+    /** Optional human label distinguishing backend variants (e.g. "local-cli", "eliza-cloud-headscale"). */
+    backend?: string;
+}
+export interface ITunnelService {
+    startTunnel(port?: number): Promise<string | undefined>;
+    stopTunnel(): Promise<void>;
+    getUrl(): string | null;
+    isActive(): boolean;
+    getStatus(): TunnelStatus;
+}
+/**
+ * Backend-agnostic accessor. Returns the first registered service that
+ * implements the tunnel contract; returns null if nothing is registered or
+ * the registered service doesn't satisfy the shape (defensive guard against
+ * an unrelated service registering under "tunnel").
+ */
+export declare function getTunnelService(runtime: IAgentRuntime): ITunnelService | null;
+/**
+ * True iff no tunnel service has claimed `serviceType="tunnel"` yet.
+ * Used by tunnel plugins' `init` hooks to coordinate "first active wins".
+ */
+export declare function tunnelSlotIsFree(runtime: IAgentRuntime): boolean;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAW,MAAM,eAAe,CAAC;AAE5D,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,mBAAmB;QAC3B,MAAM,EAAE,QAAQ,CAAC;KAClB;CACF;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,wGAAwG;IACxG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACxD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,MAAM,IAAI,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,IAAI,OAAO,CAAC;IACpB,SAAS,IAAI,YAAY,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,GAAG,IAAI,CAO9E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAEhE"}

package/dist/types.js

@@ -0,0 +1,34 @@
+/**
+ * Tunnel-service contract shared across all elizaOS tunnel plugins.
+ *
+ * All tunnel plugins (`@elizaos/plugin-tunnel`, `@elizaos/plugin-elizacloud`'s
+ * cloud tunnel, `@elizaos/plugin-ngrok`) register under
+ * `serviceType = "tunnel"` so consumers stay backend-agnostic via
+ * `runtime.getService("tunnel")`. The runtime returns the FIRST registered
+ * service for a given type, so plugins coordinate via conditional
+ * registration: each plugin's `init` only registers if its credentials are
+ * present and no other tunnel service has already claimed the slot.
+ */
+/**
+ * Backend-agnostic accessor. Returns the first registered service that
+ * implements the tunnel contract; returns null if nothing is registered or
+ * the registered service doesn't satisfy the shape (defensive guard against
+ * an unrelated service registering under "tunnel").
+ */
+export function getTunnelService(runtime) {
+    const service = runtime.getService('tunnel');
+    if (!service)
+        return null;
+    if (typeof service.startTunnel !== 'function') {
+        return null;
+    }
+    return service;
+}
+/**
+ * True iff no tunnel service has claimed `serviceType="tunnel"` yet.
+ * Used by tunnel plugins' `init` hooks to coordinate "first active wins".
+ */
+export function tunnelSlotIsFree(runtime) {
+    return runtime.getService('tunnel') === null;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA8BH;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,OAAQ,OAAmC,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,OAAmC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAsB;IACrD,OAAO,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC;AAC/C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elizaos/plugin-tunnel",
-  "version": "2.0.3-beta.6",
+  "version": "2.0.3-beta.7",
   "description": "Tunnel plugin for elizaOS — local Tailscale CLI backend (serve/funnel). Pair with @elizaos/plugin-elizacloud for the hosted headscale backend.",
   "type": "module",
   "main": "dist/index.js",
@@ -54,10 +54,10 @@
     "networking"
   ],
   "peerDependencies": {
-    "@elizaos/core": "2.0.3-beta.6"
+    "@elizaos/core": "2.0.3-beta.7"
   },
   "dependencies": {
-    "@elizaos/core": "2.0.3-beta.6",
+    "@elizaos/core": "2.0.3-beta.7",
     "zod": "^4.4.2"
   },
   "devDependencies": {
@@ -73,5 +73,5 @@
     "pluginType": "elizaos:plugin:1.0.0",
     "pluginParameters": {}
   },
-  "gitHead": "990dc996172b3e0fb525a75052a5ac28a4cd4de5"
+  "gitHead": "61094f10458d11055c75b3dd0bae374e3f66bac5"
 }