@kraki/tentacle 0.11.20 → 0.12.1

package/dist/banner.js

@@ -7,7 +7,7 @@ import bannerData from './banner-data.json' with { type: 'json' };
 const data = bannerData;
 const SCRAMBLE = '!@#$%^&*=+<>~/';
 const TITLE = 'KRAKI';
-const TITLE_COLORS = ['#00c9a7', '#00b4d8', '#06b6d4', '#ea6046', '#0891b2'];
+const TITLE_COLORS = ['#00c9a7', '#00b4d8', '#ea6046', '#0891b2', '#ea6046'];
 const BLOCK_MAP = {
     '.': '░', ':': '░', '-': '▒', '=': '▓', '+': '█', '*': '█', '#': '█', '%': '█', '@': '█',
 };

package/dist/history-parser.d.ts

@@ -0,0 +1,37 @@
+/**
+ * History parser — converts Copilot SDK events.jsonl into Kraki protocol messages.
+ *
+ * Used during import to backfill conversation history so the arm can display
+ * the full session context from before Kraki attached.
+ *
+ * Reads events.jsonl line by line (streaming) to handle large files.
+ * Caps output at MAX_BACKFILL_MESSAGES most recent messages.
+ */
+export interface BackfilledMessage {
+    seq: number;
+    type: string;
+    payload: string;
+    ts: string;
+}
+export interface ParsedSessionMeta {
+    model?: string;
+    cwd?: string;
+    gitRoot?: string;
+    branch?: string;
+    repository?: string;
+}
+/**
+ * Parse a Copilot SDK events.jsonl file into Kraki protocol messages.
+ * Returns up to MAX_BACKFILL_MESSAGES most recent messages and session metadata.
+ */
+export declare function parseEventsFile(eventsPath: string): {
+    messages: BackfilledMessage[];
+    meta: ParsedSessionMeta;
+};
+/**
+ * Parse events.jsonl from a session directory.
+ */
+export declare function parseSessionHistory(sessionDir: string): {
+    messages: BackfilledMessage[];
+    meta: ParsedSessionMeta;
+};

package/dist/history-parser.js

