daycare-cli 2026.2.12 → 2026.2.23

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

@@ -0,0 +1,57 @@
+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 { graphNodeSerialize } from "./graphNodeSerialize.js";
+import { graphStoreRead } from "./graphStoreRead.js";
+describe("graphStoreRead", () => {
+    let memoryDir;
+    beforeEach(async () => {
+        memoryDir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-graph-store-read-"));
+    });
+    afterEach(async () => {
+        await fs.rm(memoryDir, { recursive: true, force: true });
+    });
+    it("reads and parses all markdown graph files", async () => {
+        const rootNode = {
+            id: "__root__",
+            frontmatter: {
+                title: "Memory Summary",
+                description: "Root",
+                parents: [],
+                createdAt: 1,
+                updatedAt: 1
+            },
+            content: "# Memory Summary",
+            refs: ["node-1"]
+        };
+        const childNode = {
+            id: "node-1",
+            frontmatter: {
+                title: "Node 1",
+                description: "Child",
+                parents: ["__root__"],
+                createdAt: 2,
+                updatedAt: 3
+            },
+            content: "Child body",
+            refs: []
+        };
+        await fs.writeFile(path.join(memoryDir, "__root__.md"), graphNodeSerialize(rootNode), "utf8");
+        await fs.writeFile(path.join(memoryDir, "node-1.md"), graphNodeSerialize(childNode), "utf8");
+        await fs.writeFile(path.join(memoryDir, "ignore.txt"), "not markdown", "utf8");
+        const nodes = await graphStoreRead(memoryDir);
+        expect(nodes).toHaveLength(2);
+        expect(nodes[0]?.id).toBe("__root__");
+        expect(nodes[1]?.id).toBe("node-1");
+        expect(nodes[0]?.refs).toEqual(["node-1"]);
+        expect(nodes[1]?.frontmatter.parents).toEqual(["__root__"]);
+        expect(nodes[1]?.frontmatter.title).toBe("Node 1");
+    });
+    it("returns empty array when memory dir does not exist", async () => {
+        const missingDir = path.join(memoryDir, "missing");
+        const nodes = await graphStoreRead(missingDir);
+        expect(nodes).toEqual([]);
+    });
+});
+//# sourceMappingURL=graphStoreRead.spec.js.map

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

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

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

@@ -0,0 +1,7 @@
+import { type GraphNode } from "./graphTypes.js";
+/**
+ * Writes a single graph node markdown file to disk.
+ * Expects: non-root ids are stable and safe to use as filenames. Root node is virtual and cannot be written.
+ */
+export declare function graphStoreWrite(memoryDir: string, node: GraphNode): Promise<void>;
+//# sourceMappingURL=graphStoreWrite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphStoreWrite.d.ts","sourceRoot":"","sources":["../../../../sources/engine/memory/graph/graphStoreWrite.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;GAGG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvF"}

package/dist/engine/memory/graph/graphStoreWrite.js

@@ -0,0 +1,18 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { graphNodeSerialize } from "./graphNodeSerialize.js";
+import { GRAPH_ROOT_NODE_ID } from "./graphTypes.js";
+/**
+ * Writes a single graph node markdown file to disk.
+ * Expects: non-root ids are stable and safe to use as filenames. Root node is virtual and cannot be written.
+ */
+export async function graphStoreWrite(memoryDir, node) {
+    if (node.id === GRAPH_ROOT_NODE_ID) {
+        throw new Error("Root node is virtual and cannot be written to disk.");
+    }
+    await fs.mkdir(memoryDir, { recursive: true });
+    const filePath = path.join(memoryDir, `${node.id}.md`);
+    const serialized = graphNodeSerialize(node);
+    await fs.writeFile(filePath, serialized, "utf8");
+}
+//# sourceMappingURL=graphStoreWrite.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphStoreWrite.js","sourceRoot":"","sources":["../../../../sources/engine/memory/graph/graphStoreWrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAkB,MAAM,iBAAiB,CAAC;AAErE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,IAAe;IACpE,IAAI,IAAI,CAAC,EAAE,KAAK,kBAAkB,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC"}

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

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

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

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

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

