@botbotgo/agent-harness 0.0.309 → 0.0.310

package/dist/cli/process-guards.js

@@ -0,0 +1,139 @@
+import { EventEmitter } from "node:events";
+const CLI_IGNORED_STDERR_WARNING_SNIPPETS = [
+    "llamaindex was already imported. This breaks constructor checks and will lead to issues!",
+    "MaxListenersExceededWarning: Possible EventEmitter memory leak detected.",
+    "(Use `node --trace-warnings ...` to show where the warning was created)",
+];
+export function isChatServerNoiseLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+        return true;
+    }
+    return (trimmed.startsWith("Serving ACP over stdio from ") ||
+        trimmed === "langsmith/experimental/sandbox is in alpha. This feature is experimental, and breaking changes are expected." ||
+        trimmed === "llamaindex was already imported. This breaks constructor checks and will lead to issues!");
+}
+export function installCliWriteListenerGuard(streams, minimum = 64) {
+    const restore = [];
+    for (const stream of streams) {
+        if (!stream?.getMaxListeners || !stream?.setMaxListeners) {
+            continue;
+        }
+        const previous = stream.getMaxListeners();
+        if (previous === 0 || previous >= minimum) {
+            continue;
+        }
+        stream.setMaxListeners(minimum);
+        restore.push(() => stream.setMaxListeners?.(previous));
+    }
+    return () => {
+        for (const reset of restore.reverse()) {
+            reset();
+        }
+    };
+}
+export function installCliEmitterListenerGuard(minimum = 64) {
+    const previous = EventEmitter.defaultMaxListeners;
+    const hadPrototypeMaxListeners = Object.prototype.hasOwnProperty.call(EventEmitter.prototype, "_maxListeners");
+    const previousPrototypeMaxListeners = EventEmitter.prototype._maxListeners;
+    if (previous === 0 || previous >= minimum) {
+        return () => undefined;
+    }
+    EventEmitter.defaultMaxListeners = minimum;
+    EventEmitter.prototype._maxListeners = minimum;
+    return () => {
+        EventEmitter.defaultMaxListeners = previous;
+        if (hadPrototypeMaxListeners) {
+            EventEmitter.prototype._maxListeners = previousPrototypeMaxListeners;
+            return;
+        }
+        delete EventEmitter.prototype._maxListeners;
+    };
+}
+export function installCliStderrNoiseFilter(enabled) {
+    if (!enabled) {
+        return () => undefined;
+    }
+    const originalStderrWrite = process.stderr.write.bind(process.stderr);
+    process.stderr.write = ((chunk, encoding, callback) => {
+        const text = typeof chunk === "string"
+            ? chunk
+            : chunk instanceof Uint8Array
+                ? Buffer.from(chunk).toString(typeof encoding === "string" ? encoding : undefined)
+                : "";
+        if (CLI_IGNORED_STDERR_WARNING_SNIPPETS.some((snippet) => text.includes(snippet))) {
+            if (typeof encoding === "function") {
+                encoding();
+            }
+            else if (typeof callback === "function") {
+                callback();
+            }
+            return true;
+        }
+        if (typeof encoding === "function") {
+            return originalStderrWrite(chunk, encoding);
+        }
+        return originalStderrWrite(chunk, encoding, callback);
+    });
+    return () => {
+        process.stderr.write = originalStderrWrite;
+    };
+}
+export function installCliWarningFilter() {
+    const originalEmitWarning = process.emitWarning.bind(process);
+    process.emitWarning = ((warning, ...args) => {
+        const text = typeof warning === "string" ? warning : warning?.message ?? "";
+        const name = typeof warning === "string" ? String(args[1] ?? args[0] ?? "") : warning?.name ?? "";
+        if (CLI_IGNORED_STDERR_WARNING_SNIPPETS.some((snippet) => text.includes(snippet))
+            || name === "MaxListenersExceededWarning") {
+            return;
+        }
+        return originalEmitWarning(warning, ...args);
+    });
+    return () => {
+        process.emitWarning = originalEmitWarning;
+    };
+}
+function terminateChatSubprocess(child, signal = "SIGTERM") {
+    if (child.killed || child.exitCode !== null || child.signalCode !== null) {
+        return;
+    }
+    try {
+        child.kill(signal);
+    }
+    catch {
+        // Ignore termination races during shutdown.
+    }
+}
+export function installChatSubprocessExitGuard(child, host = process) {
+    let cleanedUp = false;
+    let forceKillTimer;
+    const handleParentExit = () => {
+        terminateChatSubprocess(child, "SIGTERM");
+        if (!forceKillTimer && child.exitCode === null && child.signalCode === null) {
+            forceKillTimer = setTimeout(() => {
+                terminateChatSubprocess(child, "SIGKILL");
+            }, 2_000);
+            forceKillTimer.unref?.();
+        }
+    };
+    const cleanup = () => {
+        if (cleanedUp) {
+            return;
+        }
+        cleanedUp = true;
+        if (forceKillTimer) {
+            clearTimeout(forceKillTimer);
+            forceKillTimer = undefined;
+        }
+        host.off("beforeExit", handleParentExit);
+        host.off("exit", handleParentExit);
+        child.off("close", cleanup);
+        child.off("exit", cleanup);
+    };
+    host.on("beforeExit", handleParentExit);
+    host.on("exit", handleParentExit);
+    child.on("close", cleanup);
+    child.on("exit", cleanup);
+    return cleanup;
+}

