@aria-cli/tools 1.0.9 → 1.0.11

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 (241) hide show
  1. package/package.json +9 -5
  2. package/src/__tests__/web-fetch-download.test.ts +0 -433
  3. package/src/__tests__/web-tools.test.ts +0 -619
  4. package/src/ask-user-interaction.ts +0 -33
  5. package/src/cache/web-cache.ts +0 -110
  6. package/src/definitions/arion.ts +0 -118
  7. package/src/definitions/browser/browser.ts +0 -502
  8. package/src/definitions/browser/index.ts +0 -5
  9. package/src/definitions/browser/pw-downloads.ts +0 -142
  10. package/src/definitions/browser/pw-interactions.ts +0 -282
  11. package/src/definitions/browser/pw-responses.ts +0 -98
  12. package/src/definitions/browser/pw-session.ts +0 -405
  13. package/src/definitions/browser/pw-shared.ts +0 -85
  14. package/src/definitions/browser/pw-snapshot.ts +0 -383
  15. package/src/definitions/browser/pw-state.ts +0 -101
  16. package/src/definitions/browser/types.ts +0 -203
  17. package/src/definitions/code-intelligence.ts +0 -526
  18. package/src/definitions/core.ts +0 -118
  19. package/src/definitions/delegation.ts +0 -567
  20. package/src/definitions/deploy.ts +0 -73
  21. package/src/definitions/filesystem.ts +0 -217
  22. package/src/definitions/frg.ts +0 -67
  23. package/src/definitions/index.ts +0 -28
  24. package/src/definitions/memory.ts +0 -150
  25. package/src/definitions/messaging.ts +0 -734
  26. package/src/definitions/meta.ts +0 -392
  27. package/src/definitions/network.ts +0 -179
  28. package/src/definitions/outlook.ts +0 -318
  29. package/src/definitions/patch/apply-patch.ts +0 -235
  30. package/src/definitions/patch/fuzzy-match.ts +0 -217
  31. package/src/definitions/patch/index.ts +0 -1
  32. package/src/definitions/patch/patch-parser.ts +0 -297
  33. package/src/definitions/patch/sandbox-paths.ts +0 -129
  34. package/src/definitions/process/index.ts +0 -5
  35. package/src/definitions/process/process-registry.ts +0 -303
  36. package/src/definitions/process/process.ts +0 -456
  37. package/src/definitions/process/pty-keys.ts +0 -298
  38. package/src/definitions/process/session-slug.ts +0 -147
  39. package/src/definitions/quip.ts +0 -225
  40. package/src/definitions/search.ts +0 -67
  41. package/src/definitions/session-history.ts +0 -79
  42. package/src/definitions/shell.ts +0 -202
  43. package/src/definitions/slack.ts +0 -211
  44. package/src/definitions/web.ts +0 -119
  45. package/src/executors/apply-patch.ts +0 -1035
  46. package/src/executors/arion.ts +0 -199
  47. package/src/executors/code-intelligence.ts +0 -1179
  48. package/src/executors/deploy.ts +0 -1066
  49. package/src/executors/filesystem.ts +0 -1428
  50. package/src/executors/frg-freshness.ts +0 -743
  51. package/src/executors/frg.ts +0 -394
  52. package/src/executors/index.ts +0 -280
  53. package/src/executors/learning-meta.ts +0 -1367
  54. package/src/executors/lsp-client.ts +0 -355
  55. package/src/executors/memory.ts +0 -978
  56. package/src/executors/meta.ts +0 -293
  57. package/src/executors/process-registry.ts +0 -570
  58. package/src/executors/pty-session-store.ts +0 -43
  59. package/src/executors/pty.ts +0 -342
  60. package/src/executors/restart.ts +0 -133
  61. package/src/executors/search-freshness.ts +0 -249
  62. package/src/executors/search-types.ts +0 -98
  63. package/src/executors/search.ts +0 -89
  64. package/src/executors/self-diagnose.ts +0 -552
  65. package/src/executors/session-history.ts +0 -435
  66. package/src/executors/shell-safety.ts +0 -519
  67. package/src/executors/shell.ts +0 -1243
  68. package/src/executors/utils.ts +0 -40
  69. package/src/executors/web.ts +0 -786
  70. package/src/extraction/content-extraction.ts +0 -281
  71. package/src/extraction/index.ts +0 -5
  72. package/src/headless-control-contract.ts +0 -1149
  73. package/src/index.ts +0 -788
  74. package/src/local-control-http-auth.ts +0 -2
  75. package/src/mcp/client.ts +0 -218
  76. package/src/mcp/connection.ts +0 -568
  77. package/src/mcp/index.ts +0 -11
  78. package/src/mcp/jsonrpc.ts +0 -195
  79. package/src/mcp/types.ts +0 -199
  80. package/src/network-control-adapter.ts +0 -88
  81. package/src/network-runtime/address-types.ts +0 -218
  82. package/src/network-runtime/db-owner-fencing.ts +0 -91
  83. package/src/network-runtime/delivery-receipts.ts +0 -372
  84. package/src/network-runtime/direct-endpoint-authority.ts +0 -35
  85. package/src/network-runtime/index.ts +0 -316
  86. package/src/network-runtime/local-control-contract.ts +0 -784
  87. package/src/network-runtime/node-store-contract.ts +0 -46
  88. package/src/network-runtime/pair-route-contract.ts +0 -97
  89. package/src/network-runtime/peer-capabilities.ts +0 -48
  90. package/src/network-runtime/peer-principal-ref.ts +0 -20
  91. package/src/network-runtime/peer-state-machine.ts +0 -160
  92. package/src/network-runtime/protocol-schemas.ts +0 -265
  93. package/src/network-runtime/runtime-bootstrap-contract.ts +0 -83
  94. package/src/outlook/desktop-session.ts +0 -409
  95. package/src/policy.ts +0 -171
  96. package/src/providers/brave.ts +0 -80
  97. package/src/providers/duckduckgo.ts +0 -199
  98. package/src/providers/exa.ts +0 -85
  99. package/src/providers/firecrawl.ts +0 -77
  100. package/src/providers/index.ts +0 -8
  101. package/src/providers/jina.ts +0 -70
  102. package/src/providers/router.ts +0 -121
  103. package/src/providers/search-provider.ts +0 -74
  104. package/src/providers/tavily.ts +0 -74
  105. package/src/quip/desktop-session.ts +0 -435
  106. package/src/registry/index.ts +0 -1
  107. package/src/registry/registry.ts +0 -905
  108. package/src/runtime-socket-local-control-client.ts +0 -632
  109. package/src/security/dns-normalization.ts +0 -34
  110. package/src/security/dns-pinning.ts +0 -138
  111. package/src/security/external-content.ts +0 -129
  112. package/src/security/ssrf.ts +0 -207
  113. package/src/slack/desktop-session.ts +0 -493
  114. package/src/tool-factory.ts +0 -91
  115. package/src/types.ts +0 -1341
  116. package/src/utils/retry.ts +0 -163
  117. package/src/utils/safe-parse-json.ts +0 -176
  118. package/src/utils/url.ts +0 -20
  119. package/tests/benchmarks/registry.bench.ts +0 -57
  120. package/tests/cache/web-cache.test.ts +0 -147
  121. package/tests/critical-integration.test.ts +0 -1465
  122. package/tests/definitions/apply-patch.test.ts +0 -586
  123. package/tests/definitions/browser.test.ts +0 -495
  124. package/tests/definitions/delegation-pause-resume.test.ts +0 -758
  125. package/tests/definitions/execution.test.ts +0 -671
  126. package/tests/definitions/messaging-inbox-scope.test.ts +0 -229
  127. package/tests/definitions/messaging.test.ts +0 -1468
  128. package/tests/definitions/outlook.test.ts +0 -30
  129. package/tests/definitions/process.test.ts +0 -469
  130. package/tests/definitions/slack.test.ts +0 -28
  131. package/tests/definitions/tool-inventory.test.ts +0 -218
  132. package/tests/e2e/delegation-quest-orchestration.e2e.test.ts +0 -433
  133. package/tests/e2e/memory-tool-discovery-contract.e2e.test.ts +0 -81
  134. package/tests/executors/apply-patch.test.ts +0 -538
  135. package/tests/executors/arion.test.ts +0 -309
  136. package/tests/executors/conversation-primitives.test.ts +0 -250
  137. package/tests/executors/deploy.test.ts +0 -746
  138. package/tests/executors/filesystem-tools.test.ts +0 -357
  139. package/tests/executors/filesystem.test.ts +0 -959
  140. package/tests/executors/frg-freshness.test.ts +0 -136
  141. package/tests/executors/frg-merge.test.ts +0 -70
  142. package/tests/executors/frg-session-content.test.ts +0 -40
  143. package/tests/executors/frg.test.ts +0 -56
  144. package/tests/executors/memory-bugfixes.test.ts +0 -257
  145. package/tests/executors/memory-real-memoria.integration.test.ts +0 -316
  146. package/tests/executors/memory.test.ts +0 -853
  147. package/tests/executors/meta-tools.test.ts +0 -411
  148. package/tests/executors/meta.test.ts +0 -683
  149. package/tests/executors/path-containment.test.ts +0 -51
  150. package/tests/executors/process-registry.test.ts +0 -505
  151. package/tests/executors/pty.test.ts +0 -664
  152. package/tests/executors/quest-security.test.ts +0 -249
  153. package/tests/executors/read-file-media.test.ts +0 -230
  154. package/tests/executors/recall-knowledge-schema.test.ts +0 -209
  155. package/tests/executors/recall-tags.test.ts +0 -278
  156. package/tests/executors/remember-null-safety.contract.test.ts +0 -41
  157. package/tests/executors/restart.test.ts +0 -67
  158. package/tests/executors/search-unified.test.ts +0 -381
  159. package/tests/executors/session-history.test.ts +0 -340
  160. package/tests/executors/session-transcript.test.ts +0 -561
  161. package/tests/executors/shell-abort.test.ts +0 -416
  162. package/tests/executors/shell-env-blocklist.test.ts +0 -648
  163. package/tests/executors/shell-env-process.test.ts +0 -245
  164. package/tests/executors/shell-process-registry.test.ts +0 -334
  165. package/tests/executors/shell-tools.test.ts +0 -393
  166. package/tests/executors/shell.test.ts +0 -690
  167. package/tests/executors/web-abort-vs-timeout.test.ts +0 -213
  168. package/tests/executors/web-integration.test.ts +0 -633
  169. package/tests/executors/web-symlink.test.ts +0 -18
  170. package/tests/executors/web.test.ts +0 -1400
  171. package/tests/executors/write-stdin.test.ts +0 -145
  172. package/tests/extraction/content-extraction.test.ts +0 -153
  173. package/tests/guards/tools-default-test-lane.integration.test.ts +0 -21
  174. package/tests/guards/tools-package-test-commands.e2e.test.ts +0 -43
  175. package/tests/guards/tools-test-lane-manifest.contract.test.ts +0 -76
  176. package/tests/guards/tools-vitest-workspace-alias.contract.test.ts +0 -63
  177. package/tests/helpers/async-waits.ts +0 -53
  178. package/tests/integration/headless-control-contract.integration.test.ts +0 -153
  179. package/tests/integration/memory-tool-schema-parity.integration.test.ts +0 -67
  180. package/tests/integration/meta-tools-round-trip.integration.test.ts +0 -506
  181. package/tests/integration/quest-round-trip.test.ts +0 -303
  182. package/tests/integration/registry-executor-flow.test.ts +0 -85
  183. package/tests/integration.test.ts +0 -177
  184. package/tests/loading-tier.test.ts +0 -126
  185. package/tests/mcp/client-reconnect.test.ts +0 -267
  186. package/tests/mcp/connection.test.ts +0 -846
  187. package/tests/mcp/injectable-logger.test.ts +0 -83
  188. package/tests/mcp/jsonrpc.test.ts +0 -109
  189. package/tests/mcp/lifecycle.test.ts +0 -879
  190. package/tests/network-runtime/address-types.contract.test.ts +0 -143
  191. package/tests/network-runtime/continuity-bind-schema.contract.test.ts +0 -203
  192. package/tests/network-runtime/local-control-contract.test.ts +0 -869
  193. package/tests/network-runtime/local-control-invite-token.contract.test.ts +0 -146
  194. package/tests/network-runtime/node-store-contract.test.ts +0 -11
  195. package/tests/network-runtime/pair-protocol-nodeid.contract.test.ts +0 -15
  196. package/tests/network-runtime/peer-state-machine.contract.test.ts +0 -148
  197. package/tests/network-runtime/protocol-schemas.contract.test.ts +0 -512
  198. package/tests/network-runtime/relay-pending-nodeid.contract.test.ts +0 -62
  199. package/tests/network-runtime/runtime-bootstrap-contract.test.ts +0 -227
  200. package/tests/network-runtime/runtime-socket-local-control-client.test.ts +0 -621
  201. package/tests/network-runtime/wait-for-message-script.test.ts +0 -288
  202. package/tests/parallel.test.ts +0 -71
  203. package/tests/policy.test.ts +0 -184
  204. package/tests/print-default-test-lane.ts +0 -14
  205. package/tests/print-test-lane-manifest.ts +0 -22
  206. package/tests/providers/brave.test.ts +0 -159
  207. package/tests/providers/duckduckgo.test.ts +0 -207
  208. package/tests/providers/exa.test.ts +0 -175
  209. package/tests/providers/firecrawl.test.ts +0 -168
  210. package/tests/providers/jina.test.ts +0 -144
  211. package/tests/providers/router.test.ts +0 -328
  212. package/tests/providers/tavily.test.ts +0 -165
  213. package/tests/registry/discovery.test.ts +0 -154
  214. package/tests/registry/injectable-logger.test.ts +0 -230
  215. package/tests/registry/input-validation.test.ts +0 -361
  216. package/tests/registry/interface-completeness.test.ts +0 -85
  217. package/tests/registry/mcp-integration.test.ts +0 -103
  218. package/tests/registry/mcp-read-only-hint.test.ts +0 -60
  219. package/tests/registry/memoria-discovery.test.ts +0 -390
  220. package/tests/registry/nested-validation.test.ts +0 -283
  221. package/tests/registry/pseudo-tool-filtering.test.ts +0 -258
  222. package/tests/registry/registration-lifecycle.test.ts +0 -133
  223. package/tests/registry-validation.test.ts +0 -424
  224. package/tests/registry.test.ts +0 -460
  225. package/tests/security/dns-pinning.test.ts +0 -162
  226. package/tests/security/external-content.test.ts +0 -144
  227. package/tests/security/ssrf.test.ts +0 -118
  228. package/tests/shell-safety-integration.test.ts +0 -32
  229. package/tests/shell-safety.test.ts +0 -365
  230. package/tests/slack/desktop-session.test.ts +0 -50
  231. package/tests/test-lane-manifest.ts +0 -440
  232. package/tests/test-utils.ts +0 -27
  233. package/tests/tool-factory.test.ts +0 -188
  234. package/tests/utils/retry.test.ts +0 -231
  235. package/tests/utils/url.test.ts +0 -63
  236. package/tsconfig.cjs.json +0 -24
  237. package/tsconfig.json +0 -12
  238. package/vitest.config.ts +0 -55
  239. package/vitest.e2e.config.ts +0 -24
  240. package/vitest.integration.config.ts +0 -24
  241. package/vitest.native.config.ts +0 -24
