daycare-cli 0.0.12 → 0.0.13

package/dist/engine/modules/rlm/rlmConvert.js

@@ -0,0 +1,81 @@
+/**
+ * Converts Monty positional/keyword arguments into the JSON object expected by tool execution.
+ * Expects: positional argument order matches tool parameter property order.
+ */
+export function rlmArgsConvert(args, kwargs, toolSchema) {
+    const propertyNames = toolParameterNamesResolve(toolSchema);
+    const output = {};
+    for (let index = 0; index < args.length; index += 1) {
+        const name = propertyNames[index];
+        if (!name) {
+            throw new Error(`Too many positional arguments for tool ${toolSchema.name}.`);
+        }
+        output[name] = montyValueConvert(args[index]);
+    }
+    const convertedKwargs = montyValueConvert(kwargs);
+    if (!recordIs(convertedKwargs)) {
+        throw new Error("Tool kwargs must convert to an object.");
+    }
+    for (const [name, value] of Object.entries(convertedKwargs)) {
+        output[name] = value;
+    }
+    return output;
+}
+/**
+ * Converts a tool execution result into a Python-friendly string value.
+ * Expects: tool result content follows the ToolResultMessage text block convention.
+ */
+export function rlmResultConvert(toolResult) {
+    const text = toolResult.toolMessage.content
+        .filter((part) => part.type === "text")
+        .map((part) => ("text" in part && typeof part.text === "string" ? part.text : ""))
+        .join("\n")
+        .trim();
+    if (text.length > 0) {
+        return text;
+    }
+    if (toolResult.toolMessage.isError) {
+        return "Tool execution failed.";
+    }
+    return "";
+}
+function toolParameterNamesResolve(tool) {
+    if (!recordIs(tool.parameters)) {
+        return [];
+    }
+    const properties = tool.parameters.properties;
+    if (!recordIs(properties)) {
+        return [];
+    }
+    return Object.keys(properties);
+}
+function montyValueConvert(value) {
+    if (typeof value === "bigint") {
+        if (value <= BigInt(Number.MAX_SAFE_INTEGER) && value >= BigInt(Number.MIN_SAFE_INTEGER)) {
+            return Number(value);
+        }
+        return value.toString();
+    }
+    if (value instanceof Map) {
+        const result = {};
+        for (const [key, item] of value.entries()) {
+            result[String(key)] = montyValueConvert(item);
+        }
+        return result;
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => montyValueConvert(entry));
+    }
+    if (!recordIs(value)) {
+        return value;
+    }
+    const result = {};
+    for (const [key, entry] of Object.entries(value)) {
+        result[key] = montyValueConvert(entry);
+    }
+    return result;
+}
+function recordIs(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=rlmConvert.js.map

package/dist/engine/modules/rlm/rlmConvert.js.map

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

package/dist/engine/modules/rlm/rlmConvert.spec.d.ts

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

package/dist/engine/modules/rlm/rlmConvert.spec.d.ts.map

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

package/dist/engine/modules/rlm/rlmConvert.spec.js

@@ -0,0 +1,71 @@
+import { describe, expect, it } from "vitest";
+import { Type } from "@sinclair/typebox";
+import { rlmArgsConvert, rlmResultConvert } from "./rlmConvert.js";
+describe("rlmArgsConvert", () => {
+    const tool = {
+        name: "write_file",
+        description: "",
+        parameters: Type.Object({
+            path: Type.String(),
+            content: Type.String(),
+            mode: Type.Optional(Type.String())
+        }, { additionalProperties: false })
+    };
+    it("maps positional arguments by schema property order", () => {
+        const converted = rlmArgsConvert(["/tmp/a.txt", "hello"], {}, tool);
+        expect(converted).toEqual({
+            path: "/tmp/a.txt",
+            content: "hello"
+        });
+    });
+    it("merges kwargs and lets kwargs override positional args", () => {
+        const converted = rlmArgsConvert(["/tmp/a.txt", "hello"], { content: "override" }, tool);
+        expect(converted).toEqual({
+            path: "/tmp/a.txt",
+            content: "override"
+        });
+    });
+    it("converts nested Monty map and bigint values", () => {
+        const converted = rlmArgsConvert(["/tmp/a.txt", new Map([["count", BigInt(3)]])], {}, tool);
+        expect(converted).toEqual({
+            path: "/tmp/a.txt",
+            content: {
+                count: 3
+            }
+        });
+    });
+});
+describe("rlmResultConvert", () => {
+    it("returns joined text content", () => {
+        const result = {
+            toolMessage: {
+                role: "toolResult",
+                toolCallId: "1",
+                toolName: "x",
+                content: [
+                    { type: "text", text: "hello" },
+                    { type: "text", text: "world" }
+                ],
+                isError: false,
+                timestamp: Date.now()
+            },
+            files: []
+        };
+        expect(rlmResultConvert(result)).toBe("hello\nworld");
+    });
+    it("returns fallback error text for empty error payloads", () => {
+        const result = {
+            toolMessage: {
+                role: "toolResult",
+                toolCallId: "1",
+                toolName: "x",
+                content: [],
+                isError: true,
+                timestamp: Date.now()
+            },
+            files: []
+        };
+        expect(rlmResultConvert(result)).toBe("Tool execution failed.");
+    });
+});
+//# sourceMappingURL=rlmConvert.spec.js.map

package/dist/engine/modules/rlm/rlmConvert.spec.js.map

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

package/dist/engine/modules/rlm/rlmExecute.d.ts

@@ -0,0 +1,13 @@
+import type { ToolExecutionContext } from "@/types";
+import type { ToolResolver } from "../toolResolver.js";
+export type RlmExecuteResult = {
+    output: string;
+    printOutput: string[];
+    toolCallCount: number;
+};
+/**
+ * Executes Monty Python code by routing external function calls into ToolResolver.
+ * Expects: preamble matches the currently available tool names.
+ */
+export declare function rlmExecute(code: string, preamble: string, context: ToolExecutionContext, toolResolver: ToolResolver): Promise<RlmExecuteResult>;
+//# sourceMappingURL=rlmExecute.d.ts.map

package/dist/engine/modules/rlm/rlmExecute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rlmExecute.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/rlm/rlmExecute.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAWvD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,EAC7B,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAmF3B"}

package/dist/engine/modules/rlm/rlmExecute.js

@@ -0,0 +1,120 @@
+import { Monty, MontySnapshot } from "@pydantic/monty";
+import { createId } from "@paralleldrive/cuid2";
+import { rlmArgsConvert, rlmResultConvert } from "./rlmConvert.js";
+import { RLM_PRINT_FUNCTION_NAME, RLM_TOOL_NAME } from "./rlmConstants.js";
+const RLM_LIMITS = {
+    maxDurationSecs: 30,
+    maxMemory: 50 * 1024 * 1024,
+    maxRecursionDepth: 100,
+    maxAllocations: 1_000_000
+};
+/**
+ * Executes Monty Python code by routing external function calls into ToolResolver.
+ * Expects: preamble matches the currently available tool names.
+ */
+export async function rlmExecute(code, preamble, context, toolResolver) {
+    const availableTools = toolResolver
+        .listTools()
+        .filter((tool) => tool.name !== RLM_TOOL_NAME);
+    const toolByName = new Map(availableTools.map((tool) => [tool.name, tool]));
+    const externalFunctions = [...toolByName.keys(), RLM_PRINT_FUNCTION_NAME];
+    const rewrittenCode = printCallsRewrite(code);
+    const script = [preamble.trim(), rewrittenCode].filter((chunk) => chunk.length > 0).join("\n\n");
+    const monty = new Monty(script, {
+        scriptName: "run_python.py",
+        externalFunctions
+    });
+    const printOutput = [];
+    let toolCallCount = 0;
+    let progress = monty.start({ limits: RLM_LIMITS });
+    while (progress instanceof MontySnapshot) {
+        if (progress.functionName === RLM_PRINT_FUNCTION_NAME) {
+            printOutput.push(printLineBuild(progress.args));
+            progress = progress.resume({ returnValue: null });
+            continue;
+        }
+        const tool = toolByName.get(progress.functionName);
+        if (!tool) {
+            progress = progress.resume({
+                exception: {
+                    type: "RuntimeError",
+                    message: `ToolError: Unknown tool: ${progress.functionName}`
+                }
+            });
+            continue;
+        }
+        toolCallCount += 1;
+        let resumeOptions;
+        try {
+            const args = rlmArgsConvert(progress.args, progress.kwargs, tool);
+            const toolResult = await toolResolver.execute({
+                type: "toolCall",
+                id: createId(),
+                name: tool.name,
+                arguments: args
+            }, context);
+            const value = rlmResultConvert(toolResult);
+            if (toolResult.toolMessage.isError) {
+                resumeOptions = {
+                    exception: {
+                        type: "RuntimeError",
+                        message: typeof value === "string" && value.trim().length > 0
+                            ? value
+                            : `Tool execution failed: ${tool.name}`
+                    }
+                };
+            }
+            else {
+                resumeOptions = { returnValue: value };
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            resumeOptions = {
+                exception: {
+                    type: "RuntimeError",
+                    message: `ToolError: ${message}`
+                }
+            };
+        }
+        progress = progress.resume(resumeOptions);
+    }
+    return {
+        output: valueFormat(progress.output),
+        printOutput,
+        toolCallCount
+    };
+}
+function printCallsRewrite(code) {
+    return code.replace(/(^|[^A-Za-z0-9_])print\s*\(/gm, `$1${RLM_PRINT_FUNCTION_NAME}(`);
+}
+function printLineBuild(args) {
+    return args.map((entry) => valueFormat(entry)).join(" ").trimEnd();
+}
+function valueFormat(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (typeof value === "string") {
+        return value;
+    }
+    if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") {
+        return String(value);
+    }
+    if (value instanceof Map) {
+        return valueFormat(Object.fromEntries(value.entries()));
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => valueFormat(entry)).join(", ");
+    }
+    if (typeof value === "object") {
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return String(value);
+        }
+    }
+    return String(value);
+}
+//# sourceMappingURL=rlmExecute.js.map

