daycare-cli 0.0.1

package/dist/engine/modules/tools/image-generation.js

@@ -0,0 +1,99 @@
+import { Type } from "@sinclair/typebox";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+const schema = Type.Object({
+    prompt: Type.String({ minLength: 1 }),
+    provider: Type.Optional(Type.String({ minLength: 1 })),
+    size: Type.Optional(Type.String({ minLength: 1 })),
+    count: Type.Optional(Type.Number({ minimum: 1, maximum: 4 })),
+    model: Type.Optional(Type.String({ minLength: 1 }))
+}, { additionalProperties: false });
+export function buildImageGenerationTool(imageRegistry) {
+    return {
+        tool: {
+            name: "generate_image",
+            description: "Generate one or more images using the configured image provider.",
+            parameters: schema
+        },
+        execute: async (args, toolContext, toolCall) => {
+            const payload = args;
+            const providers = imageRegistry.list();
+            if (providers.length === 0) {
+                throw new Error("No image generation providers available");
+            }
+            const providerId = payload.provider ??
+                (providers.length === 1 ? providers[0].id : null);
+            if (!providerId) {
+                throw new Error("Multiple image providers available; specify provider");
+            }
+            const provider = imageRegistry.get(providerId);
+            if (!provider) {
+                throw new Error(`Unknown image provider: ${providerId}`);
+            }
+            const result = await provider.generate({
+                prompt: payload.prompt,
+                size: payload.size,
+                count: payload.count,
+                model: payload.model
+            }, {
+                fileStore: toolContext.fileStore,
+                auth: toolContext.auth,
+                logger: toolContext.logger
+            });
+            const workspaceDir = toolContext.permissions.workingDir;
+            const workspaceImagesDir = path.join(workspaceDir, "images");
+            await fs.mkdir(workspaceImagesDir, { recursive: true });
+            const createdAt = new Date();
+            const timestamp = createdAt.toISOString().replace(/[:.]/g, "-");
+            const content = [
+                {
+                    type: "text",
+                    text: `Generated ${result.files.length} image(s) with ${providerId}.`
+                }
+            ];
+            const workspaceFiles = [];
+            for (const [index, file] of result.files.entries()) {
+                if (!file.mimeType.startsWith("image/")) {
+                    continue;
+                }
+                const data = await fs.readFile(file.path);
+                const suffix = result.files.length > 1 ? `-${index + 1}` : "";
+                const filename = `${timestamp}${suffix}.png`;
+                const outputPath = path.join(workspaceImagesDir, filename);
+                await fs.writeFile(outputPath, data);
+                workspaceFiles.push({ name: filename, path: outputPath, mimeType: file.mimeType });
+                content.push({
+                    type: "image",
+                    data: data.toString("base64"),
+                    mimeType: file.mimeType
+                });
+            }
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content,
+                details: {
+                    provider: providerId,
+                    files: result.files.map((file) => ({
+                        id: file.id,
+                        name: file.name,
+                        mimeType: file.mimeType,
+                        size: file.size
+                    })),
+                    workspace: {
+                        dir: workspaceImagesDir,
+                        files: workspaceFiles
+                    }
+                },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                files: result.files
+            };
+        }
+    };
+}
+//# sourceMappingURL=image-generation.js.map

package/dist/engine/modules/tools/image-generation.js.map

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

package/dist/engine/modules/tools/mermaid-png.d.ts

@@ -0,0 +1,14 @@
+import type { ToolDefinition } from "@/types";
+declare const schema: import("@sinclair/typebox").TObject<{
+    mermaid: import("@sinclair/typebox").TString;
+    name: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    theme: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    width: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
+}>;
+/**
+ * Builds a tool that renders Mermaid diagram source into a PNG file.
+ * Expects: args.mermaid contains raw Mermaid source without markdown fences.
+ */
+export declare function buildMermaidPngTool(): ToolDefinition<typeof schema>;
+export {};
+//# sourceMappingURL=mermaid-png.d.ts.map

