@botbotgo/runtime 1.0.0

package/dist/runtime/execution/agentRunProgress.js

@@ -0,0 +1,46 @@
+import { AgentMessageService } from "../stream/agentMessages.js";
+import { RunCompletionPolicy } from "./policies/runCompletionPolicy.js";
+import { RunSummaryFormatter } from "./policies/runSummaryFormatter.js";
+export class AgentRunProgress {
+    static shouldStopForSummary(context, summary, chunk, areTrackedArtifactsReady) {
+        return Promise.resolve(areTrackedArtifactsReady(context.trackedArtifactFiles)).then((artifactsReady) => {
+            if (context.trackedArtifactFiles.length > 0) {
+                return artifactsReady && !RunCompletionPolicy.isToolCallSummary(summary);
+            }
+            return artifactsReady &&
+                !RunCompletionPolicy.isToolCallSummary(summary) &&
+                RunCompletionPolicy.hasAssistantFinalMessage(chunk);
+        });
+    }
+    static shouldStopForChunk(context, params, chunk, areTrackedArtifactsReady) {
+        const summary = (params.summarizeChunk ?? AgentMessageService.summarizeAgentChunk)(chunk);
+        if (typeof summary !== "string")
+            return Promise.resolve(false);
+        return Promise.resolve(areTrackedArtifactsReady(context.trackedArtifactFiles)).then((artifactsReady) => {
+            if (context.trackedArtifactFiles.length > 0) {
+                return artifactsReady && !RunCompletionPolicy.isToolCallSummary(summary);
+            }
+            return artifactsReady &&
+                !RunCompletionPolicy.isToolCallSummary(summary) &&
+                RunCompletionPolicy.hasAssistantFinalMessage(chunk);
+        });
+    }
+    static logRunSummary(context, summary, elapsedMs, runLogger) {
+        if (summary.startsWith("Tool call:")) {
+            if (context.pendingToolCall) {
+                runLogger(RunSummaryFormatter.formatRunStep(context.pendingToolCall.summary, context.pendingToolCall.elapsedMs));
+            }
+            context.pendingToolCall = { summary, elapsedMs };
+            return;
+        }
+        if (summary === context.lastLoggedSummary)
+            return;
+        const formatted = context.pendingToolCall
+            ? RunSummaryFormatter.formatMergedRunStep(context.pendingToolCall.summary, summary, elapsedMs)
+            : RunSummaryFormatter.formatRunStep(summary, elapsedMs);
+        runLogger(formatted);
+        context.pendingToolCall = undefined;
+        context.lastLoggedSummary = summary;
+    }
+}
+//# sourceMappingURL=agentRunProgress.js.map

package/dist/runtime/execution/agentRunProgress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRunProgress.js","sourceRoot":"","sources":["../../../src/runtime/execution/agentRunProgress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAIxE,MAAM,OAAO,gBAAgB;IACpB,MAAM,CAAC,oBAAoB,CAChC,OAAiC,EACjC,OAAe,EACf,KAAa,EACb,wBAAwF;QAExF,OAAO,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,EAAE;YACvG,IAAI,OAAO,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5C,OAAO,cAAc,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC3E,CAAC;YACD,OAAO,cAAc;gBACnB,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,OAAO,CAAC;gBAC/C,mBAAmB,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,kBAAkB,CAC9B,OAAiC,EACjC,MAAsC,EACtC,KAAa,EACb,wBAAwF;QAExF,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,cAAc,IAAI,mBAAmB,CAAC,mBAAmB,CAAC,CAAC,KAAK,CAAC,CAAC;QAC1F,IAAI,OAAO,OAAO,KAAK,QAAQ;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/D,OAAO,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,EAAE;YACrG,IAAI,OAAO,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5C,OAAO,cAAc,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC3E,CAAC;YACD,OAAO,cAAc;gBACnB,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,OAAO,CAAC;gBAC/C,mBAAmB,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,MAAM,CAAC,aAAa,CACzB,OAAiC,EACjC,OAAe,EACf,SAAiB,EACjB,SAAoC;QAEpC,IAAI,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC5B,SAAS,CAAC,mBAAmB,CAAC,aAAa,CACzC,OAAO,CAAC,eAAe,CAAC,OAAO,EAC/B,OAAO,CAAC,eAAe,CAAC,SAAS,CAClC,CAAC,CAAC;YACL,CAAC;YACD,OAAO,CAAC,eAAe,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;YACjD,OAAO;QACT,CAAC;QACD,IAAI,OAAO,KAAK,OAAO,CAAC,iBAAiB;YAAE,OAAO;QAElD,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe;YACvC,CAAC,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;YAC9F,CAAC,CAAC,mBAAmB,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC1D,SAAS,CAAC,SAAS,CAAC,CAAC;QACrB,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;QACpC,OAAO,CAAC,iBAAiB,GAAG,OAAO,CAAC;IACtC,CAAC;CACF"}

