daycare-cli 2026.2.12 → 2026.2.23

package/dist/engine/modules/tools/channelSendTool.js

@@ -74,6 +74,9 @@ function senderUsernameResolve(descriptor) {
     if (descriptor.type === "system") {
         return usernameNormalize(descriptor.tag);
     }
+    if (descriptor.type === "memory-agent") {
+        return usernameNormalize("memory-agent");
+    }
     return usernameNormalize(descriptor.userId);
 }
 function usernameNormalize(value) {

package/dist/engine/modules/tools/channelSendTool.js.map

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

package/dist/engine/modules/tools/memoryNodeReadToolBuild.d.ts

@@ -0,0 +1,8 @@
+import type { ToolDefinition } from "@/types";
+/**
+ * Builds the memory_node_read tool that returns a single graph node by id.
+ * When nodeId is omitted reads the root node with a full graph tree overview.
+ * Expects: toolContext.memory is available and ctx.userId identifies the user.
+ */
+export declare function memoryNodeReadToolBuild(): ToolDefinition;
+//# sourceMappingURL=memoryNodeReadToolBuild.d.ts.map

package/dist/engine/modules/tools/memoryNodeReadToolBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryNodeReadToolBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/memoryNodeReadToolBuild.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AA2BlE;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,cAAc,CAkGxD"}

package/dist/engine/modules/tools/memoryNodeReadToolBuild.js

@@ -0,0 +1,99 @@
+import { Type } from "@sinclair/typebox";
+import { GRAPH_ROOT_NODE_ID } from "../../memory/graph/graphTypes.js";
+const schema = Type.Object({
+    nodeId: Type.Optional(Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+const resultSchema = Type.Object({
+    found: Type.Boolean(),
+    summary: Type.String()
+}, { additionalProperties: false });
+const returns = {
+    schema: resultSchema,
+    toLLMText: (result) => result.summary
+};
+/**
+ * Builds the memory_node_read tool that returns a single graph node by id.
+ * When nodeId is omitted reads the root node with a full graph tree overview.
+ * Expects: toolContext.memory is available and ctx.userId identifies the user.
+ */
+export function memoryNodeReadToolBuild() {
+    return {
+        tool: {
+            name: "memory_node_read",
+            description: "Read a memory document by node id. Omit nodeId to read the root node with a full graph tree overview. Returns content, frontmatter, and refs.",
+            parameters: schema
+        },
+        returns,
+        visibleByDefault: (context) => context.descriptor.type === "memory-agent",
+        execute: async (args, toolContext, toolCall) => {
+            const memory = toolContext.memory;
+            if (!memory) {
+                throw new Error("Memory is not available.");
+            }
+            const payload = args;
+            const nodeId = payload.nodeId?.trim() || GRAPH_ROOT_NODE_ID;
+            const node = await memory.readNode(toolContext.ctx.userId, nodeId);
+            if (!node) {
+                const summary = `Node not found: ${nodeId}`;
+                const toolMessage = {
+                    role: "toolResult",
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    content: [{ type: "text", text: summary }],
+                    isError: false,
+                    timestamp: Date.now()
+                };
+                return {
+                    toolMessage,
+                    typedResult: { found: false, summary }
+                };
+            }
+            const isRoot = nodeId === GRAPH_ROOT_NODE_ID;
+            const lines = [`# ${node.frontmatter.title}`, ""];
+            if (!isRoot) {
+                lines.push(`- **id**: \`${node.id}\``);
+            }
+            lines.push(`- **description**: ${node.frontmatter.description}`, `- **parents**: ${node.frontmatter.parents.length > 0
+                ? node.frontmatter.parents.map((p) => `\`${p}\``).join(", ")
+                : "(none)"}`, `- **refs**: ${node.refs.length > 0 ? node.refs.map((r) => `\`${r}\``).join(", ") : "(none)"}`, "", node.content);
+            // When reading root, append the full graph tree overview.
+            if (nodeId === GRAPH_ROOT_NODE_ID) {
+                const tree = await memory.readGraph(toolContext.ctx.userId);
+                lines.push("", "## Children", "");
+                const renderNode = (parentId, depth) => {
+                    const children = tree.children.get(parentId) ?? [];
+                    for (const child of children) {
+                        const indent = "  ".repeat(depth);
+                        const contentPreview = child.content.length > 200 ? `${child.content.slice(0, 200)}...` : child.content;
+                        lines.push(`${indent}- **${child.frontmatter.title}** (id: \`${child.id}\`)`);
+                        if (child.frontmatter.description) {
+                            lines.push(`${indent}  ${child.frontmatter.description}`);
+                        }
+                        if (child.content.trim()) {
+                            lines.push(`${indent}  > ${contentPreview.replace(/\n/g, " ")}`);
+                        }
+                        renderNode(child.id, depth + 1);
+                    }
+                };
+                renderNode(tree.root.id, 0);
+                if (!tree.children.has(tree.root.id) || tree.children.get(tree.root.id).length === 0) {
+                    lines.push("(empty graph — no documents yet)");
+                }
+            }
+            const summary = lines.join("\n");
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [{ type: "text", text: summary }],
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                typedResult: { found: true, summary }
+            };
+        }
+    };
+}
+//# sourceMappingURL=memoryNodeReadToolBuild.js.map

