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,282 @@
1
+ import { readFile, stat } from 'node:fs/promises';
2
+ import { execFile } from 'node:child_process';
3
+ import { randomUUID } from 'node:crypto';
4
+ import { promisify } from 'node:util';
5
+ import path from 'node:path';
6
+ import { AgentLoop } from './loop.js';
7
+ import { MODE_PROMPT, MODE_TOOLS, CODE_PERMISSION_PROMPT, resolveApprovalMode, } from './modes.js';
8
+ import { createDvalinContext } from '../core/context.js';
9
+ import { checkMode, checkModel, checkProvider, loadPolicy, PolicyViolationError, } from '../core/policy.js';
10
+ import { scanProject } from '../core/projectScanner.js';
11
+ import { loadIgnorePatterns } from '../core/ignorefile.js';
12
+ import { resolveInsideWorkspace } from '../core/workspace.js';
13
+ import { createDefaultToolRegistry } from '../tools/registry.js';
14
+ import { ProviderManager } from '../providers/manager.js';
15
+ import { ProviderPool } from '../providers/pool.js';
16
+ import { resolveApiKey } from '../providers/secrets.js';
17
+ import { readConfig } from '../server/configStore.js';
18
+ import { registerMcpServers } from '../mcp/register.js';
19
+ import { createSession, loadSession, saveSession, summarizeSession } from '../sessions/store.js';
20
+ import { appendJournal, completedTurn, readJournal, recoverSession } from '../sessions/journal.js';
21
+ import { renderReport } from '../audit/report.js';
22
+ import { renderRelevantMemory } from '../memory/store.js';
23
+ const execAsync = promisify(execFile);
24
+ /**
25
+ * Resolve the active provider from saved config: a provider pool takes priority
26
+ * when enabled, otherwise the single `llm` config (optionally overridden by name).
27
+ */
28
+ export async function resolveProvider(override) {
29
+ const cfg = await readConfig();
30
+ if (cfg.pool?.enabled && cfg.pool.entries.some(e => e.enabled)) {
31
+ const pool = new ProviderPool(cfg.pool.entries, cfg.pool.policy);
32
+ const picked = pool.next();
33
+ const model = cfg.pool.entries.find(e => e.id === picked.id)?.model ?? 'unknown';
34
+ return { provider: picked.adapter, providerId: picked.id, model };
35
+ }
36
+ const llm = cfg.llm;
37
+ const providerName = override ?? llm.provider;
38
+ const manager = new ProviderManager();
39
+ manager.addOpenAI(providerName, { apiKey: resolveApiKey(llm), baseUrl: llm.baseUrl, model: llm.model });
40
+ return { provider: manager.get(providerName), providerId: providerName, model: llm.model ?? 'unknown' };
41
+ }
42
+ /**
43
+ * Run one agent turn end-to-end, independent of transport. Both the WebSocket
44
+ * handler (web GUI) and the terminal UI drive this same function, passing
45
+ * transport-specific hooks for streaming and approval. Handles session
46
+ * load/save, provider resolution, prompt assembly (mode + git + AGENTS.md +
47
+ * @mentions), tool gating, and Run Report rendering.
48
+ */
49
+ export async function runAgentTurn(input, hooks = {}) {
50
+ const { content, cwd, signal } = input;
51
+ const mode = input.mode;
52
+ const codePermissionMode = input.codePermissionMode ?? 'auto';
53
+ const approvalMode = resolveApprovalMode(mode, codePermissionMode);
54
+ // ── Session ────────────────────────────────────────────────────────────
55
+ let session;
56
+ let recovered = [];
57
+ if (input.sessionId) {
58
+ const loaded = await loadSession(input.sessionId);
59
+ if (!loaded)
60
+ throw new Error(`Session not found: ${input.sessionId}`);
61
+ session = loaded;
62
+ // Close out any turn that crashed before completing; its input is preserved.
63
+ recovered = recoverSession(session.id).map(t => ({ messageId: t.messageId, content: t.content }));
64
+ }
65
+ else {
66
+ session = createSession(cwd);
67
+ }
68
+ hooks.onSessionId?.(session.id);
69
+ const messageId = input.messageId ?? newMessageId();
70
+ // Resolve policy before selecting or calling a provider. With no policy file
71
+ // this remains permissive and preserves existing behavior.
72
+ const loadedPolicy = loadPolicy(cwd);
73
+ for (const source of loadedPolicy.sources) {
74
+ if (source.error) {
75
+ console.warn(`⚠ Ignored malformed policy at ${source.path}: ${source.error}`);
76
+ }
77
+ }
78
+ enforceRunPolicy(checkMode(loadedPolicy.policy, mode), 'mode', mode);
79
+ // ── Provider ───────────────────────────────────────────────────────────
80
+ const { provider, providerId, model } = await resolveProvider(input.providerOverride);
81
+ enforceRunPolicy(checkProvider(loadedPolicy.policy, providerId), 'provider', providerId);
82
+ enforceRunPolicy(checkModel(loadedPolicy.policy, model), 'model', model);
83
+ hooks.onProviderSelected?.(providerId, model);
84
+ // Idempotency: a turn already completed for this messageId is replayed, not re-run.
85
+ if (input.messageId) {
86
+ const prior = completedTurn(readJournal(session.id), input.messageId);
87
+ if (prior) {
88
+ return {
89
+ sessionId: session.id,
90
+ result: {
91
+ messages: session.messages,
92
+ output: prior.output ?? '(replayed: prior response unavailable)',
93
+ iterationsUsed: prior.iterations ?? 0,
94
+ runId: prior.runId,
95
+ auditHead: prior.auditHead,
96
+ },
97
+ providerId,
98
+ model,
99
+ replayed: true,
100
+ recovered,
101
+ };
102
+ }
103
+ }
104
+ // ── Prompt assembly ──────────────────────────────────────────────────────
105
+ const userContent = await expandAtMentions(content, cwd);
106
+ const registry = createDefaultToolRegistry();
107
+ const isPlan = mode === 'code' && codePermissionMode === 'plan';
108
+ const baseAllowed = isPlan ? MODE_TOOLS.chat : MODE_TOOLS[mode];
109
+ // Governed MCP: connect enabled + policy-permitted servers and register their
110
+ // tools, only in acting modes (not chat / plan). Off by default; each server's
111
+ // egress is enforced by the governed fetch and each tool call is audited.
112
+ let mcpSummaries = [];
113
+ if (!isPlan && mode !== 'chat') {
114
+ const cfg = await readConfig();
115
+ mcpSummaries = await registerMcpServers(registry, cfg.mcp?.servers, { policy: loadedPolicy.policy });
116
+ }
117
+ const mcpToolNames = registry.list().filter(t => t.name.startsWith('mcp__')).map(t => t.name);
118
+ // A null base means "all tools allowed" — MCP tools are already included, so keep it null.
119
+ registry.setAllowedTools(baseAllowed === null ? null : [...baseAllowed, ...mcpToolNames]);
120
+ const systemPrompt = await buildSystemPrompt({
121
+ cwd,
122
+ mode,
123
+ codePermissionMode,
124
+ registry,
125
+ userContent,
126
+ sessionSummary: session.summary,
127
+ });
128
+ const turnMessage = mode === 'code' && codePermissionMode === 'plan'
129
+ ? `Create a detailed step-by-step plan for the following task. Do NOT execute any steps yet.\n\nTask: ${userContent}`
130
+ : userContent;
131
+ // ── Run ──────────────────────────────────────────────────────────────────
132
+ const loop = new AgentLoop({
133
+ provider,
134
+ registry,
135
+ context: createDvalinContext({
136
+ cwd,
137
+ approvalMode,
138
+ requestApproval: hooks.requestApproval,
139
+ policy: loadedPolicy.policy,
140
+ }),
141
+ systemPrompt,
142
+ audit: { model, policy: loadedPolicy, sessionId: session.id },
143
+ });
144
+ // Record the turn's intent before running so a crash mid-turn is recoverable.
145
+ appendJournal(session.id, { type: 'turn_start', messageId, content, cwd, mode });
146
+ let result;
147
+ try {
148
+ result = await loop.processMessage(turnMessage, session.messages, hooks.onEvent, signal);
149
+ }
150
+ catch (err) {
151
+ const status = err instanceof Error && err.message === 'interrupted' ? 'interrupted' : 'error';
152
+ appendJournal(session.id, { type: 'turn_end', messageId, status });
153
+ throw err;
154
+ }
155
+ // ── Persist ──────────────────────────────────────────────────────────────
156
+ session.messages = result.messages;
157
+ session.updatedAt = new Date().toISOString();
158
+ session.summary = summarizeSession(session);
159
+ await saveSession(session);
160
+ // Anchor the completed turn to its audit run (runId + chain head checkpoint).
161
+ appendJournal(session.id, {
162
+ type: 'turn_end',
163
+ messageId,
164
+ status: 'done',
165
+ output: result.output,
166
+ runId: result.runId,
167
+ auditHead: result.auditHead,
168
+ iterations: result.iterationsUsed,
169
+ });
170
+ // ── Run Report (best-effort) ─────────────────────────────────────────────
171
+ let reportMarkdown;
172
+ if (result.runId) {
173
+ try {
174
+ reportMarkdown = renderReport(result.runId);
175
+ }
176
+ catch {
177
+ // never block a turn on report rendering
178
+ }
179
+ }
180
+ return { sessionId: session.id, result, reportMarkdown, providerId, model, recovered, mcp: mcpSummaries };
181
+ }
182
+ /** Generate a stable-per-call message id used to key turn idempotency. */
183
+ function newMessageId() {
184
+ return `msg_${Date.now()}_${randomUUID().replace(/-/g, '').slice(0, 12)}`;
185
+ }
186
+ // ── Helpers ───────────────────────────────────────────────────────────────
187
+ function enforceRunPolicy(decision, targetType, target) {
188
+ if (!decision.allowed) {
189
+ throw new PolicyViolationError(targetType, decision.rule, target);
190
+ }
191
+ }
192
+ async function buildSystemPrompt(opts) {
193
+ const { cwd, mode, codePermissionMode, registry } = opts;
194
+ const tools = registry.list();
195
+ const toolsDesc = tools.map(t => `- ${t.name}: ${t.description} (access: ${t.access})`).join('\n');
196
+ const summary = await scanProject(cwd);
197
+ const sessionContext = opts.sessionSummary ? `\nPrevious session summary: ${opts.sessionSummary}\n` : '';
198
+ const localMemory = await renderRelevantMemory(cwd, opts.userContent, 8);
199
+ const agentsMd = await readTextFileSafe(path.join(cwd, 'AGENTS.md'));
200
+ const projectInstructions = agentsMd
201
+ ? `\n=== PROJECT INSTRUCTIONS (from AGENTS.md) ===\n${agentsMd}\n`
202
+ : '';
203
+ let gitContext = '';
204
+ try {
205
+ const branch = (await execAsync('git', ['branch', '--show-current'], { cwd })).stdout.trim();
206
+ const status = (await execAsync('git', ['status', '--porcelain'], { cwd })).stdout.trim();
207
+ const changedCount = status ? status.split('\n').length : 0;
208
+ gitContext = `\nGit branch: ${branch || '(detached)'}${changedCount > 0 ? ` · ${changedCount} changed file(s)` : ' · clean'}\n`;
209
+ }
210
+ catch {
211
+ // Not a git repo — silently skip
212
+ }
213
+ return [
214
+ 'You are DvalinCode, an AI coding assistant.',
215
+ MODE_PROMPT[mode],
216
+ mode === 'code' ? CODE_PERMISSION_PROMPT[codePermissionMode] : '',
217
+ '',
218
+ `Project root: ${summary.root}`,
219
+ `Files: ${summary.fileCount} files`,
220
+ `Package manager(s): ${summary.packageManagers.join(', ') || 'none'}`,
221
+ summary.signals.length > 0 ? `Signals: ${summary.signals.join(', ')}` : '',
222
+ gitContext,
223
+ projectInstructions,
224
+ localMemory,
225
+ sessionContext,
226
+ '',
227
+ '=== TOOLS ===',
228
+ `You have ${tools.length} tools available. Use this syntax in your response:`,
229
+ '',
230
+ '@tool("tool_name", {"param": "value"})',
231
+ '',
232
+ 'Available tools:',
233
+ toolsDesc,
234
+ '',
235
+ 'RULES:',
236
+ '- Always read files before modifying them.',
237
+ '- Prefer focused, surgical changes.',
238
+ ]
239
+ .filter(Boolean)
240
+ .join('\n');
241
+ }
242
+ async function readTextFileSafe(filePath) {
243
+ try {
244
+ return await readFile(filePath, 'utf8');
245
+ }
246
+ catch {
247
+ return null;
248
+ }
249
+ }
250
+ function isIgnoredPath(filePath, patterns) {
251
+ return patterns.some(pattern => filePath === pattern ||
252
+ filePath.endsWith('/' + pattern) ||
253
+ filePath.includes('/' + pattern + '/') ||
254
+ filePath.startsWith(pattern + '/'));
255
+ }
256
+ /** Expand @filepath references in the user's message by injecting file contents. */
257
+ export async function expandAtMentions(content, cwd) {
258
+ const mentionRegex = /@([\w./\-]+)/g;
259
+ const mentions = [...content.matchAll(mentionRegex)];
260
+ if (mentions.length === 0)
261
+ return content;
262
+ const ignorePatterns = await loadIgnorePatterns(cwd);
263
+ let result = content;
264
+ for (const match of mentions) {
265
+ const relPath = match[1];
266
+ if (isIgnoredPath(relPath, ignorePatterns))
267
+ continue;
268
+ try {
269
+ const absPath = await resolveInsideWorkspace(cwd, relPath);
270
+ const info = await stat(absPath);
271
+ if (info.isDirectory() || info.size > 256_000)
272
+ continue;
273
+ const fileContent = await readFile(absPath, 'utf8');
274
+ result = result.replace(match[0], `<file path="${relPath}">\n\`\`\`\n${fileContent}\n\`\`\`\n</file>`);
275
+ }
276
+ catch {
277
+ // File not found — leave mention as-is
278
+ }
279
+ }
280
+ return result;
281
+ }
282
+ //# sourceMappingURL=session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/agent/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EACL,WAAW,EACX,UAAU,EACV,sBAAsB,EACtB,mBAAmB,GAGpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,SAAS,EACT,UAAU,EACV,aAAa,EACb,UAAU,EACV,oBAAoB,GAErB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAAqB,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAA6B,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAItC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAiB;IACrD,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;IAC/B,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,IAAI,SAAS,CAAC;QACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;IACpE,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC;IACpB,MAAM,YAAY,GAAG,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,eAAe,EAAE,CAAC;IACtC,OAAO,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IACxG,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;AAC1G,CAAC;AAoDD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAmB,EAAE,QAAsB,EAAE;IAC9E,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IACvC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,kBAAkB,GAAuB,KAAK,CAAC,kBAAkB,IAAI,MAAM,CAAC;IAClF,MAAM,YAAY,GAAG,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAEnE,0EAA0E;IAC1E,IAAI,OAAO,CAAC;IACZ,IAAI,SAAS,GAAoB,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;QACtE,OAAO,GAAG,MAAM,CAAC;QACjB,6EAA6E;QAC7E,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACpG,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IACD,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAEhC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,YAAY,EAAE,CAAC;IAEpD,6EAA6E;IAC7E,2DAA2D;IAC3D,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IACrC,KAAK,MAAM,MAAM,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,CAAC,iCAAiC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;IACD,gBAAgB,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IAErE,0EAA0E;IAC1E,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACtF,gBAAgB,CAAC,aAAa,CAAC,YAAY,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACzF,gBAAgB,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACzE,KAAK,CAAC,kBAAkB,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAE9C,oFAAoF;IACpF,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACtE,IAAI,KAAK,EAAE,CAAC;YACV,OAAO;gBACL,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,MAAM,EAAE;oBACN,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,wCAAwC;oBAChE,cAAc,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;oBACrC,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,SAAS,EAAE,KAAK,CAAC,SAAS;iBAC3B;gBACD,UAAU;gBACV,KAAK;gBACL,QAAQ,EAAE,IAAI;gBACd,SAAS;aACV,CAAC;QACJ,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAEzD,MAAM,QAAQ,GAAG,yBAAyB,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,KAAK,MAAM,IAAI,kBAAkB,KAAK,MAAM,CAAC;IAChE,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAEhE,8EAA8E;IAC9E,+EAA+E;IAC/E,0EAA0E;IAC1E,IAAI,YAAY,GAA2B,EAAE,CAAC;IAC9C,IAAI,CAAC,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;QAC/B,YAAY,GAAG,MAAM,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IACvG,CAAC;IACD,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC9F,2FAA2F;IAC3F,QAAQ,CAAC,eAAe,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC;IAE1F,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC;QAC3C,GAAG;QACH,IAAI;QACJ,kBAAkB;QAClB,QAAQ;QACR,WAAW;QACX,cAAc,EAAE,OAAO,CAAC,OAAO;KAChC,CAAC,CAAC;IAEH,MAAM,WAAW,GACf,IAAI,KAAK,MAAM,IAAI,kBAAkB,KAAK,MAAM;QAC9C,CAAC,CAAC,sGAAsG,WAAW,EAAE;QACrH,CAAC,CAAC,WAAW,CAAC;IAElB,4EAA4E;IAC5E,MAAM,IAAI,GAAG,IAAI,SAAS,CAAC;QACzB,QAAQ;QACR,QAAQ;QACR,OAAO,EAAE,mBAAmB,CAAC;YAC3B,GAAG;YACH,YAAY;YACZ,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,MAAM,EAAE,YAAY,CAAC,MAAM;SAC5B,CAAC;QACF,YAAY;QACZ,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE;KAC9D,CAAC,CAAC;IAEH,8EAA8E;IAC9E,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjF,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3F,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;QAC/F,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACnC,OAAO,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,OAAO,CAAC,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAE3B,8EAA8E;IAC9E,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE;QACxB,IAAI,EAAE,UAAU;QAChB,SAAS;QACT,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,cAAc;KAClC,CAAC,CAAC;IAEH,4EAA4E;IAC5E,IAAI,cAAkC,CAAC;IACvC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,cAAc,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;QAC3C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;AAC5G,CAAC;AAED,0EAA0E;AAC1E,SAAS,YAAY;IACnB,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED,6EAA6E;AAE7E,SAAS,gBAAgB,CAAC,QAAkB,EAAE,UAAkB,EAAE,MAAc;IAC9E,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,MAAM,IAAI,oBAAoB,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAOhC;IACC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEnG,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,+BAA+B,IAAI,CAAC,cAAc,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACzG,MAAM,WAAW,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAEzE,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;IACrE,MAAM,mBAAmB,GAAG,QAAQ;QAClC,CAAC,CAAC,oDAAoD,QAAQ,IAAI;QAClE,CAAC,CAAC,EAAE,CAAC;IAEP,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7F,MAAM,MAAM,GAAG,CAAC,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC1F,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,UAAU,GAAG,iBAAiB,MAAM,IAAI,YAAY,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,YAAY,kBAAkB,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC;IAClI,CAAC;IAAC,MAAM,CAAC;QACP,iCAAiC;IACnC,CAAC;IAED,OAAO;QACL,6CAA6C;QAC7C,WAAW,CAAC,IAAI,CAAC;QACjB,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE;QACjE,EAAE;QACF,iBAAiB,OAAO,CAAC,IAAI,EAAE;QAC/B,UAAU,OAAO,CAAC,SAAS,QAAQ;QACnC,uBAAuB,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QACrE,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;QAC1E,UAAU;QACV,mBAAmB;QACnB,WAAW;QACX,cAAc;QACd,EAAE;QACF,eAAe;QACf,YAAY,KAAK,CAAC,MAAM,qDAAqD;QAC7E,EAAE;QACF,wCAAwC;QACxC,EAAE;QACF,kBAAkB;QAClB,SAAS;QACT,EAAE;QACF,QAAQ;QACR,4CAA4C;QAC5C,qCAAqC;KACtC;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB,EAAE,QAAkB;IACzD,OAAO,QAAQ,CAAC,IAAI,CAClB,OAAO,CAAC,EAAE,CACR,QAAQ,KAAK,OAAO;QACpB,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,OAAO,CAAC;QAChC,QAAQ,CAAC,QAAQ,CAAC,GAAG,GAAG,OAAO,GAAG,GAAG,CAAC;QACtC,QAAQ,CAAC,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC,CACrC,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe,EAAE,GAAW;IACjE,MAAM,YAAY,GAAG,eAAe,CAAC;IACrC,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;IACrD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAE1C,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,MAAM,GAAG,OAAO,CAAC;IACrB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,aAAa,CAAC,OAAO,EAAE,cAAc,CAAC;YAAE,SAAS;QACrD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;YACjC,IAAI,IAAI,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,OAAO;gBAAE,SAAS;YACxD,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACpD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,eAAe,OAAO,eAAe,WAAW,mBAAmB,CAAC,CAAC;QACzG,CAAC;QAAC,MAAM,CAAC;YACP,uCAAuC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -0,0 +1,86 @@
1
+ import type { ChatMessage } from '../providers/types.js';
2
+ export declare enum TurnState {
3
+ /** Restore session state */
4
+ RESTORE = "RESTORE",
5
+ /** Compact/compress context if near limit */
6
+ COMPACT = "COMPACT",
7
+ /** Handle built-in commands (/compact, /retry, /undo) */
8
+ COMMAND = "COMMAND",
9
+ /** Build system prompt with workspace context */
10
+ BUILD = "BUILD",
11
+ /** Call LLM and process tool calls in a loop */
12
+ RUN = "RUN",
13
+ /** Persist session to disk */
14
+ SAVE = "SAVE",
15
+ /** Format and output response */
16
+ RESPOND = "RESPOND",
17
+ /** Turn complete */
18
+ DONE = "DONE"
19
+ }
20
+ export type TurnConfig = {
21
+ maxIterations: number;
22
+ maxToolCallsPerTurn: number;
23
+ contextTokenLimit: number;
24
+ compactThreshold: number;
25
+ };
26
+ export declare const DEFAULT_TURN_CONFIG: TurnConfig;
27
+ export type SlashCommand = {
28
+ name: string;
29
+ description: string;
30
+ handler: (args: string, messages: ChatMessage[]) => {
31
+ messages: ChatMessage[];
32
+ output?: string;
33
+ } | Promise<{
34
+ messages: ChatMessage[];
35
+ output?: string;
36
+ }>;
37
+ };
38
+ export type LoopResult = {
39
+ messages: ChatMessage[];
40
+ output: string;
41
+ iterationsUsed: number;
42
+ usage?: {
43
+ inputTokens: number;
44
+ outputTokens: number;
45
+ };
46
+ /** Audit run id for this turn, when auditing is enabled. */
47
+ runId?: string;
48
+ /** Audit chain head hash after run_end — the checkpoint the session journal anchors to. */
49
+ auditHead?: string;
50
+ };
51
+ export type ToolResult = {
52
+ title: string;
53
+ output: string;
54
+ metadata?: Record<string, unknown>;
55
+ };
56
+ export type UndoEntry = {
57
+ toolName: string;
58
+ input: unknown;
59
+ result: ToolResult;
60
+ reverseInput: unknown;
61
+ timestamp: string;
62
+ };
63
+ export type AgentEvent = {
64
+ type: 'token_delta';
65
+ content: string;
66
+ } | {
67
+ type: 'tool_call';
68
+ name: string;
69
+ id: string;
70
+ input: unknown;
71
+ } | {
72
+ type: 'tool_result';
73
+ name: string;
74
+ id: string;
75
+ output: string;
76
+ metadata?: Record<string, unknown>;
77
+ } | {
78
+ type: 'tool_error';
79
+ name: string;
80
+ id: string;
81
+ error: string;
82
+ } | {
83
+ type: 'llm_iteration';
84
+ iteration: number;
85
+ };
86
+ export type AgentEventHandler = (event: AgentEvent) => void;
@@ -0,0 +1,26 @@
1
+ export var TurnState;
2
+ (function (TurnState) {
3
+ /** Restore session state */
4
+ TurnState["RESTORE"] = "RESTORE";
5
+ /** Compact/compress context if near limit */
6
+ TurnState["COMPACT"] = "COMPACT";
7
+ /** Handle built-in commands (/compact, /retry, /undo) */
8
+ TurnState["COMMAND"] = "COMMAND";
9
+ /** Build system prompt with workspace context */
10
+ TurnState["BUILD"] = "BUILD";
11
+ /** Call LLM and process tool calls in a loop */
12
+ TurnState["RUN"] = "RUN";
13
+ /** Persist session to disk */
14
+ TurnState["SAVE"] = "SAVE";
15
+ /** Format and output response */
16
+ TurnState["RESPOND"] = "RESPOND";
17
+ /** Turn complete */
18
+ TurnState["DONE"] = "DONE";
19
+ })(TurnState || (TurnState = {}));
20
+ export const DEFAULT_TURN_CONFIG = {
21
+ maxIterations: 10,
22
+ maxToolCallsPerTurn: 15,
23
+ contextTokenLimit: 128_000,
24
+ compactThreshold: 0.7,
25
+ };
26
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAN,IAAY,SAiBX;AAjBD,WAAY,SAAS;IACnB,4BAA4B;IAC5B,gCAAmB,CAAA;IACnB,6CAA6C;IAC7C,gCAAmB,CAAA;IACnB,yDAAyD;IACzD,gCAAmB,CAAA;IACnB,iDAAiD;IACjD,4BAAe,CAAA;IACf,gDAAgD;IAChD,wBAAW,CAAA;IACX,8BAA8B;IAC9B,0BAAa,CAAA;IACb,iCAAiC;IACjC,gCAAmB,CAAA;IACnB,oBAAoB;IACpB,0BAAa,CAAA;AACf,CAAC,EAjBW,SAAS,KAAT,SAAS,QAiBpB;AASD,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,aAAa,EAAE,EAAE;IACjB,mBAAmB,EAAE,EAAE;IACvB,iBAAiB,EAAE,OAAO;IAC1B,gBAAgB,EAAE,GAAG;CACtB,CAAC"}
@@ -0,0 +1,8 @@
1
+ import type { DiffLine } from '../core/diffPreview.js';
2
+ /** Count added/removed lines from a generated diff. */
3
+ export declare function countDiffLines(diff: DiffLine[] | undefined): {
4
+ added: number;
5
+ removed: number;
6
+ };
7
+ /** Line count of a string (empty string → 0 lines). */
8
+ export declare function lineCount(content: string): number;
@@ -0,0 +1,17 @@
1
+ /** Count added/removed lines from a generated diff. */
2
+ export function countDiffLines(diff) {
3
+ let added = 0;
4
+ let removed = 0;
5
+ for (const line of diff ?? []) {
6
+ if (line.type === 'add')
7
+ added += 1;
8
+ else if (line.type === 'remove')
9
+ removed += 1;
10
+ }
11
+ return { added, removed };
12
+ }
13
+ /** Line count of a string (empty string → 0 lines). */
14
+ export function lineCount(content) {
15
+ return content.length === 0 ? 0 : content.split('\n').length;
16
+ }
17
+ //# sourceMappingURL=diffStat.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"diffStat.js","sourceRoot":"","sources":["../../src/audit/diffStat.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,MAAM,UAAU,cAAc,CAAC,IAA4B;IACzD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;YAAE,KAAK,IAAI,CAAC,CAAC;aAC/B,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC5B,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;AAC/D,CAAC"}
@@ -0,0 +1,10 @@
1
+ /** SHA-256 hex digest of a UTF-8 string or buffer. */
2
+ export declare function sha256(data: string | Buffer): string;
3
+ /**
4
+ * Canonical JSON serialization with stable key order so that hashing is
5
+ * deterministic across machines and runs. Object keys are sorted recursively;
6
+ * arrays keep their order. Used to hash audit records for the chain.
7
+ */
8
+ export declare function canonicalJSON(value: unknown): string;
9
+ /** SHA-256 of file content; null when the content is unavailable. */
10
+ export declare function hashContent(content: string | null | undefined): string | null;
@@ -0,0 +1,33 @@
1
+ import { createHash } from 'node:crypto';
2
+ /** SHA-256 hex digest of a UTF-8 string or buffer. */
3
+ export function sha256(data) {
4
+ return createHash('sha256').update(data).digest('hex');
5
+ }
6
+ /**
7
+ * Canonical JSON serialization with stable key order so that hashing is
8
+ * deterministic across machines and runs. Object keys are sorted recursively;
9
+ * arrays keep their order. Used to hash audit records for the chain.
10
+ */
11
+ export function canonicalJSON(value) {
12
+ return JSON.stringify(sortValue(value));
13
+ }
14
+ function sortValue(value) {
15
+ if (Array.isArray(value)) {
16
+ return value.map(sortValue);
17
+ }
18
+ if (value && typeof value === 'object') {
19
+ const out = {};
20
+ for (const key of Object.keys(value).sort()) {
21
+ out[key] = sortValue(value[key]);
22
+ }
23
+ return out;
24
+ }
25
+ return value;
26
+ }
27
+ /** SHA-256 of file content; null when the content is unavailable. */
28
+ export function hashContent(content) {
29
+ if (content === null || content === undefined)
30
+ return null;
31
+ return sha256(content);
32
+ }
33
+ //# sourceMappingURL=hash.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/audit/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,sDAAsD;AACtD,MAAM,UAAU,MAAM,CAAC,IAAqB;IAC1C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IACD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvC,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACvE,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAE,KAAiC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAC,OAAkC;IAC5D,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC3D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC"}
@@ -0,0 +1,147 @@
1
+ /** A single event emitted during an agent run. */
2
+ export type AuditEvent = {
3
+ type: 'run_start';
4
+ task: string;
5
+ mode: string;
6
+ provider: string;
7
+ model: string;
8
+ cwd: string;
9
+ gitHead: string | null;
10
+ /** Session this run belongs to — links the audit chain back to the session journal. */
11
+ sessionId?: string;
12
+ /** SHA-256 of the resolved org policy governing this run (tamper-evidence). */
13
+ policyHash?: string;
14
+ /** Which policy files contributed, with their hashes and any load errors. */
15
+ policySources?: {
16
+ layer: 'machine' | 'repo';
17
+ path: string;
18
+ present: boolean;
19
+ hash: string | null;
20
+ error?: string;
21
+ }[];
22
+ } | {
23
+ type: 'tool_call';
24
+ tool: string;
25
+ argsSummary: string;
26
+ status: 'ok' | 'error';
27
+ durationMs: number;
28
+ } | {
29
+ type: 'provider_request';
30
+ provider: string;
31
+ model: string;
32
+ origin: string;
33
+ outcome: 'ok' | 'blocked' | 'error';
34
+ durationMs: number;
35
+ statusCode?: number;
36
+ } | {
37
+ type: 'mcp_request';
38
+ /** Configured MCP server id. */
39
+ server: string;
40
+ /** Tool invoked (or the JSON-RPC method for connection-level calls). */
41
+ tool: string;
42
+ /** Origin of the gateway/server — never the full URL or query. */
43
+ host: string;
44
+ outcome: 'ok' | 'blocked' | 'error';
45
+ durationMs: number;
46
+ } | {
47
+ type: 'file_read';
48
+ path: string;
49
+ sha256: string;
50
+ } | {
51
+ type: 'file_write';
52
+ path: string;
53
+ added: number;
54
+ removed: number;
55
+ beforeHash: string | null;
56
+ afterHash: string;
57
+ } | {
58
+ type: 'file_delete';
59
+ path: string;
60
+ beforeHash: string | null;
61
+ } | {
62
+ type: 'shell_exec';
63
+ /** Executable only. Arguments are intentionally excluded. */
64
+ command: string;
65
+ argsCount?: number;
66
+ inputHash?: string;
67
+ exitCode: number | null;
68
+ sandbox: 'seatbelt' | 'bwrap' | 'none';
69
+ } | {
70
+ type: 'approval';
71
+ toolName: string;
72
+ approved: boolean;
73
+ diffHash?: string;
74
+ } | {
75
+ type: 'policy_violation';
76
+ rule: string;
77
+ tool: string;
78
+ target: string;
79
+ } | {
80
+ type: 'run_end';
81
+ status: 'done' | 'interrupted' | 'error';
82
+ iterations: number;
83
+ inputTokens?: number;
84
+ outputTokens?: number;
85
+ warnings?: string[];
86
+ };
87
+ /** A persisted record: an event plus chain metadata. */
88
+ export type AuditRecord = AuditEvent & {
89
+ seq: number;
90
+ ts: string;
91
+ prevHash: string;
92
+ };
93
+ export type RunMeta = Omit<Extract<AuditEvent, {
94
+ type: 'run_start';
95
+ }>, 'type'>;
96
+ /** Default audit directory: ~/.dvalincode/audit (overridable for tests). */
97
+ export declare function defaultAuditDir(): string;
98
+ /**
99
+ * Append-only, hash-chained JSONL writer — one file per agent run. Every record
100
+ * carries `prevHash`; the chain makes after-the-fact edits detectable. Writes are
101
+ * best-effort: a failed append is counted and surfaced via run_end warnings, never
102
+ * thrown into the agent loop.
103
+ */
104
+ export declare class AuditSink {
105
+ readonly runId: string;
106
+ readonly file: string;
107
+ private seq;
108
+ private prevHash;
109
+ private warnings;
110
+ constructor(runId: string, dir?: string);
111
+ /** Append one event. Truncates long free-text fields. Never throws. */
112
+ append(event: AuditEvent): void;
113
+ /** Warnings accumulated from failed writes — fold into the run_end event. */
114
+ getWarnings(): string[];
115
+ /**
116
+ * Current hash-chain head (the `prevHash` the next record would link to). The
117
+ * session journal records this after run_end as a verifiable checkpoint that
118
+ * ties a turn to an exact point in this audit log.
119
+ */
120
+ head(): string;
121
+ }
122
+ /** Read and parse a run's JSONL into records. Throws if the file is missing. */
123
+ export declare function readRecords(runId: string, dir?: string): AuditRecord[];
124
+ export type VerifyResult = {
125
+ ok: boolean;
126
+ brokenAtSeq?: number;
127
+ reason?: string;
128
+ };
129
+ /**
130
+ * Re-derive the hash chain and confirm every record links to the previous one.
131
+ * Detects edits, insertions, deletions, and reordering.
132
+ */
133
+ export declare function verifyChain(runId: string, dir?: string): VerifyResult;
134
+ /**
135
+ * Verify an in-memory record array against the genesis link derived from `runId`.
136
+ * Same check as `verifyChain` but without disk I/O — this is what lets an
137
+ * exported Evidence Pack re-verify its embedded chains fully offline.
138
+ */
139
+ export declare function verifyRecords(runId: string, records: AuditRecord[]): VerifyResult;
140
+ /** List run ids present in the audit dir, newest first. */
141
+ export declare function listRuns(dir?: string): string[];
142
+ /** Resolve the most recent run id, or null when none exist. */
143
+ export declare function latestRun(dir?: string): string | null;
144
+ /** Generate a sortable run id: timestamp + short random suffix. */
145
+ export declare function newRunId(): string;
146
+ /** Best-effort current git HEAD for the given cwd; null outside a repo. */
147
+ export declare function resolveGitHead(cwd: string): Promise<string | null>;