@easynet/agent-runtime 1.0.3 → 1.0.5

package/dist/cli/event-listener.js

@@ -0,0 +1,131 @@
+function asRecord(value) {
+    return typeof value === "object" && value !== null ? value : null;
+}
+function asNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function asTrimmedString(value) {
+    return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+}
+function asString(value) {
+    return typeof value === "string" ? value : null;
+}
+function parseJsonObject(value) {
+    if (typeof value !== "string")
+        return null;
+    try {
+        return asRecord(JSON.parse(value));
+    }
+    catch {
+        return null;
+    }
+}
+function extractCommandMeta(args) {
+    const rec = asRecord(args) ?? parseJsonObject(args);
+    if (!rec)
+        return null;
+    const commandRaw = asString(rec.command);
+    if (commandRaw === null)
+        return null;
+    return {
+        command: commandRaw.trim(),
+        windowId: asNumber(rec.windowId),
+        tabIndex: asNumber(rec.tabIndex),
+        sessionId: asTrimmedString(rec.sessionId),
+    };
+}
+function isNoopCaptureCommand(command) {
+    const normalized = command.trim().replace(/\s+/g, " ");
+    return normalized === "" || normalized === ":" || normalized === "true" || normalized === "printf ''" || normalized === 'printf ""';
+}
+function extractToolResultMeta(payload) {
+    const payloadRec = asRecord(payload);
+    const rawResult = payloadRec ? (payloadRec.result ?? null) : null;
+    const resultRec = asRecord(rawResult) ?? parseJsonObject(rawResult);
+    const nestedResult = resultRec ? asRecord(resultRec.result) : null;
+    const output = asTrimmedString((nestedResult ?? resultRec ?? {}).output)
+        ?? asTrimmedString((nestedResult ?? resultRec ?? {}).result);
+    const error = asTrimmedString((nestedResult ?? resultRec ?? {}).error);
+    return {
+        outputLines: output ? output.split(/\r?\n/).filter((line) => line.length > 0).length : null,
+        error,
+    };
+}
+function recordToolStart(state, event) {
+    state.step += 1;
+    const payload = (event.payload ?? {});
+    const commandMeta = extractCommandMeta(payload.args);
+    if (!commandMeta) {
+        state.stepActionByNumber.set(state.step, `tool: ${event.to}`);
+        return;
+    }
+    const signature = `${commandMeta.command}|${commandMeta.windowId ?? ""}|${commandMeta.tabIndex ?? ""}|${commandMeta.sessionId ?? ""}`;
+    const isRepeat = signature === state.lastCommandSignature;
+    state.lastCommandSignature = signature;
+    const action = isNoopCaptureCommand(commandMeta.command) ? "capture current screen" : commandMeta.command;
+    state.stepActionByNumber.set(state.step, `${action}${isRepeat ? " (repeat)" : ""}`);
+}
+function writeToolDone(state, event, writer, okMark) {
+    const resultMeta = extractToolResultMeta(event.payload);
+    const action = state.stepActionByNumber.get(state.step) ?? `tool: ${event.to}`;
+    if (resultMeta.error) {
+        writer(`[step ${state.step}] ${action} ✖ (${resultMeta.error})`);
+        state.stepActionByNumber.delete(state.step);
+        return;
+    }
+    writer(`[step ${state.step}] ${action} ${okMark}`);
+    state.stepActionByNumber.delete(state.step);
+}
+function writeToolError(state, event, writer) {
+    const payload = (event.payload ?? {});
+    const action = state.stepActionByNumber.get(state.step) ?? `tool: ${event.to}`;
+    const message = typeof payload.error === "string"
+        ? payload.error
+        : payload.error instanceof Error
+            ? payload.error.message
+            : "unknown error";
+    writer(`[step ${state.step}] ${action} ✖ (${message})`);
+    state.stepActionByNumber.delete(state.step);
+}
+function handleEvent(state, event, writer, okMark) {
+    switch (event.name) {
+        case "agent.react.run.start":
+        case "agent.deep.run.start":
+            state.step = 0;
+            state.lastCommandSignature = "";
+            state.stepActionByNumber.clear();
+            writer("Analyzing started");
+            return;
+        case "agent.react.skill.matched": {
+            const payload = (event.payload ?? {});
+            const score = typeof payload.score === "number" ? payload.score.toFixed(3) : "?";
+            writer(`[skill] matched ${payload.skill ?? "unknown"} (score ${score})`);
+            return;
+        }
+        case "agent.react.tool.invoke.start":
+            recordToolStart(state, event);
+            return;
+        case "agent.react.tool.invoke.done":
+            writeToolDone(state, event, writer, okMark);
+            return;
+        case "agent.react.tool.invoke.error":
+            writeToolError(state, event, writer);
+            return;
+        case "agent.react.run.done":
+        case "agent.deep.run.done":
+            writer("completed");
+            return;
+        default:
+            return;
+    }
+}
+export function createStructuredRunEventListener(writer = console.error) {
+    const state = {
+        step: 0,
+        lastCommandSignature: "",
+        stepActionByNumber: new Map(),
+    };
+    const okMark = process.stderr.isTTY && !process.env.NO_COLOR ? "\x1b[32m✔\x1b[0m" : "✔";
+    return (event) => handleEvent(state, event, writer, okMark);
+}
+//# sourceMappingURL=event-listener.js.map

