@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.
- package/LICENSE +21 -0
- package/README.md +29 -0
- package/dist/approval-handler.d.ts +18 -0
- package/dist/approval-handler.d.ts.map +1 -0
- package/dist/approval-handler.js +39 -0
- package/dist/approval-handler.js.map +1 -0
- package/dist/circuit-breaker.d.ts +48 -0
- package/dist/circuit-breaker.d.ts.map +1 -0
- package/dist/circuit-breaker.js +171 -0
- package/dist/circuit-breaker.js.map +1 -0
- package/dist/hooks.d.ts +15 -0
- package/dist/hooks.d.ts.map +1 -0
- package/dist/hooks.js +2 -0
- package/dist/hooks.js.map +1 -0
- package/dist/index.d.ts +22 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +22 -0
- package/dist/index.js.map +1 -0
- package/dist/kernel-error.d.ts +10 -0
- package/dist/kernel-error.d.ts.map +1 -0
- package/dist/kernel-error.js +12 -0
- package/dist/kernel-error.js.map +1 -0
- package/dist/kernel-utils.d.ts +49 -0
- package/dist/kernel-utils.d.ts.map +1 -0
- package/dist/kernel-utils.js +117 -0
- package/dist/kernel-utils.js.map +1 -0
- package/dist/path-policy.d.ts +18 -0
- package/dist/path-policy.d.ts.map +1 -0
- package/dist/path-policy.js +38 -0
- package/dist/path-policy.js.map +1 -0
- package/dist/permission-gate.d.ts +93 -0
- package/dist/permission-gate.d.ts.map +1 -0
- package/dist/permission-gate.js +303 -0
- package/dist/permission-gate.js.map +1 -0
- package/dist/run-context.d.ts +26 -0
- package/dist/run-context.d.ts.map +1 -0
- package/dist/run-context.js +13 -0
- package/dist/run-context.js.map +1 -0
- package/dist/run-state.d.ts +27 -0
- package/dist/run-state.d.ts.map +1 -0
- package/dist/run-state.js +88 -0
- package/dist/run-state.js.map +1 -0
- package/dist/self-correction.d.ts +29 -0
- package/dist/self-correction.d.ts.map +1 -0
- package/dist/self-correction.js +89 -0
- package/dist/self-correction.js.map +1 -0
- package/dist/step-executor.d.ts +81 -0
- package/dist/step-executor.d.ts.map +1 -0
- package/dist/step-executor.js +314 -0
- package/dist/step-executor.js.map +1 -0
- package/dist/termination.d.ts +87 -0
- package/dist/termination.d.ts.map +1 -0
- package/dist/termination.js +89 -0
- package/dist/termination.js.map +1 -0
- package/dist/tool-context-builder.d.ts +22 -0
- package/dist/tool-context-builder.d.ts.map +1 -0
- package/dist/tool-context-builder.js +42 -0
- package/dist/tool-context-builder.js.map +1 -0
- package/dist/tool-error-router.d.ts +26 -0
- package/dist/tool-error-router.d.ts.map +1 -0
- package/dist/tool-error-router.js +85 -0
- package/dist/tool-error-router.js.map +1 -0
- package/dist/tool-result-processor.d.ts +24 -0
- package/dist/tool-result-processor.d.ts.map +1 -0
- package/dist/tool-result-processor.js +47 -0
- package/dist/tool-result-processor.js.map +1 -0
- 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":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,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,oBAAoB,CAAC;AAGxD,wDAAwD;AACxD,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,uBAAuB,GAAG,SAAS,CAAC;IAC5D,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,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,cAAc,GAAG,SAAS,CAAC;IAC/E,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;AAED,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"}
|
|
@@ -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
|
+
}
|