🚀. Socket Launch Week Day 2:Introducing Manifest Alerts.Learn more →

@atomicmemory/sdk

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@atomicmemory/sdk - npm Package Compare versions

Comparing version

1.1.0

1.1.1

+76

dist/chunk-3HWUP4VL.js

		import { isIP } from 'net';

		// src/utils/validate-api-url.ts
		function isLinkLocalIpv4([a, b]) {
		return a === 169 && b === 254;
		}
		function isPrivateIpv4([a, b]) {
		return a === 10 \|\| a === 172 && b >= 16 && b <= 31 \|\| a === 192 && b === 168 \|\| a === 100 && b >= 64 && b <= 127;
		}
		function isSpecialIpv4([a, b, c, d]) {
		const loopback = a === 127;
		const unspecified = a === 0;
		const broadcast = a === 255 && b === 255 && c === 255 && d === 255;
		const reserved = a === 192 && b === 0 && c === 0 \|\| a >= 240;
		const multicast = a >= 224 && a <= 239;
		return loopback \|\| unspecified \|\| broadcast \|\| reserved \|\| multicast;
		}
		function classifyIpv4(host) {
		const octets = host.split(".").map(Number);
		return {
		linkLocal: isLinkLocalIpv4(octets),
		blockedByDefault: isPrivateIpv4(octets) \|\| isSpecialIpv4(octets)
		};
		}
		function mappedIpv4(host) {
		const rest = host.toLowerCase().match(/^::ffff:(.+)$/)?.[1];
		if (rest === void 0) return null;
		if (/^\d{1,3}(\.\d{1,3}){3}$/.test(rest)) return rest;
		const pair = rest.match(/^([0-9a-f]{1,4}):([0-9a-f]{1,4})$/);
		if (!pair) return null;
		const hi = parseInt(pair[1], 16);
		const lo = parseInt(pair[2], 16);
		return `${hi >> 8 & 255}.${hi & 255}.${lo >> 8 & 255}.${lo & 255}`;
		}
		function classifyIpv6(host) {
		const mapped = mappedIpv4(host);
		if (mapped) return classifyIpv4(mapped);
		const lower = host.toLowerCase();
		return {
		linkLocal: /^fe[89ab]/.test(lower),
		// fe80::/10
		blockedByDefault: lower === "::1" \|\| lower === "::" \|\| /^f[cd]/.test(lower)
		// loopback, unspecified, fc00::/7 ULA
		};
		}
		function validateApiUrl(value, options = {}) {
		const stripped = value.trim();
		let parsed;
		try {
		parsed = new URL(stripped);
		} catch {
		throw new Error("api_url must be an http(s) URL");
		}
		if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
		throw new Error("api_url must be an http(s) URL");
		}
		const host = parsed.hostname.replace(/^\[\|\]$/g, "");
		if (!host) throw new Error("api_url must include a host");
		const kind = isIP(host);
		if (kind === 0) return stripped;
		const ipClass = kind === 4 ? classifyIpv4(host) : classifyIpv6(host);
		if (ipClass.linkLocal) {
		throw new Error("api_url must not target a link-local or cloud-metadata address");
		}
		const allowPrivate = options.allowPrivateNetworks ?? true;
		if (!allowPrivate && ipClass.blockedByDefault) {
		throw new Error(
		"api_url must not target a loopback, private, or reserved address; set allowPrivateNetworks=true to permit it"
		);
		}
		return stripped;
		}

		export { validateApiUrl };
		//# sourceMappingURL=chunk-3HWUP4VL.js.map
		//# sourceMappingURL=chunk-3HWUP4VL.js.map

+1

dist/chunk-3HWUP4VL.js.map

+339

dist/chunk-AQHNXVMQ.cjs

		'use strict';

		var chunkWSP2HCUV_cjs = require('./chunk-WSP2HCUV.cjs');

		// src/memory/providers/registry.ts
		var defaultRegistry = {
		atomicmemory: (config) => ({
		provider: new chunkWSP2HCUV_cjs.AtomicMemoryProvider(config)
		}),
		mem0: (config) => ({
		provider: new chunkWSP2HCUV_cjs.Mem0Provider(config)
		}),
		hindsight: (config) => ({
		provider: new chunkWSP2HCUV_cjs.HindsightProvider(config)
		})
		};

		// src/memory/memory-service.ts
		var MemoryService = class {
		constructor(config) {
		this.config = config;
		this.defaultProviderName = config.defaultProvider;
		}
		config;
		providers = /* @__PURE__ */ new Map();
		pipelines = /* @__PURE__ */ new Map();
		defaultProviderName;
		async initialize(registry = defaultRegistry) {
		const stagedProviders = /* @__PURE__ */ new Map();
		const stagedPipelines = /* @__PURE__ */ new Map();
		try {
		for (const [name, providerConfig] of Object.entries(
		this.config.providerConfigs
		)) {
		const factory = registry[name];
		if (!factory) continue;
		const registration = await factory(providerConfig);
		stagedProviders.set(name, registration.provider);
		stagedPipelines.set(
		name,
		registration.pipeline ?? chunkWSP2HCUV_cjs.noopMemoryPipeline
		);
		if (registration.provider.initialize) {
		await registration.provider.initialize();
		}
		}
		} catch (cause) {
		await Promise.allSettled(
		[...stagedProviders.values()].map((p) => p.close?.())
		);
		throw cause;
		}
		for (const [name, provider] of stagedProviders) this.providers.set(name, provider);
		for (const [name, pipeline] of stagedPipelines) this.pipelines.set(name, pipeline);
		}
		getProvider(name) {
		const providerName = name ?? this.defaultProviderName;
		const provider = this.providers.get(providerName);
		if (!provider) {
		throw new Error(
		`Provider "${providerName}" is not registered`
		);
		}
		return provider;
		}
		getAvailableProviders() {
		return Array.from(this.providers.keys());
		}
		/**
		* Provider names declared in the SDK configuration, regardless of whether
		* they have been initialized yet. Useful for UI and getter paths that
		* need to advertise capabilities before `initialize()` has run.
		*/
		getConfiguredProviders() {
		return Object.keys(this.config.providerConfigs);
		}
		// -----------------------------------------------------------------------
		// Core operations
		// -----------------------------------------------------------------------
		async ingest(input, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		if (pipeline.preprocessIngest) {
		const inputs = await pipeline.preprocessIngest(input);
		const results = [];
		for (const i of inputs) {
		const result2 = await provider.ingest(i);
		if (pipeline.postprocessIngest) {
		await pipeline.postprocessIngest(result2, i);
		}
		results.push(result2);
		}
		return mergeIngestResults(results);
		}
		const result = await provider.ingest(input);
		if (pipeline.postprocessIngest) {
		await pipeline.postprocessIngest(result, input);
		}
		return result;
		}
		async search(request, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const processedRequest = pipeline.preprocessSearch ? await pipeline.preprocessSearch(request) : request;
		const page = await provider.search(processedRequest);
		return pipeline.postprocessSearch ? await pipeline.postprocessSearch(page, processedRequest) : page;
		}
		async get(ref, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const processedRef = pipeline.preprocessGet ? await pipeline.preprocessGet(ref) : ref;
		const memory = await provider.get(processedRef);
		return pipeline.postprocessGet ? await pipeline.postprocessGet(memory, processedRef) : memory;
		}
		async delete(ref, providerName) {
		const provider = this.getProvider(providerName);
		await provider.delete(ref);
		}
		async list(request, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const page = await provider.list(request);
		return pipeline.postprocessList ? await pipeline.postprocessList(page, request) : page;
		}
		async package(request, providerName) {
		const provider = this.getProvider(providerName);
		const packager = provider.getExtension?.("package");
		if (!packager) {
		throw new chunkWSP2HCUV_cjs.UnsupportedOperationError(
		provider.name,
		"package"
		);
		}
		return packager.package(request);
		}
		// -----------------------------------------------------------------------
		// Internals
		// -----------------------------------------------------------------------
		getPipeline(name) {
		const providerName = name ?? this.defaultProviderName;
		return this.pipelines.get(providerName) ?? chunkWSP2HCUV_cjs.noopMemoryPipeline;
		}
		};
		function mergeIngestResults(results) {
		return {
		created: results.flatMap((r) => r.created),
		updated: results.flatMap((r) => r.updated),
		unchanged: results.flatMap((r) => r.unchanged)
		};
		}

		// src/client/memory-client.ts
		var MemoryClient = class {
		service;
		initialized = false;
		initPromise;
		constructor(config) {
		const providerConfigs = { ...config.providers };
		const defaultProvider = config.defaultProvider ?? pickFirstProviderKey(providerConfigs);
		if (!defaultProvider) {
		throw new Error(
		'MemoryClient requires at least one provider config. Pass e.g. { providers: { atomicmemory: { apiUrl: "..." } } }.'
		);
		}
		this.service = new MemoryService({
		defaultProvider,
		providerConfigs
		});
		}
		/**
		* Initialize all configured providers. Must be called before any memory
		* operation. Idempotent and concurrency-safe: concurrent and subsequent
		* calls share a single initialization run. The `registry` argument of the
		* first call wins; later calls share that run and their argument is ignored.
		* A REJECTED initialization is sticky — retrying on the same instance
		* re-throws the original error (partial provider state from a failed run is
		* never reused); resolve the cause (e.g. install a missing optional peer)
		* and construct a new client.
		*/
		async initialize(registry = defaultRegistry) {
		this.initPromise ??= this.service.initialize(registry).then(() => {
		this.initialized = true;
		});
		return this.initPromise;
		}
		/**
		* Write memory(ies). Input supports `text`, `messages`, or `memory` modes.
		*/
		async ingest(input) {
		this.assertInitialized();
		return this.service.ingest(input);
		}
		/**
		* Ingest without any application-layer gating. Equivalent to `ingest()`
		* on the core client; application wrappers override the gated variant
		* while delegating this path straight through.
		*/
		async ingestDirect(input) {
		this.assertInitialized();
		return this.service.ingest(input);
		}
		/**
		* Search for memories matching the request.
		*/
		async search(request) {
		this.assertInitialized();
		return this.service.search(request);
		}
		/**
		* Search without application-layer gating. See `ingestDirect` for the
		* rationale.
		*/
		async searchDirect(request) {
		this.assertInitialized();
		return this.service.search(request);
		}
		/**
		* Build an injection-ready context package from a scoped request.
		* Provider must implement the `package` extension.
		*/
		async package(request) {
		this.assertInitialized();
		return this.service.package(request);
		}
		/**
		* Package without application-layer gating.
		*/
		async packageDirect(request) {
		this.assertInitialized();
		return this.service.package(request);
		}
		/**
		* Fetch a single memory by reference.
		*/
		async get(ref) {
		this.assertInitialized();
		return this.service.get(ref);
		}
		/**
		* Delete a single memory by reference.
		*/
		async delete(ref) {
		this.assertInitialized();
		return this.service.delete(ref);
		}
		/**
		* List memories within a scope.
		*/
		async list(request) {
		this.assertInitialized();
		return this.service.list(request);
		}
		/**
		* Report the capability surface of the default (or named) provider.
		*
		* @throws if the named provider is unknown or not initialized.
		*/
		capabilities(providerName) {
		this.assertInitialized();
		return this.service.getProvider(providerName).capabilities();
		}
		/**
		* Resolve a named extension on the default (or named) provider.
		* Returns `undefined` when the provider does not advertise the
		* extension.
		*
		* @throws if the named provider is unknown or not initialized.
		*
		* @example
		* ```ts
		* const pkg = memory.getExtension<Packager>('package');
		* ```
		*/
		getExtension(extensionName, providerName) {
		this.assertInitialized();
		const provider = this.service.getProvider(providerName);
		return provider.getExtension?.(extensionName);
		}
		/**
		* Aggregate status of all configured providers. Never throws:
		* uninitialized providers report `initialized: false` and
		* `capabilities: null`.
		*/
		getProviderStatus() {
		const configured = this.service.getConfiguredProviders();
		const available = new Set(this.service.getAvailableProviders());
		return configured.map((name) => {
		if (!available.has(name)) {
		return { name, initialized: false, capabilities: null };
		}
		return {
		name,
		initialized: true,
		capabilities: this.service.getProvider(name).capabilities()
		};
		});
		}
		/**
		* Access the full AtomicMemory namespace handle (lifecycle, audit,
		* lessons, config, agents). Returns `undefined` when the client is
		* not yet initialized, the `atomicmemory` provider was not included
		* in the `providers` config, or that provider does not advertise the
		* namespace handle. This getter intentionally never throws — callers
		* can guard with a truthy check and let the handle's own methods
		* raise if used incorrectly.
		*/
		get atomicmemory() {
		if (!this.initialized) return void 0;
		if (!this.service.getConfiguredProviders().includes("atomicmemory")) {
		return void 0;
		}
		const provider = this.service.getProvider("atomicmemory");
		return provider.getExtension?.("atomicmemory.base");
		}
		/**
		* Low-level escape hatch for callers that need the concrete provider.
		*/
		getProvider(name) {
		this.assertInitialized();
		return this.service.getProvider(name);
		}
		assertInitialized() {
		if (!this.initialized) {
		throw new Error(
		"MemoryClient is not initialized. Call `await client.initialize()` first."
		);
		}
		}
		};
		function pickFirstProviderKey(providers) {
		for (const [key, value] of Object.entries(providers)) {
		if (value !== void 0 && key !== "default") return key;
		}
		return void 0;
		}

		exports.MemoryClient = MemoryClient;
		//# sourceMappingURL=chunk-AQHNXVMQ.cjs.map
		//# sourceMappingURL=chunk-AQHNXVMQ.cjs.map

+1

dist/chunk-AQHNXVMQ.cjs.map

dist/chunk-KI5UNWJI.js

Sorry, the diff of this file is too big to display

dist/chunk-KI5UNWJI.js.map

Sorry, the diff of this file is too big to display

+337

dist/chunk-KYVD7KQV.js

		import { HindsightProvider, Mem0Provider, AtomicMemoryProvider, noopMemoryPipeline, UnsupportedOperationError } from './chunk-KI5UNWJI.js';

		// src/memory/providers/registry.ts
		var defaultRegistry = {
		atomicmemory: (config) => ({
		provider: new AtomicMemoryProvider(config)
		}),
		mem0: (config) => ({
		provider: new Mem0Provider(config)
		}),
		hindsight: (config) => ({
		provider: new HindsightProvider(config)
		})
		};

		// src/memory/memory-service.ts
		var MemoryService = class {
		constructor(config) {
		this.config = config;
		this.defaultProviderName = config.defaultProvider;
		}
		config;
		providers = /* @__PURE__ */ new Map();
		pipelines = /* @__PURE__ */ new Map();
		defaultProviderName;
		async initialize(registry = defaultRegistry) {
		const stagedProviders = /* @__PURE__ */ new Map();
		const stagedPipelines = /* @__PURE__ */ new Map();
		try {
		for (const [name, providerConfig] of Object.entries(
		this.config.providerConfigs
		)) {
		const factory = registry[name];
		if (!factory) continue;
		const registration = await factory(providerConfig);
		stagedProviders.set(name, registration.provider);
		stagedPipelines.set(
		name,
		registration.pipeline ?? noopMemoryPipeline
		);
		if (registration.provider.initialize) {
		await registration.provider.initialize();
		}
		}
		} catch (cause) {
		await Promise.allSettled(
		[...stagedProviders.values()].map((p) => p.close?.())
		);
		throw cause;
		}
		for (const [name, provider] of stagedProviders) this.providers.set(name, provider);
		for (const [name, pipeline] of stagedPipelines) this.pipelines.set(name, pipeline);
		}
		getProvider(name) {
		const providerName = name ?? this.defaultProviderName;
		const provider = this.providers.get(providerName);
		if (!provider) {
		throw new Error(
		`Provider "${providerName}" is not registered`
		);
		}
		return provider;
		}
		getAvailableProviders() {
		return Array.from(this.providers.keys());
		}
		/**
		* Provider names declared in the SDK configuration, regardless of whether
		* they have been initialized yet. Useful for UI and getter paths that
		* need to advertise capabilities before `initialize()` has run.
		*/
		getConfiguredProviders() {
		return Object.keys(this.config.providerConfigs);
		}
		// -----------------------------------------------------------------------
		// Core operations
		// -----------------------------------------------------------------------
		async ingest(input, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		if (pipeline.preprocessIngest) {
		const inputs = await pipeline.preprocessIngest(input);
		const results = [];
		for (const i of inputs) {
		const result2 = await provider.ingest(i);
		if (pipeline.postprocessIngest) {
		await pipeline.postprocessIngest(result2, i);
		}
		results.push(result2);
		}
		return mergeIngestResults(results);
		}
		const result = await provider.ingest(input);
		if (pipeline.postprocessIngest) {
		await pipeline.postprocessIngest(result, input);
		}
		return result;
		}
		async search(request, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const processedRequest = pipeline.preprocessSearch ? await pipeline.preprocessSearch(request) : request;
		const page = await provider.search(processedRequest);
		return pipeline.postprocessSearch ? await pipeline.postprocessSearch(page, processedRequest) : page;
		}
		async get(ref, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const processedRef = pipeline.preprocessGet ? await pipeline.preprocessGet(ref) : ref;
		const memory = await provider.get(processedRef);
		return pipeline.postprocessGet ? await pipeline.postprocessGet(memory, processedRef) : memory;
		}
		async delete(ref, providerName) {
		const provider = this.getProvider(providerName);
		await provider.delete(ref);
		}
		async list(request, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const page = await provider.list(request);
		return pipeline.postprocessList ? await pipeline.postprocessList(page, request) : page;
		}
		async package(request, providerName) {
		const provider = this.getProvider(providerName);
		const packager = provider.getExtension?.("package");
		if (!packager) {
		throw new UnsupportedOperationError(
		provider.name,
		"package"
		);
		}
		return packager.package(request);
		}
		// -----------------------------------------------------------------------
		// Internals
		// -----------------------------------------------------------------------
		getPipeline(name) {
		const providerName = name ?? this.defaultProviderName;
		return this.pipelines.get(providerName) ?? noopMemoryPipeline;
		}
		};
		function mergeIngestResults(results) {
		return {
		created: results.flatMap((r) => r.created),
		updated: results.flatMap((r) => r.updated),
		unchanged: results.flatMap((r) => r.unchanged)
		};
		}

		// src/client/memory-client.ts
		var MemoryClient = class {
		service;
		initialized = false;
		initPromise;
		constructor(config) {
		const providerConfigs = { ...config.providers };
		const defaultProvider = config.defaultProvider ?? pickFirstProviderKey(providerConfigs);
		if (!defaultProvider) {
		throw new Error(
		'MemoryClient requires at least one provider config. Pass e.g. { providers: { atomicmemory: { apiUrl: "..." } } }.'
		);
		}
		this.service = new MemoryService({
		defaultProvider,
		providerConfigs
		});
		}
		/**
		* Initialize all configured providers. Must be called before any memory
		* operation. Idempotent and concurrency-safe: concurrent and subsequent
		* calls share a single initialization run. The `registry` argument of the
		* first call wins; later calls share that run and their argument is ignored.
		* A REJECTED initialization is sticky — retrying on the same instance
		* re-throws the original error (partial provider state from a failed run is
		* never reused); resolve the cause (e.g. install a missing optional peer)
		* and construct a new client.
		*/
		async initialize(registry = defaultRegistry) {
		this.initPromise ??= this.service.initialize(registry).then(() => {
		this.initialized = true;
		});
		return this.initPromise;
		}
		/**
		* Write memory(ies). Input supports `text`, `messages`, or `memory` modes.
		*/
		async ingest(input) {
		this.assertInitialized();
		return this.service.ingest(input);
		}
		/**
		* Ingest without any application-layer gating. Equivalent to `ingest()`
		* on the core client; application wrappers override the gated variant
		* while delegating this path straight through.
		*/
		async ingestDirect(input) {
		this.assertInitialized();
		return this.service.ingest(input);
		}
		/**
		* Search for memories matching the request.
		*/
		async search(request) {
		this.assertInitialized();
		return this.service.search(request);
		}
		/**
		* Search without application-layer gating. See `ingestDirect` for the
		* rationale.
		*/
		async searchDirect(request) {
		this.assertInitialized();
		return this.service.search(request);
		}
		/**
		* Build an injection-ready context package from a scoped request.
		* Provider must implement the `package` extension.
		*/
		async package(request) {
		this.assertInitialized();
		return this.service.package(request);
		}
		/**
		* Package without application-layer gating.
		*/
		async packageDirect(request) {
		this.assertInitialized();
		return this.service.package(request);
		}
		/**
		* Fetch a single memory by reference.
		*/
		async get(ref) {
		this.assertInitialized();
		return this.service.get(ref);
		}
		/**
		* Delete a single memory by reference.
		*/
		async delete(ref) {
		this.assertInitialized();
		return this.service.delete(ref);
		}
		/**
		* List memories within a scope.
		*/
		async list(request) {
		this.assertInitialized();
		return this.service.list(request);
		}
		/**
		* Report the capability surface of the default (or named) provider.
		*
		* @throws if the named provider is unknown or not initialized.
		*/
		capabilities(providerName) {
		this.assertInitialized();
		return this.service.getProvider(providerName).capabilities();
		}
		/**
		* Resolve a named extension on the default (or named) provider.
		* Returns `undefined` when the provider does not advertise the
		* extension.
		*
		* @throws if the named provider is unknown or not initialized.
		*
		* @example
		* ```ts
		* const pkg = memory.getExtension<Packager>('package');
		* ```
		*/
		getExtension(extensionName, providerName) {
		this.assertInitialized();
		const provider = this.service.getProvider(providerName);
		return provider.getExtension?.(extensionName);
		}
		/**
		* Aggregate status of all configured providers. Never throws:
		* uninitialized providers report `initialized: false` and
		* `capabilities: null`.
		*/
		getProviderStatus() {
		const configured = this.service.getConfiguredProviders();
		const available = new Set(this.service.getAvailableProviders());
		return configured.map((name) => {
		if (!available.has(name)) {
		return { name, initialized: false, capabilities: null };
		}
		return {
		name,
		initialized: true,
		capabilities: this.service.getProvider(name).capabilities()
		};
		});
		}
		/**
		* Access the full AtomicMemory namespace handle (lifecycle, audit,
		* lessons, config, agents). Returns `undefined` when the client is
		* not yet initialized, the `atomicmemory` provider was not included
		* in the `providers` config, or that provider does not advertise the
		* namespace handle. This getter intentionally never throws — callers
		* can guard with a truthy check and let the handle's own methods
		* raise if used incorrectly.
		*/
		get atomicmemory() {
		if (!this.initialized) return void 0;
		if (!this.service.getConfiguredProviders().includes("atomicmemory")) {
		return void 0;
		}
		const provider = this.service.getProvider("atomicmemory");
		return provider.getExtension?.("atomicmemory.base");
		}
		/**
		* Low-level escape hatch for callers that need the concrete provider.
		*/
		getProvider(name) {
		this.assertInitialized();
		return this.service.getProvider(name);
		}
		assertInitialized() {
		if (!this.initialized) {
		throw new Error(
		"MemoryClient is not initialized. Call `await client.initialize()` first."
		);
		}
		}
		};
		function pickFirstProviderKey(providers) {
		for (const [key, value] of Object.entries(providers)) {
		if (value !== void 0 && key !== "default") return key;
		}
		return void 0;
		}

		export { MemoryClient };
		//# sourceMappingURL=chunk-KYVD7KQV.js.map
		//# sourceMappingURL=chunk-KYVD7KQV.js.map

+1

dist/chunk-KYVD7KQV.js.map

+442

dist/chunk-LCCTVUJO.js

		import { validateApiUrl } from './chunk-3HWUP4VL.js';

		// src/storage/errors.ts
		var StorageClientError = class extends Error {
		errorCode;
		status;
		bodyText;
		constructor(args) {
		super(args.message);
		this.name = "StorageClientError";
		this.errorCode = args.errorCode;
		this.status = args.status;
		this.bodyText = args.bodyText;
		}
		};
		var UnsupportedCapabilityError = class extends StorageClientError {
		capability;
		constructor(args) {
		super({
		message: args.message,
		errorCode: "unsupported_capability",
		status: 400,
		bodyText: args.bodyText
		});
		this.name = "UnsupportedCapabilityError";
		this.capability = args.capability;
		}
		};
		var ArtifactNotFoundError = class extends StorageClientError {
		artifactId;
		constructor(args) {
		super({
		message: `Storage artifact ${args.artifactId} not found`,
		errorCode: "artifact_not_found",
		status: 404,
		bodyText: args.bodyText
		});
		this.name = "ArtifactNotFoundError";
		this.artifactId = args.artifactId;
		}
		};
		var ArtifactInUseError = class extends StorageClientError {
		artifactId;
		referencedByDocumentCount;
		constructor(args) {
		super({
		message: `Storage artifact ${args.artifactId} is referenced by ${args.referencedByDocumentCount} document(s); pass 'policy: "with_documents"' to cascade`,
		errorCode: "artifact_in_use",
		status: 409,
		bodyText: args.bodyText
		});
		this.name = "ArtifactInUseError";
		this.artifactId = args.artifactId;
		this.referencedByDocumentCount = args.referencedByDocumentCount;
		}
		};
		var PointerContentNotManagedError = class extends StorageClientError {
		artifactId;
		uri;
		constructor(args) {
		super({
		message: `Artifact ${args.artifactId} is pointer-mode; fetch the URI directly (the server does not proxy pointer content)`,
		errorCode: "pointer_content_not_managed",
		status: 409,
		bodyText: args.bodyText
		});
		this.name = "PointerContentNotManagedError";
		this.artifactId = args.artifactId;
		this.uri = args.uri;
		}
		};
		var FilecoinDirectStorageNotSupportedError = class extends StorageClientError {
		constructor(args) {
		super({
		message: "Direct Filecoin artifact uploads are not supported in this version. Use document ingestion or pointer mode.",
		errorCode: "filecoin_direct_storage_not_yet_supported",
		status: 501,
		bodyText: args.bodyText
		});
		this.name = "FilecoinDirectStorageNotSupportedError";
		}
		};

		// src/storage/client.ts
		var METADATA_HEADER = "X-AtomicMemory-Metadata";
		var ConcreteStorageClient = class {
		apiUrl;
		apiKey;
		userId;
		fetchImpl;
		constructor(config) {
		if (!config.apiUrl) throw new Error("StorageClient: apiUrl is required");
		if (!config.apiKey) throw new Error("StorageClient: apiKey is required");
		if (!config.userId) throw new Error("StorageClient: userId is required");
		this.apiUrl = validateApiUrl(config.apiUrl, {
		allowPrivateNetworks: config.allowPrivateNetworks
		}).replace(/\/+$/, "");
		this.apiKey = config.apiKey;
		this.userId = config.userId;
		this.fetchImpl = config.fetch ?? fetch;
		}
		async capabilities() {
		const res = await this.request("GET", "/v1/storage/capabilities");
		return await res.json();
		}
		async put(input) {
		if (input.mode === "pointer") return this.putPointer(input);
		return this.putManaged(input);
		}
		async get(ref) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("GET", `/v1/storage/artifacts/${id}`, {}, id);
		return mapStoredArtifact(await res.json());
		}
		async getContent(ref) {
		const id = this.requireArtifactId(ref);
		return this.request("GET", `/v1/storage/artifacts/${id}/content`, {}, id);
		}
		async head(ref) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("HEAD", `/v1/storage/artifacts/${id}`, {}, id);
		return mapHeadHeaders(res.headers, id);
		}
		async delete(ref, options) {
		const id = this.requireArtifactId(ref);
		const query = options?.policy ? `?policy=${encodeURIComponent(options.policy)}` : "";
		const res = await this.request("DELETE", `/v1/storage/artifacts/${id}${query}`, {}, id);
		return mapDeleteResult(await res.json());
		}
		async verify(ref, _options) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("POST", `/v1/storage/artifacts/${id}/verify`, {}, id);
		return mapVerifyResult(await res.json());
		}
		async putPointer(input) {
		const body = {
		mode: "pointer",
		uri: input.uri,
		content_type: input.contentType,
		...input.sizeBytes !== void 0 ? { size_bytes: input.sizeBytes } : {},
		...input.contentHash !== void 0 ? { content_hash: input.contentHash } : {},
		...input.metadata !== void 0 ? { metadata: input.metadata } : {}
		};
		const res = await this.request("POST", "/v1/storage/artifacts", {
		headers: { "Content-Type": "application/json" },
		body: JSON.stringify(body)
		});
		return mapStoredArtifact(await res.json());
		}
		async putManaged(input) {
		const view = coerceManagedBody(input.body);
		const params = new URLSearchParams({ mode: "managed" });
		if (input.discloseContentHash === true) params.set("disclose_content_hash", "true");
		const headers = {
		"Content-Type": input.contentType,
		"Content-Length": String(view.byteLength)
		};
		if (input.metadata !== void 0) {
		headers[METADATA_HEADER] = encodeMetadataHeader(input.metadata);
		}
		const res = await this.request(
		"POST",
		`/v1/storage/artifacts?${params.toString()}`,
		// Cast: Node's fetch accepts Uint8Array as BodyInit, but the
		// shared lib.dom type predates that. Sending the view directly
		// is intentional — see the comment above coerceManagedBody.
		{ headers, body: view }
		);
		return mapStoredArtifact(await res.json());
		}
		/**
		* Send a request to the storage API and map non-2xx responses to
		* typed errors. Callers receive the raw `Response` on success and
		* read the body themselves so streaming reads (e.g. getContent)
		* can stay zero-copy.
		*
		* Auth contract: owner identity travels on the
		* `X-AtomicMemory-User-Id` request header alongside the
		* deployment-wide `Authorization: Bearer <apiKey>`. The legacy
		* `?user_id=` URL parameter is NEVER serialized — the server's
		* auth middleware rejects it with 400 `legacy_user_id_unsupported`.
		*
		* Transport-level fetch failures (DNS, ECONNREFUSED, AbortError,
		* a misconfigured fetch impl that throws synchronously) are
		* wrapped as `StorageClientError({errorCode:'network_error',
		* status:0})` so callers can branch on a stable error contract
		* instead of catching arbitrary `TypeError`s.
		*
		* `artifactId`, when supplied, threads into the error mapper so
		* `ArtifactNotFoundError` / `ArtifactInUseError` /
		* `PointerContentNotManagedError` carry the id the caller already
		* knows. The capabilities route omits it (no artifact context).
		*/
		async request(method, path, init = {}, artifactId) {
		const url = `${this.apiUrl}${path}`;
		let res;
		try {
		res = await this.fetchImpl(url, {
		method,
		headers: {
		Authorization: `Bearer ${this.apiKey}`,
		"X-AtomicMemory-User-Id": this.userId,
		...init.headers ?? {}
		},
		body: init.body
		});
		} catch (cause) {
		throw new StorageClientError({
		message: `Network error while calling ${method} ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,
		errorCode: "network_error",
		status: 0,
		bodyText: ""
		});
		}
		if (res.ok) return res;
		await throwForResponse(res, artifactId);
		throw new StorageClientError({
		message: `unexpected non-ok response (${res.status})`,
		errorCode: "unexpected_response",
		status: res.status,
		bodyText: ""
		});
		}
		requireArtifactId(ref) {
		if (!ref.artifactId) {
		throw new StorageClientError({
		message: "ArtifactRef.artifactId is required for this operation in v1",
		errorCode: "missing_artifact_id",
		status: 0,
		bodyText: ""
		});
		}
		return ref.artifactId;
		}
		};
		var STORAGE_MODES = ["pointer", "managed"];
		var STORAGE_STATUSES = [
		"stored",
		"pending",
		"available",
		"unavailable",
		"deleting",
		"deleted",
		"delete_failed",
		"failed"
		];
		var CONTENT_ENCODINGS = ["identity", "aes_gcm"];
		function parseSize(value) {
		if (value === null) return null;
		const n = Number(value);
		if (!Number.isFinite(n) \|\| n < 0) return null;
		return n;
		}
		function mapHeadHeaders(headers, fallbackId) {
		const modeRaw = headers.get("x-atomicmemory-storage-mode");
		const statusRaw = headers.get("x-atomicmemory-storage-status");
		if (modeRaw === null \|\| !STORAGE_MODES.includes(modeRaw)) {
		throw new StorageClientError({
		message: `head(): server returned an unrecognized x-atomicmemory-storage-mode value ('${modeRaw ?? "<missing>"}'). Expected one of: ${STORAGE_MODES.join(", ")}.`,
		errorCode: "invalid_head_response",
		status: 200,
		bodyText: ""
		});
		}
		if (statusRaw === null \|\| !STORAGE_STATUSES.includes(statusRaw)) {
		throw new StorageClientError({
		message: `head(): server returned an unrecognized x-atomicmemory-storage-status value ('${statusRaw ?? "<missing>"}'). Expected one of: ${STORAGE_STATUSES.join(", ")}.`,
		errorCode: "invalid_head_response",
		status: 200,
		bodyText: ""
		});
		}
		return {
		artifactId: headers.get("x-atomicmemory-artifact-id") ?? fallbackId,
		provider: headers.get("x-atomicmemory-provider") ?? "",
		mode: modeRaw,
		status: statusRaw,
		sizeBytes: parseSize(headers.get("content-length")),
		contentType: headers.get("content-type")
		};
		}
		function coerceManagedBody(body) {
		if (Buffer.isBuffer(body)) {
		return new Uint8Array(body.buffer, body.byteOffset, body.byteLength);
		}
		if (body instanceof Uint8Array) return body;
		if (body instanceof ArrayBuffer) return new Uint8Array(body);
		if (typeof Blob !== "undefined" && body instanceof Blob) {
		throw new StorageClientError({
		message: "StorageClient.put: Blob input must be converted to Buffer / Uint8Array / ArrayBuffer before calling put(). Use `new Uint8Array(await blob.arrayBuffer())`.",
		errorCode: "unsupported_body_type",
		status: 0,
		bodyText: ""
		});
		}
		throw new StorageClientError({
		message: "StorageClient.put: only Buffer / Uint8Array / ArrayBuffer are accepted in v1. Streaming body uploads land in the Streaming + Resumable Uploads PR.",
		errorCode: "streaming_body_not_supported",
		status: 0,
		bodyText: ""
		});
		}
		function encodeMetadataHeader(metadata) {
		return Buffer.from(JSON.stringify(metadata), "utf8").toString("base64");
		}
		function mapStoredArtifact(raw) {
		const artifactId = requireWireString(raw, "artifact_id");
		const provider = requireWireString(raw, "provider");
		const mode = requireWireEnum(raw, "mode", STORAGE_MODES);
		const status = requireWireEnum(raw, "status", STORAGE_STATUSES);
		const contentEncoding = requireWireEnum(
		raw,
		"content_encoding",
		CONTENT_ENCODINGS
		);
		const createdAt = requireWireString(raw, "created_at");
		const updatedAt = requireWireString(raw, "updated_at");
		const out = {
		artifactId,
		provider,
		mode,
		uri: typeof raw.uri === "string" ? raw.uri : null,
		status,
		sizeBytes: typeof raw.size_bytes === "number" ? raw.size_bytes : null,
		contentType: typeof raw.content_type === "string" ? raw.content_type : null,
		contentEncoding,
		identifiers: raw.identifiers ?? {},
		lifecycle: raw.lifecycle ?? {},
		metadata: raw.metadata ?? {},
		createdAt,
		updatedAt
		};
		if (typeof raw.content_hash === "string") out.contentHash = raw.content_hash;
		if (raw.provider_details && typeof raw.provider_details === "object") {
		out.providerDetails = raw.provider_details;
		}
		if (raw.replication && typeof raw.replication === "object") {
		out.replication = raw.replication;
		}
		if (raw.verification && typeof raw.verification === "object") {
		out.verification = raw.verification;
		}
		if (raw.retrieval && typeof raw.retrieval === "object") {
		out.retrieval = raw.retrieval;
		}
		return out;
		}
		function requireWireString(raw, field) {
		const value = raw[field];
		if (typeof value !== "string" \|\| value.length === 0) {
		throw new StorageClientError({
		message: `mapStoredArtifact: server response is missing required \`${field}\` (or it is not a non-empty string). The storage API contract requires it.`,
		errorCode: "invalid_storage_response",
		status: 200,
		bodyText: ""
		});
		}
		return value;
		}
		function requireWireEnum(raw, field, allowed) {
		const value = raw[field];
		if (typeof value !== "string" \|\| !allowed.includes(value)) {
		throw new StorageClientError({
		message: `mapStoredArtifact: server response field \`${field}\` is not in the SDK's closed enum. Got '${String(value ?? "<missing>")}', expected one of: ${allowed.join(", ")}.`,
		errorCode: "invalid_storage_response",
		status: 200,
		bodyText: ""
		});
		}
		return value;
		}
		function mapDeleteResult(raw) {
		const artifactId = requireWireString(raw, "artifact_id");
		const status = requireWireEnum(raw, "status", STORAGE_STATUSES);
		const out = { artifactId, status };
		if (Array.isArray(raw.cascaded_document_ids)) {
		out.cascadedDocumentIds = raw.cascaded_document_ids.map(String);
		}
		return out;
		}
		function mapVerifyResult(raw) {
		const kind = raw.kind;
		if (kind === "verified") {
		return { kind: "verified", details: raw.details ?? {} };
		}
		if (kind === "failed") {
		return { kind: "failed", reason: String(raw.reason ?? "unknown failure") };
		}
		return { kind: "unsupported", reason: String(raw.reason ?? "unsupported") };
		}
		async function throwForResponse(res, artifactId) {
		const bodyText = await res.text();
		const envelope = parseEnvelope(bodyText);
		const code = envelope.error_code;
		const message = envelope.error ?? `request failed with status ${res.status}`;
		const id = artifactId ?? "";
		if (code === "artifact_in_use") {
		throw new ArtifactInUseError({
		artifactId: id,
		referencedByDocumentCount: envelope.referenced_by_document_count ?? 0,
		bodyText
		});
		}
		if (code === "pointer_content_not_managed") {
		throw new PointerContentNotManagedError({
		artifactId: id,
		uri: envelope.uri ?? "",
		bodyText
		});
		}
		if (code === "filecoin_direct_storage_not_yet_supported") {
		throw new FilecoinDirectStorageNotSupportedError({ bodyText });
		}
		if (code === "artifact_not_found" \|\| res.status === 404) {
		throw new ArtifactNotFoundError({ artifactId: id, bodyText });
		}
		if (code === "unsupported_capability") {
		throw new UnsupportedCapabilityError({
		capability: "unknown",
		message,
		bodyText
		});
		}
		throw new StorageClientError({
		message,
		errorCode: code ?? `http_${res.status}`,
		status: res.status,
		bodyText
		});
		}
		function parseEnvelope(bodyText) {
		if (bodyText.length === 0) return {};
		try {
		return JSON.parse(bodyText);
		} catch {
		return {};
		}
		}

		export { ArtifactInUseError, ArtifactNotFoundError, ConcreteStorageClient, FilecoinDirectStorageNotSupportedError, PointerContentNotManagedError, StorageClientError, UnsupportedCapabilityError };
		//# sourceMappingURL=chunk-LCCTVUJO.js.map
		//# sourceMappingURL=chunk-LCCTVUJO.js.map

