@easynet/agent-memory 0.0.2 → 1.0.0

package/dist/src/core/observability.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Observability: trace every retrieve, record hits, tokens, latency, backend distribution.
+ */
+import type { MemoryTrace, MemoryType } from "./types.js";
+export interface TraceRecorder {
+    record(trace: MemoryTrace): void | Promise<void>;
+}
+export declare class InMemoryTraceRecorder implements TraceRecorder {
+    private traces;
+    record(trace: MemoryTrace): void;
+    getTraces(): MemoryTrace[];
+    clear(): void;
+}
+export declare function createTrace(traceId: string, namespace: string, opts: {
+    query?: string;
+    hitIds: string[];
+    hitTypes: MemoryType[];
+    injectedTokens: number;
+    latencyMs: number;
+    backendDistribution: Record<string, number>;
+}): MemoryTrace;
+//# sourceMappingURL=observability.d.ts.map

package/dist/src/core/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../../../src/core/observability.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,qBAAa,qBAAsB,YAAW,aAAa;IACzD,OAAO,CAAC,MAAM,CAAqB;IAEnC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAIhC,SAAS,IAAI,WAAW,EAAE;IAI1B,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IACJ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,GACA,WAAW,CAWb"}

package/dist/src/core/observability.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Observability: trace every retrieve, record hits, tokens, latency, backend distribution.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryTraceRecorder = void 0;
+exports.createTrace = createTrace;
+class InMemoryTraceRecorder {
+    traces = [];
+    record(trace) {
+        this.traces.push(trace);
+    }
+    getTraces() {
+        return [...this.traces];
+    }
+    clear() {
+        this.traces = [];
+    }
+}
+exports.InMemoryTraceRecorder = InMemoryTraceRecorder;
+function createTrace(traceId, namespace, opts) {
+    return {
+        traceId,
+        namespace,
+        query: opts.query,
+        hitIds: opts.hitIds,
+        hitTypes: opts.hitTypes,
+        injectedTokens: opts.injectedTokens,
+        latencyMs: opts.latencyMs,
+        backendDistribution: opts.backendDistribution,
+    };
+}
+//# sourceMappingURL=observability.js.map

package/dist/src/core/observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.js","sourceRoot":"","sources":["../../../src/core/observability.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAwBH,kCAsBC;AAtCD,MAAa,qBAAqB;IACxB,MAAM,GAAkB,EAAE,CAAC;IAEnC,MAAM,CAAC,KAAkB;QACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;CACF;AAdD,sDAcC;AAED,SAAgB,WAAW,CACzB,OAAe,EACf,SAAiB,EACjB,IAOC;IAED,OAAO;QACL,OAAO;QACP,SAAS;QACT,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;KAC9C,CAAC;AACJ,CAAC"}

package/dist/src/core/policy.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Policy Engine: write/retrieve/update policies.
+ * Generic: driven by config and rules, no use-case hardcoding.
+ */
+import type { MemoryItem, MemoryType } from "./types.js";
+export interface WritePolicyContext {
+    namespace: string;
+    type: MemoryType;
+    content: string;
+    metadata?: Record<string, unknown>;
+    threadId?: string;
+    userId?: string;
+}
+export interface NamespacePolicyContext {
+    threadId?: string;
+    userId?: string;
+    projectId?: string;
+    tenantId?: string;
+}
+export interface RetrievePolicyContext {
+    namespace: string;
+    query: string;
+    budgetTokens: number;
+    existingItems?: MemoryItem[];
+}
+export interface PolicyEngineOptions {
+    /** Whether to allow writing this type (default: allow thread, cross_thread, knowledge) */
+    allowedWriteTypes?: MemoryType[];
+    /** Max items to merge per type when building injected context */
+    maxItemsPerType?: number;
+    /** Token budget per type - keyed by type */
+    budgetPerType?: Partial<Record<MemoryType, number>>;
+}
+export declare class PolicyEngine {
+    private options;
+    constructor(options?: PolicyEngineOptions);
+    /** Whether this write request should be accepted. */
+    shouldWrite(context: WritePolicyContext): boolean;
+    /** Resolve namespace from context (e.g. user:123, project:abc). */
+    selectNamespace(context: NamespacePolicyContext): string | null;
+    /** Filter and rank items within budget; merge and dedupe by semantic key. */
+    mergeAndRank(items: MemoryItem[], budgetTokens: number): {
+        items: MemoryItem[];
+        estimatedTokens: number;
+    };
+}
+//# sourceMappingURL=policy.d.ts.map

