@dirgha/code 1.22.0 → 1.23.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 (272) 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 +12 -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 +45 -1
  16. package/dist/cli/interactive.js.map +1 -1
  17. package/dist/cli/main.js +69 -18
  18. package/dist/cli/main.js.map +1 -1
  19. package/dist/cli/slash/fleet.js +19 -1
  20. package/dist/cli/slash/fleet.js.map +1 -1
  21. package/dist/cli/slash/index.d.ts +2 -1
  22. package/dist/cli/slash/index.js +3 -1
  23. package/dist/cli/slash/index.js.map +1 -1
  24. package/dist/cli/slash/models.js +4 -2
  25. package/dist/cli/slash/models.js.map +1 -1
  26. package/dist/cli/slash/paste.js +4 -7
  27. package/dist/cli/slash/paste.js.map +1 -1
  28. package/dist/cli/slash/sandbox.d.ts +21 -0
  29. package/dist/cli/slash/sandbox.js +84 -0
  30. package/dist/cli/slash/sandbox.js.map +1 -0
  31. package/dist/cli/slash.d.ts +5 -0
  32. package/dist/cli/slash.js +26 -10
  33. package/dist/cli/slash.js.map +1 -1
  34. package/dist/cli/subcommands/audit.js +28 -8
  35. package/dist/cli/subcommands/audit.js.map +1 -1
  36. package/dist/cli/subcommands/doctor.d.ts +4 -0
  37. package/dist/cli/subcommands/doctor.js +117 -21
  38. package/dist/cli/subcommands/doctor.js.map +1 -1
  39. package/dist/cli/subcommands/feature-setup.js +6 -6
  40. package/dist/cli/subcommands/feature-setup.js.map +1 -1
  41. package/dist/cli/subcommands/memory.js +23 -0
  42. package/dist/cli/subcommands/memory.js.map +1 -1
  43. package/dist/cli/subcommands/telemetry.d.ts +2 -1
  44. package/dist/cli/subcommands/telemetry.js +47 -34
  45. package/dist/cli/subcommands/telemetry.js.map +1 -1
  46. package/dist/context/branch.d.ts +2 -2
  47. package/dist/context/branch.js +40 -23
  48. package/dist/context/branch.js.map +1 -1
  49. package/dist/context/compaction.js +44 -21
  50. package/dist/context/compaction.js.map +1 -1
  51. package/dist/context/default-soul.md +1 -0
  52. package/dist/context/git-state.js +31 -18
  53. package/dist/context/git-state.js.map +1 -1
  54. package/dist/context/knowledge.js +31 -20
  55. package/dist/context/knowledge.js.map +1 -1
  56. package/dist/context/memory.js +8 -1
  57. package/dist/context/memory.js.map +1 -1
  58. package/dist/context/mode-enforcement.js +11 -1
  59. package/dist/context/mode-enforcement.js.map +1 -1
  60. package/dist/context/mode.js +67 -30
  61. package/dist/context/mode.js.map +1 -1
  62. package/dist/context/primer.d.ts +17 -0
  63. package/dist/context/primer.js +50 -3
  64. package/dist/context/primer.js.map +1 -1
  65. package/dist/context/session.d.ts +4 -0
  66. package/dist/context/session.js.map +1 -1
  67. package/dist/embeddings/iface.d.ts +26 -0
  68. package/dist/embeddings/iface.js +15 -0
  69. package/dist/embeddings/iface.js.map +1 -0
  70. package/dist/embeddings/local.d.ts +24 -0
  71. package/dist/embeddings/local.js +112 -0
  72. package/dist/embeddings/local.js.map +1 -0
  73. package/dist/embeddings/remote.d.ts +31 -0
  74. package/dist/embeddings/remote.js +88 -0
  75. package/dist/embeddings/remote.js.map +1 -0
  76. package/dist/embeddings/select.d.ts +24 -0
  77. package/dist/embeddings/select.js +39 -0
  78. package/dist/embeddings/select.js.map +1 -0
  79. package/dist/fleet/apply-back.js +5 -1
  80. package/dist/fleet/apply-back.js.map +1 -1
  81. package/dist/fleet/cli-command.d.ts +2 -0
  82. package/dist/fleet/cli-command.js +15 -1
  83. package/dist/fleet/cli-command.js.map +1 -1
  84. package/dist/fleet/runner.js +35 -2
  85. package/dist/fleet/runner.js.map +1 -1
  86. package/dist/fleet/scratchpad.js +1 -2
  87. package/dist/fleet/scratchpad.js.map +1 -1
  88. package/dist/fleet/state.d.ts +4 -0
  89. package/dist/fleet/state.js +11 -2
  90. package/dist/fleet/state.js.map +1 -1
  91. package/dist/fleet/templates.d.ts +4 -0
  92. package/dist/fleet/templates.js.map +1 -1
  93. package/dist/fleet/types.d.ts +4 -0
  94. package/dist/fleet/types.js.map +1 -1
  95. package/dist/intelligence/failover-chain.js +10 -1
  96. package/dist/intelligence/failover-chain.js.map +1 -1
  97. package/dist/intelligence/prices.d.ts +6 -4
  98. package/dist/intelligence/prices.js +36 -10
  99. package/dist/intelligence/prices.js.map +1 -1
  100. package/dist/kernel/agent-loop.js +60 -17
  101. package/dist/kernel/agent-loop.js.map +1 -1
  102. package/dist/kernel/types.d.ts +3 -0
  103. package/dist/lsp/client.js +29 -16
  104. package/dist/lsp/client.js.map +1 -1
  105. package/dist/lsp/detector.js +7 -6
  106. package/dist/lsp/detector.js.map +1 -1
  107. package/dist/mcp/client.d.ts +1 -1
  108. package/dist/mcp/client.js +19 -16
  109. package/dist/mcp/client.js.map +1 -1
  110. package/dist/mcp/transport.js +46 -38
  111. package/dist/mcp/transport.js.map +1 -1
  112. package/dist/providers/deepseek.js +1 -1
  113. package/dist/providers/deepseek.js.map +1 -1
  114. package/dist/providers/dispatch.js +15 -1
  115. package/dist/providers/dispatch.js.map +1 -1
  116. package/dist/providers/index.d.ts +11 -0
  117. package/dist/providers/index.js +29 -2
  118. package/dist/providers/index.js.map +1 -1
  119. package/dist/providers/nvidia.js +1 -1
  120. package/dist/providers/nvidia.js.map +1 -1
  121. package/dist/providers/openai-compat.js +4 -2
  122. package/dist/providers/openai-compat.js.map +1 -1
  123. package/dist/providers/openrouter.js +1 -1
  124. package/dist/providers/openrouter.js.map +1 -1
  125. package/dist/safety/audit-log.d.ts +15 -0
  126. package/dist/safety/audit-log.js +21 -0
  127. package/dist/safety/audit-log.js.map +1 -1
  128. package/dist/state/db-telemetry.js +11 -1
  129. package/dist/state/db-telemetry.js.map +1 -1
  130. package/dist/state/db.d.ts +7 -0
  131. package/dist/state/db.js +125 -3
  132. package/dist/state/db.js.map +1 -1
  133. package/dist/state/sync-index.d.ts +74 -0
  134. package/dist/state/sync-index.js +246 -0
  135. package/dist/state/sync-index.js.map +1 -0
  136. package/dist/state/transaction.d.ts +62 -0
  137. package/dist/state/transaction.js +65 -0
  138. package/dist/state/transaction.js.map +1 -0
  139. package/dist/state/vec.d.ts +28 -0
  140. package/dist/state/vec.js +113 -0
  141. package/dist/state/vec.js.map +1 -0
  142. package/dist/telemetry/gateway-push.d.ts +17 -0
  143. package/dist/telemetry/gateway-push.js +48 -0
  144. package/dist/telemetry/gateway-push.js.map +1 -0
  145. package/dist/telemetry/index.d.ts +9 -0
  146. package/dist/telemetry/index.js +9 -0
  147. package/dist/telemetry/index.js.map +1 -0
  148. package/dist/tools/browser.js +24 -16
  149. package/dist/tools/browser.js.map +1 -1
  150. package/dist/tools/checkpoint.d.ts +6 -1
  151. package/dist/tools/checkpoint.js +79 -62
  152. package/dist/tools/checkpoint.js.map +1 -1
  153. package/dist/tools/cron.js +1 -3
  154. package/dist/tools/cron.js.map +1 -1
  155. package/dist/tools/db-workspace-info.d.ts +10 -0
  156. package/dist/tools/db-workspace-info.js +76 -0
  157. package/dist/tools/db-workspace-info.js.map +1 -0
  158. package/dist/tools/diff.js +25 -21
  159. package/dist/tools/diff.js.map +1 -1
  160. package/dist/tools/exec.d.ts +6 -1
  161. package/dist/tools/exec.js +46 -4
  162. package/dist/tools/exec.js.map +1 -1
  163. package/dist/tools/fs-edit.d.ts +3 -5
  164. package/dist/tools/fs-edit.js +8 -23
  165. package/dist/tools/fs-edit.js.map +1 -1
  166. package/dist/tools/fs-ls.js +6 -8
  167. package/dist/tools/fs-ls.js.map +1 -1
  168. package/dist/tools/fs-read.d.ts +1 -1
  169. package/dist/tools/fs-read.js +37 -28
  170. package/dist/tools/fs-read.js.map +1 -1
  171. package/dist/tools/fs-write.d.ts +1 -1
  172. package/dist/tools/fs-write.js +33 -33
  173. package/dist/tools/fs-write.js.map +1 -1
  174. package/dist/tools/git.js +12 -6
  175. package/dist/tools/git.js.map +1 -1
  176. package/dist/tools/github.d.ts +13 -0
  177. package/dist/tools/github.js +257 -0
  178. package/dist/tools/github.js.map +1 -0
  179. package/dist/tools/graph-neighbors.d.ts +9 -0
  180. package/dist/tools/graph-neighbors.js +77 -0
  181. package/dist/tools/graph-neighbors.js.map +1 -0
  182. package/dist/tools/graph-traverse.d.ts +10 -0
  183. package/dist/tools/graph-traverse.js +90 -0
  184. package/dist/tools/graph-traverse.js.map +1 -0
  185. package/dist/tools/index.d.ts +10 -2
  186. package/dist/tools/index.js +17 -4
  187. package/dist/tools/index.js.map +1 -1
  188. package/dist/tools/kb-search.d.ts +13 -0
  189. package/dist/tools/kb-search.js +113 -0
  190. package/dist/tools/kb-search.js.map +1 -0
  191. package/dist/tools/multimodal.js +11 -12
  192. package/dist/tools/multimodal.js.map +1 -1
  193. package/dist/tools/registry.d.ts +10 -0
  194. package/dist/tools/registry.js.map +1 -1
  195. package/dist/tools/rtk.js +22 -9
  196. package/dist/tools/rtk.js.map +1 -1
  197. package/dist/tools/search-glob.d.ts +1 -1
  198. package/dist/tools/search-glob.js +42 -24
  199. package/dist/tools/search-glob.js.map +1 -1
  200. package/dist/tools/search-grep.d.ts +1 -1
  201. package/dist/tools/search-grep.js +56 -32
  202. package/dist/tools/search-grep.js.map +1 -1
  203. package/dist/tools/shell.d.ts +7 -1
  204. package/dist/tools/shell.js +178 -61
  205. package/dist/tools/shell.js.map +1 -1
  206. package/dist/tools/transactional-write.d.ts +10 -0
  207. package/dist/tools/transactional-write.js +132 -0
  208. package/dist/tools/transactional-write.js.map +1 -0
  209. package/dist/tui/ink/App.d.ts +2 -1
  210. package/dist/tui/ink/App.js +304 -74
  211. package/dist/tui/ink/App.js.map +1 -1
  212. package/dist/tui/ink/components/DenseToolMessage.js +20 -3
  213. package/dist/tui/ink/components/DenseToolMessage.js.map +1 -1
  214. package/dist/tui/ink/components/InputBox.js +16 -15
  215. package/dist/tui/ink/components/InputBox.js.map +1 -1
  216. package/dist/tui/ink/components/KeySetOverlay.d.ts +1 -1
  217. package/dist/tui/ink/components/KeySetOverlay.js +18 -16
  218. package/dist/tui/ink/components/KeySetOverlay.js.map +1 -1
  219. package/dist/tui/ink/components/Logo.d.ts +20 -0
  220. package/dist/tui/ink/components/Logo.js +67 -1
  221. package/dist/tui/ink/components/Logo.js.map +1 -1
  222. package/dist/tui/ink/components/ModelPicker.d.ts +2 -2
  223. package/dist/tui/ink/components/ModelPicker.js +34 -26
  224. package/dist/tui/ink/components/ModelPicker.js.map +1 -1
  225. package/dist/tui/ink/components/PasteCollapse.d.ts +3 -1
  226. package/dist/tui/ink/components/PasteCollapse.js +11 -9
  227. package/dist/tui/ink/components/PasteCollapse.js.map +1 -1
  228. package/dist/tui/ink/components/SandboxPicker.d.ts +18 -0
  229. package/dist/tui/ink/components/SandboxPicker.js +77 -0
  230. package/dist/tui/ink/components/SandboxPicker.js.map +1 -0
  231. package/dist/tui/ink/components/SpinnerGlyph.d.ts +4 -4
  232. package/dist/tui/ink/components/SpinnerGlyph.js +34 -14
  233. package/dist/tui/ink/components/SpinnerGlyph.js.map +1 -1
  234. package/dist/tui/ink/components/StatusBar.js +0 -2
  235. package/dist/tui/ink/components/StatusBar.js.map +1 -1
  236. package/dist/tui/ink/components/ThinkingBlock.d.ts +15 -4
  237. package/dist/tui/ink/components/ThinkingBlock.js +34 -17
  238. package/dist/tui/ink/components/ThinkingBlock.js.map +1 -1
  239. package/dist/tui/ink/components/ToolBox.js +21 -13
  240. package/dist/tui/ink/components/ToolBox.js.map +1 -1
  241. package/dist/tui/ink/components/VirtualTranscript.d.ts +1 -1
  242. package/dist/tui/ink/components/VirtualTranscript.js +5 -3
  243. package/dist/tui/ink/components/VirtualTranscript.js.map +1 -1
  244. package/dist/tui/ink/index.js +17 -1
  245. package/dist/tui/ink/index.js.map +1 -1
  246. package/dist/tui/ink/markdown/syntax-highlight.d.ts +13 -0
  247. package/dist/tui/ink/markdown/syntax-highlight.js +91 -0
  248. package/dist/tui/ink/markdown/syntax-highlight.js.map +1 -0
  249. package/dist/tui/ink/theme-context.js +6 -3
  250. package/dist/tui/ink/theme-context.js.map +1 -1
  251. package/dist/tui/ink/use-declined-versions.js +6 -2
  252. package/dist/tui/ink/use-declined-versions.js.map +1 -1
  253. package/dist/tui/ink/use-elapsed.d.ts +9 -1
  254. package/dist/tui/ink/use-elapsed.js +17 -2
  255. package/dist/tui/ink/use-elapsed.js.map +1 -1
  256. package/dist/tui/ink/use-event-projection.d.ts +10 -0
  257. package/dist/tui/ink/use-event-projection.js +111 -12
  258. package/dist/tui/ink/use-event-projection.js.map +1 -1
  259. package/dist/tui/ink/use-flicker-detector.js +9 -0
  260. package/dist/tui/ink/use-flicker-detector.js.map +1 -1
  261. package/dist/tui/ink/use-overlays.d.ts +2 -2
  262. package/dist/tui/ink/use-overlays.js +16 -17
  263. package/dist/tui/ink/use-overlays.js.map +1 -1
  264. package/dist/tui/ink/use-render-metrics.js +18 -5
  265. package/dist/tui/ink/use-render-metrics.js.map +1 -1
  266. package/dist/utils/env.d.ts +1 -0
  267. package/dist/utils/env.js +60 -0
  268. package/dist/utils/env.js.map +1 -0
  269. package/dist/utils/fs.d.ts +10 -0
  270. package/dist/utils/fs.js +37 -0
  271. package/dist/utils/fs.js.map +1 -0
  272. package/package.json +10 -7
