daycare-cli 2026.2.11 → 2026.2.22

package/dist/engine/memory/infer/utils/formatHistoryMessages.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatHistoryMessages.spec.js","sourceRoot":"","sources":["../../../../../sources/engine/memory/infer/utils/formatHistoryMessages.spec.ts"],"names":[],"mappings":"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"}

package/dist/engine/memory/infer/utils/parseObservations.d.ts

@@ -0,0 +1,7 @@
+import type { InferObservation } from "../inferObservations.js";
+/**
+ * Parses XML observation response into structured observations.
+ * Expects: text contains `<observation>` tags inside an `<observations>` root.
+ */
+export declare function parseObservations(text: string): InferObservation[];
+//# sourceMappingURL=parseObservations.d.ts.map

package/dist/engine/memory/infer/utils/parseObservations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseObservations.d.ts","sourceRoot":"","sources":["../../../../../sources/engine/memory/infer/utils/parseObservations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAkBlE"}

package/dist/engine/memory/infer/utils/parseObservations.js

@@ -0,0 +1,24 @@
+import { tagExtract, tagExtractAll } from "../../../../util/tagExtract.js";
+/**
+ * Parses XML observation response into structured observations.
+ * Expects: text contains `<observation>` tags inside an `<observations>` root.
+ */
+export function parseObservations(text) {
+    return tagExtractAll(text, "observation")
+        .map((observationBlock) => {
+        const observationText = tagExtract(observationBlock, "text");
+        const observationContext = tagExtract(observationBlock, "context");
+        if (observationText === null || observationContext === null) {
+            return null;
+        }
+        if (observationText.length === 0 || observationContext.length === 0) {
+            return null;
+        }
+        return {
+            text: observationText,
+            context: observationContext
+        };
+    })
+        .filter((observation) => observation !== null);
+}
+//# sourceMappingURL=parseObservations.js.map

package/dist/engine/memory/infer/utils/parseObservations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseObservations.js","sourceRoot":"","sources":["../../../../../sources/engine/memory/infer/utils/parseObservations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG3E;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC1C,OAAO,aAAa,CAAC,IAAI,EAAE,aAAa,CAAC;SACpC,GAAG,CAAC,CAAC,gBAAgB,EAA2B,EAAE;QAC/C,MAAM,eAAe,GAAG,UAAU,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,kBAAkB,GAAG,UAAU,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;QACnE,IAAI,eAAe,KAAK,IAAI,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClE,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO;YACH,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,kBAAkB;SAC9B,CAAC;IACN,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,WAAW,EAAmC,EAAE,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC;AACxF,CAAC"}

package/dist/engine/memory/infer/utils/parseObservations.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parseObservations.spec.d.ts.map

package/dist/engine/memory/infer/utils/parseObservations.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseObservations.spec.d.ts","sourceRoot":"","sources":["../../../../../sources/engine/memory/infer/utils/parseObservations.spec.ts"],"names":[],"mappings":""}

package/dist/engine/memory/infer/utils/parseObservations.spec.js