package/dist/src/core/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/core/policy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAsB,MAAM,YAAY,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,0FAA0F;IAC1F,iBAAiB,CAAC,EAAE,UAAU,EAAE,CAAC;IACjC,iEAAiE;IACjE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgC;gBAEnC,OAAO,GAAE,mBAAwB;IAQ7C,qDAAqD;IACrD,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO;IAIjD,mEAAmE;IACnE,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI;IAQ/D,6EAA6E;IAC7E,YAAY,CACV,KAAK,EAAE,UAAU,EAAE,EACnB,YAAY,EAAE,MAAM,GACnB;QAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;CA4CpD"}

package/dist/src/core/policy.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Policy Engine: write/retrieve/update policies.
+ * Generic: driven by config and rules, no use-case hardcoding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PolicyEngine = void 0;
+const DEFAULT_ALLOWED_WRITE_TYPES = ["thread", "cross_thread", "knowledge"];
+class PolicyEngine {
+    options;
+    constructor(options = {}) {
+        this.options = {
+            allowedWriteTypes: options.allowedWriteTypes ?? DEFAULT_ALLOWED_WRITE_TYPES,
+            maxItemsPerType: options.maxItemsPerType ?? 20,
+            budgetPerType: options.budgetPerType ?? {},
+        };
+    }
+    /** Whether this write request should be accepted. */
+    shouldWrite(context) {
+        return this.options.allowedWriteTypes.includes(context.type);
+    }
+    /** Resolve namespace from context (e.g. user:123, project:abc). */
+    selectNamespace(context) {
+        if (context.userId)
+            return `user:${context.userId}`;
+        if (context.projectId)
+            return `project:${context.projectId}`;
+        if (context.tenantId)
+            return `org:${context.tenantId}`;
+        if (context.threadId)
+            return `thread:${context.threadId}`;
+        return null;
+    }
+    /** Filter and rank items within budget; merge and dedupe by semantic key. */
+    mergeAndRank(items, budgetTokens) {
+        const budgetPerType = this.options.budgetPerType;
+        const maxPerType = this.options.maxItemsPerType;
+        const byType = new Map();
+        for (const item of items) {
+            const list = byType.get(item.type) ?? [];
+            list.push(item);
+            byType.set(item.type, list);
+        }
+        const selected = [];
+        let estimatedTokens = 0;
+        const roughTokensPerItem = 50;
+        for (const [type, list] of byType) {
+            const typeBudget = budgetPerType[type] ??
+                Math.floor(budgetTokens / Math.max(1, byType.size));
+            const typeLimit = Math.min(maxPerType, Math.floor(typeBudget / roughTokensPerItem));
+            const sorted = [...list].sort((a, b) => (b.metadata.confidence ?? 1) -
+                (a.metadata.confidence ?? 1));
+            const versioned = new Map();
+            for (const item of sorted) {
+                const key = item.metadata.version !== undefined
+                    ? `${item.type}:${item.namespace}:v${item.metadata.version}`
+                    : item.id;
+                if (!versioned.has(key))
+                    versioned.set(key, item);
+            }
+            const take = Array.from(versioned.values()).slice(0, typeLimit);
+            for (const item of take) {
+                if (estimatedTokens + roughTokensPerItem <= budgetTokens) {
+                    selected.push(item);
+                    estimatedTokens += roughTokensPerItem;
+                }
+            }
+        }
+        return { items: selected, estimatedTokens };
+    }
+}
+exports.PolicyEngine = PolicyEngine;
+//# sourceMappingURL=policy.js.map

