@vinhnt-sdk/step-executor 0.1.3

package/dist/step-executor.js

@@ -0,0 +1,314 @@
+import { RunAbortedError } from "@vinhnt-sdk/schema";
+import { detectDoomLoop, hashArgs, DOOM_LOOP_THRESHOLD, raceWithAbort, toolDomain, withToolTimeout } from "./kernel-utils.js";
+import { inferStepType } from "@vinhnt-sdk/schema";
+import { buildToolContext } from "./tool-context-builder.js";
+import { handleApproval as handleApprovalFn } from "./approval-handler.js";
+import { handleToolError as handleToolErrorFn } from "./tool-error-router.js";
+import { runSelfCorrection as runSelfCorrectionFn } from "./self-correction.js";
+import { redactObjectSecrets } from "@vinhnt-sdk/security";
+import { processToolResults } from "./tool-result-processor.js";
+import { checkExternalPaths } from "./path-policy.js";
+async function safeEmit(store, event) {
+    try {
+        await store.emitEvent(event);
+    }
+    catch (err) {
+        console.warn("[safeEmit] Failed to emit event:", err);
+    }
+}
+/**
+ * Executes tool calls within a run step — manages permissions, approval,
+ * plugin hooks, doom-loop detection, external-path checking, concurrent
+ * execution, self-correction, saga recording, and fallback strategies.
+ */
+export class StepExecutor {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Swap the saga reference for per-run saga scoping */
+    setSaga(saga) {
+        this.deps.saga = saga;
+    }
+    /** Swap the current agent reference for per-run agent scoping */
+    setCurrentAgent(agent) {
+        this.deps.currentAgent = agent;
+    }
+    /** Get the current agent reference (used by kernel to save prev before swap) */
+    getCurrentAgent() {
+        return this.deps.currentAgent;
+    }
+    /** Resolve the agent that owns the given run, falling back to the instance default. */
+    agentFor(runId) {
+        return this.deps.agentForRun ? this.deps.agentForRun(runId) : this.deps.currentAgent;
+    }
+    /** Resolve the saga that owns the given run, falling back to the instance default. */
+    sagaFor(runId) {
+        return this.deps.sagaForRun ? this.deps.sagaForRun(runId) : this.deps.saga;
+    }
+    async runConcurrent(tasks, concurrency) {
+        const results = new Array(tasks.length);
+        const running = [];
+        let idx = 0;
+        const exec = async (i) => {
+            const task = tasks[i];
+            if (!task)
+                return;
+            try {
+                results[i] = { status: "fulfilled", value: await task() };
+            }
+            catch (e) {
+                results[i] = { status: "rejected", reason: e };
+            }
+        };
+        const next = () => {
+            if (idx >= tasks.length)
+                return Promise.resolve();
+            const i = idx++;
+            const p = exec(i).then(next);
+            running.push(p);
+            if (running.length >= concurrency) {
+                return Promise.race(running).then(() => Promise.resolve());
+            }
+            return next();
+        };
+        await next();
+        await Promise.allSettled(running);
+        return results;
+    }
+    /**
+     * Execute a batch of tool calls for the current step.
+     * Handles permission gating, approval dialogs, plugin hooks, doom-loop
+     * detection, external-path checks, concurrent execution with configurable
+     * concurrency, self-correction on failure, and saga compensation recording.
+     */
+    async executeToolCalls(toolCalls, messages, step, runId, ctx, runAbort, sessionId, runModel) {
+        const selfCorrectTokens = { input: 0, output: 0 };
+        let toolCallCount = 0;
+        const recentCalls = [];
+        const toolResults = [];
+        const limit = this.deps.maxToolCallsPerStep;
+        for (let batchStart = 0; batchStart < toolCalls.length && !runAbort.signal.aborted && toolCallCount < limit; batchStart += limit) {
+            const batch = toolCalls.slice(batchStart, Math.min(batchStart + limit, toolCalls.length));
+            // Filter out doom-loop tools from the concurrent batch
+            const doomThreshold = this.deps.doomLoopThreshold ?? DOOM_LOOP_THRESHOLD;
+            const doomResult = [];
+            const batchIdentical = new Map();
+            const pendingEmits = [];
+            const execBatch = batch.filter((tc) => {
+                const argsKey = hashArgs(tc.args);
+                const key = `${tc.toolName}:${argsKey}`;
+                const prevCount = recentCalls.filter((r) => r.id === tc.toolName && (r.argsKey ?? hashArgs(r.args)) === argsKey).length;
+                const totalSoFar = prevCount + (batchIdentical.get(key) ?? 0);
+                if (totalSoFar >= doomThreshold) {
+                    doomResult.push({ tc, result: "doom" });
+                    pendingEmits.push(safeEmit(this.deps.store, {
+                        id: crypto.randomUUID(), runId, type: "tool.failed",
+                        occurredAt: new Date().toISOString(), traceId: ctx.traceId,
+                        data: { toolId: tc.toolId, toolName: tc.toolName, domain: toolDomain(tc.toolName), error: `Doom loop: "${tc.toolName}" called ${this.deps.doomLoopThreshold}x with identical args` },
+                    }));
+                    return false;
+                }
+                batchIdentical.set(key, (batchIdentical.get(key) ?? 0) + 1);
+                return true;
+            });
+            const tasks = execBatch.map((tc) => async () => {
+                if (detectDoomLoop(recentCalls, tc.toolName, tc.args, doomThreshold)) {
+                    await safeEmit(this.deps.store, {
+                        id: crypto.randomUUID(), runId, type: "tool.failed",
+                        occurredAt: new Date().toISOString(), traceId: ctx.traceId,
+                        data: { toolId: tc.toolId, toolName: tc.toolName, domain: toolDomain(tc.toolName), error: `Doom loop: "${tc.toolName}" called ${doomThreshold}x with identical args` },
+                    });
+                    return { tc, result: "doom" };
+                }
+                if (this.deps.externalDirectoryAccess !== true && this.deps.workspaceRoot) {
+                    const externalPath = checkExternalPaths(tc.toolName, tc.args, this.deps.workspaceRoot);
+                    if (externalPath) {
+                        await safeEmit(this.deps.store, {
+                            id: crypto.randomUUID(), runId, type: "tool.failed",
+                            occurredAt: new Date().toISOString(), traceId: ctx.traceId,
+                            data: { toolId: tc.toolId, toolName: tc.toolName, domain: toolDomain(tc.toolName), error: `External directory: ${externalPath}` },
+                        });
+                        return { tc, result: "external", reason: `External directory: ${externalPath}` };
+                    }
+                }
+                const tool = this.deps.findTool(tc.toolName, runId);
+                if (!tool) {
+                    const registered = this.deps.hasTool(tc.toolName);
+                    await safeEmit(this.deps.store, {
+                        id: crypto.randomUUID(), runId, type: "tool.failed",
+                        occurredAt: new Date().toISOString(), traceId: ctx.traceId,
+                        data: {
+                            toolId: tc.toolId, toolName: tc.toolName,
+                            domain: toolDomain(tc.toolName),
+                            ...(registered ? { decision: "deny" } : {}),
+                            error: registered
+                                ? `Tool "${tc.toolName}" not found (denied by policy)`
+                                : `Tool "${tc.toolName}" not found`,
+                        },
+                    });
+                    return { tc, result: "not-found" };
+                }
+                // P1-F: onBeforeToolExecution fired below — right before tool.execute.
+                const permResult = this.deps.permissionGate.checkTool(tc.toolName, tool.risk, tc.args, this.agentFor(runId));
+                if (!permResult.allowed && !permResult.needsApproval) {
+                    await safeEmit(this.deps.store, {
+                        id: crypto.randomUUID(), runId, type: "tool.failed",
+                        occurredAt: new Date().toISOString(), traceId: ctx.traceId,
+                        data: { toolId: tc.toolId, toolName: tc.toolName, domain: toolDomain(tc.toolName), decision: "deny", error: permResult.reason },
+                    });
+                    return { tc, result: "denied", reason: permResult.reason };
+                }
+                const compensationRef = { current: null };
+                const metadataRef = {};
+                const toolCtx = await this.buildToolContext(tc, runId, sessionId, ctx, runAbort, tool, compensationRef, metadataRef);
+                const approved = await this.handleApproval(permResult, tc, toolCtx, runId, ctx, sessionId, messages, tool.selfApproving);
+                if (!approved)
+                    return { tc, result: "rejected" };
+                await safeEmit(this.deps.store, {
+                    id: crypto.randomUUID(), runId, type: "step.type_changed",
+                    occurredAt: new Date().toISOString(), traceId: ctx.traceId,
+                    data: { stepType: inferStepType(tc.toolName), stepNumber: step, toolName: tc.toolName },
+                });
+                await safeEmit(this.deps.store, {
+                    id: crypto.randomUUID(), runId, type: "tool.invoked",
+                    occurredAt: new Date().toISOString(), traceId: ctx.traceId,
+                    data: { toolId: tc.toolId, toolName: tc.toolName, domain: toolDomain(tc.toolName), decision: "allow", input: tc.args },
+                });
+                const invHookResult = await this.deps.pluginManager?.fireHook("onToolInvoked", {
+                    toolId: tc.toolId, toolName: tc.toolName, input: tc.args,
+                });
+                const effectiveInput = invHookResult?.modified?.input ?? tc.args;
+                // P1-F: onBeforeToolExecution — intercept/modify input right before execution.
+                const beforeExecResult = await this.deps.pluginManager?.fireHook("onBeforeToolExecution", {
+                    toolId: tc.toolId, toolName: tc.toolName, input: effectiveInput,
+                });
+                const execInput = beforeExecResult?.modified?.input ?? effectiveInput;
+                // Re-validate permission if the execution hook modified the input further.
+                if (execInput !== effectiveInput) {
+                    const rePerm = this.deps.permissionGate.checkTool(tc.toolName, tool.risk, execInput, this.agentFor(runId));
+                    if (!rePerm.allowed && !rePerm.needsApproval) {
+                        await safeEmit(this.deps.store, {
+                            id: crypto.randomUUID(), runId, type: "tool.failed",
+                            occurredAt: new Date().toISOString(), traceId: ctx.traceId,
+                            data: { toolId: tc.toolId, toolName: tc.toolName, domain: toolDomain(tc.toolName), decision: "deny", error: `Plugin-modified input rejected: ${rePerm.reason}` },
+                        });
+                        return { tc, result: "denied", reason: rePerm.reason };
+                    }
+                }
+                const toolTimeout = tool.timeoutMs;
+                // RV-19: cooperative timeout — the tool's context signal is replaced
+                // with a local controller aborted at the deadline so the tool can stop
+                // its side effects, while the promise still hard-caps at the deadline.
+                const execPromise = toolTimeout
+                    ? withToolTimeout((signal) => tool.execute(execInput, { ...toolCtx, signal }), toolTimeout, runAbort.signal, `Tool "${tc.toolName}" timed out after ${toolTimeout}ms`)
+                    : tool.execute(execInput, toolCtx);
+                try {
+                    const output = await raceWithAbort(execPromise, runAbort.signal, runId);
+                    // P1-F: onAfterToolExecution — intercept/modify the raw tool output.
+                    const afterExecResult = await this.deps.pluginManager?.fireHook("onAfterToolExecution", {
+                        toolId: tc.toolId, toolName: tc.toolName, output,
+                    });
+                    const execOutput = afterExecResult?.modified?.output ?? output;
+                    const compHookResult = await this.deps.pluginManager?.fireHook("onToolCompleted", {
+                        toolId: tc.toolId, toolName: tc.toolName, output: execOutput,
+                    });
+                    const effectiveOutput = compHookResult?.modified?.output ?? execOutput;
+                    this.sagaFor(runId).record({
+                        toolId: tc.toolId, toolName: tc.toolName,
+                        input: effectiveInput, output: effectiveOutput,
+                        timestamp: Date.now(), step,
+                    });
+                    if (compensationRef.current) {
+                        this.sagaFor(runId).registerCompensation(tc.toolId, {
+                            entry: { toolId: tc.toolId, toolName: tc.toolName, input: effectiveInput, output: effectiveOutput, timestamp: Date.now(), step },
+                            compensate: compensationRef.current,
+                        });
+                    }
+                    await safeEmit(this.deps.store, {
+                        id: crypto.randomUUID(), runId, type: "tool.completed",
+                        occurredAt: new Date().toISOString(), traceId: ctx.traceId,
+                        data: {
+                            toolId: tc.toolId, toolName: tc.toolName, domain: toolDomain(tc.toolName),
+                            output: effectiveOutput,
+                            ...(metadataRef.current ? { metadata: metadataRef.current } : {}),
+                        },
+                    });
+                    return { tc, result: "success", output: effectiveOutput };
+                }
+                catch (err) {
+                    if (!(err instanceof RunAbortedError)) {
+                        // P1-N: never log raw tool args — they may contain apiKeys/secrets.
+                        console.error("[step-executor] Tool execution error", { toolId: tc.toolId, toolName: tc.toolName, error: err instanceof Error ? err.message : String(err), input: redactObjectSecrets(tc.args) });
+                    }
+                    await handleToolErrorFn(err, tc, tool, messages, step, runId, ctx, runAbort, toolCtx, sessionId, recentCalls, runModel, {
+                        store: this.deps.store,
+                        addSessionMessage: this.deps.addSessionMessage,
+                        pluginManager: this.deps.pluginManager,
+                        permissionGate: this.deps.permissionGate,
+                        selfCorrectOnFailure: this.deps.selfCorrectOnFailure,
+                        ...(this.deps.externalDirectoryAccess !== undefined ? { externalDirectoryAccess: this.deps.externalDirectoryAccess } : {}),
+                        ...(this.deps.workspaceRoot !== undefined ? { workspaceRoot: this.deps.workspaceRoot } : {}),
+                        findTool: this.deps.findTool,
+                        currentAgent: this.agentFor(runId),
+                        runSelfCorrection: (tc, messages, recentCalls, step, runId, ctx, runAbort, toolCtx, errorMsg, runModel) => this.runSelfCorrection(tc, messages, recentCalls, step, runId, ctx, runAbort, toolCtx, errorMsg, runModel, selfCorrectTokens),
+                    });
+                    await this.sagaFor(runId).rollbackStep(step);
+                    return { tc, result: "failed" };
+                }
+            });
+            await Promise.all(pendingEmits);
+            const concurrency = this.deps.maxConcurrentToolCalls ?? 5;
+            const results = await this.runConcurrent(tasks, concurrency);
+            if (runAbort.signal.aborted)
+                break;
+            // Process pre-identified doom loops after batch execution
+            if (doomResult.length > 0) {
+                const doom = doomResult[0];
+                const errorMsg = `Tool "${doom.tc.toolName}" called with identical arguments ${doomThreshold} consecutive times. Aborting to prevent infinite loop.`;
+                messages.push({ role: "tool", toolCallId: doom.tc.toolId, content: `Error: ${errorMsg}` });
+                break;
+            }
+            const processed = await processToolResults(results, doomThreshold, messages, sessionId, { model: runModel.model }, toolCallCount, recentCalls, toolResults, {
+                addSessionMessage: this.deps.addSessionMessage,
+            });
+            toolCallCount = processed.toolCallCount;
+            recentCalls.length = 0;
+            recentCalls.push(...processed.recentCalls);
+            toolResults.length = 0;
+            toolResults.push(...processed.toolResults);
+            if (processed.breakBatch)
+                break;
+        }
+        return { toolCallCount, recentCalls, selfCorrectTokens, toolResults };
+    }
+    async buildToolContext(tc, runId, sessionId, ctx, runAbort, tool, compensationRef, metadataRef) {
+        return buildToolContext(tc, runId, sessionId, ctx, runAbort, compensationRef, metadataRef, {
+            pluginManager: this.deps.pluginManager,
+            permissionGate: this.deps.permissionGate,
+            currentAgent: this.agentFor(runId),
+            toolRisk: tool.risk,
+        });
+    }
+    async handleApproval(permResult, tc, toolCtx, runId, ctx, _sessionId, messages, selfApproving) {
+        return handleApprovalFn(permResult, tc, toolCtx, runId, ctx, _sessionId, messages, {
+            store: this.deps.store,
+            permissionGate: this.deps.permissionGate,
+            pluginManager: this.deps.pluginManager,
+            currentAgent: this.agentFor(runId),
+        }, selfApproving);
+    }
+    async runSelfCorrection(tc, messages, recentCalls, step, runId, ctx, runAbort, toolCtx, errorMsg, runModel, selfCorrectTokens) {
+        return runSelfCorrectionFn(tc, messages, recentCalls, step, runId, ctx, runAbort, toolCtx, errorMsg, runModel, {
+            store: this.deps.store,
+            modelCaller: this.deps.modelCaller,
+            maxSelfCorrectAttempts: this.deps.maxSelfCorrectAttempts,
+            doomLoopThreshold: this.deps.doomLoopThreshold,
+            findTool: this.deps.findTool,
+            permissionGate: this.deps.permissionGate,
+            pluginManager: this.deps.pluginManager,
+            currentAgent: this.agentFor(runId),
+        }, selfCorrectTokens);
+    }
+}
+//# sourceMappingURL=step-executor.js.map