package/dist/cli/event-listener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-listener.js","sourceRoot":"","sources":["../../src/cli/event-listener.ts"],"names":[],"mappings":"AAoBA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAAiC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjG,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5E,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpF,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAa;IACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO;QACL,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE;QAC1B,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;QAChC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;QAChC,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAe;IAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACvD,OAAO,UAAU,KAAK,EAAE,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,WAAW,IAAI,UAAU,KAAK,WAAW,CAAC;AACtI,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAgB;IAC7C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClE,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,eAAe,CAAC,SAAS,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACnE,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,YAAY,IAAI,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;WACnE,eAAe,CAAC,CAAC,YAAY,IAAI,SAAS,IAAI,EAAE,CAAC,CAAC,MAAiB,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,YAAY,IAAI,SAAS,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QAC3F,KAAK;KACN,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAoB,EAAE,KAAiB;IAC9D,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IAChB,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAuB,CAAC;IAC5D,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,QAAQ,IAAI,EAAE,IAAI,WAAW,CAAC,QAAQ,IAAI,EAAE,IAAI,WAAW,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;IACtI,MAAM,QAAQ,GAAG,SAAS,KAAK,KAAK,CAAC,oBAAoB,CAAC;IAC1D,KAAK,CAAC,oBAAoB,GAAG,SAAS,CAAC;IACvC,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC;IAC1G,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,aAAa,CAAC,KAAoB,EAAE,KAAiB,EAAE,MAA8B,EAAE,MAAc;IAC5G,MAAM,UAAU,GAAG,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,EAAE,CAAC;IAE/E,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,CAAC,SAAS,KAAK,CAAC,IAAI,KAAK,MAAM,OAAO,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC;QACjE,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO;IACT,CAAC;IAED,MAAM,CAAC,SAAS,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;IACnD,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,cAAc,CAAC,KAAoB,EAAE,KAAiB,EAAE,MAA8B;IAC7F,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAwB,CAAC;IAC7D,MAAM,MAAM,GAAG,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,KAAK,CAAC,EAAE,EAAE,CAAC;IAC/E,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;QAC/C,CAAC,CAAC,OAAO,CAAC,KAAK;QACf,CAAC,CAAC,OAAO,CAAC,KAAK,YAAY,KAAK;YAC9B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO;YACvB,CAAC,CAAC,eAAe,CAAC;IACtB,MAAM,CAAC,SAAS,KAAK,CAAC,IAAI,KAAK,MAAM,OAAO,OAAO,GAAG,CAAC,CAAC;IACxD,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,WAAW,CAAC,KAAoB,EAAE,KAAiB,EAAE,MAA8B,EAAE,MAAc;IAC1G,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,uBAAuB,CAAC;QAC7B,KAAK,sBAAsB;YACzB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YACf,KAAK,CAAC,oBAAoB,GAAG,EAAE,CAAC;YAChC,KAAK,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;YACjC,MAAM,CAAC,mBAAmB,CAAC,CAAC;YAC5B,OAAO;QACT,KAAK,2BAA2B,CAAC,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAuC,CAAC;YAC5E,MAAM,KAAK,GAAG,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACjF,MAAM,CAAC,mBAAmB,OAAO,CAAC,KAAK,IAAI,SAAS,WAAW,KAAK,GAAG,CAAC,CAAC;YACzE,OAAO;QACT,CAAC;QACD,KAAK,+BAA+B;YAClC,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC9B,OAAO;QACT,KAAK,8BAA8B;YACjC,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAC5C,OAAO;QACT,KAAK,+BAA+B;YAClC,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YACrC,OAAO;QACT,KAAK,sBAAsB,CAAC;QAC5B,KAAK,qBAAqB;YACxB,MAAM,CAAC,WAAW,CAAC,CAAC;YACpB,OAAO;QACT;YACE,OAAO;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,SAAiC,OAAO,CAAC,KAAK;IAC7F,MAAM,KAAK,GAAkB;QAC3B,IAAI,EAAE,CAAC;QACP,oBAAoB,EAAE,EAAE;QACxB,kBAAkB,EAAE,IAAI,GAAG,EAAkB;KAC9C,CAAC;IACF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC;IACxF,OAAO,CAAC,KAAiB,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1E,CAAC"}

