dvalincode 0.12.0
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 +22 -0
- package/README.md +649 -0
- package/README.zh-CN.md +623 -0
- package/THIRD_PARTY_NOTICES.md +432 -0
- package/dist/agent/compact.d.ts +4 -0
- package/dist/agent/compact.js +40 -0
- package/dist/agent/compact.js.map +1 -0
- package/dist/agent/loop.d.ts +44 -0
- package/dist/agent/loop.js +262 -0
- package/dist/agent/loop.js.map +1 -0
- package/dist/agent/modes.d.ts +13 -0
- package/dist/agent/modes.js +44 -0
- package/dist/agent/modes.js.map +1 -0
- package/dist/agent/runner.d.ts +37 -0
- package/dist/agent/runner.js +171 -0
- package/dist/agent/runner.js.map +1 -0
- package/dist/agent/session.d.ts +73 -0
- package/dist/agent/session.js +282 -0
- package/dist/agent/session.js.map +1 -0
- package/dist/agent/types.d.ts +86 -0
- package/dist/agent/types.js +26 -0
- package/dist/agent/types.js.map +1 -0
- package/dist/audit/diffStat.d.ts +8 -0
- package/dist/audit/diffStat.js +17 -0
- package/dist/audit/diffStat.js.map +1 -0
- package/dist/audit/hash.d.ts +10 -0
- package/dist/audit/hash.js +33 -0
- package/dist/audit/hash.js.map +1 -0
- package/dist/audit/log.d.ts +147 -0
- package/dist/audit/log.js +163 -0
- package/dist/audit/log.js.map +1 -0
- package/dist/audit/minimize.d.ts +10 -0
- package/dist/audit/minimize.js +61 -0
- package/dist/audit/minimize.js.map +1 -0
- package/dist/audit/report.d.ts +8 -0
- package/dist/audit/report.js +113 -0
- package/dist/audit/report.js.map +1 -0
- package/dist/audit/taps.d.ts +8 -0
- package/dist/audit/taps.js +67 -0
- package/dist/audit/taps.js.map +1 -0
- package/dist/cli.d.ts +3 -0
- package/dist/cli.js +56 -0
- package/dist/cli.js.map +1 -0
- package/dist/commands/ask.d.ts +3 -0
- package/dist/commands/ask.js +14 -0
- package/dist/commands/ask.js.map +1 -0
- package/dist/commands/chat.d.ts +3 -0
- package/dist/commands/chat.js +148 -0
- package/dist/commands/chat.js.map +1 -0
- package/dist/commands/data.d.ts +2 -0
- package/dist/commands/data.js +65 -0
- package/dist/commands/data.js.map +1 -0
- package/dist/commands/evidence.d.ts +2 -0
- package/dist/commands/evidence.js +50 -0
- package/dist/commands/evidence.js.map +1 -0
- package/dist/commands/init.d.ts +2 -0
- package/dist/commands/init.js +18 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/memory.d.ts +2 -0
- package/dist/commands/memory.js +74 -0
- package/dist/commands/memory.js.map +1 -0
- package/dist/commands/policy.d.ts +2 -0
- package/dist/commands/policy.js +95 -0
- package/dist/commands/policy.js.map +1 -0
- package/dist/commands/provider.d.ts +2 -0
- package/dist/commands/provider.js +130 -0
- package/dist/commands/provider.js.map +1 -0
- package/dist/commands/report.d.ts +2 -0
- package/dist/commands/report.js +47 -0
- package/dist/commands/report.js.map +1 -0
- package/dist/commands/runTool.d.ts +3 -0
- package/dist/commands/runTool.js +41 -0
- package/dist/commands/runTool.js.map +1 -0
- package/dist/commands/scan.d.ts +2 -0
- package/dist/commands/scan.js +15 -0
- package/dist/commands/scan.js.map +1 -0
- package/dist/commands/serve.d.ts +2 -0
- package/dist/commands/serve.js +18 -0
- package/dist/commands/serve.js.map +1 -0
- package/dist/commands/tools.d.ts +3 -0
- package/dist/commands/tools.js +11 -0
- package/dist/commands/tools.js.map +1 -0
- package/dist/commands/trust.d.ts +2 -0
- package/dist/commands/trust.js +16 -0
- package/dist/commands/trust.js.map +1 -0
- package/dist/commands/tui.d.ts +2 -0
- package/dist/commands/tui.js +13 -0
- package/dist/commands/tui.js.map +1 -0
- package/dist/core/context.d.ts +28 -0
- package/dist/core/context.js +29 -0
- package/dist/core/context.js.map +1 -0
- package/dist/core/diffPreview.d.ts +6 -0
- package/dist/core/diffPreview.js +37 -0
- package/dist/core/diffPreview.js.map +1 -0
- package/dist/core/ignorefile.d.ts +1 -0
- package/dist/core/ignorefile.js +14 -0
- package/dist/core/ignorefile.js.map +1 -0
- package/dist/core/permissions.d.ts +3 -0
- package/dist/core/permissions.js +9 -0
- package/dist/core/permissions.js.map +1 -0
- package/dist/core/policy.d.ts +182 -0
- package/dist/core/policy.js +358 -0
- package/dist/core/policy.js.map +1 -0
- package/dist/core/projectScanner.d.ts +12 -0
- package/dist/core/projectScanner.js +85 -0
- package/dist/core/projectScanner.js.map +1 -0
- package/dist/core/subprocessSandbox.d.ts +42 -0
- package/dist/core/subprocessSandbox.js +132 -0
- package/dist/core/subprocessSandbox.js.map +1 -0
- package/dist/core/trust.d.ts +50 -0
- package/dist/core/trust.js +191 -0
- package/dist/core/trust.js.map +1 -0
- package/dist/core/workspace.d.ts +9 -0
- package/dist/core/workspace.js +55 -0
- package/dist/core/workspace.js.map +1 -0
- package/dist/data/archive.d.ts +39 -0
- package/dist/data/archive.js +127 -0
- package/dist/data/archive.js.map +1 -0
- package/dist/evidence/compliance.d.ts +22 -0
- package/dist/evidence/compliance.js +57 -0
- package/dist/evidence/compliance.js.map +1 -0
- package/dist/evidence/pack.d.ts +56 -0
- package/dist/evidence/pack.js +123 -0
- package/dist/evidence/pack.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +8 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/client.d.ts +45 -0
- package/dist/mcp/client.js +111 -0
- package/dist/mcp/client.js.map +1 -0
- package/dist/mcp/config.d.ts +10 -0
- package/dist/mcp/config.js +18 -0
- package/dist/mcp/config.js.map +1 -0
- package/dist/mcp/governedFetch.d.ts +16 -0
- package/dist/mcp/governedFetch.js +44 -0
- package/dist/mcp/governedFetch.js.map +1 -0
- package/dist/mcp/register.d.ts +26 -0
- package/dist/mcp/register.js +77 -0
- package/dist/mcp/register.js.map +1 -0
- package/dist/memory/importers.d.ts +17 -0
- package/dist/memory/importers.js +186 -0
- package/dist/memory/importers.js.map +1 -0
- package/dist/memory/store.d.ts +71 -0
- package/dist/memory/store.js +251 -0
- package/dist/memory/store.js.map +1 -0
- package/dist/providers/egress.d.ts +2 -0
- package/dist/providers/egress.js +172 -0
- package/dist/providers/egress.js.map +1 -0
- package/dist/providers/localPlanner.d.ts +3 -0
- package/dist/providers/localPlanner.js +21 -0
- package/dist/providers/localPlanner.js.map +1 -0
- package/dist/providers/manager.d.ts +30 -0
- package/dist/providers/manager.js +48 -0
- package/dist/providers/manager.js.map +1 -0
- package/dist/providers/openaiCompatible.d.ts +5 -0
- package/dist/providers/openaiCompatible.js +176 -0
- package/dist/providers/openaiCompatible.js.map +1 -0
- package/dist/providers/pool.d.ts +14 -0
- package/dist/providers/pool.js +59 -0
- package/dist/providers/pool.js.map +1 -0
- package/dist/providers/secrets.d.ts +8 -0
- package/dist/providers/secrets.js +17 -0
- package/dist/providers/secrets.js.map +1 -0
- package/dist/providers/trustedBaseUrls.d.ts +1 -0
- package/dist/providers/trustedBaseUrls.js +49 -0
- package/dist/providers/trustedBaseUrls.js.map +1 -0
- package/dist/providers/types.d.ts +59 -0
- package/dist/providers/types.js +2 -0
- package/dist/providers/types.js.map +1 -0
- package/dist/remediation/cases.d.ts +37 -0
- package/dist/remediation/cases.js +90 -0
- package/dist/remediation/cases.js.map +1 -0
- package/dist/remediation/localScan.d.ts +2 -0
- package/dist/remediation/localScan.js +212 -0
- package/dist/remediation/localScan.js.map +1 -0
- package/dist/remediation/sarif.d.ts +26 -0
- package/dist/remediation/sarif.js +150 -0
- package/dist/remediation/sarif.js.map +1 -0
- package/dist/remediation/worktree.d.ts +11 -0
- package/dist/remediation/worktree.js +90 -0
- package/dist/remediation/worktree.js.map +1 -0
- package/dist/server/configStore.d.ts +59 -0
- package/dist/server/configStore.js +73 -0
- package/dist/server/configStore.js.map +1 -0
- package/dist/server/index.d.ts +17 -0
- package/dist/server/index.js +120 -0
- package/dist/server/index.js.map +1 -0
- package/dist/server/playbookHandler.d.ts +3 -0
- package/dist/server/playbookHandler.js +44 -0
- package/dist/server/playbookHandler.js.map +1 -0
- package/dist/server/routes/config.d.ts +1 -0
- package/dist/server/routes/config.js +184 -0
- package/dist/server/routes/config.js.map +1 -0
- package/dist/server/routes/data.d.ts +1 -0
- package/dist/server/routes/data.js +29 -0
- package/dist/server/routes/data.js.map +1 -0
- package/dist/server/routes/files.d.ts +1 -0
- package/dist/server/routes/files.js +20 -0
- package/dist/server/routes/files.js.map +1 -0
- package/dist/server/routes/git.d.ts +1 -0
- package/dist/server/routes/git.js +29 -0
- package/dist/server/routes/git.js.map +1 -0
- package/dist/server/routes/projects.d.ts +3 -0
- package/dist/server/routes/projects.js +178 -0
- package/dist/server/routes/projects.js.map +1 -0
- package/dist/server/routes/remediation.d.ts +1 -0
- package/dist/server/routes/remediation.js +99 -0
- package/dist/server/routes/remediation.js.map +1 -0
- package/dist/server/routes/sessions.d.ts +1 -0
- package/dist/server/routes/sessions.js +46 -0
- package/dist/server/routes/sessions.js.map +1 -0
- package/dist/server/routes/skills.d.ts +1 -0
- package/dist/server/routes/skills.js +48 -0
- package/dist/server/routes/skills.js.map +1 -0
- package/dist/server/routes/tools.d.ts +1 -0
- package/dist/server/routes/tools.js +12 -0
- package/dist/server/routes/tools.js.map +1 -0
- package/dist/server/security.d.ts +7 -0
- package/dist/server/security.js +128 -0
- package/dist/server/security.js.map +1 -0
- package/dist/server/wsHandler.d.ts +2 -0
- package/dist/server/wsHandler.js +212 -0
- package/dist/server/wsHandler.js.map +1 -0
- package/dist/sessions/journal.d.ts +65 -0
- package/dist/sessions/journal.js +98 -0
- package/dist/sessions/journal.js.map +1 -0
- package/dist/sessions/markdown.d.ts +8 -0
- package/dist/sessions/markdown.js +69 -0
- package/dist/sessions/markdown.js.map +1 -0
- package/dist/sessions/store.d.ts +26 -0
- package/dist/sessions/store.js +136 -0
- package/dist/sessions/store.js.map +1 -0
- package/dist/skills/store.d.ts +24 -0
- package/dist/skills/store.js +215 -0
- package/dist/skills/store.js.map +1 -0
- package/dist/tools/deleteFile.d.ts +8 -0
- package/dist/tools/deleteFile.js +37 -0
- package/dist/tools/deleteFile.js.map +1 -0
- package/dist/tools/editFile.d.ts +10 -0
- package/dist/tools/editFile.js +66 -0
- package/dist/tools/editFile.js.map +1 -0
- package/dist/tools/gitDiff.d.ts +10 -0
- package/dist/tools/gitDiff.js +59 -0
- package/dist/tools/gitDiff.js.map +1 -0
- package/dist/tools/gitStatus.d.ts +5 -0
- package/dist/tools/gitStatus.js +45 -0
- package/dist/tools/gitStatus.js.map +1 -0
- package/dist/tools/listFiles.d.ts +9 -0
- package/dist/tools/listFiles.js +36 -0
- package/dist/tools/listFiles.js.map +1 -0
- package/dist/tools/listRemediationCases.d.ts +8 -0
- package/dist/tools/listRemediationCases.js +23 -0
- package/dist/tools/listRemediationCases.js.map +1 -0
- package/dist/tools/listSkills.d.ts +6 -0
- package/dist/tools/listSkills.js +21 -0
- package/dist/tools/listSkills.js.map +1 -0
- package/dist/tools/memoryDelete.d.ts +8 -0
- package/dist/tools/memoryDelete.js +24 -0
- package/dist/tools/memoryDelete.js.map +1 -0
- package/dist/tools/memoryImport.d.ts +18 -0
- package/dist/tools/memoryImport.js +64 -0
- package/dist/tools/memoryImport.js.map +1 -0
- package/dist/tools/memorySearch.d.ts +13 -0
- package/dist/tools/memorySearch.js +40 -0
- package/dist/tools/memorySearch.js.map +1 -0
- package/dist/tools/memoryUpdate.d.ts +19 -0
- package/dist/tools/memoryUpdate.js +38 -0
- package/dist/tools/memoryUpdate.js.map +1 -0
- package/dist/tools/memoryWrite.d.ts +22 -0
- package/dist/tools/memoryWrite.js +36 -0
- package/dist/tools/memoryWrite.js.map +1 -0
- package/dist/tools/prepareRemediationWorktree.d.ts +8 -0
- package/dist/tools/prepareRemediationWorktree.js +48 -0
- package/dist/tools/prepareRemediationWorktree.js.map +1 -0
- package/dist/tools/projectScripts.d.ts +11 -0
- package/dist/tools/projectScripts.js +64 -0
- package/dist/tools/projectScripts.js.map +1 -0
- package/dist/tools/readFile.d.ts +10 -0
- package/dist/tools/readFile.js +57 -0
- package/dist/tools/readFile.js.map +1 -0
- package/dist/tools/readSkill.d.ts +8 -0
- package/dist/tools/readSkill.js +25 -0
- package/dist/tools/readSkill.js.map +1 -0
- package/dist/tools/registry.d.ts +15 -0
- package/dist/tools/registry.js +121 -0
- package/dist/tools/registry.js.map +1 -0
- package/dist/tools/runCheck.d.ts +17 -0
- package/dist/tools/runCheck.js +125 -0
- package/dist/tools/runCheck.js.map +1 -0
- package/dist/tools/runSecurityScan.d.ts +8 -0
- package/dist/tools/runSecurityScan.js +36 -0
- package/dist/tools/runSecurityScan.js.map +1 -0
- package/dist/tools/searchText.d.ts +11 -0
- package/dist/tools/searchText.js +67 -0
- package/dist/tools/searchText.js.map +1 -0
- package/dist/tools/shell.d.ts +16 -0
- package/dist/tools/shell.js +114 -0
- package/dist/tools/shell.js.map +1 -0
- package/dist/tools/types.d.ts +57 -0
- package/dist/tools/types.js +2 -0
- package/dist/tools/types.js.map +1 -0
- package/dist/tools/writeFile.d.ts +9 -0
- package/dist/tools/writeFile.js +89 -0
- package/dist/tools/writeFile.js.map +1 -0
- package/dist/tui/app.d.ts +8 -0
- package/dist/tui/app.js +178 -0
- package/dist/tui/app.js.map +1 -0
- package/dist/tui/presets.d.ts +13 -0
- package/dist/tui/presets.js +11 -0
- package/dist/tui/presets.js.map +1 -0
- package/dist/tui/render.d.ts +14 -0
- package/dist/tui/render.js +83 -0
- package/dist/tui/render.js.map +1 -0
- package/dist/ui/output.d.ts +4 -0
- package/dist/ui/output.js +21 -0
- package/dist/ui/output.js.map +1 -0
- package/package.json +77 -0
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
import { assertToolPermission } from '../core/permissions.js';
|
|
2
|
+
import { randomUUID } from 'node:crypto';
|
|
3
|
+
import { checkTool, checkCommand, checkPath, PolicyViolationError } from '../core/policy.js';
|
|
4
|
+
import { emitToolAudit } from '../audit/taps.js';
|
|
5
|
+
import { minimizedDescriptor } from '../audit/minimize.js';
|
|
6
|
+
import { editFileTool } from './editFile.js';
|
|
7
|
+
import { gitDiffTool } from './gitDiff.js';
|
|
8
|
+
import { listFilesTool } from './listFiles.js';
|
|
9
|
+
import { memoryDeleteTool } from './memoryDelete.js';
|
|
10
|
+
import { memoryImportTool } from './memoryImport.js';
|
|
11
|
+
import { memorySearchTool } from './memorySearch.js';
|
|
12
|
+
import { memoryUpdateTool } from './memoryUpdate.js';
|
|
13
|
+
import { memoryWriteTool } from './memoryWrite.js';
|
|
14
|
+
import { listRemediationCasesTool } from './listRemediationCases.js';
|
|
15
|
+
import { listSkillsTool } from './listSkills.js';
|
|
16
|
+
import { prepareRemediationWorktreeTool } from './prepareRemediationWorktree.js';
|
|
17
|
+
import { projectScriptsTool } from './projectScripts.js';
|
|
18
|
+
import { readFileTool } from './readFile.js';
|
|
19
|
+
import { readSkillTool } from './readSkill.js';
|
|
20
|
+
import { runSecurityScanTool } from './runSecurityScan.js';
|
|
21
|
+
import { runCheckTool } from './runCheck.js';
|
|
22
|
+
import { searchTextTool } from './searchText.js';
|
|
23
|
+
import { shellTool } from './shell.js';
|
|
24
|
+
import { writeFileTool } from './writeFile.js';
|
|
25
|
+
import { deleteFileTool } from './deleteFile.js';
|
|
26
|
+
import { gitStatusTool } from './gitStatus.js';
|
|
27
|
+
export class ToolRegistry {
|
|
28
|
+
tools = new Map();
|
|
29
|
+
allowedToolNames = null;
|
|
30
|
+
/** Restrict which tools are visible / executable. Pass null to allow all. */
|
|
31
|
+
setAllowedTools(names) {
|
|
32
|
+
this.allowedToolNames = names ? new Set(names) : null;
|
|
33
|
+
}
|
|
34
|
+
register(tool) {
|
|
35
|
+
if (this.tools.has(tool.name)) {
|
|
36
|
+
throw new Error(`Tool already registered: ${tool.name}`);
|
|
37
|
+
}
|
|
38
|
+
this.tools.set(tool.name, tool);
|
|
39
|
+
}
|
|
40
|
+
list() {
|
|
41
|
+
const all = [...this.tools.values()].sort((a, b) => a.name.localeCompare(b.name));
|
|
42
|
+
return this.allowedToolNames ? all.filter(t => this.allowedToolNames.has(t.name)) : all;
|
|
43
|
+
}
|
|
44
|
+
get(name) {
|
|
45
|
+
if (this.allowedToolNames && !this.allowedToolNames.has(name))
|
|
46
|
+
return undefined;
|
|
47
|
+
return this.tools.get(name);
|
|
48
|
+
}
|
|
49
|
+
async run(name, rawInput, context) {
|
|
50
|
+
const tool = this.get(name);
|
|
51
|
+
if (!tool) {
|
|
52
|
+
throw new Error(`Unknown tool: ${name}`);
|
|
53
|
+
}
|
|
54
|
+
// Org policy — tool-level denylist (before any side effect or permission check).
|
|
55
|
+
const toolDecision = checkTool(context.policy, name);
|
|
56
|
+
if (!toolDecision.allowed) {
|
|
57
|
+
this.denyByPolicy(context, name, toolDecision.rule, name);
|
|
58
|
+
}
|
|
59
|
+
assertToolPermission(tool.access, context);
|
|
60
|
+
const input = tool.inputSchema.parse(rawInput);
|
|
61
|
+
// Org policy — per-target command/path checks, evaluated before the tool runs.
|
|
62
|
+
for (const target of tool.policyTargets?.(input) ?? []) {
|
|
63
|
+
const decision = target.kind === 'command' ? checkCommand(context.policy, target.value) : checkPath(context.policy, target.value);
|
|
64
|
+
if (!decision.allowed) {
|
|
65
|
+
this.denyByPolicy(context, name, decision.rule, target.value, target.kind === 'command' ? minimizedDescriptor(target.value) : target.value);
|
|
66
|
+
}
|
|
67
|
+
}
|
|
68
|
+
// In auto-edit mode every non-read tool requires explicit user approval
|
|
69
|
+
if (context.approvalMode === 'auto-edit' && tool.access !== 'read' && context.requestApproval) {
|
|
70
|
+
const approvalId = `apv_${Date.now()}_${randomUUID().replace(/-/g, '').slice(0, 12)}`;
|
|
71
|
+
const approved = await context.requestApproval(approvalId, name, input);
|
|
72
|
+
context.audit?.append({ type: 'approval', toolName: name, approved });
|
|
73
|
+
if (!approved) {
|
|
74
|
+
throw new Error(`User rejected: ${name}`);
|
|
75
|
+
}
|
|
76
|
+
}
|
|
77
|
+
// Audit tap: time the call, emit tool_call + a derived file_*/shell_exec event.
|
|
78
|
+
// All taps are no-ops when no audit sink is attached to the context.
|
|
79
|
+
const started = Date.now();
|
|
80
|
+
try {
|
|
81
|
+
const result = await tool.run(input, context);
|
|
82
|
+
emitToolAudit(context, tool.access, name, input, result, 'ok', Date.now() - started);
|
|
83
|
+
return result;
|
|
84
|
+
}
|
|
85
|
+
catch (err) {
|
|
86
|
+
emitToolAudit(context, tool.access, name, input, undefined, 'error', Date.now() - started);
|
|
87
|
+
throw err;
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
/** Record a policy denial in the audit trail and throw a structured error. */
|
|
91
|
+
denyByPolicy(context, tool, rule, target, auditTarget = target) {
|
|
92
|
+
context.audit?.append({ type: 'policy_violation', rule, tool, target: auditTarget });
|
|
93
|
+
throw new PolicyViolationError(tool, rule, target);
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
export function createDefaultToolRegistry() {
|
|
97
|
+
const registry = new ToolRegistry();
|
|
98
|
+
registry.register(editFileTool);
|
|
99
|
+
registry.register(gitDiffTool);
|
|
100
|
+
registry.register(gitStatusTool);
|
|
101
|
+
registry.register(listFilesTool);
|
|
102
|
+
registry.register(listRemediationCasesTool);
|
|
103
|
+
registry.register(listSkillsTool);
|
|
104
|
+
registry.register(memoryDeleteTool);
|
|
105
|
+
registry.register(memoryImportTool);
|
|
106
|
+
registry.register(memorySearchTool);
|
|
107
|
+
registry.register(memoryUpdateTool);
|
|
108
|
+
registry.register(memoryWriteTool);
|
|
109
|
+
registry.register(prepareRemediationWorktreeTool);
|
|
110
|
+
registry.register(projectScriptsTool);
|
|
111
|
+
registry.register(readFileTool);
|
|
112
|
+
registry.register(readSkillTool);
|
|
113
|
+
registry.register(runCheckTool);
|
|
114
|
+
registry.register(runSecurityScanTool);
|
|
115
|
+
registry.register(searchTextTool);
|
|
116
|
+
registry.register(shellTool);
|
|
117
|
+
registry.register(writeFileTool);
|
|
118
|
+
registry.register(deleteFileTool);
|
|
119
|
+
return registry;
|
|
120
|
+
}
|
|
121
|
+
//# sourceMappingURL=registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import type { Tool } from './types.js';
|
|
3
|
+
declare const inputSchema: z.ZodObject<{
|
|
4
|
+
kind: z.ZodEnum<{
|
|
5
|
+
custom: "custom";
|
|
6
|
+
test: "test";
|
|
7
|
+
typecheck: "typecheck";
|
|
8
|
+
build: "build";
|
|
9
|
+
lint: "lint";
|
|
10
|
+
}>;
|
|
11
|
+
command: z.ZodOptional<z.ZodString>;
|
|
12
|
+
args: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
13
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
14
|
+
}, z.core.$strict>;
|
|
15
|
+
type Input = z.infer<typeof inputSchema>;
|
|
16
|
+
export declare const runCheckTool: Tool<Input>;
|
|
17
|
+
export {};
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import { stat } from 'node:fs/promises';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { z } from 'zod';
|
|
4
|
+
import { detectScripts } from './projectScripts.js';
|
|
5
|
+
import { checkCommand, PolicyViolationError } from '../core/policy.js';
|
|
6
|
+
import { runGovernedProcess } from '../core/subprocessSandbox.js';
|
|
7
|
+
import { minimizedDescriptor } from '../audit/minimize.js';
|
|
8
|
+
const inputSchema = z
|
|
9
|
+
.object({
|
|
10
|
+
kind: z.enum(['test', 'typecheck', 'build', 'lint', 'custom']),
|
|
11
|
+
command: z.string().min(1).optional(),
|
|
12
|
+
args: z.array(z.string()).default([]),
|
|
13
|
+
timeoutMs: z.number().int().positive().max(120_000).default(60_000),
|
|
14
|
+
})
|
|
15
|
+
.strict();
|
|
16
|
+
export const runCheckTool = {
|
|
17
|
+
name: 'run_check',
|
|
18
|
+
description: 'Run a project check such as test, typecheck, build, or lint with structured output. Prefer this over shell for standard validation.',
|
|
19
|
+
access: 'execute',
|
|
20
|
+
inputSchema,
|
|
21
|
+
isConcurrencySafe: () => false,
|
|
22
|
+
isUndoable: () => false,
|
|
23
|
+
async run(input, context) {
|
|
24
|
+
const picked = input.kind === 'custom'
|
|
25
|
+
? pickCustom(input)
|
|
26
|
+
: await pickProjectCheck(context.cwd, input.kind, input.args);
|
|
27
|
+
if (!picked) {
|
|
28
|
+
return {
|
|
29
|
+
title: 'run_check',
|
|
30
|
+
output: `No ${input.kind} script detected. Use project_scripts to inspect available commands, or run_check kind=custom with an explicit command.`,
|
|
31
|
+
metadata: { kind: input.kind, skipped: true },
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
const commandLine = [picked.command, ...picked.args].join(' ');
|
|
35
|
+
const commandDecision = checkCommand(context.policy, commandLine);
|
|
36
|
+
if (!commandDecision.allowed) {
|
|
37
|
+
context.audit?.append({
|
|
38
|
+
type: 'policy_violation',
|
|
39
|
+
rule: commandDecision.rule,
|
|
40
|
+
tool: 'run_check',
|
|
41
|
+
target: minimizedDescriptor(commandLine),
|
|
42
|
+
});
|
|
43
|
+
throw new PolicyViolationError('run_check', commandDecision.rule, commandLine);
|
|
44
|
+
}
|
|
45
|
+
const result = await runGovernedProcess({
|
|
46
|
+
command: picked.command,
|
|
47
|
+
args: picked.args,
|
|
48
|
+
cwd: context.cwd,
|
|
49
|
+
timeoutMs: input.timeoutMs,
|
|
50
|
+
policy: context.policy,
|
|
51
|
+
audit: context.audit,
|
|
52
|
+
toolName: 'run_check',
|
|
53
|
+
preferSandboxWhenUnrestricted: true,
|
|
54
|
+
});
|
|
55
|
+
return {
|
|
56
|
+
title: `run_check ${input.kind}`,
|
|
57
|
+
output: result.output || '(no output)',
|
|
58
|
+
metadata: {
|
|
59
|
+
kind: input.kind,
|
|
60
|
+
command: picked.command,
|
|
61
|
+
args: picked.args,
|
|
62
|
+
argsCount: picked.args.length,
|
|
63
|
+
exitCode: result.exitCode,
|
|
64
|
+
timedOut: result.timedOut,
|
|
65
|
+
sandbox: result.sandbox,
|
|
66
|
+
networkEnforcement: result.sandbox === 'none' ? 'unrestricted' : 'enforced',
|
|
67
|
+
},
|
|
68
|
+
};
|
|
69
|
+
},
|
|
70
|
+
};
|
|
71
|
+
function pickCustom(input) {
|
|
72
|
+
if (!input.command)
|
|
73
|
+
return null;
|
|
74
|
+
return { command: input.command, args: input.args };
|
|
75
|
+
}
|
|
76
|
+
async function pickProjectCheck(cwd, kind, extraArgs) {
|
|
77
|
+
const scripts = await detectScripts(cwd);
|
|
78
|
+
const scriptNames = preferredScriptNames(kind);
|
|
79
|
+
const script = scripts.find(s => s.source === 'package.json' && scriptNames.includes(s.name));
|
|
80
|
+
if (script) {
|
|
81
|
+
const pm = await detectPackageManager(cwd);
|
|
82
|
+
return pm === 'yarn'
|
|
83
|
+
? { command: 'yarn', args: [script.name, ...extraArgs] }
|
|
84
|
+
: { command: pm, args: ['run', script.name, ...extraArgs] };
|
|
85
|
+
}
|
|
86
|
+
if (kind === 'test' && await exists(path.join(cwd, 'pyproject.toml'))) {
|
|
87
|
+
return { command: 'pytest', args: extraArgs };
|
|
88
|
+
}
|
|
89
|
+
if (kind === 'build' && scripts.some(s => s.source === 'Makefile' && s.name === 'build')) {
|
|
90
|
+
return { command: 'make', args: ['build', ...extraArgs] };
|
|
91
|
+
}
|
|
92
|
+
if (kind === 'test' && scripts.some(s => s.source === 'Makefile' && s.name === 'test')) {
|
|
93
|
+
return { command: 'make', args: ['test', ...extraArgs] };
|
|
94
|
+
}
|
|
95
|
+
return null;
|
|
96
|
+
}
|
|
97
|
+
function preferredScriptNames(kind) {
|
|
98
|
+
switch (kind) {
|
|
99
|
+
case 'test':
|
|
100
|
+
return ['test', 'test:unit'];
|
|
101
|
+
case 'typecheck':
|
|
102
|
+
return ['typecheck', 'type-check', 'check:types', 'tsc'];
|
|
103
|
+
case 'build':
|
|
104
|
+
return ['build'];
|
|
105
|
+
case 'lint':
|
|
106
|
+
return ['lint'];
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
async function detectPackageManager(cwd) {
|
|
110
|
+
if (await exists(path.join(cwd, 'pnpm-lock.yaml')))
|
|
111
|
+
return 'pnpm';
|
|
112
|
+
if (await exists(path.join(cwd, 'yarn.lock')))
|
|
113
|
+
return 'yarn';
|
|
114
|
+
return 'npm';
|
|
115
|
+
}
|
|
116
|
+
async function exists(filePath) {
|
|
117
|
+
try {
|
|
118
|
+
await stat(filePath);
|
|
119
|
+
return true;
|
|
120
|
+
}
|
|
121
|
+
catch {
|
|
122
|
+
return false;
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
//# sourceMappingURL=runCheck.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runCheck.js","sourceRoot":"","sources":["../../src/tools/runCheck.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import type { Tool } from './types.js';
|
|
3
|
+
declare const inputSchema: z.ZodObject<{
|
|
4
|
+
persistCases: z.ZodDefault<z.ZodBoolean>;
|
|
5
|
+
}, z.core.$strict>;
|
|
6
|
+
type Input = z.infer<typeof inputSchema>;
|
|
7
|
+
export declare const runSecurityScanTool: Tool<Input>;
|
|
8
|
+
export {};
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { runLocalSecurityScan } from '../remediation/localScan.js';
|
|
3
|
+
import { upsertRemediationCases } from '../remediation/cases.js';
|
|
4
|
+
const inputSchema = z.object({
|
|
5
|
+
persistCases: z.boolean().default(true),
|
|
6
|
+
}).strict();
|
|
7
|
+
export const runSecurityScanTool = {
|
|
8
|
+
name: 'run_security_scan',
|
|
9
|
+
description: 'Run DvalinCode local security scan on the current workspace and optionally persist findings as remediation cases.',
|
|
10
|
+
access: 'write',
|
|
11
|
+
inputSchema,
|
|
12
|
+
isConcurrencySafe: () => false,
|
|
13
|
+
async run(input, context) {
|
|
14
|
+
const result = await runLocalSecurityScan(context.cwd);
|
|
15
|
+
const cases = input.persistCases && result.findings.length
|
|
16
|
+
? await upsertRemediationCases({ cwd: context.cwd, findings: result.findings })
|
|
17
|
+
: [];
|
|
18
|
+
return {
|
|
19
|
+
title: 'Security scan',
|
|
20
|
+
output: result.findings.length
|
|
21
|
+
? result.findings.map((finding, index) => [
|
|
22
|
+
`${index + 1}. ${finding.ruleId} (${finding.securitySeverity ?? finding.severity})`,
|
|
23
|
+
` ${finding.path}${finding.startLine ? `:${finding.startLine}` : ''}`,
|
|
24
|
+
` ${finding.message}`,
|
|
25
|
+
].join('\n')).join('\n')
|
|
26
|
+
: 'No actionable security findings found.',
|
|
27
|
+
metadata: {
|
|
28
|
+
totalResults: result.totalResults,
|
|
29
|
+
skippedResults: result.skippedResults,
|
|
30
|
+
findings: result.findings,
|
|
31
|
+
cases,
|
|
32
|
+
},
|
|
33
|
+
};
|
|
34
|
+
},
|
|
35
|
+
};
|
|
36
|
+
//# sourceMappingURL=runSecurityScan.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runSecurityScan.js","sourceRoot":"","sources":["../../src/tools/runSecurityScan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAGjE,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACxC,CAAC,CAAC,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,MAAM,mBAAmB,GAAgB;IAC9C,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,mHAAmH;IAChI,MAAM,EAAE,OAAO;IACf,WAAW;IACX,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK;IAC9B,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO;QACtB,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM;YACxD,CAAC,CAAC,MAAM,sBAAsB,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC/E,CAAC,CAAC,EAAE,CAAC;QACP,OAAO;YACL,KAAK,EAAE,eAAe;YACtB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;gBAC5B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;oBACtC,GAAG,KAAK,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,QAAQ,GAAG;oBACnF,MAAM,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;oBACvE,MAAM,OAAO,CAAC,OAAO,EAAE;iBACxB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC1B,CAAC,CAAC,wCAAwC;YAC5C,QAAQ,EAAE;gBACR,YAAY,EAAE,MAAM,CAAC,YAAY;gBACjC,cAAc,EAAE,MAAM,CAAC,cAAc;gBACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,KAAK;aACN;SACF,CAAC;IACJ,CAAC;CACF,CAAC"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import type { Tool } from './types.js';
|
|
3
|
+
declare const inputSchema: z.ZodObject<{
|
|
4
|
+
query: z.ZodString;
|
|
5
|
+
pattern: z.ZodDefault<z.ZodString>;
|
|
6
|
+
caseSensitive: z.ZodDefault<z.ZodBoolean>;
|
|
7
|
+
limit: z.ZodDefault<z.ZodNumber>;
|
|
8
|
+
}, z.core.$strict>;
|
|
9
|
+
type Input = z.infer<typeof inputSchema>;
|
|
10
|
+
export declare const searchTextTool: Tool<Input>;
|
|
11
|
+
export {};
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
import { readFile } from 'node:fs/promises';
|
|
2
|
+
import fg from 'fast-glob';
|
|
3
|
+
import { z } from 'zod';
|
|
4
|
+
import { resolveInsideWorkspace } from '../core/workspace.js';
|
|
5
|
+
import { loadIgnorePatterns } from '../core/ignorefile.js';
|
|
6
|
+
const inputSchema = z
|
|
7
|
+
.object({
|
|
8
|
+
query: z.string().min(1),
|
|
9
|
+
pattern: z.string().default('**/*'),
|
|
10
|
+
caseSensitive: z.boolean().default(false),
|
|
11
|
+
limit: z.number().int().positive().max(500).default(50),
|
|
12
|
+
})
|
|
13
|
+
.strict();
|
|
14
|
+
export const searchTextTool = {
|
|
15
|
+
name: 'search_text',
|
|
16
|
+
description: 'Search text files in the workspace and return matching lines.',
|
|
17
|
+
access: 'read',
|
|
18
|
+
inputSchema,
|
|
19
|
+
isConcurrencySafe: () => true,
|
|
20
|
+
async run(input, context) {
|
|
21
|
+
const userIgnore = await loadIgnorePatterns(context.cwd);
|
|
22
|
+
const files = await fg(input.pattern, {
|
|
23
|
+
cwd: context.cwd,
|
|
24
|
+
dot: true,
|
|
25
|
+
onlyFiles: true,
|
|
26
|
+
followSymbolicLinks: false,
|
|
27
|
+
ignore: ['**/.git/**', '**/node_modules/**', '**/dist/**', '**/coverage/**', ...userIgnore],
|
|
28
|
+
});
|
|
29
|
+
const needle = input.caseSensitive ? input.query : input.query.toLowerCase();
|
|
30
|
+
const matches = [];
|
|
31
|
+
for (const file of files.sort()) {
|
|
32
|
+
if (matches.length >= input.limit)
|
|
33
|
+
break;
|
|
34
|
+
const filePath = await resolveInsideWorkspace(context.cwd, file);
|
|
35
|
+
const text = await readMaybeText(filePath);
|
|
36
|
+
if (text === null)
|
|
37
|
+
continue;
|
|
38
|
+
const lines = text.split(/\r?\n/);
|
|
39
|
+
for (let index = 0; index < lines.length; index += 1) {
|
|
40
|
+
const haystack = input.caseSensitive ? lines[index] : lines[index].toLowerCase();
|
|
41
|
+
if (haystack.includes(needle)) {
|
|
42
|
+
matches.push(`${file}:${index + 1}: ${lines[index]}`);
|
|
43
|
+
if (matches.length >= input.limit)
|
|
44
|
+
break;
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
return {
|
|
49
|
+
title: `Found ${matches.length} match${matches.length === 1 ? '' : 'es'}`,
|
|
50
|
+
output: matches.join('\n') || '(no matches)',
|
|
51
|
+
metadata: {
|
|
52
|
+
scannedFiles: files.length,
|
|
53
|
+
limit: input.limit,
|
|
54
|
+
},
|
|
55
|
+
};
|
|
56
|
+
},
|
|
57
|
+
};
|
|
58
|
+
async function readMaybeText(filePath) {
|
|
59
|
+
try {
|
|
60
|
+
const text = await readFile(filePath, 'utf8');
|
|
61
|
+
return text.includes('\u0000') ? null : text;
|
|
62
|
+
}
|
|
63
|
+
catch {
|
|
64
|
+
return null;
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
//# sourceMappingURL=searchText.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"searchText.js","sourceRoot":"","sources":["../../src/tools/searchText.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import type { Tool } from './types.js';
|
|
3
|
+
declare const inputSchema: z.ZodObject<{
|
|
4
|
+
command: z.ZodString;
|
|
5
|
+
args: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
6
|
+
timeoutMs: z.ZodDefault<z.ZodNumber>;
|
|
7
|
+
networkAccess: z.ZodDefault<z.ZodEnum<{
|
|
8
|
+
unrestricted: "unrestricted";
|
|
9
|
+
auto: "auto";
|
|
10
|
+
sandboxed: "sandboxed";
|
|
11
|
+
}>>;
|
|
12
|
+
}, z.core.$strict>;
|
|
13
|
+
type Input = z.infer<typeof inputSchema>;
|
|
14
|
+
export declare const shellTool: Tool<Input>;
|
|
15
|
+
export declare function isGitNetworkCommand(command: string, args: string[]): boolean;
|
|
16
|
+
export {};
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
import path from 'node:path';
|
|
2
|
+
import { randomUUID } from 'node:crypto';
|
|
3
|
+
import { z } from 'zod';
|
|
4
|
+
import { runGovernedProcess } from '../core/subprocessSandbox.js';
|
|
5
|
+
const inputSchema = z
|
|
6
|
+
.object({
|
|
7
|
+
command: z.string().min(1),
|
|
8
|
+
args: z.array(z.string()).default([]),
|
|
9
|
+
timeoutMs: z.number().int().positive().max(60_000).default(10_000),
|
|
10
|
+
networkAccess: z
|
|
11
|
+
.enum(['auto', 'sandboxed', 'unrestricted'])
|
|
12
|
+
.default('auto')
|
|
13
|
+
.describe('Use unrestricted only for commands that need outbound network access, such as git pull/push/fetch/clone or package downloads.'),
|
|
14
|
+
})
|
|
15
|
+
.strict();
|
|
16
|
+
export const shellTool = {
|
|
17
|
+
name: 'shell',
|
|
18
|
+
description: 'Run a process in the workspace. Use networkAccess=unrestricted for commands that need outbound network access; Git pull/push/fetch/clone can request this automatically.',
|
|
19
|
+
access: 'execute',
|
|
20
|
+
inputSchema,
|
|
21
|
+
isConcurrencySafe: () => false,
|
|
22
|
+
policyTargets: input => [{ kind: 'command', value: [input.command, ...input.args].join(' ') }],
|
|
23
|
+
async run(input, context) {
|
|
24
|
+
const skipNetworkSandbox = await shouldSkipNetworkSandbox(input, context);
|
|
25
|
+
const result = await runGovernedProcess({
|
|
26
|
+
command: input.command,
|
|
27
|
+
args: input.args,
|
|
28
|
+
cwd: context.cwd,
|
|
29
|
+
timeoutMs: input.timeoutMs,
|
|
30
|
+
policy: context.policy,
|
|
31
|
+
audit: context.audit,
|
|
32
|
+
toolName: 'shell',
|
|
33
|
+
preferSandboxWhenUnrestricted: true,
|
|
34
|
+
skipNetworkSandboxWhenPolicyAllows: skipNetworkSandbox,
|
|
35
|
+
});
|
|
36
|
+
return {
|
|
37
|
+
title: `Ran ${input.command}`,
|
|
38
|
+
output: result.output || '(no output)',
|
|
39
|
+
metadata: {
|
|
40
|
+
command: input.command,
|
|
41
|
+
argsCount: input.args.length,
|
|
42
|
+
exitCode: result.exitCode,
|
|
43
|
+
timedOut: result.timedOut,
|
|
44
|
+
sandbox: result.sandbox,
|
|
45
|
+
networkAccess: result.sandbox === 'none' ? 'unrestricted' : 'sandboxed',
|
|
46
|
+
sandboxBypass: skipNetworkSandbox,
|
|
47
|
+
networkEnforcement: result.sandbox === 'none' ? 'unrestricted' : 'enforced',
|
|
48
|
+
},
|
|
49
|
+
};
|
|
50
|
+
},
|
|
51
|
+
};
|
|
52
|
+
async function shouldSkipNetworkSandbox(input, context) {
|
|
53
|
+
if (input.networkAccess === 'sandboxed')
|
|
54
|
+
return false;
|
|
55
|
+
if (context.approvalMode === 'bypass') {
|
|
56
|
+
return true;
|
|
57
|
+
}
|
|
58
|
+
const wantsUnrestricted = input.networkAccess === 'unrestricted' ||
|
|
59
|
+
(input.networkAccess === 'auto' && isGitNetworkCommand(input.command, input.args));
|
|
60
|
+
if (!wantsUnrestricted)
|
|
61
|
+
return false;
|
|
62
|
+
if (!context.requestApproval)
|
|
63
|
+
return false;
|
|
64
|
+
const approved = await context.requestApproval(`apv_sandbox_${Date.now()}_${randomUUID().replace(/-/g, '').slice(0, 12)}`, 'shell_sandbox_bypass', {
|
|
65
|
+
command: input.command,
|
|
66
|
+
args: input.args,
|
|
67
|
+
cwd: context.cwd,
|
|
68
|
+
networkAccess: 'unrestricted',
|
|
69
|
+
reason: isGitNetworkCommand(input.command, input.args)
|
|
70
|
+
? 'Git network operations need outbound access and usually fail inside the local subprocess network sandbox.'
|
|
71
|
+
: 'This command requested unrestricted outbound network access.',
|
|
72
|
+
});
|
|
73
|
+
context.audit?.append({ type: 'approval', toolName: 'shell_sandbox_bypass', approved });
|
|
74
|
+
if (!approved) {
|
|
75
|
+
throw new Error('User rejected unrestricted network access for shell');
|
|
76
|
+
}
|
|
77
|
+
return true;
|
|
78
|
+
}
|
|
79
|
+
export function isGitNetworkCommand(command, args) {
|
|
80
|
+
if (path.basename(command).toLowerCase() !== 'git')
|
|
81
|
+
return false;
|
|
82
|
+
const subcommand = findGitSubcommand(args);
|
|
83
|
+
if (!subcommand)
|
|
84
|
+
return false;
|
|
85
|
+
if (['clone', 'fetch', 'pull', 'push'].includes(subcommand.name))
|
|
86
|
+
return true;
|
|
87
|
+
if (subcommand.name === 'remote' && args.slice(subcommand.index + 1).includes('update'))
|
|
88
|
+
return true;
|
|
89
|
+
if (subcommand.name === 'submodule' && args.slice(subcommand.index + 1).includes('update'))
|
|
90
|
+
return true;
|
|
91
|
+
if (subcommand.name === 'lfs') {
|
|
92
|
+
return args.slice(subcommand.index + 1).some(arg => ['fetch', 'pull', 'push'].includes(arg));
|
|
93
|
+
}
|
|
94
|
+
return false;
|
|
95
|
+
}
|
|
96
|
+
function findGitSubcommand(args) {
|
|
97
|
+
for (let i = 0; i < args.length; i++) {
|
|
98
|
+
const arg = args[i] ?? '';
|
|
99
|
+
if (!arg)
|
|
100
|
+
continue;
|
|
101
|
+
if (arg === '-C' || arg === '-c' || arg === '--git-dir' || arg === '--work-tree' || arg === '--namespace') {
|
|
102
|
+
i++;
|
|
103
|
+
continue;
|
|
104
|
+
}
|
|
105
|
+
if (arg.startsWith('--git-dir=') || arg.startsWith('--work-tree=') || arg.startsWith('--namespace=')) {
|
|
106
|
+
continue;
|
|
107
|
+
}
|
|
108
|
+
if (arg.startsWith('-'))
|
|
109
|
+
continue;
|
|
110
|
+
return { name: arg.toLowerCase(), index: i };
|
|
111
|
+
}
|
|
112
|
+
return null;
|
|
113
|
+
}
|
|
114
|
+
//# sourceMappingURL=shell.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"shell.js","sourceRoot":"","sources":["../../src/tools/shell.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import type { z } from 'zod';
|
|
2
|
+
import type { DvalinContext } from '../core/context.js';
|
|
3
|
+
export type ToolAccess = 'read' | 'write' | 'execute';
|
|
4
|
+
/**
|
|
5
|
+
* A policy-relevant aspect of a tool call, surfaced for org-policy enforcement
|
|
6
|
+
* (see src/core/policy.ts). A tool declares its targets so the registry can check
|
|
7
|
+
* them against the resolved policy at one chokepoint — without the registry needing
|
|
8
|
+
* to know each tool's input shape.
|
|
9
|
+
*/
|
|
10
|
+
export type PolicyTarget = {
|
|
11
|
+
kind: 'command';
|
|
12
|
+
value: string;
|
|
13
|
+
} | {
|
|
14
|
+
kind: 'path';
|
|
15
|
+
value: string;
|
|
16
|
+
};
|
|
17
|
+
export type ToolResult = {
|
|
18
|
+
title: string;
|
|
19
|
+
output: string;
|
|
20
|
+
metadata?: Record<string, unknown>;
|
|
21
|
+
};
|
|
22
|
+
export type Tool<Input> = {
|
|
23
|
+
name: string;
|
|
24
|
+
description: string;
|
|
25
|
+
access: ToolAccess;
|
|
26
|
+
inputSchema: z.ZodType<Input>;
|
|
27
|
+
/**
|
|
28
|
+
* Pre-computed JSON Schema for the LLM's tool parameters. When set, it is used
|
|
29
|
+
* instead of deriving one from `inputSchema` — e.g. MCP tools carry their
|
|
30
|
+
* server's native input schema rather than a DvalinCode-authored zod type.
|
|
31
|
+
*/
|
|
32
|
+
parametersSchema?: Record<string, unknown>;
|
|
33
|
+
isConcurrencySafe?: (input: Input) => boolean;
|
|
34
|
+
run(input: Input, context: DvalinContext): Promise<ToolResult>;
|
|
35
|
+
/**
|
|
36
|
+
* Policy-relevant targets of this call (commands run, paths touched), checked
|
|
37
|
+
* against the org policy before the tool runs. Omit when the tool has none.
|
|
38
|
+
*/
|
|
39
|
+
policyTargets?: (input: Input) => PolicyTarget[];
|
|
40
|
+
/** Whether this tool can be undone. If false, undo is not supported. */
|
|
41
|
+
isUndoable?: (input: Input) => boolean;
|
|
42
|
+
/**
|
|
43
|
+
* Compute the reverse operation input for an undo.
|
|
44
|
+
* Returns the input that would reverse the effect (e.g., swap old/new strings).
|
|
45
|
+
* If undo is not possible after the fact, return undefined.
|
|
46
|
+
* Called only if isUndoable() returned true.
|
|
47
|
+
*/
|
|
48
|
+
reverse?: (input: Input, result: ToolResult) => ReverseOp | undefined;
|
|
49
|
+
};
|
|
50
|
+
export type ReverseOp = {
|
|
51
|
+
/** Tool name to run for the reversal (usually same tool) */
|
|
52
|
+
toolName: string;
|
|
53
|
+
/** Input for the reverse tool call */
|
|
54
|
+
input: unknown;
|
|
55
|
+
/** Human-readable description of the undo action */
|
|
56
|
+
description: string;
|
|
57
|
+
};
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import type { Tool } from './types.js';
|
|
3
|
+
declare const inputSchema: z.ZodObject<{
|
|
4
|
+
filePath: z.ZodString;
|
|
5
|
+
content: z.ZodString;
|
|
6
|
+
}, z.core.$strict>;
|
|
7
|
+
type Input = z.infer<typeof inputSchema>;
|
|
8
|
+
export declare const writeFileTool: Tool<Input>;
|
|
9
|
+
export {};
|