@mono-agent/memory 0.4.1

package/dist/bujo/entities.js

@@ -0,0 +1,80 @@
+import { parseJsonLoose } from "./json.js";
+import { MemoryModelError } from "./model-error.js";
+const EMPTY = { entities: [], relations: [] };
+const PROMPT = (text) => `Extract named entities and their relations from the text below as JSON.
+Return ONLY the following JSON structure with no additional text:
+{"entities":[{"id":"type:name-kebab","name":"display name","type":"person|project|org|concept|..."}],"relations":[{"src":"entity-id","dst":"entity-id","relation":"verb phrase"}]}
+
+Rules:
+- Entity id must be a slug like "person:morgan-reberski" or "project:mono-agent"
+- Include only entities clearly mentioned in the text
+- Relations must reference entity ids present in the entities array
+- Use lowercase kebab-case for ids
+
+TEXT:
+${text}`;
+function normalizeEntity(raw) {
+    if (typeof raw !== "object" || raw === null)
+        return undefined;
+    const rec = raw;
+    const id = typeof rec.id === "string" ? rec.id.trim() : "";
+    const name = typeof rec.name === "string" ? rec.name.trim() : "";
+    if (id.length === 0 || name.length === 0)
+        return undefined;
+    const result = { id, name };
+    if (typeof rec.type === "string" && rec.type.trim().length > 0) {
+        result.type = rec.type.trim();
+    }
+    return result;
+}
+function normalizeRelation(raw, entityIds) {
+    if (typeof raw !== "object" || raw === null)
+        return undefined;
+    const rec = raw;
+    const src = typeof rec.src === "string" ? rec.src.trim() : "";
+    const dst = typeof rec.dst === "string" ? rec.dst.trim() : "";
+    const relation = typeof rec.relation === "string" ? rec.relation.trim() : "";
+    if (src.length === 0 || dst.length === 0 || relation.length === 0)
+        return undefined;
+    if (!entityIds.has(src) || !entityIds.has(dst))
+        return undefined;
+    return { src, dst, relation };
+}
+/**
+ * Use the LLM to extract named entities and their relations from `text`.
+ * Empty/whitespace text → `{entities:[], relations:[]}`.
+ * Malformed LLM *output* is handled defensively (→ EMPTY), but a model *failure* (Ollama down,
+ * timeout, 5xx) is rethrown as a {@link MemoryModelError} so it surfaces rather than looking like
+ * "no entities found".
+ */
+export async function extractEntities(text, llm) {
+    if (text.trim().length === 0)
+        return EMPTY;
+    let raw;
+    try {
+        raw = await llm.complete(PROMPT(text), { label: "capture:entities" });
+    }
+    catch (cause) {
+        throw new MemoryModelError("llm", "entities", cause);
+    }
+    const parsed = parseJsonLoose(raw);
+    if (parsed === undefined || typeof parsed !== "object" || parsed === null)
+        return EMPTY;
+    const rawEntities = Array.isArray(parsed.entities) ? parsed.entities : [];
+    const entities = [];
+    for (const item of rawEntities) {
+        const normalized = normalizeEntity(item);
+        if (normalized !== undefined)
+            entities.push(normalized);
+    }
+    const entityIds = new Set(entities.map((e) => e.id));
+    const rawRelations = Array.isArray(parsed.relations) ? parsed.relations : [];
+    const relations = [];
+    for (const item of rawRelations) {
+        const normalized = normalizeRelation(item, entityIds);
+        if (normalized !== undefined)
+            relations.push(normalized);
+    }
+    return { entities, relations };
+}
+//# sourceMappingURL=entities.js.map

package/dist/bujo/entities.js.map

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

package/dist/bujo/grammar.d.ts

