{"_id":"@atomicmemory/sdk","_rev":"6-a528d378ff7ae56469d72f7c0a48f6da","name":"@atomicmemory/sdk","dist-tags":{"latest":"1.1.1"},"versions":{"1.0.0":{"name":"@atomicmemory/sdk","version":"1.0.0","keywords":["memory","embeddings","semantic-search","rag","vector-search","llm","ai-memory"],"author":{"name":"AtomicMemory","email":"support@atomicstrata.ai"},"license":"Apache-2.0","_id":"@atomicmemory/sdk@1.0.0","maintainers":[{"name":"atomicstrata","email":"services@atomicstrata.ai"}],"homepage":"https://github.com/atomicstrata/atomicmemory-sdk#readme","bugs":{"url":"https://github.com/atomicstrata/atomicmemory-sdk/issues"},"dist":{"shasum":"a42cbd8e048a60518a38d4fa8b6c8aae33e9e173","tarball":"https://registry.npmjs.org/@atomicmemory/sdk/-/sdk-1.0.0.tgz","fileCount":132,"integrity":"sha512-16NoF+9NpPTONYFVPX8Am40wCK6vFVYNEEVFoRqciDOOG32VnPr6eVzJ/YzA8OXF7sWZ8XyikCUCPn94xnPnHg==","signatures":[{"sig":"MEUCIFoabX30qZ4OPlbCceTw50TBqbZmDCTHj1drZ0PissnbAiEA/UGw+dqZjsj3idbdDKlFPP763aKhc6YG1qqvGfP+jvs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2499361},"main":"dist/index.cjs","pnpm":{"overrides":{"protobufjs":"7.5.6","@protobufjs/utf8":"1.1.1"}},"type":"module","types":"dist/index.d.ts","module":"dist/index.js","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.cjs"},"./core":{"types":"./dist/core.d.ts","import":"./dist/core.js","default":"./dist/core.js","require":"./dist/core.cjs"},"./utils":{"types":"./dist/utils.d.ts","import":"./dist/utils.js","default":"./dist/utils.js","require":"./dist/utils.cjs"},"./memory":{"types":"./dist/memory.d.ts","import":"./dist/memory.js","default":"./dist/memory.js","require":"./dist/memory.cjs"},"./search":{"types":"./dist/search.d.ts","import":"./dist/search.js","default":"./dist/search.js","require":"./dist/search.cjs"},"./browser":{"types":"./dist/browser.d.ts","import":"./dist/browser.js","default":"./dist/browser.js","require":"./dist/browser.cjs"},"./storage":{"types":"./dist/storage.d.ts","import":"./dist/storage.js","default":"./dist/storage.js","require":"./dist/storage.cjs"},"./kv-cache":{"types":"./dist/kv-cache.d.ts","import":"./dist/kv-cache.js","default":"./dist/kv-cache.js","require":"./dist/kv-cache.cjs"},"./embedding":{"types":"./dist/embedding.d.ts","import":"./dist/embedding.js","default":"./dist/embedding.js","require":"./dist/embedding.cjs"},"./package.json":"./package.json"},"gitHead":"9dcafb43cf91bd2899102c57a635de4a50431f06","scripts":{"dev":"tsup --watch","lint":"eslint src/**/*.ts","test":"vitest run","build":"tsup","clean":"rm -rf dist coverage .tsup","format":"prettier --write src/**/*.ts","prepare":"husky","lint:fix":"eslint src/**/*.ts --fix","build:dev":"tsup --watch","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.scripts.json","test:watch":"vitest","format:check":"prettier --check src/**/*.ts","test:coverage":"vitest run --coverage","fixtures:capture":"tsx scripts/capture-fixtures.ts","typecheck:scripts":"tsc --noEmit -p tsconfig.scripts.json"},"_npmUser":{"name":"atomicstrata","email":"services@atomicstrata.ai"},"repository":{"url":"git+https://github.com/atomicstrata/atomicmemory-sdk.git","type":"git"},"_npmVersion":"11.14.1","description":"Backend-agnostic memory-layer SDK with pluggable providers (AtomicMemory, Mem0), local embeddings, storage adapters, and semantic search. Apache-2.0 licensed OSS core.","directories":{},"sideEffects":["**/transformers-env-config*"],"_nodeVersion":"25.9.0","dependencies":{"@huggingface/transformers":"^3.7.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","tsup":"^8.5.0","vite":"^7.3.3","husky":"^9.1.7","jsdom":"^27.0.0","vitest":"^4.1.6","prettier":"^3.4.2","typescript":"^5.8.3","@types/node":"^24.6.2","@types/chrome":"^0.1.19","@vitest/coverage-v8":"^4.1.6","@vitest/coverage-istanbul":"^4.1.6"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.0_1778663740273_0.4264564497858325","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@atomicmemory/sdk","version":"1.0.1","keywords":["memory","embeddings","semantic-search","rag","vector-search","llm","ai-memory"],"author":{"name":"AtomicMemory","email":"support@atomicstrata.ai"},"license":"Apache-2.0","_id":"@atomicmemory/sdk@1.0.1","maintainers":[{"name":"atomicstrata","email":"services@atomicstrata.ai"}],"homepage":"https://github.com/atomicstrata/atomicmemory-sdk#readme","bugs":{"url":"https://github.com/atomicstrata/atomicmemory-sdk/issues"},"dist":{"shasum":"95ebb8aa7776a108a1284ba24625a0cc6c42ff5e","tarball":"https://registry.npmjs.org/@atomicmemory/sdk/-/sdk-1.0.1.tgz","fileCount":132,"integrity":"sha512-IfttcyV+XoS9+2gj8eNg6jOA0c+vaXTOjdiMa75uBYcPr9oZMnob902Ytab+bhQgFmm4rKkkQOXgzUZChNhetg==","signatures":[{"sig":"MEUCIAq1YU6ibI4pqoeiEczontfWg0RWe8AmyvBhiCED9o3XAiEA1vCXpnNe3EY1rlzRqv9axKO0uBWmnYYEeH587WgNGAY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2611557},"main":"dist/index.cjs","pnpm":{"overrides":{"protobufjs":"7.5.6","@protobufjs/utf8":"1.1.1"}},"type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.cjs"},"./core":{"types":"./dist/core.d.ts","import":"./dist/core.js","default":"./dist/core.js","require":"./dist/core.cjs"},"./utils":{"types":"./dist/utils.d.ts","import":"./dist/utils.js","default":"./dist/utils.js","require":"./dist/utils.cjs"},"./memory":{"types":"./dist/memory.d.ts","import":"./dist/memory.js","default":"./dist/memory.js","require":"./dist/memory.cjs"},"./search":{"types":"./dist/search.d.ts","import":"./dist/search.js","default":"./dist/search.js","require":"./dist/search.cjs"},"./browser":{"types":"./dist/browser.d.ts","import":"./dist/browser.js","default":"./dist/browser.js","require":"./dist/browser.cjs"},"./storage":{"types":"./dist/storage.d.ts","import":"./dist/storage.js","default":"./dist/storage.js","require":"./dist/storage.cjs"},"./kv-cache":{"types":"./dist/kv-cache.d.ts","import":"./dist/kv-cache.js","default":"./dist/kv-cache.js","require":"./dist/kv-cache.cjs"},"./embedding":{"types":"./dist/embedding.d.ts","import":"./dist/embedding.js","default":"./dist/embedding.js","require":"./dist/embedding.cjs"},"./package.json":"./package.json"},"gitHead":"163ae5dbacb8277a6d68b0dded87e2d85acfa1e6","scripts":{"dev":"tsup --watch","lint":"eslint src/**/*.ts","test":"vitest run","build":"tsup","clean":"rm -rf dist coverage .tsup","format":"prettier --write src/**/*.ts","prepare":"husky","lint:fix":"eslint src/**/*.ts --fix","build:dev":"tsup --watch","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.scripts.json","test:watch":"vitest","format:check":"prettier --check src/**/*.ts","test:coverage":"vitest run --coverage","fixtures:capture":"tsx scripts/capture-fixtures.ts","typecheck:scripts":"tsc --noEmit -p tsconfig.scripts.json"},"_npmUser":{"name":"atomicstrata","email":"services@atomicstrata.ai"},"repository":{"url":"git+https://github.com/atomicstrata/atomicmemory-sdk.git","type":"git"},"_npmVersion":"11.14.1","description":"Backend-agnostic memory-layer SDK with pluggable providers (AtomicMemory, Mem0), local embeddings, storage adapters, and semantic search. Apache-2.0 licensed OSS core.","directories":{},"sideEffects":["**/transformers-env-config*"],"_nodeVersion":"25.9.0","dependencies":{"@huggingface/transformers":"^3.7.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","tsup":"^8.5.0","vite":"^7.3.3","husky":"^9.1.7","jsdom":"^27.0.0","vitest":"^4.1.6","prettier":"^3.4.2","typescript":"^5.8.3","@types/node":"^24.6.2","@types/chrome":"^0.1.19","@vitest/coverage-v8":"^4.1.6","@vitest/coverage-istanbul":"^4.1.6"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.1_1778772882160_0.528749453056331","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@atomicmemory/sdk","version":"1.0.2","keywords":["memory","embeddings","semantic-search","rag","vector-search","llm","ai-memory"],"author":{"name":"AtomicMemory","email":"support@atomicstrata.ai"},"license":"Apache-2.0","_id":"@atomicmemory/sdk@1.0.2","maintainers":[{"name":"atomicstrata","email":"services@atomicstrata.ai"}],"homepage":"https://github.com/atomicstrata/atomicmemory/tree/main/packages/sdk#readme","bugs":{"url":"https://github.com/atomicstrata/atomicmemory/issues"},"dist":{"shasum":"b406a4055c71dbe8b1ce1c796e0bc2e9709fb475","tarball":"https://registry.npmjs.org/@atomicmemory/sdk/-/sdk-1.0.2.tgz","fileCount":132,"integrity":"sha512-ONioPd1r2sLMl4UaI3GqvNL1WUkPBoCfaPCrtYzfGNdEYk9k3j96A9x46o3wQXFPCC6nz5jtNe4qTCDEGOlDUQ==","signatures":[{"sig":"MEQCIEnvaf+KSqtU/DaNBBHZ8QBJN22GJ3spTqIb4bR6jfleAiAYNZS/bCL8E9L5s2V8tOjs9UlKTDkmJKIcBk52qIqhjA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2677557},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.cjs"},"./core":{"types":"./dist/core.d.ts","import":"./dist/core.js","default":"./dist/core.js","require":"./dist/core.cjs"},"./utils":{"types":"./dist/utils.d.ts","import":"./dist/utils.js","default":"./dist/utils.js","require":"./dist/utils.cjs"},"./memory":{"types":"./dist/memory.d.ts","import":"./dist/memory.js","default":"./dist/memory.js","require":"./dist/memory.cjs"},"./search":{"types":"./dist/search.d.ts","import":"./dist/search.js","default":"./dist/search.js","require":"./dist/search.cjs"},"./browser":{"types":"./dist/browser.d.ts","import":"./dist/browser.js","default":"./dist/browser.js","require":"./dist/browser.cjs"},"./storage":{"types":"./dist/storage.d.ts","import":"./dist/storage.js","default":"./dist/storage.js","require":"./dist/storage.cjs"},"./kv-cache":{"types":"./dist/kv-cache.d.ts","import":"./dist/kv-cache.js","default":"./dist/kv-cache.js","require":"./dist/kv-cache.cjs"},"./embedding":{"types":"./dist/embedding.d.ts","import":"./dist/embedding.js","default":"./dist/embedding.js","require":"./dist/embedding.cjs"},"./package.json":"./package.json"},"gitHead":"201677d74fbb3f3cfd5e0dbb5f6904e889dcbb07","scripts":{"dev":"tsup --watch","lint":"eslint src/**/*.ts && pnpm run boundary:check","test":"vitest run","build":"tsup","clean":"rm -rf dist coverage .tsup","format":"prettier --write src/**/*.ts","prepare":"husky","lint:fix":"eslint src/**/*.ts --fix","build:dev":"tsup --watch","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.scripts.json","test:watch":"vitest","code-health":"pnpm run test:coverage && FALLOW_COVERAGE=coverage/coverage-final.json fallow audit --health-baseline=.fallow/health-baseline.json --dupes-baseline=.fallow/dupes-baseline.json --base=${FALLOW_BASE_REF:-origin/main} --no-cache && ./scripts/check-baseline-ratchet.sh ${FALLOW_BASE_REF:-origin/main}","format:check":"prettier --check src/**/*.ts","test:coverage":"vitest run --coverage","boundary:check":"node scripts/check-boundary.mjs","fixtures:capture":"tsx scripts/capture-fixtures.ts","typecheck:scripts":"tsc --noEmit -p tsconfig.scripts.json"},"_npmUser":{"name":"atomicstrata","email":"services@atomicstrata.ai"},"repository":{"url":"git+https://github.com/atomicstrata/atomicmemory.git","type":"git","directory":"packages/sdk"},"_npmVersion":"11.14.1","description":"Backend-agnostic memory-layer SDK with pluggable providers (AtomicMemory, Mem0), local embeddings, storage adapters, and semantic search. Apache-2.0 licensed OSS core.","directories":{},"sideEffects":["**/transformers-env-config*"],"_nodeVersion":"25.9.0","dependencies":{"@huggingface/transformers":"^3.7.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","tsup":"^8.5.0","vite":"^7.3.3","husky":"^9.1.7","jsdom":"^27.0.0","vitest":"^4.1.6","prettier":"^3.4.2","typescript":"^5.8.3","@types/node":"^24.6.2","@types/chrome":"^0.1.19","@vitest/coverage-v8":"^4.1.6","@vitest/coverage-istanbul":"^4.1.6"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.2_1779188639554_0.9047062805205308","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@atomicmemory/sdk","version":"1.0.3","keywords":["memory","embeddings","semantic-search","rag","vector-search","llm","ai-memory"],"author":{"name":"AtomicMemory","email":"support@atomicstrata.ai"},"license":"Apache-2.0","_id":"@atomicmemory/sdk@1.0.3","maintainers":[{"name":"atomicstrata","email":"services@atomicstrata.ai"}],"homepage":"https://github.com/atomicstrata/atomicmemory/tree/main/packages/sdk#readme","bugs":{"url":"https://github.com/atomicstrata/atomicmemory/issues"},"dist":{"shasum":"a06bacea93e56634c74263c788208ad000eaef91","tarball":"https://registry.npmjs.org/@atomicmemory/sdk/-/sdk-1.0.3.tgz","fileCount":132,"integrity":"sha512-nQUgdK8xLRAFHRBio1pC8j/WH/dmSB7wDCwP5E/53V8ghBbv5fejNL2EeiRekfJG6jHDOQR1DBX47LIiAivcfg==","signatures":[{"sig":"MEQCIBJWDyutX77yKVS/2+LERL04Auqi03TFgQ0+QzU36y4YAiBKR0AfYxQcxv0NwyT1vP9segqg03yyh1i6iD3XBms/3g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2677576},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.cjs"},"./core":{"types":"./dist/core.d.ts","import":"./dist/core.js","default":"./dist/core.js","require":"./dist/core.cjs"},"./utils":{"types":"./dist/utils.d.ts","import":"./dist/utils.js","default":"./dist/utils.js","require":"./dist/utils.cjs"},"./memory":{"types":"./dist/memory.d.ts","import":"./dist/memory.js","default":"./dist/memory.js","require":"./dist/memory.cjs"},"./search":{"types":"./dist/search.d.ts","import":"./dist/search.js","default":"./dist/search.js","require":"./dist/search.cjs"},"./browser":{"types":"./dist/browser.d.ts","import":"./dist/browser.js","default":"./dist/browser.js","require":"./dist/browser.cjs"},"./storage":{"types":"./dist/storage.d.ts","import":"./dist/storage.js","default":"./dist/storage.js","require":"./dist/storage.cjs"},"./kv-cache":{"types":"./dist/kv-cache.d.ts","import":"./dist/kv-cache.js","default":"./dist/kv-cache.js","require":"./dist/kv-cache.cjs"},"./embedding":{"types":"./dist/embedding.d.ts","import":"./dist/embedding.js","default":"./dist/embedding.js","require":"./dist/embedding.cjs"},"./package.json":"./package.json"},"gitHead":"65c9fe5b18faaa87b4b5768e7d04309672aeed4f","scripts":{"dev":"tsup --watch","lint":"eslint src/**/*.ts && pnpm run boundary:check","test":"vitest run","build":"tsup","clean":"rm -rf dist coverage .tsup","format":"prettier --write src/**/*.ts","prepare":"husky","lint:fix":"eslint src/**/*.ts --fix","build:dev":"tsup --watch","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.scripts.json","test:watch":"vitest","code-health":"pnpm run test:coverage && FALLOW_COVERAGE=coverage/coverage-final.json fallow audit --health-baseline=.fallow/health-baseline.json --dupes-baseline=.fallow/dupes-baseline.json --base=${FALLOW_BASE_REF:-origin/main} --no-cache && ./scripts/check-baseline-ratchet.sh ${FALLOW_BASE_REF:-origin/main}","format:check":"prettier --check src/**/*.ts","test:coverage":"vitest run --coverage","boundary:check":"node scripts/check-boundary.mjs","fixtures:capture":"tsx scripts/capture-fixtures.ts","typecheck:scripts":"tsc --noEmit -p tsconfig.scripts.json"},"_npmUser":{"name":"atomicstrata","email":"services@atomicstrata.ai"},"repository":{"url":"git+https://github.com/atomicstrata/atomicmemory.git","type":"git","directory":"packages/sdk"},"_npmVersion":"11.14.1","description":"Backend-agnostic memory-layer SDK with pluggable providers (AtomicMemory, Mem0), local embeddings, storage adapters, and semantic search. Apache-2.0 licensed OSS core.","directories":{},"sideEffects":["**/transformers-env-config*"],"_nodeVersion":"25.9.0","dependencies":{"@huggingface/transformers":"^3.7.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.20.5","tsup":"^8.5.0","vite":"^7.3.3","husky":"^9.1.7","jsdom":"^27.0.0","vitest":"^4.1.6","prettier":"^3.4.2","typescript":"^5.8.3","@types/node":"^24.6.2","@types/chrome":"^0.1.19","@vitest/coverage-v8":"^4.1.6","@vitest/coverage-istanbul":"^4.1.6"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.0.3_1779342281535_0.2974710916804062","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@atomicmemory/sdk","version":"1.1.0","keywords":["memory","embeddings","semantic-search","rag","vector-search","llm","ai-memory"],"author":{"name":"AtomicMemory","email":"support@atomicstrata.ai"},"license":"Apache-2.0","_id":"@atomicmemory/sdk@1.1.0","maintainers":[{"name":"atomicstrata","email":"services@atomicstrata.ai"}],"homepage":"https://github.com/atomicstrata/atomicmemory/tree/main/packages/sdk#readme","bugs":{"url":"https://github.com/atomicstrata/atomicmemory/issues"},"dist":{"shasum":"66d88ab7f2b4e701b65ebe7aaed8508830bb33f0","tarball":"https://registry.npmjs.org/@atomicmemory/sdk/-/sdk-1.1.0.tgz","fileCount":138,"integrity":"sha512-B/DayBZjtcsfiJTQD7+KOuxL4UpTjSh1pAbQZXZ2oxJl8AHn8mAEc0LrrYDSWTrIwF3b4FE98qH9rcafg8CMkg==","signatures":[{"sig":"MEUCIGFG4VjghEH2PYLhPPtocuFx1a5/pj+Puorn4YGn7i87AiEAgJycEBt1WRzfezlrai3WmONsKqbNxWQJ7CkgzaphGLE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atomicmemory%2fsdk@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":2789859},"main":"dist/index.cjs","type":"module","types":"dist/index.d.ts","module":"dist/index.js","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","default":"./dist/index.js","require":"./dist/index.cjs"},"./core":{"types":"./dist/core.d.ts","import":"./dist/core.js","default":"./dist/core.js","require":"./dist/core.cjs"},"./utils":{"types":"./dist/utils.d.ts","import":"./dist/utils.js","default":"./dist/utils.js","require":"./dist/utils.cjs"},"./memory":{"types":"./dist/memory.d.ts","import":"./dist/memory.js","default":"./dist/memory.js","require":"./dist/memory.cjs"},"./search":{"types":"./dist/search.d.ts","import":"./dist/search.js","default":"./dist/search.js","require":"./dist/search.cjs"},"./browser":{"types":"./dist/browser.d.ts","import":"./dist/browser.js","default":"./dist/browser.js","require":"./dist/browser.cjs"},"./storage":{"types":"./dist/storage.d.ts","import":"./dist/storage.js","default":"./dist/storage.js","require":"./dist/storage.cjs"},"./kv-cache":{"types":"./dist/kv-cache.d.ts","import":"./dist/kv-cache.js","default":"./dist/kv-cache.js","require":"./dist/kv-cache.cjs"},"./embedding":{"types":"./dist/embedding.d.ts","import":"./dist/embedding.js","default":"./dist/embedding.js","require":"./dist/embedding.cjs"},"./package.json":"./package.json"},"gitHead":"74d798fcc57ba02adddf0166112fa66da415c366","scripts":{"dev":"tsup --watch","lint":"eslint src/**/*.ts && pnpm run boundary:check","test":"vitest run","build":"tsup","clean":"rm -rf dist coverage .tsup","format":"prettier --write src/**/*.ts","prepare":"husky","lint:fix":"eslint src/**/*.ts --fix","build:dev":"tsup --watch","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.scripts.json","test:watch":"vitest","code-health":"pnpm run test:coverage && FALLOW_COVERAGE=coverage/coverage-final.json fallow audit --health-baseline=.fallow/health-baseline.json --dupes-baseline=.fallow/dupes-baseline.json --base=${FALLOW_BASE_REF:-origin/main} --no-cache && ./scripts/check-baseline-ratchet.sh ${FALLOW_BASE_REF:-origin/main}","format:check":"prettier --check src/**/*.ts","test:coverage":"vitest run --coverage","boundary:check":"node scripts/check-boundary.mjs","prepublishOnly":"node ../../scripts/guards/guard-npm-publish.mjs","fixtures:capture":"tsx scripts/capture-fixtures.ts","typecheck:scripts":"tsc --noEmit -p tsconfig.scripts.json"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:e98e63d7-ce71-445e-a3aa-5dab157deb88"}},"repository":{"url":"git+https://github.com/atomicstrata/atomicmemory.git","type":"git","directory":"packages/sdk"},"_npmVersion":"11.16.0","description":"Backend-agnostic memory-layer SDK with pluggable providers (AtomicMemory, Mem0), local embeddings, storage adapters, and semantic search. Apache-2.0 licensed OSS core.","directories":{},"sideEffects":["**/transformers-env-config*"],"_nodeVersion":"22.22.3","dependencies":{"@huggingface/transformers":"^3.7.1"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"devDependencies":{"ajv":"^8.20.0","tsx":"^4.20.5","tsup":"^8.5.0","vite":"^7.3.3","husky":"^9.1.7","jsdom":"^27.0.0","vitest":"^4.1.6","prettier":"^3.4.2","typescript":"^5.8.3","@types/node":"^24.6.2","ajv-formats":"^3.0.1","@types/chrome":"^0.1.19","@vitest/coverage-v8":"^4.1.6","@vitest/coverage-istanbul":"^4.1.6"},"_npmOperationalInternal":{"tmp":"tmp/sdk_1.1.0_1781144187500_0.05252036184008513","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@atomicmemory/sdk","version":"1.1.1","type":"module","engines":{"node":">=22"},"repository":{"type":"git","url":"git+https://github.com/atomicstrata/atomicmemory.git","directory":"packages/sdk"},"publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"homepage":"https://github.com/atomicstrata/atomicmemory/tree/main/packages/sdk#readme","bugs":{"url":"https://github.com/atomicstrata/atomicmemory/issues"},"main":"dist/index.cjs","module":"dist/index.js","types":"dist/index.d.ts","sideEffects":["**/transformers-env-config*"],"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js","require":"./dist/index.cjs","default":"./dist/index.js"},"./browser":{"types":"./dist/browser.d.ts","import":"./dist/browser.js","require":"./dist/browser.cjs","default":"./dist/browser.js"},"./storage":{"types":"./dist/storage.d.ts","import":"./dist/storage.js","require":"./dist/storage.cjs","default":"./dist/storage.js"},"./kv-cache":{"types":"./dist/kv-cache.d.ts","import":"./dist/kv-cache.js","require":"./dist/kv-cache.cjs","default":"./dist/kv-cache.js"},"./embedding":{"types":"./dist/embedding.d.ts","import":"./dist/embedding.js","require":"./dist/embedding.cjs","default":"./dist/embedding.js"},"./search":{"types":"./dist/search.d.ts","import":"./dist/search.js","require":"./dist/search.cjs","default":"./dist/search.js"},"./utils":{"types":"./dist/utils.d.ts","import":"./dist/utils.js","require":"./dist/utils.cjs","default":"./dist/utils.js"},"./core":{"types":"./dist/core.d.ts","import":"./dist/core.js","require":"./dist/core.cjs","default":"./dist/core.js"},"./memory":{"types":"./dist/memory.d.ts","import":"./dist/memory.js","require":"./dist/memory.cjs","default":"./dist/memory.js"},"./package.json":"./package.json"},"scripts":{"build":"tsup","code-health":"pnpm run test:coverage && FALLOW_COVERAGE=coverage/coverage-final.json fallow audit --health-baseline=.fallow/health-baseline.json --dupes-baseline=.fallow/dupes-baseline.json --base=${FALLOW_BASE_REF:-origin/main} --no-cache && ./scripts/check-baseline-ratchet.sh ${FALLOW_BASE_REF:-origin/main}","build:dev":"tsup --watch","dev":"tsup --watch","test":"vitest run","test:watch":"vitest","test:coverage":"vitest run --coverage","typecheck":"tsc --noEmit && tsc --noEmit -p tsconfig.scripts.json","typecheck:scripts":"tsc --noEmit -p tsconfig.scripts.json","lint":"eslint src/**/*.ts && pnpm run boundary:check","boundary:check":"node scripts/check-boundary.mjs","lint:fix":"eslint src/**/*.ts --fix","format":"prettier --write src/**/*.ts","format:check":"prettier --check src/**/*.ts","clean":"rm -rf dist coverage .tsup","fixtures:capture":"tsx scripts/capture-fixtures.ts","prepare":"husky","prepublishOnly":"node ../../scripts/guards/guard-npm-publish.mjs"},"keywords":["memory","embeddings","semantic-search","rag","vector-search","llm","ai-memory"],"author":{"name":"AtomicMemory","email":"support@atomicstrata.ai"},"license":"Apache-2.0","description":"Backend-agnostic memory-layer SDK with pluggable providers (AtomicMemory, Mem0), local embeddings, storage adapters, and semantic search. Apache-2.0 licensed OSS core.","devDependencies":{"@types/chrome":"^0.1.19","@types/node":"^24.6.2","@vitest/coverage-istanbul":"^4.1.6","@vitest/coverage-v8":"^4.1.6","ajv":"^8.20.0","ajv-formats":"^3.0.1","husky":"^9.1.7","jsdom":"^27.0.0","prettier":"^3.4.2","tsup":"^8.5.0","tsx":"^4.20.5","typescript":"^5.8.3","vite":"^7.3.3","vitest":"^4.1.6"},"dependencies":{"@huggingface/transformers":"^3.7.1"},"gitHead":"94e957099ba8a6b936254719931e5bafda18fbce","_id":"@atomicmemory/sdk@1.1.1","_nodeVersion":"22.22.3","_npmVersion":"11.17.0","dist":{"integrity":"sha512-tph7fB20cDzJ6IiUbd2ok7JGSNmiJwTEa0CQCzASbSiRtXDe3jjRs+9GomTvPA3ZLbaJqaMnHQbjFMFejXRLKQ==","shasum":"49904391e8cd6dc5949f16122af21f8baeb8d78f","tarball":"https://registry.npmjs.org/@atomicmemory/sdk/-/sdk-1.1.1.tgz","fileCount":142,"unpackedSize":2825106,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atomicmemory%2fsdk@1.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCICUMxfn8JgADFditI/mQzlUws7TU1/YghvmfnmZwU98cAiEA2DEfDJiEqCZeTZ7votZjOxZ77KN2NROLW0r/nkkjHZs="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:e98e63d7-ce71-445e-a3aa-5dab157deb88"}},"directories":{},"maintainers":[{"name":"atomicstrata","email":"services@atomicstrata.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sdk_1.1.1_1781599691433_0.8518572474221535"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-13T09:15:40.207Z","modified":"2026-06-16T08:48:11.915Z","1.0.0":"2026-05-13T09:15:40.453Z","1.0.1":"2026-05-14T15:34:42.365Z","1.0.2":"2026-05-19T11:03:59.909Z","1.0.3":"2026-05-21T05:44:41.751Z","1.1.0":"2026-06-11T02:16:27.746Z","1.1.1":"2026-06-16T08:48:11.608Z"},"bugs":{"url":"https://github.com/atomicstrata/atomicmemory/issues"},"author":{"name":"AtomicMemory","email":"support@atomicstrata.ai"},"license":"Apache-2.0","homepage":"https://github.com/atomicstrata/atomicmemory/tree/main/packages/sdk#readme","keywords":["memory","embeddings","semantic-search","rag","vector-search","llm","ai-memory"],"repository":{"type":"git","url":"git+https://github.com/atomicstrata/atomicmemory.git","directory":"packages/sdk"},"description":"Backend-agnostic memory-layer SDK with pluggable providers (AtomicMemory, Mem0), local embeddings, storage adapters, and semantic search. Apache-2.0 licensed OSS core.","maintainers":[{"name":"atomicstrata","email":"services@atomicstrata.ai"}],"readme":"# @atomicmemory/sdk\n\n[![CI](https://github.com/atomicstrata/atomicmemory/actions/workflows/ci.yml/badge.svg)](https://github.com/atomicstrata/atomicmemory/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/%40atomicmemory%2Fsdk?label=npm)](https://www.npmjs.com/package/@atomicmemory/sdk)\n[![Docs](https://img.shields.io/badge/docs-docs.atomicstrata.ai-blue)](https://docs.atomicstrata.ai)\n[![License: Apache 2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)\n\nBackend-agnostic memory-layer SDK — pluggable providers, local embeddings, storage adapters, semantic search.\n\n**Docs:** [docs.atomicstrata.ai/sdk](https://docs.atomicstrata.ai/sdk)\n\nAtomicMemory Core currently reaches leading performance/cost on BEAM-100K, BEAM-1M, and LoCoMo10, with BEAM-10M parity against the strongest published Mem0-new result. The SDK is the typed application surface for building on that memory layer.\n\n## What this package provides\n\n- **`AtomicMemoryClient`** — primary public surface. Aggregates the\n  memory and storage namespaces:\n  `client.memory.search(...)` and `client.storage.put(...)`.\n- **Provider interface + registry** — implement `MemoryProvider` to plug in any backend.\n- **`AtomicMemoryProvider`** — HTTP adapter for [@atomicmemory/core](../core).\n- **`Mem0Provider`** — HTTP adapter for [Mem0](https://github.com/mem0ai/mem0) (OSS or hosted).\n- **`StorageManager`** — KV / cache adapters under the `./kv-cache` subpath (IndexedDB, in-memory).\n- **`EmbeddingGenerator`** — local embedding generation via [`transformers.js`](https://github.com/huggingface/transformers.js).\n- **`SemanticSearch`** — cosine-similarity search primitives.\n- Error types (`AtomicMemoryError`, `StorageError`, `SearchError`,\n  plus storage typed errors like `ArtifactInUseError`,\n  `PointerContentNotManagedError`) and a minimal event emitter.\n\n> **Server-side only in v1.** The direct storage API uses a shared\n> bearer credential and must run inside a trusted process (a Node\n> server, ops tooling, or the webapp-sdk proxy). Browser bundles\n> must NOT instantiate `AtomicMemoryClient` directly.\n\n## Installation\n\n```bash\npnpm add @atomicmemory/sdk\n```\n\nAlso works with `npm install` / `yarn add`.\n\n## Quick start\n\nPrerequisite: start `atomicmemory-core` first. The full SDK walkthrough is in the [SDK Quickstart](https://docs.atomicstrata.ai/sdk/quickstart).\n\n```ts\nimport { AtomicMemoryClient } from '@atomicmemory/sdk';\n\nconst client = new AtomicMemoryClient({\n  apiUrl: 'http://localhost:17350',\n  apiKey: process.env.ATOMICMEMORY_API_KEY!,\n  userId: 'demo-user',\n  memory: {\n    providers: {\n      atomicmemory: { apiUrl: 'http://localhost:17350' },\n    },\n  },\n});\nawait client.memory.initialize();\n\n// Memory namespace.\nawait client.memory.ingest({\n  mode: 'messages',\n  messages: [{ role: 'user', content: 'I prefer aisle seats.' }],\n  scope: { user: 'demo-user' },\n});\nconst results = await client.memory.search({\n  query: 'seat preference',\n  scope: { user: 'demo-user' },\n});\n\n// Storage namespace.\nconst artifact = await client.storage.put({\n  mode: 'pointer',\n  uri: 'https://example.com/file.pdf',\n  contentType: 'application/pdf',\n});\nconsole.log(artifact.artifactId);\n```\n\nApplications that only need memory operations can still use\n`MemoryClient` directly. New integrations should prefer the\nnamespaced `AtomicMemoryClient.memory` surface.\n\n## Providers\n\n### AtomicMemory (recommended for self-hosted)\n\n```ts\nconst memory = new MemoryClient({\n  providers: {\n    atomicmemory: {\n      apiUrl: 'http://localhost:17350',\n      apiKey: process.env.ATOMICMEMORY_API_KEY,\n      timeout: 30_000,\n    },\n  },\n});\n```\n\n### Mem0\n\n```ts\nconst memory = new MemoryClient({\n  providers: {\n    mem0: {\n      apiUrl: 'http://localhost:8888',\n      apiStyle: 'oss',\n    },\n  },\n});\n```\n\n## Subpath exports\n\n- `@atomicmemory/sdk/browser` — browser-safe entry: `MemoryClient` + memory types/adapters, without the root bundle's storage/embedding/search surface\n- `@atomicmemory/sdk/storage` — storage artifact client + types (`ConcreteStorageClient`, `StorageClient`, `StoredArtifact`, error classes)\n- `@atomicmemory/sdk/kv-cache` — KV / cache adapters (IndexedDB, in-memory) used internally by the embedding cache\n- `@atomicmemory/sdk/embedding` — embedding generator\n- `@atomicmemory/sdk/search` — semantic search primitives\n- `@atomicmemory/sdk/utils` — shared utilities\n- `@atomicmemory/sdk/core` — error types + events\n- `@atomicmemory/sdk/memory` — memory types, provider interface, provider adapters\n\n## Development\n\n```bash\npnpm install\npnpm build\npnpm test\npnpm typecheck\n```\n\n### Refreshing mapper test fixtures\n\nThe `AtomicMemoryProvider` mappers are guarded by a record/replay\ntest suite that runs against captured `atomicmemory-core` HTTP\nresponses. When core's wire shape changes, refresh the fixtures:\n\n```bash\n# In packages/core: ensure .env has a real\n# OPENAI_API_KEY (or LLM_PROVIDER=ollama), then:\ndocker compose up -d --build\n\n# Back in packages/sdk:\npnpm fixtures:capture\n```\n\nSee [`src/memory/atomicmemory-provider/__tests__/fixtures/README.md`](./src/memory/atomicmemory-provider/__tests__/fixtures/README.md) for the full procedure and what gets normalized at capture time.\n\n## Contributing\n\nIssues and PRs welcome.\n\n## License\n\nApache-2.0 © AtomicMemory\n","readmeFilename":"README.md"}