package/dist/cli/interactive.d.ts

@@ -0,0 +1,4 @@
+import type { BotContext } from "../core/context.js";
+import { type AgentKind, type AppCliOptions } from "./types.js";
+export declare function interactive(ctx: BotContext, kind: AgentKind, options: AppCliOptions, exitApp: (code: number) => never): Promise<void>;
+//# sourceMappingURL=interactive.d.ts.map

package/dist/cli/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/cli/interactive.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrD,OAAO,EAAe,KAAK,SAAS,EAAE,KAAK,aAAa,EAAkC,MAAM,YAAY,CAAC;AAoG7G,wBAAsB,WAAW,CAC/B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,GAC/B,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/cli/interactive.js

@@ -0,0 +1,118 @@
+import os from "node:os";
+import { createInterface } from "node:readline";
+import { createRuntime } from "./runtime.js";
+import { startLoadingSpinner } from "./spinner.js";
+import { renderForTerminal } from "./terminal-render.js";
+import { DEEP, REACT } from "./types.js";
+const builtinInteractiveCommands = {
+    "list tools": (ctx) => {
+        const tools = ctx.tools
+            .map((tool) => ({
+            name: typeof tool.name === "string" ? tool.name : "(unnamed-tool)",
+            description: typeof tool.description === "string" && tool.description.trim().length > 0
+                ? tool.description.trim()
+                : "No description",
+        }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        console.log(`Available tools (${tools.length}):`);
+        for (const tool of tools) {
+            console.log(`- ${tool.name}: ${tool.description}`);
+        }
+    },
+    "list skills": (ctx) => {
+        const skills = (ctx.skillSet?.list() ?? [])
+            .map((skill) => ({ name: skill.name, description: (skill.description ?? "").trim() || "No description" }))
+            .sort((a, b) => a.name.localeCompare(b.name));
+        console.log(`Available skills (${skills.length}):`);
+        for (const skill of skills) {
+            console.log(`- ${skill.name}: ${skill.description}`);
+        }
+    },
+};
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function createCliColors(useColor) {
+    return {
+        reset: useColor ? "\x1b[0m" : "",
+        dim: useColor ? "\x1b[2m" : "",
+        user: useColor ? "\x1b[38;5;39m" : "",
+        bot: useColor ? "\x1b[38;5;48m" : "",
+        prompt: useColor ? "\x1b[38;5;245m" : "",
+        promptUser: useColor ? "\x1b[1;38;5;45m" : "",
+    };
+}
+function resolveUiOptions(kind, options) {
+    const userLabel = options.ui?.userLabel ?? os.userInfo().username;
+    const assistantLabel = options.ui?.assistantLabel ?? (kind === REACT ? "ReAct" : "Deep");
+    const useColor = options.ui?.useColor ?? (Boolean(process.stdout.isTTY) && !process.env.NO_COLOR);
+    const renderMarkdown = options.ui?.renderMarkdown ?? true;
+    const echoUserQuestion = options.ui?.echoUserQuestion ?? true;
+    const showProcessingSpinner = options.ui?.processingSpinner ?? Boolean(process.stderr.isTTY);
+    const processingText = options.ui?.processingText ?? "Processing";
+    return { userLabel, assistantLabel, useColor, renderMarkdown, echoUserQuestion, showProcessingSpinner, processingText };
+}
+async function runInteractiveCommand(ctx, input, commands) {
+    const key = input.toLowerCase();
+    const handler = commands?.[key] ?? builtinInteractiveCommands[key];
+    if (!handler)
+        return false;
+    await handler(ctx);
+    return true;
+}
+async function runUserQuery(query, runtime, ui, visuals) {
+    let stopProcessingSpinner = null;
+    try {
+        console.log(`\n${visuals.hr}`);
+        if (ui.echoUserQuestion) {
+            console.log(visuals.userPrefix);
+            console.log(`> ${query}`);
+            console.log("");
+        }
+        console.log(visuals.assistantPrefix);
+        stopProcessingSpinner = ui.showProcessingSpinner
+            ? startLoadingSpinner(ui.processingText === false ? "⏳" : `⏳ ${ui.processingText}`)
+            : null;
+        const { text } = await runtime.run(query);
+        stopProcessingSpinner?.();
+        stopProcessingSpinner = null;
+        console.log(renderForTerminal(text, { renderMarkdown: ui.renderMarkdown, useColor: ui.useColor }));
+        console.log(`${visuals.hr}\n`);
+    }
+    catch (err) {
+        stopProcessingSpinner?.();
+        console.error("Error:", err instanceof Error ? err.message : err);
+    }
+}
+export async function interactive(ctx, kind, options, exitApp) {
+    const runtime = await createRuntime(ctx, kind);
+    const ui = resolveUiOptions(kind, options);
+    const color = createCliColors(ui.useColor);
+    const hr = `${color.dim}${"-".repeat(56)}${color.reset}`;
+    const promptText = `${color.prompt}[${color.promptUser}${ui.userLabel}${color.reset}${color.prompt}]${color.reset} `;
+    const userPrefix = `${color.user}[${ui.userLabel}]${color.reset}`;
+    const assistantPrefix = `${color.bot}[${ui.assistantLabel}]${color.reset}`;
+    const userLabelPrefixPattern = new RegExp(`^(?:\\[${escapeRegExp(ui.userLabel)}\\]\\s*)+`, "i");
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const introText = options.ui?.interactiveIntro ?? `${options.appName} (${kind === DEEP ? "Deep" : "ReAct"} agent). Type your message or "exit" to quit.`;
+    if (introText !== false)
+        console.log(`${introText}\n`);
+    const prompt = () => {
+        rl.question(promptText, async (line) => {
+            const query = line?.trim()?.replace(userLabelPrefixPattern, "").trim();
+            if (!query)
+                return prompt();
+            if (query === "exit" || query === "quit") {
+                rl.close();
+                exitApp(0);
+            }
+            const handled = await runInteractiveCommand(ctx, query, options.interactiveCommands);
+            if (handled)
+                return prompt();
+            await runUserQuery(query, runtime, ui, { hr, userPrefix, assistantPrefix });
+            prompt();
+        });
+    };
+    prompt();
+}
+//# sourceMappingURL=interactive.js.map

package/dist/cli/interactive.js.map

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

package/dist/cli/runtime.d.ts

@@ -0,0 +1,8 @@
+import { type ReactAgentRuntime } from "../agents/react-agent.js";
+import { type DeepAgentRuntime } from "../agents/deep-agent.js";
+import type { BotContext } from "../core/context.js";
+import { type AgentKind } from "./types.js";
+export declare function readDefaultAgentKindFromConfig(ctx: BotContext): AgentKind | undefined;
+export declare function createRuntime(ctx: BotContext, kind: AgentKind): Promise<ReactAgentRuntime | DeepAgentRuntime>;
+export declare function runOne(ctx: BotContext, kind: AgentKind, query: string): Promise<string>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/cli/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/cli/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACpF,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAEzD,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAMrF;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,SAAS,GACd,OAAO,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,CAO/C;AAED,wBAAsB,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI7F"}

package/dist/cli/runtime.js

@@ -0,0 +1,27 @@
+import { createReactAgent } from "../agents/react-agent.js";
+import { createDeepAgent } from "../agents/deep-agent.js";
+import { malformedToolCallMiddleware } from "../middleware/malformed-tool-call-middleware.js";
+import { DEEP, REACT } from "./types.js";
+export function readDefaultAgentKindFromConfig(ctx) {
+    const defaultAgent = ctx.config?.app?.defaultAgent;
+    if (typeof defaultAgent !== "string")
+        return undefined;
+    const value = defaultAgent.trim().toLowerCase();
+    if (value === REACT || value === DEEP)
+        return value;
+    return undefined;
+}
+export async function createRuntime(ctx, kind) {
+    if (kind === REACT) {
+        return createReactAgent(ctx, {
+            middleware: [malformedToolCallMiddleware()],
+        });
+    }
+    return createDeepAgent(ctx);
+}
+export async function runOne(ctx, kind, query) {
+    const runtime = await createRuntime(ctx, kind);
+    const { text } = await runtime.run(query);
+    return text;
+}
+//# sourceMappingURL=runtime.js.map

package/dist/cli/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/cli/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAA0B,MAAM,0BAA0B,CAAC;AACpF,OAAO,EAAE,eAAe,EAAyB,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AAE9F,OAAO,EAAE,IAAI,EAAE,KAAK,EAAkB,MAAM,YAAY,CAAC;AAEzD,MAAM,UAAU,8BAA8B,CAAC,GAAe;IAC5D,MAAM,YAAY,GAAI,GAAG,CAAC,MAAM,EAAE,GAA8C,EAAE,YAAY,CAAC;IAC/F,IAAI,OAAO,YAAY,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACvD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACpD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAe,EACf,IAAe;IAEf,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QACnB,OAAO,gBAAgB,CAAC,GAAG,EAAE;YAC3B,UAAU,EAAE,CAAC,2BAA2B,EAAE,CAAC;SAC5C,CAAC,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,GAAe,EAAE,IAAe,EAAE,KAAa;IAC1E,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/spinner.d.ts

@@ -0,0 +1,2 @@
+export declare function startLoadingSpinner(message: string): () => void;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/cli/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/cli/spinner.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,IAAI,CAsB/D"}

package/dist/cli/spinner.js

@@ -0,0 +1,22 @@
+export function startLoadingSpinner(message) {
+    const frames = ["", ".", "..", "..."];
+    let frameIndex = 0;
+    let lastLength = 0;
+    const render = () => {
+        const frame = frames[frameIndex % frames.length] ?? "";
+        const trimmed = message.trim();
+        const base = trimmed.startsWith("⏳") ? trimmed : `⏳ ${trimmed}`;
+        const line = `${base}${frame}`;
+        const padded = lastLength > line.length ? line.padEnd(lastLength, " ") : line;
+        process.stderr.write(`\r${padded}\r`);
+        lastLength = padded.length;
+        frameIndex += 1;
+    };
+    render();
+    const timer = setInterval(render, 90);
+    return () => {
+        clearInterval(timer);
+        process.stderr.write(`\r${" ".repeat(lastLength)}\r`);
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/cli/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/cli/spinner.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,MAAM,MAAM,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACvD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QAChE,MAAM,IAAI,GAAG,GAAG,IAAI,GAAG,KAAK,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC;QACtC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;QAC3B,UAAU,IAAI,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,EAAE,CAAC;IACT,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtC,OAAO,GAAG,EAAE;QACV,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC,CAAC;AACJ,CAAC"}

package/dist/cli/terminal-render.d.ts

@@ -0,0 +1,7 @@
+interface RenderOptions {
+    renderMarkdown: boolean;
+    useColor: boolean;
+}
+export declare function renderForTerminal(text: string, options: RenderOptions): string;
+export {};
+//# sourceMappingURL=terminal-render.d.ts.map

package/dist/cli/terminal-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-render.d.ts","sourceRoot":"","sources":["../../src/cli/terminal-render.ts"],"names":[],"mappings":"AAGA,UAAU,aAAa;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAmTD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAQ9E"}

package/dist/cli/terminal-render.js

@@ -0,0 +1,282 @@
+import MarkdownIt from "markdown-it";
+import markdownItTerminal from "markdown-it-terminal";
+const markdownRenderers = new Map();
+function createAnsi(useColor) {
+    return {
+        reset: useColor ? "\x1b[0m" : "",
+        dim: useColor ? "\x1b[2m" : "",
+        heading: useColor ? "\x1b[1;38;5;45m" : "",
+        bullet: useColor ? "\x1b[38;5;81m" : "",
+        code: useColor ? "\x1b[38;5;221m" : "",
+        quote: useColor ? "\x1b[38;5;245m" : "",
+        hr: useColor ? "\x1b[38;5;240m" : "",
+    };
+}
+function styleInlineMarkdown(line, ansi) {
+    return line
+        .replace(/`([^`]+)`/g, `${ansi.code}\`$1\`${ansi.reset}`)
+        .replace(/\*\*([^*]+)\*\*/g, `${ansi.heading}$1${ansi.reset}`);
+}
+function parseTableRow(line) {
+    const trimmed = line.trim().replace(/^\|/, "").replace(/\|$/, "");
+    return trimmed.split("|").map((cell) => cell.trim());
+}
+function isTableSeparatorRow(cells) {
+    return cells.length > 0 && cells.every((c) => /^:?-{3,}:?$/.test(c));
+}
+function renderTable(rows, ansi) {
+    const normalized = rows.map((row) => [...row]);
+    const colCount = Math.max(...normalized.map((row) => row.length));
+    for (const row of normalized) {
+        while (row.length < colCount)
+            row.push("");
+    }
+    const widths = Array.from({ length: colCount }, (_, i) => Math.max(...normalized.map((row) => (row[i] ?? "").length)));
+    const border = `+${widths.map((w) => "-".repeat(w + 2)).join("+")}+`;
+    const output = [`${ansi.hr}${border}${ansi.reset}`];
+    normalized.forEach((row, idx) => {
+        const body = row.map((cell, i) => ` ${(cell ?? "").padEnd(widths[i] ?? 0)} `).join("|");
+        const styled = idx === 0
+            ? `${ansi.heading}|${styleInlineMarkdown(body, ansi)}|${ansi.reset}`
+            : `|${styleInlineMarkdown(body, ansi)}|`;
+        output.push(styled);
+        if (idx === 0)
+            output.push(`${ansi.hr}${border}${ansi.reset}`);
+    });
+    output.push(`${ansi.hr}${border}${ansi.reset}`);
+    return output;
+}
+function appendCodeFenceLine(line, state, ansi, out) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("```"))
+        return;
+    if (!state.inCodeBlock) {
+        const lang = trimmed.slice(3).trim();
+        const title = lang ? ` code:${lang} ` : " code ";
+        state.codeBoxWidth = Math.max(16, title.length + 4);
+        state.inCodeBlock = true;
+        out.push(`${ansi.hr}┌${"─".repeat(state.codeBoxWidth)}┐${ansi.reset}`);
+        out.push(`${ansi.hr}│${ansi.reset}${ansi.dim}${title.padEnd(state.codeBoxWidth)}${ansi.reset}${ansi.hr}│${ansi.reset}`);
+        return;
+    }
+    state.inCodeBlock = false;
+    out.push(`${ansi.hr}└${"─".repeat(state.codeBoxWidth)}┘${ansi.reset}`);
+}
+function renderMarkdownTable(lines, index, ansi) {
+    const line = lines[index] ?? "";
+    const next = lines[index + 1] ?? "";
+    if (!line.includes("|") || !next.includes("|"))
+        return null;
+    const header = parseTableRow(line);
+    const separator = parseTableRow(next);
+    if (!(header.length > 1 && header.length === separator.length && isTableSeparatorRow(separator))) {
+        return null;
+    }
+    const rows = [header];
+    let cursor = index + 2;
+    while (cursor < lines.length && (lines[cursor] ?? "").includes("|")) {
+        rows.push(parseTableRow(lines[cursor] ?? ""));
+        cursor += 1;
+    }
+    return { nextIndex: cursor - 1, rendered: renderTable(rows, ansi) };
+}
+function formatMarkdownForTerminal(markdown, options = { useColor: true }) {
+    const ansi = createAnsi(options.useColor);
+    const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+    const out = [];
+    const state = { inCodeBlock: false, codeBoxWidth: 0 };
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        const before = state.inCodeBlock;
+        appendCodeFenceLine(line, state, ansi, out);
+        if (line.trim().startsWith("```"))
+            continue;
+        if (before && state.inCodeBlock) {
+            const content = line.length > state.codeBoxWidth ? line.slice(0, state.codeBoxWidth) : line.padEnd(state.codeBoxWidth);
+            out.push(`${ansi.hr}│${ansi.reset}${ansi.code}${content}${ansi.reset}${ansi.hr}│${ansi.reset}`);
+            continue;
+        }
+        const table = renderMarkdownTable(lines, i, ansi);
+        if (table) {
+            out.push(...table.rendered);
+            i = table.nextIndex;
+            continue;
+        }
+        if (/^\s*#{1,6}\s+/.test(line)) {
+            out.push(`${ansi.heading}${line.replace(/^\s*#{1,6}\s+/, "").trim()}${ansi.reset}`);
+            continue;
+        }
+        if (/^\s*>\s?/.test(line)) {
+            out.push(`${ansi.quote}${line}${ansi.reset}`);
+            continue;
+        }
+        if (/^\s*([-*]|\d+\.)\s+/.test(line)) {
+            out.push(`${ansi.bullet}${styleInlineMarkdown(line, ansi)}${ansi.reset}`);
+            continue;
+        }
+        if (/^\s*---+\s*$/.test(line)) {
+            out.push(`${ansi.hr}${"─".repeat(56)}${ansi.reset}`);
+            continue;
+        }
+        out.push(styleInlineMarkdown(line, ansi));
+    }
+    return out.join("\n");
+}
+function sanitizeLine(line) {
+    let next = line;
+    const trimmed = next.trim();
+    if (next.includes("```") && !trimmed.startsWith("```")) {
+        next = next.replace(/```+/g, "").replace(/\s+$/, "");
+    }
+    if (/^\s*#{3,}\s+/.test(next)) {
+        next = next.replace(/^\s*#{3,}\s+/, "## ");
+    }
+    return next;
+}
+function normalizeListLine(line) {
+    if (/^(\s{2,}|\t+)([*-])\s+/.test(line)) {
+        return line.replace(/^(\s{2,}|\t+)([*-])\s+/, "- ");
+    }
+    if (/^(\s{2,}|\t+)(\d+\.)\s+/.test(line)) {
+        return line.replace(/^(\s{2,}|\t+)(\d+\.)\s+/, "$2 ");
+    }
+    return line;
+}
+function applyHeadingHeuristics(lines, hasMarkdownHeadings) {
+    return lines.map((line) => {
+        const trimmed = line.trim();
+        const bulletHeading = trimmed.match(/^[-*]\s+\*\*([^*]+)\*\*: ?\s*$/);
+        if (bulletHeading?.[1])
+            return `### ${bulletHeading[1].trim()}`;
+        const plainBullet = trimmed.match(/^[-*]\s+([^`].+):\s*$/);
+        if (plainBullet?.[1] && plainBullet[1].length <= 48) {
+            return `### ${plainBullet[1].trim()}`;
+        }
+        if (hasMarkdownHeadings)
+            return trimmed === "Summary (3‑8 bullets)" ? "## Summary" : line;
+        const unwrapped = trimmed.replace(/^\*\*(.+)\*\*$/, "$1").trim();
+        if (/^(Key terminal output.*|Current terminal buffer.*|Summary.*|Next steps.*)$/i.test(unwrapped)) {
+            return `## ${unwrapped}`;
+        }
+        if (/^(Key observations|Findings|Analysis|Conclusion)$/i.test(unwrapped)) {
+            return `## ${unwrapped}`;
+        }
+        return line;
+    });
+}
+function mergeWrappedListItems(lines) {
+    const merged = [];
+    for (let i = 0; i < lines.length; i += 1) {
+        const current = lines[i] ?? "";
+        const next = lines[i + 1] ?? "";
+        const isListLine = /^([-*]|\d+\.)\s+/.test(current.trim());
+        const nextTrim = next.trim();
+        const nextStartsNewBlock = nextTrim.length === 0 ||
+            /^([-*]|\d+\.)\s+/.test(nextTrim) ||
+            /^#{1,6}\s+/.test(nextTrim) ||
+            /^```/.test(nextTrim) ||
+            /^---+$/.test(nextTrim);
+        const wrappedContinuation = isListLine && !nextStartsNewBlock && /^[0-9./~]/.test(nextTrim);
+        if (wrappedContinuation) {
+            merged.push(`${current.replace(/\s+$/, "")} ${nextTrim}`);
+            i += 1;
+            continue;
+        }
+        merged.push(current);
+    }
+    return merged;
+}
+function fenceIndentedOutputBlocks(lines) {
+    const output = [];
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i] ?? "";
+        output.push(line);
+        const heading = line.trim();
+        const isOutputHeading = /^##\s*(Key terminal output|Current terminal buffer|Terminal output)/i.test(heading);
+        if (!isOutputHeading)
+            continue;
+        if ((lines[i + 1] ?? "").trim().startsWith("```"))
+            continue;
+        let j = i + 1;
+        const block = [];
+        while (j < lines.length) {
+            const current = lines[j] ?? "";
+            if (!current.trim()) {
+                if (block.length === 0) {
+                    j += 1;
+                    continue;
+                }
+                break;
+            }
+            if (!/^\s{2,}\S/.test(current))
+                break;
+            block.push(current.replace(/^\s+/, ""));
+            j += 1;
+        }
+        if (block.length >= 2) {
+            output.push("```text", ...block, "```");
+            i = j - 1;
+        }
+    }
+    return output;
+}
+function ensureBalancedCodeFences(lines) {
+    const count = lines.reduce((acc, line) => acc + (/^\s*```/.test(line) ? 1 : 0), 0);
+    if (count % 2 === 0)
+        return lines;
+    return [...lines, "```"];
+}
+function normalizeAssistantMarkdown(text) {
+    const source = text.replace(/\r\n/g, "\n");
+    const hasHeadings = /^\s*#{1,6}\s+/m.test(source);
+    const sanitized = source.split("\n").map(sanitizeLine).map(normalizeListLine);
+    const titled = applyHeadingHeuristics(sanitized, hasHeadings);
+    const merged = mergeWrappedListItems(titled);
+    const fenced = fenceIndentedOutputBlocks(merged);
+    return ensureBalancedCodeFences(fenced).join("\n");
+}
+function getMarkdownRenderer(useColor) {
+    const key = useColor ? "color" : "plain";
+    const cached = markdownRenderers.get(key);
+    if (cached)
+        return cached;
+    const renderer = new MarkdownIt({ html: false, linkify: true, typographer: true, breaks: false });
+    renderer.use(markdownItTerminal, {
+        indent: "",
+        ...(useColor
+            ? {}
+            : {
+                styleOptions: {
+                    code: (s) => s,
+                    blockquote: (s) => s,
+                    html: (s) => s,
+                    heading: (s) => s,
+                    firstHeading: (s) => s,
+                    hr: (s) => s,
+                    listitem: (s) => s,
+                    table: (s) => s,
+                    paragraph: (s) => s,
+                    strong: (s) => s,
+                    em: (s) => s,
+                    codespan: (s) => s,
+                    del: (s) => s,
+                    link: (s) => s,
+                    href: (s) => s,
+                },
+            }),
+    });
+    markdownRenderers.set(key, renderer);
+    return renderer;
+}
+export function renderForTerminal(text, options) {
+    if (!options.renderMarkdown)
+        return text;
+    const normalized = normalizeAssistantMarkdown(text);
+    try {
+        return getMarkdownRenderer(options.useColor).render(normalized, {});
+    }
+    catch {
+        return formatMarkdownForTerminal(normalized, { useColor: options.useColor });
+    }
+}
+//# sourceMappingURL=terminal-render.js.map