+1

dist/chunk-LCCTVUJO.js.map

+450

dist/chunk-LPC54QOU.cjs

		'use strict';

		var chunkMIG2OG5Z_cjs = require('./chunk-MIG2OG5Z.cjs');

		// src/storage/errors.ts
		var StorageClientError = class extends Error {
		errorCode;
		status;
		bodyText;
		constructor(args) {
		super(args.message);
		this.name = "StorageClientError";
		this.errorCode = args.errorCode;
		this.status = args.status;
		this.bodyText = args.bodyText;
		}
		};
		var UnsupportedCapabilityError = class extends StorageClientError {
		capability;
		constructor(args) {
		super({
		message: args.message,
		errorCode: "unsupported_capability",
		status: 400,
		bodyText: args.bodyText
		});
		this.name = "UnsupportedCapabilityError";
		this.capability = args.capability;
		}
		};
		var ArtifactNotFoundError = class extends StorageClientError {
		artifactId;
		constructor(args) {
		super({
		message: `Storage artifact ${args.artifactId} not found`,
		errorCode: "artifact_not_found",
		status: 404,
		bodyText: args.bodyText
		});
		this.name = "ArtifactNotFoundError";
		this.artifactId = args.artifactId;
		}
		};
		var ArtifactInUseError = class extends StorageClientError {
		artifactId;
		referencedByDocumentCount;
		constructor(args) {
		super({
		message: `Storage artifact ${args.artifactId} is referenced by ${args.referencedByDocumentCount} document(s); pass 'policy: "with_documents"' to cascade`,
		errorCode: "artifact_in_use",
		status: 409,
		bodyText: args.bodyText
		});
		this.name = "ArtifactInUseError";
		this.artifactId = args.artifactId;
		this.referencedByDocumentCount = args.referencedByDocumentCount;
		}
		};
		var PointerContentNotManagedError = class extends StorageClientError {
		artifactId;
		uri;
		constructor(args) {
		super({
		message: `Artifact ${args.artifactId} is pointer-mode; fetch the URI directly (the server does not proxy pointer content)`,
		errorCode: "pointer_content_not_managed",
		status: 409,
		bodyText: args.bodyText
		});
		this.name = "PointerContentNotManagedError";
		this.artifactId = args.artifactId;
		this.uri = args.uri;
		}
		};
		var FilecoinDirectStorageNotSupportedError = class extends StorageClientError {
		constructor(args) {
		super({
		message: "Direct Filecoin artifact uploads are not supported in this version. Use document ingestion or pointer mode.",
		errorCode: "filecoin_direct_storage_not_yet_supported",
		status: 501,
		bodyText: args.bodyText
		});
		this.name = "FilecoinDirectStorageNotSupportedError";
		}
		};

		// src/storage/client.ts
		var METADATA_HEADER = "X-AtomicMemory-Metadata";
		var ConcreteStorageClient = class {
		apiUrl;
		apiKey;
		userId;
		fetchImpl;
		constructor(config) {
		if (!config.apiUrl) throw new Error("StorageClient: apiUrl is required");
		if (!config.apiKey) throw new Error("StorageClient: apiKey is required");
		if (!config.userId) throw new Error("StorageClient: userId is required");
		this.apiUrl = chunkMIG2OG5Z_cjs.validateApiUrl(config.apiUrl, {
		allowPrivateNetworks: config.allowPrivateNetworks
		}).replace(/\/+$/, "");
		this.apiKey = config.apiKey;
		this.userId = config.userId;
		this.fetchImpl = config.fetch ?? fetch;
		}
		async capabilities() {
		const res = await this.request("GET", "/v1/storage/capabilities");
		return await res.json();
		}
		async put(input) {
		if (input.mode === "pointer") return this.putPointer(input);
		return this.putManaged(input);
		}
		async get(ref) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("GET", `/v1/storage/artifacts/${id}`, {}, id);
		return mapStoredArtifact(await res.json());
		}
		async getContent(ref) {
		const id = this.requireArtifactId(ref);
		return this.request("GET", `/v1/storage/artifacts/${id}/content`, {}, id);
		}
		async head(ref) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("HEAD", `/v1/storage/artifacts/${id}`, {}, id);
		return mapHeadHeaders(res.headers, id);
		}
		async delete(ref, options) {
		const id = this.requireArtifactId(ref);
		const query = options?.policy ? `?policy=${encodeURIComponent(options.policy)}` : "";
		const res = await this.request("DELETE", `/v1/storage/artifacts/${id}${query}`, {}, id);
		return mapDeleteResult(await res.json());
		}
		async verify(ref, _options) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("POST", `/v1/storage/artifacts/${id}/verify`, {}, id);
		return mapVerifyResult(await res.json());
		}
		async putPointer(input) {
		const body = {
		mode: "pointer",
		uri: input.uri,
		content_type: input.contentType,
		...input.sizeBytes !== void 0 ? { size_bytes: input.sizeBytes } : {},
		...input.contentHash !== void 0 ? { content_hash: input.contentHash } : {},
		...input.metadata !== void 0 ? { metadata: input.metadata } : {}
		};
		const res = await this.request("POST", "/v1/storage/artifacts", {
		headers: { "Content-Type": "application/json" },
		body: JSON.stringify(body)
		});
		return mapStoredArtifact(await res.json());
		}
		async putManaged(input) {
		const view = coerceManagedBody(input.body);
		const params = new URLSearchParams({ mode: "managed" });
		if (input.discloseContentHash === true) params.set("disclose_content_hash", "true");
		const headers = {
		"Content-Type": input.contentType,
		"Content-Length": String(view.byteLength)
		};
		if (input.metadata !== void 0) {
		headers[METADATA_HEADER] = encodeMetadataHeader(input.metadata);
		}
		const res = await this.request(
		"POST",
		`/v1/storage/artifacts?${params.toString()}`,
		// Cast: Node's fetch accepts Uint8Array as BodyInit, but the
		// shared lib.dom type predates that. Sending the view directly
		// is intentional — see the comment above coerceManagedBody.
		{ headers, body: view }
		);
		return mapStoredArtifact(await res.json());
		}
		/**
		* Send a request to the storage API and map non-2xx responses to
		* typed errors. Callers receive the raw `Response` on success and
		* read the body themselves so streaming reads (e.g. getContent)
		* can stay zero-copy.
		*
		* Auth contract: owner identity travels on the
		* `X-AtomicMemory-User-Id` request header alongside the
		* deployment-wide `Authorization: Bearer <apiKey>`. The legacy
		* `?user_id=` URL parameter is NEVER serialized — the server's
		* auth middleware rejects it with 400 `legacy_user_id_unsupported`.
		*
		* Transport-level fetch failures (DNS, ECONNREFUSED, AbortError,
		* a misconfigured fetch impl that throws synchronously) are
		* wrapped as `StorageClientError({errorCode:'network_error',
		* status:0})` so callers can branch on a stable error contract
		* instead of catching arbitrary `TypeError`s.
		*
		* `artifactId`, when supplied, threads into the error mapper so
		* `ArtifactNotFoundError` / `ArtifactInUseError` /
		* `PointerContentNotManagedError` carry the id the caller already
		* knows. The capabilities route omits it (no artifact context).
		*/
		async request(method, path, init = {}, artifactId) {
		const url = `${this.apiUrl}${path}`;
		let res;
		try {
		res = await this.fetchImpl(url, {
		method,
		headers: {
		Authorization: `Bearer ${this.apiKey}`,
		"X-AtomicMemory-User-Id": this.userId,
		...init.headers ?? {}
		},
		body: init.body
		});
		} catch (cause) {
		throw new StorageClientError({
		message: `Network error while calling ${method} ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,
		errorCode: "network_error",
		status: 0,
		bodyText: ""
		});
		}
		if (res.ok) return res;
		await throwForResponse(res, artifactId);
		throw new StorageClientError({
		message: `unexpected non-ok response (${res.status})`,
		errorCode: "unexpected_response",
		status: res.status,
		bodyText: ""
		});
		}
		requireArtifactId(ref) {
		if (!ref.artifactId) {
		throw new StorageClientError({
		message: "ArtifactRef.artifactId is required for this operation in v1",
		errorCode: "missing_artifact_id",
		status: 0,
		bodyText: ""
		});
		}
		return ref.artifactId;
		}
		};
		var STORAGE_MODES = ["pointer", "managed"];
		var STORAGE_STATUSES = [
		"stored",
		"pending",
		"available",
		"unavailable",
		"deleting",
		"deleted",
		"delete_failed",
		"failed"
		];
		var CONTENT_ENCODINGS = ["identity", "aes_gcm"];
		function parseSize(value) {
		if (value === null) return null;
		const n = Number(value);
		if (!Number.isFinite(n) \|\| n < 0) return null;
		return n;
		}
		function mapHeadHeaders(headers, fallbackId) {
		const modeRaw = headers.get("x-atomicmemory-storage-mode");
		const statusRaw = headers.get("x-atomicmemory-storage-status");
		if (modeRaw === null \|\| !STORAGE_MODES.includes(modeRaw)) {
		throw new StorageClientError({
		message: `head(): server returned an unrecognized x-atomicmemory-storage-mode value ('${modeRaw ?? "<missing>"}'). Expected one of: ${STORAGE_MODES.join(", ")}.`,
		errorCode: "invalid_head_response",
		status: 200,
		bodyText: ""
		});
		}
		if (statusRaw === null \|\| !STORAGE_STATUSES.includes(statusRaw)) {
		throw new StorageClientError({
		message: `head(): server returned an unrecognized x-atomicmemory-storage-status value ('${statusRaw ?? "<missing>"}'). Expected one of: ${STORAGE_STATUSES.join(", ")}.`,
		errorCode: "invalid_head_response",
		status: 200,
		bodyText: ""
		});
		}
		return {
		artifactId: headers.get("x-atomicmemory-artifact-id") ?? fallbackId,
		provider: headers.get("x-atomicmemory-provider") ?? "",
		mode: modeRaw,
		status: statusRaw,
		sizeBytes: parseSize(headers.get("content-length")),
		contentType: headers.get("content-type")
		};
		}
		function coerceManagedBody(body) {
		if (Buffer.isBuffer(body)) {
		return new Uint8Array(body.buffer, body.byteOffset, body.byteLength);
		}
		if (body instanceof Uint8Array) return body;
		if (body instanceof ArrayBuffer) return new Uint8Array(body);
		if (typeof Blob !== "undefined" && body instanceof Blob) {
		throw new StorageClientError({
		message: "StorageClient.put: Blob input must be converted to Buffer / Uint8Array / ArrayBuffer before calling put(). Use `new Uint8Array(await blob.arrayBuffer())`.",
		errorCode: "unsupported_body_type",
		status: 0,
		bodyText: ""
		});
		}
		throw new StorageClientError({
		message: "StorageClient.put: only Buffer / Uint8Array / ArrayBuffer are accepted in v1. Streaming body uploads land in the Streaming + Resumable Uploads PR.",
		errorCode: "streaming_body_not_supported",
		status: 0,
		bodyText: ""
		});
		}
		function encodeMetadataHeader(metadata) {
		return Buffer.from(JSON.stringify(metadata), "utf8").toString("base64");
		}
		function mapStoredArtifact(raw) {
		const artifactId = requireWireString(raw, "artifact_id");
		const provider = requireWireString(raw, "provider");
		const mode = requireWireEnum(raw, "mode", STORAGE_MODES);
		const status = requireWireEnum(raw, "status", STORAGE_STATUSES);
		const contentEncoding = requireWireEnum(
		raw,
		"content_encoding",
		CONTENT_ENCODINGS
		);
		const createdAt = requireWireString(raw, "created_at");
		const updatedAt = requireWireString(raw, "updated_at");
		const out = {
		artifactId,
		provider,
		mode,
		uri: typeof raw.uri === "string" ? raw.uri : null,
		status,
		sizeBytes: typeof raw.size_bytes === "number" ? raw.size_bytes : null,
		contentType: typeof raw.content_type === "string" ? raw.content_type : null,
		contentEncoding,
		identifiers: raw.identifiers ?? {},
		lifecycle: raw.lifecycle ?? {},
		metadata: raw.metadata ?? {},
		createdAt,
		updatedAt
		};
		if (typeof raw.content_hash === "string") out.contentHash = raw.content_hash;
		if (raw.provider_details && typeof raw.provider_details === "object") {
		out.providerDetails = raw.provider_details;
		}
		if (raw.replication && typeof raw.replication === "object") {
		out.replication = raw.replication;
		}
		if (raw.verification && typeof raw.verification === "object") {
		out.verification = raw.verification;
		}
		if (raw.retrieval && typeof raw.retrieval === "object") {
		out.retrieval = raw.retrieval;
		}
		return out;
		}
		function requireWireString(raw, field) {
		const value = raw[field];
		if (typeof value !== "string" \|\| value.length === 0) {
		throw new StorageClientError({
		message: `mapStoredArtifact: server response is missing required \`${field}\` (or it is not a non-empty string). The storage API contract requires it.`,
		errorCode: "invalid_storage_response",
		status: 200,
		bodyText: ""
		});
		}
		return value;
		}
		function requireWireEnum(raw, field, allowed) {
		const value = raw[field];
		if (typeof value !== "string" \|\| !allowed.includes(value)) {
		throw new StorageClientError({
		message: `mapStoredArtifact: server response field \`${field}\` is not in the SDK's closed enum. Got '${String(value ?? "<missing>")}', expected one of: ${allowed.join(", ")}.`,
		errorCode: "invalid_storage_response",
		status: 200,
		bodyText: ""
		});
		}
		return value;
		}
		function mapDeleteResult(raw) {
		const artifactId = requireWireString(raw, "artifact_id");
		const status = requireWireEnum(raw, "status", STORAGE_STATUSES);
		const out = { artifactId, status };
		if (Array.isArray(raw.cascaded_document_ids)) {
		out.cascadedDocumentIds = raw.cascaded_document_ids.map(String);
		}
		return out;
		}
		function mapVerifyResult(raw) {
		const kind = raw.kind;
		if (kind === "verified") {
		return { kind: "verified", details: raw.details ?? {} };
		}
		if (kind === "failed") {
		return { kind: "failed", reason: String(raw.reason ?? "unknown failure") };
		}
		return { kind: "unsupported", reason: String(raw.reason ?? "unsupported") };
		}
		async function throwForResponse(res, artifactId) {
		const bodyText = await res.text();
		const envelope = parseEnvelope(bodyText);
		const code = envelope.error_code;
		const message = envelope.error ?? `request failed with status ${res.status}`;
		const id = artifactId ?? "";
		if (code === "artifact_in_use") {
		throw new ArtifactInUseError({
		artifactId: id,
		referencedByDocumentCount: envelope.referenced_by_document_count ?? 0,
		bodyText
		});
		}
		if (code === "pointer_content_not_managed") {
		throw new PointerContentNotManagedError({
		artifactId: id,
		uri: envelope.uri ?? "",
		bodyText
		});
		}
		if (code === "filecoin_direct_storage_not_yet_supported") {
		throw new FilecoinDirectStorageNotSupportedError({ bodyText });
		}
		if (code === "artifact_not_found" \|\| res.status === 404) {
		throw new ArtifactNotFoundError({ artifactId: id, bodyText });
		}
		if (code === "unsupported_capability") {
		throw new UnsupportedCapabilityError({
		capability: "unknown",
		message,
		bodyText
		});
		}
		throw new StorageClientError({
		message,
		errorCode: code ?? `http_${res.status}`,
		status: res.status,
		bodyText
		});
		}
		function parseEnvelope(bodyText) {
		if (bodyText.length === 0) return {};
		try {
		return JSON.parse(bodyText);
		} catch {
		return {};
		}
		}

		exports.ArtifactInUseError = ArtifactInUseError;
		exports.ArtifactNotFoundError = ArtifactNotFoundError;
		exports.ConcreteStorageClient = ConcreteStorageClient;
		exports.FilecoinDirectStorageNotSupportedError = FilecoinDirectStorageNotSupportedError;
		exports.PointerContentNotManagedError = PointerContentNotManagedError;
		exports.StorageClientError = StorageClientError;
		exports.UnsupportedCapabilityError = UnsupportedCapabilityError;
		//# sourceMappingURL=chunk-LPC54QOU.cjs.map
		//# sourceMappingURL=chunk-LPC54QOU.cjs.map

+1

dist/chunk-LPC54QOU.cjs.map

+78

dist/chunk-MIG2OG5Z.cjs

		'use strict';

		var net = require('net');

		// src/utils/validate-api-url.ts
		function isLinkLocalIpv4([a, b]) {
		return a === 169 && b === 254;
		}
		function isPrivateIpv4([a, b]) {
		return a === 10 \|\| a === 172 && b >= 16 && b <= 31 \|\| a === 192 && b === 168 \|\| a === 100 && b >= 64 && b <= 127;
		}
		function isSpecialIpv4([a, b, c, d]) {
		const loopback = a === 127;
		const unspecified = a === 0;
		const broadcast = a === 255 && b === 255 && c === 255 && d === 255;
		const reserved = a === 192 && b === 0 && c === 0 \|\| a >= 240;
		const multicast = a >= 224 && a <= 239;
		return loopback \|\| unspecified \|\| broadcast \|\| reserved \|\| multicast;
		}
		function classifyIpv4(host) {
		const octets = host.split(".").map(Number);
		return {
		linkLocal: isLinkLocalIpv4(octets),
		blockedByDefault: isPrivateIpv4(octets) \|\| isSpecialIpv4(octets)
		};
		}
		function mappedIpv4(host) {
		const rest = host.toLowerCase().match(/^::ffff:(.+)$/)?.[1];
		if (rest === void 0) return null;
		if (/^\d{1,3}(\.\d{1,3}){3}$/.test(rest)) return rest;
		const pair = rest.match(/^([0-9a-f]{1,4}):([0-9a-f]{1,4})$/);
		if (!pair) return null;
		const hi = parseInt(pair[1], 16);
		const lo = parseInt(pair[2], 16);
		return `${hi >> 8 & 255}.${hi & 255}.${lo >> 8 & 255}.${lo & 255}`;
		}
		function classifyIpv6(host) {
		const mapped = mappedIpv4(host);
		if (mapped) return classifyIpv4(mapped);
		const lower = host.toLowerCase();
		return {
		linkLocal: /^fe[89ab]/.test(lower),
		// fe80::/10
		blockedByDefault: lower === "::1" \|\| lower === "::" \|\| /^f[cd]/.test(lower)
		// loopback, unspecified, fc00::/7 ULA
		};
		}
		function validateApiUrl(value, options = {}) {
		const stripped = value.trim();
		let parsed;
		try {
		parsed = new URL(stripped);
		} catch {
		throw new Error("api_url must be an http(s) URL");
		}
		if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
		throw new Error("api_url must be an http(s) URL");
		}
		const host = parsed.hostname.replace(/^\[\|\]$/g, "");
		if (!host) throw new Error("api_url must include a host");
		const kind = net.isIP(host);
		if (kind === 0) return stripped;
		const ipClass = kind === 4 ? classifyIpv4(host) : classifyIpv6(host);
		if (ipClass.linkLocal) {
		throw new Error("api_url must not target a link-local or cloud-metadata address");
		}
		const allowPrivate = options.allowPrivateNetworks ?? true;
		if (!allowPrivate && ipClass.blockedByDefault) {
		throw new Error(
		"api_url must not target a loopback, private, or reserved address; set allowPrivateNetworks=true to permit it"
		);
		}
		return stripped;
		}

		exports.validateApiUrl = validateApiUrl;
		//# sourceMappingURL=chunk-MIG2OG5Z.cjs.map
		//# sourceMappingURL=chunk-MIG2OG5Z.cjs.map

+1

dist/chunk-MIG2OG5Z.cjs.map

dist/chunk-WSP2HCUV.cjs

Sorry, the diff of this file is too big to display

dist/chunk-WSP2HCUV.cjs.map

Sorry, the diff of this file is too big to display

dist/hindsight-provider-2_IU9rqm.d.cts

Sorry, the diff of this file is too big to display

dist/hindsight-provider-2_IU9rqm.d.ts

Sorry, the diff of this file is too big to display

+5

-0

CHANGELOG.md

		@@ -9,2 +9,7 @@ # Changelog

		## [1.1.1] - 2026-06-16

		### Security
		- Hardened client configuration validation. Upgrade recommended.

		## [1.0.1] - 2026-05-14
		@@ -11,0 +16,0 @@

+23

-22

dist/browser.cjs

		'use strict';

		var chunkKIUVJBBH_cjs = require('./chunk-KIUVJBBH.cjs');
		var chunkNULA3B6E_cjs = require('./chunk-NULA3B6E.cjs');
		var chunkAQHNXVMQ_cjs = require('./chunk-AQHNXVMQ.cjs');
		var chunkWSP2HCUV_cjs = require('./chunk-WSP2HCUV.cjs');
		require('./chunk-MIG2OG5Z.cjs');

		@@ -10,81 +11,81 @@
		enumerable: true,
		get: function () { return chunkKIUVJBBH_cjs.MemoryClient; }
		get: function () { return chunkAQHNXVMQ_cjs.MemoryClient; }
		});
		Object.defineProperty(exports, "ATOMICMEMORY_DEFAULT_TIMEOUT", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.ATOMICMEMORY_DEFAULT_TIMEOUT; }
		get: function () { return chunkWSP2HCUV_cjs.ATOMICMEMORY_DEFAULT_TIMEOUT; }
		});
		Object.defineProperty(exports, "ATOMICMEMORY_EXTENSION_NAMES", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.ATOMICMEMORY_EXTENSION_NAMES; }
		get: function () { return chunkWSP2HCUV_cjs.ATOMICMEMORY_EXTENSION_NAMES; }
		});
		Object.defineProperty(exports, "AtomicMemoryProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.AtomicMemoryProvider; }
		get: function () { return chunkWSP2HCUV_cjs.AtomicMemoryProvider; }
		});
		Object.defineProperty(exports, "BaseMemoryProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.BaseMemoryProvider; }
		get: function () { return chunkWSP2HCUV_cjs.BaseMemoryProvider; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_API_VERSION", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_API_VERSION; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_API_VERSION; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_MAX_TOKENS", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_MAX_TOKENS; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_MAX_TOKENS; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_PROJECT_ID", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_PROJECT_ID; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_PROJECT_ID; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_TIMEOUT", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_TIMEOUT; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_TIMEOUT; }
		});
		Object.defineProperty(exports, "HINDSIGHT_SCOPE_TAGS_MATCH", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_SCOPE_TAGS_MATCH; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_SCOPE_TAGS_MATCH; }
		});
		Object.defineProperty(exports, "HindsightProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HindsightProvider; }
		get: function () { return chunkWSP2HCUV_cjs.HindsightProvider; }
		});
		Object.defineProperty(exports, "InvalidScopeError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.InvalidScopeError; }
		get: function () { return chunkWSP2HCUV_cjs.InvalidScopeError; }
		});
		Object.defineProperty(exports, "MEM0_DEFAULT_TIMEOUT", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.MEM0_DEFAULT_TIMEOUT; }
		get: function () { return chunkWSP2HCUV_cjs.MEM0_DEFAULT_TIMEOUT; }
		});
		Object.defineProperty(exports, "Mem0ContextProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.Mem0ContextProvider; }
		get: function () { return chunkWSP2HCUV_cjs.Mem0ContextProvider; }
		});
		Object.defineProperty(exports, "Mem0Provider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.Mem0Provider; }
		get: function () { return chunkWSP2HCUV_cjs.Mem0Provider; }
		});
		Object.defineProperty(exports, "MemoryProviderError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.MemoryProviderError; }
		get: function () { return chunkWSP2HCUV_cjs.MemoryProviderError; }
		});
		Object.defineProperty(exports, "MemoryTransportError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.MemoryTransportError; }
		get: function () { return chunkWSP2HCUV_cjs.MemoryTransportError; }
		});
		Object.defineProperty(exports, "RateLimitError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.RateLimitError; }
		get: function () { return chunkWSP2HCUV_cjs.RateLimitError; }
		});
		Object.defineProperty(exports, "UnsupportedOperationError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.UnsupportedOperationError; }
		get: function () { return chunkWSP2HCUV_cjs.UnsupportedOperationError; }
		});
		Object.defineProperty(exports, "noopMemoryPipeline", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.noopMemoryPipeline; }
		get: function () { return chunkWSP2HCUV_cjs.noopMemoryPipeline; }
		});
		//# sourceMappingURL=browser.cjs.map
		//# sourceMappingURL=browser.cjs.map

+2

-2

