0xkobold 0.5.2 → 0.6.0

package/dist/src/memory/session-resume.js

@@ -0,0 +1,265 @@
+/**
+ * Session Resume System
+ *
+ * Allows searching and resuming previous sessions.
+ * Auto-saves sessions on shutdown.
+ * Suggests relevant past sessions on startup.
+ */
+import { eventBus } from "../event-bus";
+import { getSessionStore } from "./session-store";
+import { getSessionMemoryBridge } from "./session-memory-bridge";
+class SessionResumeSystem {
+    store = getSessionStore();
+    bridge = getSessionMemoryBridge();
+    currentSessionKey;
+    shutdownInProgress = false;
+    constructor() {
+        console.log("[SessionResume] Initializing...");
+        this.setupShutdownHandlers();
+        this.setupEventListeners();
+    }
+    /**
+     * Setup graceful shutdown handlers
+     */
+    setupShutdownHandlers() {
+        // Ctrl+C (SIGINT)
+        process.on("SIGINT", async () => {
+            console.log("\n[SIGINT] Graceful shutdown...");
+            await this.performGracefulShutdown();
+            process.exit(0);
+        });
+        // SIGTERM (Docker kill, etc)
+        process.on("SIGTERM", async () => {
+            console.log("\n[SIGTERM] Graceful shutdown...");
+            await this.performGracefulShutdown();
+            process.exit(0);
+        });
+        // Before exit (last resort)
+        process.on("exit", (code) => {
+            if (!this.shutdownInProgress && this.currentSessionKey) {
+                console.log("[SessionResume] Emergency save on exit...");
+                // Synchronous fallback - can't use async here
+                try {
+                    const fs = require("fs");
+                    const path = require("path");
+                    const os = require("os");
+                    const dumpPath = path.join(os.homedir(), ".0xkobold", "emergency-sessions.json");
+                    const sessions = this.store.list().map(k => ({ key: k, saved: Date.now() }));
+                    fs.writeFileSync(dumpPath, JSON.stringify(sessions, null, 2));
+                }
+                catch { }
+            }
+        });
+    }
+    /**
+     * Graceful shutdown - save current session
+     */
+    async performGracefulShutdown() {
+        if (this.shutdownInProgress)
+            return;
+        this.shutdownInProgress = true;
+        try {
+            if (this.currentSessionKey) {
+                console.log(`[SessionResume] Saving session ${this.currentSessionKey.slice(0, 8)}...`);
+                await this.saveSessionToPerennial(this.currentSessionKey, "shutdown");
+            }
+            // Also save all active sessions
+            const activeSessions = this.store.getActiveSessions();
+            for (const session of activeSessions) {
+                if (session.messageCount > 0) {
+                    await this.saveSessionToPerennial(session.sessionKey, "shutdown-batch");
+                }
+            }
+            console.log(`[SessionResume] Saved ${activeSessions.length} active sessions`);
+        }
+        catch (err) {
+            console.error("[SessionResume] Shutdown save failed:", err);
+        }
+    }
+    /**
+     * Setup event listeners
+     */
+    setupEventListeners() {
+        // Track current session
+        eventBus.on("gateway.session_connected", async (event) => {
+            const { sessionKey } = event.payload;
+            this.currentSessionKey = sessionKey;
+            console.log(`[SessionResume] Now tracking session: ${sessionKey.slice(0, 8)}`);
+        });
+        // When session disconnects
+        eventBus.on("gateway.session_disconnected", async (event) => {
+            const { sessionKey } = event.payload;
+            if (this.currentSessionKey === sessionKey) {
+                await this.saveSessionToPerennial(sessionKey, "disconnect");
+                this.currentSessionKey = undefined;
+            }
+        });
+    }
+    /**
+     * Save session summary to perennial memory
+     */
+    async saveSessionToPerennial(sessionKey, reason) {
+        const session = this.store.get(sessionKey);
+        if (!session || session.messageCount === 0)
+            return;
+        const enriched = await this.bridge.getEnrichedSession(sessionKey);
+        if (!enriched)
+            return;
+        // Build summary
+        const summary = enriched.conversationSummary || `Session with ${session.messageCount} messages`;
+        const content = `[Session ${reason}] ${sessionKey.slice(0, 8)}: ${summary}`;
+        // Emit to perennial
+        eventBus.emit("perennial.save", {
+            content,
+            category: "context",
+            tags: ["session-summary", `reason-${reason}`, `thread-${session.memoryThreadId}`],
+            importance: Math.min(0.9, 0.5 + session.messageCount * 0.01),
+            project: "0xKobold",
+        });
+        // Also save thread summary
+        eventBus.emit("perennial.save", {
+            content: `Conversation thread ${session.memoryThreadId}: ${summary}`,
+            category: "context",
+            tags: ["conversation-thread", `session-${sessionKey.slice(0, 8)}`],
+            importance: 0.7,
+            project: "0xKobold",
+        });
+        console.log(`[SessionResume] Saved session ${sessionKey.slice(0, 8)} (${session.messageCount} msgs)`);
+    }
+    /**
+     * Search through all sessions
+     */
+    async searchSessions(query, options = {}) {
+        const { limit = 10, includeInactive = true } = options;
+        // Get all sessions
+        const allSessions = includeInactive
+            ? this.store.list().map(k => this.store.get(k)).filter(Boolean)
+            : this.store.getActiveSessions();
+        // Score each session
+        const scored = await Promise.all(allSessions.map(async (session) => {
+            const enriched = await this.bridge.getEnrichedSession(session.sessionKey);
+            // Calculate relevance
+            const searchText = [
+                session.conversationSummary,
+                enriched?.conversationSummary,
+                ...enriched?.recentMemories.map(m => m.content) || [],
+            ].join(" ");
+            const relevanceScore = this.calculateRelevance(searchText, query);
+            return {
+                sessionKey: session.sessionKey,
+                memoryThreadId: session.memoryThreadId || "unknown",
+                lastActive: new Date(session.updatedAt).toISOString(),
+                messageCount: session.messageCount,
+                summary: session.conversationSummary,
+                relevanceScore,
+                preview: searchText.slice(0, 200) + "...",
+            };
+        }));
+        // Sort by relevance and return top
+        return scored
+            .filter(s => s.relevanceScore > 0.1)
+            .sort((a, b) => b.relevanceScore - a.relevanceScore)
+            .slice(0, limit);
+    }
+    /**
+     * Get resume suggestions for new session
+     */
+    async getResumeSuggestions(currentContext) {
+        // Get recent active sessions (not current)
+        const activeSessions = this.store.getActiveSessions()
+            .filter(s => s.sessionKey !== this.currentSessionKey)
+            .filter(s => s.messageCount > 0)
+            .slice(0, 5);
+        const suggestions = [];
+        for (const session of activeSessions) {
+            const enriched = await this.bridge.getEnrichedSession(session.sessionKey);
+            const lastMessage = session.conversationSummary?.split("\n").pop() || "Previous conversation";
+            const timeAgo = this.formatTimeAgo(session.updatedAt);
+            let reason = `Last active ${timeAgo}`;
+            if (currentContext && enriched?.conversationSummary) {
+                const relevance = this.calculateRelevance(enriched.conversationSummary, currentContext);
+                if (relevance > 0.3) {
+                    reason = `Related to current topic (${Math.round(relevance * 100)}% match)`;
+                }
+            }
+            suggestions.push({
+                sessionKey: session.sessionKey,
+                reason,
+                lastMessage: lastMessage.slice(0, 100),
+                timeAgo,
+            });
+        }
+        return suggestions;
+    }
+    /**
+     * Resume a session by key or thread ID
+     */
+    async resumeSession(identifier) {
+        // Try as session key first
+        let session = this.store.get(identifier);
+        // Try as memory thread ID
+        if (!session) {
+            session = this.store.getByMemoryThread(identifier);
+        }
+        // Try partial match
+        if (!session) {
+            const all = this.store.list();
+            const partial = all.find(k => k.includes(identifier) || identifier.includes(k));
+            if (partial) {
+                session = this.store.get(partial);
+            }
+        }
+        if (!session) {
+            return { success: false, error: "Session not found" };
+        }
+        // Get full context
+        const context = await this.bridge.getMemoryContext(session.sessionKey);
+        const enriched = await this.bridge.getEnrichedSession(session.sessionKey);
+        // Build resume context
+        const resumeContext = [
+            `Resuming session ${session.sessionKey.slice(0, 8)}...`,
+            enriched?.conversationSummary ? `Previous: ${enriched.conversationSummary.slice(0, 500)}` : null,
+            enriched?.recentMemories?.length ?
+                `Recent memories:\n${enriched.recentMemories.slice(-5).map(m => `- ${m.content.slice(0, 80)}`).join("\n")}` : null,
+        ].filter(Boolean).join("\n\n");
+        return {
+            success: true,
+            sessionKey: session.sessionKey,
+            context: resumeContext,
+        };
+    }
+    /**
+     * Get current session stats
+     */
+    getCurrentSessionStats() {
+        const active = this.store.getActiveSessions();
+        return {
+            activeSessions: active.length,
+            currentSession: this.currentSessionKey?.slice(0, 8),
+            totalMessages: active.reduce((sum, s) => sum + s.messageCount, 0),
+        };
+    }
+    // Private helpers
+    calculateRelevance(text, query) {
+        const textWords = new Set(text.toLowerCase().split(/\s+/));
+        const queryWords = new Set(query.toLowerCase().split(/\s+/));
+        const intersection = [...queryWords].filter(w => textWords.has(w));
+        return intersection.length / Math.max(queryWords.size, 1);
+    }
+    formatTimeAgo(timestamp) {
+        const seconds = Math.floor((Date.now() - timestamp) / 1000);
+        if (seconds < 60)
+            return `${seconds}s ago`;
+        if (seconds < 3600)
+            return `${Math.floor(seconds / 60)}m ago`;
+        if (seconds < 86400)
+            return `${Math.floor(seconds / 3600)}h ago`;
+        return `${Math.floor(seconds / 86400)}d ago`;
+    }
+}
+// Singleton
+const resumeSystem = new SessionResumeSystem();
+export function getSessionResumeSystem() {
+    return resumeSystem;
+}
+//# sourceMappingURL=session-resume.js.map

