@membank/core 0.11.1 → 0.12.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.cjs +108 -39
- package/dist/index.d.cts +108 -16
- package/dist/index.d.mts +108 -16
- package/dist/index.mjs +108 -39
- package/package.json +1 -1
package/dist/index.cjs
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`node:
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`node:crypto`),l=require(`zod`),u=require(`node:fs`),d=require(`node:os`),f=require(`node:path`),p=require(`better-sqlite3`);p=s(p,1);let m=require(`sqlite-vec`);m=s(m,1);let ee=require(`node:events`),h=require(`@huggingface/transformers`),g=require(`@anthropic-ai/claude-agent-sdk`),te=require(`node:fs/promises`),ne=require(`node:child_process`),re=require(`node:util`);function ie(e,t){return t.list(e)}const _=[`memory.created`,`memory.updated`,`memory.deleted`,`memory.flagged`,`memory.queried`],v=l.z.enum(_);function y(e,t){let n=new Date,r=n.toISOString();t.insert({id:(0,c.randomUUID)(),projectHash:e.projectHash,eventType:e.eventType,memoryId:e.memoryId??null,payload:e.payload??{},createdAt:r});let i=new Date(n);i.setDate(i.getDate()-30),t.prune(i.toISOString())}function ae(e){return{id:e.id,projectHash:e.project_hash,eventType:v.parse(e.event_type),memoryId:e.memory_id,payload:JSON.parse(e.payload),createdAt:e.created_at}}var b=class{#e;#t=0;#n;#r;constructor(e){this.#e=e,this.#n=e.db.prepare(`INSERT INTO activity_events (id, project_hash, event_type, memory_id, payload, created_at)
|
|
2
|
+
VALUES (?, ?, ?, ?, ?, ?)`),this.#r=e.db.prepare(`DELETE FROM activity_events WHERE created_at < ?`)}insert(e){this.#n.run(e.id,e.projectHash,e.eventType,e.memoryId,JSON.stringify(e.payload),e.createdAt)}list(e){let t=[],n=[];e.scope!==void 0&&(t.push(`project_hash = ?`),n.push(e.scope)),e.type!==void 0&&(t.push(`event_type = ?`),n.push(e.type)),e.since!==void 0&&(t.push(`created_at >= ?`),n.push(e.since));let r=t.length>0?`WHERE ${t.join(` AND `)}`:``,i=e.limit===void 0?``:`LIMIT ?`;return e.limit!==void 0&&n.push(e.limit),this.#e.db.prepare(`SELECT * FROM activity_events ${r} ORDER BY created_at DESC ${i}`).all(...n).map(ae)}prune(e){let t=Date.now();t-this.#t<6e4||(this.#r.run(e),this.#t=t)}};function oe(e){return new b(e)}function se(e){let t=new b(e);return{logEvent:e=>y(e,t)}}const x={logEvent(){}};function ce(){let e=(0,f.join)((0,d.homedir)(),`.membank`,`config.json`);try{let t=(0,u.readFileSync)(e,`utf8`);return JSON.parse(t)}catch{return null}}function le(){return ce()?.synthesis?.enabled===!0}const S=[`correction`,`preference`,`decision`,`learning`,`fact`],C=l.z.enum(S),w=l.z.array(l.z.string()),T=l.z.object({id:l.z.string(),name:l.z.string(),scopeHash:l.z.string(),createdAt:l.z.string(),updatedAt:l.z.string()}),E=l.z.enum([`similarity_dedup`]),D=l.z.object({id:l.z.string(),memoryId:l.z.string(),conflictingMemoryId:l.z.string().nullable(),similarity:l.z.number(),conflictContentSnapshot:l.z.string(),reason:E,createdAt:l.z.string(),resolvedAt:l.z.string().nullable()}),O=l.z.object({id:l.z.string(),memory_id:l.z.string(),conflicting_memory_id:l.z.string().nullable(),similarity:l.z.number(),conflict_content_snapshot:l.z.string(),reason:E,created_at:l.z.string(),resolved_at:l.z.string().nullable()}),k=l.z.object({id:l.z.string(),content:l.z.string(),type:C,tags:l.z.array(l.z.string()),projects:l.z.array(T),sourceHarness:l.z.string().nullable(),accessCount:l.z.number().int().nonnegative(),pinned:l.z.boolean(),reviewEvents:l.z.array(D),createdAt:l.z.string(),updatedAt:l.z.string()}),A=l.z.object({query:l.z.string().min(1),type:C.optional(),projectHash:l.z.string().optional(),limit:l.z.number().int().positive().optional(),includePinned:l.z.boolean().optional()}),ue=l.z.object({content:l.z.string().min(1),type:C,tags:l.z.array(l.z.string()).optional(),projectScope:l.z.object({hash:l.z.string(),name:l.z.string()}).optional(),sourceHarness:l.z.string().optional()}),j=l.z.object({content:l.z.string().min(1).optional(),tags:l.z.array(l.z.string()).optional(),type:C.optional()}),M=l.z.object({id:l.z.string(),scope:l.z.string(),content:l.z.string(),sourceMemoryHash:l.z.string(),synthesizedAt:l.z.string(),expiresAt:l.z.string(),inFlightSince:l.z.string().nullable(),createdAt:l.z.string(),updatedAt:l.z.string()}),de=l.z.object({stats:l.z.record(C,l.z.number()),pinnedGlobal:l.z.array(k),pinnedProject:l.z.array(k),synthesis:l.z.string().optional()}),N=l.z.object({id:l.z.string(),content:l.z.string(),type:l.z.string(),tags:l.z.string(),source:l.z.string().nullable(),access_count:l.z.number(),pinned:l.z.number(),created_at:l.z.string(),updated_at:l.z.string()}),P=l.z.object({id:l.z.string(),name:l.z.string(),scope_hash:l.z.string(),created_at:l.z.string(),updated_at:l.z.string()});function F(e,t,n=[]){return{id:e.id,content:e.content,type:C.parse(e.type),tags:w.parse(JSON.parse(e.tags)),projects:t,sourceHarness:e.source,accessCount:e.access_count,pinned:e.pinned!==0,reviewEvents:n,createdAt:e.created_at,updatedAt:e.updated_at}}function I(e){let t=O.parse(e);return{id:t.id,memoryId:t.memory_id,conflictingMemoryId:t.conflicting_memory_id,similarity:t.similarity,conflictContentSnapshot:t.conflict_content_snapshot,reason:t.reason,createdAt:t.created_at,resolvedAt:t.resolved_at}}function L(e){return{id:e.id,name:e.name,scopeHash:e.scope_hash,createdAt:e.created_at,updatedAt:e.updated_at}}var R=class extends Error{constructor(e,t){super(e,t),this.name=`MembankError`}},z=class extends R{constructor(e,t){super(e,t),this.name=`DatabaseError`}};const fe=(0,f.join)((0,d.homedir)(),`.membank`,`memory.db`),pe=[[1,`
|
|
2
3
|
CREATE TABLE IF NOT EXISTS memories (
|
|
3
4
|
id TEXT PRIMARY KEY,
|
|
4
5
|
content TEXT NOT NULL,
|
|
@@ -154,14 +155,86 @@ CREATE TABLE IF NOT EXISTS extraction_runs (
|
|
|
154
155
|
|
|
155
156
|
CREATE INDEX IF NOT EXISTS idx_extraction_runs_status
|
|
156
157
|
ON extraction_runs(status) WHERE status = 'in_flight';
|
|
157
|
-
`]
|
|
158
|
+
`],[7,`
|
|
159
|
+
INSERT OR IGNORE INTO projects (id, name, scope_hash, created_at, updated_at)
|
|
160
|
+
VALUES ('00000000-0000-0000-0000-000000000000', 'global', '0000000000000000', datetime('now'), datetime('now'));
|
|
161
|
+
|
|
162
|
+
INSERT OR IGNORE INTO memory_projects (memory_id, project_id)
|
|
163
|
+
SELECT id, '00000000-0000-0000-0000-000000000000'
|
|
164
|
+
FROM memories
|
|
165
|
+
WHERE id NOT IN (SELECT memory_id FROM memory_projects);
|
|
166
|
+
`],[8,`
|
|
167
|
+
PRAGMA foreign_keys = OFF;
|
|
168
|
+
|
|
169
|
+
BEGIN;
|
|
170
|
+
|
|
171
|
+
UPDATE syntheses SET scope = '0000000000000000' WHERE scope = 'global';
|
|
172
|
+
|
|
173
|
+
DROP TABLE IF EXISTS syntheses_new;
|
|
174
|
+
|
|
175
|
+
CREATE TABLE syntheses_new (
|
|
176
|
+
id TEXT PRIMARY KEY,
|
|
177
|
+
scope TEXT NOT NULL REFERENCES projects(scope_hash) ON DELETE CASCADE,
|
|
178
|
+
content TEXT NOT NULL,
|
|
179
|
+
source_memory_hash TEXT NOT NULL,
|
|
180
|
+
synthesized_at TEXT NOT NULL,
|
|
181
|
+
expires_at TEXT NOT NULL,
|
|
182
|
+
in_flight_since TEXT,
|
|
183
|
+
created_at TEXT NOT NULL,
|
|
184
|
+
updated_at TEXT NOT NULL,
|
|
185
|
+
UNIQUE(scope),
|
|
186
|
+
CHECK(expires_at > synthesized_at)
|
|
187
|
+
);
|
|
188
|
+
|
|
189
|
+
INSERT INTO syntheses_new SELECT * FROM syntheses;
|
|
190
|
+
|
|
191
|
+
DROP TABLE syntheses;
|
|
192
|
+
ALTER TABLE syntheses_new RENAME TO syntheses;
|
|
193
|
+
|
|
194
|
+
CREATE INDEX IF NOT EXISTS idx_syntheses_expires_at ON syntheses(expires_at);
|
|
195
|
+
CREATE INDEX IF NOT EXISTS idx_syntheses_scope_inflight
|
|
196
|
+
ON syntheses(scope) WHERE in_flight_since IS NOT NULL;
|
|
197
|
+
|
|
198
|
+
COMMIT;
|
|
199
|
+
|
|
200
|
+
PRAGMA foreign_keys = ON;
|
|
201
|
+
`],[9,`
|
|
202
|
+
CREATE TABLE activity_events (
|
|
203
|
+
id TEXT PRIMARY KEY,
|
|
204
|
+
project_hash TEXT NOT NULL REFERENCES projects(scope_hash) ON DELETE CASCADE,
|
|
205
|
+
event_type TEXT NOT NULL,
|
|
206
|
+
memory_id TEXT,
|
|
207
|
+
payload TEXT NOT NULL,
|
|
208
|
+
created_at TEXT NOT NULL
|
|
209
|
+
);
|
|
210
|
+
|
|
211
|
+
CREATE INDEX idx_activity_project_created ON activity_events(project_hash, created_at DESC);
|
|
212
|
+
CREATE INDEX idx_activity_type_created ON activity_events(event_type, created_at DESC);
|
|
213
|
+
`],[10,`
|
|
214
|
+
ALTER TABLE activity_events RENAME TO activity_events_old;
|
|
215
|
+
|
|
216
|
+
CREATE TABLE activity_events (
|
|
217
|
+
id TEXT PRIMARY KEY,
|
|
218
|
+
project_hash TEXT NOT NULL,
|
|
219
|
+
event_type TEXT NOT NULL,
|
|
220
|
+
memory_id TEXT,
|
|
221
|
+
payload TEXT NOT NULL,
|
|
222
|
+
created_at TEXT NOT NULL
|
|
223
|
+
);
|
|
224
|
+
|
|
225
|
+
INSERT INTO activity_events SELECT * FROM activity_events_old;
|
|
226
|
+
DROP TABLE activity_events_old;
|
|
227
|
+
|
|
228
|
+
CREATE INDEX idx_activity_project_created ON activity_events(project_hash, created_at DESC);
|
|
229
|
+
CREATE INDEX idx_activity_type_created ON activity_events(event_type, created_at DESC);
|
|
230
|
+
`]];var me=class e{#e;constructor(e){this.#e=e}static open(t){let n=t??fe;(0,u.mkdirSync)((0,f.dirname)(n),{recursive:!0});let r=new p.default(n);return e.#n(r,m.load)}static openInMemory(){return e.#t(m.load)}static _openInMemoryWithLoader(t){return e.#t(t)}static#t(t){let n=new p.default(`:memory:`);return e.#n(n,t)}static#n(t,n){try{n(t)}catch(e){throw new z(`Failed to load sqlite-vec extension`,{cause:e})}t.pragma(`journal_mode = WAL`),t.pragma(`foreign_keys = ON`);let r=new e(t);return r.#r(),r}#r(){this.#e.exec(`
|
|
158
231
|
CREATE TABLE IF NOT EXISTS meta (
|
|
159
232
|
key TEXT PRIMARY KEY,
|
|
160
233
|
value TEXT NOT NULL
|
|
161
234
|
);
|
|
162
|
-
`);let e=this.#e.prepare(`SELECT value FROM meta WHERE key = 'schema_version'`).get(),t=e?Number.parseInt(e.value,10):0;for(let[e,n]of
|
|
163
|
-
`);var
|
|
164
|
-
`),r=Object.fromEntries(Object.entries(process.env).filter(e=>e[1]!==void 0)),i=Date.now(),a=(0,
|
|
235
|
+
`);let e=this.#e.prepare(`SELECT value FROM meta WHERE key = 'schema_version'`).get(),t=e?Number.parseInt(e.value,10):0;for(let[e,n]of pe)t<e&&(this.#e.exec(n),this.#e.prepare(`INSERT OR REPLACE INTO meta (key, value) VALUES ('schema_version', ?)`).run(String(e)))}get db(){return this.#e}close(){this.#e.close()}};const B=`Xenova/bge-small-en-v1.5`;var V=class extends Error{constructor(e,t){super(e,t),this.name=`ModelDownloadError`}};function he(){return(0,f.join)((0,d.homedir)(),`.membank`,`models`)}function H(e){if(!(0,u.existsSync)(e))return!1;try{return(0,u.readdirSync)(e).length>0}catch{return!1}}var ge=class extends ee.EventEmitter{modelPath;constructor(e){super(),this.modelPath=e??he()}isAlreadyCached(){return H(this.modelPath)}get cachePath(){return this.modelPath}async download(){if(H(this.modelPath))return{skipped:!0};let e=Date.now(),t=0,n=e;try{await(0,h.pipeline)(`feature-extraction`,B,{cache_dir:this.modelPath,progress_callback:e=>{if(e.status!==`progress`||e.total==null||e.loaded==null)return;let r=e.total,i=e.loaded,a=r>0?i/r*100:0,o=Date.now(),s=o-n,c=i-t,l=0;if(s>0&&c>0){let e=c/s;l=(r-i)/e/1e3}t=i,n=o;let u={totalBytes:r,downloadedBytes:i,percentage:a,estimatedSecondsRemaining:l};this.emit(`progress`,u)}})}catch(e){throw new V(`Failed to download model`,{cause:e})}return{skipped:!1}}},_e=class{modelCachePath;onProgress;pipelineInstance=null;constructor(e,t){this.modelCachePath=e??(0,f.join)((0,d.homedir)(),`.membank`,`models`),this.onProgress=t}async getPipeline(){return this.pipelineInstance===null&&(this.pipelineInstance=await(0,h.pipeline)(`feature-extraction`,`Xenova/bge-small-en-v1.5`,{cache_dir:this.modelCachePath,progress_callback:this.onProgress})),this.pipelineInstance}async embed(e){let t=(await(await this.getPipeline())(e,{pooling:`mean`,normalize:!0})).data;return t instanceof Float32Array?t:new Float32Array(t)}};async function ve(e,t){let n=t.now??(()=>new Date);if(!t.repo.tryClaim(e.sessionId,n(),t.config)){let n=t.repo.get(e.sessionId);return{status:`skipped`,reason:n?.status===`completed`&&n.completedAt!==null?`recently_completed`:`in_flight`}}try{let r=await t.transcripts.read(e.transcriptPath);return await t.agent.run({transcript:r,projectHash:e.projectHash,sessionId:e.sessionId}),t.repo.markCompleted(e.sessionId,n()),{status:`completed`}}catch(r){let i=r instanceof Error?r.message:String(r);return t.repo.markFailed(e.sessionId,n(),i),{status:`failed`,error:i}}}const ye=[`You are a memory extractor that runs after a coding session ends. You read the session transcript and CALL save_memory for every durable fact, preference, correction, decision, or learning the user expressed, so that future sessions inherit them.`,``,`Memory types (pick the closest match):`,`- correction: the user told the assistant to stop doing something or to do it differently.`,`- preference: the user stated how they want work done (tools, style, conventions).`,`- decision: the user committed to a choice future work should respect (tech pick, architectural direction, scope cut).`,`- learning: a non-obvious fact about the codebase or tooling that future sessions would otherwise rediscover.`,`- fact: stable info about the user or their project not derivable from the code.`,``,`Bias strongly toward saving. If the user said it in plain language and it would be useful in a future session, save it. Phrasing like 'stop X', 'always Y', 'we use Z', 'don't suggest W', 'we decided', 'from now on' is a clear save signal — even when the assistant in the transcript already acknowledged it, save it so the NEXT session also knows.`,``,`Process:`,`1. Read the supplied transcript end-to-end.`,`2. Identify every distinct durable signal. List them mentally before calling tools.`,`3. Optional: call query_memory with focused search terms to avoid duplicates. If a near-duplicate exists, call update_memory instead of save_memory.`,`4. Call save_memory for each new durable signal. Phrase the content as a standalone instruction or fact — strip session framing ("in this session", "just now"). Good: "Use pnpm, not npm, for all dependency operations." Bad: "User said stop using npm."`,"5. Use `global: true` only when the fact is about the user themselves or applies across every project. Otherwise default to project scope (omit `global`).",``,`Only return without saving when the transcript truly contains no durable signal — pure greetings, time-of-day questions, abandoned tasks. Do not invent facts. If in doubt and the signal is concrete, save it.`].join(`
|
|
236
|
+
`);var be=class{#e;constructor(e){this.#e=e}async run(e){let t=(0,g.createSdkMcpServer)({name:`membank-extraction-tools`,version:`1.0.0`,tools:[(0,g.tool)(`query_memory`,`Search memories by semantic similarity to check for existing entries before saving.`,{query:l.z.string().describe(`Search text`),limit:l.z.number().optional().describe(`Maximum results to return`),global:l.z.boolean().optional().describe(`Query global memories when true, otherwise current project scope`)},async({query:t,limit:n,global:r})=>({content:[{type:`text`,text:await this.#e.queryMemory({query:t,limit:n,global:r,projectHash:e.projectHash})}]}),{annotations:{readOnlyHint:!0}}),(0,g.tool)(`save_memory`,`Persist a new memory. The system handles dedup automatically.`,{content:l.z.string().describe(`Memory content — concise, decontextualised`),type:l.z.enum([`correction`,`preference`,`decision`,`learning`,`fact`]).describe(`Memory type`),tags:l.z.array(l.z.string()).optional().describe(`Optional tags`),global:l.z.boolean().optional().describe(`Save as global memory rather than project-scoped`)},async({content:e,type:t,tags:n,global:r})=>({content:[{type:`text`,text:await this.#e.saveMemory({content:e,type:t,tags:n,global:r})}]})),(0,g.tool)(`update_memory`,`Refine an existing memory by id rather than creating a near-duplicate.`,{id:l.z.string().describe(`Memory id`),content:l.z.string().optional(),type:l.z.enum([`correction`,`preference`,`decision`,`learning`,`fact`]).optional(),tags:l.z.array(l.z.string()).optional()},async({id:e,content:t,type:n,tags:r})=>({content:[{type:`text`,text:await this.#e.updateMemory({id:e,content:t,type:n,tags:r})}]}))]}),n=[`Session id: ${e.sessionId}`,``,`Transcript (most recent turns):`,`---`,e.transcript,`---`,``,`Extract durable memories from this transcript following the system instructions.`].join(`
|
|
237
|
+
`),r=Object.fromEntries(Object.entries(process.env).filter(e=>e[1]!==void 0)),i=Date.now(),a=(0,g.query)({prompt:n,options:{model:`claude-haiku-4-5-20251001`,systemPrompt:ye,mcpServers:{"membank-extraction-tools":t},allowedTools:[`mcp__membank-extraction-tools__query_memory`,`mcp__membank-extraction-tools__save_memory`,`mcp__membank-extraction-tools__update_memory`],disallowedTools:[`mcp__membank__*`],settingSources:[],permissionMode:`bypassPermissions`,env:r}}),o=process.env.MEMBANK_EXTRACTION_DEBUG===`true`;for await(let e of a)if(o&&process.stderr.write(`[extraction debug] ${JSON.stringify(e).slice(0,600)}\n`),e.type===`result`&&e.subtype!==`success`){let t=`errors`in e&&Array.isArray(e.errors)?`: ${e.errors.join(`; `)}`:``;throw Error(`Extraction agent failed: ${e.subtype}${t}`)}let s=Date.now()-i;process.stderr.write(`membank extraction: session=${e.sessionId} duration=${s}ms\n`)}};function xe(e){return new be(e)}function Se(e,t,n,r){return e===void 0?{kind:`claim`}:e.status===`in_flight`?t.getTime()-e.startedAt.getTime()<n?{kind:`skip`,reason:`in_flight`}:{kind:`claim`}:e.status===`completed`&&e.completedAt!==null&&t.getTime()-e.completedAt.getTime()<r?{kind:`skip`,reason:`recently_completed`}:{kind:`claim`}}function Ce(e){return{sessionId:e.session_id,startedAt:e.started_at,completedAt:e.completed_at,status:e.status,error:e.error}}var we=class{#e;constructor(e){this.#e=e}tryClaim(e,t,n){let r=this.#t(e);if(Se(r===void 0?void 0:{startedAt:new Date(r.started_at),completedAt:r.completed_at===null?null:new Date(r.completed_at),status:r.status},t,n.inFlightTimeoutMs??6e5,n.recentCompletionMs??6e4).kind===`skip`)return!1;let i=t.toISOString();return this.#e.db.prepare(`INSERT INTO extraction_runs (session_id, started_at, completed_at, status, error)
|
|
165
238
|
VALUES (?, ?, NULL, 'in_flight', NULL)
|
|
166
239
|
ON CONFLICT(session_id) DO UPDATE SET
|
|
167
240
|
started_at = excluded.started_at,
|
|
@@ -171,26 +244,25 @@ CREATE INDEX IF NOT EXISTS idx_extraction_runs_status
|
|
|
171
244
|
SET status = 'completed', completed_at = ?, error = NULL
|
|
172
245
|
WHERE session_id = ?`).run(t.toISOString(),e)}markFailed(e,t,n){this.#e.db.prepare(`UPDATE extraction_runs
|
|
173
246
|
SET status = 'failed', completed_at = ?, error = ?
|
|
174
|
-
WHERE session_id = ?`).run(t.toISOString(),n,e)}get(e){let t=this.#t(e);return t===void 0?void 0:
|
|
175
|
-
`)}var
|
|
176
|
-
`).filter(e=>e.length>0),n=[];for(let e of t){let t;try{t=JSON.parse(e)}catch{continue}let r=t.message?.role;if(r!==`user`&&r!==`assistant`)continue;let i=
|
|
247
|
+
WHERE session_id = ?`).run(t.toISOString(),n,e)}get(e){let t=this.#t(e);return t===void 0?void 0:Ce(t)}#t(e){return this.#e.db.prepare(`SELECT * FROM extraction_runs WHERE session_id = ?`).get(e)}};function Te(e){return new we(e)}function Ee(e){if(typeof e==`string`)return e;if(!Array.isArray(e))return``;let t=[];for(let n of e){if(typeof n!=`object`||!n)continue;let e=n;e.type===`text`&&typeof e.text==`string`?t.push(e.text):e.type===`tool_use`&&typeof e.name==`string`?t.push(`[tool_use: ${e.name}]`):e.type===`tool_result`&&t.push(`[tool_result]`)}return t.join(`
|
|
248
|
+
`)}var De=class{#e;#t;constructor(e={}){this.#e=e.maxTurns??80,this.#t=e.maxChars??6e4}async read(e){let t=(await(0,te.readFile)(e,`utf8`)).split(`
|
|
249
|
+
`).filter(e=>e.length>0),n=[];for(let e of t){let t;try{t=JSON.parse(e)}catch{continue}let r=t.message?.role;if(r!==`user`&&r!==`assistant`)continue;let i=Ee(t.message?.content).trim();i.length!==0&&n.push(`${r}: ${i}`)}let r=n.slice(-this.#e).join(`
|
|
177
250
|
|
|
178
|
-
`);return r.length<=this.#t?r:r.slice(r.length-this.#t)}};function
|
|
251
|
+
`);return r.length<=this.#t?r:r.slice(r.length-this.#t)}};function Oe(e={}){return new De(e)}const U=`00000000-0000-0000-0000-000000000000`,W=`0000000000000000`,G=`global`;function ke(e,t,n=x){let r=t.findById(e)?.projects[0]?.scopeHash??`0000000000000000`;return t.delete(e),n.logEvent({projectHash:r,eventType:`memory.deleted`,memoryId:e}),Promise.resolve()}function Ae(e,t){t.resolveReviewEvents(e)}function je(e){return e>.92?`overwrite`:e>=.75?`flag`:`none`}async function Me(e,t){let{content:n,type:r,tags:i=[],projectScope:a,sourceHarness:o}=ue.parse(e),{repo:s,embedder:l,activityLogger:u=x}=t,d=a?.hash??`0000000000000000`,f=await l.embed(n),[p]=s.findSimilar(f,r,a?.hash);if(p!==void 0){let e=je(p.similarity);if(e===`overwrite`){let e=s.overwrite(p.id,n,f);return u.logEvent({projectHash:d,eventType:`memory.updated`,memoryId:p.id}),e}if(e===`flag`){let e=s.create({id:(0,c.randomUUID)(),content:n,type:r,tags:i,sourceHarness:o??null,embedding:f,projectScope:a});return s.createReviewEvent({memoryId:p.id,conflictingMemoryId:e.id,similarity:p.similarity,conflictContentSnapshot:n}),u.logEvent({projectHash:d,eventType:`memory.created`,memoryId:e.id}),u.logEvent({projectHash:d,eventType:`memory.flagged`,memoryId:p.id,payload:{conflictingMemoryId:e.id,similarity:p.similarity}}),e}}let m=s.create({id:(0,c.randomUUID)(),content:n,type:r,tags:i,sourceHarness:o??null,embedding:f,projectScope:a});return u.logEvent({projectHash:d,eventType:`memory.created`,memoryId:m.id}),m}async function Ne(e,t,n){let{repo:r,embedder:i,activityLogger:a=x}=n,o=j.parse(t),s=o.content===void 0?void 0:await i.embed(o.content),c=r.update(e,o,s),l=c.projects[0]?.scopeHash??`0000000000000000`;return a.logEvent({projectHash:l,eventType:`memory.updated`,memoryId:e}),c}const K=8e3;function Pe(e){return e>=K}var q=class{#e;#t;constructor(e,t){this.#e=e,this.#t=t}findSimilar(e,t,n){let r=Buffer.from(e.buffer),i;return i=n===void 0?this.#e.db.prepare(`SELECT m.rowid, m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS similarity
|
|
179
252
|
FROM memories m JOIN embeddings e ON e.rowid = m.rowid
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
253
|
+
JOIN memory_projects mp ON mp.memory_id = m.id
|
|
254
|
+
JOIN projects p ON p.id = mp.project_id
|
|
255
|
+
WHERE m.type = ? AND p.scope_hash = ?
|
|
256
|
+
ORDER BY similarity DESC LIMIT 1`).get(r,t,W):this.#e.db.prepare(`SELECT m.rowid, m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS similarity
|
|
183
257
|
FROM memories m JOIN embeddings e ON e.rowid = m.rowid
|
|
184
258
|
JOIN memory_projects mp ON mp.memory_id = m.id
|
|
185
259
|
JOIN projects p ON p.id = mp.project_id
|
|
186
260
|
WHERE m.type = ? AND p.scope_hash = ?
|
|
187
|
-
ORDER BY similarity DESC LIMIT 1`).get(r,t,n),i===void 0?[]:[{id:i.id,similarity:i.similarity}]}create(e){let{id:t,content:n,type:r,tags:i,sourceHarness:a,embedding:o,projectScope:s}=e,c=new Date().toISOString(),l=Buffer.from(o.buffer);
|
|
188
|
-
VALUES (?, ?, ?, ?, ?, 0, 0, ?, ?)`).run(t,n,r,JSON.stringify(i),a,c,c),this.#e.db.prepare(`INSERT INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`).run(l,t)
|
|
189
|
-
WHERE id NOT IN (SELECT memory_id FROM memory_projects)
|
|
190
|
-
AND pinned = 1`).all().map(e=>M(e,[]))}listPinnedForProject(e){return this.#e.db.prepare(`SELECT m.* FROM memories m
|
|
261
|
+
ORDER BY similarity DESC LIMIT 1`).get(r,t,n),i===void 0?[]:[{id:i.id,similarity:i.similarity}]}create(e){let{id:t,content:n,type:r,tags:i,sourceHarness:a,embedding:o,projectScope:s}=e,c=new Date().toISOString(),l=Buffer.from(o.buffer);this.#e.db.prepare(`INSERT INTO memories (id, content, type, tags, source, access_count, pinned, created_at, updated_at)
|
|
262
|
+
VALUES (?, ?, ?, ?, ?, 0, 0, ?, ?)`).run(t,n,r,JSON.stringify(i),a,c,c),this.#e.db.prepare(`INSERT INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`).run(l,t);let u=s??{hash:`0000000000000000`,name:`global`},d=this.#t.upsertByHash(u.hash,u.name);return this.#t.addAssociation(t,d.id),F(N.parse(this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(t)),this.#t.getProjectsForMemories([t]).get(t)??[])}overwrite(e,t,n){let r=new Date().toISOString(),i=Buffer.from(n.buffer);this.#e.db.prepare(`UPDATE memories SET content = ?, updated_at = ? WHERE id = ?`).run(t,r,e);let a=this.#e.db.prepare(`SELECT rowid FROM memories WHERE id = ?`).get(e)?.rowid;a!==void 0&&this.#e.db.prepare(`UPDATE embeddings SET embedding = ? WHERE rowid = ?`).run(i,a);let o=N.parse(this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(e)),s=this.#t.getProjectsForMemories([e]),c=this.#r([e]);return F(o,s.get(e)??[],c.get(e)??[])}findById(e){let t=this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(e);if(t===void 0)return;let n=this.#t.getProjectsForMemories([e]),r=this.#r([e]);return F(t,n.get(e)??[],r.get(e)??[])}update(e,t,n){let{content:r,tags:i,type:a}=j.parse(t),o=this.#e.db.prepare(`SELECT m.rowid, m.* FROM memories m WHERE m.id = ?`).get(e);if(o===void 0)throw Error(`Memory not found: ${e}`);let s=new Date().toISOString(),c=[`updated_at = ?`],l=[s];if(r!==void 0&&(c.push(`content = ?`),l.push(r)),i!==void 0&&(c.push(`tags = ?`),l.push(JSON.stringify(i))),a!==void 0&&(c.push(`type = ?`),l.push(a)),l.push(e),this.#e.db.prepare(`UPDATE memories SET ${c.join(`, `)} WHERE id = ?`).run(...l),n!==void 0){let e=Buffer.from(n.buffer);this.#e.db.prepare(`UPDATE embeddings SET embedding = ? WHERE rowid = ?`).run(e,o.rowid)}let u=N.parse(this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(e)),d=this.#t.getProjectsForMemories([e]),f=this.#r([e]);return F(u,d.get(e)??[],f.get(e)??[])}delete(e){let t=this.#e.db.prepare(`SELECT rowid FROM memories WHERE id = ?`).get(e);t!==void 0&&this.#e.db.prepare(`DELETE FROM embeddings WHERE rowid = ?`).run(t.rowid),this.#e.db.prepare(`DELETE FROM memory_projects WHERE memory_id = ?`).run(e),this.#e.db.prepare(`DELETE FROM memories WHERE id = ?`).run(e)}list(e){let t=[],n=[];e?.type!==void 0&&(t.push(`m.type = ?`),n.push(e.type)),e?.pinned===!0&&t.push(`m.pinned = 1`),e?.needsReview===!0&&t.push(`EXISTS (SELECT 1 FROM memory_review_events e WHERE e.memory_id = m.id AND e.resolved_at IS NULL)`),e?.projectId===`global`?(t.push(`EXISTS (SELECT 1 FROM memory_projects mp JOIN projects p ON p.id = mp.project_id WHERE mp.memory_id = m.id AND p.scope_hash = ?)`),n.push(W)):e?.projectId!==void 0&&(t.push(`m.id IN (SELECT memory_id FROM memory_projects WHERE project_id = ?)`),n.push(e.projectId));let r=t.length>0?`WHERE ${t.join(` AND `)}`:``,i=this.#e.db.prepare(`SELECT m.* FROM memories m ${r} ORDER BY m.created_at DESC`).all(...n);if(i.length===0)return[];let a=i.map(e=>e.id),o=this.#t.getProjectsForMemories(a),s=this.#r(a);return i.map(e=>F(e,o.get(e.id)??[],s.get(e.id)??[]))}listPinnedGlobal(){return this.listPinnedForProject(W)}listPinnedForProject(e){return this.#e.db.prepare(`SELECT m.* FROM memories m
|
|
191
263
|
JOIN memory_projects mp ON mp.memory_id = m.id
|
|
192
264
|
JOIN projects p ON p.id = mp.project_id
|
|
193
|
-
WHERE p.scope_hash = ? AND m.pinned = 1`).all(e).map(e=>
|
|
265
|
+
WHERE p.scope_hash = ? AND m.pinned = 1`).all(e).map(e=>F(e,[]))}listFlagged(e){let t;if(t=e===void 0?this.#e.db.prepare(`SELECT * FROM memories
|
|
194
266
|
WHERE EXISTS (
|
|
195
267
|
SELECT 1 FROM memory_review_events e
|
|
196
268
|
WHERE e.memory_id = memories.id AND e.resolved_at IS NULL
|
|
@@ -201,44 +273,41 @@ CREATE INDEX IF NOT EXISTS idx_extraction_runs_status
|
|
|
201
273
|
WHERE e.memory_id = memories.id AND e.resolved_at IS NULL
|
|
202
274
|
)
|
|
203
275
|
AND ${this.#n()}
|
|
204
|
-
ORDER BY created_at DESC`).all(e),t.length===0)return[];let n=t.map(e=>e.id),r=this.#t.getProjectsForMemories(n),i=this.#r(n,{unresolvedOnly:!0});return t.map(e=>
|
|
276
|
+
ORDER BY created_at DESC`).all(e),t.length===0)return[];let n=t.map(e=>e.id),r=this.#t.getProjectsForMemories(n),i=this.#r(n,{unresolvedOnly:!0});return t.map(e=>F(e,r.get(e.id)??[],i.get(e.id)??[]))}listReviewEvents(e,t){let n=t?.unresolvedOnly===!0?`WHERE memory_id = ? AND resolved_at IS NULL`:`WHERE memory_id = ?`;return this.#e.db.prepare(`SELECT * FROM memory_review_events ${n} ORDER BY created_at DESC`).all(e).map(e=>I(O.parse(e)))}createReviewEvent(e){let t=new Date().toISOString();this.#e.db.prepare(`INSERT INTO memory_review_events
|
|
205
277
|
(id, memory_id, conflicting_memory_id, similarity, conflict_content_snapshot, reason, created_at)
|
|
206
|
-
VALUES (?, ?, ?, ?, ?, 'similarity_dedup', ?)`).run((0,
|
|
207
|
-
WHERE pinned = 1 AND ${this.#n()}`).get(e)??{total:0}).total}stats(e){let t=Object.fromEntries(
|
|
278
|
+
VALUES (?, ?, ?, ?, ?, 'similarity_dedup', ?)`).run((0,c.randomUUID)(),e.memoryId,e.conflictingMemoryId,e.similarity,e.conflictContentSnapshot,t)}resolveReviewEvents(e){let t=new Date().toISOString();this.#e.db.prepare(`UPDATE memory_review_events SET resolved_at = ? WHERE memory_id = ? AND resolved_at IS NULL`).run(t,e)}getPinnedCharCount(e){return e===void 0?(this.#e.db.prepare(`SELECT COALESCE(SUM(LENGTH(content)), 0) as total FROM memories WHERE pinned = 1`).get()??{total:0}).total:(this.#e.db.prepare(`SELECT COALESCE(SUM(LENGTH(content)), 0) as total FROM memories
|
|
279
|
+
WHERE pinned = 1 AND ${this.#n()}`).get(e)??{total:0}).total}stats(e){let t=Object.fromEntries(S.map(e=>[e,0]));if(e!==void 0){let n=this.#e.db.prepare(`SELECT type, COUNT(*) as count FROM memories
|
|
208
280
|
WHERE ${this.#n()}
|
|
209
|
-
GROUP BY type`).all(e);for(let e of n){let n=
|
|
281
|
+
GROUP BY type`).all(e);for(let e of n){let n=C.safeParse(e.type);n.success&&(t[n.data]=e.count)}let r=this.#e.db.prepare(`SELECT COUNT(*) as total, SUM(pinned) as pinned,
|
|
210
282
|
COALESCE(SUM(CASE WHEN pinned = 1 THEN LENGTH(content) ELSE 0 END), 0) as pinBudgetChars
|
|
211
283
|
FROM memories WHERE ${this.#n()}`).get(e)??{total:0,pinned:0,pinBudgetChars:0},i=this.#e.db.prepare(`SELECT COUNT(DISTINCT e.memory_id) as needsReview
|
|
212
284
|
FROM memory_review_events e
|
|
213
285
|
JOIN memories m ON m.id = e.memory_id
|
|
214
286
|
WHERE e.resolved_at IS NULL
|
|
215
|
-
AND ${this.#n(`m`)}`).get(e)??{needsReview:0};return{byType:t,total:r.total,pinned:r.pinned??0,needsReview:i.needsReview,pinBudgetChars:r.pinBudgetChars}}let n=this.#e.db.prepare(`SELECT type, COUNT(*) as count FROM memories GROUP BY type`).all();for(let e of n){let n=
|
|
216
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`),n=this.#e.db.prepare(`INSERT OR REPLACE INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`);this.#e.db.transaction(()=>{for(let r of e)t.run(r.id,r.content,r.type,JSON.stringify(r.tags),r.sourceHarness,r.accessCount,+!!r.pinned,r.createdAt,r.updatedAt),r.embedding!==null&&n.run(Buffer.from(r.embedding.buffer,r.embedding.byteOffset,r.embedding.byteLength),r.id)})()}#n(e=`memories`){return`
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
))`}#r(e,t){if(e.length===0)return new Map;let n=e.map(()=>`?`).join(`, `),r=t?.unresolvedOnly===!0?`AND resolved_at IS NULL`:``,i=this.#e.db.prepare(`SELECT * FROM memory_review_events
|
|
287
|
+
AND ${this.#n(`m`)}`).get(e)??{needsReview:0};return{byType:t,total:r.total,pinned:r.pinned??0,needsReview:i.needsReview,pinBudgetChars:r.pinBudgetChars}}let n=this.#e.db.prepare(`SELECT type, COUNT(*) as count FROM memories GROUP BY type`).all();for(let e of n){let n=C.safeParse(e.type);n.success&&(t[n.data]=e.count)}let r=this.#e.db.prepare(`SELECT COUNT(*) as total, SUM(pinned) as pinned FROM memories`).get()??{total:0,pinned:0},i=this.#e.db.prepare(`SELECT COUNT(DISTINCT memory_id) as needsReview FROM memory_review_events WHERE resolved_at IS NULL`).get()??{needsReview:0};return{byType:t,total:r.total,pinned:r.pinned??0,needsReview:i.needsReview,pinBudgetChars:this.getPinnedCharCount()}}setPin(e,t){if(this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(e)===void 0)throw Error(`Memory not found: ${e}`);let n=new Date().toISOString();this.#e.db.prepare(`UPDATE memories SET pinned = ?, updated_at = ? WHERE id = ?`).run(+!!t,n,e);let r=N.parse(this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(e)),i=this.#t.getProjectsForMemories([e]),a=this.#r([e]);return F(r,i.get(e)??[],a.get(e)??[])}incrementAccessCount(e){this.#e.db.prepare(`UPDATE memories SET access_count = access_count + 1 WHERE id = ?`).run(e)}exportAll(){return this.#e.db.prepare(`SELECT m.*, e.embedding FROM memories m LEFT JOIN embeddings e ON e.rowid = m.rowid ORDER BY m.created_at DESC`).all().map(e=>({id:e.id,content:e.content,type:C.parse(e.type),tags:w.parse(JSON.parse(e.tags)),sourceHarness:e.source,accessCount:e.access_count,pinned:e.pinned!==0,createdAt:e.created_at,updatedAt:e.updated_at,embedding:e.embedding===null?null:new Float32Array(e.embedding.buffer,e.embedding.byteOffset,e.embedding.byteLength/4)}))}importAll(e){let t=this.#e.db.prepare(`INSERT OR REPLACE INTO memories (id, content, type, tags, source, access_count, pinned, created_at, updated_at)
|
|
288
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`),n=this.#e.db.prepare(`INSERT OR REPLACE INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`);this.#e.db.transaction(()=>{for(let r of e)t.run(r.id,r.content,r.type,JSON.stringify(r.tags),r.sourceHarness,r.accessCount,+!!r.pinned,r.createdAt,r.updatedAt),r.embedding!==null&&n.run(Buffer.from(r.embedding.buffer,r.embedding.byteOffset,r.embedding.byteLength),r.id)})()}#n(e=`memories`){return`EXISTS (
|
|
289
|
+
SELECT 1 FROM memory_projects mp JOIN projects p ON p.id = mp.project_id
|
|
290
|
+
WHERE mp.memory_id = ${e}.id AND (p.scope_hash = ? OR p.scope_hash = '${W}')
|
|
291
|
+
)`}#r(e,t){if(e.length===0)return new Map;let n=e.map(()=>`?`).join(`, `),r=t?.unresolvedOnly===!0?`AND resolved_at IS NULL`:``,i=this.#e.db.prepare(`SELECT * FROM memory_review_events
|
|
221
292
|
WHERE memory_id IN (${n}) ${r}
|
|
222
|
-
ORDER BY created_at DESC`).all(...e),a=new Map;for(let e of i){let t=
|
|
293
|
+
ORDER BY created_at DESC`).all(...e),a=new Map;for(let e of i){let t=I(O.parse(e)),n=a.get(t.memoryId)??[];n.push(t),a.set(t.memoryId,n)}return a}};function Fe(e,t){return new q(e,t)}const J=(0,re.promisify)(ne.execFile);function Y(e){return(0,c.createHash)(`sha256`).update(e).digest(`hex`).slice(0,16)}async function X(){try{let{stdout:e}=await J(`git`,[`remote`,`get-url`,`origin`]),t=e.trim();if(t){let e=Y(t);return{hash:e,name:t.split(`/`).pop()?.replace(/\.git$/,``)??e.slice(0,8)}}}catch{}let e=process.cwd(),t=Y(e);return{hash:t,name:e.split(/[/\\]/).filter(Boolean).pop()??t.slice(0,8)}}async function Ie(){try{let{stdout:e}=await J(`git`,[`remote`,`get-url`,`origin`]),t=e.trim();if(t)return Y(t)}catch{}return Y(process.cwd())}const Le=[{name:`scope-to-projects`,description:`Rename the auto-migrated project for the current directory from its generic hash-derived name to the resolved repo/directory name.`}];async function Re(e){let t=await X(),n=e.getByHash(t.hash);if(n===void 0)return null;let r=n.name,i=e.countMemories(n.id);return e.rename(n.id,t.name),{migration:`scope-to-projects`,oldName:r,newName:t.name,memoryCount:i}}var ze=class{#e;constructor(e){this.#e=e}upsertByHash(e,t){if(!/^[0-9a-f]{16}$/.test(e))throw Error(`Invalid scope hash "${e}": expected 16 lowercase hex characters`);let n=new Date().toISOString(),r=e===`0000000000000000`?U:(0,c.randomUUID)(),i=e===`0000000000000000`?G:t;return this.#e.db.prepare(`INSERT OR IGNORE INTO projects (id, name, scope_hash, created_at, updated_at) VALUES (?, ?, ?, ?, ?)`).run(r,i,e,n,n),L(P.parse(this.#e.db.prepare(`SELECT * FROM projects WHERE scope_hash = ?`).get(e)))}rename(e,t){let n=new Date().toISOString();this.#e.db.prepare(`UPDATE projects SET name = ?, updated_at = ? WHERE id = ?`).run(t,n,e);let r=this.#e.db.prepare(`SELECT * FROM projects WHERE id = ?`).get(e);if(r===void 0)throw Error(`Project not found: ${e}`);return L(r)}list(){return this.#e.db.prepare(`SELECT * FROM projects ORDER BY name ASC`).all().map(L)}getByHash(e){let t=this.#e.db.prepare(`SELECT * FROM projects WHERE scope_hash = ?`).get(e);return t===void 0?void 0:L(t)}getByName(e){let t=this.#e.db.prepare(`SELECT * FROM projects WHERE name = ? LIMIT 1`).get(e);return t===void 0?void 0:L(t)}addAssociation(e,t){this.#e.db.prepare(`INSERT OR IGNORE INTO memory_projects (memory_id, project_id) VALUES (?, ?)`).run(e,t)}removeAssociation(e,t){this.#e.db.prepare(`DELETE FROM memory_projects WHERE memory_id = ? AND project_id = ?`).run(e,t)}countMemories(e){return this.#e.db.prepare(`SELECT COUNT(*) AS count FROM memory_projects WHERE project_id = ?`).get(e)?.count??0}getProjectsForMemories(e){if(e.length===0)return new Map;let t=e.map(()=>`?`).join(`,`),n=this.#e.db.prepare(`SELECT p.*, mp.memory_id FROM projects p
|
|
223
294
|
JOIN memory_projects mp ON mp.project_id = p.id
|
|
224
|
-
WHERE mp.memory_id IN (${t})`).all(...e),r=new Map;for(let e of n){let t=r.get(e.memory_id)??[];t.push(
|
|
295
|
+
WHERE mp.memory_id IN (${t})`).all(...e),r=new Map;for(let e of n){let t=r.get(e.memory_id)??[];t.push(L(e)),r.set(e.memory_id,t)}return r}};function Be(e){return new ze(e)}const Ve={correction:1,preference:.8,decision:.6,learning:.4,fact:.2};function He(e,t,n){let r=Ve[e.type],i=e.accessCount/(e.accessCount+10),a=1/(1+(n-new Date(e.updatedAt).getTime())/864e5),o=+!!e.pinned;return t*.4+r*.25+i*.2+a*.1+o*.05}async function Z(e,t){let{query:n,type:r,projectHash:i,limit:a=10,includePinned:o}=A.parse(e),{activityLogger:s=x}=t,c=await t.embedder.embed(n),l=Buffer.from(c.buffer),u=t.adapter.findByEmbedding(l,{type:r,projectHash:i,includePinned:o}),d=Date.now(),f=u.filter(e=>e.cosineSim>0).map(e=>{let{cosineSim:t,...n}=e;return{...n,score:He(n,t,d)}});f.sort((e,t)=>t.score-e.score);let p=f.slice(0,a);for(let e of p)t.repo.incrementAccessCount(e.id);return s.logEvent({projectHash:i??`0000000000000000`,eventType:`memory.queried`,payload:{resultCount:p.length,topScores:p.slice(0,3).map(e=>e.score)}}),p}var Ue=class{#e;constructor(e){this.#e=e}findByEmbedding(e,t){let{type:n,projectHash:r,includePinned:i}=t,a=[],o=[e],s=``;i||a.push(`m.pinned = 0`),n!==void 0&&(a.push(`m.type = ?`),o.push(n)),r!==void 0&&(s=`JOIN memory_projects mp ON mp.memory_id = m.id JOIN projects p ON p.id = mp.project_id`,a.push(`(p.scope_hash = ? OR p.scope_hash = ?)`),o.push(r,W));let c=a.length>0?`WHERE ${a.join(` AND `)}`:``,l=`
|
|
225
296
|
SELECT m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS cosine_sim
|
|
226
297
|
FROM memories m JOIN embeddings e ON e.rowid = m.rowid
|
|
227
298
|
${s}
|
|
228
299
|
${c}
|
|
229
|
-
`;return this.#e.db.prepare(l).all(...o).map(e=>({...
|
|
300
|
+
`;return this.#e.db.prepare(l).all(...o).map(e=>({...F(e,[]),cosineSim:e.cosine_sim}))}},We=class{#e;#t;#n;#r;constructor(e,t,n,r=x){this.#e=e,this.#t=t,this.#n=n,this.#r=r}async query(e){return Z(e,{adapter:new Ue(this.#e),repo:this.#n,embedder:this.#t,activityLogger:this.#r})}};function Q(e,t){let n=t.repo.stats(e.projectHash);return e.synthesis!==void 0&&e.synthesis.length>0?{stats:n.byType,pinnedGlobal:[],pinnedProject:[],synthesis:e.synthesis}:{stats:n.byType,pinnedGlobal:t.repo.listPinnedGlobal(),pinnedProject:t.repo.listPinnedForProject(e.projectHash)}}function Ge(){return[...S]}var Ke=class{#e;constructor(e){this.#e=e}getSessionContext(e,t){return Q({projectHash:e,synthesis:t},{repo:this.#e})}},qe=class{#e;#t;#n;#r=new Set;#i=new Map;#a=!1;#o;#s=new Map;constructor(e,t,n){this.#e=e,this.#t=t,this.#n=n}async init(){this.#e.clearStaleInFlight(this.#t.inFlightTimeoutMs??12e4),this.#e.expireStale();let e=this.#e.getExpiredOrDirtyScopes();for(let{scope:t}of e)this.#r.add(t);this.#a=!0,await this.#l()}shutdown(){this.#a=!1,this.#o!==void 0&&(clearTimeout(this.#o),this.#o=void 0);let e=[...this.#s.values()];return e.length===0?Promise.resolve():Promise.race([Promise.allSettled(e).then(()=>void 0),new Promise(e=>setTimeout(e,5e3))])}markDirty(e){this.#r.add(e)}#c(){if(!this.#a)return;let e=this.#t.debounceMs??45e3;this.#o=setTimeout(()=>{this.#l()},e)}async#l(){let e=[...this.#r];for(let t of e){let e=this.#t.inFlightTimeoutMs??12e4,n=this.#e.getSynthesis(t);if(n?.inFlightSince!==null&&n?.inFlightSince!==void 0){if(Date.now()-new Date(n.inFlightSince).getTime()<e)continue;this.#e.clearInFlight(t)}this.#r.delete(t);let r=this.#u(t).finally(()=>{this.#s.delete(t)});this.#s.set(t,r)}this.#c()}async#u(e){this.#e.markInFlight(e);try{let t=e===`0000000000000000`?void 0:e,n=await this.#n.run(e,t),r=this.#e.computeSourceMemoryHash(e);this.#e.saveSynthesis(e,n,r),this.#i.delete(e)}catch(t){let n=(this.#i.get(e)??0)+1;this.#i.set(e,n);let r=Math.min(n,5),i=(this.#t.debounceMs??45e3)*r;process.stderr.write(`membank synthesis: error for scope=${e} failures=${n} backoff=${i}ms: ${t instanceof Error?t.message:String(t)}\n`),setTimeout(()=>{this.#r.add(e)},i),this.#e.clearInFlight(e)}}};async function Je(e,t){let n=e===`0000000000000000`?void 0:e;t.synthRepo.markInFlight(e);try{let[r,i]=await Promise.all([t.agentRunner.run(e,n),Promise.resolve(t.synthRepo.computeSourceMemoryHash(e))]);return t.synthRepo.saveSynthesis(e,r,i),r}catch(n){throw t.synthRepo.clearInFlight(e),n}}var Ye=class{#e;constructor(e,t){this.#e=e}async run(e,t){let n=(0,g.createSdkMcpServer)({name:`membank-synthesis-tools`,version:`1.0.0`,tools:[(0,g.tool)(`query_memory`,`Search memories by semantic similarity`,{query:l.z.string().describe(`Search text`),limit:l.z.number().optional().describe(`Maximum results to return`),global:l.z.boolean().optional().describe(`Query global memories only when true, otherwise current project scope`)},async({query:e,limit:n,global:r})=>({content:[{type:`text`,text:await this.#e.queryMemory({query:e,limit:n,global:r,projectHash:t})}]}),{annotations:{readOnlyHint:!0}}),(0,g.tool)(`get_memory_summary`,`Returns aggregate stats: total memories, counts by type, pinned count, review queue size`,{},async()=>({content:[{type:`text`,text:await this.#e.getMemorySummary()}]}),{annotations:{readOnlyHint:!0}})]}),r=`Synthesize the memories for ${e===`0000000000000000`?`global (across all projects)`:`project scope: ${e}`}. Use get_memory_summary first to understand the overall state, then use query_memory to retrieve relevant memories (query with broad terms like "preferences", "corrections", "decisions", "key facts"). After gathering information, produce a concise synthesis of the most important things to remember about this user. Output only the synthesis text — no preamble, no metadata.`,i=Date.now(),a=Object.fromEntries(Object.entries(process.env).filter(e=>e[1]!==void 0)),o=(0,g.query)({prompt:r,options:{model:`claude-haiku-4-5-20251001`,systemPrompt:`You are a memory synthesizer. Your job is to read the user's stored memories and produce a concise, well-structured summary of what's most important to remember about this user — their preferences, corrections, decisions, and key facts. Pinned memories are higher fidelity and should be weighted more heavily. Exclude transient or ephemeral details. Output plain text suitable for injection into an LLM context window. Be concise — target 200-400 words.`,mcpServers:{"membank-synthesis-tools":n},allowedTools:[`mcp__membank-synthesis-tools__query_memory`,`mcp__membank-synthesis-tools__get_memory_summary`],disallowedTools:[`mcp__membank__*`],settingSources:[],permissionMode:`bypassPermissions`,env:a}}),s=``;for await(let e of o)if(e.type===`result`)if(e.subtype===`success`)s=e.result;else{let t=`errors`in e&&Array.isArray(e.errors)?`: ${e.errors.join(`; `)}`:``;throw Error(`Synthesis agent failed: ${e.subtype}${t}`)}let c=Date.now()-i;if(process.stderr.write(`membank synthesis: scope=${e} duration=${c}ms\n`),s===``)throw Error(`Synthesis agent returned empty result`);return s}};function Xe(e,t){return new Ye(e,t)}function $(e){return M.parse({id:e.id,scope:e.scope,content:e.content,sourceMemoryHash:e.source_memory_hash,synthesizedAt:e.synthesized_at,expiresAt:e.expires_at,inFlightSince:e.in_flight_since,createdAt:e.created_at,updatedAt:e.updated_at})}var Ze=class{#e;constructor(e){this.#e=e}saveSynthesis(e,t,n){let r=new Date().toISOString(),i=new Date(Date.now()+720*60*60*1e3).toISOString();if(this.#e.db.prepare(`SELECT id FROM syntheses WHERE scope = ?`).get(e)!==void 0)this.#e.db.prepare(`UPDATE syntheses
|
|
230
301
|
SET content = ?, source_memory_hash = ?, synthesized_at = ?, expires_at = ?,
|
|
231
302
|
in_flight_since = NULL, updated_at = ?
|
|
232
|
-
WHERE scope = ?`).run(t,n,r,i,r,e);else{let a=(0,
|
|
303
|
+
WHERE scope = ?`).run(t,n,r,i,r,e);else{let a=(0,c.randomUUID)();this.#e.db.prepare(`INSERT INTO syntheses
|
|
233
304
|
(id, scope, content, source_memory_hash, synthesized_at, expires_at,
|
|
234
305
|
in_flight_since, created_at, updated_at)
|
|
235
|
-
VALUES (?, ?, ?, ?, ?, ?, NULL, ?, ?)`).run(a,e,t,n,r,i,r,r)}let a=this.#e.db.prepare(`SELECT * FROM syntheses WHERE scope = ?`).get(e);if(a===void 0)throw Error(`Failed to save synthesis for scope: ${e}`);return $(a)}getSynthesis(e){let t=this.#e.db.prepare(`SELECT * FROM syntheses WHERE scope = ?`).get(e);return t===void 0?void 0:$(t)}listAll(){return this.#e.db.prepare(`SELECT * FROM syntheses ORDER BY scope`).all().map($)}markInFlight(e){let t=new Date().toISOString();if(this.#e.db.prepare(`SELECT id FROM syntheses WHERE scope = ?`).get(e)!==void 0)this.#e.db.prepare(`UPDATE syntheses SET in_flight_since = ?, updated_at = ? WHERE scope = ?`).run(t,t,e);else{let n=(0,
|
|
306
|
+
VALUES (?, ?, ?, ?, ?, ?, NULL, ?, ?)`).run(a,e,t,n,r,i,r,r)}let a=this.#e.db.prepare(`SELECT * FROM syntheses WHERE scope = ?`).get(e);if(a===void 0)throw Error(`Failed to save synthesis for scope: ${e}`);return $(a)}getSynthesis(e){let t=this.#e.db.prepare(`SELECT * FROM syntheses WHERE scope = ?`).get(e);return t===void 0?void 0:$(t)}listAll(){return this.#e.db.prepare(`SELECT * FROM syntheses ORDER BY scope`).all().map($)}markInFlight(e){let t=new Date().toISOString();if(this.#e.db.prepare(`SELECT id FROM syntheses WHERE scope = ?`).get(e)!==void 0)this.#e.db.prepare(`UPDATE syntheses SET in_flight_since = ?, updated_at = ? WHERE scope = ?`).run(t,t,e);else{let n=(0,c.randomUUID)(),r=new Date(Date.now()+720*60*60*1e3).toISOString();this.#e.db.prepare(`INSERT INTO syntheses
|
|
236
307
|
(id, scope, content, source_memory_hash, synthesized_at, expires_at,
|
|
237
308
|
in_flight_since, created_at, updated_at)
|
|
238
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(n,e,`pending`,``,t,r,t,t,t)}}clearInFlight(e){let t=new Date().toISOString();this.#e.db.prepare(`UPDATE syntheses SET in_flight_since = NULL, updated_at = ? WHERE scope = ?`).run(t,e)}clearStaleInFlight(e){let t=new Date(Date.now()-e).toISOString(),n=new Date().toISOString();this.#e.db.prepare(`UPDATE syntheses SET in_flight_since = NULL, updated_at = ? WHERE in_flight_since IS NOT NULL AND in_flight_since < ?`).run(n,t)}computeSourceMemoryHash(e){let t
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
WHERE p.scope_hash = ?
|
|
244
|
-
ORDER BY m.id`).all(e),(0,g.createHash)(`sha256`).update(JSON.stringify(t.map(e=>e.content))).digest(`hex`)}getExpiredOrDirtyScopes(){let e=this.getAllActiveScopes(),t=new Date().toISOString(),n=[];for(let r of e){let e=this.#e.db.prepare(`SELECT * FROM syntheses WHERE scope = ?`).get(r);if(e===void 0||e.content===`pending`&&e.source_memory_hash===``){n.push({scope:r,reason:`missing`});continue}if(e.expires_at<=t){n.push({scope:r,reason:`expired`});continue}this.computeSourceMemoryHash(r)!==e.source_memory_hash&&n.push({scope:r,reason:`dirty`})}return n}getAllActiveScopes(){return[`global`,...this.#e.db.prepare(`SELECT DISTINCT scope_hash FROM projects`).all().map(e=>e.scope_hash)]}expireStale(){let e=new Date().toISOString();this.#e.db.prepare(`DELETE FROM syntheses WHERE expires_at < ?`).run(e)}};function Be(e){return new ze(e)}exports.DatabaseError=I,exports.DatabaseManager=ce,exports.EmbeddingService=V,exports.MEMORY_TYPE_VALUES=v,exports.MIGRATIONS=Ee,exports.MODEL_NAME=L,exports.MembankError=F,exports.MemoryPatchSchema=O,exports.MemoryRowSchema=A,exports.MemorySchema=T,exports.MemoryTypeSchema=y,exports.ModelDownloadError=R,exports.ModelDownloader=B,exports.PIN_BUDGET_THRESHOLD=G,exports.ProjectRowSchema=j,exports.ProjectSchema=x,exports.QueryEngine=Me,exports.QueryOptionsSchema=E,exports.ReviewEventRowSchema=w,exports.ReviewEventSchema=C,exports.ReviewReasonSchema=S,exports.SaveOptionsSchema=D,exports.SessionContextBuilder=Pe,exports.SessionContextSchema=ae,exports.SqliteMemoryRepository=K,exports.SynthesisEngine=Fe,exports.SynthesisSchema=k,exports.TagsJsonSchema=b,exports.createClaudeCodeTranscriptReader=_e,exports.createExtractionAgentRunner=ue,exports.createExtractionRunRepository=me,exports.createMemoryRepository=we,exports.createProjectRepository=ke,exports.createSynthesisAgentRunner=Re,exports.createSynthesisRepository=Be,exports.deleteMemory=ve,exports.getSessionContext=Q,exports.isOverBudget=Ce,exports.isSynthesisEnabled=ie,exports.listMemoryTypes=Ne,exports.queryMemories=Z,exports.resolveProject=Y,exports.resolveReview=ye,exports.resolveScope=Te,exports.rowToMemory=M,exports.rowToProject=P,exports.runExtraction=H,exports.runScopeToProjectsMigration=De,exports.runSynthesis=Ie,exports.saveMemory=xe,exports.updateMemory=Se;
|
|
309
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(n,e,`pending`,``,t,r,t,t,t)}}clearInFlight(e){let t=new Date().toISOString();this.#e.db.prepare(`UPDATE syntheses SET in_flight_since = NULL, updated_at = ? WHERE scope = ?`).run(t,e)}clearStaleInFlight(e){let t=new Date(Date.now()-e).toISOString(),n=new Date().toISOString();this.#e.db.prepare(`UPDATE syntheses SET in_flight_since = NULL, updated_at = ? WHERE in_flight_since IS NOT NULL AND in_flight_since < ?`).run(n,t)}computeSourceMemoryHash(e){let t=this.#e.db.prepare(`SELECT m.content FROM memories m
|
|
310
|
+
JOIN memory_projects mp ON mp.memory_id = m.id
|
|
311
|
+
JOIN projects p ON p.id = mp.project_id
|
|
312
|
+
WHERE p.scope_hash = ?
|
|
313
|
+
ORDER BY m.id`).all(e);return(0,c.createHash)(`sha256`).update(JSON.stringify(t.map(e=>e.content))).digest(`hex`)}getExpiredOrDirtyScopes(){let e=this.getAllActiveScopes(),t=new Date().toISOString(),n=[];for(let r of e){let e=this.#e.db.prepare(`SELECT * FROM syntheses WHERE scope = ?`).get(r);if(e===void 0||e.content===`pending`&&e.source_memory_hash===``){n.push({scope:r,reason:`missing`});continue}if(e.expires_at<=t){n.push({scope:r,reason:`expired`});continue}this.computeSourceMemoryHash(r)!==e.source_memory_hash&&n.push({scope:r,reason:`dirty`})}return n}getAllActiveScopes(){return this.#e.db.prepare(`SELECT DISTINCT scope_hash FROM projects`).all().map(e=>e.scope_hash)}expireStale(){let e=new Date().toISOString();this.#e.db.prepare(`DELETE FROM syntheses WHERE expires_at < ?`).run(e)}};function Qe(e){return new Ze(e)}exports.ACTIVITY_EVENT_TYPE_VALUES=_,exports.ActivityEventTypeSchema=v,exports.DatabaseError=z,exports.DatabaseManager=me,exports.EmbeddingService=_e,exports.GLOBAL_PROJECT_ID=U,exports.GLOBAL_PROJECT_NAME=G,exports.GLOBAL_SCOPE_HASH=W,exports.MEMORY_TYPE_VALUES=S,exports.MIGRATIONS=Le,exports.MODEL_NAME=B,exports.MembankError=R,exports.MemoryPatchSchema=j,exports.MemoryRowSchema=N,exports.MemorySchema=k,exports.MemoryTypeSchema=C,exports.ModelDownloadError=V,exports.ModelDownloader=ge,exports.PIN_BUDGET_THRESHOLD=K,exports.ProjectRowSchema=P,exports.ProjectSchema=T,exports.QueryEngine=We,exports.QueryOptionsSchema=A,exports.RETENTION_DAYS=30,exports.ReviewEventRowSchema=O,exports.ReviewEventSchema=D,exports.ReviewReasonSchema=E,exports.SaveOptionsSchema=ue,exports.SessionContextBuilder=Ke,exports.SessionContextSchema=de,exports.SqliteMemoryRepository=q,exports.SynthesisEngine=qe,exports.SynthesisSchema=M,exports.TagsJsonSchema=w,exports.createActivityLogger=se,exports.createActivityRepository=oe,exports.createClaudeCodeTranscriptReader=Oe,exports.createExtractionAgentRunner=xe,exports.createExtractionRunRepository=Te,exports.createMemoryRepository=Fe,exports.createProjectRepository=Be,exports.createSynthesisAgentRunner=Xe,exports.createSynthesisRepository=Qe,exports.deleteMemory=ke,exports.getSessionContext=Q,exports.isOverBudget=Pe,exports.isSynthesisEnabled=le,exports.listEvents=ie,exports.listMemoryTypes=Ge,exports.logEvent=y,exports.noopActivityLogger=x,exports.queryMemories=Z,exports.resolveProject=X,exports.resolveReview=Ae,exports.resolveScope=Ie,exports.rowToMemory=F,exports.rowToProject=L,exports.runExtraction=ve,exports.runScopeToProjectsMigration=Re,exports.runSynthesis=Je,exports.saveMemory=Me,exports.updateMemory=Ne;
|
package/dist/index.d.cts
CHANGED
|
@@ -2,6 +2,103 @@ import { z } from "zod";
|
|
|
2
2
|
import BetterSqlite3 from "better-sqlite3";
|
|
3
3
|
import { EventEmitter } from "node:events";
|
|
4
4
|
|
|
5
|
+
//#region src/activity/domain/activity-event.d.ts
|
|
6
|
+
declare const ACTIVITY_EVENT_TYPE_VALUES: readonly ["memory.created", "memory.updated", "memory.deleted", "memory.flagged", "memory.queried"];
|
|
7
|
+
declare const ActivityEventTypeSchema: z.ZodEnum<{
|
|
8
|
+
"memory.created": "memory.created";
|
|
9
|
+
"memory.updated": "memory.updated";
|
|
10
|
+
"memory.deleted": "memory.deleted";
|
|
11
|
+
"memory.flagged": "memory.flagged";
|
|
12
|
+
"memory.queried": "memory.queried";
|
|
13
|
+
}>;
|
|
14
|
+
type ActivityEventType = z.infer<typeof ActivityEventTypeSchema>;
|
|
15
|
+
declare const RETENTION_DAYS = 30;
|
|
16
|
+
interface ActivityEvent {
|
|
17
|
+
id: string;
|
|
18
|
+
projectHash: string;
|
|
19
|
+
eventType: ActivityEventType;
|
|
20
|
+
memoryId: string | null;
|
|
21
|
+
payload: Record<string, unknown>;
|
|
22
|
+
createdAt: string;
|
|
23
|
+
}
|
|
24
|
+
interface ActivityEventInput {
|
|
25
|
+
projectHash: string;
|
|
26
|
+
eventType: ActivityEventType;
|
|
27
|
+
memoryId?: string;
|
|
28
|
+
payload?: Record<string, unknown>;
|
|
29
|
+
}
|
|
30
|
+
//#endregion
|
|
31
|
+
//#region src/activity/ports.d.ts
|
|
32
|
+
interface ActivityRepository {
|
|
33
|
+
insert(event: {
|
|
34
|
+
id: string;
|
|
35
|
+
projectHash: string;
|
|
36
|
+
eventType: ActivityEventType;
|
|
37
|
+
memoryId: string | null;
|
|
38
|
+
payload: Record<string, unknown>;
|
|
39
|
+
createdAt: string;
|
|
40
|
+
}): void;
|
|
41
|
+
list(filter: {
|
|
42
|
+
scope?: string;
|
|
43
|
+
type?: ActivityEventType;
|
|
44
|
+
since?: string;
|
|
45
|
+
limit?: number;
|
|
46
|
+
}): ActivityEvent[];
|
|
47
|
+
prune(olderThan: string): void;
|
|
48
|
+
}
|
|
49
|
+
interface ActivityLogger {
|
|
50
|
+
logEvent(input: ActivityEventInput): void;
|
|
51
|
+
}
|
|
52
|
+
declare const noopActivityLogger: ActivityLogger;
|
|
53
|
+
//#endregion
|
|
54
|
+
//#region src/activity/application/list-events.d.ts
|
|
55
|
+
interface ListEventsFilter {
|
|
56
|
+
scope?: string;
|
|
57
|
+
type?: ActivityEventType;
|
|
58
|
+
since?: string;
|
|
59
|
+
limit?: number;
|
|
60
|
+
}
|
|
61
|
+
declare function listEvents(filter: ListEventsFilter, repo: ActivityRepository): ActivityEvent[];
|
|
62
|
+
//#endregion
|
|
63
|
+
//#region src/activity/application/log-event.d.ts
|
|
64
|
+
declare function logEvent(input: ActivityEventInput, repo: ActivityRepository): void;
|
|
65
|
+
//#endregion
|
|
66
|
+
//#region src/db/manager.d.ts
|
|
67
|
+
type VecLoader = (db: BetterSqlite3.Database) => void;
|
|
68
|
+
declare class DatabaseManager {
|
|
69
|
+
#private;
|
|
70
|
+
private constructor();
|
|
71
|
+
static open(dbPath?: string): DatabaseManager;
|
|
72
|
+
static openInMemory(): DatabaseManager;
|
|
73
|
+
/** For testing: inject a custom vec loader (e.g. a throwing stub). */
|
|
74
|
+
static _openInMemoryWithLoader(loader: VecLoader): DatabaseManager;
|
|
75
|
+
get db(): BetterSqlite3.Database;
|
|
76
|
+
close(): void;
|
|
77
|
+
}
|
|
78
|
+
//#endregion
|
|
79
|
+
//#region src/activity/infrastructure/sqlite-activity-repository.d.ts
|
|
80
|
+
declare class SqliteActivityRepository implements ActivityRepository {
|
|
81
|
+
#private;
|
|
82
|
+
constructor(db: DatabaseManager);
|
|
83
|
+
insert(event: {
|
|
84
|
+
id: string;
|
|
85
|
+
projectHash: string;
|
|
86
|
+
eventType: string;
|
|
87
|
+
memoryId: string | null;
|
|
88
|
+
payload: Record<string, unknown>;
|
|
89
|
+
createdAt: string;
|
|
90
|
+
}): void;
|
|
91
|
+
list(filter: {
|
|
92
|
+
scope?: string;
|
|
93
|
+
type?: string;
|
|
94
|
+
since?: string;
|
|
95
|
+
limit?: number;
|
|
96
|
+
}): ActivityEvent[];
|
|
97
|
+
prune(olderThan: string): void;
|
|
98
|
+
}
|
|
99
|
+
declare function createActivityRepository(db: DatabaseManager): SqliteActivityRepository;
|
|
100
|
+
declare function createActivityLogger(db: DatabaseManager): ActivityLogger;
|
|
101
|
+
//#endregion
|
|
5
102
|
//#region src/config/loader.d.ts
|
|
6
103
|
declare function isSynthesisEnabled(): boolean;
|
|
7
104
|
//#endregion
|
|
@@ -262,19 +359,6 @@ declare class DatabaseError extends MembankError {
|
|
|
262
359
|
constructor(message: string, options?: ErrorOptions);
|
|
263
360
|
}
|
|
264
361
|
//#endregion
|
|
265
|
-
//#region src/db/manager.d.ts
|
|
266
|
-
type VecLoader = (db: BetterSqlite3.Database) => void;
|
|
267
|
-
declare class DatabaseManager {
|
|
268
|
-
#private;
|
|
269
|
-
private constructor();
|
|
270
|
-
static open(dbPath?: string): DatabaseManager;
|
|
271
|
-
static openInMemory(): DatabaseManager;
|
|
272
|
-
/** For testing: inject a custom vec loader (e.g. a throwing stub). */
|
|
273
|
-
static _openInMemoryWithLoader(loader: VecLoader): DatabaseManager;
|
|
274
|
-
get db(): BetterSqlite3.Database;
|
|
275
|
-
close(): void;
|
|
276
|
-
}
|
|
277
|
-
//#endregion
|
|
278
362
|
//#region src/embedding/infrastructure/model-downloader.d.ts
|
|
279
363
|
declare const MODEL_NAME = "Xenova/bge-small-en-v1.5";
|
|
280
364
|
interface DownloadProgress {
|
|
@@ -476,7 +560,7 @@ interface TranscriptReaderOptions {
|
|
|
476
560
|
declare function createClaudeCodeTranscriptReader(opts?: TranscriptReaderOptions): TranscriptReader;
|
|
477
561
|
//#endregion
|
|
478
562
|
//#region src/memory/application/delete-memory.d.ts
|
|
479
|
-
declare function deleteMemory(id: string, repo: MemoryRepository): Promise<void>;
|
|
563
|
+
declare function deleteMemory(id: string, repo: MemoryRepository, activityLogger?: ActivityLogger): Promise<void>;
|
|
480
564
|
//#endregion
|
|
481
565
|
//#region src/memory/application/resolve-review.d.ts
|
|
482
566
|
declare function resolveReview(memoryId: string, repo: MemoryRepository): void;
|
|
@@ -485,12 +569,14 @@ declare function resolveReview(memoryId: string, repo: MemoryRepository): void;
|
|
|
485
569
|
declare function saveMemory(opts: SaveOptions, deps: {
|
|
486
570
|
repo: MemoryRepository;
|
|
487
571
|
embedder: Embedder;
|
|
572
|
+
activityLogger?: ActivityLogger;
|
|
488
573
|
}): Promise<Memory>;
|
|
489
574
|
//#endregion
|
|
490
575
|
//#region src/memory/application/update-memory.d.ts
|
|
491
576
|
declare function updateMemory(id: string, patch: MemoryPatch, deps: {
|
|
492
577
|
repo: MemoryRepository;
|
|
493
578
|
embedder: Embedder;
|
|
579
|
+
activityLogger?: ActivityLogger;
|
|
494
580
|
}): Promise<Memory>;
|
|
495
581
|
//#endregion
|
|
496
582
|
//#region src/memory/domain/pin-budget.d.ts
|
|
@@ -543,6 +629,11 @@ declare class SqliteMemoryRepository implements MemoryRepository {
|
|
|
543
629
|
}
|
|
544
630
|
declare function createMemoryRepository(db: DatabaseManager, projects: ProjectRepository): MemoryRepository;
|
|
545
631
|
//#endregion
|
|
632
|
+
//#region src/project/domain/global-scope.d.ts
|
|
633
|
+
declare const GLOBAL_PROJECT_ID: "00000000-0000-0000-0000-000000000000";
|
|
634
|
+
declare const GLOBAL_SCOPE_HASH: "0000000000000000";
|
|
635
|
+
declare const GLOBAL_PROJECT_NAME: "global";
|
|
636
|
+
//#endregion
|
|
546
637
|
//#region src/project/infrastructure/sqlite-project-repository.d.ts
|
|
547
638
|
declare function createProjectRepository(db: DatabaseManager): ProjectRepository;
|
|
548
639
|
//#endregion
|
|
@@ -582,12 +673,13 @@ declare function queryMemories(options: QueryOptions, deps: {
|
|
|
582
673
|
adapter: QueryAdapter;
|
|
583
674
|
repo: Pick<MemoryRepository, "incrementAccessCount">;
|
|
584
675
|
embedder: Embedder;
|
|
676
|
+
activityLogger?: ActivityLogger;
|
|
585
677
|
}): Promise<ScoredMemory[]>;
|
|
586
678
|
//#endregion
|
|
587
679
|
//#region src/query/engine.d.ts
|
|
588
680
|
declare class QueryEngine implements Querier {
|
|
589
681
|
#private;
|
|
590
|
-
constructor(db: DatabaseManager, embeddingService: Embedder, repo: MemoryRepository);
|
|
682
|
+
constructor(db: DatabaseManager, embeddingService: Embedder, repo: MemoryRepository, activityLogger?: ActivityLogger);
|
|
591
683
|
query(options: QueryOptions): Promise<ScoredMemory[]>;
|
|
592
684
|
}
|
|
593
685
|
//#endregion
|
|
@@ -675,5 +767,5 @@ declare function createSynthesisAgentRunner(tools: SynthesisTools, config: Synth
|
|
|
675
767
|
//#region src/synthesis/infrastructure/sqlite-synthesis-repository.d.ts
|
|
676
768
|
declare function createSynthesisRepository(db: DatabaseManager): SynthesisRepository;
|
|
677
769
|
//#endregion
|
|
678
|
-
export { type AgentRunner, type CreateMemoryOpts, type CreateReviewEventOpts, DatabaseError, DatabaseManager, type DownloadProgress, type DownloadResult, type Embedder, EmbeddingService, type ExtractionAgentRunner, type ExtractionConfig, type ExtractionRunRecord, type ExtractionRunRepository, type ExtractionTools, MEMORY_TYPE_VALUES, MIGRATIONS, MODEL_NAME, MembankError, type Memory, type MemoryExportRecord, type MemoryPatch, MemoryPatchSchema, type MemoryRepository, type MemoryRow, MemoryRowSchema, MemorySchema, type MemoryType, MemoryTypeSchema, MigrationMeta, ModelDownloadError, ModelDownloader, PIN_BUDGET_THRESHOLD, type ProgressCallback, Project, type ProjectRepository, ProjectRow, ProjectRowSchema, ProjectSchema, type Querier, type QueryAdapter, QueryEngine, QueryOptions, QueryOptionsSchema, type ReviewEvent, type ReviewEventRow, ReviewEventRowSchema, ReviewEventSchema, ReviewReason, ReviewReasonSchema, type RunExtractionInput, type RunExtractionResult, type SaveOptions, SaveOptionsSchema, ScopeToProjectsResult, type ScoredMemory, SessionContext, SessionContextBuilder, SessionContextSchema, type SimilarMemoryResult, SqliteMemoryRepository, type StatsResult, Synthesis, type SynthesisConfig, SynthesisEngine, type SynthesisRepository, SynthesisSchema, type SynthesisTools, TagsJsonSchema, type TranscriptReader, createClaudeCodeTranscriptReader, createExtractionAgentRunner, createExtractionRunRepository, createMemoryRepository, createProjectRepository, createSynthesisAgentRunner, createSynthesisRepository, deleteMemory, getSessionContext, isOverBudget, isSynthesisEnabled, listMemoryTypes, queryMemories, resolveProject, resolveReview, resolveScope, rowToMemory, rowToProject, runExtraction, runScopeToProjectsMigration, runSynthesis, saveMemory, updateMemory };
|
|
770
|
+
export { ACTIVITY_EVENT_TYPE_VALUES, type ActivityEvent, type ActivityEventInput, type ActivityEventType, ActivityEventTypeSchema, type ActivityLogger, type ActivityRepository, type AgentRunner, type CreateMemoryOpts, type CreateReviewEventOpts, DatabaseError, DatabaseManager, type DownloadProgress, type DownloadResult, type Embedder, EmbeddingService, type ExtractionAgentRunner, type ExtractionConfig, type ExtractionRunRecord, type ExtractionRunRepository, type ExtractionTools, GLOBAL_PROJECT_ID, GLOBAL_PROJECT_NAME, GLOBAL_SCOPE_HASH, type ListEventsFilter, MEMORY_TYPE_VALUES, MIGRATIONS, MODEL_NAME, MembankError, type Memory, type MemoryExportRecord, type MemoryPatch, MemoryPatchSchema, type MemoryRepository, type MemoryRow, MemoryRowSchema, MemorySchema, type MemoryType, MemoryTypeSchema, MigrationMeta, ModelDownloadError, ModelDownloader, PIN_BUDGET_THRESHOLD, type ProgressCallback, Project, type ProjectRepository, ProjectRow, ProjectRowSchema, ProjectSchema, type Querier, type QueryAdapter, QueryEngine, QueryOptions, QueryOptionsSchema, RETENTION_DAYS, type ReviewEvent, type ReviewEventRow, ReviewEventRowSchema, ReviewEventSchema, ReviewReason, ReviewReasonSchema, type RunExtractionInput, type RunExtractionResult, type SaveOptions, SaveOptionsSchema, ScopeToProjectsResult, type ScoredMemory, SessionContext, SessionContextBuilder, SessionContextSchema, type SimilarMemoryResult, SqliteMemoryRepository, type StatsResult, Synthesis, type SynthesisConfig, SynthesisEngine, type SynthesisRepository, SynthesisSchema, type SynthesisTools, TagsJsonSchema, type TranscriptReader, createActivityLogger, createActivityRepository, createClaudeCodeTranscriptReader, createExtractionAgentRunner, createExtractionRunRepository, createMemoryRepository, createProjectRepository, createSynthesisAgentRunner, createSynthesisRepository, deleteMemory, getSessionContext, isOverBudget, isSynthesisEnabled, listEvents, listMemoryTypes, logEvent, noopActivityLogger, queryMemories, resolveProject, resolveReview, resolveScope, rowToMemory, rowToProject, runExtraction, runScopeToProjectsMigration, runSynthesis, saveMemory, updateMemory };
|
|
679
771
|
//# sourceMappingURL=index.d.cts.map
|
package/dist/index.d.mts
CHANGED
|
@@ -2,6 +2,103 @@ import { z } from "zod";
|
|
|
2
2
|
import BetterSqlite3 from "better-sqlite3";
|
|
3
3
|
import { EventEmitter } from "node:events";
|
|
4
4
|
|
|
5
|
+
//#region src/activity/domain/activity-event.d.ts
|
|
6
|
+
declare const ACTIVITY_EVENT_TYPE_VALUES: readonly ["memory.created", "memory.updated", "memory.deleted", "memory.flagged", "memory.queried"];
|
|
7
|
+
declare const ActivityEventTypeSchema: z.ZodEnum<{
|
|
8
|
+
"memory.created": "memory.created";
|
|
9
|
+
"memory.updated": "memory.updated";
|
|
10
|
+
"memory.deleted": "memory.deleted";
|
|
11
|
+
"memory.flagged": "memory.flagged";
|
|
12
|
+
"memory.queried": "memory.queried";
|
|
13
|
+
}>;
|
|
14
|
+
type ActivityEventType = z.infer<typeof ActivityEventTypeSchema>;
|
|
15
|
+
declare const RETENTION_DAYS = 30;
|
|
16
|
+
interface ActivityEvent {
|
|
17
|
+
id: string;
|
|
18
|
+
projectHash: string;
|
|
19
|
+
eventType: ActivityEventType;
|
|
20
|
+
memoryId: string | null;
|
|
21
|
+
payload: Record<string, unknown>;
|
|
22
|
+
createdAt: string;
|
|
23
|
+
}
|
|
24
|
+
interface ActivityEventInput {
|
|
25
|
+
projectHash: string;
|
|
26
|
+
eventType: ActivityEventType;
|
|
27
|
+
memoryId?: string;
|
|
28
|
+
payload?: Record<string, unknown>;
|
|
29
|
+
}
|
|
30
|
+
//#endregion
|
|
31
|
+
//#region src/activity/ports.d.ts
|
|
32
|
+
interface ActivityRepository {
|
|
33
|
+
insert(event: {
|
|
34
|
+
id: string;
|
|
35
|
+
projectHash: string;
|
|
36
|
+
eventType: ActivityEventType;
|
|
37
|
+
memoryId: string | null;
|
|
38
|
+
payload: Record<string, unknown>;
|
|
39
|
+
createdAt: string;
|
|
40
|
+
}): void;
|
|
41
|
+
list(filter: {
|
|
42
|
+
scope?: string;
|
|
43
|
+
type?: ActivityEventType;
|
|
44
|
+
since?: string;
|
|
45
|
+
limit?: number;
|
|
46
|
+
}): ActivityEvent[];
|
|
47
|
+
prune(olderThan: string): void;
|
|
48
|
+
}
|
|
49
|
+
interface ActivityLogger {
|
|
50
|
+
logEvent(input: ActivityEventInput): void;
|
|
51
|
+
}
|
|
52
|
+
declare const noopActivityLogger: ActivityLogger;
|
|
53
|
+
//#endregion
|
|
54
|
+
//#region src/activity/application/list-events.d.ts
|
|
55
|
+
interface ListEventsFilter {
|
|
56
|
+
scope?: string;
|
|
57
|
+
type?: ActivityEventType;
|
|
58
|
+
since?: string;
|
|
59
|
+
limit?: number;
|
|
60
|
+
}
|
|
61
|
+
declare function listEvents(filter: ListEventsFilter, repo: ActivityRepository): ActivityEvent[];
|
|
62
|
+
//#endregion
|
|
63
|
+
//#region src/activity/application/log-event.d.ts
|
|
64
|
+
declare function logEvent(input: ActivityEventInput, repo: ActivityRepository): void;
|
|
65
|
+
//#endregion
|
|
66
|
+
//#region src/db/manager.d.ts
|
|
67
|
+
type VecLoader = (db: BetterSqlite3.Database) => void;
|
|
68
|
+
declare class DatabaseManager {
|
|
69
|
+
#private;
|
|
70
|
+
private constructor();
|
|
71
|
+
static open(dbPath?: string): DatabaseManager;
|
|
72
|
+
static openInMemory(): DatabaseManager;
|
|
73
|
+
/** For testing: inject a custom vec loader (e.g. a throwing stub). */
|
|
74
|
+
static _openInMemoryWithLoader(loader: VecLoader): DatabaseManager;
|
|
75
|
+
get db(): BetterSqlite3.Database;
|
|
76
|
+
close(): void;
|
|
77
|
+
}
|
|
78
|
+
//#endregion
|
|
79
|
+
//#region src/activity/infrastructure/sqlite-activity-repository.d.ts
|
|
80
|
+
declare class SqliteActivityRepository implements ActivityRepository {
|
|
81
|
+
#private;
|
|
82
|
+
constructor(db: DatabaseManager);
|
|
83
|
+
insert(event: {
|
|
84
|
+
id: string;
|
|
85
|
+
projectHash: string;
|
|
86
|
+
eventType: string;
|
|
87
|
+
memoryId: string | null;
|
|
88
|
+
payload: Record<string, unknown>;
|
|
89
|
+
createdAt: string;
|
|
90
|
+
}): void;
|
|
91
|
+
list(filter: {
|
|
92
|
+
scope?: string;
|
|
93
|
+
type?: string;
|
|
94
|
+
since?: string;
|
|
95
|
+
limit?: number;
|
|
96
|
+
}): ActivityEvent[];
|
|
97
|
+
prune(olderThan: string): void;
|
|
98
|
+
}
|
|
99
|
+
declare function createActivityRepository(db: DatabaseManager): SqliteActivityRepository;
|
|
100
|
+
declare function createActivityLogger(db: DatabaseManager): ActivityLogger;
|
|
101
|
+
//#endregion
|
|
5
102
|
//#region src/config/loader.d.ts
|
|
6
103
|
declare function isSynthesisEnabled(): boolean;
|
|
7
104
|
//#endregion
|
|
@@ -262,19 +359,6 @@ declare class DatabaseError extends MembankError {
|
|
|
262
359
|
constructor(message: string, options?: ErrorOptions);
|
|
263
360
|
}
|
|
264
361
|
//#endregion
|
|
265
|
-
//#region src/db/manager.d.ts
|
|
266
|
-
type VecLoader = (db: BetterSqlite3.Database) => void;
|
|
267
|
-
declare class DatabaseManager {
|
|
268
|
-
#private;
|
|
269
|
-
private constructor();
|
|
270
|
-
static open(dbPath?: string): DatabaseManager;
|
|
271
|
-
static openInMemory(): DatabaseManager;
|
|
272
|
-
/** For testing: inject a custom vec loader (e.g. a throwing stub). */
|
|
273
|
-
static _openInMemoryWithLoader(loader: VecLoader): DatabaseManager;
|
|
274
|
-
get db(): BetterSqlite3.Database;
|
|
275
|
-
close(): void;
|
|
276
|
-
}
|
|
277
|
-
//#endregion
|
|
278
362
|
//#region src/embedding/infrastructure/model-downloader.d.ts
|
|
279
363
|
declare const MODEL_NAME = "Xenova/bge-small-en-v1.5";
|
|
280
364
|
interface DownloadProgress {
|
|
@@ -476,7 +560,7 @@ interface TranscriptReaderOptions {
|
|
|
476
560
|
declare function createClaudeCodeTranscriptReader(opts?: TranscriptReaderOptions): TranscriptReader;
|
|
477
561
|
//#endregion
|
|
478
562
|
//#region src/memory/application/delete-memory.d.ts
|
|
479
|
-
declare function deleteMemory(id: string, repo: MemoryRepository): Promise<void>;
|
|
563
|
+
declare function deleteMemory(id: string, repo: MemoryRepository, activityLogger?: ActivityLogger): Promise<void>;
|
|
480
564
|
//#endregion
|
|
481
565
|
//#region src/memory/application/resolve-review.d.ts
|
|
482
566
|
declare function resolveReview(memoryId: string, repo: MemoryRepository): void;
|
|
@@ -485,12 +569,14 @@ declare function resolveReview(memoryId: string, repo: MemoryRepository): void;
|
|
|
485
569
|
declare function saveMemory(opts: SaveOptions, deps: {
|
|
486
570
|
repo: MemoryRepository;
|
|
487
571
|
embedder: Embedder;
|
|
572
|
+
activityLogger?: ActivityLogger;
|
|
488
573
|
}): Promise<Memory>;
|
|
489
574
|
//#endregion
|
|
490
575
|
//#region src/memory/application/update-memory.d.ts
|
|
491
576
|
declare function updateMemory(id: string, patch: MemoryPatch, deps: {
|
|
492
577
|
repo: MemoryRepository;
|
|
493
578
|
embedder: Embedder;
|
|
579
|
+
activityLogger?: ActivityLogger;
|
|
494
580
|
}): Promise<Memory>;
|
|
495
581
|
//#endregion
|
|
496
582
|
//#region src/memory/domain/pin-budget.d.ts
|
|
@@ -543,6 +629,11 @@ declare class SqliteMemoryRepository implements MemoryRepository {
|
|
|
543
629
|
}
|
|
544
630
|
declare function createMemoryRepository(db: DatabaseManager, projects: ProjectRepository): MemoryRepository;
|
|
545
631
|
//#endregion
|
|
632
|
+
//#region src/project/domain/global-scope.d.ts
|
|
633
|
+
declare const GLOBAL_PROJECT_ID: "00000000-0000-0000-0000-000000000000";
|
|
634
|
+
declare const GLOBAL_SCOPE_HASH: "0000000000000000";
|
|
635
|
+
declare const GLOBAL_PROJECT_NAME: "global";
|
|
636
|
+
//#endregion
|
|
546
637
|
//#region src/project/infrastructure/sqlite-project-repository.d.ts
|
|
547
638
|
declare function createProjectRepository(db: DatabaseManager): ProjectRepository;
|
|
548
639
|
//#endregion
|
|
@@ -582,12 +673,13 @@ declare function queryMemories(options: QueryOptions, deps: {
|
|
|
582
673
|
adapter: QueryAdapter;
|
|
583
674
|
repo: Pick<MemoryRepository, "incrementAccessCount">;
|
|
584
675
|
embedder: Embedder;
|
|
676
|
+
activityLogger?: ActivityLogger;
|
|
585
677
|
}): Promise<ScoredMemory[]>;
|
|
586
678
|
//#endregion
|
|
587
679
|
//#region src/query/engine.d.ts
|
|
588
680
|
declare class QueryEngine implements Querier {
|
|
589
681
|
#private;
|
|
590
|
-
constructor(db: DatabaseManager, embeddingService: Embedder, repo: MemoryRepository);
|
|
682
|
+
constructor(db: DatabaseManager, embeddingService: Embedder, repo: MemoryRepository, activityLogger?: ActivityLogger);
|
|
591
683
|
query(options: QueryOptions): Promise<ScoredMemory[]>;
|
|
592
684
|
}
|
|
593
685
|
//#endregion
|
|
@@ -675,5 +767,5 @@ declare function createSynthesisAgentRunner(tools: SynthesisTools, config: Synth
|
|
|
675
767
|
//#region src/synthesis/infrastructure/sqlite-synthesis-repository.d.ts
|
|
676
768
|
declare function createSynthesisRepository(db: DatabaseManager): SynthesisRepository;
|
|
677
769
|
//#endregion
|
|
678
|
-
export { type AgentRunner, type CreateMemoryOpts, type CreateReviewEventOpts, DatabaseError, DatabaseManager, type DownloadProgress, type DownloadResult, type Embedder, EmbeddingService, type ExtractionAgentRunner, type ExtractionConfig, type ExtractionRunRecord, type ExtractionRunRepository, type ExtractionTools, MEMORY_TYPE_VALUES, MIGRATIONS, MODEL_NAME, MembankError, type Memory, type MemoryExportRecord, type MemoryPatch, MemoryPatchSchema, type MemoryRepository, type MemoryRow, MemoryRowSchema, MemorySchema, type MemoryType, MemoryTypeSchema, MigrationMeta, ModelDownloadError, ModelDownloader, PIN_BUDGET_THRESHOLD, type ProgressCallback, Project, type ProjectRepository, ProjectRow, ProjectRowSchema, ProjectSchema, type Querier, type QueryAdapter, QueryEngine, QueryOptions, QueryOptionsSchema, type ReviewEvent, type ReviewEventRow, ReviewEventRowSchema, ReviewEventSchema, ReviewReason, ReviewReasonSchema, type RunExtractionInput, type RunExtractionResult, type SaveOptions, SaveOptionsSchema, ScopeToProjectsResult, type ScoredMemory, SessionContext, SessionContextBuilder, SessionContextSchema, type SimilarMemoryResult, SqliteMemoryRepository, type StatsResult, Synthesis, type SynthesisConfig, SynthesisEngine, type SynthesisRepository, SynthesisSchema, type SynthesisTools, TagsJsonSchema, type TranscriptReader, createClaudeCodeTranscriptReader, createExtractionAgentRunner, createExtractionRunRepository, createMemoryRepository, createProjectRepository, createSynthesisAgentRunner, createSynthesisRepository, deleteMemory, getSessionContext, isOverBudget, isSynthesisEnabled, listMemoryTypes, queryMemories, resolveProject, resolveReview, resolveScope, rowToMemory, rowToProject, runExtraction, runScopeToProjectsMigration, runSynthesis, saveMemory, updateMemory };
|
|
770
|
+
export { ACTIVITY_EVENT_TYPE_VALUES, type ActivityEvent, type ActivityEventInput, type ActivityEventType, ActivityEventTypeSchema, type ActivityLogger, type ActivityRepository, type AgentRunner, type CreateMemoryOpts, type CreateReviewEventOpts, DatabaseError, DatabaseManager, type DownloadProgress, type DownloadResult, type Embedder, EmbeddingService, type ExtractionAgentRunner, type ExtractionConfig, type ExtractionRunRecord, type ExtractionRunRepository, type ExtractionTools, GLOBAL_PROJECT_ID, GLOBAL_PROJECT_NAME, GLOBAL_SCOPE_HASH, type ListEventsFilter, MEMORY_TYPE_VALUES, MIGRATIONS, MODEL_NAME, MembankError, type Memory, type MemoryExportRecord, type MemoryPatch, MemoryPatchSchema, type MemoryRepository, type MemoryRow, MemoryRowSchema, MemorySchema, type MemoryType, MemoryTypeSchema, MigrationMeta, ModelDownloadError, ModelDownloader, PIN_BUDGET_THRESHOLD, type ProgressCallback, Project, type ProjectRepository, ProjectRow, ProjectRowSchema, ProjectSchema, type Querier, type QueryAdapter, QueryEngine, QueryOptions, QueryOptionsSchema, RETENTION_DAYS, type ReviewEvent, type ReviewEventRow, ReviewEventRowSchema, ReviewEventSchema, ReviewReason, ReviewReasonSchema, type RunExtractionInput, type RunExtractionResult, type SaveOptions, SaveOptionsSchema, ScopeToProjectsResult, type ScoredMemory, SessionContext, SessionContextBuilder, SessionContextSchema, type SimilarMemoryResult, SqliteMemoryRepository, type StatsResult, Synthesis, type SynthesisConfig, SynthesisEngine, type SynthesisRepository, SynthesisSchema, type SynthesisTools, TagsJsonSchema, type TranscriptReader, createActivityLogger, createActivityRepository, createClaudeCodeTranscriptReader, createExtractionAgentRunner, createExtractionRunRepository, createMemoryRepository, createProjectRepository, createSynthesisAgentRunner, createSynthesisRepository, deleteMemory, getSessionContext, isOverBudget, isSynthesisEnabled, listEvents, listMemoryTypes, logEvent, noopActivityLogger, queryMemories, resolveProject, resolveReview, resolveScope, rowToMemory, rowToProject, runExtraction, runScopeToProjectsMigration, runSynthesis, saveMemory, updateMemory };
|
|
679
771
|
//# sourceMappingURL=index.d.mts.map
|
package/dist/index.mjs
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{createHash as e,randomUUID as t}from"node:crypto";import{z as n}from"zod";import{existsSync as r,mkdirSync as i,readFileSync as a,readdirSync as o}from"node:fs";import{homedir as s}from"node:os";import{dirname as c,join as l}from"node:path";import u from"better-sqlite3";import*as d from"sqlite-vec";import{EventEmitter as f}from"node:events";import{pipeline as p}from"@huggingface/transformers";import{createSdkMcpServer as m,query as h,tool as g}from"@anthropic-ai/claude-agent-sdk";import{readFile as ee}from"node:fs/promises";import{execFile as te}from"node:child_process";import{promisify as ne}from"node:util";function re(e,t){return t.list(e)}const _=[`memory.created`,`memory.updated`,`memory.deleted`,`memory.flagged`,`memory.queried`],v=n.enum(_),ie=30;function y(e,n){let r=new Date,i=r.toISOString();n.insert({id:t(),projectHash:e.projectHash,eventType:e.eventType,memoryId:e.memoryId??null,payload:e.payload??{},createdAt:i});let a=new Date(r);a.setDate(a.getDate()-30),n.prune(a.toISOString())}function ae(e){return{id:e.id,projectHash:e.project_hash,eventType:v.parse(e.event_type),memoryId:e.memory_id,payload:JSON.parse(e.payload),createdAt:e.created_at}}var b=class{#e;#t=0;#n;#r;constructor(e){this.#e=e,this.#n=e.db.prepare(`INSERT INTO activity_events (id, project_hash, event_type, memory_id, payload, created_at)
|
|
2
|
+
VALUES (?, ?, ?, ?, ?, ?)`),this.#r=e.db.prepare(`DELETE FROM activity_events WHERE created_at < ?`)}insert(e){this.#n.run(e.id,e.projectHash,e.eventType,e.memoryId,JSON.stringify(e.payload),e.createdAt)}list(e){let t=[],n=[];e.scope!==void 0&&(t.push(`project_hash = ?`),n.push(e.scope)),e.type!==void 0&&(t.push(`event_type = ?`),n.push(e.type)),e.since!==void 0&&(t.push(`created_at >= ?`),n.push(e.since));let r=t.length>0?`WHERE ${t.join(` AND `)}`:``,i=e.limit===void 0?``:`LIMIT ?`;return e.limit!==void 0&&n.push(e.limit),this.#e.db.prepare(`SELECT * FROM activity_events ${r} ORDER BY created_at DESC ${i}`).all(...n).map(ae)}prune(e){let t=Date.now();t-this.#t<6e4||(this.#r.run(e),this.#t=t)}};function oe(e){return new b(e)}function se(e){let t=new b(e);return{logEvent:e=>y(e,t)}}const x={logEvent(){}};function ce(){let e=l(s(),`.membank`,`config.json`);try{let t=a(e,`utf8`);return JSON.parse(t)}catch{return null}}function le(){return ce()?.synthesis?.enabled===!0}const S=[`correction`,`preference`,`decision`,`learning`,`fact`],C=n.enum(S),w=n.array(n.string()),T=n.object({id:n.string(),name:n.string(),scopeHash:n.string(),createdAt:n.string(),updatedAt:n.string()}),E=n.enum([`similarity_dedup`]),D=n.object({id:n.string(),memoryId:n.string(),conflictingMemoryId:n.string().nullable(),similarity:n.number(),conflictContentSnapshot:n.string(),reason:E,createdAt:n.string(),resolvedAt:n.string().nullable()}),O=n.object({id:n.string(),memory_id:n.string(),conflicting_memory_id:n.string().nullable(),similarity:n.number(),conflict_content_snapshot:n.string(),reason:E,created_at:n.string(),resolved_at:n.string().nullable()}),k=n.object({id:n.string(),content:n.string(),type:C,tags:n.array(n.string()),projects:n.array(T),sourceHarness:n.string().nullable(),accessCount:n.number().int().nonnegative(),pinned:n.boolean(),reviewEvents:n.array(D),createdAt:n.string(),updatedAt:n.string()}),A=n.object({query:n.string().min(1),type:C.optional(),projectHash:n.string().optional(),limit:n.number().int().positive().optional(),includePinned:n.boolean().optional()}),ue=n.object({content:n.string().min(1),type:C,tags:n.array(n.string()).optional(),projectScope:n.object({hash:n.string(),name:n.string()}).optional(),sourceHarness:n.string().optional()}),j=n.object({content:n.string().min(1).optional(),tags:n.array(n.string()).optional(),type:C.optional()}),M=n.object({id:n.string(),scope:n.string(),content:n.string(),sourceMemoryHash:n.string(),synthesizedAt:n.string(),expiresAt:n.string(),inFlightSince:n.string().nullable(),createdAt:n.string(),updatedAt:n.string()}),de=n.object({stats:n.record(C,n.number()),pinnedGlobal:n.array(k),pinnedProject:n.array(k),synthesis:n.string().optional()}),N=n.object({id:n.string(),content:n.string(),type:n.string(),tags:n.string(),source:n.string().nullable(),access_count:n.number(),pinned:n.number(),created_at:n.string(),updated_at:n.string()}),P=n.object({id:n.string(),name:n.string(),scope_hash:n.string(),created_at:n.string(),updated_at:n.string()});function F(e,t,n=[]){return{id:e.id,content:e.content,type:C.parse(e.type),tags:w.parse(JSON.parse(e.tags)),projects:t,sourceHarness:e.source,accessCount:e.access_count,pinned:e.pinned!==0,reviewEvents:n,createdAt:e.created_at,updatedAt:e.updated_at}}function I(e){let t=O.parse(e);return{id:t.id,memoryId:t.memory_id,conflictingMemoryId:t.conflicting_memory_id,similarity:t.similarity,conflictContentSnapshot:t.conflict_content_snapshot,reason:t.reason,createdAt:t.created_at,resolvedAt:t.resolved_at}}function L(e){return{id:e.id,name:e.name,scopeHash:e.scope_hash,createdAt:e.created_at,updatedAt:e.updated_at}}var R=class extends Error{constructor(e,t){super(e,t),this.name=`MembankError`}},z=class extends R{constructor(e,t){super(e,t),this.name=`DatabaseError`}};const fe=l(s(),`.membank`,`memory.db`),pe=[[1,`
|
|
2
3
|
CREATE TABLE IF NOT EXISTS memories (
|
|
3
4
|
id TEXT PRIMARY KEY,
|
|
4
5
|
content TEXT NOT NULL,
|
|
@@ -154,14 +155,86 @@ CREATE TABLE IF NOT EXISTS extraction_runs (
|
|
|
154
155
|
|
|
155
156
|
CREATE INDEX IF NOT EXISTS idx_extraction_runs_status
|
|
156
157
|
ON extraction_runs(status) WHERE status = 'in_flight';
|
|
157
|
-
`]
|
|
158
|
+
`],[7,`
|
|
159
|
+
INSERT OR IGNORE INTO projects (id, name, scope_hash, created_at, updated_at)
|
|
160
|
+
VALUES ('00000000-0000-0000-0000-000000000000', 'global', '0000000000000000', datetime('now'), datetime('now'));
|
|
161
|
+
|
|
162
|
+
INSERT OR IGNORE INTO memory_projects (memory_id, project_id)
|
|
163
|
+
SELECT id, '00000000-0000-0000-0000-000000000000'
|
|
164
|
+
FROM memories
|
|
165
|
+
WHERE id NOT IN (SELECT memory_id FROM memory_projects);
|
|
166
|
+
`],[8,`
|
|
167
|
+
PRAGMA foreign_keys = OFF;
|
|
168
|
+
|
|
169
|
+
BEGIN;
|
|
170
|
+
|
|
171
|
+
UPDATE syntheses SET scope = '0000000000000000' WHERE scope = 'global';
|
|
172
|
+
|
|
173
|
+
DROP TABLE IF EXISTS syntheses_new;
|
|
174
|
+
|
|
175
|
+
CREATE TABLE syntheses_new (
|
|
176
|
+
id TEXT PRIMARY KEY,
|
|
177
|
+
scope TEXT NOT NULL REFERENCES projects(scope_hash) ON DELETE CASCADE,
|
|
178
|
+
content TEXT NOT NULL,
|
|
179
|
+
source_memory_hash TEXT NOT NULL,
|
|
180
|
+
synthesized_at TEXT NOT NULL,
|
|
181
|
+
expires_at TEXT NOT NULL,
|
|
182
|
+
in_flight_since TEXT,
|
|
183
|
+
created_at TEXT NOT NULL,
|
|
184
|
+
updated_at TEXT NOT NULL,
|
|
185
|
+
UNIQUE(scope),
|
|
186
|
+
CHECK(expires_at > synthesized_at)
|
|
187
|
+
);
|
|
188
|
+
|
|
189
|
+
INSERT INTO syntheses_new SELECT * FROM syntheses;
|
|
190
|
+
|
|
191
|
+
DROP TABLE syntheses;
|
|
192
|
+
ALTER TABLE syntheses_new RENAME TO syntheses;
|
|
193
|
+
|
|
194
|
+
CREATE INDEX IF NOT EXISTS idx_syntheses_expires_at ON syntheses(expires_at);
|
|
195
|
+
CREATE INDEX IF NOT EXISTS idx_syntheses_scope_inflight
|
|
196
|
+
ON syntheses(scope) WHERE in_flight_since IS NOT NULL;
|
|
197
|
+
|
|
198
|
+
COMMIT;
|
|
199
|
+
|
|
200
|
+
PRAGMA foreign_keys = ON;
|
|
201
|
+
`],[9,`
|
|
202
|
+
CREATE TABLE activity_events (
|
|
203
|
+
id TEXT PRIMARY KEY,
|
|
204
|
+
project_hash TEXT NOT NULL REFERENCES projects(scope_hash) ON DELETE CASCADE,
|
|
205
|
+
event_type TEXT NOT NULL,
|
|
206
|
+
memory_id TEXT,
|
|
207
|
+
payload TEXT NOT NULL,
|
|
208
|
+
created_at TEXT NOT NULL
|
|
209
|
+
);
|
|
210
|
+
|
|
211
|
+
CREATE INDEX idx_activity_project_created ON activity_events(project_hash, created_at DESC);
|
|
212
|
+
CREATE INDEX idx_activity_type_created ON activity_events(event_type, created_at DESC);
|
|
213
|
+
`],[10,`
|
|
214
|
+
ALTER TABLE activity_events RENAME TO activity_events_old;
|
|
215
|
+
|
|
216
|
+
CREATE TABLE activity_events (
|
|
217
|
+
id TEXT PRIMARY KEY,
|
|
218
|
+
project_hash TEXT NOT NULL,
|
|
219
|
+
event_type TEXT NOT NULL,
|
|
220
|
+
memory_id TEXT,
|
|
221
|
+
payload TEXT NOT NULL,
|
|
222
|
+
created_at TEXT NOT NULL
|
|
223
|
+
);
|
|
224
|
+
|
|
225
|
+
INSERT INTO activity_events SELECT * FROM activity_events_old;
|
|
226
|
+
DROP TABLE activity_events_old;
|
|
227
|
+
|
|
228
|
+
CREATE INDEX idx_activity_project_created ON activity_events(project_hash, created_at DESC);
|
|
229
|
+
CREATE INDEX idx_activity_type_created ON activity_events(event_type, created_at DESC);
|
|
230
|
+
`]];var me=class e{#e;constructor(e){this.#e=e}static open(t){let n=t??fe;i(c(n),{recursive:!0});let r=new u(n);return e.#n(r,d.load)}static openInMemory(){return e.#t(d.load)}static _openInMemoryWithLoader(t){return e.#t(t)}static#t(t){let n=new u(`:memory:`);return e.#n(n,t)}static#n(t,n){try{n(t)}catch(e){throw new z(`Failed to load sqlite-vec extension`,{cause:e})}t.pragma(`journal_mode = WAL`),t.pragma(`foreign_keys = ON`);let r=new e(t);return r.#r(),r}#r(){this.#e.exec(`
|
|
158
231
|
CREATE TABLE IF NOT EXISTS meta (
|
|
159
232
|
key TEXT PRIMARY KEY,
|
|
160
233
|
value TEXT NOT NULL
|
|
161
234
|
);
|
|
162
|
-
`);let e=this.#e.prepare(`SELECT value FROM meta WHERE key = 'schema_version'`).get(),t=e?Number.parseInt(e.value,10):0;for(let[e,n]of
|
|
163
|
-
`);var
|
|
164
|
-
`),
|
|
235
|
+
`);let e=this.#e.prepare(`SELECT value FROM meta WHERE key = 'schema_version'`).get(),t=e?Number.parseInt(e.value,10):0;for(let[e,n]of pe)t<e&&(this.#e.exec(n),this.#e.prepare(`INSERT OR REPLACE INTO meta (key, value) VALUES ('schema_version', ?)`).run(String(e)))}get db(){return this.#e}close(){this.#e.close()}};const B=`Xenova/bge-small-en-v1.5`;var V=class extends Error{constructor(e,t){super(e,t),this.name=`ModelDownloadError`}};function he(){return l(s(),`.membank`,`models`)}function H(e){if(!r(e))return!1;try{return o(e).length>0}catch{return!1}}var ge=class extends f{modelPath;constructor(e){super(),this.modelPath=e??he()}isAlreadyCached(){return H(this.modelPath)}get cachePath(){return this.modelPath}async download(){if(H(this.modelPath))return{skipped:!0};let e=Date.now(),t=0,n=e;try{await p(`feature-extraction`,B,{cache_dir:this.modelPath,progress_callback:e=>{if(e.status!==`progress`||e.total==null||e.loaded==null)return;let r=e.total,i=e.loaded,a=r>0?i/r*100:0,o=Date.now(),s=o-n,c=i-t,l=0;if(s>0&&c>0){let e=c/s;l=(r-i)/e/1e3}t=i,n=o;let u={totalBytes:r,downloadedBytes:i,percentage:a,estimatedSecondsRemaining:l};this.emit(`progress`,u)}})}catch(e){throw new V(`Failed to download model`,{cause:e})}return{skipped:!1}}},_e=class{modelCachePath;onProgress;pipelineInstance=null;constructor(e,t){this.modelCachePath=e??l(s(),`.membank`,`models`),this.onProgress=t}async getPipeline(){return this.pipelineInstance===null&&(this.pipelineInstance=await p(`feature-extraction`,`Xenova/bge-small-en-v1.5`,{cache_dir:this.modelCachePath,progress_callback:this.onProgress})),this.pipelineInstance}async embed(e){let t=(await(await this.getPipeline())(e,{pooling:`mean`,normalize:!0})).data;return t instanceof Float32Array?t:new Float32Array(t)}};async function ve(e,t){let n=t.now??(()=>new Date);if(!t.repo.tryClaim(e.sessionId,n(),t.config)){let n=t.repo.get(e.sessionId);return{status:`skipped`,reason:n?.status===`completed`&&n.completedAt!==null?`recently_completed`:`in_flight`}}try{let r=await t.transcripts.read(e.transcriptPath);return await t.agent.run({transcript:r,projectHash:e.projectHash,sessionId:e.sessionId}),t.repo.markCompleted(e.sessionId,n()),{status:`completed`}}catch(r){let i=r instanceof Error?r.message:String(r);return t.repo.markFailed(e.sessionId,n(),i),{status:`failed`,error:i}}}const ye=[`You are a memory extractor that runs after a coding session ends. You read the session transcript and CALL save_memory for every durable fact, preference, correction, decision, or learning the user expressed, so that future sessions inherit them.`,``,`Memory types (pick the closest match):`,`- correction: the user told the assistant to stop doing something or to do it differently.`,`- preference: the user stated how they want work done (tools, style, conventions).`,`- decision: the user committed to a choice future work should respect (tech pick, architectural direction, scope cut).`,`- learning: a non-obvious fact about the codebase or tooling that future sessions would otherwise rediscover.`,`- fact: stable info about the user or their project not derivable from the code.`,``,`Bias strongly toward saving. If the user said it in plain language and it would be useful in a future session, save it. Phrasing like 'stop X', 'always Y', 'we use Z', 'don't suggest W', 'we decided', 'from now on' is a clear save signal — even when the assistant in the transcript already acknowledged it, save it so the NEXT session also knows.`,``,`Process:`,`1. Read the supplied transcript end-to-end.`,`2. Identify every distinct durable signal. List them mentally before calling tools.`,`3. Optional: call query_memory with focused search terms to avoid duplicates. If a near-duplicate exists, call update_memory instead of save_memory.`,`4. Call save_memory for each new durable signal. Phrase the content as a standalone instruction or fact — strip session framing ("in this session", "just now"). Good: "Use pnpm, not npm, for all dependency operations." Bad: "User said stop using npm."`,"5. Use `global: true` only when the fact is about the user themselves or applies across every project. Otherwise default to project scope (omit `global`).",``,`Only return without saving when the transcript truly contains no durable signal — pure greetings, time-of-day questions, abandoned tasks. Do not invent facts. If in doubt and the signal is concrete, save it.`].join(`
|
|
236
|
+
`);var be=class{#e;constructor(e){this.#e=e}async run(e){let t=m({name:`membank-extraction-tools`,version:`1.0.0`,tools:[g(`query_memory`,`Search memories by semantic similarity to check for existing entries before saving.`,{query:n.string().describe(`Search text`),limit:n.number().optional().describe(`Maximum results to return`),global:n.boolean().optional().describe(`Query global memories when true, otherwise current project scope`)},async({query:t,limit:n,global:r})=>({content:[{type:`text`,text:await this.#e.queryMemory({query:t,limit:n,global:r,projectHash:e.projectHash})}]}),{annotations:{readOnlyHint:!0}}),g(`save_memory`,`Persist a new memory. The system handles dedup automatically.`,{content:n.string().describe(`Memory content — concise, decontextualised`),type:n.enum([`correction`,`preference`,`decision`,`learning`,`fact`]).describe(`Memory type`),tags:n.array(n.string()).optional().describe(`Optional tags`),global:n.boolean().optional().describe(`Save as global memory rather than project-scoped`)},async({content:e,type:t,tags:n,global:r})=>({content:[{type:`text`,text:await this.#e.saveMemory({content:e,type:t,tags:n,global:r})}]})),g(`update_memory`,`Refine an existing memory by id rather than creating a near-duplicate.`,{id:n.string().describe(`Memory id`),content:n.string().optional(),type:n.enum([`correction`,`preference`,`decision`,`learning`,`fact`]).optional(),tags:n.array(n.string()).optional()},async({id:e,content:t,type:n,tags:r})=>({content:[{type:`text`,text:await this.#e.updateMemory({id:e,content:t,type:n,tags:r})}]}))]}),r=[`Session id: ${e.sessionId}`,``,`Transcript (most recent turns):`,`---`,e.transcript,`---`,``,`Extract durable memories from this transcript following the system instructions.`].join(`
|
|
237
|
+
`),i=Object.fromEntries(Object.entries(process.env).filter(e=>e[1]!==void 0)),a=Date.now(),o=h({prompt:r,options:{model:`claude-haiku-4-5-20251001`,systemPrompt:ye,mcpServers:{"membank-extraction-tools":t},allowedTools:[`mcp__membank-extraction-tools__query_memory`,`mcp__membank-extraction-tools__save_memory`,`mcp__membank-extraction-tools__update_memory`],disallowedTools:[`mcp__membank__*`],settingSources:[],permissionMode:`bypassPermissions`,env:i}}),s=process.env.MEMBANK_EXTRACTION_DEBUG===`true`;for await(let e of o)if(s&&process.stderr.write(`[extraction debug] ${JSON.stringify(e).slice(0,600)}\n`),e.type===`result`&&e.subtype!==`success`){let t=`errors`in e&&Array.isArray(e.errors)?`: ${e.errors.join(`; `)}`:``;throw Error(`Extraction agent failed: ${e.subtype}${t}`)}let c=Date.now()-a;process.stderr.write(`membank extraction: session=${e.sessionId} duration=${c}ms\n`)}};function xe(e){return new be(e)}function Se(e,t,n,r){return e===void 0?{kind:`claim`}:e.status===`in_flight`?t.getTime()-e.startedAt.getTime()<n?{kind:`skip`,reason:`in_flight`}:{kind:`claim`}:e.status===`completed`&&e.completedAt!==null&&t.getTime()-e.completedAt.getTime()<r?{kind:`skip`,reason:`recently_completed`}:{kind:`claim`}}function Ce(e){return{sessionId:e.session_id,startedAt:e.started_at,completedAt:e.completed_at,status:e.status,error:e.error}}var we=class{#e;constructor(e){this.#e=e}tryClaim(e,t,n){let r=this.#t(e);if(Se(r===void 0?void 0:{startedAt:new Date(r.started_at),completedAt:r.completed_at===null?null:new Date(r.completed_at),status:r.status},t,n.inFlightTimeoutMs??6e5,n.recentCompletionMs??6e4).kind===`skip`)return!1;let i=t.toISOString();return this.#e.db.prepare(`INSERT INTO extraction_runs (session_id, started_at, completed_at, status, error)
|
|
165
238
|
VALUES (?, ?, NULL, 'in_flight', NULL)
|
|
166
239
|
ON CONFLICT(session_id) DO UPDATE SET
|
|
167
240
|
started_at = excluded.started_at,
|
|
@@ -171,26 +244,25 @@ CREATE INDEX IF NOT EXISTS idx_extraction_runs_status
|
|
|
171
244
|
SET status = 'completed', completed_at = ?, error = NULL
|
|
172
245
|
WHERE session_id = ?`).run(t.toISOString(),e)}markFailed(e,t,n){this.#e.db.prepare(`UPDATE extraction_runs
|
|
173
246
|
SET status = 'failed', completed_at = ?, error = ?
|
|
174
|
-
WHERE session_id = ?`).run(t.toISOString(),n,e)}get(e){let t=this.#t(e);return t===void 0?void 0:
|
|
175
|
-
`)}var
|
|
176
|
-
`).filter(e=>e.length>0),n=[];for(let e of t){let t;try{t=JSON.parse(e)}catch{continue}let r=t.message?.role;if(r!==`user`&&r!==`assistant`)continue;let i=
|
|
247
|
+
WHERE session_id = ?`).run(t.toISOString(),n,e)}get(e){let t=this.#t(e);return t===void 0?void 0:Ce(t)}#t(e){return this.#e.db.prepare(`SELECT * FROM extraction_runs WHERE session_id = ?`).get(e)}};function Te(e){return new we(e)}function Ee(e){if(typeof e==`string`)return e;if(!Array.isArray(e))return``;let t=[];for(let n of e){if(typeof n!=`object`||!n)continue;let e=n;e.type===`text`&&typeof e.text==`string`?t.push(e.text):e.type===`tool_use`&&typeof e.name==`string`?t.push(`[tool_use: ${e.name}]`):e.type===`tool_result`&&t.push(`[tool_result]`)}return t.join(`
|
|
248
|
+
`)}var De=class{#e;#t;constructor(e={}){this.#e=e.maxTurns??80,this.#t=e.maxChars??6e4}async read(e){let t=(await ee(e,`utf8`)).split(`
|
|
249
|
+
`).filter(e=>e.length>0),n=[];for(let e of t){let t;try{t=JSON.parse(e)}catch{continue}let r=t.message?.role;if(r!==`user`&&r!==`assistant`)continue;let i=Ee(t.message?.content).trim();i.length!==0&&n.push(`${r}: ${i}`)}let r=n.slice(-this.#e).join(`
|
|
177
250
|
|
|
178
|
-
`);return r.length<=this.#t?r:r.slice(r.length-this.#t)}};function
|
|
251
|
+
`);return r.length<=this.#t?r:r.slice(r.length-this.#t)}};function Oe(e={}){return new De(e)}const U=`00000000-0000-0000-0000-000000000000`,W=`0000000000000000`,G=`global`;function ke(e,t,n=x){let r=t.findById(e)?.projects[0]?.scopeHash??`0000000000000000`;return t.delete(e),n.logEvent({projectHash:r,eventType:`memory.deleted`,memoryId:e}),Promise.resolve()}function Ae(e,t){t.resolveReviewEvents(e)}function je(e){return e>.92?`overwrite`:e>=.75?`flag`:`none`}async function Me(e,n){let{content:r,type:i,tags:a=[],projectScope:o,sourceHarness:s}=ue.parse(e),{repo:c,embedder:l,activityLogger:u=x}=n,d=o?.hash??`0000000000000000`,f=await l.embed(r),[p]=c.findSimilar(f,i,o?.hash);if(p!==void 0){let e=je(p.similarity);if(e===`overwrite`){let e=c.overwrite(p.id,r,f);return u.logEvent({projectHash:d,eventType:`memory.updated`,memoryId:p.id}),e}if(e===`flag`){let e=c.create({id:t(),content:r,type:i,tags:a,sourceHarness:s??null,embedding:f,projectScope:o});return c.createReviewEvent({memoryId:p.id,conflictingMemoryId:e.id,similarity:p.similarity,conflictContentSnapshot:r}),u.logEvent({projectHash:d,eventType:`memory.created`,memoryId:e.id}),u.logEvent({projectHash:d,eventType:`memory.flagged`,memoryId:p.id,payload:{conflictingMemoryId:e.id,similarity:p.similarity}}),e}}let m=c.create({id:t(),content:r,type:i,tags:a,sourceHarness:s??null,embedding:f,projectScope:o});return u.logEvent({projectHash:d,eventType:`memory.created`,memoryId:m.id}),m}async function Ne(e,t,n){let{repo:r,embedder:i,activityLogger:a=x}=n,o=j.parse(t),s=o.content===void 0?void 0:await i.embed(o.content),c=r.update(e,o,s),l=c.projects[0]?.scopeHash??`0000000000000000`;return a.logEvent({projectHash:l,eventType:`memory.updated`,memoryId:e}),c}const K=8e3;function Pe(e){return e>=K}var q=class{#e;#t;constructor(e,t){this.#e=e,this.#t=t}findSimilar(e,t,n){let r=Buffer.from(e.buffer),i;return i=n===void 0?this.#e.db.prepare(`SELECT m.rowid, m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS similarity
|
|
179
252
|
FROM memories m JOIN embeddings e ON e.rowid = m.rowid
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
253
|
+
JOIN memory_projects mp ON mp.memory_id = m.id
|
|
254
|
+
JOIN projects p ON p.id = mp.project_id
|
|
255
|
+
WHERE m.type = ? AND p.scope_hash = ?
|
|
256
|
+
ORDER BY similarity DESC LIMIT 1`).get(r,t,W):this.#e.db.prepare(`SELECT m.rowid, m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS similarity
|
|
183
257
|
FROM memories m JOIN embeddings e ON e.rowid = m.rowid
|
|
184
258
|
JOIN memory_projects mp ON mp.memory_id = m.id
|
|
185
259
|
JOIN projects p ON p.id = mp.project_id
|
|
186
260
|
WHERE m.type = ? AND p.scope_hash = ?
|
|
187
|
-
ORDER BY similarity DESC LIMIT 1`).get(r,t,n),i===void 0?[]:[{id:i.id,similarity:i.similarity}]}create(e){let{id:t,content:n,type:r,tags:i,sourceHarness:a,embedding:o,projectScope:s}=e,c=new Date().toISOString(),l=Buffer.from(o.buffer);
|
|
188
|
-
VALUES (?, ?, ?, ?, ?, 0, 0, ?, ?)`).run(t,n,r,JSON.stringify(i),a,c,c),this.#e.db.prepare(`INSERT INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`).run(l,t)
|
|
189
|
-
WHERE id NOT IN (SELECT memory_id FROM memory_projects)
|
|
190
|
-
AND pinned = 1`).all().map(e=>j(e,[]))}listPinnedForProject(e){return this.#e.db.prepare(`SELECT m.* FROM memories m
|
|
261
|
+
ORDER BY similarity DESC LIMIT 1`).get(r,t,n),i===void 0?[]:[{id:i.id,similarity:i.similarity}]}create(e){let{id:t,content:n,type:r,tags:i,sourceHarness:a,embedding:o,projectScope:s}=e,c=new Date().toISOString(),l=Buffer.from(o.buffer);this.#e.db.prepare(`INSERT INTO memories (id, content, type, tags, source, access_count, pinned, created_at, updated_at)
|
|
262
|
+
VALUES (?, ?, ?, ?, ?, 0, 0, ?, ?)`).run(t,n,r,JSON.stringify(i),a,c,c),this.#e.db.prepare(`INSERT INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`).run(l,t);let u=s??{hash:`0000000000000000`,name:`global`},d=this.#t.upsertByHash(u.hash,u.name);return this.#t.addAssociation(t,d.id),F(N.parse(this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(t)),this.#t.getProjectsForMemories([t]).get(t)??[])}overwrite(e,t,n){let r=new Date().toISOString(),i=Buffer.from(n.buffer);this.#e.db.prepare(`UPDATE memories SET content = ?, updated_at = ? WHERE id = ?`).run(t,r,e);let a=this.#e.db.prepare(`SELECT rowid FROM memories WHERE id = ?`).get(e)?.rowid;a!==void 0&&this.#e.db.prepare(`UPDATE embeddings SET embedding = ? WHERE rowid = ?`).run(i,a);let o=N.parse(this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(e)),s=this.#t.getProjectsForMemories([e]),c=this.#r([e]);return F(o,s.get(e)??[],c.get(e)??[])}findById(e){let t=this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(e);if(t===void 0)return;let n=this.#t.getProjectsForMemories([e]),r=this.#r([e]);return F(t,n.get(e)??[],r.get(e)??[])}update(e,t,n){let{content:r,tags:i,type:a}=j.parse(t),o=this.#e.db.prepare(`SELECT m.rowid, m.* FROM memories m WHERE m.id = ?`).get(e);if(o===void 0)throw Error(`Memory not found: ${e}`);let s=new Date().toISOString(),c=[`updated_at = ?`],l=[s];if(r!==void 0&&(c.push(`content = ?`),l.push(r)),i!==void 0&&(c.push(`tags = ?`),l.push(JSON.stringify(i))),a!==void 0&&(c.push(`type = ?`),l.push(a)),l.push(e),this.#e.db.prepare(`UPDATE memories SET ${c.join(`, `)} WHERE id = ?`).run(...l),n!==void 0){let e=Buffer.from(n.buffer);this.#e.db.prepare(`UPDATE embeddings SET embedding = ? WHERE rowid = ?`).run(e,o.rowid)}let u=N.parse(this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(e)),d=this.#t.getProjectsForMemories([e]),f=this.#r([e]);return F(u,d.get(e)??[],f.get(e)??[])}delete(e){let t=this.#e.db.prepare(`SELECT rowid FROM memories WHERE id = ?`).get(e);t!==void 0&&this.#e.db.prepare(`DELETE FROM embeddings WHERE rowid = ?`).run(t.rowid),this.#e.db.prepare(`DELETE FROM memory_projects WHERE memory_id = ?`).run(e),this.#e.db.prepare(`DELETE FROM memories WHERE id = ?`).run(e)}list(e){let t=[],n=[];e?.type!==void 0&&(t.push(`m.type = ?`),n.push(e.type)),e?.pinned===!0&&t.push(`m.pinned = 1`),e?.needsReview===!0&&t.push(`EXISTS (SELECT 1 FROM memory_review_events e WHERE e.memory_id = m.id AND e.resolved_at IS NULL)`),e?.projectId===`global`?(t.push(`EXISTS (SELECT 1 FROM memory_projects mp JOIN projects p ON p.id = mp.project_id WHERE mp.memory_id = m.id AND p.scope_hash = ?)`),n.push(W)):e?.projectId!==void 0&&(t.push(`m.id IN (SELECT memory_id FROM memory_projects WHERE project_id = ?)`),n.push(e.projectId));let r=t.length>0?`WHERE ${t.join(` AND `)}`:``,i=this.#e.db.prepare(`SELECT m.* FROM memories m ${r} ORDER BY m.created_at DESC`).all(...n);if(i.length===0)return[];let a=i.map(e=>e.id),o=this.#t.getProjectsForMemories(a),s=this.#r(a);return i.map(e=>F(e,o.get(e.id)??[],s.get(e.id)??[]))}listPinnedGlobal(){return this.listPinnedForProject(W)}listPinnedForProject(e){return this.#e.db.prepare(`SELECT m.* FROM memories m
|
|
191
263
|
JOIN memory_projects mp ON mp.memory_id = m.id
|
|
192
264
|
JOIN projects p ON p.id = mp.project_id
|
|
193
|
-
WHERE p.scope_hash = ? AND m.pinned = 1`).all(e).map(e=>
|
|
265
|
+
WHERE p.scope_hash = ? AND m.pinned = 1`).all(e).map(e=>F(e,[]))}listFlagged(e){let t;if(t=e===void 0?this.#e.db.prepare(`SELECT * FROM memories
|
|
194
266
|
WHERE EXISTS (
|
|
195
267
|
SELECT 1 FROM memory_review_events e
|
|
196
268
|
WHERE e.memory_id = memories.id AND e.resolved_at IS NULL
|
|
@@ -201,45 +273,42 @@ CREATE INDEX IF NOT EXISTS idx_extraction_runs_status
|
|
|
201
273
|
WHERE e.memory_id = memories.id AND e.resolved_at IS NULL
|
|
202
274
|
)
|
|
203
275
|
AND ${this.#n()}
|
|
204
|
-
ORDER BY created_at DESC`).all(e),t.length===0)return[];let n=t.map(e=>e.id),r=this.#t.getProjectsForMemories(n),i=this.#r(n,{unresolvedOnly:!0});return t.map(e=>
|
|
276
|
+
ORDER BY created_at DESC`).all(e),t.length===0)return[];let n=t.map(e=>e.id),r=this.#t.getProjectsForMemories(n),i=this.#r(n,{unresolvedOnly:!0});return t.map(e=>F(e,r.get(e.id)??[],i.get(e.id)??[]))}listReviewEvents(e,t){let n=t?.unresolvedOnly===!0?`WHERE memory_id = ? AND resolved_at IS NULL`:`WHERE memory_id = ?`;return this.#e.db.prepare(`SELECT * FROM memory_review_events ${n} ORDER BY created_at DESC`).all(e).map(e=>I(O.parse(e)))}createReviewEvent(e){let n=new Date().toISOString();this.#e.db.prepare(`INSERT INTO memory_review_events
|
|
205
277
|
(id, memory_id, conflicting_memory_id, similarity, conflict_content_snapshot, reason, created_at)
|
|
206
|
-
VALUES (?, ?, ?, ?, ?, 'similarity_dedup', ?)`).run(
|
|
207
|
-
WHERE pinned = 1 AND ${this.#n()}`).get(e)??{total:0}).total}stats(e){let t=Object.fromEntries(
|
|
278
|
+
VALUES (?, ?, ?, ?, ?, 'similarity_dedup', ?)`).run(t(),e.memoryId,e.conflictingMemoryId,e.similarity,e.conflictContentSnapshot,n)}resolveReviewEvents(e){let t=new Date().toISOString();this.#e.db.prepare(`UPDATE memory_review_events SET resolved_at = ? WHERE memory_id = ? AND resolved_at IS NULL`).run(t,e)}getPinnedCharCount(e){return e===void 0?(this.#e.db.prepare(`SELECT COALESCE(SUM(LENGTH(content)), 0) as total FROM memories WHERE pinned = 1`).get()??{total:0}).total:(this.#e.db.prepare(`SELECT COALESCE(SUM(LENGTH(content)), 0) as total FROM memories
|
|
279
|
+
WHERE pinned = 1 AND ${this.#n()}`).get(e)??{total:0}).total}stats(e){let t=Object.fromEntries(S.map(e=>[e,0]));if(e!==void 0){let n=this.#e.db.prepare(`SELECT type, COUNT(*) as count FROM memories
|
|
208
280
|
WHERE ${this.#n()}
|
|
209
|
-
GROUP BY type`).all(e);for(let e of n){let n=
|
|
281
|
+
GROUP BY type`).all(e);for(let e of n){let n=C.safeParse(e.type);n.success&&(t[n.data]=e.count)}let r=this.#e.db.prepare(`SELECT COUNT(*) as total, SUM(pinned) as pinned,
|
|
210
282
|
COALESCE(SUM(CASE WHEN pinned = 1 THEN LENGTH(content) ELSE 0 END), 0) as pinBudgetChars
|
|
211
283
|
FROM memories WHERE ${this.#n()}`).get(e)??{total:0,pinned:0,pinBudgetChars:0},i=this.#e.db.prepare(`SELECT COUNT(DISTINCT e.memory_id) as needsReview
|
|
212
284
|
FROM memory_review_events e
|
|
213
285
|
JOIN memories m ON m.id = e.memory_id
|
|
214
286
|
WHERE e.resolved_at IS NULL
|
|
215
|
-
AND ${this.#n(`m`)}`).get(e)??{needsReview:0};return{byType:t,total:r.total,pinned:r.pinned??0,needsReview:i.needsReview,pinBudgetChars:r.pinBudgetChars}}let n=this.#e.db.prepare(`SELECT type, COUNT(*) as count FROM memories GROUP BY type`).all();for(let e of n){let n=
|
|
216
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`),n=this.#e.db.prepare(`INSERT OR REPLACE INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`);this.#e.db.transaction(()=>{for(let r of e)t.run(r.id,r.content,r.type,JSON.stringify(r.tags),r.sourceHarness,r.accessCount,+!!r.pinned,r.createdAt,r.updatedAt),r.embedding!==null&&n.run(Buffer.from(r.embedding.buffer,r.embedding.byteOffset,r.embedding.byteLength),r.id)})()}#n(e=`memories`){return`
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
))`}#r(e,t){if(e.length===0)return new Map;let n=e.map(()=>`?`).join(`, `),r=t?.unresolvedOnly===!0?`AND resolved_at IS NULL`:``,i=this.#e.db.prepare(`SELECT * FROM memory_review_events
|
|
287
|
+
AND ${this.#n(`m`)}`).get(e)??{needsReview:0};return{byType:t,total:r.total,pinned:r.pinned??0,needsReview:i.needsReview,pinBudgetChars:r.pinBudgetChars}}let n=this.#e.db.prepare(`SELECT type, COUNT(*) as count FROM memories GROUP BY type`).all();for(let e of n){let n=C.safeParse(e.type);n.success&&(t[n.data]=e.count)}let r=this.#e.db.prepare(`SELECT COUNT(*) as total, SUM(pinned) as pinned FROM memories`).get()??{total:0,pinned:0},i=this.#e.db.prepare(`SELECT COUNT(DISTINCT memory_id) as needsReview FROM memory_review_events WHERE resolved_at IS NULL`).get()??{needsReview:0};return{byType:t,total:r.total,pinned:r.pinned??0,needsReview:i.needsReview,pinBudgetChars:this.getPinnedCharCount()}}setPin(e,t){if(this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(e)===void 0)throw Error(`Memory not found: ${e}`);let n=new Date().toISOString();this.#e.db.prepare(`UPDATE memories SET pinned = ?, updated_at = ? WHERE id = ?`).run(+!!t,n,e);let r=N.parse(this.#e.db.prepare(`SELECT * FROM memories WHERE id = ?`).get(e)),i=this.#t.getProjectsForMemories([e]),a=this.#r([e]);return F(r,i.get(e)??[],a.get(e)??[])}incrementAccessCount(e){this.#e.db.prepare(`UPDATE memories SET access_count = access_count + 1 WHERE id = ?`).run(e)}exportAll(){return this.#e.db.prepare(`SELECT m.*, e.embedding FROM memories m LEFT JOIN embeddings e ON e.rowid = m.rowid ORDER BY m.created_at DESC`).all().map(e=>({id:e.id,content:e.content,type:C.parse(e.type),tags:w.parse(JSON.parse(e.tags)),sourceHarness:e.source,accessCount:e.access_count,pinned:e.pinned!==0,createdAt:e.created_at,updatedAt:e.updated_at,embedding:e.embedding===null?null:new Float32Array(e.embedding.buffer,e.embedding.byteOffset,e.embedding.byteLength/4)}))}importAll(e){let t=this.#e.db.prepare(`INSERT OR REPLACE INTO memories (id, content, type, tags, source, access_count, pinned, created_at, updated_at)
|
|
288
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`),n=this.#e.db.prepare(`INSERT OR REPLACE INTO embeddings (rowid, embedding) SELECT m.rowid, ? FROM memories m WHERE m.id = ?`);this.#e.db.transaction(()=>{for(let r of e)t.run(r.id,r.content,r.type,JSON.stringify(r.tags),r.sourceHarness,r.accessCount,+!!r.pinned,r.createdAt,r.updatedAt),r.embedding!==null&&n.run(Buffer.from(r.embedding.buffer,r.embedding.byteOffset,r.embedding.byteLength),r.id)})()}#n(e=`memories`){return`EXISTS (
|
|
289
|
+
SELECT 1 FROM memory_projects mp JOIN projects p ON p.id = mp.project_id
|
|
290
|
+
WHERE mp.memory_id = ${e}.id AND (p.scope_hash = ? OR p.scope_hash = '${W}')
|
|
291
|
+
)`}#r(e,t){if(e.length===0)return new Map;let n=e.map(()=>`?`).join(`, `),r=t?.unresolvedOnly===!0?`AND resolved_at IS NULL`:``,i=this.#e.db.prepare(`SELECT * FROM memory_review_events
|
|
221
292
|
WHERE memory_id IN (${n}) ${r}
|
|
222
|
-
ORDER BY created_at DESC`).all(...e),a=new Map;for(let e of i){let t=
|
|
293
|
+
ORDER BY created_at DESC`).all(...e),a=new Map;for(let e of i){let t=I(O.parse(e)),n=a.get(t.memoryId)??[];n.push(t),a.set(t.memoryId,n)}return a}};function Fe(e,t){return new q(e,t)}const J=ne(te);function Y(t){return e(`sha256`).update(t).digest(`hex`).slice(0,16)}async function X(){try{let{stdout:e}=await J(`git`,[`remote`,`get-url`,`origin`]),t=e.trim();if(t){let e=Y(t);return{hash:e,name:t.split(`/`).pop()?.replace(/\.git$/,``)??e.slice(0,8)}}}catch{}let e=process.cwd(),t=Y(e);return{hash:t,name:e.split(/[/\\]/).filter(Boolean).pop()??t.slice(0,8)}}async function Ie(){try{let{stdout:e}=await J(`git`,[`remote`,`get-url`,`origin`]),t=e.trim();if(t)return Y(t)}catch{}return Y(process.cwd())}const Le=[{name:`scope-to-projects`,description:`Rename the auto-migrated project for the current directory from its generic hash-derived name to the resolved repo/directory name.`}];async function Re(e){let t=await X(),n=e.getByHash(t.hash);if(n===void 0)return null;let r=n.name,i=e.countMemories(n.id);return e.rename(n.id,t.name),{migration:`scope-to-projects`,oldName:r,newName:t.name,memoryCount:i}}var ze=class{#e;constructor(e){this.#e=e}upsertByHash(e,n){if(!/^[0-9a-f]{16}$/.test(e))throw Error(`Invalid scope hash "${e}": expected 16 lowercase hex characters`);let r=new Date().toISOString(),i=e===`0000000000000000`?U:t(),a=e===`0000000000000000`?G:n;return this.#e.db.prepare(`INSERT OR IGNORE INTO projects (id, name, scope_hash, created_at, updated_at) VALUES (?, ?, ?, ?, ?)`).run(i,a,e,r,r),L(P.parse(this.#e.db.prepare(`SELECT * FROM projects WHERE scope_hash = ?`).get(e)))}rename(e,t){let n=new Date().toISOString();this.#e.db.prepare(`UPDATE projects SET name = ?, updated_at = ? WHERE id = ?`).run(t,n,e);let r=this.#e.db.prepare(`SELECT * FROM projects WHERE id = ?`).get(e);if(r===void 0)throw Error(`Project not found: ${e}`);return L(r)}list(){return this.#e.db.prepare(`SELECT * FROM projects ORDER BY name ASC`).all().map(L)}getByHash(e){let t=this.#e.db.prepare(`SELECT * FROM projects WHERE scope_hash = ?`).get(e);return t===void 0?void 0:L(t)}getByName(e){let t=this.#e.db.prepare(`SELECT * FROM projects WHERE name = ? LIMIT 1`).get(e);return t===void 0?void 0:L(t)}addAssociation(e,t){this.#e.db.prepare(`INSERT OR IGNORE INTO memory_projects (memory_id, project_id) VALUES (?, ?)`).run(e,t)}removeAssociation(e,t){this.#e.db.prepare(`DELETE FROM memory_projects WHERE memory_id = ? AND project_id = ?`).run(e,t)}countMemories(e){return this.#e.db.prepare(`SELECT COUNT(*) AS count FROM memory_projects WHERE project_id = ?`).get(e)?.count??0}getProjectsForMemories(e){if(e.length===0)return new Map;let t=e.map(()=>`?`).join(`,`),n=this.#e.db.prepare(`SELECT p.*, mp.memory_id FROM projects p
|
|
223
294
|
JOIN memory_projects mp ON mp.project_id = p.id
|
|
224
|
-
WHERE mp.memory_id IN (${t})`).all(...e),r=new Map;for(let e of n){let t=r.get(e.memory_id)??[];t.push(
|
|
295
|
+
WHERE mp.memory_id IN (${t})`).all(...e),r=new Map;for(let e of n){let t=r.get(e.memory_id)??[];t.push(L(e)),r.set(e.memory_id,t)}return r}};function Be(e){return new ze(e)}const Ve={correction:1,preference:.8,decision:.6,learning:.4,fact:.2};function He(e,t,n){let r=Ve[e.type],i=e.accessCount/(e.accessCount+10),a=1/(1+(n-new Date(e.updatedAt).getTime())/864e5),o=+!!e.pinned;return t*.4+r*.25+i*.2+a*.1+o*.05}async function Z(e,t){let{query:n,type:r,projectHash:i,limit:a=10,includePinned:o}=A.parse(e),{activityLogger:s=x}=t,c=await t.embedder.embed(n),l=Buffer.from(c.buffer),u=t.adapter.findByEmbedding(l,{type:r,projectHash:i,includePinned:o}),d=Date.now(),f=u.filter(e=>e.cosineSim>0).map(e=>{let{cosineSim:t,...n}=e;return{...n,score:He(n,t,d)}});f.sort((e,t)=>t.score-e.score);let p=f.slice(0,a);for(let e of p)t.repo.incrementAccessCount(e.id);return s.logEvent({projectHash:i??`0000000000000000`,eventType:`memory.queried`,payload:{resultCount:p.length,topScores:p.slice(0,3).map(e=>e.score)}}),p}var Ue=class{#e;constructor(e){this.#e=e}findByEmbedding(e,t){let{type:n,projectHash:r,includePinned:i}=t,a=[],o=[e],s=``;i||a.push(`m.pinned = 0`),n!==void 0&&(a.push(`m.type = ?`),o.push(n)),r!==void 0&&(s=`JOIN memory_projects mp ON mp.memory_id = m.id JOIN projects p ON p.id = mp.project_id`,a.push(`(p.scope_hash = ? OR p.scope_hash = ?)`),o.push(r,W));let c=a.length>0?`WHERE ${a.join(` AND `)}`:``,l=`
|
|
225
296
|
SELECT m.*, (1 - vec_distance_cosine(e.embedding, ?)) AS cosine_sim
|
|
226
297
|
FROM memories m JOIN embeddings e ON e.rowid = m.rowid
|
|
227
298
|
${s}
|
|
228
299
|
${c}
|
|
229
|
-
`;return this.#e.db.prepare(l).all(...o).map(e=>({...
|
|
300
|
+
`;return this.#e.db.prepare(l).all(...o).map(e=>({...F(e,[]),cosineSim:e.cosine_sim}))}},We=class{#e;#t;#n;#r;constructor(e,t,n,r=x){this.#e=e,this.#t=t,this.#n=n,this.#r=r}async query(e){return Z(e,{adapter:new Ue(this.#e),repo:this.#n,embedder:this.#t,activityLogger:this.#r})}};function Q(e,t){let n=t.repo.stats(e.projectHash);return e.synthesis!==void 0&&e.synthesis.length>0?{stats:n.byType,pinnedGlobal:[],pinnedProject:[],synthesis:e.synthesis}:{stats:n.byType,pinnedGlobal:t.repo.listPinnedGlobal(),pinnedProject:t.repo.listPinnedForProject(e.projectHash)}}function Ge(){return[...S]}var Ke=class{#e;constructor(e){this.#e=e}getSessionContext(e,t){return Q({projectHash:e,synthesis:t},{repo:this.#e})}},qe=class{#e;#t;#n;#r=new Set;#i=new Map;#a=!1;#o;#s=new Map;constructor(e,t,n){this.#e=e,this.#t=t,this.#n=n}async init(){this.#e.clearStaleInFlight(this.#t.inFlightTimeoutMs??12e4),this.#e.expireStale();let e=this.#e.getExpiredOrDirtyScopes();for(let{scope:t}of e)this.#r.add(t);this.#a=!0,await this.#l()}shutdown(){this.#a=!1,this.#o!==void 0&&(clearTimeout(this.#o),this.#o=void 0);let e=[...this.#s.values()];return e.length===0?Promise.resolve():Promise.race([Promise.allSettled(e).then(()=>void 0),new Promise(e=>setTimeout(e,5e3))])}markDirty(e){this.#r.add(e)}#c(){if(!this.#a)return;let e=this.#t.debounceMs??45e3;this.#o=setTimeout(()=>{this.#l()},e)}async#l(){let e=[...this.#r];for(let t of e){let e=this.#t.inFlightTimeoutMs??12e4,n=this.#e.getSynthesis(t);if(n?.inFlightSince!==null&&n?.inFlightSince!==void 0){if(Date.now()-new Date(n.inFlightSince).getTime()<e)continue;this.#e.clearInFlight(t)}this.#r.delete(t);let r=this.#u(t).finally(()=>{this.#s.delete(t)});this.#s.set(t,r)}this.#c()}async#u(e){this.#e.markInFlight(e);try{let t=e===`0000000000000000`?void 0:e,n=await this.#n.run(e,t),r=this.#e.computeSourceMemoryHash(e);this.#e.saveSynthesis(e,n,r),this.#i.delete(e)}catch(t){let n=(this.#i.get(e)??0)+1;this.#i.set(e,n);let r=Math.min(n,5),i=(this.#t.debounceMs??45e3)*r;process.stderr.write(`membank synthesis: error for scope=${e} failures=${n} backoff=${i}ms: ${t instanceof Error?t.message:String(t)}\n`),setTimeout(()=>{this.#r.add(e)},i),this.#e.clearInFlight(e)}}};async function Je(e,t){let n=e===`0000000000000000`?void 0:e;t.synthRepo.markInFlight(e);try{let[r,i]=await Promise.all([t.agentRunner.run(e,n),Promise.resolve(t.synthRepo.computeSourceMemoryHash(e))]);return t.synthRepo.saveSynthesis(e,r,i),r}catch(n){throw t.synthRepo.clearInFlight(e),n}}var Ye=class{#e;constructor(e,t){this.#e=e}async run(e,t){let r=m({name:`membank-synthesis-tools`,version:`1.0.0`,tools:[g(`query_memory`,`Search memories by semantic similarity`,{query:n.string().describe(`Search text`),limit:n.number().optional().describe(`Maximum results to return`),global:n.boolean().optional().describe(`Query global memories only when true, otherwise current project scope`)},async({query:e,limit:n,global:r})=>({content:[{type:`text`,text:await this.#e.queryMemory({query:e,limit:n,global:r,projectHash:t})}]}),{annotations:{readOnlyHint:!0}}),g(`get_memory_summary`,`Returns aggregate stats: total memories, counts by type, pinned count, review queue size`,{},async()=>({content:[{type:`text`,text:await this.#e.getMemorySummary()}]}),{annotations:{readOnlyHint:!0}})]}),i=`Synthesize the memories for ${e===`0000000000000000`?`global (across all projects)`:`project scope: ${e}`}. Use get_memory_summary first to understand the overall state, then use query_memory to retrieve relevant memories (query with broad terms like "preferences", "corrections", "decisions", "key facts"). After gathering information, produce a concise synthesis of the most important things to remember about this user. Output only the synthesis text — no preamble, no metadata.`,a=Date.now(),o=Object.fromEntries(Object.entries(process.env).filter(e=>e[1]!==void 0)),s=h({prompt:i,options:{model:`claude-haiku-4-5-20251001`,systemPrompt:`You are a memory synthesizer. Your job is to read the user's stored memories and produce a concise, well-structured summary of what's most important to remember about this user — their preferences, corrections, decisions, and key facts. Pinned memories are higher fidelity and should be weighted more heavily. Exclude transient or ephemeral details. Output plain text suitable for injection into an LLM context window. Be concise — target 200-400 words.`,mcpServers:{"membank-synthesis-tools":r},allowedTools:[`mcp__membank-synthesis-tools__query_memory`,`mcp__membank-synthesis-tools__get_memory_summary`],disallowedTools:[`mcp__membank__*`],settingSources:[],permissionMode:`bypassPermissions`,env:o}}),c=``;for await(let e of s)if(e.type===`result`)if(e.subtype===`success`)c=e.result;else{let t=`errors`in e&&Array.isArray(e.errors)?`: ${e.errors.join(`; `)}`:``;throw Error(`Synthesis agent failed: ${e.subtype}${t}`)}let l=Date.now()-a;if(process.stderr.write(`membank synthesis: scope=${e} duration=${l}ms\n`),c===``)throw Error(`Synthesis agent returned empty result`);return c}};function Xe(e,t){return new Ye(e,t)}function $(e){return M.parse({id:e.id,scope:e.scope,content:e.content,sourceMemoryHash:e.source_memory_hash,synthesizedAt:e.synthesized_at,expiresAt:e.expires_at,inFlightSince:e.in_flight_since,createdAt:e.created_at,updatedAt:e.updated_at})}var Ze=class{#e;constructor(e){this.#e=e}saveSynthesis(e,n,r){let i=new Date().toISOString(),a=new Date(Date.now()+720*60*60*1e3).toISOString();if(this.#e.db.prepare(`SELECT id FROM syntheses WHERE scope = ?`).get(e)!==void 0)this.#e.db.prepare(`UPDATE syntheses
|
|
230
301
|
SET content = ?, source_memory_hash = ?, synthesized_at = ?, expires_at = ?,
|
|
231
302
|
in_flight_since = NULL, updated_at = ?
|
|
232
|
-
WHERE scope = ?`).run(
|
|
303
|
+
WHERE scope = ?`).run(n,r,i,a,i,e);else{let o=t();this.#e.db.prepare(`INSERT INTO syntheses
|
|
233
304
|
(id, scope, content, source_memory_hash, synthesized_at, expires_at,
|
|
234
305
|
in_flight_since, created_at, updated_at)
|
|
235
|
-
VALUES (?, ?, ?, ?, ?, ?, NULL, ?, ?)`).run(
|
|
306
|
+
VALUES (?, ?, ?, ?, ?, ?, NULL, ?, ?)`).run(o,e,n,r,i,a,i,i)}let o=this.#e.db.prepare(`SELECT * FROM syntheses WHERE scope = ?`).get(e);if(o===void 0)throw Error(`Failed to save synthesis for scope: ${e}`);return $(o)}getSynthesis(e){let t=this.#e.db.prepare(`SELECT * FROM syntheses WHERE scope = ?`).get(e);return t===void 0?void 0:$(t)}listAll(){return this.#e.db.prepare(`SELECT * FROM syntheses ORDER BY scope`).all().map($)}markInFlight(e){let n=new Date().toISOString();if(this.#e.db.prepare(`SELECT id FROM syntheses WHERE scope = ?`).get(e)!==void 0)this.#e.db.prepare(`UPDATE syntheses SET in_flight_since = ?, updated_at = ? WHERE scope = ?`).run(n,n,e);else{let r=t(),i=new Date(Date.now()+720*60*60*1e3).toISOString();this.#e.db.prepare(`INSERT INTO syntheses
|
|
236
307
|
(id, scope, content, source_memory_hash, synthesized_at, expires_at,
|
|
237
308
|
in_flight_since, created_at, updated_at)
|
|
238
|
-
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
WHERE p.scope_hash = ?
|
|
244
|
-
ORDER BY m.id`).all(e),h(`sha256`).update(JSON.stringify(t.map(e=>e.content))).digest(`hex`)}getExpiredOrDirtyScopes(){let e=this.getAllActiveScopes(),t=new Date().toISOString(),n=[];for(let r of e){let e=this.#e.db.prepare(`SELECT * FROM syntheses WHERE scope = ?`).get(r);if(e===void 0||e.content===`pending`&&e.source_memory_hash===``){n.push({scope:r,reason:`missing`});continue}if(e.expires_at<=t){n.push({scope:r,reason:`expired`});continue}this.computeSourceMemoryHash(r)!==e.source_memory_hash&&n.push({scope:r,reason:`dirty`})}return n}getAllActiveScopes(){return[`global`,...this.#e.db.prepare(`SELECT DISTINCT scope_hash FROM projects`).all().map(e=>e.scope_hash)]}expireStale(){let e=new Date().toISOString();this.#e.db.prepare(`DELETE FROM syntheses WHERE expires_at < ?`).run(e)}};function ze(e){return new Re(e)}export{F as DatabaseError,ce as DatabaseManager,B as EmbeddingService,_ as MEMORY_TYPE_VALUES,we as MIGRATIONS,I as MODEL_NAME,P as MembankError,D as MemoryPatchSchema,k as MemoryRowSchema,w as MemorySchema,v as MemoryTypeSchema,L as ModelDownloadError,z as ModelDownloader,K as PIN_BUDGET_THRESHOLD,A as ProjectRowSchema,b as ProjectSchema,je as QueryEngine,T as QueryOptionsSchema,C as ReviewEventRowSchema,S as ReviewEventSchema,x as ReviewReasonSchema,E as SaveOptionsSchema,Ne as SessionContextBuilder,ae as SessionContextSchema,q as SqliteMemoryRepository,Pe as SynthesisEngine,O as SynthesisSchema,y as TagsJsonSchema,ge as createClaudeCodeTranscriptReader,W as createExtractionAgentRunner,pe as createExtractionRunRepository,Se as createMemoryRepository,De as createProjectRepository,Le as createSynthesisAgentRunner,ze as createSynthesisRepository,_e as deleteMemory,Q as getSessionContext,xe as isOverBudget,ie as isSynthesisEnabled,Me as listMemoryTypes,Z as queryMemories,X as resolveProject,ve as resolveReview,Ce as resolveScope,j as rowToMemory,N as rowToProject,V as runExtraction,Te as runScopeToProjectsMigration,Fe as runSynthesis,ye as saveMemory,be as updateMemory};
|
|
309
|
+
VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(r,e,`pending`,``,n,i,n,n,n)}}clearInFlight(e){let t=new Date().toISOString();this.#e.db.prepare(`UPDATE syntheses SET in_flight_since = NULL, updated_at = ? WHERE scope = ?`).run(t,e)}clearStaleInFlight(e){let t=new Date(Date.now()-e).toISOString(),n=new Date().toISOString();this.#e.db.prepare(`UPDATE syntheses SET in_flight_since = NULL, updated_at = ? WHERE in_flight_since IS NOT NULL AND in_flight_since < ?`).run(n,t)}computeSourceMemoryHash(t){let n=this.#e.db.prepare(`SELECT m.content FROM memories m
|
|
310
|
+
JOIN memory_projects mp ON mp.memory_id = m.id
|
|
311
|
+
JOIN projects p ON p.id = mp.project_id
|
|
312
|
+
WHERE p.scope_hash = ?
|
|
313
|
+
ORDER BY m.id`).all(t);return e(`sha256`).update(JSON.stringify(n.map(e=>e.content))).digest(`hex`)}getExpiredOrDirtyScopes(){let e=this.getAllActiveScopes(),t=new Date().toISOString(),n=[];for(let r of e){let e=this.#e.db.prepare(`SELECT * FROM syntheses WHERE scope = ?`).get(r);if(e===void 0||e.content===`pending`&&e.source_memory_hash===``){n.push({scope:r,reason:`missing`});continue}if(e.expires_at<=t){n.push({scope:r,reason:`expired`});continue}this.computeSourceMemoryHash(r)!==e.source_memory_hash&&n.push({scope:r,reason:`dirty`})}return n}getAllActiveScopes(){return this.#e.db.prepare(`SELECT DISTINCT scope_hash FROM projects`).all().map(e=>e.scope_hash)}expireStale(){let e=new Date().toISOString();this.#e.db.prepare(`DELETE FROM syntheses WHERE expires_at < ?`).run(e)}};function Qe(e){return new Ze(e)}export{_ as ACTIVITY_EVENT_TYPE_VALUES,v as ActivityEventTypeSchema,z as DatabaseError,me as DatabaseManager,_e as EmbeddingService,U as GLOBAL_PROJECT_ID,G as GLOBAL_PROJECT_NAME,W as GLOBAL_SCOPE_HASH,S as MEMORY_TYPE_VALUES,Le as MIGRATIONS,B as MODEL_NAME,R as MembankError,j as MemoryPatchSchema,N as MemoryRowSchema,k as MemorySchema,C as MemoryTypeSchema,V as ModelDownloadError,ge as ModelDownloader,K as PIN_BUDGET_THRESHOLD,P as ProjectRowSchema,T as ProjectSchema,We as QueryEngine,A as QueryOptionsSchema,ie as RETENTION_DAYS,O as ReviewEventRowSchema,D as ReviewEventSchema,E as ReviewReasonSchema,ue as SaveOptionsSchema,Ke as SessionContextBuilder,de as SessionContextSchema,q as SqliteMemoryRepository,qe as SynthesisEngine,M as SynthesisSchema,w as TagsJsonSchema,se as createActivityLogger,oe as createActivityRepository,Oe as createClaudeCodeTranscriptReader,xe as createExtractionAgentRunner,Te as createExtractionRunRepository,Fe as createMemoryRepository,Be as createProjectRepository,Xe as createSynthesisAgentRunner,Qe as createSynthesisRepository,ke as deleteMemory,Q as getSessionContext,Pe as isOverBudget,le as isSynthesisEnabled,re as listEvents,Ge as listMemoryTypes,y as logEvent,x as noopActivityLogger,Z as queryMemories,X as resolveProject,Ae as resolveReview,Ie as resolveScope,F as rowToMemory,L as rowToProject,ve as runExtraction,Re as runScopeToProjectsMigration,Je as runSynthesis,Me as saveMemory,Ne as updateMemory};
|
|
245
314
|
//# sourceMappingURL=index.mjs.map
|