package/dist/src/core/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/core/policy.ts"],"names":[],"mappings":"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"}

package/dist/src/core/privacy.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Privacy Guard: PII/sensitive field filtering, redaction, and delete support.
+ * Generic: no use-case-specific patterns; config-driven blocklist/allowlist.
+ */
+export interface PrivacyGuardOptions {
+    /**
+     * Metadata keys to strip before storing.
+     * Omit = use built-in defaults; [] = allow all keys; ["password", "token"] = custom list.
+     */
+    forbiddenMetadataKeys?: string[];
+    /** If true, redact content that looks like secrets before storing (placeholder for future). */
+    redactSecrets?: boolean;
+}
+export declare class PrivacyGuard {
+    private forbiddenKeys;
+    private redactSecrets;
+    constructor(options?: PrivacyGuardOptions);
+    /** Strip forbidden keys from metadata. */
+    sanitizeMetadata(metadata: Record<string, unknown>): Record<string, unknown>;
+    /** Redact obvious secret patterns in content when redactSecrets is true (placeholder). */
+    redactContent(content: string): string;
+}
+//# sourceMappingURL=privacy.d.ts.map

package/dist/src/core/privacy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.d.ts","sourceRoot":"","sources":["../../../src/core/privacy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,+FAA+F;IAC/F,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAWD,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,aAAa,CAAU;gBAEnB,OAAO,GAAE,mBAAwB;IAS7C,0CAA0C;IAC1C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAU5E,0FAA0F;IAC1F,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAKvC"}

package/dist/src/core/privacy.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Privacy Guard: PII/sensitive field filtering, redaction, and delete support.
+ * Generic: no use-case-specific patterns; config-driven blocklist/allowlist.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrivacyGuard = void 0;
+const DEFAULT_FORBIDDEN_KEYS = [
+    "password",
+    "api_key",
+    "apikey",
+    "secret",
+    "token",
+    "authorization",
+];
+class PrivacyGuard {
+    forbiddenKeys;
+    redactSecrets;
+    constructor(options = {}) {
+        this.forbiddenKeys = new Set(options.forbiddenMetadataKeys !== undefined
+            ? options.forbiddenMetadataKeys
+            : DEFAULT_FORBIDDEN_KEYS);
+        this.redactSecrets = options.redactSecrets ?? false;
+    }
+    /** Strip forbidden keys from metadata. */
+    sanitizeMetadata(metadata) {
+        const out = {};
+        for (const [k, v] of Object.entries(metadata)) {
+            const lower = k.toLowerCase();
+            if (this.forbiddenKeys.has(lower))
+                continue;
+            out[k] = v;
+        }
+        return out;
+    }
+    /** Redact obvious secret patterns in content when redactSecrets is true (placeholder). */
+    redactContent(content) {
+        if (!this.redactSecrets)
+            return content;
+        // Placeholder: future implementation can detect/seal secrets in content
+        return content;
+    }
+}
+exports.PrivacyGuard = PrivacyGuard;
+//# sourceMappingURL=privacy.js.map

package/dist/src/core/privacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy.js","sourceRoot":"","sources":["../../../src/core/privacy.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAYH,MAAM,sBAAsB,GAAG;IAC7B,UAAU;IACV,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,eAAe;CAChB,CAAC;AAEF,MAAa,YAAY;IACf,aAAa,CAAc;IAC3B,aAAa,CAAU;IAE/B,YAAY,UAA+B,EAAE;QAC3C,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,CAC1B,OAAO,CAAC,qBAAqB,KAAK,SAAS;YACzC,CAAC,CAAC,OAAO,CAAC,qBAAqB;YAC/B,CAAC,CAAC,sBAAsB,CAC3B,CAAC;QACF,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC;IACtD,CAAC;IAED,0CAA0C;IAC1C,gBAAgB,CAAC,QAAiC;QAChD,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,SAAS;YAC5C,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,0FAA0F;IAC1F,aAAa,CAAC,OAAe;QAC3B,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO,OAAO,CAAC;QACxC,wEAAwE;QACxE,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AA9BD,oCA8BC"}

