funolio-agent 0.12.2 → 0.13.0

package/dist/local-server.js

@@ -54,8 +54,17 @@ const local_funnel_1 = require("./local-funnel");
 const local_import_worker_1 = require("./local-import-worker");
 const clerk_model_1 = require("./clerk-model");
 const workflow_engine_1 = require("./workflow-engine");
+const context_window_1 = require("./context-window");
+const summarization_pipeline_1 = require("./summarization-pipeline");
+const backfill_1 = require("./backfill");
+const config_cleanup_1 = require("./config-cleanup");
 const status_parser_1 = require("./orchestration/status-parser");
 const guided_actions_1 = require("./orchestration/guided-actions");
+const topic_normalizer_1 = require("./orchestration/topic-normalizer");
+const manager_1 = require("./mcp/manager");
+const registry_1 = require("./mcp/registry");
+const marketplace_1 = require("./mcp/marketplace");
+const claude_config_writer_1 = require("./mcp/claude-config-writer");
 const chalk_1 = __importDefault(require("chalk"));
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
@@ -128,6 +137,16 @@ function startLocalServer(opts) {
     catch (err) {
         console.error(chalk_1.default.yellow(`  Failed to seed agent profiles: ${err}`));
     }
+    // Ensure there is always an "unassigned" project and no NULL project_id rows.
+    try {
+        const moved = data.moveNullConversationsToUnassigned();
+        if (moved.moved > 0) {
+            console.log(chalk_1.default.gray(`  Assigned ${moved.moved} conversation(s) to "${data.UNASSIGNED_PROJECT_NAME}"`));
+        }
+    }
+    catch (err) {
+        console.error(chalk_1.default.yellow(`  Failed to normalize unassigned conversations: ${err}`));
+    }
     // ─── Health ──────────────────────────────────────────────────
     app.get('/api/health', (_req, res) => {
         try {
@@ -294,6 +313,7 @@ function startLocalServer(opts) {
     // ─── Projects ──────────────────────────────────────────────
     app.get('/api/projects', (req, res) => {
         try {
+            data.moveNullConversationsToUnassigned();
             const projects = data.listProjects();
             if (req.query.include === 'conversations') {
                 const result = projects.map(p => {
@@ -337,6 +357,7 @@ function startLocalServer(opts) {
             const deleted = data.deleteProject(req.params.id);
             if (!deleted)
                 return res.status(404).json({ error: 'Not found' });
+            data.moveNullConversationsToUnassigned();
             res.json({ ok: true });
         }
         catch (err) {
@@ -481,6 +502,67 @@ function startLocalServer(opts) {
             res.status(500).json({ error: err.message });
         }
     });
+    // ─── Topic Operations (Phase 4) ────────────────────────────
+    /**
+     * GET /api/topics/:id/conversations — conversations linked via topic_segment
+     */
+    app.get('/api/topics/:id/conversations', (req, res) => {
+        try {
+            const limit = parseInt(req.query.limit, 10) || 50;
+            const offset = parseInt(req.query.offset, 10) || 0;
+            const convs = data.listTopicConversations(req.params.id, { limit, offset });
+            res.json(convs);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    /**
+     * POST /api/topics/:id/move — move topic to a different project
+     */
+    app.post('/api/topics/:id/move', (req, res) => {
+        try {
+            const { toProjectId } = req.body;
+            if (!toProjectId)
+                return res.status(400).json({ error: 'toProjectId required' });
+            const updated = data.moveTopic(req.params.id, toProjectId);
+            if (!updated)
+                return res.status(404).json({ error: 'Topic not found' });
+            res.json(updated);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    /**
+     * POST /api/topics/:id/merge — merge source topic into target
+     */
+    app.post('/api/topics/:id/merge', (req, res) => {
+        try {
+            const { targetTopicId } = req.body;
+            if (!targetTopicId)
+                return res.status(400).json({ error: 'targetTopicId required' });
+            data.mergeTopics(req.params.id, targetTopicId);
+            res.json({ ok: true });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    /**
+     * GET /api/conversations/:id/messages — paginated messages for a conversation
+     */
+    app.get('/api/conversations/:id/messages', (req, res) => {
+        try {
+            const limit = parseInt(req.query.limit, 10) || 25;
+            const offset = parseInt(req.query.offset, 10) || 0;
+            const msgs = data.getMessages(req.params.id, { limit, offset });
+            res.json(msgs);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
     // ─── File Upload ───────────────────────────────────────────
     app.post('/api/chat/upload', async (req, res) => {
         try {
@@ -565,6 +647,7 @@ function startLocalServer(opts) {
             // Save user message (skip if multi-bot call where first bot already saved it)
             if (!skipUserMessage) {
                 data.addMessage(convId, 'user', message);
+                (0, context_window_1.incrementTurnCount)(convId);
             }
             // Load conversation history
             const history = data.getMessages(convId, { limit: 100 });
@@ -577,9 +660,14 @@ function startLocalServer(opts) {
             let systemPrompt;
             const clerk = (0, clerk_model_1.getClerk)();
             if (clerk) {
-                const built = clerk.buildPrompt(message, profile.id, profile, { targetModel: profile.model });
+                const conv = data.getConversation(convId);
+                const built = clerk.buildPrompt(message, profile.id, profile, {
+                    targetModel: profile.model,
+                    conversationId: convId,
+                    projectName: conv?.project_name || undefined,
+                });
                 systemPrompt = built.systemPrompt;
-                console.log(chalk_1.default.gray(`  [clerk] Context: ${built.injectedFacts} facts, ${built.injectedDecisions} decisions (${built.contextTokensUsed} tokens)`));
+                console.log(chalk_1.default.gray(`  [clerk] Context: ${built.injectedFacts} facts, ${built.injectedDecisions} decisions, ${built.injectedSummaries} summaries (${built.contextTokensUsed} tokens)`));
             }
             else {
                 // Fallback: manual prompt building
@@ -710,6 +798,10 @@ function startLocalServer(opts) {
                 }
             }
             (0, local_funnel_1.scheduleFunnelProcessing)(convId);
+            // Summarization: trigger after every 5-turn boundary (fire-and-forget)
+            if ((0, context_window_1.shouldSummarize)(convId)) {
+                (0, summarization_pipeline_1.runSummarization)(convId).catch(err => console.error(chalk_1.default.yellow(`  [summarization] ${err.message}`)));
+            }
         }
         catch (err) {
             console.error(chalk_1.default.red(`Chat error: ${err.message}`));
@@ -728,16 +820,49 @@ function startLocalServer(opts) {
     // ─── Memory Facts ───────────────────────────────────────────
     app.get('/api/memory/facts', (req, res) => {
         try {
-            const { agentId, factType, limit, offset, search } = req.query;
+            const { agentId, factType, limit, offset, search, groupByProject } = req.query;
+            const limitN = limit ? parseInt(limit) : 100;
+            const offsetN = offset ? parseInt(offset) : 0;
+            const grouped = groupByProject === '1' || groupByProject === 'true';
+            if (grouped) {
+                const db = data.getDb();
+                const wheres = [];
+                const params = [];
+                if (agentId) {
+                    wheres.push('f.agent_id = ?');
+                    params.push(agentId);
+                }
+                if (factType) {
+                    wheres.push('f.fact_type = ?');
+                    params.push(factType);
+                }
+                if (search) {
+                    wheres.push('(f.content LIKE ? OR COALESCE(c.title, \'\') LIKE ?)');
+                    params.push(`%${search}%`, `%${search}%`);
+                }
+                let sql = `
+          SELECT f.*, c.title as conversation_title, c.project_id,
+                 COALESCE(p.name, '${data.UNASSIGNED_PROJECT_NAME}') as project_name
+          FROM memory_fact f
+          LEFT JOIN conversation c ON f.conversation_id = c.id
+          LEFT JOIN project p ON c.project_id = p.id
+        `;
+                if (wheres.length > 0)
+                    sql += ` WHERE ${wheres.join(' AND ')}`;
+                sql += ' ORDER BY f.created_at DESC LIMIT ? OFFSET ?';
+                params.push(limitN, offsetN);
+                const rows = db.prepare(sql).all(...params);
+                return res.json(rows);
+            }
             if (search && agentId) {
-                const facts = data.searchMemoryFacts(search, agentId, limit ? parseInt(limit) : 50);
+                const facts = data.searchMemoryFacts(search, agentId, limitN);
                 return res.json(facts);
             }
             const facts = data.listMemoryFacts({
                 agentId: agentId || undefined,
                 factType: factType || undefined,
-                limit: limit ? parseInt(limit) : undefined,
-                offset: offset ? parseInt(offset) : undefined,
+                limit: limitN,
+                offset: offsetN,
             });
             res.json(facts);
         }
@@ -770,7 +895,27 @@ function startLocalServer(opts) {
     });
     app.get('/api/memory/decisions', (req, res) => {
         try {
-            const { conversationId, limit } = req.query;
+            const { conversationId, limit, groupByProject } = req.query;
+            const grouped = groupByProject === '1' || groupByProject === 'true';
+            if (grouped) {
+                const db = data.getDb();
+                const params = [];
+                let sql = `
+          SELECT d.*, c.title as conversation_title, c.project_id,
+                 COALESCE(p.name, '${data.UNASSIGNED_PROJECT_NAME}') as project_name
+          FROM decision d
+          LEFT JOIN conversation c ON d.conversation_id = c.id
+          LEFT JOIN project p ON c.project_id = p.id
+        `;
+                if (conversationId) {
+                    sql += ' WHERE d.conversation_id = ?';
+                    params.push(conversationId);
+                }
+                sql += ' ORDER BY d.created_at DESC LIMIT ?';
+                params.push(limit ? parseInt(limit) : 200);
+                const rows = db.prepare(sql).all(...params);
+                return res.json(rows);
+            }
             const decisions = data.listDecisions({
                 conversationId: conversationId || undefined,
                 limit: limit ? parseInt(limit) : undefined,
@@ -781,9 +926,44 @@ function startLocalServer(opts) {
             res.status(500).json({ error: err.message });
         }
     });
+    app.delete('/api/memory/decisions/:id', (req, res) => {
+        try {
+            const deleted = data.deleteDecision(req.params.id);
+            if (!deleted)
+                return res.status(404).json({ error: 'Not found' });
+            res.json({ ok: true });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
     app.get('/api/memory/action-items', (req, res) => {
         try {
-            const { status, limit } = req.query;
+            const { status, limit, groupByProject } = req.query;
+            const grouped = groupByProject === '1' || groupByProject === 'true';
+            if (grouped) {
+                const db = data.getDb();
+                const params = [];
+                const wheres = [];
+                if (status) {
+                    wheres.push('a.status = ?');
+                    params.push(status);
+                }
+                let sql = `
+          SELECT a.*, c.title as conversation_title, c.project_id,
+                 COALESCE(p.name, '${data.UNASSIGNED_PROJECT_NAME}') as project_name
+          FROM action_item a
+          LEFT JOIN conversation c ON a.conversation_id = c.id
+          LEFT JOIN project p ON c.project_id = p.id
+        `;
+                if (wheres.length > 0) {
+                    sql += ` WHERE ${wheres.join(' AND ')}`;
+                }
+                sql += ' ORDER BY a.created_at DESC LIMIT ?';
+                params.push(limit ? parseInt(limit) : 200);
+                const rows = db.prepare(sql).all(...params);
+                return res.json(rows);
+            }
             const items = data.listActionItems({
                 status: status || undefined,
                 limit: limit ? parseInt(limit) : undefined,
@@ -794,6 +974,17 @@ function startLocalServer(opts) {
             res.status(500).json({ error: err.message });
         }
     });
+    app.delete('/api/memory/action-items/:id', (req, res) => {
+        try {
+            const deleted = data.deleteActionItem(req.params.id);
+            if (!deleted)
+                return res.status(404).json({ error: 'Not found' });
+            res.json({ ok: true });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
     // ─── Settings ───────────────────────────────────────────────
     app.get('/api/settings', (_req, res) => {
         try {
@@ -986,6 +1177,9 @@ function startLocalServer(opts) {
                         agentId: s.agentId,
                         instruction: s.instruction,
                         onStatus: s.onStatus,
+                        isCheckpoint: s.isCheckpoint,
+                        onFailStepIndex: s.onFailStepIndex,
+                        maxLoops: s.maxLoops,
                     });
                 }
             }
@@ -1031,7 +1225,7 @@ function startLocalServer(opts) {
     });
     app.post('/api/workflow-templates/:id/steps', (req, res) => {
         try {
-            const { agentId, instruction, onStatus, orderIndex } = req.body;
+            const { agentId, instruction, onStatus, orderIndex, isCheckpoint, onFailStepIndex, maxLoops } = req.body;
             if (!agentId)
                 return res.status(400).json({ error: 'agentId is required' });
             const step = data.addWorkflowTemplateStep({
@@ -1040,6 +1234,9 @@ function startLocalServer(opts) {
                 agentId,
                 instruction,
                 onStatus,
+                isCheckpoint,
+                onFailStepIndex,
+                maxLoops,
             });
             res.status(201).json(step);
         }
@@ -1082,6 +1279,259 @@ function startLocalServer(opts) {
             res.status(500).json({ error: err.message });
         }
     });
+    // ─── Project Extractions (decisions, facts, action items) ──
+    app.get('/api/projects/:id/extractions', (req, res) => {
+        try {
+            const projectId = req.params.id;
+            const { type } = req.query;
+            // Get all conversations for this project
+            const db = data.getDb();
+            const convIds = db.prepare('SELECT id FROM conversation WHERE project_id = ?').all(projectId);
+            if (convIds.length === 0) {
+                return res.json({ decisions: [], actionItems: [], facts: [], summaries: [] });
+            }
+            const ids = convIds.map(c => c.id);
+            const placeholders = ids.map(() => '?').join(',');
+            const result = {};
+            if (!type || type === 'decisions') {
+                result.decisions = db.prepare(`SELECT d.*, c.title as conversation_title FROM decision d
+           LEFT JOIN conversation c ON d.conversation_id = c.id
+           WHERE d.conversation_id IN (${placeholders})
+           ORDER BY d.created_at DESC`).all(...ids);
+            }
+            if (!type || type === 'actionItems') {
+                result.actionItems = db.prepare(`SELECT a.*, c.title as conversation_title FROM action_item a
+           LEFT JOIN conversation c ON a.conversation_id = c.id
+           WHERE a.conversation_id IN (${placeholders})
+           ORDER BY a.created_at DESC`).all(...ids);
+            }
+            if (!type || type === 'facts') {
+                result.facts = db.prepare(`SELECT f.*, c.title as conversation_title FROM memory_fact f
+           LEFT JOIN conversation c ON f.conversation_id = c.id
+           WHERE f.conversation_id IN (${placeholders})
+           ORDER BY f.created_at DESC`).all(...ids);
+            }
+            if (!type || type === 'summaries') {
+                result.summaries = db.prepare(`SELECT s.*, c.title as conversation_title FROM conversation_summary s
+           LEFT JOIN conversation c ON s.conversation_id = c.id
+           WHERE s.conversation_id IN (${placeholders})
+           ORDER BY s.created_at DESC`).all(...ids);
+            }
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // ─── Config Cleanup ─────────────────────────────────────────
+    app.post('/api/projects/:id/cleanup', async (req, res) => {
+        try {
+            const project = data.getProject(req.params.id);
+            if (!project)
+                return res.status(404).json({ error: 'Project not found' });
+            if (!project.folder)
+                return res.status(400).json({ error: 'Project has no folder configured' });
+            const result = await (0, config_cleanup_1.runConfigCleanup)(project.id, project.folder, { force: req.body?.force });
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // ─── Workflow Executions ────────────────────────────────────
+    app.get('/api/workflows/:id', (req, res) => {
+        try {
+            const exec = data.getWorkflowExecution(req.params.id);
+            if (!exec)
+                return res.status(404).json({ error: 'Workflow execution not found' });
+            res.json(exec);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    app.get('/api/conversations/:id/workflows', (req, res) => {
+        try {
+            const executions = data.listWorkflowExecutions({ conversationId: req.params.id, limit: 20 });
+            res.json(executions);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // ─── Backfill ──────────────────────────────────────────────
+    // Backfill runs detached from the HTTP request so it survives page navigation.
+    // The SSE endpoint streams progress while connected, but the backfill job
+    // continues in the background regardless.
+    let backfillJob = {
+        running: false, progress: null, result: null, error: null,
+    };
+    const launchBackfill = (projectHints, options) => {
+        if (backfillJob.running)
+            return;
+        backfillJob = { running: true, progress: null, result: null, error: null };
+        (0, backfill_1.backfillAll)((progress) => {
+            backfillJob.progress = progress;
+        }, projectHints, {
+            includeSummaries: options?.includeSummaries,
+            includeProjectCatalog: options?.includeProjectCatalog,
+        }).then((result) => {
+            backfillJob.result = result;
+            backfillJob.running = false;
+        }).catch((err) => {
+            backfillJob.error = err.message;
+            backfillJob.running = false;
+        });
+    };
+    // JSON status endpoint used by desktop polling fallback (Tauri HTTP can buffer SSE).
+    app.get('/api/backfill/status', (_req, res) => {
+        res.json(backfillJob);
+    });
+    // JSON start endpoint for polling clients.
+    app.post('/api/backfill/start', async (req, res) => {
+        try {
+            if (!(0, summarization_pipeline_1.isClerkConfigured)()) {
+                return res.status(400).json({
+                    error: 'Configure a clerk model in Settings → Orchestration before running backfill'
+                });
+            }
+            const projectHints = Array.isArray(req.body?.projectHints) ? req.body.projectHints : undefined;
+            launchBackfill(projectHints, {
+                includeSummaries: req.body?.includeSummaries === true,
+                includeProjectCatalog: req.body?.includeProjectCatalog !== false,
+            });
+            res.status(202).json({ ok: true, running: true });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    app.post('/api/backfill', async (req, res) => {
+        try {
+            if (!(0, summarization_pipeline_1.isClerkConfigured)()) {
+                return res.status(400).json({
+                    error: 'Configure a clerk model in Settings → Orchestration before running backfill'
+                });
+            }
+            if (backfillJob.running) {
+                // Already running — stream existing progress
+                res.writeHead(200, {
+                    'Content-Type': 'text/event-stream',
+                    'Cache-Control': 'no-cache',
+                    'Connection': 'keep-alive',
+                });
+                if (backfillJob.progress) {
+                    res.write(`event: progress\ndata: ${JSON.stringify(backfillJob.progress)}\n\n`);
+                }
+                // Don't end — keep SSE open for live updates
+                const interval = setInterval(() => {
+                    try {
+                        if (!backfillJob.running) {
+                            if (backfillJob.result) {
+                                res.write(`event: done\ndata: ${JSON.stringify(backfillJob.result)}\n\n`);
+                            }
+                            else if (backfillJob.error) {
+                                res.write(`event: error\ndata: ${JSON.stringify({ error: backfillJob.error })}\n\n`);
+                            }
+                            clearInterval(interval);
+                            res.end();
+                        }
+                        else if (backfillJob.progress) {
+                            res.write(`event: progress\ndata: ${JSON.stringify(backfillJob.progress)}\n\n`);
+                        }
+                    }
+                    catch {
+                        clearInterval(interval);
+                    }
+                }, 2000);
+                req.on('close', () => clearInterval(interval));
+                return;
+            }
+            const projectHints = Array.isArray(req.body?.projectHints) ? req.body.projectHints : undefined;
+            launchBackfill(projectHints, {
+                includeSummaries: req.body?.includeSummaries === true,
+                includeProjectCatalog: req.body?.includeProjectCatalog !== false,
+            });
+            // SSE for progress
+            res.writeHead(200, {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache',
+                'Connection': 'keep-alive',
+            });
+            let connected = true;
+            req.on('close', () => { connected = false; });
+            const sendEvent = (event, payload) => {
+                if (connected) {
+                    try {
+                        res.write(`event: ${event}\ndata: ${JSON.stringify(payload)}\n\n`);
+                    }
+                    catch {
+                        connected = false;
+                    }
+                }
+            };
+            if (backfillJob.progress) {
+                sendEvent('progress', backfillJob.progress);
+            }
+            const interval = setInterval(() => {
+                try {
+                    if (!backfillJob.running) {
+                        if (backfillJob.result) {
+                            sendEvent('done', backfillJob.result);
+                        }
+                        else if (backfillJob.error) {
+                            sendEvent('error', { error: backfillJob.error });
+                        }
+                        clearInterval(interval);
+                        if (connected) {
+                            try {
+                                res.end();
+                            }
+                            catch { }
+                        }
+                        return;
+                    }
+                    if (backfillJob.progress) {
+                        sendEvent('progress', backfillJob.progress);
+                    }
+                }
+                catch {
+                    clearInterval(interval);
+                }
+            }, 1000);
+            req.on('close', () => clearInterval(interval));
+        }
+        catch (err) {
+            backfillJob.running = false;
+            if (!res.headersSent) {
+                res.status(500).json({ error: err.message });
+            }
+        }
+    });
+    app.post('/api/backfill/test-one', async (req, res) => {
+        try {
+            if (!(0, summarization_pipeline_1.isClerkConfigured)()) {
+                return res.status(400).json({
+                    error: 'Configure a clerk model in Settings -> Orchestration before running backfill',
+                });
+            }
+            if (backfillJob.running) {
+                return res.status(409).json({ error: 'Backfill is currently running. Wait for completion before test-one.' });
+            }
+            const projectHints = Array.isArray(req.body?.projectHints) ? req.body.projectHints : undefined;
+            const conversationId = typeof req.body?.conversationId === 'string' && req.body.conversationId.trim()
+                ? req.body.conversationId.trim()
+                : undefined;
+            const result = await (0, backfill_1.backfillOne)(projectHints, conversationId, {
+                includeSummaries: req.body?.includeSummaries === true,
+                includeProjectCatalog: req.body?.includeProjectCatalog !== false,
+            });
+            res.json(result);
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
     // ─── Import ─────────────────────────────────────────────────
     app.post('/api/import/start', async (req, res) => {
         try {
@@ -1218,6 +1668,100 @@ function startLocalServer(opts) {
             res.status(500).json({ error: err.message });
         }
     });
+    // ─── MCP Marketplace ────────────────────────────────────────────
+    const mcpManager = new manager_1.MCPManager();
+    // Auto-launch persisted always-on servers
+    mcpManager.autoLaunch().catch((err) => {
+        console.error(chalk_1.default.yellow(`[MCP] Auto-launch error: ${err.message}`));
+    });
+    /**
+     * GET /api/mcp/catalog — full marketplace catalog with install status
+     */
+    app.get('/api/mcp/catalog', (_req, res) => {
+        try {
+            const catalog = (0, marketplace_1.buildMarketplaceCatalog)();
+            const running = new Set(mcpManager.getRunningServers());
+            const persisted = new Set(mcpManager.loadPersistedConfigs().map((c) => c.id));
+            const tools = catalog.map(({ entry, info }) => {
+                let status = 'not_installed';
+                if (running.has(entry.id)) {
+                    status = 'running';
+                }
+                else if (persisted.has(entry.id)) {
+                    status = 'installed';
+                }
+                return { entry, info, status, inClaudeConfig: (0, claude_config_writer_1.isInClaudeConfig)(entry.id) };
+            });
+            res.json({ tools, categories: marketplace_1.MARKETPLACE_CATEGORIES });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    /**
+     * POST /api/mcp/install — install + launch + configure Claude Code
+     */
+    app.post('/api/mcp/install', async (req, res) => {
+        try {
+            const { toolId, envVars, alwaysOn } = req.body;
+            if (!toolId)
+                return res.status(400).json({ error: 'toolId required' });
+            const entry = registry_1.BUILTIN_REGISTRY.find((e) => e.id === toolId);
+            if (!entry)
+                return res.status(404).json({ error: `Unknown tool: ${toolId}` });
+            // Install and launch via MCPManager
+            const tools = await mcpManager.installAndLaunch(entry, envVars || {}, alwaysOn ?? true);
+            // Configure Claude Code
+            (0, claude_config_writer_1.addMcpToClaudeConfig)(entry, envVars || {});
+            res.json({
+                ok: true,
+                toolId,
+                toolsDiscovered: tools.length,
+                inClaudeConfig: true,
+            });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    /**
+     * POST /api/mcp/uninstall — stop + remove persisted config + remove from Claude Code
+     */
+    app.post('/api/mcp/uninstall', async (req, res) => {
+        try {
+            const { toolId } = req.body;
+            if (!toolId)
+                return res.status(400).json({ error: 'toolId required' });
+            await mcpManager.uninstallServer(toolId);
+            (0, claude_config_writer_1.removeMcpFromClaudeConfig)(toolId);
+            res.json({ ok: true, toolId });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    /**
+     * GET /api/mcp/status — status map of all servers
+     */
+    app.get('/api/mcp/status', (_req, res) => {
+        try {
+            const running = mcpManager.getRunningServers();
+            const persisted = mcpManager.loadPersistedConfigs();
+            const status = {};
+            for (const config of persisted) {
+                const info = mcpManager.getServerInfo(config.id);
+                status[config.id] = {
+                    running: running.includes(config.id),
+                    alwaysOn: config.alwaysOn,
+                    toolCount: info?.tools.length ?? 0,
+                };
+            }
+            res.json({ status });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
     // Initialize workflow engine
     (0, workflow_engine_1.getWorkflowEngine)(opts.projectDir);
     // Start server
@@ -1281,44 +1825,38 @@ async function autoSuggestTopic(convId, projectId) {
         if (msgs.length < 3)
             return;
         const clerk = (0, clerk_model_1.getClerk)();
-        let topicTitle;
+        let rawTitle;
         if (clerk) {
             const transcript = msgs.slice(0, 4).map(m => `${m.role}: ${m.content.slice(0, 150)}`).join('\n');
             const clerkLlm = clerk.llm;
             const resp = await clerkLlm.chat({
-                messages: [{ role: 'user', content: `Generate a short topic name (2-5 words, no quotes) for this conversation:\n\n${transcript}` }],
-                system: 'You generate short topic names. Return ONLY the topic name, nothing else.',
+                messages: [{ role: 'user', content: `Generate a short topic name (2-3 words, no quotes) for this conversation:\n\n${transcript}` }],
+                system: 'You generate short topic names (2-3 words, title case). Return ONLY the topic name, nothing else.',
                 stream: false,
             });
-            topicTitle = resp?.content?.trim().slice(0, 60) || 'General';
+            rawTitle = resp?.content?.trim().slice(0, 60) || 'General';
         }
         else {
             // Heuristic: use first user message
             const firstUser = msgs.find(m => m.role === 'user');
-            topicTitle = firstUser ? firstUser.content.slice(0, 40).replace(/\n/g, ' ').trim() : 'General';
+            rawTitle = firstUser ? firstUser.content.slice(0, 40).replace(/\n/g, ' ').trim() : 'General';
         }
+        // Normalize for quality constraints
+        const topicTitle = (0, topic_normalizer_1.normalizeTopicTitle)(rawTitle) || rawTitle;
         // Check if a similar topic exists for this project
         const topics = data.listTopics({ projectId, limit: 100 });
-        const matchingTopic = topics.find(t => t.title.toLowerCase() === topicTitle.toLowerCase());
+        const matchingTopic = topics.find(t => t.title.toLowerCase() === topicTitle.toLowerCase() ||
+            (t.normalized_title && t.normalized_title === topicTitle.toLowerCase()));
         if (matchingTopic) {
-            // Link to existing topic
-            data.createTopicSegment({
-                topicId: matchingTopic.id,
-                conversationId: convId,
-                startSeq: 1,
-                endSeq: 999999,
-            });
+            // Idempotent link to existing topic
+            data.upsertConversationTopicSegment(convId, matchingTopic.id);
             data.updateTopic(matchingTopic.id, { messageCount: matchingTopic.message_count + msgs.length, lastActivityAt: new Date().toISOString() });
         }
         else {
-            // Create new topic
+            // Create new topic with normalized title
             const topic = data.createTopic({ title: topicTitle, projectId, isAuto: true });
-            data.createTopicSegment({
-                topicId: topic.id,
-                conversationId: convId,
-                startSeq: 1,
-                endSeq: 999999,
-            });
+            data.updateTopic(topic.id, { normalizedTitle: topicTitle.toLowerCase() });
+            data.upsertConversationTopicSegment(convId, topic.id);
         }
         console.log(chalk_1.default.gray(`  [topic] Auto-suggested: "${topicTitle}" for conv ${convId.slice(0, 8)}`));
     }