kimi-code-memory-mcp-server 0.1.0 → 0.1.2

package/dist/dao/memory-tree-renderer.js

@@ -0,0 +1,75 @@
+/**
+ * Pure renderer: turns a TreeNode data structure into an ASCII memory index tree.
+ *
+ * This module performs no file I/O; callers are responsible for building the
+ * TreeNode (including timestamps used for `[new]` markers).
+ */
+export class MemoryIndexTreeRenderer {
+    render(root, recentLimit = 5) {
+        const timeEntries = [];
+        const collectTimes = (node, nodePath) => {
+            for (const file of node.files) {
+                timeEntries.push({
+                    fullPath: `${nodePath}/${file.key}`,
+                    updatedAt: file.updatedAt || '',
+                    createdAt: file.createdAt || '',
+                });
+            }
+            for (const [name, child] of node.children.entries()) {
+                collectTimes(child, `${nodePath}/${name}`);
+            }
+        };
+        collectTimes(root, root.name);
+        const recentKeys = new Set(timeEntries
+            .sort((a, b) => {
+            const aUpdated = a.updatedAt ? new Date(a.updatedAt).getTime() : 0;
+            const bUpdated = b.updatedAt ? new Date(b.updatedAt).getTime() : 0;
+            if (bUpdated !== aUpdated)
+                return bUpdated - aUpdated;
+            const aCreated = a.createdAt ? new Date(a.createdAt).getTime() : 0;
+            const bCreated = b.createdAt ? new Date(b.createdAt).getTime() : 0;
+            return bCreated - aCreated;
+        })
+            .slice(0, recentLimit)
+            .map((e) => e.fullPath));
+        const renderNode = (node, nodePath, prefix = '', isLast = true, isRoot = false) => {
+            const lines = [];
+            const comment = node.comment;
+            if (isRoot) {
+                lines.push(`${node.name}/${comment ? ` — ${comment}` : ''}`);
+            }
+            else {
+                const connector = prefix === '' ? '' : isLast ? '└── ' : '├── ';
+                lines.push(`${prefix}${connector}${node.name}/${comment ? ` — ${comment}` : ''}`);
+            }
+            const childEntries = Array.from(node.children.entries()).sort((a, b) => a[0].localeCompare(b[0]));
+            const allFiles = [...node.files].sort((a, b) => a.key.localeCompare(b.key));
+            const items = [
+                ...childEntries.map(([name, childNode]) => ({
+                    type: 'folder',
+                    name,
+                    data: childNode,
+                })),
+                ...allFiles.map((file) => ({ type: 'file', name: file.key, data: file })),
+            ];
+            for (let i = 0; i < items.length; i++) {
+                const item = items[i];
+                const isLastItem = i === items.length - 1;
+                const childPrefix = isRoot ? '' : prefix + (isLast ? '    ' : '│   ');
+                if (item.type === 'folder') {
+                    lines.push(...renderNode(item.data, `${nodePath}/${item.name}`, childPrefix, isLastItem, false));
+                }
+                else {
+                    const file = item.data;
+                    const fileConnector = isLastItem ? '└── ' : '├── ';
+                    const tagStr = file.tags.length > 0 ? ` [${file.tags.join(', ')}]` : '';
+                    const newMark = recentKeys.has(`${nodePath}/${file.key}`) ? ' [new]' : '';
+                    lines.push(`${childPrefix}${fileConnector}${file.key} — ${file.title}${tagStr}${newMark}`);
+                }
+            }
+            return lines;
+        };
+        return renderNode(root, root.name, '', true, true).join('\n');
+    }
+}
+//# sourceMappingURL=memory-tree-renderer.js.map

package/dist/dao/memory-tree-renderer.js.map

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

package/dist/prompts/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MCP Prompts for the Kimi Code Memory server.
+ *
+ * Prompts provide reusable instruction templates that clients can fetch
+ * before asking the model to perform memory-aware tasks.
+ */
+export interface PromptArgument {
+    name: string;
+    description?: string;
+    required?: boolean;
+}
+export interface PromptDefinition {
+    name: string;
+    description: string;
+    arguments?: PromptArgument[];
+}
+export declare const prompts: PromptDefinition[];
+export declare function getPrompt(name: string, args?: Record<string, string>): {
+    messages: Array<{
+        role: 'user' | 'assistant';
+        content: {
+            type: 'text';
+            text: string;
+        };
+    }>;
+};

package/dist/prompts/index.js