package/dist/engine/modules/rlm/rlmExecute.js.map

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

package/dist/engine/modules/rlm/rlmExecute.spec.d.ts

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

package/dist/engine/modules/rlm/rlmExecute.spec.d.ts.map

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

package/dist/engine/modules/rlm/rlmExecute.spec.js

@@ -0,0 +1,118 @@
+import { describe, expect, it, vi } from "vitest";
+import { Type } from "@sinclair/typebox";
+import { rlmExecute } from "./rlmExecute.js";
+import { rlmPreambleBuild } from "./rlmPreambleBuild.js";
+const baseTools = [
+    {
+        name: "echo",
+        description: "Echo back text.",
+        parameters: Type.Object({ text: Type.String() }, { additionalProperties: false })
+    },
+    {
+        name: "fail_tool",
+        description: "Always fails.",
+        parameters: Type.Object({}, { additionalProperties: false })
+    }
+];
+describe("rlmExecute", () => {
+    it("executes a tool call and returns final output", async () => {
+        const resolver = createResolver(async (name, args) => {
+            if (name !== "echo") {
+                throw new Error(`Unexpected tool ${name}`);
+            }
+            const payload = args;
+            return okResult(name, String(payload.text));
+        });
+        const result = await rlmExecute("value = echo('hello')\nvalue", rlmPreambleBuild(resolver.listTools()), createContext(), resolver);
+        expect(result.output).toBe("hello");
+        expect(result.toolCallCount).toBe(1);
+        expect(result.printOutput).toEqual([]);
+    });
+    it("supports chained calls and catches tool errors in python", async () => {
+        const resolver = createResolver(async (name, args) => {
+            if (name === "echo") {
+                const payload = args;
+                return okResult(name, `echo:${payload.text}`);
+            }
+            if (name === "fail_tool") {
+                return errorResult(name, "boom");
+            }
+            throw new Error(`Unexpected tool ${name}`);
+        });
+        const code = [
+            "first = echo('one')",
+            "try:",
+            "    fail_tool()",
+            "except ToolError:",
+            "    pass",
+            "second = echo(first)",
+            "second"
+        ].join("\n");
+        const result = await rlmExecute(code, rlmPreambleBuild(resolver.listTools()), createContext(), resolver);
+        expect(result.output).toBe("echo:echo:one");
+        expect(result.toolCallCount).toBe(3);
+    });
+    it("captures print output", async () => {
+        const resolver = createResolver(async (name) => {
+            throw new Error(`Unexpected tool ${name}`);
+        });
+        const result = await rlmExecute("print('hello', 'world')\n'done'", rlmPreambleBuild(resolver.listTools()), createContext(), resolver);
+        expect(result.output).toBe("done");
+        expect(result.printOutput).toEqual(["hello world"]);
+        expect(result.toolCallCount).toBe(0);
+    });
+});
+function createResolver(handler) {
+    return {
+        listTools: () => baseTools,
+        execute: vi.fn(async (toolCall) => handler(toolCall.name, toolCall.arguments))
+    };
+}
+function createContext() {
+    return {
+        connectorRegistry: null,
+        fileStore: null,
+        auth: null,
+        logger: console,
+        assistant: null,
+        permissions: {
+            workingDir: "/tmp",
+            writeDirs: [],
+            readDirs: [],
+            network: false,
+            events: false
+        },
+        agent: null,
+        source: "test",
+        messageContext: {},
+        agentSystem: null,
+        heartbeats: null
+    };
+}
+function okResult(name, text) {
+    return {
+        toolMessage: {
+            role: "toolResult",
+            toolCallId: "1",
+            toolName: name,
+            content: [{ type: "text", text }],
+            isError: false,
+            timestamp: Date.now()
+        },
+        files: []
+    };
+}
+function errorResult(name, text) {
+    return {
+        toolMessage: {
+            role: "toolResult",
+            toolCallId: "1",
+            toolName: name,
+            content: [{ type: "text", text }],
+            isError: true,
+            timestamp: Date.now()
+        },
+        files: []
+    };
+}
+//# sourceMappingURL=rlmExecute.spec.js.map

