@vheins/local-memory-mcp 0.1.0

package/dist/tools/schemas.js

@@ -0,0 +1,251 @@
+import { z } from "zod";
+// Shared schema components
+export const MemoryScopeSchema = z.object({
+    repo: z.string().min(1),
+    branch: z.string().optional(),
+    folder: z.string().optional(),
+    language: z.string().optional()
+});
+export const MemoryTypeSchema = z.enum(["code_fact", "decision", "mistake", "pattern"]);
+// Tool schemas
+export const MemoryStoreSchema = z.object({
+    type: MemoryTypeSchema,
+    title: z.string().min(3).max(100),
+    content: z.string().min(10),
+    importance: z.number().min(1).max(5),
+    scope: MemoryScopeSchema,
+    ttlDays: z.number().min(1).optional()
+});
+export const MemoryUpdateSchema = z.object({
+    id: z.string().uuid(),
+    title: z.string().min(3).max(100).optional(),
+    content: z.string().min(10).optional(),
+    importance: z.number().min(1).max(5).optional()
+}).refine((data) => data.content !== undefined || data.title !== undefined || data.importance !== undefined, { message: "At least one of title, content or importance must be provided" });
+export const MemorySearchSchema = z.object({
+    query: z.string().min(3),
+    prompt: z.string().optional(),
+    repo: z.string().min(1),
+    types: z.array(MemoryTypeSchema).optional(),
+    minImportance: z.number().min(1).max(5).optional(),
+    limit: z.number().min(1).max(10).default(5),
+    includeRecap: z.boolean().default(false)
+});
+export const MemoryRecapSchema = z.object({
+    repo: z.string().min(1),
+    limit: z.number().min(1).max(50).default(20),
+    offset: z.number().min(0).default(0)
+});
+export const MemorySummarizeSchema = z.object({
+    repo: z.string().min(1),
+    signals: z.array(z.string().max(200)).min(1)
+});
+// Tool definitions for MCP
+export const TOOL_DEFINITIONS = [
+    {
+        name: "memory-store",
+        description: "Store a new memory entry that affects future behavior",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type: {
+                    type: "string",
+                    enum: ["code_fact", "decision", "mistake", "pattern"],
+                    description: "Type of memory being stored"
+                },
+                title: {
+                    type: "string",
+                    minLength: 3,
+                    maxLength: 100,
+                    description: "Short title for the memory (required)"
+                },
+                content: {
+                    type: "string",
+                    minLength: 10,
+                    description: "The memory content (must be durable knowledge)"
+                },
+                importance: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 5,
+                    description: "Importance score (1-5)"
+                },
+                scope: {
+                    type: "object",
+                    properties: {
+                        repo: {
+                            type: "string",
+                            description: "Repository name (required)"
+                        },
+                        branch: {
+                            type: "string",
+                            description: "Git branch (optional)"
+                        },
+                        folder: {
+                            type: "string",
+                            description: "Specific folder path (optional)"
+                        },
+                        language: {
+                            type: "string",
+                            description: "Programming language (optional)"
+                        }
+                    },
+                    required: ["repo"]
+                },
+                ttlDays: {
+                    type: "number",
+                    minimum: 1,
+                    description: "Time-to-live in days. Memory will expire after this many days (optional)"
+                }
+            },
+            required: ["type", "title", "content", "importance", "scope"]
+        }
+    },
+    {
+        name: "memory-update",
+        description: "Update an existing memory entry",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    format: "uuid",
+                    description: "Memory entry ID"
+                },
+                title: {
+                    type: "string",
+                    minLength: 3,
+                    maxLength: 100,
+                    description: "Updated title (optional)"
+                },
+                content: {
+                    type: "string",
+                    minLength: 10,
+                    description: "Updated content (optional)"
+                },
+                importance: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 5,
+                    description: "Updated importance (optional)"
+                }
+            },
+            required: ["id"]
+        }
+    },
+    {
+        name: "memory-search",
+        description: "Search for relevant memories in the current repository",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    minLength: 3,
+                    description: "Search query"
+                },
+                prompt: {
+                    type: "string",
+                    description: "Context/prompt to help determine relevance. Use this to specify what kind of information you're looking for (optional)"
+                },
+                repo: {
+                    type: "string",
+                    description: "Repository name (required)"
+                },
+                types: {
+                    type: "array",
+                    items: {
+                        type: "string",
+                        enum: ["code_fact", "decision", "mistake", "pattern"]
+                    },
+                    description: "Filter by memory types (optional)"
+                },
+                minImportance: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 5,
+                    description: "Minimum importance score (optional)"
+                },
+                limit: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 10,
+                    default: 5,
+                    description: "Maximum number of results"
+                },
+                includeRecap: {
+                    type: "boolean",
+                    default: false,
+                    description: "Include recent memories recap context in the response (optional, default false)"
+                }
+            },
+            required: ["query", "repo"]
+        }
+    },
+    {
+        name: "memory-summarize",
+        description: "Update the summary for a repository",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name"
+                },
+                signals: {
+                    type: "array",
+                    items: {
+                        type: "string",
+                        maxLength: 200
+                    },
+                    minItems: 1,
+                    description: "High-level signals to include in summary"
+                }
+            },
+            required: ["repo", "signals"]
+        }
+    },
+    {
+        name: "memory-delete",
+        description: "Soft-delete a memory entry (remove from active use)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                id: {
+                    type: "string",
+                    format: "uuid",
+                    description: "Memory entry ID to delete"
+                }
+            },
+            required: ["id"]
+        }
+    },
+    {
+        name: "memory-recap",
+        description: "Get the last 20 memories from a repository for context",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repo: {
+                    type: "string",
+                    description: "Repository name (required)"
+                },
+                limit: {
+                    type: "number",
+                    minimum: 1,
+                    maximum: 50,
+                    default: 20,
+                    description: "Maximum number of memories to retrieve"
+                },
+                offset: {
+                    type: "number",
+                    minimum: 0,
+                    default: 0,
+                    description: "Number of memories to skip for pagination (optional, default 0)"
+                }
+            },
+            required: ["repo"]
+        }
+    }
+];
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,31 @@
+export type MemoryType = "code_fact" | "decision" | "mistake" | "pattern";
+export type MemoryScope = {
+    repo: string;
+    branch?: string;
+    folder?: string;
+    language?: string;
+};
+export type MemoryEntry = {
+    id: string;
+    type: MemoryType;
+    title?: string;
+    content: string;
+    importance: number;
+    scope: MemoryScope;
+    created_at: string;
+    updated_at: string;
+    hit_count: number;
+    recall_count: number;
+    last_used_at: string | null;
+    expires_at: string | null;
+};
+export type VectorResult = {
+    id: string;
+    score: number;
+};
+export interface VectorStore {
+    upsert(id: string, text: string): Promise<void>;
+    remove(id: string): Promise<void>;
+    search(query: string, limit: number): Promise<VectorResult[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1E,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC/D"}

package/dist/types.js

@@ -0,0 +1,3 @@
+// Shared types for MCP Local Memory
+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,oCAAoC"}

package/dist/utils/git-scope.d.ts

@@ -0,0 +1,8 @@
+export declare function resolveGitScope(cwd?: string): {
+    repo: string;
+    branch: string | undefined;
+} | {
+    repo: string;
+    branch?: undefined;
+};
+//# sourceMappingURL=git-scope.d.ts.map

package/dist/utils/git-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-scope.d.ts","sourceRoot":"","sources":["../../src/utils/git-scope.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,GAAG,SAAgB;;;;;;EAsClD"}

package/dist/utils/git-scope.js

@@ -0,0 +1,38 @@
+import { execSync } from "child_process";
+import path from "path";
+export function resolveGitScope(cwd = process.cwd()) {
+    // 1. Try git root
+    try {
+        const root = execSync("git rev-parse --show-toplevel", {
+            cwd,
+            stdio: ["ignore", "pipe", "ignore"]
+        })
+            .toString()
+            .trim();
+        const repo = path.basename(root);
+        let branch;
+        try {
+            branch = execSync("git rev-parse --abbrev-ref HEAD", {
+                cwd,
+                stdio: ["ignore", "pipe", "ignore"]
+            })
+                .toString()
+                .trim();
+        }
+        catch { }
+        return {
+            repo,
+            branch
+        };
+    }
+    catch { }
+    // 2. Fallback: project folder
+    const fallback = path.basename(cwd);
+    if (fallback) {
+        return {
+            repo: fallback
+        };
+    }
+    throw new Error("Unable to resolve project scope (no git repo, no folder)");
+}
+//# sourceMappingURL=git-scope.js.map

package/dist/utils/git-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-scope.js","sourceRoot":"","sources":["../../src/utils/git-scope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,UAAU,eAAe,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IACjD,kBAAkB;IAClB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,+BAA+B,EAAE;YACrD,GAAG;YACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC;aACC,QAAQ,EAAE;aACV,IAAI,EAAE,CAAC;QAEV,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEjC,IAAI,MAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,GAAG,QAAQ,CAAC,iCAAiC,EAAE;gBACnD,GAAG;gBACH,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;aACpC,CAAC;iBACC,QAAQ,EAAE;iBACV,IAAI,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QAEV,OAAO;YACL,IAAI;YACJ,MAAM;SACP,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC,CAAA,CAAC;IAEV,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO;YACL,IAAI,EAAE,QAAQ;SACf,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;AAC9E,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: {
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAuCA,eAAO,MAAM,MAAM;mBACF,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;kBAGjD,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;kBAGhD,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;mBAG/C,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGhE,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,40 @@
+// Structured logger — outputs JSON to stderr
+// Requirements: 21.1, 21.2
+const LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+function parseLevel(raw) {
+    if (raw && raw in LEVELS)
+        return raw;
+    return "info";
+}
+const configuredLevel = parseLevel(process.env.LOG_LEVEL?.toLowerCase());
+function log(level, message, context) {
+    if (LEVELS[level] < LEVELS[configuredLevel])
+        return;
+    const entry = {
+        level,
+        timestamp: new Date().toISOString(),
+        message,
+        ...(context !== undefined ? { context } : {}),
+    };
+    process.stderr.write(JSON.stringify(entry) + "\n");
+}
+export const logger = {
+    debug(message, context) {
+        log("debug", message, context);
+    },
+    info(message, context) {
+        log("info", message, context);
+    },
+    warn(message, context) {
+        log("warn", message, context);
+    },
+    error(message, context) {
+        log("error", message, context);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,2BAA2B;AAW3B,MAAM,MAAM,GAA6B;IACvC,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,SAAS,UAAU,CAAC,GAAuB;IACzC,IAAI,GAAG,IAAI,GAAG,IAAI,MAAM;QAAE,OAAO,GAAe,CAAC;IACjD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,eAAe,GAAa,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;AAEnF,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,OAAiC;IAC9E,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,eAAe,CAAC;QAAE,OAAO;IAEpD,MAAM,KAAK,GAAa;QACtB,KAAK;QACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO;QACP,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC;IAEF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,CAAC,OAAe,EAAE,OAAiC;QACtD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,OAAiC;QACrD,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,OAAiC;QACrD,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,OAAiC;QACtD,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;CACF,CAAC"}

package/dist/utils/logger.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.test.d.ts.map

package/dist/utils/logger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../src/utils/logger.test.ts"],"names":[],"mappings":""}

package/dist/utils/logger.test.js

@@ -0,0 +1,84 @@
+// Feature: memory-mcp-optimization
+// Property 20: StructuredLogger output adalah JSON valid dengan field wajib
+// Validates: Requirements 21.1, 21.2
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import * as fc from "fast-check";
+describe("Property 20: StructuredLogger output adalah JSON valid dengan field wajib", () => {
+    let stderrOutput = [];
+    let stderrSpy;
+    beforeEach(() => {
+        stderrOutput = [];
+        stderrSpy = vi.spyOn(process.stderr, "write").mockImplementation((chunk) => {
+            stderrOutput.push(typeof chunk === "string" ? chunk : chunk.toString());
+            return true;
+        });
+        // Reset LOG_LEVEL to ensure all levels are logged
+        process.env.LOG_LEVEL = "debug";
+    });
+    afterEach(() => {
+        stderrSpy.mockRestore();
+        delete process.env.LOG_LEVEL;
+    });
+    it("each log call produces valid JSON output with required fields", async () => {
+        // Re-import logger after setting LOG_LEVEL
+        const { logger } = await import("./logger.js?t=" + Date.now());
+        fc.assert(fc.property(fc.oneof(fc.constant("debug"), fc.constant("info"), fc.constant("warn"), fc.constant("error")), fc.string({ minLength: 1, maxLength: 100 }), (level, message) => {
+            stderrOutput = [];
+            logger[level](message);
+            expect(stderrOutput.length).toBeGreaterThanOrEqual(1);
+            const lastOutput = stderrOutput[stderrOutput.length - 1];
+            // Must be parseable JSON
+            let parsed;
+            expect(() => {
+                parsed = JSON.parse(lastOutput.trim());
+            }).not.toThrow();
+            parsed = JSON.parse(lastOutput.trim());
+            // Must have required fields
+            expect(parsed).toHaveProperty("level");
+            expect(parsed).toHaveProperty("timestamp");
+            expect(parsed).toHaveProperty("message");
+            // level must match
+            expect(parsed.level).toBe(level);
+            // message must match
+            expect(parsed.message).toBe(message);
+            // timestamp must be ISO 8601
+            expect(typeof parsed.timestamp).toBe("string");
+            const ts = new Date(parsed.timestamp);
+            expect(isNaN(ts.getTime())).toBe(false);
+        }), { numRuns: 100 });
+    });
+    it("log output with context includes context field", async () => {
+        const { logger } = await import("./logger.js?t=" + Date.now() + "ctx");
+        stderrOutput = [];
+        logger.info("test message", { key: "value", count: 42 });
+        expect(stderrOutput.length).toBeGreaterThanOrEqual(1);
+        const lastOutput = stderrOutput[stderrOutput.length - 1];
+        const parsed = JSON.parse(lastOutput.trim());
+        expect(parsed).toHaveProperty("context");
+        expect(parsed.context).toEqual({ key: "value", count: 42 });
+    });
+    it("log output without context does not include context field", async () => {
+        const { logger } = await import("./logger.js?t=" + Date.now() + "noctx");
+        stderrOutput = [];
+        logger.info("no context message");
+        expect(stderrOutput.length).toBeGreaterThanOrEqual(1);
+        const lastOutput = stderrOutput[stderrOutput.length - 1];
+        const parsed = JSON.parse(lastOutput.trim());
+        expect(parsed).not.toHaveProperty("context");
+    });
+    it("all four log levels produce valid JSON with correct level field", async () => {
+        const { logger } = await import("./logger.js?t=" + Date.now() + "levels");
+        const levels = ["debug", "info", "warn", "error"];
+        for (const level of levels) {
+            stderrOutput = [];
+            logger[level](`test ${level} message`);
+            expect(stderrOutput.length).toBeGreaterThanOrEqual(1);
+            const lastOutput = stderrOutput[stderrOutput.length - 1];
+            const parsed = JSON.parse(lastOutput.trim());
+            expect(parsed.level).toBe(level);
+            expect(parsed.message).toBe(`test ${level} message`);
+            expect(typeof parsed.timestamp).toBe("string");
+        }
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/dist/utils/logger.test.js.map

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

package/dist/utils/mcp-response.d.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+export declare const McpContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    data: z.ZodString;
+    mimeType: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"resource">;
+    resource: z.ZodObject<{
+        uri: z.ZodString;
+        mimeType: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+export type McpContent = z.infer<typeof McpContentSchema>;
+export type McpResponse = {
+    content: McpContent[];
+};
+export declare function createMcpResponse(data: unknown, summary: string, options?: {
+    query?: string;
+    results?: Array<{
+        id: string;
+        type: string;
+        title?: string;
+        content: string;
+        importance?: number;
+        scope?: {
+            repo: string;
+            folder?: string;
+            language?: string;
+        };
+        created_at?: string;
+        updated_at?: string;
+        hit_count?: number;
+        recall_count?: number;
+        last_used_at?: string | null;
+        expires_at?: string | null;
+    }>;
+}): McpResponse;
+export declare function createTextOnlyResponse(text: string): McpResponse;
+export declare function isMcpResponse(obj: unknown): obj is McpResponse;
+//# sourceMappingURL=mcp-response.d.ts.map

package/dist/utils/mcp-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-response.d.ts","sourceRoot":"","sources":["../../src/utils/mcp-response.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;2BAkB3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC,CAAA;CACH,GACA,WAAW,CA2Cb;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAShE;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,WAAW,CAW9D"}

package/dist/utils/mcp-response.js

@@ -0,0 +1,81 @@
+import { z } from "zod";
+export const McpContentSchema = z.discriminatedUnion("type", [
+    z.object({
+        type: z.literal("text"),
+        text: z.string(),
+    }),
+    z.object({
+        type: z.literal("image"),
+        data: z.string(),
+        mimeType: z.string(),
+    }),
+    z.object({
+        type: z.literal("resource"),
+        resource: z.object({
+            uri: z.string(),
+            mimeType: z.string().optional(),
+            text: z.string().optional(),
+        }),
+    }),
+]);
+export function createMcpResponse(data, summary, options) {
+    const { query, results } = options || {};
+    const content = [
+        {
+            type: "text",
+            text: summary,
+        },
+    ];
+    // Add resource for each result with embedded content
+    if (results && results.length > 0) {
+        for (const result of results) {
+            const resultId = Buffer.from(result.id).toString('base64').substring(0, 8);
+            // Generate title from content if not present
+            const title = result.title || (result.content.length > 50 ? result.content.substring(0, 50) + '...' : result.content);
+            content.push({
+                type: "resource",
+                resource: {
+                    uri: `memory://${resultId}`,
+                    mimeType: "application/json",
+                    text: JSON.stringify({
+                        id: result.id,
+                        type: result.type,
+                        title: title,
+                        content: result.content,
+                        importance: result.importance,
+                        scope: result.scope,
+                        created_at: result.created_at,
+                        updated_at: result.updated_at,
+                        hit_count: result.hit_count,
+                        recall_count: result.recall_count,
+                        last_used_at: result.last_used_at,
+                        expires_at: result.expires_at
+                    })
+                }
+            });
+        }
+    }
+    return { content };
+}
+export function createTextOnlyResponse(text) {
+    return {
+        content: [
+            {
+                type: "text",
+                text,
+            },
+        ],
+    };
+}
+export function isMcpResponse(obj) {
+    if (typeof obj !== "object" || obj === null)
+        return false;
+    const response = obj;
+    if (!Array.isArray(response.content))
+        return false;
+    return response.content.every((item) => typeof item === "object" &&
+        item !== null &&
+        "type" in item &&
+        typeof item.type === "string");
+}
+//# sourceMappingURL=mcp-response.js.map