daycare-cli 2026.2.12 → 2026.2.22

package/dist/engine/modules/toolResolver.spec.js

@@ -7,6 +7,94 @@ const textReturns = {
     toLLMText: (result) => result.text
 };
 describe("ToolResolver", () => {
+    it("lists tools as visible by default when callback is not defined", () => {
+        const resolver = new ToolResolver();
+        resolver.register("test", {
+            tool: {
+                name: "read_file",
+                description: "Read file.",
+                parameters: Type.Object({ path: Type.String() }, { additionalProperties: false })
+            },
+            returns: textReturns,
+            execute: async () => okResult("read_file", "ok")
+        });
+        const tools = resolver.listToolsForAgent(toolVisibilityContextCreate());
+        expect(tools.map((tool) => tool.name)).toEqual(["read_file"]);
+    });
+    it("omits tools from contextual list when visibleByDefault returns false", () => {
+        const resolver = new ToolResolver();
+        resolver.register("test", {
+            tool: {
+                name: "read_file",
+                description: "Read file.",
+                parameters: Type.Object({ path: Type.String() }, { additionalProperties: false })
+            },
+            returns: textReturns,
+            visibleByDefault: () => false,
+            execute: async () => okResult("read_file", "ok")
+        });
+        const tools = resolver.listToolsForAgent(toolVisibilityContextCreate());
+        expect(tools).toEqual([]);
+    });
+    it("supports descriptor-aware visibility callbacks", () => {
+        const resolver = new ToolResolver();
+        resolver.register("test", {
+            tool: {
+                name: "memory_node_read",
+                description: "Read memory node.",
+                parameters: Type.Object({}, { additionalProperties: false })
+            },
+            returns: textReturns,
+            visibleByDefault: (context) => context.descriptor.type === "memory-agent",
+            execute: async () => okResult("memory_node_read", "ok")
+        });
+        const memoryTools = resolver.listToolsForAgent(toolVisibilityContextCreate({ descriptor: { type: "memory-agent", id: "agent-1" } }));
+        const userTools = resolver.listToolsForAgent(toolVisibilityContextCreate());
+        expect(memoryTools.map((tool) => tool.name)).toEqual(["memory_node_read"]);
+        expect(userTools).toEqual([]);
+    });
+    it("keeps hidden tools executable when no execution allowlist is configured", async () => {
+        const resolver = new ToolResolver();
+        resolver.register("test", {
+            tool: {
+                name: "hidden_tool",
+                description: "Hidden tool.",
+                parameters: Type.Object({}, { additionalProperties: false })
+            },
+            returns: textReturns,
+            visibleByDefault: () => false,
+            execute: async () => okResult("hidden_tool", "ok")
+        });
+        expect(resolver.listToolsForAgent(toolVisibilityContextCreate())).toEqual([]);
+        const result = await resolver.execute({
+            type: "toolCall",
+            id: "call-1",
+            name: "hidden_tool",
+            arguments: {}
+        }, toolExecutionContextCreate());
+        expect(result.toolMessage.isError).toBe(false);
+        expect(messageText(result)).toContain("ok");
+    });
+    it("blocks execution when tool is not in execution allowlist", async () => {
+        const resolver = new ToolResolver();
+        resolver.register("test", {
+            tool: {
+                name: "read_file",
+                description: "Read file.",
+                parameters: Type.Object({ path: Type.String() }, { additionalProperties: false })
+            },
+            returns: textReturns,
+            execute: async () => okResult("read_file", "ok")
+        });
+        const result = await resolver.execute({
+            type: "toolCall",
+            id: "call-1",
+            name: "read_file",
+            arguments: { path: "/tmp/a.txt" }
+        }, toolExecutionContextCreate({ allowedToolNames: new Set(["memory_node_read"]) }));
+        expect(result.toolMessage.isError).toBe(true);
+        expect(messageText(result)).toContain('Tool "read_file" is not allowed for this agent.');
+    });
     it("rejects non-run_python tool calls when rlmToolOnly is enabled", async () => {
         const resolver = new ToolResolver();
         resolver.register("test", {
@@ -204,6 +292,19 @@ function toolExecutionContextCreate(overrides = {}) {
         ...overrides
     };
 }
+function toolVisibilityContextCreate(overrides = {}) {
+    return {
+        userId: "user-1",
+        agentId: "agent-1",
+        descriptor: {
+            type: "user",
+            connector: "telegram",
+            userId: "user-1",
+            channelId: "channel-1"
+        },
+        ...overrides
+    };
+}
 function okResult(name, text) {
     return {
         toolMessage: {

package/dist/engine/modules/toolResolver.spec.js.map

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

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