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.
Files changed (317) hide show
  1. package/LICENSE +22 -0
  2. package/README.md +649 -0
  3. package/README.zh-CN.md +623 -0
  4. package/THIRD_PARTY_NOTICES.md +432 -0
  5. package/dist/agent/compact.d.ts +4 -0
  6. package/dist/agent/compact.js +40 -0
  7. package/dist/agent/compact.js.map +1 -0
  8. package/dist/agent/loop.d.ts +44 -0
  9. package/dist/agent/loop.js +262 -0
  10. package/dist/agent/loop.js.map +1 -0
  11. package/dist/agent/modes.d.ts +13 -0
  12. package/dist/agent/modes.js +44 -0
  13. package/dist/agent/modes.js.map +1 -0
  14. package/dist/agent/runner.d.ts +37 -0
  15. package/dist/agent/runner.js +171 -0
  16. package/dist/agent/runner.js.map +1 -0
  17. package/dist/agent/session.d.ts +73 -0
  18. package/dist/agent/session.js +282 -0
  19. package/dist/agent/session.js.map +1 -0
  20. package/dist/agent/types.d.ts +86 -0
  21. package/dist/agent/types.js +26 -0
  22. package/dist/agent/types.js.map +1 -0
  23. package/dist/audit/diffStat.d.ts +8 -0
  24. package/dist/audit/diffStat.js +17 -0
  25. package/dist/audit/diffStat.js.map +1 -0
  26. package/dist/audit/hash.d.ts +10 -0
  27. package/dist/audit/hash.js +33 -0
  28. package/dist/audit/hash.js.map +1 -0
  29. package/dist/audit/log.d.ts +147 -0
  30. package/dist/audit/log.js +163 -0
  31. package/dist/audit/log.js.map +1 -0
  32. package/dist/audit/minimize.d.ts +10 -0
  33. package/dist/audit/minimize.js +61 -0
  34. package/dist/audit/minimize.js.map +1 -0
  35. package/dist/audit/report.d.ts +8 -0
  36. package/dist/audit/report.js +113 -0
  37. package/dist/audit/report.js.map +1 -0
  38. package/dist/audit/taps.d.ts +8 -0
  39. package/dist/audit/taps.js +67 -0
  40. package/dist/audit/taps.js.map +1 -0
  41. package/dist/cli.d.ts +3 -0
  42. package/dist/cli.js +56 -0
  43. package/dist/cli.js.map +1 -0
  44. package/dist/commands/ask.d.ts +3 -0
  45. package/dist/commands/ask.js +14 -0
  46. package/dist/commands/ask.js.map +1 -0
  47. package/dist/commands/chat.d.ts +3 -0
  48. package/dist/commands/chat.js +148 -0
  49. package/dist/commands/chat.js.map +1 -0
  50. package/dist/commands/data.d.ts +2 -0
  51. package/dist/commands/data.js +65 -0
  52. package/dist/commands/data.js.map +1 -0
  53. package/dist/commands/evidence.d.ts +2 -0
  54. package/dist/commands/evidence.js +50 -0
  55. package/dist/commands/evidence.js.map +1 -0
  56. package/dist/commands/init.d.ts +2 -0
  57. package/dist/commands/init.js +18 -0
  58. package/dist/commands/init.js.map +1 -0
  59. package/dist/commands/memory.d.ts +2 -0
  60. package/dist/commands/memory.js +74 -0
  61. package/dist/commands/memory.js.map +1 -0
  62. package/dist/commands/policy.d.ts +2 -0
  63. package/dist/commands/policy.js +95 -0
  64. package/dist/commands/policy.js.map +1 -0
  65. package/dist/commands/provider.d.ts +2 -0
  66. package/dist/commands/provider.js +130 -0
  67. package/dist/commands/provider.js.map +1 -0
  68. package/dist/commands/report.d.ts +2 -0
  69. package/dist/commands/report.js +47 -0
  70. package/dist/commands/report.js.map +1 -0
  71. package/dist/commands/runTool.d.ts +3 -0
  72. package/dist/commands/runTool.js +41 -0
  73. package/dist/commands/runTool.js.map +1 -0
  74. package/dist/commands/scan.d.ts +2 -0
  75. package/dist/commands/scan.js +15 -0
  76. package/dist/commands/scan.js.map +1 -0
  77. package/dist/commands/serve.d.ts +2 -0
  78. package/dist/commands/serve.js +18 -0
  79. package/dist/commands/serve.js.map +1 -0
  80. package/dist/commands/tools.d.ts +3 -0
  81. package/dist/commands/tools.js +11 -0
  82. package/dist/commands/tools.js.map +1 -0
  83. package/dist/commands/trust.d.ts +2 -0
  84. package/dist/commands/trust.js +16 -0
  85. package/dist/commands/trust.js.map +1 -0
  86. package/dist/commands/tui.d.ts +2 -0
  87. package/dist/commands/tui.js +13 -0
  88. package/dist/commands/tui.js.map +1 -0
  89. package/dist/core/context.d.ts +28 -0
  90. package/dist/core/context.js +29 -0
  91. package/dist/core/context.js.map +1 -0
  92. package/dist/core/diffPreview.d.ts +6 -0
  93. package/dist/core/diffPreview.js +37 -0
  94. package/dist/core/diffPreview.js.map +1 -0
  95. package/dist/core/ignorefile.d.ts +1 -0
  96. package/dist/core/ignorefile.js +14 -0
  97. package/dist/core/ignorefile.js.map +1 -0
  98. package/dist/core/permissions.d.ts +3 -0
  99. package/dist/core/permissions.js +9 -0
  100. package/dist/core/permissions.js.map +1 -0
  101. package/dist/core/policy.d.ts +182 -0
  102. package/dist/core/policy.js +358 -0
  103. package/dist/core/policy.js.map +1 -0
  104. package/dist/core/projectScanner.d.ts +12 -0
  105. package/dist/core/projectScanner.js +85 -0
  106. package/dist/core/projectScanner.js.map +1 -0
  107. package/dist/core/subprocessSandbox.d.ts +42 -0
  108. package/dist/core/subprocessSandbox.js +132 -0
  109. package/dist/core/subprocessSandbox.js.map +1 -0
  110. package/dist/core/trust.d.ts +50 -0
  111. package/dist/core/trust.js +191 -0
  112. package/dist/core/trust.js.map +1 -0
  113. package/dist/core/workspace.d.ts +9 -0
  114. package/dist/core/workspace.js +55 -0
  115. package/dist/core/workspace.js.map +1 -0
  116. package/dist/data/archive.d.ts +39 -0
  117. package/dist/data/archive.js +127 -0
  118. package/dist/data/archive.js.map +1 -0
  119. package/dist/evidence/compliance.d.ts +22 -0
  120. package/dist/evidence/compliance.js +57 -0
  121. package/dist/evidence/compliance.js.map +1 -0
  122. package/dist/evidence/pack.d.ts +56 -0
  123. package/dist/evidence/pack.js +123 -0
  124. package/dist/evidence/pack.js.map +1 -0
  125. package/dist/index.d.ts +2 -0
  126. package/dist/index.js +8 -0
  127. package/dist/index.js.map +1 -0
  128. package/dist/mcp/client.d.ts +45 -0
  129. package/dist/mcp/client.js +111 -0
  130. package/dist/mcp/client.js.map +1 -0
  131. package/dist/mcp/config.d.ts +10 -0
  132. package/dist/mcp/config.js +18 -0
  133. package/dist/mcp/config.js.map +1 -0
  134. package/dist/mcp/governedFetch.d.ts +16 -0
  135. package/dist/mcp/governedFetch.js +44 -0
  136. package/dist/mcp/governedFetch.js.map +1 -0
  137. package/dist/mcp/register.d.ts +26 -0
  138. package/dist/mcp/register.js +77 -0
  139. package/dist/mcp/register.js.map +1 -0
  140. package/dist/memory/importers.d.ts +17 -0
  141. package/dist/memory/importers.js +186 -0
  142. package/dist/memory/importers.js.map +1 -0
  143. package/dist/memory/store.d.ts +71 -0
  144. package/dist/memory/store.js +251 -0
  145. package/dist/memory/store.js.map +1 -0
  146. package/dist/providers/egress.d.ts +2 -0
  147. package/dist/providers/egress.js +172 -0
  148. package/dist/providers/egress.js.map +1 -0
  149. package/dist/providers/localPlanner.d.ts +3 -0
  150. package/dist/providers/localPlanner.js +21 -0
  151. package/dist/providers/localPlanner.js.map +1 -0
  152. package/dist/providers/manager.d.ts +30 -0
  153. package/dist/providers/manager.js +48 -0
  154. package/dist/providers/manager.js.map +1 -0
  155. package/dist/providers/openaiCompatible.d.ts +5 -0
  156. package/dist/providers/openaiCompatible.js +176 -0
  157. package/dist/providers/openaiCompatible.js.map +1 -0
  158. package/dist/providers/pool.d.ts +14 -0
  159. package/dist/providers/pool.js +59 -0
  160. package/dist/providers/pool.js.map +1 -0
  161. package/dist/providers/secrets.d.ts +8 -0
  162. package/dist/providers/secrets.js +17 -0
  163. package/dist/providers/secrets.js.map +1 -0
  164. package/dist/providers/trustedBaseUrls.d.ts +1 -0
  165. package/dist/providers/trustedBaseUrls.js +49 -0
  166. package/dist/providers/trustedBaseUrls.js.map +1 -0
  167. package/dist/providers/types.d.ts +59 -0
  168. package/dist/providers/types.js +2 -0
  169. package/dist/providers/types.js.map +1 -0
  170. package/dist/remediation/cases.d.ts +37 -0
  171. package/dist/remediation/cases.js +90 -0
  172. package/dist/remediation/cases.js.map +1 -0
  173. package/dist/remediation/localScan.d.ts +2 -0
  174. package/dist/remediation/localScan.js +212 -0
  175. package/dist/remediation/localScan.js.map +1 -0
  176. package/dist/remediation/sarif.d.ts +26 -0
  177. package/dist/remediation/sarif.js +150 -0
  178. package/dist/remediation/sarif.js.map +1 -0
  179. package/dist/remediation/worktree.d.ts +11 -0
  180. package/dist/remediation/worktree.js +90 -0
  181. package/dist/remediation/worktree.js.map +1 -0
  182. package/dist/server/configStore.d.ts +59 -0
  183. package/dist/server/configStore.js +73 -0
  184. package/dist/server/configStore.js.map +1 -0
  185. package/dist/server/index.d.ts +17 -0
  186. package/dist/server/index.js +120 -0
  187. package/dist/server/index.js.map +1 -0
  188. package/dist/server/playbookHandler.d.ts +3 -0
  189. package/dist/server/playbookHandler.js +44 -0
  190. package/dist/server/playbookHandler.js.map +1 -0
  191. package/dist/server/routes/config.d.ts +1 -0
  192. package/dist/server/routes/config.js +184 -0
  193. package/dist/server/routes/config.js.map +1 -0
  194. package/dist/server/routes/data.d.ts +1 -0
  195. package/dist/server/routes/data.js +29 -0
  196. package/dist/server/routes/data.js.map +1 -0
  197. package/dist/server/routes/files.d.ts +1 -0
  198. package/dist/server/routes/files.js +20 -0
  199. package/dist/server/routes/files.js.map +1 -0
  200. package/dist/server/routes/git.d.ts +1 -0
  201. package/dist/server/routes/git.js +29 -0
  202. package/dist/server/routes/git.js.map +1 -0
  203. package/dist/server/routes/projects.d.ts +3 -0
  204. package/dist/server/routes/projects.js +178 -0
  205. package/dist/server/routes/projects.js.map +1 -0
  206. package/dist/server/routes/remediation.d.ts +1 -0
  207. package/dist/server/routes/remediation.js +99 -0
  208. package/dist/server/routes/remediation.js.map +1 -0
  209. package/dist/server/routes/sessions.d.ts +1 -0
  210. package/dist/server/routes/sessions.js +46 -0
  211. package/dist/server/routes/sessions.js.map +1 -0
  212. package/dist/server/routes/skills.d.ts +1 -0
  213. package/dist/server/routes/skills.js +48 -0
  214. package/dist/server/routes/skills.js.map +1 -0
  215. package/dist/server/routes/tools.d.ts +1 -0
  216. package/dist/server/routes/tools.js +12 -0
  217. package/dist/server/routes/tools.js.map +1 -0
  218. package/dist/server/security.d.ts +7 -0
  219. package/dist/server/security.js +128 -0
  220. package/dist/server/security.js.map +1 -0
  221. package/dist/server/wsHandler.d.ts +2 -0
  222. package/dist/server/wsHandler.js +212 -0
  223. package/dist/server/wsHandler.js.map +1 -0
  224. package/dist/sessions/journal.d.ts +65 -0
  225. package/dist/sessions/journal.js +98 -0
  226. package/dist/sessions/journal.js.map +1 -0
  227. package/dist/sessions/markdown.d.ts +8 -0
  228. package/dist/sessions/markdown.js +69 -0
  229. package/dist/sessions/markdown.js.map +1 -0
  230. package/dist/sessions/store.d.ts +26 -0
  231. package/dist/sessions/store.js +136 -0
  232. package/dist/sessions/store.js.map +1 -0
  233. package/dist/skills/store.d.ts +24 -0
  234. package/dist/skills/store.js +215 -0
  235. package/dist/skills/store.js.map +1 -0
  236. package/dist/tools/deleteFile.d.ts +8 -0
  237. package/dist/tools/deleteFile.js +37 -0
  238. package/dist/tools/deleteFile.js.map +1 -0
  239. package/dist/tools/editFile.d.ts +10 -0
  240. package/dist/tools/editFile.js +66 -0
  241. package/dist/tools/editFile.js.map +1 -0
  242. package/dist/tools/gitDiff.d.ts +10 -0
  243. package/dist/tools/gitDiff.js +59 -0
  244. package/dist/tools/gitDiff.js.map +1 -0
  245. package/dist/tools/gitStatus.d.ts +5 -0
  246. package/dist/tools/gitStatus.js +45 -0
  247. package/dist/tools/gitStatus.js.map +1 -0
  248. package/dist/tools/listFiles.d.ts +9 -0
  249. package/dist/tools/listFiles.js +36 -0
  250. package/dist/tools/listFiles.js.map +1 -0
  251. package/dist/tools/listRemediationCases.d.ts +8 -0
  252. package/dist/tools/listRemediationCases.js +23 -0
  253. package/dist/tools/listRemediationCases.js.map +1 -0
  254. package/dist/tools/listSkills.d.ts +6 -0
  255. package/dist/tools/listSkills.js +21 -0
  256. package/dist/tools/listSkills.js.map +1 -0
  257. package/dist/tools/memoryDelete.d.ts +8 -0
  258. package/dist/tools/memoryDelete.js +24 -0
  259. package/dist/tools/memoryDelete.js.map +1 -0
  260. package/dist/tools/memoryImport.d.ts +18 -0
  261. package/dist/tools/memoryImport.js +64 -0
  262. package/dist/tools/memoryImport.js.map +1 -0
  263. package/dist/tools/memorySearch.d.ts +13 -0
  264. package/dist/tools/memorySearch.js +40 -0
  265. package/dist/tools/memorySearch.js.map +1 -0
  266. package/dist/tools/memoryUpdate.d.ts +19 -0
  267. package/dist/tools/memoryUpdate.js +38 -0
  268. package/dist/tools/memoryUpdate.js.map +1 -0
  269. package/dist/tools/memoryWrite.d.ts +22 -0
  270. package/dist/tools/memoryWrite.js +36 -0
  271. package/dist/tools/memoryWrite.js.map +1 -0
  272. package/dist/tools/prepareRemediationWorktree.d.ts +8 -0
  273. package/dist/tools/prepareRemediationWorktree.js +48 -0
  274. package/dist/tools/prepareRemediationWorktree.js.map +1 -0
  275. package/dist/tools/projectScripts.d.ts +11 -0
  276. package/dist/tools/projectScripts.js +64 -0
  277. package/dist/tools/projectScripts.js.map +1 -0
  278. package/dist/tools/readFile.d.ts +10 -0
  279. package/dist/tools/readFile.js +57 -0
  280. package/dist/tools/readFile.js.map +1 -0
  281. package/dist/tools/readSkill.d.ts +8 -0
  282. package/dist/tools/readSkill.js +25 -0
  283. package/dist/tools/readSkill.js.map +1 -0
  284. package/dist/tools/registry.d.ts +15 -0
  285. package/dist/tools/registry.js +121 -0
  286. package/dist/tools/registry.js.map +1 -0
  287. package/dist/tools/runCheck.d.ts +17 -0
  288. package/dist/tools/runCheck.js +125 -0
  289. package/dist/tools/runCheck.js.map +1 -0
  290. package/dist/tools/runSecurityScan.d.ts +8 -0
  291. package/dist/tools/runSecurityScan.js +36 -0
  292. package/dist/tools/runSecurityScan.js.map +1 -0
  293. package/dist/tools/searchText.d.ts +11 -0
  294. package/dist/tools/searchText.js +67 -0
  295. package/dist/tools/searchText.js.map +1 -0
  296. package/dist/tools/shell.d.ts +16 -0
  297. package/dist/tools/shell.js +114 -0
  298. package/dist/tools/shell.js.map +1 -0
  299. package/dist/tools/types.d.ts +57 -0
  300. package/dist/tools/types.js +2 -0
  301. package/dist/tools/types.js.map +1 -0
  302. package/dist/tools/writeFile.d.ts +9 -0
  303. package/dist/tools/writeFile.js +89 -0
  304. package/dist/tools/writeFile.js.map +1 -0
  305. package/dist/tui/app.d.ts +8 -0
  306. package/dist/tui/app.js +178 -0
  307. package/dist/tui/app.js.map +1 -0
  308. package/dist/tui/presets.d.ts +13 -0
  309. package/dist/tui/presets.js +11 -0
  310. package/dist/tui/presets.js.map +1 -0
  311. package/dist/tui/render.d.ts +14 -0
  312. package/dist/tui/render.js +83 -0
  313. package/dist/tui/render.js.map +1 -0
  314. package/dist/ui/output.d.ts +4 -0
  315. package/dist/ui/output.js +21 -0
  316. package/dist/ui/output.js.map +1 -0
  317. 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,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -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 {};