package/dist/runtime/execution/agentRunState.d.ts

@@ -0,0 +1,44 @@
+import type { AgentWorkspaceState } from "../../state/workspaceState.js";
+export interface PendingToolCall {
+    summary: string;
+    elapsedMs: number;
+}
+export interface RetryState {
+    malformedRetryCount: number;
+    incompleteRetryCount: number;
+    emptyRetryCount: number;
+    idleTimeoutRetryCount: number;
+    transientModelRetryCount: number;
+    malformedToolCallMaxRetries: number;
+    incompleteRunMaxRetries: number;
+    emptyRunMaxRetries: number;
+    idleTimeoutMaxRetries: number;
+    transientModelMaxRetries: number;
+}
+export interface ExecutionContext<TChunk> {
+    run: Awaited<ReturnType<AgentWorkspaceState["prepareRun"]>>;
+    effectivePrompt: string;
+    trackedArtifactFiles: string[];
+    trackedPaths: string[];
+    requiredArtifactPaths: string[];
+    runInput: Awaited<ReturnType<AgentWorkspaceState["prepareRun"]>>["input"];
+    runConfig: Awaited<ReturnType<AgentWorkspaceState["prepareRun"]>>["config"];
+    pendingToolCall: PendingToolCall | undefined;
+    lastLoggedSummary: string;
+    lastStepCount: number;
+    lastSummary: string;
+}
+export declare class AgentRunStateFactory {
+    static createRetryState(hasTrackedArtifacts: boolean, params: {
+        malformedToolCallMaxRetries?: number;
+        incompleteRunMaxRetries?: number;
+        emptyRunMaxRetries?: number;
+        idleTimeoutMaxRetries?: number;
+    }, defaults: {
+        incompleteRunMaxRetries?: number;
+        emptyRunMaxRetries?: number;
+        malformedToolCallMaxRetries?: number;
+        idleTimeoutMaxRetries?: number;
+    }): RetryState;
+}
+//# sourceMappingURL=agentRunState.d.ts.map

package/dist/runtime/execution/agentRunState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRunState.d.ts","sourceRoot":"","sources":["../../../src/runtime/execution/agentRunState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wBAAwB,EAAE,MAAM,CAAC;IACjC,2BAA2B,EAAE,MAAM,CAAC;IACpC,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB,CAAC,MAAM;IACtC,GAAG,EAAE,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC1E,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5E,eAAe,EAAE,eAAe,GAAG,SAAS,CAAC;IAC7C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,oBAAoB;WACjB,gBAAgB,CAC5B,mBAAmB,EAAE,OAAO,EAC5B,MAAM,EAAE;QACN,2BAA2B,CAAC,EAAE,MAAM,CAAC;QACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,EACD,QAAQ,EAAE;QACR,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,2BAA2B,CAAC,EAAE,MAAM,CAAC;QACrC,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,GACA,UAAU;CAiBd"}

package/dist/runtime/execution/agentRunState.js

@@ -0,0 +1,17 @@
+export class AgentRunStateFactory {
+    static createRetryState(hasTrackedArtifacts, params, defaults) {
+        return {
+            malformedRetryCount: 0,
+            incompleteRetryCount: 0,
+            emptyRetryCount: 0,
+            idleTimeoutRetryCount: 0,
+            transientModelRetryCount: 0,
+            malformedToolCallMaxRetries: params.malformedToolCallMaxRetries ?? defaults.malformedToolCallMaxRetries ?? 2,
+            incompleteRunMaxRetries: params.incompleteRunMaxRetries ?? defaults.incompleteRunMaxRetries ?? (hasTrackedArtifacts ? 2 : 0),
+            emptyRunMaxRetries: params.emptyRunMaxRetries ?? defaults.emptyRunMaxRetries ?? 2,
+            idleTimeoutMaxRetries: params.idleTimeoutMaxRetries ?? defaults.idleTimeoutMaxRetries ?? 1,
+            transientModelMaxRetries: Number(process.env.LLM_TRANSIENT_RETRIES) >= 0 ? Number(process.env.LLM_TRANSIENT_RETRIES) : 0,
+        };
+    }
+}
+//# sourceMappingURL=agentRunState.js.map

