daycare-cli 2026.2.12 → 2026.2.22

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,19 @@
+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;
+};
+/**
+ * Runs inference on conversation history to extract observations worth persisting.
+ * 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":"AAGA,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;CACxB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAoEtG"}

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

@@ -0,0 +1,67 @@
+import { createId } from "@paralleldrive/cuid2";
+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.
+ * Expects: records from a single session, at least one provider available.
+ */
+export async function inferObservations(options) {
+    const { records, inferenceRouter, providers, signal } = options;
+    if (records.length === 0) {
+        return [];
+    }
+    const transcript = formatHistoryMessages(records);
+    if (transcript.trim().length === 0) {
+        return [];
+    }
+    const systemPrompt = (await agentPromptBundledRead("memory/OBSERVE.md")).trim();
+    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,7 @@
+import type { AgentHistoryRecord } from "@/types";
+/**
+ * Formats agent history records into a human-readable markdown transcript.
+ * Expects: records are in chronological order from a single session.
+ */
+export declare function formatHistoryMessages(records: AgentHistoryRecord[]): 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;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAoC3E"}

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

@@ -0,0 +1,46 @@
+/**
+ * Formats agent history records into a human-readable markdown transcript.
+ * Expects: records are in chronological order from a single session.
+ */
+export function formatHistoryMessages(records) {
+    const parts = [];
+    for (const record of records) {
+        switch (record.type) {
+            case "user_message":
+                parts.push(`## User\n\n${record.text}`);
+                break;
+            case "assistant_message":
+                if (record.text.length > 0) {
+                    parts.push(`## Assistant\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;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA6B;IAC/D,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,cAAc,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxC,MAAM;YAEV,KAAK,mBAAmB;gBACpB,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjD,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":""}

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

@@ -0,0 +1,89 @@
+import { describe, expect, it } from "vitest";
+import { formatHistoryMessages } from "./formatHistoryMessages.js";
+describe("formatHistoryMessages", () => {
+    it("returns empty string for empty records", () => {
+        expect(formatHistoryMessages([])).toBe("");
+    });
+    it("formats user message", () => {
+        const records = [{ type: "user_message", at: 1000, text: "Hello there", files: [] }];
+        expect(formatHistoryMessages(records)).toBe("## User\n\nHello there");
+    });
+    it("formats assistant message with text", () => {
+        const records = [
+            {
+                type: "assistant_message",
+                at: 1000,
+                text: "Hi!",
+                files: [],
+                toolCalls: [],
+                tokens: null
+            }
+        ];
+        expect(formatHistoryMessages(records)).toBe("## Assistant\n\nHi!");
+    });
+    it("formats assistant message with tool calls", () => {
+        const records = [
+            {
+                type: "assistant_message",
+                at: 1000,
+                text: "Let me check.",
+                files: [],
+                toolCalls: [{ type: "toolCall", id: "tc1", name: "read_file", arguments: { path: "/tmp/a.txt" } }],
+                tokens: null
+            }
+        ];
+        const result = formatHistoryMessages(records);
+        expect(result).toContain("## Assistant\n\nLet me check.");
+        expect(result).toContain("### Tool Call: read_file");
+        expect(result).toContain("/tmp/a.txt");
+    });
+    it("formats note records", () => {
+        const records = [{ type: "note", at: 1000, text: "session started" }];
+        expect(formatHistoryMessages(records)).toBe("> Note: session started");
+    });
+    it("skips rlm_start records", () => {
+        const records = [
+            { type: "rlm_start", at: 1000, toolCallId: "tc1", code: "x", preamble: "y" }
+        ];
+        expect(formatHistoryMessages(records)).toBe("");
+    });
+    it("formats tool result with text content", () => {
+        const records = [
+            {
+                type: "tool_result",
+                at: 1000,
+                toolCallId: "tc1",
+                output: {
+                    toolMessage: {
+                        role: "tool",
+                        toolCallId: "tc1",
+                        toolName: "read_file",
+                        isError: false,
+                        timestamp: 1000,
+                        content: [{ type: "text", text: "file contents here" }]
+                    },
+                    typedResult: {}
+                }
+            }
+        ];
+        const result = formatHistoryMessages(records);
+        expect(result).toContain("### Tool Result");
+        expect(result).toContain("file contents here");
+    });
+    it("joins multiple records with double newlines", () => {
+        const records = [
+            { type: "user_message", at: 1000, text: "Q", files: [] },
+            {
+                type: "assistant_message",
+                at: 1001,
+                text: "A",
+                files: [],
+                toolCalls: [],
+                tokens: null
+            }
+        ];
+        const result = formatHistoryMessages(records);
+        expect(result).toBe("## User\n\nQ\n\n## Assistant\n\nA");
+    });
+});
+//# sourceMappingURL=formatHistoryMessages.spec.js.map

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"}