@vinhnt-sdk/step-executor 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (67) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +29 -0
  3. package/dist/approval-handler.d.ts +18 -0
  4. package/dist/approval-handler.d.ts.map +1 -0
  5. package/dist/approval-handler.js +39 -0
  6. package/dist/approval-handler.js.map +1 -0
  7. package/dist/circuit-breaker.d.ts +48 -0
  8. package/dist/circuit-breaker.d.ts.map +1 -0
  9. package/dist/circuit-breaker.js +171 -0
  10. package/dist/circuit-breaker.js.map +1 -0
  11. package/dist/hooks.d.ts +15 -0
  12. package/dist/hooks.d.ts.map +1 -0
  13. package/dist/hooks.js +2 -0
  14. package/dist/hooks.js.map +1 -0
  15. package/dist/index.d.ts +22 -0
  16. package/dist/index.d.ts.map +1 -0
  17. package/dist/index.js +22 -0
  18. package/dist/index.js.map +1 -0
  19. package/dist/kernel-error.d.ts +10 -0
  20. package/dist/kernel-error.d.ts.map +1 -0
  21. package/dist/kernel-error.js +12 -0
  22. package/dist/kernel-error.js.map +1 -0
  23. package/dist/kernel-utils.d.ts +49 -0
  24. package/dist/kernel-utils.d.ts.map +1 -0
  25. package/dist/kernel-utils.js +117 -0
  26. package/dist/kernel-utils.js.map +1 -0
  27. package/dist/path-policy.d.ts +18 -0
  28. package/dist/path-policy.d.ts.map +1 -0
  29. package/dist/path-policy.js +38 -0
  30. package/dist/path-policy.js.map +1 -0
  31. package/dist/permission-gate.d.ts +93 -0
  32. package/dist/permission-gate.d.ts.map +1 -0
  33. package/dist/permission-gate.js +303 -0
  34. package/dist/permission-gate.js.map +1 -0
  35. package/dist/run-context.d.ts +26 -0
  36. package/dist/run-context.d.ts.map +1 -0
  37. package/dist/run-context.js +13 -0
  38. package/dist/run-context.js.map +1 -0
  39. package/dist/run-state.d.ts +27 -0
  40. package/dist/run-state.d.ts.map +1 -0
  41. package/dist/run-state.js +88 -0
  42. package/dist/run-state.js.map +1 -0
  43. package/dist/self-correction.d.ts +29 -0
  44. package/dist/self-correction.d.ts.map +1 -0
  45. package/dist/self-correction.js +89 -0
  46. package/dist/self-correction.js.map +1 -0
  47. package/dist/step-executor.d.ts +81 -0
  48. package/dist/step-executor.d.ts.map +1 -0
  49. package/dist/step-executor.js +314 -0
  50. package/dist/step-executor.js.map +1 -0
  51. package/dist/termination.d.ts +87 -0
  52. package/dist/termination.d.ts.map +1 -0
  53. package/dist/termination.js +89 -0
  54. package/dist/termination.js.map +1 -0
  55. package/dist/tool-context-builder.d.ts +22 -0
  56. package/dist/tool-context-builder.d.ts.map +1 -0
  57. package/dist/tool-context-builder.js +42 -0
  58. package/dist/tool-context-builder.js.map +1 -0
  59. package/dist/tool-error-router.d.ts +26 -0
  60. package/dist/tool-error-router.d.ts.map +1 -0
  61. package/dist/tool-error-router.js +85 -0
  62. package/dist/tool-error-router.js.map +1 -0
  63. package/dist/tool-result-processor.d.ts +24 -0
  64. package/dist/tool-result-processor.d.ts.map +1 -0
  65. package/dist/tool-result-processor.js +47 -0
  66. package/dist/tool-result-processor.js.map +1 -0
  67. package/package.json +63 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-error-router.d.ts","sourceRoot":"","sources":["../src/tool-error-router.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,85 @@