package/dist/engine/modules/tools/memoryNodeReadToolBuild.js.map

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

package/dist/engine/modules/tools/memoryNodeReadToolBuild.spec.d.ts

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

package/dist/engine/modules/tools/memoryNodeReadToolBuild.spec.d.ts.map

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

package/dist/engine/modules/tools/memoryNodeReadToolBuild.spec.js

@@ -0,0 +1,112 @@
+import { describe, expect, it } from "vitest";
+import { memoryNodeReadToolBuild } from "./memoryNodeReadToolBuild.js";
+const sampleNode = {
+    id: "user-prefs",
+    frontmatter: {
+        title: "User Preferences",
+        description: "General user preferences",
+        parents: ["__root__"],
+        createdAt: 1000,
+        updatedAt: 2000
+    },
+    content: "Prefers dark mode and concise responses.",
+    refs: ["person-alice"]
+};
+const rootNode = {
+    id: "__root__",
+    frontmatter: {
+        title: "Memory Summary",
+        description: "Structured summary of all memories",
+        parents: [],
+        createdAt: 0,
+        updatedAt: 0
+    },
+    content: "# Memory Graph\nRoot content.",
+    refs: ["user-prefs"]
+};
+function makeContext(node, tree) {
+    const defaultTree = {
+        root: rootNode,
+        children: new Map([["__root__", []]])
+    };
+    return {
+        memory: {
+            readNode: async (_userId, nodeId) => {
+                if (nodeId === "__root__")
+                    return {
+                        ...rootNode,
+                        refs: (tree ?? defaultTree).children.get("__root__")?.map((c) => c.id) ?? []
+                    };
+                return node;
+            },
+            readGraph: async () => tree ?? defaultTree
+        },
+        ctx: { agentId: "agent-1", userId: "user-1" }
+    };
+}
+describe("memoryNodeReadToolBuild", () => {
+    const tool = memoryNodeReadToolBuild();
+    it("is visible by default only for memory-agent descriptors", () => {
+        expect(tool.visibleByDefault?.({
+            userId: "user-1",
+            agentId: "agent-1",
+            descriptor: { type: "memory-agent", id: "source-agent-1" }
+        })).toBe(true);
+        expect(tool.visibleByDefault?.({
+            userId: "user-1",
+            agentId: "agent-1",
+            descriptor: { type: "user", connector: "telegram", userId: "user-1", channelId: "channel-1" }
+        })).toBe(false);
+    });
+    it("returns node content with id when found", async () => {
+        const result = await tool.execute({ nodeId: "user-prefs" }, makeContext(sampleNode), {
+            id: "tc1",
+            name: "memory_node_read"
+        });
+        expect(result.typedResult.found).toBe(true);
+        expect(result.typedResult.summary).toContain("User Preferences");
+        expect(result.typedResult.summary).toContain("Prefers dark mode");
+        expect(result.typedResult.summary).toContain("person-alice");
+        expect(result.typedResult.summary).toContain("**parents**");
+        expect(result.typedResult.summary).toContain("**id**: `user-prefs`");
+    });
+    it("returns not found when node is missing", async () => {
+        const result = await tool.execute({ nodeId: "nonexistent" }, makeContext(null), {
+            id: "tc1",
+            name: "memory_node_read"
+        });
+        expect(result.typedResult.found).toBe(false);
+        expect(result.typedResult.summary).toContain("not found");
+    });
+    it("reads root without id but with children refs and tree overview", async () => {
+        const tree = {
+            root: rootNode,
+            children: new Map([["__root__", [sampleNode]]])
+        };
+        const result = await tool.execute({}, makeContext(null, tree), {
+            id: "tc1",
+            name: "memory_node_read"
+        });
+        expect(result.typedResult.found).toBe(true);
+        expect(result.typedResult.summary).toContain("Memory Summary");
+        expect(result.typedResult.summary).not.toContain("**id**: `__root__`");
+        expect(result.typedResult.summary).toContain("Children");
+        expect(result.typedResult.summary).toContain("User Preferences");
+        expect(result.typedResult.summary).toContain("user-prefs");
+        expect(result.typedResult.summary).toContain("**parents**");
+        expect(result.typedResult.summary).toContain("**refs**");
+    });
+    it("shows empty graph message when root has no children", async () => {
+        const result = await tool.execute({}, makeContext(null), {
+            id: "tc1",
+            name: "memory_node_read"
+        });
+        expect(result.typedResult.found).toBe(true);
+        expect(result.typedResult.summary).toContain("empty graph");
+    });
+    it("throws when memory is not available", async () => {
+        const ctx = { ctx: { agentId: "a", userId: "u" } };
+        await expect(tool.execute({ nodeId: "x" }, ctx, { id: "tc1", name: "memory_node_read" })).rejects.toThrow("Memory is not available");
+    });
+});
+//# sourceMappingURL=memoryNodeReadToolBuild.spec.js.map