dist/browser.d.cts

		@@ -1,3 +0,3 @@
		import { aM as MemoryProviderRegistration, s as AtomicMemoryProviderConfig, aF as Mem0ProviderConfig, ah as HindsightProviderConfig, ap as IngestInput, aq as IngestResult, b9 as SearchRequest, bb as SearchResultPage, aX as PackageRequest, Q as ContextPackage, aN as MemoryRef, aG as Memory, az as ListRequest, aA as ListResultPage, F as Capabilities, i as AtomicMemoryHandle, aJ as MemoryProvider } from './hindsight-provider-CbfXnvx7.cjs';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aH as MemoryKind, aI as MemoryProcessingPipeline, aK as MemoryProviderEntry, aL as MemoryProviderError, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, ba as SearchResult, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bm as noopMemoryPipeline } from './hindsight-provider-CbfXnvx7.cjs';
		import { aM as MemoryProviderRegistration, s as AtomicMemoryProviderConfig, aF as Mem0ProviderConfig, ah as HindsightProviderConfig, ap as IngestInput, aq as IngestResult, b9 as SearchRequest, bb as SearchResultPage, aX as PackageRequest, Q as ContextPackage, aN as MemoryRef, aG as Memory, az as ListRequest, aA as ListResultPage, F as Capabilities, i as AtomicMemoryHandle, aJ as MemoryProvider } from './hindsight-provider-2_IU9rqm.cjs';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aH as MemoryKind, aI as MemoryProcessingPipeline, aK as MemoryProviderEntry, aL as MemoryProviderError, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, ba as SearchResult, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bm as noopMemoryPipeline } from './hindsight-provider-2_IU9rqm.cjs';

		@@ -4,0 +4,0 @@ /**

+2

-2

dist/browser.d.ts

		@@ -1,3 +0,3 @@
		import { aM as MemoryProviderRegistration, s as AtomicMemoryProviderConfig, aF as Mem0ProviderConfig, ah as HindsightProviderConfig, ap as IngestInput, aq as IngestResult, b9 as SearchRequest, bb as SearchResultPage, aX as PackageRequest, Q as ContextPackage, aN as MemoryRef, aG as Memory, az as ListRequest, aA as ListResultPage, F as Capabilities, i as AtomicMemoryHandle, aJ as MemoryProvider } from './hindsight-provider-CbfXnvx7.js';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aH as MemoryKind, aI as MemoryProcessingPipeline, aK as MemoryProviderEntry, aL as MemoryProviderError, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, ba as SearchResult, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bm as noopMemoryPipeline } from './hindsight-provider-CbfXnvx7.js';
		import { aM as MemoryProviderRegistration, s as AtomicMemoryProviderConfig, aF as Mem0ProviderConfig, ah as HindsightProviderConfig, ap as IngestInput, aq as IngestResult, b9 as SearchRequest, bb as SearchResultPage, aX as PackageRequest, Q as ContextPackage, aN as MemoryRef, aG as Memory, az as ListRequest, aA as ListResultPage, F as Capabilities, i as AtomicMemoryHandle, aJ as MemoryProvider } from './hindsight-provider-2_IU9rqm.js';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aH as MemoryKind, aI as MemoryProcessingPipeline, aK as MemoryProviderEntry, aL as MemoryProviderError, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, ba as SearchResult, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bm as noopMemoryPipeline } from './hindsight-provider-2_IU9rqm.js';

		@@ -4,0 +4,0 @@ /**

+3

-2

dist/browser.js

		@@ -1,4 +0,5 @@
		export { MemoryClient } from './chunk-V5K4WVX5.js';
		export { ATOMICMEMORY_DEFAULT_TIMEOUT, ATOMICMEMORY_EXTENSION_NAMES, AtomicMemoryProvider, BaseMemoryProvider, HINDSIGHT_DEFAULT_API_VERSION, HINDSIGHT_DEFAULT_MAX_TOKENS, HINDSIGHT_DEFAULT_PROJECT_ID, HINDSIGHT_DEFAULT_TIMEOUT, HINDSIGHT_SCOPE_TAGS_MATCH, HindsightProvider, InvalidScopeError, MEM0_DEFAULT_TIMEOUT, Mem0ContextProvider, Mem0Provider, MemoryProviderError, MemoryTransportError, RateLimitError, UnsupportedOperationError, noopMemoryPipeline } from './chunk-T7PRWXW6.js';
		export { MemoryClient } from './chunk-KYVD7KQV.js';
		export { ATOMICMEMORY_DEFAULT_TIMEOUT, ATOMICMEMORY_EXTENSION_NAMES, AtomicMemoryProvider, BaseMemoryProvider, HINDSIGHT_DEFAULT_API_VERSION, HINDSIGHT_DEFAULT_MAX_TOKENS, HINDSIGHT_DEFAULT_PROJECT_ID, HINDSIGHT_DEFAULT_TIMEOUT, HINDSIGHT_SCOPE_TAGS_MATCH, HindsightProvider, InvalidScopeError, MEM0_DEFAULT_TIMEOUT, Mem0ContextProvider, Mem0Provider, MemoryProviderError, MemoryTransportError, RateLimitError, UnsupportedOperationError, noopMemoryPipeline } from './chunk-KI5UNWJI.js';
		import './chunk-3HWUP4VL.js';
		//# sourceMappingURL=browser.js.map
		//# sourceMappingURL=browser.js.map

+43

-34

dist/index.cjs

		'use strict';

		var chunkR56Z5WG5_cjs = require('./chunk-R56Z5WG5.cjs');
		var chunkKIUVJBBH_cjs = require('./chunk-KIUVJBBH.cjs');
		var chunkNULA3B6E_cjs = require('./chunk-NULA3B6E.cjs');
		var chunkAQHNXVMQ_cjs = require('./chunk-AQHNXVMQ.cjs');
		var chunkWSP2HCUV_cjs = require('./chunk-WSP2HCUV.cjs');
		var chunkH52DPNS2_cjs = require('./chunk-H52DPNS2.cjs');
		var chunkDIZ6Y5IO_cjs = require('./chunk-DIZ6Y5IO.cjs');
		var chunkLPC54QOU_cjs = require('./chunk-LPC54QOU.cjs');
		var chunkMIG2OG5Z_cjs = require('./chunk-MIG2OG5Z.cjs');
		var chunkZXO6ES3G_cjs = require('./chunk-ZXO6ES3G.cjs');
		@@ -26,3 +27,5 @@ var chunkB2CN7FAS_cjs = require('./chunk-B2CN7FAS.cjs');
		if (!config.apiKey) throw new Error("EntitiesClient: apiKey is required");
		this.apiUrl = config.apiUrl.replace(/\/+$/, "");
		this.apiUrl = chunkMIG2OG5Z_cjs.validateApiUrl(config.apiUrl, {
		allowPrivateNetworks: config.allowPrivateNetworks
		}).replace(/\/+$/, "");
		this.apiKey = config.apiKey;
		@@ -265,13 +268,18 @@ this.fetchImpl = config.fetch ?? fetch;
		}
		this.memory = new chunkKIUVJBBH_cjs.MemoryClient(
		this.memory = new chunkAQHNXVMQ_cjs.MemoryClient(
		config.memory ?? {
		providers: {
		atomicmemory: { apiUrl: config.apiUrl, apiKey: config.apiKey }
		atomicmemory: {
		apiUrl: config.apiUrl,
		apiKey: config.apiKey,
		allowPrivateNetworks: config.allowPrivateNetworks
		}
		}
		}
		);
		this.storage = new chunkDIZ6Y5IO_cjs.ConcreteStorageClient({
		this.storage = new chunkLPC54QOU_cjs.ConcreteStorageClient({
		apiUrl: config.apiUrl,
		apiKey: config.apiKey,
		userId: config.userId,
		allowPrivateNetworks: config.allowPrivateNetworks,
		fetch: config.fetch
		@@ -282,2 +290,3 @@ });
		apiKey: config.apiKey,
		allowPrivateNetworks: config.allowPrivateNetworks,
		fetch: config.fetch
		@@ -302,79 +311,79 @@ });
		enumerable: true,
		get: function () { return chunkKIUVJBBH_cjs.MemoryClient; }
		get: function () { return chunkAQHNXVMQ_cjs.MemoryClient; }
		});
		Object.defineProperty(exports, "ATOMICMEMORY_DEFAULT_TIMEOUT", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.ATOMICMEMORY_DEFAULT_TIMEOUT; }
		get: function () { return chunkWSP2HCUV_cjs.ATOMICMEMORY_DEFAULT_TIMEOUT; }
		});
		Object.defineProperty(exports, "ATOMICMEMORY_EXTENSION_NAMES", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.ATOMICMEMORY_EXTENSION_NAMES; }
		get: function () { return chunkWSP2HCUV_cjs.ATOMICMEMORY_EXTENSION_NAMES; }
		});
		Object.defineProperty(exports, "AtomicMemoryProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.AtomicMemoryProvider; }
		get: function () { return chunkWSP2HCUV_cjs.AtomicMemoryProvider; }
		});
		Object.defineProperty(exports, "BaseMemoryProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.BaseMemoryProvider; }
		get: function () { return chunkWSP2HCUV_cjs.BaseMemoryProvider; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_API_VERSION", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_API_VERSION; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_API_VERSION; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_MAX_TOKENS", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_MAX_TOKENS; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_MAX_TOKENS; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_PROJECT_ID", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_PROJECT_ID; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_PROJECT_ID; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_TIMEOUT", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_TIMEOUT; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_TIMEOUT; }
		});
		Object.defineProperty(exports, "HINDSIGHT_SCOPE_TAGS_MATCH", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_SCOPE_TAGS_MATCH; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_SCOPE_TAGS_MATCH; }
		});
		Object.defineProperty(exports, "HindsightProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HindsightProvider; }
		get: function () { return chunkWSP2HCUV_cjs.HindsightProvider; }
		});
		Object.defineProperty(exports, "InvalidScopeError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.InvalidScopeError; }
		get: function () { return chunkWSP2HCUV_cjs.InvalidScopeError; }
		});
		Object.defineProperty(exports, "MEM0_DEFAULT_TIMEOUT", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.MEM0_DEFAULT_TIMEOUT; }
		get: function () { return chunkWSP2HCUV_cjs.MEM0_DEFAULT_TIMEOUT; }
		});
		Object.defineProperty(exports, "Mem0ContextProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.Mem0ContextProvider; }
		get: function () { return chunkWSP2HCUV_cjs.Mem0ContextProvider; }
		});
		Object.defineProperty(exports, "Mem0Provider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.Mem0Provider; }
		get: function () { return chunkWSP2HCUV_cjs.Mem0Provider; }
		});
		Object.defineProperty(exports, "MemoryProviderError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.MemoryProviderError; }
		get: function () { return chunkWSP2HCUV_cjs.MemoryProviderError; }
		});
		Object.defineProperty(exports, "MemoryTransportError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.MemoryTransportError; }
		get: function () { return chunkWSP2HCUV_cjs.MemoryTransportError; }
		});
		Object.defineProperty(exports, "RateLimitError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.RateLimitError; }
		get: function () { return chunkWSP2HCUV_cjs.RateLimitError; }
		});
		Object.defineProperty(exports, "UnsupportedOperationError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.UnsupportedOperationError; }
		get: function () { return chunkWSP2HCUV_cjs.UnsupportedOperationError; }
		});
		Object.defineProperty(exports, "noopMemoryPipeline", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.noopMemoryPipeline; }
		get: function () { return chunkWSP2HCUV_cjs.noopMemoryPipeline; }
		});
		@@ -427,27 +436,27 @@ Object.defineProperty(exports, "DEFAULT_VALIDATION_CONFIG", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.ArtifactInUseError; }
		get: function () { return chunkLPC54QOU_cjs.ArtifactInUseError; }
		});
		Object.defineProperty(exports, "ArtifactNotFoundError", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.ArtifactNotFoundError; }
		get: function () { return chunkLPC54QOU_cjs.ArtifactNotFoundError; }
		});
		Object.defineProperty(exports, "ConcreteStorageClient", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.ConcreteStorageClient; }
		get: function () { return chunkLPC54QOU_cjs.ConcreteStorageClient; }
		});
		Object.defineProperty(exports, "FilecoinDirectStorageNotSupportedError", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.FilecoinDirectStorageNotSupportedError; }
		get: function () { return chunkLPC54QOU_cjs.FilecoinDirectStorageNotSupportedError; }
		});
		Object.defineProperty(exports, "PointerContentNotManagedError", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.PointerContentNotManagedError; }
		get: function () { return chunkLPC54QOU_cjs.PointerContentNotManagedError; }
		});
		Object.defineProperty(exports, "StorageClientError", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.StorageClientError; }
		get: function () { return chunkLPC54QOU_cjs.StorageClientError; }
		});
		Object.defineProperty(exports, "UnsupportedCapabilityError", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.UnsupportedCapabilityError; }
		get: function () { return chunkLPC54QOU_cjs.UnsupportedCapabilityError; }
		});
		@@ -454,0 +463,0 @@ Object.defineProperty(exports, "EmbeddingGenerator", {

+1

-1

dist/index.cjs.map

		@@ -1,1 +0,1 @@
		{"version":3,"sources":["../src/entities/client.ts","../src/client/atomic-memory-client.ts","../src/index.ts"],"names":["MemoryClient","ConcreteStorageClient"],"mappings":";;;;;;;;;;;;;;;;;;AAkCO,IAAM,iBAAN,MAAqB;AAAA,EACT,MAAA;AAAA,EACA,MAAA;AAAA,EACA,SAAA;AAAA,EAEjB,YAAY,MAAA,EAA8B;AACxC,IAAA,IAAI,CAAC,MAAA,CAAO,MAAA,EAAQ,MAAM,IAAI,MAAM,oCAAoC,CAAA;AACxE,IAAA,IAAI,CAAC,MAAA,CAAO,MAAA,EAAQ,MAAM,IAAI,MAAM,oCAAoC,CAAA;AACxE,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA,CAAO,MAAA,CAAO,OAAA,CAAQ,QAAQ,EAAE,CAAA;AAC9C,IAAA,IAAA,CAAK,SAAS,MAAA,CAAO,MAAA;AACrB,IAAA,IAAA,CAAK,SAAA,GAAY,OAAO,KAAA,IAAS,KAAA;AAAA,EACnC;AAAA;AAAA,EAGA,MAAM,OAAA,CAAQ,QAAA,EAAkB,UAAA,GAAyB,MAAA,EAAgC;AACvF,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,OAAA,CAAQ,KAAA,EAAO,CAAA,aAAA,EAAgB,UAAU,CAAA,CAAA,EAAI,kBAAA,CAAmB,QAAQ,CAAC,CAAA,QAAA,CAAU,CAAA;AAC1G,IAAA,OAAO,UAAA,CAAW,MAAM,GAAA,CAAI,IAAA,EAAiC,CAAA;AAAA,EAC/D;AAAA;AAAA,EAGA,MAAM,IAAA,CAAK,IAAA,GAA4B,EAAC,EAA8B;AACpE,IAAA,MAAM,EAAA,GAAK,qBAAqB,IAAI,CAAA;AACpC,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,QAAQ,KAAA,EAAO,CAAA,YAAA,EAAe,EAAE,CAAA,CAAE,CAAA;AACzD,IAAA,OAAO,OAAA,CAAQ,MAAM,GAAA,CAAI,IAAA,EAAiC,CAAA;AAAA,EAC5D;AAAA;AAAA,EAGA,MAAM,GAAA,CAAI,QAAA,EAAkB,UAAA,GAAyB,MAAA,EAA+B;AAClF,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,OAAA,CAAQ,KAAA,EAAO,CAAA,aAAA,EAAgB,UAAU,CAAA,CAAA,EAAI,kBAAA,CAAmB,QAAQ,CAAC,CAAA,CAAE,CAAA;AAClG,IAAA,OAAO,SAAA,CAAU,MAAM,GAAA,CAAI,IAAA,EAAiC,CAAA;AAAA,EAC9D;AAAA;AAAA,EAGA,MAAM,MAAA,CAAO,QAAA,EAAkB,UAAA,GAAyB,MAAA,EAAqC;AAC3F,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,OAAA,CAAQ,QAAA,EAAU,CAAA,aAAA,EAAgB,UAAU,CAAA,CAAA,EAAI,kBAAA,CAAmB,QAAQ,CAAC,CAAA,CAAE,CAAA;AACrG,IAAA,OAAO,eAAA,CAAgB,MAAM,GAAA,CAAI,IAAA,EAAiC,CAAA;AAAA,EACpE;AAAA;AAAA,EAGA,MAAM,UAAA,CAAW,QAAA,EAAkB,OAA6B,EAAC,EAAG,aAAyB,MAAA,EAAQ;AACnG,IAAA,MAAM,EAAA,GAAK,qBAAqB,IAAI,CAAA;AACpC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,OAAA,CAAQ,KAAA,EAAO,CAAA,aAAA,EAAgB,UAAU,CAAA,CAAA,EAAI,kBAAA,CAAmB,QAAQ,CAAC,CAAA,WAAA,EAAc,EAAE,CAAA,CAAE,CAAA;AAClH,IAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,IAAA,OAAA,CAAQ,IAAA,CAAK,UAAA,IAAc,EAAC,EAAG,IAAI,YAAY,CAAA;AAAA,EACjD;AAAA;AAAA,EAGA,MAAM,aAAA,CAAc,QAAA,EAAkB,QAAA,EAAkB,aAAyB,MAAA,EAAgC;AAC/G,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,OAAA;AAAA,MACrB,KAAA;AAAA,MACA,CAAA,aAAA,EAAgB,UAAU,CAAA,CAAA,EAAI,kBAAA,CAAmB,QAAQ,CAAC,CAAA,UAAA,EAAa,kBAAA,CAAmB,QAAQ,CAAC,CAAA,QAAA;AAAA,KACrG;AACA,IAAA,OAAO,UAAA,CAAW,MAAM,GAAA,CAAI,IAAA,EAAiC,CAAA;AAAA,EAC/D;AAAA;AAAA,EAGA,MAAM,aAAA,CAAc,QAAA,EAAkB,KAAA,EAAiC,aAAyB,MAAA,EAAiC;AAC/H,IAAA,MAAM,OAAgC,EAAC;AACvC,IAAA,IAAI,KAAA,CAAM,gBAAA,KAAqB,MAAA,EAAW,IAAA,CAAK,oBAAoB,KAAA,CAAM,gBAAA;AACzE,IAAA,IAAI,KAAA,CAAM,WAAA,KAAgB,MAAA,EAAW,IAAA,CAAK,eAAe,KAAA,CAAM,WAAA;AAC/D,IAAA,IAAI,KAAA,CAAM,YAAA,KAAiB,MAAA,EAAW,IAAA,CAAK,gBAAgB,KAAA,CAAM,YAAA;AACjE,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,OAAA;AAAA,MACrB,OAAA;AAAA,MACA,CAAA,aAAA,EAAgB,UAAU,CAAA,CAAA,EAAI,kBAAA,CAAmB,QAAQ,CAAC,CAAA,SAAA,CAAA;AAAA,MAC1D,EAAE,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,IAAsB,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI,CAAA;AAAE,KAChF;AACA,IAAA,OAAO,WAAA,CAAY,MAAM,GAAA,CAAI,IAAA,EAAiC,CAAA;AAAA,EAChE;AAAA;AAAA,EAGA,MAAM,KAAA,CACJ,MAAA,EACA,MAAA,EAC8B;AAC9B,IAAA,MAAM,IAAA,GAAO;AAAA,MACX,MAAA,EAAQ,EAAE,WAAA,EAAa,MAAA,CAAO,cAAc,MAAA,EAAQ,SAAA,EAAW,OAAO,QAAA,EAAS;AAAA,MAC/E,MAAA,EAAQ,EAAE,WAAA,EAAa,MAAA,CAAO,cAAc,MAAA,EAAQ,SAAA,EAAW,OAAO,QAAA;AAAS,KACjF;AACA,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,OAAA,CAAQ,QAAQ,oBAAA,EAAsB;AAAA,MAC3D,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAmB;AAAA,MAC9C,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,KAC1B,CAAA;AACD,IAAA,OAAO,cAAA,CAAe,MAAM,GAAA,CAAI,IAAA,EAAiC,CAAA;AAAA,EACnE;AAAA,EAEA,MAAc,OAAA,CACZ,MAAA,EACA,IAAA,EACA,IAAA,GAA8D,EAAC,EAC5C;AACnB,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,IAAA,CAAK,MAAM,GAAG,IAAI,CAAA,CAAA;AACjC,IAAA,IAAI,GAAA;AACJ,IAAA,IAAI;AACF,MAAA,GAAA,GAAM,MAAM,IAAA,CAAK,SAAA,CAAU,GAAA,EAAK;AAAA,QAC9B,MAAA;AAAA,QACA,OAAA,EAAS,EAAE,aAAA,EAAe,CAAA,OAAA,EAAU,IAAA,CAAK,MAAM,CAAA,CAAA,EAAI,GAAI,IAAA,CAAK,OAAA,IAAW,EAAC,EAAG;AAAA,QAC3E,MAAM,IAAA,CAAK;AAAA,OACZ,CAAA;AAAA,IACH,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,sCAAA,EAAyC,MAAM,CAAA,CAAA,EAAI,IAAI,CAAA,EAAA,EAAK,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,OACpH;AAAA,IACF;AACA,IAAA,IAAI,GAAA,CAAI,IAAI,OAAO,GAAA;AACnB,IAAA,MAAM,OAAO,MAAM,GAAA,CAAI,MAAK,CAAE,KAAA,CAAM,MAAM,EAAE,CAAA;AAC5C,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,gBAAA,EAAmB,MAAM,CAAA,CAAA,EAAI,IAAI,CAAA,aAAA,EAAgB,GAAA,CAAI,MAAM,CAAA,EAAA,EAAK,IAAI,CAAA,CAAE,CAAA;AAAA,EACxF;AACF;AAMA,SAAS,qBAAqB,IAAA,EAAmC;AAC/D,EAAA,MAAM,CAAA,GAAI,IAAI,eAAA,EAAgB;AAC9B,EAAA,IAAI,KAAK,UAAA,EAAY,CAAA,CAAE,GAAA,CAAI,aAAA,EAAe,KAAK,UAAU,CAAA;AACzD,EAAA,IAAI,IAAA,CAAK,SAAS,MAAA,EAAW,CAAA,CAAE,IAAI,MAAA,EAAQ,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA;AAC5D,EAAA,IAAI,IAAA,CAAK,aAAa,MAAA,EAAW,CAAA,CAAE,IAAI,WAAA,EAAa,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAC,CAAA;AACzE,EAAA,OAAO,EAAE,QAAA,EAAS,GAAI,IAAI,CAAA,CAAE,QAAA,EAAU,CAAA,CAAA,GAAK,EAAA;AAC7C;AAEA,SAAS,qBAAqB,IAAA,EAAoC;AAChE,EAAA,MAAM,CAAA,GAAI,IAAI,eAAA,EAAgB;AAC9B,EAAA,IAAI,KAAK,SAAA,EAAW,CAAA,CAAE,GAAA,CAAI,WAAA,EAAa,KAAK,SAAS,CAAA;AACrD,EAAA,IAAI,KAAK,MAAA,EAAQ,CAAA,CAAE,GAAA,CAAI,QAAA,EAAU,KAAK,MAAM,CAAA;AAC5C,EAAA,IAAI,IAAA,CAAK,UAAU,MAAA,EAAW,CAAA,CAAE,IAAI,OAAA,EAAS,MAAA,CAAO,IAAA,CAAK,KAAK,CAAC,CAAA;AAC/D,EAAA,OAAO,EAAE,QAAA,EAAS,GAAI,IAAI,CAAA,CAAE,QAAA,EAAU,CAAA,CAAA,GAAK,EAAA;AAC7C;AAMA,SAAS,aAAa,CAAA,EAAY;AAChC,EAAA,MAAM,CAAA,GAAI,CAAA;AACV,EAAA,OAAO;AAAA,IACL,QAAQ,CAAA,CAAE,MAAA;AAAA,IACV,WAAW,CAAA,CAAE,SAAA;AAAA,IACb,OAAO,CAAA,CAAE,KAAA;AAAA,IACT,MAAM,CAAA,CAAE,IAAA;AAAA,IACR,cAAA,EAAiB,EAAE,gBAAA,IAAsC,IAAA;AAAA,IACzD,YAAY,CAAA,CAAE;AAAA,GAChB;AACF;AAEA,SAAS,YAAY,CAAA,EAAY;AAC/B,EAAA,MAAM,GAAA,GAAM,CAAA;AACZ,EAAA,OAAO;AAAA,IACL,gBAAgB,GAAA,CAAI,gBAAA;AAAA,IACpB,cAAc,GAAA,CAAI,aAAA;AAAA,IAClB,YAAY,GAAA,CAAI,UAAA;AAAA,IAChB,OAAA,EAAU,IAAI,QAAA,IAA8B;AAAA,GAC9C;AACF;AAEA,SAAS,QAAQ,CAAA,EAAY;AAC3B,EAAA,MAAM,IAAA,GAAO,CAAA;AACb,EAAA,OAAO;AAAA,IACL,YAAY,IAAA,CAAK,WAAA;AAAA,IACjB,UAAU,IAAA,CAAK,SAAA;AAAA,IACf,SAAS,IAAA,CAAK,OAAA;AAAA,IACd,WAAW,IAAA,CAAK;AAAA,GAClB;AACF;AAEA,SAAS,eAAe,GAAA,EAAoF;AAC1G,EAAA,IAAI,CAAC,KAAK,OAAO,IAAA;AACjB,EAAA,OAAO;AAAA,IACL,SAAS,GAAA,CAAI,OAAA;AAAA,IACb,WAAA,EAAc,GAAA,CAAI,WAAA,IAA4B,EAAC;AAAA,IAC/C,YAAA,EAAe,GAAA,CAAI,YAAA,IAA6B,EAAC;AAAA,IACjD,eAAA,EAAkB,GAAA,CAAI,gBAAA,IAAiC;AAAC,GAC1D;AACF;AAEA,SAAS,WAAW,CAAA,EAAgE;AAClF,EAAA,OAAO;AAAA,IACL,YAAY,CAAA,CAAE,WAAA;AAAA,IACd,UAAU,CAAA,CAAE,SAAA;AAAA,IACZ,OAAA,EAAS,cAAA,CAAe,CAAA,CAAE,OAAyC,CAAA;AAAA,IACnE,aAAc,CAAA,CAAE,UAAA,IAA4B,EAAC,EAAG,IAAI,YAAY,CAAA;AAAA,IAChE,aAAa,CAAA,CAAE,YAAA;AAAA,IACf,UAAA,EAAa,EAAE,WAAA,IAAiC,IAAA;AAAA,IAChD,SAAA,EAAY,EAAE,UAAA,IAAgC;AAAA,GAChD;AACF;AAEA,SAAS,QAAQ,CAAA,EAAmE;AAClF,EAAA,OAAO;AAAA,IACL,WAAY,CAAA,CAAE,QAAA,IAA0B,EAAC,EAAG,GAAA,CAAI,CAAC,CAAA,KAAM;AACrD,MAAA,MAAM,MAAA,GAAS,CAAA;AACf,MAAA,OAAO;AAAA,QACL,YAAY,MAAA,CAAO,WAAA;AAAA,QACnB,UAAU,MAAA,CAAO,SAAA;AAAA,QACjB,aAAa,MAAA,CAAO,YAAA;AAAA,QACpB,UAAA,EAAa,OAAO,WAAA,IAAiC;AAAA,OACvD;AAAA,IACF,CAAC,CAAA;AAAA,IACD,OAAO,CAAA,CAAE,KAAA;AAAA,IACT,MAAM,CAAA,CAAE,IAAA;AAAA,IACR,UAAU,CAAA,CAAE;AAAA,GACd;AACF;AAEA,SAAS,UAAU,CAAA,EAA+D;AAChF,EAAA,OAAO;AAAA,IACL,YAAY,CAAA,CAAE,WAAA;AAAA,IACd,UAAU,CAAA,CAAE,SAAA;AAAA,IACZ,aAAa,CAAA,CAAE,YAAA;AAAA,IACf,aAAc,CAAA,CAAE,UAAA,IAA4B,EAAC,EAAG,IAAI,YAAY,CAAA;AAAA,IAChE,YAAa,CAAA,CAAE,SAAA,IAA2B,EAAC,EAAG,IAAI,WAAW,CAAA;AAAA,IAC7D,cAAe,CAAA,CAAE,YAAA,IAA8B,EAAC,EAAG,IAAI,OAAO,CAAA;AAAA,IAC9D,SAAA,EAAY,EAAE,UAAA,IAAgC;AAAA,GAChD;AACF;AAEA,SAAS,gBAAgB,CAAA,EAAqE;AAC5F,EAAA,MAAM,IAAI,CAAA,CAAE,OAAA;AACZ,EAAA,OAAO;AAAA,IACL,OAAA,EAAS;AAAA,MACP,UAAU,CAAA,CAAE,QAAA;AAAA,MACZ,kBAAkB,CAAA,CAAE,iBAAA;AAAA,MACpB,SAAS,CAAA,CAAE,OAAA;AAAA,MACX,UAAU,CAAA,CAAE,QAAA;AAAA,MACZ,aAAa,CAAA,CAAE,YAAA;AAAA,MACf,aAAa,CAAA,CAAE;AAAA;AACjB,GACF;AACF;AAEA,SAAS,WAAW,CAAA,EAAgE;AAClF,EAAA,OAAO;AAAA,IACL,UAAU,CAAA,CAAE,SAAA;AAAA,IACZ,UAAW,CAAA,CAAE,OAAA,IAAyB,EAAC,EAAG,GAAA,CAAI,CAAC,CAAA,KAAM;AACnD,MAAA,MAAM,KAAA,GAAQ,CAAA;AACd,MAAA,OAAO;AAAA,QACL,WAAW,KAAA,CAAM,UAAA;AAAA,QACjB,OAAO,KAAA,CAAM,KAAA;AAAA,QACb,SAAS,KAAA,CAAM,OAAA;AAAA,QACf,WAAW,KAAA,CAAM,SAAA;AAAA,QACjB,YAAA,EAAe,MAAM,aAAA,IAAmC;AAAA,OAC1D;AAAA,IACF,CAAC;AAAA,GACH;AACF;AAEA,SAAS,YAAY,CAAA,EAAiE;AACpF,EAAA,OAAO;AAAA,IACL,UAAU,CAAA,CAAE,SAAA;AAAA,IACZ,gBAAA,EAAmB,EAAE,iBAAA,IAAuC,IAAA;AAAA,IAC5D,WAAA,EAAc,EAAE,YAAA,IAAoC,IAAA;AAAA,IACpD,cAAc,CAAA,CAAE,aAAA;AAAA,IAChB,WAAW,CAAA,CAAE;AAAA,GACf;AACF;AAEA,SAAS,eAAe,CAAA,EAAsE;AAC5F,EAAA,MAAM,IAAI,CAAA,CAAE,MAAA;AACZ,EAAA,OAAO;AAAA,IACL,MAAA,EAAQ;AAAA,MACN,eAAe,CAAA,CAAE,cAAA;AAAA,MACjB,iBAAiB,CAAA,CAAE,gBAAA;AAAA,MACnB,YAAY,CAAA,CAAE;AAAA,KAChB;AAAA,IACA,gBAAgB,CAAA,CAAE;AAAA,GACpB;AACF;;;AC/OO,IAAM,qBAAN,MAAyB;AAAA,EACrB,MAAA;AAAA,EACA,OAAA;AAAA,EACA,QAAA;AAAA,EAET,YAAY,MAAA,EAAkC;AAC5C,IAAA,IAAI,CAAC,OAAO,MAAA,EAAQ;AAClB,MAAA,MAAM,IAAI,MAAM,wCAAwC,CAAA;AAAA,IAC1D;AACA,IAAA,IAAI,CAAC,OAAO,MAAA,EAAQ;AAClB,MAAA,MAAM,IAAI,MAAM,wCAAwC,CAAA;AAAA,IAC1D;AACA,IAAA,IAAI,CAAC,OAAO,MAAA,EAAQ;AAClB,MAAA,MAAM,IAAI,MAAM,wCAAwC,CAAA;AAAA,IAC1D;AAOA,IAAA,IAAA,CAAK,SAAS,IAAIA,8BAAA;AAAA,MAChB,OAAO,MAAA,IAAU;AAAA,QACf,SAAA,EAAW;AAAA,UACT,cAAc,EAAE,MAAA,EAAQ,OAAO,MAAA,EAAQ,MAAA,EAAQ,OAAO,MAAA;AAAO;AAC/D;AACF,KACF;AACA,IAAA,IAAA,CAAK,OAAA,GAAU,IAAIC,uCAAA,CAAsB;AAAA,MACvC,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,OAAO,MAAA,CAAO;AAAA,KACf,CAAA;AACD,IAAA,IAAA,CAAK,QAAA,GAAW,IAAI,cAAA,CAAe;AAAA,MACjC,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,QAAQ,MAAA,CAAO,MAAA;AAAA,MACf,OAAO,MAAA,CAAO;AAAA,KACf,CAAA;AAAA,EACH;AACF;;;ACmDO,IAAM,WAAA,GAAc;AACpB,IAAM,WAAA,GAAc","file":"index.cjs","sourcesContent":["/*\n @file `EntitiesClient` — SDK surface for /v1/entities.\n \n Thin fetch wrapper over the entity API routes. All methods default\n * `entityType` to `'user'` since that is the primary use case.\n * Server responses use snake_case; this client maps to camelCase.\n \n Usage:\n * const client = new AtomicMemoryClient({ apiUrl, apiKey, userId });\n * const profile = await client.entities.profile('alice');\n * const attrs = await client.entities.attributes('alice', { attribute: 'role' });\n /\n\nimport type {\n DeleteEntityResult,\n EntityDetail,\n EntityListResult,\n EntityProfile,\n EntitySettings,\n EntityType,\n GetAttributesOptions,\n ListEntitiesOptions,\n MemoryHistory,\n MergeEntitiesResult,\n PatchEntitySettingsInput,\n} from './types.js';\n\nexport interface EntitiesClientConfig {\n apiUrl: string;\n apiKey: string;\n /* Optional fetch override — defaults to the Node global. /\n fetch?: typeof fetch;\n}\n\nexport class EntitiesClient {\n private readonly apiUrl: string;\n private readonly apiKey: string;\n private readonly fetchImpl: typeof fetch;\n\n constructor(config: EntitiesClientConfig) {\n if (!config.apiUrl) throw new Error('EntitiesClient: apiUrl is required');\n if (!config.apiKey) throw new Error('EntitiesClient: apiKey is required');\n this.apiUrl = config.apiUrl.replace(/\\/+$/, '');\n this.apiKey = config.apiKey;\n this.fetchImpl = config.fetch ?? fetch;\n }\n\n /* Get the synthesized profile for an entity. /\n async profile(entityId: string, entityType: EntityType = 'user'): Promise<EntityProfile> {\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/profile`);\n return mapProfile(await res.json() as Record<string, unknown>);\n }\n\n /* List all entities with memory counts (paginated). /\n async list(opts: ListEntitiesOptions = {}): Promise<EntityListResult> {\n const qs = buildEntityListQuery(opts);\n const res = await this.request('GET', `/v1/entities${qs}`);\n return mapList(await res.json() as Record<string, unknown>);\n }\n\n /* Get entity detail — attributes, relations, and recent cards. /\n async get(entityId: string, entityType: EntityType = 'user'): Promise<EntityDetail> {\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}`);\n return mapDetail(await res.json() as Record<string, unknown>);\n }\n\n /* Cascade-delete all data for an entity. /\n async delete(entityId: string, entityType: EntityType = 'user'): Promise<DeleteEntityResult> {\n const res = await this.request('DELETE', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}`);\n return mapDeleteResult(await res.json() as Record<string, unknown>);\n }\n\n /* Get structured attribute triples for an entity. /\n async attributes(entityId: string, opts: GetAttributesOptions = {}, entityType: EntityType = 'user') {\n const qs = buildAttributesQuery(opts);\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/attributes${qs}`);\n const body = await res.json() as { attributes: unknown[] };\n return (body.attributes ?? []).map(mapAttribute);\n }\n\n /* Get the mutation history of a single memory record. /\n async memoryHistory(entityId: string, memoryId: string, entityType: EntityType = 'user'): Promise<MemoryHistory> {\n const res = await this.request(\n 'GET',\n `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/memories/${encodeURIComponent(memoryId)}/history`,\n );\n return mapHistory(await res.json() as Record<string, unknown>);\n }\n\n /* Update per-entity extraction guidance and pipeline config. /\n async patchSettings(entityId: string, input: PatchEntitySettingsInput, entityType: EntityType = 'user'): Promise<EntitySettings> {\n const body: Record<string, unknown> = {};\n if (input.extractionPrompt !== undefined) body.extraction_prompt = input.extractionPrompt;\n if (input.memoryKinds !== undefined) body.memory_kinds = input.memoryKinds;\n if (input.decayEnabled !== undefined) body.decay_enabled = input.decayEnabled;\n const res = await this.request(\n 'PATCH',\n `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/settings`,\n { headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) },\n );\n return mapSettings(await res.json() as Record<string, unknown>);\n }\n\n /* Merge a source entity into a target entity. /\n async merge(\n source: { entityId: string; entityType?: EntityType },\n target: { entityId: string; entityType?: EntityType },\n ): Promise<MergeEntitiesResult> {\n const body = {\n source: { entity_type: source.entityType ?? 'user', entity_id: source.entityId },\n target: { entity_type: target.entityType ?? 'user', entity_id: target.entityId },\n };\n const res = await this.request('POST', '/v1/entities/merge', {\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify(body),\n });\n return mapMergeResult(await res.json() as Record<string, unknown>);\n }\n\n private async request(\n method: string,\n path: string,\n init: { headers?: Record<string, string>; body?: BodyInit } = {},\n ): Promise<Response> {\n const url = `${this.apiUrl}${path}`;\n let res: Response;\n try {\n res = await this.fetchImpl(url, {\n method,\n headers: { Authorization: `Bearer ${this.apiKey}`, ...(init.headers ?? {}) },\n body: init.body,\n });\n } catch (cause) {\n throw new Error(\n `EntitiesClient: network error calling ${method} ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,\n );\n }\n if (res.ok) return res;\n const text = await res.text().catch(() => '');\n throw new Error(`EntitiesClient: ${method} ${path} failed with ${res.status}: ${text}`);\n }\n}\n\n// ---------------------------------------------------------------------------\n// Query builders\n// ---------------------------------------------------------------------------\n\nfunction buildEntityListQuery(opts: ListEntitiesOptions): string {\n const p = new URLSearchParams();\n if (opts.entityType) p.set('entity_type', opts.entityType);\n if (opts.page !== undefined) p.set('page', String(opts.page));\n if (opts.pageSize !== undefined) p.set('page_size', String(opts.pageSize));\n return p.toString() ? `?${p.toString()}` : '';\n}\n\nfunction buildAttributesQuery(opts: GetAttributesOptions): string {\n const p = new URLSearchParams();\n if (opts.attribute) p.set('attribute', opts.attribute);\n if (opts.entity) p.set('entity', opts.entity);\n if (opts.limit !== undefined) p.set('limit', String(opts.limit));\n return p.toString() ? `?${p.toString()}` : '';\n}\n\n// ---------------------------------------------------------------------------\n// Wire → SDK type mappers (snake_case → camelCase)\n// ---------------------------------------------------------------------------\n\nfunction mapAttribute(r: unknown) {\n const a = r as Record<string, unknown>;\n return {\n entity: a.entity as string,\n attribute: a.attribute as string,\n value: a.value as string,\n type: a.type as string,\n sourceMemoryId: (a.source_memory_id as string \| null) ?? null,\n observedAt: a.observed_at as string,\n };\n}\n\nfunction mapRelation(r: unknown) {\n const row = r as Record<string, unknown>;\n return {\n targetEntityId: row.target_entity_id as string,\n relationType: row.relation_type as string,\n confidence: row.confidence as number,\n validTo: (row.valid_to as string \| null) ?? null,\n };\n}\n\nfunction mapCard(c: unknown) {\n const card = c as Record<string, unknown>;\n return {\n entityName: card.entity_name as string,\n cardText: card.card_text as string,\n version: card.version as number,\n updatedAt: card.updated_at as string,\n };\n}\n\nfunction mapProfileBody(raw: Record<string, unknown> \| null): import('./types.js').EntityProfile['profile'] {\n if (!raw) return null;\n return {\n summary: raw.summary as string,\n preferences: (raw.preferences as string[]) ?? [],\n instructions: (raw.instructions as string[]) ?? [],\n openCommitments: (raw.open_commitments as string[]) ?? [],\n };\n}\n\nfunction mapProfile(r: Record<string, unknown>): import('./types.js').EntityProfile {\n return {\n entityType: r.entity_type as import('./types.js').EntityType,\n entityId: r.entity_id as string,\n profile: mapProfileBody(r.profile as Record<string, unknown> \| null),\n attributes: ((r.attributes as unknown[]) ?? []).map(mapAttribute),\n memoryCount: r.memory_count as number,\n lastActive: (r.last_active as string \| null) ?? null,\n updatedAt: (r.updated_at as string \| null) ?? null,\n };\n}\n\nfunction mapList(r: Record<string, unknown>): import('./types.js').EntityListResult {\n return {\n entities: ((r.entities as unknown[]) ?? []).map((e) => {\n const entity = e as Record<string, unknown>;\n return {\n entityType: entity.entity_type as import('./types.js').EntityType,\n entityId: entity.entity_id as string,\n memoryCount: entity.memory_count as number,\n lastActive: (entity.last_active as string \| null) ?? null,\n };\n }),\n total: r.total as number,\n page: r.page as number,\n pageSize: r.page_size as number,\n };\n}\n\nfunction mapDetail(r: Record<string, unknown>): import('./types.js').EntityDetail {\n return {\n entityType: r.entity_type as import('./types.js').EntityType,\n entityId: r.entity_id as string,\n memoryCount: r.memory_count as number,\n attributes: ((r.attributes as unknown[]) ?? []).map(mapAttribute),\n relations: ((r.relations as unknown[]) ?? []).map(mapRelation),\n recentCards: ((r.recent_cards as unknown[]) ?? []).map(mapCard),\n updatedAt: (r.updated_at as string \| null) ?? null,\n };\n}\n\nfunction mapDeleteResult(r: Record<string, unknown>): import('./types.js').DeleteEntityResult {\n const d = r.deleted as Record<string, number>;\n return {\n deleted: {\n memories: d.memories,\n entityAttributes: d.entity_attributes,\n profile: d.profile,\n entities: d.entities,\n entityEdges: d.entity_edges,\n entityCards: d.entity_cards,\n },\n };\n}\n\nfunction mapHistory(r: Record<string, unknown>): import('./types.js').MemoryHistory {\n return {\n memoryId: r.memory_id as string,\n history: ((r.history as unknown[]) ?? []).map((h) => {\n const entry = h as Record<string, unknown>;\n return {\n versionId: entry.version_id as string,\n event: entry.event as string,\n content: entry.content as string,\n timestamp: entry.timestamp as string,\n supersededBy: (entry.superseded_by as string \| null) ?? null,\n };\n }),\n };\n}\n\nfunction mapSettings(r: Record<string, unknown>): import('./types.js').EntitySettings {\n return {\n entityId: r.entity_id as string,\n extractionPrompt: (r.extraction_prompt as string \| null) ?? null,\n memoryKinds: (r.memory_kinds as string[] \| null) ?? null,\n decayEnabled: r.decay_enabled as boolean,\n updatedAt: r.updated_at as string,\n };\n}\n\nfunction mapMergeResult(r: Record<string, unknown>): import('./types.js').MergeEntitiesResult {\n const m = r.merged as Record<string, number>;\n return {\n merged: {\n memoriesMoved: m.memories_moved,\n attributesMoved: m.attributes_moved,\n cardsMoved: m.cards_moved,\n },\n targetEntityId: r.target_entity_id as string,\n };\n}\n","/\n @file `AtomicMemoryClient` — primary public surface for the SDK.\n \n Aggregates `memory` (the memory-layer API) and `storage` (the\n * direct-storage API) under one client so callers see a coherent\n * single entry point:\n \n import { AtomicMemoryClient } from '@atomicmemory/sdk';\n * const client = new AtomicMemoryClient({\n * apiUrl: 'http://localhost:17350',\n * apiKey: process.env.ATOMICMEMORY_API_KEY!,\n * userId: 'u1',\n * });\n * await client.memory.initialize();\n * const artifact = await client.storage.put({\n * mode: 'pointer',\n * uri: 'https://example.com/file.pdf',\n * contentType: 'application/pdf',\n * });\n \n v1 SDK is server-side only. Browser bundles must proxy through a\n * trusted server, such as an application-owned API boundary.\n \n Applications that only need memory operations can still use\n * `MemoryClient` directly. New integrations should prefer\n * `AtomicMemoryClient.memory`.\n /\n\nimport { MemoryClient, type MemoryClientConfig } from './memory-client';\nimport { ConcreteStorageClient } from '../storage/client';\nimport type { StorageClient } from '../storage/interfaces';\nimport { EntitiesClient } from '../entities/client';\n\n/\n Constructor config for the aggregator. All three transport fields\n * (`apiUrl`, `apiKey`, `userId`) are REQUIRED — they back both the\n * storage namespace and the default AtomicMemory memory provider.\n * Memory-only consumers should still pass `apiUrl` (it doubles as\n * the default memory provider's `apiUrl`); the `memory` block then\n * narrows the registration further if a non-default provider mix is\n * needed.\n \n `userId` is the owner-scope seam the storage routes accept until a\n * real auth seam ships. `fetch` is an optional override; defaults to\n * the Node global.\n /\nexport interface AtomicMemoryClientConfig {\n apiUrl: string;\n apiKey: string;\n userId: string;\n /* Optional fetch override — defaults to the Node global. /\n fetch?: typeof fetch;\n /* Memory-provider registration. Defaults to a single AtomicMemory\n * provider pointing at `apiUrl`. /\n memory?: MemoryClientConfig;\n}\n\n/\n Primary public client. Holds a `memory` namespace (`MemoryClient`)\n * and a `storage` namespace (`StorageClient`).\n /\nexport class AtomicMemoryClient {\n readonly memory: MemoryClient;\n readonly storage: StorageClient;\n readonly entities: EntitiesClient;\n\n constructor(config: AtomicMemoryClientConfig) {\n if (!config.apiUrl) {\n throw new Error('AtomicMemoryClient: apiUrl is required');\n }\n if (!config.apiKey) {\n throw new Error('AtomicMemoryClient: apiKey is required');\n }\n if (!config.userId) {\n throw new Error('AtomicMemoryClient: userId is required');\n }\n // Default provider registration MUST forward the apiKey so the\n // memory namespace shares the storage namespace's auth contract.\n // The earlier shape dropped it silently — memory requests went\n // out unauthenticated even when the caller supplied `apiKey`,\n // failing with 401 against any core deployment that gates `/v1/`\n // (every deployment since the auth middleware landed).\n this.memory = new MemoryClient(\n config.memory ?? {\n providers: {\n atomicmemory: { apiUrl: config.apiUrl, apiKey: config.apiKey },\n },\n },\n );\n this.storage = new ConcreteStorageClient({\n apiUrl: config.apiUrl,\n apiKey: config.apiKey,\n userId: config.userId,\n fetch: config.fetch,\n });\n this.entities = new EntitiesClient({\n apiUrl: config.apiUrl,\n apiKey: config.apiKey,\n fetch: config.fetch,\n });\n }\n}\n","/*\n @file @atomicmemory/sdk public surface\n \n Backend-agnostic memory-layer SDK. Pluggable providers, local\n * embeddings, storage adapters, semantic search.\n \n @example\n * ```typescript\n * import { MemoryClient } from '@atomicmemory/sdk';\n \n const memory = new MemoryClient({\n * providers: { atomicmemory: { apiUrl: 'http://localhost:17350' } },\n * });\n * await memory.initialize();\n * await memory.ingest({ mode: 'text', content: 'hello', scope: { user: 'u1' } });\n * const results = await memory.search({ query: 'hello', scope: { user: 'u1' } });\n * ```\n /\n\n// Primary client — `AtomicMemoryClient` aggregates the memory and\n// storage namespaces. `MemoryClient` remains available for\n// applications that only need memory operations.\nexport {\n AtomicMemoryClient,\n type AtomicMemoryClientConfig,\n} from './client/atomic-memory-client';\n\nexport { MemoryClient } from './client/memory-client';\nexport type {\n MemoryClientConfig,\n MemoryProviderConfigs,\n ProviderStatus,\n} from './client/memory-client';\n\n// Types\nexport from './types';\n\n// Event system\nexport { EventEmitter, type EventMap } from './core/events';\n\n// Error handling\nexport {\n AtomicMemoryError,\n StorageError,\n EmbeddingError,\n SearchError,\n ConfigurationError,\n NetworkError,\n RetryableOperation,\n withRetry,\n ErrorContext,\n ErrorUtils,\n type RetryPolicy,\n} from './core/error-handling/';\n\n// KV cache used by embeddings and local search. New artifact-storage\n// integrations should use the `./storage` subpath.\nexport { StorageManager } from './kv-cache/storage-manager';\nexport { MemoryStorageAdapter } from './kv-cache/memory-storage';\nexport { IndexedDBStorageAdapter } from './kv-cache/indexeddb-storage';\nexport type { StorageAdapter, StorageStats } from './kv-cache/storage-adapter';\n\n// KV cache validation\nexport {\n StorageValidator,\n validateKey,\n validateValue,\n validateKeyValue,\n assertValidKey,\n assertValidValue,\n assertValidKeyValue,\n DEFAULT_VALIDATION_CONFIG,\n} from './kv-cache/validation';\nexport type { ValidationConfig, ValidationResult } from './kv-cache/validation';\n\n// Storage API for the public `client.storage` namespace.\nexport * from './storage';\n\n// Entity API for the public `client.entities` namespace.\nexport * from './entities';\n\n// Logging\nexport {\n Logger,\n getLogger,\n configureLogging,\n setLogLevel,\n logger,\n} from './utils/logger';\nexport type {\n LogLevel,\n LogContext,\n LogEntry,\n LoggerConfig,\n} from './utils/logger';\n\n// Debug logging\nexport {\n setDebugHandler,\n setDebugEnabled,\n isDebugEnabled,\n debugLog,\n debugInfo,\n debugWarn,\n debugError,\n} from './utils/debug-logger';\nexport type { DebugLogEntry, DebugLogHandler } from './utils/debug-logger';\n\n// Embedding\nexport { EmbeddingGenerator } from './embedding/embedding-generator';\nexport { TransformersAdapter } from './embedding/transformers-adapter';\nexport { WasmSemanticProcessor } from './embedding/wasm-semantic-processor';\nexport { testWebAssemblySupport } from './embedding/wasm-semantic-processor';\n\n// Search\nexport { SemanticSearch } from './search/semantic-search';\nexport { cosineSimilarity } from './search/similarity-calculator';\nexport type {\n SemanticSearchResult,\n SearchOptions,\n StoredContext,\n} from './search/semantic-search/types';\n\n// Utilities\nexport { PerformanceMonitor } from './utils/performance';\nexport { DebugTools } from './utils/debugging';\nexport * from './utils/validation';\nexport {\n getEnvironment,\n isTestEnvironment,\n isDevelopmentEnvironment,\n isExtensionEnvironment,\n} from './utils/environment';\n\n// Runtime configuration — singleton consumed by application wrappers\n// that need to initialize environment settings at SDK startup.\nexport { RuntimeConfig, runtimeConfig } from './core/runtime-config';\n\n// Memory system — types, provider interface, concrete adapters.\n// `MemoryService` is intentionally not re-exported from root; consumers\n// use `MemoryClient` (above) as the canonical API.\nexport * from './memory/types';\nexport * from './memory/errors';\nexport * from './memory/provider';\nexport * from './memory/capability-profiles';\nexport * from './memory/pipeline';\nexport * from './memory/registration';\nexport * from './memory/atomicmemory-provider';\nexport * from './memory/mem0-provider';\nexport * from './memory/hindsight-provider';\n\n// Version information\nexport const SDK_VERSION = '1.0.0';\nexport const API_VERSION = '1.0';\n"]}
		{"version":3,"sources":["../src/entities/client.ts","../src/client/atomic-memory-client.ts","../src/index.ts"],"names":["validateApiUrl","MemoryClient","ConcreteStorageClient"],"mappings":"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","file":"index.cjs","sourcesContent":["/*\n @file `EntitiesClient` — SDK surface for /v1/entities.\n \n Thin fetch wrapper over the entity API routes. All methods default\n * `entityType` to `'user'` since that is the primary use case.\n * Server responses use snake_case; this client maps to camelCase.\n \n Usage:\n * const client = new AtomicMemoryClient({ apiUrl, apiKey, userId });\n * const profile = await client.entities.profile('alice');\n * const attrs = await client.entities.attributes('alice', { attribute: 'role' });\n /\n\nimport { validateApiUrl } from '../utils/validate-api-url.js';\nimport type {\n DeleteEntityResult,\n EntityDetail,\n EntityListResult,\n EntityProfile,\n EntitySettings,\n EntityType,\n GetAttributesOptions,\n ListEntitiesOptions,\n MemoryHistory,\n MergeEntitiesResult,\n PatchEntitySettingsInput,\n} from './types.js';\n\nexport interface EntitiesClientConfig {\n apiUrl: string;\n apiKey: string;\n /\n Permit `apiUrl` to target loopback / private / reserved IP literals.\n * Defaults to `true`; set `false` to harden against SSRF. Link-local /\n * cloud-metadata addresses are blocked regardless. See `validateApiUrl`.\n /\n allowPrivateNetworks?: boolean;\n /* Optional fetch override — defaults to the Node global. /\n fetch?: typeof fetch;\n}\n\nexport class EntitiesClient {\n private readonly apiUrl: string;\n private readonly apiKey: string;\n private readonly fetchImpl: typeof fetch;\n\n constructor(config: EntitiesClientConfig) {\n if (!config.apiUrl) throw new Error('EntitiesClient: apiUrl is required');\n if (!config.apiKey) throw new Error('EntitiesClient: apiKey is required');\n this.apiUrl = validateApiUrl(config.apiUrl, {\n allowPrivateNetworks: config.allowPrivateNetworks,\n }).replace(/\\/+$/, '');\n this.apiKey = config.apiKey;\n this.fetchImpl = config.fetch ?? fetch;\n }\n\n /* Get the synthesized profile for an entity. /\n async profile(entityId: string, entityType: EntityType = 'user'): Promise<EntityProfile> {\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/profile`);\n return mapProfile(await res.json() as Record<string, unknown>);\n }\n\n /* List all entities with memory counts (paginated). /\n async list(opts: ListEntitiesOptions = {}): Promise<EntityListResult> {\n const qs = buildEntityListQuery(opts);\n const res = await this.request('GET', `/v1/entities${qs}`);\n return mapList(await res.json() as Record<string, unknown>);\n }\n\n /* Get entity detail — attributes, relations, and recent cards. /\n async get(entityId: string, entityType: EntityType = 'user'): Promise<EntityDetail> {\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}`);\n return mapDetail(await res.json() as Record<string, unknown>);\n }\n\n /* Cascade-delete all data for an entity. /\n async delete(entityId: string, entityType: EntityType = 'user'): Promise<DeleteEntityResult> {\n const res = await this.request('DELETE', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}`);\n return mapDeleteResult(await res.json() as Record<string, unknown>);\n }\n\n /* Get structured attribute triples for an entity. /\n async attributes(entityId: string, opts: GetAttributesOptions = {}, entityType: EntityType = 'user') {\n const qs = buildAttributesQuery(opts);\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/attributes${qs}`);\n const body = await res.json() as { attributes: unknown[] };\n return (body.attributes ?? []).map(mapAttribute);\n }\n\n /* Get the mutation history of a single memory record. /\n async memoryHistory(entityId: string, memoryId: string, entityType: EntityType = 'user'): Promise<MemoryHistory> {\n const res = await this.request(\n 'GET',\n `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/memories/${encodeURIComponent(memoryId)}/history`,\n );\n return mapHistory(await res.json() as Record<string, unknown>);\n }\n\n /* Update per-entity extraction guidance and pipeline config. /\n async patchSettings(entityId: string, input: PatchEntitySettingsInput, entityType: EntityType = 'user'): Promise<EntitySettings> {\n const body: Record<string, unknown> = {};\n if (input.extractionPrompt !== undefined) body.extraction_prompt = input.extractionPrompt;\n if (input.memoryKinds !== undefined) body.memory_kinds = input.memoryKinds;\n if (input.decayEnabled !== undefined) body.decay_enabled = input.decayEnabled;\n const res = await this.request(\n 'PATCH',\n `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/settings`,\n { headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) },\n );\n return mapSettings(await res.json() as Record<string, unknown>);\n }\n\n /* Merge a source entity into a target entity. /\n async merge(\n source: { entityId: string; entityType?: EntityType },\n target: { entityId: string; entityType?: EntityType },\n ): Promise<MergeEntitiesResult> {\n const body = {\n source: { entity_type: source.entityType ?? 'user', entity_id: source.entityId },\n target: { entity_type: target.entityType ?? 'user', entity_id: target.entityId },\n };\n const res = await this.request('POST', '/v1/entities/merge', {\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify(body),\n });\n return mapMergeResult(await res.json() as Record<string, unknown>);\n }\n\n private async request(\n method: string,\n path: string,\n init: { headers?: Record<string, string>; body?: BodyInit } = {},\n ): Promise<Response> {\n const url = `${this.apiUrl}${path}`;\n let res: Response;\n try {\n res = await this.fetchImpl(url, {\n method,\n headers: { Authorization: `Bearer ${this.apiKey}`, ...(init.headers ?? {}) },\n body: init.body,\n });\n } catch (cause) {\n throw new Error(\n `EntitiesClient: network error calling ${method} ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,\n );\n }\n if (res.ok) return res;\n const text = await res.text().catch(() => '');\n throw new Error(`EntitiesClient: ${method} ${path} failed with ${res.status}: ${text}`);\n }\n}\n\n// ---------------------------------------------------------------------------\n// Query builders\n// ---------------------------------------------------------------------------\n\nfunction buildEntityListQuery(opts: ListEntitiesOptions): string {\n const p = new URLSearchParams();\n if (opts.entityType) p.set('entity_type', opts.entityType);\n if (opts.page !== undefined) p.set('page', String(opts.page));\n if (opts.pageSize !== undefined) p.set('page_size', String(opts.pageSize));\n return p.toString() ? `?${p.toString()}` : '';\n}\n\nfunction buildAttributesQuery(opts: GetAttributesOptions): string {\n const p = new URLSearchParams();\n if (opts.attribute) p.set('attribute', opts.attribute);\n if (opts.entity) p.set('entity', opts.entity);\n if (opts.limit !== undefined) p.set('limit', String(opts.limit));\n return p.toString() ? `?${p.toString()}` : '';\n}\n\n// ---------------------------------------------------------------------------\n// Wire → SDK type mappers (snake_case → camelCase)\n// ---------------------------------------------------------------------------\n\nfunction mapAttribute(r: unknown) {\n const a = r as Record<string, unknown>;\n return {\n entity: a.entity as string,\n attribute: a.attribute as string,\n value: a.value as string,\n type: a.type as string,\n sourceMemoryId: (a.source_memory_id as string \| null) ?? null,\n observedAt: a.observed_at as string,\n };\n}\n\nfunction mapRelation(r: unknown) {\n const row = r as Record<string, unknown>;\n return {\n targetEntityId: row.target_entity_id as string,\n relationType: row.relation_type as string,\n confidence: row.confidence as number,\n validTo: (row.valid_to as string \| null) ?? null,\n };\n}\n\nfunction mapCard(c: unknown) {\n const card = c as Record<string, unknown>;\n return {\n entityName: card.entity_name as string,\n cardText: card.card_text as string,\n version: card.version as number,\n updatedAt: card.updated_at as string,\n };\n}\n\nfunction mapProfileBody(raw: Record<string, unknown> \| null): import('./types.js').EntityProfile['profile'] {\n if (!raw) return null;\n return {\n summary: raw.summary as string,\n preferences: (raw.preferences as string[]) ?? [],\n instructions: (raw.instructions as string[]) ?? [],\n openCommitments: (raw.open_commitments as string[]) ?? [],\n };\n}\n\nfunction mapProfile(r: Record<string, unknown>): import('./types.js').EntityProfile {\n return {\n entityType: r.entity_type as import('./types.js').EntityType,\n entityId: r.entity_id as string,\n profile: mapProfileBody(r.profile as Record<string, unknown> \| null),\n attributes: ((r.attributes as unknown[]) ?? []).map(mapAttribute),\n memoryCount: r.memory_count as number,\n lastActive: (r.last_active as string \| null) ?? null,\n updatedAt: (r.updated_at as string \| null) ?? null,\n };\n}\n\nfunction mapList(r: Record<string, unknown>): import('./types.js').EntityListResult {\n return {\n entities: ((r.entities as unknown[]) ?? []).map((e) => {\n const entity = e as Record<string, unknown>;\n return {\n entityType: entity.entity_type as import('./types.js').EntityType,\n entityId: entity.entity_id as string,\n memoryCount: entity.memory_count as number,\n lastActive: (entity.last_active as string \| null) ?? null,\n };\n }),\n total: r.total as number,\n page: r.page as number,\n pageSize: r.page_size as number,\n };\n}\n\nfunction mapDetail(r: Record<string, unknown>): import('./types.js').EntityDetail {\n return {\n entityType: r.entity_type as import('./types.js').EntityType,\n entityId: r.entity_id as string,\n memoryCount: r.memory_count as number,\n attributes: ((r.attributes as unknown[]) ?? []).map(mapAttribute),\n relations: ((r.relations as unknown[]) ?? []).map(mapRelation),\n recentCards: ((r.recent_cards as unknown[]) ?? []).map(mapCard),\n updatedAt: (r.updated_at as string \| null) ?? null,\n };\n}\n\nfunction mapDeleteResult(r: Record<string, unknown>): import('./types.js').DeleteEntityResult {\n const d = r.deleted as Record<string, number>;\n return {\n deleted: {\n memories: d.memories,\n entityAttributes: d.entity_attributes,\n profile: d.profile,\n entities: d.entities,\n entityEdges: d.entity_edges,\n entityCards: d.entity_cards,\n },\n };\n}\n\nfunction mapHistory(r: Record<string, unknown>): import('./types.js').MemoryHistory {\n return {\n memoryId: r.memory_id as string,\n history: ((r.history as unknown[]) ?? []).map((h) => {\n const entry = h as Record<string, unknown>;\n return {\n versionId: entry.version_id as string,\n event: entry.event as string,\n content: entry.content as string,\n timestamp: entry.timestamp as string,\n supersededBy: (entry.superseded_by as string \| null) ?? null,\n };\n }),\n };\n}\n\nfunction mapSettings(r: Record<string, unknown>): import('./types.js').EntitySettings {\n return {\n entityId: r.entity_id as string,\n extractionPrompt: (r.extraction_prompt as string \| null) ?? null,\n memoryKinds: (r.memory_kinds as string[] \| null) ?? null,\n decayEnabled: r.decay_enabled as boolean,\n updatedAt: r.updated_at as string,\n };\n}\n\nfunction mapMergeResult(r: Record<string, unknown>): import('./types.js').MergeEntitiesResult {\n const m = r.merged as Record<string, number>;\n return {\n merged: {\n memoriesMoved: m.memories_moved,\n attributesMoved: m.attributes_moved,\n cardsMoved: m.cards_moved,\n },\n targetEntityId: r.target_entity_id as string,\n };\n}\n","/\n @file `AtomicMemoryClient` — primary public surface for the SDK.\n \n Aggregates `memory` (the memory-layer API) and `storage` (the\n * direct-storage API) under one client so callers see a coherent\n * single entry point:\n \n import { AtomicMemoryClient } from '@atomicmemory/sdk';\n * const client = new AtomicMemoryClient({\n * apiUrl: 'http://localhost:17350',\n * apiKey: process.env.ATOMICMEMORY_API_KEY!,\n * userId: 'u1',\n * });\n * await client.memory.initialize();\n * const artifact = await client.storage.put({\n * mode: 'pointer',\n * uri: 'https://example.com/file.pdf',\n * contentType: 'application/pdf',\n * });\n \n v1 SDK is server-side only. Browser bundles must proxy through a\n * trusted server, such as an application-owned API boundary.\n \n Applications that only need memory operations can still use\n * `MemoryClient` directly. New integrations should prefer\n * `AtomicMemoryClient.memory`.\n /\n\nimport { MemoryClient, type MemoryClientConfig } from './memory-client';\nimport { ConcreteStorageClient } from '../storage/client';\nimport type { StorageClient } from '../storage/interfaces';\nimport { EntitiesClient } from '../entities/client';\n\n/\n Constructor config for the aggregator. All three transport fields\n * (`apiUrl`, `apiKey`, `userId`) are REQUIRED — they back both the\n * storage namespace and the default AtomicMemory memory provider.\n * Memory-only consumers should still pass `apiUrl` (it doubles as\n * the default memory provider's `apiUrl`); the `memory` block then\n * narrows the registration further if a non-default provider mix is\n * needed.\n \n `userId` is the owner-scope seam the storage routes accept until a\n * real auth seam ships. `fetch` is an optional override; defaults to\n * the Node global.\n /\nexport interface AtomicMemoryClientConfig {\n apiUrl: string;\n apiKey: string;\n userId: string;\n /* Optional fetch override — defaults to the Node global. /\n fetch?: typeof fetch;\n /\n Permit `apiUrl` to target loopback / private / reserved IP literals.\n * Defaults to `true` — the SDK routinely connects to local/self-hosted\n * cores. Set `false` to harden against SSRF; link-local / cloud-metadata\n * addresses are blocked regardless. Forwarded to the default memory\n * provider, storage, and entities sub-clients. See `validateApiUrl`.\n /\n allowPrivateNetworks?: boolean;\n /* Memory-provider registration. Defaults to a single AtomicMemory\n * provider pointing at `apiUrl`. /\n memory?: MemoryClientConfig;\n}\n\n/\n Primary public client. Holds a `memory` namespace (`MemoryClient`)\n * and a `storage` namespace (`StorageClient`).\n /\nexport class AtomicMemoryClient {\n readonly memory: MemoryClient;\n readonly storage: StorageClient;\n readonly entities: EntitiesClient;\n\n constructor(config: AtomicMemoryClientConfig) {\n if (!config.apiUrl) {\n throw new Error('AtomicMemoryClient: apiUrl is required');\n }\n if (!config.apiKey) {\n throw new Error('AtomicMemoryClient: apiKey is required');\n }\n if (!config.userId) {\n throw new Error('AtomicMemoryClient: userId is required');\n }\n // Default provider registration MUST forward the apiKey so the\n // memory namespace shares the storage namespace's auth contract.\n // The earlier shape dropped it silently — memory requests went\n // out unauthenticated even when the caller supplied `apiKey`,\n // failing with 401 against any core deployment that gates `/v1/`\n // (every deployment since the auth middleware landed).\n this.memory = new MemoryClient(\n config.memory ?? {\n providers: {\n atomicmemory: {\n apiUrl: config.apiUrl,\n apiKey: config.apiKey,\n allowPrivateNetworks: config.allowPrivateNetworks,\n },\n },\n },\n );\n this.storage = new ConcreteStorageClient({\n apiUrl: config.apiUrl,\n apiKey: config.apiKey,\n userId: config.userId,\n allowPrivateNetworks: config.allowPrivateNetworks,\n fetch: config.fetch,\n });\n this.entities = new EntitiesClient({\n apiUrl: config.apiUrl,\n apiKey: config.apiKey,\n allowPrivateNetworks: config.allowPrivateNetworks,\n fetch: config.fetch,\n });\n }\n}\n","/*\n @file @atomicmemory/sdk public surface\n \n Backend-agnostic memory-layer SDK. Pluggable providers, local\n * embeddings, storage adapters, semantic search.\n \n @example\n * ```typescript\n * import { MemoryClient } from '@atomicmemory/sdk';\n \n const memory = new MemoryClient({\n * providers: { atomicmemory: { apiUrl: 'http://localhost:17350' } },\n * });\n * await memory.initialize();\n * await memory.ingest({ mode: 'text', content: 'hello', scope: { user: 'u1' } });\n * const results = await memory.search({ query: 'hello', scope: { user: 'u1' } });\n * ```\n /\n\n// Primary client — `AtomicMemoryClient` aggregates the memory and\n// storage namespaces. `MemoryClient` remains available for\n// applications that only need memory operations.\nexport {\n AtomicMemoryClient,\n type AtomicMemoryClientConfig,\n} from './client/atomic-memory-client';\n\nexport { MemoryClient } from './client/memory-client';\nexport type {\n MemoryClientConfig,\n MemoryProviderConfigs,\n ProviderStatus,\n} from './client/memory-client';\n\n// Types\nexport from './types';\n\n// Event system\nexport { EventEmitter, type EventMap } from './core/events';\n\n// Error handling\nexport {\n AtomicMemoryError,\n StorageError,\n EmbeddingError,\n SearchError,\n ConfigurationError,\n NetworkError,\n RetryableOperation,\n withRetry,\n ErrorContext,\n ErrorUtils,\n type RetryPolicy,\n} from './core/error-handling/';\n\n// KV cache used by embeddings and local search. New artifact-storage\n// integrations should use the `./storage` subpath.\nexport { StorageManager } from './kv-cache/storage-manager';\nexport { MemoryStorageAdapter } from './kv-cache/memory-storage';\nexport { IndexedDBStorageAdapter } from './kv-cache/indexeddb-storage';\nexport type { StorageAdapter, StorageStats } from './kv-cache/storage-adapter';\n\n// KV cache validation\nexport {\n StorageValidator,\n validateKey,\n validateValue,\n validateKeyValue,\n assertValidKey,\n assertValidValue,\n assertValidKeyValue,\n DEFAULT_VALIDATION_CONFIG,\n} from './kv-cache/validation';\nexport type { ValidationConfig, ValidationResult } from './kv-cache/validation';\n\n// Storage API for the public `client.storage` namespace.\nexport * from './storage';\n\n// Entity API for the public `client.entities` namespace.\nexport * from './entities';\n\n// Logging\nexport {\n Logger,\n getLogger,\n configureLogging,\n setLogLevel,\n logger,\n} from './utils/logger';\nexport type {\n LogLevel,\n LogContext,\n LogEntry,\n LoggerConfig,\n} from './utils/logger';\n\n// Debug logging\nexport {\n setDebugHandler,\n setDebugEnabled,\n isDebugEnabled,\n debugLog,\n debugInfo,\n debugWarn,\n debugError,\n} from './utils/debug-logger';\nexport type { DebugLogEntry, DebugLogHandler } from './utils/debug-logger';\n\n// Embedding\nexport { EmbeddingGenerator } from './embedding/embedding-generator';\nexport { TransformersAdapter } from './embedding/transformers-adapter';\nexport { WasmSemanticProcessor } from './embedding/wasm-semantic-processor';\nexport { testWebAssemblySupport } from './embedding/wasm-semantic-processor';\n\n// Search\nexport { SemanticSearch } from './search/semantic-search';\nexport { cosineSimilarity } from './search/similarity-calculator';\nexport type {\n SemanticSearchResult,\n SearchOptions,\n StoredContext,\n} from './search/semantic-search/types';\n\n// Utilities\nexport { PerformanceMonitor } from './utils/performance';\nexport { DebugTools } from './utils/debugging';\nexport * from './utils/validation';\nexport {\n getEnvironment,\n isTestEnvironment,\n isDevelopmentEnvironment,\n isExtensionEnvironment,\n} from './utils/environment';\n\n// Runtime configuration — singleton consumed by application wrappers\n// that need to initialize environment settings at SDK startup.\nexport { RuntimeConfig, runtimeConfig } from './core/runtime-config';\n\n// Memory system — types, provider interface, concrete adapters.\n// `MemoryService` is intentionally not re-exported from root; consumers\n// use `MemoryClient` (above) as the canonical API.\nexport * from './memory/types';\nexport * from './memory/errors';\nexport * from './memory/provider';\nexport * from './memory/capability-profiles';\nexport * from './memory/pipeline';\nexport * from './memory/registration';\nexport * from './memory/atomicmemory-provider';\nexport * from './memory/mem0-provider';\nexport * from './memory/hindsight-provider';\n\n// Version information\nexport const SDK_VERSION = '1.0.0';\nexport const API_VERSION = '1.0';\n"]}

+15

-1

dist/index.d.cts

		@@ -13,3 +13,3 @@ import { MemoryClient, MemoryClientConfig } from './browser.cjs';
		export { S as SearchOptions, a as SemanticSearch, b as SemanticSearchResult, c as StoredContext, f as cosineSimilarity } from './similarity-calculator-C03LitnZ.cjs';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, i as AtomicMemoryHandle, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, s as AtomicMemoryProviderConfig, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, F as Capabilities, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, Q as ContextPackage, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ah as HindsightProviderConfig, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, ap as IngestInput, aq as IngestResult, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, az as ListRequest, aA as ListResultPage, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aF as Mem0ProviderConfig, aG as Memory, aH as MemoryKind, aI as MemoryProcessingPipeline, aJ as MemoryProvider, aK as MemoryProviderEntry, aL as MemoryProviderError, aM as MemoryProviderRegistration, aN as MemoryRef, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aX as PackageRequest, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, b9 as SearchRequest, ba as SearchResult, bb as SearchResultPage, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bm as noopMemoryPipeline } from './hindsight-provider-CbfXnvx7.cjs';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, i as AtomicMemoryHandle, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, s as AtomicMemoryProviderConfig, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, F as Capabilities, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, Q as ContextPackage, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ah as HindsightProviderConfig, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, ap as IngestInput, aq as IngestResult, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, az as ListRequest, aA as ListResultPage, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aF as Mem0ProviderConfig, aG as Memory, aH as MemoryKind, aI as MemoryProcessingPipeline, aJ as MemoryProvider, aK as MemoryProviderEntry, aL as MemoryProviderError, aM as MemoryProviderRegistration, aN as MemoryRef, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aX as PackageRequest, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, b9 as SearchRequest, ba as SearchResult, bb as SearchResultPage, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bm as noopMemoryPipeline } from './hindsight-provider-2_IU9rqm.cjs';
		export { CapabilityGap, CapabilityProfile, capabilityGaps, satisfiesProfile } from './memory.cjs';
		@@ -148,2 +148,8 @@
		apiKey: string;
		/**
		* Permit `apiUrl` to target loopback / private / reserved IP literals.
		* Defaults to `true`; set `false` to harden against SSRF. Link-local /
		* cloud-metadata addresses are blocked regardless. See `validateApiUrl`.
		*/
		allowPrivateNetworks?: boolean;
		/** Optional fetch override — defaults to the Node global. */
		@@ -236,2 +242,10 @@ fetch?: typeof fetch;
		fetch?: typeof fetch;
		/**
		* Permit `apiUrl` to target loopback / private / reserved IP literals.
		* Defaults to `true` — the SDK routinely connects to local/self-hosted
		* cores. Set `false` to harden against SSRF; link-local / cloud-metadata
		* addresses are blocked regardless. Forwarded to the default memory
		* provider, storage, and entities sub-clients. See `validateApiUrl`.
		*/
		allowPrivateNetworks?: boolean;
		/** Memory-provider registration. Defaults to a single AtomicMemory
		@@ -238,0 +252,0 @@ * provider pointing at `apiUrl`. */