@@ -0,0 +1,257 @@
1
+ /**
2
+ * GitHub client tool.
3
+ *
4
+ * Wraps the `gh` CLI for common GitHub operations: creating / listing PRs,
5
+ * creating / listing issues, and viewing repo info. Every action returns
6
+ * structured JSON so the model can act on specific fields without parsing
7
+ * plain text.
8
+ *
9
+ * Requires the `gh` CLI to be installed and authenticated. The tool checks
10
+ * for the binary at call time and returns a clear error when it is absent.
11
+ */
12
+ import { spawn } from "node:child_process";
13
+ import { execFile } from "node:child_process";
14
+ import { promisify } from "node:util";
15
+ const execFileAsync = promisify(execFile);
16
+ const GH_TIMEOUT_MS = 30_000;
17
+ /** Resolve whether `gh` is available; returns path or null. */
18
+ async function resolveGh() {
19
+ try {
20
+ const { stdout } = await execFileAsync(process.platform === "win32" ? "where" : "which", ["gh"], { timeout: 3_000 });
21
+ return stdout.trim().split(/\r?\n/)[0] ?? null;
22
+ }
23
+ catch {
24
+ return null;
25
+ }
26
+ }
27
+ /** Run `gh` with the given args, collect stdout+stderr, return exit code + text. */
28
+ async function runGh(args, cwd, env) {
29
+ return new Promise((resolveAll) => {
30
+ const child = spawn("gh", args, {
31
+ cwd,
32
+ env,
33
+ stdio: ["pipe", "pipe", "pipe"],
34
+ });
35
+ const stdoutChunks = [];
36
+ const stderrChunks = [];
37
+ child.stdout.on("data", (buf) => stdoutChunks.push(buf));
38
+ child.stderr.on("data", (buf) => stderrChunks.push(buf));
39
+ const timer = setTimeout(() => {
40
+ child.kill("SIGTERM");
41
+ setTimeout(() => {
42
+ try {
43
+ child.kill("SIGKILL");
44
+ }
45
+ catch {
46
+ /* already gone */
47
+ }
48
+ }, 2_000);
49
+ }, GH_TIMEOUT_MS);
50
+ child.on("error", () => {
51
+ clearTimeout(timer);
52
+ resolveAll({ code: -1, stdout: "", stderr: "spawn error" });
53
+ });
54
+ child.on("close", (code) => {
55
+ clearTimeout(timer);
56
+ resolveAll({
57
+ code: code ?? -1,
58
+ stdout: Buffer.concat(stdoutChunks).toString("utf8"),
59
+ stderr: Buffer.concat(stderrChunks).toString("utf8"),
60
+ });
61
+ });
62
+ });
63
+ }
64
+ /** Build the `gh` args array for each action. */
65
+ function buildArgs(input) {
66
+ const lim = String(input.limit ?? 30);
67
+ switch (input.action) {
68
+ case "pr_create": {
69
+ const args = ["pr", "create", "--json", "number,url,title,state,draft"];
70
+ if (input.title)
71
+ args.push("--title", input.title);
72
+ if (input.body)
73
+ args.push("--body", input.body);
74
+ if (input.base)
75
+ args.push("--base", input.base);
76
+ if (input.draft)
77
+ args.push("--draft");
78
+ return args;
79
+ }
80
+ case "pr_list": {
81
+ const args = [
82
+ "pr",
83
+ "list",
84
+ "--limit",
85
+ lim,
86
+ "--json",
87
+ "number,url,title,state,draft,headRefName,author",
88
+ ];
89
+ if (input.state)
90
+ args.push("--state", input.state);
91
+ return args;
92
+ }
93
+ case "pr_view": {
94
+ const args = [
95
+ "pr",
96
+ "view",
97
+ "--json",
98
+ "number,url,title,state,body,draft,headRefName,baseRefName,author,reviews,checks",
99
+ ];
100
+ if (input.state) {
101
+ // pr view doesn't filter by state, but we can pass a number/branch via state
102
+ // treat it as a positional specifier when numeric
103
+ if (/^\d+$/.test(input.state))
104
+ args.push(input.state);
105
+ }
106
+ return args;
107
+ }
108
+ case "issue_list": {
109
+ const args = [
110
+ "issue",
111
+ "list",
112
+ "--limit",
113
+ lim,
114
+ "--json",
115
+ "number,url,title,state,labels,assignees,author,createdAt",
116
+ ];
117
+ if (input.state && input.state !== "merged") {
118
+ args.push("--state", input.state);
119
+ }
120
+ if (input.label && input.label.length > 0) {
121
+ args.push("--label", input.label.join(","));
122
+ }
123
+ return args;
124
+ }
125
+ case "issue_create": {
126
+ const args = [
127
+ "issue",
128
+ "create",
129
+ "--json",
130
+ "number,url,title",
131
+ ];
132
+ if (input.title)
133
+ args.push("--title", input.title);
134
+ if (input.body)
135
+ args.push("--body", input.body ?? "");
136
+ if (input.assignee)
137
+ args.push("--assignee", input.assignee);
138
+ if (input.label && input.label.length > 0) {
139
+ for (const l of input.label)
140
+ args.push("--label", l);
141
+ }
142
+ return args;
143
+ }
144
+ case "repo_view": {
145
+ return [
146
+ "repo",
147
+ "view",
148
+ "--json",
149
+ "name,description,url,defaultBranchRef,isPrivate,stargazerCount,forkCount,languages,licenseInfo,createdAt,pushedAt",
150
+ ];
151
+ }
152
+ }
153
+ }
154
+ export const githubTool = {
155
+ name: "github",
156
+ description: "Run GitHub operations via gh CLI: create PRs, list issues, view repo info. " +
157
+ "Requires the `gh` CLI to be installed and authenticated (`gh auth login`). " +
158
+ "All responses are structured JSON.",
159
+ inputSchema: {
160
+ type: "object",
161
+ properties: {
162
+ action: {
163
+ type: "string",
164
+ enum: [
165
+ "pr_create",
166
+ "pr_list",
167
+ "pr_view",
168
+ "issue_list",
169
+ "issue_create",
170
+ "repo_view",
171
+ ],
172
+ description: "The GitHub operation to perform.",
173
+ },
174
+ title: {
175
+ type: "string",
176
+ description: "PR or issue title (required for pr_create / issue_create).",
177
+ },
178
+ body: {
179
+ type: "string",
180
+ description: "PR or issue body text.",
181
+ },
182
+ base: {
183
+ type: "string",
184
+ description: "Target branch for pr_create (defaults to the repo default branch).",
185
+ },
186
+ draft: {
187
+ type: "boolean",
188
+ description: "Create PR as draft (pr_create only).",
189
+ },
190
+ assignee: {
191
+ type: "string",
192
+ description: "GitHub login to assign (issue_create only).",
193
+ },
194
+ label: {
195
+ type: "array",
196
+ items: { type: "string" },
197
+ description: "Labels to apply (issue_create / issue_list filter).",
198
+ },
199
+ state: {
200
+ type: "string",
201
+ enum: ["open", "closed", "merged"],
202
+ description: "Filter state for pr_list / issue_list, or PR number for pr_view.",
203
+ },
204
+ limit: {
205
+ type: "integer",
206
+ minimum: 1,
207
+ maximum: 200,
208
+ description: "Max items to return for list operations (default 30).",
209
+ },
210
+ },
211
+ required: ["action"],
212
+ },
213
+ timeoutMs: 35_000,
214
+ requiresApproval: (raw) => {
215
+ const input = raw;
216
+ // Mutations require approval; reads do not.
217
+ return input.action === "pr_create" || input.action === "issue_create";
218
+ },
219
+ async execute(rawInput, ctx) {
220
+ const input = rawInput;
221
+ const ghBin = await resolveGh();
222
+ if (!ghBin) {
223
+ return {
224
+ content: "gh CLI not found. Install it from https://cli.github.com and run `gh auth login`.",
225
+ isError: true,
226
+ };
227
+ }
228
+ const args = buildArgs(input);
229
+ ctx.onProgress?.(`gh ${args.join(" ")}`);
230
+ const result = await runGh(args, ctx.cwd, ctx.env);
231
+ if (result.code !== 0) {
232
+ const detail = result.stderr.trim() || result.stdout.trim();
233
+ return {
234
+ content: `gh exited with code ${result.code}: ${detail}`,
235
+ data: { action: input.action, exitCode: result.code, data: null },
236
+ isError: true,
237
+ };
238
+ }
239
+ let parsed = null;
240
+ try {
241
+ parsed = JSON.parse(result.stdout);
242
+ }
243
+ catch {
244
+ // Some gh commands don't output JSON even with --json (e.g. interactive
245
+ // prompts fall through). Return raw text in that case.
246
+ parsed = result.stdout.trim();
247
+ }
248
+ return {
249
+ content: typeof parsed === "string"
250
+ ? parsed
251
+ : JSON.stringify(parsed, null, 2),
252
+ data: { action: input.action, exitCode: result.code, data: parsed },
253
+ isError: false,
254
+ };
255
+ },
256
+ };
257
+ //# sourceMappingURL=github.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"github.js","sourceRoot":"","sources":["../../src/tools/github.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * graph_neighbors tool — one-hop graph neighbour lookup.
3
+ *
4
+ * Returns immediate neighbours of a graph node via directed edges.
5
+ * Filterable by relation label and direction (out/in/both).
6
+ * Uses the same SQLite DB as the relational + FTS stores.
7
+ */
8
+ import type { Tool } from "./registry.js";
9
+ export declare const graphNeighborsTool: Tool;
@@ -0,0 +1,77 @@
1
+ /**
2
+ * graph_neighbors tool — one-hop graph neighbour lookup.
3
+ *
4
+ * Returns immediate neighbours of a graph node via directed edges.
5
+ * Filterable by relation label and direction (out/in/both).
6
+ * Uses the same SQLite DB as the relational + FTS stores.
7
+ */
8
+ import { openDb } from "../state/db.js";
9
+ export const graphNeighborsTool = {
10
+ name: "graph_neighbors",
11
+ description: "Return the immediate (one-hop) neighbours of a graph node. Filter by " +
12
+ "relation label and direction. 'out' = outgoing edges (this node is " +
13
+ "the source); 'in' = incoming; 'both' = union.",
14
+ inputSchema: {
15
+ type: "object",
16
+ properties: {
17
+ node_id: { type: "string" },
18
+ rel: { type: "string" },
19
+ direction: { type: "string", enum: ["out", "in", "both"] },
20
+ },
21
+ required: ["node_id"],
22
+ },
23
+ async execute(rawInput, _ctx) {
24
+ const input = rawInput;
25
+ if (!input.node_id) {
26
+ return { content: "node_id is required", isError: true };
27
+ }
28
+ const dir = input.direction ?? "out";
29
+ const db = openDb();
30
+ const rows = [];
31
+ try {
32
+ if (dir === "out" || dir === "both") {
33
+ const sql = input.rel
34
+ ? `SELECT e.dst AS id, e.rel, n.type, n.props
35
+ FROM graph_edges e LEFT JOIN graph_nodes n ON n.id = e.dst
36
+ WHERE e.src = ? AND e.rel = ? ORDER BY e.ts`
37
+ : `SELECT e.dst AS id, e.rel, n.type, n.props
38
+ FROM graph_edges e LEFT JOIN graph_nodes n ON n.id = e.dst
39
+ WHERE e.src = ? ORDER BY e.ts`;
40
+ const params = input.rel
41
+ ? [input.node_id, input.rel]
42
+ : [input.node_id];
43
+ for (const r of db.prepare(sql).all(...params)) {
44
+ rows.push({ ...r, direction: "out" });
45
+ }
46
+ }
47
+ if (dir === "in" || dir === "both") {
48
+ const sql = input.rel
49
+ ? `SELECT e.src AS id, e.rel, n.type, n.props
50
+ FROM graph_edges e LEFT JOIN graph_nodes n ON n.id = e.src
51
+ WHERE e.dst = ? AND e.rel = ? ORDER BY e.ts`
52
+ : `SELECT e.src AS id, e.rel, n.type, n.props
53
+ FROM graph_edges e LEFT JOIN graph_nodes n ON n.id = e.src
54
+ WHERE e.dst = ? ORDER BY e.ts`;
55
+ const params = input.rel
56
+ ? [input.node_id, input.rel]
57
+ : [input.node_id];
58
+ for (const r of db.prepare(sql).all(...params)) {
59
+ rows.push({ ...r, direction: "in" });
60
+ }
61
+ }
62
+ }
63
+ catch (err) {
64
+ return {
65
+ content: `graph_neighbors failed: ${err.message}`,
66
+ isError: true,
67
+ };
68
+ }
69
+ const summary = rows.length === 0
70
+ ? `no neighbours of ${input.node_id}${input.rel ? ` via ${input.rel}` : ""}`
71
+ : rows
72
+ .map((n) => `${n.direction === "out" ? "→" : "←"} ${n.id} (${n.rel}) [${n.type ?? "?"}]`)
73
+ .join("\n");
74
+ return { content: summary, data: rows, isError: false };
75
+ },
76
+ };
77
+ //# sourceMappingURL=graph-neighbors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph-neighbors.js","sourceRoot":"","sources":["../../src/tools/graph-neighbors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAgBxC,MAAM,CAAC,MAAM,kBAAkB,GAAS;IACtC,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,uEAAuE;QACvE,qEAAqE;QACrE,+CAA+C;IACjD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC3B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE;SAC3D;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IACD,KAAK,CAAC,OAAO,CAAC,QAAiB,EAAE,IAAI;QACnC,MAAM,KAAK,GAAG,QAAiB,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3D,CAAC;QACD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC;QACrC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,GAAe,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACpC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG;oBACnB,CAAC,CAAC;;yDAE6C;oBAC/C,CAAC,CAAC;;2CAE+B,CAAC;gBACpC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG;oBACtB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC;oBAC5B,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACpB,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAE5C,EAAE,CAAC;oBACF,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,EAAc,CAAC,CAAC;gBACpD,CAAC;YACH,CAAC;YACD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACnC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG;oBACnB,CAAC,CAAC;;yDAE6C;oBAC/C,CAAC,CAAC;;2CAE+B,CAAC;gBACpC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG;oBACtB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC;oBAC5B,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACpB,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAE5C,EAAE,CAAC;oBACF,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAc,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,2BAA4B,GAAa,CAAC,OAAO,EAAE;gBAC5D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,KAAK,CAAC;YACf,CAAC,CAAC,oBAAoB,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5E,CAAC,CAAC,IAAI;iBACD,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,GAAG,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,IAAI,GAAG,GAAG,CAC/E;iBACA,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC1D,CAAC;CACF,CAAC"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * graph_traverse tool — recursive forward traversal from a starting node.
3
+ *
4
+ * Uses a SQLite recursive CTE to walk graph_edges. Returns each reachable
5
+ * node with depth, the relation it was reached via, and the parent node.
6
+ * Bounded by max_depth + max_results. Cycles are detected and skipped via
7
+ * a path-tracking column.
8
+ */
9
+ import type { Tool } from "./registry.js";
10
+ export declare const graphTraverseTool: Tool;
@@ -0,0 +1,90 @@
1
+ /**
2
+ * graph_traverse tool — recursive forward traversal from a starting node.
3
+ *
4
+ * Uses a SQLite recursive CTE to walk graph_edges. Returns each reachable
5
+ * node with depth, the relation it was reached via, and the parent node.
6
+ * Bounded by max_depth + max_results. Cycles are detected and skipped via
7
+ * a path-tracking column.
8
+ */
9
+ import { openDb } from "../state/db.js";
10
+ export const graphTraverseTool = {
11
+ name: "graph_traverse",
12
+ description: "Recursive forward traversal from a starting node. Returns each " +
13
+ "reachable node with its depth, the relation it was reached via, and " +
14
+ "the parent. Bounded by max_depth + max_results to prevent runaway " +
15
+ "queries on cyclic graphs (cycles are detected and skipped).",
16
+ inputSchema: {
17
+ type: "object",
18
+ properties: {
19
+ start_id: { type: "string" },
20
+ rel: { type: "string" },
21
+ max_depth: { type: "integer", minimum: 1, maximum: 50 },
22
+ max_results: { type: "integer", minimum: 1, maximum: 10000 },
23
+ },
24
+ required: ["start_id"],
25
+ },
26
+ async execute(rawInput, _ctx) {
27
+ const input = rawInput;
28
+ if (!input.start_id) {
29
+ return { content: "start_id is required", isError: true };
30
+ }
31
+ const maxDepth = input.max_depth ?? 3;
32
+ const maxResults = input.max_results ?? 100;
33
+ const db = openDb();
34
+ try {
35
+ const sql = input.rel
36
+ ? `
37
+ WITH RECURSIVE walk(depth, node_id, type, via_rel, parent_id, path) AS (
38
+ SELECT 0, n.id, n.type, NULL, NULL, ',' || n.id || ','
39
+ FROM graph_nodes n WHERE n.id = ?
40
+ UNION ALL
41
+ SELECT w.depth + 1, e.dst, n.type, e.rel, e.src,
42
+ w.path || e.dst || ','
43
+ FROM graph_edges e
44
+ JOIN walk w ON w.node_id = e.src
45
+ LEFT JOIN graph_nodes n ON n.id = e.dst
46
+ WHERE e.rel = ?
47
+ AND w.depth < ?
48
+ AND instr(w.path, ',' || e.dst || ',') = 0
49
+ )
50
+ SELECT depth, node_id, type, via_rel, parent_id
51
+ FROM walk LIMIT ?
52
+ `
53
+ : `
54
+ WITH RECURSIVE walk(depth, node_id, type, via_rel, parent_id, path) AS (
55
+ SELECT 0, n.id, n.type, NULL, NULL, ',' || n.id || ','
56
+ FROM graph_nodes n WHERE n.id = ?
57
+ UNION ALL
58
+ SELECT w.depth + 1, e.dst, n.type, e.rel, e.src,
59
+ w.path || e.dst || ','
60
+ FROM graph_edges e
61
+ JOIN walk w ON w.node_id = e.src
62
+ LEFT JOIN graph_nodes n ON n.id = e.dst
63
+ WHERE w.depth < ?
64
+ AND instr(w.path, ',' || e.dst || ',') = 0
65
+ )
66
+ SELECT depth, node_id, type, via_rel, parent_id
67
+ FROM walk LIMIT ?
68
+ `;
69
+ const params = input.rel
70
+ ? [input.start_id, input.rel, maxDepth, maxResults]
71
+ : [input.start_id, maxDepth, maxResults];
72
+ const rows = db.prepare(sql).all(...params);
73
+ const summary = rows.length === 0
74
+ ? `node ${input.start_id} not found or has no outgoing edges`
75
+ : rows
76
+ .map((p) => `${" ".repeat(p.depth)}${p.depth === 0 ? "●" : "→"} ${p.node_id}` +
77
+ `${p.type ? ` [${p.type}]` : ""}` +
78
+ `${p.via_rel ? ` (via ${p.via_rel})` : ""}`)
79
+ .join("\n");
80
+ return { content: summary, data: rows, isError: false };
81
+ }
82
+ catch (err) {
83
+ return {
84
+ content: `graph_traverse failed: ${err.message}`,
85
+ isError: true,
86
+ };
87
+ }
88
+ },
89
+ };
90
+ //# sourceMappingURL=graph-traverse.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"graph-traverse.js","sourceRoot":"","sources":["../../src/tools/graph-traverse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAiBxC,MAAM,CAAC,MAAM,iBAAiB,GAAS;IACrC,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,iEAAiE;QACjE,sEAAsE;QACtE,oEAAoE;QACpE,6DAA6D;IAC/D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC5B,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvB,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE;YACvD,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE;SAC7D;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;IACD,KAAK,CAAC,OAAO,CAAC,QAAiB,EAAE,IAAI;QACnC,MAAM,KAAK,GAAG,QAAiB,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,IAAI,GAAG,CAAC;QAC5C,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG;gBACnB,CAAC,CAAC;;;;;;;;;;;;;;;;SAgBD;gBACD,CAAC,CAAC;;;;;;;;;;;;;;;SAeD,CAAC;YACJ,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG;gBACtB,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,UAAU,CAAC;gBACnD,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC3C,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAW,CAAC;YACtD,MAAM,OAAO,GACX,IAAI,CAAC,MAAM,KAAK,CAAC;gBACf,CAAC,CAAC,QAAQ,KAAK,CAAC,QAAQ,qCAAqC;gBAC7D,CAAC,CAAC,IAAI;qBACD,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CACJ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE;oBAClE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBACjC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC9C;qBACA,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,0BAA2B,GAAa,CAAC,OAAO,EAAE;gBAC3D,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
@@ -13,16 +13,24 @@ import { searchGrepTool } from "./search-grep.js";
13
13
  import { searchGlobTool } from "./search-glob.js";
