daycare-cli 0.0.0-canary.08d0b9e

package/dist/engine/modules/connectorRegistry.js

@@ -0,0 +1,152 @@
+import { getLogger } from "../../log.js";
+import { CommandRegistry } from "./commandRegistry.js";
+const CORE_COMMANDS = [
+    { command: "reset", description: "Reset the current conversation." },
+    { command: "context", description: "Show latest context token usage." },
+    { command: "compact", description: "Compact the current conversation." },
+    { command: "abort", description: "Abort the current inference." }
+];
+export class ConnectorRegistry {
+    connectors = new Map();
+    commandRegistry;
+    onMessage;
+    onCommand;
+    onPermission;
+    onFatal;
+    logger = getLogger("connectors.registry");
+    constructor(options) {
+        this.commandRegistry = options.commandRegistry ?? new CommandRegistry();
+        this.onMessage = options.onMessage;
+        this.onCommand = options.onCommand;
+        this.onPermission = options.onPermission;
+        this.onFatal = options.onFatal;
+        this.commandRegistry.onChange(() => {
+            void this.updateCommandsForAllConnectors();
+        });
+        this.logger.debug("init: ConnectorRegistry initialized");
+    }
+    list() {
+        return Array.from(this.connectors.keys());
+    }
+    listStatus() {
+        return Array.from(this.connectors.entries()).map(([id, entry]) => ({
+            id,
+            loadedAt: entry.loadedAt
+        }));
+    }
+    has(id) {
+        return this.connectors.has(id);
+    }
+    get(id) {
+        return this.connectors.get(id)?.connector ?? null;
+    }
+    register(id, connector) {
+        this.logger.debug(`register: register() called connectorId=${id}`);
+        if (this.connectors.has(id)) {
+            this.logger.debug(`register: Connector already registered connectorId=${id}`);
+            return { ok: true, status: "already-loaded" };
+        }
+        this.logger.debug(`event: Attaching message handler connectorId=${id}`);
+        const unsubscribe = this.attach(id, connector);
+        const commandUnsubscribe = this.attachCommand(id, connector);
+        const permissionUnsubscribe = this.attachPermission(id, connector);
+        this.connectors.set(id, {
+            connector,
+            unsubscribe,
+            commandUnsubscribe,
+            permissionUnsubscribe,
+            loadedAt: new Date()
+        });
+        void this.updateCommandsForConnector(id, connector);
+        this.logger.debug(`event: Connector added to registry connectorId=${id} totalConnectors=${this.connectors.size}`);
+        this.logger.info({ connector: id }, "register: Connector registered");
+        return { ok: true, status: "loaded" };
+    }
+    async unregister(id, reason = "unload") {
+        this.logger.debug(`unregister: unregister() called connectorId=${id} reason=${reason}`);
+        const entry = this.connectors.get(id);
+        if (!entry) {
+            this.logger.debug(`event: Connector not found connectorId=${id}`);
+            return { ok: true, status: "not-loaded" };
+        }
+        this.logger.debug(`event: Unsubscribing message handler connectorId=${id}`);
+        entry.unsubscribe?.();
+        entry.commandUnsubscribe?.();
+        entry.permissionUnsubscribe?.();
+        try {
+            this.logger.debug(`event: Calling connector.shutdown() connectorId=${id} reason=${reason}`);
+            await entry.connector.shutdown?.(reason);
+            this.logger.debug(`event: Connector shutdown complete connectorId=${id}`);
+        }
+        catch (error) {
+            this.logger.warn({ connector: id, error }, "error: Connector shutdown failed");
+        }
+        this.connectors.delete(id);
+        this.logger.debug(`event: Connector removed from registry connectorId=${id} remainingConnectors=${this.connectors.size}`);
+        this.logger.info({ connector: id }, "unregister: Connector unregistered");
+        return { ok: true, status: "unloaded" };
+    }
+    async unregisterAll(reason = "shutdown") {
+        const ids = Array.from(this.connectors.keys());
+        this.logger.debug(`start: unregisterAll() starting count=${ids.length} ids=${ids.join(",")} reason=${reason}`);
+        for (const id of ids) {
+            await this.unregister(id, reason);
+        }
+        this.logger.debug("event: unregisterAll() complete");
+    }
+    reportFatal(id, reason, error) {
+        this.onFatal?.(id, reason, error);
+    }
+    attach(id, connector) {
+        const handler = (message, context, descriptor) => {
+            return this.onMessage(message, context, descriptor);
+        };
+        return connector.onMessage(handler);
+    }
+    attachCommand(id, connector) {
+        if (!this.onCommand || !connector.onCommand) {
+            return undefined;
+        }
+        const handler = (command, context, descriptor) => {
+            return this.onCommand?.(command, context, descriptor);
+        };
+        return connector.onCommand(handler);
+    }
+    attachPermission(id, connector) {
+        if (!this.onPermission || !connector.onPermission) {
+            return undefined;
+        }
+        const handler = (decision, context, descriptor) => {
+            return this.onPermission?.(decision, context, descriptor);
+        };
+        return connector.onPermission(handler);
+    }
+    commandListBuild() {
+        const commandByName = new Map();
+        for (const command of CORE_COMMANDS) {
+            commandByName.set(command.command, command);
+        }
+        for (const command of this.commandRegistry.list()) {
+            commandByName.set(command.command, command);
+        }
+        return Array.from(commandByName.values());
+    }
+    async updateCommandsForAllConnectors() {
+        for (const [id, entry] of this.connectors.entries()) {
+            await this.updateCommandsForConnector(id, entry.connector);
+        }
+    }
+    async updateCommandsForConnector(id, connector) {
+        if (!connector.updateCommands) {
+            return;
+        }
+        const commands = this.commandListBuild();
+        try {
+            await connector.updateCommands(commands);
+        }
+        catch (error) {
+            this.logger.warn({ connector: id, error }, "error: Connector updateCommands() failed");
+        }
+    }
+}
+//# sourceMappingURL=connectorRegistry.js.map