package/dist/step-executor.js.map

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

package/dist/termination.d.ts

@@ -0,0 +1,87 @@
+import type { RunId } from "@vinhnt-sdk/schema";
+/**
+ * ── Termination policy (Phase 4) ─────────────────────────────────────────
+ * A declarative, per-run exit strategy layered on top of the plain loop:
+ * hard step cap, token budget, and stop conditions / hooks that are verified
+ * after each step. The loop stays the unit of execution; the policy decides
+ * when it may stop early (success) or must be cut (budget exhausted).
+ */
+/** Result of one tool invocation, used by stop-condition evaluation. */
+export interface ToolCallOutcome {
+    readonly toolName: string;
+    readonly output?: string;
+    readonly exitCode?: number;
+}
+/** Read-only snapshot the loop exposes to stop conditions / hooks each step. */
+export interface StepVerificationContext {
+    readonly runId: RunId;
+    readonly step: number;
+    readonly finalOutput: string;
+    readonly totalInputTokens: number;
+    readonly totalOutputTokens: number;
+    readonly lastStepToolOutcomes: readonly ToolCallOutcome[];
+}
+/** Declarative condition that can end the loop early. */
+export type StopCondition = {
+    kind: "tool-output";
+    tool: string;
+    expect: {
+        exitCode?: number;
+    };
+} | {
+    kind: "file-unchanged";
+    path: string;
+} | {
+    kind: "screenshot";
+} | {
+    kind: "llm-judge";
+    agent: string;
+    criteria: readonly string[];
+} | {
+    kind: "state";
+    predicate: (ctx: StepVerificationContext) => boolean;
+};
+/** Hard limits and stop conditions that terminate a run. */
+export interface TerminationPolicy {
+    /** Per-run hard step cap (overrides the kernel default when set). */
+    readonly maxSteps?: number;
+    /** Token budget — the loop is cut when any limit is exceeded. */
+    readonly budgetTokens?: {
+        readonly input?: number;
+        readonly output?: number;
+        readonly total?: number;
+    };
+    /** Declarative conditions checked after each step (e.g. stop-when-build-green). */
+    readonly stopConditions?: readonly StopCondition[];
+    /** Deterministic async hooks — return "stop" to end the run early as success. */
+    readonly stopHooks?: readonly {
+        onStepEnded(ctx: StepVerificationContext): Promise<"continue" | "stop">;
+    }[];
+    /** Evaluator-optimizer: id of the judge agent used for `llm-judge` conditions. */
+    readonly evaluatorAgent?: string;
+}
+/** Normalize an arbitrary tool result into an outcome (exitCode from structured output). */
+export declare function toToolCallOutcome(toolName: string, output: unknown): ToolCallOutcome;
+/**
+ * Evaluate declarative stop conditions against a step context. Returns the
+ * first matching condition, or undefined to continue. Kinds that need external
+ * infrastructure (file-unchanged, screenshot, llm-judge) return undefined here;
+ * wire them through `stopHooks` / an evaluator agent instead.
+ */
+export declare function evaluateStopConditions(conditions: readonly StopCondition[], ctx: StepVerificationContext): StopCondition | undefined;
+/**
+ * Build the judge prompt for an `llm-judge` stop condition. The evaluator is
+ * asked to return a single verdict, not a long essay — cheap enough to run
+ * every step.
+ */
+export declare function buildJudgeMessages(condition: Extract<StopCondition, {
+    kind: "llm-judge";
+}>, ctx: StepVerificationContext, evaluatorAgent?: string): {
+    role: "system" | "user";
+    content: string;
+}[];
+/** Parse a judge verdict (`{"met": true|false}`) tolerantly. */
+export declare function parseJudgeVerdict(content: string): {
+    met: boolean;
+};
+//# sourceMappingURL=termination.d.ts.map