package/dist/engine/modules/tools/mermaid-png.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-png.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/mermaid-png.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C,QAAA,MAAM,MAAM;;;;;EAQX,CAAC;AASF;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAAC,OAAO,MAAM,CAAC,CAwEnE"}

package/dist/engine/modules/tools/mermaid-png.js

@@ -0,0 +1,96 @@
+import { Type } from "@sinclair/typebox";
+import { THEMES, renderMermaid } from "beautiful-mermaid";
+import { renderToPng } from "../../../util/renderToPng.js";
+const schema = Type.Object({
+    mermaid: Type.String({ minLength: 1 }),
+    name: Type.Optional(Type.String({ minLength: 1 })),
+    theme: Type.Optional(Type.String({ minLength: 1 })),
+    width: Type.Optional(Type.Integer({ minimum: 256, maximum: 4096 }))
+}, { additionalProperties: false });
+/**
+ * Builds a tool that renders Mermaid diagram source into a PNG file.
+ * Expects: args.mermaid contains raw Mermaid source without markdown fences.
+ */
+export function buildMermaidPngTool() {
+    return {
+        tool: {
+            name: "generate_mermaid_png",
+            description: "Render raw Mermaid diagram source into a PNG file and return it as a generated artifact.",
+            parameters: schema
+        },
+        execute: async (args, context, toolCall) => {
+            const payload = args;
+            const themeName = payload.theme ?? "github-light";
+            const theme = THEMES[themeName];
+            if (!theme) {
+                const available = Object.keys(THEMES).sort().join(", ");
+                throw new Error(`Unknown Mermaid theme: ${themeName}. Available themes: ${available}`);
+            }
+            const diagram = payload.mermaid.trim();
+            if (diagram.length === 0) {
+                throw new Error("Mermaid source is empty.");
+            }
+            if (diagram.includes("```")) {
+                throw new Error("Provide raw Mermaid source without ``` fences.");
+            }
+            const svg = await renderMermaid(diagram, theme);
+            const png = await renderToPng(svg, {
+                width: payload.width ?? 1600
+            });
+            const stored = await context.fileStore.saveBuffer({
+                name: mermaidPngNameResolve(payload.name),
+                mimeType: "image/png",
+                data: png,
+                source: "generate_mermaid_png"
+            });
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [
+                    {
+                        type: "text",
+                        text: `Generated Mermaid PNG ${stored.name}.`
+                    }
+                ],
+                details: {
+                    fileId: stored.id,
+                    name: stored.name,
+                    mimeType: stored.mimeType,
+                    size: stored.size,
+                    theme: themeName,
+                    width: payload.width ?? 1600
+                },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                files: [
+                    {
+                        id: stored.id,
+                        name: stored.name,
+                        mimeType: stored.mimeType,
+                        size: stored.size,
+                        path: stored.path
+                    }
+                ]
+            };
+        }
+    };
+}
+function mermaidPngNameResolve(requestedName) {
+    const fallback = `mermaid-${Date.now()}.png`;
+    if (!requestedName) {
+        return fallback;
+    }
+    const trimmed = requestedName.trim();
+    if (trimmed.length === 0) {
+        return fallback;
+    }
+    if (trimmed.toLowerCase().endsWith(".png")) {
+        return trimmed;
+    }
+    return `${trimmed}.png`;
+}
+//# sourceMappingURL=mermaid-png.js.map

package/dist/engine/modules/tools/mermaid-png.js.map

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

package/dist/engine/modules/tools/mermaid-png.spec.d.ts

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

package/dist/engine/modules/tools/mermaid-png.spec.d.ts.map

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

package/dist/engine/modules/tools/mermaid-png.spec.js