@@ -0,0 +1,18 @@
+import type { MemoryStatus, MemoryType } from "../store/index.js";
+import type { Bullet } from "./types.js";
+export declare const MARKER_FOR: (type: MemoryType, status: MemoryStatus) => string;
+export declare function parseBullet(line: string): Bullet | undefined;
+export declare function serializeBullet(bullet: Bullet): string;
+export interface DailyLine {
+    readonly raw: string;
+    readonly lineNumber: number;
+    readonly bullet?: Bullet;
+}
+export interface DailyFile {
+    readonly lines: readonly DailyLine[];
+}
+export declare function parseDailyFile(content: string): DailyFile & {
+    bullets: Bullet[];
+};
+export declare function serializeDailyFile(file: DailyFile): string;
+//# sourceMappingURL=grammar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"grammar.d.ts","sourceRoot":"","sources":["../../src/bujo/grammar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAoBzC,eAAO,MAAM,UAAU,GAAI,MAAM,UAAU,EAAE,QAAQ,YAAY,KAAG,MAWnE,CAAC;AAaF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA+B5D;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAgBtD;AA2BD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA0BjF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAE1D"}

package/dist/bujo/grammar.js

@@ -0,0 +1,147 @@
+const MARKERS = {
+    "[ ]": { type: "task", status: "open" },
+    "[x]": { type: "task", status: "done" },
+    "[>]": { type: "task", status: "migrated" },
+    "[<]": { type: "task", status: "scheduled" },
+    "[~]": { type: "task", status: "dropped" },
+    "◦": { type: "event", status: "open" },
+    "–": { type: "note", status: "open" },
+};
+const STATUS_MARKER = {
+    done: "[x]",
+    migrated: "[>]",
+    scheduled: "[<]",
+    dropped: "[~]",
+    invalidated: "[~]", // rendered struck like dropped; the comment metadata stays authoritative for the real status
+};
+export const MARKER_FOR = (type, status) => {
+    // For task-style statuses (done/migrated/scheduled/dropped), the visible marker encodes status.
+    const statusMarker = STATUS_MARKER[status];
+    if (statusMarker !== undefined)
+        return statusMarker;
+    // For open status, use the type-specific marker.
+    for (const [marker, m] of Object.entries(MARKERS)) {
+        if (m.type === type && m.status === status)
+            return marker;
+    }
+    // notes/events that have no direct marker fall back to the base marker
+    if (type === "event")
+        return "◦";
+    return "–";
+};
+// Allowed enum members (must mirror the SQLite CHECK constraints in ../store/index.js).
+// A malformed daily line (`type=bogus`, `status=invalid`) must NOT produce an out-of-enum Bullet,
+// or rebuild/upsert would fail the CHECK constraint.
+const VALID_TYPES = new Set(["task", "event", "note"]);
+const VALID_STATUSES = new Set(["open", "done", "scheduled", "migrated", "dropped", "invalidated"]);
+const BULLET_MARKER = String.raw `(\[[ x><~]\]|◦|–)`;
+const LEGACY_LINE_RE = new RegExp(`^- ${BULLET_MARKER} (.*?)  <!--mem (.*)-->$`, "u");
+const VISIBLE_LINE_RE = new RegExp(`^- ${BULLET_MARKER} (.*?)$`, "u");
+const META_LINE_RE = /^\s+<!--mem (.*)-->$/u;
+export function parseBullet(line) {
+    const match = parseBulletParts(line);
+    if (match === undefined)
+        return undefined;
+    const [, marker, text, meta] = match;
+    const fields = parseMeta(meta ?? "");
+    const base = MARKERS[marker ?? ""];
+    if (base === undefined)
+        return undefined;
+    // Validate enum membership before trusting metadata; an empty OR invalid value (e.g. `status=` or
+    // `status=bogus`) falls back to the marker-derived base value rather than corrupting the Bullet.
+    const status = (VALID_STATUSES.has(fields.status ?? "") ? fields.status : undefined) ?? base.status;
+    const type = (VALID_TYPES.has(fields.type ?? "") ? fields.type : undefined) ?? base.type;
+    // A bullet needs a stable id, a created timestamp, and non-empty text. Missing/blank values (e.g.
+    // `id=` or `created=`) would yield id="" — a primary-key collision on rebuild and impossible to
+    // rewrite-by-id. Treat such malformed lines as non-bullets rather than corrupting the index.
+    const id = (fields.id ?? "").trim();
+    const createdAt = (fields.created ?? "").trim();
+    const bulletText = (text ?? "").trim();
+    if (id === "" || createdAt === "" || bulletText === "")
+        return undefined;
+    const salienceNum = Number(fields.salience);
+    const bullet = {
+        id,
+        type,
+        status,
+        text: bulletText,
+        salience: fields.salience !== undefined && Number.isFinite(salienceNum) ? salienceNum : 0.5,
+        isInsight: fields.isInsight === "1",
+        createdAt,
+        refs: fields.refs === undefined || fields.refs.length === 0 ? [] : fields.refs.split(","),
+        ...(fields.due !== undefined ? { dueAt: fields.due } : {}),
+    };
+    return bullet;
+}
+export function serializeBullet(bullet) {
+    if (bullet.text.includes("\n") || bullet.text.includes("<!--mem")) {
+        throw new Error("memory-bujo: bullet text must not contain a newline or the '<!--mem' delimiter.");
+    }
+    const marker = MARKER_FOR(bullet.type, bullet.status);
+    const meta = [
+        `id=${bullet.id}`,
+        `type=${bullet.type}`,
+        `status=${bullet.status}`,
+        `salience=${bullet.salience}`,
+        `isInsight=${bullet.isInsight ? "1" : "0"}`,
+        `created=${bullet.createdAt}`,
+        `refs=${bullet.refs.join(",")}`,
+        ...(bullet.dueAt === undefined ? [] : [`due=${bullet.dueAt}`]),
+    ].join(" ");
+    return `- ${marker} ${bullet.text}\n  <!--mem ${meta}-->`;
+}
+function parseBulletParts(line) {
+    const legacy = LEGACY_LINE_RE.exec(line);
+    if (legacy !== null)
+        return legacy;
+    const split = line.split("\n");
+    if (split.length !== 2)
+        return undefined;
+    const visible = VISIBLE_LINE_RE.exec(split[0] ?? "");
+    const meta = META_LINE_RE.exec(split[1] ?? "");
+    if (visible === null || meta === null)
+        return undefined;
+    const out = [line, visible[1] ?? "", visible[2] ?? "", meta[1] ?? ""];
+    out.index = 0;
+    out.input = line;
+    return out;
+}
+function parseMeta(meta) {
+    const out = {};
+    for (const pair of meta.trim().split(/\s+/u)) {
+        const eq = pair.indexOf("=");
+        if (eq === -1)
+            continue;
+        out[pair.slice(0, eq)] = pair.slice(eq + 1);
+    }
+    return out;
+}
+export function parseDailyFile(content) {
+    const rawLines = content.split("\n");
+    const lines = [];
+    for (let i = 0; i < rawLines.length; i += 1) {
+        const raw = rawLines[i] ?? "";
+        const lineNumber = i + 1;
+        const bullet = parseBullet(raw);
+        if (bullet !== undefined) {
+            lines.push({ raw, lineNumber, bullet });
+            continue;
+        }
+        const next = rawLines[i + 1];
+        if (next !== undefined) {
+            const splitRaw = `${raw}\n${next}`;
+            const splitBullet = parseBullet(splitRaw);
+            if (splitBullet !== undefined) {
+                lines.push({ raw: splitRaw, lineNumber, bullet: splitBullet });
+                i += 1;
+                continue;
+            }
+        }
+        lines.push({ raw, lineNumber });
+    }
+    return { lines, bullets: lines.flatMap((l) => (l.bullet ? [l.bullet] : [])) };
+}
+export function serializeDailyFile(file) {
+    return file.lines.map((l) => (l.bullet ? serializeBullet(l.bullet) : l.raw)).join("\n");
+}
+//# sourceMappingURL=grammar.js.map

