@codemem/mcp 0.35.2 → 0.36.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -1,2 +1,2 @@
1
- import { t as e } from "./server-Djvf0Yik.js";
1
+ import { t as e } from "./server-BH_IcTFq.js";
2
2
  export { e as createCodememMcpServer };
@@ -485,4 +485,4 @@ function O(t, n = {}) {
485
485
  //#endregion
486
486
  export { O as t };
487
487
 
488
- //# sourceMappingURL=server-Djvf0Yik.js.map
488
+ //# sourceMappingURL=server-BH_IcTFq.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"server-Djvf0Yik.js","names":[],"sources":["../src/project-scope.ts","../src/content.ts","../src/memory-access.ts","../src/schemas.ts","../src/tools/items.ts","../src/tools/learn.ts","../src/memory-kinds.ts","../src/tools/schema.ts","../src/tools/search.ts","../src/tools/timeline.ts","../src/server.ts"],"sourcesContent":["import { type MemoryFilters, resolveProject } from \"@codemem/core\";\n\nfunction cleanProject(value: string | null | undefined): string | null {\n\tconst trimmed = value?.trim();\n\treturn trimmed ? trimmed : null;\n}\n\nexport function resolveDefaultProject(): string | null {\n\treturn cleanProject(process.env.CODEMEM_PROJECT) ?? resolveProject(process.cwd());\n}\n\nexport function resolveWriteProject(input: {\n\tproject?: string | null;\n\tenvProject?: string | null;\n}): string | null {\n\treturn cleanProject(input.project) ?? cleanProject(input.envProject) ?? null;\n}\n\nexport function buildFilters(\n\traw: Record<string, unknown>,\n\tdefaultProject = resolveDefaultProject(),\n): MemoryFilters | undefined {\n\tconst filters: MemoryFilters = {};\n\tlet hasAny = false;\n\n\tconst explicitProject = typeof raw.project === \"string\" ? cleanProject(raw.project) : undefined;\n\tconst resolvedProject = explicitProject || cleanProject(defaultProject) || undefined;\n\tif (resolvedProject) {\n\t\tfilters.project = resolvedProject;\n\t\thasAny = true;\n\t}\n\n\tfor (const key of [\n\t\t\"kind\",\n\t\t\"visibility\",\n\t\t\"scope_id\",\n\t\t\"include_scope_ids\",\n\t\t\"exclude_scope_ids\",\n\t\t\"include_visibility\",\n\t\t\"exclude_visibility\",\n\t\t\"include_workspace_ids\",\n\t\t\"exclude_workspace_ids\",\n\t\t\"include_workspace_kinds\",\n\t\t\"exclude_workspace_kinds\",\n\t\t\"include_actor_ids\",\n\t\t\"exclude_actor_ids\",\n\t\t\"include_trust_states\",\n\t\t\"exclude_trust_states\",\n\t\t\"ownership_scope\",\n\t\t\"personal_first\",\n\t\t\"trust_bias\",\n\t\t\"widen_shared_when_weak\",\n\t\t\"widen_shared_min_personal_results\",\n\t\t\"widen_shared_min_personal_score\",\n\t] as const) {\n\t\tconst val = raw[key];\n\t\tif (val !== undefined && val !== null) {\n\t\t\t(filters as Record<string, unknown>)[key] = val;\n\t\t\thasAny = true;\n\t\t}\n\t}\n\n\treturn hasAny ? filters : undefined;\n}\n","export function jsonContent(data: unknown) {\n\treturn { content: [{ type: \"text\" as const, text: JSON.stringify(data) }] };\n}\n\nexport function errorContent(message: string) {\n\treturn { content: [{ type: \"text\" as const, text: JSON.stringify({ error: message }) }] };\n}\n","import {\n\ttype MemoryFilters,\n\ttype MemoryItemResponse,\n\ttype MemoryStore,\n\ttoJson,\n} from \"@codemem/core\";\nimport { resolveWriteProject } from \"./project-scope.js\";\n\nexport function getMemoryForMcp(\n\tstore: MemoryStore,\n\tmemoryId: number,\n\tfilters?: MemoryFilters,\n): MemoryItemResponse | null {\n\tconst rows = store.timeline(null, memoryId, 0, 0, filters ?? null);\n\treturn rows.find((row) => row.id === memoryId) ?? null;\n}\n\nexport function getManyForMcp(\n\tstore: MemoryStore,\n\tids: number[],\n\tfilters?: MemoryFilters,\n): MemoryItemResponse[] {\n\tif (ids.length === 0) return [];\n\tconst results: MemoryItemResponse[] = [];\n\tfor (const id of ids) {\n\t\tconst item = getMemoryForMcp(store, id, filters);\n\t\tif (item) results.push(item);\n\t}\n\treturn results;\n}\n\nexport function forgetMemoryForMcp(\n\tstore: MemoryStore,\n\tmemoryId: number,\n\tfilters?: MemoryFilters,\n): boolean {\n\tconst item = getMemoryForMcp(store, memoryId, filters);\n\tif (!item) return false;\n\tstore.forget(memoryId);\n\treturn true;\n}\n\nexport interface RememberMemoryForMcpInput {\n\tkind: string;\n\ttitle: string;\n\tbody: string;\n\tconfidence: number;\n\tproject?: string | null;\n}\n\nexport interface RememberMemoryForMcpContext {\n\tcwd?: string;\n\tuser?: string;\n\tenvProject?: string | null;\n\tnow?: () => string;\n}\n\nexport function rememberMemoryForMcp(\n\tstore: MemoryStore,\n\tinput: RememberMemoryForMcpInput,\n\tcontext: RememberMemoryForMcpContext = {},\n): { memId: number; title: string; body: string } {\n\treturn store.db.transaction(() => {\n\t\tconst now = context.now?.() ?? new Date().toISOString();\n\t\tconst user = context.user ?? process.env.USER ?? \"unknown\";\n\t\tconst cwd = context.cwd ?? process.cwd();\n\t\tconst project = resolveWriteProject({\n\t\t\tproject: input.project,\n\t\t\tenvProject: context.envProject,\n\t\t});\n\n\t\tconst sessionInfo = store.db\n\t\t\t.prepare(\n\t\t\t\t`INSERT INTO sessions(started_at, ended_at, cwd, project, user, tool_version, metadata_json)\n\t\t\t\t VALUES (?, ?, ?, ?, ?, ?, ?)`,\n\t\t\t)\n\t\t\t.run(now, now, cwd, project, user, \"mcp-ts\", toJson({ mcp: true }));\n\t\tconst sessionId = Number(sessionInfo.lastInsertRowid);\n\n\t\tconst memId = store.remember(sessionId, input.kind, input.title, input.body, input.confidence);\n\t\tif (!getMemoryForMcp(store, memId)) {\n\t\t\tthrow new Error(\"unauthorized_scope\");\n\t\t}\n\n\t\tstore.db\n\t\t\t.prepare(\"UPDATE sessions SET ended_at = ?, metadata_json = ? WHERE id = ?\")\n\t\t\t.run(context.now?.() ?? new Date().toISOString(), toJson({ mcp: true }), sessionId);\n\n\t\treturn { memId, title: input.title, body: input.body };\n\t})();\n}\n","import { z } from \"zod\";\n\nconst scopeFilterSchema = {\n\tscope_id: z.string().optional().describe(\"Filter by a single sharing domain scope_id\"),\n\tinclude_scope_ids: z.array(z.string()).optional().describe(\"Sharing domain scope_ids to include\"),\n\texclude_scope_ids: z.array(z.string()).optional().describe(\"Sharing domain scope_ids to exclude\"),\n};\n\nexport const filterSchema = {\n\tkind: z.string().optional().describe(\"Filter by memory kind\"),\n\tproject: z.string().optional().describe(\"Filter by project scope (matches sessions.project)\"),\n\t...scopeFilterSchema,\n\tvisibility: z.array(z.string()).optional(),\n\tinclude_visibility: z.array(z.string()).optional(),\n\texclude_visibility: z.array(z.string()).optional(),\n\tinclude_workspace_ids: z.array(z.string()).optional(),\n\texclude_workspace_ids: z.array(z.string()).optional(),\n\tinclude_workspace_kinds: z.array(z.string()).optional(),\n\texclude_workspace_kinds: z.array(z.string()).optional(),\n\tinclude_actor_ids: z.array(z.string()).optional(),\n\texclude_actor_ids: z.array(z.string()).optional(),\n\tinclude_trust_states: z.array(z.string()).optional(),\n\texclude_trust_states: z.array(z.string()).optional(),\n\townership_scope: z.string().optional(),\n\tpersonal_first: z.union([z.boolean(), z.string()]).optional(),\n\ttrust_bias: z.string().optional(),\n\twiden_shared_when_weak: z.union([z.boolean(), z.string()]).optional(),\n\twiden_shared_min_personal_results: z.number().int().optional(),\n\twiden_shared_min_personal_score: z.number().optional(),\n};\n\nexport const memoryKindSchema = z.enum([\n\t\"discovery\",\n\t\"change\",\n\t\"feature\",\n\t\"bugfix\",\n\t\"refactor\",\n\t\"decision\",\n\t\"exploration\",\n]);\n\nexport const filterNames = Object.keys(filterSchema).toSorted();\n","import { storeVectors } from \"@codemem/core\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { errorContent, jsonContent } from \"../content.js\";\nimport {\n\tforgetMemoryForMcp,\n\tgetManyForMcp,\n\tgetMemoryForMcp,\n\trememberMemoryForMcp,\n} from \"../memory-access.js\";\nimport { buildFilters } from \"../project-scope.js\";\nimport { filterSchema, memoryKindSchema } from \"../schemas.js\";\nimport type { ToolRegistrationContext } from \"../tool-context.js\";\n\nexport function registerItemTools(server: McpServer, context: ToolRegistrationContext): void {\n\tconst { envProject, store } = context;\n\n\tserver.tool(\n\t\t\"memory_get\",\n\t\t\"Fetch a single memory item by ID.\",\n\t\t{\n\t\t\tmemory_id: z.number().int().describe(\"Memory ID\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\t// Direct-ID ops do not inherit the server default project. Callers already\n\t\t\t\t// have an exact ID; cwd/env should not silently scope the lookup.\n\t\t\t\tconst item = getMemoryForMcp(store, args.memory_id, buildFilters(args, null));\n\t\t\t\tif (!item) return errorContent(\"not_found\");\n\t\t\t\treturn jsonContent(item);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_get_observations\",\n\t\t\"Fetch multiple memory items by their IDs.\",\n\t\t{\n\t\t\tids: z.array(z.number().int()).max(200).describe(\"Memory IDs to fetch\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst items = getManyForMcp(store, args.ids, buildFilters(args, null));\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_remember\",\n\t\t\"Create a new memory. Use for milestones, decisions, and notable facts.\",\n\t\t{\n\t\t\tkind: memoryKindSchema.describe(\"Memory kind\"),\n\t\t\ttitle: z.string().describe(\"Short title\"),\n\t\t\tbody: z.string().describe(\"Body text (high-signal content)\"),\n\t\t\tconfidence: z.number().min(0).max(1).default(0.5).describe(\"Confidence 0-1\"),\n\t\t\tproject: z.string().optional().describe(\"Project identifier\"),\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\t// Writes never inherit the server default project. They only honor an\n\t\t\t\t// explicit `project` input or CODEMEM_PROJECT; otherwise project stays null.\n\t\t\t\tconst result = rememberMemoryForMcp(store, args, {\n\t\t\t\t\tenvProject: envProject(),\n\t\t\t\t});\n\n\t\t\t\ttry {\n\t\t\t\t\tawait storeVectors(store.db, result.memId, result.title, result.body);\n\t\t\t\t} catch {\n\t\t\t\t\t// Memory writes should succeed even if embeddings are unavailable.\n\t\t\t\t}\n\n\t\t\t\treturn jsonContent({ id: result.memId });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_forget\",\n\t\t\"Soft-delete a memory item. Use for incorrect or sensitive data.\",\n\t\t{\n\t\t\tmemory_id: z.number().int().describe(\"Memory ID to forget\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tif (!forgetMemoryForMcp(store, args.memory_id, buildFilters(args, null))) {\n\t\t\t\t\treturn errorContent(\"not_found\");\n\t\t\t\t}\n\t\t\t\treturn jsonContent({ status: \"ok\" });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n}\n","import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { jsonContent } from \"../content.js\";\n\nexport function registerLearnTools(server: McpServer): void {\n\tserver.tool(\n\t\t\"memory_learn\",\n\t\t\"Learn how to use codemem memory tools. Call this first if unfamiliar.\",\n\t\t{},\n\t\tasync () => {\n\t\t\treturn jsonContent({\n\t\t\t\tintro: \"Use this tool when you're new to codemem or unsure when to recall/persist.\",\n\t\t\t\tclient_hint: \"If you are unfamiliar with codemem, call memory.learn first.\",\n\t\t\t\trecall: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Start of a task or when the user references prior work.\",\n\t\t\t\t\t\t\"When you need background context, decisions, or recent changes.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Use memory.search_index to get compact candidates.\",\n\t\t\t\t\t\t\"Use memory.timeline to expand around a promising memory.\",\n\t\t\t\t\t\t\"Use memory.get_observations for full details only when needed.\",\n\t\t\t\t\t\t\"Use memory.pack for quick one-shot context blocks.\",\n\t\t\t\t\t\t\"Use the project filter unless the user requests cross-project context.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\n\t\t\t\t\t\t'memory.search_index(\"billing cache bug\", limit=5)',\n\t\t\t\t\t\t\"memory.timeline(memory_id=123)\",\n\t\t\t\t\t\t\"memory.get_observations([123, 456])\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tpersistence: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Milestones (task done, key decision, new facts learned).\",\n\t\t\t\t\t\t\"Notable regressions or follow-ups that should be remembered.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Use memory.remember with kind decision/discovery/change/exploration.\",\n\t\t\t\t\t\t\"Keep titles short and bodies high-signal.\",\n\t\t\t\t\t\t\"ALWAYS pass the project parameter if known.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\n\t\t\t\t\t\t'memory.remember(kind=\"decision\", title=\"Switch to async cache\", body=\"...why...\", project=\"my-service\")',\n\t\t\t\t\t\t'memory.remember(kind=\"change\", title=\"Fixed retry loop\", body=\"...impact...\", project=\"my-service\")',\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tforget: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Accidental or sensitive data stored in memory items.\",\n\t\t\t\t\t\t\"Obsolete or incorrect items that should no longer surface.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Call memory.forget(id) to mark the item inactive.\",\n\t\t\t\t\t\t\"Prefer forgetting over overwriting to preserve auditability.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\"memory.forget(123)\"],\n\t\t\t\t},\n\t\t\t\tprompt_hint:\n\t\t\t\t\t\"At task start: call memory.search_index; during work: memory.timeline + memory.get_observations; at milestones: memory.remember.\",\n\t\t\t\trecommended_system_prompt: [\n\t\t\t\t\t\"Trigger policy (1-liner): If the user references prior work or starts a task,\",\n\t\t\t\t\t\"immediately call memory.search_index; then use memory.timeline + memory.get_observations;\",\n\t\t\t\t\t\"at milestones, call memory.remember; use memory.forget for incorrect/sensitive items.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"System prompt:\",\n\t\t\t\t\t\"You have access to codemem MCP tools. If unfamiliar, call memory.learn first.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Recall:\",\n\t\t\t\t\t\"- Start of any task: call memory.search_index with a concise task query.\",\n\t\t\t\t\t'- If prior work is referenced (\"as before\", \"last time\", \"we already did…\", \"regression\"),',\n\t\t\t\t\t\" call memory.search_index or memory.timeline.\",\n\t\t\t\t\t\"- Use memory.get_observations only after filtering IDs.\",\n\t\t\t\t\t\"- Prefer project-scoped queries unless the user asks for cross-project.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Persistence:\",\n\t\t\t\t\t\"- On milestones (task done, key decision, new facts learned), call memory.remember.\",\n\t\t\t\t\t\"- Use kind=decision for tradeoffs, kind=change for outcomes, kind=discovery/exploration for useful findings.\",\n\t\t\t\t\t\"- Keep titles short and bodies high-signal.\",\n\t\t\t\t\t\"- ALWAYS pass the project parameter if known.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Safety:\",\n\t\t\t\t\t\"- Use memory.forget(id) for incorrect or sensitive items.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Examples:\",\n\t\t\t\t\t'- memory.search_index(\"billing cache bug\")',\n\t\t\t\t\t\"- memory.timeline(memory_id=123)\",\n\t\t\t\t\t\"- memory.get_observations([123, 456])\",\n\t\t\t\t\t'- memory.remember(kind=\"decision\", title=\"Use async cache\", body=\"Chose async cache to avoid lock contention in X.\", project=\"my-service\")',\n\t\t\t\t\t'- memory.remember(kind=\"change\", title=\"Fixed retry loop\", body=\"Root cause was Y; added guard in Z.\", project=\"my-service\")',\n\t\t\t\t\t\"- memory.forget(123)\",\n\t\t\t\t].join(\"\\n\"),\n\t\t\t});\n\t\t},\n\t);\n}\n","export const MEMORY_KINDS: Record<string, string> = {\n\tdiscovery: \"Something learned about the codebase, architecture, or tools\",\n\tchange: \"A code change that was made\",\n\tfeature: \"A new feature that was implemented\",\n\tbugfix: \"A bug that was found and fixed\",\n\trefactor: \"Code that was refactored or restructured\",\n\tdecision: \"A design or architecture decision\",\n\texploration: \"An experiment or investigation (may not have shipped)\",\n};\n","import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { jsonContent } from \"../content.js\";\nimport { MEMORY_KINDS } from \"../memory-kinds.js\";\nimport { filterNames } from \"../schemas.js\";\n\nexport function registerSchemaTools(server: McpServer): void {\n\tserver.tool(\n\t\t\"memory_schema\",\n\t\t\"Return the memory schema — kinds, fields, and available filters.\",\n\t\t{},\n\t\tasync () => {\n\t\t\treturn jsonContent({\n\t\t\t\tkinds: Object.keys(MEMORY_KINDS),\n\t\t\t\tkind_descriptions: MEMORY_KINDS,\n\t\t\t\tfields: {\n\t\t\t\t\ttitle: \"short text\",\n\t\t\t\t\tbody: \"long text\",\n\t\t\t\t\tsubtitle: \"short text\",\n\t\t\t\t\tfacts: \"list<string>\",\n\t\t\t\t\tnarrative: \"long text\",\n\t\t\t\t\tconcepts: \"list<string>\",\n\t\t\t\t\tfiles_read: \"list<string>\",\n\t\t\t\t\tfiles_modified: \"list<string>\",\n\t\t\t\t\tprompt_number: \"int\",\n\t\t\t\t},\n\t\t\t\tfilters: filterNames,\n\t\t\t});\n\t\t},\n\t);\n}\n","import type { MemoryResult } from \"@codemem/core\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { errorContent, jsonContent } from \"../content.js\";\nimport { buildFilters } from \"../project-scope.js\";\nimport { filterSchema } from \"../schemas.js\";\nimport type { ToolRegistrationContext } from \"../tool-context.js\";\n\nexport function registerSearchTools(server: McpServer, context: ToolRegistrationContext): void {\n\tconst { defaultProject, store } = context;\n\n\tserver.tool(\n\t\t\"memory_search\",\n\t\t\"Search memories by text query. Returns full body text for each match.\",\n\t\t{\n\t\t\tquery: z.string().describe(\"Search query\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(5).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.search(args.query, args.limit, filters);\n\t\t\t\treturn jsonContent({\n\t\t\t\t\titems: items.map((m: MemoryResult) => ({\n\t\t\t\t\t\tid: m.id,\n\t\t\t\t\t\ttitle: m.title,\n\t\t\t\t\t\tkind: m.kind,\n\t\t\t\t\t\tbody: m.body_text,\n\t\t\t\t\t\tconfidence: m.confidence,\n\t\t\t\t\t\tscore: m.score,\n\t\t\t\t\t\tsession_id: m.session_id,\n\t\t\t\t\t\tmetadata: m.metadata,\n\t\t\t\t\t})),\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_search_index\",\n\t\t\"Search memories by text query. Returns compact index entries (no body) for browsing.\",\n\t\t{\n\t\t\tquery: z.string().describe(\"Search query\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(8).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.search(args.query, args.limit, filters);\n\t\t\t\treturn jsonContent({\n\t\t\t\t\titems: items.map((m: MemoryResult) => ({\n\t\t\t\t\t\tid: m.id,\n\t\t\t\t\t\tkind: m.kind,\n\t\t\t\t\t\ttitle: m.title,\n\t\t\t\t\t\tscore: m.score,\n\t\t\t\t\t\tcreated_at: m.created_at,\n\t\t\t\t\t\tsession_id: m.session_id,\n\t\t\t\t\t\tmetadata: m.metadata,\n\t\t\t\t\t})),\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_explain\",\n\t\t\"Explain search results with detailed scoring breakdown.\",\n\t\t{\n\t\t\tquery: z.string().optional().describe(\"Search query\"),\n\t\t\tids: z.array(z.number().int()).max(200).optional().describe(\"Specific memory IDs to explain\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(10).describe(\"Max results\"),\n\t\t\tinclude_pack_context: z.boolean().default(false).describe(\"Include formatted pack context\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst result = store.explain(args.query ?? null, args.ids ?? null, args.limit, filters, {\n\t\t\t\t\tincludePackContext: args.include_pack_context,\n\t\t\t\t});\n\t\t\t\treturn jsonContent(result);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_recent\",\n\t\t\"Return recent memories, newest first.\",\n\t\t{\n\t\t\tlimit: z.number().int().min(1).max(100).default(8).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.recent(args.limit, filters);\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_pack\",\n\t\t\"Build a formatted memory pack from search results — quick one-shot context block.\",\n\t\t{\n\t\t\tcontext: z.string().describe(\"Context description to search for\"),\n\t\t\tlimit: z.number().int().min(1).max(50).optional().describe(\"Max items to include\"),\n\t\t\tcompact: z\n\t\t\t\t.boolean()\n\t\t\t\t.optional()\n\t\t\t\t.describe(\n\t\t\t\t\t\"When true, render a scannable index of all items with full detail only for the top N (default 3). Saves tokens when broad overview matters more than per-item detail.\",\n\t\t\t\t),\n\t\t\tcompact_detail_count: z\n\t\t\t\t.number()\n\t\t\t\t.int()\n\t\t\t\t.min(0)\n\t\t\t\t.max(50)\n\t\t\t\t.optional()\n\t\t\t\t.describe(\"Number of items to show in full detail in compact mode (default 3)\"),\n\t\t\tcompression_mode: z\n\t\t\t\t.enum([\"off\", \"compact\", \"ids\"])\n\t\t\t\t.optional()\n\t\t\t\t.describe(\n\t\t\t\t\t\"Near-related compression mode: off disables it, compact applies only to compact rendering, ids applies in all modes. Defaults to CODEMEM_PACK_COMPRESSION or compact.\",\n\t\t\t\t),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst renderOptions =\n\t\t\t\t\targs.compact || args.compact_detail_count != null || args.compression_mode != null\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\tcompact: args.compact ?? (args.compact_detail_count != null ? true : undefined),\n\t\t\t\t\t\t\t\tcompactDetailCount: args.compact_detail_count,\n\t\t\t\t\t\t\t\tcompressionMode: args.compression_mode,\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: undefined;\n\t\t\t\tconst result = await store.buildMemoryPackAsync(\n\t\t\t\t\targs.context,\n\t\t\t\t\targs.limit ?? undefined,\n\t\t\t\t\tnull,\n\t\t\t\t\tfilters,\n\t\t\t\t\trenderOptions,\n\t\t\t\t);\n\t\t\t\treturn jsonContent(result);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n}\n","import { dedupeOrderedIds, type MemoryItemResponse, projectMatchesFilter } from \"@codemem/core\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { errorContent, jsonContent } from \"../content.js\";\nimport { getManyForMcp } from \"../memory-access.js\";\nimport { buildFilters } from \"../project-scope.js\";\nimport { filterSchema } from \"../schemas.js\";\nimport type { ToolRegistrationContext } from \"../tool-context.js\";\n\nexport function registerTimelineTools(server: McpServer, context: ToolRegistrationContext): void {\n\tconst { defaultProject, store } = context;\n\n\tserver.tool(\n\t\t\"memory_timeline\",\n\t\t\"Get a chronological window of memories around an anchor (by ID or query).\",\n\t\t{\n\t\t\tquery: z.string().optional().describe(\"Search query to find anchor\"),\n\t\t\tmemory_id: z.number().int().optional().describe(\"Anchor memory ID\"),\n\t\t\tdepth_before: z.number().int().min(0).default(3).describe(\"Items before anchor\"),\n\t\t\tdepth_after: z.number().int().min(0).default(3).describe(\"Items after anchor\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.timeline(\n\t\t\t\t\targs.query ?? null,\n\t\t\t\t\targs.memory_id ?? null,\n\t\t\t\t\targs.depth_before,\n\t\t\t\t\targs.depth_after,\n\t\t\t\t\tfilters,\n\t\t\t\t);\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_expand\",\n\t\t\"Fetch memories by ID with surrounding timeline context.\",\n\t\t{\n\t\t\tids: z\n\t\t\t\t.array(z.union([z.number(), z.string()]))\n\t\t\t\t.max(200)\n\t\t\t\t.describe(\"Memory IDs to expand\"),\n\t\t\tdepth_before: z.number().int().min(0).default(3).describe(\"Timeline items before\"),\n\t\t\tdepth_after: z.number().int().min(0).default(3).describe(\"Timeline items after\"),\n\t\t\tinclude_observations: z.boolean().default(false).describe(\"Include full observation details\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\t// Explicit blank `project` clears scoping for cross-project expansion.\n\t\t\t\t// Only fall back to the server default when `project` is omitted entirely.\n\t\t\t\tconst filterDefaultProject =\n\t\t\t\t\targs.project !== undefined && !args.project.trim() ? null : defaultProject();\n\t\t\t\tconst filters = buildFilters(args, filterDefaultProject);\n\t\t\t\tconst resolvedProject = filters?.project ?? null;\n\t\t\t\tconst { ordered: orderedIds, invalid: invalidIds } = dedupeOrderedIds(args.ids);\n\t\t\t\tconst errors: Array<Record<string, unknown>> = [];\n\n\t\t\t\tif (invalidIds.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"INVALID_ARGUMENT\",\n\t\t\t\t\t\tfield: \"ids\",\n\t\t\t\t\t\tmessage: \"some ids are not valid integers\",\n\t\t\t\t\t\tids: invalidIds,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tconst missingNotFound: number[] = [];\n\t\t\t\tconst missingProjectMismatch: number[] = [];\n\t\t\t\tconst missingFilterMismatch: number[] = [];\n\t\t\t\tconst anchors: MemoryItemResponse[] = [];\n\t\t\t\tconst timelineItems: MemoryItemResponse[] = [];\n\t\t\t\tconst timelineSeen = new Set<number>();\n\t\t\t\tconst sessionProjects = new Map<number, string | null>();\n\n\t\t\t\tfor (const memoryId of orderedIds) {\n\t\t\t\t\tconst item = store.get(memoryId);\n\t\t\t\t\tif (!item?.active) {\n\t\t\t\t\t\tmissingNotFound.push(memoryId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst sessionId = item.session_id;\n\t\t\t\t\tif (resolvedProject && sessionId > 0) {\n\t\t\t\t\t\tif (!sessionProjects.has(sessionId)) {\n\t\t\t\t\t\t\tconst row = store.db\n\t\t\t\t\t\t\t\t.prepare(\"SELECT project FROM sessions WHERE id = ? LIMIT 1\")\n\t\t\t\t\t\t\t\t.get(sessionId) as { project: string | null } | undefined;\n\t\t\t\t\t\t\tsessionProjects.set(sessionId, typeof row?.project === \"string\" ? row.project : null);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (!projectMatchesFilter(resolvedProject, sessionProjects.get(sessionId) ?? null)) {\n\t\t\t\t\t\t\tmissingProjectMismatch.push(memoryId);\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (resolvedProject && sessionId <= 0) {\n\t\t\t\t\t\tmissingProjectMismatch.push(memoryId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst expanded = store.timeline(\n\t\t\t\t\t\tnull,\n\t\t\t\t\t\tmemoryId,\n\t\t\t\t\t\targs.depth_before,\n\t\t\t\t\t\targs.depth_after,\n\t\t\t\t\t\tfilters,\n\t\t\t\t\t);\n\t\t\t\t\tconst anchor = expanded.find((expandedItem) => expandedItem.id === memoryId);\n\t\t\t\t\tif (!anchor) {\n\t\t\t\t\t\tmissingFilterMismatch.push(memoryId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tanchors.push(anchor);\n\t\t\t\t\tfor (const expandedItem of expanded) {\n\t\t\t\t\t\tconst expandedId = expandedItem.id;\n\t\t\t\t\t\tif (expandedId <= 0 || timelineSeen.has(expandedId)) continue;\n\t\t\t\t\t\ttimelineSeen.add(expandedId);\n\t\t\t\t\t\ttimelineItems.push(expandedItem);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (missingNotFound.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"NOT_FOUND\",\n\t\t\t\t\t\tfield: \"ids\",\n\t\t\t\t\t\tmessage: \"some requested ids were not found\",\n\t\t\t\t\t\tids: missingNotFound,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (missingProjectMismatch.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"PROJECT_MISMATCH\",\n\t\t\t\t\t\tfield: \"project\",\n\t\t\t\t\t\tmessage: \"some requested ids are outside the requested project scope\",\n\t\t\t\t\t\tids: missingProjectMismatch,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (missingFilterMismatch.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"FILTER_MISMATCH\",\n\t\t\t\t\t\tfield: \"filters\",\n\t\t\t\t\t\tmessage: \"some requested ids are outside the requested filters\",\n\t\t\t\t\t\tids: missingFilterMismatch,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tlet observations: MemoryItemResponse[] = [];\n\t\t\t\tif (args.include_observations) {\n\t\t\t\t\tconst observationSeen = new Set<number>();\n\t\t\t\t\tconst observationIds: number[] = [];\n\t\t\t\t\tfor (const item of [...anchors, ...timelineItems]) {\n\t\t\t\t\t\tif (item.id > 0 && !observationSeen.has(item.id)) {\n\t\t\t\t\t\t\tobservationSeen.add(item.id);\n\t\t\t\t\t\t\tobservationIds.push(item.id);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tobservations = getManyForMcp(store, observationIds, filters);\n\t\t\t\t}\n\n\t\t\t\treturn jsonContent({\n\t\t\t\t\tanchors,\n\t\t\t\t\ttimeline: timelineItems,\n\t\t\t\t\tobservations,\n\t\t\t\t\tmissing_ids: orderedIds.filter(\n\t\t\t\t\t\t(memoryId: number) =>\n\t\t\t\t\t\t\tmissingNotFound.includes(memoryId) ||\n\t\t\t\t\t\t\tmissingProjectMismatch.includes(memoryId) ||\n\t\t\t\t\t\t\tmissingFilterMismatch.includes(memoryId),\n\t\t\t\t\t),\n\t\t\t\t\terrors,\n\t\t\t\t\tmetadata: {\n\t\t\t\t\t\tproject: resolvedProject,\n\t\t\t\t\t\trequested_ids_count: orderedIds.length,\n\t\t\t\t\t\treturned_anchor_count: anchors.length,\n\t\t\t\t\t\ttimeline_count: timelineItems.length,\n\t\t\t\t\t\tinclude_observations: args.include_observations,\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n}\n","import { type MemoryStore, VERSION } from \"@codemem/core\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { resolveDefaultProject } from \"./project-scope.js\";\nimport type { CodememMcpServerOptions, ToolRegistrationContext } from \"./tool-context.js\";\nimport { registerItemTools } from \"./tools/items.js\";\nimport { registerLearnTools } from \"./tools/learn.js\";\nimport { registerSchemaTools } from \"./tools/schema.js\";\nimport { registerSearchTools } from \"./tools/search.js\";\nimport { registerTimelineTools } from \"./tools/timeline.js\";\n\nexport function createCodememMcpServer(\n\tstore: MemoryStore,\n\toptions: CodememMcpServerOptions = {},\n): McpServer {\n\tconst server = new McpServer({ name: \"codemem\", version: VERSION });\n\tconst context: ToolRegistrationContext = {\n\t\tstore,\n\t\t// Resolve lazily per call so long-running servers pick up the current\n\t\t// CODEMEM_PROJECT / process.cwd() rather than the value at construction.\n\t\tdefaultProject: () => {\n\t\t\tif (options.resolveDefaultProject) return options.resolveDefaultProject();\n\t\t\tif (options.defaultProject !== undefined) return options.defaultProject;\n\t\t\treturn resolveDefaultProject();\n\t\t},\n\t\tenvProject: () =>\n\t\t\toptions.envProject !== undefined ? options.envProject : (process.env.CODEMEM_PROJECT ?? null),\n\t};\n\n\tregisterSearchTools(server, context);\n\tregisterTimelineTools(server, context);\n\tregisterItemTools(server, context);\n\tregisterSchemaTools(server);\n\tregisterLearnTools(server);\n\n\treturn server;\n}\n"],"mappings":";;;;AAEA,SAAS,EAAa,GAAiD;AAEtE,QADgB,GAAO,MAAM,IACF;;AAG5B,SAAgB,IAAuC;AACtD,QAAO,EAAa,QAAQ,IAAI,gBAAgB,IAAI,EAAe,QAAQ,KAAK,CAAC;;AAGlF,SAAgB,EAAoB,GAGlB;AACjB,QAAO,EAAa,EAAM,QAAQ,IAAI,EAAa,EAAM,WAAW,IAAI;;AAGzE,SAAgB,EACf,GACA,IAAiB,GAAuB,EACZ;CAC5B,IAAM,IAAyB,EAAE,EAC7B,IAAS,IAGP,KADkB,OAAO,EAAI,WAAY,WAAW,EAAa,EAAI,QAAQ,GAAG,KAAA,MAC3C,EAAa,EAAe,IAAI,KAAA;AAC3E,CAAI,MACH,EAAQ,UAAU,GAClB,IAAS;AAGV,MAAK,IAAM,KAAO;EACjB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,EAAW;EACX,IAAM,IAAM,EAAI;AAChB,EAAI,KAA6B,SAC/B,EAAoC,KAAO,GAC5C,IAAS;;AAIX,QAAO,IAAS,IAAU,KAAA;;;;AC9D3B,SAAgB,EAAY,GAAe;AAC1C,QAAO,EAAE,SAAS,CAAC;EAAE,MAAM;EAAiB,MAAM,KAAK,UAAU,EAAK;EAAE,CAAC,EAAE;;AAG5E,SAAgB,EAAa,GAAiB;AAC7C,QAAO,EAAE,SAAS,CAAC;EAAE,MAAM;EAAiB,MAAM,KAAK,UAAU,EAAE,OAAO,GAAS,CAAC;EAAE,CAAC,EAAE;;;;ACG1F,SAAgB,EACf,GACA,GACA,GAC4B;AAE5B,QADa,EAAM,SAAS,MAAM,GAAU,GAAG,GAAG,KAAW,KACtD,CAAK,MAAM,MAAQ,EAAI,OAAO,EAAS,IAAI;;AAGnD,SAAgB,EACf,GACA,GACA,GACuB;AACvB,KAAI,EAAI,WAAW,EAAG,QAAO,EAAE;CAC/B,IAAM,IAAgC,EAAE;AACxC,MAAK,IAAM,KAAM,GAAK;EACrB,IAAM,IAAO,EAAgB,GAAO,GAAI,EAAQ;AAChD,EAAI,KAAM,EAAQ,KAAK,EAAK;;AAE7B,QAAO;;AAGR,SAAgB,EACf,GACA,GACA,GACU;AAIV,QAHa,EAAgB,GAAO,GAAU,EACzC,IACL,EAAM,OAAO,EAAS,EACf,MAFW;;AAoBnB,SAAgB,EACf,GACA,GACA,IAAuC,EAAE,EACQ;AACjD,QAAO,EAAM,GAAG,kBAAkB;EACjC,IAAM,IAAM,EAAQ,OAAO,qBAAI,IAAI,MAAM,EAAC,aAAa,EACjD,IAAO,EAAQ,QAAQ,QAAQ,IAAI,QAAQ,WAC3C,IAAM,EAAQ,OAAO,QAAQ,KAAK,EAClC,IAAU,EAAoB;GACnC,SAAS,EAAM;GACf,YAAY,EAAQ;GACpB,CAAC,EAEI,IAAc,EAAM,GACxB,QACA,iIAEA,CACA,IAAI,GAAK,GAAK,GAAK,GAAS,GAAM,UAAU,EAAO,EAAE,KAAK,IAAM,CAAC,CAAC,EAC9D,IAAY,OAAO,EAAY,gBAAgB,EAE/C,IAAQ,EAAM,SAAS,GAAW,EAAM,MAAM,EAAM,OAAO,EAAM,MAAM,EAAM,WAAW;AAC9F,MAAI,CAAC,EAAgB,GAAO,EAAM,CACjC,OAAU,MAAM,qBAAqB;AAOtC,SAJA,EAAM,GACJ,QAAQ,mEAAmE,CAC3E,IAAI,EAAQ,OAAO,qBAAI,IAAI,MAAM,EAAC,aAAa,EAAE,EAAO,EAAE,KAAK,IAAM,CAAC,EAAE,EAAU,EAE7E;GAAE;GAAO,OAAO,EAAM;GAAO,MAAM,EAAM;GAAM;GACrD,EAAE;;;;ACvFL,IAAM,IAAoB;CACzB,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,6CAA6C;CACtF,mBAAmB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,SAAS,sCAAsC;CACjG,mBAAmB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,SAAS,sCAAsC;CACjG,EAEY,IAAe;CAC3B,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,wBAAwB;CAC7D,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,qDAAqD;CAC7F,GAAG;CACH,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CAC1C,oBAAoB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CAClD,oBAAoB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CAClD,uBAAuB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACrD,uBAAuB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACrD,yBAAyB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACvD,yBAAyB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACvD,mBAAmB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACjD,mBAAmB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACjD,sBAAsB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACpD,sBAAsB,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,UAAU;CACpD,iBAAiB,EAAE,QAAQ,CAAC,UAAU;CACtC,gBAAgB,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU;CAC7D,YAAY,EAAE,QAAQ,CAAC,UAAU;CACjC,wBAAwB,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU;CACrE,mCAAmC,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU;CAC9D,iCAAiC,EAAE,QAAQ,CAAC,UAAU;CACtD,EAEY,IAAmB,EAAE,KAAK;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAAC,EAEW,IAAc,OAAO,KAAK,EAAa,CAAC,UAAU;;;AC3B/D,SAAgB,EAAkB,GAAmB,GAAwC;CAC5F,IAAM,EAAE,eAAY,aAAU;AAsE9B,CApEA,EAAO,KACN,cACA,qCACA;EACC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,SAAS,YAAY;EACjD,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GAGH,IAAM,IAAO,EAAgB,GAAO,EAAK,WAAW,EAAa,GAAM,KAAK,CAAC;AAE7E,UADK,IACE,EAAY,EAAK,GADN,EAAa,YAAY;WAEnC,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,2BACA,6CACA;EACC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,sBAAsB;EACvE,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;AAEH,UAAO,EAAY,EAAE,OADP,EAAc,GAAO,EAAK,KAAK,EAAa,GAAM,KAAK,CAChD,EAAO,CAAC;WACrB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,mBACA,0EACA;EACC,MAAM,EAAiB,SAAS,cAAc;EAC9C,OAAO,EAAE,QAAQ,CAAC,SAAS,cAAc;EACzC,MAAM,EAAE,QAAQ,CAAC,SAAS,kCAAkC;EAC5D,YAAY,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,GAAI,CAAC,SAAS,iBAAiB;EAC5E,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,qBAAqB;EAC7D,EACD,OAAO,MAAS;AACf,MAAI;GAGH,IAAM,IAAS,EAAqB,GAAO,GAAM,EAChD,YAAY,GAAY,EACxB,CAAC;AAEF,OAAI;AACH,UAAM,EAAa,EAAM,IAAI,EAAO,OAAO,EAAO,OAAO,EAAO,KAAK;WAC9D;AAIR,UAAO,EAAY,EAAE,IAAI,EAAO,OAAO,CAAC;WAChC,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,iBACA,mEACA;EACC,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,SAAS,sBAAsB;EAC3D,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;AAIH,UAHK,EAAmB,GAAO,EAAK,WAAW,EAAa,GAAM,KAAK,CAAC,GAGjE,EAAY,EAAE,QAAQ,MAAM,CAAC,GAF5B,EAAa,YAAY;WAGzB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE;;;;ACnGF,SAAgB,EAAmB,GAAyB;AAC3D,GAAO,KACN,gBACA,yEACA,EAAE,EACF,YACQ,EAAY;EAClB,OAAO;EACP,aAAa;EACb,QAAQ;GACP,MAAM,CACL,2DACA,kEACA;GACD,KAAK;IACJ;IACA;IACA;IACA;IACA;IACA;GACD,UAAU;IACT;IACA;IACA;IACA;GACD;EACD,aAAa;GACZ,MAAM,CACL,4DACA,+DACA;GACD,KAAK;IACJ;IACA;IACA;IACA;GACD,UAAU,CACT,mHACA,8GACA;GACD;EACD,QAAQ;GACP,MAAM,CACL,wDACA,6DACA;GACD,KAAK,CACJ,qDACA,+DACA;GACD,UAAU,CAAC,qBAAqB;GAChC;EACD,aACC;EACD,2BAA2B;GAC1B;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA;GACA,CAAC,KAAK,KAAK;EACZ,CAAC,CAEH;;;;AC5FF,IAAa,IAAuC;CACnD,WAAW;CACX,QAAQ;CACR,SAAS;CACT,QAAQ;CACR,UAAU;CACV,UAAU;CACV,aAAa;CACb;;;ACHD,SAAgB,EAAoB,GAAyB;AAC5D,GAAO,KACN,iBACA,oEACA,EAAE,EACF,YACQ,EAAY;EAClB,OAAO,OAAO,KAAK,EAAa;EAChC,mBAAmB;EACnB,QAAQ;GACP,OAAO;GACP,MAAM;GACN,UAAU;GACV,OAAO;GACP,WAAW;GACX,UAAU;GACV,YAAY;GACZ,gBAAgB;GAChB,eAAe;GACf;EACD,SAAS;EACT,CAAC,CAEH;;;;ACpBF,SAAgB,EAAoB,GAAmB,GAAwC;CAC9F,IAAM,EAAE,mBAAgB,aAAU;AAsGlC,CApGA,EAAO,KACN,iBACA,yEACA;EACC,OAAO,EAAE,QAAQ,CAAC,SAAS,eAAe;EAC1C,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,SAAS,cAAc;EACzE,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC;AAEpD,UAAO,EAAY,EAClB,OAFa,EAAM,OAAO,EAAK,OAAO,EAAK,OAAO,EAE3C,CAAM,KAAK,OAAqB;IACtC,IAAI,EAAE;IACN,OAAO,EAAE;IACT,MAAM,EAAE;IACR,MAAM,EAAE;IACR,YAAY,EAAE;IACd,OAAO,EAAE;IACT,YAAY,EAAE;IACd,UAAU,EAAE;IACZ,EAAE,EACH,CAAC;WACM,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,uBACA,wFACA;EACC,OAAO,EAAE,QAAQ,CAAC,SAAS,eAAe;EAC1C,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,SAAS,cAAc;EACzE,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC;AAEpD,UAAO,EAAY,EAClB,OAFa,EAAM,OAAO,EAAK,OAAO,EAAK,OAAO,EAE3C,CAAM,KAAK,OAAqB;IACtC,IAAI,EAAE;IACN,MAAM,EAAE;IACR,OAAO,EAAE;IACT,OAAO,EAAE;IACT,YAAY,EAAE;IACd,YAAY,EAAE;IACd,UAAU,EAAE;IACZ,EAAE,EACH,CAAC;WACM,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,kBACA,2DACA;EACC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,eAAe;EACrD,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,iCAAiC;EAC7F,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC,SAAS,cAAc;EAC1E,sBAAsB,EAAE,SAAS,CAAC,QAAQ,GAAM,CAAC,SAAS,iCAAiC;EAC3F,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC;AAIpD,UAAO,EAHQ,EAAM,QAAQ,EAAK,SAAS,MAAM,EAAK,OAAO,MAAM,EAAK,OAAO,GAAS,EACvF,oBAAoB,EAAK,sBACzB,CACkB,CAAO;WAClB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,iBACA,yCACA;EACC,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC,SAAS,cAAc;EAC1E,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC;AAEpD,UAAO,EAAY,EAAE,OADP,EAAM,OAAO,EAAK,OAAO,EAClB,EAAO,CAAC;WACrB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,eACA,qFACA;EACC,SAAS,EAAE,QAAQ,CAAC,SAAS,oCAAoC;EACjE,OAAO,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,uBAAuB;EAClF,SAAS,EACP,SAAS,CACT,UAAU,CACV,SACA,wKACA;EACF,sBAAsB,EACpB,QAAQ,CACR,KAAK,CACL,IAAI,EAAE,CACN,IAAI,GAAG,CACP,UAAU,CACV,SAAS,qEAAqE;EAChF,kBAAkB,EAChB,KAAK;GAAC;GAAO;GAAW;GAAM,CAAC,CAC/B,UAAU,CACV,SACA,wKACA;EACF,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC,EAC9C,IACL,EAAK,WAAW,EAAK,wBAAwB,QAAQ,EAAK,oBAAoB,OAC3E;IACA,SAAS,EAAK,YAAY,EAAK,wBAAwB,OAAc,KAAA,IAAP;IAC9D,oBAAoB,EAAK;IACzB,iBAAiB,EAAK;IACtB,GACA,KAAA;AAQJ,UAAO,EAAY,MAPE,EAAM,qBAC1B,EAAK,SACL,EAAK,SAAS,KAAA,GACd,MACA,GACA,EACA,CACyB;WAClB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE;;;;ACxJF,SAAgB,EAAsB,GAAmB,GAAwC;CAChG,IAAM,EAAE,mBAAgB,aAAU;AA6BlC,CA3BA,EAAO,KACN,mBACA,6EACA;EACC,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,8BAA8B;EACpE,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,mBAAmB;EACnE,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,sBAAsB;EAChF,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,qBAAqB;EAC9E,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GACH,IAAM,IAAU,EAAa,GAAM,GAAgB,CAAC;AAQpD,UAAO,EAAY,EAAE,OAPP,EAAM,SACnB,EAAK,SAAS,MACd,EAAK,aAAa,MAClB,EAAK,cACL,EAAK,aACL,EAEoB,EAAO,CAAC;WACrB,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE,EAED,EAAO,KACN,iBACA,2DACA;EACC,KAAK,EACH,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CACxC,IAAI,IAAI,CACR,SAAS,uBAAuB;EAClC,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,wBAAwB;EAClF,aAAa,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,uBAAuB;EAChF,sBAAsB,EAAE,SAAS,CAAC,QAAQ,GAAM,CAAC,SAAS,mCAAmC;EAC7F,GAAG;EACH,EACD,OAAO,MAAS;AACf,MAAI;GAKH,IAAM,IAAU,EAAa,GAD5B,EAAK,YAAY,KAAA,KAAa,CAAC,EAAK,QAAQ,MAAM,GAAG,OAAO,GAAgB,CACrB,EAClD,IAAkB,GAAS,WAAW,MACtC,EAAE,SAAS,GAAY,SAAS,MAAe,EAAiB,EAAK,IAAI,EACzE,IAAyC,EAAE;AAEjD,GAAI,EAAW,SAAS,KACvB,EAAO,KAAK;IACX,MAAM;IACN,OAAO;IACP,SAAS;IACT,KAAK;IACL,CAAC;GAGH,IAAM,IAA4B,EAAE,EAC9B,IAAmC,EAAE,EACrC,IAAkC,EAAE,EACpC,IAAgC,EAAE,EAClC,IAAsC,EAAE,EACxC,oBAAe,IAAI,KAAa,EAChC,oBAAkB,IAAI,KAA4B;AAExD,QAAK,IAAM,KAAY,GAAY;IAClC,IAAM,IAAO,EAAM,IAAI,EAAS;AAChC,QAAI,CAAC,GAAM,QAAQ;AAClB,OAAgB,KAAK,EAAS;AAC9B;;IAGD,IAAM,IAAY,EAAK;AACvB,QAAI,KAAmB,IAAY,GAAG;AACrC,SAAI,CAAC,EAAgB,IAAI,EAAU,EAAE;MACpC,IAAM,IAAM,EAAM,GAChB,QAAQ,oDAAoD,CAC5D,IAAI,EAAU;AAChB,QAAgB,IAAI,GAAW,OAAO,GAAK,WAAY,WAAW,EAAI,UAAU,KAAK;;AAEtF,SAAI,CAAC,EAAqB,GAAiB,EAAgB,IAAI,EAAU,IAAI,KAAK,EAAE;AACnF,QAAuB,KAAK,EAAS;AACrC;;eAES,KAAmB,KAAa,GAAG;AAC7C,OAAuB,KAAK,EAAS;AACrC;;IAGD,IAAM,IAAW,EAAM,SACtB,MACA,GACA,EAAK,cACL,EAAK,aACL,EACA,EACK,IAAS,EAAS,MAAM,MAAiB,EAAa,OAAO,EAAS;AAC5E,QAAI,CAAC,GAAQ;AACZ,OAAsB,KAAK,EAAS;AACpC;;AAGD,MAAQ,KAAK,EAAO;AACpB,SAAK,IAAM,KAAgB,GAAU;KACpC,IAAM,IAAa,EAAa;AAC5B,UAAc,KAAK,EAAa,IAAI,EAAW,KACnD,EAAa,IAAI,EAAW,EAC5B,EAAc,KAAK,EAAa;;;AAoBlC,GAhBI,EAAgB,SAAS,KAC5B,EAAO,KAAK;IACX,MAAM;IACN,OAAO;IACP,SAAS;IACT,KAAK;IACL,CAAC,EAEC,EAAuB,SAAS,KACnC,EAAO,KAAK;IACX,MAAM;IACN,OAAO;IACP,SAAS;IACT,KAAK;IACL,CAAC,EAEC,EAAsB,SAAS,KAClC,EAAO,KAAK;IACX,MAAM;IACN,OAAO;IACP,SAAS;IACT,KAAK;IACL,CAAC;GAGH,IAAI,IAAqC,EAAE;AAC3C,OAAI,EAAK,sBAAsB;IAC9B,IAAM,oBAAkB,IAAI,KAAa,EACnC,IAA2B,EAAE;AACnC,SAAK,IAAM,KAAQ,CAAC,GAAG,GAAS,GAAG,EAAc,CAChD,CAAI,EAAK,KAAK,KAAK,CAAC,EAAgB,IAAI,EAAK,GAAG,KAC/C,EAAgB,IAAI,EAAK,GAAG,EAC5B,EAAe,KAAK,EAAK,GAAG;AAG9B,QAAe,EAAc,GAAO,GAAgB,EAAQ;;AAG7D,UAAO,EAAY;IAClB;IACA,UAAU;IACV;IACA,aAAa,EAAW,QACtB,MACA,EAAgB,SAAS,EAAS,IAClC,EAAuB,SAAS,EAAS,IACzC,EAAsB,SAAS,EAAS,CACzC;IACD;IACA,UAAU;KACT,SAAS;KACT,qBAAqB,EAAW;KAChC,uBAAuB,EAAQ;KAC/B,gBAAgB,EAAc;KAC9B,sBAAsB,EAAK;KAC3B;IACD,CAAC;WACM,GAAK;AACb,UAAO,EAAa,aAAe,QAAQ,EAAI,UAAU,OAAO,EAAI,CAAC;;GAGvE;;;;ACjLF,SAAgB,EACf,GACA,IAAmC,EAAE,EACzB;CACZ,IAAM,IAAS,IAAI,EAAU;EAAE,MAAM;EAAW,SAAS;EAAS,CAAC,EAC7D,IAAmC;EACxC;EAGA,sBACK,EAAQ,wBAA8B,EAAQ,uBAAuB,GACrE,EAAQ,mBAAmB,KAAA,IACxB,GAAuB,GADmB,EAAQ;EAG1D,kBACC,EAAQ,eAAe,KAAA,IAAkC,QAAQ,IAAI,mBAAmB,OAArD,EAAQ;EAC5C;AAQD,QANA,EAAoB,GAAQ,EAAQ,EACpC,EAAsB,GAAQ,EAAQ,EACtC,EAAkB,GAAQ,EAAQ,EAClC,EAAoB,EAAO,EAC3B,EAAmB,EAAO,EAEnB"}
1
+ {"version":3,"file":"server-BH_IcTFq.js","names":[],"sources":["../src/project-scope.ts","../src/content.ts","../src/memory-access.ts","../src/schemas.ts","../src/tools/items.ts","../src/tools/learn.ts","../src/memory-kinds.ts","../src/tools/schema.ts","../src/tools/search.ts","../src/tools/timeline.ts","../src/server.ts"],"sourcesContent":["import { type MemoryFilters, resolveProject } from \"@codemem/core\";\n\nfunction cleanProject(value: string | null | undefined): string | null {\n\tconst trimmed = value?.trim();\n\treturn trimmed ? trimmed : null;\n}\n\nexport function resolveDefaultProject(): string | null {\n\treturn cleanProject(process.env.CODEMEM_PROJECT) ?? resolveProject(process.cwd());\n}\n\nexport function resolveWriteProject(input: {\n\tproject?: string | null;\n\tenvProject?: string | null;\n}): string | null {\n\treturn cleanProject(input.project) ?? cleanProject(input.envProject) ?? null;\n}\n\nexport function buildFilters(\n\traw: Record<string, unknown>,\n\tdefaultProject = resolveDefaultProject(),\n): MemoryFilters | undefined {\n\tconst filters: MemoryFilters = {};\n\tlet hasAny = false;\n\n\tconst explicitProject = typeof raw.project === \"string\" ? cleanProject(raw.project) : undefined;\n\tconst resolvedProject = explicitProject || cleanProject(defaultProject) || undefined;\n\tif (resolvedProject) {\n\t\tfilters.project = resolvedProject;\n\t\thasAny = true;\n\t}\n\n\tfor (const key of [\n\t\t\"kind\",\n\t\t\"visibility\",\n\t\t\"scope_id\",\n\t\t\"include_scope_ids\",\n\t\t\"exclude_scope_ids\",\n\t\t\"include_visibility\",\n\t\t\"exclude_visibility\",\n\t\t\"include_workspace_ids\",\n\t\t\"exclude_workspace_ids\",\n\t\t\"include_workspace_kinds\",\n\t\t\"exclude_workspace_kinds\",\n\t\t\"include_actor_ids\",\n\t\t\"exclude_actor_ids\",\n\t\t\"include_trust_states\",\n\t\t\"exclude_trust_states\",\n\t\t\"ownership_scope\",\n\t\t\"personal_first\",\n\t\t\"trust_bias\",\n\t\t\"widen_shared_when_weak\",\n\t\t\"widen_shared_min_personal_results\",\n\t\t\"widen_shared_min_personal_score\",\n\t] as const) {\n\t\tconst val = raw[key];\n\t\tif (val !== undefined && val !== null) {\n\t\t\t(filters as Record<string, unknown>)[key] = val;\n\t\t\thasAny = true;\n\t\t}\n\t}\n\n\treturn hasAny ? filters : undefined;\n}\n","export function jsonContent(data: unknown) {\n\treturn { content: [{ type: \"text\" as const, text: JSON.stringify(data) }] };\n}\n\nexport function errorContent(message: string) {\n\treturn { content: [{ type: \"text\" as const, text: JSON.stringify({ error: message }) }] };\n}\n","import {\n\ttype MemoryFilters,\n\ttype MemoryItemResponse,\n\ttype MemoryStore,\n\ttoJson,\n} from \"@codemem/core\";\nimport { resolveWriteProject } from \"./project-scope.js\";\n\nexport function getMemoryForMcp(\n\tstore: MemoryStore,\n\tmemoryId: number,\n\tfilters?: MemoryFilters,\n): MemoryItemResponse | null {\n\tconst rows = store.timeline(null, memoryId, 0, 0, filters ?? null);\n\treturn rows.find((row) => row.id === memoryId) ?? null;\n}\n\nexport function getManyForMcp(\n\tstore: MemoryStore,\n\tids: number[],\n\tfilters?: MemoryFilters,\n): MemoryItemResponse[] {\n\tif (ids.length === 0) return [];\n\tconst results: MemoryItemResponse[] = [];\n\tfor (const id of ids) {\n\t\tconst item = getMemoryForMcp(store, id, filters);\n\t\tif (item) results.push(item);\n\t}\n\treturn results;\n}\n\nexport function forgetMemoryForMcp(\n\tstore: MemoryStore,\n\tmemoryId: number,\n\tfilters?: MemoryFilters,\n): boolean {\n\tconst item = getMemoryForMcp(store, memoryId, filters);\n\tif (!item) return false;\n\tstore.forget(memoryId);\n\treturn true;\n}\n\nexport interface RememberMemoryForMcpInput {\n\tkind: string;\n\ttitle: string;\n\tbody: string;\n\tconfidence: number;\n\tproject?: string | null;\n}\n\nexport interface RememberMemoryForMcpContext {\n\tcwd?: string;\n\tuser?: string;\n\tenvProject?: string | null;\n\tnow?: () => string;\n}\n\nexport function rememberMemoryForMcp(\n\tstore: MemoryStore,\n\tinput: RememberMemoryForMcpInput,\n\tcontext: RememberMemoryForMcpContext = {},\n): { memId: number; title: string; body: string } {\n\treturn store.db.transaction(() => {\n\t\tconst now = context.now?.() ?? new Date().toISOString();\n\t\tconst user = context.user ?? process.env.USER ?? \"unknown\";\n\t\tconst cwd = context.cwd ?? process.cwd();\n\t\tconst project = resolveWriteProject({\n\t\t\tproject: input.project,\n\t\t\tenvProject: context.envProject,\n\t\t});\n\n\t\tconst sessionInfo = store.db\n\t\t\t.prepare(\n\t\t\t\t`INSERT INTO sessions(started_at, ended_at, cwd, project, user, tool_version, metadata_json)\n\t\t\t\t VALUES (?, ?, ?, ?, ?, ?, ?)`,\n\t\t\t)\n\t\t\t.run(now, now, cwd, project, user, \"mcp-ts\", toJson({ mcp: true }));\n\t\tconst sessionId = Number(sessionInfo.lastInsertRowid);\n\n\t\tconst memId = store.remember(sessionId, input.kind, input.title, input.body, input.confidence);\n\t\tif (!getMemoryForMcp(store, memId)) {\n\t\t\tthrow new Error(\"unauthorized_scope\");\n\t\t}\n\n\t\tstore.db\n\t\t\t.prepare(\"UPDATE sessions SET ended_at = ?, metadata_json = ? WHERE id = ?\")\n\t\t\t.run(context.now?.() ?? new Date().toISOString(), toJson({ mcp: true }), sessionId);\n\n\t\treturn { memId, title: input.title, body: input.body };\n\t})();\n}\n","import { z } from \"zod\";\n\nconst scopeFilterSchema = {\n\tscope_id: z.string().optional().describe(\"Filter by a single sharing domain scope_id\"),\n\tinclude_scope_ids: z.array(z.string()).optional().describe(\"Sharing domain scope_ids to include\"),\n\texclude_scope_ids: z.array(z.string()).optional().describe(\"Sharing domain scope_ids to exclude\"),\n};\n\nexport const filterSchema = {\n\tkind: z.string().optional().describe(\"Filter by memory kind\"),\n\tproject: z.string().optional().describe(\"Filter by project scope (matches sessions.project)\"),\n\t...scopeFilterSchema,\n\tvisibility: z.array(z.string()).optional(),\n\tinclude_visibility: z.array(z.string()).optional(),\n\texclude_visibility: z.array(z.string()).optional(),\n\tinclude_workspace_ids: z.array(z.string()).optional(),\n\texclude_workspace_ids: z.array(z.string()).optional(),\n\tinclude_workspace_kinds: z.array(z.string()).optional(),\n\texclude_workspace_kinds: z.array(z.string()).optional(),\n\tinclude_actor_ids: z.array(z.string()).optional(),\n\texclude_actor_ids: z.array(z.string()).optional(),\n\tinclude_trust_states: z.array(z.string()).optional(),\n\texclude_trust_states: z.array(z.string()).optional(),\n\townership_scope: z.string().optional(),\n\tpersonal_first: z.union([z.boolean(), z.string()]).optional(),\n\ttrust_bias: z.string().optional(),\n\twiden_shared_when_weak: z.union([z.boolean(), z.string()]).optional(),\n\twiden_shared_min_personal_results: z.number().int().optional(),\n\twiden_shared_min_personal_score: z.number().optional(),\n};\n\nexport const memoryKindSchema = z.enum([\n\t\"discovery\",\n\t\"change\",\n\t\"feature\",\n\t\"bugfix\",\n\t\"refactor\",\n\t\"decision\",\n\t\"exploration\",\n]);\n\nexport const filterNames = Object.keys(filterSchema).toSorted();\n","import { storeVectors } from \"@codemem/core\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { errorContent, jsonContent } from \"../content.js\";\nimport {\n\tforgetMemoryForMcp,\n\tgetManyForMcp,\n\tgetMemoryForMcp,\n\trememberMemoryForMcp,\n} from \"../memory-access.js\";\nimport { buildFilters } from \"../project-scope.js\";\nimport { filterSchema, memoryKindSchema } from \"../schemas.js\";\nimport type { ToolRegistrationContext } from \"../tool-context.js\";\n\nexport function registerItemTools(server: McpServer, context: ToolRegistrationContext): void {\n\tconst { envProject, store } = context;\n\n\tserver.tool(\n\t\t\"memory_get\",\n\t\t\"Fetch a single memory item by ID.\",\n\t\t{\n\t\t\tmemory_id: z.number().int().describe(\"Memory ID\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\t// Direct-ID ops do not inherit the server default project. Callers already\n\t\t\t\t// have an exact ID; cwd/env should not silently scope the lookup.\n\t\t\t\tconst item = getMemoryForMcp(store, args.memory_id, buildFilters(args, null));\n\t\t\t\tif (!item) return errorContent(\"not_found\");\n\t\t\t\treturn jsonContent(item);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_get_observations\",\n\t\t\"Fetch multiple memory items by their IDs.\",\n\t\t{\n\t\t\tids: z.array(z.number().int()).max(200).describe(\"Memory IDs to fetch\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst items = getManyForMcp(store, args.ids, buildFilters(args, null));\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_remember\",\n\t\t\"Create a new memory. Use for milestones, decisions, and notable facts.\",\n\t\t{\n\t\t\tkind: memoryKindSchema.describe(\"Memory kind\"),\n\t\t\ttitle: z.string().describe(\"Short title\"),\n\t\t\tbody: z.string().describe(\"Body text (high-signal content)\"),\n\t\t\tconfidence: z.number().min(0).max(1).default(0.5).describe(\"Confidence 0-1\"),\n\t\t\tproject: z.string().optional().describe(\"Project identifier\"),\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\t// Writes never inherit the server default project. They only honor an\n\t\t\t\t// explicit `project` input or CODEMEM_PROJECT; otherwise project stays null.\n\t\t\t\tconst result = rememberMemoryForMcp(store, args, {\n\t\t\t\t\tenvProject: envProject(),\n\t\t\t\t});\n\n\t\t\t\ttry {\n\t\t\t\t\tawait storeVectors(store.db, result.memId, result.title, result.body);\n\t\t\t\t} catch {\n\t\t\t\t\t// Memory writes should succeed even if embeddings are unavailable.\n\t\t\t\t}\n\n\t\t\t\treturn jsonContent({ id: result.memId });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_forget\",\n\t\t\"Soft-delete a memory item. Use for incorrect or sensitive data.\",\n\t\t{\n\t\t\tmemory_id: z.number().int().describe(\"Memory ID to forget\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tif (!forgetMemoryForMcp(store, args.memory_id, buildFilters(args, null))) {\n\t\t\t\t\treturn errorContent(\"not_found\");\n\t\t\t\t}\n\t\t\t\treturn jsonContent({ status: \"ok\" });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n}\n","import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { jsonContent } from \"../content.js\";\n\nexport function registerLearnTools(server: McpServer): void {\n\tserver.tool(\n\t\t\"memory_learn\",\n\t\t\"Learn how to use codemem memory tools. Call this first if unfamiliar.\",\n\t\t{},\n\t\tasync () => {\n\t\t\treturn jsonContent({\n\t\t\t\tintro: \"Use this tool when you're new to codemem or unsure when to recall/persist.\",\n\t\t\t\tclient_hint: \"If you are unfamiliar with codemem, call memory.learn first.\",\n\t\t\t\trecall: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Start of a task or when the user references prior work.\",\n\t\t\t\t\t\t\"When you need background context, decisions, or recent changes.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Use memory.search_index to get compact candidates.\",\n\t\t\t\t\t\t\"Use memory.timeline to expand around a promising memory.\",\n\t\t\t\t\t\t\"Use memory.get_observations for full details only when needed.\",\n\t\t\t\t\t\t\"Use memory.pack for quick one-shot context blocks.\",\n\t\t\t\t\t\t\"Use the project filter unless the user requests cross-project context.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\n\t\t\t\t\t\t'memory.search_index(\"billing cache bug\", limit=5)',\n\t\t\t\t\t\t\"memory.timeline(memory_id=123)\",\n\t\t\t\t\t\t\"memory.get_observations([123, 456])\",\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tpersistence: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Milestones (task done, key decision, new facts learned).\",\n\t\t\t\t\t\t\"Notable regressions or follow-ups that should be remembered.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Use memory.remember with kind decision/discovery/change/exploration.\",\n\t\t\t\t\t\t\"Keep titles short and bodies high-signal.\",\n\t\t\t\t\t\t\"ALWAYS pass the project parameter if known.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\n\t\t\t\t\t\t'memory.remember(kind=\"decision\", title=\"Switch to async cache\", body=\"...why...\", project=\"my-service\")',\n\t\t\t\t\t\t'memory.remember(kind=\"change\", title=\"Fixed retry loop\", body=\"...impact...\", project=\"my-service\")',\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tforget: {\n\t\t\t\t\twhen: [\n\t\t\t\t\t\t\"Accidental or sensitive data stored in memory items.\",\n\t\t\t\t\t\t\"Obsolete or incorrect items that should no longer surface.\",\n\t\t\t\t\t],\n\t\t\t\t\thow: [\n\t\t\t\t\t\t\"Call memory.forget(id) to mark the item inactive.\",\n\t\t\t\t\t\t\"Prefer forgetting over overwriting to preserve auditability.\",\n\t\t\t\t\t],\n\t\t\t\t\texamples: [\"memory.forget(123)\"],\n\t\t\t\t},\n\t\t\t\tprompt_hint:\n\t\t\t\t\t\"At task start: call memory.search_index; during work: memory.timeline + memory.get_observations; at milestones: memory.remember.\",\n\t\t\t\trecommended_system_prompt: [\n\t\t\t\t\t\"Trigger policy (1-liner): If the user references prior work or starts a task,\",\n\t\t\t\t\t\"immediately call memory.search_index; then use memory.timeline + memory.get_observations;\",\n\t\t\t\t\t\"at milestones, call memory.remember; use memory.forget for incorrect/sensitive items.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"System prompt:\",\n\t\t\t\t\t\"You have access to codemem MCP tools. If unfamiliar, call memory.learn first.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Recall:\",\n\t\t\t\t\t\"- Start of any task: call memory.search_index with a concise task query.\",\n\t\t\t\t\t'- If prior work is referenced (\"as before\", \"last time\", \"we already did…\", \"regression\"),',\n\t\t\t\t\t\" call memory.search_index or memory.timeline.\",\n\t\t\t\t\t\"- Use memory.get_observations only after filtering IDs.\",\n\t\t\t\t\t\"- Prefer project-scoped queries unless the user asks for cross-project.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Persistence:\",\n\t\t\t\t\t\"- On milestones (task done, key decision, new facts learned), call memory.remember.\",\n\t\t\t\t\t\"- Use kind=decision for tradeoffs, kind=change for outcomes, kind=discovery/exploration for useful findings.\",\n\t\t\t\t\t\"- Keep titles short and bodies high-signal.\",\n\t\t\t\t\t\"- ALWAYS pass the project parameter if known.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Safety:\",\n\t\t\t\t\t\"- Use memory.forget(id) for incorrect or sensitive items.\",\n\t\t\t\t\t\"\",\n\t\t\t\t\t\"Examples:\",\n\t\t\t\t\t'- memory.search_index(\"billing cache bug\")',\n\t\t\t\t\t\"- memory.timeline(memory_id=123)\",\n\t\t\t\t\t\"- memory.get_observations([123, 456])\",\n\t\t\t\t\t'- memory.remember(kind=\"decision\", title=\"Use async cache\", body=\"Chose async cache to avoid lock contention in X.\", project=\"my-service\")',\n\t\t\t\t\t'- memory.remember(kind=\"change\", title=\"Fixed retry loop\", body=\"Root cause was Y; added guard in Z.\", project=\"my-service\")',\n\t\t\t\t\t\"- memory.forget(123)\",\n\t\t\t\t].join(\"\\n\"),\n\t\t\t});\n\t\t},\n\t);\n}\n","export const MEMORY_KINDS: Record<string, string> = {\n\tdiscovery: \"Something learned about the codebase, architecture, or tools\",\n\tchange: \"A code change that was made\",\n\tfeature: \"A new feature that was implemented\",\n\tbugfix: \"A bug that was found and fixed\",\n\trefactor: \"Code that was refactored or restructured\",\n\tdecision: \"A design or architecture decision\",\n\texploration: \"An experiment or investigation (may not have shipped)\",\n};\n","import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { jsonContent } from \"../content.js\";\nimport { MEMORY_KINDS } from \"../memory-kinds.js\";\nimport { filterNames } from \"../schemas.js\";\n\nexport function registerSchemaTools(server: McpServer): void {\n\tserver.tool(\n\t\t\"memory_schema\",\n\t\t\"Return the memory schema — kinds, fields, and available filters.\",\n\t\t{},\n\t\tasync () => {\n\t\t\treturn jsonContent({\n\t\t\t\tkinds: Object.keys(MEMORY_KINDS),\n\t\t\t\tkind_descriptions: MEMORY_KINDS,\n\t\t\t\tfields: {\n\t\t\t\t\ttitle: \"short text\",\n\t\t\t\t\tbody: \"long text\",\n\t\t\t\t\tsubtitle: \"short text\",\n\t\t\t\t\tfacts: \"list<string>\",\n\t\t\t\t\tnarrative: \"long text\",\n\t\t\t\t\tconcepts: \"list<string>\",\n\t\t\t\t\tfiles_read: \"list<string>\",\n\t\t\t\t\tfiles_modified: \"list<string>\",\n\t\t\t\t\tprompt_number: \"int\",\n\t\t\t\t},\n\t\t\t\tfilters: filterNames,\n\t\t\t});\n\t\t},\n\t);\n}\n","import type { MemoryResult } from \"@codemem/core\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { errorContent, jsonContent } from \"../content.js\";\nimport { buildFilters } from \"../project-scope.js\";\nimport { filterSchema } from \"../schemas.js\";\nimport type { ToolRegistrationContext } from \"../tool-context.js\";\n\nexport function registerSearchTools(server: McpServer, context: ToolRegistrationContext): void {\n\tconst { defaultProject, store } = context;\n\n\tserver.tool(\n\t\t\"memory_search\",\n\t\t\"Search memories by text query. Returns full body text for each match.\",\n\t\t{\n\t\t\tquery: z.string().describe(\"Search query\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(5).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.search(args.query, args.limit, filters);\n\t\t\t\treturn jsonContent({\n\t\t\t\t\titems: items.map((m: MemoryResult) => ({\n\t\t\t\t\t\tid: m.id,\n\t\t\t\t\t\ttitle: m.title,\n\t\t\t\t\t\tkind: m.kind,\n\t\t\t\t\t\tbody: m.body_text,\n\t\t\t\t\t\tconfidence: m.confidence,\n\t\t\t\t\t\tscore: m.score,\n\t\t\t\t\t\tsession_id: m.session_id,\n\t\t\t\t\t\tmetadata: m.metadata,\n\t\t\t\t\t})),\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_search_index\",\n\t\t\"Search memories by text query. Returns compact index entries (no body) for browsing.\",\n\t\t{\n\t\t\tquery: z.string().describe(\"Search query\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(8).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.search(args.query, args.limit, filters);\n\t\t\t\treturn jsonContent({\n\t\t\t\t\titems: items.map((m: MemoryResult) => ({\n\t\t\t\t\t\tid: m.id,\n\t\t\t\t\t\tkind: m.kind,\n\t\t\t\t\t\ttitle: m.title,\n\t\t\t\t\t\tscore: m.score,\n\t\t\t\t\t\tcreated_at: m.created_at,\n\t\t\t\t\t\tsession_id: m.session_id,\n\t\t\t\t\t\tmetadata: m.metadata,\n\t\t\t\t\t})),\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_explain\",\n\t\t\"Explain search results with detailed scoring breakdown.\",\n\t\t{\n\t\t\tquery: z.string().optional().describe(\"Search query\"),\n\t\t\tids: z.array(z.number().int()).max(200).optional().describe(\"Specific memory IDs to explain\"),\n\t\t\tlimit: z.number().int().min(1).max(50).default(10).describe(\"Max results\"),\n\t\t\tinclude_pack_context: z.boolean().default(false).describe(\"Include formatted pack context\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst result = store.explain(args.query ?? null, args.ids ?? null, args.limit, filters, {\n\t\t\t\t\tincludePackContext: args.include_pack_context,\n\t\t\t\t});\n\t\t\t\treturn jsonContent(result);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_recent\",\n\t\t\"Return recent memories, newest first.\",\n\t\t{\n\t\t\tlimit: z.number().int().min(1).max(100).default(8).describe(\"Max results\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.recent(args.limit, filters);\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_pack\",\n\t\t\"Build a formatted memory pack from search results — quick one-shot context block.\",\n\t\t{\n\t\t\tcontext: z.string().describe(\"Context description to search for\"),\n\t\t\tlimit: z.number().int().min(1).max(50).optional().describe(\"Max items to include\"),\n\t\t\tcompact: z\n\t\t\t\t.boolean()\n\t\t\t\t.optional()\n\t\t\t\t.describe(\n\t\t\t\t\t\"When true, render a scannable index of all items with full detail only for the top N (default 3). Saves tokens when broad overview matters more than per-item detail.\",\n\t\t\t\t),\n\t\t\tcompact_detail_count: z\n\t\t\t\t.number()\n\t\t\t\t.int()\n\t\t\t\t.min(0)\n\t\t\t\t.max(50)\n\t\t\t\t.optional()\n\t\t\t\t.describe(\"Number of items to show in full detail in compact mode (default 3)\"),\n\t\t\tcompression_mode: z\n\t\t\t\t.enum([\"off\", \"compact\", \"ids\"])\n\t\t\t\t.optional()\n\t\t\t\t.describe(\n\t\t\t\t\t\"Near-related compression mode: off disables it, compact applies only to compact rendering, ids applies in all modes. Defaults to CODEMEM_PACK_COMPRESSION or compact.\",\n\t\t\t\t),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst renderOptions =\n\t\t\t\t\targs.compact || args.compact_detail_count != null || args.compression_mode != null\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\tcompact: args.compact ?? (args.compact_detail_count != null ? true : undefined),\n\t\t\t\t\t\t\t\tcompactDetailCount: args.compact_detail_count,\n\t\t\t\t\t\t\t\tcompressionMode: args.compression_mode,\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: undefined;\n\t\t\t\tconst result = await store.buildMemoryPackAsync(\n\t\t\t\t\targs.context,\n\t\t\t\t\targs.limit ?? undefined,\n\t\t\t\t\tnull,\n\t\t\t\t\tfilters,\n\t\t\t\t\trenderOptions,\n\t\t\t\t);\n\t\t\t\treturn jsonContent(result);\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n}\n","import { dedupeOrderedIds, type MemoryItemResponse, projectMatchesFilter } from \"@codemem/core\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport { errorContent, jsonContent } from \"../content.js\";\nimport { getManyForMcp } from \"../memory-access.js\";\nimport { buildFilters } from \"../project-scope.js\";\nimport { filterSchema } from \"../schemas.js\";\nimport type { ToolRegistrationContext } from \"../tool-context.js\";\n\nexport function registerTimelineTools(server: McpServer, context: ToolRegistrationContext): void {\n\tconst { defaultProject, store } = context;\n\n\tserver.tool(\n\t\t\"memory_timeline\",\n\t\t\"Get a chronological window of memories around an anchor (by ID or query).\",\n\t\t{\n\t\t\tquery: z.string().optional().describe(\"Search query to find anchor\"),\n\t\t\tmemory_id: z.number().int().optional().describe(\"Anchor memory ID\"),\n\t\t\tdepth_before: z.number().int().min(0).default(3).describe(\"Items before anchor\"),\n\t\t\tdepth_after: z.number().int().min(0).default(3).describe(\"Items after anchor\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\tconst filters = buildFilters(args, defaultProject());\n\t\t\t\tconst items = store.timeline(\n\t\t\t\t\targs.query ?? null,\n\t\t\t\t\targs.memory_id ?? null,\n\t\t\t\t\targs.depth_before,\n\t\t\t\t\targs.depth_after,\n\t\t\t\t\tfilters,\n\t\t\t\t);\n\t\t\t\treturn jsonContent({ items });\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n\n\tserver.tool(\n\t\t\"memory_expand\",\n\t\t\"Fetch memories by ID with surrounding timeline context.\",\n\t\t{\n\t\t\tids: z\n\t\t\t\t.array(z.union([z.number(), z.string()]))\n\t\t\t\t.max(200)\n\t\t\t\t.describe(\"Memory IDs to expand\"),\n\t\t\tdepth_before: z.number().int().min(0).default(3).describe(\"Timeline items before\"),\n\t\t\tdepth_after: z.number().int().min(0).default(3).describe(\"Timeline items after\"),\n\t\t\tinclude_observations: z.boolean().default(false).describe(\"Include full observation details\"),\n\t\t\t...filterSchema,\n\t\t},\n\t\tasync (args) => {\n\t\t\ttry {\n\t\t\t\t// Explicit blank `project` clears scoping for cross-project expansion.\n\t\t\t\t// Only fall back to the server default when `project` is omitted entirely.\n\t\t\t\tconst filterDefaultProject =\n\t\t\t\t\targs.project !== undefined && !args.project.trim() ? null : defaultProject();\n\t\t\t\tconst filters = buildFilters(args, filterDefaultProject);\n\t\t\t\tconst resolvedProject = filters?.project ?? null;\n\t\t\t\tconst { ordered: orderedIds, invalid: invalidIds } = dedupeOrderedIds(args.ids);\n\t\t\t\tconst errors: Array<Record<string, unknown>> = [];\n\n\t\t\t\tif (invalidIds.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"INVALID_ARGUMENT\",\n\t\t\t\t\t\tfield: \"ids\",\n\t\t\t\t\t\tmessage: \"some ids are not valid integers\",\n\t\t\t\t\t\tids: invalidIds,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tconst missingNotFound: number[] = [];\n\t\t\t\tconst missingProjectMismatch: number[] = [];\n\t\t\t\tconst missingFilterMismatch: number[] = [];\n\t\t\t\tconst anchors: MemoryItemResponse[] = [];\n\t\t\t\tconst timelineItems: MemoryItemResponse[] = [];\n\t\t\t\tconst timelineSeen = new Set<number>();\n\t\t\t\tconst sessionProjects = new Map<number, string | null>();\n\n\t\t\t\tfor (const memoryId of orderedIds) {\n\t\t\t\t\tconst item = store.get(memoryId);\n\t\t\t\t\tif (!item?.active) {\n\t\t\t\t\t\tmissingNotFound.push(memoryId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst sessionId = item.session_id;\n\t\t\t\t\tif (resolvedProject && sessionId > 0) {\n\t\t\t\t\t\tif (!sessionProjects.has(sessionId)) {\n\t\t\t\t\t\t\tconst row = store.db\n\t\t\t\t\t\t\t\t.prepare(\"SELECT project FROM sessions WHERE id = ? LIMIT 1\")\n\t\t\t\t\t\t\t\t.get(sessionId) as { project: string | null } | undefined;\n\t\t\t\t\t\t\tsessionProjects.set(sessionId, typeof row?.project === \"string\" ? row.project : null);\n\t\t\t\t\t\t}\n\t\t\t\t\t\tif (!projectMatchesFilter(resolvedProject, sessionProjects.get(sessionId) ?? null)) {\n\t\t\t\t\t\t\tmissingProjectMismatch.push(memoryId);\n\t\t\t\t\t\t\tcontinue;\n\t\t\t\t\t\t}\n\t\t\t\t\t} else if (resolvedProject && sessionId <= 0) {\n\t\t\t\t\t\tmissingProjectMismatch.push(memoryId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tconst expanded = store.timeline(\n\t\t\t\t\t\tnull,\n\t\t\t\t\t\tmemoryId,\n\t\t\t\t\t\targs.depth_before,\n\t\t\t\t\t\targs.depth_after,\n\t\t\t\t\t\tfilters,\n\t\t\t\t\t);\n\t\t\t\t\tconst anchor = expanded.find((expandedItem) => expandedItem.id === memoryId);\n\t\t\t\t\tif (!anchor) {\n\t\t\t\t\t\tmissingFilterMismatch.push(memoryId);\n\t\t\t\t\t\tcontinue;\n\t\t\t\t\t}\n\n\t\t\t\t\tanchors.push(anchor);\n\t\t\t\t\tfor (const expandedItem of expanded) {\n\t\t\t\t\t\tconst expandedId = expandedItem.id;\n\t\t\t\t\t\tif (expandedId <= 0 || timelineSeen.has(expandedId)) continue;\n\t\t\t\t\t\ttimelineSeen.add(expandedId);\n\t\t\t\t\t\ttimelineItems.push(expandedItem);\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tif (missingNotFound.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"NOT_FOUND\",\n\t\t\t\t\t\tfield: \"ids\",\n\t\t\t\t\t\tmessage: \"some requested ids were not found\",\n\t\t\t\t\t\tids: missingNotFound,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (missingProjectMismatch.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"PROJECT_MISMATCH\",\n\t\t\t\t\t\tfield: \"project\",\n\t\t\t\t\t\tmessage: \"some requested ids are outside the requested project scope\",\n\t\t\t\t\t\tids: missingProjectMismatch,\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t\tif (missingFilterMismatch.length > 0) {\n\t\t\t\t\terrors.push({\n\t\t\t\t\t\tcode: \"FILTER_MISMATCH\",\n\t\t\t\t\t\tfield: \"filters\",\n\t\t\t\t\t\tmessage: \"some requested ids are outside the requested filters\",\n\t\t\t\t\t\tids: missingFilterMismatch,\n\t\t\t\t\t});\n\t\t\t\t}\n\n\t\t\t\tlet observations: MemoryItemResponse[] = [];\n\t\t\t\tif (args.include_observations) {\n\t\t\t\t\tconst observationSeen = new Set<number>();\n\t\t\t\t\tconst observationIds: number[] = [];\n\t\t\t\t\tfor (const item of [...anchors, ...timelineItems]) {\n\t\t\t\t\t\tif (item.id > 0 && !observationSeen.has(item.id)) {\n\t\t\t\t\t\t\tobservationSeen.add(item.id);\n\t\t\t\t\t\t\tobservationIds.push(item.id);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tobservations = getManyForMcp(store, observationIds, filters);\n\t\t\t\t}\n\n\t\t\t\treturn jsonContent({\n\t\t\t\t\tanchors,\n\t\t\t\t\ttimeline: timelineItems,\n\t\t\t\t\tobservations,\n\t\t\t\t\tmissing_ids: orderedIds.filter(\n\t\t\t\t\t\t(memoryId: number) =>\n\t\t\t\t\t\t\tmissingNotFound.includes(memoryId) ||\n\t\t\t\t\t\t\tmissingProjectMismatch.includes(memoryId) ||\n\t\t\t\t\t\t\tmissingFilterMismatch.includes(memoryId),\n\t\t\t\t\t),\n\t\t\t\t\terrors,\n\t\t\t\t\tmetadata: {\n\t\t\t\t\t\tproject: resolvedProject,\n\t\t\t\t\t\trequested_ids_count: orderedIds.length,\n\t\t\t\t\t\treturned_anchor_count: anchors.length,\n\t\t\t\t\t\ttimeline_count: timelineItems.length,\n\t\t\t\t\t\tinclude_observations: args.include_observations,\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t} catch (err) {\n\t\t\t\treturn errorContent(err instanceof Error ? err.message : String(err));\n\t\t\t}\n\t\t},\n\t);\n}\n","import { type MemoryStore, VERSION } from \"@codemem/core\";\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { resolveDefaultProject } from \"./project-scope.js\";\nimport type { CodememMcpServerOptions, ToolRegistrationContext } from \"./tool-context.js\";\nimport { registerItemTools } from \"./tools/items.js\";\nimport { registerLearnTools } from \"./tools/learn.js\";\nimport { registerSchemaTools } from \"./tools/schema.js\";\nimport { registerSearchTools } from \"./tools/search.js\";\nimport { registerTimelineTools } from \"./tools/timeline.js\";\n\nexport function createCodememMcpServer(\n\tstore: MemoryStore,\n\toptions: CodememMcpServerOptions = {},\n): McpServer {\n\tconst server = new McpServer({ name: \"codemem\", version: VERSION });\n\tconst context: ToolRegistrationContext = {\n\t\tstore,\n\t\t// Resolve lazily per call so long-running servers pick up the current\n\t\t// CODEMEM_PROJECT / process.cwd() rather than the value at construction.\n\t\tdefaultProject: () => {\n\t\t\tif (options.resolveDefaultProject) return options.resolveDefaultProject();\n\t\t\tif (options.defaultProject !== undefined) return options.defaultProject;\n\t\t\treturn resolveDefaultProject();\n\t\t},\n\t\tenvProject: () =>\n\t\t\toptions.envProject !== undefined ? options.envProject : (process.env.CODEMEM_PROJECT ?? null),\n\t};\n\n\tregisterSearchTools(server, context);\n\tregisterTimelineTools(server, context);\n\tregisterItemTools(server, context);\n\tregisterSchemaTools(server);\n\tregisterLearnTools(server);\n\n\treturn server;\n}\n"],"mappings":"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"}
package/dist/stdio.js CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- import { t as e } from "./server-Djvf0Yik.js";
2
+ import { t as e } from "./server-BH_IcTFq.js";
3
3
  import { MemoryStore as t, resolveDbPath as n } from "@codemem/core";
4
4
  import { existsSync as r } from "node:fs";
5
5
  import { dirname as i, join as a } from "node:path";
package/dist/stdio.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"stdio.js","names":[],"sources":["../src/stdio.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * @codemem/mcp — MCP stdio server bootstrap.\n *\n * Runs as a separate process spawned by the host (OpenCode/Claude).\n * Owns its own better-sqlite3 connection. Communicates via stdio JSON-RPC.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { MemoryStore, resolveDbPath } from \"@codemem/core\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { createCodememMcpServer } from \"./server.js\";\n\n/** Default viewer host/port for health checks. */\nconst VIEWER_HOST = process.env.CODEMEM_VIEWER_HOST ?? \"127.0.0.1\";\nconst VIEWER_PORT = process.env.CODEMEM_VIEWER_PORT ?? \"38888\";\n\n/** Resolve the `codemem` CLI binary path. Checks package-local paths first, then PATH. */\nfunction resolveCliPath(): string | null {\n\t// When installed via npm/npx, the MCP server and CLI share node_modules.\n\t// Walk up from this file to find the CLI's bin entry.\n\tconst candidates: string[] = [];\n\tconst selfDir = dirname(import.meta.dirname ?? \".\");\n\t// Monorepo dev: sibling package\n\tcandidates.push(join(selfDir, \"..\", \"cli\", \"dist\", \"index.js\"));\n\t// npm install: node_modules/.bin/codemem\n\tcandidates.push(join(selfDir, \"..\", \".bin\", \"codemem\"));\n\t// npm install: deeper node_modules\n\tcandidates.push(join(selfDir, \"..\", \"..\", \".bin\", \"codemem\"));\n\tfor (const p of candidates) {\n\t\tif (existsSync(p)) return p;\n\t}\n\t// Fall back to PATH\n\treturn \"codemem\";\n}\n\n/** Check if the viewer is already running. */\nasync function isViewerHealthy(): Promise<boolean> {\n\ttry {\n\t\tconst url = `http://${VIEWER_HOST}:${VIEWER_PORT}/api/health`;\n\t\tconst response = await fetch(url, { signal: AbortSignal.timeout(2_000) });\n\t\treturn response.ok;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Attempt to start the viewer server as a detached background process.\n * Best-effort: failures are logged to stderr but never block MCP startup.\n */\nasync function ensureViewer(): Promise<void> {\n\tif (process.env.CODEMEM_VIEWER === \"0\" || process.env.CODEMEM_VIEWER_AUTO === \"0\") return;\n\n\tif (await isViewerHealthy()) return;\n\n\tconst cli = resolveCliPath();\n\tif (!cli) return;\n\n\ttry {\n\t\t// If the resolved path is a .js file, run it with node.\n\t\t// Otherwise it's a bin script that can run directly.\n\t\tconst isJsFile = cli.endsWith(\".js\");\n\t\tconst cmd = isJsFile ? process.execPath : cli;\n\t\tconst args = isJsFile ? [cli, \"serve\", \"start\"] : [\"serve\", \"start\"];\n\t\t// Pass non-default host/port so the spawned viewer matches what we health-check.\n\t\tif (VIEWER_HOST !== \"127.0.0.1\") args.push(\"--host\", VIEWER_HOST);\n\t\tif (VIEWER_PORT !== \"38888\") args.push(\"--port\", VIEWER_PORT);\n\n\t\tconst child = spawn(cmd, args, {\n\t\t\tdetached: true,\n\t\t\tstdio: \"ignore\",\n\t\t\tenv: { ...process.env, CODEMEM_PLUGIN_IGNORE: \"1\" },\n\t\t});\n\t\tchild.on(\"error\", () => {}); // swallow — best effort\n\t\tchild.unref();\n\n\t\t// Brief health check loop — don't block for long\n\t\tfor (let i = 0; i < 5; i++) {\n\t\t\tawait new Promise((r) => setTimeout(r, 1_000));\n\t\t\tif (await isViewerHealthy()) return;\n\t\t}\n\t} catch {\n\t\t// Best effort — MCP server continues regardless\n\t}\n}\n\nasync function main() {\n\tconst dbPath = resolveDbPath();\n\tconst store = new MemoryStore(dbPath);\n\n\ttry {\n\t\t// Auto-start viewer in background (belt and suspenders with any hook-based start)\n\t\tensureViewer().catch(() => {});\n\n\t\tconst server = createCodememMcpServer(store);\n\t\tconst transport = new StdioServerTransport();\n\n\t\tconst shutdown = () => {\n\t\t\ttry {\n\t\t\t\tstore.close();\n\t\t\t} catch {\n\t\t\t\t// Best effort — process is exiting\n\t\t\t}\n\t\t\tprocess.exit(0);\n\t\t};\n\n\t\tprocess.on(\"SIGINT\", shutdown);\n\t\tprocess.on(\"SIGTERM\", shutdown);\n\n\t\tawait server.connect(transport);\n\t} catch (err) {\n\t\t// Close the store before bubbling so a startup failure does not leave\n\t\t// the SQLite journal behind. Signal handlers are not yet attached if we\n\t\t// crash before `server.connect` resolves.\n\t\ttry {\n\t\t\tstore.close();\n\t\t} catch {\n\t\t\t// best effort\n\t\t}\n\t\tthrow err;\n\t}\n}\n\nmain().catch((err) => {\n\tconsole.error(\"codemem MCP server failed to start:\", err);\n\tprocess.exit(1);\n});\n"],"mappings":";;;;;;;;AAiBA,IAAM,IAAc,QAAQ,IAAI,uBAAuB,aACjD,IAAc,QAAQ,IAAI,uBAAuB;AAGvD,SAAS,IAAgC;CAGxC,IAAM,IAAuB,EAAE,EACzB,IAAU,EAAQ,OAAO,KAAK,WAAW,IAAI;AAMnD,CAJA,EAAW,KAAK,EAAK,GAAS,MAAM,OAAO,QAAQ,WAAW,CAAC,EAE/D,EAAW,KAAK,EAAK,GAAS,MAAM,QAAQ,UAAU,CAAC,EAEvD,EAAW,KAAK,EAAK,GAAS,MAAM,MAAM,QAAQ,UAAU,CAAC;AAC7D,MAAK,IAAM,KAAK,EACf,KAAI,EAAW,EAAE,CAAE,QAAO;AAG3B,QAAO;;AAIR,eAAe,IAAoC;AAClD,KAAI;EACH,IAAM,IAAM,UAAU,EAAY,GAAG,EAAY;AAEjD,UAAO,MADgB,MAAM,GAAK,EAAE,QAAQ,YAAY,QAAQ,IAAM,EAAE,CAAC,EACzD;SACT;AACP,SAAO;;;AAQT,eAAe,IAA8B;AAG5C,KAFI,QAAQ,IAAI,mBAAmB,OAAO,QAAQ,IAAI,wBAAwB,OAE1E,MAAM,GAAiB,CAAE;CAE7B,IAAM,IAAM,GAAgB;AACvB,OAEL,KAAI;EAGH,IAAM,IAAW,EAAI,SAAS,MAAM,EAC9B,IAAM,IAAW,QAAQ,WAAW,GACpC,IAAO,IAAW;GAAC;GAAK;GAAS;GAAQ,GAAG,CAAC,SAAS,QAAQ;AAGpE,EADI,MAAgB,eAAa,EAAK,KAAK,UAAU,EAAY,EAC7D,MAAgB,WAAS,EAAK,KAAK,UAAU,EAAY;EAE7D,IAAM,IAAQ,EAAM,GAAK,GAAM;GAC9B,UAAU;GACV,OAAO;GACP,KAAK;IAAE,GAAG,QAAQ;IAAK,uBAAuB;IAAK;GACnD,CAAC;AAEF,EADA,EAAM,GAAG,eAAe,GAAG,EAC3B,EAAM,OAAO;AAGb,OAAK,IAAI,IAAI,GAAG,IAAI,GAAG,IAEtB,KADA,MAAM,IAAI,SAAS,MAAM,WAAW,GAAG,IAAM,CAAC,EAC1C,MAAM,GAAiB,CAAE;SAEvB;;AAKT,eAAe,IAAO;CAErB,IAAM,IAAQ,IAAI,EADH,GACe,CAAO;AAErC,KAAI;AAEH,KAAc,CAAC,YAAY,GAAG;EAE9B,IAAM,IAAS,EAAuB,EAAM,EACtC,IAAY,IAAI,GAAsB,EAEtC,UAAiB;AACtB,OAAI;AACH,MAAM,OAAO;WACN;AAGR,WAAQ,KAAK,EAAE;;AAMhB,EAHA,QAAQ,GAAG,UAAU,EAAS,EAC9B,QAAQ,GAAG,WAAW,EAAS,EAE/B,MAAM,EAAO,QAAQ,EAAU;UACvB,GAAK;AAIb,MAAI;AACH,KAAM,OAAO;UACN;AAGR,QAAM;;;AAIR,GAAM,CAAC,OAAO,MAAQ;AAErB,CADA,QAAQ,MAAM,uCAAuC,EAAI,EACzD,QAAQ,KAAK,EAAE;EACd"}
1
+ {"version":3,"file":"stdio.js","names":[],"sources":["../src/stdio.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * @codemem/mcp — MCP stdio server bootstrap.\n *\n * Runs as a separate process spawned by the host (OpenCode/Claude).\n * Owns its own better-sqlite3 connection. Communicates via stdio JSON-RPC.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { MemoryStore, resolveDbPath } from \"@codemem/core\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { createCodememMcpServer } from \"./server.js\";\n\n/** Default viewer host/port for health checks. */\nconst VIEWER_HOST = process.env.CODEMEM_VIEWER_HOST ?? \"127.0.0.1\";\nconst VIEWER_PORT = process.env.CODEMEM_VIEWER_PORT ?? \"38888\";\n\n/** Resolve the `codemem` CLI binary path. Checks package-local paths first, then PATH. */\nfunction resolveCliPath(): string | null {\n\t// When installed via npm/npx, the MCP server and CLI share node_modules.\n\t// Walk up from this file to find the CLI's bin entry.\n\tconst candidates: string[] = [];\n\tconst selfDir = dirname(import.meta.dirname ?? \".\");\n\t// Monorepo dev: sibling package\n\tcandidates.push(join(selfDir, \"..\", \"cli\", \"dist\", \"index.js\"));\n\t// npm install: node_modules/.bin/codemem\n\tcandidates.push(join(selfDir, \"..\", \".bin\", \"codemem\"));\n\t// npm install: deeper node_modules\n\tcandidates.push(join(selfDir, \"..\", \"..\", \".bin\", \"codemem\"));\n\tfor (const p of candidates) {\n\t\tif (existsSync(p)) return p;\n\t}\n\t// Fall back to PATH\n\treturn \"codemem\";\n}\n\n/** Check if the viewer is already running. */\nasync function isViewerHealthy(): Promise<boolean> {\n\ttry {\n\t\tconst url = `http://${VIEWER_HOST}:${VIEWER_PORT}/api/health`;\n\t\tconst response = await fetch(url, { signal: AbortSignal.timeout(2_000) });\n\t\treturn response.ok;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Attempt to start the viewer server as a detached background process.\n * Best-effort: failures are logged to stderr but never block MCP startup.\n */\nasync function ensureViewer(): Promise<void> {\n\tif (process.env.CODEMEM_VIEWER === \"0\" || process.env.CODEMEM_VIEWER_AUTO === \"0\") return;\n\n\tif (await isViewerHealthy()) return;\n\n\tconst cli = resolveCliPath();\n\tif (!cli) return;\n\n\ttry {\n\t\t// If the resolved path is a .js file, run it with node.\n\t\t// Otherwise it's a bin script that can run directly.\n\t\tconst isJsFile = cli.endsWith(\".js\");\n\t\tconst cmd = isJsFile ? process.execPath : cli;\n\t\tconst args = isJsFile ? [cli, \"serve\", \"start\"] : [\"serve\", \"start\"];\n\t\t// Pass non-default host/port so the spawned viewer matches what we health-check.\n\t\tif (VIEWER_HOST !== \"127.0.0.1\") args.push(\"--host\", VIEWER_HOST);\n\t\tif (VIEWER_PORT !== \"38888\") args.push(\"--port\", VIEWER_PORT);\n\n\t\tconst child = spawn(cmd, args, {\n\t\t\tdetached: true,\n\t\t\tstdio: \"ignore\",\n\t\t\tenv: { ...process.env, CODEMEM_PLUGIN_IGNORE: \"1\" },\n\t\t});\n\t\tchild.on(\"error\", () => {}); // swallow — best effort\n\t\tchild.unref();\n\n\t\t// Brief health check loop — don't block for long\n\t\tfor (let i = 0; i < 5; i++) {\n\t\t\tawait new Promise((r) => setTimeout(r, 1_000));\n\t\t\tif (await isViewerHealthy()) return;\n\t\t}\n\t} catch {\n\t\t// Best effort — MCP server continues regardless\n\t}\n}\n\nasync function main() {\n\tconst dbPath = resolveDbPath();\n\tconst store = new MemoryStore(dbPath);\n\n\ttry {\n\t\t// Auto-start viewer in background (belt and suspenders with any hook-based start)\n\t\tensureViewer().catch(() => {});\n\n\t\tconst server = createCodememMcpServer(store);\n\t\tconst transport = new StdioServerTransport();\n\n\t\tconst shutdown = () => {\n\t\t\ttry {\n\t\t\t\tstore.close();\n\t\t\t} catch {\n\t\t\t\t// Best effort — process is exiting\n\t\t\t}\n\t\t\tprocess.exit(0);\n\t\t};\n\n\t\tprocess.on(\"SIGINT\", shutdown);\n\t\tprocess.on(\"SIGTERM\", shutdown);\n\n\t\tawait server.connect(transport);\n\t} catch (err) {\n\t\t// Close the store before bubbling so a startup failure does not leave\n\t\t// the SQLite journal behind. Signal handlers are not yet attached if we\n\t\t// crash before `server.connect` resolves.\n\t\ttry {\n\t\t\tstore.close();\n\t\t} catch {\n\t\t\t// best effort\n\t\t}\n\t\tthrow err;\n\t}\n}\n\nmain().catch((err) => {\n\tconsole.error(\"codemem MCP server failed to start:\", err);\n\tprocess.exit(1);\n});\n"],"mappings":";;;;;;;;AAiBA,IAAM,IAAc,QAAQ,IAAI,uBAAuB,aACjD,IAAc,QAAQ,IAAI,uBAAuB;AAGvD,SAAS,IAAgC;CAGxC,IAAM,IAAuB,CAAC,GACxB,IAAU,EAAQ,OAAO,KAAK,WAAW,GAAG;CAMlD,AAJA,EAAW,KAAK,EAAK,GAAS,MAAM,OAAO,QAAQ,UAAU,CAAC,GAE9D,EAAW,KAAK,EAAK,GAAS,MAAM,QAAQ,SAAS,CAAC,GAEtD,EAAW,KAAK,EAAK,GAAS,MAAM,MAAM,QAAQ,SAAS,CAAC;CAC5D,KAAK,IAAM,KAAK,GACf,IAAI,EAAW,CAAC,GAAG,OAAO;CAG3B,OAAO;AACR;AAGA,eAAe,IAAoC;CAClD,IAAI;EACH,IAAM,IAAM,UAAU,EAAY,GAAG,EAAY;EAEjD,QAAO,MADgB,MAAM,GAAK,EAAE,QAAQ,YAAY,QAAQ,GAAK,EAAE,CAAC,GACxD;CACjB,QAAQ;EACP,OAAO;CACR;AACD;AAMA,eAAe,IAA8B;CAG5C,IAFI,QAAQ,IAAI,mBAAmB,OAAO,QAAQ,IAAI,wBAAwB,OAE1E,MAAM,EAAgB,GAAG;CAE7B,IAAM,IAAM,EAAe;CACtB,OAEL,IAAI;EAGH,IAAM,IAAW,EAAI,SAAS,KAAK,GAC7B,IAAM,IAAW,QAAQ,WAAW,GACpC,IAAO,IAAW;GAAC;GAAK;GAAS;EAAO,IAAI,CAAC,SAAS,OAAO;EAGnE,AADI,MAAgB,eAAa,EAAK,KAAK,UAAU,CAAW,GAC5D,MAAgB,WAAS,EAAK,KAAK,UAAU,CAAW;EAE5D,IAAM,IAAQ,EAAM,GAAK,GAAM;GAC9B,UAAU;GACV,OAAO;GACP,KAAK;IAAE,GAAG,QAAQ;IAAK,uBAAuB;GAAI;EACnD,CAAC;EAED,AADA,EAAM,GAAG,eAAe,CAAC,CAAC,GAC1B,EAAM,MAAM;EAGZ,KAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAEtB,IADA,MAAM,IAAI,SAAS,MAAM,WAAW,GAAG,GAAK,CAAC,GACzC,MAAM,EAAgB,GAAG;CAE/B,QAAQ,CAER;AACD;AAEA,eAAe,IAAO;CAErB,IAAM,IAAQ,IAAI,EADH,EACe,CAAM;CAEpC,IAAI;EAEH,EAAa,EAAE,YAAY,CAAC,CAAC;EAE7B,IAAM,IAAS,EAAuB,CAAK,GACrC,IAAY,IAAI,EAAqB,GAErC,UAAiB;GACtB,IAAI;IACH,EAAM,MAAM;GACb,QAAQ,CAER;GACA,QAAQ,KAAK,CAAC;EACf;EAKA,AAHA,QAAQ,GAAG,UAAU,CAAQ,GAC7B,QAAQ,GAAG,WAAW,CAAQ,GAE9B,MAAM,EAAO,QAAQ,CAAS;CAC/B,SAAS,GAAK;EAIb,IAAI;GACH,EAAM,MAAM;EACb,QAAQ,CAER;EACA,MAAM;CACP;AACD;AAEA,EAAK,EAAE,OAAO,MAAQ;CAErB,AADA,QAAQ,MAAM,uCAAuC,CAAG,GACxD,QAAQ,KAAK,CAAC;AACf,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@codemem/mcp",
3
- "version": "0.35.2",
3
+ "version": "0.36.0",
4
4
  "type": "module",
5
5
  "types": "./dist/index.d.ts",
6
6
  "exports": {
@@ -30,15 +30,15 @@
30
30
  "@modelcontextprotocol/sdk": "^1.29.0",
31
31
  "express": "^5.2.1",
32
32
  "express-rate-limit": "^8.5.2",
33
- "zod": "^4.4.2",
34
- "@codemem/core": "^0.35.2"
33
+ "zod": "^4.4.3",
34
+ "@codemem/core": "^0.36.0"
35
35
  },
36
36
  "devDependencies": {
37
37
  "@types/express": "^5.0.6",
38
- "@types/node": "^24.0.0",
38
+ "@types/node": "^24.12.4",
39
39
  "typescript": "^6.0.3",
40
- "vite": "^8.0.10",
41
- "vitest": "^4.1.5"
40
+ "vite": "^8.0.14",
41
+ "vitest": "^4.1.7"
42
42
  },
43
43
  "repository": {
44
44
  "type": "git",