@@ -0,0 +1,190 @@
+/**
+ * History parser — converts Copilot SDK events.jsonl into Kraki protocol messages.
+ *
+ * Used during import to backfill conversation history so the arm can display
+ * the full session context from before Kraki attached.
+ *
+ * Reads events.jsonl line by line (streaming) to handle large files.
+ * Caps output at MAX_BACKFILL_MESSAGES most recent messages.
+ */
+import { existsSync, openSync, readSync, closeSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { createLogger } from './logger.js';
+const logger = createLogger('history-parser');
+/** Max messages to backfill from events.jsonl (most recent kept). */
+const MAX_BACKFILL_MESSAGES = 500;
+// ── Parser ──────────────────────────────────────────────
+/**
+ * Parse a Copilot SDK events.jsonl file into Kraki protocol messages.
+ * Returns up to MAX_BACKFILL_MESSAGES most recent messages and session metadata.
+ */
+export function parseEventsFile(eventsPath) {
+    if (!existsSync(eventsPath)) {
+        return { messages: [], meta: {} };
+    }
+    const messages = [];
+    const meta = {};
+    let seq = 0;
+    // Stream line by line using a buffer to handle large files
+    const content = readFileChunked(eventsPath);
+    for (const line of content.split('\n')) {
+        if (!line.trim())
+            continue;
+        let event;
+        try {
+            event = JSON.parse(line);
+        }
+        catch {
+            continue; // skip corrupt lines
+        }
+        const ts = event.timestamp ?? new Date().toISOString();
+        const converted = convertEvent(event, ts, meta);
+        if (converted) {
+            seq++;
+            messages.push({ seq, ...converted });
+        }
+    }
+    // Keep only the most recent messages
+    if (messages.length > MAX_BACKFILL_MESSAGES) {
+        const trimmed = messages.slice(messages.length - MAX_BACKFILL_MESSAGES);
+        // Re-number seq starting from 1
+        for (let i = 0; i < trimmed.length; i++) {
+            trimmed[i].seq = i + 1;
+        }
+        return { messages: trimmed, meta };
+    }
+    return { messages, meta };
+}
+/**
+ * Parse events.jsonl from a session directory.
+ */
+export function parseSessionHistory(sessionDir) {
+    return parseEventsFile(join(sessionDir, 'events.jsonl'));
+}
+// ── Event conversion ────────────────────────────────────
+function convertEvent(event, ts, meta) {
+    switch (event.type) {
+        case 'session.start': {
+            // Extract metadata, don't emit a message
+            const ctx = event.data.context;
+            if (event.data.selectedModel)
+                meta.model = event.data.selectedModel;
+            if (ctx?.cwd)
+                meta.cwd = ctx.cwd;
+            if (ctx?.gitRoot)
+                meta.gitRoot = ctx.gitRoot;
+            if (ctx?.branch)
+                meta.branch = ctx.branch;
+            if (ctx?.repository)
+                meta.repository = ctx.repository;
+            return null;
+        }
+        case 'user.message': {
+            const content = event.data.content ?? '';
+            // Use transformedContent if available (has system context stripped)
+            return {
+                type: 'user_message',
+                payload: JSON.stringify({ content }),
+                ts,
+            };
+        }
+        case 'assistant.message': {
+            const content = event.data.content ?? '';
+            if (!content)
+                return null; // skip empty messages (SDK sends these before tool calls)
+            return {
+                type: 'agent_message',
+                payload: JSON.stringify({ content }),
+                ts,
+            };
+        }
+        case 'tool.execution_start': {
+            const toolName = event.data.toolName ?? 'unknown';
+            const args = (event.data.arguments ?? event.data.args ?? {});
+            const toolCallId = event.data.toolCallId;
+            return {
+                type: 'tool_start',
+                payload: JSON.stringify({ toolName, args, toolCallId }),
+                ts,
+            };
+        }
+        case 'tool.execution_complete': {
+            const toolName = event.data.toolName ?? 'unknown';
+            const toolCallId = event.data.toolCallId;
+            const success = event.data.success;
+            const rawResult = event.data.result;
+            const resultObj = typeof rawResult === 'object' && rawResult !== null
+                ? rawResult
+                : null;
+            const result = resultObj?.content
+                ?? (typeof rawResult === 'string' ? rawResult : (event.data.output ?? ''));
+            // Extract model from the first tool completion that has it
+            if (!meta.model && event.data.model) {
+                meta.model = event.data.model;
+            }
+            return {
+                type: 'tool_complete',
+                payload: JSON.stringify({
+                    toolName,
+                    args: {},
+                    result: result.slice(0, 5000), // Cap result size for backfill
+                    toolCallId,
+                    success,
+                }),
+                ts,
+            };
+        }
+        case 'assistant.turn_end': {
+            return {
+                type: 'idle',
+                payload: JSON.stringify({}),
+                ts,
+            };
+        }
+        // Skip events that don't map to Kraki messages
+        case 'assistant.message_delta':
+        case 'assistant.turn_start':
+        case 'hook.start':
+        case 'hook.end':
+        case 'subagent.started':
+        case 'session.idle':
+        case 'session.shutdown':
+        case 'session.info':
+        case 'session.warning':
+        case 'session.task_complete':
+        case 'assistant.usage':
+        case 'session.title_changed':
+            return null;
+        default:
+            // Unknown event type — skip
+            return null;
+    }
+}
+// ── File reading helper ─────────────────────────────────
+function readFileChunked(filePath) {
+    // For files under 10MB, just read the whole thing
+    const stat = statSync(filePath);
+    if (stat.size <= 10 * 1024 * 1024) {
+        const fd = openSync(filePath, 'r');
+        const buf = Buffer.alloc(stat.size);
+        readSync(fd, buf, 0, stat.size, 0);
+        closeSync(fd);
+        return buf.toString('utf8');
+    }
+    // For larger files, read in chunks
+    logger.info({ filePath, size: stat.size }, 'Large events.jsonl — reading in chunks');
+    const fd = openSync(filePath, 'r');
+    const chunks = [];
+    const chunkSize = 1024 * 1024; // 1MB chunks
+    let offset = 0;
+    while (offset < stat.size) {
+        const readSize = Math.min(chunkSize, stat.size - offset);
+        const buf = Buffer.alloc(readSize);
+        readSync(fd, buf, 0, readSize, offset);
+        chunks.push(buf);
+        offset += readSize;
+    }
+    closeSync(fd);
+    return Buffer.concat(chunks).toString('utf8');
+}
+//# sourceMappingURL=history-parser.js.map

package/dist/history-parser.js.map

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

package/dist/index.d.ts

@@ -2,7 +2,11 @@ export { AgentAdapter, CopilotAdapter, parsePermission } from './adapters/index.
 export type { CreateSessionConfig, SessionInfo, PermissionDecision, SessionCreatedEvent, MessageEvent, MessageDeltaEvent, PermissionRequestEvent, QuestionRequestEvent, ToolStartEvent, ToolCompleteEvent, SessionEndedEvent, ErrorEvent, ParsedPermission, } from './adapters/index.js';
 export { loadConfig, saveConfig, configExists, getOrCreateDeviceId } from './config.js';
 export { SessionManager } from './session-manager.js';
-export type { SessionContext, SessionMeta, RunRecord, LoggedMessage } from './session-manager.js';
+export type { SessionContext, SessionMeta, RunRecord, LoggedMessage, SessionLink } from './session-manager.js';
 export { RelayClient } from './relay-client.js';
 export type { RelayClientOptions, RelayClientState } from './relay-client.js';
 export { KeyManager } from './key-manager.js';
+export { scanLocalSessions, filterSessions } from './session-scanner.js';
+export type { ScanOptions, SessionFilter } from './session-scanner.js';
+export { parseEventsFile, parseSessionHistory } from './history-parser.js';
+export type { BackfilledMessage, ParsedSessionMeta } from './history-parser.js';

package/dist/index.js

@@ -8,4 +8,6 @@ export { loadConfig, saveConfig, configExists, getOrCreateDeviceId } from './con
 export { SessionManager } from './session-manager.js';
 export { RelayClient } from './relay-client.js';
 export { KeyManager } from './key-manager.js';
+export { scanLocalSessions, filterSessions } from './session-scanner.js';
+export { parseEventsFile, parseSessionHistory } from './history-parser.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,0DAA0D;AAC1D,+DAA+D;AAC/D,0CAA0C;AAE1C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAkBpF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,0DAA0D;AAC1D,+DAA+D;AAC/D,0CAA0C;AAE1C,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAkBpF,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/relay-client.d.ts

@@ -90,6 +90,8 @@ export declare class RelayClient {
     private handleConsumerMessage;
     private handleCreateSession;
     private handleForkSession;
+    private handleRequestLocalSessions;
+    private handleImportSession;
     /**
      * Process queued unicast envelopes delivered by the relay in auth_ok.
      * These are messages sent by arms while this tentacle was offline.

package/dist/relay-client.js

@@ -8,7 +8,10 @@
 import { WebSocket } from 'ws';
 import { appendFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { homedir } from 'node:os';
 import { importPublicKey, encryptToBlob, decryptFromBlob, signChallenge } from '@kraki/crypto';
+import { scanLocalSessions, filterSessions } from './session-scanner.js';
+import { parseSessionHistory } from './history-parser.js';
 import { createLogger } from './logger.js';
 import { getKrakiHome } from './config.js';
 const logger = createLogger('relay-client');
@@ -310,6 +313,15 @@ export class RelayClient {
             this.handleClientLog(msg.deviceId, payload?.entries);
             return;
         }
+        // ── Local session sync (no sessionId) ────────────────
+        if (msg.type === 'request_local_sessions') {
+            this.handleRequestLocalSessions(msg);
+            return;
+        }
+        if (msg.type === 'import_session') {
+            this.handleImportSession(msg);
+            return;
+        }
         const sessionId = msg.sessionId;
         if (!sessionId)
             return;
@@ -366,6 +378,7 @@ export class RelayClient {
                     this.adapter.killSession(sessionId)
                         .catch((err) => logger.error({ err, sessionId }, 'killSession on delete failed'))
                         .finally(() => {
+                        this.sessionManager.removeLinkByKrakiId(sessionId);
                         this.sessionManager.deleteSession(sessionId);
                         this.lastAgentContent.delete(sessionId);
                         this.send({ type: 'session_deleted', sessionId, payload: {} });
@@ -512,6 +525,154 @@ export class RelayClient {
             });
         }
     }
+    // ── Local session sync handlers ───────────────────────
+    handleRequestLocalSessions(msg) {
+        if (msg.type !== 'request_local_sessions')
+            return;
+        const { requestId, filter } = msg.payload;
+        const requesterDeviceId = msg.deviceId;
+        const requesterKey = this.consumerKeys.get(requesterDeviceId);
+        try {
+            let sessions = scanLocalSessions();
+            const linkedIds = this.sessionManager.getLinkedIds();
+            // Mark sessions that are already linked
+            for (const s of sessions) {
+                const link = this.sessionManager.getLink(s.sessionId);
+                if (link)
+                    s.linkedKrakiSessionId = link.krakiSessionId;
+            }
+            // Exclude sessions that Kraki already manages (created natively, not imported)
+            const krakiSessionIds = new Set(this.sessionManager.getSessionList().map(s => s.id));
+            sessions = sessions.filter(s => !krakiSessionIds.has(s.sessionId) || s.linkedKrakiSessionId);
+            // Apply filters
+            if (filter) {
+                sessions = filterSessions(sessions, filter, linkedIds);
+            }
+            const response = {
+                type: 'local_sessions_list',
+                deviceId: this.authInfo?.deviceId ?? '',
+                seq: ++this.seqCounter,
+                timestamp: new Date().toISOString(),
+                payload: { sessions, requestId },
+            };
+            if (requesterKey) {
+                this.sendUnicastTo(requesterDeviceId, requesterKey, response);
+            }
+            else {
+                // No encryption key — broadcast (works in open/non-E2E mode)
+                this.send(response);
+            }
+            logger.debug({ count: sessions.length, requestId }, 'Sent local sessions list');
+        }
+        catch (err) {
+            logger.error({ err }, 'Failed to scan local sessions');
+            const response = {
+                type: 'local_sessions_list',
+                deviceId: this.authInfo?.deviceId ?? '',
+                seq: ++this.seqCounter,
+                timestamp: new Date().toISOString(),
+                payload: { sessions: [], requestId },
+            };
+            if (requesterKey) {
+                this.sendUnicastTo(requesterDeviceId, requesterKey, response);
+            }
+            else {
+                this.send(response);
+            }
+        }
+    }
+    async handleImportSession(msg) {
+        if (msg.type !== 'import_session')
+            return;
+        const { requestId, localSessionId } = msg.payload;
+        // Check if already linked
+        const existing = this.sessionManager.getLink(localSessionId);
+        if (existing) {
+            this.send({
+                type: 'error',
+                sessionId: '',
+                payload: { message: `Session already imported as ${existing.krakiSessionId} (requestId: ${requestId})` },
+            });
+            return;
+        }
+        try {
+            // Use localSessionId as Kraki session ID (shared identity)
+            const krakiSessionId = localSessionId;
+            // Parse events.jsonl for backfill
+            const sessionStateDir = join(homedir(), '.copilot', 'session-state', localSessionId);
+            const { messages: backfilledMessages, meta: parsedMeta } = parseSessionHistory(sessionStateDir);
+            // Scan to get local session metadata
+            const scanResults = scanLocalSessions();
+            const localSession = scanResults.find(s => s.sessionId === localSessionId);
+            // Create Kraki session
+            this.sessionManager.createSession('copilot', parsedMeta.model ?? localSession?.model, krakiSessionId);
+            // Persist source, title, model, and original creation time
+            this.sessionManager.updateMeta(krakiSessionId, {
+                source: localSession?.source ?? 'copilot-cli',
+                autoTitle: localSession?.summary?.slice(0, 100),
+                model: parsedMeta.model ?? localSession?.model,
+                createdAt: localSession?.startTime,
+            });
+            // Backfill messages
+            for (const m of backfilledMessages) {
+                this.sessionManager.appendMessage(krakiSessionId, m.type, m.payload);
+            }
+            // Write link table entry
+            this.sessionManager.addLink({
+                localSessionId,
+                krakiSessionId,
+                source: localSession?.source ?? 'copilot-cli',
+                cwd: localSession?.cwd,
+                branch: localSession?.branch,
+                linkedAt: new Date().toISOString(),
+            });
+            // Map requestId for session_created correlation
+            if (requestId) {
+                this.pendingRequestIds.set(krakiSessionId, requestId);
+            }
+            // Resume the session via SDK. Use createSession with the existing sessionId
+            // so the CLI server discovers the state on disk. resumeSession only works
+            // for sessions the CLI server has already loaded in memory.
+            const cwd = localSession?.cwd ?? parsedMeta.cwd ?? '/';
+            try {
+                await this.adapter.createSession({
+                    sessionId: krakiSessionId,
+                    model: parsedMeta.model,
+                    cwd,
+                });
+            }
+            catch (createErr) {
+                // SDK resume failed — still keep backfilled history, but manually
+                // send session_created so the web UI knows the session exists.
+                logger.warn({ err: createErr.message, krakiSessionId }, 'SDK resume failed — session imported as idle');
+                const meta = this.sessionManager.getMeta(krakiSessionId);
+                this.send({
+                    type: 'session_created',
+                    sessionId: krakiSessionId,
+                    payload: {
+                        agent: 'copilot',
+                        model: parsedMeta.model ?? localSession?.model,
+                        requestId,
+                        lastSeq: meta?.lastSeq ?? 0,
+                    },
+                });
+                if (requestId)
+                    this.pendingRequestIds.delete(krakiSessionId);
+            }
+            // Mark idle — will transition to active when user sends a message
+            this.sessionManager.markIdle(krakiSessionId);
+            this.send({ type: 'idle', sessionId: krakiSessionId, payload: {} });
+            logger.info({ localSessionId, krakiSessionId, backfilled: backfilledMessages.length }, 'Session imported');
+        }
+        catch (err) {
+            logger.error({ err, localSessionId }, 'Import session failed');
+            this.send({
+                type: 'error',
+                sessionId: '',
+                payload: { message: `Failed to import session: ${err.message} (requestId: ${requestId})` },
+            });
+        }
+    }
     // ── Pending message processing ─────────────────────
     /**
      * Process queued unicast envelopes delivered by the relay in auth_ok.