package/dist/bujo/grammar.js.map

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

package/dist/bujo/graph.d.ts

@@ -0,0 +1,17 @@
+import type { EntityRecord, EntityRelationRecord } from "../store/index.js";
+/**
+ * Read the canonical graph.jsonl at `<root>/graph.jsonl`.
+ * Missing file → `{entities:[], relations:[]}`.
+ * Malformed lines are skipped defensively (never throws).
+ * Dedupes on read: entities by `id` keeping the LAST occurrence;
+ * relations by `src|dst|relation` keeping the last.
+ */
+export declare function readGraph(root: string): {
+    entities: EntityRecord[];
+    relations: EntityRelationRecord[];
+};
+/** Append a single entity record to `<root>/graph.jsonl` (mkdir root if needed). */
+export declare function appendEntity(root: string, record: EntityRecord): void;
+/** Append a single relation record to `<root>/graph.jsonl` (mkdir root if needed). */
+export declare function appendRelation(root: string, record: EntityRelationRecord): void;
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/bujo/graph.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAY5E;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IAAC,SAAS,EAAE,oBAAoB,EAAE,CAAA;CAAE,CA4CvG;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CASrE;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAa/E"}

package/dist/bujo/graph.js

@@ -0,0 +1,96 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const GRAPH_FILE = "graph.jsonl";
+function graphPath(root) {
+    return join(root, GRAPH_FILE);
+}
+/**
+ * Read the canonical graph.jsonl at `<root>/graph.jsonl`.
+ * Missing file → `{entities:[], relations:[]}`.
+ * Malformed lines are skipped defensively (never throws).
+ * Dedupes on read: entities by `id` keeping the LAST occurrence;
+ * relations by `src|dst|relation` keeping the last.
+ */
+export function readGraph(root) {
+    const path = graphPath(root);
+    if (!existsSync(path))
+        return { entities: [], relations: [] };
+    const raw = readFileSync(path, "utf8");
+    const entityMap = new Map();
+    const relationMap = new Map();
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch {
+            // skip malformed lines
+            continue;
+        }
+        if (typeof parsed !== "object" || parsed === null)
+            continue;
+        const rec = parsed;
+        if (rec["kind"] === "entity") {
+            const { kind: _kind, ...rest } = rec;
+            const entity = rest;
+            if (typeof entity.id === "string" && entity.id.length > 0) {
+                entityMap.set(entity.id, entity);
+            }
+        }
+        else if (rec["kind"] === "relation") {
+            const { kind: _kind, ...rest } = rec;
+            const relation = rest;
+            if (typeof relation.src === "string" &&
+                typeof relation.dst === "string" &&
+                typeof relation.relation === "string") {
+                const key = `${relation.src}|${relation.dst}|${relation.relation}`;
+                relationMap.set(key, relation);
+            }
+        }
+    }
+    return {
+        entities: Array.from(entityMap.values()),
+        relations: Array.from(relationMap.values()),
+    };
+}
+/** Append a single entity record to `<root>/graph.jsonl` (mkdir root if needed). */
+export function appendEntity(root, record) {
+    const current = readGraph(root).entities.find((entity) => entity.id === record.id);
+    const recordToAppend = current === undefined ? record : mergeEntityRecord(current, record);
+    if (current !== undefined && entityRecordsEqual(current, recordToAppend)) {
+        return;
+    }
+    mkdirSync(root, { recursive: true });
+    const line = { kind: "entity", ...recordToAppend };
+    appendFileSync(graphPath(root), `${JSON.stringify(line)}\n`, "utf8");
+}
+/** Append a single relation record to `<root>/graph.jsonl` (mkdir root if needed). */
+export function appendRelation(root, record) {
+    const exists = readGraph(root).relations.some((relation) => relation.src === record.src &&
+        relation.dst === record.dst &&
+        relation.relation === record.relation);
+    if (exists) {
+        return;
+    }
+    mkdirSync(root, { recursive: true });
+    const line = { kind: "relation", ...record };
+    appendFileSync(graphPath(root), `${JSON.stringify(line)}\n`, "utf8");
+}
+function entityRecordsEqual(a, b) {
+    return (a.id === b.id &&
+        a.name === b.name &&
+        a.type === b.type &&
+        a.summary === b.summary);
+}
+function mergeEntityRecord(current, next) {
+    return {
+        ...next,
+        ...(next.type === undefined && current.type !== undefined ? { type: current.type } : {}),
+        ...(next.summary === undefined && current.summary !== undefined ? { summary: current.summary } : {}),
+        ...(next.updatedAt === undefined && current.updatedAt !== undefined ? { updatedAt: current.updatedAt } : {}),
+    };
+}
+//# sourceMappingURL=graph.js.map

