daycare-cli 2026.2.12 → 2026.2.23

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

@@ -0,0 +1,109 @@
+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");
+    });
+    it("uses background labels when isForeground is false", () => {
+        const records = [
+            { type: "user_message", at: 1000, text: "run task", files: [] },
+            {
+                type: "assistant_message",
+                at: 1001,
+                text: "Done.",
+                files: [],
+                toolCalls: [],
+                tokens: null
+            }
+        ];
+        const result = formatHistoryMessages(records, false);
+        expect(result).toBe("## System Message\n\nrun task\n\n## Agent\n\nDone.");
+    });
+    it("uses foreground labels by default", () => {
+        const records = [{ type: "user_message", at: 1000, text: "hi", files: [] }];
+        expect(formatHistoryMessages(records)).toBe("## User\n\nhi");
+        expect(formatHistoryMessages(records, true)).toBe("## User\n\nhi");
+    });
+});
+//# 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"}

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

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

@@ -1,11 +1,23 @@
 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[];
+    isForeground?: boolean;
+};
 /**
  * Observes a single invalidated session for memory extraction.
- * Stub for now — actual LLM-based extraction will be added later.
+ * Runs inference to extract observations from conversation history.
  *
  * Expects: ctx identifies the agent, records are the unprocessed history entries.
  */
-export declare function memorySessionObserve(sessionNumber: number, ctx: Context, records: AgentHistoryRecord[], _storage: Storage): Promise<void>;
+export declare function memorySessionObserve(options: MemorySessionObserveOptions): Promise<InferObservation[]>;
 //# sourceMappingURL=memorySessionObserve.d.ts.map

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

@@ -1 +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,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACtC,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,kBAAkB,EAAE,EAC7B,QAAQ,EAAE,OAAO,GAClB,OAAO,CAAC,IAAI,CAAC,CAIf"}
+{"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;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAkB5G"}

package/dist/engine/memory/memorySessionObserve.js

@@ -1,12 +1,22 @@
 import { getLogger } from "../../log.js";
+import { inferObservations } from "./infer/inferObservations.js";
 const logger = getLogger("engine.memory");
 /**
  * Observes a single invalidated session for memory extraction.
- * Stub for now — actual LLM-based extraction will be added later.
+ * Runs inference to extract observations from conversation history.
  *
  * Expects: ctx identifies the agent, records are the unprocessed history entries.
  */