@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vitest";
+import { parseObservations } from "./parseObservations.js";
+describe("parseObservations", () => {
+    it("parses valid observations", () => {
+        const xml = "<observations>\n<observation><text>Fact A</text><context>Ctx A</context></observation>\n<observation><text>Fact B</text><context>Ctx B</context></observation>\n</observations>";
+        expect(parseObservations(xml)).toEqual([
+            { text: "Fact A", context: "Ctx A" },
+            { text: "Fact B", context: "Ctx B" }
+        ]);
+    });
+    it("returns empty array when no tags", () => {
+        expect(parseObservations("nothing here")).toEqual([]);
+    });
+    it("skips observations with empty text or context", () => {
+        const xml = "<observations><observation><text>  </text><context>Ctx</context></observation><observation><text>Real</text><context>  </context></observation><observation><text>Kept</text><context>Useful summary</context></observation></observations>";
+        expect(parseObservations(xml)).toEqual([{ text: "Kept", context: "Useful summary" }]);
+    });
+    it("trims whitespace from text and context", () => {
+        const xml = "<observation><text>  spaced out  </text><context>  related context  </context></observation>";
+        expect(parseObservations(xml)).toEqual([{ text: "spaced out", context: "related context" }]);
+    });
+    it("handles multiline text and context", () => {
+        const xml = "<observation><text>line one\nline two</text><context>ctx one\nctx two</context></observation>";
+        expect(parseObservations(xml)).toEqual([{ text: "line one\nline two", context: "ctx one\nctx two" }]);
+    });
+    it("skips observations missing required fields", () => {
+        const xml = "<observations><observation><text>Only text</text></observation><observation><context>Only context</context></observation></observations>";
+        expect(parseObservations(xml)).toEqual([]);
+    });
+});
+//# sourceMappingURL=parseObservations.spec.js.map

package/dist/engine/memory/infer/utils/parseObservations.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseObservations.spec.js","sourceRoot":"","sources":["../../../../../sources/engine/memory/infer/utils/parseObservations.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,GAAG,GACL,iLAAiL,CAAC;QACtL,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YACnC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE;YACpC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE;SACvC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QACxC,MAAM,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACrD,MAAM,GAAG,GACL,6OAA6O,CAAC;QAClP,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAAG,8FAA8F,CAAC;QAC3G,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,GAAG,GAAG,+FAA+F,CAAC;QAC5G,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC;IAC1G,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,MAAM,GAAG,GACL,0IAA0I,CAAC;QAC/I,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/engine/memory/memory.d.ts