package/dist/engine/modules/tools/memoryNodeReadToolBuild.spec.js.map

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

package/dist/engine/modules/tools/memoryNodeWriteToolBuild.d.ts

@@ -0,0 +1,10 @@
+import type { ToolDefinition } from "@/types";
+/**
+ * Builds the memory_node_write tool that creates or updates a graph node.
+ * When nodeId is omitted a cuid2 is generated. When provided the existing node is updated.
+ * Root node (__root__) cannot be written — it is virtual and read-only.
+ * Title, description, and parents are required and normalized before writing.
+ * Expects: toolContext.memory is available and ctx.userId identifies the user.
+ */
+export declare function memoryNodeWriteToolBuild(): ToolDefinition;
+//# sourceMappingURL=memoryNodeWriteToolBuild.d.ts.map

package/dist/engine/modules/tools/memoryNodeWriteToolBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryNodeWriteToolBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/memoryNodeWriteToolBuild.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAgClE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,IAAI,cAAc,CAgFzD"}

package/dist/engine/modules/tools/memoryNodeWriteToolBuild.js

@@ -0,0 +1,115 @@
+import { createId } from "@paralleldrive/cuid2";
+import { Type } from "@sinclair/typebox";
+import { GRAPH_ROOT_NODE_ID } from "../../memory/graph/graphTypes.js";
+const schema = Type.Object({
+    nodeId: Type.Optional(Type.String({ minLength: 1 })),
+    title: Type.String({ minLength: 1 }),
+    description: Type.String({ minLength: 1 }),
+    content: Type.String(),
+    parents: Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }),
+    refs: Type.Optional(Type.Array(Type.String({ minLength: 1 })))
+}, { additionalProperties: false });
+const resultSchema = Type.Object({
+    summary: Type.String(),
+    nodeId: Type.String()
+}, { additionalProperties: false });
+const returns = {
+    schema: resultSchema,
+    toLLMText: (result) => result.summary
+};
+/**
+ * Builds the memory_node_write tool that creates or updates a graph node.
+ * When nodeId is omitted a cuid2 is generated. When provided the existing node is updated.
+ * Root node (__root__) cannot be written — it is virtual and read-only.
+ * Title, description, and parents are required and normalized before writing.
+ * Expects: toolContext.memory is available and ctx.userId identifies the user.
+ */
+export function memoryNodeWriteToolBuild() {
+    return {
+        tool: {
+            name: "memory_node_write",
+            description: "Create or update a memory document. Provide title, description, content (markdown body), parents (required list of parent node ids — use __root__ or root for top-level), and optional refs (cross-reference node ids). Omit nodeId to create; provide nodeId to update.",
+            parameters: schema
+        },
+        returns,
+        visibleByDefault: (context) => context.descriptor.type === "memory-agent",
+        execute: async (args, toolContext, toolCall) => {
+            const memory = toolContext.memory;
+            if (!memory) {
+                throw new Error("Memory is not available.");
+            }
+            const payload = args;
+            const nodeId = payload.nodeId?.trim() || createId();
+            if (nodeId.startsWith("__")) {
+                throw new Error("Node ids starting with __ are reserved.");
+            }
+            const title = payload.title.trim();
+            if (title.length === 0) {
+                throw new Error("Memory node title is required.");
+            }
+            const description = payload.description.trim();
+            if (description.length === 0) {
+                throw new Error("Memory node description is required.");
+            }
+            const rawParents = Array.isArray(payload.parents) ? payload.parents : [];
+            if (rawParents.length === 0) {
+                throw new Error("Memory node parents are required and must include at least one parent id.");
+            }
+            const parents = memoryNodeIdsNormalize(rawParents, [nodeId], { normalizeRootAlias: true });
+            if (parents.length === 0) {
+                throw new Error("Memory node parents must include at least one valid parent id.");
+            }
+            for (const parentId of parents) {
+                if (parentId.startsWith("__") && parentId !== GRAPH_ROOT_NODE_ID) {
+                    throw new Error("Only __root__ is allowed as a reserved parent id.");
+                }
+            }
+            const refs = memoryNodeIdsNormalize(payload.refs ?? [], [nodeId], { normalizeRootAlias: false });
+            const now = Date.now();
+            const userId = toolContext.ctx.userId;
+            const existing = await memory.readNode(userId, nodeId);
+            await memory.writeNode(userId, {
+                id: nodeId,
+                frontmatter: {
+                    title,
+                    description,
+                    parents,
+                    createdAt: existing?.frontmatter.createdAt ?? now,
+                    updatedAt: now
+                },
+                content: payload.content,
+                refs
+            });
+            const action = existing ? "Updated" : "Created";
+            const summary = `${action} memory node: ${nodeId} ("${title}")`;
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [{ type: "text", text: summary }],
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                typedResult: { summary, nodeId }
+            };
+        }
+    };
+}
+function memoryNodeIdsNormalize(values, excludedIds, options) {
+    const excluded = new Set(excludedIds);
+    const seen = new Set();
+    const normalized = [];
+    for (const value of values) {
+        const trimmed = value.trim();
+        const nodeId = options.normalizeRootAlias && trimmed.toLowerCase() === "root" ? GRAPH_ROOT_NODE_ID : trimmed;
+        if (nodeId.length === 0 || excluded.has(nodeId) || seen.has(nodeId)) {
+            continue;
+        }
+        seen.add(nodeId);
+        normalized.push(nodeId);
+    }
+    return normalized;
+}
+//# sourceMappingURL=memoryNodeWriteToolBuild.js.map

