kimi-code-memory-mcp-server 0.1.0

package/dist/tools/memory-tools.js

@@ -0,0 +1,292 @@
+/**
+ * Memory CRUD tools: remember, recall, recall_recent, search, list, list_tags, delete, move.
+ */
+import fs from 'fs';
+import path from 'path';
+import { sanitizeFolder, sanitizeKey, toTitle } from '../utils/validation.js';
+import { parseFrontmatter } from '../utils/frontmatter.js';
+function toolResult(data, isError = false) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        isError,
+    };
+}
+function safeParseFile(filePath) {
+    try {
+        const text = fs.readFileSync(filePath, 'utf8');
+        return parseFrontmatter(text) || { frontmatter: {}, body: text };
+    }
+    catch {
+        return null;
+    }
+}
+function fileStats(filePath) {
+    try {
+        return fs.statSync(filePath);
+    }
+    catch {
+        return null;
+    }
+}
+export function createMemoryTools(ctx) {
+    const { storeRoot, indexDao, themeManager, memoryStore } = ctx;
+    function resolveFilePath(folder, key) {
+        return path.join(storeRoot, folder, `${sanitizeKey(key)}.md`);
+    }
+    async function handleRemember(args) {
+        const key = args.key;
+        if (!key || typeof key !== 'string') {
+            return toolResult({ success: false, error: 'Missing or invalid "key"' }, true);
+        }
+        const folderRaw = typeof args.folder === 'string' ? args.folder : 'memory';
+        const folder = sanitizeFolder(folderRaw);
+        if (!folder) {
+            return toolResult({ success: false, error: 'Invalid folder path' }, true);
+        }
+        const content = typeof args.content === 'string' ? args.content : '';
+        const tags = Array.isArray(args.tags) ? args.tags.filter((t) => typeof t === 'string') : [];
+        const themes = Array.isArray(args.themes)
+            ? args.themes.filter((t) => typeof t === 'string')
+            : [];
+        const filePath = memoryStore.write(folder, key, content, tags);
+        await indexDao.upsertEntry(filePath);
+        const sanitizedKey = sanitizeKey(key);
+        const readBack = memoryStore.read(folder, key);
+        const title = typeof readBack?.title === 'string' ? readBack.title : toTitle(key);
+        for (const theme of themes) {
+            await themeManager.addThemeAssociation(theme, {
+                memoryKey: sanitizedKey,
+                folder,
+                title,
+            });
+        }
+        return toolResult({ success: true, filePath, folder, key, themes });
+    }
+    async function handleRecall(args) {
+        const key = args.key;
+        if (!key || typeof key !== 'string') {
+            return toolResult({ found: false, error: 'Missing or invalid "key"' }, true);
+        }
+        const folderRaw = typeof args.folder === 'string' ? args.folder : 'memory';
+        const folder = sanitizeFolder(folderRaw);
+        if (!folder) {
+            return toolResult({ found: false, error: 'Invalid folder path', key }, true);
+        }
+        const readResult = memoryStore.read(folder, key);
+        if (!readResult) {
+            return toolResult({ found: false, key, folder });
+        }
+        await indexDao.upsertEntry(readResult.filePath);
+        return toolResult({
+            found: true,
+            key,
+            folder,
+            content: readResult.content,
+            tags: Array.isArray(readResult.tags) ? readResult.tags : [],
+            createdAt: readResult.createdAt || null,
+            updatedAt: readResult.updatedAt || null,
+        });
+    }
+    function handleRecallRecent(args) {
+        const n = typeof args.n === 'number' ? Math.max(1, Math.floor(args.n)) : 10;
+        const folderFilterRaw = typeof args.folder === 'string' ? args.folder : null;
+        const folderFilter = folderFilterRaw ? sanitizeFolder(folderFilterRaw) : null;
+        if (folderFilterRaw && !folderFilter) {
+            return toolResult({ items: [], error: 'Invalid folder path' }, true);
+        }
+        const tagFilter = typeof args.tag === 'string' ? args.tag : null;
+        const index = indexDao.getIndex();
+        const items = [];
+        for (const key of Object.keys(index.index)) {
+            if (!key.endsWith('.md'))
+                continue;
+            const value = index.index[key];
+            const folder = path.dirname(key);
+            const entryKey = path.basename(key, '.md');
+            if (folderFilter && folder !== folderFilter)
+                continue;
+            if (tagFilter && (!Array.isArray(value.tags) || !value.tags.includes(tagFilter)))
+                continue;
+            const filePath = path.join(storeRoot, key);
+            const stats = fileStats(filePath);
+            items.push({
+                key: entryKey,
+                folder,
+                title: value.title || toTitle(entryKey),
+                tags: Array.isArray(value.tags) ? value.tags : [],
+                updatedAt: stats ? stats.mtime.toISOString() : new Date().toISOString(),
+                preview: '',
+            });
+        }
+        items.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+        return toolResult({
+            items: items.slice(0, n).map((item) => {
+                const filePath = resolveFilePath(item.folder, item.key);
+                const parsed = safeParseFile(filePath);
+                return {
+                    ...item,
+                    preview: (parsed?.body || '').slice(0, 400),
+                };
+            }),
+        });
+    }
+    function handleSearch(args) {
+        const query = args.query;
+        if (!query || typeof query !== 'string') {
+            return toolResult({ items: [], error: 'Missing or invalid "query"' }, true);
+        }
+        const needle = query.toLowerCase();
+        const folderFilterRaw = typeof args.folder === 'string' ? args.folder : null;
+        const folderFilter = folderFilterRaw ? sanitizeFolder(folderFilterRaw) : null;
+        if (folderFilterRaw && !folderFilter) {
+            return toolResult({ items: [], error: 'Invalid folder path' }, true);
+        }
+        const index = indexDao.getIndex();
+        const items = [];
+        for (const key of Object.keys(index.index)) {
+            if (!key.endsWith('.md'))
+                continue;
+            const value = index.index[key];
+            const folder = path.dirname(key);
+            const entryKey = path.basename(key, '.md');
+            if (folderFilter && folder !== folderFilter)
+                continue;
+            const title = value.title || toTitle(entryKey);
+            const haystack = `${title}\n${entryKey}`.toLowerCase();
+            if (!haystack.includes(needle)) {
+                const filePath = path.join(storeRoot, key);
+                const parsed = safeParseFile(filePath);
+                const body = parsed?.body || '';
+                if (!body.toLowerCase().includes(needle))
+                    continue;
+                const matches = [];
+                const lines = body.split(/\r?\n/);
+                for (const line of lines) {
+                    if (line.toLowerCase().includes(needle)) {
+                        matches.push(line.trim().slice(0, 200));
+                        if (matches.length >= 3)
+                            break;
+                    }
+                }
+                items.push({ key: entryKey, folder, title, matches });
+                continue;
+            }
+            items.push({ key: entryKey, folder, title, matches: [`title: ${title}`] });
+        }
+        return toolResult({ items });
+    }
+    function handleListTags() {
+        const index = indexDao.getIndex();
+        const tagSet = new Set();
+        for (const key of Object.keys(index.index)) {
+            if (!key.endsWith('.md'))
+                continue;
+            const value = index.index[key];
+            if (Array.isArray(value.tags)) {
+                for (const tag of value.tags)
+                    tagSet.add(tag);
+            }
+        }
+        return toolResult({ tags: Array.from(tagSet).sort() });
+    }
+    function handleList(args) {
+        const folderFilterRaw = typeof args.folder === 'string' ? args.folder : null;
+        const folderFilter = folderFilterRaw ? sanitizeFolder(folderFilterRaw) : null;
+        if (folderFilterRaw && !folderFilter) {
+            return toolResult({ items: [], error: 'Invalid folder path' }, true);
+        }
+        const index = indexDao.getIndex();
+        const items = [];
+        for (const key of Object.keys(index.index)) {
+            if (!key.endsWith('.md'))
+                continue;
+            const value = index.index[key];
+            const folder = path.dirname(key);
+            if (folderFilter && folder !== folderFilter)
+                continue;
+            const filePath = path.join(storeRoot, key);
+            const stats = fileStats(filePath);
+            items.push({
+                key: path.basename(key, '.md'),
+                folder,
+                title: value.title || toTitle(path.basename(key, '.md')),
+                tags: Array.isArray(value.tags) ? value.tags : [],
+                updatedAt: stats ? stats.mtime.toISOString() : new Date().toISOString(),
+                size: stats ? stats.size : 0,
+            });
+        }
+        items.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+        return toolResult({ items });
+    }
+    async function handleDelete(args) {
+        const key = args.key;
+        if (!key || typeof key !== 'string') {
+            return toolResult({ success: false, error: 'Missing or invalid "key"' }, true);
+        }
+        const folderRaw = typeof args.folder === 'string' ? args.folder : 'memory';
+        const folder = sanitizeFolder(folderRaw);
+        if (!folder) {
+            return toolResult({ success: false, error: 'Invalid folder path', key }, true);
+        }
+        const filePath = memoryStore.resolveFilePath(folder, key);
+        const relativePath = path.relative(storeRoot, filePath).replace(/\\/g, '/');
+        const deleted = memoryStore.delete(folder, key);
+        if (!deleted) {
+            return toolResult({ success: false, key, folder, error: 'Memory not found' }, true);
+        }
+        await indexDao.deleteEntryByPath(relativePath);
+        return toolResult({ success: true, key, folder });
+    }
+    async function handleMove(args) {
+        const key = args.key;
+        if (!key || typeof key !== 'string') {
+            return toolResult({ success: false, error: 'Missing or invalid "key"' }, true);
+        }
+        const folderRaw = typeof args.folder === 'string' ? args.folder : 'memory';
+        const folder = sanitizeFolder(folderRaw);
+        if (!folder) {
+            return toolResult({ success: false, error: 'Invalid folder path', key }, true);
+        }
+        const toFolderRaw = typeof args.toFolder === 'string' ? args.toFolder : null;
+        if (!toFolderRaw) {
+            return toolResult({ success: false, error: 'Missing "toFolder"' }, true);
+        }
+        const toFolder = sanitizeFolder(toFolderRaw);
+        if (!toFolder) {
+            return toolResult({ success: false, error: 'Invalid toFolder path', key }, true);
+        }
+        const newKeyRaw = typeof args.newKey === 'string' ? args.newKey : key;
+        const newKey = sanitizeKey(newKeyRaw);
+        const srcPath = memoryStore.resolveFilePath(folder, key);
+        const destPath = memoryStore.resolveFilePath(toFolder, newKey);
+        if (!fs.existsSync(srcPath)) {
+            return toolResult({ success: false, key, folder, error: 'Memory not found' }, true);
+        }
+        if (fs.existsSync(destPath)) {
+            return toolResult({
+                success: false,
+                key,
+                folder,
+                toFolder,
+                newKey,
+                error: 'Destination already exists',
+            }, true);
+        }
+        const oldRelativePath = path.relative(storeRoot, srcPath).replace(/\\/g, '/');
+        const newRelativePath = path.relative(storeRoot, destPath).replace(/\\/g, '/');
+        memoryStore.move(folder, key, toFolder, newKeyRaw);
+        await indexDao.moveEntry(oldRelativePath, newRelativePath);
+        return toolResult({ success: true, key, newKey, fromFolder: folder, toFolder });
+    }
+    return {
+        handleRemember,
+        handleRecall,
+        handleRecallRecent,
+        handleSearch,
+        handleListTags,
+        handleList,
+        handleDelete,
+        handleMove,
+    };
+}
+//# sourceMappingURL=memory-tools.js.map