+15

-1

dist/index.d.ts

		@@ -13,3 +13,3 @@ import { MemoryClient, MemoryClientConfig } from './browser.js';
		export { S as SearchOptions, a as SemanticSearch, b as SemanticSearchResult, c as StoredContext, f as cosineSimilarity } from './similarity-calculator-Cxx4s-Gq.js';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, i as AtomicMemoryHandle, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, s as AtomicMemoryProviderConfig, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, F as Capabilities, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, Q as ContextPackage, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ah as HindsightProviderConfig, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, ap as IngestInput, aq as IngestResult, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, az as ListRequest, aA as ListResultPage, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aF as Mem0ProviderConfig, aG as Memory, aH as MemoryKind, aI as MemoryProcessingPipeline, aJ as MemoryProvider, aK as MemoryProviderEntry, aL as MemoryProviderError, aM as MemoryProviderRegistration, aN as MemoryRef, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aX as PackageRequest, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, b9 as SearchRequest, ba as SearchResult, bb as SearchResultPage, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bm as noopMemoryPipeline } from './hindsight-provider-CbfXnvx7.js';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, i as AtomicMemoryHandle, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, s as AtomicMemoryProviderConfig, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, F as Capabilities, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, Q as ContextPackage, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ah as HindsightProviderConfig, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, ap as IngestInput, aq as IngestResult, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, az as ListRequest, aA as ListResultPage, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aF as Mem0ProviderConfig, aG as Memory, aH as MemoryKind, aI as MemoryProcessingPipeline, aJ as MemoryProvider, aK as MemoryProviderEntry, aL as MemoryProviderError, aM as MemoryProviderRegistration, aN as MemoryRef, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aX as PackageRequest, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, b9 as SearchRequest, ba as SearchResult, bb as SearchResultPage, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bm as noopMemoryPipeline } from './hindsight-provider-2_IU9rqm.js';
		export { CapabilityGap, CapabilityProfile, capabilityGaps, satisfiesProfile } from './memory.js';
		@@ -148,2 +148,8 @@
		apiKey: string;
		/**
		* Permit `apiUrl` to target loopback / private / reserved IP literals.
		* Defaults to `true`; set `false` to harden against SSRF. Link-local /
		* cloud-metadata addresses are blocked regardless. See `validateApiUrl`.
		*/
		allowPrivateNetworks?: boolean;
		/** Optional fetch override — defaults to the Node global. */
		@@ -236,2 +242,10 @@ fetch?: typeof fetch;
		fetch?: typeof fetch;
		/**
		* Permit `apiUrl` to target loopback / private / reserved IP literals.
		* Defaults to `true` — the SDK routinely connects to local/self-hosted
		* cores. Set `false` to harden against SSRF; link-local / cloud-metadata
		* addresses are blocked regardless. Forwarded to the default memory
		* provider, storage, and entities sub-clients. See `validateApiUrl`.
		*/
		allowPrivateNetworks?: boolean;
		/** Memory-provider registration. Defaults to a single AtomicMemory
		@@ -238,0 +252,0 @@ * provider pointing at `apiUrl`. */