@@ -1,526 +0,0 @@
1
- /**
2
- * Code intelligence tool definitions
3
- *
4
- * 7 native tools wrapping external CLI binaries for code search, structural
5
- * analysis, knowledge graphs, LSP intelligence, and file discovery.
6
- */
7
-
8
- import type { JSONSchema7 } from "json-schema";
9
- import type { Tool } from "../types.js";
10
- import {
11
- executeRg,
12
- executeUg,
13
- executeProbe,
14
- executeSg,
15
- executeCbm,
16
- executeLsp,
17
- executeSerena,
18
- executeFff,
19
- } from "../executors/code-intelligence.js";
20
-
21
- // ---------------------------------------------------------------------------
22
- // rg — ripgrep
23
- // ---------------------------------------------------------------------------
24
-
25
- const rg: Tool = {
26
- name: "rg",
27
- description:
28
- "Fast text/regex search (ripgrep). SIMD-accelerated, .gitignore-aware. " +
29
- "Returns structured JSON matches with file, line, and text. " +
30
- "Use for finding strings, patterns, identifiers. Fastest grep available.",
31
- category: "code",
32
- parameters: {
33
- type: "object",
34
- properties: {
35
- pattern: { type: "string", description: "Search pattern (regex by default)" },
36
- path: { type: "string", description: "File or directory to search (default: working dir)" },
37
- ignore_case: { type: "boolean", description: "Case-insensitive search (-i)" },
38
- smart_case: {
39
- type: "boolean",
40
- description: "Case-insensitive unless pattern has uppercase (-S)",
41
- },
42
- fixed_strings: {
43
- type: "boolean",
44
- description: "Treat pattern as literal string, not regex (-F)",
45
- },
46
- word_regexp: { type: "boolean", description: "Match whole words only (-w)" },
47
- file_type: {
48
- type: "string",
49
- description: "File type filter: ts, py, rs, go, java, etc. (-t TYPE)",
50
- },
51
- glob: { type: "string", description: "Glob filter, prefix ! to exclude (-g GLOB)" },
52
- context: { type: "number", description: "Context lines around matches (-C NUM)" },
53
- max_count: { type: "number", description: "Max matches per file (-m NUM)", default: 100 },
54
- invert: { type: "boolean", description: "Show lines NOT matching (-v)" },
55
- files_only: { type: "boolean", description: "Only print file names with matches (-l)" },
56
- count: { type: "boolean", description: "Only print match count per file (-c)" },
57
- extra_args: {
58
- type: "array",
59
- items: { type: "string" },
60
- description:
61
- "Additional rg flags: ['--pcre2','-U','--max-depth=3','--hidden','--no-ignore','--type-not=test']",
62
- },
63
- },
64
- required: ["pattern"],
65
- } as JSONSchema7,
66
- riskLevel: "safe",
67
- isReadOnly: true,
68
- loadingTier: "always",
69
- execute: executeRg,
70
- };
71
-
72
- // ---------------------------------------------------------------------------
73
- // ug — ugrep
74
- // ---------------------------------------------------------------------------
75
-
76
- const ug: Tool = {
77
- name: "ug",
78
- description:
79
- "Text search with fuzzy matching, boolean queries, and archive search (ugrep). " +
80
- "Superset of ripgrep features. Use fuzzy for approximate matching (typos), " +
81
- "bool for AND/OR/NOT queries, decompress for searching inside zip/tar/gz.",
82
- category: "code",
83
- parameters: {
84
- type: "object",
85
- properties: {
86
- pattern: { type: "string", description: "Search pattern (regex by default)" },
87
- path: { type: "string", description: "File or directory to search (default: working dir)" },
88
- ignore_case: { type: "boolean", description: "Case-insensitive (-i)" },
89
- smart_case: {
90
- type: "boolean",
91
- description: "Smart case: insensitive unless uppercase present (-j)",
92
- },
93
- fixed_strings: { type: "boolean", description: "Literal string matching (-F)" },
94
- word_regexp: { type: "boolean", description: "Match whole words only (-w)" },
95
- file_type: { type: "string", description: "File type filter (-t TYPE)" },
96
- glob: { type: "string", description: "Glob filter (-g GLOB)" },
97
- context: { type: "number", description: "Context lines around matches (-C NUM)" },
98
- max_count: { type: "number", description: "Max matches per file (-m NUM)", default: 100 },
99
- fuzzy: {
100
- oneOf: [{ type: "boolean" }, { type: "number" }],
101
- description: "Fuzzy matching (-Z). true=default distance, number=max Levenshtein distance",
102
- },
103
- bool: {
104
- type: "boolean",
105
- description: "Boolean query mode (-%%). Pattern uses AND/OR/NOT: 'auth AND NOT test'",
106
- },
107
- neg_pattern: {
108
- type: "string",
109
- description: "Negative pattern — reject matching lines (-N PATTERN)",
110
- },
111
- files_only: { type: "boolean", description: "Only print file names (-l)" },
112
- count: { type: "boolean", description: "Only print match count per file (-c)" },
113
- decompress: {
114
- type: "boolean",
115
- description: "Search inside compressed files and archives (-z)",
116
- },
117
- extra_args: {
118
- type: "array",
119
- items: { type: "string" },
120
- description:
121
- "Additional ug flags: ['--depth=3','-O=ts,js','--min-size=1K','--format=%f:%n:%o']",
122
- },
123
- },
124
- required: ["pattern"],
125
- } as JSONSchema7,
126
- riskLevel: "safe",
127
- isReadOnly: true,
128
- loadingTier: "always",
129
- execute: executeUg,
130
- };
131
-
132
- // ---------------------------------------------------------------------------
133
- // probe
134
- // ---------------------------------------------------------------------------
135
-
136
- const probe: Tool = {
137
- name: "probe",
138
- description:
139
- "Ranked semantic code search with token budgeting (Probe). Returns complete functions/classes, " +
140
- "not line fragments. 4 commands: search (ES-style boolean queries with BM25 ranking), " +
141
- "extract (get code by file:line or file#symbol), symbols (list symbols in file), " +
142
- "query (AST pattern matching). Use max_tokens for LLM context budgeting, session for pagination.",
143
- category: "code",
144
- parameters: {
145
- type: "object",
146
- properties: {
147
- command: {
148
- type: "string",
149
- enum: ["search", "extract", "symbols", "query"],
150
- default: "search",
151
- description:
152
- "search=semantic search, extract=get code by line/symbol, symbols=list symbols, query=AST pattern",
153
- },
154
- query: {
155
- type: "string",
156
- description:
157
- "Search query (ES syntax: AND/OR/NOT, ext:rs, file:path, dir:tests) or AST pattern for query command",
158
- },
159
- path: { type: "string", description: "Directory to search (default: working dir)" },
160
- exact: {
161
- type: "boolean",
162
- description:
163
- "Exact match (true) vs stemmed search (false). 'getUserData' exact vs 'get','user','data'",
164
- },
165
- max_tokens: {
166
- type: "number",
167
- description: "Token budget — limit total output tokens for LLM context",
168
- },
169
- max_results: { type: "number", description: "Maximum number of results" },
170
- session: {
171
- type: "string",
172
- description: "Session ID for pagination. Reuse to get next page (dedup previous results)",
173
- },
174
- language: {
175
- type: "string",
176
- description: "Language filter: rust, typescript, python, go, java, etc.",
177
- },
178
- reranker: {
179
- type: "string",
180
- description: "Ranking algorithm: bm25 (default), tfidf, hybrid, hybrid2",
181
- },
182
- allow_tests: { type: "boolean", description: "Include test files in results" },
183
- files: {
184
- type: "array",
185
- items: { type: "string" },
186
- description:
187
- "File specs for extract and symbols commands: ['src/auth.ts:42', 'src/auth.ts#handleAuth', 'src/auth.ts:10-50']",
188
- },
189
- extra_args: {
190
- type: "array",
191
- items: { type: "string" },
192
- description: "Additional probe flags: ['--files-only','--no-merge','--lsp','--timeout=60']",
193
- },
194
- },
195
- required: [],
196
- } as JSONSchema7,
197
- riskLevel: "safe",
198
- isReadOnly: true,
199
- loadingTier: "always",
200
- execute: executeProbe,
201
- };
202
-
203
- // ---------------------------------------------------------------------------
204
- // sg — ast-grep
205
- // ---------------------------------------------------------------------------
206
-
207
- const sg: Tool = {
208
- name: "sg",
209
- description:
210
- "AST structural pattern matching and rewriting (ast-grep). Patterns look like real code. " +
211
- "$NAME matches single node, $$$ARGS matches variadic, $_ is wildcard. " +
212
- "Examples: 'console.log($MSG)', 'async function $NAME($$$PARAMS) { $$$BODY }'. " +
213
- "Set rewrite for search-and-replace refactoring. Use command='scan' with inline_rules for YAML rules.",
214
- category: "code",
215
- parameters: {
216
- type: "object",
217
- properties: {
218
- command: {
219
- type: "string",
220
- enum: ["run", "scan"],
221
- default: "run",
222
- description: "run=pattern match/rewrite, scan=rule-based scanning",
223
- },
224
- pattern: {
225
- type: "string",
226
- description:
227
- "AST pattern. $NAME=single node, $$$ARGS=variadic, $_=wildcard. " +
228
- "Examples: 'console.log($MSG)', 'async function $NAME($$$PARAMS) { $$$BODY }'",
229
- },
230
- language: {
231
- type: "string",
232
- description:
233
- "Language: typescript, python, rust, go, java, javascript, c, cpp, ruby, php, swift, kotlin",
234
- },
235
- rewrite: {
236
- type: "string",
237
- description:
238
- "Replacement pattern with same metavariables. Example: pattern='console.log($MSG)' rewrite='logger.info($MSG)'",
239
- },
240
- strictness: {
241
- type: "string",
242
- enum: ["cst", "smart", "ast", "relaxed", "signature"],
243
- description:
244
- "Matching strictness. smart=default, ast=ignore punctuation, relaxed=ignore comments",
245
- },
246
- globs: { type: "string", description: "File glob filter, prefix ! to exclude" },
247
- rule: { type: "string", description: "Path to a YAML rule file (for scan)" },
248
- inline_rules: {
249
- type: "string",
250
- description:
251
- "Inline YAML rule text (for scan). Example: 'id: no-console\\nlanguage: TypeScript\\nrule:\\n pattern: console.log($$$)'",
252
- },
253
- path: { type: "string", description: "Directory to search (default: working dir)" },
254
- update_all: { type: "boolean", description: "Apply all rewrites without confirmation (-U)" },
255
- context: { type: "number", description: "Context lines around matches (-C NUM)" },
256
- extra_args: {
257
- type: "array",
258
- items: { type: "string" },
259
- description:
260
- "Additional sg flags: ['--selector=function_declaration','--threads=4','--no-ignore=hidden']",
261
- },
262
- },
263
- required: [],
264
- } as JSONSchema7,
265
- riskLevel: "safe",
266
- isReadOnly: true,
267
- loadingTier: "always",
268
- execute: executeSg,
269
- };
270
-
271
- // ---------------------------------------------------------------------------
272
- // cbm — codebase-memory-mcp
273
- // ---------------------------------------------------------------------------
274
-
275
- const cbm: Tool = {
276
- name: "cbm",
277
- description:
278
- "Code knowledge graph (codebase-memory-mcp). Index codebases, search symbols, trace call chains, " +
279
- "analyze blast radius. Run action='index' once per project. Then: search (symbols by name/type/file), " +
280
- "trace (who calls this? what does it call?), impact (what breaks if I change this?), " +
281
- "context (360° view: definition + callers + callees in one call), architecture (project overview), " +
282
- "snippet (read source by qualified name), code_search (graph-augmented grep), cypher (raw Cypher query).",
283
- category: "code",
284
- parameters: {
285
- type: "object",
286
- properties: {
287
- action: {
288
- type: "string",
289
- enum: [
290
- "index",
291
- "search",
292
- "trace",
293
- "impact",
294
- "context",
295
- "snippet",
296
- "code_search",
297
- "architecture",
298
- "schema",
299
- "cypher",
300
- "list_projects",
301
- "delete_project",
302
- "status",
303
- ],
304
- description: "Action to perform",
305
- },
306
- path: { type: "string", description: "Repository path to index" },
307
- mode: {
308
- type: "string",
309
- enum: ["full", "fast"],
310
- description: "full=with git history, fast=skip git",
311
- },
312
- name: { type: "string", description: "Symbol name or regex pattern" },
313
- label: {
314
- type: "string",
315
- description:
316
- "Node type: Function, Class, Method, Interface, Enum, Type, Module, File, Route, Package",
317
- },
318
- file: { type: "string", description: "File path filter" },
319
- direction: {
320
- type: "string",
321
- enum: ["inbound", "outbound", "both"],
322
- default: "both",
323
- description: "inbound=callers, outbound=callees",
324
- },
325
- depth: { type: "number", description: "Traversal depth (1-5)", default: 3 },
326
- edge_types: {
327
- type: "array",
328
- items: { type: "string" },
329
- description:
330
- "Filter edges: CALLS, IMPORTS, INHERITS, IMPLEMENTS, USES_TYPE, TESTS, HTTP_CALLS",
331
- },
332
- scope: { type: "string", description: "Git diff scope: 'staged', 'HEAD~1', branch name" },
333
- base_branch: { type: "string", description: "Git branch for comparison", default: "main" },
334
- qualified_name: {
335
- type: "string",
336
- description: "Full qualified name from search results (for snippet)",
337
- },
338
- include_neighbors: {
339
- type: "boolean",
340
- description: "Include caller/callee names (for snippet)",
341
- },
342
- code_pattern: { type: "string", description: "Text search pattern (for code_search)" },
343
- regex: { type: "boolean", description: "Use regex for code_search" },
344
- code_mode: {
345
- type: "string",
346
- enum: ["compact", "full", "files"],
347
- description: "Output mode for code_search",
348
- },
349
- query: { type: "string", description: "Cypher query string (for cypher action)" },
350
- max_rows: { type: "number", description: "Max rows for cypher query" },
351
- project: {
352
- type: "string",
353
- description: "Project name (auto-detected if one project indexed)",
354
- },
355
- limit: { type: "number", description: "Max results", default: 20 },
356
- context: { type: "number", description: "Context lines for code_search" },
357
- },
358
- required: ["action"],
359
- } as JSONSchema7,
360
- riskLevel: "safe",
361
- isReadOnly: true,
362
- loadingTier: "always",
363
- execute: executeCbm,
364
- };
365
-
366
- // ---------------------------------------------------------------------------
367
- // lsp — native LSP client (direct JSON-RPC to language servers)
368
- // ---------------------------------------------------------------------------
369
-
370
- const lsp: Tool = {
371
- name: "lsp",
372
- description:
373
- "Compiler-accurate code intelligence via native LSP (Language Server Protocol). " +
374
- "Spawns real language servers directly — same as VS Code and Claude Code. " +
375
- "No Serena, no MCP, no HTTP. Supports: TypeScript, Python, Go, Rust, C/C++, Swift, Java, Kotlin, Lua, PHP, Ruby, C#. " +
376
- "Actions: definition (go-to-definition), references (find all references), " +
377
- "hover (type info + docs), symbols (document symbol list), rename (safe cross-file rename). " +
378
- "Line and character are 0-based. Server starts on first use and stays warm.",
379
- category: "code",
380
- parameters: {
381
- type: "object",
382
- properties: {
383
- action: {
384
- type: "string",
385
- enum: ["definition", "references", "hover", "symbols", "rename"],
386
- description:
387
- "definition=go to definition, references=find all references, " +
388
- "hover=type info and docs, symbols=list all symbols in file, " +
389
- "rename=rename symbol across codebase",
390
- },
391
- file: {
392
- type: "string",
393
- description:
394
- "File path (relative or absolute). Language server auto-detected from extension.",
395
- },
396
- line: {
397
- type: "number",
398
- description: "0-based line number (for definition, references, hover, rename)",
399
- },
400
- character: {
401
- type: "number",
402
- description: "0-based column/character offset (for definition, references, hover, rename)",
403
- },
404
- new_name: {
405
- type: "string",
406
- description: "New symbol name (for rename action only)",
407
- },
408
- },
409
- required: ["action", "file"],
410
- } as JSONSchema7,
411
- riskLevel: "safe",
412
- isReadOnly: true,
413
- loadingTier: "always",
414
- execute: executeLsp,
415
- };
416
-
417
- // ---------------------------------------------------------------------------
418
- // serena — LSP intelligence via HTTP project server
419
- // ---------------------------------------------------------------------------
420
-
421
- const serena: Tool = {
422
- name: "serena",
423
- description:
424
- "Compiler-accurate LSP symbol navigation and editing via Serena HTTP project server. " +
425
- "Use for symbol-level operations by name path (not line/column). " +
426
- "Actions: find_symbol, find_references, overview, replace_body, insert_after, insert_before, rename, search. " +
427
- "Requires: uvx --from 'git+https://github.com/oraios/serena' serena start-project-server --port 9750",
428
- category: "code",
429
- parameters: {
430
- type: "object",
431
- properties: {
432
- action: {
433
- type: "string",
434
- enum: [
435
- "find_symbol",
436
- "find_references",
437
- "overview",
438
- "replace_body",
439
- "insert_after",
440
- "insert_before",
441
- "rename",
442
- "search",
443
- ],
444
- description: "Serena action",
445
- },
446
- name_path: {
447
- type: "string",
448
- description: "Symbol name path: 'handleAuth', 'MyClass/myMethod', '/TopLevel/Nested'",
449
- },
450
- relative_path: { type: "string", description: "Restrict to file or directory" },
451
- include_body: { type: "boolean", description: "Include source code of the symbol" },
452
- include_info: { type: "boolean", description: "Include hover info (docstring, signature)" },
453
- depth: { type: "number", description: "Descendants depth (1=immediate children)" },
454
- body: { type: "string", description: "New code content (for replace_body/insert)" },
455
- new_name: { type: "string", description: "New symbol name (for rename)" },
456
- pattern: { type: "string", description: "Regex pattern (for search action)" },
457
- context_before: { type: "number", description: "Context lines before match" },
458
- context_after: { type: "number", description: "Context lines after match" },
459
- paths_include: { type: "string", description: "Glob to include files" },
460
- paths_exclude: { type: "string", description: "Glob to exclude files" },
461
- extra_args: { type: "object", description: "Additional Serena API params" },
462
- },
463
- required: ["action"],
464
- } as JSONSchema7,
465
- riskLevel: "safe",
466
- isReadOnly: true,
467
- loadingTier: "always",
468
- execute: executeSerena,
469
- };
470
-
471
- // ---------------------------------------------------------------------------
472
- // fff — frecency-aware file finder
473
- // ---------------------------------------------------------------------------
474
-
475
- const fff: Tool = {
476
- name: "fff",
477
- description:
478
- "Frecency-aware fuzzy file finder and grep (fff). Files you access often rank higher. " +
479
- "3 actions: grep (search file contents), find_files (fuzzy file search by topic), " +
480
- "multi_grep (OR-search across multiple patterns). Use constraints for filtering: " +
481
- "'*.rs' (type), 'src/' (dir), 'schema.rs' (file), '!test/' (exclude).",
482
- category: "code",
483
- parameters: {
484
- type: "object",
485
- properties: {
486
- action: {
487
- type: "string",
488
- enum: ["grep", "find_files", "multi_grep"],
489
- description:
490
- "grep=search contents, find_files=fuzzy file search, multi_grep=OR-search multiple patterns",
491
- },
492
- query: { type: "string", description: "Search text or topic description" },
493
- patterns: {
494
- type: "array",
495
- items: { type: "string" },
496
- description: "Multiple patterns for OR-search (multi_grep only)",
497
- },
498
- constraints: {
499
- type: "string",
500
- description:
501
- "Inline constraints: '*.rs' (type), 'src/' (dir), 'schema.rs' (file), '!test/' (exclude)",
502
- },
503
- path: { type: "string", description: "Directory to search (default: working dir)" },
504
- },
505
- required: ["action"],
506
- } as JSONSchema7,
507
- riskLevel: "safe",
508
- isReadOnly: true,
509
- loadingTier: "always",
510
- execute: executeFff,
511
- };
512
-
513
- // ---------------------------------------------------------------------------
514
- // Export
515
- // ---------------------------------------------------------------------------
516
-
517
- export const CODE_INTELLIGENCE_TOOL_DEFINITIONS: Tool[] = [
518
- rg,
519
- ug,
520
- probe,
521
- sg,
522
- cbm,
523
- lsp,
524
- serena,
525
- fff,
526
- ];
@@ -1,118 +0,0 @@
1
- /**
2
- * Core tool definitions for ARIA
3
- * Core tools across 10 definition groups:
4
- * memory (5), web (3+1), filesystem (8), shell (7+1), arion (4), delegation (3), messaging (4+2), network (2), deploy (1), meta (11)
5
- *
6
- * Individual category definitions are in their respective files.
7
- * This module assembles them into the unified CORE_TOOL_DEFINITIONS array.
8
- * browser and process are forked from OpenClaw (MIT) and added directly here.
9
- */
10
-
11
- import type { Tool, ToolCategory, RiskLevel } from "../types.js";
12
- import { MEMORY_TOOL_DEFINITIONS } from "./memory.js";
13
- import { WEB_TOOL_DEFINITIONS } from "./web.js";
14
- import { FILESYSTEM_TOOL_DEFINITIONS } from "./filesystem.js";
15
- import { SHELL_TOOL_DEFINITIONS } from "./shell.js";
16
- import { ARION_TOOL_DEFINITIONS } from "./arion.js";
17
- import { DELEGATION_TOOL_DEFINITIONS } from "./delegation.js";
18
- import { MESSAGING_TOOL_DEFINITIONS } from "./messaging.js";
19
- import { SLACK_TOOL_DEFINITIONS } from "./slack.js";
20
- import { OUTLOOK_TOOL_DEFINITIONS } from "./outlook.js";
21
- import { QUIP_TOOL_DEFINITIONS } from "./quip.js";
22
- import { NETWORK_TOOL_DEFINITIONS } from "./network.js";
23
- import { DEPLOY_TOOL_DEFINITIONS } from "./deploy.js";
24
- import { META_TOOL_DEFINITIONS } from "./meta.js";
25
- import { SESSION_HISTORY_TOOL_DEFINITIONS } from "./session-history.js";
26
- import { FRG_TOOL_DEFINITIONS } from "./frg.js";
27
- import { CODE_INTELLIGENCE_TOOL_DEFINITIONS } from "./code-intelligence.js";
28
- import { SEARCH_TOOL_DEFINITIONS } from "./search.js";
29
-
30
- // OpenClaw forks (MIT) — Playwright browser automation and background process management
31
- import { browserTool } from "./browser/index.js";
32
- import { processTool } from "./process/index.js";
33
-
34
- // Re-export category arrays for direct access
35
- export { MEMORY_TOOL_DEFINITIONS } from "./memory.js";
36
- export { WEB_TOOL_DEFINITIONS } from "./web.js";
37
- export { FILESYSTEM_TOOL_DEFINITIONS } from "./filesystem.js";
38
- export { SHELL_TOOL_DEFINITIONS } from "./shell.js";
39
- export { ARION_TOOL_DEFINITIONS } from "./arion.js";
40
- export { DELEGATION_TOOL_DEFINITIONS } from "./delegation.js";
41
- export { MESSAGING_TOOL_DEFINITIONS } from "./messaging.js";
42
- export { SLACK_TOOL_DEFINITIONS } from "./slack.js";
43
- export { OUTLOOK_TOOL_DEFINITIONS } from "./outlook.js";
44
- export { QUIP_TOOL_DEFINITIONS } from "./quip.js";
45
- export { NETWORK_TOOL_DEFINITIONS } from "./network.js";
46
- export { DEPLOY_TOOL_DEFINITIONS } from "./deploy.js";
47
- export { META_TOOL_DEFINITIONS } from "./meta.js";
48
- export { SESSION_HISTORY_TOOL_DEFINITIONS } from "./session-history.js";
49
- export { FRG_TOOL_DEFINITIONS } from "./frg.js";
50
- export { CODE_INTELLIGENCE_TOOL_DEFINITIONS } from "./code-intelligence.js";
51
- export { SEARCH_TOOL_DEFINITIONS } from "./search.js";
52
-
53
- /**
54
- * All core tool definitions
55
- */
56
- export const CORE_TOOL_DEFINITIONS: Tool[] = [
57
- // Memory tools (5)
58
- ...MEMORY_TOOL_DEFINITIONS,
59
- // Web tools (3 + browser)
60
- ...WEB_TOOL_DEFINITIONS,
61
- browserTool,
62
- // Filesystem tools (6: read_file, write_file, edit_file, glob, ls, apply_patch)
63
- ...FILESYSTEM_TOOL_DEFINITIONS,
64
- // Shell tools (7 + process)
65
- ...SHELL_TOOL_DEFINITIONS,
66
- processTool,
67
- // Arion tools (4)
68
- ...ARION_TOOL_DEFINITIONS,
69
- // Delegation tools (7): delegate_arion, spawn_worker, check_delegation, pause_delegation, resume_delegation, delegate_remote, quest_report
70
- ...DELEGATION_TOOL_DEFINITIONS,
71
- // Messaging tools (6): send_message, check_messages, search_messages, get_thread, check_slack_messages, send_slack_message
72
- ...MESSAGING_TOOL_DEFINITIONS,
73
- ...SLACK_TOOL_DEFINITIONS,
74
- ...OUTLOOK_TOOL_DEFINITIONS,
75
- ...QUIP_TOOL_DEFINITIONS,
76
- // Network tools (2): manage_network + list_clients
77
- ...NETWORK_TOOL_DEFINITIONS,
78
- // Deploy tools (1): deploy (SSH remote deployment)
79
- ...DEPLOY_TOOL_DEFINITIONS,
80
- // Meta tools (10): ask_user/quest plus learning/meta capability tools
81
- ...META_TOOL_DEFINITIONS,
82
- // Session History tools (1): session_history (list/search/get/current/stats/delete/set_title)
83
- ...SESSION_HISTORY_TOOL_DEFINITIONS,
84
- // Fast regex native tool (1): frg (index/search/status/update/replace)
85
- ...FRG_TOOL_DEFINITIONS,
86
- // Code Intelligence tools (7): rg, ug, probe, sg, cbm, serena, fff
87
- ...CODE_INTELLIGENCE_TOOL_DEFINITIONS,
88
- // Native indexed grep (1): grep (replaces TS grep with n-gram indexed Rust NAPI)
89
- ...SEARCH_TOOL_DEFINITIONS,
90
- ];
91
-
92
- /**
93
- * Get all core tools
94
- */
95
- export function getCoreTools(): Tool[] {
96
- return CORE_TOOL_DEFINITIONS;
97
- }
98
-
99
- /**
100
- * Get a core tool by name
101
- */
102
- export function getCoreTool(name: string): Tool | undefined {
103
- return CORE_TOOL_DEFINITIONS.find((tool) => tool.name === name);
104
- }
105
-
106
- /**
107
- * Get all tools in a category
108
- */
109
- export function getCoreToolsByCategory(category: ToolCategory): Tool[] {
110
- return CORE_TOOL_DEFINITIONS.filter((tool) => tool.category === category);
111
- }
112
-
113
- /**
114
- * Get all tools by risk level
115
- */
116
- export function getCoreToolsByRiskLevel(riskLevel: RiskLevel): Tool[] {
117
- return CORE_TOOL_DEFINITIONS.filter((tool) => tool.riskLevel === riskLevel);
118
- }