package/dist/cli/request-tree.d.ts

@@ -0,0 +1,12 @@
+import type { RequestEventSnapshot, RequestExecutionStep } from "../contracts/types.js";
+export declare function flattenRequestExecutionSteps(snapshot: RequestEventSnapshot): RequestExecutionStep[];
+export declare function renderRequestSnapshotTree(snapshot: RequestEventSnapshot, color?: boolean, timingSummary?: string): string;
+export declare function renderRequestEventContinuation(snapshot: RequestEventSnapshot, fromIndex: number, color?: boolean): string;
+export declare function buildTodoContinuationSignature(snapshot: RequestEventSnapshot): string;
+export declare function renderRequestTodoContinuation(snapshot: RequestEventSnapshot, previousSignature: string, color?: boolean): string;
+export declare function buildTerminalRequestSnapshot(snapshot: RequestEventSnapshot, result: {
+    state: string;
+    output: string;
+}): RequestEventSnapshot;
+export declare function summarizeRequestOutput(output: string, color: boolean): string;
+export declare function buildExecutionStepContinuationKey(step: RequestExecutionStep): string;

package/dist/cli/request-tree.js

@@ -0,0 +1,296 @@
+const STEP_KIND_ICON = {
+    llm: "◆",
+    tool: "⚙",
+    skill: "★",
+    agent: "◉",
+    memory: "◈",
+    approval: "⚠",
+};
+function ellipsizeChatId(value, maxChars) {
+    if (value.length <= maxChars) {
+        return value;
+    }
+    if (maxChars <= 1) {
+        return "…";
+    }
+    return `${value.slice(0, maxChars - 1)}…`;
+}
+function formatTreeBranch(isLast) {
+    return isLast ? "└─" : "├─";
+}
+function formatTreeIndent(ancestorLast) {
+    return ancestorLast ? "   " : "│  ";
+}
+function applyAnsi(text, code, enabled) {
+    if (!enabled) {
+        return text;
+    }
+    return `\x1b[${code}m${text}\x1b[0m`;
+}
+function renderRequestStateBadge(state, color) {
+    if (state === "completed") {
+        return color ? `\x1b[32;1m✔ DONE\x1b[0m` : "✔ DONE";
+    }
+    if (state === "running") {
+        return color ? `\x1b[36;1m▶ RUNNING\x1b[0m` : "▶ RUNNING";
+    }
+    if (state === "waiting" || state === "waiting_for_approval") {
+        return color ? `\x1b[33;1m⚠ WAITING\x1b[0m` : "⚠ WAITING";
+    }
+    if (state === "failed") {
+        return color ? `\x1b[31;1m✘ FAILED\x1b[0m` : "✘ FAILED";
+    }
+    if (state === "cancelled") {
+        return color ? `\x1b[31m○ CANCELLED\x1b[0m` : "○ CANCELLED";
+    }
+    if (state === "queued") {
+        return color ? `\x1b[38;5;242m· QUEUED\x1b[0m` : "· QUEUED";
+    }
+    return color ? `\x1b[37m${state.toUpperCase()}\x1b[0m` : state.toUpperCase();
+}
+function summarizeRequestPlan(snapshot) {
+    const summary = snapshot.plan.summary;
+    const eventCount = flattenRequestExecutionSteps(snapshot).length;
+    const parts = [
+        `${summary.total} todo${summary.total === 1 ? "" : "s"}`,
+        summary.inProgress > 0 ? `${summary.inProgress} active` : undefined,
+        summary.completed > 0 ? `${summary.completed} done` : undefined,
+        summary.failed > 0 ? `${summary.failed} failed` : undefined,
+        eventCount > 0 ? `${eventCount} event${eventCount === 1 ? "" : "s"}` : undefined,
+    ].filter((part) => typeof part === "string");
+    return parts.join(" · ");
+}
+function formatCompactClockTime(value) {
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return value;
+    }
+    return new Intl.DateTimeFormat("en-US", {
+        hour12: false,
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+    }).format(date);
+}
+function renderTimeRange(startedAt, endedAt, detail, color) {
+    if (!startedAt && !endedAt) {
+        return "";
+    }
+    const from = startedAt ? formatCompactClockTime(startedAt) : "?";
+    const to = endedAt ? formatCompactClockTime(endedAt) : "now";
+    const durationMs = typeof detail?.durationMs === "number" ? detail.durationMs : undefined;
+    const durationLabel = durationMs !== undefined
+        ? ` · ${(durationMs / 1000).toFixed(durationMs >= 10_000 ? 0 : durationMs >= 1_000 ? 1 : 3)}s`
+        : "";
+    return ` ${applyAnsi(`[${from} -> ${to}${durationLabel}]`, "2", color)}`;
+}
+function readStepSkillNames(step) {
+    const value = step.detail?.skillNames;
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string" && item.trim().length > 0) : [];
+}
+function buildRequestStepEventKey(step) {
+    return `${step.kind}:${step.id}`;
+}
+function resolveEventTimestamp(step) {
+    return step.occurredAt ?? step.endedAt ?? step.startedAt;
+}
+function summarizeRequestStepDetail(step, displayName, color) {
+    if (step.kind === "memory" && step.detail?.source === "runtime-durable-memory") {
+        const count = typeof step.detail.count === "number" ? step.detail.count : undefined;
+        const scopes = Array.isArray(step.detail.scopes)
+            ? step.detail.scopes.filter((item) => typeof item === "string" && item.trim().length > 0)
+            : [];
+        const countLabel = count !== undefined ? `${count} record${count === 1 ? "" : "s"}` : undefined;
+        const scopeLabel = scopes.length > 0 ? scopes.join(", ") : undefined;
+        const summary = typeof step.detail.summary === "string" ? step.detail.summary.trim() : "";
+        const detailLabel = [countLabel, scopeLabel].filter((value) => Boolean(value)).join(" · ");
+        if (detailLabel) {
+            return ` ${applyAnsi(`(${detailLabel})`, "2", color)}`;
+        }
+        if (summary && !summary.toLowerCase().includes(displayName.toLowerCase())) {
+            const preview = summary.length > 48 ? `${summary.slice(0, 45)}...` : summary;
+            return ` ${applyAnsi(`(${preview})`, "2", color)}`;
+        }
+        return "";
+    }
+    if (step.ownerAgentId && step.ownerAgentId !== step.agentId) {
+        return ` ${applyAnsi(`(from ${step.ownerAgentId})`, "2", color)}`;
+    }
+    return "";
+}
+function statusIcon(status, color) {
+    if (status === "completed" || status === "done")
+        return applyAnsi("✔", "32", color);
+    if (status === "in_progress" || status === "started")
+        return applyAnsi("▶", "36", color);
+    if (status === "failed")
+        return applyAnsi("✘", "31", color);
+    if (status === "cancelled")
+        return applyAnsi("○", "31", color);
+    if (status === "pending" || status === "queued")
+        return applyAnsi("·", "238", color);
+    return applyAnsi("?", "37", color);
+}
+function renderRequestStepLine(step, prefix, isLast, _activeEventId, color = false) {
+    const skillNames = step.kind === "skill" ? readStepSkillNames(step) : [];
+    const profileDisplayName = step.id.startsWith("profile:") && step.kind === "agent"
+        ? `${step.name} ${step.action ?? ""}`.trim()
+        : undefined;
+    const displayName = profileDisplayName
+        ? profileDisplayName
+        : step.kind === "skill" && skillNames.length === 1
+            ? skillNames[0]
+            : step.kind === "skill" && skillNames.length > 1
+                ? skillNames.join(", ")
+                : step.name;
+    const icon = STEP_KIND_ICON[step.kind] ?? "·";
+    const kindLabel = color
+        ? `\x1b[38;5;242m${icon} ${step.kind}\x1b[0m`
+        : `${icon} ${step.kind}`;
+    const stIcon = statusIcon(step.status === "started" ? "in_progress" : step.status, color);
+    const nameFormatted = color ? `\x1b[38;5;252m${displayName}\x1b[0m` : displayName;
+    const eventTime = resolveEventTimestamp(step);
+    const timeLabel = eventTime ? applyAnsi(`[${formatCompactClockTime(eventTime)}]`, "2", color) : applyAnsi("[time?]", "2", color);
+    const detailSuffix = summarizeRequestStepDetail(step, displayName, color);
+    return `${prefix}${formatTreeBranch(isLast)} ${timeLabel} ${stIcon} ${kindLabel} ${nameFormatted}${detailSuffix}`;
+}
+function isInternalAgentLifecycleStep(step) {
+    return step.kind === "agent" && step.id.startsWith("profile:agent:");
+}
+function isVisibleRequestTreeStep(step) {
+    if (step.kind === "skill") {
+        return false;
+    }
+    return !isInternalAgentLifecycleStep(step);
+}
+function getVisibleTodoEvents(todo) {
+    return todo.events.filter(isVisibleRequestTreeStep);
+}
+function getVisibleRootEvents(snapshot) {
+    return snapshot.events.filter(isVisibleRequestTreeStep);
+}
+export function flattenRequestExecutionSteps(snapshot) {
+    return [
+        ...snapshot.plan.items.flatMap((item) => getVisibleTodoEvents(item)),
+        ...getVisibleRootEvents(snapshot),
+    ];
+}
+function buildExecutionStepEventKey(step) {
+    return [
+        buildRequestStepEventKey(step),
+        step.status,
+        step.startedAt ?? "",
+        step.endedAt ?? "",
+    ].join("|");
+}
+export function renderRequestSnapshotTree(snapshot, color = false, timingSummary) {
+    const lines = [];
+    const rootEvents = getVisibleRootEvents(snapshot);
+    const badge = renderRequestStateBadge(snapshot.state, color);
+    const agentLabel = snapshot.agentId
+        ? (color ? `\x1b[38;5;33m${snapshot.agentId}\x1b[0m` : snapshot.agentId)
+        : applyAnsi("unknown", "2", color);
+    const headerLabel = color ? `\x1b[1;37mREQUEST\x1b[0m` : "REQUEST";
+    lines.push(`${headerLabel}  ${badge}  ${applyAnsi("agent:", "2", color)}${agentLabel}`);
+    const muted = (s) => applyAnsi(s, "2", color);
+    lines.push(`├─ ${muted("session")} ${applyAnsi(ellipsizeChatId(snapshot.sessionId, 24), "2", color)}`);
+    lines.push(`├─ ${muted("request")} ${applyAnsi(ellipsizeChatId(snapshot.requestId, 24), "2", color)}`);
+    const planSummary = summarizeRequestPlan(snapshot);
+    const timing = timingSummary ?? "collecting";
+    lines.push(`├─ ${muted("plan")} ${applyAnsi(`v${snapshot.plan.version}`, "2", color)}  ${muted("·")}  ${planSummary ? applyAnsi(planSummary, "2", color) : muted("no tracked work yet")}`);
+    lines.push(`├─ ${muted("timing")} ${applyAnsi(timing, "2", color)}`);
+    lines.push(`├─ ${muted("todos")}`);
+    const planPrefix = `${formatTreeIndent(false)}`;
+    if (snapshot.plan.items.length === 0) {
+        lines.push(`${planPrefix}└─ ${muted("none yet")}`);
+    }
+    else {
+        snapshot.plan.items.forEach((todo, todoIndex) => {
+            const todoEvents = getVisibleTodoEvents(todo);
+            const todoIsLast = todoIndex === snapshot.plan.items.length - 1 && rootEvents.length === 0 && !snapshot.approval;
+            const todoActive = todo.key === snapshot.activeTodoKey ? (color ? ` \x1b[36m●\x1b[0m` : " ●") : "";
+            const tIcon = statusIcon(todo.status, color);
+            const todoTimeRange = renderTimeRange(todo.startedAt, todo.endedAt, undefined, color);
+            const todoContent = color ? `\x1b[38;5;253m${todo.content}\x1b[0m` : todo.content;
+            lines.push(`${planPrefix}${formatTreeBranch(todoIsLast)} ${tIcon} ${todoContent}${todoTimeRange}${todoActive}`);
+            if (todoEvents.length > 0) {
+                const todoEventPrefix = `${planPrefix}${formatTreeIndent(todoIsLast)}`;
+                todoEvents.forEach((step, eventIndex) => {
+                    lines.push(renderRequestStepLine(step, todoEventPrefix, eventIndex === todoEvents.length - 1, snapshot.activeEventId, color));
+                });
+            }
+        });
+    }
+    if (rootEvents.length > 0) {
+        lines.push(`├─ ${muted("events")}`);
+        rootEvents.forEach((step, index) => {
+            lines.push(renderRequestStepLine(step, `${formatTreeIndent(false)}`, index === rootEvents.length - 1 && !snapshot.approval, snapshot.activeEventId, color));
+        });
+    }
+    if (snapshot.approval) {
+        const approvalStatus = snapshot.approval.status ?? "pending";
+        const approvalColor = approvalStatus === "approved" ? "32" : approvalStatus === "rejected" ? "31" : "33";
+        lines.push(`└─ ${color ? `\x1b[33m⚠ approval\x1b[0m` : "⚠ approval"} ${muted("·")} ${snapshot.approval.toolName ?? "unknown-tool"} ${applyAnsi(`(${approvalStatus})`, approvalColor, color)}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+export function renderRequestEventContinuation(snapshot, fromIndex, color = false) {
+    const eventSteps = flattenRequestExecutionSteps(snapshot).slice(fromIndex);
+    if (eventSteps.length === 0) {
+        return "";
+    }
+    const muted = (s) => applyAnsi(s, "2", color);
+    const lines = [`${muted("events (continued)")}`];
+    eventSteps.forEach((step, index) => {
+        lines.push(renderRequestStepLine(step, "", index === eventSteps.length - 1, snapshot.activeEventId, color));
+    });
+    return `${lines.join("\n")}\n`;
+}
+export function buildTodoContinuationSignature(snapshot) {
+    return snapshot.plan.items
+        .map((item) => [
+        item.id ?? "",
+        item.content,
+        item.status,
+        item.ownerAgentId ?? "",
+        item.startedAt ?? "",
+        item.endedAt ?? "",
+    ].join("|"))
+        .join(";");
+}
+export function renderRequestTodoContinuation(snapshot, previousSignature, color = false) {
+    const nextSignature = buildTodoContinuationSignature(snapshot);
+    if (!nextSignature || nextSignature === previousSignature || snapshot.plan.items.length === 0) {
+        return "";
+    }
+    const muted = (s) => applyAnsi(s, "2", color);
+    const lines = [`${muted("todos (continued)")}`];
+    snapshot.plan.items.forEach((todo, index) => {
+        const tIcon = statusIcon(todo.status, color);
+        const todoTimeRange = renderTimeRange(todo.startedAt, todo.endedAt, undefined, color);
+        const todoContent = color ? `\x1b[38;5;253m${todo.content}\x1b[0m` : todo.content;
+        lines.push(`${formatTreeBranch(index === snapshot.plan.items.length - 1)} ${tIcon} ${todoContent}${todoTimeRange}`);
+    });
+    return `${lines.join("\n")}\n`;
+}
+export function buildTerminalRequestSnapshot(snapshot, result) {
+    return {
+        ...snapshot,
+        state: result.state,
+        updatedAt: new Date().toISOString(),
+        output: result.output,
+        activeEventId: undefined,
+    };
+}
+export function summarizeRequestOutput(output, color) {
+    const trimmed = output.trim();
+    if (!trimmed) {
+        return applyAnsi("empty", "2", color);
+    }
+    const normalized = trimmed.replace(/\s+/g, " ");
+    const preview = normalized.length > 72 ? `${normalized.slice(0, 69)}...` : normalized;
+    return applyAnsi(preview, "2", color);
+}
+export function buildExecutionStepContinuationKey(step) {
+    return buildExecutionStepEventKey(step);
+}

package/dist/cli/runtime-commands.d.ts

@@ -0,0 +1,15 @@
+import { createAgentHarness } from "../api.js";
+import { createAgentHarnessClient } from "../client.js";
+import { sleep } from "./managed-service.js";
+type RuntimeCommandIo = {
+    cwd: string;
+    stdout: (message: string) => void;
+    stderr: (message: string) => void;
+};
+type RuntimeCommandDeps = {
+    createHarness: typeof createAgentHarness;
+    createClient?: typeof createAgentHarnessClient;
+    sleep: typeof sleep;
+};
+export declare function handleRuntimeCommand(subcommandAndArgs: string[], io: RuntimeCommandIo, deps: RuntimeCommandDeps): Promise<number>;
+export {};