@@ -0,0 +1,50 @@
+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 { graphStoreWrite } from "./graphStoreWrite.js";
+describe("graphStoreWrite", () => {
+    let memoryDir;
+    beforeEach(async () => {
+        memoryDir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-graph-store-write-"));
+    });
+    afterEach(async () => {
+        await fs.rm(memoryDir, { recursive: true, force: true });
+    });
+    it("rejects writing the root node", async () => {
+        const node = {
+            id: "__root__",
+            frontmatter: {
+                title: "Memory Summary",
+                description: "Root",
+                parents: [],
+                createdAt: 1,
+                updatedAt: 1
+            },
+            content: "# Memory Summary",
+            refs: []
+        };
+        await expect(graphStoreWrite(memoryDir, node)).rejects.toThrow("virtual");
+    });
+    it("writes non-root node to <id>.md", async () => {
+        const node = {
+            id: "abc123",
+            frontmatter: {
+                title: "Node",
+                description: "Desc",
+                parents: ["__root__"],
+                createdAt: 1,
+                updatedAt: 2
+            },
+            content: "Body",
+            refs: []
+        };
+        await graphStoreWrite(memoryDir, node);
+        const filePath = path.join(memoryDir, "abc123.md");
+        const content = await fs.readFile(filePath, "utf8");
+        expect(content).toContain("title: Node");
+        expect(content).toContain("parents:");
+        expect(content).toContain("Body");
+    });
+});
+//# sourceMappingURL=graphStoreWrite.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphStoreWrite.spec.js","sourceRoot":"","sources":["../../../../sources/engine/memory/graph/graphStoreWrite.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC7B,IAAI,SAAiB,CAAC;IAEtB,UAAU,CAAC,KAAK,IAAI,EAAE;QAClB,SAAS,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,IAAI,GAAc;YACpB,EAAE,EAAE,UAAU;YACd,WAAW,EAAE;gBACT,KAAK,EAAE,gBAAgB;gBACvB,WAAW,EAAE,MAAM;gBACnB,OAAO,EAAE,EAAE;gBACX,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,CAAC;aACf;YACD,OAAO,EAAE,kBAAkB;YAC3B,IAAI,EAAE,EAAE;SACX,CAAC;QAEF,MAAM,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,IAAI,GAAc;YACpB,EAAE,EAAE,QAAQ;YACZ,WAAW,EAAE;gBACT,KAAK,EAAE,MAAM;gBACb,WAAW,EAAE,MAAM;gBACnB,OAAO,EAAE,CAAC,UAAU,CAAC;gBACrB,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,CAAC;aACf;YACD,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,EAAE;SACX,CAAC;QAEF,MAAM,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACzC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+import { type GraphNode, type GraphTree } from "./graphTypes.js";
+/**
+ * Projects graph nodes into a root + parent/children map for UI traversal.
+ * Hierarchy is determined by frontmatter.parents on each child node.
+ * Nodes with no valid parent are attached to root.
+ * Expects: node ids are unique; root node id is `__root__` when present.
+ */
+export declare function graphTreeBuild(nodes: GraphNode[]): GraphTree;
+//# sourceMappingURL=graphTreeBuild.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphTreeBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/memory/graph/graphTreeBuild.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAErF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,SAAS,CAwF5D"}

package/dist/engine/memory/graph/graphTreeBuild.js

