@vinhnt-sdk/core 0.1.0

package/dist/kernel/sub-agent-runner.js

@@ -0,0 +1,128 @@
+import { createSubAgent } from "../agent/agent-factory.js";
+export async function runAgent(deps, agentId, prompt, ctx, sessionId) {
+    if (deps.currentDepthRef.value >= deps.maxSubAgentDepth) {
+        throw new Error(`Sub-agent depth limit (${deps.maxSubAgentDepth}) reached. Cannot spawn more sub-agents.`);
+    }
+    if (deps.agentChainRef.value.has(agentId)) {
+        throw new Error(`Cycle detected: agent '${agentId}' is already in the call chain.`);
+    }
+    const prevAgent = deps.currentAgentRef.value;
+    const prevDepth = deps.currentDepthRef.value;
+    const prevSnapshot = deps.sessionStateRef.value ? deps.sessionStateRef.value.snapshot() : undefined;
+    try {
+        const agent = await deps.agentRegistry.get(agentId);
+        if (!agent)
+            throw new Error(`Agent '${agentId}' not found`);
+        deps.currentAgentRef.value = agent;
+        deps.currentDepthRef.value++;
+        deps.agentChainRef.value.add(agentId);
+        if (deps.sessionStateRef.value) {
+            deps.sessionStateRef.value.resetMessages([]);
+            deps.sessionStateRef.value.step = 0;
+            deps.sessionStateRef.value.toolCallCount = 0;
+            deps.sessionStateRef.value.isRunning = true;
+        }
+        const parentRunId = deps.stateMachine.runIdStack.at(-1);
+        const childCtx = parentRunId
+            ? { ...ctx, parentRunId }
+            : ctx;
+        const handle = deps.runFn(prompt, childCtx, sessionId, undefined);
+        await handle.completed;
+        const output = await getRunOutput(deps.store, handle.runId);
+        return output;
+    }
+    finally {
+        deps.currentAgentRef.value = prevAgent;
+        deps.currentDepthRef.value = prevDepth;
+        deps.agentChainRef.value.delete(agentId);
+        if (deps.sessionStateRef.value && prevSnapshot) {
+            deps.sessionStateRef.value.restore(prevSnapshot);
+        }
+    }
+}
+export async function runAgentsParallel(deps, tasks, ctx, sessionId) {
+    if (deps.currentDepthRef.value >= deps.maxSubAgentDepth) {
+        throw new Error(`Sub-agent depth limit (${deps.maxSubAgentDepth}) reached.`);
+    }
+    const agents = await Promise.all(tasks.map((t) => deps.agentRegistry.get(t.agentId)));
+    for (let i = 0; i < agents.length; i++) {
+        if (!agents[i])
+            throw new Error(`Agent '${tasks[i].agentId}' not found`);
+    }
+    const prevDepth = deps.currentDepthRef.value;
+    deps.currentDepthRef.value++;
+    const parentRunId = deps.stateMachine.runIdStack.at(-1);
+    const childCtx = parentRunId
+        ? { ...ctx, parentRunId }
+        : ctx;
+    try {
+        const results = await Promise.allSettled(tasks.map(async (t, i) => {
+            const agent = agents[i];
+            const childSession = deps.sessionStateRef.value ? deps.sessionStateRef.value.fork() : undefined;
+            if (childSession) {
+                childSession.resetMessages([]);
+                childSession.step = 0;
+                childSession.toolCallCount = 0;
+                childSession.isRunning = true;
+            }
+            const childCtxForAgent = {
+                ...childCtx,
+                requestId: crypto.randomUUID(),
+            };
+            // Snapshot parent refs for per-task isolation
+            const prevSession = deps.sessionStateRef.value;
+            const prevAgent = deps.currentAgentRef.value;
+            deps.sessionStateRef.value = childSession;
+            deps.currentAgentRef.value = agent;
+            try {
+                const handle = deps.runFn(t.prompt, childCtxForAgent, sessionId, agent);
+                await handle.completed;
+                const output = await getRunOutput(deps.store, handle.runId);
+                return output;
+            }
+            finally {
+                deps.sessionStateRef.value = prevSession;
+                deps.currentAgentRef.value = prevAgent;
+            }
+        }));
+        const outputs = results.map((r) => {
+            if (r.status === "fulfilled")
+                return `[OK] ${r.value}`;
+            return `[ERROR] ${r.reason instanceof Error ? r.reason.message : String(r.reason)}`;
+        });
+        return outputs.join("\n---\n");
+    }
+    finally {
+        deps.currentDepthRef.value = prevDepth;
+    }
+}
+export function createSubAgentAndRegister(deps, params) {
+    if (!deps.currentAgentRef.value)
+        throw new Error("No current agent selected — call useAgent() first");
+    const agent = createSubAgent(params, deps.currentAgentRef.value);
+    return deps.agentRegistry.register(agent, deps.currentAgentRef.value.id).then(() => agent);
+}
+/** Load completed output efficiently using snapshots. Avoids O(n) event replay. */
+export async function getRunOutput(store, runId) {
+    const snap = await store.getSnapshot(runId);
+    if (snap?.state?.finalOutput !== undefined && snap.state.finalOutput !== "") {
+        return String(snap.state.finalOutput);
+    }
+    const events = await store.list(runId);
+    const completed = events.find((e) => e.type === "run.completed");
+    return completed?.data.output ?? "";
+}
+/** Load completed event data using snapshot-optimized loading. */
+export async function getCompletedEventData(store, runId) {
+    const snap = await store.getSnapshot(runId);
+    const afterSeq = snap?.sequence ?? 0;
+    const events = await store.list(runId, afterSeq);
+    const completed = events.find((e) => e.type === "run.completed");
+    if (completed?.data)
+        return completed.data;
+    if (snap?.state?.finalOutput !== undefined) {
+        return { output: String(snap.state.finalOutput), status: "completed" };
+    }
+    return null;
+}
+//# sourceMappingURL=sub-agent-runner.js.map