package/dist/src/memory/session-resume.js.map

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

package/dist/src/memory/session-store.js

@@ -0,0 +1,224 @@
+/**
+ * Session Store (Phase 2 + Phase 5)
+ *
+ * SQLite-based session persistence for gateway.
+ * Phase 5: Links to memory systems for conversation continuity.
+ */
+import { Database } from "bun:sqlite";
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { randomUUID } from "node:crypto";
+const DB_PATH = `${process.env.HOME || "~"}/.0xkobold/sessions.db`;
+let db = null;
+function getDb() {
+    if (db)
+        return db;
+    mkdirSync(dirname(DB_PATH), { recursive: true });
+    db = new Database(DB_PATH);
+    db.run(`
+    CREATE TABLE IF NOT EXISTS sessions (
+      session_key TEXT PRIMARY KEY,
+      session_id TEXT NOT NULL,
+      agent_id TEXT,
+      updated_at INTEGER NOT NULL,
+      created_at INTEGER NOT NULL,
+      model_override TEXT,
+      provider_override TEXT,
+      thinking_level TEXT,
+      verbose_level TEXT,
+      auth_profile_override TEXT,
+      skills_snapshot TEXT,
+      cli_session_ids TEXT,
+      spawned_by TEXT,
+      system_prompt_report TEXT,
+      -- Phase 5: Memory integration columns
+      memory_thread_id TEXT,
+      perennial_session_id TEXT,
+      user_profile_id TEXT,
+      last_run_id TEXT,
+      conversation_summary TEXT,
+      message_count INTEGER DEFAULT 0
+    )
+  `);
+    db.run(`
+    CREATE INDEX IF NOT EXISTS idx_sessions_updated 
+    ON sessions(updated_at)
+  `);
+    // Phase 5: Indexes for memory lookups
+    db.run(`
+    CREATE INDEX IF NOT EXISTS idx_sessions_memory_thread 
+    ON sessions(memory_thread_id)
+  `);
+    db.run(`
+    CREATE INDEX IF NOT EXISTS idx_sessions_user_profile 
+    ON sessions(user_profile_id)
+  `);
+    db.run(`
+    CREATE INDEX IF NOT EXISTS idx_sessions_perennial 
+    ON sessions(perennial_session_id)
+  `);
+    return db;
+}
+function rowToEntry(row) {
+    return {
+        sessionId: row.session_id,
+        sessionKey: row.session_key,
+        agentId: row.agent_id,
+        updatedAt: row.updated_at,
+        createdAt: row.created_at,
+        modelOverride: row.model_override,
+        providerOverride: row.provider_override,
+        thinkingLevel: row.thinking_level,
+        verboseLevel: row.verbose_level,
+        authProfileOverride: row.auth_profile_override,
+        skillsSnapshot: row.skills_snapshot ? JSON.parse(row.skills_snapshot) : undefined,
+        cliSessionIds: row.cli_session_ids ? JSON.parse(row.cli_session_ids) : undefined,
+        spawnedBy: row.spawned_by,
+        systemPromptReport: row.system_prompt_report
+            ? JSON.parse(row.system_prompt_report)
+            : undefined,
+        // Phase 5
+        memoryThreadId: row.memory_thread_id,
+        perennialSessionId: row.perennial_session_id,
+        userProfileId: row.user_profile_id,
+        lastRunId: row.last_run_id,
+        conversationSummary: row.conversation_summary,
+        messageCount: row.message_count || 0,
+    };
+}
+export function createSessionStore() {
+    const db = getDb();
+    const cache = new Map();
+    // Load existing sessions into cache
+    const rows = db.query("SELECT * FROM sessions").all();
+    for (const row of rows) {
+        const entry = rowToEntry(row);
+        cache.set(entry.sessionKey, entry);
+    }
+    return {
+        get(sessionKey) {
+            // Check cache first
+            const cached = cache.get(sessionKey);
+            if (cached)
+                return cached;
+            // Try database
+            const row = db
+                .query("SELECT * FROM sessions WHERE session_key = ?")
+                .get(sessionKey);
+            if (!row)
+                return undefined;
+            const entry = rowToEntry(row);
+            cache.set(sessionKey, entry);
+            return entry;
+        },
+        set(sessionKey, entry) {
+            cache.set(sessionKey, entry);
+            const now = Date.now();
+            db.run(`
+        INSERT INTO sessions (
+          session_key, session_id, agent_id, updated_at, created_at,
+          model_override, provider_override, thinking_level, verbose_level,
+          auth_profile_override, skills_snapshot, cli_session_ids, spawned_by, system_prompt_report,
+          memory_thread_id, perennial_session_id, user_profile_id, last_run_id,
+          conversation_summary, message_count
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(session_key) DO UPDATE SET
+          session_id = excluded.session_id,
+          agent_id = excluded.agent_id,
+          updated_at = excluded.updated_at,
+          model_override = excluded.model_override,
+          provider_override = excluded.provider_override,
+          thinking_level = excluded.thinking_level,
+          verbose_level = excluded.verbose_level,
+          auth_profile_override = excluded.auth_profile_override,
+          skills_snapshot = excluded.skills_snapshot,
+          cli_session_ids = excluded.cli_session_ids,
+          spawned_by = excluded.spawned_by,
+          system_prompt_report = excluded.system_prompt_report,
+          memory_thread_id = excluded.memory_thread_id,
+          perennial_session_id = excluded.perennial_session_id,
+          user_profile_id = excluded.user_profile_id,
+          last_run_id = excluded.last_run_id,
+          conversation_summary = excluded.conversation_summary,
+          message_count = excluded.message_count
+      `, [
+                sessionKey,
+                entry.sessionId,
+                entry.agentId ?? null,
+                now,
+                entry.createdAt ?? now,
+                entry.modelOverride ?? null,
+                entry.providerOverride ?? null,
+                entry.thinkingLevel ?? null,
+                entry.verboseLevel ?? null,
+                entry.authProfileOverride ?? null,
+                entry.skillsSnapshot ? JSON.stringify(entry.skillsSnapshot) : null,
+                entry.cliSessionIds ? JSON.stringify(entry.cliSessionIds) : null,
+                entry.spawnedBy ?? null,
+                entry.systemPromptReport ? JSON.stringify(entry.systemPromptReport) : null,
+                // Phase 5
+                entry.memoryThreadId ?? null,
+                entry.perennialSessionId ?? null,
+                entry.userProfileId ?? null,
+                entry.lastRunId ?? null,
+                entry.conversationSummary ?? null,
+                entry.messageCount ?? 0,
+            ]);
+        },
+        delete(sessionKey) {
+            cache.delete(sessionKey);
+            db.run("DELETE FROM sessions WHERE session_key = ?", [sessionKey]);
+        },
+        list() {
+            return Array.from(cache.keys());
+        },
+        cleanup(maxAgeMs) {
+            const cutoff = Date.now() - maxAgeMs;
+            // Remove from database
+            db.run("DELETE FROM sessions WHERE updated_at < ?", [cutoff]);
+            // Remove from cache
+            for (const [key, entry] of cache) {
+                if (entry.updatedAt < cutoff) {
+                    cache.delete(key);
+                }
+            }
+        },
+        // Phase 5: Memory-aware queries
+        getByMemoryThread(threadId) {
+            const row = db
+                .query("SELECT * FROM sessions WHERE memory_thread_id = ? LIMIT 1")
+                .get(threadId);
+            if (!row)
+                return undefined;
+            return rowToEntry(row);
+        },
+        getActiveSessions() {
+            const cutoff = Date.now() - 24 * 60 * 60 * 1000; // 24 hours
+            const rows = db
+                .query("SELECT * FROM sessions WHERE updated_at > ? ORDER BY updated_at DESC")
+                .all(cutoff);
+            return rows.map(rowToEntry);
+        },
+        getSessionsForUser(userProfileId) {
+            const rows = db
+                .query("SELECT * FROM sessions WHERE user_profile_id = ? ORDER BY updated_at DESC")
+                .all(userProfileId);
+            return rows.map(rowToEntry);
+        },
+    };
+}
+export function generateSessionId() {
+    return randomUUID();
+}
+// Global singleton
+let globalStore = null;
+export function getSessionStore() {
+    if (!globalStore) {
+        globalStore = createSessionStore();
+    }
+    return globalStore;
+}
+export function resetSessionStore() {
+    globalStore = null;
+}
+//# sourceMappingURL=session-store.js.map

