alaska-ai 0.1.0

package/dist/mcp/tunnel.js

@@ -0,0 +1,154 @@
+/**
+ * Tunnel manager — opens public tunnels via cloudflared or ngrok.
+ *
+ * Tunnels are only used for user-facing things (dev server previews,
+ * file browsers) — never for the bridge's own IPC server.
+ */
+import { spawn } from 'node:child_process';
+import { detectTunnelTools } from '../cli/init.js';
+/** Tracks all active tunnels for cleanup. */
+const activeTunnels = new Map();
+/**
+ * Open a tunnel on the given port using cloudflared (preferred) or ngrok.
+ * Auto-closes after `ttl` seconds.
+ */
+export async function openTunnel(port, ttl) {
+    const { hasCloudflared, hasNgrok } = detectTunnelTools();
+    if (hasCloudflared) {
+        return openCloudflaredTunnel(port, ttl);
+    }
+    if (hasNgrok) {
+        return openNgrokTunnel(port, ttl);
+    }
+    throw new Error('No tunnel tool available. Install cloudflared or ngrok:\n' +
+        '  brew install cloudflared\n' +
+        '  brew install ngrok');
+}
+/** Open a cloudflared tunnel. Parses the public URL from stderr. */
+function openCloudflaredTunnel(port, ttl) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('cloudflared', ['tunnel', '--url', `http://localhost:${port}`], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const id = `cf-${port}-${Date.now()}`;
+        let resolved = false;
+        const timer = ttl > 0 ? setTimeout(() => {
+            closeTunnel(id);
+        }, ttl * 1000) : null;
+        activeTunnels.set(id, { process: child, timer });
+        // cloudflared prints the URL to stderr like:
+        // "... https://some-random.trycloudflare.com ..."
+        let stderrBuf = '';
+        child.stderr?.on('data', (chunk) => {
+            stderrBuf += chunk.toString();
+            const match = stderrBuf.match(/https:\/\/[a-z0-9-]+\.trycloudflare\.com/);
+            if (match && !resolved) {
+                resolved = true;
+                const url = match[0];
+                console.log(`[tunnel] cloudflared tunnel opened: ${url} (port ${port}, TTL ${ttl}s)`);
+                resolve({
+                    url,
+                    close: () => closeTunnel(id),
+                });
+            }
+        });
+        child.on('error', (err) => {
+            activeTunnels.delete(id);
+            if (timer)
+                clearTimeout(timer);
+            if (!resolved)
+                reject(new Error(`cloudflared failed: ${err.message}`));
+        });
+        child.on('exit', (code) => {
+            activeTunnels.delete(id);
+            if (timer)
+                clearTimeout(timer);
+            if (!resolved)
+                reject(new Error(`cloudflared exited with code ${code} before URL was available`));
+        });
+        // Timeout if URL not found within 30 seconds
+        setTimeout(() => {
+            if (!resolved) {
+                resolved = true;
+                closeTunnel(id);
+                reject(new Error('cloudflared timed out waiting for URL'));
+            }
+        }, 30000);
+    });
+}
+/** Open an ngrok tunnel. Queries the local API for the public URL. */
+function openNgrokTunnel(port, ttl) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('ngrok', ['http', String(port)], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const id = `ngrok-${port}-${Date.now()}`;
+        let resolved = false;
+        const timer = ttl > 0 ? setTimeout(() => {
+            closeTunnel(id);
+        }, ttl * 1000) : null;
+        activeTunnels.set(id, { process: child, timer });
+        child.on('error', (err) => {
+            activeTunnels.delete(id);
+            if (timer)
+                clearTimeout(timer);
+            if (!resolved)
+                reject(new Error(`ngrok failed: ${err.message}`));
+        });
+        child.on('exit', (code) => {
+            activeTunnels.delete(id);
+            if (timer)
+                clearTimeout(timer);
+            if (!resolved)
+                reject(new Error(`ngrok exited with code ${code}`));
+        });
+        // Poll the ngrok local API for the tunnel URL
+        const pollInterval = setInterval(async () => {
+            try {
+                const res = await fetch('http://127.0.0.1:4040/api/tunnels');
+                const data = await res.json();
+                const tunnel = data.tunnels?.find(t => t.proto === 'https') ?? data.tunnels?.[0];
+                if (tunnel && !resolved) {
+                    resolved = true;
+                    clearInterval(pollInterval);
+                    const url = tunnel.public_url;
+                    console.log(`[tunnel] ngrok tunnel opened: ${url} (port ${port}, TTL ${ttl}s)`);
+                    resolve({
+                        url,
+                        close: () => closeTunnel(id),
+                    });
+                }
+            }
+            catch {
+                // ngrok API not ready yet — keep polling
+            }
+        }, 500);
+        // Timeout after 30 seconds
+        setTimeout(() => {
+            clearInterval(pollInterval);
+            if (!resolved) {
+                resolved = true;
+                closeTunnel(id);
+                reject(new Error('ngrok timed out waiting for tunnel URL'));
+            }
+        }, 30000);
+    });
+}
+/** Close a specific tunnel by its internal ID. */
+function closeTunnel(id) {
+    const tunnel = activeTunnels.get(id);
+    if (tunnel) {
+        if (tunnel.timer)
+            clearTimeout(tunnel.timer);
+        tunnel.process.kill('SIGTERM');
+        activeTunnels.delete(id);
+        console.log(`[tunnel] closed tunnel ${id}`);
+    }
+}
+/** Close all active tunnels. Called during shutdown. */
+export function closeAllTunnels() {
+    for (const [id] of activeTunnels) {
+        closeTunnel(id);
+    }
+}
+//# sourceMappingURL=tunnel.js.map