@@ -0,0 +1,81 @@
+import { describe, expect, it, vi } from "vitest";
+import { buildMermaidPngTool } from "./mermaid-png.js";
+const mocks = vi.hoisted(() => ({
+    renderToPng: vi.fn(async () => Buffer.from("png"))
+}));
+vi.mock("../../../util/renderToPng.js", () => ({
+    renderToPng: mocks.renderToPng
+}));
+describe("buildMermaidPngTool", () => {
+    it("renders a png file from mermaid source", async () => {
+        const saveBuffer = vi.fn(async (options) => ({
+            id: "file-1",
+            name: options.name,
+            path: "/tmp/file-1.png",
+            mimeType: options.mimeType,
+            size: options.data.byteLength,
+            source: options.source,
+            createdAt: "2026-01-01T00:00:00.000Z"
+        }));
+        const tool = buildMermaidPngTool();
+        const result = await tool.execute({
+            mermaid: "graph LR\n  A --> B",
+            name: "pipeline"
+        }, contextBuild(saveBuffer), { id: "call-1", name: "generate_mermaid_png" });
+        expect(saveBuffer).toHaveBeenCalledTimes(1);
+        expect(mocks.renderToPng).toHaveBeenCalledTimes(1);
+        expect(saveBuffer.mock.calls[0]?.[0]).toMatchObject({
+            name: "pipeline.png",
+            mimeType: "image/png",
+            source: "generate_mermaid_png"
+        });
+        expect(result.files).toEqual([
+            {
+                id: "file-1",
+                name: "pipeline.png",
+                mimeType: "image/png",
+                size: expect.any(Number),
+                path: "/tmp/file-1.png"
+            }
+        ]);
+        expect(result.toolMessage.isError).toBe(false);
+    });
+    it("rejects fenced markdown input", async () => {
+        const saveBuffer = vi.fn();
+        const tool = buildMermaidPngTool();
+        await expect(tool.execute({
+            mermaid: "```mermaid\ngraph LR\n  A --> B\n```"
+        }, contextBuild(saveBuffer), { id: "call-1", name: "generate_mermaid_png" })).rejects.toThrow("raw Mermaid source without ``` fences");
+        expect(saveBuffer).not.toHaveBeenCalled();
+    });
+    it("rejects unknown theme", async () => {
+        const saveBuffer = vi.fn();
+        const tool = buildMermaidPngTool();
+        await expect(tool.execute({
+            mermaid: "graph LR\n  A --> B",
+            theme: "not-a-theme"
+        }, contextBuild(saveBuffer), { id: "call-1", name: "generate_mermaid_png" })).rejects.toThrow("Unknown Mermaid theme");
+        expect(saveBuffer).not.toHaveBeenCalled();
+    });
+});
+function contextBuild(saveBuffer) {
+    return {
+        connectorRegistry: null,
+        fileStore: { saveBuffer },
+        auth: null,
+        logger: console,
+        assistant: null,
+        permissions: {
+            workingDir: "/tmp",
+            writeDirs: [],
+            readDirs: [],
+            network: false
+        },
+        agent: { id: "agent-test" },
+        source: "test",
+        messageContext: {},
+        agentSystem: null,
+        heartbeats: null
+    };
+}
+//# sourceMappingURL=mermaid-png.spec.js.map