package/dist/bujo/graph.js.map

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

package/dist/bujo/ids.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Minimal ULID-style id: a millisecond timestamp encoded as 10 Crockford base32 chars
+ * (50-bit capacity, monotonically sortable) + a 16-char random suffix. Injectable for tests.
+ */
+export declare function createIdFactory(options?: {
+    clock?: () => Date;
+    random?: () => number;
+}): () => string;
+//# sourceMappingURL=ids.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/bujo/ids.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GAAG,MAAM,MAAM,CAgBzG"}

package/dist/bujo/ids.js

@@ -0,0 +1,23 @@
+const ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ"; // Crockford base32
+/**
+ * Minimal ULID-style id: a millisecond timestamp encoded as 10 Crockford base32 chars
+ * (50-bit capacity, monotonically sortable) + a 16-char random suffix. Injectable for tests.
+ */
+export function createIdFactory(options = {}) {
+    const clock = options.clock ?? (() => new Date());
+    const random = options.random ?? Math.random;
+    return () => {
+        let time = clock().getTime();
+        const timeChars = [];
+        for (let i = 0; i < 10; i += 1) {
+            timeChars.unshift(ENCODING[time % 32] ?? "0");
+            time = Math.floor(time / 32);
+        }
+        let suffix = "";
+        for (let i = 0; i < 16; i += 1) {
+            suffix += ENCODING[Math.floor(random() * 32)] ?? "0";
+        }
+        return timeChars.join("") + suffix;
+    };
+}
+//# sourceMappingURL=ids.js.map