package/dist/mcp/tunnel.js.map

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

package/dist/router.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Router for Alaska.
+ *
+ * Maps channel/thread pairs to projects and sessions, manages backend
+ * lifecycle, and enforces session state machine transitions.
+ */
+import type { Backend, FileAttachment, McpServerEntry } from './types/backend.js';
+import type { NormalizedEvent } from './types/events.js';
+import type { Store, Project, Session } from './store.js';
+/** Factory function that creates a Backend instance given a backend name. */
+export type BackendFactory = (backendName: string) => Backend;
+export interface ResolveResult {
+    project: Project;
+    session: Session;
+}
+export interface RouteResult {
+    events: NormalizedEvent[];
+    session: Session;
+}
+/** Context passed to mcpConfigFactory for generating per-session MCP config. */
+export interface McpConfigContext {
+    channelId: string;
+    threadId: string;
+    projectDir: string;
+    platform: string;
+}
+/** Factory that creates MCP config for a backend session. */
+export type McpConfigFactory = (ctx: McpConfigContext) => McpServerEntry;
+export interface RouterOptions {
+    /** Timeout for backend.send() in milliseconds. Default: 300000 (5 minutes). */
+    timeoutMs?: number;
+    /** Factory to generate MCP config for each backend session. */
+    mcpConfigFactory?: McpConfigFactory;
+    /** IPC server info for permission hook scripts. */
+    ipc?: {
+        port: number;
+        secret: string;
+    };
+    /** Path to compiled hook scripts directory (dist/hooks/). */
+    hookScriptDir?: string;
+}
+export declare class Router {
+    private store;
+    private backendFactory;
+    private activeBackends;
+    private timeoutMs;
+    private mcpConfigFactory?;
+    private ipc?;
+    private hookScriptDir?;
+    /** Per-thread lock to serialize concurrent sends/responds to the same thread. */
+    private threadLocks;
+    /** Last activity timestamp per thread for idle timeout cleanup. */
+    private lastActivity;
+    /** Idle cleanup interval handle. */
+    private idleCleanupInterval;
+    constructor(store: Store, backendFactory: BackendFactory, options?: RouterOptions);
+    /**
+     * Clean up backends that have been idle for longer than the timeout.
+     */
+    private cleanupIdleBackends;
+    /**
+     * Get an existing alive backend for a thread, or create and start a new one.
+     * Returns the backend ready for send().
+     */
+    private getOrCreateBackend;
+    /**
+     * Acquire a per-thread lock. If another operation is in progress for this
+     * thread, the returned promise won't resolve until it finishes.
+     * Returns a release function to call when the operation completes.
+     */
+    private acquireThreadLock;
+    /** Send with timeout — races backend.send() against a timeout. */
+    private sendWithTimeout;
+    /**
+     * Resolve a channel + thread to a project and session.
+     * Returns null if the channel is not bound to a project.
+     * Creates a new session if the thread is unknown in a bound channel.
+     */
+    resolve(channelId: string, threadId: string): Promise<ResolveResult | null>;
+    /** Prepend context metadata (time, source platform) so the backend can reason about relative dates and message origin. */
+    private prependContext;
+    /** Augment prompt text with upload info for files that have staging metadata. */
+    private augmentTextWithUploadInfo;
+    /** Clean up staging files from file attachments. */
+    private cleanupFileStaging;
+    /**
+     * Send a message through the backend and return normalized events.
+     * Manages session state transitions and persists backend session ID.
+     */
+    send(channelId: string, threadId: string, text: string, files?: FileAttachment[]): Promise<RouteResult>;
+    private _send;
+    /**
+     * Handle a user response when a session is waiting_for_input.
+     * This resumes the backend with the user's response text.
+     * When allowedTools is provided, the backend will auto-approve those tools.
+     */
+    respond(channelId: string, threadId: string, text: string, allowedTools?: string[]): Promise<RouteResult>;
+    private _respond;
+    /**
+     * Reset a session — clear the backend session ID so next message starts fresh.
+     */
+    resetSession(channelId: string, threadId: string): Promise<Session>;
+    /**
+     * Cancel a running backend for a thread. Uses interrupt() for clean
+     * cancellation, then stop() to terminate. Transitions the session back to idle.
+     * Returns true if a backend was cancelled, false if nothing was running.
+     */
+    cancelBackend(channelId: string, threadId: string): Promise<boolean>;
+    /**
+     * Graceful shutdown — stop all active backend sessions and clean up.
+     */
+    shutdown(): Promise<void>;
+}