+16

-7

dist/index.js

		export { capabilityGaps, satisfiesProfile } from './chunk-4CP57UR3.js';
		import { MemoryClient } from './chunk-V5K4WVX5.js';
		export { MemoryClient } from './chunk-V5K4WVX5.js';
		export { ATOMICMEMORY_DEFAULT_TIMEOUT, ATOMICMEMORY_EXTENSION_NAMES, AtomicMemoryProvider, BaseMemoryProvider, HINDSIGHT_DEFAULT_API_VERSION, HINDSIGHT_DEFAULT_MAX_TOKENS, HINDSIGHT_DEFAULT_PROJECT_ID, HINDSIGHT_DEFAULT_TIMEOUT, HINDSIGHT_SCOPE_TAGS_MATCH, HindsightProvider, InvalidScopeError, MEM0_DEFAULT_TIMEOUT, Mem0ContextProvider, Mem0Provider, MemoryProviderError, MemoryTransportError, RateLimitError, UnsupportedOperationError, noopMemoryPipeline } from './chunk-T7PRWXW6.js';
		import { MemoryClient } from './chunk-KYVD7KQV.js';
		export { MemoryClient } from './chunk-KYVD7KQV.js';
		export { ATOMICMEMORY_DEFAULT_TIMEOUT, ATOMICMEMORY_EXTENSION_NAMES, AtomicMemoryProvider, BaseMemoryProvider, HINDSIGHT_DEFAULT_API_VERSION, HINDSIGHT_DEFAULT_MAX_TOKENS, HINDSIGHT_DEFAULT_PROJECT_ID, HINDSIGHT_DEFAULT_TIMEOUT, HINDSIGHT_SCOPE_TAGS_MATCH, HindsightProvider, InvalidScopeError, MEM0_DEFAULT_TIMEOUT, Mem0ContextProvider, Mem0Provider, MemoryProviderError, MemoryTransportError, RateLimitError, UnsupportedOperationError, noopMemoryPipeline } from './chunk-KI5UNWJI.js';
		export { DEFAULT_VALIDATION_CONFIG, IndexedDBStorageAdapter, MemoryStorageAdapter, StorageManager, StorageValidator, assertValidKey, assertValidKeyValue, assertValidValue, validateKey, validateKeyValue, validateValue } from './chunk-4H2WXRAW.js';
		import { ConcreteStorageClient } from './chunk-OFIOAOM3.js';
		export { ArtifactInUseError, ArtifactNotFoundError, ConcreteStorageClient, FilecoinDirectStorageNotSupportedError, PointerContentNotManagedError, StorageClientError, UnsupportedCapabilityError } from './chunk-OFIOAOM3.js';
		import { ConcreteStorageClient } from './chunk-LCCTVUJO.js';
		export { ArtifactInUseError, ArtifactNotFoundError, ConcreteStorageClient, FilecoinDirectStorageNotSupportedError, PointerContentNotManagedError, StorageClientError, UnsupportedCapabilityError } from './chunk-LCCTVUJO.js';
		import { validateApiUrl } from './chunk-3HWUP4VL.js';
		export { EmbeddingGenerator, WasmSemanticProcessor, testWebAssemblySupport } from './chunk-CLKTWYFG.js';
		@@ -26,3 +27,5 @@ export { TransformersAdapter } from './chunk-X73QW6GA.js';
		if (!config.apiKey) throw new Error("EntitiesClient: apiKey is required");
		this.apiUrl = config.apiUrl.replace(/\/+$/, "");
		this.apiUrl = validateApiUrl(config.apiUrl, {
		allowPrivateNetworks: config.allowPrivateNetworks
		}).replace(/\/+$/, "");
		this.apiKey = config.apiKey;
		@@ -268,3 +271,7 @@ this.fetchImpl = config.fetch ?? fetch;
		providers: {
		atomicmemory: { apiUrl: config.apiUrl, apiKey: config.apiKey }
		atomicmemory: {
		apiUrl: config.apiUrl,
		apiKey: config.apiKey,
		allowPrivateNetworks: config.allowPrivateNetworks
		}
		}
		@@ -277,2 +284,3 @@ }
		userId: config.userId,
		allowPrivateNetworks: config.allowPrivateNetworks,
		fetch: config.fetch
		@@ -283,2 +291,3 @@ });
		apiKey: config.apiKey,
		allowPrivateNetworks: config.allowPrivateNetworks,
		fetch: config.fetch
		@@ -285,0 +294,0 @@ });

+1

-1