14
14
  import { gitTool } from "./git.js";
15
15
  import { browserTool } from "./browser.js";
16
- import { checkpointTool } from "./checkpoint.js";
17
16
  import { lspGoToDefinitionTool } from "./lsp-definition.js";
18
17
  import { lspFindReferencesTool } from "./lsp-references.js";
19
18
  import { lspHoverTool } from "./lsp-hover.js";
20
19
  import { lspDocumentSymbolsTool } from "./lsp-symbols.js";
21
20
  import { rtkTool } from "./rtk.js";
22
21
  import { qmdTool } from "./qmd.js";
22
+ import { githubTool } from "./github.js";
23
+ import { kbSearchTool } from "./kb-search.js";
24
+ import { graphNeighborsTool } from "./graph-neighbors.js";
25
+ import { graphTraverseTool } from "./graph-traverse.js";
26
+ import { transactionalWriteTool } from "./transactional-write.js";
27
+ import { dbWorkspaceInfoTool } from "./db-workspace-info.js";
28
+ export { createMultimodalTool } from "./multimodal.js";
23
29
  export { createCronTool } from "./cron.js";
30
+ export { createCheckpointTool } from "./checkpoint.js";
24
31
  export { createTaskTool } from "./task.js";
25
32
  declare const cronTool: Tool;
