waymark-hub 1.0.0

package/dist/tools/memory.js

@@ -0,0 +1,273 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerMemoryTools = registerMemoryTools;
+const zod_1 = require("zod");
+const client_js_1 = require("../db/client.js");
+const crypto_1 = require("crypto");
+const memoryStatus = zod_1.z.enum(['active', 'superseded', 'stale', 'archived']);
+const feedbackRating = zod_1.z.enum([
+    'used',
+    'not_used',
+    'helpful',
+    'irrelevant',
+    'stale',
+    'incorrect',
+    'too_verbose',
+]);
+function registerMemoryTools(server) {
+    server.registerTool('memory_write', {
+        description: 'Create or replace a named memory node (project-scoped, or global if no project_id).',
+        inputSchema: zod_1.z.object({
+            project_id: zod_1.z.string().optional().describe('omit for global'),
+            name: zod_1.z.string().describe('kebab-case slug'),
+            description: zod_1.z.string().describe('one-line summary'),
+            type: zod_1.z.enum(['user', 'feedback', 'project', 'reference', 'handoff', 'decision'])
+                .default('project'),
+            body: zod_1.z.string().describe('markdown body'),
+            tags: zod_1.z.array(zod_1.z.string()).optional(),
+            surface: zod_1.z.string().default('claude-code'),
+            agent_id: zod_1.z.string().optional(),
+            origin_session: zod_1.z.string().optional(),
+            status: memoryStatus.optional(),
+            importance: zod_1.z.number().int().min(0).max(100).optional(),
+            confidence: zod_1.z.number().int().min(0).max(100).optional(),
+            source_type: zod_1.z.string().optional(),
+            source_ref: zod_1.z.string().optional(),
+            valid_from: zod_1.z.string().optional(),
+            valid_until: zod_1.z.string().optional(),
+            supersedes_id: zod_1.z.string().optional().describe('id this record replaces'),
+            last_verified_at: zod_1.z.string().optional(),
+        }),
+    }, ({ project_id, name, description, type, body, tags, surface, agent_id, origin_session, status, importance, confidence, source_type, source_ref, valid_from, valid_until, supersedes_id, last_verified_at, }) => {
+        const db = (0, client_js_1.getDb)();
+        const tagsJson = tags ? JSON.stringify(tags) : null;
+        const now = new Date().toISOString();
+        if (agent_id && !db.prepare('SELECT 1 FROM agents WHERE id = ?').get(agent_id)) {
+            return { content: [{ type: 'text', text: `Agent "${agent_id}" not found.` }], isError: true };
+        }
+        if (supersedes_id && !db.prepare('SELECT 1 FROM memory_nodes WHERE id = ?').get(supersedes_id)) {
+            return {
+                content: [{ type: 'text', text: `Memory node "${supersedes_id}" not found.` }],
+                isError: true,
+            };
+        }
+        const existing = db.prepare('SELECT id FROM memory_nodes WHERE name = ? AND (project_id = ? OR (project_id IS NULL AND ? IS NULL))').get(name, project_id ?? null, project_id ?? null);
+        if (existing) {
+            if (supersedes_id === existing.id) {
+                return { content: [{ type: 'text', text: 'A memory cannot supersede itself.' }], isError: true };
+            }
+            db.transaction(() => {
+                db.prepare(`
+            UPDATE memory_nodes SET
+              description = ?, type = ?, body = ?, tags = ?,
+              surface = ?, created_by_agent = COALESCE(?, created_by_agent),
+              origin_session = ?, status = COALESCE(?, status),
+              importance = COALESCE(?, importance),
+              confidence = COALESCE(?, confidence),
+              source_type = COALESCE(?, source_type),
+              source_ref = COALESCE(?, source_ref),
+              valid_from = COALESCE(?, valid_from),
+              valid_until = COALESCE(?, valid_until),
+              supersedes_id = COALESCE(?, supersedes_id),
+              last_verified_at = COALESCE(?, last_verified_at),
+              updated_at = ?
+            WHERE id = ?
+          `).run(description, type, body, tagsJson, surface, agent_id ?? null, origin_session ?? null, status ?? null, importance ?? null, confidence ?? null, source_type ?? null, source_ref ?? null, valid_from ?? null, valid_until ?? null, supersedes_id ?? null, last_verified_at ?? null, now, existing.id);
+                if (supersedes_id) {
+                    db.prepare("UPDATE memory_nodes SET status = 'superseded', updated_at = ? WHERE id = ?").run(now, supersedes_id);
+                }
+            })();
+            const row = db.prepare('SELECT * FROM memory_nodes WHERE id = ?').get(existing.id);
+            return { content: [{ type: 'text', text: JSON.stringify(row, null, 2) }] };
+        }
+        const id = (0, crypto_1.randomUUID)();
+        db.transaction(() => {
+            db.prepare(`
+          INSERT INTO memory_nodes
+            (
+              id, project_id, surface, name, description, type, body, tags,
+              origin_session, created_at, updated_at, created_by_agent,
+              status, importance, confidence, source_type, source_ref,
+              valid_from, valid_until, supersedes_id, last_verified_at
+            )
+          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        `).run(id, project_id ?? null, surface, name, description, type, body, tagsJson, origin_session ?? null, now, now, agent_id ?? null, status ?? 'active', importance ?? 50, confidence ?? 50, source_type ?? null, source_ref ?? null, valid_from ?? null, valid_until ?? null, supersedes_id ?? null, last_verified_at ?? null);
+            if (supersedes_id) {
+                db.prepare("UPDATE memory_nodes SET status = 'superseded', updated_at = ? WHERE id = ?").run(now, supersedes_id);
+            }
+        })();
+        const row = db.prepare('SELECT * FROM memory_nodes WHERE id = ?').get(id);
+        return { content: [{ type: 'text', text: JSON.stringify(row, null, 2) }] };
+    });
+    server.registerTool('memory_read', {
+        description: 'Read a single memory node by id or by project+name.',
+        inputSchema: zod_1.z.object({
+            id: zod_1.z.string().optional().describe('Memory node UUID'),
+            project_id: zod_1.z.string().optional(),
+            name: zod_1.z.string().optional().describe('Memory node name slug'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, ({ id, project_id, name }) => {
+        const db = (0, client_js_1.getDb)();
+        let row;
+        if (id) {
+            row = db.prepare('SELECT * FROM memory_nodes WHERE id = ?').get(id);
+        }
+        else if (name) {
+            row = db.prepare(`SELECT * FROM memory_nodes
+           WHERE name = ? AND (project_id = ? OR project_id IS NULL)
+           ORDER BY CASE WHEN project_id = ? THEN 0 ELSE 1 END
+           LIMIT 1`).get(name, project_id ?? null, project_id ?? null);
+        }
+        if (!row)
+            return { content: [{ type: 'text', text: 'Memory node not found.' }], isError: true };
+        return { content: [{ type: 'text', text: JSON.stringify(row, null, 2) }] };
+    });
+    server.registerTool('memory_list', {
+        description: 'List all memory nodes for a project. Omit project_id for global memory. ' +
+            'Returns name, description, type, surface, updated_at (not full body to save context).',
+        inputSchema: zod_1.z.object({
+            project_id: zod_1.z.string().optional().describe('Project id. Omit for global memory.'),
+            type: zod_1.z.enum(['user', 'feedback', 'project', 'reference', 'handoff', 'decision']).optional(),
+            status: memoryStatus.optional(),
+            include_body: zod_1.z.boolean().default(false).describe('Include full body in results (use sparingly)'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, ({ project_id, type, status, include_body }) => {
+        const db = (0, client_js_1.getDb)();
+        const cols = include_body
+            ? '*'
+            : `id, project_id, surface, name, description, type, tags,
+           status, importance, confidence, source_type, source_ref,
+           valid_from, valid_until, supersedes_id, last_verified_at,
+           created_by_agent, updated_at`;
+        let sql = `SELECT ${cols} FROM memory_nodes WHERE 1=1`;
+        const params = [];
+        if (project_id !== undefined) {
+            sql += ' AND project_id = ?';
+            params.push(project_id);
+        }
+        else {
+            sql += ' AND project_id IS NULL';
+        }
+        if (type) {
+            sql += ' AND type = ?';
+            params.push(type);
+        }
+        if (status) {
+            sql += ' AND status = ?';
+            params.push(status);
+        }
+        sql += ' ORDER BY updated_at DESC';
+        const rows = db.prepare(sql).all(...params);
+        return { content: [{ type: 'text', text: JSON.stringify(rows, null, 2) }] };
+    });
+    server.registerTool('memory_search', {
+        description: 'Full-text search across all memory nodes. Use to find anything known about a topic.',
+        inputSchema: zod_1.z.object({
+            query: zod_1.z.string().describe('Search terms'),
+            project_id: zod_1.z.string().optional().describe('Limit to a specific project. Omit to search all.'),
+            include_inactive: zod_1.z.boolean().default(false)
+                .describe('Include stale, superseded, archived, and expired records'),
+            limit: zod_1.z.number().int().min(1).max(50).default(10),
+        }),
+        annotations: { readOnlyHint: true },
+    }, ({ query, project_id, include_inactive, limit }) => {
+        const db = (0, client_js_1.getDb)();
+        let sql = `
+        SELECT m.id, m.project_id, m.surface, m.name, m.description, m.type, m.tags,
+               m.status, m.importance, m.confidence, m.source_type, m.source_ref,
+               m.updated_at,
+               snippet(memory_fts, 2, '[', ']', '...', 20) AS snippet
+        FROM memory_fts
+        JOIN memory_nodes m ON m.rowid = memory_fts.rowid
+        WHERE memory_fts MATCH ?
+      `;
+        const params = [query];
+        if (!include_inactive) {
+            sql += `
+          AND m.status = 'active'
+          AND (m.valid_from IS NULL OR m.valid_from <= ?)
+          AND (m.valid_until IS NULL OR m.valid_until >= ?)
+        `;
+            const now = new Date().toISOString();
+            params.push(now, now);
+        }
+        if (project_id) {
+            sql += ' AND m.project_id = ?';
+            params.push(project_id);
+        }
+        sql += ' ORDER BY rank LIMIT ?';
+        params.push(limit);
+        try {
+            const rows = db.prepare(sql).all(...params);
+            return { content: [{ type: 'text', text: JSON.stringify(rows, null, 2) }] };
+        }
+        catch {
+            return {
+                content: [{
+                        type: 'text',
+                        text: `FTS5 could not parse the query ${JSON.stringify(query)}. ` +
+                            'Use plain words ("auth token"), quoted phrases ("\\"session log\\""), or prefix search ("bench*"). ' +
+                            'Characters like -, :, ( ) are FTS operators — wrap terms containing them in double quotes.',
+                    }],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool('memory_set_status', {
+        description: 'Mark a memory record active, superseded, stale, or archived.',
+        inputSchema: zod_1.z.object({
+            id: zod_1.z.string(),
+            status: memoryStatus,
+            last_verified_at: zod_1.z.string().optional(),
+        }),
+    }, ({ id, status, last_verified_at }) => {
+        const db = (0, client_js_1.getDb)();
+        const result = db.prepare(`
+        UPDATE memory_nodes SET
+          status = ?,
+          last_verified_at = COALESCE(?, last_verified_at),
+          updated_at = ?
+        WHERE id = ?
+      `).run(status, last_verified_at ?? null, new Date().toISOString(), id);
+        if (result.changes === 0) {
+            return { content: [{ type: 'text', text: `Memory node "${id}" not found.` }], isError: true };
+        }
+        const row = db.prepare('SELECT * FROM memory_nodes WHERE id = ?').get(id);
+        return { content: [{ type: 'text', text: JSON.stringify(row, null, 2) }] };
+    });
+    server.registerTool('memory_feedback', {
+        description: 'Record whether a memory was useful, irrelevant, stale, incorrect, or too verbose.',
+        inputSchema: zod_1.z.object({
+            memory_id: zod_1.z.string(),
+            agent_id: zod_1.z.string().optional(),
+            session_id: zod_1.z.string().optional(),
+            rating: feedbackRating,
+            notes: zod_1.z.string().optional(),
+        }),
+    }, ({ memory_id, agent_id, session_id, rating, notes }) => {
+        const db = (0, client_js_1.getDb)();
+        if (!db.prepare('SELECT 1 FROM memory_nodes WHERE id = ?').get(memory_id)) {
+            return {
+                content: [{ type: 'text', text: `Memory node "${memory_id}" not found.` }],
+                isError: true,
+            };
+        }
+        if (agent_id && !db.prepare('SELECT 1 FROM agents WHERE id = ?').get(agent_id)) {
+            return { content: [{ type: 'text', text: `Agent "${agent_id}" not found.` }], isError: true };
+        }
+        if (session_id && !db.prepare('SELECT 1 FROM sessions WHERE id = ?').get(session_id)) {
+            return { content: [{ type: 'text', text: `Session "${session_id}" not found.` }], isError: true };
+        }
+        const id = (0, crypto_1.randomUUID)();
+        db.prepare(`
+        INSERT INTO memory_feedback
+          (id, memory_id, agent_id, session_id, rating, notes, created_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+      `).run(id, memory_id, agent_id ?? null, session_id ?? null, rating, notes ?? null, new Date().toISOString());
+        const row = db.prepare('SELECT * FROM memory_feedback WHERE id = ?').get(id);
+        return { content: [{ type: 'text', text: JSON.stringify(row, null, 2) }] };
+    });
+}
+//# sourceMappingURL=memory.js.map

package/dist/tools/memory.js.map

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

package/dist/tools/projects.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerProjectTools(server: McpServer): void;
+//# sourceMappingURL=projects.d.ts.map

package/dist/tools/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8G5D"}

package/dist/tools/projects.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerProjectTools = registerProjectTools;
+const zod_1 = require("zod");
+const client_js_1 = require("../db/client.js");
+function registerProjectTools(server) {
+    server.registerTool('project_list', {
+        description: 'List all known projects with their status, stack, and last update time.',
+        inputSchema: zod_1.z.object({
+            status: zod_1.z.enum(['active', 'paused', 'archived']).optional()
+                .describe('Filter by status. Omit to get all projects.'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, ({ status }) => {
+        const db = (0, client_js_1.getDb)();
+        const rows = status
+            ? db.prepare('SELECT * FROM projects WHERE status = ? ORDER BY updated_at DESC').all(status)
+            : db.prepare('SELECT * FROM projects ORDER BY updated_at DESC').all();
+        return {
+            content: [{ type: 'text', text: JSON.stringify(rows, null, 2) }],
+        };
+    });
+    server.registerTool('project_get', {
+        description: 'Get full details for a single project by its id or name.',
+        inputSchema: zod_1.z.object({
+            id: zod_1.z.string().optional().describe('Project id (directory slug), e.g. "D--Projects-MyApp"'),
+            name: zod_1.z.string().optional().describe('Human name, e.g. "MyApp". Case-insensitive partial match.'),
+        }),
+        annotations: { readOnlyHint: true },
+    }, ({ id, name }) => {
+        const db = (0, client_js_1.getDb)();
+        let row;
+        if (id) {
+            row = db.prepare('SELECT * FROM projects WHERE id = ?').get(id);
+        }
+        else if (name) {
+            row = db.prepare("SELECT * FROM projects WHERE lower(name) LIKE lower('%' || ? || '%') LIMIT 1")
+                .get(name);
+        }
+        if (!row) {
+            return { content: [{ type: 'text', text: 'Project not found.' }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(row, null, 2) }] };
+    });
+    server.registerTool('project_upsert', {
+        description: 'Create or update a project record. Use to register a new project or update stack/description.',
+        inputSchema: zod_1.z.object({
+            id: zod_1.z.string().describe('Directory slug id, e.g. "D--Projects-MyApp"'),
+            name: zod_1.z.string().describe('Human-readable project name'),
+            root_path: zod_1.z.string().describe('Absolute path on disk, e.g. "D:\\\\Projects\\\\MyApp"'),
+            stack: zod_1.z.string().optional().describe('Tech stack description, e.g. "Laravel 12 + Nuxt 4 + MySQL"'),
+            description: zod_1.z.string().optional().describe('Short project description'),
+            status: zod_1.z.enum(['active', 'paused', 'archived']).optional(),
+        }),
+    }, ({ id, name, root_path, stack, description, status }) => {
+        const db = (0, client_js_1.getDb)();
+        const now = new Date().toISOString();
+        const existing = db.prepare('SELECT 1 FROM projects WHERE id = ?').get(id);
+        if (existing) {
+            db.prepare(`
+          UPDATE projects SET
+            name = ?, root_path = ?, stack = COALESCE(?, stack),
+            description = COALESCE(?, description), status = COALESCE(?, status),
+            updated_at = ?
+          WHERE id = ?
+        `).run(name, root_path, stack ?? null, description ?? null, status ?? null, now, id);
+        }
+        else {
+            db.prepare(`
+          INSERT INTO projects (id, name, root_path, stack, description, status, created_at, updated_at)
+          VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+        `).run(id, name, root_path, stack ?? null, description ?? null, status ?? 'active', now, now);
+        }
+        const row = db.prepare('SELECT * FROM projects WHERE id = ?').get(id);
+        return { content: [{ type: 'text', text: JSON.stringify(row, null, 2) }] };
+    });
+    server.registerTool('project_set_status', {
+        description: 'Quickly change project status to active, paused, or archived.',
+        inputSchema: zod_1.z.object({
+            id: zod_1.z.string().describe('Project id'),
+            status: zod_1.z.enum(['active', 'paused', 'archived']),
+        }),
+    }, ({ id, status }) => {
+        const db = (0, client_js_1.getDb)();
+        const result = db.prepare("UPDATE projects SET status = ?, updated_at = datetime('now') WHERE id = ?").run(status, id);
+        if (result.changes === 0) {
+            return { content: [{ type: 'text', text: `Project "${id}" not found.` }], isError: true };
+        }
+        return { content: [{ type: 'text', text: `Project "${id}" status set to "${status}".` }] };
+    });
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

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

package/dist/tools/sessions.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSessionTools(server: McpServer): void;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/tools/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/tools/sessions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYpE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6I5D"}

package/dist/tools/sessions.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSessionTools = registerSessionTools;
+const zod_1 = require("zod");
+const client_js_1 = require("../db/client.js");
+const crypto_1 = require("crypto");
+const AUTO_HANDOFF_PREFIX = 'auto-handoff';
+function autoHandoffName(projectId) {
+    return projectId ? `${AUTO_HANDOFF_PREFIX}:${projectId}` : AUTO_HANDOFF_PREFIX;
+}
+function registerSessionTools(server) {
+    server.registerTool('session_log', {
+        description: 'Record a session summary at the end of significant agent work. ' +
+            'On outcome "partial"/"blocked" (or when next_steps are given) the hub automatically ' +
+            'writes a handoff memory so the next agent resumes without retelling; ' +
+            'outcome "completed" retires that auto-handoff.',
+        inputSchema: zod_1.z.object({
+            project_id: zod_1.z.string().optional(),
+            agent_id: zod_1.z.string().optional(),
+            provider: zod_1.z.string().optional(),
+            model: zod_1.z.string().optional(),
+            client: zod_1.z.string().optional(),
+            client_session_id: zod_1.z.string().optional(),
+            surface: zod_1.z.string().default('claude-code'),
+            started_at: zod_1.z.string().describe('ISO datetime session started'),
+            summary: zod_1.z.string().describe('what was accomplished and decided'),
+            files_touched: zod_1.z.array(zod_1.z.string()).optional(),
+            commits_made: zod_1.z.array(zod_1.z.string()).optional(),
+            outcome: zod_1.z.enum(['completed', 'blocked', 'partial']).default('completed'),
+            next_steps: zod_1.z.array(zod_1.z.string()).optional()
+                .describe('concrete next actions for whichever agent continues this work'),
+        }),
+    }, ({ project_id, agent_id, provider, model, client, client_session_id, surface, started_at, summary, files_touched, commits_made, outcome, next_steps, }) => {
+        const db = (0, client_js_1.getDb)();
+        const id = (0, crypto_1.randomUUID)();
+        const now = new Date().toISOString();
+        let agent;
+        if (agent_id) {
+            agent = db.prepare('SELECT * FROM agents WHERE id = ?').get(agent_id);
+            if (!agent) {
+                return { content: [{ type: 'text', text: `Agent "${agent_id}" not found.` }], isError: true };
+            }
+        }
+        db.prepare(`
+        INSERT INTO sessions
+          (
+            id, project_id, surface, started_at, ended_at, summary,
+            files_touched, commits_made, outcome,
+            agent_id, provider, model, client, client_session_id
+          )
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(id, project_id ?? null, surface, started_at, now, summary, files_touched ? JSON.stringify(files_touched) : null, commits_made ? JSON.stringify(commits_made) : null, outcome, agent_id ?? null, provider ?? agent?.provider ?? null, model ?? agent?.model ?? null, client ?? agent?.client ?? surface, client_session_id ?? null);
+        const handoffName = autoHandoffName(project_id);
+        const existingHandoff = db.prepare(`
+        SELECT id FROM memory_nodes
+        WHERE name = ? AND (project_id IS ? OR project_id = ?) AND status = 'active'
+      `).get(handoffName, project_id ?? null, project_id ?? null);
+        let handoffNote = '';
+        const needsHandoff = outcome !== 'completed' || (next_steps?.length ?? 0) > 0;
+        if (needsHandoff) {
+            const who = agent?.display_name ?? agent_id ?? client ?? surface;
+            const bodyParts = [
+                `Outcome: ${outcome} (session ${id}, agent: ${who})`,
+                `Done: ${summary}`,
+            ];
+            if (next_steps?.length)
+                bodyParts.push(`Next steps:\n${next_steps.map(s => `- ${s}`).join('\n')}`);
+            if (files_touched?.length)
+                bodyParts.push(`Files touched: ${files_touched.join(', ')}`);
+            if (commits_made?.length)
+                bodyParts.push(`Commits: ${commits_made.join(', ')}`);
+            const body = bodyParts.join('\n\n');
+            const description = `Continue from ${who}: ${summary.slice(0, 200)}`;
+            if (existingHandoff) {
+                db.prepare(`
+            UPDATE memory_nodes
+            SET description = ?, body = ?, origin_session = ?, created_by_agent = ?,
+                source_type = 'session', source_ref = ?, updated_at = ?
+            WHERE id = ?
+          `).run(description, body, id, agent_id ?? null, id, now, existingHandoff.id);
+                handoffNote = ` Handoff memory updated ("${handoffName}").`;
+            }
+            else {
+                db.prepare(`
+            INSERT INTO memory_nodes
+              (id, project_id, surface, name, description, type, body,
+               origin_session, created_by_agent, status, importance, confidence,
+               source_type, source_ref, created_at, updated_at)
+            VALUES (?, ?, ?, ?, ?, 'handoff', ?, ?, ?, 'active', 90, 80, 'session', ?, ?, ?)
+          `).run((0, crypto_1.randomUUID)(), project_id ?? null, surface, handoffName, description, body, id, agent_id ?? null, id, now, now);
+                handoffNote = ` Handoff memory created ("${handoffName}").`;
+            }
+        }
+        else if (existingHandoff) {
+            db.prepare(`
+          UPDATE memory_nodes SET status = 'superseded', updated_at = ? WHERE id = ?
+        `).run(now, existingHandoff.id);
+            handoffNote = ` Work completed: auto-handoff "${handoffName}" retired.`;
+        }
+        const projectWarning = !project_id && needsHandoff
+            ? ' WARNING: no project_id — this handoff is global and will NOT surface in any' +
+                ' project resume. Re-log with project_id so the next agent finds it.'
+            : '';
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Session logged with id "${id}".${handoffNote}${projectWarning}` +
+                        ' Use memory_write for decisions/facts that should outlive this handoff.',
+                }],
+        };
+    });
+}
+//# sourceMappingURL=sessions.js.map

package/dist/tools/sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.js","sourceRoot":"","sources":["../../src/tools/sessions.ts"],"names":[],"mappings":";;AAYA,oDA6IC;AAxJD,6BAAwB;AACxB,+CAAwC;AAExC,mCAAoC;AAEpC,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAE3C,SAAS,eAAe,CAAC,SAA6B;IACpD,OAAO,SAAS,CAAC,CAAC,CAAC,GAAG,mBAAmB,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC;AACjF,CAAC;AAED,SAAgB,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,WAAW,EACT,iEAAiE;YACjE,sFAAsF;YACtF,uEAAuE;YACvE,gDAAgD;QAClD,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;YACpB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACjC,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC5B,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,iBAAiB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YACxC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;YAC1C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;YAC/D,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACjE,aAAa,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YAC7C,YAAY,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;YAC5C,OAAO,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;YACzE,UAAU,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;iBACvC,QAAQ,CAAC,+DAA+D,CAAC;SAC7E,CAAC;KACH,EACD,CAAC,EACC,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,KAAK,EACL,MAAM,EACN,iBAAiB,EACjB,OAAO,EACP,UAAU,EACV,OAAO,EACP,aAAa,EACb,YAAY,EACZ,OAAO,EACP,UAAU,GACX,EAAE,EAAE;QACH,MAAM,EAAE,GAAG,IAAA,iBAAK,GAAE,CAAC;QACnB,MAAM,EAAE,GAAG,IAAA,mBAAU,GAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,KAAwB,CAAC;QAE7B,IAAI,QAAQ,EAAE,CAAC;YACb,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAsB,CAAC;YAC3F,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,QAAQ,cAAc,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAChG,CAAC;QACH,CAAC;QAED,EAAE,CAAC,OAAO,CAAC;;;;;;;;OAQV,CAAC,CAAC,GAAG,CACJ,EAAE,EACF,UAAU,IAAI,IAAI,EAClB,OAAO,EACP,UAAU,EACV,GAAG,EACH,OAAO,EACP,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EACpD,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAClD,OAAO,EACP,QAAQ,IAAI,IAAI,EAChB,QAAQ,IAAI,KAAK,EAAE,QAAQ,IAAI,IAAI,EACnC,KAAK,IAAI,KAAK,EAAE,KAAK,IAAI,IAAI,EAC7B,MAAM,IAAI,KAAK,EAAE,MAAM,IAAI,OAAO,EAClC,iBAAiB,IAAI,IAAI,CAC1B,CAAC;QAEF,MAAM,WAAW,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,eAAe,GAAG,EAAE,CAAC,OAAO,CAAC;;;OAGlC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,UAAU,IAAI,IAAI,EAAE,UAAU,IAAI,IAAI,CAA+B,CAAC;QAE1F,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,MAAM,YAAY,GAAG,OAAO,KAAK,WAAW,IAAI,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAE9E,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,KAAK,EAAE,YAAY,IAAI,QAAQ,IAAI,MAAM,IAAI,OAAO,CAAC;YACjE,MAAM,SAAS,GAAG;gBAChB,YAAY,OAAO,aAAa,EAAE,YAAY,GAAG,GAAG;gBACpD,SAAS,OAAO,EAAE;aACnB,CAAC;YACF,IAAI,UAAU,EAAE,MAAM;gBAAE,SAAS,CAAC,IAAI,CAAC,gBAAgB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnG,IAAI,aAAa,EAAE,MAAM;gBAAE,SAAS,CAAC,IAAI,CAAC,kBAAkB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxF,IAAI,YAAY,EAAE,MAAM;gBAAE,SAAS,CAAC,IAAI,CAAC,YAAY,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChF,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,WAAW,GAAG,iBAAiB,GAAG,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YAErE,IAAI,eAAe,EAAE,CAAC;gBACpB,EAAE,CAAC,OAAO,CAAC;;;;;WAKV,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,IAAI,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;gBAC7E,WAAW,GAAG,6BAA6B,WAAW,KAAK,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,EAAE,CAAC,OAAO,CAAC;;;;;;WAMV,CAAC,CAAC,GAAG,CACJ,IAAA,mBAAU,GAAE,EAAE,UAAU,IAAI,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,IAAI,EACzE,EAAE,EAAE,QAAQ,IAAI,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,CACnC,CAAC;gBACF,WAAW,GAAG,6BAA6B,WAAW,KAAK,CAAC;YAC9D,CAAC;QACH,CAAC;aAAM,IAAI,eAAe,EAAE,CAAC;YAC3B,EAAE,CAAC,OAAO,CAAC;;SAEV,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC;YAChC,WAAW,GAAG,kCAAkC,WAAW,YAAY,CAAC;QAC1E,CAAC;QAED,MAAM,cAAc,GAAG,CAAC,UAAU,IAAI,YAAY;YAChD,CAAC,CAAC,8EAA8E;gBAC9E,qEAAqE;YACvE,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,2BAA2B,EAAE,KAAK,WAAW,GAAG,cAAc,EAAE;wBACpE,yEAAyE;iBAC5E,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/tasks.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerTaskTools(server: McpServer): void;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/tools/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMpE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8WzD"}