dist/index.js.map

		@@ -1,1 +0,1 @@
		{"version":3,"sources":["../src/entities/client.ts","../src/client/atomic-memory-client.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/*\n @file `EntitiesClient` — SDK surface for /v1/entities.\n \n Thin fetch wrapper over the entity API routes. All methods default\n * `entityType` to `'user'` since that is the primary use case.\n * Server responses use snake_case; this client maps to camelCase.\n \n Usage:\n * const client = new AtomicMemoryClient({ apiUrl, apiKey, userId });\n * const profile = await client.entities.profile('alice');\n * const attrs = await client.entities.attributes('alice', { attribute: 'role' });\n /\n\nimport type {\n DeleteEntityResult,\n EntityDetail,\n EntityListResult,\n EntityProfile,\n EntitySettings,\n EntityType,\n GetAttributesOptions,\n ListEntitiesOptions,\n MemoryHistory,\n MergeEntitiesResult,\n PatchEntitySettingsInput,\n} from './types.js';\n\nexport interface EntitiesClientConfig {\n apiUrl: string;\n apiKey: string;\n /* Optional fetch override — defaults to the Node global. /\n fetch?: typeof fetch;\n}\n\nexport class EntitiesClient {\n private readonly apiUrl: string;\n private readonly apiKey: string;\n private readonly fetchImpl: typeof fetch;\n\n constructor(config: EntitiesClientConfig) {\n if (!config.apiUrl) throw new Error('EntitiesClient: apiUrl is required');\n if (!config.apiKey) throw new Error('EntitiesClient: apiKey is required');\n this.apiUrl = config.apiUrl.replace(/\\/+$/, '');\n this.apiKey = config.apiKey;\n this.fetchImpl = config.fetch ?? fetch;\n }\n\n /* Get the synthesized profile for an entity. /\n async profile(entityId: string, entityType: EntityType = 'user'): Promise<EntityProfile> {\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/profile`);\n return mapProfile(await res.json() as Record<string, unknown>);\n }\n\n /* List all entities with memory counts (paginated). /\n async list(opts: ListEntitiesOptions = {}): Promise<EntityListResult> {\n const qs = buildEntityListQuery(opts);\n const res = await this.request('GET', `/v1/entities${qs}`);\n return mapList(await res.json() as Record<string, unknown>);\n }\n\n /* Get entity detail — attributes, relations, and recent cards. /\n async get(entityId: string, entityType: EntityType = 'user'): Promise<EntityDetail> {\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}`);\n return mapDetail(await res.json() as Record<string, unknown>);\n }\n\n /* Cascade-delete all data for an entity. /\n async delete(entityId: string, entityType: EntityType = 'user'): Promise<DeleteEntityResult> {\n const res = await this.request('DELETE', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}`);\n return mapDeleteResult(await res.json() as Record<string, unknown>);\n }\n\n /* Get structured attribute triples for an entity. /\n async attributes(entityId: string, opts: GetAttributesOptions = {}, entityType: EntityType = 'user') {\n const qs = buildAttributesQuery(opts);\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/attributes${qs}`);\n const body = await res.json() as { attributes: unknown[] };\n return (body.attributes ?? []).map(mapAttribute);\n }\n\n /* Get the mutation history of a single memory record. /\n async memoryHistory(entityId: string, memoryId: string, entityType: EntityType = 'user'): Promise<MemoryHistory> {\n const res = await this.request(\n 'GET',\n `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/memories/${encodeURIComponent(memoryId)}/history`,\n );\n return mapHistory(await res.json() as Record<string, unknown>);\n }\n\n /* Update per-entity extraction guidance and pipeline config. /\n async patchSettings(entityId: string, input: PatchEntitySettingsInput, entityType: EntityType = 'user'): Promise<EntitySettings> {\n const body: Record<string, unknown> = {};\n if (input.extractionPrompt !== undefined) body.extraction_prompt = input.extractionPrompt;\n if (input.memoryKinds !== undefined) body.memory_kinds = input.memoryKinds;\n if (input.decayEnabled !== undefined) body.decay_enabled = input.decayEnabled;\n const res = await this.request(\n 'PATCH',\n `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/settings`,\n { headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) },\n );\n return mapSettings(await res.json() as Record<string, unknown>);\n }\n\n /* Merge a source entity into a target entity. /\n async merge(\n source: { entityId: string; entityType?: EntityType },\n target: { entityId: string; entityType?: EntityType },\n ): Promise<MergeEntitiesResult> {\n const body = {\n source: { entity_type: source.entityType ?? 'user', entity_id: source.entityId },\n target: { entity_type: target.entityType ?? 'user', entity_id: target.entityId },\n };\n const res = await this.request('POST', '/v1/entities/merge', {\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify(body),\n });\n return mapMergeResult(await res.json() as Record<string, unknown>);\n }\n\n private async request(\n method: string,\n path: string,\n init: { headers?: Record<string, string>; body?: BodyInit } = {},\n ): Promise<Response> {\n const url = `${this.apiUrl}${path}`;\n let res: Response;\n try {\n res = await this.fetchImpl(url, {\n method,\n headers: { Authorization: `Bearer ${this.apiKey}`, ...(init.headers ?? {}) },\n body: init.body,\n });\n } catch (cause) {\n throw new Error(\n `EntitiesClient: network error calling ${method} ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,\n );\n }\n if (res.ok) return res;\n const text = await res.text().catch(() => '');\n throw new Error(`EntitiesClient: ${method} ${path} failed with ${res.status}: ${text}`);\n }\n}\n\n// ---------------------------------------------------------------------------\n// Query builders\n// ---------------------------------------------------------------------------\n\nfunction buildEntityListQuery(opts: ListEntitiesOptions): string {\n const p = new URLSearchParams();\n if (opts.entityType) p.set('entity_type', opts.entityType);\n if (opts.page !== undefined) p.set('page', String(opts.page));\n if (opts.pageSize !== undefined) p.set('page_size', String(opts.pageSize));\n return p.toString() ? `?${p.toString()}` : '';\n}\n\nfunction buildAttributesQuery(opts: GetAttributesOptions): string {\n const p = new URLSearchParams();\n if (opts.attribute) p.set('attribute', opts.attribute);\n if (opts.entity) p.set('entity', opts.entity);\n if (opts.limit !== undefined) p.set('limit', String(opts.limit));\n return p.toString() ? `?${p.toString()}` : '';\n}\n\n// ---------------------------------------------------------------------------\n// Wire → SDK type mappers (snake_case → camelCase)\n// ---------------------------------------------------------------------------\n\nfunction mapAttribute(r: unknown) {\n const a = r as Record<string, unknown>;\n return {\n entity: a.entity as string,\n attribute: a.attribute as string,\n value: a.value as string,\n type: a.type as string,\n sourceMemoryId: (a.source_memory_id as string \| null) ?? null,\n observedAt: a.observed_at as string,\n };\n}\n\nfunction mapRelation(r: unknown) {\n const row = r as Record<string, unknown>;\n return {\n targetEntityId: row.target_entity_id as string,\n relationType: row.relation_type as string,\n confidence: row.confidence as number,\n validTo: (row.valid_to as string \| null) ?? null,\n };\n}\n\nfunction mapCard(c: unknown) {\n const card = c as Record<string, unknown>;\n return {\n entityName: card.entity_name as string,\n cardText: card.card_text as string,\n version: card.version as number,\n updatedAt: card.updated_at as string,\n };\n}\n\nfunction mapProfileBody(raw: Record<string, unknown> \| null): import('./types.js').EntityProfile['profile'] {\n if (!raw) return null;\n return {\n summary: raw.summary as string,\n preferences: (raw.preferences as string[]) ?? [],\n instructions: (raw.instructions as string[]) ?? [],\n openCommitments: (raw.open_commitments as string[]) ?? [],\n };\n}\n\nfunction mapProfile(r: Record<string, unknown>): import('./types.js').EntityProfile {\n return {\n entityType: r.entity_type as import('./types.js').EntityType,\n entityId: r.entity_id as string,\n profile: mapProfileBody(r.profile as Record<string, unknown> \| null),\n attributes: ((r.attributes as unknown[]) ?? []).map(mapAttribute),\n memoryCount: r.memory_count as number,\n lastActive: (r.last_active as string \| null) ?? null,\n updatedAt: (r.updated_at as string \| null) ?? null,\n };\n}\n\nfunction mapList(r: Record<string, unknown>): import('./types.js').EntityListResult {\n return {\n entities: ((r.entities as unknown[]) ?? []).map((e) => {\n const entity = e as Record<string, unknown>;\n return {\n entityType: entity.entity_type as import('./types.js').EntityType,\n entityId: entity.entity_id as string,\n memoryCount: entity.memory_count as number,\n lastActive: (entity.last_active as string \| null) ?? null,\n };\n }),\n total: r.total as number,\n page: r.page as number,\n pageSize: r.page_size as number,\n };\n}\n\nfunction mapDetail(r: Record<string, unknown>): import('./types.js').EntityDetail {\n return {\n entityType: r.entity_type as import('./types.js').EntityType,\n entityId: r.entity_id as string,\n memoryCount: r.memory_count as number,\n attributes: ((r.attributes as unknown[]) ?? []).map(mapAttribute),\n relations: ((r.relations as unknown[]) ?? []).map(mapRelation),\n recentCards: ((r.recent_cards as unknown[]) ?? []).map(mapCard),\n updatedAt: (r.updated_at as string \| null) ?? null,\n };\n}\n\nfunction mapDeleteResult(r: Record<string, unknown>): import('./types.js').DeleteEntityResult {\n const d = r.deleted as Record<string, number>;\n return {\n deleted: {\n memories: d.memories,\n entityAttributes: d.entity_attributes,\n profile: d.profile,\n entities: d.entities,\n entityEdges: d.entity_edges,\n entityCards: d.entity_cards,\n },\n };\n}\n\nfunction mapHistory(r: Record<string, unknown>): import('./types.js').MemoryHistory {\n return {\n memoryId: r.memory_id as string,\n history: ((r.history as unknown[]) ?? []).map((h) => {\n const entry = h as Record<string, unknown>;\n return {\n versionId: entry.version_id as string,\n event: entry.event as string,\n content: entry.content as string,\n timestamp: entry.timestamp as string,\n supersededBy: (entry.superseded_by as string \| null) ?? null,\n };\n }),\n };\n}\n\nfunction mapSettings(r: Record<string, unknown>): import('./types.js').EntitySettings {\n return {\n entityId: r.entity_id as string,\n extractionPrompt: (r.extraction_prompt as string \| null) ?? null,\n memoryKinds: (r.memory_kinds as string[] \| null) ?? null,\n decayEnabled: r.decay_enabled as boolean,\n updatedAt: r.updated_at as string,\n };\n}\n\nfunction mapMergeResult(r: Record<string, unknown>): import('./types.js').MergeEntitiesResult {\n const m = r.merged as Record<string, number>;\n return {\n merged: {\n memoriesMoved: m.memories_moved,\n attributesMoved: m.attributes_moved,\n cardsMoved: m.cards_moved,\n },\n targetEntityId: r.target_entity_id as string,\n };\n}\n","/\n @file `AtomicMemoryClient` — primary public surface for the SDK.\n \n Aggregates `memory` (the memory-layer API) and `storage` (the\n * direct-storage API) under one client so callers see a coherent\n * single entry point:\n \n import { AtomicMemoryClient } from '@atomicmemory/sdk';\n * const client = new AtomicMemoryClient({\n * apiUrl: 'http://localhost:17350',\n * apiKey: process.env.ATOMICMEMORY_API_KEY!,\n * userId: 'u1',\n * });\n * await client.memory.initialize();\n * const artifact = await client.storage.put({\n * mode: 'pointer',\n * uri: 'https://example.com/file.pdf',\n * contentType: 'application/pdf',\n * });\n \n v1 SDK is server-side only. Browser bundles must proxy through a\n * trusted server, such as an application-owned API boundary.\n \n Applications that only need memory operations can still use\n * `MemoryClient` directly. New integrations should prefer\n * `AtomicMemoryClient.memory`.\n /\n\nimport { MemoryClient, type MemoryClientConfig } from './memory-client';\nimport { ConcreteStorageClient } from '../storage/client';\nimport type { StorageClient } from '../storage/interfaces';\nimport { EntitiesClient } from '../entities/client';\n\n/\n Constructor config for the aggregator. All three transport fields\n * (`apiUrl`, `apiKey`, `userId`) are REQUIRED — they back both the\n * storage namespace and the default AtomicMemory memory provider.\n * Memory-only consumers should still pass `apiUrl` (it doubles as\n * the default memory provider's `apiUrl`); the `memory` block then\n * narrows the registration further if a non-default provider mix is\n * needed.\n \n `userId` is the owner-scope seam the storage routes accept until a\n * real auth seam ships. `fetch` is an optional override; defaults to\n * the Node global.\n /\nexport interface AtomicMemoryClientConfig {\n apiUrl: string;\n apiKey: string;\n userId: string;\n /* Optional fetch override — defaults to the Node global. /\n fetch?: typeof fetch;\n /* Memory-provider registration. Defaults to a single AtomicMemory\n * provider pointing at `apiUrl`. /\n memory?: MemoryClientConfig;\n}\n\n/\n Primary public client. Holds a `memory` namespace (`MemoryClient`)\n * and a `storage` namespace (`StorageClient`).\n /\nexport class AtomicMemoryClient {\n readonly memory: MemoryClient;\n readonly storage: StorageClient;\n readonly entities: EntitiesClient;\n\n constructor(config: AtomicMemoryClientConfig) {\n if (!config.apiUrl) {\n throw new Error('AtomicMemoryClient: apiUrl is required');\n }\n if (!config.apiKey) {\n throw new Error('AtomicMemoryClient: apiKey is required');\n }\n if (!config.userId) {\n throw new Error('AtomicMemoryClient: userId is required');\n }\n // Default provider registration MUST forward the apiKey so the\n // memory namespace shares the storage namespace's auth contract.\n // The earlier shape dropped it silently — memory requests went\n // out unauthenticated even when the caller supplied `apiKey`,\n // failing with 401 against any core deployment that gates `/v1/`\n // (every deployment since the auth middleware landed).\n this.memory = new MemoryClient(\n config.memory ?? {\n providers: {\n atomicmemory: { apiUrl: config.apiUrl, apiKey: config.apiKey },\n },\n },\n );\n this.storage = new ConcreteStorageClient({\n apiUrl: config.apiUrl,\n apiKey: config.apiKey,\n userId: config.userId,\n fetch: config.fetch,\n });\n this.entities = new EntitiesClient({\n apiUrl: config.apiUrl,\n apiKey: config.apiKey,\n fetch: config.fetch,\n });\n }\n}\n","/*\n @file @atomicmemory/sdk public surface\n \n Backend-agnostic memory-layer SDK. Pluggable providers, local\n * embeddings, storage adapters, semantic search.\n \n @example\n * ```typescript\n * import { MemoryClient } from '@atomicmemory/sdk';\n \n const memory = new MemoryClient({\n * providers: { atomicmemory: { apiUrl: 'http://localhost:17350' } },\n * });\n * await memory.initialize();\n * await memory.ingest({ mode: 'text', content: 'hello', scope: { user: 'u1' } });\n * const results = await memory.search({ query: 'hello', scope: { user: 'u1' } });\n * ```\n /\n\n// Primary client — `AtomicMemoryClient` aggregates the memory and\n// storage namespaces. `MemoryClient` remains available for\n// applications that only need memory operations.\nexport {\n AtomicMemoryClient,\n type AtomicMemoryClientConfig,\n} from './client/atomic-memory-client';\n\nexport { MemoryClient } from './client/memory-client';\nexport type {\n MemoryClientConfig,\n MemoryProviderConfigs,\n ProviderStatus,\n} from './client/memory-client';\n\n// Types\nexport from './types';\n\n// Event system\nexport { EventEmitter, type EventMap } from './core/events';\n\n// Error handling\nexport {\n AtomicMemoryError,\n StorageError,\n EmbeddingError,\n SearchError,\n ConfigurationError,\n NetworkError,\n RetryableOperation,\n withRetry,\n ErrorContext,\n ErrorUtils,\n type RetryPolicy,\n} from './core/error-handling/';\n\n// KV cache used by embeddings and local search. New artifact-storage\n// integrations should use the `./storage` subpath.\nexport { StorageManager } from './kv-cache/storage-manager';\nexport { MemoryStorageAdapter } from './kv-cache/memory-storage';\nexport { IndexedDBStorageAdapter } from './kv-cache/indexeddb-storage';\nexport type { StorageAdapter, StorageStats } from './kv-cache/storage-adapter';\n\n// KV cache validation\nexport {\n StorageValidator,\n validateKey,\n validateValue,\n validateKeyValue,\n assertValidKey,\n assertValidValue,\n assertValidKeyValue,\n DEFAULT_VALIDATION_CONFIG,\n} from './kv-cache/validation';\nexport type { ValidationConfig, ValidationResult } from './kv-cache/validation';\n\n// Storage API for the public `client.storage` namespace.\nexport * from './storage';\n\n// Entity API for the public `client.entities` namespace.\nexport * from './entities';\n\n// Logging\nexport {\n Logger,\n getLogger,\n configureLogging,\n setLogLevel,\n logger,\n} from './utils/logger';\nexport type {\n LogLevel,\n LogContext,\n LogEntry,\n LoggerConfig,\n} from './utils/logger';\n\n// Debug logging\nexport {\n setDebugHandler,\n setDebugEnabled,\n isDebugEnabled,\n debugLog,\n debugInfo,\n debugWarn,\n debugError,\n} from './utils/debug-logger';\nexport type { DebugLogEntry, DebugLogHandler } from './utils/debug-logger';\n\n// Embedding\nexport { EmbeddingGenerator } from './embedding/embedding-generator';\nexport { TransformersAdapter } from './embedding/transformers-adapter';\nexport { WasmSemanticProcessor } from './embedding/wasm-semantic-processor';\nexport { testWebAssemblySupport } from './embedding/wasm-semantic-processor';\n\n// Search\nexport { SemanticSearch } from './search/semantic-search';\nexport { cosineSimilarity } from './search/similarity-calculator';\nexport type {\n SemanticSearchResult,\n SearchOptions,\n StoredContext,\n} from './search/semantic-search/types';\n\n// Utilities\nexport { PerformanceMonitor } from './utils/performance';\nexport { DebugTools } from './utils/debugging';\nexport * from './utils/validation';\nexport {\n getEnvironment,\n isTestEnvironment,\n isDevelopmentEnvironment,\n isExtensionEnvironment,\n} from './utils/environment';\n\n// Runtime configuration — singleton consumed by application wrappers\n// that need to initialize environment settings at SDK startup.\nexport { RuntimeConfig, runtimeConfig } from './core/runtime-config';\n\n// Memory system — types, provider interface, concrete adapters.\n// `MemoryService` is intentionally not re-exported from root; consumers\n// use `MemoryClient` (above) as the canonical API.\nexport * from './memory/types';\nexport * from './memory/errors';\nexport * from './memory/provider';\nexport * from './memory/capability-profiles';\nexport * from './memory/pipeline';\nexport * from './memory/registration';\nexport * from './memory/atomicmemory-provider';\nexport * from './memory/mem0-provider';\nexport * from './memory/hindsight-provider';\n\n// Version information\nexport const SDK_VERSION = '1.0.0';\nexport const API_VERSION = '1.0';\n"]}
		{"version":3,"sources":["../src/entities/client.ts","../src/client/atomic-memory-client.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/*\n @file `EntitiesClient` — SDK surface for /v1/entities.\n \n Thin fetch wrapper over the entity API routes. All methods default\n * `entityType` to `'user'` since that is the primary use case.\n * Server responses use snake_case; this client maps to camelCase.\n \n Usage:\n * const client = new AtomicMemoryClient({ apiUrl, apiKey, userId });\n * const profile = await client.entities.profile('alice');\n * const attrs = await client.entities.attributes('alice', { attribute: 'role' });\n /\n\nimport { validateApiUrl } from '../utils/validate-api-url.js';\nimport type {\n DeleteEntityResult,\n EntityDetail,\n EntityListResult,\n EntityProfile,\n EntitySettings,\n EntityType,\n GetAttributesOptions,\n ListEntitiesOptions,\n MemoryHistory,\n MergeEntitiesResult,\n PatchEntitySettingsInput,\n} from './types.js';\n\nexport interface EntitiesClientConfig {\n apiUrl: string;\n apiKey: string;\n /\n Permit `apiUrl` to target loopback / private / reserved IP literals.\n * Defaults to `true`; set `false` to harden against SSRF. Link-local /\n * cloud-metadata addresses are blocked regardless. See `validateApiUrl`.\n /\n allowPrivateNetworks?: boolean;\n /* Optional fetch override — defaults to the Node global. /\n fetch?: typeof fetch;\n}\n\nexport class EntitiesClient {\n private readonly apiUrl: string;\n private readonly apiKey: string;\n private readonly fetchImpl: typeof fetch;\n\n constructor(config: EntitiesClientConfig) {\n if (!config.apiUrl) throw new Error('EntitiesClient: apiUrl is required');\n if (!config.apiKey) throw new Error('EntitiesClient: apiKey is required');\n this.apiUrl = validateApiUrl(config.apiUrl, {\n allowPrivateNetworks: config.allowPrivateNetworks,\n }).replace(/\\/+$/, '');\n this.apiKey = config.apiKey;\n this.fetchImpl = config.fetch ?? fetch;\n }\n\n /* Get the synthesized profile for an entity. /\n async profile(entityId: string, entityType: EntityType = 'user'): Promise<EntityProfile> {\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/profile`);\n return mapProfile(await res.json() as Record<string, unknown>);\n }\n\n /* List all entities with memory counts (paginated). /\n async list(opts: ListEntitiesOptions = {}): Promise<EntityListResult> {\n const qs = buildEntityListQuery(opts);\n const res = await this.request('GET', `/v1/entities${qs}`);\n return mapList(await res.json() as Record<string, unknown>);\n }\n\n /* Get entity detail — attributes, relations, and recent cards. /\n async get(entityId: string, entityType: EntityType = 'user'): Promise<EntityDetail> {\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}`);\n return mapDetail(await res.json() as Record<string, unknown>);\n }\n\n /* Cascade-delete all data for an entity. /\n async delete(entityId: string, entityType: EntityType = 'user'): Promise<DeleteEntityResult> {\n const res = await this.request('DELETE', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}`);\n return mapDeleteResult(await res.json() as Record<string, unknown>);\n }\n\n /* Get structured attribute triples for an entity. /\n async attributes(entityId: string, opts: GetAttributesOptions = {}, entityType: EntityType = 'user') {\n const qs = buildAttributesQuery(opts);\n const res = await this.request('GET', `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/attributes${qs}`);\n const body = await res.json() as { attributes: unknown[] };\n return (body.attributes ?? []).map(mapAttribute);\n }\n\n /* Get the mutation history of a single memory record. /\n async memoryHistory(entityId: string, memoryId: string, entityType: EntityType = 'user'): Promise<MemoryHistory> {\n const res = await this.request(\n 'GET',\n `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/memories/${encodeURIComponent(memoryId)}/history`,\n );\n return mapHistory(await res.json() as Record<string, unknown>);\n }\n\n /* Update per-entity extraction guidance and pipeline config. /\n async patchSettings(entityId: string, input: PatchEntitySettingsInput, entityType: EntityType = 'user'): Promise<EntitySettings> {\n const body: Record<string, unknown> = {};\n if (input.extractionPrompt !== undefined) body.extraction_prompt = input.extractionPrompt;\n if (input.memoryKinds !== undefined) body.memory_kinds = input.memoryKinds;\n if (input.decayEnabled !== undefined) body.decay_enabled = input.decayEnabled;\n const res = await this.request(\n 'PATCH',\n `/v1/entities/${entityType}/${encodeURIComponent(entityId)}/settings`,\n { headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) },\n );\n return mapSettings(await res.json() as Record<string, unknown>);\n }\n\n /* Merge a source entity into a target entity. /\n async merge(\n source: { entityId: string; entityType?: EntityType },\n target: { entityId: string; entityType?: EntityType },\n ): Promise<MergeEntitiesResult> {\n const body = {\n source: { entity_type: source.entityType ?? 'user', entity_id: source.entityId },\n target: { entity_type: target.entityType ?? 'user', entity_id: target.entityId },\n };\n const res = await this.request('POST', '/v1/entities/merge', {\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify(body),\n });\n return mapMergeResult(await res.json() as Record<string, unknown>);\n }\n\n private async request(\n method: string,\n path: string,\n init: { headers?: Record<string, string>; body?: BodyInit } = {},\n ): Promise<Response> {\n const url = `${this.apiUrl}${path}`;\n let res: Response;\n try {\n res = await this.fetchImpl(url, {\n method,\n headers: { Authorization: `Bearer ${this.apiKey}`, ...(init.headers ?? {}) },\n body: init.body,\n });\n } catch (cause) {\n throw new Error(\n `EntitiesClient: network error calling ${method} ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,\n );\n }\n if (res.ok) return res;\n const text = await res.text().catch(() => '');\n throw new Error(`EntitiesClient: ${method} ${path} failed with ${res.status}: ${text}`);\n }\n}\n\n// ---------------------------------------------------------------------------\n// Query builders\n// ---------------------------------------------------------------------------\n\nfunction buildEntityListQuery(opts: ListEntitiesOptions): string {\n const p = new URLSearchParams();\n if (opts.entityType) p.set('entity_type', opts.entityType);\n if (opts.page !== undefined) p.set('page', String(opts.page));\n if (opts.pageSize !== undefined) p.set('page_size', String(opts.pageSize));\n return p.toString() ? `?${p.toString()}` : '';\n}\n\nfunction buildAttributesQuery(opts: GetAttributesOptions): string {\n const p = new URLSearchParams();\n if (opts.attribute) p.set('attribute', opts.attribute);\n if (opts.entity) p.set('entity', opts.entity);\n if (opts.limit !== undefined) p.set('limit', String(opts.limit));\n return p.toString() ? `?${p.toString()}` : '';\n}\n\n// ---------------------------------------------------------------------------\n// Wire → SDK type mappers (snake_case → camelCase)\n// ---------------------------------------------------------------------------\n\nfunction mapAttribute(r: unknown) {\n const a = r as Record<string, unknown>;\n return {\n entity: a.entity as string,\n attribute: a.attribute as string,\n value: a.value as string,\n type: a.type as string,\n sourceMemoryId: (a.source_memory_id as string \| null) ?? null,\n observedAt: a.observed_at as string,\n };\n}\n\nfunction mapRelation(r: unknown) {\n const row = r as Record<string, unknown>;\n return {\n targetEntityId: row.target_entity_id as string,\n relationType: row.relation_type as string,\n confidence: row.confidence as number,\n validTo: (row.valid_to as string \| null) ?? null,\n };\n}\n\nfunction mapCard(c: unknown) {\n const card = c as Record<string, unknown>;\n return {\n entityName: card.entity_name as string,\n cardText: card.card_text as string,\n version: card.version as number,\n updatedAt: card.updated_at as string,\n };\n}\n\nfunction mapProfileBody(raw: Record<string, unknown> \| null): import('./types.js').EntityProfile['profile'] {\n if (!raw) return null;\n return {\n summary: raw.summary as string,\n preferences: (raw.preferences as string[]) ?? [],\n instructions: (raw.instructions as string[]) ?? [],\n openCommitments: (raw.open_commitments as string[]) ?? [],\n };\n}\n\nfunction mapProfile(r: Record<string, unknown>): import('./types.js').EntityProfile {\n return {\n entityType: r.entity_type as import('./types.js').EntityType,\n entityId: r.entity_id as string,\n profile: mapProfileBody(r.profile as Record<string, unknown> \| null),\n attributes: ((r.attributes as unknown[]) ?? []).map(mapAttribute),\n memoryCount: r.memory_count as number,\n lastActive: (r.last_active as string \| null) ?? null,\n updatedAt: (r.updated_at as string \| null) ?? null,\n };\n}\n\nfunction mapList(r: Record<string, unknown>): import('./types.js').EntityListResult {\n return {\n entities: ((r.entities as unknown[]) ?? []).map((e) => {\n const entity = e as Record<string, unknown>;\n return {\n entityType: entity.entity_type as import('./types.js').EntityType,\n entityId: entity.entity_id as string,\n memoryCount: entity.memory_count as number,\n lastActive: (entity.last_active as string \| null) ?? null,\n };\n }),\n total: r.total as number,\n page: r.page as number,\n pageSize: r.page_size as number,\n };\n}\n\nfunction mapDetail(r: Record<string, unknown>): import('./types.js').EntityDetail {\n return {\n entityType: r.entity_type as import('./types.js').EntityType,\n entityId: r.entity_id as string,\n memoryCount: r.memory_count as number,\n attributes: ((r.attributes as unknown[]) ?? []).map(mapAttribute),\n relations: ((r.relations as unknown[]) ?? []).map(mapRelation),\n recentCards: ((r.recent_cards as unknown[]) ?? []).map(mapCard),\n updatedAt: (r.updated_at as string \| null) ?? null,\n };\n}\n\nfunction mapDeleteResult(r: Record<string, unknown>): import('./types.js').DeleteEntityResult {\n const d = r.deleted as Record<string, number>;\n return {\n deleted: {\n memories: d.memories,\n entityAttributes: d.entity_attributes,\n profile: d.profile,\n entities: d.entities,\n entityEdges: d.entity_edges,\n entityCards: d.entity_cards,\n },\n };\n}\n\nfunction mapHistory(r: Record<string, unknown>): import('./types.js').MemoryHistory {\n return {\n memoryId: r.memory_id as string,\n history: ((r.history as unknown[]) ?? []).map((h) => {\n const entry = h as Record<string, unknown>;\n return {\n versionId: entry.version_id as string,\n event: entry.event as string,\n content: entry.content as string,\n timestamp: entry.timestamp as string,\n supersededBy: (entry.superseded_by as string \| null) ?? null,\n };\n }),\n };\n}\n\nfunction mapSettings(r: Record<string, unknown>): import('./types.js').EntitySettings {\n return {\n entityId: r.entity_id as string,\n extractionPrompt: (r.extraction_prompt as string \| null) ?? null,\n memoryKinds: (r.memory_kinds as string[] \| null) ?? null,\n decayEnabled: r.decay_enabled as boolean,\n updatedAt: r.updated_at as string,\n };\n}\n\nfunction mapMergeResult(r: Record<string, unknown>): import('./types.js').MergeEntitiesResult {\n const m = r.merged as Record<string, number>;\n return {\n merged: {\n memoriesMoved: m.memories_moved,\n attributesMoved: m.attributes_moved,\n cardsMoved: m.cards_moved,\n },\n targetEntityId: r.target_entity_id as string,\n };\n}\n","/\n @file `AtomicMemoryClient` — primary public surface for the SDK.\n \n Aggregates `memory` (the memory-layer API) and `storage` (the\n * direct-storage API) under one client so callers see a coherent\n * single entry point:\n \n import { AtomicMemoryClient } from '@atomicmemory/sdk';\n * const client = new AtomicMemoryClient({\n * apiUrl: 'http://localhost:17350',\n * apiKey: process.env.ATOMICMEMORY_API_KEY!,\n * userId: 'u1',\n * });\n * await client.memory.initialize();\n * const artifact = await client.storage.put({\n * mode: 'pointer',\n * uri: 'https://example.com/file.pdf',\n * contentType: 'application/pdf',\n * });\n \n v1 SDK is server-side only. Browser bundles must proxy through a\n * trusted server, such as an application-owned API boundary.\n \n Applications that only need memory operations can still use\n * `MemoryClient` directly. New integrations should prefer\n * `AtomicMemoryClient.memory`.\n /\n\nimport { MemoryClient, type MemoryClientConfig } from './memory-client';\nimport { ConcreteStorageClient } from '../storage/client';\nimport type { StorageClient } from '../storage/interfaces';\nimport { EntitiesClient } from '../entities/client';\n\n/\n Constructor config for the aggregator. All three transport fields\n * (`apiUrl`, `apiKey`, `userId`) are REQUIRED — they back both the\n * storage namespace and the default AtomicMemory memory provider.\n * Memory-only consumers should still pass `apiUrl` (it doubles as\n * the default memory provider's `apiUrl`); the `memory` block then\n * narrows the registration further if a non-default provider mix is\n * needed.\n \n `userId` is the owner-scope seam the storage routes accept until a\n * real auth seam ships. `fetch` is an optional override; defaults to\n * the Node global.\n /\nexport interface AtomicMemoryClientConfig {\n apiUrl: string;\n apiKey: string;\n userId: string;\n /* Optional fetch override — defaults to the Node global. /\n fetch?: typeof fetch;\n /\n Permit `apiUrl` to target loopback / private / reserved IP literals.\n * Defaults to `true` — the SDK routinely connects to local/self-hosted\n * cores. Set `false` to harden against SSRF; link-local / cloud-metadata\n * addresses are blocked regardless. Forwarded to the default memory\n * provider, storage, and entities sub-clients. See `validateApiUrl`.\n /\n allowPrivateNetworks?: boolean;\n /* Memory-provider registration. Defaults to a single AtomicMemory\n * provider pointing at `apiUrl`. /\n memory?: MemoryClientConfig;\n}\n\n/\n Primary public client. Holds a `memory` namespace (`MemoryClient`)\n * and a `storage` namespace (`StorageClient`).\n /\nexport class AtomicMemoryClient {\n readonly memory: MemoryClient;\n readonly storage: StorageClient;\n readonly entities: EntitiesClient;\n\n constructor(config: AtomicMemoryClientConfig) {\n if (!config.apiUrl) {\n throw new Error('AtomicMemoryClient: apiUrl is required');\n }\n if (!config.apiKey) {\n throw new Error('AtomicMemoryClient: apiKey is required');\n }\n if (!config.userId) {\n throw new Error('AtomicMemoryClient: userId is required');\n }\n // Default provider registration MUST forward the apiKey so the\n // memory namespace shares the storage namespace's auth contract.\n // The earlier shape dropped it silently — memory requests went\n // out unauthenticated even when the caller supplied `apiKey`,\n // failing with 401 against any core deployment that gates `/v1/`\n // (every deployment since the auth middleware landed).\n this.memory = new MemoryClient(\n config.memory ?? {\n providers: {\n atomicmemory: {\n apiUrl: config.apiUrl,\n apiKey: config.apiKey,\n allowPrivateNetworks: config.allowPrivateNetworks,\n },\n },\n },\n );\n this.storage = new ConcreteStorageClient({\n apiUrl: config.apiUrl,\n apiKey: config.apiKey,\n userId: config.userId,\n allowPrivateNetworks: config.allowPrivateNetworks,\n fetch: config.fetch,\n });\n this.entities = new EntitiesClient({\n apiUrl: config.apiUrl,\n apiKey: config.apiKey,\n allowPrivateNetworks: config.allowPrivateNetworks,\n fetch: config.fetch,\n });\n }\n}\n","/*\n @file @atomicmemory/sdk public surface\n \n Backend-agnostic memory-layer SDK. Pluggable providers, local\n * embeddings, storage adapters, semantic search.\n \n @example\n * ```typescript\n * import { MemoryClient } from '@atomicmemory/sdk';\n \n const memory = new MemoryClient({\n * providers: { atomicmemory: { apiUrl: 'http://localhost:17350' } },\n * });\n * await memory.initialize();\n * await memory.ingest({ mode: 'text', content: 'hello', scope: { user: 'u1' } });\n * const results = await memory.search({ query: 'hello', scope: { user: 'u1' } });\n * ```\n /\n\n// Primary client — `AtomicMemoryClient` aggregates the memory and\n// storage namespaces. `MemoryClient` remains available for\n// applications that only need memory operations.\nexport {\n AtomicMemoryClient,\n type AtomicMemoryClientConfig,\n} from './client/atomic-memory-client';\n\nexport { MemoryClient } from './client/memory-client';\nexport type {\n MemoryClientConfig,\n MemoryProviderConfigs,\n ProviderStatus,\n} from './client/memory-client';\n\n// Types\nexport from './types';\n\n// Event system\nexport { EventEmitter, type EventMap } from './core/events';\n\n// Error handling\nexport {\n AtomicMemoryError,\n StorageError,\n EmbeddingError,\n SearchError,\n ConfigurationError,\n NetworkError,\n RetryableOperation,\n withRetry,\n ErrorContext,\n ErrorUtils,\n type RetryPolicy,\n} from './core/error-handling/';\n\n// KV cache used by embeddings and local search. New artifact-storage\n// integrations should use the `./storage` subpath.\nexport { StorageManager } from './kv-cache/storage-manager';\nexport { MemoryStorageAdapter } from './kv-cache/memory-storage';\nexport { IndexedDBStorageAdapter } from './kv-cache/indexeddb-storage';\nexport type { StorageAdapter, StorageStats } from './kv-cache/storage-adapter';\n\n// KV cache validation\nexport {\n StorageValidator,\n validateKey,\n validateValue,\n validateKeyValue,\n assertValidKey,\n assertValidValue,\n assertValidKeyValue,\n DEFAULT_VALIDATION_CONFIG,\n} from './kv-cache/validation';\nexport type { ValidationConfig, ValidationResult } from './kv-cache/validation';\n\n// Storage API for the public `client.storage` namespace.\nexport * from './storage';\n\n// Entity API for the public `client.entities` namespace.\nexport * from './entities';\n\n// Logging\nexport {\n Logger,\n getLogger,\n configureLogging,\n setLogLevel,\n logger,\n} from './utils/logger';\nexport type {\n LogLevel,\n LogContext,\n LogEntry,\n LoggerConfig,\n} from './utils/logger';\n\n// Debug logging\nexport {\n setDebugHandler,\n setDebugEnabled,\n isDebugEnabled,\n debugLog,\n debugInfo,\n debugWarn,\n debugError,\n} from './utils/debug-logger';\nexport type { DebugLogEntry, DebugLogHandler } from './utils/debug-logger';\n\n// Embedding\nexport { EmbeddingGenerator } from './embedding/embedding-generator';\nexport { TransformersAdapter } from './embedding/transformers-adapter';\nexport { WasmSemanticProcessor } from './embedding/wasm-semantic-processor';\nexport { testWebAssemblySupport } from './embedding/wasm-semantic-processor';\n\n// Search\nexport { SemanticSearch } from './search/semantic-search';\nexport { cosineSimilarity } from './search/similarity-calculator';\nexport type {\n SemanticSearchResult,\n SearchOptions,\n StoredContext,\n} from './search/semantic-search/types';\n\n// Utilities\nexport { PerformanceMonitor } from './utils/performance';\nexport { DebugTools } from './utils/debugging';\nexport * from './utils/validation';\nexport {\n getEnvironment,\n isTestEnvironment,\n isDevelopmentEnvironment,\n isExtensionEnvironment,\n} from './utils/environment';\n\n// Runtime configuration — singleton consumed by application wrappers\n// that need to initialize environment settings at SDK startup.\nexport { RuntimeConfig, runtimeConfig } from './core/runtime-config';\n\n// Memory system — types, provider interface, concrete adapters.\n// `MemoryService` is intentionally not re-exported from root; consumers\n// use `MemoryClient` (above) as the canonical API.\nexport * from './memory/types';\nexport * from './memory/errors';\nexport * from './memory/provider';\nexport * from './memory/capability-profiles';\nexport * from './memory/pipeline';\nexport * from './memory/registration';\nexport * from './memory/atomicmemory-provider';\nexport * from './memory/mem0-provider';\nexport * from './memory/hindsight-provider';\n\n// Version information\nexport const SDK_VERSION = '1.0.0';\nexport const API_VERSION = '1.0';\n"]}

+25

-24

dist/memory.cjs

		'use strict';

		var chunkR56Z5WG5_cjs = require('./chunk-R56Z5WG5.cjs');
		var chunkNULA3B6E_cjs = require('./chunk-NULA3B6E.cjs');
		var chunkWSP2HCUV_cjs = require('./chunk-WSP2HCUV.cjs');
		require('./chunk-MIG2OG5Z.cjs');

		@@ -18,93 +19,93 @@
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.ATOMICMEMORY_DEFAULT_TIMEOUT; }
		get: function () { return chunkWSP2HCUV_cjs.ATOMICMEMORY_DEFAULT_TIMEOUT; }
		});
		Object.defineProperty(exports, "ATOMICMEMORY_EXTENSION_NAMES", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.ATOMICMEMORY_EXTENSION_NAMES; }
		get: function () { return chunkWSP2HCUV_cjs.ATOMICMEMORY_EXTENSION_NAMES; }
		});
		Object.defineProperty(exports, "AtomicMemoryProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.AtomicMemoryProvider; }
		get: function () { return chunkWSP2HCUV_cjs.AtomicMemoryProvider; }
		});
		Object.defineProperty(exports, "BaseMemoryProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.BaseMemoryProvider; }
		get: function () { return chunkWSP2HCUV_cjs.BaseMemoryProvider; }
		});
		Object.defineProperty(exports, "DEFAULT_META_FACT_PATTERNS", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.DEFAULT_META_FACT_PATTERNS; }
		get: function () { return chunkWSP2HCUV_cjs.DEFAULT_META_FACT_PATTERNS; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_API_VERSION", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_API_VERSION; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_API_VERSION; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_MAX_TOKENS", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_MAX_TOKENS; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_MAX_TOKENS; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_PROJECT_ID", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_PROJECT_ID; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_PROJECT_ID; }
		});
		Object.defineProperty(exports, "HINDSIGHT_DEFAULT_TIMEOUT", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_DEFAULT_TIMEOUT; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_DEFAULT_TIMEOUT; }
		});
		Object.defineProperty(exports, "HINDSIGHT_SCOPE_TAGS_MATCH", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HINDSIGHT_SCOPE_TAGS_MATCH; }
		get: function () { return chunkWSP2HCUV_cjs.HINDSIGHT_SCOPE_TAGS_MATCH; }
		});
		Object.defineProperty(exports, "HindsightProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.HindsightProvider; }
		get: function () { return chunkWSP2HCUV_cjs.HindsightProvider; }
		});
		Object.defineProperty(exports, "InvalidScopeError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.InvalidScopeError; }
		get: function () { return chunkWSP2HCUV_cjs.InvalidScopeError; }
		});
		Object.defineProperty(exports, "MEM0_DEFAULT_TIMEOUT", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.MEM0_DEFAULT_TIMEOUT; }
		get: function () { return chunkWSP2HCUV_cjs.MEM0_DEFAULT_TIMEOUT; }
		});
		Object.defineProperty(exports, "Mem0ContextProvider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.Mem0ContextProvider; }
		get: function () { return chunkWSP2HCUV_cjs.Mem0ContextProvider; }
		});
		Object.defineProperty(exports, "Mem0Provider", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.Mem0Provider; }
		get: function () { return chunkWSP2HCUV_cjs.Mem0Provider; }
		});
		Object.defineProperty(exports, "MemoryProviderError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.MemoryProviderError; }
		get: function () { return chunkWSP2HCUV_cjs.MemoryProviderError; }
		});
		Object.defineProperty(exports, "MemoryTransportError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.MemoryTransportError; }
		get: function () { return chunkWSP2HCUV_cjs.MemoryTransportError; }
		});
		Object.defineProperty(exports, "RateLimitError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.RateLimitError; }
		get: function () { return chunkWSP2HCUV_cjs.RateLimitError; }
		});
		Object.defineProperty(exports, "UnsupportedOperationError", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.UnsupportedOperationError; }
		get: function () { return chunkWSP2HCUV_cjs.UnsupportedOperationError; }
		});
		Object.defineProperty(exports, "filterMetaFacts", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.filterMetaFacts; }
		get: function () { return chunkWSP2HCUV_cjs.filterMetaFacts; }
		});
		Object.defineProperty(exports, "isMetaFact", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.isMetaFact; }
		get: function () { return chunkWSP2HCUV_cjs.isMetaFact; }
		});
		Object.defineProperty(exports, "noopMemoryPipeline", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.noopMemoryPipeline; }
		get: function () { return chunkWSP2HCUV_cjs.noopMemoryPipeline; }
		});
		Object.defineProperty(exports, "resolveMetaFactPatterns", {
		enumerable: true,
		get: function () { return chunkNULA3B6E_cjs.resolveMetaFactPatterns; }
		get: function () { return chunkWSP2HCUV_cjs.resolveMetaFactPatterns; }
		});
		//# sourceMappingURL=memory.cjs.map
		//# sourceMappingURL=memory.cjs.map

+2

-2