package/dist/engine/modules/tools/memoryNodeWriteToolBuild.js.map

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

package/dist/engine/modules/tools/memoryNodeWriteToolBuild.spec.d.ts

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

package/dist/engine/modules/tools/memoryNodeWriteToolBuild.spec.d.ts.map

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

package/dist/engine/modules/tools/memoryNodeWriteToolBuild.spec.js

@@ -0,0 +1,163 @@
+import { isCuid } from "@paralleldrive/cuid2";
+import { describe, expect, it } from "vitest";
+import { memoryNodeWriteToolBuild } from "./memoryNodeWriteToolBuild.js";
+function makeContext(existingNode) {
+    const written = [];
+    return {
+        context: {
+            memory: {
+                readNode: async (_userId, _nodeId) => {
+                    return existingNode;
+                },
+                writeNode: async (_userId, node) => {
+                    written.push(node);
+                }
+            },
+            ctx: { agentId: "agent-1", userId: "user-1" }
+        },
+        written
+    };
+}
+describe("memoryNodeWriteToolBuild", () => {
+    const tool = memoryNodeWriteToolBuild();
+    it("is visible by default only for memory-agent descriptors", () => {
+        expect(tool.visibleByDefault?.({
+            userId: "user-1",
+            agentId: "agent-1",
+            descriptor: { type: "memory-agent", id: "source-agent-1" }
+        })).toBe(true);
+        expect(tool.visibleByDefault?.({
+            userId: "user-1",
+            agentId: "agent-1",
+            descriptor: { type: "user", connector: "telegram", userId: "user-1", channelId: "channel-1" }
+        })).toBe(false);
+    });
+    it("generates cuid2 id when nodeId is omitted", async () => {
+        const { context, written } = makeContext(null);
+        const result = await tool.execute({
+            title: "User Preferences",
+            description: "Stable user communication preferences",
+            content: "Prefers dark mode.",
+            parents: ["__root__"]
+        }, context, { id: "tc1", name: "memory_node_write" });
+        expect(result.typedResult.summary).toContain("Created");
+        expect(isCuid(result.typedResult.nodeId)).toBe(true);
+        expect(written).toHaveLength(1);
+        expect(written[0].frontmatter.title).toBe("User Preferences");
+        expect(written[0].frontmatter.description).toBe("Stable user communication preferences");
+        expect(written[0].frontmatter.parents).toEqual(["__root__"]);
+        expect(written[0].content).toBe("Prefers dark mode.");
+    });
+    it("updates existing node and preserves createdAt", async () => {
+        const existing = {
+            id: "user-prefs",
+            frontmatter: {
+                title: "Old Title",
+                description: "Old description",
+                parents: ["__root__"],
+                createdAt: 1000,
+                updatedAt: 1500
+            },
+            content: "Old content",
+            refs: []
+        };
+        const { context, written } = makeContext(existing);
+        const result = await tool.execute({
+            nodeId: "user-prefs",
+            title: "User Preferences",
+            description: "Current preferences and communication style",
+            content: "Updated content.",
+            parents: ["__root__"]
+        }, context, { id: "tc1", name: "memory_node_write" });
+        expect(result.typedResult.summary).toContain("Updated");
+        expect(written[0].frontmatter.createdAt).toBe(1000);
+    });
+    it("normalizes parents and refs by trimming, deduping, and removing self references", async () => {
+        const { context, written } = makeContext(null);
+        await tool.execute({
+            nodeId: "node-1",
+            title: "Node",
+            description: "A fully normalized memory node",
+            content: "Body",
+            parents: ["__root__", " topic-a ", "topic-a", "node-1", "   "],
+            refs: [" ref-a ", "ref-a", "node-1", " "]
+        }, context, { id: "tc1", name: "memory_node_write" });
+        expect(written).toHaveLength(1);
+        expect(written[0].frontmatter.parents).toEqual(["__root__", "topic-a"]);
+        expect(written[0].refs).toEqual(["ref-a"]);
+    });
+    it("normalizes parent root alias to __root__", async () => {
+        const { context, written } = makeContext(null);
+        await tool.execute({
+            nodeId: "node-1",
+            title: "Node",
+            description: "A fully normalized memory node",
+            content: "Body",
+            parents: ["root", "topic-a"],
+            refs: []
+        }, context, { id: "tc1", name: "memory_node_write" });
+        expect(written).toHaveLength(1);
+        expect(written[0].frontmatter.parents).toEqual(["__root__", "topic-a"]);
+    });
+    it("rejects reserved node ids", async () => {
+        const { context } = makeContext(null);
+        await expect(tool.execute({
+            nodeId: "__root__",
+            title: "Root",
+            description: "Root",
+            content: "x",
+            parents: ["__root__"]
+        }, context, {
+            id: "tc1",
+            name: "memory_node_write"
+        })).rejects.toThrow("reserved");
+    });
+    it("rejects empty description", async () => {
+        const { context } = makeContext(null);
+        await expect(tool.execute({
+            title: "Node",
+            description: " ",
+            content: "x",
+            parents: ["__root__"]
+        }, context, { id: "tc1", name: "memory_node_write" })).rejects.toThrow("description is required");
+    });
+    it("rejects missing parents", async () => {
+        const { context } = makeContext(null);
+        await expect(tool.execute({
+            title: "Node",
+            description: "Node description",
+            content: "x"
+        }, context, { id: "tc1", name: "memory_node_write" })).rejects.toThrow("parents are required");
+    });
+    it("rejects parents that normalize to empty", async () => {
+        const { context } = makeContext(null);
+        await expect(tool.execute({
+            title: "Node",
+            description: "Node description",
+            content: "x",
+            parents: [" "]
+        }, context, { id: "tc1", name: "memory_node_write" })).rejects.toThrow("parents must include at least one valid parent id");
+    });
+    it("rejects reserved parent ids other than __root__", async () => {
+        const { context } = makeContext(null);
+        await expect(tool.execute({
+            title: "Node",
+            description: "Node description",
+            content: "x",
+            parents: ["__internal"]
+        }, context, { id: "tc1", name: "memory_node_write" })).rejects.toThrow("Only __root__ is allowed as a reserved parent id");
+    });
+    it("throws when memory is not available", async () => {
+        const ctx = { ctx: { agentId: "a", userId: "u" } };
+        await expect(tool.execute({
+            title: "T",
+            description: "T description",
+            content: "c",
+            parents: ["__root__"]
+        }, ctx, {
+            id: "tc1",
+            name: "memory_node_write"
+        })).rejects.toThrow("Memory is not available");
+    });
+});
+//# sourceMappingURL=memoryNodeWriteToolBuild.spec.js.map

package/dist/engine/modules/tools/memoryNodeWriteToolBuild.spec.js.map

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

package/dist/engine/modules/tools/toolResultTruncate.d.ts

@@ -1,7 +1,7 @@
 import type { ToolExecutionResult } from "@/types";
 /**
  * Truncates long tool result text payloads and appends a notice.
- * Expects: content is a single text block or a string.
+ * Expects: content is a string or block array with optional text parts.
  */
 export declare function toolResultTruncate(result: ToolExecutionResult): ToolExecutionResult;
 //# sourceMappingURL=toolResultTruncate.d.ts.map

package/dist/engine/modules/tools/toolResultTruncate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolResultTruncate.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/toolResultTruncate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAKnD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CA2BnF"}
+{"version":3,"file":"toolResultTruncate.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/toolResultTruncate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAKnD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAmDnF"}