package/dist/runtime/execution/agentRunState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRunState.js","sourceRoot":"","sources":["../../../src/runtime/execution/agentRunState.ts"],"names":[],"mappings":"AAiCA,MAAM,OAAO,oBAAoB;IACxB,MAAM,CAAC,gBAAgB,CAC5B,mBAA4B,EAC5B,MAKC,EACD,QAKC;QAED,OAAO;YACL,mBAAmB,EAAE,CAAC;YACtB,oBAAoB,EAAE,CAAC;YACvB,eAAe,EAAE,CAAC;YAClB,qBAAqB,EAAE,CAAC;YACxB,wBAAwB,EAAE,CAAC;YAC3B,2BAA2B,EACzB,MAAM,CAAC,2BAA2B,IAAI,QAAQ,CAAC,2BAA2B,IAAI,CAAC;YACjF,uBAAuB,EACrB,MAAM,CAAC,uBAAuB,IAAI,QAAQ,CAAC,uBAAuB,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrG,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,IAAI,QAAQ,CAAC,kBAAkB,IAAI,CAAC;YACjF,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,IAAI,QAAQ,CAAC,qBAAqB,IAAI,CAAC;YAC1F,wBAAwB,EACtB,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC;SACjG,CAAC;IACJ,CAAC;CACF"}

package/dist/runtime/execution/policies/runCompletionPolicy.d.ts

@@ -0,0 +1,5 @@
+export declare class RunCompletionPolicy {
+    static isToolCallSummary(summary: string): boolean;
+    static hasAssistantFinalMessage(chunk: unknown): boolean;
+}
+//# sourceMappingURL=runCompletionPolicy.d.ts.map

package/dist/runtime/execution/policies/runCompletionPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCompletionPolicy.d.ts","sourceRoot":"","sources":["../../../../src/runtime/execution/policies/runCompletionPolicy.ts"],"names":[],"mappings":"AAEA,qBAAa,mBAAmB;WAChB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;WAI3C,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;CAsBhE"}

package/dist/runtime/execution/policies/runCompletionPolicy.js

@@ -0,0 +1,30 @@
+import { AgentMessageService } from "../../stream/agentMessages.js";
+export class RunCompletionPolicy {
+    static isToolCallSummary(summary) {
+        return summary.startsWith("Tool call:");
+    }
+    static hasAssistantFinalMessage(chunk) {
+        if (!chunk)
+            return false;
+        const messages = AgentMessageService.getAgentMessages(chunk);
+        const last = messages.length > 0 ? messages[messages.length - 1] : undefined;
+        if (!last)
+            return false;
+        const role = String(last.role ?? "").toLowerCase();
+        const type = String(last.type ?? "").toLowerCase();
+        const kwargs = (last.kwargs ?? {});
+        const hasToolCalls = Array.isArray(last.tool_calls) && last.tool_calls.length > 0 ||
+            Array.isArray(kwargs.tool_calls) && kwargs.tool_calls.length > 0;
+        if (hasToolCalls)
+            return false;
+        const content = typeof last.content === "string"
+            ? last.content
+            : typeof kwargs.content === "string"
+                ? kwargs.content
+                : "";
+        if (!content.trim())
+            return false;
+        return role === "assistant" || role === "ai" || type.includes("ai");
+    }
+}
+//# sourceMappingURL=runCompletionPolicy.js.map

package/dist/runtime/execution/policies/runCompletionPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCompletionPolicy.js","sourceRoot":"","sources":["../../../../src/runtime/execution/policies/runCompletionPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,OAAO,mBAAmB;IACvB,MAAM,CAAC,iBAAiB,CAAC,OAAe;QAC7C,OAAO,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;IAEM,MAAM,CAAC,wBAAwB,CAAC,KAAc;QACnD,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7E,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QAExB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAgD,CAAC;QAClF,MAAM,YAAY,GAChB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;YAC5D,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACnE,IAAI,YAAY;YAAE,OAAO,KAAK,CAAC;QAE/B,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;YAC9C,CAAC,CAAC,IAAI,CAAC,OAAO;YACd,CAAC,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ;gBAClC,CAAC,CAAC,MAAM,CAAC,OAAO;gBAChB,CAAC,CAAC,EAAE,CAAC;QACT,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;YAAE,OAAO,KAAK,CAAC;QAClC,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;CACF"}

package/dist/runtime/execution/policies/runErrorPolicy.d.ts

@@ -0,0 +1,7 @@
+export declare class RunErrorPolicy {
+    static isIdleTimeoutError(error: unknown): boolean;
+    static isTransientModelError(error: unknown): boolean;
+    static isRecoverableToolCallError(error: unknown): boolean;
+    static createTransientModelError(error: unknown): Error;
+}
+//# sourceMappingURL=runErrorPolicy.d.ts.map