dist/memory.d.cts

		@@ -1,3 +0,3 @@
		import { ap as IngestInput, F as Capabilities } from './hindsight-provider-CbfXnvx7.cjs';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, i as AtomicMemoryHandle, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, s as AtomicMemoryProviderConfig, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, Q as ContextPackage, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, U as DEFAULT_META_FACT_PATTERNS, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ah as HindsightProviderConfig, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, aq as IngestResult, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, az as ListRequest, aA as ListResultPage, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aF as Mem0ProviderConfig, aG as Memory, aH as MemoryKind, aI as MemoryProcessingPipeline, aJ as MemoryProvider, aK as MemoryProviderEntry, aL as MemoryProviderError, aM as MemoryProviderRegistration, aN as MemoryRef, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aT as MetaFactFilterConfig, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aX as PackageRequest, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, b9 as SearchRequest, ba as SearchResult, bb as SearchResultPage, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bk as filterMetaFacts, bl as isMetaFact, bm as noopMemoryPipeline, bn as resolveMetaFactPatterns } from './hindsight-provider-CbfXnvx7.cjs';
		import { ap as IngestInput, F as Capabilities } from './hindsight-provider-2_IU9rqm.cjs';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, i as AtomicMemoryHandle, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, s as AtomicMemoryProviderConfig, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, Q as ContextPackage, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, U as DEFAULT_META_FACT_PATTERNS, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ah as HindsightProviderConfig, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, aq as IngestResult, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, az as ListRequest, aA as ListResultPage, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aF as Mem0ProviderConfig, aG as Memory, aH as MemoryKind, aI as MemoryProcessingPipeline, aJ as MemoryProvider, aK as MemoryProviderEntry, aL as MemoryProviderError, aM as MemoryProviderRegistration, aN as MemoryRef, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aT as MetaFactFilterConfig, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aX as PackageRequest, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, b9 as SearchRequest, ba as SearchResult, bb as SearchResultPage, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bk as filterMetaFacts, bl as isMetaFact, bm as noopMemoryPipeline, bn as resolveMetaFactPatterns } from './hindsight-provider-2_IU9rqm.cjs';

		@@ -4,0 +4,0 @@ /**

+2

-2

dist/memory.d.ts

		@@ -1,3 +0,3 @@
		import { ap as IngestInput, F as Capabilities } from './hindsight-provider-CbfXnvx7.js';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, i as AtomicMemoryHandle, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, s as AtomicMemoryProviderConfig, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, Q as ContextPackage, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, U as DEFAULT_META_FACT_PATTERNS, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ah as HindsightProviderConfig, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, aq as IngestResult, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, az as ListRequest, aA as ListResultPage, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aF as Mem0ProviderConfig, aG as Memory, aH as MemoryKind, aI as MemoryProcessingPipeline, aJ as MemoryProvider, aK as MemoryProviderEntry, aL as MemoryProviderError, aM as MemoryProviderRegistration, aN as MemoryRef, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aT as MetaFactFilterConfig, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aX as PackageRequest, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, b9 as SearchRequest, ba as SearchResult, bb as SearchResultPage, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bk as filterMetaFacts, bl as isMetaFact, bm as noopMemoryPipeline, bn as resolveMetaFactPatterns } from './hindsight-provider-CbfXnvx7.js';
		import { ap as IngestInput, F as Capabilities } from './hindsight-provider-2_IU9rqm.js';
		export { A as ATOMICMEMORY_DEFAULT_TIMEOUT, a as ATOMICMEMORY_EXTENSION_NAMES, b as AddContextResult, c as AgentConflict, d as AgentScope, e as AtomicMemoryAgents, f as AtomicMemoryAudit, g as AtomicMemoryConfig, h as AtomicMemoryExtensionName, i as AtomicMemoryHandle, j as AtomicMemoryHealthStatus, k as AtomicMemoryIngestInput, l as AtomicMemoryIngestResult, m as AtomicMemoryLessons, n as AtomicMemoryLifecycle, o as AtomicMemoryListOptions, p as AtomicMemoryListResultPage, q as AtomicMemoryMemory, r as AtomicMemoryProvider, s as AtomicMemoryProviderConfig, t as AtomicMemorySearchRequest, u as AtomicMemorySearchResult, v as AtomicMemorySearchResultPage, w as AuditTrailEntry, x as AuditTrailResult, y as AutoResolveConflictsResult, B as BaseMemoryProvider, z as BatchOps, C as CapCheckResult, D as CapRecommendation, E as CapStatus, G as ConfigUpdateResult, H as ConfigUpdates, I as ConflictResolution, J as ConflictStatus, K as ConflictsListResult, L as ConsolidationExecutionResult, M as ConsolidationResult, N as ConsolidationScanResult, O as ContentClass, P as ContextMetadata, Q as ContextPackage, R as ContextRecord, S as ContextSearchOptions, T as ContextSearchResult, U as DEFAULT_META_FACT_PATTERNS, V as DecayResult, W as DocumentMetadata, X as EmbeddingProviderName, Y as FieldFilter, Z as FilterExpr, _ as Forgetter, $ as GetTrustResult, a0 as GraphEdge, a1 as GraphNode, a2 as GraphResult, a3 as GraphSearch, a4 as GraphSearchRequest, a5 as HINDSIGHT_DEFAULT_API_VERSION, a6 as HINDSIGHT_DEFAULT_MAX_TOKENS, a7 as HINDSIGHT_DEFAULT_PROJECT_ID, a8 as HINDSIGHT_DEFAULT_TIMEOUT, a9 as HINDSIGHT_SCOPE_TAGS_MATCH, aa as Health, ab as HealthConfig, ac as HealthStatus, ad as HindsightOperation, ae as HindsightOperationsHandle, af as HindsightOperationsPage, ag as HindsightProvider, ah as HindsightProviderConfig, ai as HindsightRecallBudget, aj as HindsightRetainHandle, ak as HindsightRetainItem, al as HindsightRetainRequest, am as HindsightRetainResponse, an as HindsightTagsMatch, ao as IngestBase, aq as IngestResult, ar as Insight, as as InvalidScopeError, at as LLMProviderName, au as Lesson, av as LessonSeverity, aw as LessonStats, ax as LessonType, ay as LessonsListResult, az as ListRequest, aA as ListResultPage, aB as MEM0_DEFAULT_TIMEOUT, aC as Mem0ContextProvider, aD as Mem0ContextProviderConfig, aE as Mem0Provider, aF as Mem0ProviderConfig, aG as Memory, aH as MemoryKind, aI as MemoryProcessingPipeline, aJ as MemoryProvider, aK as MemoryProviderEntry, aL as MemoryProviderError, aM as MemoryProviderRegistration, aN as MemoryRef, aO as MemoryScope, aP as MemoryTransportError, aQ as MemoryVersion, aR as Message, aS as MessageIngest, aT as MetaFactFilterConfig, aU as MutationRecord, aV as MutationSummary, aW as MutationType, aX as PackageRequest, aY as Packager, aZ as Profile, a_ as Profiler, a$ as Provenance, b0 as RateLimitError, b1 as RecentMutationsResult, b2 as ReconcileStatus, b3 as ReconciliationResult, b4 as Reflector, b5 as ResetSourceResult, b6 as ResolveConflictResult, b7 as RetrievalReceipt, b8 as Scope, b9 as SearchRequest, ba as SearchResult, bb as SearchResultPage, bc as SetTrustResult, bd as StatsResult, be as TemporalSearch, bf as TextIngest, bg as UnsupportedOperationError, bh as Updater, bi as VerbatimIngest, bj as Versioner, bk as filterMetaFacts, bl as isMetaFact, bm as noopMemoryPipeline, bn as resolveMetaFactPatterns } from './hindsight-provider-2_IU9rqm.js';

		@@ -4,0 +4,0 @@ /**

+2

-1

dist/memory.js

		export { capabilityGaps, satisfiesProfile } from './chunk-4CP57UR3.js';
		export { ATOMICMEMORY_DEFAULT_TIMEOUT, ATOMICMEMORY_EXTENSION_NAMES, AtomicMemoryProvider, BaseMemoryProvider, DEFAULT_META_FACT_PATTERNS, HINDSIGHT_DEFAULT_API_VERSION, HINDSIGHT_DEFAULT_MAX_TOKENS, HINDSIGHT_DEFAULT_PROJECT_ID, HINDSIGHT_DEFAULT_TIMEOUT, HINDSIGHT_SCOPE_TAGS_MATCH, HindsightProvider, InvalidScopeError, MEM0_DEFAULT_TIMEOUT, Mem0ContextProvider, Mem0Provider, MemoryProviderError, MemoryTransportError, RateLimitError, UnsupportedOperationError, filterMetaFacts, isMetaFact, noopMemoryPipeline, resolveMetaFactPatterns } from './chunk-T7PRWXW6.js';
		export { ATOMICMEMORY_DEFAULT_TIMEOUT, ATOMICMEMORY_EXTENSION_NAMES, AtomicMemoryProvider, BaseMemoryProvider, DEFAULT_META_FACT_PATTERNS, HINDSIGHT_DEFAULT_API_VERSION, HINDSIGHT_DEFAULT_MAX_TOKENS, HINDSIGHT_DEFAULT_PROJECT_ID, HINDSIGHT_DEFAULT_TIMEOUT, HINDSIGHT_SCOPE_TAGS_MATCH, HindsightProvider, InvalidScopeError, MEM0_DEFAULT_TIMEOUT, Mem0ContextProvider, Mem0Provider, MemoryProviderError, MemoryTransportError, RateLimitError, UnsupportedOperationError, filterMetaFacts, isMetaFact, noopMemoryPipeline, resolveMetaFactPatterns } from './chunk-KI5UNWJI.js';
		import './chunk-3HWUP4VL.js';
		//# sourceMappingURL=memory.js.map
		//# sourceMappingURL=memory.js.map

+9

-8

dist/storage.cjs

		'use strict';

		var chunkDIZ6Y5IO_cjs = require('./chunk-DIZ6Y5IO.cjs');
		var chunkLPC54QOU_cjs = require('./chunk-LPC54QOU.cjs');
		require('./chunk-MIG2OG5Z.cjs');

		@@ -9,29 +10,29 @@
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.ArtifactInUseError; }
		get: function () { return chunkLPC54QOU_cjs.ArtifactInUseError; }
		});
		Object.defineProperty(exports, "ArtifactNotFoundError", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.ArtifactNotFoundError; }
		get: function () { return chunkLPC54QOU_cjs.ArtifactNotFoundError; }
		});
		Object.defineProperty(exports, "ConcreteStorageClient", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.ConcreteStorageClient; }
		get: function () { return chunkLPC54QOU_cjs.ConcreteStorageClient; }
		});
		Object.defineProperty(exports, "FilecoinDirectStorageNotSupportedError", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.FilecoinDirectStorageNotSupportedError; }
		get: function () { return chunkLPC54QOU_cjs.FilecoinDirectStorageNotSupportedError; }
		});
		Object.defineProperty(exports, "PointerContentNotManagedError", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.PointerContentNotManagedError; }
		get: function () { return chunkLPC54QOU_cjs.PointerContentNotManagedError; }
		});
		Object.defineProperty(exports, "StorageClientError", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.StorageClientError; }
		get: function () { return chunkLPC54QOU_cjs.StorageClientError; }
		});
		Object.defineProperty(exports, "UnsupportedCapabilityError", {
		enumerable: true,
		get: function () { return chunkDIZ6Y5IO_cjs.UnsupportedCapabilityError; }
		get: function () { return chunkLPC54QOU_cjs.UnsupportedCapabilityError; }
		});
		//# sourceMappingURL=storage.cjs.map
		//# sourceMappingURL=storage.cjs.map

+6

-0

dist/storage.d.cts

		@@ -393,2 +393,8 @@ /**
		apiKey: string;
		/**
		* Permit `apiUrl` to target loopback / private / reserved IP literals.
		* Defaults to `true`; set `false` to harden against SSRF. Link-local /
		* cloud-metadata addresses are blocked regardless. See `validateApiUrl`.
		*/
		allowPrivateNetworks?: boolean;
		/** Optional fetch override — defaults to the Node global. */
		@@ -395,0 +401,0 @@ fetch?: typeof fetch;

+6

-0

dist/storage.d.ts

		@@ -393,2 +393,8 @@ /**
		apiKey: string;
		/**
		* Permit `apiUrl` to target loopback / private / reserved IP literals.
		* Defaults to `true`; set `false` to harden against SSRF. Link-local /
		* cloud-metadata addresses are blocked regardless. See `validateApiUrl`.
		*/
		allowPrivateNetworks?: boolean;
		/** Optional fetch override — defaults to the Node global. */
		@@ -395,0 +401,0 @@ fetch?: typeof fetch;

+2

-1

dist/storage.js

		@@ -1,3 +0,4 @@
		export { ArtifactInUseError, ArtifactNotFoundError, ConcreteStorageClient, FilecoinDirectStorageNotSupportedError, PointerContentNotManagedError, StorageClientError, UnsupportedCapabilityError } from './chunk-OFIOAOM3.js';
		export { ArtifactInUseError, ArtifactNotFoundError, ConcreteStorageClient, FilecoinDirectStorageNotSupportedError, PointerContentNotManagedError, StorageClientError, UnsupportedCapabilityError } from './chunk-LCCTVUJO.js';
		import './chunk-3HWUP4VL.js';
		//# sourceMappingURL=storage.js.map
		//# sourceMappingURL=storage.js.map

+1

-1

package.json

		{
		"name": "@atomicmemory/sdk",
		"version": "1.1.0",
		"version": "1.1.1",
		"type": "module",
		@@ -5,0 +5,0 @@ "engines": {

-446

dist/chunk-DIZ6Y5IO.cjs

		'use strict';

		// src/storage/errors.ts
		var StorageClientError = class extends Error {
		errorCode;
		status;
		bodyText;
		constructor(args) {
		super(args.message);
		this.name = "StorageClientError";
		this.errorCode = args.errorCode;
		this.status = args.status;
		this.bodyText = args.bodyText;
		}
		};
		var UnsupportedCapabilityError = class extends StorageClientError {
		capability;
		constructor(args) {
		super({
		message: args.message,
		errorCode: "unsupported_capability",
		status: 400,
		bodyText: args.bodyText
		});
		this.name = "UnsupportedCapabilityError";
		this.capability = args.capability;
		}
		};
		var ArtifactNotFoundError = class extends StorageClientError {
		artifactId;
		constructor(args) {
		super({
		message: `Storage artifact ${args.artifactId} not found`,
		errorCode: "artifact_not_found",
		status: 404,
		bodyText: args.bodyText
		});
		this.name = "ArtifactNotFoundError";
		this.artifactId = args.artifactId;
		}
		};
		var ArtifactInUseError = class extends StorageClientError {
		artifactId;
		referencedByDocumentCount;
		constructor(args) {
		super({
		message: `Storage artifact ${args.artifactId} is referenced by ${args.referencedByDocumentCount} document(s); pass 'policy: "with_documents"' to cascade`,
		errorCode: "artifact_in_use",
		status: 409,
		bodyText: args.bodyText
		});
		this.name = "ArtifactInUseError";
		this.artifactId = args.artifactId;
		this.referencedByDocumentCount = args.referencedByDocumentCount;
		}
		};
		var PointerContentNotManagedError = class extends StorageClientError {
		artifactId;
		uri;
		constructor(args) {
		super({
		message: `Artifact ${args.artifactId} is pointer-mode; fetch the URI directly (the server does not proxy pointer content)`,
		errorCode: "pointer_content_not_managed",
		status: 409,
		bodyText: args.bodyText
		});
		this.name = "PointerContentNotManagedError";
		this.artifactId = args.artifactId;
		this.uri = args.uri;
		}
		};
		var FilecoinDirectStorageNotSupportedError = class extends StorageClientError {
		constructor(args) {
		super({
		message: "Direct Filecoin artifact uploads are not supported in this version. Use document ingestion or pointer mode.",
		errorCode: "filecoin_direct_storage_not_yet_supported",
		status: 501,
		bodyText: args.bodyText
		});
		this.name = "FilecoinDirectStorageNotSupportedError";
		}
		};

		// src/storage/client.ts
		var METADATA_HEADER = "X-AtomicMemory-Metadata";
		var ConcreteStorageClient = class {
		apiUrl;
		apiKey;
		userId;
		fetchImpl;
		constructor(config) {
		if (!config.apiUrl) throw new Error("StorageClient: apiUrl is required");
		if (!config.apiKey) throw new Error("StorageClient: apiKey is required");
		if (!config.userId) throw new Error("StorageClient: userId is required");
		this.apiUrl = config.apiUrl.replace(/\/+$/, "");
		this.apiKey = config.apiKey;
		this.userId = config.userId;
		this.fetchImpl = config.fetch ?? fetch;
		}
		async capabilities() {
		const res = await this.request("GET", "/v1/storage/capabilities");
		return await res.json();
		}
		async put(input) {
		if (input.mode === "pointer") return this.putPointer(input);
		return this.putManaged(input);
		}
		async get(ref) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("GET", `/v1/storage/artifacts/${id}`, {}, id);
		return mapStoredArtifact(await res.json());
		}
		async getContent(ref) {
		const id = this.requireArtifactId(ref);
		return this.request("GET", `/v1/storage/artifacts/${id}/content`, {}, id);
		}
		async head(ref) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("HEAD", `/v1/storage/artifacts/${id}`, {}, id);
		return mapHeadHeaders(res.headers, id);
		}
		async delete(ref, options) {
		const id = this.requireArtifactId(ref);
		const query = options?.policy ? `?policy=${encodeURIComponent(options.policy)}` : "";
		const res = await this.request("DELETE", `/v1/storage/artifacts/${id}${query}`, {}, id);
		return mapDeleteResult(await res.json());
		}
		async verify(ref, _options) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("POST", `/v1/storage/artifacts/${id}/verify`, {}, id);
		return mapVerifyResult(await res.json());
		}
		async putPointer(input) {
		const body = {
		mode: "pointer",
		uri: input.uri,
		content_type: input.contentType,
		...input.sizeBytes !== void 0 ? { size_bytes: input.sizeBytes } : {},
		...input.contentHash !== void 0 ? { content_hash: input.contentHash } : {},
		...input.metadata !== void 0 ? { metadata: input.metadata } : {}
		};
		const res = await this.request("POST", "/v1/storage/artifacts", {
		headers: { "Content-Type": "application/json" },
		body: JSON.stringify(body)
		});
		return mapStoredArtifact(await res.json());
		}
		async putManaged(input) {
		const view = coerceManagedBody(input.body);
		const params = new URLSearchParams({ mode: "managed" });
		if (input.discloseContentHash === true) params.set("disclose_content_hash", "true");
		const headers = {
		"Content-Type": input.contentType,
		"Content-Length": String(view.byteLength)
		};
		if (input.metadata !== void 0) {
		headers[METADATA_HEADER] = encodeMetadataHeader(input.metadata);
		}
		const res = await this.request(
		"POST",
		`/v1/storage/artifacts?${params.toString()}`,
		// Cast: Node's fetch accepts Uint8Array as BodyInit, but the
		// shared lib.dom type predates that. Sending the view directly
		// is intentional — see the comment above coerceManagedBody.
		{ headers, body: view }
		);
		return mapStoredArtifact(await res.json());
		}
		/**
		* Send a request to the storage API and map non-2xx responses to
		* typed errors. Callers receive the raw `Response` on success and
		* read the body themselves so streaming reads (e.g. getContent)
		* can stay zero-copy.
		*
		* Auth contract: owner identity travels on the
		* `X-AtomicMemory-User-Id` request header alongside the
		* deployment-wide `Authorization: Bearer <apiKey>`. The legacy
		* `?user_id=` URL parameter is NEVER serialized — the server's
		* auth middleware rejects it with 400 `legacy_user_id_unsupported`.
		*
		* Transport-level fetch failures (DNS, ECONNREFUSED, AbortError,
		* a misconfigured fetch impl that throws synchronously) are
		* wrapped as `StorageClientError({errorCode:'network_error',
		* status:0})` so callers can branch on a stable error contract
		* instead of catching arbitrary `TypeError`s.
		*
		* `artifactId`, when supplied, threads into the error mapper so
		* `ArtifactNotFoundError` / `ArtifactInUseError` /
		* `PointerContentNotManagedError` carry the id the caller already
		* knows. The capabilities route omits it (no artifact context).
		*/
		async request(method, path, init = {}, artifactId) {
		const url = `${this.apiUrl}${path}`;
		let res;
		try {
		res = await this.fetchImpl(url, {
		method,
		headers: {
		Authorization: `Bearer ${this.apiKey}`,
		"X-AtomicMemory-User-Id": this.userId,
		...init.headers ?? {}
		},
		body: init.body
		});
		} catch (cause) {
		throw new StorageClientError({
		message: `Network error while calling ${method} ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,
		errorCode: "network_error",
		status: 0,
		bodyText: ""
		});
		}
		if (res.ok) return res;
		await throwForResponse(res, artifactId);
		throw new StorageClientError({
		message: `unexpected non-ok response (${res.status})`,
		errorCode: "unexpected_response",
		status: res.status,
		bodyText: ""
		});
		}
		requireArtifactId(ref) {
		if (!ref.artifactId) {
		throw new StorageClientError({
		message: "ArtifactRef.artifactId is required for this operation in v1",
		errorCode: "missing_artifact_id",
		status: 0,
		bodyText: ""
		});
		}
		return ref.artifactId;
		}
		};
		var STORAGE_MODES = ["pointer", "managed"];
		var STORAGE_STATUSES = [
		"stored",
		"pending",
		"available",
		"unavailable",
		"deleting",
		"deleted",
		"delete_failed",
		"failed"
		];
		var CONTENT_ENCODINGS = ["identity", "aes_gcm"];
		function parseSize(value) {
		if (value === null) return null;
		const n = Number(value);
		if (!Number.isFinite(n) \|\| n < 0) return null;
		return n;
		}
		function mapHeadHeaders(headers, fallbackId) {
		const modeRaw = headers.get("x-atomicmemory-storage-mode");
		const statusRaw = headers.get("x-atomicmemory-storage-status");
		if (modeRaw === null \|\| !STORAGE_MODES.includes(modeRaw)) {
		throw new StorageClientError({
		message: `head(): server returned an unrecognized x-atomicmemory-storage-mode value ('${modeRaw ?? "<missing>"}'). Expected one of: ${STORAGE_MODES.join(", ")}.`,
		errorCode: "invalid_head_response",
		status: 200,
		bodyText: ""
		});
		}
		if (statusRaw === null \|\| !STORAGE_STATUSES.includes(statusRaw)) {
		throw new StorageClientError({
		message: `head(): server returned an unrecognized x-atomicmemory-storage-status value ('${statusRaw ?? "<missing>"}'). Expected one of: ${STORAGE_STATUSES.join(", ")}.`,
		errorCode: "invalid_head_response",
		status: 200,
		bodyText: ""
		});
		}
		return {
		artifactId: headers.get("x-atomicmemory-artifact-id") ?? fallbackId,
		provider: headers.get("x-atomicmemory-provider") ?? "",
		mode: modeRaw,
		status: statusRaw,
		sizeBytes: parseSize(headers.get("content-length")),
		contentType: headers.get("content-type")
		};
		}
		function coerceManagedBody(body) {
		if (Buffer.isBuffer(body)) {
		return new Uint8Array(body.buffer, body.byteOffset, body.byteLength);
		}
		if (body instanceof Uint8Array) return body;
		if (body instanceof ArrayBuffer) return new Uint8Array(body);
		if (typeof Blob !== "undefined" && body instanceof Blob) {
		throw new StorageClientError({
		message: "StorageClient.put: Blob input must be converted to Buffer / Uint8Array / ArrayBuffer before calling put(). Use `new Uint8Array(await blob.arrayBuffer())`.",
		errorCode: "unsupported_body_type",
		status: 0,
		bodyText: ""
		});
		}
		throw new StorageClientError({
		message: "StorageClient.put: only Buffer / Uint8Array / ArrayBuffer are accepted in v1. Streaming body uploads land in the Streaming + Resumable Uploads PR.",
		errorCode: "streaming_body_not_supported",
		status: 0,
		bodyText: ""
		});
		}
		function encodeMetadataHeader(metadata) {
		return Buffer.from(JSON.stringify(metadata), "utf8").toString("base64");
		}
		function mapStoredArtifact(raw) {
		const artifactId = requireWireString(raw, "artifact_id");
		const provider = requireWireString(raw, "provider");
		const mode = requireWireEnum(raw, "mode", STORAGE_MODES);
		const status = requireWireEnum(raw, "status", STORAGE_STATUSES);
		const contentEncoding = requireWireEnum(
		raw,
		"content_encoding",
		CONTENT_ENCODINGS
		);
		const createdAt = requireWireString(raw, "created_at");
		const updatedAt = requireWireString(raw, "updated_at");
		const out = {
		artifactId,
		provider,
		mode,
		uri: typeof raw.uri === "string" ? raw.uri : null,
		status,
		sizeBytes: typeof raw.size_bytes === "number" ? raw.size_bytes : null,
		contentType: typeof raw.content_type === "string" ? raw.content_type : null,
		contentEncoding,
		identifiers: raw.identifiers ?? {},
		lifecycle: raw.lifecycle ?? {},
		metadata: raw.metadata ?? {},
		createdAt,
		updatedAt
		};
		if (typeof raw.content_hash === "string") out.contentHash = raw.content_hash;
		if (raw.provider_details && typeof raw.provider_details === "object") {
		out.providerDetails = raw.provider_details;
		}
		if (raw.replication && typeof raw.replication === "object") {
		out.replication = raw.replication;
		}
		if (raw.verification && typeof raw.verification === "object") {
		out.verification = raw.verification;
		}
		if (raw.retrieval && typeof raw.retrieval === "object") {
		out.retrieval = raw.retrieval;
		}
		return out;
		}
		function requireWireString(raw, field) {
		const value = raw[field];
		if (typeof value !== "string" \|\| value.length === 0) {
		throw new StorageClientError({
		message: `mapStoredArtifact: server response is missing required \`${field}\` (or it is not a non-empty string). The storage API contract requires it.`,
		errorCode: "invalid_storage_response",
		status: 200,
		bodyText: ""
		});
		}
		return value;
		}
		function requireWireEnum(raw, field, allowed) {
		const value = raw[field];
		if (typeof value !== "string" \|\| !allowed.includes(value)) {
		throw new StorageClientError({
		message: `mapStoredArtifact: server response field \`${field}\` is not in the SDK's closed enum. Got '${String(value ?? "<missing>")}', expected one of: ${allowed.join(", ")}.`,
		errorCode: "invalid_storage_response",
		status: 200,
		bodyText: ""
		});
		}
		return value;
		}
		function mapDeleteResult(raw) {
		const artifactId = requireWireString(raw, "artifact_id");
		const status = requireWireEnum(raw, "status", STORAGE_STATUSES);
		const out = { artifactId, status };
		if (Array.isArray(raw.cascaded_document_ids)) {
		out.cascadedDocumentIds = raw.cascaded_document_ids.map(String);
		}
		return out;
		}
		function mapVerifyResult(raw) {
		const kind = raw.kind;
		if (kind === "verified") {
		return { kind: "verified", details: raw.details ?? {} };
		}
		if (kind === "failed") {
		return { kind: "failed", reason: String(raw.reason ?? "unknown failure") };
		}
		return { kind: "unsupported", reason: String(raw.reason ?? "unsupported") };
		}
		async function throwForResponse(res, artifactId) {
		const bodyText = await res.text();
		const envelope = parseEnvelope(bodyText);
		const code = envelope.error_code;
		const message = envelope.error ?? `request failed with status ${res.status}`;
		const id = artifactId ?? "";
		if (code === "artifact_in_use") {
		throw new ArtifactInUseError({
		artifactId: id,
		referencedByDocumentCount: envelope.referenced_by_document_count ?? 0,
		bodyText
		});
		}
		if (code === "pointer_content_not_managed") {
		throw new PointerContentNotManagedError({
		artifactId: id,
		uri: envelope.uri ?? "",
		bodyText
		});
		}
		if (code === "filecoin_direct_storage_not_yet_supported") {
		throw new FilecoinDirectStorageNotSupportedError({ bodyText });
		}
		if (code === "artifact_not_found" \|\| res.status === 404) {
		throw new ArtifactNotFoundError({ artifactId: id, bodyText });
		}
		if (code === "unsupported_capability") {
		throw new UnsupportedCapabilityError({
		capability: "unknown",
		message,
		bodyText
		});
		}
		throw new StorageClientError({
		message,
		errorCode: code ?? `http_${res.status}`,
		status: res.status,
		bodyText
		});
		}
		function parseEnvelope(bodyText) {
		if (bodyText.length === 0) return {};
		try {
		return JSON.parse(bodyText);
		} catch {
		return {};
		}
		}

		exports.ArtifactInUseError = ArtifactInUseError;
		exports.ArtifactNotFoundError = ArtifactNotFoundError;
		exports.ConcreteStorageClient = ConcreteStorageClient;
		exports.FilecoinDirectStorageNotSupportedError = FilecoinDirectStorageNotSupportedError;
		exports.PointerContentNotManagedError = PointerContentNotManagedError;
		exports.StorageClientError = StorageClientError;
		exports.UnsupportedCapabilityError = UnsupportedCapabilityError;
		//# sourceMappingURL=chunk-DIZ6Y5IO.cjs.map
		//# sourceMappingURL=chunk-DIZ6Y5IO.cjs.map

-1

dist/chunk-DIZ6Y5IO.cjs.map

-339