package/dist/termination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"termination.d.ts","sourceRoot":"","sources":["../src/termination.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD;;;;;;GAMG;AAEH,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,gFAAgF;AAChF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,SAAS,eAAe,EAAE,CAAC;CAC3D;AAED,yDAAyD;AACzD,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACpE;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACjE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,OAAO,CAAA;CAAE,CAAC;AAE5E,4DAA4D;AAC5D,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvG,mFAAmF;IACnF,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACnD,iFAAiF;IACjF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS;QAAE,WAAW,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC,CAAA;KAAE,EAAE,CAAC;IAC5G,kFAAkF;IAClF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,eAAe,CAapF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,SAAS,aAAa,EAAE,EACpC,GAAG,EAAE,uBAAuB,GAC3B,aAAa,GAAG,SAAS,CAK3B;AAqBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,OAAO,CAAC,aAAa,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,EACxD,GAAG,EAAE,uBAAuB,EAC5B,cAAc,CAAC,EAAE,MAAM,GACtB;IAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CA0BhD;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,OAAO,CAAA;CAAE,CAInE"}

package/dist/termination.js

@@ -0,0 +1,89 @@
+/** Normalize an arbitrary tool result into an outcome (exitCode from structured output). */
+export function toToolCallOutcome(toolName, output) {
+    if (typeof output === "string")
+        return { toolName, output };
+    if (output && typeof output === "object") {
+        const structured = output;
+        const text = typeof structured.output === "string" ? structured.output : undefined;
+        const code = typeof structured.exitCode === "number" ? structured.exitCode : undefined;
+        return {
+            toolName,
+            ...(text !== undefined ? { output: text } : {}),
+            ...(code !== undefined ? { exitCode: code } : {}),
+        };
+    }
+    return { toolName };
+}
+/**
+ * Evaluate declarative stop conditions against a step context. Returns the
+ * first matching condition, or undefined to continue. Kinds that need external
+ * infrastructure (file-unchanged, screenshot, llm-judge) return undefined here;
+ * wire them through `stopHooks` / an evaluator agent instead.
+ */
+export function evaluateStopConditions(conditions, ctx) {
+    for (const condition of conditions) {
+        if (matchesCondition(condition, ctx))
+            return condition;
+    }
+    return undefined;
+}
+function matchesCondition(condition, ctx) {
+    switch (condition.kind) {
+        case "tool-output": {
+            const outcome = ctx.lastStepToolOutcomes.find((o) => o.toolName === condition.tool);
+            if (!outcome)
+                return false;
+            if (condition.expect?.exitCode !== undefined)
+                return outcome.exitCode === condition.expect.exitCode;
+            return outcome.output !== undefined;
+        }
+        case "state":
+            return condition.predicate(ctx);
+        case "file-unchanged":
+        case "screenshot":
+        case "llm-judge":
+            return false;
+        default:
+            return false;
+    }
+}
+/**
+ * Build the judge prompt for an `llm-judge` stop condition. The evaluator is
+ * asked to return a single verdict, not a long essay — cheap enough to run
+ * every step.
+ */
+export function buildJudgeMessages(condition, ctx, evaluatorAgent) {
+    const persona = evaluatorAgent ? ` (agent "${evaluatorAgent}")` : "";
+    const toolLog = ctx.lastStepToolOutcomes.length > 0
+        ? ctx.lastStepToolOutcomes
+            .map((o) => `- ${o.toolName}${o.exitCode !== undefined ? ` (exit ${o.exitCode})` : ""}${o.output ? `: ${String(o.output).slice(0, 300)}` : ""}`)
+            .join("\n")
+        : "(no tool output this step)";
+    return [
+        {
+            role: "system",
+            content: `You are an evaluator judge${persona}. Given the criteria and the evidence, decide whether the task is complete. Respond with ONLY a valid JSON object of the form {"met": true} or {"met": false}. No prose.`,
+        },
+        {
+            role: "user",
+            content: [
+                `Criteria (ALL must be met):`,
+                condition.criteria.map((c) => `- ${c}`).join("\n"),
+                "",
+                "Evidence:",
+                `Final output: ${ctx.finalOutput || "(none yet)"}`,
+                `Tool outputs this step:\n${toolLog}`,
+                "",
+                "Are all criteria met? Reply JSON only.",
+            ].join("\n"),
+        },
+    ];
+}
+/** Parse a judge verdict (`{"met": true|false}`) tolerantly. */
+export function parseJudgeVerdict(content) {
+    const match = content.match(/"met"\s*:\s*(true|false)/i);
+    if (match)
+        return { met: match[1].toLowerCase() === "true" };
+    return { met: false };
+}
+//# sourceMappingURL=termination.js.map