package/dist/bujo/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/bujo/ids.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,kCAAkC,CAAC,CAAC,mBAAmB;AAExE;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,UAAyD,EAAE;IACzF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IAC7C,OAAO,GAAG,EAAE;QACV,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAa,EAAE,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC;YAC9C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,GAAG,CAAC;QACvD,CAAC;QACD,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC;IACrC,CAAC,CAAC;AACJ,CAAC"}

package/dist/bujo/index.d.ts

@@ -0,0 +1,26 @@
+export { createBujoMemoryStore, BujoMemoryStore } from "./store.js";
+export { composeRecallBlock } from "./recall.js";
+export { rebuildFromMarkdown } from "./rebuild.js";
+export { parseBullet, serializeBullet, parseDailyFile, serializeDailyFile } from "./grammar.js";
+export { appendBullet, dailyFilePath } from "./daily.js";
+export { createIdFactory } from "./ids.js";
+export type { Bullet, BujoOptions, BujoTier } from "./types.js";
+export type { LlmComplete, LlmCompleteOptions } from "./llm.js";
+export { MemoryModelError } from "./model-error.js";
+export type { MemoryModelKind } from "./model-error.js";
+export { captureTurn } from "./capture.js";
+export type { CaptureTurnResult } from "./capture.js";
+export { distill } from "./distill.js";
+export type { CandidateMemory } from "./distill.js";
+export { reconcile } from "./reconcile.js";
+export type { ReconcileAction, ReconcileDeps } from "./reconcile.js";
+export { extractEntities } from "./entities.js";
+export type { Extraction, ExtractedEntity, ExtractedRelation } from "./entities.js";
+export { readGraph } from "./graph.js";
+export { createOllamaLlm } from "./ollama-llm.js";
+export { reflect } from "./reflect.js";
+export type { ReflectDeps, ReflectResult } from "./reflect.js";
+export { migrate } from "./migrate.js";
+export type { MigrateDeps, MigrateResult } from "./migrate.js";
+export { writeFutureLog, writeIndex } from "./projections.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bujo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/bujo/index.js