package/dist/engine/modules/tools/mermaid-png.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-png.spec.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/mermaid-png.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAGlD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9B,WAAW,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;CACnD,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,8BAA8B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7C,WAAW,EAAE,KAAK,CAAC,WAAW;CAC/B,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,OAK/B,EAAE,EAAE,CAAC,CAAC;YACL,EAAE,EAAE,QAAQ;YACZ,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,0BAA0B;SACtC,CAAC,CAAC,CAAC;QAEJ,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAC/B;YACE,OAAO,EAAE,qBAAqB;YAC9B,IAAI,EAAE,UAAU;SACjB,EACD,YAAY,CAAC,UAAU,CAAC,EACxB,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAC/C,CAAC;QAEF,MAAM,CAAC,UAAU,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;YAClD,IAAI,EAAE,cAAc;YACpB,QAAQ,EAAE,WAAW;YACrB,MAAM,EAAE,sBAAsB;SAC/B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;YAC3B;gBACE,EAAE,EAAE,QAAQ;gBACZ,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,WAAW;gBACrB,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;gBACxB,IAAI,EAAE,iBAAiB;aACxB;SACF,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QAEnC,MAAM,MAAM,CACV,IAAI,CAAC,OAAO,CACV;YACE,OAAO,EAAE,sCAAsC;SAChD,EACD,YAAY,CAAC,UAAU,CAAC,EACxB,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAC/C,CACF,CAAC,OAAO,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC;QAE3D,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,KAAK,IAAI,EAAE;QACrC,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QAEnC,MAAM,MAAM,CACV,IAAI,CAAC,OAAO,CACV;YACE,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE,aAAa;SACrB,EACD,YAAY,CAAC,UAAU,CAAC,EACxB,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAC/C,CACF,CAAC,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAE3C,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,SAAS,YAAY,CAAC,UAapB;IACA,OAAO;QACL,iBAAiB,EAAE,IAA4D;QAC/E,SAAS,EAAE,EAAE,UAAU,EAAkD;QACzE,IAAI,EAAE,IAA+C;QACrD,MAAM,EAAE,OAAoD;QAC5D,SAAS,EAAE,IAAI;QACf,WAAW,EAAE;YACX,UAAU,EAAE,MAAM;YAClB,SAAS,EAAE,EAAE;YACb,QAAQ,EAAE,EAAE;YACZ,OAAO,EAAE,KAAK;SACf;QACD,KAAK,EAAE,EAAE,EAAE,EAAE,YAAY,EAA8C;QACvE,MAAM,EAAE,MAAM;QACd,cAAc,EAAE,EAAuD;QACvE,WAAW,EAAE,IAAsD;QACnE,UAAU,EAAE,IAAqD;KAClE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { ToolDefinition } from "@/types";
+/**
+ * Builds the create_permanent_agent tool to create or update permanent agents.
+ * Expects: agent name + system prompt are provided; workspaceDir stays within the main workspace.
+ */
+export declare function permanentAgentToolBuild(): ToolDefinition;
+//# sourceMappingURL=permanentAgentToolBuild.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permanentAgentToolBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/permanentAgentToolBuild.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA6B9C;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,cAAc,CAmGxD"}

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

