daycare-cli 0.0.0-canary.f57680e

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

@@ -0,0 +1,187 @@
+import { Type } from "@sinclair/typebox";
+import { execGateNormalize } from "../../scheduling/execGateNormalize.js";
+const envSchema = Type.Record(Type.String({ minLength: 1 }), Type.Union([Type.String(), Type.Number(), Type.Boolean()]));
+const runSchema = Type.Object({
+    ids: Type.Optional(Type.Array(Type.String({ minLength: 1 })))
+}, { additionalProperties: false });
+const addSchema = Type.Object({
+    id: Type.Optional(Type.String({ minLength: 1 })),
+    title: Type.String({ minLength: 1 }),
+    prompt: Type.String({ minLength: 1 }),
+    gate: Type.Optional(Type.Object({
+        command: Type.String({ minLength: 1 }),
+        cwd: Type.Optional(Type.String({ minLength: 1 })),
+        timeoutMs: Type.Optional(Type.Number({ minimum: 100, maximum: 300_000 })),
+        env: Type.Optional(envSchema),
+        home: Type.Optional(Type.String({ minLength: 1 })),
+        permissions: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 })),
+        packageManagers: Type.Optional(Type.Array(Type.Union([
+            Type.Literal("dart"),
+            Type.Literal("dotnet"),
+            Type.Literal("go"),
+            Type.Literal("java"),
+            Type.Literal("node"),
+            Type.Literal("php"),
+            Type.Literal("python"),
+            Type.Literal("ruby"),
+            Type.Literal("rust")
+        ]), { minItems: 1 })),
+        allowedDomains: Type.Optional(Type.Array(Type.String({ minLength: 1 }), { minItems: 1 }))
+    }, { additionalProperties: false })),
+    overwrite: Type.Optional(Type.Boolean())
+}, { additionalProperties: false });
+const removeSchema = Type.Object({
+    id: Type.String({ minLength: 1 })
+}, { additionalProperties: false });
+const heartbeatRunResultSchema = Type.Object({
+    summary: Type.String(),
+    ran: Type.Number()
+}, { additionalProperties: false });
+const heartbeatRunReturns = {
+    schema: heartbeatRunResultSchema,
+    toLLMText: (result) => result.summary
+};
+const heartbeatAddResultSchema = Type.Object({
+    summary: Type.String(),
+    taskId: Type.String(),
+    title: Type.String()
+}, { additionalProperties: false });
+const heartbeatAddReturns = {
+    schema: heartbeatAddResultSchema,
+    toLLMText: (result) => result.summary
+};
+const heartbeatRemoveResultSchema = Type.Object({
+    summary: Type.String(),
+    taskId: Type.String(),
+    removed: Type.Boolean()
+}, { additionalProperties: false });
+const heartbeatRemoveReturns = {
+    schema: heartbeatRemoveResultSchema,
+    toLLMText: (result) => result.summary
+};
+export function buildHeartbeatRunTool() {
+    return {
+        tool: {
+            name: "heartbeat_run",
+            description: "Run heartbeat tasks immediately as a single batch instead of waiting for the next interval.",
+            parameters: runSchema
+        },
+        returns: heartbeatRunReturns,
+        execute: async (args, toolContext, toolCall) => {
+            const payload = args;
+            const result = await toolContext.heartbeats.runNow({ ids: payload.ids });
+            const summary = result.ran > 0
+                ? `Heartbeat ran ${result.ran} task(s): ${result.taskIds.join(", ")}.`
+                : "No heartbeat tasks ran.";
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [
+                    {
+                        type: "text",
+                        text: summary
+                    }
+                ],
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    ran: result.ran
+                }
+            };
+        }
+    };
+}
+export function buildHeartbeatAddTool() {
+    return {
+        tool: {
+            name: "heartbeat_add",
+            description: "Create or update a heartbeat prompt stored in config/heartbeat (optional gate).",
+            parameters: addSchema
+        },
+        returns: heartbeatAddReturns,
+        execute: async (args, toolContext, toolCall) => {
+            const payload = args;
+            const gate = execGateNormalize(payload.gate);
+            const result = await toolContext.heartbeats.addTask({
+                id: payload.id,
+                title: payload.title,
+                prompt: payload.prompt,
+                gate,
+                overwrite: payload.overwrite
+            });
+            const summary = `Heartbeat saved: ${result.id} (${result.title}).`;
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [
+                    {
+                        type: "text",
+                        text: summary
+                    }
+                ],
+                details: {
+                    id: result.id,
+                    title: result.title,
+                    filePath: result.filePath,
+                    gate: result.gate ?? null
+                },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    taskId: result.id,
+                    title: result.title
+                }
+            };
+        }
+    };
+}
+export function buildHeartbeatRemoveTool() {
+    return {
+        tool: {
+            name: "heartbeat_remove",
+            description: "Delete a heartbeat task.",
+            parameters: removeSchema
+        },
+        returns: heartbeatRemoveReturns,
+        execute: async (args, toolContext, toolCall) => {
+            const payload = args;
+            const removed = await toolContext.heartbeats.removeTask(payload.id);
+            const summary = removed
+                ? `Removed heartbeat ${payload.id}.`
+                : `Heartbeat not found: ${payload.id}.`;
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [
+                    {
+                        type: "text",
+                        text: summary
+                    }
+                ],
+                details: { id: payload.id, removed },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    taskId: payload.id,
+                    removed
+                }
+            };
+        }
+    };
+}
+//# sourceMappingURL=heartbeat.js.map

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

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