package/dist/src/memory/session-store.js.map

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

package/dist/src/skills/framework.js

@@ -176,34 +176,122 @@ export function resetSkillRegistry() {
     registry = null;
 }
 /**
- * Install skill from source
+ * Install skill from source (local path, git URL, or tarball)
  */
 export async function installSkill(source, targetDir) {
     const skillsDir = targetDir || SKILL_DIRS[1];
     try {
         // Create skills directory if needed
         await fs.mkdir(skillsDir, { recursive: true });
-        // TODO(v0.5.1): Clone from git, extract from tarball, etc.
-        // For now, assume source is a local path
-        const skillName = path.basename(source);
-        const targetPath = path.join(skillsDir, skillName);
-        if (existsSync(targetPath)) {
-            return { success: false, message: `Skill ${skillName} already installed` };
-        }
-        // Simple copy for now
-        await fs.mkdir(targetPath, { recursive: true });
-        const files = await fs.readdir(source);
-        for (const file of files) {
-            const src = path.join(source, file);
-            const dest = path.join(targetPath, file);
-            await fs.copyFile(src, dest);
+        // Detect source type and install accordingly
+        if (source.startsWith('git+') || source.endsWith('.git') || source.includes('github.com') || source.includes('gitlab.com')) {
+            return await installFromGit(source, skillsDir);
+        }
+        else if (source.endsWith('.tar.gz') || source.endsWith('.tgz')) {
+            return await installFromTarball(source, skillsDir);
+        }
+        else {
+            // Local path copy
+            return await installFromLocal(source, skillsDir);
         }
-        return { success: true, message: `Installed ${skillName} to ${targetPath}` };
     }
     catch (error) {
         return { success: false, message: `Installation failed: ${error}` };
     }
 }
+/**
+ * Install skill from local directory
+ */
+async function installFromLocal(source, skillsDir) {
+    const skillName = path.basename(source);
+    const targetPath = path.join(skillsDir, skillName);
+    if (existsSync(targetPath)) {
+        return { success: false, message: `Skill ${skillName} already installed` };
+    }
+    await fs.mkdir(targetPath, { recursive: true });
+    const files = await fs.readdir(source);
+    for (const file of files) {
+        const src = path.join(source, file);
+        const dest = path.join(targetPath, file);
+        const stat = await fs.stat(src);
+        if (stat.isDirectory()) {
+            // Recursively copy directories (simple implementation)
+            await fs.mkdir(dest, { recursive: true });
+        }
+        else {
+            await fs.copyFile(src, dest);
+        }
+    }
+    return { success: true, message: `Installed ${skillName} from local path to ${targetPath}` };
+}
+/**
+ * Install skill from git repository
+ */
+async function installFromGit(repoUrl, skillsDir) {
+    const { execSync } = await import('child_process');
+    // Extract skill name from repo URL
+    const repoName = path.basename(repoUrl, '.git');
+    const targetPath = path.join(skillsDir, repoName);
+    if (existsSync(targetPath)) {
+        return { success: false, message: `Skill ${repoName} already installed` };
+    }
+    try {
+        // Clone the repository
+        console.log(`[Skills] Cloning ${repoUrl}...`);
+        execSync(`git clone "${repoUrl}" "${targetPath}"`, {
+            cwd: skillsDir,
+            timeout: 60000,
+            stdio: 'pipe'
+        });
+        return { success: true, message: `Installed ${repoName} from git to ${targetPath}` };
+    }
+    catch (error) {
+        // Clean up partial clone
+        if (existsSync(targetPath)) {
+            await fs.rm(targetPath, { recursive: true, force: true });
+        }
+        throw new Error(`Git clone failed: ${error.message}`);
+    }
+}
+/**
+ * Install skill from tarball
+ */
+async function installFromTarball(tarballPath, skillsDir) {
+    const { execSync } = await import('child_process');
+    const tarName = path.basename(tarballPath, '.tar.gz').replace('.tgz', '');
+    const extractDir = path.join(skillsDir, `__extract_${Date.now()}`);
+    try {
+        // Extract tarball
+        console.log(`[Skills] Extracting ${tarName}...`);
+        execSync(`tar -xzf "${tarballPath}" -C "${extractDir}"`, {
+            timeout: 30000,
+            stdio: 'pipe'
+        });
+        // Find the extracted directory (usually one subdir)
+        const entries = await fs.readdir(extractDir);
+        const skillDir = entries.find(e => !e.startsWith('.'));
+        if (!skillDir) {
+            throw new Error('No skill directory found in tarball');
+        }
+        const sourcePath = path.join(extractDir, skillDir);
+        const targetPath = path.join(skillsDir, skillDir);
+        if (existsSync(targetPath)) {
+            await fs.rm(extractDir, { recursive: true, force: true });
+            return { success: false, message: `Skill ${skillDir} already installed` };
+        }
+        // Move to final location
+        await fs.rename(sourcePath, targetPath);
+        await fs.rm(extractDir, { recursive: true, force: true });
+        return { success: true, message: `Installed ${skillDir} from tarball to ${targetPath}` };
+    }
+    catch (error) {
+        // Cleanup
+        if (existsSync(extractDir)) {
+            await fs.rm(extractDir, { recursive: true, force: true });
+        }
+        throw new Error(`Tarball extraction failed: ${error.message}`);
+    }
+}
 /**
  * Get skill marketplace (curated list)
  */