@@ -0,0 +1,103 @@
+/**
+ * MCP Prompts for the Kimi Code Memory server.
+ *
+ * Prompts provide reusable instruction templates that clients can fetch
+ * before asking the model to perform memory-aware tasks.
+ */
+export const prompts = [
+    {
+        name: 'memory-decision-check',
+        description: 'Before modifying a file, check historical decisions related to it.',
+        arguments: [
+            {
+                name: 'filePath',
+                description: 'Path of the file you are about to modify.',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'memory-theme-trace',
+        description: 'Trace the evolution of a theme across sessions.',
+        arguments: [
+            {
+                name: 'theme',
+                description: 'Theme identifier to trace.',
+                required: false,
+            },
+        ],
+    },
+    {
+        name: 'memory-session-summary',
+        description: 'Summarize the current session and suggest themes to tag.',
+    },
+];
+export function getPrompt(name, args = {}) {
+    switch (name) {
+        case 'memory-decision-check': {
+            const filePath = args.filePath || '<file-path>';
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `I am about to modify ${filePath}. Before I make any changes, please check our historical decisions and rules related to this file or feature.`,
+                        },
+                    },
+                    {
+                        role: 'assistant',
+                        content: {
+                            type: 'text',
+                            text: `I'll search the workspace memory for decisions, rules, and knowledge related to ${filePath}. If relevant themes exist, I'll trace their evolution across sessions before you edit.`,
+                        },
+                    },
+                ],
+            };
+        }
+        case 'memory-theme-trace': {
+            const theme = args.theme || '<theme>';
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: `Please trace the evolution of the "${theme}" theme across sessions and memories.`,
+                        },
+                    },
+                    {
+                        role: 'assistant',
+                        content: {
+                            type: 'text',
+                            text: `I'll look up the "${theme}" theme, list its associated memories and refined turns, and summarize how it evolved over time.`,
+                        },
+                    },
+                ],
+            };
+        }
+        case 'memory-session-summary': {
+            return {
+                messages: [
+                    {
+                        role: 'user',
+                        content: {
+                            type: 'text',
+                            text: 'Please summarize the current session and suggest any themes worth tagging for future traceability.',
+                        },
+                    },
+                    {
+                        role: 'assistant',
+                        content: {
+                            type: 'text',
+                            text: "I'll review the current session's turns, extract key decisions and open questions, and propose themes that connect this session to related work.",
+                        },
+                    },
+                ],
+            };
+        }
+        default:
+            throw new Error(`Unknown prompt: ${name}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,CAAC,MAAM,OAAO,GAAuB;IACzC;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,oEAAoE;QACjF,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,2CAA2C;gBACxD,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,iDAAiD;QAC9D,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,4BAA4B;gBACzC,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;IACD;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EAAE,0DAA0D;KACxE;CACF,CAAC;AAEF,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,OAA+B,EAAE;IAEjC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,uBAAuB,CAAC,CAAC,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,aAAa,CAAC;YAChD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,wBAAwB,QAAQ,+GAA+G;yBACtJ;qBACF;oBACD;wBACE,IAAI,EAAE,WAAW;wBACjB,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,mFAAmF,QAAQ,yFAAyF;yBAC3L;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QACD,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC;YACtC,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,sCAAsC,KAAK,uCAAuC;yBACzF;qBACF;oBACD;wBACE,IAAI,EAAE,WAAW;wBACjB,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,qBAAqB,KAAK,kGAAkG;yBACnI;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QACD,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC9B,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,oGAAoG;yBAC3G;qBACF;oBACD;wBACE,IAAI,EAAE,WAAW;wBACjB,OAAO,EAAE;4BACP,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,kJAAkJ;yBACzJ;qBACF;iBACF;aACF,CAAC;QACJ,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/refine/adapter.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Row <-> domain mapping for refined turns.
+ */
+import type { RefinedRow, RefinedTurn } from './types.js';
+export declare function rowToTurn(row: RefinedRow): RefinedTurn;
+export declare function turnToRow(turn: RefinedTurn): RefinedRow;

package/dist/refine/adapter.js

@@ -0,0 +1,28 @@
+/**
+ * Row <-> domain mapping for refined turns.
+ */
+export function rowToTurn(row) {
+    return {
+        sessionId: row.session_id,
+        turnId: row.turn_id,
+        timestamp: row.timestamp ?? undefined,
+        summary: row.summary,
+        facts: JSON.parse(row.facts || '[]'),
+        notes: JSON.parse(row.notes || '[]'),
+        entities: JSON.parse(row.entities || '{"files":[],"tools":[],"errors":[]}'),
+        categories: JSON.parse(row.categories || '{}'),
+    };
+}
+export function turnToRow(turn) {
+    return {
+        session_id: turn.sessionId,
+        turn_id: turn.turnId,
+        timestamp: turn.timestamp ?? null,
+        summary: turn.summary,
+        facts: JSON.stringify(turn.facts),
+        notes: JSON.stringify(turn.notes),
+        entities: JSON.stringify(turn.entities),
+        categories: JSON.stringify(turn.categories),
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/refine/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/refine/adapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,SAAS,CAAC,GAAe;IACvC,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,MAAM,EAAE,GAAG,CAAC,OAAO;QACnB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;QACrC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC;QACpC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC;QACpC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,IAAI,qCAAqC,CAAC;QAC3E,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAiB;IACzC,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,SAAS;QAC1B,OAAO,EAAE,IAAI,CAAC,MAAM;QACpB,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QACjC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QACjC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;QACvC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/refine/constants.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Constants for the turn refinement layer.
+ */
+/** Action / conclusion keywords in both English and Chinese. */
+export declare const ACTION_KEYWORDS: string[];
+/** Markdown headings that group the following list items into categories. */
+export declare const CATEGORY_HEADINGS: Record<string, string[]>;
+/** Slicing limits used during extraction and search. */
+export declare const LIMITS: {
+    /** Max length of the user text snippet included in the summary. */
+    userText: number;
+    /** Max length of the agent lead sentence included in the summary. */
+    agentLead: number;
+    /** Max number of extracted facts stored per turn. */
+    facts: number;
+    /** Max number of fallback notes stored per turn. */
+    notes: number;
+    /** Max number of file entities stored per turn. */
+    files: number;
+    /** Max number of tool entities stored per turn. */
+    tools: number;
+    /** Max number of error entities stored per turn. */
+    errors: number;
+    /** Max length of a single error snippet. */
+    errorSnippet: number;
+    /** Default max number of search matches returned. */
+    searchResultLimit: number;
+    /** Multiplier used to fetch extra candidates before ranking search results. */
+    searchCandidateMultiplier: number;
+};
+/** Helpers for ISO date boundary formatting used in SQL queries. */
+export declare const DATE_FORMAT: {
+    dayStart: (date: string) => string;
+    dayEnd: (date: string) => string;
+};

package/dist/refine/constants.js

@@ -0,0 +1,107 @@
+/**
+ * Constants for the turn refinement layer.
+ */
+/** Action / conclusion keywords in both English and Chinese. */
+export const ACTION_KEYWORDS = [
+    // English - past tense / conclusions
+    'Implemented',
+    'Refactored',
+    'Confirmed',
+    'Completed',
+    'Decided',
+    'Changed',
+    'Updated',
+    'Removed',
+    'Fixed',
+    'Added',
+    'Done',
+    // English - planning / status
+    'Next step',
+    'Next',
+    'Blocker',
+    'Blocked by',
+    'Blocked',
+    'Result',
+    'Results',
+    'Summary',
+    'Status',
+    'Objective',
+    'Plan',
+    'Goal',
+    'Action',
+    'Actions',
+    'Note',
+    'Notes',
+    // Chinese - past tense / conclusions
+    '已完成',
+    '完成',
+    '修复了',
+    '修复',
+    '添加了',
+    '添加',
+    '删除了',
+    '删除',
+    '更新了',
+    '更新',
+    '决定了',
+    '决定',
+    '确认了',
+    '确认',
+    '实现了',
+    '实现',
+    '重构了',
+    '重构',
+    // Chinese - planning / status
+    '下一步',
+    '阻塞项',
+    '阻塞',
+    '被阻塞',
+    '原因',
+    '结果',
+    '状态',
+    '注意',
+    '计划',
+    '目标',
+    '行动',
+    '备注',
+];
+/** Markdown headings that group the following list items into categories. */
+export const CATEGORY_HEADINGS = {
+    focus: ['Current Focus', '当前任务', '当前聚焦', 'Focus'],
+    completed: ['Completed', 'Done', '已完成', '完成'],
+    next: ['Next Steps', 'Next', '下一步', '后续'],
+    blockers: ['Blockers', 'Blocked', '阻塞', '阻塞项', 'Blocked by'],
+    status: ['Status', '当前状态', '状态'],
+    summary: ['Summary', '总结', '摘要'],
+    decisions: ['Decisions', '决定', '决策'],
+    notes: ['Notes', '备注', 'Note'],
+};
+/** Slicing limits used during extraction and search. */
+export const LIMITS = {
+    /** Max length of the user text snippet included in the summary. */
+    userText: 200,
+    /** Max length of the agent lead sentence included in the summary. */
+    agentLead: 120,
+    /** Max number of extracted facts stored per turn. */
+    facts: 8,
+    /** Max number of fallback notes stored per turn. */
+    notes: 8,
+    /** Max number of file entities stored per turn. */
+    files: 10,
+    /** Max number of tool entities stored per turn. */
+    tools: 10,
+    /** Max number of error entities stored per turn. */
+    errors: 5,
+    /** Max length of a single error snippet. */
+    errorSnippet: 200,
+    /** Default max number of search matches returned. */
+    searchResultLimit: 100,
+    /** Multiplier used to fetch extra candidates before ranking search results. */
+    searchCandidateMultiplier: 4,
+};
+/** Helpers for ISO date boundary formatting used in SQL queries. */
+export const DATE_FORMAT = {
+    dayStart: (date) => `${date}T00:00:00.000Z`,
+    dayEnd: (date) => `${date}T23:59:59.999Z`,
+};
+//# sourceMappingURL=constants.js.map

package/dist/refine/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/refine/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gEAAgE;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,qCAAqC;IACrC,aAAa;IACb,YAAY;IACZ,WAAW;IACX,WAAW;IACX,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,OAAO;IACP,OAAO;IACP,MAAM;IACN,8BAA8B;IAC9B,WAAW;IACX,MAAM;IACN,SAAS;IACT,YAAY;IACZ,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;IACT,QAAQ;IACR,WAAW;IACX,MAAM;IACN,MAAM;IACN,QAAQ;IACR,SAAS;IACT,MAAM;IACN,OAAO;IACP,qCAAqC;IACrC,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,8BAA8B;IAC9B,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;CACL,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAA6B;IACzD,KAAK,EAAE,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;IACjD,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC;IAC7C,IAAI,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC;IACzC,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,CAAC;IAC5D,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC;IAChC,OAAO,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC;IAChC,SAAS,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC;IACpC,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,wDAAwD;AACxD,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,mEAAmE;IACnE,QAAQ,EAAE,GAAG;IACb,qEAAqE;IACrE,SAAS,EAAE,GAAG;IACd,qDAAqD;IACrD,KAAK,EAAE,CAAC;IACR,oDAAoD;IACpD,KAAK,EAAE,CAAC;IACR,mDAAmD;IACnD,KAAK,EAAE,EAAE;IACT,mDAAmD;IACnD,KAAK,EAAE,EAAE;IACT,oDAAoD;IACpD,MAAM,EAAE,CAAC;IACT,4CAA4C;IAC5C,YAAY,EAAE,GAAG;IACjB,qDAAqD;IACrD,iBAAiB,EAAE,GAAG;IACtB,+EAA+E;IAC/E,yBAAyB,EAAE,CAAC;CAC7B,CAAC;AAEF,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,QAAQ,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,GAAG,IAAI,gBAAgB;IAC3D,MAAM,EAAE,CAAC,IAAY,EAAU,EAAE,CAAC,GAAG,IAAI,gBAAgB;CAC1D,CAAC"}

package/dist/refine/extractor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Pure turn extraction logic.
+ *
+ * Converts a RawTurn into a RefinedTurn using deterministic, local rules:
+ * action keywords, category headings, list items, and lightweight entity
+ * extraction. No LLM is involved.
+ */
+import type { RawTurn, RefinedTurn } from './types.js';
+/**
+ * Extract a RefinedTurn from a RawTurn.
+ */
+export declare function extract(turn: RawTurn, sessionId: string): RefinedTurn;

package/dist/refine/extractor.js

@@ -0,0 +1,122 @@
+/**
+ * Pure turn extraction logic.
+ *
+ * Converts a RawTurn into a RefinedTurn using deterministic, local rules:
+ * action keywords, category headings, list items, and lightweight entity
+ * extraction. No LLM is involved.
+ */
+import { ACTION_KEYWORDS, LIMITS } from './constants.js';
+import { extractEntitiesFromAction } from '../utils/action-entities.js';
+import { matchCategory } from '../utils/headings.js';
+function buildActionRegex() {
+    // Sort longer phrases first so "Next step" wins over "Next".
+    const sorted = [...ACTION_KEYWORDS].sort((a, b) => b.length - a.length);
+    const escaped = sorted.map((k) => k.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+    // Support both English colon and Chinese full-width colon, optional whitespace.
+    return new RegExp(`^(?:${escaped.join('|')})(：|:)?\\s*`, 'i');
+}
+const ACTION_REGEX = buildActionRegex();
+const HEADING_REGEX = /^(#{1,6})\s+(.+?)(?:\s+[:：])?\s*$/;
+function isSentenceLike(text) {
+    if (text.length < 10 || text.length > LIMITS.userText)
+        return false;
+    // End with sentence terminator or colon.
+    return /[.。!！?？:：]$/.test(text);
+}
+function pickAgentLead(agentText) {
+    const first = agentText.split(/\r?\n/).find((line) => line.trim().length > 0);
+    if (!first)
+        return null;
+    const trimmed = first.trim();
+    return trimmed.length > 0 && trimmed.length <= LIMITS.agentLead && !trimmed.startsWith('#')
+        ? trimmed
+        : null;
+}
+/**
+ * Extract a RefinedTurn from a RawTurn.
+ */
+export function extract(turn, sessionId) {
+    const files = new Set();
+    const tools = new Set();
+    const errors = new Set();
+    for (const action of turn.actions || []) {
+        const { files: actionFiles, tools: actionTools, errors: actionErrors } = extractEntitiesFromAction(action);
+        for (const file of actionFiles)
+            files.add(file);
+        for (const tool of actionTools)
+            tools.add(tool);
+        for (const error of actionErrors)
+            errors.add(error);
+    }
+    const userText = (turn.user || '').slice(0, LIMITS.userText).trim();
+    const toolNames = Array.from(tools);
+    const agentText = turn.agentText || turn.agent || '';
+    const agentLead = pickAgentLead(agentText);
+    let summary = userText;
+    if (toolNames.length > 0) {
+        summary = `${userText ? `${userText} · ` : ''}${toolNames.join(', ')}`;
+    }
+    if (agentLead && agentLead !== userText) {
+        summary = summary ? `${summary} · ${agentLead}` : agentLead;
+    }
+    const facts = [];
+    const notes = [];
+    const categories = {};
+    let currentCategory = null;
+    const lines = String(agentText).split(/\r?\n/);
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (!line) {
+            currentCategory = null;
+            continue;
+        }
+        // Markdown / Chinese heading detection.
+        const headingMatch = line.match(HEADING_REGEX);
+        if (headingMatch) {
+            currentCategory = matchCategory(headingMatch[2]);
+            continue;
+        }
+        let extracted = null;
+        // List item.
+        if (line.startsWith('- ') || line.startsWith('* ')) {
+            extracted = line.slice(2).trim();
+        }
+        // Numbered list item like "1. xxx" or "1) xxx".
+        else if (/^(\d+)[.)]\s+/.test(line)) {
+            extracted = line.replace(/^\d+[.)]\s+/, '').trim();
+        }
+        // Action / conclusion sentence.
+        else {
+            const actionMatch = line.match(ACTION_REGEX);
+            if (actionMatch) {
+                extracted = line.slice(actionMatch[0].length).trim();
+            }
+        }
+        if (extracted) {
+            const item = extracted;
+            if (currentCategory) {
+                (categories[currentCategory] ||= []).push(item);
+            }
+            facts.push(item);
+        }
+        else if (isSentenceLike(line)) {
+            // Fallback: keep short declarative sentences that did not match keywords.
+            notes.push(line);
+        }
+    }
+    return {
+        sessionId,
+        turnId: parseInt(String(turn.turnId), 10),
+        timestamp: turn.timestamp,
+        summary,
+        facts: facts.slice(0, LIMITS.facts),
+        notes: notes.slice(0, LIMITS.notes),
+        entities: {
+            files: Array.from(files).slice(0, LIMITS.files),
+            tools: toolNames.slice(0, LIMITS.tools),
+            errors: Array.from(errors).slice(0, LIMITS.errors),
+        },
+        categories,
+    };
+}
+//# sourceMappingURL=extractor.js.map

package/dist/refine/extractor.js.map

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

package/dist/refine/store.d.ts

@@ -0,0 +1,19 @@
+/**
+ * SQLite storage for refined turns.
+ */
+import type { RefinedSearchOptions, RefinedSearchMatch, RefinedTurn } from './types.js';
+export declare class RefinedStore {
+    refinedRoot: string;
+    private dbPath;
+    private db;
+    constructor(refinedRoot: string);
+    private initDb;
+    getDbPath(): string;
+    saveRefinedTurns(sessionId: string, refinedTurns: RefinedTurn[]): void;
+    loadRefinedTurns(sessionId: string): RefinedTurn[];
+    loadRefinedTurn(sessionId: string, turnId: number): RefinedTurn | undefined;
+    searchRefinedTurns(options: RefinedSearchOptions): RefinedSearchMatch[];
+    countAll(): number;
+    listRecentTurns(limit: number): RefinedTurn[];
+    close(): void;
+}