33
+ declare const checkpointTool: Tool;
26
34
  export * from "./registry.js";
27
35
  export * from "./permission.js";
28
36
  export * from "./exec.js";
@@ -32,4 +40,4 @@ export * from "./lsp-references.js";
32
40
  export * from "./lsp-hover.js";
33
41
  export * from "./lsp-symbols.js";
34
42
  export declare const builtInTools: Tool[];
35
- export { fsReadTool, fsWriteTool, fsEditTool, fsLsTool, shellTool, searchGrepTool, searchGlobTool, gitTool, browserTool, checkpointTool, cronTool, lspGoToDefinitionTool, lspFindReferencesTool, lspHoverTool, lspDocumentSymbolsTool, rtkTool, qmdTool, };
43
+ export { fsReadTool, fsWriteTool, fsEditTool, fsLsTool, shellTool, searchGrepTool, searchGlobTool, gitTool, githubTool, browserTool, checkpointTool, cronTool, lspGoToDefinitionTool, lspFindReferencesTool, lspHoverTool, lspDocumentSymbolsTool, rtkTool, qmdTool, kbSearchTool, graphNeighborsTool, graphTraverseTool, transactionalWriteTool, dbWorkspaceInfoTool, };
@@ -12,7 +12,7 @@ import { searchGrepTool } from "./search-grep.js";
12
12
  import { searchGlobTool } from "./search-glob.js";