package/dist/termination.js.map

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

package/dist/tool-context-builder.d.ts

@@ -0,0 +1,22 @@
+import type { RunId, RequestContext } from "@vinhnt-sdk/schema";
+import type { ToolContext, ToolRisk } from "@vinhnt-sdk/tools";
+import type { StepExecutorPluginHooks } from "./hooks.js";
+import type { PermissionGate } from "./permission-gate.js";
+import type { ToolExecutionPlan } from "./step-executor.js";
+import type { AgentConfig } from "@vinhnt-sdk/schema";
+/** Dependencies required by {@link buildToolContext}. */
+export interface ToolContextBuilderDeps {
+    readonly pluginManager: StepExecutorPluginHooks | undefined;
+    readonly permissionGate: PermissionGate;
+    readonly currentAgent: AgentConfig | undefined;
+    /** Tool risk used to evaluate the tool's own `ctx.ask` against the gate. */
+    readonly toolRisk: ToolRisk;
+}
+/** Mutable ref through which tools attach observability metadata. */
+export interface MetadataRef {
+    current?: Record<string, unknown> | undefined;
+}
+export declare function buildToolContext(tc: ToolExecutionPlan, runId: RunId, sessionId: string | undefined, ctx: RequestContext, runAbort: AbortController, compensationRef: {
+    current: (() => Promise<void>) | null;
+}, metadataRef: MetadataRef, deps: ToolContextBuilderDeps): Promise<ToolContext>;
+//# sourceMappingURL=tool-context-builder.d.ts.map