@@ -0,0 +1,20 @@
+export { createBujoMemoryStore, BujoMemoryStore } from "./store.js";
+export { composeRecallBlock } from "./recall.js";
+export { rebuildFromMarkdown } from "./rebuild.js";
+export { parseBullet, serializeBullet, parseDailyFile, serializeDailyFile } from "./grammar.js";
+export { appendBullet, dailyFilePath } from "./daily.js";
+export { createIdFactory } from "./ids.js";
+export { MemoryModelError } from "./model-error.js";
+// Phase 2 capture pipeline
+export { captureTurn } from "./capture.js";
+export { distill } from "./distill.js";
+export { reconcile } from "./reconcile.js";
+export { extractEntities } from "./entities.js";
+export { readGraph } from "./graph.js";
+// Phase 4 built-in LLM adapter
+export { createOllamaLlm } from "./ollama-llm.js";
+// Phase 3 rituals
+export { reflect } from "./reflect.js";
+export { migrate } from "./migrate.js";
+export { writeFutureLog, writeIndex } from "./projections.js";
+//# sourceMappingURL=index.js.map

package/dist/bujo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bujo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,2BAA2B;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,+BAA+B;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,kBAAkB;AAClB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/bujo/json.d.ts

@@ -0,0 +1,3 @@
+/** Extract the first top-level JSON value (object or array) from an LLM completion, tolerating prose/code fences. */
+export declare function parseJsonLoose<T>(text: string): T | undefined;
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/bujo/json.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAsB7D"}

package/dist/bujo/json.js

