@dirgha/code 1.22.0 → 1.24.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 (321) hide show
  1. package/CHANGELOG.md +171 -0
  2. package/README.md +8 -4
  3. package/dist/auth/keypool.js +40 -26
  4. package/dist/auth/keypool.js.map +1 -1
  5. package/dist/auth/keystore.js +16 -11
  6. package/dist/auth/keystore.js.map +1 -1
  7. package/dist/cli/config.d.ts +36 -5
  8. package/dist/cli/config.js +31 -3
  9. package/dist/cli/config.js.map +1 -1
  10. package/dist/cli/first-run.js +40 -24
  11. package/dist/cli/first-run.js.map +1 -1
  12. package/dist/cli/flows/wizard.js +13 -18
  13. package/dist/cli/flows/wizard.js.map +1 -1
  14. package/dist/cli/interactive.d.ts +4 -0
  15. package/dist/cli/interactive.js +61 -1
  16. package/dist/cli/interactive.js.map +1 -1
  17. package/dist/cli/main.js +82 -23
  18. package/dist/cli/main.js.map +1 -1
  19. package/dist/cli/setup.js +1 -0
  20. package/dist/cli/setup.js.map +1 -1
  21. package/dist/cli/slash/fleet.js +28 -3
  22. package/dist/cli/slash/fleet.js.map +1 -1
  23. package/dist/cli/slash/index.d.ts +2 -1
  24. package/dist/cli/slash/index.js +3 -1
  25. package/dist/cli/slash/index.js.map +1 -1
  26. package/dist/cli/slash/models.js +339 -7
  27. package/dist/cli/slash/models.js.map +1 -1
  28. package/dist/cli/slash/paste.js +4 -7
  29. package/dist/cli/slash/paste.js.map +1 -1
  30. package/dist/cli/slash/provider.d.ts +1 -0
  31. package/dist/cli/slash/provider.js +33 -1
  32. package/dist/cli/slash/provider.js.map +1 -1
  33. package/dist/cli/slash/sandbox.d.ts +21 -0
  34. package/dist/cli/slash/sandbox.js +84 -0
  35. package/dist/cli/slash/sandbox.js.map +1 -0
  36. package/dist/cli/slash.d.ts +5 -0
  37. package/dist/cli/slash.js +26 -10
  38. package/dist/cli/slash.js.map +1 -1
  39. package/dist/cli/subcommands/audit.js +28 -8
  40. package/dist/cli/subcommands/audit.js.map +1 -1
  41. package/dist/cli/subcommands/doctor.d.ts +4 -0
  42. package/dist/cli/subcommands/doctor.js +117 -21
  43. package/dist/cli/subcommands/doctor.js.map +1 -1
  44. package/dist/cli/subcommands/feature-setup.js +6 -6
  45. package/dist/cli/subcommands/feature-setup.js.map +1 -1
  46. package/dist/cli/subcommands/memory.js +23 -0
  47. package/dist/cli/subcommands/memory.js.map +1 -1
  48. package/dist/cli/subcommands/telemetry.d.ts +2 -1
  49. package/dist/cli/subcommands/telemetry.js +47 -34
  50. package/dist/cli/subcommands/telemetry.js.map +1 -1
  51. package/dist/context/_fts.js +4 -1
  52. package/dist/context/_fts.js.map +1 -1
  53. package/dist/context/branch.d.ts +2 -2
  54. package/dist/context/branch.js +40 -23
  55. package/dist/context/branch.js.map +1 -1
  56. package/dist/context/compaction.js +44 -21
  57. package/dist/context/compaction.js.map +1 -1
  58. package/dist/context/default-soul.md +1 -0
  59. package/dist/context/git-state.js +31 -18
  60. package/dist/context/git-state.js.map +1 -1
  61. package/dist/context/knowledge.js +31 -20
  62. package/dist/context/knowledge.js.map +1 -1
  63. package/dist/context/memory.js +8 -1
  64. package/dist/context/memory.js.map +1 -1
  65. package/dist/context/mode-enforcement.js +11 -1
  66. package/dist/context/mode-enforcement.js.map +1 -1
  67. package/dist/context/mode.js +67 -30
  68. package/dist/context/mode.js.map +1 -1
  69. package/dist/context/primer.d.ts +17 -0
  70. package/dist/context/primer.js +50 -3
  71. package/dist/context/primer.js.map +1 -1
  72. package/dist/context/session.d.ts +4 -0
  73. package/dist/context/session.js.map +1 -1
  74. package/dist/daemon/server.js +17 -3
  75. package/dist/daemon/server.js.map +1 -1
  76. package/dist/embeddings/iface.d.ts +26 -0
  77. package/dist/embeddings/iface.js +15 -0
  78. package/dist/embeddings/iface.js.map +1 -0
  79. package/dist/embeddings/local.d.ts +24 -0
  80. package/dist/embeddings/local.js +112 -0
  81. package/dist/embeddings/local.js.map +1 -0
  82. package/dist/embeddings/remote.d.ts +31 -0
  83. package/dist/embeddings/remote.js +88 -0
  84. package/dist/embeddings/remote.js.map +1 -0
  85. package/dist/embeddings/select.d.ts +24 -0
  86. package/dist/embeddings/select.js +39 -0
  87. package/dist/embeddings/select.js.map +1 -0
  88. package/dist/fleet/apply-back.js +5 -1
  89. package/dist/fleet/apply-back.js.map +1 -1
  90. package/dist/fleet/cli-command.d.ts +2 -0
  91. package/dist/fleet/cli-command.js +15 -1
  92. package/dist/fleet/cli-command.js.map +1 -1
  93. package/dist/fleet/runner.js +35 -2
  94. package/dist/fleet/runner.js.map +1 -1
  95. package/dist/fleet/scratchpad.js +1 -2
  96. package/dist/fleet/scratchpad.js.map +1 -1
  97. package/dist/fleet/state.d.ts +4 -0
  98. package/dist/fleet/state.js +11 -2
  99. package/dist/fleet/state.js.map +1 -1
  100. package/dist/fleet/templates.d.ts +4 -0
  101. package/dist/fleet/templates.js.map +1 -1
  102. package/dist/fleet/types.d.ts +4 -0
  103. package/dist/fleet/types.js.map +1 -1
  104. package/dist/intelligence/failover-chain.js +10 -1
  105. package/dist/intelligence/failover-chain.js.map +1 -1
  106. package/dist/intelligence/prices.d.ts +6 -4
  107. package/dist/intelligence/prices.js +45 -11
  108. package/dist/intelligence/prices.js.map +1 -1
  109. package/dist/kernel/abort-utils.d.ts +4 -0
  110. package/dist/kernel/abort-utils.js +45 -0
  111. package/dist/kernel/abort-utils.js.map +1 -0
  112. package/dist/kernel/agent-loop.js +104 -25
  113. package/dist/kernel/agent-loop.js.map +1 -1
  114. package/dist/kernel/tool-timeout.d.ts +27 -0
  115. package/dist/kernel/tool-timeout.js +53 -0
  116. package/dist/kernel/tool-timeout.js.map +1 -0
  117. package/dist/kernel/types.d.ts +3 -0
  118. package/dist/lsp/client.js +29 -16
  119. package/dist/lsp/client.js.map +1 -1
  120. package/dist/lsp/detector.js +7 -6
  121. package/dist/lsp/detector.js.map +1 -1
  122. package/dist/mcp/client.d.ts +1 -1
  123. package/dist/mcp/client.js +19 -16
  124. package/dist/mcp/client.js.map +1 -1
  125. package/dist/mcp/transport.js +46 -38
  126. package/dist/mcp/transport.js.map +1 -1
  127. package/dist/providers/custom-provider.d.ts +31 -0
  128. package/dist/providers/custom-provider.js +72 -0
  129. package/dist/providers/custom-provider.js.map +1 -0
  130. package/dist/providers/deepseek.js +1 -1
  131. package/dist/providers/deepseek.js.map +1 -1
  132. package/dist/providers/dispatch.d.ts +1 -1
  133. package/dist/providers/dispatch.js +25 -2
  134. package/dist/providers/dispatch.js.map +1 -1
  135. package/dist/providers/family-fallback.js +5 -0
  136. package/dist/providers/family-fallback.js.map +1 -1
  137. package/dist/providers/gemini.js +33 -3
  138. package/dist/providers/gemini.js.map +1 -1
  139. package/dist/providers/index.d.ts +16 -0
  140. package/dist/providers/index.js +43 -2
  141. package/dist/providers/index.js.map +1 -1
  142. package/dist/providers/machine1.d.ts +30 -0
  143. package/dist/providers/machine1.js +341 -0
  144. package/dist/providers/machine1.js.map +1 -0
  145. package/dist/providers/nvidia.js +1 -1
  146. package/dist/providers/nvidia.js.map +1 -1
  147. package/dist/providers/openai-compat.d.ts +1 -0
  148. package/dist/providers/openai-compat.js +32 -9
  149. package/dist/providers/openai-compat.js.map +1 -1
  150. package/dist/providers/openrouter.js +5 -2
  151. package/dist/providers/openrouter.js.map +1 -1
  152. package/dist/safety/audit-log.d.ts +15 -0
  153. package/dist/safety/audit-log.js +21 -0
  154. package/dist/safety/audit-log.js.map +1 -1
  155. package/dist/state/db-telemetry.js +11 -1
  156. package/dist/state/db-telemetry.js.map +1 -1
  157. package/dist/state/db.d.ts +7 -0
  158. package/dist/state/db.js +147 -3
  159. package/dist/state/db.js.map +1 -1
  160. package/dist/state/index.js +8 -4
  161. package/dist/state/index.js.map +1 -1
  162. package/dist/state/sync-index.d.ts +74 -0
  163. package/dist/state/sync-index.js +246 -0
  164. package/dist/state/sync-index.js.map +1 -0
  165. package/dist/state/transaction.d.ts +62 -0
  166. package/dist/state/transaction.js +65 -0
  167. package/dist/state/transaction.js.map +1 -0
  168. package/dist/state/vec.d.ts +28 -0
  169. package/dist/state/vec.js +113 -0
  170. package/dist/state/vec.js.map +1 -0
  171. package/dist/telemetry/gateway-push.d.ts +17 -0
  172. package/dist/telemetry/gateway-push.js +48 -0
  173. package/dist/telemetry/gateway-push.js.map +1 -0
  174. package/dist/telemetry/index.d.ts +9 -0
  175. package/dist/telemetry/index.js +9 -0
  176. package/dist/telemetry/index.js.map +1 -0
  177. package/dist/tools/browser.js +24 -16
  178. package/dist/tools/browser.js.map +1 -1
  179. package/dist/tools/checkpoint.d.ts +6 -1
  180. package/dist/tools/checkpoint.js +94 -63
  181. package/dist/tools/checkpoint.js.map +1 -1
  182. package/dist/tools/cron.js +1 -3
  183. package/dist/tools/cron.js.map +1 -1
  184. package/dist/tools/db-workspace-info.d.ts +10 -0
  185. package/dist/tools/db-workspace-info.js +76 -0
  186. package/dist/tools/db-workspace-info.js.map +1 -0
  187. package/dist/tools/diff.js +25 -21
  188. package/dist/tools/diff.js.map +1 -1
  189. package/dist/tools/exec.d.ts +6 -1
  190. package/dist/tools/exec.js +46 -4
  191. package/dist/tools/exec.js.map +1 -1
  192. package/dist/tools/fs-edit.d.ts +3 -5
  193. package/dist/tools/fs-edit.js +8 -23
  194. package/dist/tools/fs-edit.js.map +1 -1
  195. package/dist/tools/fs-ls.js +6 -8
  196. package/dist/tools/fs-ls.js.map +1 -1
  197. package/dist/tools/fs-read.d.ts +1 -1
  198. package/dist/tools/fs-read.js +37 -28
  199. package/dist/tools/fs-read.js.map +1 -1
  200. package/dist/tools/fs-write.d.ts +1 -1
  201. package/dist/tools/fs-write.js +33 -33
  202. package/dist/tools/fs-write.js.map +1 -1
  203. package/dist/tools/git.js +13 -6
  204. package/dist/tools/git.js.map +1 -1
  205. package/dist/tools/github.d.ts +13 -0
  206. package/dist/tools/github.js +257 -0
  207. package/dist/tools/github.js.map +1 -0
  208. package/dist/tools/graph-neighbors.d.ts +9 -0
  209. package/dist/tools/graph-neighbors.js +77 -0
  210. package/dist/tools/graph-neighbors.js.map +1 -0
  211. package/dist/tools/graph-traverse.d.ts +10 -0
  212. package/dist/tools/graph-traverse.js +90 -0
  213. package/dist/tools/graph-traverse.js.map +1 -0
  214. package/dist/tools/index.d.ts +10 -2
  215. package/dist/tools/index.js +17 -4
  216. package/dist/tools/index.js.map +1 -1
  217. package/dist/tools/kb-search.d.ts +13 -0
  218. package/dist/tools/kb-search.js +113 -0
  219. package/dist/tools/kb-search.js.map +1 -0
  220. package/dist/tools/multimodal.js +30 -15
  221. package/dist/tools/multimodal.js.map +1 -1
  222. package/dist/tools/permission.js +5 -4
  223. package/dist/tools/permission.js.map +1 -1
  224. package/dist/tools/registry.d.ts +10 -0
  225. package/dist/tools/registry.js.map +1 -1
  226. package/dist/tools/rtk.js +28 -9
  227. package/dist/tools/rtk.js.map +1 -1
  228. package/dist/tools/search-glob.d.ts +1 -1
  229. package/dist/tools/search-glob.js +46 -24
  230. package/dist/tools/search-glob.js.map +1 -1
  231. package/dist/tools/search-grep.d.ts +1 -1
  232. package/dist/tools/search-grep.js +56 -32
  233. package/dist/tools/search-grep.js.map +1 -1
  234. package/dist/tools/shell.d.ts +7 -1
  235. package/dist/tools/shell.js +178 -61
  236. package/dist/tools/shell.js.map +1 -1
  237. package/dist/tools/transactional-write.d.ts +10 -0
  238. package/dist/tools/transactional-write.js +132 -0
  239. package/dist/tools/transactional-write.js.map +1 -0
  240. package/dist/tui/approval.js +31 -3
  241. package/dist/tui/approval.js.map +1 -1
  242. package/dist/tui/ink/App.d.ts +2 -1
  243. package/dist/tui/ink/App.js +333 -79
  244. package/dist/tui/ink/App.js.map +1 -1
  245. package/dist/tui/ink/components/DenseToolMessage.js +20 -3
  246. package/dist/tui/ink/components/DenseToolMessage.js.map +1 -1
  247. package/dist/tui/ink/components/InputBox.d.ts +4 -0
  248. package/dist/tui/ink/components/InputBox.js +38 -21
  249. package/dist/tui/ink/components/InputBox.js.map +1 -1
  250. package/dist/tui/ink/components/KeySetOverlay.d.ts +1 -1
  251. package/dist/tui/ink/components/KeySetOverlay.js +18 -16
  252. package/dist/tui/ink/components/KeySetOverlay.js.map +1 -1
  253. package/dist/tui/ink/components/Logo.d.ts +20 -0
  254. package/dist/tui/ink/components/Logo.js +67 -1
  255. package/dist/tui/ink/components/Logo.js.map +1 -1
  256. package/dist/tui/ink/components/ModelPicker.d.ts +2 -2
  257. package/dist/tui/ink/components/ModelPicker.js +34 -26
  258. package/dist/tui/ink/components/ModelPicker.js.map +1 -1
  259. package/dist/tui/ink/components/PasteCollapse.d.ts +3 -1
  260. package/dist/tui/ink/components/PasteCollapse.js +11 -9
  261. package/dist/tui/ink/components/PasteCollapse.js.map +1 -1
  262. package/dist/tui/ink/components/PromptQueueIndicator.js +1 -1
  263. package/dist/tui/ink/components/PromptQueueIndicator.js.map +1 -1
  264. package/dist/tui/ink/components/SandboxPicker.d.ts +18 -0
  265. package/dist/tui/ink/components/SandboxPicker.js +77 -0
  266. package/dist/tui/ink/components/SandboxPicker.js.map +1 -0
  267. package/dist/tui/ink/components/SpinnerGlyph.d.ts +4 -4
  268. package/dist/tui/ink/components/SpinnerGlyph.js +34 -14
  269. package/dist/tui/ink/components/SpinnerGlyph.js.map +1 -1
  270. package/dist/tui/ink/components/StatusBar.d.ts +3 -7
  271. package/dist/tui/ink/components/StatusBar.js +2 -11
  272. package/dist/tui/ink/components/StatusBar.js.map +1 -1
  273. package/dist/tui/ink/components/ThinkingBlock.d.ts +15 -4
  274. package/dist/tui/ink/components/ThinkingBlock.js +34 -17
  275. package/dist/tui/ink/components/ThinkingBlock.js.map +1 -1
  276. package/dist/tui/ink/components/ToolBox.js +21 -13
  277. package/dist/tui/ink/components/ToolBox.js.map +1 -1
  278. package/dist/tui/ink/components/VirtualTranscript.d.ts +1 -1
  279. package/dist/tui/ink/components/VirtualTranscript.js +5 -3
  280. package/dist/tui/ink/components/VirtualTranscript.js.map +1 -1
  281. package/dist/tui/ink/index.js +36 -14
  282. package/dist/tui/ink/index.js.map +1 -1
  283. package/dist/tui/ink/ink-approval-bus.d.ts +2 -0
  284. package/dist/tui/ink/ink-approval-bus.js +10 -0
  285. package/dist/tui/ink/ink-approval-bus.js.map +1 -1
  286. package/dist/tui/ink/markdown/display.js +9 -2
  287. package/dist/tui/ink/markdown/display.js.map +1 -1
  288. package/dist/tui/ink/markdown/split-point.js +8 -13
  289. package/dist/tui/ink/markdown/split-point.js.map +1 -1
  290. package/dist/tui/ink/markdown/syntax-highlight.d.ts +13 -0
  291. package/dist/tui/ink/markdown/syntax-highlight.js +91 -0
  292. package/dist/tui/ink/markdown/syntax-highlight.js.map +1 -0
  293. package/dist/tui/ink/theme-context.js +6 -3
  294. package/dist/tui/ink/theme-context.js.map +1 -1
  295. package/dist/tui/ink/use-declined-versions.js +6 -2
  296. package/dist/tui/ink/use-declined-versions.js.map +1 -1
  297. package/dist/tui/ink/use-elapsed.d.ts +9 -1
  298. package/dist/tui/ink/use-elapsed.js +17 -2
  299. package/dist/tui/ink/use-elapsed.js.map +1 -1
  300. package/dist/tui/ink/use-event-projection.d.ts +10 -0
  301. package/dist/tui/ink/use-event-projection.js +111 -12
  302. package/dist/tui/ink/use-event-projection.js.map +1 -1
  303. package/dist/tui/ink/use-flicker-detector.js +9 -0
  304. package/dist/tui/ink/use-flicker-detector.js.map +1 -1
  305. package/dist/tui/ink/use-overlays.d.ts +2 -2
  306. package/dist/tui/ink/use-overlays.js +20 -17
  307. package/dist/tui/ink/use-overlays.js.map +1 -1
  308. package/dist/tui/ink/use-render-metrics.js +18 -5
  309. package/dist/tui/ink/use-render-metrics.js.map +1 -1
  310. package/dist/tui/ink/use-tool-progress.d.ts +7 -0
  311. package/dist/tui/ink/use-tool-progress.js +39 -0
  312. package/dist/tui/ink/use-tool-progress.js.map +1 -0
  313. package/dist/tui/ink/use-transcript-scroll.js +14 -6
  314. package/dist/tui/ink/use-transcript-scroll.js.map +1 -1
  315. package/dist/utils/env.d.ts +1 -0
  316. package/dist/utils/env.js +60 -0
  317. package/dist/utils/env.js.map +1 -0
  318. package/dist/utils/fs.d.ts +10 -0
  319. package/dist/utils/fs.js +37 -0
  320. package/dist/utils/fs.js.map +1 -0
  321. package/package.json +12 -8
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Markdown → SQLite indexer (Sprint 6 — docs/cli/index/agent-db.md).
3
+ *
4
+ * Walks `~/.dirgha/memory/*.md` and `~/.dirgha/knowledge/*.md`, indexing
5
+ * each file as a row in `embedding_meta` with source label
6
+ * `memory:<slug>` or `kb:<slug>`. The SQLite copy is a derived index —
7
+ * the markdown files on disk remain the source of truth.
8
+ *
9
+ * Skips files that haven't changed via an `index_state(source PK, mtime)`
10
+ * sidecar table. `rm -rf ~/.dirgha/dirgha.db` and a restart rebuilds
11
+ * cleanly because every markdown file looks "new" again.
12
+ *
13
+ * If chokidar is installed (optional dependency), watches the two
14
+ * directories and propagates add/change/unlink within ~200ms. When
15
+ * chokidar is absent, the startup-only sync is the entire mechanism.
16
+ *
17
+ * Public API:
18
+ * - syncMemoryAndKb(db, opts?) — one-shot walk + insert/update/delete
19
+ * - startWatchers(db, opts?) — optional chokidar wiring (returns null if absent)
20
+ *
21
+ * Both APIs return summaries useful for `dirgha doctor` and tests.
22
+ */
23
+ export interface SyncOptions {
24
+ /** Override ~/.dirgha root for tests. Defaults to `homedir()/.dirgha`. */
25
+ home?: string;
26
+ /** Set to true to log skip/insert/update counts to stderr. */
27
+ verbose?: boolean;
28
+ }
29
+ export interface SyncSummary {
30
+ inserted: number;
31
+ updated: number;
32
+ unchanged: number;
33
+ deleted: number;
34
+ total: number;
35
+ /** Most-recent file mtime (ms epoch) seen during this sync, or 0 when empty. */
36
+ latestMtime: number;
37
+ }
38
+ export interface KbStats {
39
+ count: number;
40
+ latestSync: number;
41
+ }
42
+ /**
43
+ * Bootstrap the `index_state` table used to skip-already-indexed files.
44
+ * Idempotent — safe to call on every openDb().
45
+ */
46
+ export declare function ensureIndexStateTable(db: import("better-sqlite3").Database): void;
47
+ /**
48
+ * One-shot walk over ~/.dirgha/memory and ~/.dirgha/knowledge. Inserts
49
+ * new files, refreshes changed ones, and removes rows for files no
50
+ * longer on disk.
51
+ */
52
+ export declare function syncMemoryAndKb(db: import("better-sqlite3").Database, opts?: SyncOptions): SyncSummary;
53
+ /**
54
+ * Count of currently indexed memory + KB chunks, plus the most recent
55
+ * sync timestamp. Used by `dirgha doctor`.
56
+ */
57
+ export declare function getKbChunkStats(db: import("better-sqlite3").Database): KbStats;
58
+ export interface WatcherHandle {
59
+ close(): Promise<void>;
60
+ }
61
+ /**
62
+ * Optional file watcher. Returns null when chokidar is not installed —
63
+ * callers should treat that as "startup-only sync, no live updates".
64
+ */
65
+ export declare function startWatchers(db: import("better-sqlite3").Database, opts?: SyncOptions): WatcherHandle | null;
66
+ /**
67
+ * Lazy startup hook — called from openDb() on first DB open per process.
68
+ * Wraps syncMemoryAndKb + startWatchers in a try/catch so a transient
69
+ * filesystem error never blocks the CLI from booting.
70
+ */
71
+ export declare function bootstrapIndex(db: import("better-sqlite3").Database, opts?: SyncOptions): {
72
+ summary: SyncSummary;
73
+ watcher: WatcherHandle | null;
74
+ };
@@ -0,0 +1,246 @@
1
+ /**
2
+ * Markdown → SQLite indexer (Sprint 6 — docs/cli/index/agent-db.md).
3
+ *
4
+ * Walks `~/.dirgha/memory/*.md` and `~/.dirgha/knowledge/*.md`, indexing
5
+ * each file as a row in `embedding_meta` with source label
6
+ * `memory:<slug>` or `kb:<slug>`. The SQLite copy is a derived index —
7
+ * the markdown files on disk remain the source of truth.
8
+ *
9
+ * Skips files that haven't changed via an `index_state(source PK, mtime)`
10
+ * sidecar table. `rm -rf ~/.dirgha/dirgha.db` and a restart rebuilds
11
+ * cleanly because every markdown file looks "new" again.
12
+ *
13
+ * If chokidar is installed (optional dependency), watches the two
14
+ * directories and propagates add/change/unlink within ~200ms. When
15
+ * chokidar is absent, the startup-only sync is the entire mechanism.
16
+ *
17
+ * Public API:
18
+ * - syncMemoryAndKb(db, opts?) — one-shot walk + insert/update/delete
19
+ * - startWatchers(db, opts?) — optional chokidar wiring (returns null if absent)
20
+ *
21
+ * Both APIs return summaries useful for `dirgha doctor` and tests.
22
+ */
23
+ import { readdirSync, statSync, readFileSync, existsSync } from "node:fs";
24
+ import { join } from "node:path";
25
+ import { homedir } from "node:os";
26
+ import { createRequire } from "node:module";
27
+ const _require = createRequire(import.meta.url);
28
+ const NAMESPACES = [
29
+ { dir: "memory", prefix: "memory:" },
30
+ { dir: "knowledge", prefix: "kb:" },
31
+ ];
32
+ /**
33
+ * Bootstrap the `index_state` table used to skip-already-indexed files.
34
+ * Idempotent — safe to call on every openDb().
35
+ */
36
+ export function ensureIndexStateTable(db) {
37
+ db.exec(`
38
+ CREATE TABLE IF NOT EXISTS index_state (
39
+ source TEXT PRIMARY KEY,
40
+ mtime INTEGER NOT NULL,
41
+ ts INTEGER NOT NULL DEFAULT (unixepoch() * 1000)
42
+ );
43
+ `);
44
+ }
45
+ /**
46
+ * One-shot walk over ~/.dirgha/memory and ~/.dirgha/knowledge. Inserts
47
+ * new files, refreshes changed ones, and removes rows for files no
48
+ * longer on disk.
49
+ */
50
+ export function syncMemoryAndKb(db, opts = {}) {
51
+ ensureIndexStateTable(db);
52
+ const home = opts.home ?? homedir();
53
+ const root = join(home, ".dirgha");
54
+ const summary = {
55
+ inserted: 0,
56
+ updated: 0,
57
+ unchanged: 0,
58
+ deleted: 0,
59
+ total: 0,
60
+ latestMtime: 0,
61
+ };
62
+ const seen = new Set();
63
+ for (const ns of NAMESPACES) {
64
+ const dir = join(root, ns.dir);
65
+ if (!existsSync(dir))
66
+ continue;
67
+ let names;
68
+ try {
69
+ names = readdirSync(dir);
70
+ }
71
+ catch {
72
+ continue;
73
+ }
74
+ for (const name of names) {
75
+ if (!name.endsWith(".md"))
76
+ continue;
77
+ // Skip the human-readable index files generated by memory.ts /
78
+ // knowledge.ts — they're derived too and would just bloat the index.
79
+ if (name === "MEMORY.md" || name === "INDEX.md")
80
+ continue;
81
+ const slug = name.replace(/\.md$/, "");
82
+ const source = `${ns.prefix}${slug}`;
83
+ const path = join(dir, name);
84
+ seen.add(source);
85
+ let mtime;
86
+ try {
87
+ mtime = Math.floor(statSync(path).mtimeMs);
88
+ }
89
+ catch {
90
+ continue;
91
+ }
92
+ const prior = db
93
+ .prepare("SELECT mtime FROM index_state WHERE source = ?")
94
+ .get(source);
95
+ if (prior && prior.mtime === mtime) {
96
+ summary.unchanged++;
97
+ if (mtime > summary.latestMtime)
98
+ summary.latestMtime = mtime;
99
+ continue;
100
+ }
101
+ let body;
102
+ try {
103
+ body = readFileSync(path, "utf8");
104
+ }
105
+ catch {
106
+ continue;
107
+ }
108
+ const chunk = body.slice(0, 8_000); // cap per-row to keep DB manageable
109
+ const tx = db.transaction(() => {
110
+ // embedding_meta has no UNIQUE on source — clean prior rows for
111
+ // this source first so re-index leaves exactly one entry.
112
+ db.prepare("DELETE FROM embedding_meta WHERE source = ?").run(source);
113
+ db.prepare("INSERT INTO embedding_meta(source, chunk, ts) VALUES (?, ?, ?)").run(source, chunk, Date.now());
114
+ db.prepare("INSERT INTO index_state(source, mtime, ts) VALUES (?, ?, ?) " +
115
+ "ON CONFLICT(source) DO UPDATE SET mtime = excluded.mtime, ts = excluded.ts").run(source, mtime, Date.now());
116
+ });
117
+ tx();
118
+ if (prior)
119
+ summary.updated++;
120
+ else
121
+ summary.inserted++;
122
+ if (mtime > summary.latestMtime)
123
+ summary.latestMtime = mtime;
124
+ }
125
+ }
126
+ // Sweep stale rows — files deleted from disk should drop from the index.
127
+ const knownSources = db
128
+ .prepare("SELECT source FROM index_state")
129
+ .all();
130
+ for (const row of knownSources) {
131
+ if (!isMemoryOrKbSource(row.source))
132
+ continue;
133
+ if (seen.has(row.source))
134
+ continue;
135
+ db.transaction(() => {
136
+ db.prepare("DELETE FROM embedding_meta WHERE source = ?").run(row.source);
137
+ db.prepare("DELETE FROM index_state WHERE source = ?").run(row.source);
138
+ })();
139
+ summary.deleted++;
140
+ }
141
+ summary.total =
142
+ summary.inserted + summary.updated + summary.unchanged;
143
+ if (opts.verbose) {
144
+ process.stderr.write(`[Dirgha] sync-index: +${summary.inserted} ~${summary.updated} =${summary.unchanged} -${summary.deleted} (latest mtime ${new Date(summary.latestMtime || 0).toISOString()})\n`);
145
+ }
146
+ return summary;
147
+ }
148
+ function isMemoryOrKbSource(source) {
149
+ return source.startsWith("memory:") || source.startsWith("kb:");
150
+ }
151
+ /**
152
+ * Count of currently indexed memory + KB chunks, plus the most recent
153
+ * sync timestamp. Used by `dirgha doctor`.
154
+ */
155
+ export function getKbChunkStats(db) {
156
+ try {
157
+ const c = db
158
+ .prepare("SELECT COUNT(*) AS c FROM embedding_meta WHERE source LIKE 'memory:%' OR source LIKE 'kb:%'")
159
+ .get();
160
+ const m = db
161
+ .prepare("SELECT MAX(ts) AS m FROM index_state WHERE source LIKE 'memory:%' OR source LIKE 'kb:%'")
162
+ .get();
163
+ return { count: c.c ?? 0, latestSync: m.m ?? 0 };
164
+ }
165
+ catch {
166
+ return { count: 0, latestSync: 0 };
167
+ }
168
+ }
169
+ /**
170
+ * Optional file watcher. Returns null when chokidar is not installed —
171
+ * callers should treat that as "startup-only sync, no live updates".
172
+ */
173
+ export function startWatchers(db, opts = {}) {
174
+ let chokidar = null;
175
+ try {
176
+ chokidar = _require("chokidar");
177
+ }
178
+ catch {
179
+ return null;
180
+ }
181
+ const home = opts.home ?? homedir();
182
+ const targets = NAMESPACES.map((ns) => join(home, ".dirgha", ns.dir));
183
+ const watcher = chokidar.watch(targets, {
184
+ ignoreInitial: true,
185
+ persistent: false,
186
+ awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 },
187
+ });
188
+ // Coalesce add/change events into a 200 ms re-sync window so a single
189
+ // editor save doesn't fire syncMemoryAndKb three times.
190
+ let pending = null;
191
+ const schedule = () => {
192
+ if (pending)
193
+ return;
194
+ pending = setTimeout(() => {
195
+ pending = null;
196
+ try {
197
+ syncMemoryAndKb(db, opts);
198
+ }
199
+ catch (err) {
200
+ process.stderr.write(`[Dirgha] sync-index watcher error: ${err.message}\n`);
201
+ }
202
+ }, 200);
203
+ };
204
+ watcher.on("add", schedule);
205
+ watcher.on("change", schedule);
206
+ watcher.on("unlink", schedule);
207
+ return {
208
+ async close() {
209
+ if (pending) {
210
+ clearTimeout(pending);
211
+ pending = null;
212
+ }
213
+ await watcher.close();
214
+ },
215
+ };
216
+ }
217
+ /**
218
+ * Lazy startup hook — called from openDb() on first DB open per process.
219
+ * Wraps syncMemoryAndKb + startWatchers in a try/catch so a transient
220
+ * filesystem error never blocks the CLI from booting.
221
+ */
222
+ export function bootstrapIndex(db, opts = {}) {
223
+ let summary = {
224
+ inserted: 0,
225
+ updated: 0,
226
+ unchanged: 0,
227
+ deleted: 0,
228
+ total: 0,
229
+ latestMtime: 0,
230
+ };
231
+ try {
232
+ summary = syncMemoryAndKb(db, opts);
233
+ }
234
+ catch (err) {
235
+ process.stderr.write(`[Dirgha] sync-index startup failed (live updates may stop): ${err.message}\n`);
236
+ }
237
+ let watcher = null;
238
+ try {
239
+ watcher = startWatchers(db, opts);
240
+ }
241
+ catch {
242
+ /* chokidar present but failed to attach — fall back to startup-only */
243
+ }
244
+ return { summary, watcher };
245
+ }
246
+ //# sourceMappingURL=sync-index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sync-index.js","sourceRoot":"","sources":["../../src/state/sync-index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,62 @@
1
+ /**
2
+ * Multi-model transactional API. Wraps relational + FTS + vector + graph
3
+ * writes in a single SQLite BEGIN IMMEDIATE / COMMIT, so an agent can
4
+ * fire a furious burst of cross-model writes and either get them all or
5
+ * get nothing — no partial state.
6
+ *
7
+ * Use from agent tools (transactional_write tool exposes this) or from
8
+ * direct callers. The callback receives a typed `tx` object; throw or
9
+ * abort to roll back.
10
+ */
11
+ export interface MessageWrite {
12
+ role: "user" | "assistant" | "system" | "tool";
13
+ content: string;
14
+ ts?: number;
15
+ session_id?: string;
16
+ }
17
+ export interface EmbeddingWrite {
18
+ source: string;
19
+ chunk: string;
20
+ vec: number[];
21
+ }
22
+ export interface GraphNodeWrite {
23
+ id: string;
24
+ type: string;
25
+ props?: Record<string, unknown>;
26
+ }
27
+ export interface GraphEdgeWrite {
28
+ src: string;
29
+ dst: string;
30
+ rel: string;
31
+ props?: Record<string, unknown>;
32
+ }
33
+ export interface TxResult {
34
+ message_id?: number;
35
+ embedding_id?: number;
36
+ node_ids: string[];
37
+ edge_keys: string[];
38
+ }
39
+ export interface TxApi {
40
+ message: {
41
+ insert(w: MessageWrite): number;
42
+ };
43
+ embedding: {
44
+ insert(w: EmbeddingWrite): number;
45
+ };
46
+ graph: {
47
+ addNode(w: GraphNodeWrite): string;
48
+ addEdge(w: GraphEdgeWrite): {
49
+ src: string;
50
+ dst: string;
51
+ rel: string;
52
+ };
53
+ };
54
+ }
55
+ /**
56
+ * Run a callback inside a single SQLite transaction. All writes (messages,
57
+ * embeddings, graph nodes, graph edges) commit atomically via BEGIN IMMEDIATE.
58
+ *
59
+ * Pass an optional Database handle for testing with in-memory databases;
60
+ * defaults to the shared `openDb()` singleton.
61
+ */
62
+ export declare function transactional<T>(fn: (tx: TxApi) => T, db?: import("better-sqlite3").Database): T;
@@ -0,0 +1,65 @@
1
+ /**
2
+ * Multi-model transactional API. Wraps relational + FTS + vector + graph
3
+ * writes in a single SQLite BEGIN IMMEDIATE / COMMIT, so an agent can
4
+ * fire a furious burst of cross-model writes and either get them all or
5
+ * get nothing — no partial state.
6
+ *
7
+ * Use from agent tools (transactional_write tool exposes this) or from
8
+ * direct callers. The callback receives a typed `tx` object; throw or
9
+ * abort to roll back.
10
+ */
11
+ import { openDb } from "./db.js";
12
+ /**
13
+ * Run a callback inside a single SQLite transaction. All writes (messages,
14
+ * embeddings, graph nodes, graph edges) commit atomically via BEGIN IMMEDIATE.
15
+ *
16
+ * Pass an optional Database handle for testing with in-memory databases;
17
+ * defaults to the shared `openDb()` singleton.
18
+ */
19
+ export function transactional(fn, db) {
20
+ const d = db ?? openDb();
21
+ // BEGIN IMMEDIATE — acquires write lock now (not deferred), so concurrent
22
+ // writers serialise instead of failing late with SQLITE_BUSY.
23
+ const txn = d.transaction((apiFn) => {
24
+ const api = {
25
+ message: {
26
+ insert(w) {
27
+ const ts = w.ts ?? Date.now();
28
+ const session = w.session_id ?? "default";
29
+ const stmt = d.prepare("INSERT INTO messages(session_id, role, content, ts) VALUES (?,?,?,?)");
30
+ const r = stmt.run(session, w.role, w.content, ts);
31
+ return r.lastInsertRowid;
32
+ },
33
+ },
34
+ embedding: {
35
+ insert(w) {
36
+ if (!Array.isArray(w.vec) || w.vec.length === 0) {
37
+ throw new Error("embedding.vec must be a non-empty number array");
38
+ }
39
+ // sqlite-vec's vec0 virtual table uses JSON-serialised float[]
40
+ const vecJson = JSON.stringify(w.vec);
41
+ const ins = d.prepare("INSERT INTO embeddings(embedding) VALUES (?)");
42
+ const r = ins.run(vecJson);
43
+ const rowid = r.lastInsertRowid;
44
+ d.prepare("INSERT INTO embedding_meta(id, source, chunk, ts) VALUES (?,?,?,?)").run(rowid, w.source, w.chunk, Date.now());
45
+ return rowid;
46
+ },
47
+ },
48
+ graph: {
49
+ addNode(w) {
50
+ d.prepare("INSERT INTO graph_nodes(id, type, props) VALUES (?,?,?) " +
51
+ "ON CONFLICT(id) DO UPDATE SET type=excluded.type, props=excluded.props").run(w.id, w.type, w.props ? JSON.stringify(w.props) : null);
52
+ return w.id;
53
+ },
54
+ addEdge(w) {
55
+ d.prepare("INSERT INTO graph_edges(src, dst, rel, props) VALUES (?,?,?,?) " +
56
+ "ON CONFLICT(src, dst, rel) DO UPDATE SET props=excluded.props").run(w.src, w.dst, w.rel, w.props ? JSON.stringify(w.props) : null);
57
+ return { src: w.src, dst: w.dst, rel: w.rel };
58
+ },
59
+ },
60
+ };
61
+ return apiFn(api);
62
+ });
63
+ return txn.immediate(fn);
64
+ }
65
+ //# sourceMappingURL=transaction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transaction.js","sourceRoot":"","sources":["../../src/state/transaction.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,28 @@
1
+ /**
2
+ * sqlite-vec extension loader and vector schema migration.
3
+ *
4
+ * sqlite-vec is an optional native binding. On platforms where it
5
+ * isn't available the CLI continues with FTS5 + relational search;
6
+ * vector features are no-ops with a stderr warning.
7
+ */
8
+ /**
9
+ * Load the sqlite-vec extension into the open database handle.
10
+ * On failure the CLI continues with vector features disabled.
11
+ */
12
+ export declare function loadVecExtension(db: import("better-sqlite3").Database): void;
13
+ /**
14
+ * Idempotent vector schema migration. Creates the embeddings virtual
15
+ * table (vec0) and a sidecar embedding_meta table. If the vec extension
16
+ * is absent, the virtual table step is skipped via savepoint — the meta
17
+ * table and index are still created so relational lookups work.
18
+ */
19
+ export declare function migrateVecSchema(db: import("better-sqlite3").Database): void;
20
+ /**
21
+ * Returns true when sqlite-vec is loaded and vec_version() responds.
22
+ * Used by `dirgha doctor` for the extension status line.
23
+ */
24
+ export declare function isVecLoaded(db: import("better-sqlite3").Database): boolean;
25
+ /**
26
+ * Return the loaded vec version string, or null when unavailable.
27
+ */
28
+ export declare function vecVersion(db: import("better-sqlite3").Database): string | null;
@@ -0,0 +1,113 @@
1
+ /**
2
+ * sqlite-vec extension loader and vector schema migration.
3
+ *
4
+ * sqlite-vec is an optional native binding. On platforms where it
5
+ * isn't available the CLI continues with FTS5 + relational search;
6
+ * vector features are no-ops with a stderr warning.
7
+ */
8
+ import { createRequire } from "node:module";
9
+ import { recordDbError } from "./db-telemetry.js";
10
+ const _require = createRequire(import.meta.url);
11
+ let _sqliteVec = null;
12
+ try {
13
+ _sqliteVec = _require("sqlite-vec");
14
+ }
15
+ catch {
16
+ /* optional dependency not installed on this platform */
17
+ }
18
+ /**
19
+ * Load the sqlite-vec extension into the open database handle.
20
+ * On failure the CLI continues with vector features disabled.
21
+ */
22
+ export function loadVecExtension(db) {
23
+ if (!_sqliteVec)
24
+ return;
25
+ try {
26
+ _sqliteVec.load(db);
27
+ try {
28
+ const row = db
29
+ .prepare("SELECT vec_version() AS version")
30
+ .get();
31
+ if (row?.version) {
32
+ process.stderr.write(`[Dirgha] sqlite-vec v${row.version} loaded\n`);
33
+ }
34
+ }
35
+ catch {
36
+ /* extension loaded but version probe failed — unusual, non-fatal */
37
+ }
38
+ migrateVecSchema(db);
39
+ }
40
+ catch (err) {
41
+ process.stderr.write(`[Dirgha] sqlite-vec extension failed to load (vector search disabled): ${err.message}\n`);
42
+ }
43
+ }
44
+ /**
45
+ * Idempotent vector schema migration. Creates the embeddings virtual
46
+ * table (vec0) and a sidecar embedding_meta table. If the vec extension
47
+ * is absent, the virtual table step is skipped via savepoint — the meta
48
+ * table and index are still created so relational lookups work.
49
+ */
50
+ export function migrateVecSchema(db) {
51
+ try {
52
+ // embedding_meta + index are always safe (no extension required).
53
+ db.exec(`
54
+ CREATE TABLE IF NOT EXISTS embedding_meta (
55
+ id INTEGER PRIMARY KEY,
56
+ source TEXT NOT NULL,
57
+ chunk TEXT NOT NULL,
58
+ ts INTEGER NOT NULL
59
+ );
60
+ CREATE INDEX IF NOT EXISTS idx_embedding_meta_source
61
+ ON embedding_meta(source);
62
+ `);
63
+ // Virtual table wrapped in savepoint for graceful fallback when vec
64
+ // is absent. If vec0 module is not loaded, rollback and log; meta
65
+ // table survives.
66
+ db.exec("SAVEPOINT vec_migration");
67
+ try {
68
+ db.exec(`
69
+ CREATE VIRTUAL TABLE IF NOT EXISTS embeddings USING vec0(
70
+ embedding float[384]
71
+ );
72
+ `);
73
+ db.exec("RELEASE vec_migration");
74
+ }
75
+ catch (err) {
76
+ db.exec("ROLLBACK TO vec_migration");
77
+ process.stderr.write(`[Dirgha] vec virtual table creation failed (vector search disabled): ${err.message}\n`);
78
+ }
79
+ }
80
+ catch (err) {
81
+ recordDbError(err);
82
+ }
83
+ }
84
+ /**
85
+ * Returns true when sqlite-vec is loaded and vec_version() responds.
86
+ * Used by `dirgha doctor` for the extension status line.
87
+ */
88
+ export function isVecLoaded(db) {
89
+ try {
90
+ const row = db
91
+ .prepare("SELECT vec_version() AS version")
92
+ .get();
93
+ return Boolean(row?.version);
94
+ }
95
+ catch {
96
+ return false;
97
+ }
98
+ }
99
+ /**
100
+ * Return the loaded vec version string, or null when unavailable.
101
+ */
102
+ export function vecVersion(db) {
103
+ try {
104
+ const row = db
105
+ .prepare("SELECT vec_version() AS version")
106
+ .get();
107
+ return row?.version ?? null;
108
+ }
109
+ catch {
110
+ return null;
111
+ }
112
+ }
113
+ //# sourceMappingURL=vec.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vec.js","sourceRoot":"","sources":["../../src/state/vec.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEhD,IAAI,UAAU,GAAuC,IAAI,CAAC;AAC1D,IAAI,CAAC;IACH,UAAU,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;AACtC,CAAC;AAAC,MAAM,CAAC;IACP,wDAAwD;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAqC;IAErC,IAAI,CAAC,UAAU;QAAE,OAAO;IAExB,IAAI,CAAC;QACH,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEpB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,EAAE;iBACX,OAAO,CAAC,iCAAiC,CAAC;iBAC1C,GAAG,EAA0B,CAAC;YACjC,IAAI,GAAG,EAAE,OAAO,EAAE,CAAC;gBACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;QACtE,CAAC;QAED,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,0EAA2E,GAAa,CAAC,OAAO,IAAI,CACrG,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,EAAqC;IAErC,IAAI,CAAC;QACH,kEAAkE;QAClE,EAAE,CAAC,IAAI,CAAC;;;;;;;;;KASP,CAAC,CAAC;QAEH,oEAAoE;QACpE,kEAAkE;QAClE,kBAAkB;QAClB,EAAE,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC;;;;OAIP,CAAC,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;YACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,wEAAyE,GAAa,CAAC,OAAO,IAAI,CACnG,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,aAAa,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,EAAqC;IAErC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE;aACX,OAAO,CAAC,iCAAiC,CAAC;aAC1C,GAAG,EAAsC,CAAC;QAC7C,OAAO,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,EAAqC;IAErC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE;aACX,OAAO,CAAC,iCAAiC,CAAC;aAC1C,GAAG,EAAsC,CAAC;QAC7C,OAAO,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
@@ -0,0 +1,17 @@
1
+ /**
2
+ * Push CLI audit entries to the Dirgha gateway so they surface in the
3
+ * web IDE dashboard under the active agent session.
4
+ *
5
+ * Every function here is fire-and-forget: network errors, auth failures,
6
+ * and timeouts are all silently swallowed. Telemetry must never crash or
7
+ * slow down the CLI.
8
+ */
9
+ import type { AuditEntry } from '../safety/audit-log.js';
10
+ /**
11
+ * POST each audit entry to the gateway's agent-session log endpoint.
12
+ *
13
+ * @param sessionId The agent session ID (from AgentLoopConfig).
14
+ * @param entries Audit entries returned by `drainPending()`.
15
+ * @param token JWT bearer token from `~/.dirgha/credentials.json`.
16
+ */
17
+ export declare function pushAuditEntries(sessionId: string, entries: AuditEntry[], token: string): Promise<void>;