@@ -0,0 +1,18 @@
+import { type GraphNode, type GraphTree } from "./graph/graphTypes.js";
+export type MemoryOptions = {
+    usersDir: string;
+};
+/**
+ * Facade for user-scoped graph-memory markdown storage.
+ * Expects: usersDir points to the runtime users root.
+ */
+export declare class Memory {
+    private readonly usersDir;
+    constructor(options: MemoryOptions);
+    resolveMemoryDir(userId: string): string;
+    readGraph(userId: string): Promise<GraphTree>;
+    readNode(userId: string, nodeId: string): Promise<GraphNode | null>;
+    writeNode(userId: string, node: GraphNode): Promise<void>;
+    append(userId: string, nodeId: string, content: string): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/engine/memory/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../sources/engine/memory/memory.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE3F,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,qBAAa,MAAM;IACf,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,OAAO,EAAE,aAAa;IAIlC,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIlC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAS7C,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAsBnE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAkB/E"}

package/dist/engine/memory/memory.js

@@ -0,0 +1,71 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { graphNodeParse } from "./graph/graphNodeParse.js";
+import { graphRootNodeRead } from "./graph/graphRootNodeRead.js";
+import { graphStoreRead } from "./graph/graphStoreRead.js";
+import { graphStoreWrite } from "./graph/graphStoreWrite.js";
+import { graphTreeBuild } from "./graph/graphTreeBuild.js";
+import { GRAPH_ROOT_NODE_ID } from "./graph/graphTypes.js";
+/**
+ * Facade for user-scoped graph-memory markdown storage.
+ * Expects: usersDir points to the runtime users root.
+ */
+export class Memory {
+    usersDir;
+    constructor(options) {
+        this.usersDir = options.usersDir;
+    }
+    resolveMemoryDir(userId) {
+        return path.join(this.usersDir, userId, "memory", "graph");
+    }
+    async readGraph(userId) {
+        const memoryDir = this.resolveMemoryDir(userId);
+        await fs.mkdir(memoryDir, { recursive: true });
+        const root = await graphRootNodeRead();
+        const nodes = await graphStoreRead(memoryDir);
+        nodes.push(root);
+        return graphTreeBuild(nodes);
+    }
+    async readNode(userId, nodeId) {
+        if (nodeId === GRAPH_ROOT_NODE_ID) {
+            // Build the full tree so root.refs reflects its actual children.
+            const tree = await this.readGraph(userId);
+            const childIds = (tree.children.get(GRAPH_ROOT_NODE_ID) ?? []).map((c) => c.id);
+            return { ...tree.root, refs: childIds };
+        }
+        const memoryDir = this.resolveMemoryDir(userId);
+        const filename = `${nodeId}.md`;
+        const filePath = path.join(memoryDir, filename);
+        try {
+            const raw = await fs.readFile(filePath, "utf8");
+            return graphNodeParse(nodeId, raw);
+        }
+        catch (error) {
+            if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async writeNode(userId, node) {
+        const memoryDir = this.resolveMemoryDir(userId);
+        await graphStoreWrite(memoryDir, node);
+    }
+    async append(userId, nodeId, content) {
+        const node = await this.readNode(userId, nodeId);
+        if (!node) {
+            throw new Error(`Memory node not found: ${nodeId}`);
+        }
+        const separator = node.content.length === 0 || node.content.endsWith("\n") ? "" : "\n";
+        const updatedNode = {
+            ...node,
+            frontmatter: {
+                ...node.frontmatter,
+                updatedAt: Date.now()
+            },
+            content: `${node.content}${separator}${content}`
+        };
+        await this.writeNode(userId, updatedNode);
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/engine/memory/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../../sources/engine/memory/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAkC,MAAM,uBAAuB,CAAC;AAM3F;;;GAGG;AACH,MAAM,OAAO,MAAM;IACE,QAAQ,CAAS;IAElC,YAAY,OAAsB;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACrC,CAAC;IAED,gBAAgB,CAAC,MAAc;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,iBAAiB,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,SAAS,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,MAAc;QACzC,IAAI,MAAM,KAAK,kBAAkB,EAAE,CAAC;YAChC,iEAAiE;YACjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC1C,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAChF,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5C,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,GAAG,MAAM,KAAK,CAAC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEhD,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAChD,OAAO,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnF,OAAO,IAAI,CAAC;YAChB,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,IAAe;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,MAAc,EAAE,OAAe;QACxD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACvF,MAAM,WAAW,GAAc;YAC3B,GAAG,IAAI;YACP,WAAW,EAAE;gBACT,GAAG,IAAI,CAAC,WAAW;gBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACxB;YACD,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,SAAS,GAAG,OAAO,EAAE;SACnD,CAAC;QAEF,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9C,CAAC;CACJ"}

package/dist/engine/memory/memory.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory.spec.d.ts.map

package/dist/engine/memory/memory.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/memory/memory.spec.ts"],"names":[],"mappings":""}

package/dist/engine/memory/memory.spec.js

@@ -0,0 +1,68 @@
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { Memory } from "./memory.js";
+describe("Memory", () => {
+    let usersDir;
+    beforeEach(async () => {
+        usersDir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-memory-facade-"));
+    });
+    afterEach(async () => {
+        await fs.rm(usersDir, { recursive: true, force: true });
+    });
+    it("readGraph returns virtual root and creates graph directory", async () => {
+        const memory = new Memory({ usersDir });
+        const tree = await memory.readGraph("usr_001");
+        expect(tree.root.id).toBe("__root__");
+        expect(tree.root.content).toContain("Memory Graph");
+        const graphDir = path.join(usersDir, "usr_001", "memory", "graph");
+        const stat = await fs.stat(graphDir);
+        expect(stat.isDirectory()).toBe(true);
+    });
+    it("readNode returns virtual root with children refs populated", async () => {
+        const memory = new Memory({ usersDir });
+        const child = {
+            id: "child-1",
+            frontmatter: {
+                title: "Child",
+                description: "Child node",
+                parents: ["__root__"],
+                createdAt: 1,
+                updatedAt: 1
+            },
+            content: "body",
+            refs: []
+        };
+        await memory.writeNode("usr_001", child);
+        const root = await memory.readNode("usr_001", "__root__");
+        expect(root).not.toBeNull();
+        expect(root.id).toBe("__root__");
+        expect(root.content).toContain("Memory Graph");
+        expect(root.refs).toContain("child-1");
+    });
+    it("append updates body and updatedAt while preserving frontmatter", async () => {
+        const memory = new Memory({ usersDir });
+        const node = {
+            id: "node-1",
+            frontmatter: {
+                title: "Preference",
+                description: "User preference",
+                parents: ["__root__"],
+                createdAt: 100,
+                updatedAt: 100
+            },
+            content: "Initial line",
+            refs: []
+        };
+        await memory.writeNode("usr_001", node);
+        await memory.append("usr_001", "node-1", "Appended line");
+        const updated = await memory.readNode("usr_001", "node-1");
+        expect(updated).not.toBeNull();
+        expect(updated?.frontmatter.title).toBe("Preference");
+        expect(updated?.frontmatter.description).toBe("User preference");
+        expect(updated?.frontmatter.updatedAt).toBeGreaterThan(100);
+        expect(updated?.content).toBe("Initial line\nAppended line");
+    });
+});
+//# sourceMappingURL=memory.spec.js.map

package/dist/engine/memory/memory.spec.js.map

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

package/dist/engine/memory/memorySessionObserve.d.ts

@@ -0,0 +1,22 @@
+import type { AgentHistoryRecord } from "@/types";
+import type { ProviderSettings } from "../../settings.js";
+import type { Storage } from "../../storage/storage.js";
+import type { Context } from "../agents/context.js";
+import type { InferenceRouter } from "../modules/inference/router.js";
+import { type InferObservation } from "./infer/inferObservations.js";
+export type MemorySessionObserveOptions = {
+    sessionNumber: number;
+    ctx: Context;
+    records: AgentHistoryRecord[];
+    storage: Storage;
+    inferenceRouter: InferenceRouter;
+    providers: ProviderSettings[];
+};
+/**
+ * Observes a single invalidated session for memory extraction.
+ * Runs inference to extract observations from conversation history.
+ *
+ * Expects: ctx identifies the agent, records are the unprocessed history entries.
+ */
+export declare function memorySessionObserve(options: MemorySessionObserveOptions): Promise<InferObservation[]>;
+//# sourceMappingURL=memorySessionObserve.d.ts.map

package/dist/engine/memory/memorySessionObserve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorySessionObserve.d.ts","sourceRoot":"","sources":["../../../sources/engine/memory/memorySessionObserve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,KAAK,gBAAgB,EAAqB,MAAM,8BAA8B,CAAC;AAIxF,MAAM,MAAM,2BAA2B,GAAG;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,EAAE,gBAAgB,EAAE,CAAC;CACjC,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAiB5G"}

package/dist/engine/memory/memorySessionObserve.js

@@ -0,0 +1,21 @@
+import { getLogger } from "../../log.js";
+import { inferObservations } from "./infer/inferObservations.js";
+const logger = getLogger("engine.memory");
+/**
+ * Observes a single invalidated session for memory extraction.
+ * Runs inference to extract observations from conversation history.
+ *
+ * Expects: ctx identifies the agent, records are the unprocessed history entries.
+ */
+export async function memorySessionObserve(options) {
+    const { sessionNumber, ctx, records, inferenceRouter, providers } = options;
+    logger.debug(`event: Observing session sessionNumber=${sessionNumber} agentId=${ctx.agentId} records=${records.length}`);
+    const observations = await inferObservations({
+        records,
+        inferenceRouter,
+        providers
+    });
+    logger.debug(`event: Session observed sessionNumber=${sessionNumber} agentId=${ctx.agentId} observations=${observations.length}`);
+    return observations;
+}
+//# sourceMappingURL=memorySessionObserve.js.map

package/dist/engine/memory/memorySessionObserve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorySessionObserve.js","sourceRoot":"","sources":["../../../sources/engine/memory/memorySessionObserve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAKzC,OAAO,EAAyB,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAExF,MAAM,MAAM,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;AAW1C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAoC;IAC3E,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC5E,MAAM,CAAC,KAAK,CACR,0CAA0C,aAAa,YAAY,GAAG,CAAC,OAAO,YAAY,OAAO,CAAC,MAAM,EAAE,CAC7G,CAAC;IAEF,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC;QACzC,OAAO;QACP,eAAe;QACf,SAAS;KACZ,CAAC,CAAC;IAEH,MAAM,CAAC,KAAK,CACR,yCAAyC,aAAa,YAAY,GAAG,CAAC,OAAO,iBAAiB,YAAY,CAAC,MAAM,EAAE,CACtH,CAAC;IAEF,OAAO,YAAY,CAAC;AACxB,CAAC"}

package/dist/engine/memory/memorySessionObserve.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memorySessionObserve.spec.d.ts.map

package/dist/engine/memory/memorySessionObserve.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memorySessionObserve.spec.d.ts","sourceRoot":"","sources":["../../../sources/engine/memory/memorySessionObserve.spec.ts"],"names":[],"mappings":""}

package/dist/engine/memory/memorySessionObserve.spec.js

@@ -0,0 +1,112 @@
+import { describe, expect, it, vi } from "vitest";
+import { Storage } from "../../storage/storage.js";
+import { Context } from "../agents/context.js";
+import { memorySessionObserve } from "./memorySessionObserve.js";
+const permissions = {
+    workingDir: "/workspace",
+    writeDirs: ["/workspace"]
+};
+function mockInferenceRouter(responseText) {
+    return {
+        complete: vi.fn().mockResolvedValue({
+            message: {
+                role: "assistant",
+                content: [{ type: "text", text: responseText }],
+                api: "test",
+                provider: "test",
+                model: "test",
+                usage: {
+                    input: 0,
+                    output: 0,
+                    cacheRead: 0,
+                    cacheWrite: 0,
+                    totalTokens: 0,
+                    cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 }
+                },
+                stopReason: "stop",
+                timestamp: Date.now()
+            },
+            providerId: "test",
+            modelId: "test"
+        }),
+        reload: vi.fn()
+    };
+}
+describe("memorySessionObserve", () => {
+    it("returns observations from inference", async () => {
+        const storage = Storage.open(":memory:");
+        try {
+            const owner = (await storage.users.findMany())[0];
+            if (!owner) {
+                throw new Error("Owner user missing");
+            }
+            await storage.agents.create({
+                id: "agent-1",
+                userId: owner.id,
+                type: "cron",
+                descriptor: { type: "cron", id: "agent-1", name: "job" },
+                activeSessionId: null,
+                permissions,
+                tokens: null,
+                stats: {},
+                lifecycle: "active",
+                createdAt: 1,
+                updatedAt: 1
+            });
+            const sessionId = await storage.sessions.create({ agentId: "agent-1", createdAt: 1000 });
+            await storage.history.append(sessionId, {
+                type: "user_message",
+                at: 1001,
+                text: "Deploy to production",
+                files: []
+            });
+            const ctx = new Context("agent-1", owner.id);
+            const records = await storage.history.findBySessionId(sessionId);
+            const xml = "<observations>\n<observation><text>The person wanted to push their latest changes to production as part of the release cycle</text><context>During a release planning session, the person asked to deploy to production. They seemed confident the changes were ready and wanted to move forward quickly.</context></observation>\n</observations>";
+            const router = mockInferenceRouter(xml);
+            const observations = await memorySessionObserve({
+                sessionNumber: 1,
+                ctx,
+                records,
+                storage,
+                inferenceRouter: router,
+                providers: []
+            });
+            expect(observations).toEqual([
+                {
+                    text: "The person wanted to push their latest changes to production as part of the release cycle",
+                    context: "During a release planning session, the person asked to deploy to production. They seemed confident the changes were ready and wanted to move forward quickly."
+                }
+            ]);
+            expect(router.complete).toHaveBeenCalledOnce();
+        }
+        finally {
+            storage.close();
+        }
+    });
+    it("returns empty array when no records", async () => {
+        const storage = Storage.open(":memory:");
+        try {
+            const owner = (await storage.users.findMany())[0];
+            if (!owner) {
+                throw new Error("Owner user missing");
+            }
+            const ctx = new Context("agent-1", owner.id);
+            const router = mockInferenceRouter("<observations></observations>");
+            const observations = await memorySessionObserve({
+                sessionNumber: 1,
+                ctx,
+                records: [],
+                storage,
+                inferenceRouter: router,
+                providers: []
+            });
+            expect(observations).toEqual([]);
+            expect(router.complete).not.toHaveBeenCalled();
+        }
+        finally {
+            storage.close();
+        }
+    });
+});
+//# sourceMappingURL=memorySessionObserve.spec.js.map

package/dist/engine/memory/memorySessionObserve.spec.js.map

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

package/dist/engine/memory/memoryWorker.d.ts

@@ -0,0 +1,39 @@
+import type { Storage } from "../../storage/storage.js";
+import type { AgentDescriptor } from "../agents/ops/agentDescriptorTypes.js";
+import type { ConfigModule } from "../config/configModule.js";
+export type MemoryWorkerPostFn = (target: {
+    descriptor: AgentDescriptor;
+}, item: {
+    type: "system_message";
+    text: string;
+    origin: string;
+}) => Promise<void>;
+export type MemoryWorkerOptions = {
+    storage: Storage;
+    config: ConfigModule;
+    intervalMs?: number;
+};
+/**
+ * Timer-based worker that polls for invalidated sessions and routes them
+ * to per-agent memory-agents for observation extraction.
+ */
+export declare class MemoryWorker {
+    private readonly storage;
+    private readonly config;
+    private readonly intervalMs;
+    private postToAgent;
+    private tickTimer;
+    private started;
+    private stopped;
+    constructor(options: MemoryWorkerOptions);
+    /**
+     * Sets the posting function used to route transcripts to memory-agents.
+     * Must be called before start().
+     */
+    setPostFn(fn: MemoryWorkerPostFn): void;
+    start(): void;
+    stop(): void;
+    private scheduleNextTick;
+    private tick;
+}
+//# sourceMappingURL=memoryWorker.d.ts.map

package/dist/engine/memory/memoryWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryWorker.d.ts","sourceRoot":"","sources":["../../../sources/engine/memory/memoryWorker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAQ9D,MAAM,MAAM,kBAAkB,GAAG,CAC7B,MAAM,EAAE;IAAE,UAAU,EAAE,eAAe,CAAA;CAAE,EACvC,IAAI,EAAE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,KAC7D,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,mBAAmB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,mBAAmB;IAMxC;;;OAGG;IACH,SAAS,CAAC,EAAE,EAAE,kBAAkB,GAAG,IAAI;IAIvC,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,IAAI;IAYZ,OAAO,CAAC,gBAAgB;YAYV,IAAI;CA6ErB"}

package/dist/engine/memory/memoryWorker.js

@@ -0,0 +1,125 @@
+import { getLogger } from "../../log.js";
+import { formatHistoryMessages } from "./infer/utils/formatHistoryMessages.js";
+const logger = getLogger("engine.memory");
+const DEFAULT_INTERVAL_MS = 30_000;
+const DEFAULT_BATCH_SIZE = 10;
+/**
+ * Timer-based worker that polls for invalidated sessions and routes them
+ * to per-agent memory-agents for observation extraction.
+ */
+export class MemoryWorker {
+    storage;
+    config;
+    intervalMs;
+    postToAgent = null;
+    tickTimer = null;
+    started = false;
+    stopped = false;
+    constructor(options) {
+        this.storage = options.storage;
+        this.config = options.config;
+        this.intervalMs = options.intervalMs ?? DEFAULT_INTERVAL_MS;
+    }
+    /**
+     * Sets the posting function used to route transcripts to memory-agents.
+     * Must be called before start().
+     */
+    setPostFn(fn) {
+        this.postToAgent = fn;
+    }
+    start() {
+        if (this.started || this.stopped) {
+            return;
+        }
+        this.started = true;
+        logger.debug("start: MemoryWorker started");
+        this.scheduleNextTick();
+    }
+    stop() {
+        if (this.stopped) {
+            return;
+        }
+        this.stopped = true;
+        if (this.tickTimer) {
+            clearTimeout(this.tickTimer);
+            this.tickTimer = null;
+        }
+        logger.debug("stop: MemoryWorker stopped");
+    }
+    scheduleNextTick() {
+        if (this.stopped) {
+            return;
+        }
+        this.tickTimer = setTimeout(() => {
+            this.tickTimer = null;
+            void this.tick().catch((error) => {
+                logger.warn({ error }, "error: Memory worker tick failed");
+            });
+        }, this.intervalMs);
+    }
+    async tick() {
+        if (this.stopped) {
+            return;
+        }
+        if (!this.postToAgent) {
+            logger.warn("skip: Memory worker tick skipped — no postFn set");
+            this.scheduleNextTick();
+            return;
+        }
+        try {
+            const sessions = await this.storage.sessions.findInvalidated(DEFAULT_BATCH_SIZE);
+            if (sessions.length > 0) {
+                logger.debug(`event: Memory worker tick found ${sessions.length} invalidated session(s)`);
+            }
+            for (const session of sessions) {
+                if (this.stopped) {
+                    break;
+                }
+                const invalidatedAt = session.invalidatedAt;
+                if (invalidatedAt === null) {
+                    continue;
+                }
+                const agent = await this.storage.agents.findById(session.agentId);
+                if (!agent) {
+                    logger.warn(`event: Agent not found for session sessionId=${session.id} agentId=${session.agentId}`);
+                    continue;
+                }
+                // Skip sessions belonging to memory-agents to prevent recursion
+                if (agent.descriptor.type === "memory-agent") {
+                    await this.storage.sessions.markProcessed(session.id, invalidatedAt, invalidatedAt);
+                    continue;
+                }
+                const processedUntil = session.processedUntil ?? 0;
+                const records = await this.storage.history.findSinceId(session.id, processedUntil);
+                if (records.length === 0) {
+                    await this.storage.sessions.markProcessed(session.id, invalidatedAt, invalidatedAt);
+                    continue;
+                }
+                const transcript = formatHistoryMessages(records);
+                if (transcript.trim().length === 0) {
+                    await this.storage.sessions.markProcessed(session.id, invalidatedAt, invalidatedAt);
+                    continue;
+                }
+                const descriptor = { type: "memory-agent", id: session.agentId };
+                await this.postToAgent({ descriptor }, {
+                    type: "system_message",
+                    text: transcript,
+                    origin: `memory-worker:${session.id}`
+                });
+                const maxHistoryId = await this.storage.history.maxId(session.id);
+                const newProcessedUntil = maxHistoryId ?? invalidatedAt;
+                const cleared = await this.storage.sessions.markProcessed(session.id, newProcessedUntil, invalidatedAt);
+                if (cleared) {
+                    logger.debug(`event: Session routed to memory-agent sessionId=${session.id} processedUntil=${newProcessedUntil}`);
+                }
+                else {
+                    logger.debug(`event: Session re-invalidated during routing sessionId=${session.id}`);
+                }
+            }
+        }
+        finally {
+            this.scheduleNextTick();
+        }
+    }
+}
+//# sourceMappingURL=memoryWorker.js.map