package/dist/engine/modules/connectorRegistry.js.map

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

package/dist/engine/modules/connectorRegistry.spec.d.ts

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

package/dist/engine/modules/connectorRegistry.spec.d.ts.map

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

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

@@ -0,0 +1,72 @@
+import { describe, expect, it, vi } from "vitest";
+import { CommandRegistry } from "./commandRegistry.js";
+import { ConnectorRegistry } from "./connectorRegistry.js";
+describe("ConnectorRegistry command updates", () => {
+    it("pushes merged core and plugin commands to connectors", async () => {
+        const commandRegistry = new CommandRegistry();
+        const connectorRegistry = new ConnectorRegistry({
+            commandRegistry,
+            onMessage: async () => undefined
+        });
+        const updateCommands = vi.fn(async () => undefined);
+        const connector = {
+            capabilities: { sendText: true },
+            onMessage: () => () => undefined,
+            sendMessage: async () => undefined,
+            updateCommands
+        };
+        connectorRegistry.register("telegram", connector);
+        await Promise.resolve();
+        expect(updateCommands).toHaveBeenCalledTimes(1);
+        expect(updateCommands).toHaveBeenLastCalledWith([
+            { command: "reset", description: "Reset the current conversation." },
+            { command: "context", description: "Show latest context token usage." },
+            { command: "compact", description: "Compact the current conversation." },
+            { command: "abort", description: "Abort the current inference." }
+        ]);
+        commandRegistry.register("upgrade", {
+            command: "upgrade",
+            description: "Upgrade daycare to latest version",
+            handler: async () => undefined
+        });
+        await Promise.resolve();
+        expect(updateCommands).toHaveBeenCalledTimes(2);
+        expect(updateCommands).toHaveBeenLastCalledWith([
+            { command: "reset", description: "Reset the current conversation." },
+            { command: "context", description: "Show latest context token usage." },
+            { command: "compact", description: "Compact the current conversation." },
+            { command: "abort", description: "Abort the current inference." },
+            { command: "upgrade", description: "Upgrade daycare to latest version" }
+        ]);
+    });
+    it("updates newly registered connectors with current command state", async () => {
+        const commandRegistry = new CommandRegistry();
+        commandRegistry.register("upgrade", {
+            command: "upgrade",
+            description: "Upgrade daycare to latest version",
+            handler: async () => undefined
+        });
+        const connectorRegistry = new ConnectorRegistry({
+            commandRegistry,
+            onMessage: async () => undefined
+        });
+        const updateCommands = vi.fn(async () => undefined);
+        const connector = {
+            capabilities: { sendText: true },
+            onMessage: () => () => undefined,
+            sendMessage: async () => undefined,
+            updateCommands
+        };
+        connectorRegistry.register("telegram", connector);
+        await Promise.resolve();
+        expect(updateCommands).toHaveBeenCalledTimes(1);
+        expect(updateCommands).toHaveBeenLastCalledWith([
+            { command: "reset", description: "Reset the current conversation." },
+            { command: "context", description: "Show latest context token usage." },
+            { command: "compact", description: "Compact the current conversation." },
+            { command: "abort", description: "Abort the current inference." },
+            { command: "upgrade", description: "Upgrade daycare to latest version" }
+        ]);
+    });
+});
+//# sourceMappingURL=connectorRegistry.spec.js.map

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

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