13
13
  import { gitTool } from "./git.js";
14
14
  import { browserTool } from "./browser.js";
15
- import { checkpointTool } from "./checkpoint.js";
15
+ import { createCheckpointTool } from "./checkpoint.js";
16
16
  import { createCronTool } from "./cron.js";
17
17
  import { lspGoToDefinitionTool } from "./lsp-definition.js";
18
18
  import { lspFindReferencesTool } from "./lsp-references.js";
@@ -20,11 +20,18 @@ import { lspHoverTool } from "./lsp-hover.js";
20
20
  import { lspDocumentSymbolsTool } from "./lsp-symbols.js";
21
21
  import { rtkTool } from "./rtk.js";
22
22
  import { qmdTool } from "./qmd.js";
23
- // multimodal is a factory (needs runtime Provider) — wired in main.ts, not baked into builtInTools
24
- // export { createMultimodalTool } from "./multimodal.js";
23
+ import { githubTool } from "./github.js";
24
+ import { kbSearchTool } from "./kb-search.js";
25
+ import { graphNeighborsTool } from "./graph-neighbors.js";
26
+ import { graphTraverseTool } from "./graph-traverse.js";
27
+ import { transactionalWriteTool } from "./transactional-write.js";
28
+ import { dbWorkspaceInfoTool } from "./db-workspace-info.js";
29
+ export { createMultimodalTool } from "./multimodal.js";
25
30
  export { createCronTool } from "./cron.js";