1
+ import { sanitizeEnv } from "@vinhnt-sdk/security";
2
+ import { hashArgs, raceWithAbort, toolDomain } from "./kernel-utils.js";
3
+ import { ToolPermissionDenied, RunAbortedError } from "@vinhnt-sdk/schema";
4
+ import { checkExternalPaths } from "./path-policy.js";
5
+ export async function handleToolError(err, tc, _tool, messages, step, runId, ctx, runAbort, toolCtx, sessionId, recentCalls, runModel, deps) {
6
+ const isPermissionDenied = err instanceof ToolPermissionDenied;
7
+ if (err instanceof RunAbortedError)
8
+ return;
9
+ const errorMsg = err instanceof Error ? err.message : String(err);
10
+ if (tc.toolName === "edit_file" && errorMsg.includes("not found") && !isPermissionDenied) {
11
+ if (await tryReadFileFallback(tc, runAbort, runId, ctx, sessionId, messages, errorMsg, runModel, deps)) {
12
+ recentCalls.push({ id: tc.toolName, args: tc.args, argsKey: hashArgs(tc.args) });
13
+ return;
14
+ }
15
+ }
16
+ await deps.store.emitEvent({
17
+ id: crypto.randomUUID(), runId, type: "tool.failed",
18
+ occurredAt: new Date().toISOString(), traceId: ctx.traceId,
19
+ data: { toolId: tc.toolId, toolName: tc.toolName, domain: toolDomain(tc.toolName), error: errorMsg },
20
+ });
21
+ await deps.pluginManager?.fireHook("onToolFailed", {
22
+ toolId: tc.toolId, toolName: tc.toolName, error: errorMsg,
23
+ });
24
+ messages.push({ role: "tool", toolCallId: tc.toolId, content: `Error: ${errorMsg}` });
25
+ await deps.addSessionMessage(sessionId, "tool", `Error: ${errorMsg}`, {
26
+ toolCallId: tc.toolId, model: runModel.model,
27
+ });
28
+ if (!isPermissionDenied && deps.selfCorrectOnFailure) {
29
+ await deps.runSelfCorrection(tc, messages, recentCalls, step, runId, ctx, runAbort, toolCtx, errorMsg, runModel);
30
+ }
31
+ }
32
+ export async function tryReadFileFallback(tc, runAbort, runId, ctx, sessionId, messages, errorMsg, runModel, deps) {
33
+ try {
34
+ const fallbackTool = deps.findTool("read_file", runId);
35
+ if (!fallbackTool)
36
+ return false;
37
+ const fbInput = { filePath: tc.args?.filePath ?? "" };
38
+ if (deps.externalDirectoryAccess !== true && deps.workspaceRoot) {
39
+ const extPath = checkExternalPaths("read_file", fbInput, deps.workspaceRoot);
40
+ if (extPath)
41
+ return false;
42
+ }
43
+ const fbPermResult = deps.permissionGate.checkTool("read_file", fallbackTool.risk, undefined, deps.currentAgent);
44
+ if (!fbPermResult.allowed && !fbPermResult.needsApproval)
45
+ return false;
46
+ if (fbPermResult.needsApproval) {
47
+ 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, undefined, undefined, runAbort.signal);
48
+ if (reply === "reject")
49
+ return false;
50
+ }
51
+ const toolCtx = {
52
+ sessionId: sessionId ?? "", runId,
53
+ agentId: deps.currentAgent?.id ?? "",
54
+ agentName: deps.currentAgent?.profile.name ?? "",
55
+ signal: runAbort.signal, env: sanitizeEnv(),
56
+ ask: async (input) => {
57
+ return deps.permissionGate.askForTool("read_file", tc.toolId, runId, sessionId ?? "", input.reason, deps.currentAgent?.id ?? "", ctx.traceId, deps.pluginManager, undefined, runAbort.signal);
58
+ },
59
+ metadata: () => { },
60
+ setCompensation: () => { },
61
+ };
62
+ const fbOutput = await raceWithAbort(fallbackTool.execute(fbInput, toolCtx), runAbort.signal, runId);
63
+ const fbContent = typeof fbOutput === "string" ? fbOutput : JSON.stringify(fbOutput);
64
+ await deps.store.emitEvent({
65
+ id: crypto.randomUUID(), runId, type: "tool.completed",
66
+ occurredAt: new Date().toISOString(), traceId: ctx.traceId,
67
+ data: { toolId: tc.toolId, toolName: "read_file", domain: toolDomain("read_file"), output: fbOutput },
68
+ });
69
+ messages.push({
70
+ role: "tool", toolCallId: tc.toolId,
71
+ content: `Error: ${errorMsg}\n\nCurrent file content:\n${fbContent}`,
72
+ });
73
+ await deps.addSessionMessage(sessionId, "tool", `Error: ${errorMsg}\n\nCurrent file content:\n${fbContent}`, {
74
+ toolCallId: tc.toolId, model: runModel.model,
75
+ });
76
+ await deps.pluginManager?.fireHook("onToolFailed", {
77
+ toolId: tc.toolId, toolName: tc.toolName, error: errorMsg,
78
+ });
79
+ return true;
80
+ }
81
+ catch {
82
+ return false;
83
+ }
84
+ }
85
+ //# sourceMappingURL=tool-error-router.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-error-router.js","sourceRoot":"","sources":["../src/tool-error-router.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ import type { RecentCall } from "./kernel-utils.js";
2
+ import type { ToolCallOutcome } from "./termination.js";
3
+ import type { ChatMessage } from "@vinhnt-sdk/schema";
4
+ import type { ToolExecutionPlan } from "./step-executor.js";
5
+ /** Dependencies required by {@link processToolResults}. */
6
+ export interface ToolResultProcessorDeps {
7
+ readonly addSessionMessage: (sessionId: string | undefined, role: string, content: string, extra?: Record<string, unknown>) => Promise<void>;
8
+ }
9
+ /** Aggregated outcome of processing a batch of tool results. */
10
+ export interface ToolResultProcessorResult {
11
+ toolCallCount: number;
12
+ recentCalls: RecentCall[];
13
+ toolResults: ToolCallOutcome[];
14
+ breakBatch: boolean;
15
+ }
16
+ export declare function processToolResults(results: PromiseSettledResult<{
17
+ tc: ToolExecutionPlan;
18
+ result: string;
19
+ reason?: string;
20
+ output?: unknown;
21
+ }>[], doomThreshold: number, messages: ChatMessage[], sessionId: string | undefined, runModel: {
22
+ model?: string;
23
+ }, existingToolCallCount: number, existingRecentCalls: RecentCall[], existingToolResults: ToolCallOutcome[], deps: ToolResultProcessorDeps): Promise<ToolResultProcessorResult>;
24
+ //# sourceMappingURL=tool-result-processor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-result-processor.d.ts","sourceRoot":"","sources":["../src/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,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,2DAA2D;AAC3D,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,gEAAgE;AAChE,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"}
@@ -0,0 +1,47 @@
1
+ import { hashArgs } from "./kernel-utils.js";
2
+ import { toToolCallOutcome } from "./termination.js";
3
+ export async function processToolResults(results, doomThreshold, messages, sessionId, runModel, existingToolCallCount, existingRecentCalls, existingToolResults, deps) {
4
+ let toolCallCount = existingToolCallCount;
5
+ const recentCalls = [...existingRecentCalls];
6
+ const toolResults = [...existingToolResults];
7
+ let breakBatch = false;
8
+ for (const settled of results) {
9
+ if (settled.status === "rejected") {
10
+ messages.push({ role: "tool", toolCallId: "", content: `Error: ${settled.reason}` });
11
+ continue;
12
+ }
13
+ const r = settled.value;
14
+ if (r.result === "doom") {
15
+ const errorMsg = `Tool "${r.tc.toolName}" called with identical arguments ${doomThreshold} consecutive times. Aborting to prevent infinite loop.`;
16
+ messages.push({ role: "tool", toolCallId: r.tc.toolId, content: `Error: ${errorMsg}` });
17
+ breakBatch = true;
18
+ break;
19
+ }
20
+ if (r.result === "not-found") {
21
+ messages.push({ role: "tool", toolCallId: r.tc.toolId, content: `Error: Tool "${r.tc.toolName}" not found` });
22
+ continue;
23
+ }
24
+ if (r.result === "denied") {
25
+ messages.push({ role: "tool", toolCallId: r.tc.toolId, content: `Error: ${r.reason}` });
26
+ continue;
27
+ }
28
+ if (r.result === "external") {
29
+ messages.push({ role: "tool", toolCallId: r.tc.toolId, content: `Error: ${r.reason}` });
30
+ continue;
31
+ }
32
+ if (r.result === "rejected")
33
+ continue;
34
+ if (r.result === "failed")
35
+ continue;
36
+ const outputStr = typeof r.output === "string" ? r.output : JSON.stringify(r.output);
37
+ messages.push({ role: "tool", content: outputStr, toolCallId: r.tc.toolId });
38
+ await deps.addSessionMessage(sessionId, "tool", outputStr, {
39
+ toolCallId: r.tc.toolId, model: runModel.model ?? "",
40
+ });
41
+ toolCallCount++;
42
+ recentCalls.push({ id: r.tc.toolName, args: r.tc.args, argsKey: hashArgs(r.tc.args) });
43
+ toolResults.push(toToolCallOutcome(r.tc.toolName, r.output));
44
+ }
45
+ return { toolCallCount, recentCalls, toolResults, breakBatch };
46
+ }
47
+ //# sourceMappingURL=tool-result-processor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-result-processor.js","sourceRoot":"","sources":["../src/tool-result-processor.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,63 @@
1
+ {
2
+ "name": "@vinhnt-sdk/step-executor",
3
+ "version": "0.1.3",
4
+ "description": "Step execution kernel for VNT Agent — tool lifecycle, timeouts, permission gating, doom-loop detection, self-correction and run state",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "main": "./dist/index.js",
8
+ "types": "./dist/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "types": "./dist/index.d.ts",
12
+ "import": "./dist/index.js",
13
+ "default": "./dist/index.js"
14
+ },
15
+ "./package.json": "./package.json"
16
+ },
17
+ "files": [
18
+ "dist",
19
+ "LICENSE",
20
+ "README.md"
21
+ ],
22
+ "sideEffects": false,
23
+ "engines": {
24
+ "node": ">=20"
25
+ },
26
+ "repository": {
27
+ "type": "git",
28
+ "url": "https://github.com/vinhnt-develop/vinhnt-sdk.git",
29
+ "directory": "packages/step-executor"
30
+ },
31
+ "homepage": "https://github.com/vinhnt-develop/vinhnt-sdk/tree/main/packages/step-executor",
32
+ "bugs": {
33
+ "url": "https://github.com/vinhnt-develop/vinhnt-sdk/issues"
34
+ },
35
+ "keywords": [
36
+ "vnt",
37
+ "step",
38
+ "executor",
39
+ "tool",
40
+ "permission",
41
+ "kernel",
42
+ "agent"
43
+ ],
44
+ "publishConfig": {
45
+ "access": "public"
46
+ },
47
+ "dependencies": {
48
+ "@vinhnt-sdk/schema": "0.1.3",
49
+ "@vinhnt-sdk/permission": "0.1.3",
50
+ "@vinhnt-sdk/session": "0.1.3",
51
+ "@vinhnt-sdk/event": "0.1.3",
52
+ "@vinhnt-sdk/llm": "0.1.3",
53
+ "@vinhnt-sdk/security": "0.1.3",
54
+ "@vinhnt-sdk/tools": "0.1.3"
55
+ },
56
+ "scripts": {
57
+ "build": "tsc -b",
58
+ "typecheck": "tsc --noEmit",
59
+ "clean": "node -e \"try{require('fs').rmSync('dist',{recursive:true,force:true})}catch(e){}\" && node -e \"try{require('fs').rmSync('tsconfig.tsbuildinfo',{force:true})}catch(e){}\"",
60
+ "test": "vitest run",
61
+ "lint": "eslint ."
62
+ }
63
+ }