@@ -0,0 +1,85 @@
+import { GRAPH_ROOT_NODE_ID } from "./graphTypes.js";
+/**
+ * Projects graph nodes into a root + parent/children map for UI traversal.
+ * Hierarchy is determined by frontmatter.parents on each child node.
+ * Nodes with no valid parent are attached to root.
+ * Expects: node ids are unique; root node id is `__root__` when present.
+ */
+export function graphTreeBuild(nodes) {
+    const nodeById = new Map();
+    for (const node of nodes) {
+        nodeById.set(node.id, node);
+    }
+    const root = nodeById.get(GRAPH_ROOT_NODE_ID) ??
+        {
+            id: GRAPH_ROOT_NODE_ID,
+            frontmatter: {
+                title: "Memory Summary",
+                description: "Structured summary of all memories",
+                parents: [],
+                createdAt: 0,
+                updatedAt: 0
+            },
+            content: "",
+            refs: []
+        };
+    nodeById.set(root.id, root);
+    const children = new Map();
+    const edges = new Set();
+    const link = (parentId, childNode) => {
+        const edgeKey = `${parentId}->${childNode.id}`;
+        if (edges.has(edgeKey)) {
+            return;
+        }
+        edges.add(edgeKey);
+        const siblings = children.get(parentId) ?? [];
+        siblings.push(childNode);
+        children.set(parentId, siblings);
+    };
+    // Build hierarchy from child.parents.
+    for (const node of nodeById.values()) {
+        if (node.id === root.id) {
+            continue;
+        }
+        let linked = false;
+        for (const parentId of node.frontmatter.parents) {
+            if (parentId === node.id) {
+                continue;
+            }
+            if (parentId === root.id) {
+                link(root.id, node);
+                linked = true;
+                continue;
+            }
+            const parentNode = nodeById.get(parentId);
+            if (!parentNode) {
+                continue;
+            }
+            link(parentNode.id, node);
+            linked = true;
+        }
+        if (!linked) {
+            link(root.id, node);
+        }
+    }
+    const sortedChildren = new Map();
+    for (const [parentId, childNodes] of children.entries()) {
+        const sorted = [...childNodes].sort((left, right) => {
+            const leftTitle = left.frontmatter.title.toLowerCase();
+            const rightTitle = right.frontmatter.title.toLowerCase();
+            if (leftTitle === rightTitle) {
+                return left.id.localeCompare(right.id);
+            }
+            return leftTitle.localeCompare(rightTitle);
+        });
+        sortedChildren.set(parentId, sorted);
+    }
+    if (!sortedChildren.has(root.id)) {
+        sortedChildren.set(root.id, []);
+    }
+    return {
+        root,
+        children: sortedChildren
+    };
+}
+//# sourceMappingURL=graphTreeBuild.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,46 @@
+import { describe, expect, it } from "vitest";
+import { graphTreeBuild } from "./graphTreeBuild.js";
+function nodeCreate(input) {
+    return {
+        id: input.id,
+        frontmatter: {
+            title: input.title,
+            description: `${input.title} description`,
+            parents: input.parents ?? ["__root__"],
+            createdAt: 1,
+            updatedAt: 1
+        },
+        content: "",
+        refs: input.refs ?? []
+    };
+}
+describe("graphTreeBuild", () => {
+    it("builds tree from frontmatter parents", () => {
+        const root = nodeCreate({ id: "__root__", title: "Memory Summary", parents: [] });
+        const prefs = nodeCreate({ id: "prefs", title: "Preferences", parents: ["__root__"] });
+        const darkMode = nodeCreate({ id: "dark-mode", title: "Dark mode", parents: ["prefs"] });
+        const tree = graphTreeBuild([root, prefs, darkMode]);
+        const rootChildren = tree.children.get("__root__") ?? [];
+        expect(rootChildren.map((c) => c.id)).toEqual(["prefs"]);
+        const prefsChildren = tree.children.get("prefs") ?? [];
+        expect(prefsChildren.map((c) => c.id)).toEqual(["dark-mode"]);
+    });
+    it("supports multiple parents for one node", () => {
+        const root = nodeCreate({ id: "__root__", title: "Memory Summary", parents: [] });
+        const source = nodeCreate({ id: "source", title: "Source", parents: ["__root__"] });
+        const target = nodeCreate({ id: "target", title: "Target", parents: ["source", "__root__"] });
+        const tree = graphTreeBuild([root, source, target]);
+        const sourceChildren = tree.children.get("source") ?? [];
+        const rootChildren = tree.children.get("__root__") ?? [];
+        expect(sourceChildren.map((child) => child.id)).toContain("target");
+        expect(rootChildren.map((child) => child.id)).toContain("target");
+    });
+    it("attaches nodes with unknown parents to root", () => {
+        const root = nodeCreate({ id: "__root__", title: "Memory Summary", parents: [] });
+        const orphan = nodeCreate({ id: "orphan", title: "Orphan", parents: ["missing-parent"] });
+        const tree = graphTreeBuild([root, orphan]);
+        const rootChildren = tree.children.get("__root__") ?? [];
+        expect(rootChildren.map((child) => child.id)).toContain("orphan");
+    });
+});
+//# sourceMappingURL=graphTreeBuild.spec.js.map

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

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

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

@@ -0,0 +1,19 @@
+export type GraphNodeFrontmatter = {
+    title: string;
+    description: string;
+    parents: string[];
+    createdAt: number;
+    updatedAt: number;
+};
+export type GraphNode = {
+    id: string;
+    frontmatter: GraphNodeFrontmatter;
+    content: string;
+    refs: string[];
+};
+export type GraphTree = {
+    root: GraphNode;
+    children: Map<string, GraphNode[]>;
+};
+export declare const GRAPH_ROOT_NODE_ID = "__root__";
+//# sourceMappingURL=graphTypes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphTypes.d.ts","sourceRoot":"","sources":["../../../../sources/engine/memory/graph/graphTypes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,oBAAoB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;CACtC,CAAC;AAEF,eAAO,MAAM,kBAAkB,aAAa,CAAC"}