package/dist/tool-context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-context-builder.d.ts","sourceRoot":"","sources":["../src/tool-context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,yDAAyD;AACzD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAC5D,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/C,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAC/C;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,eAAe,EACzB,eAAe,EAAE;IAAE,OAAO,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAA;CAAE,EAC1D,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,WAAW,CAAC,CA2CtB"}

package/dist/tool-context-builder.js

@@ -0,0 +1,42 @@
+import { sanitizeEnv } from "@vinhnt-sdk/security";
+export async function buildToolContext(tc, runId, sessionId, ctx, runAbort, compensationRef, metadataRef, deps) {
+    // P1-G: default env is the sanitized whitelist, never raw process.env.
+    let shellEnv = sanitizeEnv();
+    const shellEnvResult = await deps.pluginManager?.fireHook("onShellEnv", { env: {} });
+    if (shellEnvResult?.modified?.env) {
+        shellEnv = { ...shellEnv, ...shellEnvResult.modified.env };
+    }
+    metadataRef.current = undefined;
+    return {
+        sessionId: sessionId ?? "",
+        runId,
+        agentId: deps.currentAgent?.id ?? "",
+        agentName: deps.currentAgent?.profile.name ?? "",
+        signal: runAbort.signal,
+        env: shellEnv,
+        parentContext: ctx,
+        // P1-H: single approval path — gate decide first (saved patterns / rules),
+        // then prompt via the approval store passing savePatterns for "always".
+        ask: async (askInput) => {
+            const decision = deps.permissionGate.checkTool(tc.toolName, deps.toolRisk, tc.args, deps.currentAgent);
+            if (decision.allowed)
+                return "once";
+            // Deny rules must always win over any previously saved approval — a
+            // per-tool approval must not resurrect a tool that is now deny-listed.
+            if (!decision.needsApproval)
+                return "reject";
+            if (deps.permissionGate.checkSavedApproval(tc.toolName, tc.args, deps.currentAgent?.id))
+                return "once";
+            return deps.permissionGate.askForTool(tc.toolName, tc.toolId, runId, sessionId ?? "", askInput.reason, deps.currentAgent?.id ?? "", ctx.traceId, deps.pluginManager, askInput.savePatterns, runAbort.signal);
+        },
+        metadata: (input) => {
+            metadataRef.current = {
+                ...metadataRef.current,
+                ...(input.metadata ?? {}),
+                ...(input.title ? { title: input.title } : {}),
+            };
+        },
+        setCompensation: (action) => { compensationRef.current = action; },
+    };
+}
+//# sourceMappingURL=tool-context-builder.js.map