@@ -0,0 +1,58 @@
+/** Extract the first top-level JSON value (object or array) from an LLM completion, tolerating prose/code fences. */
+export function parseJsonLoose(text) {
+    const fenced = text.match(/```(?:json)?\s*([\s\S]*?)```/u);
+    const body = fenced?.[1] ?? text;
+    // Scan EVERY bracket-like start, not just the first: prose, markdown citations (`[1]`), or
+    // pseudocode can put a stray `[`/`{` ahead of the real payload. Keep the LARGEST value that
+    // actually parses, so a trivial "[1]" citation loses to the real object/array later on.
+    let best;
+    for (let i = 0; i < body.length; i += 1) {
+        const open = body[i];
+        if (open !== "[" && open !== "{")
+            continue;
+        const end = matchingClose(body, i, open);
+        if (end === -1)
+            continue;
+        const slice = body.slice(i, end + 1);
+        try {
+            const value = JSON.parse(slice);
+            if (best === undefined || slice.length > best.len)
+                best = { value, len: slice.length };
+            i = end; // this span parsed — skip the nested brackets it already covers
+        }
+        catch {
+            // Not valid JSON at this position; try the next bracket.
+        }
+    }
+    return best?.value;
+}
+/** Index of the bracket closing `body[start]` (an `[` or `{`), respecting strings/escapes; -1 if unbalanced. */
+function matchingClose(body, start, open) {
+    const close = open === "[" ? "]" : "}";
+    let depth = 0, inStr = false, esc = false;
+    for (let i = start; i < body.length; i += 1) {
+        const ch = body[i];
+        if (ch === undefined)
+            break;
+        if (inStr) {
+            if (esc)
+                esc = false;
+            else if (ch === "\\")
+                esc = true;
+            else if (ch === '"')
+                inStr = false;
+            continue;
+        }
+        if (ch === '"')
+            inStr = true;
+        else if (ch === open)
+            depth += 1;
+        else if (ch === close) {
+            depth -= 1;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+//# sourceMappingURL=json.js.map

package/dist/bujo/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/bujo/json.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,MAAM,UAAU,cAAc,CAAI,IAAY;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACjC,2FAA2F;IAC3F,4FAA4F;IAC5F,wFAAwF;IACxF,IAAI,IAAiD,CAAC;IACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG;YAAE,SAAS;QAC3C,MAAM,GAAG,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,SAAS;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAY,CAAC;YAC3C,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG;gBAAE,IAAI,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;YACvF,CAAC,GAAG,GAAG,CAAC,CAAC,gEAAgE;QAC3E,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,EAAE,KAAsB,CAAC;AACtC,CAAC;AAED,gHAAgH;AAChH,SAAS,aAAa,CAAC,IAAY,EAAE,KAAa,EAAE,IAAe;IACjE,MAAM,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACvC,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,GAAG,GAAG,KAAK,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,EAAE,KAAK,SAAS;YAAE,MAAM;QAC5B,IAAI,KAAK,EAAE,CAAC;YAAC,IAAI,GAAG;gBAAE,GAAG,GAAG,KAAK,CAAC;iBAAM,IAAI,EAAE,KAAK,IAAI;gBAAE,GAAG,GAAG,IAAI,CAAC;iBAAM,IAAI,EAAE,KAAK,GAAG;gBAAE,KAAK,GAAG,KAAK,CAAC;YAAC,SAAS;QAAC,CAAC;QACpH,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,GAAG,IAAI,CAAC;aAAM,IAAI,EAAE,KAAK,IAAI;YAAE,KAAK,IAAI,CAAC,CAAC;aAAM,IAAI,EAAE,KAAK,KAAK,EAAE,CAAC;YAAC,KAAK,IAAI,CAAC,CAAC;YAAC,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;QAAC,CAAC;IACnI,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC"}

package/dist/bujo/llm.d.ts

@@ -0,0 +1,14 @@
+/** Per-call hints for a completion. `label` tags the ritual (e.g. "capture:distill") so a recording host can group/name the run. */
+export interface LlmCompleteOptions {
+    readonly label?: string;
+}
+/** Minimal injected LLM completion surface. Implementations adapt the host runtime (P4); tests use a fake. */
+export interface LlmComplete {
+    readonly id: string;
+    /**
+     * Returns the model's text completion for the prompt. The optional `opts.label`
+     * is an advisory ritual tag; implementations that don't record may ignore it.
+     */
+    complete(prompt: string, opts?: LlmCompleteOptions): Promise<string>;
+}
+//# sourceMappingURL=llm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm.d.ts","sourceRoot":"","sources":["../../src/bujo/llm.ts"],"names":[],"mappings":"AAAA,oIAAoI;AACpI,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,8GAA8G;AAC9G,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtE"}

package/dist/bujo/llm.js

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

package/dist/bujo/llm.js.map

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

package/dist/bujo/migrate.d.ts

@@ -0,0 +1,12 @@
+import type { ReflectDeps } from "./reflect.js";
+export type MigrateDeps = ReflectDeps;
+export interface MigrateResult {
+    readonly promoted: number;
+    readonly rescheduled: number;
+    readonly clustered: number;
+    readonly forgotten: number;
+    readonly reviewed: number;
+}
+/** Monthly BuJo migration ritual: review aging open memories and apply LLM decisions. */
+export declare function migrate(deps: MigrateDeps): Promise<MigrateResult>;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../src/bujo/migrate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AA4BD,yFAAyF;AACzF,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAmHvE"}