daycare-cli 0.0.0-canary.017f2bd

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

@@ -0,0 +1,77 @@
+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
+        }));
+        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"
+        });
+        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" },
+        ctx: null,
+        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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"}

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 owner user's home.
+ */
+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":"AAKA,OAAO,KAAK,EAAkC,cAAc,EAA4C,MAAM,SAAS,CAAC;AA6CxH;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,cAAc,CA6HxD"}

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

@@ -0,0 +1,207 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { createId } from "@paralleldrive/cuid2";
+import { Type } from "@sinclair/typebox";
+import { cuid2Is } from "../../../utils/cuid2Is.js";
+import { agentDescriptorWrite } from "../../agents/ops/agentDescriptorWrite.js";
+import { agentPermanentList } from "../../agents/ops/agentPermanentList.js";
+import { agentStateRead } from "../../agents/ops/agentStateRead.js";
+import { agentStateWrite } from "../../agents/ops/agentStateWrite.js";
+import { pathResolveSecure } from "../../permissions/pathResolveSecure.js";
+import { permissionBuildUser } from "../../permissions/permissionBuildUser.js";
+import { permissionTagsApply } from "../../permissions/permissionTagsApply.js";
+import { permissionTagsNormalize } from "../../permissions/permissionTagsNormalize.js";
+import { permissionTagsValidate } from "../../permissions/permissionTagsValidate.js";
+const schema = Type.Object({
+    name: Type.String({ minLength: 1 }),
+    username: Type.Optional(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 });
+const permanentAgentResultSchema = Type.Object({
+    summary: Type.String(),
+    agentId: Type.String(),
+    name: Type.String(),
+    action: Type.String()
+}, { additionalProperties: false });
+const permanentAgentReturns = {
+    schema: permanentAgentResultSchema,
+    toLLMText: (result) => result.summary
+};
+/**
+ * Builds the create_permanent_agent tool to create or update permanent agents.
+ * Expects: agent name + system prompt are provided; workspaceDir stays within the owner user's home.
+ */
+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
+        },
+        returns: permanentAgentReturns,
+        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 username = payload.username?.trim();
+            if (payload.username !== undefined && !username) {
+                throw new Error("Permanent agent username must be non-empty when provided.");
+            }
+            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 storage = toolContext.agentSystem.storage;
+            const existingAgents = await agentPermanentList(storage);
+            const resolvedAgent = resolveExistingAgent(existingAgents, payload.agentId, name);
+            const agentId = resolvedAgent?.agentId ?? createId();
+            const ownerUserId = contextUserIdResolve(toolContext);
+            const ownerUserHome = toolContext.agentSystem.userHomeForUserId(ownerUserId);
+            const resolvedWorkspaceDir = payload.workspaceDir
+                ? await resolveWorkspaceDir(ownerUserHome.home, payload.workspaceDir)
+                : (resolvedAgent?.descriptor.workspaceDir ?? null);
+            const descriptor = {
+                type: "permanent",
+                id: agentId,
+                name,
+                ...(username
+                    ? { username }
+                    : resolvedAgent?.descriptor.username
+                        ? { username: resolvedAgent.descriptor.username }
+                        : {}),
+                description,
+                systemPrompt,
+                ...(resolvedWorkspaceDir ? { workspaceDir: resolvedWorkspaceDir } : {})
+            };
+            const basePermissions = permissionBuildUser(ownerUserHome);
+            if (resolvedAgent) {
+                await agentDescriptorWrite(storage, agentId, descriptor, ownerUserId, basePermissions);
+                toolContext.agentSystem.updateAgentDescriptor(agentId, descriptor);
+                const state = await agentStateRead(storage, 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(storage, agentId, nextState);
+                toolContext.agentSystem.updateAgentPermissions(agentId, nextState.permissions, nextState.updatedAt);
+            }
+            else {
+                const now = Date.now();
+                const permissions = updatePermissions(basePermissions, resolvedWorkspaceDir);
+                permissionTagsApply(permissions, permissionTags);
+                const state = {
+                    context: { messages: [] },
+                    activeSessionId: null,
+                    inferenceSessionId: createId(),
+                    permissions,
+                    tokens: null,
+                    stats: {},
+                    createdAt: now,
+                    updatedAt: now,
+                    state: "active"
+                };
+                await agentDescriptorWrite(storage, agentId, descriptor, ownerUserId, basePermissions);
+                await agentStateWrite(storage, agentId, state);
+                state.activeSessionId = await storage.sessions.create({
+                    agentId,
+                    inferenceSessionId: state.inferenceSessionId,
+                    createdAt: now
+                });
+                await agentStateWrite(storage, agentId, state);
+                toolContext.agentSystem.updateAgentDescriptor(agentId, descriptor);
+                toolContext.agentSystem.updateAgentPermissions(agentId, permissions, now);
+            }
+            const action = resolvedAgent ? "updated" : "created";
+            const summary = `Permanent agent ${action}: ${agentId} (name: ${name}).`;
+            const toolMessage = {
+                role: "toolResult",
+                toolCallId: toolCall.id,
+                toolName: toolCall.name,
+                content: [
+                    {
+                        type: "text",
+                        text: summary
+                    }
+                ],
+                isError: false,
+                timestamp: Date.now()
+            };
+            return {
+                toolMessage,
+                typedResult: {
+                    summary,
+                    agentId,
+                    name,
+                    action
+                }
+            };
+        }
+    };
+}
+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
+    };
+}
+function contextUserIdResolve(context) {
+    const userId = context.ctx?.userId;
+    if (!userId) {
+        throw new Error("Tool context userId is required.");
+    }
+    return userId;
+}
+//# 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":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAe,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AACvF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAErF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CACtB;IACI,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACtD,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAC1C,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAC3C,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1D,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;IACrD,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;CACzF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAClC,CAAC;AAIF,MAAM,0BAA0B,GAAG,IAAI,CAAC,MAAM,CAC1C;IACI,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;IACtB,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;IACtB,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;CACxB,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAClC,CAAC;AAIF,MAAM,qBAAqB,GAA6C;IACpE,MAAM,EAAE,0BAA0B;IAClC,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO;CACxC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,uBAAuB;IACnC,OAAO;QACH,IAAI,EAAE;YACF,IAAI,EAAE,wBAAwB;YAC9B,WAAW,EAAE,qFAAqF;YAClG,UAAU,EAAE,MAAM;SACrB;QACD,OAAO,EAAE,qBAAqB;QAC9B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE;YAC3C,MAAM,OAAO,GAAG,IAA0B,CAAC;YAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACR,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACzD,CAAC;YACD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YAC/C,IAAI,CAAC,WAAW,EAAE,CAAC;gBACf,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;YAChE,CAAC;YACD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC1C,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC9C,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;YACjF,CAAC;YACD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YACjD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,cAAc,GAAG,uBAAuB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YACpE,MAAM,sBAAsB,CAAC,WAAW,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAEtE,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC,OAAO,CAAC;YAChD,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;YACzD,MAAM,aAAa,GAAG,oBAAoB,CAAC,cAAc,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAClF,MAAM,OAAO,GAAG,aAAa,EAAE,OAAO,IAAI,QAAQ,EAAE,CAAC;YACrD,MAAM,WAAW,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;YACtD,MAAM,aAAa,GAAG,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;YAC7E,MAAM,oBAAoB,GAAG,OAAO,CAAC,YAAY;gBAC7C,CAAC,CAAC,MAAM,mBAAmB,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC;gBACrE,CAAC,CAAC,CAAC,aAAa,EAAE,UAAU,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC;YAEvD,MAAM,UAAU,GAAG;gBACf,IAAI,EAAE,WAAoB;gBAC1B,EAAE,EAAE,OAAO;gBACX,IAAI;gBACJ,GAAG,CAAC,QAAQ;oBACR,CAAC,CAAC,EAAE,QAAQ,EAAE;oBACd,CAAC,CAAC,aAAa,EAAE,UAAU,CAAC,QAAQ;wBAClC,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,QAAQ,EAAE;wBACjD,CAAC,CAAC,EAAE,CAAC;gBACX,WAAW;gBACX,YAAY;gBACZ,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1E,CAAC;YACF,MAAM,eAAe,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;YAE3D,IAAI,aAAa,EAAE,CAAC;gBAChB,MAAM,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;gBACvF,WAAW,CAAC,WAAW,CAAC,qBAAqB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;gBAEnE,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACrD,IAAI,CAAC,KAAK,EAAE,CAAC;oBACT,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBACxD,CAAC;gBACD,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,WAAW,EAAE,oBAAoB,CAAC,CAAC;gBAC/E,mBAAmB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;gBACjD,MAAM,SAAS,GAAe;oBAC1B,GAAG,KAAK;oBACR,WAAW;oBACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACxB,CAAC;gBACF,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;gBACnD,WAAW,CAAC,WAAW,CAAC,sBAAsB,CAAC,OAAO,EAAE,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;YACxG,CAAC;iBAAM,CAAC;gBACJ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,MAAM,WAAW,GAAG,iBAAiB,CAAC,eAAe,EAAE,oBAAoB,CAAC,CAAC;gBAC7E,mBAAmB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;gBACjD,MAAM,KAAK,GAAe;oBACtB,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;oBACzB,eAAe,EAAE,IAAI;oBACrB,kBAAkB,EAAE,QAAQ,EAAE;oBAC9B,WAAW;oBACX,MAAM,EAAE,IAAI;oBACZ,KAAK,EAAE,EAAE;oBACT,SAAS,EAAE,GAAG;oBACd,SAAS,EAAE,GAAG;oBACd,KAAK,EAAE,QAAQ;iBAClB,CAAC;gBACF,MAAM,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC;gBACvF,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC/C,KAAK,CAAC,eAAe,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;oBAClD,OAAO;oBACP,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;oBAC5C,SAAS,EAAE,GAAG;iBACjB,CAAC,CAAC;gBACH,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;gBAC/C,WAAW,CAAC,WAAW,CAAC,qBAAqB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;gBACnE,WAAW,CAAC,WAAW,CAAC,sBAAsB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;YAC9E,CAAC;YAED,MAAM,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;YACrD,MAAM,OAAO,GAAG,mBAAmB,MAAM,KAAK,OAAO,WAAW,IAAI,IAAI,CAAC;YACzE,MAAM,WAAW,GAAsB;gBACnC,IAAI,EAAE,YAAY;gBAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,QAAQ,EAAE,QAAQ,CAAC,IAAI;gBACvB,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,OAAO;qBAChB;iBACJ;gBACD,OAAO,EAAE,KAAK;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACxB,CAAC;YAEF,OAAO;gBACH,WAAW;gBACX,WAAW,EAAE;oBACT,OAAO;oBACP,OAAO;oBACP,IAAI;oBACJ,MAAM;iBACT;aACJ,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC;AAED,SAAS,oBAAoB,CACzB,MAA+B,EAC/B,OAA2B,EAC3B,IAAY;IAEZ,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC;QACxE,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,CAAC;IAC9F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACxE,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACtC,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,aAAqB,EAAE,KAAa;IACnE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACzF,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC;IAClE,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,OAAO,QAAQ,CAAC,QAAQ,CAAC;AAC7B,CAAC;AAED,SAAS,iBAAiB,CAAC,WAA+B,EAAE,YAA2B;IACnF,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,OAAO,WAAW,CAAC;IACvB,CAAC;IACD,OAAO;QACH,GAAG,WAAW;QACd,UAAU,EAAE,YAAY;KAC3B,CAAC;AACN,CAAC;AAED,SAAS,oBAAoB,CAAC,OAA6B;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

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,166 @@
+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 { Storage } from "../../../storage/storage.js";
+import { agentPermanentList } from "../../agents/ops/agentPermanentList.js";
+import { agentStateRead } from "../../agents/ops/agentStateRead.js";
+import { UserHome } from "../../users/userHome.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 }
+            }, path.join(dir, "settings.json"));
+            const storage = Storage.open(config.dbPath);
+            const updateAgentDescriptor = vi.fn();
+            const updateAgentPermissions = vi.fn();
+            const context = contextBuild(buildPermissions({ network: true, readDirs: ["/tmp"] }), {
+                config: { current: config },
+                storage,
+                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);
+            storage.close();
+        }
+        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 }
+            }, path.join(dir, "settings.json"));
+            const storage = Storage.open(config.dbPath);
+            const context = contextBuild(buildPermissions({ network: false }), {
+                config: { current: config },
+                storage,
+                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");
+            storage.close();
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+    it("stores username on permanent agent descriptor when provided", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-permanent-tool-username-"));
+        try {
+            const config = configResolve({
+                engine: { dataDir: dir }
+            }, path.join(dir, "settings.json"));
+            const storage = Storage.open(config.dbPath);
+            const tool = permanentAgentToolBuild();
+            const context = contextBuild(buildPermissions({ network: false }), {
+                config: { current: config },
+                storage,
+                updateAgentDescriptor: vi.fn(),
+                updateAgentPermissions: vi.fn()
+            });
+            await tool.execute({
+                name: "ops",
+                username: "opsbot",
+                description: "Operations agent",
+                systemPrompt: "Run operations tasks"
+            }, context, toolCall);
+            const agents = await agentPermanentList(config);
+            const created = agents.find((entry) => entry.descriptor.name === "ops") ?? null;
+            expect(created?.descriptor.username).toBe("opsbot");
+            storage.close();
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+    it("throws a clear error when context userId is missing", async () => {
+        const dir = await mkdtemp(path.join(os.tmpdir(), "daycare-permanent-tool-missing-user-"));
+        try {
+            const config = configResolve({
+                engine: { dataDir: dir }
+            }, path.join(dir, "settings.json"));
+            const storage = Storage.open(config.dbPath);
+            const tool = permanentAgentToolBuild();
+            const context = {
+                ...contextBuild(buildPermissions({ network: false }), {
+                    config: { current: config },
+                    storage,
+                    updateAgentDescriptor: vi.fn(),
+                    updateAgentPermissions: vi.fn()
+                }),
+                ctx: null
+            };
+            await expect(tool.execute({
+                name: "ops",
+                description: "Operations agent",
+                systemPrompt: "Run operations tasks"
+            }, context, toolCall)).rejects.toThrow("Tool context userId is required.");
+            storage.close();
+        }
+        finally {
+            await rm(dir, { recursive: true, force: true });
+        }
+    });
+});
+function buildPermissions(overrides) {
+    return {
+        workingDir: "/workspace",
+        writeDirs: ["/workspace"],
+        readDirs: [],
+        network: false,
+        events: false,
+        ...overrides
+    };
+}
+function contextBuild(permissions, agentSystem) {
+    return {
+        connectorRegistry: null,
+        fileStore: null,
+        auth: null,
+        logger: console,
+        assistant: null,
+        permissions,
+        agent: { id: "creator-agent" },
+        ctx: {
+            agentId: "creator-agent",
+            userId: "creator-user"
+        },
+        source: "test",
+        messageContext: {},
+        agentSystem: {
+            ...agentSystem,
+            userHomeForUserId: agentSystem.userHomeForUserId ??
+                ((userId) => new UserHome(agentSystem.config.current.usersDir, userId))
+        },
+        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":"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"}

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

@@ -0,0 +1,13 @@
+import type { PermissionDecision } from "@/types";
+/**
+ * Tracks pending permission requests so tool calls can wait for user decisions.
+ * Expects: token values are unique per in-flight request.
+ */
+export declare class PermissionRequestRegistry {
+    private pending;
+    register(token: string, timeoutMs: number): Promise<PermissionDecision>;
+    resolve(token: string, decision: PermissionDecision): boolean;
+    cancel(token: string): void;
+    private pendingTake;
+}
+//# sourceMappingURL=permissionRequestRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissionRequestRegistry.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/permissionRequestRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAQlD;;;GAGG;AACH,qBAAa,yBAAyB;IAClC,OAAO,CAAC,OAAO,CAA+C;IAE9D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqBvE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO;IAU7D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS3B,OAAO,CAAC,WAAW;CAQtB"}

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

@@ -0,0 +1,51 @@
+/**
+ * Tracks pending permission requests so tool calls can wait for user decisions.
+ * Expects: token values are unique per in-flight request.
+ */
+export class PermissionRequestRegistry {
+    pending = new Map();
+    register(token, timeoutMs) {
+        if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+            throw new Error("Permission timeout must be greater than zero.");
+        }
+        if (this.pending.has(token)) {
+            throw new Error("Permission token is already pending.");
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                const entry = this.pendingTake(token);
+                if (!entry) {
+                    return;
+                }
+                entry.reject(new Error("Permission request timed out."));
+            }, timeoutMs);
+            this.pending.set(token, { resolve, reject, timer });
+        });
+    }
+    resolve(token, decision) {
+        const entry = this.pendingTake(token);
+        if (!entry) {
+            return false;
+        }
+        clearTimeout(entry.timer);
+        entry.resolve(decision);
+        return true;
+    }
+    cancel(token) {
+        const entry = this.pendingTake(token);
+        if (!entry) {
+            return;
+        }
+        clearTimeout(entry.timer);
+        entry.reject(new Error("Permission request cancelled."));
+    }
+    pendingTake(token) {
+        const entry = this.pending.get(token);
+        if (!entry) {
+            return null;
+        }
+        this.pending.delete(token);
+        return entry;
+    }
+}
+//# sourceMappingURL=permissionRequestRegistry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissionRequestRegistry.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/permissionRequestRegistry.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,OAAO,yBAAyB;IAC1B,OAAO,GAAG,IAAI,GAAG,EAAoC,CAAC;IAE9D,QAAQ,CAAC,KAAa,EAAE,SAAiB;QACrC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,IAAI,OAAO,CAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACvD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;gBACtC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACT,OAAO;gBACX,CAAC;gBACD,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;YAC7D,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,CAAC,KAAa,EAAE,QAA4B;QAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,KAAa;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO;QACX,CAAC;QACD,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;IAC7D,CAAC;IAEO,WAAW,CAAC,KAAa;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ"}

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

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

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

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

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

