kimi-code-memory-mcp-server 0.1.0

package/dist/tools/theme-tools.js

@@ -0,0 +1,186 @@
+/**
+ * Theme tracing tools: tag_theme, trace_theme, list_themes, refine_session_turns.
+ */
+import fs from 'fs';
+import path from 'path';
+import { sanitizeFolder, sanitizeKey, toTitle } from '../utils/validation.js';
+import { parseFrontmatter } from '../utils/frontmatter.js';
+import { findAllWorkspaceSessions, parseWireFile } from '../context/wire-context.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;
+    }
+}
+export function createThemeTools(ctx) {
+    const { storeRoot, themeManager, refinedManager } = ctx;
+    async function handleTagTheme(args) {
+        const theme = args.theme;
+        if (!theme || typeof theme !== 'string') {
+            return toolResult({ success: false, error: 'Missing or invalid "theme"' }, true);
+        }
+        const ref = {};
+        if (args.sessionId && typeof args.turnId === 'number') {
+            const allSessions = findAllWorkspaceSessions();
+            const session = allSessions.find((s) => s.sessionId === args.sessionId);
+            if (!session) {
+                return toolResult({ success: false, error: 'Session not found' }, true);
+            }
+            const { turns } = await parseWireFile(session.wire);
+            const turnExists = turns.some((t) => String(t.turnId) === String(args.turnId));
+            if (!turnExists) {
+                return toolResult({ success: false, error: 'Turn not found' }, true);
+            }
+            ref.sessionId = args.sessionId;
+            ref.turnId = args.turnId;
+        }
+        if (args.memoryKey) {
+            const memoryFolderRaw = typeof args.memoryFolder === 'string' ? args.memoryFolder : 'memory';
+            const memoryFolder = sanitizeFolder(memoryFolderRaw);
+            if (!memoryFolder) {
+                return toolResult({ success: false, error: 'Invalid memoryFolder path' }, true);
+            }
+            const sanitizedMemoryKey = sanitizeKey(args.memoryKey);
+            const memoryFilePath = path.join(storeRoot, memoryFolder, `${sanitizedMemoryKey}.md`);
+            if (!fs.existsSync(memoryFilePath)) {
+                return toolResult({ success: false, error: 'Memory not found' }, true);
+            }
+            const parsed = safeParseFile(memoryFilePath);
+            ref.memoryKey = sanitizedMemoryKey;
+            ref.folder = memoryFolder;
+            ref.title =
+                typeof args.memoryTitle === 'string'
+                    ? args.memoryTitle
+                    : String(parsed?.frontmatter?.title || toTitle(sanitizedMemoryKey));
+        }
+        if (!ref.sessionId && !ref.memoryKey) {
+            return toolResult({ success: false, error: 'Provide either sessionId+turnId or memoryKey' }, true);
+        }
+        await themeManager.addThemeAssociation(theme, ref);
+        return toolResult({ success: true, theme: sanitizeKey(theme), ref });
+    }
+    async function handleTraceTheme(args) {
+        const theme = args.theme;
+        if (!theme || typeof theme !== 'string') {
+            return toolResult({ found: false, error: 'Missing or invalid "theme"' }, true);
+        }
+        const association = themeManager.loadTheme(theme);
+        if (!association) {
+            return toolResult({ found: false, theme });
+        }
+        association.turns.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+        association.memories.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
+        const includeContent = args.includeTurnContent === true;
+        const result = {
+            found: true,
+            theme: association.theme,
+            displayName: association.displayName || association.theme,
+            createdAt: association.createdAt,
+            updatedAt: association.updatedAt,
+            turnCount: association.turns.length,
+            memoryCount: association.memories.length,
+            turns: association.turns,
+            memories: association.memories,
+        };
+        if (includeContent && association.turns.length > 0) {
+            const loadedTurns = [];
+            const allSessions = findAllWorkspaceSessions();
+            const sessionById = new Map(allSessions.map((s) => [s.sessionId, s]));
+            for (const ref of association.turns) {
+                if (!ref.sessionId || ref.turnId === undefined)
+                    continue;
+                try {
+                    const refinedTurns = refinedManager.loadRefinedTurns(ref.sessionId);
+                    const refined = refinedTurns.find((t) => String(t.turnId) === String(ref.turnId));
+                    const session = sessionById.get(ref.sessionId);
+                    let fullTurn = null;
+                    if (session) {
+                        const { turns } = await parseWireFile(session.wire);
+                        fullTurn = turns.find((t) => String(t.turnId) === String(ref.turnId));
+                    }
+                    loadedTurns.push({
+                        ...ref,
+                        refined: refined || null,
+                        content: fullTurn
+                            ? {
+                                user: fullTurn.user,
+                                agent: fullTurn.agentText || fullTurn.agent,
+                                timestamp: fullTurn.timestamp,
+                                actions: fullTurn.actions,
+                            }
+                            : null,
+                    });
+                }
+                catch (err) {
+                    loadedTurns.push({
+                        ...ref,
+                        content: null,
+                        refined: null,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+            result.turns = loadedTurns;
+        }
+        return toolResult(result);
+    }
+    function handleListThemes() {
+        return toolResult({ themes: themeManager.listThemes() });
+    }
+    async function handleRefineSessionTurns(args) {
+        let session = null;
+        const requestedSessionId = args.sessionId || args.session_id;
+        if (requestedSessionId) {
+            const allSessions = findAllWorkspaceSessions();
+            session = allSessions.find((s) => s.sessionId === requestedSessionId);
+            if (!session) {
+                return toolResult({ success: false, error: 'Session not found' }, true);
+            }
+        }
+        if (!session) {
+            const { getCurrentSessionWirePath } = await import('../context/wire-context.js');
+            session = getCurrentSessionWirePath();
+        }
+        if (!session) {
+            return toolResult({ success: false, error: 'No session wire found' }, true);
+        }
+        const { turns } = await parseWireFile(session.wire);
+        let targetTurnIds = null;
+        if (Array.isArray(args.turnIds) && args.turnIds.length > 0) {
+            targetTurnIds = new Set(args.turnIds.map((id) => parseInt(String(id), 10)));
+        }
+        let targetTurns = turns;
+        if (targetTurnIds) {
+            targetTurns = turns.filter((t) => targetTurnIds.has(parseInt(t.turnId, 10)));
+        }
+        const limit = typeof args.limit === 'number' ? Math.max(0, Math.floor(args.limit)) : null;
+        if (limit !== null && targetTurns.length > limit) {
+            targetTurns = limit === 0 ? [] : targetTurns.slice(-limit);
+        }
+        const refinedTurns = targetTurns.map((turn) => refinedManager.refineTurn({ ...turn, timestamp: turn.timestamp || undefined }, session.sessionId));
+        await refinedManager.saveRefinedTurns(session.sessionId, refinedTurns);
+        return toolResult({
+            success: true,
+            sessionId: session.sessionId,
+            refinedCount: refinedTurns.length,
+            outputPath: refinedManager.getDbPath(),
+            sample: refinedTurns.slice(0, 2),
+        });
+    }
+    return {
+        handleTagTheme,
+        handleTraceTheme,
+        handleListThemes,
+        handleRefineSessionTurns,
+    };
+}
+//# sourceMappingURL=theme-tools.js.map

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

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

package/dist/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Shared context and argument types used across tools.
+ */
+import type { IndexDao } from './dao/index.js';
+import type { MemoryStore } from './dao/memory-store.js';
+import type { ThemeManager } from './theme-manager.js';
+import type { RefinedManager } from './refined-manager.js';
+export interface Ctx {
+    cwd: string;
+    workspaceId: string;
+    storeRoot: string;
+    indexDao: IndexDao;
+    memoryStore: MemoryStore;
+    themeManager: ThemeManager;
+    refinedManager: RefinedManager;
+}
+export interface RememberArgs {
+    key: string;
+    content?: string;
+    folder?: string;
+    tags?: unknown[];
+    themes?: unknown[];
+}
+export interface RecallArgs {
+    key: string;
+    folder?: string;
+}
+export interface RecallRecentArgs {
+    n?: number;
+    folder?: string;
+    tag?: string;
+}
+export interface SearchArgs {
+    query: string;
+    folder?: string;
+}
+export interface DeleteArgs {
+    key: string;
+    folder?: string;
+}
+export interface MoveArgs {
+    key: string;
+    folder?: string;
+    toFolder: string;
+    newKey?: string;
+}
+export interface LoadWorkspaceContextArgs {
+    detailed_rounds?: number;
+    summary_rounds?: number;
+}
+export interface LoadMoreContextArgs {
+    before_turn_id?: number;
+    limit?: number;
+}
+export interface SearchContextArgs {
+    query: string;
+    date_from?: string;
+    date_to?: string;
+    limit?: number;
+    cluster_gap_seconds?: number;
+    max_cluster_size?: number;
+}
+export interface ListSearchViewsArgs {
+    limit?: number;
+}
+export interface LoadTurnContextArgs {
+    references: unknown[];
+}
+export interface TagThemeArgs {
+    theme: string;
+    sessionId?: string;
+    turnId?: number;
+    memoryKey?: string;
+    memoryFolder?: string;
+    memoryTitle?: string;
+}
+export interface TraceThemeArgs {
+    theme: string;
+    includeTurnContent?: boolean;
+}
+export interface RefineSessionTurnsArgs {
+    sessionId?: string;
+    session_id?: string;
+    turnIds?: unknown[];
+    limit?: number;
+}
+export interface OrganizeArgs {
+    content?: string;
+    sources?: unknown[];
+}
+export interface SyncWorkspaceIndexArgs {
+    folderComments?: Record<string, string>;
+}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared context and argument types used across tools.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/frontmatter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Minimal YAML frontmatter parser/stringifier for Markdown memory files.
+ */
+export type Frontmatter = Record<string, string | string[]>;
+export interface ParsedFrontmatter {
+    frontmatter: Frontmatter;
+    body: string;
+}
+export declare function parseFrontmatter(fileContent: string): ParsedFrontmatter | null;
+export declare function stringifyFrontmatter(frontmatter: Frontmatter): string;

package/dist/utils/frontmatter.js

@@ -0,0 +1,61 @@
+/**
+ * Minimal YAML frontmatter parser/stringifier for Markdown memory files.
+ */
+function stripQuotes(value) {
+    return value.replace(/^['"]|['"]$/g, '');
+}
+export function parseFrontmatter(fileContent) {
+    const normalized = fileContent.replace(/\r\n/g, '\n');
+    if (!normalized.startsWith('---\n'))
+        return null;
+    const end = normalized.indexOf('\n---', 4);
+    if (end === -1)
+        return null;
+    const fmText = normalized.slice(4, end);
+    const body = normalized.slice(end + 4).replace(/^\n+/, '');
+    const frontmatter = {};
+    let currentKey = null;
+    for (const rawLine of fmText.split('\n')) {
+        const line = rawLine.trimEnd();
+        if (!line.trim())
+            continue;
+        const listMatch = line.match(/^(\s+)-\s*(.*)$/);
+        if (listMatch && currentKey) {
+            const current = frontmatter[currentKey];
+            if (Array.isArray(current)) {
+                current.push(stripQuotes(listMatch[2].trim()));
+            }
+            continue;
+        }
+        const kvMatch = line.match(/^([^:]+):\s*(.*)$/);
+        if (kvMatch) {
+            currentKey = kvMatch[1].trim();
+            const value = kvMatch[2].trim();
+            if (value === '') {
+                frontmatter[currentKey] = [];
+            }
+            else {
+                frontmatter[currentKey] = stripQuotes(value);
+            }
+        }
+    }
+    return { frontmatter, body };
+}
+export function stringifyFrontmatter(frontmatter) {
+    let out = '---\n';
+    for (const [k, v] of Object.entries(frontmatter)) {
+        if (Array.isArray(v)) {
+            out += `${k}:\n`;
+            for (const item of v) {
+                out += `  - ${item}\n`;
+            }
+        }
+        else {
+            const safe = String(v).replace(/'/g, "''");
+            out += `${k}: '${safe}'\n`;
+        }
+    }
+    out += '---\n\n';
+    return out;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/utils/frontmatter.js.map

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

package/dist/utils/mutex.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A simple per-instance promise mutex.
+ *
+ * Operations queued through `runExclusive` are serialized: each waits for the
+ * previous one to complete before starting. This prevents read-modify-write
+ * races on shared files such as index.json, theme JSON, and refined JSONL.
+ */
+export declare class Mutex {
+    private queue;
+    runExclusive<T>(fn: () => Promise<T> | T): Promise<T>;
+}

package/dist/utils/mutex.js

@@ -0,0 +1,17 @@
+/**
+ * A simple per-instance promise mutex.
+ *
+ * Operations queued through `runExclusive` are serialized: each waits for the
+ * previous one to complete before starting. This prevents read-modify-write
+ * races on shared files such as index.json, theme JSON, and refined JSONL.
+ */
+export class Mutex {
+    queue = Promise.resolve();
+    runExclusive(fn) {
+        const task = this.queue.then(() => fn(), () => fn());
+        // Keep a non-rejecting reference so one failed operation does not block the queue.
+        this.queue = task.then(() => { }, () => { });
+        return task;
+    }
+}
+//# sourceMappingURL=mutex.js.map

package/dist/utils/mutex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutex.js","sourceRoot":"","sources":["../../src/utils/mutex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,OAAO,KAAK;IACR,KAAK,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEpD,YAAY,CAAI,EAAwB;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAC1B,GAAG,EAAE,CAAC,EAAE,EAAE,EACV,GAAG,EAAE,CAAC,EAAE,EAAE,CACX,CAAC;QACF,mFAAmF;QACnF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CACpB,GAAG,EAAE,GAAE,CAAC,EACR,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Path and workspace hashing helpers.
+ */
+export declare const homedir: string;
+export declare function computeWorkspaceHash(cwd: string): string;
+export declare function computeWorkspaceId(cwd: string): string;
+export declare function getProjectRoot(): string;
+export declare function relativeStorePath(storeRoot: string, filePath: string): string;
+/**
+ * Resolve path segments under a base directory and verify the result does not
+ * escape the base directory (path traversal protection).
+ */
+export declare function safeResolve(base: string, ...segments: string[]): string;
+export declare function isPathInside(parent: string, child: string): boolean;
+/**
+ * Atomically write a file by writing to a temp file and renaming it into place.
+ * The target directory is created if it does not exist.
+ */
+export declare function atomicWriteFile(filePath: string, content: string, encoding?: BufferEncoding): void;

package/dist/utils/paths.js

@@ -0,0 +1,54 @@
+/**
+ * Path and workspace hashing helpers.
+ */
+import os from 'os';
+import path from 'path';
+import fs from 'fs';
+import crypto from 'crypto';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export const homedir = os.homedir();
+export function computeWorkspaceHash(cwd) {
+    const normalized = String(cwd).replace(/\\/g, '/');
+    return crypto.createHash('sha256').update(normalized).digest('hex').slice(0, 12);
+}
+export function computeWorkspaceId(cwd) {
+    if (!cwd || cwd === homedir) {
+        return 'workspace-default';
+    }
+    return `workspace-${computeWorkspaceHash(cwd)}`;
+}
+export function getProjectRoot() {
+    return path.resolve(__dirname, '..', '..');
+}
+export function relativeStorePath(storeRoot, filePath) {
+    return path.relative(storeRoot, filePath).replace(/\\/g, '/');
+}
+/**
+ * Resolve path segments under a base directory and verify the result does not
+ * escape the base directory (path traversal protection).
+ */
+export function safeResolve(base, ...segments) {
+    const resolvedBase = path.resolve(base);
+    const resolved = path.resolve(resolvedBase, ...segments);
+    const relative = path.relative(resolvedBase, resolved);
+    if (relative.startsWith('..') || path.isAbsolute(relative)) {
+        throw new Error(`Path escapes base directory: ${segments.join('/')}`);
+    }
+    return resolved;
+}
+export function isPathInside(parent, child) {
+    const relative = path.relative(path.resolve(parent), path.resolve(child));
+    return !relative.startsWith('..') && !path.isAbsolute(relative);
+}
+/**
+ * Atomically write a file by writing to a temp file and renaming it into place.
+ * The target directory is created if it does not exist.
+ */
+export function atomicWriteFile(filePath, content, encoding = 'utf8') {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    const tmpPath = filePath + '.tmp';
+    fs.writeFileSync(tmpPath, content, encoding);
+    fs.renameSync(tmpPath, filePath);
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Input sanitization helpers.
+ */
+export declare function sanitizeKey(key: unknown): string;
+/**
+ * Sanitize and validate a folder path.
+ *
+ * Rules:
+ * - Backslashes are normalized to forward slashes.
+ * - Absolute paths, parent traversal, or characters outside [a-zA-Z0-9_\-/] are rejected.
+ * - Leading/trailing slashes are trimmed.
+ * - An empty or missing value defaults to 'memory'.
+ */
+export declare function sanitizeFolder(folder: unknown): string | null;
+export declare function toTitle(key: unknown): string;

package/dist/utils/validation.js

@@ -0,0 +1,40 @@
+/**
+ * Input sanitization helpers.
+ */
+export function sanitizeKey(key) {
+    return (String(key)
+        .trim()
+        .replace(/[\\/:*?"<>|]/g, '_')
+        .replace(/\s+/g, '_')
+        .slice(0, 120) || 'untitled');
+}
+/**
+ * Sanitize and validate a folder path.
+ *
+ * Rules:
+ * - Backslashes are normalized to forward slashes.
+ * - Absolute paths, parent traversal, or characters outside [a-zA-Z0-9_\-/] are rejected.
+ * - Leading/trailing slashes are trimmed.
+ * - An empty or missing value defaults to 'memory'.
+ */
+export function sanitizeFolder(folder) {
+    let normalized = String(folder).replace(/\\/g, '/');
+    if (normalized.startsWith('/'))
+        return null;
+    if (normalized.includes('..'))
+        return null;
+    if (/[^a-zA-Z0-9_\-/]/.test(normalized))
+        return null;
+    normalized = normalized.replace(/^\/+|\/+$/g, '');
+    return normalized || 'memory';
+}
+export function toTitle(key) {
+    return String(key)
+        .replace(/[-_]+/g, ' ')
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .split(' ')
+        .filter(Boolean)
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+        .join(' ');
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,OAAO,CACL,MAAM,CAAC,GAAG,CAAC;SACR,IAAI,EAAE;SACN,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC;SAC7B,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,UAAU,CAC/B,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,IAAI,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,UAAU,IAAI,QAAQ,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAY;IAClC,OAAO,MAAM,CAAC,GAAG,CAAC;SACf,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAChE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Single source of truth for the MCP server runtime version.
+ *
+ * This value is kept in sync with `package.json` by `scripts/sync-version.mjs`
+ * during the build/publish flow. The runtime version is reported to MCP clients
+ * during protocol initialization and must match the repository (package)
+ * version unless explicitly noted otherwise.
+ */
+export declare const VERSION = "0.1.0";

package/dist/version.js

@@ -0,0 +1,10 @@
+/**
+ * Single source of truth for the MCP server runtime version.
+ *
+ * This value is kept in sync with `package.json` by `scripts/sync-version.mjs`
+ * during the build/publish flow. The runtime version is reported to MCP clients
+ * during protocol initialization and must match the repository (package)
+ * version unless explicitly noted otherwise.
+ */
+export const VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}