package/dist/tools/memory-tools.js.map

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

package/dist/tools/system-tools.d.ts

@@ -0,0 +1,37 @@
+/**
+ * System tools: get_current_workspace, organize_memories, sync_workspace_index, bootstrap_workspace.
+ */
+import type { Ctx, OrganizeArgs, SyncWorkspaceIndexArgs } from '../types.js';
+export declare function createSystemTools(ctx: Ctx): {
+    handleGetCurrentWorkspace: () => {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    };
+    handleOrganize: (args: OrganizeArgs) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+    handleSyncWorkspaceIndex: (args: SyncWorkspaceIndexArgs) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+    handleBootstrapWorkspace: (args: {
+        detailed_rounds?: number;
+        summary_rounds?: number;
+    }) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};

package/dist/tools/system-tools.js

@@ -0,0 +1,195 @@
+/**
+ * System tools: get_current_workspace, organize_memories, sync_workspace_index, bootstrap_workspace.
+ */
+import fs from 'fs';
+import path from 'path';
+import { ESSENCE_SIZE_LIMIT } from '../config.js';
+import { loadMcpConfig } from '../context/wire-context.js';
+import { parseFrontmatter, stringifyFrontmatter } from '../utils/frontmatter.js';
+import { atomicWriteFile } from '../utils/paths.js';
+import { toTitle } from '../utils/validation.js';
+function toolResult(data, isError = false) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+        isError,
+    };
+}
+function safeParseFile(filePath) {
+    try {
+        const text = fs.readFileSync(filePath, 'utf8');
+        return parseFrontmatter(text) || { frontmatter: {}, body: text };
+    }
+    catch {
+        return null;
+    }
+}
+function fileStats(filePath) {
+    try {
+        return fs.statSync(filePath);
+    }
+    catch {
+        return null;
+    }
+}
+const ESSENCE = {
+    folder: 'essence',
+    key: 'essence',
+    maxRecommendedBytes: ESSENCE_SIZE_LIMIT,
+    rules: [
+        '输入源：现有 essence/essence.md + memory/ 下所有条目；notes/ 不参与。',
+        '输出目标：固定单个文件 essence/essence.md，覆盖写入。',
+        '核心任务：重新结构化内容——归类、按重要度排序、去重合并。',
+        '语言要求：精炼、无歧义、不改变语义；可适当压缩格式，不必考虑人类可读性。',
+        '信息保留：尽量不丢失信息；如需舍弃某 memory 源内容，Agent 自行决定并处理。',
+        '来源标注：关键章节/结论在正文内用 `> 来源：memory/<folder>/key` 标注；不写入 frontmatter sources。',
+        '不强制模板：Agent 自行决定最终结构和章节。',
+        '大小提示：工具校验并提示是否超过 15KB，但不阻止保存。',
+        '工具不碰 memory/ 源文件：Agent 整理后如需清理或重写源记忆，自行调用 delete / remember。',
+    ].join('\n'),
+};
+export function createSystemTools(ctx) {
+    const { cwd, workspaceId, storeRoot, indexDao } = ctx;
+    function loadEssenceFile() {
+        const essencePath = path.join(storeRoot, 'essence', 'essence.md');
+        if (!fs.existsSync(essencePath))
+            return null;
+        const parsed = safeParseFile(essencePath);
+        if (!parsed)
+            return null;
+        const stats = fileStats(essencePath);
+        return {
+            key: 'essence',
+            folder: 'essence',
+            filePath: essencePath,
+            frontmatter: parsed.frontmatter || {},
+            content: parsed.body || '',
+            size: stats ? stats.size : 0,
+        };
+    }
+    function handleGetCurrentWorkspace() {
+        return toolResult({
+            cwd,
+            workspaceId,
+            storePath: storeRoot,
+        });
+    }
+    async function handleOrganize(args) {
+        if (typeof args.content !== 'string') {
+            const existingEssence = loadEssenceFile();
+            const pendingMemories = [];
+            const index = indexDao.getIndex();
+            for (const key of Object.keys(index.index)) {
+                if (!key.endsWith('.md'))
+                    continue;
+                if (!key.startsWith('memory/'))
+                    continue;
+                const value = index.index[key];
+                const filePath = path.join(storeRoot, key);
+                const parsed = safeParseFile(filePath);
+                pendingMemories.push({
+                    key: path.basename(key, '.md'),
+                    folder: path.dirname(key),
+                    title: value.title || toTitle(path.basename(key, '.md')),
+                    tags: Array.isArray(value.tags) ? value.tags : [],
+                    size: fileStats(filePath)?.size || 0,
+                    content: parsed?.body || '',
+                });
+            }
+            return toolResult({
+                stage: 'prepare',
+                existingEssence: existingEssence
+                    ? {
+                        found: true,
+                        key: existingEssence.key,
+                        folder: existingEssence.folder,
+                        size: existingEssence.size,
+                        content: existingEssence.content,
+                    }
+                    : { found: false },
+                pendingMemories,
+                rules: ESSENCE.rules,
+                outputPath: `${ESSENCE.folder}/${ESSENCE.key}.md`,
+                maxRecommendedBytes: ESSENCE.maxRecommendedBytes,
+                message: 'Prepare ready. Generate the organized essence content and call organize_memories with content to store.',
+            });
+        }
+        const content = args.content;
+        const sources = Array.isArray(args.sources)
+            ? args.sources.filter((s) => typeof s === 'string')
+            : [];
+        const contentBytes = Buffer.byteLength(content, 'utf8');
+        const withinLimit = contentBytes <= ESSENCE.maxRecommendedBytes;
+        const essenceDir = path.join(storeRoot, ESSENCE.folder);
+        fs.mkdirSync(essenceDir, { recursive: true });
+        const essencePath = path.join(essenceDir, `${ESSENCE.key}.md`);
+        const nowIso = new Date().toISOString();
+        const frontmatter = {
+            key: ESSENCE.key,
+            title: 'Workspace Essence',
+            tags: ['essence', 'workspace-memory'],
+            updatedAt: nowIso,
+        };
+        const fileContent = stringifyFrontmatter(frontmatter) + content;
+        atomicWriteFile(essencePath, fileContent, 'utf8');
+        await indexDao.upsertEntry(essencePath);
+        return toolResult({
+            success: true,
+            stage: 'store',
+            filePath: essencePath,
+            contentSize: contentBytes,
+            recommendedMax: ESSENCE.maxRecommendedBytes,
+            sizeHint: withinLimit
+                ? 'within recommended limit'
+                : `exceeds ${ESSENCE.maxRecommendedBytes} bytes, consider compressing next time`,
+            sources,
+        });
+    }
+    async function handleSyncWorkspaceIndex(args) {
+        const result = await indexDao.reconcileIndex({
+            folderComments: args.folderComments,
+        });
+        const index = indexDao.getIndex();
+        const foldersNeedingComment = [];
+        for (const key of Object.keys(index.index)) {
+            if (!key.endsWith('/'))
+                continue;
+            const value = index.index[key];
+            if (!value.comment) {
+                foldersNeedingComment.push(key);
+            }
+        }
+        return toolResult({
+            ...result,
+            foldersNeedingComment,
+        });
+    }
+    async function handleBootstrapWorkspace(args) {
+        await indexDao.reconcileIndex();
+        const { buildWorkspaceContext } = await import('./context-tools.js').then((m) => m.createContextTools(ctx));
+        const contextData = await buildWorkspaceContext(args);
+        const existingEssence = loadEssenceFile();
+        const config = loadMcpConfig();
+        return toolResult({
+            workspace: contextData.workspace,
+            recentContext: contextData.recentContext,
+            essence: existingEssence
+                ? {
+                    found: true,
+                    key: existingEssence.key,
+                    folder: existingEssence.folder,
+                    size: existingEssence.size,
+                    content: existingEssence.content,
+                }
+                : { found: false },
+            memoryIndexTree: indexDao.buildMemoryIndexTree(config.recentChangeLimit),
+            notesRefs: indexDao.listRefs('notes'),
+        });
+    }
+    return {
+        handleGetCurrentWorkspace,
+        handleOrganize,
+        handleSyncWorkspaceIndex,
+        handleBootstrapWorkspace,
+    };
+}
+//# sourceMappingURL=system-tools.js.map

package/dist/tools/system-tools.js.map

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

package/dist/tools/theme-tools.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Theme tracing tools: tag_theme, trace_theme, list_themes, refine_session_turns.
+ */
+import type { Ctx, RefineSessionTurnsArgs, TagThemeArgs, TraceThemeArgs } from '../types.js';
+export declare function createThemeTools(ctx: Ctx): {
+    handleTagTheme: (args: TagThemeArgs) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+    handleTraceTheme: (args: TraceThemeArgs) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+    handleListThemes: () => {
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    };
+    handleRefineSessionTurns: (args: RefineSessionTurnsArgs) => Promise<{
+        content: {
+            type: string;
+            text: string;
+        }[];
+        isError: boolean;
+    }>;
+};