package/dist/kernel/sub-agent-runner.js.map

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

package/dist/kernel/termination.d.ts

@@ -0,0 +1,85 @@
+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[];
+}
+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;
+};
+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/kernel/termination.d.ts.map

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

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

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

@@ -0,0 +1,15 @@
+import type { RunId, RequestContext } from "@vinhnt-sdk/schema";
+import type { ToolContext } from "../tool/definitions.js";
+import type { PluginManager } from "../plugin.js";
+import type { PermissionGate } from "./permission-gate.js";
+import type { ToolExecutionPlan } from "./step-executor.js";
+import type { AgentConfig } from "@vinhnt-sdk/schema";
+export interface ToolContextBuilderDeps {
+    readonly pluginManager: PluginManager | undefined;
+    readonly permissionGate: PermissionGate;
+    readonly currentAgent: AgentConfig | undefined;
+}
+export declare function buildToolContext(tc: ToolExecutionPlan, runId: RunId, sessionId: string | undefined, ctx: RequestContext, runAbort: AbortController, compensationRef: {
+    current: (() => Promise<void>) | null;
+}, deps: ToolContextBuilderDeps): Promise<ToolContext>;
+//# sourceMappingURL=tool-context-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-context-builder.d.ts","sourceRoot":"","sources":["../../src/kernel/tool-context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,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,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;CAChD;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,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAyBtB"}

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