package/dist/engine/modules/tools/image-generation.d.ts

@@ -0,0 +1,4 @@
+import type { ImageGenerationRegistry } from "../imageGenerationRegistry.js";
+import type { ToolDefinition } from "@/types";
+export declare function buildImageGenerationTool(imageRegistry: ImageGenerationRegistry): ToolDefinition;
+//# sourceMappingURL=image-generation.d.ts.map

package/dist/engine/modules/tools/image-generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-generation.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/image-generation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAmClE,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,uBAAuB,GACrC,cAAc,CAqGhB"}

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

@@ -0,0 +1,114 @@
+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 });
+const imageGenerationResultSchema = Type.Object({
+    summary: Type.String(),
+    provider: Type.String(),
+    fileCount: Type.Number(),
+    workspaceDir: Type.String()
+}, { additionalProperties: false });
+const imageGenerationReturns = {
+    schema: imageGenerationResultSchema,
+    toLLMText: (result) => result.summary
+};
+export function buildImageGenerationTool(imageRegistry) {
+    return {
+        tool: {
+            name: "generate_image",
+            description: "Generate one or more images using the configured image provider.",
+            parameters: schema
+        },
+        returns: imageGenerationReturns,
+        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 workspaceFilesDir = path.join(workspaceDir, "files");
+            await fs.mkdir(workspaceFilesDir, { recursive: true });
+            const createdAt = new Date();
+            const timestamp = createdAt.toISOString().replace(/[:.]/g, "-");
+            const summary = `Generated ${result.files.length} image(s) with ${providerId}. Saved under ${workspaceFilesDir}.`;
+            const content = [
+                {
+                    type: "text",
+                    text: summary
+                }
+            ];
+            const workspaceFiles = [];
+            for (const [index, file] of result.files.entries()) {
+                if (!file.mimeType.startsWith("image/")) {
+                    continue;
+                }
+                const suffix = result.files.length > 1 ? `-${index + 1}` : "";
+                const filename = `${timestamp}${suffix}.png`;
+                const outputPath = path.join(workspaceFilesDir, filename);
+                await fs.copyFile(file.path, outputPath);
+                workspaceFiles.push({ name: filename, path: outputPath, mimeType: file.mimeType });
+                content.push({
+                    type: "text",
+                    text: `Image file: ${outputPath} (${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: workspaceFilesDir,
+                        files: workspaceFiles
+                    }
+                },
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    provider: providerId,
+                    fileCount: workspaceFiles.length,
+                    workspaceDir: workspaceFilesDir
+                }
+            };
+        }
+    };
+}
+//# 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/image-generation.spec.d.ts

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

package/dist/engine/modules/tools/image-generation.spec.d.ts.map

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

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

@@ -0,0 +1,72 @@
+import { promises as fs } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { ImageGenerationRegistry } from "../imageGenerationRegistry.js";
+import { buildImageGenerationTool } from "./image-generation.js";
+describe("buildImageGenerationTool", () => {
+    it("returns file path references without embedding image bytes", async () => {
+        const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "daycare-image-tool-"));
+        try {
+            const sourcePath = path.join(tempDir, "source.png");
+            await fs.writeFile(sourcePath, Buffer.from("png-bytes"));
+            const imageRegistry = new ImageGenerationRegistry();
+            imageRegistry.register("test-plugin", {
+                id: "test-provider",
+                label: "Test Provider",
+                generate: async () => ({
+                    files: [
+                        {
+                            id: "file-1",
+                            name: "source.png",
+                            mimeType: "image/png",
+                            size: 9,
+                            path: sourcePath
+                        }
+                    ]
+                })
+            });
+            const tool = buildImageGenerationTool(imageRegistry);
+            const result = await tool.execute({ prompt: "draw" }, contextBuild(tempDir), { id: "call-1", name: "generate_image" });
+            const workspace = result.toolMessage.details?.workspace;
+            expect(workspace?.dir).toBe(path.join(tempDir, "files"));
+            expect(workspace?.files).toHaveLength(1);
+            const generatedPath = workspace?.files[0]?.path;
+            expect(generatedPath).toBeTruthy();
+            if (!generatedPath) {
+                throw new Error("Missing generated file path");
+            }
+            const generatedData = await fs.readFile(generatedPath, "utf8");
+            expect(generatedData).toBe("png-bytes");
+            const content = result.toolMessage.content;
+            expect(content.every((block) => block.type === "text")).toBe(true);
+            expect(content.some((block) => (block.text ?? "").includes(generatedPath))).toBe(true);
+            expect(content.every((block) => !("data" in block))).toBe(true);
+        }
+        finally {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+    });
+});
+function contextBuild(workingDir) {
+    return {
+        connectorRegistry: null,
+        fileStore: null,
+        auth: null,
+        logger: console,
+        assistant: null,
+        permissions: {
+            workingDir,
+            writeDirs: [],
+            readDirs: [],
+            network: false,
+            events: false
+        },
+        agent: { id: "agent-test" },
+        source: "test",
+        messageContext: {},
+        agentSystem: null,
+        heartbeats: null
+    };
+}
+//# sourceMappingURL=image-generation.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image-generation.spec.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/image-generation.spec.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,EAAsB,MAAM,SAAS,CAAC;AAGlE,QAAA,MAAM,MAAM;;;;;EAQX,CAAC;AAiCF;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAAC,OAAO,MAAM,CAAC,CAwEnE"}

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

@@ -0,0 +1,107 @@
+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 });
+const mermaidPngResultSchema = Type.Object({
+    summary: Type.String(),
+    fileId: Type.String(),
+    fileName: Type.String(),
+    theme: Type.String(),
+    width: Type.Number()
+}, { additionalProperties: false });
+const mermaidPngReturns = {
+    schema: mermaidPngResultSchema,
+    toLLMText: (result) => result.summary
+};
+/**
+ * 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
+        },
+        returns: mermaidPngReturns,
+        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 summary = `Generated Mermaid PNG: ${stored.path}`;
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [
+                    {
+                        type: "text",
+                        text: summary
+                    }
+                ],
+                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,
+                typedResult: {
+                    summary,
+                    fileId: stored.id,
+                    fileName: stored.name,
+                    theme: themeName,
+                    width: payload.width ?? 1600
+                }
+            };
+        }
+    };
+}
+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,79 @@
+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.toolMessage.isError).toBe(false);
+        expect(result.toolMessage.content).toEqual([
+            {
+                type: "text",
+                text: "Generated Mermaid PNG: /tmp/file-1.png"
+            }
+        ]);
+    });
+    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,
+            events: 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":"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"}