package/dist/runtime/execution/policies/runErrorPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runErrorPolicy.d.ts","sourceRoot":"","sources":["../../../../src/runtime/execution/policies/runErrorPolicy.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAc;WACX,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;WAK3C,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;WAa9C,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;WAuBnD,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK;CAO/D"}

package/dist/runtime/execution/policies/runErrorPolicy.js

@@ -0,0 +1,40 @@
+export class RunErrorPolicy {
+    static isIdleTimeoutError(error) {
+        const message = error instanceof Error ? error.message : String(error ?? "");
+        return message.includes("Agent stream idle timeout");
+    }
+    static isTransientModelError(error) {
+        const message = error instanceof Error ? error.message : String(error ?? "");
+        const normalized = message.toLowerCase();
+        return (normalized.includes("middlewareerror: 502") ||
+            normalized.includes("middlewareerror: 503") ||
+            normalized.includes("middlewareerror: 504") ||
+            normalized.includes("bad gateway") ||
+            normalized.includes("gateway timeout") ||
+            normalized.includes("<!doctype html>"));
+    }
+    static isRecoverableToolCallError(error) {
+        const seen = new Set();
+        let current = error;
+        while (current && typeof current === "object" && !seen.has(current)) {
+            seen.add(current);
+            const message = String(current.message ?? "").toLowerCase();
+            if (message.includes("error parsing tool call") ||
+                message.includes("invalid character") ||
+                message.includes("did not match expected schema") ||
+                message.includes("invalid input") ||
+                message.includes("error invoking tool") ||
+                message.includes("tool input")) {
+                return true;
+            }
+            current = current.cause;
+        }
+        return false;
+    }
+    static createTransientModelError(error) {
+        return new Error(`Model request failed with a transient upstream error. ` +
+            `Try reducing runtime config pressure (llmMaxTokens=1024, model timeout in config/model.yaml options.timeoutMs=60000) ` +
+            `and verify endpoint with scripts/verify-llm.sh. Original error: ${String(error)}`);
+    }
+}
+//# sourceMappingURL=runErrorPolicy.js.map

package/dist/runtime/execution/policies/runErrorPolicy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runErrorPolicy.js","sourceRoot":"","sources":["../../../../src/runtime/execution/policies/runErrorPolicy.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAc;IAClB,MAAM,CAAC,kBAAkB,CAAC,KAAc;QAC7C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC7E,OAAO,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC;IACvD,CAAC;IAEM,MAAM,CAAC,qBAAqB,CAAC,KAAc;QAChD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC7E,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACzC,OAAO,CACL,UAAU,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YAC3C,UAAU,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YAC3C,UAAU,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YAC3C,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC;YAClC,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACtC,UAAU,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CACvC,CAAC;IACJ,CAAC;IAEM,MAAM,CAAC,0BAA0B,CAAC,KAAc;QACrD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;QAChC,IAAI,OAAO,GAAY,KAAK,CAAC;QAE7B,OAAO,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACpE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAClB,MAAM,OAAO,GAAG,MAAM,CAAE,OAAiC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YACvF,IACE,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAC;gBAC3C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;gBACrC,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC;gBACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;gBACjC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC;gBACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAC9B,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,GAAI,OAA+B,CAAC,KAAK,CAAC;QACnD,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,MAAM,CAAC,yBAAyB,CAAC,KAAc;QACpD,OAAO,IAAI,KAAK,CACd,wDAAwD;YACtD,uHAAuH;YACvH,mEAAmE,MAAM,CAAC,KAAK,CAAC,EAAE,CACrF,CAAC;IACJ,CAAC;CACF"}

package/dist/runtime/execution/policies/runPromptBuilder.d.ts

@@ -0,0 +1,10 @@
+export declare class RunPromptBuilder {
+    static buildExecutionPrompt(prompt: string): string;
+    static buildIncompleteRetryPrompt(params: {
+        prompt: string;
+        trackedPaths: string[];
+        requiredArtifactPaths: string[];
+        lastSummary: string;
+    }): string;
+}
+//# sourceMappingURL=runPromptBuilder.d.ts.map

package/dist/runtime/execution/policies/runPromptBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPromptBuilder.d.ts","sourceRoot":"","sources":["../../../../src/runtime/execution/policies/runPromptBuilder.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAgB;WACb,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;WAe5C,0BAA0B,CAAC,MAAM,EAAE;QAC/C,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,qBAAqB,EAAE,MAAM,EAAE,CAAC;QAChC,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,MAAM;CAiBX"}