@@ -0,0 +1,23 @@
+export async function buildToolContext(tc, runId, sessionId, ctx, runAbort, compensationRef, deps) {
+    let shellEnv = process.env;
+    const shellEnvResult = await deps.pluginManager?.fireHook("onShellEnv", { env: {} });
+    if (shellEnvResult?.modified?.env) {
+        shellEnv = shellEnvResult.modified.env;
+    }
+    let currentToolMetadata;
+    return {
+        sessionId: sessionId ?? "",
+        runId,
+        agentId: deps.currentAgent?.id ?? "",
+        agentName: deps.currentAgent?.profile.name ?? "",
+        signal: runAbort.signal,
+        env: shellEnv,
+        parentContext: ctx,
+        ask: async (askInput) => {
+            return deps.permissionGate.askForTool(tc.toolName, tc.toolId, runId, sessionId ?? "", askInput.reason, deps.currentAgent?.id ?? "", ctx.traceId, deps.pluginManager);
+        },
+        metadata: (input) => { currentToolMetadata = { ...currentToolMetadata, ...input.metadata }; },
+        setCompensation: (action) => { compensationRef.current = action; },
+    };
+}
+//# sourceMappingURL=tool-context-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-context-builder.js","sourceRoot":"","sources":["../../src/kernel/tool-context-builder.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAqB,EACrB,KAAY,EACZ,SAA6B,EAC7B,GAAmB,EACnB,QAAyB,EACzB,eAA0D,EAC1D,IAA4B;IAE5B,IAAI,QAAQ,GAA2B,OAAO,CAAC,GAA6B,CAAC;IAC7E,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,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC;IACzC,CAAC;IACD,IAAI,mBAAwD,CAAC;IAC7D,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,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;YACtB,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,CAChC,CAAC;QACJ,CAAC;QACD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,mBAAmB,GAAG,EAAE,GAAG,mBAAmB,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC7F,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE,GAAG,eAAe,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC;KACnE,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,25 @@
+import type { RunId, RequestContext } from "@vinhnt-sdk/schema";
+import type { ChatMessage } from "../model.js";
+import type { ToolContext, ToolDefinition } from "../tool/definitions.js";
+import type { PluginManager } from "../plugin.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 "../model.js";
+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: PluginManager | undefined;
+    readonly permissionGate: PermissionGate;
+    readonly selfCorrectOnFailure: boolean;
+    readonly externalDirectoryAccess?: boolean;
+    readonly workspaceRoot?: string;
+    readonly findTool: (name: string) => 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error-router.d.ts","sourceRoot":"","sources":["../../src/kernel/tool-error-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE;QAAE,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,oBAAoB,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IACrI,QAAQ,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7I,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IAChE,YAAY,EAAE,OAAO,oBAAoB,EAAE,WAAW,GAAG,SAAS,CAAC;IACnE,iBAAiB,EAAE,CACjB,EAAE,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,EACzE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,cAAc,EAC/C,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EACjE,QAAQ,EAAE,aAAa,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAoBD,wBAAsB,eAAe,CACnC,GAAG,EAAE,OAAO,EACZ,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,WAAW,EAAE,EACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,eAAe,EACzB,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,iBAAiB,EACrB,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,cAAc,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE,WAAW,EAAE,EACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,OAAO,CAAC,CA+DlB"}

package/dist/kernel/tool-error-router.js