@@ -0,0 +1,163 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { Type } from "@sinclair/typebox";
+import { createId } from "@paralleldrive/cuid2";
+import { cuid2Is } from "../../../utils/cuid2Is.js";
+import { permissionClone } from "../../permissions/permissionClone.js";
+import { permissionTagsApply } from "../../permissions/permissionTagsApply.js";
+import { permissionTagsNormalize } from "../../permissions/permissionTagsNormalize.js";
+import { permissionTagsValidate } from "../../permissions/permissionTagsValidate.js";
+import { pathResolveSecure } from "../../permissions/pathResolveSecure.js";
+import { agentDescriptorWrite } from "../../agents/ops/agentDescriptorWrite.js";
+import { agentHistoryAppend } from "../../agents/ops/agentHistoryAppend.js";
+import { agentPermanentList } from "../../agents/ops/agentPermanentList.js";
+import { agentStateRead } from "../../agents/ops/agentStateRead.js";
+import { agentStateWrite } from "../../agents/ops/agentStateWrite.js";
+const schema = Type.Object({
+    name: Type.String({ minLength: 1 }),
+    description: Type.String({ minLength: 1 }),
+    systemPrompt: Type.String({ minLength: 1 }),
+    workspaceDir: Type.Optional(Type.String({ minLength: 1 })),
+    agentId: Type.Optional(Type.String({ minLength: 1 })),
+    permissions: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }))
+}, { additionalProperties: false });
+/**
+ * Builds the create_permanent_agent tool to create or update permanent agents.
+ * Expects: agent name + system prompt are provided; workspaceDir stays within the main workspace.
+ */
+export function permanentAgentToolBuild() {
+    return {
+        tool: {
+            name: "create_permanent_agent",
+            description: "Create or update a permanent background agent with a stable name and system prompt.",
+            parameters: schema
+        },
+        execute: async (args, toolContext, toolCall) => {
+            const payload = args;
+            const name = payload.name.trim();
+            if (!name) {
+                throw new Error("Permanent agent name is required.");
+            }
+            const description = payload.description.trim();
+            if (!description) {
+                throw new Error("Permanent agent description is required.");
+            }
+            const systemPrompt = payload.systemPrompt.trim();
+            if (!systemPrompt) {
+                throw new Error("Permanent agent system prompt is required.");
+            }
+            const permissionTags = permissionTagsNormalize(payload.permissions);
+            await permissionTagsValidate(toolContext.permissions, permissionTags);
+            const config = toolContext.agentSystem.config.current;
+            const existingAgents = await agentPermanentList(config);
+            const resolvedAgent = resolveExistingAgent(existingAgents, payload.agentId, name);
+            const agentId = resolvedAgent?.agentId ?? createId();
+            const resolvedWorkspaceDir = payload.workspaceDir
+                ? await resolveWorkspaceDir(config.workspaceDir, payload.workspaceDir)
+                : resolvedAgent?.descriptor.workspaceDir ?? null;
+            const descriptor = {
+                type: "permanent",
+                id: agentId,
+                name,
+                description,
+                systemPrompt,
+                ...(resolvedWorkspaceDir ? { workspaceDir: resolvedWorkspaceDir } : {})
+            };
+            if (resolvedAgent) {
+                await agentDescriptorWrite(config, agentId, descriptor);
+                toolContext.agentSystem.updateAgentDescriptor(agentId, descriptor);
+                const state = await agentStateRead(config, agentId);
+                if (!state) {
+                    throw new Error("Permanent agent state not found.");
+                }
+                const permissions = updatePermissions(state.permissions, resolvedWorkspaceDir);
+                permissionTagsApply(permissions, permissionTags);
+                const nextState = {
+                    ...state,
+                    permissions,
+                    updatedAt: Date.now()
+                };
+                await agentStateWrite(config, agentId, nextState);
+                toolContext.agentSystem.updateAgentPermissions(agentId, nextState.permissions, nextState.updatedAt);
+            }
+            else {
+                const now = Date.now();
+                const permissions = updatePermissions(permissionClone(config.defaultPermissions), resolvedWorkspaceDir);
+                permissionTagsApply(permissions, permissionTags);
+                const state = {
+                    context: { messages: [] },
+                    permissions,
+                    tokens: null,
+                    stats: {},
+                    createdAt: now,
+                    updatedAt: now,
+                    state: "active"
+                };
+                await agentDescriptorWrite(config, agentId, descriptor);
+                await agentStateWrite(config, agentId, state);
+                await agentHistoryAppend(config, agentId, { type: "start", at: now });
+                toolContext.agentSystem.updateAgentDescriptor(agentId, descriptor);
+                toolContext.agentSystem.updateAgentPermissions(agentId, permissions, now);
+            }
+            const action = resolvedAgent ? "updated" : "created";
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [
+                    {
+                        type: "text",
+                        text: `Permanent agent ${action}: ${agentId} (name: ${name}).`
+                    }
+                ],
+                isError: false,
+                timestamp: Date.now()
+            };
+            return { toolMessage, files: [] };
+        }
+    };
+}
+function resolveExistingAgent(agents, agentId, name) {
+    if (agentId) {
+        const trimmed = agentId.trim();
+        if (!cuid2Is(trimmed)) {
+            throw new Error("agentId must be a cuid2 value.");
+        }
+        const match = agents.find((entry) => entry.agentId === trimmed) ?? null;
+        if (!match) {
+            throw new Error("Permanent agent not found for the supplied agentId.");
+        }
+        return match;
+    }
+    const normalized = normalizeName(name);
+    const matches = agents.filter((entry) => normalizeName(entry.descriptor.name) === normalized);
+    if (matches.length === 0) {
+        return null;
+    }
+    return matches.sort((a, b) => b.updatedAt - a.updatedAt)[0] ?? null;
+}
+function normalizeName(value) {
+    return value.trim().toLowerCase();
+}
+async function resolveWorkspaceDir(workspaceRoot, input) {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        throw new Error("workspaceDir must be a non-empty string when provided.");
+    }
+    const target = path.isAbsolute(trimmed)
+        ? trimmed
+        : path.resolve(workspaceRoot, trimmed);
+    const resolved = await pathResolveSecure([workspaceRoot], target);
+    await fs.mkdir(resolved.realPath, { recursive: true });
+    return resolved.realPath;
+}
+function updatePermissions(permissions, workspaceDir) {
+    if (!workspaceDir) {
+        return permissions;
+    }
+    return {
+        ...permissions,
+        workingDir: workspaceDir
+    };
+}
+//# sourceMappingURL=permanentAgentToolBuild.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,94 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it, vi } from "vitest";
+import { configResolve } from "../../../config/configResolve.js";
+import { agentPermanentList } from "../../agents/ops/agentPermanentList.js";
+import { agentStateRead } from "../../agents/ops/agentStateRead.js";
+import { permanentAgentToolBuild } from "./permanentAgentToolBuild.js";
+const toolCall = { id: "tool-1", name: "create_permanent_agent" };
+describe("permanentAgentToolBuild", () => {
+    it("applies creator-granted permissions during permanent agent creation", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-permanent-tool-"));
+        try {
+            const config = configResolve({
+                engine: { dataDir: dir },
+                assistant: { workspaceDir: dir }
+            }, path.join(dir, "settings.json"));
+            const updateAgentDescriptor = vi.fn();
+            const updateAgentPermissions = vi.fn();
+            const context = contextBuild(buildPermissions({ network: true, readDirs: ["/tmp"] }), {
+                config: { current: config },
+                updateAgentDescriptor,
+                updateAgentPermissions
+            });
+            const tool = permanentAgentToolBuild();
+            await tool.execute({
+                name: "ops",
+                description: "Ops automation",
+                systemPrompt: "Keep things running",
+                permissions: ["@network", "@read:/tmp"]
+            }, context, toolCall);
+            const agents = await agentPermanentList(config);
+            const created = agents.find((entry) => entry.descriptor.name === "ops") ?? null;
+            expect(created).not.toBeNull();
+            const state = await agentStateRead(config, created.agentId);
+            expect(state?.permissions.network).toBe(true);
+            expect(state?.permissions.readDirs).toContain(path.resolve("/tmp"));
+            expect(updateAgentDescriptor).toHaveBeenCalledTimes(1);
+            expect(updateAgentPermissions).toHaveBeenCalledTimes(1);
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+    it("rejects permissions that the creator does not have", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-permanent-tool-deny-"));
+        try {
+            const config = configResolve({
+                engine: { dataDir: dir },
+                assistant: { workspaceDir: dir }
+            }, path.join(dir, "settings.json"));
+            const context = contextBuild(buildPermissions({ network: false }), {
+                config: { current: config },
+                updateAgentDescriptor: vi.fn(),
+                updateAgentPermissions: vi.fn()
+            });
+            const tool = permanentAgentToolBuild();
+            await expect(tool.execute({
+                name: "ops",
+                description: "Ops automation",
+                systemPrompt: "Keep things running",
+                permissions: ["@network"]
+            }, context, toolCall)).rejects.toThrow("Cannot attach permission");
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+});
+function buildPermissions(overrides) {
+    return {
+        workingDir: "/workspace",
+        writeDirs: ["/workspace"],
+        readDirs: [],
+        network: false,
+        ...overrides
+    };
+}
+function contextBuild(permissions, agentSystem) {
+    return {
+        connectorRegistry: null,
+        fileStore: null,
+        auth: null,
+        logger: console,
+        assistant: null,
+        permissions,
+        agent: { id: "creator-agent" },
+        source: "test",
+        messageContext: {},
+        agentSystem: agentSystem,
+        heartbeats: null
+    };
+}
+//# sourceMappingURL=permanentAgentToolBuild.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permanentAgentToolBuild.spec.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/permanentAgentToolBuild.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,QAAQ,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC;AAElE,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,yBAAyB,CAAC,CAAC,CAAC;QAC7E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,aAAa,CAC1B;gBACE,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE;gBACxB,SAAS,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE;aACjC,EACD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAChC,CAAC;YACF,MAAM,qBAAqB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,sBAAsB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,YAAY,CAC1B,gBAAgB,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EACvD;gBACE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;gBAC3B,qBAAqB;gBACrB,sBAAsB;aACvB,CACF,CAAC;YACF,MAAM,IAAI,GAAG,uBAAuB,EAAE,CAAC;YAEvC,MAAM,IAAI,CAAC,OAAO,CAChB;gBACE,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,gBAAgB;gBAC7B,YAAY,EAAE,qBAAqB;gBACnC,WAAW,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;aACxC,EACD,OAAO,EACP,QAAQ,CACT,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC;YAChF,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,OAAQ,CAAC,OAAO,CAAC,CAAC;YAC7D,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;YACpE,MAAM,CAAC,qBAAqB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;YACvD,MAAM,CAAC,sBAAsB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,8BAA8B,CAAC,CAAC,CAAC;QAClF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,aAAa,CAC1B;gBACE,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE;gBACxB,SAAS,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE;aACjC,EACD,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAChC,CAAC;YACF,MAAM,OAAO,GAAG,YAAY,CAC1B,gBAAgB,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EACpC;gBACE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;gBAC3B,qBAAqB,EAAE,EAAE,CAAC,EAAE,EAAE;gBAC9B,sBAAsB,EAAE,EAAE,CAAC,EAAE,EAAE;aAChC,CACF,CAAC;YACF,MAAM,IAAI,GAAG,uBAAuB,EAAE,CAAC;YAEvC,MAAM,MAAM,CACV,IAAI,CAAC,OAAO,CACV;gBACE,IAAI,EAAE,KAAK;gBACX,WAAW,EAAE,gBAAgB;gBAC7B,YAAY,EAAE,qBAAqB;gBACnC,WAAW,EAAE,CAAC,UAAU,CAAC;aAC1B,EACD,OAAO,EACP,QAAQ,CACT,CACF,CAAC,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;QAChD,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,SAAS,gBAAgB,CACvB,SAAsC;IAEtC,OAAO;QACL,UAAU,EAAE,YAAY;QACxB,SAAS,EAAE,CAAC,YAAY,CAAC;QACzB,QAAQ,EAAE,EAAE;QACZ,OAAO,EAAE,KAAK;QACd,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,WAA+B,EAC/B,WAQC;IAED,OAAO;QACL,iBAAiB,EAAE,IAA4D;QAC/E,SAAS,EAAE,IAAoD;QAC/D,IAAI,EAAE,IAA+C;QACrD,MAAM,EAAE,OAAoD;QAC5D,SAAS,EAAE,IAAI;QACf,WAAW;QACX,KAAK,EAAE,EAAE,EAAE,EAAE,eAAe,EAA8C;QAC1E,MAAM,EAAE,MAAM;QACd,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,WAA6D;QAC1E,UAAU,EAAE,IAAqD;KAClE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from "@/types";
+export declare function buildPermissionRequestTool(): ToolDefinition;
+export declare function buildPermissionGrantTool(): ToolDefinition;
+//# sourceMappingURL=permissions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/permissions.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA6B9C,wBAAgB,0BAA0B,IAAI,cAAc,CAwI3D;AAED,wBAAgB,wBAAwB,IAAI,cAAc,CAiDzD"}