@mono-agent/memory 0.4.1

package/dist/bujo/store.js.map

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

package/dist/bujo/types.d.ts

@@ -0,0 +1,39 @@
+import type { EmbeddingProvider } from "../search/index.js";
+import type { MemoryStatus, MemoryType } from "../store/index.js";
+import type { LlmComplete } from "./llm.js";
+export type { CandidateMemory } from "./distill.js";
+/** One parsed markdown bullet line: a visible part + structured metadata from the trailing comment. */
+export interface Bullet {
+    readonly id: string;
+    readonly type: MemoryType;
+    readonly status: MemoryStatus;
+    readonly text: string;
+    readonly salience: number;
+    readonly isInsight: boolean;
+    readonly createdAt: string;
+    readonly refs: readonly string[];
+    readonly dueAt?: string;
+}
+export type BujoTier = "lite" | "journal" | "bujo";
+/** Minimal logger sink for best-effort background work (capture queue). */
+export interface BujoLogger {
+    warn(message: string): void;
+}
+export interface BujoOptions {
+    readonly root: string;
+    /** Embedding provider. When absent, the store runs in `lite` tier (FTS-only recall). */
+    readonly embeddings?: EmbeddingProvider;
+    /** Vector dimension. Required when `embeddings` is provided; ignored in the `lite` tier. */
+    readonly dim?: number;
+    readonly maxBytes?: number;
+    readonly clock?: () => Date;
+    /** Optional LLM for the intelligent capture path (distill + reconcile + entity extraction).
+     * When absent, `capture()` returns `undefined` and `appendHostSummary` is the only write path. */
+    readonly llm?: LlmComplete;
+    /** Explicit tier override. When absent, the tier is derived from the options:
+     * no embeddings → `"lite"`; embeddings + no llm → `"journal"`; embeddings + llm → `"bujo"`. */
+    readonly tier?: BujoTier;
+    /** Optional sink for caught errors in the async capture queue. Defaults to a no-op. */
+    readonly logger?: BujoLogger;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/bujo/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/bujo/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,uGAAuG;AACvG,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnD,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,4FAA4F;IAC5F,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B;sGACkG;IAClG,QAAQ,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC;IAC3B;mGAC+F;IAC/F,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC;IACzB,uFAAuF;IACvF,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;CAC9B"}

package/dist/bujo/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/bujo/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/bujo/types.ts"],"names":[],"mappings":""}

package/dist/search/chunks.d.ts

@@ -0,0 +1,14 @@
+import type { MemoryChunk } from "./types.js";
+/** Minimal structural shape of an entity, to avoid a package dependency on memory-graph. */
+export interface EntityLike {
+    readonly name: string;
+    readonly entityType: string;
+    readonly observations: readonly string[];
+}
+/**
+ * Builds indexable chunks from the markdown journal archive plus the entity
+ * snapshot. Journal files are split into `##`-delimited sections; each entity
+ * becomes one summary chunk.
+ */
+export declare function gatherMemoryChunks(rootDir: string, entities: readonly EntityLike[]): Promise<readonly MemoryChunk[]>;
+//# sourceMappingURL=chunks.d.ts.map

package/dist/search/chunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunks.d.ts","sourceRoot":"","sources":["../../src/search/chunks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,4FAA4F;AAC5F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAmC1H"}

package/dist/search/chunks.js

@@ -0,0 +1,75 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+const MEMORY_SUBDIRS = ["daily", "monthly"];
+const DATE_RE = /^(\d{4}-\d{2}-\d{2})\.md$/u;
+/**
+ * Builds indexable chunks from the markdown journal archive plus the entity
+ * snapshot. Journal files are split into `##`-delimited sections; each entity
+ * becomes one summary chunk.
+ */
+export async function gatherMemoryChunks(rootDir, entities) {
+    const chunks = [];
+    for (const subdir of MEMORY_SUBDIRS) {
+        const dir = join(rootDir, subdir);
+        for (const name of await readDirSafe(dir)) {
+            if (!name.endsWith(".md")) {
+                continue;
+            }
+            const content = await readUtf8(join(dir, name));
+            if (content === undefined) {
+                continue;
+            }
+            const source = `${subdir}/${name}`;
+            const day = subdir === "daily" ? DATE_RE.exec(name)?.[1] : undefined;
+            splitSections(content).forEach((section, index) => {
+                chunks.push({
+                    id: `${source}#${index}`,
+                    source,
+                    text: section,
+                    ...(day === undefined ? {} : { day }),
+                });
+            });
+        }
+    }
+    for (const entity of entities) {
+        const facts = entity.observations.join("; ");
+        const text = facts.length === 0
+            ? `${entity.name} (${entity.entityType})`
+            : `${entity.name} (${entity.entityType}): ${facts}`;
+        chunks.push({ id: `entity:${normalizeName(entity.name)}`, source: "graph", text });
+    }
+    return chunks;
+}
+function splitSections(content) {
+    const sections = content.split(/\n(?=#{1,3} )/u).map((section) => section.trim()).filter(Boolean);
+    return sections.length === 0 ? [content.trim()].filter(Boolean) : sections;
+}
+function normalizeName(name) {
+    return name.replace(/\s+/gu, " ").trim().toLowerCase();
+}
+async function readUtf8(path) {
+    try {
+        return await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error, "ENOENT")) {
+            return undefined;
+        }
+        throw error;
+    }
+}
+async function readDirSafe(dir) {
+    try {
+        return await readdir(dir);
+    }
+    catch (error) {
+        if (isNodeError(error, "ENOENT")) {
+            return [];
+        }
+        throw error;
+    }
+}
+function isNodeError(error, code) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+//# sourceMappingURL=chunks.js.map

package/dist/search/chunks.js.map

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

package/dist/search/circuit-breaker.d.ts

@@ -0,0 +1,34 @@
+import type { EmbeddingProvider } from "./types.js";
+export interface CircuitBreakerEmbeddingOptions {
+    /** Consecutive inner failures before the breaker trips OPEN (default 3). */
+    readonly failureThreshold?: number;
+    /** How long the breaker stays OPEN before allowing a HALF-OPEN trial (default 30000ms). */
+    readonly cooldownMs?: number;
+    /** Injectable clock for deterministic tests (default Date.now). */
+    readonly now?: () => number;
+}
+/**
+ * Wraps an {@link EmbeddingProvider} with a circuit breaker so a slow/failing
+ * backend stops blocking the critical path. After `failureThreshold` consecutive
+ * failures the breaker trips OPEN and fails FAST (throwing `embedding_circuit_open`
+ * without calling the inner provider) for `cooldownMs`. It then allows a single
+ * HALF-OPEN trial: success CLOSES it, failure RE-OPENS it for a fresh cooldown.
+ */
+export declare class CircuitBreakerEmbeddingProvider implements EmbeddingProvider {
+    readonly id: string;
+    private readonly inner;
+    private readonly failureThreshold;
+    private readonly cooldownMs;
+    private readonly now;
+    private state;
+    private consecutiveFailures;
+    private openedAt;
+    private trialInFlight;
+    constructor(inner: EmbeddingProvider, options?: CircuitBreakerEmbeddingOptions);
+    embed(texts: readonly string[]): Promise<number[][]>;
+    private onSuccess;
+    private onFailure;
+    private open;
+}
+export declare function createCircuitBreakerEmbeddingProvider(inner: EmbeddingProvider, options?: CircuitBreakerEmbeddingOptions): EmbeddingProvider;
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/search/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/search/circuit-breaker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKpD,MAAM,WAAW,8BAA8B;IAC7C,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAID;;;;;;GAMG;AACH,qBAAa,+BAAgC,YAAW,iBAAiB;IACvE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,QAAQ,CAAK;IAGrB,OAAO,CAAC,aAAa,CAAS;gBAElB,KAAK,EAAE,iBAAiB,EAAE,OAAO,GAAE,8BAAmC;IAQ5E,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAoC1D,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,IAAI;CAKb;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE,8BAAmC,GAC3C,iBAAiB,CAEnB"}

package/dist/search/circuit-breaker.js

@@ -0,0 +1,89 @@
+import { MemorySearchError } from "./embeddings.js";
+const DEFAULT_FAILURE_THRESHOLD = 3;
+const DEFAULT_COOLDOWN_MS = 30_000;
+/**
+ * Wraps an {@link EmbeddingProvider} with a circuit breaker so a slow/failing
+ * backend stops blocking the critical path. After `failureThreshold` consecutive
+ * failures the breaker trips OPEN and fails FAST (throwing `embedding_circuit_open`
+ * without calling the inner provider) for `cooldownMs`. It then allows a single
+ * HALF-OPEN trial: success CLOSES it, failure RE-OPENS it for a fresh cooldown.
+ */
+export class CircuitBreakerEmbeddingProvider {
+    id;
+    inner;
+    failureThreshold;
+    cooldownMs;
+    now;
+    state = "closed";
+    consecutiveFailures = 0;
+    openedAt = 0;
+    // Guards the single HALF-OPEN trial: once a trial is in flight, concurrent
+    // callers must fail fast rather than pile onto an unhealthy backend.
+    trialInFlight = false;
+    constructor(inner, options = {}) {
+        this.inner = inner;
+        this.failureThreshold = options.failureThreshold ?? DEFAULT_FAILURE_THRESHOLD;
+        this.cooldownMs = options.cooldownMs ?? DEFAULT_COOLDOWN_MS;
+        this.now = options.now ?? Date.now;
+        this.id = inner.id;
+    }
+    async embed(texts) {
+        if (this.state === "open") {
+            if (this.now() - this.openedAt < this.cooldownMs) {
+                throw new MemorySearchError("embedding_circuit_open", "Embedding circuit is open; failing fast.", {
+                    id: this.id,
+                    cooldownMs: this.cooldownMs,
+                });
+            }
+            // Cooldown elapsed: allow exactly one trial.
+            this.state = "half-open";
+        }
+        // In HALF-OPEN only the first caller may probe the backend; concurrent
+        // callers fail fast so a single trial decides whether to re-close or
+        // re-open. (Once state flips to half-open, the `state === "open"` guard
+        // above no longer blocks them, so this second guard is required.)
+        if (this.state === "half-open") {
+            if (this.trialInFlight) {
+                throw new MemorySearchError("embedding_circuit_open", "Embedding circuit is half-open; a trial is already in flight.", {
+                    id: this.id,
+                    cooldownMs: this.cooldownMs,
+                });
+            }
+            this.trialInFlight = true;
+        }
+        try {
+            const result = await this.inner.embed(texts);
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    onSuccess() {
+        this.state = "closed";
+        this.consecutiveFailures = 0;
+        this.trialInFlight = false;
+    }
+    onFailure() {
+        if (this.state === "half-open") {
+            // A failed trial re-opens the breaker for a fresh cooldown window.
+            this.open();
+            return;
+        }
+        this.consecutiveFailures += 1;
+        if (this.consecutiveFailures >= this.failureThreshold) {
+            this.open();
+        }
+    }
+    open() {
+        this.state = "open";
+        this.openedAt = this.now();
+        this.trialInFlight = false;
+    }
+}
+export function createCircuitBreakerEmbeddingProvider(inner, options = {}) {
+    return new CircuitBreakerEmbeddingProvider(inner, options);
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/search/circuit-breaker.js.map

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

package/dist/search/embeddings.d.ts

@@ -0,0 +1,44 @@
+import type { EmbeddingProvider, EmbeddingProviderConfig, MemorySearchErrorCode } from "./types.js";
+export declare class MemorySearchError extends Error {
+    readonly code: MemorySearchErrorCode;
+    readonly details: Record<string, unknown>;
+    constructor(code: MemorySearchErrorCode, message: string, details?: Record<string, unknown>);
+}
+type FetchLike = typeof fetch;
+export interface OllamaEmbeddingOptions {
+    readonly model: string;
+    readonly endpoint?: string;
+    readonly timeoutMs?: number;
+    readonly fetchImpl?: FetchLike;
+}
+/** Local embeddings via Ollama's `/api/embed` endpoint (e.g. nomic-embed-text). */
+export declare class OllamaEmbeddingProvider implements EmbeddingProvider {
+    readonly id: string;
+    private readonly model;
+    private readonly endpoint;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(options: OllamaEmbeddingOptions);
+    embed(texts: readonly string[]): Promise<number[][]>;
+}
+export interface OpenAIEmbeddingOptions {
+    readonly model: string;
+    readonly apiKey: string;
+    readonly endpoint?: string;
+    readonly timeoutMs?: number;
+    readonly fetchImpl?: FetchLike;
+}
+/** Remote embeddings via the OpenAI-compatible `/embeddings` endpoint. */
+export declare class OpenAIEmbeddingProvider implements EmbeddingProvider {
+    readonly id: string;
+    private readonly model;
+    private readonly apiKey;
+    private readonly endpoint;
+    private readonly timeoutMs;
+    private readonly fetchImpl;
+    constructor(options: OpenAIEmbeddingOptions);
+    embed(texts: readonly string[]): Promise<number[][]>;
+}
+export declare function createEmbeddingProvider(config: EmbeddingProviderConfig, fetchImpl?: FetchLike): EmbeddingProvider;
+export {};
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/search/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/search/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEpG,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE9B,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAMhG;AAED,KAAK,SAAS,GAAG,OAAO,KAAK,CAAC;AAM9B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAChC;AAED,mFAAmF;AACnF,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,OAAO,EAAE,sBAAsB;IAWrC,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAsB3D;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;CAChC;AAED,0EAA0E;AAC1E,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,OAAO,EAAE,sBAAsB;IAerC,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;CAqB3D;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,uBAAuB,EAC/B,SAAS,CAAC,EAAE,SAAS,GACpB,iBAAiB,CAsBnB"}

package/dist/search/embeddings.js

@@ -0,0 +1,141 @@
+export class MemorySearchError extends Error {
+    code;
+    details;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.name = "MemorySearchError";
+        this.code = code;
+        this.details = { ...details, code };
+    }
+}
+const DEFAULT_OLLAMA_ENDPOINT = "http://localhost:11434";
+const DEFAULT_OPENAI_ENDPOINT = "https://api.openai.com/v1";
+const DEFAULT_TIMEOUT_MS = 30_000;
+/** Local embeddings via Ollama's `/api/embed` endpoint (e.g. nomic-embed-text). */
+export class OllamaEmbeddingProvider {
+    id;
+    model;
+    endpoint;
+    timeoutMs;
+    fetchImpl;
+    constructor(options) {
+        if (typeof options.model !== "string" || options.model.trim().length === 0) {
+            throw new MemorySearchError("invalid_embedding_options", "Ollama embedding model is required.");
+        }
+        this.model = options.model;
+        this.endpoint = (options.endpoint ?? DEFAULT_OLLAMA_ENDPOINT).replace(/\/+$/u, "");
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+        this.id = `ollama:${this.model}`;
+    }
+    async embed(texts) {
+        if (texts.length === 0) {
+            return [];
+        }
+        const body = JSON.stringify({ model: this.model, input: [...texts] });
+        const response = await withTimeout(this.timeoutMs, (signal) => this.fetchImpl(`${this.endpoint}/api/embed`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body,
+            signal,
+        }));
+        if (!response.ok) {
+            throw new MemorySearchError("embedding_request_failed", `Ollama embeddings request failed (${response.status}).`, {
+                status: response.status,
+                endpoint: this.endpoint,
+            });
+        }
+        const json = (await response.json());
+        return validateEmbeddings(json.embeddings, texts.length);
+    }
+}
+/** Remote embeddings via the OpenAI-compatible `/embeddings` endpoint. */
+export class OpenAIEmbeddingProvider {
+    id;
+    model;
+    apiKey;
+    endpoint;
+    timeoutMs;
+    fetchImpl;
+    constructor(options) {
+        if (typeof options.model !== "string" || options.model.trim().length === 0) {
+            throw new MemorySearchError("invalid_embedding_options", "OpenAI embedding model is required.");
+        }
+        if (typeof options.apiKey !== "string" || options.apiKey.trim().length === 0) {
+            throw new MemorySearchError("invalid_embedding_options", "OpenAI embeddings require an API key.");
+        }
+        this.model = options.model;
+        this.apiKey = options.apiKey;
+        this.endpoint = (options.endpoint ?? DEFAULT_OPENAI_ENDPOINT).replace(/\/+$/u, "");
+        this.timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this.fetchImpl = options.fetchImpl ?? fetch;
+        this.id = `openai:${this.model}`;
+    }
+    async embed(texts) {
+        if (texts.length === 0) {
+            return [];
+        }
+        const response = await withTimeout(this.timeoutMs, (signal) => this.fetchImpl(`${this.endpoint}/embeddings`, {
+            method: "POST",
+            headers: { "content-type": "application/json", authorization: `Bearer ${this.apiKey}` },
+            body: JSON.stringify({ model: this.model, input: [...texts] }),
+            signal,
+        }));
+        if (!response.ok) {
+            throw new MemorySearchError("embedding_request_failed", `OpenAI embeddings request failed (${response.status}).`, {
+                status: response.status,
+            });
+        }
+        const json = (await response.json());
+        const embeddings = Array.isArray(json.data) ? json.data.map((entry) => entry.embedding) : undefined;
+        return validateEmbeddings(embeddings, texts.length);
+    }
+}
+export function createEmbeddingProvider(config, fetchImpl) {
+    if (config.provider === "ollama") {
+        return new OllamaEmbeddingProvider({
+            model: config.model,
+            ...(config.endpoint === undefined ? {} : { endpoint: config.endpoint }),
+            ...(config.timeoutMs === undefined ? {} : { timeoutMs: config.timeoutMs }),
+            ...(fetchImpl === undefined ? {} : { fetchImpl }),
+        });
+    }
+    if (config.provider === "openai") {
+        if (config.apiKey === undefined) {
+            throw new MemorySearchError("invalid_embedding_options", "OpenAI embeddings require an API key.");
+        }
+        return new OpenAIEmbeddingProvider({
+            model: config.model,
+            apiKey: config.apiKey,
+            ...(config.endpoint === undefined ? {} : { endpoint: config.endpoint }),
+            ...(config.timeoutMs === undefined ? {} : { timeoutMs: config.timeoutMs }),
+            ...(fetchImpl === undefined ? {} : { fetchImpl }),
+        });
+    }
+    throw new MemorySearchError("invalid_embedding_options", `Unknown embedding provider "${String(config.provider)}".`);
+}
+function validateEmbeddings(value, expected) {
+    if (!Array.isArray(value) || value.length !== expected) {
+        throw new MemorySearchError("embedding_response_invalid", "Embedding response shape was unexpected.", {
+            expected,
+            received: Array.isArray(value) ? value.length : typeof value,
+        });
+    }
+    return value.map((vector) => {
+        if (!Array.isArray(vector) || vector.some((component) => typeof component !== "number")) {
+            throw new MemorySearchError("embedding_response_invalid", "Embedding vector was not an array of numbers.");
+        }
+        return vector;
+    });
+}
+async function withTimeout(timeoutMs, run) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        return await run(controller.signal);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/search/embeddings.js.map

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

package/dist/search/index.d.ts

@@ -0,0 +1,8 @@
+export { createEmbeddingProvider, MemorySearchError, OllamaEmbeddingProvider, OpenAIEmbeddingProvider, } from "./embeddings.js";
+export { CircuitBreakerEmbeddingProvider, createCircuitBreakerEmbeddingProvider, } from "./circuit-breaker.js";
+export type { CircuitBreakerEmbeddingOptions } from "./circuit-breaker.js";
+export { createVectorMemoryIndex, VectorMemoryIndex } from "./vector-index.js";
+export { gatherMemoryChunks } from "./chunks.js";
+export type { EntityLike } from "./chunks.js";
+export type { EmbeddingProvider, EmbeddingProviderConfig, EmbeddingProviderKind, MemoryChunk, MemorySearchErrorCode, SearchHit, VectorMemoryIndexOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,+BAA+B,EAC/B,qCAAqC,GACtC,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,WAAW,EACX,qBAAqB,EACrB,SAAS,EACT,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/search/index.js

@@ -0,0 +1,5 @@
+export { createEmbeddingProvider, MemorySearchError, OllamaEmbeddingProvider, OpenAIEmbeddingProvider, } from "./embeddings.js";
+export { CircuitBreakerEmbeddingProvider, createCircuitBreakerEmbeddingProvider, } from "./circuit-breaker.js";
+export { createVectorMemoryIndex, VectorMemoryIndex } from "./vector-index.js";
+export { gatherMemoryChunks } from "./chunks.js";
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,+BAA+B,EAC/B,qCAAqC,GACtC,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/search/types.d.ts

@@ -0,0 +1,41 @@
+export type MemorySearchErrorCode = "invalid_embedding_options" | "embedding_request_failed" | "embedding_response_invalid" | "embedding_circuit_open" | "invalid_index_options" | "index_read_failed" | "index_write_failed";
+/** Turns text into dense vectors. Implementations: Ollama (default), OpenAI. */
+export interface EmbeddingProvider {
+    /** Stable identifier for diagnostics (e.g. "ollama:nomic-embed-text"). */
+    readonly id: string;
+    embed(texts: readonly string[]): Promise<number[][]>;
+}
+/** A unit of indexable memory (a journal section or an entity summary). */
+export interface MemoryChunk {
+    readonly id: string;
+    readonly source: string;
+    readonly text: string;
+    readonly day?: string;
+}
+export interface SearchHit {
+    readonly id: string;
+    readonly source: string;
+    readonly text: string;
+    readonly score: number;
+    readonly day?: string;
+}
+export type EmbeddingProviderKind = "ollama" | "openai";
+export interface EmbeddingProviderConfig {
+    readonly provider: EmbeddingProviderKind;
+    readonly model: string;
+    readonly endpoint?: string;
+    readonly apiKey?: string;
+    readonly timeoutMs?: number;
+}
+export interface VectorMemoryIndexOptions {
+    /** JSONL file holding the embedding records (e.g. `<root>/index/embeddings.jsonl`). */
+    readonly path: string;
+    readonly embeddings: EmbeddingProvider;
+    /** Prefix applied to documents before embedding (nomic-embed-text convention). */
+    readonly documentPrefix?: string;
+    /** Prefix applied to queries before embedding (nomic-embed-text convention). */
+    readonly queryPrefix?: string;
+    /** Embedding batch size (default 32). */
+    readonly batchSize?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/search/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,2BAA2B,GAC3B,0BAA0B,GAC1B,4BAA4B,GAC5B,wBAAwB,GACxB,uBAAuB,GACvB,mBAAmB,GACnB,oBAAoB,CAAC;AAEzB,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACtD;AAED,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,uFAAuF;IACvF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,kFAAkF;IAClF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/search/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/search/types.ts"],"names":[],"mappings":""}

package/dist/search/vector-index.d.ts

@@ -0,0 +1,28 @@
+import type { MemoryChunk, SearchHit, VectorMemoryIndexOptions } from "./types.js";
+/**
+ * A dependency-free embedded vector store: embeddings persisted as JSON Lines,
+ * searched by brute-force cosine similarity. Fast and simple well under ~50k
+ * chunks, which is ample for a single agent's memory; no external vector DB.
+ */
+export declare class VectorMemoryIndex {
+    private readonly path;
+    private readonly embeddings;
+    private readonly documentPrefix;
+    private readonly queryPrefix;
+    private readonly batchSize;
+    private records;
+    private loaded;
+    constructor(options: VectorMemoryIndexOptions);
+    /** Replaces the entire index from the supplied chunks (used by consolidation). */
+    rebuild(chunks: readonly MemoryChunk[]): Promise<{
+        readonly indexed: number;
+    }>;
+    /** Semantic search by cosine similarity. Throws if embeddings are unavailable. */
+    search(query: string, limit?: number, minScore?: number): Promise<readonly SearchHit[]>;
+    size(): Promise<number>;
+    private embedAll;
+    private ensureLoaded;
+    private persist;
+}
+export declare function createVectorMemoryIndex(options: VectorMemoryIndexOptions): VectorMemoryIndex;
+//# sourceMappingURL=vector-index.d.ts.map

package/dist/search/vector-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-index.d.ts","sourceRoot":"","sources":["../../src/search/vector-index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAqB,WAAW,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAetG;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,wBAAwB;IAW7C,kFAAkF;IAC5E,OAAO,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IASpF,kFAAkF;IAC5E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,QAAQ,SAAI,GAAG,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC;IAyB7E,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;YAKf,QAAQ;YAUR,YAAY;YA0CZ,OAAO;CAsBtB;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAE5F"}