package/dist/tool-context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-context-builder.js","sourceRoot":"","sources":["../src/tool-context-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAqBnD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAqB,EACrB,KAAY,EACZ,SAA6B,EAC7B,GAAmB,EACnB,QAAyB,EACzB,eAA0D,EAC1D,WAAwB,EACxB,IAA4B;IAE5B,uEAAuE;IACvE,IAAI,QAAQ,GAA2B,WAAW,EAAE,CAAC;IACrD,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;IACrF,IAAI,cAAc,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAClC,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;IAC7D,CAAC;IACD,WAAW,CAAC,OAAO,GAAG,SAAS,CAAC;IAChC,OAAO;QACL,SAAS,EAAE,SAAS,IAAI,EAAE;QAC1B,KAAK;QACL,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE;QACpC,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QAChD,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,EAAE,QAAQ;QACb,aAAa,EAAE,GAAG;QAClB,2EAA2E;QAC3E,wEAAwE;QACxE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,SAAS,CAC5C,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,IAA+B,EAAE,IAAI,CAAC,YAAY,CAClF,CAAC;YACF,IAAI,QAAQ,CAAC,OAAO;gBAAE,OAAO,MAAM,CAAC;YACpC,oEAAoE;YACpE,uEAAuE;YACvE,IAAI,CAAC,QAAQ,CAAC,aAAa;gBAAE,OAAO,QAAQ,CAAC;YAC7C,IAAI,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,IAA+B,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;gBAAE,OAAO,MAAM,CAAC;YAClI,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CACnC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,IAAI,EAAE,EAC9C,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,EAC5C,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAC/B,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CACvC,CAAC;QACJ,CAAC;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,WAAW,CAAC,OAAO,GAAG;gBACpB,GAAG,WAAW,CAAC,OAAO;gBACtB,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;gBACzB,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/C,CAAC;QACJ,CAAC;QACD,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,eAAe,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;KACnE,CAAC;AACJ,CAAC"}