package/dist/engine/modules/rlm/rlmExecute.spec.js.map

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

package/dist/engine/modules/rlm/rlmPreambleBuild.d.ts

@@ -0,0 +1,7 @@
+import type { Tool } from "@mariozechner/pi-ai";
+/**
+ * Builds a Python preamble containing synchronous tool stubs for the current tool surface.
+ * Expects: tool names are unique and come from ToolResolver.listTools().
+ */
+export declare function rlmPreambleBuild(tools: Tool[]): string;
+//# sourceMappingURL=rlmPreambleBuild.d.ts.map

package/dist/engine/modules/rlm/rlmPreambleBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rlmPreambleBuild.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/rlm/rlmPreambleBuild.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAIhD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CA0CtD"}

package/dist/engine/modules/rlm/rlmPreambleBuild.js

@@ -0,0 +1,148 @@
+import { RLM_PRINT_FUNCTION_NAME, RLM_TOOL_NAME } from "./rlmConstants.js";
+/**
+ * Builds a Python preamble containing synchronous tool stubs for the current tool surface.
+ * Expects: tool names are unique and come from ToolResolver.listTools().
+ */
+export function rlmPreambleBuild(tools) {
+    const lines = [
+        "# You have the following tools available as Python functions.",
+        "# Call tool functions directly (no await).",
+        "# Tool failures raise ToolError (alias of RuntimeError).",
+        "# Use print() for debug logs; the last expression is returned.",
+        "",
+        "from typing import Any",
+        "",
+        "ToolError = RuntimeError",
+        "",
+        "# Typed tool stubs for code assistance only (not executed).",
+        "if False:",
+        `    def ${RLM_PRINT_FUNCTION_NAME}(*values: Any) -> None:`,
+        "        ...",
+        ""
+    ];
+    let stubCount = 0;
+    for (const tool of tools) {
+        if (tool.name === RLM_TOOL_NAME) {
+            continue;
+        }
+        if (!pythonIdentifierIs(tool.name)) {
+            continue;
+        }
+        stubCount += 1;
+        const signature = pythonSignatureBuild(tool);
+        const description = pythonDocstringEscape(tool.description?.trim() || "No description.");
+        lines.push(`    def ${tool.name}(${signature}) -> str:`);
+        lines.push(`        \"\"\"${description}\"\"\"`);
+        lines.push("        ...");
+        lines.push("");
+    }
+    if (stubCount === 0) {
+        lines.push("    pass");
+    }
+    return lines.join("\n").trimEnd();
+}
+function pythonSignatureBuild(tool) {
+    const parameters = parametersSchemaResolve(tool);
+    const properties = propertiesSchemaResolve(parameters.properties);
+    const required = new Set(requiredListResolve(parameters.required));
+    const entries = [];
+    for (const [name, schema] of Object.entries(properties)) {
+        if (!pythonIdentifierIs(name)) {
+            continue;
+        }
+        const typeHint = pythonTypeFromSchema(schema);
+        if (required.has(name)) {
+            entries.push(`${name}: ${typeHint}`);
+            continue;
+        }
+        entries.push(`${name}: ${typeHint} | None = None`);
+    }
+    return entries.join(", ");
+}
+function parametersSchemaResolve(tool) {
+    const schema = tool.parameters;
+    if (!recordIs(schema)) {
+        return {};
+    }
+    return {
+        properties: recordIs(schema.properties) ? schema.properties : undefined,
+        required: schema.required
+    };
+}
+function propertiesSchemaResolve(value) {
+    if (!recordIs(value)) {
+        return {};
+    }
+    return value;
+}
+function requiredListResolve(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.filter((entry) => typeof entry === "string");
+}
+function pythonTypeFromSchema(schema) {
+    if (!recordIs(schema)) {
+        return "Any";
+    }
+    const anyOf = schema.anyOf;
+    if (Array.isArray(anyOf) && anyOf.length > 0) {
+        const union = anyOf
+            .map((candidate) => pythonTypeFromSchema(candidate))
+            .filter((candidate, index, all) => all.indexOf(candidate) === index);
+        return union.length > 0 ? union.join(" | ") : "Any";
+    }
+    const oneOf = schema.oneOf;
+    if (Array.isArray(oneOf) && oneOf.length > 0) {
+        const union = oneOf
+            .map((candidate) => pythonTypeFromSchema(candidate))
+            .filter((candidate, index, all) => all.indexOf(candidate) === index);
+        return union.length > 0 ? union.join(" | ") : "Any";
+    }
+    const type = schema.type;
+    if (typeof type === "string") {
+        if (type === "string") {
+            return "str";
+        }
+        if (type === "integer") {
+            return "int";
+        }
+        if (type === "number") {
+            return "float";
+        }
+        if (type === "boolean") {
+            return "bool";
+        }
+        if (type === "null") {
+            return "None";
+        }
+        if (type === "array") {
+            return `list[${pythonTypeFromSchema(schema.items)}]`;
+        }
+        if (type === "object") {
+            const additional = schema.additionalProperties;
+            if (additional === false) {
+                return "dict[str, Any]";
+            }
+            return "dict[str, Any]";
+        }
+    }
+    if (Array.isArray(type) && type.length > 0) {
+        const union = type
+            .filter((entry) => typeof entry === "string")
+            .map((entry) => pythonTypeFromSchema({ type: entry }))
+            .filter((candidate, index, all) => all.indexOf(candidate) === index);
+        return union.length > 0 ? union.join(" | ") : "Any";
+    }
+    return "Any";
+}
+function pythonIdentifierIs(value) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(value);
+}
+function pythonDocstringEscape(value) {
+    return value.replace(/\"\"\"/g, '\\"\\"\\"');
+}
+function recordIs(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=rlmPreambleBuild.js.map

package/dist/engine/modules/rlm/rlmPreambleBuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rlmPreambleBuild.js","sourceRoot":"","sources":["../../../../sources/engine/modules/rlm/rlmPreambleBuild.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,KAAK,GAAa;QACtB,+DAA+D;QAC/D,4CAA4C;QAC5C,0DAA0D;QAC1D,gEAAgE;QAChE,EAAE;QACF,wBAAwB;QACxB,EAAE;QACF,0BAA0B;QAC1B,EAAE;QACF,6DAA6D;QAC7D,WAAW;QACX,WAAW,uBAAuB,yBAAyB;QAC3D,aAAa;QACb,EAAE;KACH,CAAC;IACF,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YAChC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,SAAS;QACX,CAAC;QAED,SAAS,IAAI,CAAC,CAAC;QACf,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,qBAAqB,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,iBAAiB,CAAC,CAAC;QAEzF,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,IAAI,SAAS,WAAW,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,iBAAiB,WAAW,QAAQ,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAU;IACtC,MAAM,UAAU,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,uBAAuB,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,mBAAmB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEnE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,QAAQ,EAAE,CAAC,CAAC;YACrC,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,QAAQ,gBAAgB,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,uBAAuB,CAAC,IAAU;IAIzC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAqB,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACvE,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAe;IAC3C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK;aAChB,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;aACnD,MAAM,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK;aAChB,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;aACnD,MAAM,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,QAAQ,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QACvD,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,MAAM,CAAC,oBAAoB,CAAC;YAC/C,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;gBACzB,OAAO,gBAAgB,CAAC;YAC1B,CAAC;YACD,OAAO,gBAAgB,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI;aACf,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;aAC7D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;aACrD,MAAM,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,KAAK,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACtD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,OAAO,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/engine/modules/rlm/rlmPreambleBuild.spec.d.ts

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

package/dist/engine/modules/rlm/rlmPreambleBuild.spec.d.ts.map

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