![\"DARKSOL](\"https://raw.githubusercontent.com/darks0l/remem-v2/main/assets/darksol-banner.png\")
\n\n \n
\n\n[](https://www.npmjs.com/package/@darksol/remem-v2)\n[](https://opensource.org/licenses/MIT)\n[](https://nodejs.org/)\n\n\n
\n\n> The stripped-down ReMEM core: scoped memory planning, recall, extraction, graph expansion, and bounded context assembly for agents.\n\nReMEM v2 is the clean rebuild lane.\n\nInstead of one giant memory class doing everything, this package focuses on the actual product center:\n\n- intake before storage\n- extraction before prompt bloat\n- graph-aware recursive recall\n- scoped execution for tenant/session-aware memory work\n- bounded context assembly\n- composable repositories and pipelines\n\n## Install\n\n```bash\nnpm install @darksol/remem-v2\n```\n\n## Quick Start\n\n```ts\nimport { randomUUID } from 'node:crypto';\nimport {\n buildBoundedContextPacket,\n computeSmartRecallV2,\n createMemoryPipeline,\n executeRecallPlan,\n executeExtractionRequest,\n expandGraphRecall,\n planRecall,\n type Extractor,\n type IntakePolicy,\n type MemoryRepository,\n type SmartRecallCollectors,\n} from '@darksol/remem-v2';\n\nconst repository: MemoryRepository = {\n async store(record) {\n return {\n id: randomUUID(),\n ...record,\n createdAt: Date.now(),\n updatedAt: Date.now(),\n };\n },\n async createLink(link) {\n return { id: randomUUID(), ...link, createdAt: Date.now() };\n },\n async findRecent() {\n return [];\n },\n async search() {\n return [];\n },\n async getLinksFor() {\n return [];\n },\n};\n\nconst intakePolicy: IntakePolicy = {\n async evaluate(candidate) {\n return {\n accepted: candidate.content.length > 24,\n kind: 'fact',\n score: 0.72,\n threshold: 0.58,\n reason: 'Sufficient signal for storage',\n layerHint: 'semantic',\n };\n },\n};\n\nconst extractor: Extractor = {\n async extract(request) {\n return {\n query: request.query,\n summary: 'No extraction sources wired yet.',\n items: [],\n links: [],\n usedChars: 0,\n truncated: false,\n };\n },\n};\n\nconst pipeline = createMemoryPipeline({ repository, intakePolicy, extractor });\n\nawait pipeline.ingest({\n content: 'We decided to rebuild ReMEM around intake and extraction.',\n topics: ['roadmap', 'memory'],\n source: 'operator',\n});\n\nconst collectors: SmartRecallCollectors = {\n async query(query) {\n return { query, results: [], totalAvailable: 0, tookMs: 0 };\n },\n async graph(query) {\n return { query, results: [], totalAvailable: 0, tookMs: 0, linksTraversed: 0 };\n },\n procedural() {\n return [];\n },\n async recent() {\n return [];\n },\n proceduralToQueryResult(match) {\n return match.entry;\n },\n};\n\nconst recall = await computeSmartRecallV2('What matters right now?', {\n profile: 'agent-safe',\n limit: 8,\n}, collectors);\n\nconst plan = planRecall({\n query: 'What matters right now?',\n profile: 'agent-safe',\n topics: ['memory', 'roadmap'],\n scope: {\n namespace: ['tenant', 'memory'],\n tenantId: 'tenant-core',\n sessionId: 'session-1',\n },\n});\n\nconst packet = buildBoundedContextPacket(\n [\n {\n key: 'summary',\n title: 'Summary',\n body: 'ReMEM v2 keeps intake, recall, and context assembly as explicit seams.',\n required: true,\n priority: 10,\n },\n {\n key: 'results',\n title: 'Recall Results',\n body: recall.results.map((item) => `- ${item.content}`).join('\\n'),\n priority: 7,\n metadata: { laneCount: recall.results.length },\n },\n ],\n {\n query: 'What matters right now?',\n maxChars: 320,\n includeSectionMetadata: true,\n }\n);\n\nconsole.log(packet.text);\nconsole.log(plan.lanePlans);\n\nconst graphExpansion = expandGraphRecall(recall.results, recall.results, [], {\n hops: 1,\n limit: 4,\n minScore: 0.2,\n});\n\nconsole.log(graphExpansion.paths);\n\nconst executed = await executeRecallPlan(plan, collectors);\nconsole.log(executed.packet.text);\n\nconst extracted = await executeExtractionRequest({\n query: 'Summarize active memory',\n profile: 'agent-safe',\n scope: {\n namespace: ['tenant', 'memory'],\n tenantId: 'tenant-core',\n sessionId: 'session-1',\n },\n includeMetadata: true,\n}, collectors);\n\nconsole.log(extracted.extraction.summary);\n```\n\n## What This Package Is\n\nThis package is the v2 engine seam, not the whole legacy surface.\n\nGood fit:\n\n- building a custom agent memory engine\n- implementing durable intake/extraction flows\n- running tenant- or session-aware recall and extraction work\n- swapping repositories without rewriting orchestration\n- treating graph recall as a first-class memory primitive\n\nNot the goal:\n\n- shipping setup wizards\n- bundling HTTP servers\n- carrying every legacy ReMEM concern forever\n\n## Status\n\n`0.2.0` is the current release cut.\n\nIt already gives you:\n\n- memory contracts\n- ingestion pipelines\n- recall planning\n- smart recall fusion\n- recall plan execution\n- scoped execution contracts\n- extraction execution over the same planner/runtime spine\n- bounded context packet assembly\n- graph expansion helpers\n- packed artifact verification\n\nNext up:\n\n- direct reuse as the engine under `@darksol/remem`\n\nBuilt with teeth.\n","readmeFilename":"README.md"}