package/dist/runtime/execution/policies/runPromptBuilder.js

@@ -0,0 +1,34 @@
+export class RunPromptBuilder {
+    static buildExecutionPrompt(prompt) {
+        const guardrails = [
+            "Tool-call rules:",
+            '- Return strict JSON for tool args (example: {"offset":0}, never "offset=0").',
+            "- Use workspace-relative paths only; never construct absolute filesystem paths.",
+            "- Framework supports both tool calls and script commands; follow the SKILL whitelist per step.",
+            "- If a skill allows both tool and script for one step, prefer the tool path unless user asks for script.",
+            "- Do not inspect script source files unless the user explicitly asks for script code.",
+            "- Avoid redundant exploratory calls; use the shortest valid workflow.",
+            "- Complete the task in one uninterrupted run whenever possible; do not stop after intermediate reads or planning.",
+            "- If required output artifacts are missing, continue executing tool steps until they are written and validated.",
+        ].join("\n");
+        return `${prompt}\n\n${guardrails}`;
+    }
+    static buildIncompleteRetryPrompt(params) {
+        const missingOutputs = params.requiredArtifactPaths.length > 0
+            ? params.requiredArtifactPaths.join(", ")
+            : "(none)";
+        const previousSummary = params.lastSummary?.trim() || "n/a";
+        return [
+            "The previous run ended before completion.",
+            `Last summary: ${previousSummary}.`,
+            "Continue in the current thread and do not restart from scratch.",
+            `Missing required outputs (write these first): ${missingOutputs}.`,
+            `Tracked state paths: ${params.trackedPaths.join(", ")}.`,
+            "After generating missing outputs, perform required validation and provide the final response.",
+            "",
+            "Original task:",
+            params.prompt,
+        ].join("\n");
+    }
+}
+//# sourceMappingURL=runPromptBuilder.js.map

package/dist/runtime/execution/policies/runPromptBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPromptBuilder.js","sourceRoot":"","sources":["../../../../src/runtime/execution/policies/runPromptBuilder.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAgB;IACpB,MAAM,CAAC,oBAAoB,CAAC,MAAc;QAC/C,MAAM,UAAU,GAAG;YACjB,kBAAkB;YAClB,+EAA+E;YAC/E,iFAAiF;YACjF,gGAAgG;YAChG,0GAA0G;YAC1G,uFAAuF;YACvF,uEAAuE;YACvE,mHAAmH;YACnH,iHAAiH;SAClH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO,GAAG,MAAM,OAAO,UAAU,EAAE,CAAC;IACtC,CAAC;IAEM,MAAM,CAAC,0BAA0B,CAAC,MAKxC;QACC,MAAM,cAAc,GAAG,MAAM,CAAC,qBAAqB,CAAC,MAAM,GAAG,CAAC;YAC5D,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;YACzC,CAAC,CAAC,QAAQ,CAAC;QACb,MAAM,eAAe,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC;QAC5D,OAAO;YACL,2CAA2C;YAC3C,iBAAiB,eAAe,GAAG;YACnC,iEAAiE;YACjE,iDAAiD,cAAc,GAAG;YAClE,wBAAwB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACzD,+FAA+F;YAC/F,EAAE;YACF,gBAAgB;YAChB,MAAM,CAAC,MAAM;SACd,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF"}

package/dist/runtime/execution/policies/runSummaryFormatter.d.ts

@@ -0,0 +1,6 @@
+export declare class RunSummaryFormatter {
+    static formatRunStep(summary: string, elapsedMs: number): string;
+    static formatMergedRunStep(toolSummary: string, resultSummary: string, resultElapsedMs: number): string;
+    private static classifyRunSummary;
+}
+//# sourceMappingURL=runSummaryFormatter.d.ts.map

package/dist/runtime/execution/policies/runSummaryFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runSummaryFormatter.d.ts","sourceRoot":"","sources":["../../../../src/runtime/execution/policies/runSummaryFormatter.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAmB;WAChB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;WAKzD,mBAAmB,CAC/B,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,eAAe,EAAE,MAAM,GACtB,MAAM;IAMT,OAAO,CAAC,MAAM,CAAC,kBAAkB;CAwClC"}

package/dist/runtime/execution/policies/runSummaryFormatter.js