dist/chunk-KIUVJBBH.cjs

		'use strict';

		var chunkNULA3B6E_cjs = require('./chunk-NULA3B6E.cjs');

		// src/memory/providers/registry.ts
		var defaultRegistry = {
		atomicmemory: (config) => ({
		provider: new chunkNULA3B6E_cjs.AtomicMemoryProvider(config)
		}),
		mem0: (config) => ({
		provider: new chunkNULA3B6E_cjs.Mem0Provider(config)
		}),
		hindsight: (config) => ({
		provider: new chunkNULA3B6E_cjs.HindsightProvider(config)
		})
		};

		// src/memory/memory-service.ts
		var MemoryService = class {
		constructor(config) {
		this.config = config;
		this.defaultProviderName = config.defaultProvider;
		}
		config;
		providers = /* @__PURE__ */ new Map();
		pipelines = /* @__PURE__ */ new Map();
		defaultProviderName;
		async initialize(registry = defaultRegistry) {
		const stagedProviders = /* @__PURE__ */ new Map();
		const stagedPipelines = /* @__PURE__ */ new Map();
		try {
		for (const [name, providerConfig] of Object.entries(
		this.config.providerConfigs
		)) {
		const factory = registry[name];
		if (!factory) continue;
		const registration = await factory(providerConfig);
		stagedProviders.set(name, registration.provider);
		stagedPipelines.set(
		name,
		registration.pipeline ?? chunkNULA3B6E_cjs.noopMemoryPipeline
		);
		if (registration.provider.initialize) {
		await registration.provider.initialize();
		}
		}
		} catch (cause) {
		await Promise.allSettled(
		[...stagedProviders.values()].map((p) => p.close?.())
		);
		throw cause;
		}
		for (const [name, provider] of stagedProviders) this.providers.set(name, provider);
		for (const [name, pipeline] of stagedPipelines) this.pipelines.set(name, pipeline);
		}
		getProvider(name) {
		const providerName = name ?? this.defaultProviderName;
		const provider = this.providers.get(providerName);
		if (!provider) {
		throw new Error(
		`Provider "${providerName}" is not registered`
		);
		}
		return provider;
		}
		getAvailableProviders() {
		return Array.from(this.providers.keys());
		}
		/**
		* Provider names declared in the SDK configuration, regardless of whether
		* they have been initialized yet. Useful for UI and getter paths that
		* need to advertise capabilities before `initialize()` has run.
		*/
		getConfiguredProviders() {
		return Object.keys(this.config.providerConfigs);
		}
		// -----------------------------------------------------------------------
		// Core operations
		// -----------------------------------------------------------------------
		async ingest(input, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		if (pipeline.preprocessIngest) {
		const inputs = await pipeline.preprocessIngest(input);
		const results = [];
		for (const i of inputs) {
		const result2 = await provider.ingest(i);
		if (pipeline.postprocessIngest) {
		await pipeline.postprocessIngest(result2, i);
		}
		results.push(result2);
		}
		return mergeIngestResults(results);
		}
		const result = await provider.ingest(input);
		if (pipeline.postprocessIngest) {
		await pipeline.postprocessIngest(result, input);
		}
		return result;
		}
		async search(request, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const processedRequest = pipeline.preprocessSearch ? await pipeline.preprocessSearch(request) : request;
		const page = await provider.search(processedRequest);
		return pipeline.postprocessSearch ? await pipeline.postprocessSearch(page, processedRequest) : page;
		}
		async get(ref, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const processedRef = pipeline.preprocessGet ? await pipeline.preprocessGet(ref) : ref;
		const memory = await provider.get(processedRef);
		return pipeline.postprocessGet ? await pipeline.postprocessGet(memory, processedRef) : memory;
		}
		async delete(ref, providerName) {
		const provider = this.getProvider(providerName);
		await provider.delete(ref);
		}
		async list(request, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const page = await provider.list(request);
		return pipeline.postprocessList ? await pipeline.postprocessList(page, request) : page;
		}
		async package(request, providerName) {
		const provider = this.getProvider(providerName);
		const packager = provider.getExtension?.("package");
		if (!packager) {
		throw new chunkNULA3B6E_cjs.UnsupportedOperationError(
		provider.name,
		"package"
		);
		}
		return packager.package(request);
		}
		// -----------------------------------------------------------------------
		// Internals
		// -----------------------------------------------------------------------
		getPipeline(name) {
		const providerName = name ?? this.defaultProviderName;
		return this.pipelines.get(providerName) ?? chunkNULA3B6E_cjs.noopMemoryPipeline;
		}
		};
		function mergeIngestResults(results) {
		return {
		created: results.flatMap((r) => r.created),
		updated: results.flatMap((r) => r.updated),
		unchanged: results.flatMap((r) => r.unchanged)
		};
		}

		// src/client/memory-client.ts
		var MemoryClient = class {
		service;
		initialized = false;
		initPromise;
		constructor(config) {
		const providerConfigs = { ...config.providers };
		const defaultProvider = config.defaultProvider ?? pickFirstProviderKey(providerConfigs);
		if (!defaultProvider) {
		throw new Error(
		'MemoryClient requires at least one provider config. Pass e.g. { providers: { atomicmemory: { apiUrl: "..." } } }.'
		);
		}
		this.service = new MemoryService({
		defaultProvider,
		providerConfigs
		});
		}
		/**
		* Initialize all configured providers. Must be called before any memory
		* operation. Idempotent and concurrency-safe: concurrent and subsequent
		* calls share a single initialization run. The `registry` argument of the
		* first call wins; later calls share that run and their argument is ignored.
		* A REJECTED initialization is sticky — retrying on the same instance
		* re-throws the original error (partial provider state from a failed run is
		* never reused); resolve the cause (e.g. install a missing optional peer)
		* and construct a new client.
		*/
		async initialize(registry = defaultRegistry) {
		this.initPromise ??= this.service.initialize(registry).then(() => {
		this.initialized = true;
		});
		return this.initPromise;
		}
		/**
		* Write memory(ies). Input supports `text`, `messages`, or `memory` modes.
		*/
		async ingest(input) {
		this.assertInitialized();
		return this.service.ingest(input);
		}
		/**
		* Ingest without any application-layer gating. Equivalent to `ingest()`
		* on the core client; application wrappers override the gated variant
		* while delegating this path straight through.
		*/
		async ingestDirect(input) {
		this.assertInitialized();
		return this.service.ingest(input);
		}
		/**
		* Search for memories matching the request.
		*/
		async search(request) {
		this.assertInitialized();
		return this.service.search(request);
		}
		/**
		* Search without application-layer gating. See `ingestDirect` for the
		* rationale.
		*/
		async searchDirect(request) {
		this.assertInitialized();
		return this.service.search(request);
		}
		/**
		* Build an injection-ready context package from a scoped request.
		* Provider must implement the `package` extension.
		*/
		async package(request) {
		this.assertInitialized();
		return this.service.package(request);
		}
		/**
		* Package without application-layer gating.
		*/
		async packageDirect(request) {
		this.assertInitialized();
		return this.service.package(request);
		}
		/**
		* Fetch a single memory by reference.
		*/
		async get(ref) {
		this.assertInitialized();
		return this.service.get(ref);
		}
		/**
		* Delete a single memory by reference.
		*/
		async delete(ref) {
		this.assertInitialized();
		return this.service.delete(ref);
		}
		/**
		* List memories within a scope.
		*/
		async list(request) {
		this.assertInitialized();
		return this.service.list(request);
		}
		/**
		* Report the capability surface of the default (or named) provider.
		*
		* @throws if the named provider is unknown or not initialized.
		*/
		capabilities(providerName) {
		this.assertInitialized();
		return this.service.getProvider(providerName).capabilities();
		}
		/**
		* Resolve a named extension on the default (or named) provider.
		* Returns `undefined` when the provider does not advertise the
		* extension.
		*
		* @throws if the named provider is unknown or not initialized.
		*
		* @example
		* ```ts
		* const pkg = memory.getExtension<Packager>('package');
		* ```
		*/
		getExtension(extensionName, providerName) {
		this.assertInitialized();
		const provider = this.service.getProvider(providerName);
		return provider.getExtension?.(extensionName);
		}
		/**
		* Aggregate status of all configured providers. Never throws:
		* uninitialized providers report `initialized: false` and
		* `capabilities: null`.
		*/
		getProviderStatus() {
		const configured = this.service.getConfiguredProviders();
		const available = new Set(this.service.getAvailableProviders());
		return configured.map((name) => {
		if (!available.has(name)) {
		return { name, initialized: false, capabilities: null };
		}
		return {
		name,
		initialized: true,
		capabilities: this.service.getProvider(name).capabilities()
		};
		});
		}
		/**
		* Access the full AtomicMemory namespace handle (lifecycle, audit,
		* lessons, config, agents). Returns `undefined` when the client is
		* not yet initialized, the `atomicmemory` provider was not included
		* in the `providers` config, or that provider does not advertise the
		* namespace handle. This getter intentionally never throws — callers
		* can guard with a truthy check and let the handle's own methods
		* raise if used incorrectly.
		*/
		get atomicmemory() {
		if (!this.initialized) return void 0;
		if (!this.service.getConfiguredProviders().includes("atomicmemory")) {
		return void 0;
		}
		const provider = this.service.getProvider("atomicmemory");
		return provider.getExtension?.("atomicmemory.base");
		}
		/**
		* Low-level escape hatch for callers that need the concrete provider.
		*/
		getProvider(name) {
		this.assertInitialized();
		return this.service.getProvider(name);
		}
		assertInitialized() {
		if (!this.initialized) {
		throw new Error(
		"MemoryClient is not initialized. Call `await client.initialize()` first."
		);
		}
		}
		};
		function pickFirstProviderKey(providers) {
		for (const [key, value] of Object.entries(providers)) {
		if (value !== void 0 && key !== "default") return key;
		}
		return void 0;
		}

		exports.MemoryClient = MemoryClient;
		//# sourceMappingURL=chunk-KIUVJBBH.cjs.map
		//# sourceMappingURL=chunk-KIUVJBBH.cjs.map

-1

dist/chunk-KIUVJBBH.cjs.map

dist/chunk-NULA3B6E.cjs

Sorry, the diff of this file is too big to display

dist/chunk-NULA3B6E.cjs.map

Sorry, the diff of this file is too big to display

-438

dist/chunk-OFIOAOM3.js

		// src/storage/errors.ts
		var StorageClientError = class extends Error {
		errorCode;
		status;
		bodyText;
		constructor(args) {
		super(args.message);
		this.name = "StorageClientError";
		this.errorCode = args.errorCode;
		this.status = args.status;
		this.bodyText = args.bodyText;
		}
		};
		var UnsupportedCapabilityError = class extends StorageClientError {
		capability;
		constructor(args) {
		super({
		message: args.message,
		errorCode: "unsupported_capability",
		status: 400,
		bodyText: args.bodyText
		});
		this.name = "UnsupportedCapabilityError";
		this.capability = args.capability;
		}
		};
		var ArtifactNotFoundError = class extends StorageClientError {
		artifactId;
		constructor(args) {
		super({
		message: `Storage artifact ${args.artifactId} not found`,
		errorCode: "artifact_not_found",
		status: 404,
		bodyText: args.bodyText
		});
		this.name = "ArtifactNotFoundError";
		this.artifactId = args.artifactId;
		}
		};
		var ArtifactInUseError = class extends StorageClientError {
		artifactId;
		referencedByDocumentCount;
		constructor(args) {
		super({
		message: `Storage artifact ${args.artifactId} is referenced by ${args.referencedByDocumentCount} document(s); pass 'policy: "with_documents"' to cascade`,
		errorCode: "artifact_in_use",
		status: 409,
		bodyText: args.bodyText
		});
		this.name = "ArtifactInUseError";
		this.artifactId = args.artifactId;
		this.referencedByDocumentCount = args.referencedByDocumentCount;
		}
		};
		var PointerContentNotManagedError = class extends StorageClientError {
		artifactId;
		uri;
		constructor(args) {
		super({
		message: `Artifact ${args.artifactId} is pointer-mode; fetch the URI directly (the server does not proxy pointer content)`,
		errorCode: "pointer_content_not_managed",
		status: 409,
		bodyText: args.bodyText
		});
		this.name = "PointerContentNotManagedError";
		this.artifactId = args.artifactId;
		this.uri = args.uri;
		}
		};
		var FilecoinDirectStorageNotSupportedError = class extends StorageClientError {
		constructor(args) {
		super({
		message: "Direct Filecoin artifact uploads are not supported in this version. Use document ingestion or pointer mode.",
		errorCode: "filecoin_direct_storage_not_yet_supported",
		status: 501,
		bodyText: args.bodyText
		});
		this.name = "FilecoinDirectStorageNotSupportedError";
		}
		};

		// src/storage/client.ts
		var METADATA_HEADER = "X-AtomicMemory-Metadata";
		var ConcreteStorageClient = class {
		apiUrl;
		apiKey;
		userId;
		fetchImpl;
		constructor(config) {
		if (!config.apiUrl) throw new Error("StorageClient: apiUrl is required");
		if (!config.apiKey) throw new Error("StorageClient: apiKey is required");
		if (!config.userId) throw new Error("StorageClient: userId is required");
		this.apiUrl = config.apiUrl.replace(/\/+$/, "");
		this.apiKey = config.apiKey;
		this.userId = config.userId;
		this.fetchImpl = config.fetch ?? fetch;
		}
		async capabilities() {
		const res = await this.request("GET", "/v1/storage/capabilities");
		return await res.json();
		}
		async put(input) {
		if (input.mode === "pointer") return this.putPointer(input);
		return this.putManaged(input);
		}
		async get(ref) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("GET", `/v1/storage/artifacts/${id}`, {}, id);
		return mapStoredArtifact(await res.json());
		}
		async getContent(ref) {
		const id = this.requireArtifactId(ref);
		return this.request("GET", `/v1/storage/artifacts/${id}/content`, {}, id);
		}
		async head(ref) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("HEAD", `/v1/storage/artifacts/${id}`, {}, id);
		return mapHeadHeaders(res.headers, id);
		}
		async delete(ref, options) {
		const id = this.requireArtifactId(ref);
		const query = options?.policy ? `?policy=${encodeURIComponent(options.policy)}` : "";
		const res = await this.request("DELETE", `/v1/storage/artifacts/${id}${query}`, {}, id);
		return mapDeleteResult(await res.json());
		}
		async verify(ref, _options) {
		const id = this.requireArtifactId(ref);
		const res = await this.request("POST", `/v1/storage/artifacts/${id}/verify`, {}, id);
		return mapVerifyResult(await res.json());
		}
		async putPointer(input) {
		const body = {
		mode: "pointer",
		uri: input.uri,
		content_type: input.contentType,
		...input.sizeBytes !== void 0 ? { size_bytes: input.sizeBytes } : {},
		...input.contentHash !== void 0 ? { content_hash: input.contentHash } : {},
		...input.metadata !== void 0 ? { metadata: input.metadata } : {}
		};
		const res = await this.request("POST", "/v1/storage/artifacts", {
		headers: { "Content-Type": "application/json" },
		body: JSON.stringify(body)
		});
		return mapStoredArtifact(await res.json());
		}
		async putManaged(input) {
		const view = coerceManagedBody(input.body);
		const params = new URLSearchParams({ mode: "managed" });
		if (input.discloseContentHash === true) params.set("disclose_content_hash", "true");
		const headers = {
		"Content-Type": input.contentType,
		"Content-Length": String(view.byteLength)
		};
		if (input.metadata !== void 0) {
		headers[METADATA_HEADER] = encodeMetadataHeader(input.metadata);
		}
		const res = await this.request(
		"POST",
		`/v1/storage/artifacts?${params.toString()}`,
		// Cast: Node's fetch accepts Uint8Array as BodyInit, but the
		// shared lib.dom type predates that. Sending the view directly
		// is intentional — see the comment above coerceManagedBody.
		{ headers, body: view }
		);
		return mapStoredArtifact(await res.json());
		}
		/**
		* Send a request to the storage API and map non-2xx responses to
		* typed errors. Callers receive the raw `Response` on success and
		* read the body themselves so streaming reads (e.g. getContent)
		* can stay zero-copy.
		*
		* Auth contract: owner identity travels on the
		* `X-AtomicMemory-User-Id` request header alongside the
		* deployment-wide `Authorization: Bearer <apiKey>`. The legacy
		* `?user_id=` URL parameter is NEVER serialized — the server's
		* auth middleware rejects it with 400 `legacy_user_id_unsupported`.
		*
		* Transport-level fetch failures (DNS, ECONNREFUSED, AbortError,
		* a misconfigured fetch impl that throws synchronously) are
		* wrapped as `StorageClientError({errorCode:'network_error',
		* status:0})` so callers can branch on a stable error contract
		* instead of catching arbitrary `TypeError`s.
		*
		* `artifactId`, when supplied, threads into the error mapper so
		* `ArtifactNotFoundError` / `ArtifactInUseError` /
		* `PointerContentNotManagedError` carry the id the caller already
		* knows. The capabilities route omits it (no artifact context).
		*/
		async request(method, path, init = {}, artifactId) {
		const url = `${this.apiUrl}${path}`;
		let res;
		try {
		res = await this.fetchImpl(url, {
		method,
		headers: {
		Authorization: `Bearer ${this.apiKey}`,
		"X-AtomicMemory-User-Id": this.userId,
		...init.headers ?? {}
		},
		body: init.body
		});
		} catch (cause) {
		throw new StorageClientError({
		message: `Network error while calling ${method} ${path}: ${cause instanceof Error ? cause.message : String(cause)}`,
		errorCode: "network_error",
		status: 0,
		bodyText: ""
		});
		}
		if (res.ok) return res;
		await throwForResponse(res, artifactId);
		throw new StorageClientError({
		message: `unexpected non-ok response (${res.status})`,
		errorCode: "unexpected_response",
		status: res.status,
		bodyText: ""
		});
		}
		requireArtifactId(ref) {
		if (!ref.artifactId) {
		throw new StorageClientError({
		message: "ArtifactRef.artifactId is required for this operation in v1",
		errorCode: "missing_artifact_id",
		status: 0,
		bodyText: ""
		});
		}
		return ref.artifactId;
		}
		};
		var STORAGE_MODES = ["pointer", "managed"];
		var STORAGE_STATUSES = [
		"stored",
		"pending",
		"available",
		"unavailable",
		"deleting",
		"deleted",
		"delete_failed",
		"failed"
		];
		var CONTENT_ENCODINGS = ["identity", "aes_gcm"];
		function parseSize(value) {
		if (value === null) return null;
		const n = Number(value);
		if (!Number.isFinite(n) \|\| n < 0) return null;
		return n;
		}
		function mapHeadHeaders(headers, fallbackId) {
		const modeRaw = headers.get("x-atomicmemory-storage-mode");
		const statusRaw = headers.get("x-atomicmemory-storage-status");
		if (modeRaw === null \|\| !STORAGE_MODES.includes(modeRaw)) {
		throw new StorageClientError({
		message: `head(): server returned an unrecognized x-atomicmemory-storage-mode value ('${modeRaw ?? "<missing>"}'). Expected one of: ${STORAGE_MODES.join(", ")}.`,
		errorCode: "invalid_head_response",
		status: 200,
		bodyText: ""
		});
		}
		if (statusRaw === null \|\| !STORAGE_STATUSES.includes(statusRaw)) {
		throw new StorageClientError({
		message: `head(): server returned an unrecognized x-atomicmemory-storage-status value ('${statusRaw ?? "<missing>"}'). Expected one of: ${STORAGE_STATUSES.join(", ")}.`,
		errorCode: "invalid_head_response",
		status: 200,
		bodyText: ""
		});
		}
		return {
		artifactId: headers.get("x-atomicmemory-artifact-id") ?? fallbackId,
		provider: headers.get("x-atomicmemory-provider") ?? "",
		mode: modeRaw,
		status: statusRaw,
		sizeBytes: parseSize(headers.get("content-length")),
		contentType: headers.get("content-type")
		};
		}
		function coerceManagedBody(body) {
		if (Buffer.isBuffer(body)) {
		return new Uint8Array(body.buffer, body.byteOffset, body.byteLength);
		}
		if (body instanceof Uint8Array) return body;
		if (body instanceof ArrayBuffer) return new Uint8Array(body);
		if (typeof Blob !== "undefined" && body instanceof Blob) {
		throw new StorageClientError({
		message: "StorageClient.put: Blob input must be converted to Buffer / Uint8Array / ArrayBuffer before calling put(). Use `new Uint8Array(await blob.arrayBuffer())`.",
		errorCode: "unsupported_body_type",
		status: 0,
		bodyText: ""
		});
		}
		throw new StorageClientError({
		message: "StorageClient.put: only Buffer / Uint8Array / ArrayBuffer are accepted in v1. Streaming body uploads land in the Streaming + Resumable Uploads PR.",
		errorCode: "streaming_body_not_supported",
		status: 0,
		bodyText: ""
		});
		}
		function encodeMetadataHeader(metadata) {
		return Buffer.from(JSON.stringify(metadata), "utf8").toString("base64");
		}
		function mapStoredArtifact(raw) {
		const artifactId = requireWireString(raw, "artifact_id");
		const provider = requireWireString(raw, "provider");
		const mode = requireWireEnum(raw, "mode", STORAGE_MODES);
		const status = requireWireEnum(raw, "status", STORAGE_STATUSES);
		const contentEncoding = requireWireEnum(
		raw,
		"content_encoding",
		CONTENT_ENCODINGS
		);
		const createdAt = requireWireString(raw, "created_at");
		const updatedAt = requireWireString(raw, "updated_at");
		const out = {
		artifactId,
		provider,
		mode,
		uri: typeof raw.uri === "string" ? raw.uri : null,
		status,
		sizeBytes: typeof raw.size_bytes === "number" ? raw.size_bytes : null,
		contentType: typeof raw.content_type === "string" ? raw.content_type : null,
		contentEncoding,
		identifiers: raw.identifiers ?? {},
		lifecycle: raw.lifecycle ?? {},
		metadata: raw.metadata ?? {},
		createdAt,
		updatedAt
		};
		if (typeof raw.content_hash === "string") out.contentHash = raw.content_hash;
		if (raw.provider_details && typeof raw.provider_details === "object") {
		out.providerDetails = raw.provider_details;
		}
		if (raw.replication && typeof raw.replication === "object") {
		out.replication = raw.replication;
		}
		if (raw.verification && typeof raw.verification === "object") {
		out.verification = raw.verification;
		}
		if (raw.retrieval && typeof raw.retrieval === "object") {
		out.retrieval = raw.retrieval;
		}
		return out;
		}
		function requireWireString(raw, field) {
		const value = raw[field];
		if (typeof value !== "string" \|\| value.length === 0) {
		throw new StorageClientError({
		message: `mapStoredArtifact: server response is missing required \`${field}\` (or it is not a non-empty string). The storage API contract requires it.`,
		errorCode: "invalid_storage_response",
		status: 200,
		bodyText: ""
		});
		}
		return value;
		}
		function requireWireEnum(raw, field, allowed) {
		const value = raw[field];
		if (typeof value !== "string" \|\| !allowed.includes(value)) {
		throw new StorageClientError({
		message: `mapStoredArtifact: server response field \`${field}\` is not in the SDK's closed enum. Got '${String(value ?? "<missing>")}', expected one of: ${allowed.join(", ")}.`,
		errorCode: "invalid_storage_response",
		status: 200,
		bodyText: ""
		});
		}
		return value;
		}
		function mapDeleteResult(raw) {
		const artifactId = requireWireString(raw, "artifact_id");
		const status = requireWireEnum(raw, "status", STORAGE_STATUSES);
		const out = { artifactId, status };
		if (Array.isArray(raw.cascaded_document_ids)) {
		out.cascadedDocumentIds = raw.cascaded_document_ids.map(String);
		}
		return out;
		}
		function mapVerifyResult(raw) {
		const kind = raw.kind;
		if (kind === "verified") {
		return { kind: "verified", details: raw.details ?? {} };
		}
		if (kind === "failed") {
		return { kind: "failed", reason: String(raw.reason ?? "unknown failure") };
		}
		return { kind: "unsupported", reason: String(raw.reason ?? "unsupported") };
		}
		async function throwForResponse(res, artifactId) {
		const bodyText = await res.text();
		const envelope = parseEnvelope(bodyText);
		const code = envelope.error_code;
		const message = envelope.error ?? `request failed with status ${res.status}`;
		const id = artifactId ?? "";
		if (code === "artifact_in_use") {
		throw new ArtifactInUseError({
		artifactId: id,
		referencedByDocumentCount: envelope.referenced_by_document_count ?? 0,
		bodyText
		});
		}
		if (code === "pointer_content_not_managed") {
		throw new PointerContentNotManagedError({
		artifactId: id,
		uri: envelope.uri ?? "",
		bodyText
		});
		}
		if (code === "filecoin_direct_storage_not_yet_supported") {
		throw new FilecoinDirectStorageNotSupportedError({ bodyText });
		}
		if (code === "artifact_not_found" \|\| res.status === 404) {
		throw new ArtifactNotFoundError({ artifactId: id, bodyText });
		}
		if (code === "unsupported_capability") {
		throw new UnsupportedCapabilityError({
		capability: "unknown",
		message,
		bodyText
		});
		}
		throw new StorageClientError({
		message,
		errorCode: code ?? `http_${res.status}`,
		status: res.status,
		bodyText
		});
		}
		function parseEnvelope(bodyText) {
		if (bodyText.length === 0) return {};
		try {
		return JSON.parse(bodyText);
		} catch {
		return {};
		}
		}

		export { ArtifactInUseError, ArtifactNotFoundError, ConcreteStorageClient, FilecoinDirectStorageNotSupportedError, PointerContentNotManagedError, StorageClientError, UnsupportedCapabilityError };
		//# sourceMappingURL=chunk-OFIOAOM3.js.map
		//# sourceMappingURL=chunk-OFIOAOM3.js.map

-1

dist/chunk-OFIOAOM3.js.map

dist/chunk-T7PRWXW6.js

Sorry, the diff of this file is too big to display

dist/chunk-T7PRWXW6.js.map

Sorry, the diff of this file is too big to display

-337

dist/chunk-V5K4WVX5.js

		import { HindsightProvider, Mem0Provider, AtomicMemoryProvider, noopMemoryPipeline, UnsupportedOperationError } from './chunk-T7PRWXW6.js';

		// src/memory/providers/registry.ts
		var defaultRegistry = {
		atomicmemory: (config) => ({
		provider: new AtomicMemoryProvider(config)
		}),
		mem0: (config) => ({
		provider: new Mem0Provider(config)
		}),
		hindsight: (config) => ({
		provider: new HindsightProvider(config)
		})
		};

		// src/memory/memory-service.ts
		var MemoryService = class {
		constructor(config) {
		this.config = config;
		this.defaultProviderName = config.defaultProvider;
		}
		config;
		providers = /* @__PURE__ */ new Map();
		pipelines = /* @__PURE__ */ new Map();
		defaultProviderName;
		async initialize(registry = defaultRegistry) {
		const stagedProviders = /* @__PURE__ */ new Map();
		const stagedPipelines = /* @__PURE__ */ new Map();
		try {
		for (const [name, providerConfig] of Object.entries(
		this.config.providerConfigs
		)) {
		const factory = registry[name];
		if (!factory) continue;
		const registration = await factory(providerConfig);
		stagedProviders.set(name, registration.provider);
		stagedPipelines.set(
		name,
		registration.pipeline ?? noopMemoryPipeline
		);
		if (registration.provider.initialize) {
		await registration.provider.initialize();
		}
		}
		} catch (cause) {
		await Promise.allSettled(
		[...stagedProviders.values()].map((p) => p.close?.())
		);
		throw cause;
		}
		for (const [name, provider] of stagedProviders) this.providers.set(name, provider);
		for (const [name, pipeline] of stagedPipelines) this.pipelines.set(name, pipeline);
		}
		getProvider(name) {
		const providerName = name ?? this.defaultProviderName;
		const provider = this.providers.get(providerName);
		if (!provider) {
		throw new Error(
		`Provider "${providerName}" is not registered`
		);
		}
		return provider;
		}
		getAvailableProviders() {
		return Array.from(this.providers.keys());
		}
		/**
		* Provider names declared in the SDK configuration, regardless of whether
		* they have been initialized yet. Useful for UI and getter paths that
		* need to advertise capabilities before `initialize()` has run.
		*/
		getConfiguredProviders() {
		return Object.keys(this.config.providerConfigs);
		}
		// -----------------------------------------------------------------------
		// Core operations
		// -----------------------------------------------------------------------
		async ingest(input, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		if (pipeline.preprocessIngest) {
		const inputs = await pipeline.preprocessIngest(input);
		const results = [];
		for (const i of inputs) {
		const result2 = await provider.ingest(i);
		if (pipeline.postprocessIngest) {
		await pipeline.postprocessIngest(result2, i);
		}
		results.push(result2);
		}
		return mergeIngestResults(results);
		}
		const result = await provider.ingest(input);
		if (pipeline.postprocessIngest) {
		await pipeline.postprocessIngest(result, input);
		}
		return result;
		}
		async search(request, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const processedRequest = pipeline.preprocessSearch ? await pipeline.preprocessSearch(request) : request;
		const page = await provider.search(processedRequest);
		return pipeline.postprocessSearch ? await pipeline.postprocessSearch(page, processedRequest) : page;
		}
		async get(ref, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const processedRef = pipeline.preprocessGet ? await pipeline.preprocessGet(ref) : ref;
		const memory = await provider.get(processedRef);
		return pipeline.postprocessGet ? await pipeline.postprocessGet(memory, processedRef) : memory;
		}
		async delete(ref, providerName) {
		const provider = this.getProvider(providerName);
		await provider.delete(ref);
		}
		async list(request, providerName) {
		const provider = this.getProvider(providerName);
		const pipeline = this.getPipeline(providerName);
		const page = await provider.list(request);
		return pipeline.postprocessList ? await pipeline.postprocessList(page, request) : page;
		}
		async package(request, providerName) {
		const provider = this.getProvider(providerName);
		const packager = provider.getExtension?.("package");
		if (!packager) {
		throw new UnsupportedOperationError(
		provider.name,
		"package"
		);
		}
		return packager.package(request);
		}
		// -----------------------------------------------------------------------
		// Internals
		// -----------------------------------------------------------------------
		getPipeline(name) {
		const providerName = name ?? this.defaultProviderName;
		return this.pipelines.get(providerName) ?? noopMemoryPipeline;
		}
		};
		function mergeIngestResults(results) {
		return {
		created: results.flatMap((r) => r.created),
		updated: results.flatMap((r) => r.updated),
		unchanged: results.flatMap((r) => r.unchanged)
		};
		}

		// src/client/memory-client.ts
		var MemoryClient = class {
		service;
		initialized = false;
		initPromise;
		constructor(config) {
		const providerConfigs = { ...config.providers };
		const defaultProvider = config.defaultProvider ?? pickFirstProviderKey(providerConfigs);
		if (!defaultProvider) {
		throw new Error(
		'MemoryClient requires at least one provider config. Pass e.g. { providers: { atomicmemory: { apiUrl: "..." } } }.'
		);
		}
		this.service = new MemoryService({
		defaultProvider,
		providerConfigs
		});
		}
		/**
		* Initialize all configured providers. Must be called before any memory
		* operation. Idempotent and concurrency-safe: concurrent and subsequent
		* calls share a single initialization run. The `registry` argument of the
		* first call wins; later calls share that run and their argument is ignored.
		* A REJECTED initialization is sticky — retrying on the same instance
		* re-throws the original error (partial provider state from a failed run is
		* never reused); resolve the cause (e.g. install a missing optional peer)
		* and construct a new client.
		*/
		async initialize(registry = defaultRegistry) {
		this.initPromise ??= this.service.initialize(registry).then(() => {
		this.initialized = true;
		});
		return this.initPromise;
		}
		/**
		* Write memory(ies). Input supports `text`, `messages`, or `memory` modes.
		*/
		async ingest(input) {
		this.assertInitialized();
		return this.service.ingest(input);
		}
		/**
		* Ingest without any application-layer gating. Equivalent to `ingest()`
		* on the core client; application wrappers override the gated variant
		* while delegating this path straight through.
		*/
		async ingestDirect(input) {
		this.assertInitialized();
		return this.service.ingest(input);
		}
		/**
		* Search for memories matching the request.
		*/
		async search(request) {
		this.assertInitialized();
		return this.service.search(request);
		}
		/**
		* Search without application-layer gating. See `ingestDirect` for the
		* rationale.
		*/
		async searchDirect(request) {
		this.assertInitialized();
		return this.service.search(request);
		}
		/**
		* Build an injection-ready context package from a scoped request.
		* Provider must implement the `package` extension.
		*/
		async package(request) {
		this.assertInitialized();
		return this.service.package(request);
		}
		/**
		* Package without application-layer gating.
		*/
		async packageDirect(request) {
		this.assertInitialized();
		return this.service.package(request);
		}
		/**
		* Fetch a single memory by reference.
		*/
		async get(ref) {
		this.assertInitialized();
		return this.service.get(ref);
		}
		/**
		* Delete a single memory by reference.
		*/
		async delete(ref) {
		this.assertInitialized();
		return this.service.delete(ref);
		}
		/**
		* List memories within a scope.
		*/
		async list(request) {
		this.assertInitialized();
		return this.service.list(request);
		}
		/**
		* Report the capability surface of the default (or named) provider.
		*
		* @throws if the named provider is unknown or not initialized.
		*/
		capabilities(providerName) {
		this.assertInitialized();
		return this.service.getProvider(providerName).capabilities();
		}
		/**
		* Resolve a named extension on the default (or named) provider.
		* Returns `undefined` when the provider does not advertise the
		* extension.
		*
		* @throws if the named provider is unknown or not initialized.
		*
		* @example
		* ```ts
		* const pkg = memory.getExtension<Packager>('package');
		* ```
		*/
		getExtension(extensionName, providerName) {
		this.assertInitialized();
		const provider = this.service.getProvider(providerName);
		return provider.getExtension?.(extensionName);
		}
		/**
		* Aggregate status of all configured providers. Never throws:
		* uninitialized providers report `initialized: false` and
		* `capabilities: null`.
		*/
		getProviderStatus() {
		const configured = this.service.getConfiguredProviders();
		const available = new Set(this.service.getAvailableProviders());
		return configured.map((name) => {
		if (!available.has(name)) {
		return { name, initialized: false, capabilities: null };
		}
		return {
		name,
		initialized: true,
		capabilities: this.service.getProvider(name).capabilities()
		};
		});
		}
		/**
		* Access the full AtomicMemory namespace handle (lifecycle, audit,
		* lessons, config, agents). Returns `undefined` when the client is
		* not yet initialized, the `atomicmemory` provider was not included
		* in the `providers` config, or that provider does not advertise the
		* namespace handle. This getter intentionally never throws — callers
		* can guard with a truthy check and let the handle's own methods
		* raise if used incorrectly.
		*/
		get atomicmemory() {
		if (!this.initialized) return void 0;
		if (!this.service.getConfiguredProviders().includes("atomicmemory")) {
		return void 0;
		}
		const provider = this.service.getProvider("atomicmemory");
		return provider.getExtension?.("atomicmemory.base");
		}
		/**
		* Low-level escape hatch for callers that need the concrete provider.
		*/
		getProvider(name) {
		this.assertInitialized();
		return this.service.getProvider(name);
		}
		assertInitialized() {
		if (!this.initialized) {
		throw new Error(
		"MemoryClient is not initialized. Call `await client.initialize()` first."
		);
		}
		}
		};
		function pickFirstProviderKey(providers) {
		for (const [key, value] of Object.entries(providers)) {
		if (value !== void 0 && key !== "default") return key;
		}
		return void 0;
		}

		export { MemoryClient };
		//# sourceMappingURL=chunk-V5K4WVX5.js.map
		//# sourceMappingURL=chunk-V5K4WVX5.js.map

-1

dist/chunk-V5K4WVX5.js.map

dist/hindsight-provider-CbfXnvx7.d.cts

Sorry, the diff of this file is too big to display

dist/hindsight-provider-CbfXnvx7.d.ts

Sorry, the diff of this file is too big to display

@atomicmemory/sdk - npm Package Compare versions

New alerts

Improved metrics

Worsened metrics