package/dist/tool-error-router.d.ts

@@ -0,0 +1,26 @@
+import type { RunId, RequestContext } from "@vinhnt-sdk/schema";
+import type { ChatMessage } from "@vinhnt-sdk/schema";
+import type { ToolContext, ToolDefinition } from "@vinhnt-sdk/tools";
+import type { StepExecutorPluginHooks } from "./hooks.js";
+import type { PermissionGate } from "./permission-gate.js";
+import type { RecentCall } from "./kernel-utils.js";
+import type { ToolExecutionPlan } from "./step-executor.js";
+import type { ModelProvider } from "@vinhnt-sdk/schema";
+/** Dependencies required by {@link handleToolError}. */
+export interface ToolErrorRouterDeps {
+    readonly store: {
+        emitEvent(event: Omit<import("@vinhnt-sdk/schema").KnownRunEvent, "sequence">, persist?: boolean): Promise<void>;
+    };
+    readonly addSessionMessage: (sessionId: string | undefined, role: string, content: string, extra?: Record<string, unknown>) => Promise<void>;
+    readonly pluginManager: StepExecutorPluginHooks | undefined;
+    readonly permissionGate: PermissionGate;
+    readonly selfCorrectOnFailure: boolean;
+    readonly externalDirectoryAccess?: boolean;
+    readonly workspaceRoot?: string;
+    readonly findTool: (name: string, runId?: RunId) => ToolDefinition | undefined;
+    currentAgent: import("@vinhnt-sdk/schema").AgentConfig | undefined;
+    runSelfCorrection: (tc: ToolExecutionPlan, messages: ChatMessage[], recentCalls: RecentCall[], step: number, runId: RunId, ctx: RequestContext, runAbort: AbortController, toolCtx: ToolContext, errorMsg: string, runModel: ModelProvider) => Promise<void>;
+}
+export declare function handleToolError(err: unknown, tc: ToolExecutionPlan, _tool: ToolDefinition, messages: ChatMessage[], step: number, runId: RunId, ctx: RequestContext, runAbort: AbortController, toolCtx: ToolContext, sessionId: string | undefined, recentCalls: RecentCall[], runModel: ModelProvider, deps: ToolErrorRouterDeps): Promise<void>;
+export declare function tryReadFileFallback(tc: ToolExecutionPlan, runAbort: AbortController, runId: RunId, ctx: RequestContext, sessionId: string | undefined, messages: ChatMessage[], errorMsg: string, runModel: ModelProvider, deps: ToolErrorRouterDeps): Promise<boolean>;
+//# sourceMappingURL=tool-error-router.d.ts.map