@@ -0,0 +1,47 @@
+export class RunSummaryFormatter {
+    static formatRunStep(summary, elapsedMs) {
+        const { indent, marker, text } = this.classifyRunSummary(summary);
+        return `${" ".repeat(indent)}${marker} ${text}  (${(elapsedMs / 1000).toFixed(1)}s)`;
+    }
+    static formatMergedRunStep(toolSummary, resultSummary, resultElapsedMs) {
+        const toolText = toolSummary.replace(/^Tool call:\s*/, "");
+        const { text } = this.classifyRunSummary(resultSummary);
+        return `- ${toolText} -> ${text}  (${(resultElapsedMs / 1000).toFixed(1)}s)`;
+    }
+    static classifyRunSummary(summary) {
+        if (summary.startsWith("Tool call:")) {
+            return {
+                indent: 2,
+                marker: "-",
+                text: summary.replace(/^Tool call:\s*/, ""),
+            };
+        }
+        if (summary.startsWith("Saved file") ||
+            summary.startsWith("Command ") ||
+            summary.startsWith("Checked workspace files") ||
+            summary.startsWith("Rate limited") ||
+            summary === "Command returned a usage error" ||
+            summary === "Loaded instructions" ||
+            summary === "Reviewed generated content" ||
+            summary === "Command completed") {
+            return {
+                indent: 6,
+                marker: ">",
+                text: summary,
+            };
+        }
+        if (summary === "Run completed") {
+            return {
+                indent: 0,
+                marker: "done",
+                text: summary,
+            };
+        }
+        return {
+            indent: 0,
+            marker: "*",
+            text: summary.replace(/^Message:\s*/, ""),
+        };
+    }
+}
+//# sourceMappingURL=runSummaryFormatter.js.map

package/dist/runtime/execution/policies/runSummaryFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runSummaryFormatter.js","sourceRoot":"","sources":["../../../../src/runtime/execution/policies/runSummaryFormatter.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAmB;IACvB,MAAM,CAAC,aAAa,CAAC,OAAe,EAAE,SAAiB;QAC5D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAClE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,IAAI,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IACvF,CAAC;IAEM,MAAM,CAAC,mBAAmB,CAC/B,WAAmB,EACnB,aAAqB,EACrB,eAAuB;QAEvB,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;QACxD,OAAO,KAAK,QAAQ,OAAO,IAAI,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,CAAC;IAEO,MAAM,CAAC,kBAAkB,CAAC,OAAe;QAC/C,IAAI,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACrC,OAAO;gBACL,MAAM,EAAE,CAAC;gBACT,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;aAC5C,CAAC;QACJ,CAAC;QAED,IACE,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC;YAChC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC;YAC9B,OAAO,CAAC,UAAU,CAAC,yBAAyB,CAAC;YAC7C,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC;YAClC,OAAO,KAAK,gCAAgC;YAC5C,OAAO,KAAK,qBAAqB;YACjC,OAAO,KAAK,4BAA4B;YACxC,OAAO,KAAK,mBAAmB,EAC/B,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,CAAC;gBACT,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,OAAO;aACd,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,KAAK,eAAe,EAAE,CAAC;YAChC,OAAO;gBACL,MAAM,EAAE,CAAC;gBACT,MAAM,EAAE,MAAM;gBACd,IAAI,EAAE,OAAO;aACd,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,CAAC;YACT,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC1C,CAAC;IACJ,CAAC;CACF"}

package/dist/runtime/execution/policies/runtimeDelay.d.ts

@@ -0,0 +1,4 @@
+export declare class RuntimeDelay {
+    static wait(ms: number): Promise<void>;
+}
+//# sourceMappingURL=runtimeDelay.d.ts.map

package/dist/runtime/execution/policies/runtimeDelay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeDelay.d.ts","sourceRoot":"","sources":["../../../../src/runtime/execution/policies/runtimeDelay.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAY;WACT,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG9C"}

package/dist/runtime/execution/policies/runtimeDelay.js