@@ -0,0 +1,47 @@
+import { describe, expect, it, vi } from "vitest";
+import { PermissionRequestRegistry } from "./permissionRequestRegistry.js";
+describe("PermissionRequestRegistry", () => {
+    it("resolves pending request when a decision arrives", async () => {
+        const registry = new PermissionRequestRegistry();
+        const decision = decisionBuild({ token: "token-1", approved: true });
+        const pending = registry.register("token-1", 1_000);
+        const resolved = registry.resolve("token-1", decision);
+        expect(resolved).toBe(true);
+        await expect(pending).resolves.toEqual(decision);
+    });
+    it("rejects pending request when timeout is reached", async () => {
+        vi.useFakeTimers();
+        try {
+            const registry = new PermissionRequestRegistry();
+            const pending = registry.register("token-1", 5_000);
+            const rejection = expect(pending).rejects.toThrow("Permission request timed out.");
+            await vi.advanceTimersByTimeAsync(5_000);
+            await rejection;
+        }
+        finally {
+            vi.useRealTimers();
+        }
+    });
+    it("returns false for unknown token resolve", () => {
+        const registry = new PermissionRequestRegistry();
+        const resolved = registry.resolve("missing", decisionBuild({ token: "missing" }));
+        expect(resolved).toBe(false);
+    });
+    it("rejects pending request when cancelled", async () => {
+        const registry = new PermissionRequestRegistry();
+        const pending = registry.register("token-1", 1_000);
+        const rejection = expect(pending).rejects.toThrow("Permission request cancelled.");
+        registry.cancel("token-1");
+        await rejection;
+    });
+});
+function decisionBuild(overrides = {}) {
+    return {
+        token: "token-1",
+        agentId: "agent-1",
+        approved: false,
+        permissions: [{ permission: "@network", access: { kind: "network" } }],
+        ...overrides
+    };
+}
+//# sourceMappingURL=permissionRequestRegistry.spec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"permissionRequestRegistry.spec.js","sourceRoot":"","sources":["../../../../sources/engine/modules/tools/permissionRequestRegistry.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAGlD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAC;QACjD,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAErE,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEvD,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC7D,EAAE,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAC;YACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACpD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;YAEnF,MAAM,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;YAEzC,MAAM,SAAS,CAAC;QACpB,CAAC;gBAAS,CAAC;YACP,EAAE,CAAC,aAAa,EAAE,CAAC;QACvB,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAC/C,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAC;QAEjD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAElF,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACpD,MAAM,QAAQ,GAAG,IAAI,yBAAyB,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACpD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;QAEnF,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAE3B,MAAM,SAAS,CAAC;IACpB,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,SAAS,aAAa,CAAC,YAAyC,EAAE;IAC9D,OAAO;QACH,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,KAAK;QACf,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;QACtE,GAAG,SAAS;KACf,CAAC;AACN,CAAC"}