package/dist/engine/modules/connectors/types.d.ts

@@ -0,0 +1,91 @@
+import type { FileReference } from "../../../files/types.js";
+import type { AgentDescriptor } from "../../agents/ops/agentDescriptorTypes.js";
+export type ConnectorFileMode = "document" | "photo" | "video";
+export type ConnectorFileDisposition = ConnectorFileMode | "auto";
+export type ConnectorFile = FileReference & {
+    sendAs?: ConnectorFileDisposition;
+};
+export type ConnectorCapabilities = {
+    sendText: boolean;
+    sendFiles?: {
+        modes: ConnectorFileMode[];
+    };
+    messageFormatPrompt?: string;
+    reactions?: boolean;
+    typing?: boolean;
+};
+export type ConnectorMessage = {
+    text: string | null;
+    rawText?: string | null;
+    files?: ConnectorFile[];
+    replyToMessageId?: string;
+};
+export type MessageContext = {
+    messageId?: string;
+    permissionTags?: string[];
+};
+export type MessageHandler = (message: ConnectorMessage, context: MessageContext, descriptor: AgentDescriptor) => void | Promise<void>;
+export type CommandHandler = (command: string, context: MessageContext, descriptor: AgentDescriptor) => void | Promise<void>;
+export type SlashCommandEntry = {
+    command: string;
+    description: string;
+};
+export type PluginCommandDefinition = SlashCommandEntry & {
+    handler: CommandHandler;
+};
+export type MessageUnsubscribe = () => void;
+export type CommandUnsubscribe = () => void;
+export type PermissionKind = "read" | "write" | "network" | "events" | "workspace";
+export type PermissionRequestScope = "now" | "always";
+export type PermissionAccess = {
+    kind: "network";
+} | {
+    kind: "events";
+} | {
+    kind: "workspace";
+} | {
+    kind: "read";
+    path: string;
+} | {
+    kind: "write";
+    path: string;
+};
+export type PermissionEntry = {
+    permission: string;
+    access: PermissionAccess;
+};
+export type PermissionRequest = {
+    token: string;
+    agentId: string;
+    reason: string;
+    message: string;
+    permissions: PermissionEntry[];
+    scope?: PermissionRequestScope;
+    requester: {
+        id: string;
+        type: AgentDescriptor["type"];
+        label: string;
+        kind: "foreground" | "background";
+    };
+};
+export type PermissionDecision = {
+    token: string;
+    agentId: string;
+    approved: boolean;
+    permissions: PermissionEntry[];
+    scope?: PermissionRequestScope;
+};
+export type PermissionHandler = (decision: PermissionDecision, context: MessageContext, descriptor: AgentDescriptor) => void | Promise<void>;
+export interface Connector {
+    capabilities: ConnectorCapabilities;
+    onMessage(handler: MessageHandler): MessageUnsubscribe;
+    onCommand?: (handler: CommandHandler) => CommandUnsubscribe;
+    updateCommands?: (commands: SlashCommandEntry[]) => void | Promise<void>;
+    onPermission?: (handler: PermissionHandler) => MessageUnsubscribe;
+    sendMessage(targetId: string, message: ConnectorMessage): Promise<void>;
+    requestPermission?: (targetId: string, request: PermissionRequest, context: MessageContext, descriptor: AgentDescriptor) => Promise<void>;
+    startTyping?: (targetId: string) => () => void;
+    setReaction?: (targetId: string, messageId: string, reaction: string) => Promise<void>;
+    shutdown?: (reason?: string) => void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/engine/modules/connectors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/connectors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAEhF,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAC/D,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,GAAG,MAAM,CAAC;AAElE,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IACxC,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE;QACR,KAAK,EAAE,iBAAiB,EAAE,CAAC;KAC9B,CAAC;IACF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CACzB,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,eAAe,KAC1B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,MAAM,cAAc,GAAG,CACzB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,eAAe,KAC1B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,MAAM,iBAAiB,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG;IACtD,OAAO,EAAE,cAAc,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC;AAC5C,MAAM,MAAM,kBAAkB,GAAG,MAAM,IAAI,CAAC;AAE5C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AACnF,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEtD,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,MAAM,MAAM,eAAe,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,sBAAsB,CAAC;IAC/B,SAAS,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;QAC9B,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC;KACrC,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,sBAAsB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAC5B,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,eAAe,KAC1B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,SAAS;IACtB,YAAY,EAAE,qBAAqB,CAAC;IACpC,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB,CAAC;IACvD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,kBAAkB,CAAC;IAC5D,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,kBAAkB,CAAC;IAClE,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,iBAAiB,CAAC,EAAE,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,eAAe,KAC1B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC;IAC/C,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD"}

package/dist/engine/modules/connectors/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/modules/connectors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../sources/engine/modules/connectors/types.ts"],"names":[],"mappings":""}

package/dist/engine/modules/executablePrompts/executablePromptExpand.d.ts

@@ -0,0 +1,8 @@
+import type { ToolExecutionContext } from "@/types";
+import type { ToolResolverApi } from "../toolResolver.js";
+/**
+ * Expands `<run_python>...</run_python>` blocks inside a prompt using the RLM runtime.
+ * Expects: caller has already checked feature flags and execution permissions.
+ */
+export declare function executablePromptExpand(prompt: string, context: ToolExecutionContext, toolResolver: ToolResolverApi): Promise<string>;
+//# sourceMappingURL=executablePromptExpand.d.ts.map

package/dist/engine/modules/executablePrompts/executablePromptExpand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executablePromptExpand.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/executablePrompts/executablePromptExpand.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAIpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D;;;GAGG;AACH,wBAAsB,sBAAsB,CACxC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,oBAAoB,EAC7B,YAAY,EAAE,eAAe,GAC9B,OAAO,CAAC,MAAM,CAAC,CAsCjB"}

package/dist/engine/modules/executablePrompts/executablePromptExpand.js

@@ -0,0 +1,45 @@
+import { createId } from "@paralleldrive/cuid2";
+import { tagExtractAll } from "../../../util/tagExtract.js";
+import { montyRuntimePreambleBuild } from "../monty/montyRuntimePreambleBuild.js";
+import { rlmExecute } from "../rlm/rlmExecute.js";
+import { executablePromptTagReplace } from "./executablePromptTagReplace.js";
+/**
+ * Expands `<run_python>...</run_python>` blocks inside a prompt using the RLM runtime.
+ * Expects: caller has already checked feature flags and execution permissions.
+ */
+export async function executablePromptExpand(prompt, context, toolResolver) {
+    const codeBlocks = tagExtractAll(prompt, "run_python");
+    if (codeBlocks.length === 0) {
+        return prompt;
+    }
+    const tagMatches = [...prompt.matchAll(/<run_python(\s[^>]*)?>[\s\S]*?<\/run_python\s*>/gi)];
+    if (tagMatches.length === 0) {
+        return prompt;
+    }
+    const preamble = montyRuntimePreambleBuild(toolResolver.listTools());
+    const replacements = [];
+    for (let index = 0; index < codeBlocks.length; index += 1) {
+        const code = codeBlocks[index];
+        try {
+            const result = await rlmExecute(code, preamble, context, toolResolver, createId(), context.appendHistoryRecord);
+            replacements.push(result.output);
+        }
+        catch (error) {
+            replacements.push(`<exec_error>${errorMessageResolve(error)}</exec_error>`);
+        }
+    }
+    let expanded = prompt;
+    const replacementCount = Math.min(tagMatches.length, replacements.length);
+    for (let index = replacementCount - 1; index >= 0; index -= 1) {
+        const tagMatch = tagMatches[index];
+        expanded = executablePromptTagReplace(expanded, tagMatch, replacements[index] ?? "");
+    }
+    return expanded;
+}
+function errorMessageResolve(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+//# sourceMappingURL=executablePromptExpand.js.map

package/dist/engine/modules/executablePrompts/executablePromptExpand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executablePromptExpand.js","sourceRoot":"","sources":["../../../../sources/engine/modules/executablePrompts/executablePromptExpand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CACxC,MAAc,EACd,OAA6B,EAC7B,YAA6B;IAE7B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,mDAAmD,CAAC,CAAC,CAAC;IAC7F,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,yBAAyB,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IACrE,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAE,CAAC;QAChC,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,UAAU,CAC3B,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,QAAQ,EAAE,EACV,OAAO,CAAC,mBAAmB,CAC9B,CAAC;YACF,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,YAAY,CAAC,IAAI,CAAC,eAAe,mBAAmB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAChF,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,GAAG,MAAM,CAAC;IACtB,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1E,KAAK,IAAI,KAAK,GAAG,gBAAgB,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAE,CAAC;QACpC,QAAQ,GAAG,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,OAAO,QAAQ,CAAC;AACpB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACvC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,OAAO,CAAC;IACzB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC"}

package/dist/engine/modules/executablePrompts/executablePromptExpand.spec.d.ts

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

package/dist/engine/modules/executablePrompts/executablePromptExpand.spec.d.ts.map

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

package/dist/engine/modules/executablePrompts/executablePromptExpand.spec.js

@@ -0,0 +1,95 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { executablePromptExpand } from "./executablePromptExpand.js";
+const { rlmExecuteMock, montyRuntimePreambleBuildMock } = vi.hoisted(() => ({
+    rlmExecuteMock: vi.fn(),
+    montyRuntimePreambleBuildMock: vi.fn(() => "# preamble")
+}));
+vi.mock("../rlm/rlmExecute.js", () => ({
+    rlmExecute: rlmExecuteMock
+}));
+vi.mock("../monty/montyRuntimePreambleBuild.js", () => ({
+    montyRuntimePreambleBuild: montyRuntimePreambleBuildMock
+}));
+describe("executablePromptExpand", () => {
+    beforeEach(() => {
+        rlmExecuteMock.mockReset();
+        montyRuntimePreambleBuildMock.mockClear();
+    });
+    it("returns prompt unchanged when no run_python tags exist", async () => {
+        const resolver = resolverBuild();
+        const context = contextBuild();
+        const prompt = "no executable blocks";
+        const result = await executablePromptExpand(prompt, context, resolver);
+        expect(result).toBe(prompt);
+        expect(rlmExecuteMock).not.toHaveBeenCalled();
+        expect(montyRuntimePreambleBuildMock).not.toHaveBeenCalled();
+    });
+    it("expands a single run_python block", async () => {
+        rlmExecuteMock.mockResolvedValue({
+            output: "42",
+            printOutput: [],
+            toolCallCount: 0
+        });
+        const resolver = resolverBuild();
+        const context = contextBuild();
+        const result = await executablePromptExpand("A<run_python>1+1</run_python>B", context, resolver);
+        expect(result).toBe("A42B");
+        expect(rlmExecuteMock).toHaveBeenCalledTimes(1);
+        expect(rlmExecuteMock).toHaveBeenCalledWith("1+1", "# preamble", context, resolver, expect.any(String), undefined);
+    });
+    it("expands multiple run_python blocks in prompt order", async () => {
+        rlmExecuteMock
+            .mockResolvedValueOnce({
+            output: "FIRST",
+            printOutput: [],
+            toolCallCount: 0
+        })
+            .mockResolvedValueOnce({
+            output: "SECOND",
+            printOutput: [],
+            toolCallCount: 0
+        });
+        const resolver = resolverBuild();
+        const context = contextBuild();
+        const result = await executablePromptExpand("x <run_python>first()</run_python> y <run_python>second()</run_python> z", context, resolver);
+        expect(result).toBe("x FIRST y SECOND z");
+        expect(rlmExecuteMock).toHaveBeenNthCalledWith(1, "first()", "# preamble", context, resolver, expect.any(String), undefined);
+        expect(rlmExecuteMock).toHaveBeenNthCalledWith(2, "second()", "# preamble", context, resolver, expect.any(String), undefined);
+    });
+    it("replaces failed executions with exec_error blocks", async () => {
+        rlmExecuteMock.mockRejectedValue(new Error("boom"));
+        const resolver = resolverBuild();
+        const context = contextBuild();
+        const result = await executablePromptExpand("a <run_python>broken()</run_python> b", context, resolver);
+        expect(result).toBe("a <exec_error>boom</exec_error> b");
+    });
+});
+function resolverBuild() {
+    return {
+        listTools: vi.fn(() => []),
+        execute: vi.fn()
+    };
+}
+function contextBuild() {
+    return {
+        connectorRegistry: null,
+        fileStore: null,
+        auth: null,
+        logger: console,
+        assistant: null,
+        permissions: {
+            workingDir: "/",
+            writeDirs: [],
+            readDirs: [],
+            network: false,
+            events: false
+        },
+        agent: null,
+        ctx: null,
+        source: "test",
+        messageContext: {},
+        agentSystem: null,
+        heartbeats: null
+    };
+}
+//# sourceMappingURL=executablePromptExpand.spec.js.map

package/dist/engine/modules/executablePrompts/executablePromptExpand.spec.js.map

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

package/dist/engine/modules/executablePrompts/executablePromptTagReplace.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Replaces a specific `<run_python>...</run_python>` match within a prompt string.
+ * Expects: `tagMatch` comes from `String.prototype.matchAll()` on the original prompt.
+ */
+export declare function executablePromptTagReplace(prompt: string, tagMatch: RegExpMatchArray, replacement: string): string;
+//# sourceMappingURL=executablePromptTagReplace.d.ts.map

package/dist/engine/modules/executablePrompts/executablePromptTagReplace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executablePromptTagReplace.d.ts","sourceRoot":"","sources":["../../../../sources/engine/modules/executablePrompts/executablePromptTagReplace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAOlH"}

package/dist/engine/modules/executablePrompts/executablePromptTagReplace.js

@@ -0,0 +1,13 @@
+/**
+ * Replaces a specific `<run_python>...</run_python>` match within a prompt string.
+ * Expects: `tagMatch` comes from `String.prototype.matchAll()` on the original prompt.
+ */
+export function executablePromptTagReplace(prompt, tagMatch, replacement) {
+    if (tagMatch.index === undefined || typeof tagMatch[0] !== "string") {
+        return prompt;
+    }
+    const start = tagMatch.index;
+    const end = start + tagMatch[0].length;
+    return `${prompt.slice(0, start)}${replacement}${prompt.slice(end)}`;
+}
+//# sourceMappingURL=executablePromptTagReplace.js.map

package/dist/engine/modules/executablePrompts/executablePromptTagReplace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executablePromptTagReplace.js","sourceRoot":"","sources":["../../../../sources/engine/modules/executablePrompts/executablePromptTagReplace.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc,EAAE,QAA0B,EAAE,WAAmB;IACtG,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAClE,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC7B,MAAM,GAAG,GAAG,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACvC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;AACzE,CAAC"}

package/dist/engine/modules/executablePrompts/executablePromptTagReplace.spec.d.ts

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

package/dist/engine/modules/executablePrompts/executablePromptTagReplace.spec.d.ts.map

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

package/dist/engine/modules/executablePrompts/executablePromptTagReplace.spec.js

@@ -0,0 +1,42 @@
+import { describe, expect, it } from "vitest";
+import { executablePromptTagReplace } from "./executablePromptTagReplace.js";
+describe("executablePromptTagReplace", () => {
+    it("replaces a single run_python block", () => {
+        const prompt = "before <run_python>echo()</run_python> after";
+        const match = [...prompt.matchAll(/<run_python(\s[^>]*)?>[\s\S]*?<\/run_python\s*>/gi)][0];
+        if (!match) {
+            throw new Error("expected run_python match");
+        }
+        const replaced = executablePromptTagReplace(prompt, match, "RESULT");
+        expect(replaced).toBe("before RESULT after");
+    });
+    it("supports multiple replacements when applied from last to first", () => {
+        const prompt = "<run_python>a()</run_python> + <run_python>b()</run_python>";
+        const matches = [...prompt.matchAll(/<run_python(\s[^>]*)?>[\s\S]*?<\/run_python\s*>/gi)];
+        if (matches.length !== 2) {
+            throw new Error("expected two run_python matches");
+        }
+        let replaced = executablePromptTagReplace(prompt, matches[1], "B");
+        replaced = executablePromptTagReplace(replaced, matches[0], "A");
+        expect(replaced).toBe("A + B");
+    });
+    it("supports empty replacement text", () => {
+        const prompt = "x<run_python>noop()</run_python>y";
+        const match = [...prompt.matchAll(/<run_python(\s[^>]*)?>[\s\S]*?<\/run_python\s*>/gi)][0];
+        if (!match) {
+            throw new Error("expected run_python match");
+        }
+        const replaced = executablePromptTagReplace(prompt, match, "");
+        expect(replaced).toBe("xy");
+    });
+    it("replaces multiline tags with attributes", () => {
+        const prompt = ["start", '<run_python mode="safe">', "value = 1", "value", "</run_python>", "end"].join("\n");
+        const match = [...prompt.matchAll(/<run_python(\s[^>]*)?>[\s\S]*?<\/run_python\s*>/gi)][0];
+        if (!match) {
+            throw new Error("expected run_python match");
+        }
+        const replaced = executablePromptTagReplace(prompt, match, "42");
+        expect(replaced).toBe("start\n42\nend");
+    });
+});
+//# sourceMappingURL=executablePromptTagReplace.spec.js.map

package/dist/engine/modules/executablePrompts/executablePromptTagReplace.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executablePromptTagReplace.spec.js","sourceRoot":"","sources":["../../../../sources/engine/modules/executablePrompts/executablePromptTagReplace.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E,QAAQ,CAAC,4BAA4B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,8CAA8C,CAAC;QAC9D,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,mDAAmD,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,QAAQ,GAAG,0BAA0B,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QACrE,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACtE,MAAM,MAAM,GAAG,6DAA6D,CAAC;QAC7E,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,mDAAmD,CAAC,CAAC,CAAC;QAC1F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,QAAQ,GAAG,0BAA0B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,GAAG,CAAC,CAAC;QACpE,QAAQ,GAAG,0BAA0B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAE,EAAE,GAAG,CAAC,CAAC;QAClE,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACvC,MAAM,MAAM,GAAG,mCAAmC,CAAC;QACnD,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,mDAAmD,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,QAAQ,GAAG,0BAA0B,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,0BAA0B,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9G,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,mDAAmD,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3F,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QACjD,CAAC;QACD,MAAM,QAAQ,GAAG,0BAA0B,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QACjE,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}