package/dist/engine/memory/graph/graphTypes.js

@@ -0,0 +1,2 @@
+export const GRAPH_ROOT_NODE_ID = "__root__";
+//# sourceMappingURL=graphTypes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphTypes.js","sourceRoot":"","sources":["../../../../sources/engine/memory/graph/graphTypes.ts"],"names":[],"mappings":"AAoBA,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { AgentHistoryRecord } from "@/types";
+import type { ProviderSettings } from "../../../settings.js";
+import type { InferenceRouter } from "../../modules/inference/router.js";
+export type InferObservation = {
+    text: string;
+    context: string;
+};
+export type InferObservationsOptions = {
+    records: AgentHistoryRecord[];
+    inferenceRouter: InferenceRouter;
+    providers: ProviderSettings[];
+    signal?: AbortSignal;
+    isForeground?: boolean;
+};
+/**
+ * Runs inference on conversation history to extract observations worth persisting.
+ * When isForeground is false, the OBSERVE.md prompt is adjusted for background agent context.
+ *
+ * Expects: records from a single session, at least one provider available.
+ */
+export declare function inferObservations(options: InferObservationsOptions): Promise<InferObservation[]>;
+//# sourceMappingURL=inferObservations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inferObservations.d.ts","sourceRoot":"","sources":["../../../../sources/engine/memory/infer/inferObservations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAIlD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAMzE,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACnC,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,EAAE,gBAAgB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAqEtG"}

package/dist/engine/memory/infer/inferObservations.js

@@ -0,0 +1,71 @@
+import { createId } from "@paralleldrive/cuid2";
+import Handlebars from "handlebars";
+import { getLogger } from "../../../log.js";
+import { getProviderDefinition } from "../../../providers/catalog.js";
+import { providerModelSelectBySize } from "../../../providers/providerModelSelectBySize.js";
+import { agentPromptBundledRead } from "../../agents/ops/agentPromptBundledRead.js";
+import { messageExtractText } from "../../messages/messageExtractText.js";
+import { formatHistoryMessages } from "./utils/formatHistoryMessages.js";
+import { parseObservations } from "./utils/parseObservations.js";
+const logger = getLogger("memory.infer");
+/**
+ * Runs inference on conversation history to extract observations worth persisting.
+ * When isForeground is false, the OBSERVE.md prompt is adjusted for background agent context.
+ *
+ * Expects: records from a single session, at least one provider available.
+ */
+export async function inferObservations(options) {
+    const { records, inferenceRouter, providers, signal, isForeground = true } = options;
+    if (records.length === 0) {
+        return [];
+    }
+    const transcript = formatHistoryMessages(records, isForeground);
+    if (transcript.trim().length === 0) {
+        return [];
+    }
+    const template = (await agentPromptBundledRead("memory/OBSERVE.md")).trim();
+    const systemPrompt = Handlebars.compile(template)({ isForeground });
+    const context = {
+        messages: [
+            {
+                role: "user",
+                content: transcript,
+                timestamp: Date.now()
+            }
+        ],
+        systemPrompt
+    };
+    // Select normal-sized model for each provider
+    const providersOverride = providers.map((provider) => {
+        const definition = getProviderDefinition(provider.id);
+        const models = definition?.models ?? [];
+        const normalModel = providerModelSelectBySize(models, "normal");
+        if (!normalModel) {
+            return { ...provider };
+        }
+        return { ...provider, model: normalModel };
+    });
+    const sessionId = `memory-observe:${createId()}`;
+    logger.debug(`start: inferObservations starting recordCount=${records.length} providerCount=${providersOverride.length}`);
+    const result = await inferenceRouter.complete(context, sessionId, {
+        providersOverride,
+        signal
+    });
+    const text = messageExtractText(result.message)?.trim() ?? "";
+    if (text.length === 0) {
+        logger.debug("event: inferObservations produced empty response");
+        return [];
+    }
+    const observations = parseObservations(text);
+    if (observations.length === 0 && text.includes("observation")) {
+        logger.warn(`event: inferObservations found no valid <observation> tags in response: ${text}`);
+    }
+    for (const observation of observations) {
+        logger.info({
+            observationText: observation.text,
+            observationContext: observation.context
+        }, "event: inferObservations inferred");
+    }
+    return observations;
+}
+//# sourceMappingURL=inferObservations.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { AgentHistoryRecord } from "@/types";
+/**
+ * Formats agent history records into a human-readable markdown transcript.
+ * When isForeground is false, labels are "System Message"/"Agent" instead of "User"/"Assistant".
+ *
+ * Expects: records are in chronological order from a single session.
+ */
+export declare function formatHistoryMessages(records: AgentHistoryRecord[], isForeground?: boolean): string;
+//# sourceMappingURL=formatHistoryMessages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatHistoryMessages.d.ts","sourceRoot":"","sources":["../../../../../sources/engine/memory/infer/utils/formatHistoryMessages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,YAAY,UAAO,GAAG,MAAM,CAsChG"}

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