@@ -0,0 +1,102 @@
+import { hashArgs, raceWithAbort, toolDomain } from "./kernel-utils.js";
+import { ToolPermissionDenied, RunAbortedError } from "@vinhnt-sdk/schema";
+function checkExternalPathsLocal(toolName, args, workspaceRoot) {
+    const PATH_AWARE_TOOLS = new Set(["read_file", "write_file", "edit_file", "apply_patch", "list_directory", "glob_files", "grep_files", "shell"]);
+    const { normalize } = require("node:path");
+    if (!PATH_AWARE_TOOLS.has(toolName))
+        return undefined;
+    const input = args;
+    if (!input)
+        return undefined;
+    const normalizedRoot = workspaceRoot.replace(/\\/g, "/") + "/";
+    const pathCandidates = [input.filePath, input.path, input.dirPath].filter((p) => typeof p === "string");
+    for (const p of pathCandidates) {
+        const absRaw = p.startsWith("/") || /^[A-Za-z]:[/\\]/.test(p) ? p : workspaceRoot + "/" + p;
+        const absPath = normalize(absRaw).replace(/\\/g, "/");
+        if (!absPath.startsWith(normalizedRoot)) {
+            return `references path outside workspace: "${p}" (${absPath} not in ${normalizedRoot})`;
+        }
+    }
+    return undefined;
+}
+export async function handleToolError(err, tc, _tool, messages, step, runId, ctx, runAbort, toolCtx, sessionId, recentCalls, runModel, deps) {
+    const isPermissionDenied = err instanceof ToolPermissionDenied;
+    if (err instanceof RunAbortedError)
+        return;
+    const errorMsg = err instanceof Error ? err.message : String(err);
+    if (tc.toolName === "edit_file" && errorMsg.includes("not found") && !isPermissionDenied) {
+        if (await tryReadFileFallback(tc, runAbort, runId, ctx, sessionId, messages, errorMsg, runModel, deps)) {
+            recentCalls.push({ id: tc.toolName, args: tc.args, argsKey: hashArgs(tc.args) });
+            return;
+        }
+    }
+    await deps.store.emitEvent({
+        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: errorMsg },
+    });
+    await deps.pluginManager?.fireHook("onToolFailed", {
+        toolId: tc.toolId, toolName: tc.toolName, error: errorMsg,
+    });
+    messages.push({ role: "tool", toolCallId: tc.toolId, content: `Error: ${errorMsg}` });
+    await deps.addSessionMessage(sessionId, "tool", `Error: ${errorMsg}`, {
+        toolCallId: tc.toolId, model: runModel.model,
+    });
+    if (!isPermissionDenied && deps.selfCorrectOnFailure) {
+        await deps.runSelfCorrection(tc, messages, recentCalls, step, runId, ctx, runAbort, toolCtx, errorMsg, runModel);
+    }
+}
+export async function tryReadFileFallback(tc, runAbort, runId, ctx, sessionId, messages, errorMsg, runModel, deps) {
+    try {
+        const fallbackTool = deps.findTool("read_file");
+        if (!fallbackTool)
+            return false;
+        const fbInput = { filePath: tc.args?.filePath ?? "" };
+        if (deps.externalDirectoryAccess !== true && deps.workspaceRoot) {
+            const extPath = checkExternalPathsLocal("read_file", fbInput, deps.workspaceRoot);
+            if (extPath)
+                return false;
+        }
+        const fbPermResult = deps.permissionGate.checkTool("read_file", fallbackTool.risk, undefined, deps.currentAgent);
+        if (!fbPermResult.allowed && !fbPermResult.needsApproval)
+            return false;
+        if (fbPermResult.needsApproval) {
+            const reply = await deps.permissionGate.askForTool("read_file", tc.toolId, runId, sessionId ?? "", `Fallback read_file for edit_file after error: ${errorMsg.substring(0, 100)}`, deps.currentAgent?.id ?? "", ctx.traceId);
+            if (reply === "reject")
+                return false;
+        }
+        const toolCtx = {
+            sessionId: sessionId ?? "", runId,
+            agentId: deps.currentAgent?.id ?? "",
+            agentName: deps.currentAgent?.profile.name ?? "",
+            signal: runAbort.signal, env: process.env,
+            ask: async (input) => {
+                return deps.permissionGate.askForTool("read_file", tc.toolId, runId, sessionId ?? "", input.reason, deps.currentAgent?.id ?? "", ctx.traceId, deps.pluginManager);
+            },
+            metadata: () => { },
+            setCompensation: () => { },
+        };
+        const fbOutput = await raceWithAbort(fallbackTool.execute(fbInput, toolCtx), runAbort.signal, runId);
+        const fbContent = typeof fbOutput === "string" ? fbOutput : JSON.stringify(fbOutput);
+        await deps.store.emitEvent({
+            id: crypto.randomUUID(), runId, type: "tool.completed",
+            occurredAt: new Date().toISOString(), traceId: ctx.traceId,
+            data: { toolId: tc.toolId, toolName: "read_file", domain: toolDomain("read_file"), output: fbOutput },
+        });
+        messages.push({
+            role: "tool", toolCallId: tc.toolId,
+            content: `Error: ${errorMsg}\n\nCurrent file content:\n${fbContent}`,
+        });
+        await deps.addSessionMessage(sessionId, "tool", `Error: ${errorMsg}\n\nCurrent file content:\n${fbContent}`, {
+            toolCallId: tc.toolId, model: runModel.model,
+        });
+        await deps.pluginManager?.fireHook("onToolFailed", {
+            toolId: tc.toolId, toolName: tc.toolName, error: errorMsg,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=tool-error-router.js.map

package/dist/kernel/tool-error-router.js.map

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

package/dist/kernel/tool-result-processor.d.ts

@@ -0,0 +1,22 @@
+import type { RecentCall } from "./kernel-utils.js";
+import type { ToolCallOutcome } from "./termination.js";
+import type { ChatMessage } from "../model.js";
+import type { ToolExecutionPlan } from "./step-executor.js";
+export interface ToolResultProcessorDeps {
+    readonly addSessionMessage: (sessionId: string | undefined, role: string, content: string, extra?: Record<string, unknown>) => Promise<void>;
+}
+export interface ToolResultProcessorResult {
+    toolCallCount: number;
+    recentCalls: RecentCall[];
+    toolResults: ToolCallOutcome[];
+    breakBatch: boolean;
+}
+export declare function processToolResults(results: PromiseSettledResult<{
+    tc: ToolExecutionPlan;
+    result: string;
+    reason?: string;
+    output?: unknown;
+}>[], doomThreshold: number, messages: ChatMessage[], sessionId: string | undefined, runModel: {
+    model?: string;
+}, existingToolCallCount: number, existingRecentCalls: RecentCall[], existingToolResults: ToolCallOutcome[], deps: ToolResultProcessorDeps): Promise<ToolResultProcessorResult>;
+//# sourceMappingURL=tool-result-processor.d.ts.map

package/dist/kernel/tool-result-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-processor.d.ts","sourceRoot":"","sources":["../../src/kernel/tool-result-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9I;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,oBAAoB,CAAC;IAAE,EAAE,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,EAAE,EAC7G,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,QAAQ,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5B,qBAAqB,EAAE,MAAM,EAC7B,mBAAmB,EAAE,UAAU,EAAE,EACjC,mBAAmB,EAAE,eAAe,EAAE,EACtC,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,yBAAyB,CAAC,CA8CpC"}

package/dist/kernel/tool-result-processor.js

@@ -0,0 +1,47 @@
+import { hashArgs } from "./kernel-utils.js";
+import { toToolCallOutcome } from "./termination.js";
+export async function processToolResults(results, doomThreshold, messages, sessionId, runModel, existingToolCallCount, existingRecentCalls, existingToolResults, deps) {
+    let toolCallCount = existingToolCallCount;
+    const recentCalls = [...existingRecentCalls];
+    const toolResults = [...existingToolResults];
+    let breakBatch = false;
+    for (const settled of results) {
+        if (settled.status === "rejected") {
+            messages.push({ role: "tool", toolCallId: "", content: `Error: ${settled.reason}` });
+            continue;
+        }
+        const r = settled.value;
+        if (r.result === "doom") {
+            const errorMsg = `Tool "${r.tc.toolName}" called with identical arguments ${doomThreshold} consecutive times. Aborting to prevent infinite loop.`;
+            messages.push({ role: "tool", toolCallId: r.tc.toolId, content: `Error: ${errorMsg}` });
+            breakBatch = true;
+            break;
+        }
+        if (r.result === "not-found") {
+            messages.push({ role: "tool", toolCallId: r.tc.toolId, content: `Error: Tool "${r.tc.toolName}" not found` });
+            continue;
+        }
+        if (r.result === "denied") {
+            messages.push({ role: "tool", toolCallId: r.tc.toolId, content: `Error: ${r.reason}` });
+            continue;
+        }
+        if (r.result === "external") {
+            messages.push({ role: "tool", toolCallId: r.tc.toolId, content: `Error: ${r.reason}` });
+            continue;
+        }
+        if (r.result === "rejected")
+            continue;
+        if (r.result === "failed")
+            continue;
+        const outputStr = typeof r.output === "string" ? r.output : JSON.stringify(r.output);
+        messages.push({ role: "tool", content: outputStr, toolCallId: r.tc.toolId });
+        await deps.addSessionMessage(sessionId, "tool", outputStr, {
+            toolCallId: r.tc.toolId, model: runModel.model ?? "",
+        });
+        toolCallCount++;
+        recentCalls.push({ id: r.tc.toolName, args: r.tc.args, argsKey: hashArgs(r.tc.args) });
+        toolResults.push(toToolCallOutcome(r.tc.toolName, r.output));
+    }
+    return { toolCallCount, recentCalls, toolResults, breakBatch };
+}
+//# sourceMappingURL=tool-result-processor.js.map

package/dist/kernel/tool-result-processor.js.map

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

package/dist/kernel/tool-saga.d.ts

@@ -0,0 +1,24 @@
+export interface SagaEntry {
+    toolId: string;
+    toolName: string;
+    input: unknown;
+    output: unknown;
+    timestamp: number;
+    step: number;
+}
+export interface CompensationAction {
+    entry: SagaEntry;
+    compensate(): Promise<void>;
+}
+export declare class ToolSaga {
+    private readonly steps;
+    private readonly compensations;
+    private readonly rolledBack;
+    record(entry: SagaEntry): void;
+    registerCompensation(toolId: string, action: CompensationAction): void;
+    getEntries(step?: number): SagaEntry[];
+    rollbackStep(step: number): Promise<void>;
+    rollbackAll(): Promise<void>;
+    clear(): void;
+}
+//# sourceMappingURL=tool-saga.d.ts.map