-export async function memorySessionObserve(sessionNumber, ctx, records, _storage) {
-    logger.debug(`event: Observing session sessionNumber=${sessionNumber} agentId=${ctx.agentId} records=${records.length} (stub)`);
+export async function memorySessionObserve(options) {
+    const { sessionNumber, ctx, records, inferenceRouter, providers, isForeground } = options;
+    logger.debug(`event: Observing session sessionNumber=${sessionNumber} agentId=${ctx.agentId} records=${records.length}`);
+    const observations = await inferObservations({
+        records,
+        inferenceRouter,
+        providers,
+        isForeground
+    });
+    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

@@ -1 +1 @@
-{"version":3,"file":"memorySessionObserve.js","sourceRoot":"","sources":["../../../sources/engine/memory/memorySessionObserve.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,MAAM,MAAM,GAAG,SAAS,CAAC,eAAe,CAAC,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACtC,aAAqB,EACrB,GAAY,EACZ,OAA6B,EAC7B,QAAiB;IAEjB,MAAM,CAAC,KAAK,CACR,0CAA0C,aAAa,YAAY,GAAG,CAAC,OAAO,YAAY,OAAO,CAAC,MAAM,SAAS,CACpH,CAAC;AACN,CAAC"}
+{"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;AAY1C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,OAAoC;IAC3E,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAC1F,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;QACT,YAAY;KACf,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.js

@@ -1,4 +1,4 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it, vi } from "vitest";
 import { Storage } from "../../storage/storage.js";
 import { Context } from "../agents/context.js";
 import { memorySessionObserve } from "./memorySessionObserve.js";
@@ -6,8 +6,34 @@ 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("runs without error with unprocessed records", async () => {
+    it("returns observations from inference", async () => {
         const storage = Storage.open(":memory:");
         try {
             const owner = (await storage.users.findMany())[0];
@@ -28,10 +54,109 @@ describe("memorySessionObserve", () => {
                 updatedAt: 1
             });
             const sessionId = await storage.sessions.create({ agentId: "agent-1", createdAt: 1000 });
-            await storage.history.append(sessionId, { type: "note", at: 1001, text: "msg" });
+            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);
-            await expect(memorySessionObserve(1, ctx, records, storage)).resolves.toBeUndefined();
+            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("passes isForeground to inferObservations and uses background labels", 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-bg",
+                userId: owner.id,
+                type: "cron",
+                descriptor: { type: "cron", id: "agent-bg", name: "job" },
+                activeSessionId: null,
+                permissions,
+                tokens: null,
+                stats: {},
+                lifecycle: "active",
+                createdAt: 1,
+                updatedAt: 1
+            });
+            const sessionId = await storage.sessions.create({ agentId: "agent-bg", createdAt: 1000 });
+            await storage.history.append(sessionId, {
+                type: "user_message",
+                at: 1001,
+                text: "run cleanup",
+                files: []
+            });
+            const ctx = new Context("agent-bg", owner.id);
+            const records = await storage.history.findBySessionId(sessionId);
+            const xml = "<observations></observations>";
+            const router = mockInferenceRouter(xml);
+            await memorySessionObserve({
+                sessionNumber: 1,
+                ctx,
+                records,
+                storage,
+                inferenceRouter: router,
+                providers: [],
+                isForeground: false
+            });
+            // Verify the transcript sent to inference uses background labels
+            const calls = router.complete.mock.calls;
+            expect(calls.length).toBeGreaterThan(0);
+            const context = calls[0][0];
+            expect(context.messages[0].content).toContain("## System Message");
+            expect(context.messages[0].content).not.toContain("## User");
+            // Verify the system prompt uses the background variant
+            expect(context.systemPrompt).toContain("automated agent");
+            expect(context.systemPrompt).not.toContain("between a person and an AI assistant");
+        }
+        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();

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

@@ -1 +1 @@
-{"version":3,"file":"memorySessionObserve.spec.js","sourceRoot":"","sources":["../../../sources/engine/memory/memorySessionObserve.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAG9C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,WAAW,GAAuB;IACpC,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,CAAC,YAAY,CAAC;CAC5B,CAAC;AAEF,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC1C,CAAC;YACD,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;gBACxB,EAAE,EAAE,SAAS;gBACb,MAAM,EAAE,KAAK,CAAC,EAAE;gBAChB,IAAI,EAAE,MAAM;gBACZ,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;gBACxD,eAAe,EAAE,IAAI;gBACrB,WAAW;gBACX,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,CAAC;aACf,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzF,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAEjF,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAEjE,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QAC1F,CAAC;gBAAS,CAAC;YACP,OAAO,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}
+{"version":3,"file":"memorySessionObserve.spec.js","sourceRoot":"","sources":["../../../sources/engine/memory/memorySessionObserve.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAGlD,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,WAAW,GAAuB;IACpC,UAAU,EAAE,YAAY;IACxB,SAAS,EAAE,CAAC,YAAY,CAAC;CAC5B,CAAC;AAEF,SAAS,mBAAmB,CAAC,YAAoB;IAC7C,OAAO;QACH,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC;YAChC,OAAO,EAAE;gBACL,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;gBAC/C,GAAG,EAAE,MAAM;gBACX,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE;oBACH,KAAK,EAAE,CAAC;oBACR,MAAM,EAAE,CAAC;oBACT,SAAS,EAAE,CAAC;oBACZ,UAAU,EAAE,CAAC;oBACb,WAAW,EAAE,CAAC;oBACd,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;iBACvE;gBACD,UAAU,EAAE,MAAM;gBAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACxB;YACD,UAAU,EAAE,MAAM;YAClB,OAAO,EAAE,MAAM;SAClB,CAAC;QACF,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE;KACY,CAAC;AACpC,CAAC;AAED,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC1C,CAAC;YACD,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;gBACxB,EAAE,EAAE,SAAS;gBACb,MAAM,EAAE,KAAK,CAAC,EAAE;gBAChB,IAAI,EAAE,MAAM;gBACZ,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;gBACxD,eAAe,EAAE,IAAI;gBACrB,WAAW;gBACX,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,CAAC;aACf,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzF,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE;gBACpC,IAAI,EAAE,cAAc;gBACpB,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,sBAAsB;gBAC5B,KAAK,EAAE,EAAE;aACZ,CAAC,CAAC;YAEH,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YACjE,MAAM,GAAG,GACL,oVAAoV,CAAC;YACzV,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;YAExC,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC;gBAC5C,aAAa,EAAE,CAAC;gBAChB,GAAG;gBACH,OAAO;gBACP,OAAO;gBACP,eAAe,EAAE,MAAM;gBACvB,SAAS,EAAE,EAAE;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;gBACzB;oBACI,IAAI,EAAE,2FAA2F;oBACjG,OAAO,EACH,+JAA+J;iBACtK;aACJ,CAAC,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,EAAE,CAAC;QACnD,CAAC;gBAAS,CAAC;YACP,OAAO,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC1C,CAAC;YACD,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;gBACxB,EAAE,EAAE,UAAU;gBACd,MAAM,EAAE,KAAK,CAAC,EAAE;gBAChB,IAAI,EAAE,MAAM;gBACZ,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;gBACzD,eAAe,EAAE,IAAI;gBACrB,WAAW;gBACX,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,QAAQ;gBACnB,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,CAAC;aACf,CAAC,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1F,MAAM,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE;gBACpC,IAAI,EAAE,cAAc;gBACpB,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,EAAE;aACZ,CAAC,CAAC;YAEH,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YACjE,MAAM,GAAG,GAAG,+BAA+B,CAAC;YAC5C,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;YAExC,MAAM,oBAAoB,CAAC;gBACvB,aAAa,EAAE,CAAC;gBAChB,GAAG;gBACH,OAAO;gBACP,OAAO;gBACP,eAAe,EAAE,MAAM;gBACvB,SAAS,EAAE,EAAE;gBACb,YAAY,EAAE,KAAK;aACtB,CAAC,CAAC;YAEH,iEAAiE;YACjE,MAAM,KAAK,GAAI,MAAM,CAAC,QAAqC,CAAC,IAAI,CAAC,KAAK,CAAC;YACvE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAA8D,CAAC;YAC1F,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;YACpE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YAC9D,uDAAuD;YACvD,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAC1D,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,sCAAsC,CAAC,CAAC;QACvF,CAAC;gBAAS,CAAC;YACP,OAAO,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACzC,IAAI,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACT,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAC1C,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7C,MAAM,MAAM,GAAG,mBAAmB,CAAC,+BAA+B,CAAC,CAAC;YAEpE,MAAM,YAAY,GAAG,MAAM,oBAAoB,CAAC;gBAC5C,aAAa,EAAE,CAAC;gBAChB,GAAG;gBACH,OAAO,EAAE,EAAE;gBACX,OAAO;gBACP,eAAe,EAAE,MAAM;gBACvB,SAAS,EAAE,EAAE;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACjC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACnD,CAAC;gBAAS,CAAC;YACP,OAAO,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}