package/dist/src/core/router.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Memory Router: route read/write to one or more backends by type/namespace.
+ * Generic: routing is config-driven (which types go to which provider).
+ */
+import type { MemoryItem, MemoryProvider, MemoryQueryRequest, MemoryWriteRequest } from "./types.js";
+export interface RouterRule {
+    types?: string[];
+    namespacePrefix?: string;
+    providerId: string;
+}
+export interface MemoryRouterOptions {
+    providers: Map<string, MemoryProvider>;
+    /** Which provider(s) handle which types/namespaces. If empty, all go to defaultProvider. */
+    rules?: RouterRule[];
+    defaultProviderId: string;
+}
+export declare class MemoryRouter {
+    private providers;
+    private rules;
+    private defaultProviderId;
+    constructor(options: MemoryRouterOptions);
+    private getProvider;
+    /** Resolve which provider(s) to use for this write. Returns at least one provider id. */
+    routeWrite(req: MemoryWriteRequest): string[];
+    /** Resolve which provider(s) to query. */
+    routeQuery(req: MemoryQueryRequest): string[];
+    write(req: MemoryWriteRequest): Promise<MemoryItem>;
+    query(req: MemoryQueryRequest): Promise<MemoryItem[]>;
+    delete(id: string, namespace: string): Promise<void>;
+    /** Get one item by namespace and key (path); uses first provider that has getByKey. */
+    getByKey(namespace: string, key: string): Promise<MemoryItem | null>;
+    /** Delete item by namespace and key. */
+    deleteByKey(namespace: string, key: string): Promise<void>;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/src/core/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/core/router.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErG,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACvC,4FAA4F;IAC5F,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,OAAO,EAAE,mBAAmB;IAMxC,OAAO,CAAC,WAAW;IAMnB,yFAAyF;IACzF,UAAU,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,EAAE;IAY7C,0CAA0C;IAC1C,UAAU,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,EAAE;IAavC,KAAK,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAMnD,KAAK,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAUrD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1D,uFAAuF;IACjF,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAU1E,wCAAwC;IAClC,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKjE"}

package/dist/src/core/router.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Memory Router: route read/write to one or more backends by type/namespace.
+ * Generic: routing is config-driven (which types go to which provider).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryRouter = void 0;
+class MemoryRouter {
+    providers;
+    rules;
+    defaultProviderId;
+    constructor(options) {
+        this.providers = options.providers;
+        this.rules = options.rules ?? [];
+        this.defaultProviderId = options.defaultProviderId;
+    }
+    getProvider(id) {
+        const p = this.providers.get(id);
+        if (!p)
+            throw new Error(`Unknown provider: ${id}`);
+        return p;
+    }
+    /** Resolve which provider(s) to use for this write. Returns at least one provider id. */
+    routeWrite(req) {
+        const matched = this.rules.filter((r) => (!r.types || r.types.includes(req.type)) &&
+            (!r.namespacePrefix || req.namespace.startsWith(r.namespacePrefix)));
+        if (matched.length > 0) {
+            return [...new Set(matched.map((r) => r.providerId))];
+        }
+        return [this.defaultProviderId];
+    }
+    /** Resolve which provider(s) to query. */
+    routeQuery(req) {
+        const matched = this.rules.filter((r) => (!r.types ||
+            (req.types && req.types.some((t) => r.types.includes(t)))) &&
+            (!r.namespacePrefix || req.namespace.startsWith(r.namespacePrefix)));
+        if (matched.length > 0) {
+            return [...new Set(matched.map((r) => r.providerId))];
+        }
+        return [this.defaultProviderId];
+    }
+    async write(req) {
+        const ids = this.routeWrite(req);
+        const provider = this.getProvider(ids[0]);
+        return provider.write(req);
+    }
+    async query(req) {
+        const ids = this.routeQuery(req);
+        const all = [];
+        for (const id of ids) {
+            const items = await this.getProvider(id).query(req);
+            all.push(...items);
+        }
+        return all;
+    }
+    async delete(id, namespace) {
+        for (const p of this.providers.values()) {
+            try {
+                await p.delete(id, namespace);
+            }
+            catch {
+                // ignore if not in this provider
+            }
+        }
+    }
+    /** Get one item by namespace and key (path); uses first provider that has getByKey. */
+    async getByKey(namespace, key) {
+        for (const p of this.providers.values()) {
+            if (p.getByKey) {
+                const item = await p.getByKey(namespace, key);
+                if (item)
+                    return item;
+            }
+        }
+        return null;
+    }
+    /** Delete item by namespace and key. */
+    async deleteByKey(namespace, key) {
+        for (const p of this.providers.values()) {
+            if (p.deleteByKey)
+                await p.deleteByKey(namespace, key);
+        }
+    }
+}
+exports.MemoryRouter = MemoryRouter;
+//# sourceMappingURL=router.js.map

package/dist/src/core/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/core/router.ts"],"names":[],"mappings":"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"}

package/dist/src/core/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Unified memory types per agent-memory dev doc.
+ * Generic: no use-case hardcoding; driven by config and semantic understanding.
+ */
+/** Supported memory types: thread (session), cross_thread (cross-session), knowledge (docs/RAG). No use-case hardcoding. */
+export type MemoryType = "thread" | "cross_thread" | "knowledge";
+export type MemoryScope = "thread" | "global";
+export type MemorySource = "chat" | "tool" | "doc" | "image" | "code" | "system";
+export type PrivacyLevel = "public" | "private" | "sensitive";
+export interface MemoryItemMetadata {
+    source?: MemorySource;
+    thread_id?: string;
+    user_id?: string;
+    project_id?: string;
+    doc_id?: string;
+    page?: number;
+    image_path?: string;
+    tags?: string[];
+    created_at: string;
+    updated_at?: string;
+    ttl_seconds?: number;
+    confidence?: number;
+    privacy?: PrivacyLevel;
+    version?: number;
+    [key: string]: unknown;
+}
+export interface MemoryItem {
+    id: string;
+    type: MemoryType;
+    namespace: string;
+    scope: MemoryScope;
+    content: string;
+    embedding?: number[];
+    metadata: MemoryItemMetadata;
+}
+export interface MemoryWriteRequest {
+    namespace: string;
+    type: MemoryType;
+    content: string;
+    scope?: MemoryScope;
+    metadata?: Partial<MemoryItemMetadata>;
+}
+/** memorize input: type optional; when omitted, classifyMemory callback or default cross_thread. */
+export type MemorizeRequest = Omit<MemoryWriteRequest, "type"> & {
+    type?: MemoryType;
+};
+export interface MemoryQueryRequest {
+    namespace: string;
+    query: string;
+    topK?: number;
+    filters?: Record<string, unknown>;
+    budgetTokens?: number;
+    types?: MemoryType[];
+}
+export interface MemoryProvider {
+    write(req: MemoryWriteRequest): Promise<MemoryItem>;
+    query(req: MemoryQueryRequest): Promise<MemoryItem[]>;
+    delete(id: string, namespace: string): Promise<void>;
+    /** Optional: get a single item by namespace and key (e.g. path). */
+    getByKey?(namespace: string, key: string): Promise<MemoryItem | null>;
+    /** Optional: delete the item with the given namespace and key. */
+    deleteByKey?(namespace: string, key: string): Promise<void>;
+    upsert?(item: MemoryItem): Promise<MemoryItem>;
+}
+export interface RetrieveResult {
+    items: MemoryItem[];
+    injectedText: string;
+    traceId: string;
+}
+/** Recall result (same shape as retrieveForPrompt). */
+export type RecallResult = RetrieveResult;
+export interface MemoryTrace {
+    traceId: string;
+    namespace: string;
+    query?: string;
+    hitIds: string[];
+    hitTypes: MemoryType[];
+    injectedTokens: number;
+    latencyMs: number;
+    backendDistribution: Record<string, number>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"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"}

package/dist/src/core/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Unified memory types per agent-memory dev doc.
+ * Generic: no use-case hardcoding; driven by config and semantic understanding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/{adapters → src/core}/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/src/create-agent-memory.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Create AgentMemory from YAML or default config.
+ * Returned memory.memorize supports content+type and url (local/remote PDF, txt, HTML, images).
+ */
+import { type AgentMemoryConfig } from "./core/config.js";
+import type { MemoryItem, MemoryWriteRequest } from "./core/types.js";
+import type { AgentMemory, ClassifyMemoryFn } from "./core/agent-memory.js";
+import { type Mem0MemoryLike } from "./providers/mem0-provider.js";
+/** memorize input when using createAgentMemory: content (+ optional type) or url. */
+export type MemorizeRequestWithIngest = Omit<MemoryWriteRequest, "content" | "type"> & {
+    content?: string;
+    type?: MemoryWriteRequest["type"];
+    /** Local path or remote URL; format detected and ingested as knowledge. */
+    url?: string;
+};
+export interface CreateAgentMemoryOptions {
+    /** YAML config path; default cwd/config/agent-memory.yaml or in-memory if missing */
+    configPath?: string;
+    /** Config object; overrides configPath */
+    config?: AgentMemoryConfig;
+    /** Provider overrides (e.g. mem0: pass initialized Memory instance) */
+    overrides?: {
+        mem0?: Mem0MemoryLike;
+    };
+    /** When type omitted: used to infer type; otherwise default cross_thread */
+    classifyMemory?: ClassifyMemoryFn;
+    /** For image URL ingest: generate caption; otherwise store "(image: <url>)" */
+    captionFn?: (buffer: Buffer) => Promise<string>;
+}
+/** createAgentMemory return type: memorize supports content+type and url */
+export interface CreateAgentMemoryResult extends Omit<AgentMemory, "memorize" | "write"> {
+    memorize(req: MemorizeRequestWithIngest): Promise<MemoryItem>;
+    write(req: MemorizeRequestWithIngest): Promise<MemoryItem>;
+}
+/**
+ * Create AgentMemory from YAML or default config.
+ *
+ * @example
+ * const memory = await createAgentMemory();
+ * @example
+ * const memory = await createAgentMemory({ configPath: "./config/memory.yaml" });
+ * @example
+ * const mem0 = new Memory({ ... });
+ * const memory = await createAgentMemory({ configPath: "config/agent-memory.yaml", overrides: { mem0 } });
+ */
+export declare function createAgentMemory(options?: CreateAgentMemoryOptions | string): Promise<CreateAgentMemoryResult>;
+//# sourceMappingURL=create-agent-memory.d.ts.map

package/dist/src/create-agent-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent-memory.d.ts","sourceRoot":"","sources":["../../src/create-agent-memory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAkB,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEtF,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAQ5E,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAKjF,qFAAqF;AACrF,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,MAAM,CAAC,GAAG;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAClC,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,uEAAuE;IACvE,SAAS,CAAC,EAAE;QACV,IAAI,CAAC,EAAE,cAAc,CAAC;KACvB,CAAC;IACF,4EAA4E;IAC5E,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjD;AAED,4EAA4E;AAC5E,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,OAAO,CAAC;IACtF,QAAQ,CAAC,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9D,KAAK,CAAC,GAAG,EAAE,yBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5D;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,GAAE,wBAAwB,GAAG,MAAW,GAC9C,OAAO,CAAC,uBAAuB,CAAC,CA0HlC"}