@@ -0,0 +1,6 @@
+export class RuntimeDelay {
+    static wait(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=runtimeDelay.js.map

package/dist/runtime/execution/policies/runtimeDelay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtimeDelay.js","sourceRoot":"","sources":["../../../../src/runtime/execution/policies/runtimeDelay.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAY;IAChB,MAAM,CAAC,IAAI,CAAC,EAAU;QAC3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/runtime/execution/policies/toolConfigReader.d.ts

@@ -0,0 +1,8 @@
+export declare class ToolConfigReader {
+    static readAllowedToolNames(toolConfigPath: string): string[] | undefined;
+    private static collectDeepagentsNames;
+    private static collectCustomizedNames;
+    private static addStringItems;
+    private static addObjectKeys;
+}
+//# sourceMappingURL=toolConfigReader.d.ts.map

package/dist/runtime/execution/policies/toolConfigReader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolConfigReader.d.ts","sourceRoot":"","sources":["../../../../src/runtime/execution/policies/toolConfigReader.ts"],"names":[],"mappings":"AAGA,qBAAa,gBAAgB;WACb,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IA6BhF,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA4BrC,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA0BrC,OAAO,CAAC,MAAM,CAAC,cAAc;IAQ7B,OAAO,CAAC,MAAM,CAAC,aAAa;CAW7B"}

package/dist/runtime/execution/policies/toolConfigReader.js

@@ -0,0 +1,91 @@
+import { existsSync, readFileSync } from "node:fs";
+import { parseYamlContent } from "@botbotgo/common/config";
+export class ToolConfigReader {
+    static readAllowedToolNames(toolConfigPath) {
+        if (!existsSync(toolConfigPath)) {
+            return undefined;
+        }
+        const raw = readFileSync(toolConfigPath, "utf8");
+        const parsed = parseYamlContent(raw, {
+            substituteEnv: false,
+        });
+        if (!parsed || typeof parsed !== "object") {
+            return undefined;
+        }
+        const source = parsed.spec && typeof parsed.spec === "object" && !Array.isArray(parsed.spec)
+            ? parsed.spec
+            : parsed;
+        const toolsNode = source.tools && typeof source.tools === "object" && !Array.isArray(source.tools)
+            ? source.tools
+            : undefined;
+        const deepagents = toolsNode?.deepagents;
+        const legacyDeepagents = source.deepagents && typeof source.deepagents === "object" && !Array.isArray(source.deepagents)
+            ? source.deepagents
+            : undefined;
+        const names = new Set();
+        this.collectDeepagentsNames(names, deepagents, legacyDeepagents, source);
+        this.collectCustomizedNames(names, toolsNode);
+        return names.size > 0 ? [...names] : undefined;
+    }
+    static collectDeepagentsNames(names, deepagents, legacyDeepagents, source) {
+        if (Array.isArray(deepagents)) {
+            this.addStringItems(names, deepagents);
+            return;
+        }
+        if (deepagents &&
+            typeof deepagents === "object" &&
+            !Array.isArray(deepagents) &&
+            Array.isArray(deepagents.tools)) {
+            this.addStringItems(names, deepagents.tools);
+            return;
+        }
+        if (Array.isArray(legacyDeepagents?.tools)) {
+            this.addStringItems(names, legacyDeepagents.tools);
+            return;
+        }
+        if (Array.isArray(source.allowedToolNames)) {
+            this.addStringItems(names, source.allowedToolNames);
+        }
+    }
+    static collectCustomizedNames(names, toolsNode) {
+        const customized = toolsNode?.customized;
+        if (customized && typeof customized === "object" && !Array.isArray(customized)) {
+            const source = customized;
+            const descriptorGrouped = Object.keys(source).some((key) => /^(npm|file):/.test(key));
+            if (descriptorGrouped) {
+                for (const sourceValue of Object.values(source)) {
+                    this.addObjectKeys(names, sourceValue);
+                }
+            }
+            else {
+                this.addObjectKeys(names, source);
+            }
+            return;
+        }
+        if (!toolsNode) {
+            return;
+        }
+        for (const sourceValue of Object.values(toolsNode)) {
+            this.addObjectKeys(names, sourceValue);
+        }
+    }
+    static addStringItems(names, items) {
+        for (const item of items) {
+            if (typeof item === "string" && item.trim().length > 0) {
+                names.add(item.trim());
+            }
+        }
+    }
+    static addObjectKeys(names, sourceValue) {
+        if (!sourceValue || typeof sourceValue !== "object" || Array.isArray(sourceValue)) {
+            return;
+        }
+        for (const toolName of Object.keys(sourceValue)) {
+            const trimmed = toolName.trim();
+            if (trimmed.length > 0) {
+                names.add(trimmed);
+            }
+        }
+    }
+}
+//# sourceMappingURL=toolConfigReader.js.map

package/dist/runtime/execution/policies/toolConfigReader.js.map

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

package/dist/runtime/human-loop/consoleHumanLoop.d.ts

@@ -0,0 +1,21 @@
+import type { HumanLoopDecision, HumanLoopRequest, HumanLoopService } from "./humanLoop.js";
+export interface ConsoleHumanLoopServiceOptions {
+    input?: NodeJS.ReadableStream;
+    output?: NodeJS.WritableStream;
+    prompt?: (question: string) => Promise<string>;
+    writer?: (line: string) => void;
+}
+export declare class ConsoleHumanLoopService implements HumanLoopService {
+    private readonly input;
+    private readonly output;
+    private readonly promptOverride?;
+    private readonly writer;
+    constructor(options?: ConsoleHumanLoopServiceOptions);
+    request(request: HumanLoopRequest): Promise<HumanLoopDecision>;
+    private printRequest;
+    private askAction;
+    private askRevisedArgs;
+    private askOptional;
+    private ask;
+}
+//# sourceMappingURL=consoleHumanLoop.d.ts.map

package/dist/runtime/human-loop/consoleHumanLoop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleHumanLoop.d.ts","sourceRoot":"","sources":["../../../src/runtime/human-loop/consoleHumanLoop.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE5F,MAAM,WAAW,8BAA8B;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC/B,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,qBAAa,uBAAwB,YAAW,gBAAgB;IAC9D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAA2C;IAC3E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAE7B,OAAO,GAAE,8BAAmC;IASlD,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0B3E,OAAO,CAAC,YAAY;YAaN,SAAS;YAUT,cAAc;YAkBd,WAAW;YAIX,GAAG;CAelB"}

package/dist/runtime/human-loop/consoleHumanLoop.js

@@ -0,0 +1,102 @@
+import * as readline from "node:readline/promises";
+import { stdin as defaultInput, stdout as defaultOutput } from "node:process";
+export class ConsoleHumanLoopService {
+    input;
+    output;
+    promptOverride;
+    writer;
+    constructor(options = {}) {
+        this.input = options.input ?? defaultInput;
+        this.output = options.output ?? defaultOutput;
+        this.promptOverride = options.prompt;
+        this.writer = options.writer ?? ((line) => {
+            this.output.write(`${line}\n`);
+        });
+    }
+    async request(request) {
+        this.printRequest(request);
+        const action = await this.askAction();
+        if (action === "approve") {
+            return { action, decidedAt: new Date().toISOString() };
+        }
+        if (action === "reject") {
+            const message = await this.askOptional("Rejection message (optional): ");
+            return {
+                action,
+                message: message || `Rejected in console for tool ${request.toolName}.`,
+                decidedAt: new Date().toISOString(),
+            };
+        }
+        const revisedArgs = await this.askRevisedArgs(request);
+        const message = await this.askOptional("Revision note (optional): ");
+        return {
+            action: "revise",
+            revisedArgs,
+            message: message || "Args revised in console.",
+            decidedAt: new Date().toISOString(),
+        };
+    }
+    printRequest(request) {
+        this.writer("");
+        this.writer(`[human-loop] ${request.title}`);
+        this.writer(`kind: ${request.kind}`);
+        this.writer(`tool: ${request.toolName}`);
+        if (request.threadId)
+            this.writer(`thread: ${request.threadId}`);
+        if (request.riskLevel)
+            this.writer(`risk: ${request.riskLevel}`);
+        this.writer(request.description);
+        this.writer("args:");
+        this.writer(JSON.stringify(request.args, null, 2));
+        this.writer("");
+    }
+    async askAction() {
+        while (true) {
+            const answer = (await this.ask("Approve, reject, or revise? [a/r/e]: ")).trim().toLowerCase();
+            if (answer === "a" || answer === "approve")
+                return "approve";
+            if (answer === "r" || answer === "reject")
+                return "reject";
+            if (answer === "e" || answer === "edit" || answer === "revise")
+                return "revise";
+            this.writer("Please enter a, r, or e.");
+        }
+    }
+    async askRevisedArgs(request) {
+        this.writer("Enter revised args as one-line JSON.");
+        this.writer(`Current args: ${JSON.stringify(request.args)}`);
+        while (true) {
+            const answer = (await this.ask("revised args JSON: ")).trim();
+            try {
+                const parsed = JSON.parse(answer);
+                if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+                    this.writer("Expected a JSON object.");
+                    continue;
+                }
+                return parsed;
+            }
+            catch {
+                this.writer("Invalid JSON. Try again.");
+            }
+        }
+    }
+    async askOptional(question) {
+        return (await this.ask(question)).trim();
+    }
+    async ask(question) {
+        if (this.promptOverride) {
+            return this.promptOverride(question);
+        }
+        const rl = readline.createInterface({
+            input: this.input,
+            output: this.output,
+        });
+        try {
+            return await rl.question(question);
+        }
+        finally {
+            rl.close();
+        }
+    }
+}
+//# sourceMappingURL=consoleHumanLoop.js.map

package/dist/runtime/human-loop/consoleHumanLoop.js.map

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