31
+ export { createCheckpointTool } from "./checkpoint.js";
26
32
  export { createTaskTool } from "./task.js";
27
33
  const cronTool = createCronTool();
34
+ const checkpointTool = createCheckpointTool();
28
35
  export * from "./registry.js";
29
36
  export * from "./permission.js";
30
37
  export * from "./exec.js";
@@ -42,6 +49,7 @@ export const builtInTools = [
42
49
  searchGrepTool,
43
50
  searchGlobTool,
44
51
  gitTool,
52
+ githubTool,
45
53
  browserTool,
46
54
  checkpointTool,
47
55
  cronTool,
@@ -51,6 +59,11 @@ export const builtInTools = [
51
59
  lspDocumentSymbolsTool,
52
60
  rtkTool,
53
61
  qmdTool,
62
+ kbSearchTool,
63
+ graphNeighborsTool,
64
+ graphTraverseTool,
65
+ transactionalWriteTool,
66
+ dbWorkspaceInfoTool,
54
67
  ];
55
- export { fsReadTool, fsWriteTool, fsEditTool, fsLsTool, shellTool, searchGrepTool, searchGlobTool, gitTool, browserTool, checkpointTool, cronTool, lspGoToDefinitionTool, lspFindReferencesTool, lspHoverTool, lspDocumentSymbolsTool, rtkTool, qmdTool, };
68
+ export { fsReadTool, fsWriteTool, fsEditTool, fsLsTool, shellTool, searchGrepTool, searchGlobTool, gitTool, githubTool, browserTool, checkpointTool, cronTool, lspGoToDefinitionTool, lspFindReferencesTool, lspHoverTool, lspDocumentSymbolsTool, rtkTool, qmdTool, kbSearchTool, graphNeighborsTool, graphTraverseTool, transactionalWriteTool, dbWorkspaceInfoTool, };
56
69
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,mGAAmG;AACnG,0DAA0D;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;AAElC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAE1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAEjC,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,UAAU;IACV,WAAW;IACX,UAAU;IACV,QAAQ;IACR,SAAS;IACT,cAAc;IACd,cAAc;IACd,OAAO;IACP,WAAW;IACX,cAAc;IACd,QAAQ;IACR,qBAAqB;IACrB,qBAAqB;IACrB,YAAY;IACZ,sBAAsB;IACtB,OAAO;IACP,OAAO;CACR,CAAC;AAEF,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,SAAS,EACT,cAAc,EACd,cAAc,EACd,OAAO,EACP,WAAW,EACX,cAAc,EACd,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,OAAO,EACP,OAAO,GACR,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;AAClC,MAAM,cAAc,GAAG,oBAAoB,EAAE,CAAC;AAE9C,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAE1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AAEjC,MAAM,CAAC,MAAM,YAAY,GAAW;IAClC,UAAU;IACV,WAAW;IACX,UAAU;IACV,QAAQ;IACR,SAAS;IACT,cAAc;IACd,cAAc;IACd,OAAO;IACP,UAAU;IACV,WAAW;IACX,cAAc;IACd,QAAQ;IACR,qBAAqB;IACrB,qBAAqB;IACrB,YAAY;IACZ,sBAAsB;IACtB,OAAO;IACP,OAAO;IACP,YAAY;IACZ,kBAAkB;IAClB,iBAAiB;IACjB,sBAAsB;IACtB,mBAAmB;CACpB,CAAC;AAEF,OAAO,EACL,UAAU,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,SAAS,EACT,cAAc,EACd,cAAc,EACd,OAAO,EACP,UAAU,EACV,WAAW,EACX,cAAc,EACd,QAAQ,EACR,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,sBAAsB,EACtB,OAAO,EACP,OAAO,EACP,YAAY,EACZ,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACpB,CAAC"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * kb_search tool — cosine-similarity search over the local embeddings
3
+ * index. Uses sqlite-vec's vec0 virtual table + embedding_meta sidecar.
4
+ * Gracefully degrades when the vec extension is absent.
5
+ *
6
+ * Inputs accept either:
7
+ * - `query`: a string. We embed it via {@link selectEmbedder} (local
8
+ * Xenova by default, remote HTTP when `embeddingsEndpoint` is set).
9
+ * - `query_vector`: a pre-computed float[384] array. Backwards compat
10
+ * for callers that already have a vector in hand.
11
+ */
12
+ import type { Tool } from "./registry.js";
13
+ export declare const kbSearchTool: Tool;