@@ -0,0 +1,50 @@
+/**
+ * Formats agent history records into a human-readable markdown transcript.
+ * When isForeground is false, labels are "System Message"/"Agent" instead of "User"/"Assistant".
+ *
+ * Expects: records are in chronological order from a single session.
+ */
+export function formatHistoryMessages(records, isForeground = true) {
+    const userLabel = isForeground ? "User" : "System Message";
+    const assistantLabel = isForeground ? "Assistant" : "Agent";
+    const parts = [];
+    for (const record of records) {
+        switch (record.type) {
+            case "user_message":
+                parts.push(`## ${userLabel}\n\n${record.text}`);
+                break;
+            case "assistant_message":
+                if (record.text.length > 0) {
+                    parts.push(`## ${assistantLabel}\n\n${record.text}`);
+                }
+                for (const toolCall of record.toolCalls) {
+                    const args = JSON.stringify(toolCall.arguments, null, 2);
+                    parts.push(`### Tool Call: ${toolCall.name}\n\n\`\`\`\n${args}\n\`\`\``);
+                }
+                break;
+            case "tool_result": {
+                const text = toolResultExtractText(record.output.toolMessage.content);
+                parts.push(`### Tool Result\n\n\`\`\`\n${text}\n\`\`\``);
+                break;
+            }
+            case "note":
+                parts.push(`> Note: ${record.text}`);
+                break;
+            // Skip rlm_* and assistant_rewrite records — internal implementation details
+            default:
+                break;
+        }
+    }
+    return parts.join("\n\n");
+}
+/** Extracts text from ToolResultMessage content blocks. */
+function toolResultExtractText(content) {
+    if (!Array.isArray(content)) {
+        return String(content);
+    }
+    const texts = content
+        .filter((part) => part?.type === "text" && typeof part.text === "string")
+        .map((part) => part.text);
+    return texts.length > 0 ? texts.join("\n") : JSON.stringify(content);
+}
+//# sourceMappingURL=formatHistoryMessages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatHistoryMessages.js","sourceRoot":"","sources":["../../../../../sources/engine/memory/infer/utils/formatHistoryMessages.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA6B,EAAE,YAAY,GAAG,IAAI;IACpF,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC3D,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC3B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,cAAc;gBACf,KAAK,CAAC,IAAI,CAAC,MAAM,SAAS,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBAChD,MAAM;YAEV,KAAK,mBAAmB;gBACpB,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,KAAK,CAAC,IAAI,CAAC,MAAM,cAAc,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACzD,CAAC;gBACD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;oBACtC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;oBACzD,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,IAAI,eAAe,IAAI,UAAU,CAAC,CAAC;gBAC7E,CAAC;gBACD,MAAM;YAEV,KAAK,aAAa,CAAC,CAAC,CAAC;gBACjB,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBACtE,KAAK,CAAC,IAAI,CAAC,8BAA8B,IAAI,UAAU,CAAC,CAAC;gBACzD,MAAM;YACV,CAAC;YAED,KAAK,MAAM;gBACP,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrC,MAAM;YAEV,6EAA6E;YAC7E;gBACI,MAAM;QACd,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9B,CAAC;AAED,2DAA2D;AAC3D,SAAS,qBAAqB,CAAC,OAAqC;IAChE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,KAAK,GAAG,OAAO;SAChB,MAAM,CACH,CAAC,IAAI,EAA0C,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAC3G;SACA,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACzE,CAAC"}

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

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

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

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