@kraki/tentacle 0.1.0

package/dist/relay-client.js

@@ -0,0 +1,525 @@
+/**
+ * Relay client — connects the tentacle to the head via WebSocket.
+ *
+ * Translates adapter events into protocol messages and sends them to the head.
+ * Receives consumer actions from the head and routes them to the adapter.
+ * Handles auth, reconnection, and session lifecycle.
+ */
+import { WebSocket } from 'ws';
+import { importPublicKey } from '@kraki/crypto';
+import { createLogger } from './logger.js';
+const logger = createLogger('relay-client');
+export class RelayClient {
+    ws = null;
+    adapter;
+    sessionManager;
+    keyManager;
+    options;
+    state = 'disconnected';
+    reconnectAttempts = 0;
+    reconnectTimer = null;
+    authInfo = null;
+    e2eEnabled = false;
+    /** Cached consumer public keys for E2E encryption */
+    consumerKeys = new Map();
+    /** Messages queued when E2E is enabled but no consumer keys are available yet */
+    pendingE2eQueue = [];
+    /** Maps pre-generated sessionId → requestId for concurrent create_session correlation */
+    pendingRequestIds = new Map();
+    // Stale connection detection — tracks server pings to detect sleep/network changes
+    lastServerPingAt = 0;
+    staleCheckTimer = null;
+    /** How long without a server ping before we consider the connection stale (ms) */
+    static STALE_THRESHOLD = 60_000; // 60s (server pings every 30s, so 2 missed pings)
+    /** How often to check for stale connection (ms) */
+    static STALE_CHECK_INTERVAL = 10_000;
+    /** Called when relay state changes */
+    onStateChange = null;
+    /** Called on auth success */
+    onAuthenticated = null;
+    /** Called on fatal error (won't reconnect) */
+    onFatalError = null;
+    constructor(adapter, sessionManager, options, keyManager) {
+        this.adapter = adapter;
+        this.sessionManager = sessionManager;
+        this.options = options;
+        this.keyManager = keyManager ?? null;
+        this.wireAdapterEvents();
+    }
+    /**
+     * Connect to the relay. Auto-reconnects on disconnect.
+     */
+    connect() {
+        if (this.ws)
+            return;
+        this.setState('connecting');
+        const ws = new WebSocket(this.options.relayUrl);
+        this.ws = ws;
+        ws.on('open', () => {
+            this.setState('authenticating');
+            this.reconnectAttempts = 0;
+            this.lastServerPingAt = Date.now();
+            this.startStaleCheck();
+            const authMsg = {
+                type: 'auth',
+                token: this.options.token,
+                device: {
+                    ...this.options.device,
+                    publicKey: this.keyManager?.getCompactPublicKey(),
+                },
+            };
+            ws.send(JSON.stringify(authMsg));
+        });
+        ws.on('message', (data) => {
+            this.lastServerPingAt = Date.now();
+            try {
+                const msg = JSON.parse(data.toString());
+                this.handleMessage(msg);
+            }
+            catch {
+                // Ignore malformed messages from head
+            }
+        });
+        ws.on('close', () => {
+            this.stopStaleCheck();
+            this.ws = null;
+            this.setState('disconnected');
+            this.scheduleReconnect();
+        });
+        ws.on('error', () => {
+            // Error triggers close, which handles reconnect
+        });
+        // Track server pings for stale connection detection
+        ws.on('ping', () => {
+            this.lastServerPingAt = Date.now();
+        });
+    }
+    /**
+     * Disconnect from the relay. No reconnect.
+     */
+    disconnect() {
+        this.stopStaleCheck();
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.ws) {
+            this.ws.close();
+            this.ws = null;
+        }
+        this.setState('disconnected');
+    }
+    /**
+     * Get current connection state.
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get auth info from last successful connection.
+     */
+    getAuthInfo() {
+        return this.authInfo;
+    }
+    // ── Message handling ────────────────────────────────
+    handleMessage(msg) {
+        if (msg.type === 'auth_ok') {
+            this.authInfo = msg;
+            this.e2eEnabled = this.authInfo.e2e && !!this.keyManager;
+            // Cache consumer device public keys for E2E
+            if (this.e2eEnabled && this.authInfo.devices) {
+                this.updateConsumerKeys(this.authInfo.devices);
+            }
+            this.setState('connected');
+            this.onAuthenticated?.(this.authInfo);
+            this.resumeDisconnectedSessions();
+            return;
+        }
+        if (msg.type === 'auth_error') {
+            this.onFatalError?.(msg.message);
+            this.disconnect();
+            return;
+        }
+        if (msg.type === 'pong') {
+            return;
+        }
+        if (msg.type === 'head_notice') {
+            // Update consumer keys when devices change
+            if (this.e2eEnabled && msg.event === 'device_online') {
+                const dev = msg.data?.device;
+                const key = dev?.encryptionKey ?? dev?.publicKey;
+                if (dev && key) {
+                    this.consumerKeys.set(dev.id, key);
+                    this.flushE2eQueue();
+                }
+            }
+            if (msg.event === 'device_offline' || msg.event === 'device_removed') {
+                this.consumerKeys.delete(msg.data?.deviceId);
+            }
+            return;
+        }
+        // In E2E mode, incoming consumer messages may be encrypted
+        if (msg.type === 'encrypted' && this.keyManager && this.authInfo) {
+            try {
+                const decrypted = this.keyManager.decryptForMe({ iv: msg.iv, ciphertext: msg.ciphertext, tag: msg.tag, keys: msg.keys }, this.authInfo.deviceId);
+                const inner = JSON.parse(decrypted);
+                this.handleConsumerMessage(inner);
+            }
+            catch {
+                // Can't decrypt — not for us or corrupted
+            }
+            return;
+        }
+        // Plaintext consumer messages
+        this.handleConsumerMessage(msg);
+    }
+    handleConsumerMessage(msg) {
+        // create_session is special — no sessionId yet
+        if (msg.type === 'create_session') {
+            this.handleCreateSession(msg);
+            return;
+        }
+        const sessionId = msg.sessionId;
+        if (!sessionId)
+            return;
+        try {
+            switch (msg.type) {
+                case 'send_input':
+                    // Broadcast user_message back to apps (round-trip confirmation)
+                    this.send({
+                        type: 'user_message',
+                        sessionId,
+                        payload: { content: msg.payload.text },
+                    });
+                    this.adapter.sendMessage(sessionId, msg.payload.text, msg.payload.attachments)
+                        .catch((err) => logger.error({ err, sessionId }, 'sendMessage failed'));
+                    break;
+                case 'approve':
+                    this.adapter.respondToPermission(sessionId, msg.payload.permissionId, 'approve')
+                        .catch((err) => logger.error({ err, sessionId }, 'respondToPermission failed'));
+                    break;
+                case 'deny':
+                    this.adapter.respondToPermission(sessionId, msg.payload.permissionId, 'deny')
+                        .catch((err) => logger.error({ err, sessionId }, 'respondToPermission failed'));
+                    break;
+                case 'always_allow':
+                    this.adapter.respondToPermission(sessionId, msg.payload.permissionId, 'always_allow')
+                        .catch((err) => logger.error({ err, sessionId }, 'respondToPermission failed'));
+                    break;
+                case 'answer':
+                    this.adapter.respondToQuestion(sessionId, msg.payload.questionId, msg.payload.answer, false)
+                        .catch((err) => logger.error({ err, sessionId }, 'respondToQuestion failed'));
+                    break;
+                case 'kill_session':
+                    this.adapter.killSession(sessionId)
+                        .catch((err) => logger.error({ err, sessionId }, 'killSession failed'));
+                    break;
+                case 'abort_session':
+                    this.adapter.abortSession(sessionId)
+                        .catch((err) => logger.error({ err, sessionId }, 'abortSession failed'));
+                    break;
+                default: {
+                    // Handle extended message types (e.g. set_session_mode)
+                    const ext = msg;
+                    if (ext.type === 'set_session_mode') {
+                        this.adapter.setSessionMode(sessionId, ext.payload.mode);
+                        // Echo confirmation back so head stores it for replay
+                        this.send({
+                            type: 'session_mode_set',
+                            sessionId,
+                            payload: { mode: ext.payload.mode },
+                        });
+                    }
+                    break;
+                }
+            }
+        }
+        catch (err) {
+            logger.error({ err, sessionId, type: msg.type }, 'handleConsumerMessage failed');
+        }
+    }
+    async handleCreateSession(msg) {
+        if (msg.type !== 'create_session')
+            return;
+        const { model, cwd, prompt, requestId } = msg.payload;
+        // Pre-generate a stable sessionId and map requestId BEFORE calling the adapter.
+        // This is concurrency-safe: each request gets its own unique key.
+        const preSessionId = `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+        if (requestId) {
+            this.pendingRequestIds.set(preSessionId, requestId);
+        }
+        try {
+            const result = await this.adapter.createSession({ model, cwd: cwd || '/', sessionId: preSessionId });
+            // If an initial prompt was provided, send it to the new session
+            if (prompt && result.sessionId) {
+                await this.adapter.sendMessage(result.sessionId, prompt);
+            }
+        }
+        catch (err) {
+            this.pendingRequestIds.delete(preSessionId);
+            if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+                this.ws.send(JSON.stringify({
+                    type: 'server_error',
+                    message: `Failed to create session: ${err.message}`,
+                    requestId,
+                }));
+            }
+        }
+    }
+    // ── Adapter event wiring ────────────────────────────
+    wireAdapterEvents() {
+        this.adapter.onSessionCreated = (event) => {
+            // Track in SessionManager if not already tracked (from resume)
+            if (!this.sessionManager.getMeta(event.sessionId)) {
+                this.sessionManager.createSession(event.agent, event.model, event.sessionId);
+            }
+            // Look up requestId by sessionId (set in handleCreateSession before adapter call)
+            const requestId = this.pendingRequestIds.get(event.sessionId);
+            if (requestId)
+                this.pendingRequestIds.delete(event.sessionId);
+            this.send({
+                type: 'session_created',
+                sessionId: event.sessionId,
+                payload: { agent: event.agent, model: event.model, requestId },
+            });
+        };
+        this.adapter.onMessage = (sessionId, event) => {
+            this.send({
+                type: 'agent_message',
+                sessionId,
+                payload: { content: event.content },
+            });
+            // Update context with latest state
+            this.sessionManager.updateContext(sessionId, {
+                lastUserMessage: '', // Will be set by send_input handler
+            });
+        };
+        this.adapter.onMessageDelta = (sessionId, event) => {
+            this.send({
+                type: 'agent_message_delta',
+                sessionId,
+                payload: { content: event.content },
+            });
+        };
+        this.adapter.onPermissionRequest = (sessionId, event) => {
+            this.send({
+                type: 'permission',
+                sessionId,
+                payload: {
+                    id: event.id,
+                    toolName: event.toolArgs.toolName,
+                    args: event.toolArgs.args,
+                    description: event.description,
+                },
+            });
+        };
+        // When a permission is auto-resolved (e.g. by Always Allow), notify relay
+        // so the web app can remove the blocking card
+        this.adapter.onPermissionAutoResolved = (sessionId, permissionId) => {
+            if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+                this.ws.send(JSON.stringify({
+                    type: 'approve',
+                    sessionId,
+                    payload: { permissionId },
+                }));
+            }
+        };
+        this.adapter.onQuestionRequest = (sessionId, event) => {
+            this.send({
+                type: 'question',
+                sessionId,
+                payload: {
+                    id: event.id,
+                    question: event.question,
+                    choices: event.choices,
+                },
+            });
+        };
+        this.adapter.onToolStart = (sessionId, event) => {
+            this.send({
+                type: 'tool_start',
+                sessionId,
+                payload: { toolName: event.toolName, args: event.args, toolCallId: event.toolCallId },
+            });
+            // Track key files from tool usage
+            if (event.toolName === 'read_file' || event.toolName === 'write_file') {
+                const path = event.args?.path;
+                if (path) {
+                    const ctx = this.sessionManager.getContext(sessionId);
+                    if (ctx) {
+                        const files = new Set(ctx.keyFiles);
+                        files.add(path);
+                        this.sessionManager.updateContext(sessionId, { keyFiles: Array.from(files) });
+                    }
+                }
+            }
+        };
+        this.adapter.onToolComplete = (sessionId, event) => {
+            this.send({
+                type: 'tool_complete',
+                sessionId,
+                payload: { toolName: event.toolName, args: {}, result: event.result, toolCallId: event.toolCallId },
+            });
+        };
+        this.adapter.onIdle = (sessionId) => {
+            this.send({ type: 'idle', sessionId, payload: {} });
+        };
+        this.adapter.onError = (sessionId, event) => {
+            this.send({
+                type: 'error',
+                sessionId,
+                payload: { message: event.message },
+            });
+        };
+        this.adapter.onSessionEnded = (sessionId, event) => {
+            this.sessionManager.endSession(sessionId, event.reason);
+            this.send({
+                type: 'session_ended',
+                sessionId,
+                payload: { reason: event.reason },
+            });
+        };
+    }
+    // ── Session resume on reconnect ─────────────────────
+    async resumeDisconnectedSessions() {
+        const resumable = this.sessionManager.getResumableSessions();
+        for (const meta of resumable) {
+            const result = this.sessionManager.resumeSession(meta.id);
+            if (result) {
+                try {
+                    await this.adapter.resumeSession(meta.id, result.context);
+                    // session_created will be fired by adapter's onSessionCreated callback
+                }
+                catch {
+                    this.sessionManager.endSession(meta.id, 'resume_failed');
+                    this.send({
+                        type: 'session_ended',
+                        sessionId: meta.id,
+                        payload: { reason: 'resume_failed' },
+                    });
+                }
+            }
+        }
+    }
+    // ── Send to relay ───────────────────────────────────
+    // TODO: Make send() accept a discriminated union of ProducerMessage types
+    // instead of Partial<ProducerMessage> so TypeScript enforces correct payload
+    // shape per message type (e.g. user_message must have payload.content).
+    send(msg) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN)
+            return;
+        if (this.e2eEnabled && this.keyManager) {
+            if (this.consumerKeys.size === 0) {
+                // No consumers online — queue (bounded to prevent memory growth)
+                if (this.pendingE2eQueue.length < 1000) {
+                    this.pendingE2eQueue.push(msg);
+                }
+                else {
+                    logger.warn({ type: msg.type }, 'E2E queue full (1000) — dropping message');
+                }
+                return;
+            }
+            this.sendEncrypted(msg);
+            return;
+        }
+        try {
+            this.ws.send(JSON.stringify(msg));
+        }
+        catch (err) {
+            logger.error({ err }, 'ws.send failed');
+        }
+    }
+    /**
+     * Encrypt and send a message to the relay.
+     */
+    sendEncrypted(msg) {
+        if (!this.ws || this.ws.readyState !== WebSocket.OPEN || !this.keyManager)
+            return;
+        const recipients = [];
+        for (const [deviceId, compactKey] of this.consumerKeys) {
+            recipients.push({ deviceId, publicKey: importPublicKey(compactKey) });
+        }
+        const plaintext = JSON.stringify(msg);
+        const encrypted = this.keyManager.encryptForRecipients(plaintext, recipients);
+        const envelope = {
+            type: 'encrypted',
+            sessionId: msg.sessionId,
+            iv: encrypted.iv,
+            ciphertext: encrypted.ciphertext,
+            tag: encrypted.tag,
+            keys: encrypted.keys,
+        };
+        // Expose agent/model for session_created so the head can register properly
+        if (msg.type === 'session_created' && msg.payload) {
+            envelope.agent = msg.payload.agent;
+            envelope.model = msg.payload.model;
+        }
+        // Mark ephemeral messages — head forwards but doesn't persist
+        if (msg.type === 'agent_message_delta' || msg.type === 'idle') {
+            envelope.ephemeral = true;
+        }
+        this.ws.send(JSON.stringify(envelope));
+    }
+    /**
+     * Flush queued E2E messages once consumer keys become available.
+     */
+    flushE2eQueue() {
+        if (this.consumerKeys.size === 0 || this.pendingE2eQueue.length === 0)
+            return;
+        const queued = this.pendingE2eQueue.splice(0);
+        for (const msg of queued) {
+            this.sendEncrypted(msg);
+        }
+    }
+    updateConsumerKeys(devices) {
+        this.consumerKeys.clear();
+        for (const d of devices) {
+            if (d.role === 'app') {
+                const key = d.encryptionKey ?? d.publicKey;
+                if (key)
+                    this.consumerKeys.set(d.id, key);
+            }
+        }
+        // Flush queued messages now that we have consumer keys
+        this.flushE2eQueue();
+    }
+    // ── Stale connection detection ───────────────────────
+    startStaleCheck() {
+        this.stopStaleCheck();
+        this.staleCheckTimer = setInterval(() => {
+            if (this.state !== 'connected' && this.state !== 'authenticating')
+                return;
+            const elapsed = Date.now() - this.lastServerPingAt;
+            if (elapsed > RelayClient.STALE_THRESHOLD) {
+                logger.warn(`No server ping for ${Math.round(elapsed / 1000)}s — connection stale, reconnecting`);
+                this.ws?.close();
+            }
+        }, RelayClient.STALE_CHECK_INTERVAL);
+    }
+    stopStaleCheck() {
+        if (this.staleCheckTimer) {
+            clearInterval(this.staleCheckTimer);
+            this.staleCheckTimer = null;
+        }
+    }
+    // ── Reconnect logic ─────────────────────────────────
+    scheduleReconnect() {
+        const max = this.options.maxReconnects ?? Infinity;
+        if (this.reconnectAttempts >= max) {
+            this.onFatalError?.('Max reconnect attempts reached');
+            return;
+        }
+        const delay = this.options.reconnectDelay ?? 3000;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectAttempts++;
+            this.connect();
+        }, delay);
+    }
+    setState(state) {
+        if (this.state === state)
+            return;
+        this.state = state;
+        this.onStateChange?.(state);
+    }
+}
+//# sourceMappingURL=relay-client.js.map

package/dist/relay-client.js.map

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

package/dist/session-manager.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Tentacle session manager.
+ *
+ * Owns session lifecycle: create, resume, crash recovery, context persistence.
+ * The head doesn't know about runs or context — it just sees sessionIds.
+ * This is the tentacle's local intelligence layer.
+ */
+export interface SessionContext {
+    summary: string;
+    keyFiles: string[];
+    lastUserMessage: string;
+    pendingAction?: string;
+    updatedAt: string;
+}
+export interface SessionMeta {
+    id: string;
+    agent: string;
+    model?: string;
+    title?: string;
+    state: 'active' | 'idle' | 'disconnected' | 'ended';
+    currentRunId: string;
+    totalRuns: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface RunRecord {
+    id: string;
+    startedAt: string;
+    endedAt?: string;
+    endReason?: string;
+}
+export declare class SessionManager {
+    private sessionsDir;
+    constructor(sessionsDir?: string);
+    /**
+     * Create a new session. Returns the session ID.
+     */
+    createSession(agent: string, model?: string, sessionId?: string): {
+        sessionId: string;
+        runId: string;
+    };
+    /**
+     * Resume a session after crash/restart. Creates a new run.
+     * Returns context for the agent to recover.
+     */
+    resumeSession(sessionId: string): {
+        runId: string;
+        context: SessionContext;
+    } | null;
+    /**
+     * Mark a session as ended normally.
+     */
+    endSession(sessionId: string, reason: string): void;
+    /**
+     * Mark a session as disconnected (agent process died unexpectedly).
+     */
+    markDisconnected(sessionId: string): void;
+    /**
+     * Update session context (rolling summary for recovery).
+     */
+    updateContext(sessionId: string, context: Partial<SessionContext>): void;
+    /**
+     * Update session title (e.g., auto-generated by agent).
+     */
+    setTitle(sessionId: string, title: string): void;
+    /**
+     * Get all sessions that were active/disconnected (need resume on restart).
+     */
+    getResumableSessions(): SessionMeta[];
+    /**
+     * Get session context for a session.
+     */
+    getContext(sessionId: string): SessionContext | null;
+    /**
+     * Get session metadata.
+     */
+    getMeta(sessionId: string): SessionMeta | null;
+    private sessionDir;
+    private readMeta;
+    private writeMeta;
+    private readContext;
+    private writeContext;
+    private readRun;
+    private writeRun;
+}