@easynet/agent-tool-buildin 0.0.42 → 0.0.44

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 (54) hide show
  1. package/dist/core-tools-manifest.json +1653 -1344
  2. package/dist/src/iterm/common.d.ts +43 -0
  3. package/dist/src/iterm/common.d.ts.map +1 -0
  4. package/dist/src/iterm/common.js +164 -0
  5. package/dist/src/iterm/common.js.map +1 -0
  6. package/dist/src/iterm/itermCreateTab.d.ts +30 -0
  7. package/dist/src/iterm/itermCreateTab.d.ts.map +1 -0
  8. package/dist/src/iterm/itermCreateTab.js +59 -0
  9. package/dist/src/iterm/itermCreateTab.js.map +1 -0
  10. package/dist/src/iterm/itermCreateWindow.d.ts +30 -0
  11. package/dist/src/iterm/itermCreateWindow.d.ts.map +1 -0
  12. package/dist/src/iterm/itermCreateWindow.js +62 -0
  13. package/dist/src/iterm/itermCreateWindow.js.map +1 -0
  14. package/dist/src/iterm/itermGetSessionInfo.d.ts +30 -0
  15. package/dist/src/iterm/itermGetSessionInfo.d.ts.map +1 -0
  16. package/dist/src/iterm/itermGetSessionInfo.js +41 -0
  17. package/dist/src/iterm/itermGetSessionInfo.js.map +1 -0
  18. package/dist/src/iterm/itermListCurrentWindowSessions.d.ts +43 -0
  19. package/dist/src/iterm/itermListCurrentWindowSessions.d.ts.map +1 -0
  20. package/dist/src/iterm/itermListCurrentWindowSessions.js +67 -0
  21. package/dist/src/iterm/itermListCurrentWindowSessions.js.map +1 -0
  22. package/dist/src/iterm/itermListWindows.d.ts +31 -0
  23. package/dist/src/iterm/itermListWindows.d.ts.map +1 -0
  24. package/dist/src/iterm/itermListWindows.js +73 -0
  25. package/dist/src/iterm/itermListWindows.js.map +1 -0
  26. package/dist/src/iterm/itermRename.d.ts +30 -0
  27. package/dist/src/iterm/itermRename.d.ts.map +1 -0
  28. package/dist/src/iterm/itermRename.js +49 -0
  29. package/dist/src/iterm/itermRename.js.map +1 -0
  30. package/dist/src/iterm/itermResizeWindow.d.ts +29 -0
  31. package/dist/src/iterm/itermResizeWindow.d.ts.map +1 -0
  32. package/dist/src/iterm/itermResizeWindow.js +53 -0
  33. package/dist/src/iterm/itermResizeWindow.js.map +1 -0
  34. package/dist/src/iterm/itermRunCommandInSession.d.ts +29 -0
  35. package/dist/src/iterm/itermRunCommandInSession.d.ts.map +1 -0
  36. package/dist/src/iterm/itermRunCommandInSession.js +37 -0
  37. package/dist/src/iterm/itermRunCommandInSession.js.map +1 -0
  38. package/dist/src/iterm/itermSendText.d.ts +28 -0
  39. package/dist/src/iterm/itermSendText.d.ts.map +1 -0
  40. package/dist/src/iterm/itermSendText.js +47 -0
  41. package/dist/src/iterm/itermSendText.js.map +1 -0
  42. package/dist/src/iterm/itermSetBackgroundColor.d.ts +35 -0
  43. package/dist/src/iterm/itermSetBackgroundColor.d.ts.map +1 -0
  44. package/dist/src/iterm/itermSetBackgroundColor.js +41 -0
  45. package/dist/src/iterm/itermSetBackgroundColor.js.map +1 -0
  46. package/dist/src/iterm/itermSplitPane.d.ts +32 -0
  47. package/dist/src/iterm/itermSplitPane.d.ts.map +1 -0
  48. package/dist/src/iterm/itermSplitPane.js +57 -0
  49. package/dist/src/iterm/itermSplitPane.js.map +1 -0
  50. package/dist/src/iterm/itermTools.d.ts +11 -209
  51. package/dist/src/iterm/itermTools.d.ts.map +1 -1
  52. package/dist/src/iterm/itermTools.js +11 -533
  53. package/dist/src/iterm/itermTools.js.map +1 -1
  54. package/package.json +3 -1
package/dist/core-tools-manifest.json CHANGED
@@ -2,36 +2,34 @@
2
2
  "kind": "core",
3
3
  "tools": [
4
4
  {
5
- "name": "analyzeLog",
6
- "description": "Analyze log text via OpenAI-compatible LLM, identifying errors, root causes, and suggestions.",
5
+ "name": "itermCreateWindow",
6
+ "description": "Create a new iTerm2 window, optionally with profile/command and initial names.",
7
7
  "inputSchema": {
8
8
  "type": "object",
9
9
  "properties": {
10
- "logText": {
10
+ "profile": {
11
11
  "type": "string"
12
12
  },
13
- "log": {
13
+ "command": {
14
14
  "type": "string"
15
15
  },
16
- "text": {
16
+ "cmd": {
17
17
  "type": "string"
18
18
  },
19
- "chunkSize": {
20
- "type": "number"
19
+ "activate": {
20
+ "type": "object",
21
+ "properties": {}
21
22
  },
22
- "chunkOverlap": {
23
- "type": "number"
23
+ "windowName": {
24
+ "type": "string"
24
25
  },
25
- "model": {
26
+ "tabName": {
26
27
  "type": "string"
27
28
  },
28
- "timeoutMs": {
29
- "type": "number"
29
+ "sessionName": {
30
+ "type": "string"
30
31
  }
31
- },
32
- "required": [
33
- "logText"
34
- ]
32
+ }
35
33
  },
36
34
  "outputSchema": {
37
35
  "type": "object",
@@ -39,16 +37,32 @@
39
37
  "result": {
40
38
  "type": "object",
41
39
  "properties": {
42
- "analysis": {
40
+ "profile": {
43
41
  "type": "string"
44
42
  },
45
- "chunksProcessed": {
43
+ "commandText": {
44
+ "type": "string"
45
+ },
46
+ "windowId": {
47
+ "type": "number"
48
+ },
49
+ "tabIndex": {
46
50
  "type": "number"
51
+ },
52
+ "sessionId": {
53
+ "type": "string"
54
+ },
55
+ "sessionUniqueId": {
56
+ "type": "string"
47
57
  }
48
58
  },
49
59
  "required": [
50
- "analysis",
51
- "chunksProcessed"
60
+ "profile",
61
+ "commandText",
62
+ "windowId",
63
+ "tabIndex",
64
+ "sessionId",
65
+ "sessionUniqueId"
52
66
  ]
53
67
  },
54
68
  "evidence": {
@@ -59,6 +73,9 @@
59
73
  "type": {
60
74
  "type": "string"
61
75
  },
76
+ "ref": {
77
+ "type": "string"
78
+ },
62
79
  "summary": {
63
80
  "type": "string"
64
81
  },
@@ -68,6 +85,7 @@
68
85
  },
69
86
  "required": [
70
87
  "type",
88
+ "ref",
71
89
  "summary",
72
90
  "createdAt"
73
91
  ]
@@ -79,60 +97,39 @@
79
97
  "evidence"
80
98
  ]
81
99
  },
82
- "sourcePath": "src/analyze/analyzeLog",
83
- "exportName": "analyzeLog",
84
- "sideEffect": "none"
100
+ "sourcePath": "src/iterm/itermCreateWindow",
101
+ "exportName": "itermCreateWindow",
102
+ "sideEffect": "local_write"
85
103
  },
86
104
  {
87
- "name": "analyzeProjectRepo",
88
- "description": "Build an index for a source-code repository and generate a whole-project understanding summary.",
105
+ "name": "itermCreateTab",
106
+ "description": "Create a new tab in an iTerm2 window.",
89
107
  "inputSchema": {
90
108
  "type": "object",
91
109
  "properties": {
92
- "path": {
93
- "type": "string"
110
+ "windowId": {
111
+ "type": "number"
94
112
  },
95
- "repoPath": {
113
+ "profile": {
96
114
  "type": "string"
97
115
  },
98
- "projectPath": {
116
+ "command": {
99
117
  "type": "string"
100
118
  },
101
- "outputIndexPath": {
119
+ "cmd": {
102
120
  "type": "string"
103
121
  },
104
- "includeHidden": {
105
- "type": "object",
106
- "properties": {}
107
- },
108
- "maxFiles": {
109
- "type": "number"
110
- },
111
- "maxFileBytes": {
112
- "type": "number"
113
- },
114
- "includeExtensions": {
115
- "type": "array",
116
- "items": {
117
- "type": "string"
118
- }
119
- },
120
- "excludeDirs": {
121
- "type": "array",
122
- "items": {
123
- "type": "string"
124
- }
122
+ "tabName": {
123
+ "type": "string"
125
124
  },
126
- "model": {
125
+ "sessionName": {
127
126
  "type": "string"
128
127
  },
129
- "timeoutMs": {
130
- "type": "number"
128
+ "activate": {
129
+ "type": "object",
130
+ "properties": {}
131
131
  }
132
- },
133
- "required": [
134
- "path"
135
- ]
132
+ }
136
133
  },
137
134
  "outputSchema": {
138
135
  "type": "object",
@@ -140,55 +137,32 @@
140
137
  "result": {
141
138
  "type": "object",
142
139
  "properties": {
143
- "repoRoot": {
144
- "type": "string"
145
- },
146
- "indexPath": {
147
- "type": "string"
148
- },
149
- "totalIndexedFiles": {
150
- "type": "number"
151
- },
152
- "truncated": {
153
- "type": "boolean"
154
- },
155
- "skippedBinary": {
140
+ "windowId": {
156
141
  "type": "number"
157
142
  },
158
- "indexSplit": {
159
- "type": "boolean"
160
- },
161
- "indexPartPaths": {
162
- "type": "array",
163
- "items": {
164
- "type": "string"
165
- }
143
+ "profile": {
144
+ "type": "string"
166
145
  },
167
- "llmUsed": {
168
- "type": "boolean"
146
+ "commandText": {
147
+ "type": "string"
169
148
  },
170
- "partialCount": {
149
+ "tabIndex": {
171
150
  "type": "number"
172
151
  },
173
- "model": {
152
+ "sessionId": {
174
153
  "type": "string"
175
154
  },
176
- "understanding": {
155
+ "sessionUniqueId": {
177
156
  "type": "string"
178
157
  }
179
158
  },
180
159
  "required": [
181
- "repoRoot",
182
- "indexPath",
183
- "totalIndexedFiles",
184
- "truncated",
185
- "skippedBinary",
186
- "indexSplit",
187
- "indexPartPaths",
188
- "llmUsed",
189
- "partialCount",
190
- "model",
191
- "understanding"
160
+ "windowId",
161
+ "profile",
162
+ "commandText",
163
+ "tabIndex",
164
+ "sessionId",
165
+ "sessionUniqueId"
192
166
  ]
193
167
  },
194
168
  "evidence": {
@@ -199,6 +173,9 @@
199
173
  "type": {
200
174
  "type": "string"
201
175
  },
176
+ "ref": {
177
+ "type": "string"
178
+ },
202
179
  "summary": {
203
180
  "type": "string"
204
181
  },
@@ -208,6 +185,7 @@
208
185
  },
209
186
  "required": [
210
187
  "type",
188
+ "ref",
211
189
  "summary",
212
190
  "createdAt"
213
191
  ]
@@ -219,54 +197,46 @@
219
197
  "evidence"
220
198
  ]
221
199
  },
222
- "sourcePath": "src/analyze/analyzeProjectRepo",
223
- "exportName": "analyzeProjectRepo",
200
+ "sourcePath": "src/iterm/itermCreateTab",
201
+ "exportName": "itermCreateTab",
224
202
  "sideEffect": "local_write"
225
203
  },
226
204
  {
227
- "name": "askProjectRepo",
228
- "description": "Ask a concrete question about a repository based on .project-index.json (or split parts).",
205
+ "name": "itermSplitPane",
206
+ "description": "Split an iTerm2 session into a new pane.",
229
207
  "inputSchema": {
230
208
  "type": "object",
231
209
  "properties": {
232
- "path": {
233
- "type": "string"
234
- },
235
- "repoPath": {
236
- "type": "string"
210
+ "windowId": {
211
+ "type": "number"
237
212
  },
238
- "projectPath": {
239
- "type": "string"
213
+ "tabIndex": {
214
+ "type": "number"
240
215
  },
241
- "question": {
216
+ "sessionId": {
242
217
  "type": "string"
243
218
  },
244
- "query": {
245
- "type": "string"
219
+ "direction": {
220
+ "type": "string",
221
+ "enum": [
222
+ "horizontal",
223
+ "vertical"
224
+ ]
246
225
  },
247
- "q": {
226
+ "profile": {
248
227
  "type": "string"
249
228
  },
250
- "indexPath": {
229
+ "command": {
251
230
  "type": "string"
252
231
  },
253
- "topK": {
254
- "type": "number"
255
- },
256
- "maxSnippetChars": {
257
- "type": "number"
258
- },
259
- "model": {
232
+ "cmd": {
260
233
  "type": "string"
261
234
  },
262
- "timeoutMs": {
263
- "type": "number"
235
+ "activate": {
236
+ "type": "object",
237
+ "properties": {}
264
238
  }
265
- },
266
- "required": [
267
- "path",
268
- "question"
269
- ]
239
+ }
270
240
  },
271
241
  "outputSchema": {
272
242
  "type": "object",
@@ -274,70 +244,36 @@
274
244
  "result": {
275
245
  "type": "object",
276
246
  "properties": {
277
- "repoRoot": {
247
+ "direction": {
278
248
  "type": "string"
279
249
  },
280
- "indexPath": {
250
+ "profile": {
281
251
  "type": "string"
282
252
  },
283
- "question": {
253
+ "commandText": {
284
254
  "type": "string"
285
255
  },
286
- "model": {
287
- "type": "string"
256
+ "windowId": {
257
+ "type": "number"
288
258
  },
289
- "answer": {
259
+ "tabIndex": {
260
+ "type": "number"
261
+ },
262
+ "sessionId": {
290
263
  "type": "string"
291
264
  },
292
- "matchedFiles": {
293
- "type": "array",
294
- "items": {
295
- "type": "object",
296
- "properties": {
297
- "path": {
298
- "type": "string"
299
- },
300
- "score": {
301
- "type": "number"
302
- },
303
- "source": {
304
- "type": "string",
305
- "enum": [
306
- "index",
307
- "live_scan"
308
- ]
309
- }
310
- },
311
- "required": [
312
- "path",
313
- "score",
314
- "source"
315
- ]
316
- }
317
- },
318
- "retrievalMode": {
265
+ "sessionUniqueId": {
319
266
  "type": "string"
320
- },
321
- "deepReadUsed": {
322
- "type": "boolean"
323
- },
324
- "deepReadPaths": {
325
- "type": "array",
326
- "items": {
327
- "type": "string"
328
- }
329
267
  }
330
268
  },
331
269
  "required": [
332
- "repoRoot",
333
- "indexPath",
334
- "question",
335
- "model",
336
- "answer",
337
- "matchedFiles",
338
- "retrievalMode",
339
- "deepReadUsed",
340
- "deepReadPaths"
270
+ "direction",
271
+ "profile",
272
+ "commandText",
273
+ "windowId",
274
+ "tabIndex",
275
+ "sessionId",
276
+ "sessionUniqueId"
341
277
  ]
342
278
  },
343
279
  "evidence": {
@@ -348,6 +284,9 @@
348
284
  "type": {
349
285
  "type": "string"
350
286
  },
287
+ "ref": {
288
+ "type": "string"
289
+ },
351
290
  "summary": {
352
291
  "type": "string"
353
292
  },
@@ -357,6 +296,7 @@
357
296
  },
358
297
  "required": [
359
298
  "type",
299
+ "ref",
360
300
  "summary",
361
301
  "createdAt"
362
302
  ]
@@ -368,29 +308,23 @@
368
308
  "evidence"
369
309
  ]
370
310
  },
371
- "sourcePath": "src/analyze/askProjectRepo",
372
- "exportName": "askProjectRepo",
373
- "sideEffect": "none"
311
+ "sourcePath": "src/iterm/itermSplitPane",
312
+ "exportName": "itermSplitPane",
313
+ "sideEffect": "local_write"
374
314
  },
375
315
  {
376
- "name": "embedText",
377
- "description": "Convert text into embedding vectors via OpenAI-compatible API.",
316
+ "name": "itermResizeWindow",
317
+ "description": "Resize the current iTerm2 window to a percentage of the main screen,",
378
318
  "inputSchema": {
379
319
  "type": "object",
380
320
  "properties": {
381
- "text": {
382
- "type": "string"
383
- },
384
- "texts": {
385
- "type": "array",
386
- "items": {
387
- "type": "string"
388
- }
321
+ "windowId": {
322
+ "type": "number"
389
323
  },
390
- "model": {
391
- "type": "string"
324
+ "widthPercent": {
325
+ "type": "number"
392
326
  },
393
- "timeoutMs": {
327
+ "heightPercent": {
394
328
  "type": "number"
395
329
  }
396
330
  }
@@ -401,30 +335,32 @@
401
335
  "result": {
402
336
  "type": "object",
403
337
  "properties": {
404
- "embeddings": {
405
- "type": "array",
406
- "items": {
407
- "type": "array",
408
- "items": {
409
- "type": "number"
410
- }
411
- }
338
+ "widthPercent": {
339
+ "type": "number"
412
340
  },
413
- "model": {
414
- "type": "string"
341
+ "heightPercent": {
342
+ "type": "number"
415
343
  },
416
- "dimensions": {
344
+ "windowId": {
417
345
  "type": "number"
418
346
  },
419
- "count": {
347
+ "tabIndex": {
420
348
  "type": "number"
349
+ },
350
+ "sessionId": {
351
+ "type": "string"
352
+ },
353
+ "sessionUniqueId": {
354
+ "type": "string"
421
355
  }
422
356
  },
423
357
  "required": [
424
- "embeddings",
425
- "model",
426
- "dimensions",
427
- "count"
358
+ "widthPercent",
359
+ "heightPercent",
360
+ "windowId",
361
+ "tabIndex",
362
+ "sessionId",
363
+ "sessionUniqueId"
428
364
  ]
429
365
  },
430
366
  "evidence": {
@@ -435,6 +371,9 @@
435
371
  "type": {
436
372
  "type": "string"
437
373
  },
374
+ "ref": {
375
+ "type": "string"
376
+ },
438
377
  "summary": {
439
378
  "type": "string"
440
379
  },
@@ -444,6 +383,7 @@
444
383
  },
445
384
  "required": [
446
385
  "type",
386
+ "ref",
447
387
  "summary",
448
388
  "createdAt"
449
389
  ]
@@ -455,84 +395,35 @@
455
395
  "evidence"
456
396
  ]
457
397
  },
458
- "sourcePath": "src/analyze/embedText",
459
- "exportName": "embedText",
460
- "sideEffect": "none"
398
+ "sourcePath": "src/iterm/itermResizeWindow",
399
+ "exportName": "itermResizeWindow",
400
+ "sideEffect": "local_write"
461
401
  },
462
402
  {
463
- "name": "runCommand",
464
- "description": "Run an allowlisted command in the sandbox via spawn (no shell), with timeout and output limits.",
403
+ "name": "itermRename",
404
+ "description": "Rename iTerm2 window/tab/session targets.",
465
405
  "inputSchema": {
466
406
  "type": "object",
467
407
  "properties": {
468
- "command": {
469
- "type": "string"
470
- },
471
- "cmd": {
472
- "type": "string"
473
- },
474
- "args": {
475
- "type": "array",
476
- "items": {
477
- "type": "string"
478
- }
408
+ "windowId": {
409
+ "type": "number"
479
410
  },
480
- "arguments": {
481
- "type": "array",
482
- "items": {
483
- "type": "string"
484
- }
411
+ "tabIndex": {
412
+ "type": "number"
485
413
  },
486
- "cwd": {
414
+ "sessionId": {
487
415
  "type": "string"
488
416
  },
489
- "timeoutMs": {
490
- "type": "number"
491
- }
492
- },
493
- "required": [
494
- "command"
495
- ]
496
- },
497
- "outputSchema": {
498
- "type": "object",
499
- "properties": {
500
- "result": {},
501
- "evidence": {
502
- "type": "array",
503
- "items": {}
504
- }
505
- },
506
- "required": [
507
- "result",
508
- "evidence"
509
- ]
510
- },
511
- "sourcePath": "src/exec/runCommand",
512
- "exportName": "runCommand",
513
- "sideEffect": "local_write"
514
- },
515
- {
516
- "name": "deletePath",
517
- "description": "Delete a file or directory in the sandbox. Requires confirm=true to proceed.",
518
- "inputSchema": {
519
- "type": "object",
520
- "properties": {
521
- "path": {
417
+ "windowName": {
522
418
  "type": "string"
523
419
  },
524
- "recursive": {
525
- "type": "object",
526
- "properties": {}
420
+ "tabName": {
421
+ "type": "string"
527
422
  },
528
- "confirm": {
529
- "type": "boolean"
423
+ "sessionName": {
424
+ "type": "string"
530
425
  }
531
- },
532
- "required": [
533
- "path",
534
- "confirm"
535
- ]
426
+ }
536
427
  },
537
428
  "outputSchema": {
538
429
  "type": "object",
@@ -540,20 +431,39 @@
540
431
  "result": {
541
432
  "type": "object",
542
433
  "properties": {
543
- "path": {
544
- "type": "string"
434
+ "windowName": {
435
+ "type": "object",
436
+ "properties": {}
545
437
  },
546
- "deleted": {
547
- "type": "boolean"
438
+ "tabName": {
439
+ "type": "object",
440
+ "properties": {}
548
441
  },
549
- "type": {
442
+ "sessionName": {
443
+ "type": "object",
444
+ "properties": {}
445
+ },
446
+ "windowId": {
447
+ "type": "number"
448
+ },
449
+ "tabIndex": {
450
+ "type": "number"
451
+ },
452
+ "sessionId": {
453
+ "type": "string"
454
+ },
455
+ "sessionUniqueId": {
550
456
  "type": "string"
551
457
  }
552
458
  },
553
459
  "required": [
554
- "path",
555
- "deleted",
556
- "type"
460
+ "windowName",
461
+ "tabName",
462
+ "sessionName",
463
+ "windowId",
464
+ "tabIndex",
465
+ "sessionId",
466
+ "sessionUniqueId"
557
467
  ]
558
468
  },
559
469
  "evidence": {
@@ -588,37 +498,41 @@
588
498
  "evidence"
589
499
  ]
590
500
  },
591
- "sourcePath": "src/fs/deletePath",
592
- "exportName": "deletePath",
593
- "sideEffect": "destructive"
501
+ "sourcePath": "src/iterm/itermRename",
502
+ "exportName": "itermRename",
503
+ "sideEffect": "local_write"
594
504
  },
595
505
  {
596
- "name": "listDir",
597
- "description": "List files and subdirectories in a sandbox directory, optionally recursive with depth limit.",
506
+ "name": "itermSetBackgroundColor",
507
+ "description": "Set iTerm2 session background color.",
598
508
  "inputSchema": {
599
509
  "type": "object",
600
510
  "properties": {
601
- "path": {
511
+ "windowId": {
512
+ "type": "number"
513
+ },
514
+ "tabIndex": {
515
+ "type": "number"
516
+ },
517
+ "sessionId": {
602
518
  "type": "string"
603
519
  },
604
- "maxEntries": {
520
+ "hex": {
521
+ "type": "string"
522
+ },
523
+ "red": {
605
524
  "type": "number"
606
525
  },
607
- "includeHidden": {
608
- "type": "object",
609
- "properties": {}
526
+ "green": {
527
+ "type": "number"
610
528
  },
611
- "recursive": {
612
- "type": "object",
613
- "properties": {}
529
+ "blue": {
530
+ "type": "number"
614
531
  },
615
- "maxDepth": {
532
+ "alpha": {
616
533
  "type": "number"
617
534
  }
618
- },
619
- "required": [
620
- "path"
621
- ]
535
+ }
622
536
  },
623
537
  "outputSchema": {
624
538
  "type": "object",
@@ -626,53 +540,48 @@
626
540
  "result": {
627
541
  "type": "object",
628
542
  "properties": {
629
- "path": {
630
- "type": "string"
631
- },
632
- "entries": {
633
- "type": "array",
634
- "items": {
635
- "type": "object",
636
- "properties": {
637
- "name": {
638
- "type": "string"
639
- },
640
- "kind": {
641
- "type": "string",
642
- "enum": [
643
- "directory",
644
- "file",
645
- "symlink",
646
- "other"
647
- ]
648
- },
649
- "size": {
650
- "type": "number"
651
- },
652
- "mtime": {
653
- "type": "string"
654
- }
543
+ "color": {
544
+ "type": "object",
545
+ "properties": {
546
+ "red": {
547
+ "type": "number"
655
548
  },
656
- "required": [
657
- "name",
658
- "kind",
659
- "size",
660
- "mtime"
661
- ]
662
- }
549
+ "green": {
550
+ "type": "number"
551
+ },
552
+ "blue": {
553
+ "type": "number"
554
+ },
555
+ "alpha": {
556
+ "type": "number"
557
+ }
558
+ },
559
+ "required": [
560
+ "red",
561
+ "green",
562
+ "blue",
563
+ "alpha"
564
+ ]
663
565
  },
664
- "totalEntries": {
566
+ "windowId": {
665
567
  "type": "number"
666
568
  },
667
- "truncated": {
668
- "type": "boolean"
569
+ "tabIndex": {
570
+ "type": "number"
571
+ },
572
+ "sessionId": {
573
+ "type": "string"
574
+ },
575
+ "sessionUniqueId": {
576
+ "type": "string"
669
577
  }
670
578
  },
671
579
  "required": [
672
- "path",
673
- "entries",
674
- "totalEntries",
675
- "truncated"
580
+ "color",
581
+ "windowId",
582
+ "tabIndex",
583
+ "sessionId",
584
+ "sessionUniqueId"
676
585
  ]
677
586
  },
678
587
  "evidence": {
@@ -707,25 +616,35 @@
707
616
  "evidence"
708
617
  ]
709
618
  },
710
- "sourcePath": "src/fs/listDir",
711
- "exportName": "listDir",
712
- "sideEffect": "none"
619
+ "sourcePath": "src/iterm/itermSetBackgroundColor",
620
+ "exportName": "itermSetBackgroundColor",
621
+ "sideEffect": "local_write"
713
622
  },
714
623
  {
715
- "name": "readText",
716
- "description": "Read a UTF-8 text file from the sandbox.",
624
+ "name": "itermSendText",
625
+ "description": "Send text to an iTerm2 session as if typed.",
717
626
  "inputSchema": {
718
627
  "type": "object",
719
628
  "properties": {
720
- "path": {
629
+ "text": {
721
630
  "type": "string"
722
631
  },
723
- "maxBytes": {
632
+ "windowId": {
633
+ "type": "number"
634
+ },
635
+ "tabIndex": {
724
636
  "type": "number"
637
+ },
638
+ "sessionId": {
639
+ "type": "string"
640
+ },
641
+ "newline": {
642
+ "type": "object",
643
+ "properties": {}
725
644
  }
726
645
  },
727
646
  "required": [
728
- "path"
647
+ "text"
729
648
  ]
730
649
  },
731
650
  "outputSchema": {
@@ -734,20 +653,32 @@
734
653
  "result": {
735
654
  "type": "object",
736
655
  "properties": {
737
- "path": {
738
- "type": "string"
739
- },
740
656
  "text": {
741
657
  "type": "string"
742
658
  },
743
- "bytes": {
659
+ "newline": {
660
+ "type": "boolean"
661
+ },
662
+ "windowId": {
663
+ "type": "number"
664
+ },
665
+ "tabIndex": {
744
666
  "type": "number"
667
+ },
668
+ "sessionId": {
669
+ "type": "string"
670
+ },
671
+ "sessionUniqueId": {
672
+ "type": "string"
745
673
  }
746
674
  },
747
675
  "required": [
748
- "path",
749
676
  "text",
750
- "bytes"
677
+ "newline",
678
+ "windowId",
679
+ "tabIndex",
680
+ "sessionId",
681
+ "sessionUniqueId"
751
682
  ]
752
683
  },
753
684
  "evidence": {
@@ -782,47 +713,31 @@
782
713
  "evidence"
783
714
  ]
784
715
  },
785
- "sourcePath": "src/fs/readText",
786
- "exportName": "readText",
787
- "sideEffect": "none"
716
+ "sourcePath": "src/iterm/itermSendText",
717
+ "exportName": "itermSendText",
718
+ "sideEffect": "local_write"
788
719
  },
789
720
  {
790
- "name": "searchText",
791
- "description": "Search files in the sandbox by regex pattern, with glob filtering and match limits.",
721
+ "name": "itermRunCommandInSession",
722
+ "description": "Run a shell command in an iTerm2 session (panel).",
792
723
  "inputSchema": {
793
724
  "type": "object",
794
725
  "properties": {
795
- "root": {
796
- "type": "string"
797
- },
798
- "path": {
799
- "type": "string"
800
- },
801
- "dir": {
802
- "type": "string"
803
- },
804
- "directory": {
805
- "type": "string"
806
- },
807
- "query": {
808
- "type": "string"
809
- },
810
- "q": {
811
- "type": "string"
812
- },
813
- "glob": {
726
+ "command": {
814
727
  "type": "string"
815
728
  },
816
- "maxMatches": {
729
+ "windowId": {
817
730
  "type": "number"
818
731
  },
819
- "maxFiles": {
732
+ "tabIndex": {
820
733
  "type": "number"
734
+ },
735
+ "sessionId": {
736
+ "type": "string"
821
737
  }
822
738
  },
823
739
  "required": [
824
- "root",
825
- "query"
740
+ "command"
826
741
  ]
827
742
  },
828
743
  "outputSchema": {
@@ -831,51 +746,36 @@
831
746
  "result": {
832
747
  "type": "object",
833
748
  "properties": {
834
- "root": {
749
+ "command": {
835
750
  "type": "string"
836
751
  },
837
- "query": {
752
+ "text": {
838
753
  "type": "string"
839
754
  },
840
- "matches": {
841
- "type": "array",
842
- "items": {
843
- "type": "object",
844
- "properties": {
845
- "file": {
846
- "type": "string"
847
- },
848
- "lineNo": {
849
- "type": "number"
850
- },
851
- "excerpt": {
852
- "type": "string"
853
- }
854
- },
855
- "required": [
856
- "file",
857
- "lineNo",
858
- "excerpt"
859
- ]
860
- }
755
+ "newline": {
756
+ "type": "boolean"
861
757
  },
862
- "totalMatches": {
758
+ "windowId": {
863
759
  "type": "number"
864
760
  },
865
- "filesScanned": {
761
+ "tabIndex": {
866
762
  "type": "number"
867
763
  },
868
- "truncated": {
869
- "type": "boolean"
764
+ "sessionId": {
765
+ "type": "string"
766
+ },
767
+ "sessionUniqueId": {
768
+ "type": "string"
870
769
  }
871
770
  },
872
771
  "required": [
873
- "root",
874
- "query",
875
- "matches",
876
- "totalMatches",
877
- "filesScanned",
878
- "truncated"
772
+ "command",
773
+ "text",
774
+ "newline",
775
+ "windowId",
776
+ "tabIndex",
777
+ "sessionId",
778
+ "sessionUniqueId"
879
779
  ]
880
780
  },
881
781
  "evidence": {
@@ -910,23 +810,16 @@
910
810
  "evidence"
911
811
  ]
912
812
  },
913
- "sourcePath": "src/fs/searchText",
914
- "exportName": "searchText",
915
- "sideEffect": "none"
813
+ "sourcePath": "src/iterm/itermRunCommandInSession",
814
+ "exportName": "itermRunCommandInSession",
815
+ "sideEffect": "local_write"
916
816
  },
917
817
  {
918
- "name": "sha256",
919
- "description": "Compute SHA-256 hash of a file in the sandbox.",
818
+ "name": "itermListWindows",
819
+ "description": "List iTerm2 windows, tabs, and sessions.",
920
820
  "inputSchema": {
921
821
  "type": "object",
922
- "properties": {
923
- "path": {
924
- "type": "string"
925
- }
926
- },
927
- "required": [
928
- "path"
929
- ]
822
+ "properties": {}
930
823
  },
931
824
  "outputSchema": {
932
825
  "type": "object",
@@ -934,47 +827,90 @@
934
827
  "result": {
935
828
  "type": "object",
936
829
  "properties": {
937
- "sha256": {
938
- "type": "string"
939
- },
940
- "path": {
941
- "type": "string"
942
- },
943
- "bytes": {
944
- "type": "number"
945
- }
946
- },
947
- "required": [
948
- "sha256",
949
- "path",
950
- "bytes"
951
- ]
952
- },
953
- "evidence": {
954
- "type": "array",
955
- "items": {
956
- "type": "object",
957
- "properties": {
958
- "type": {
959
- "type": "string"
960
- },
961
- "ref": {
962
- "type": "string"
963
- },
964
- "summary": {
965
- "type": "string"
966
- },
967
- "createdAt": {
968
- "type": "string"
969
- }
970
- },
971
- "required": [
972
- "type",
973
- "ref",
974
- "summary",
975
- "createdAt"
976
- ]
977
- }
830
+ "sessions": {
831
+ "type": "array",
832
+ "items": {
833
+ "type": "object",
834
+ "properties": {
835
+ "windowId": {
836
+ "type": "number"
837
+ },
838
+ "windowName": {
839
+ "type": "string"
840
+ },
841
+ "tabIndex": {
842
+ "type": "number"
843
+ },
844
+ "tabIndexZeroBased": {
845
+ "type": "number"
846
+ },
847
+ "isCurrentTab": {
848
+ "type": "boolean"
849
+ },
850
+ "sessionId": {
851
+ "type": "string"
852
+ },
853
+ "sessionUniqueId": {
854
+ "type": "string"
855
+ },
856
+ "sessionName": {
857
+ "type": "string"
858
+ },
859
+ "tty": {
860
+ "type": "string"
861
+ },
862
+ "isCurrentSession": {
863
+ "type": "boolean"
864
+ }
865
+ },
866
+ "required": [
867
+ "windowId",
868
+ "windowName",
869
+ "tabIndex",
870
+ "tabIndexZeroBased",
871
+ "isCurrentTab",
872
+ "sessionId",
873
+ "sessionUniqueId",
874
+ "sessionName",
875
+ "tty",
876
+ "isCurrentSession"
877
+ ]
878
+ }
879
+ },
880
+ "count": {
881
+ "type": "number"
882
+ }
883
+ },
884
+ "required": [
885
+ "sessions",
886
+ "count"
887
+ ]
888
+ },
889
+ "evidence": {
890
+ "type": "array",
891
+ "items": {
892
+ "type": "object",
893
+ "properties": {
894
+ "type": {
895
+ "type": "string"
896
+ },
897
+ "ref": {
898
+ "type": "string"
899
+ },
900
+ "summary": {
901
+ "type": "string"
902
+ },
903
+ "createdAt": {
904
+ "type": "string"
905
+ }
906
+ },
907
+ "required": [
908
+ "type",
909
+ "ref",
910
+ "summary",
911
+ "createdAt"
912
+ ]
913
+ }
978
914
  }
979
915
  },
980
916
  "required": [
@@ -982,29 +918,46 @@
982
918
  "evidence"
983
919
  ]
984
920
  },
985
- "sourcePath": "src/fs/sha256",
986
- "exportName": "sha256",
921
+ "sourcePath": "src/iterm/itermListWindows",
922
+ "exportName": "itermListWindows",
987
923
  "sideEffect": "none"
988
924
  },
989
925
  {
990
- "name": "writeText",
991
- "description": "Create or overwrite a UTF-8 text file in the sandbox, with auto mkdir and overwrite protection.",
926
+ "name": "itermListCurrentWindowSessions",
927
+ "description": "List all sessions (panels) in the current iTerm2 window only.",
992
928
  "inputSchema": {
929
+ "type": "object",
930
+ "properties": {}
931
+ },
932
+ "outputSchema": {
993
933
  "type": "object",
994
934
  "properties": {
995
- "path": {
935
+ "result": {},
936
+ "evidence": {}
937
+ },
938
+ "required": [
939
+ "result",
940
+ "evidence"
941
+ ]
942
+ },
943
+ "sourcePath": "src/iterm/itermListCurrentWindowSessions",
944
+ "exportName": "itermListCurrentWindowSessions",
945
+ "sideEffect": "none"
946
+ },
947
+ {
948
+ "name": "itermGetSessionInfo",
949
+ "description": "Get detailed info for a specific iTerm2 session (panel) by id / uniqueId / tty.",
950
+ "inputSchema": {
951
+ "type": "object",
952
+ "properties": {
953
+ "sessionId": {
996
954
  "type": "string"
997
955
  },
998
- "content": {
956
+ "sessionUniqueId": {
999
957
  "type": "string"
1000
958
  },
1001
- "overwrite": {
1002
- "type": "object",
1003
- "properties": {}
1004
- },
1005
- "mkdirp": {
1006
- "type": "object",
1007
- "properties": {}
959
+ "tty": {
960
+ "type": "string"
1008
961
  }
1009
962
  }
1010
963
  },
@@ -1014,20 +967,48 @@
1014
967
  "result": {
1015
968
  "type": "object",
1016
969
  "properties": {
1017
- "path": {
970
+ "windowId": {
971
+ "type": "number"
972
+ },
973
+ "windowName": {
1018
974
  "type": "string"
1019
975
  },
1020
- "bytes": {
976
+ "tabIndex": {
1021
977
  "type": "number"
1022
978
  },
1023
- "sha256": {
979
+ "tabIndexZeroBased": {
980
+ "type": "number"
981
+ },
982
+ "isCurrentTab": {
983
+ "type": "boolean"
984
+ },
985
+ "sessionId": {
986
+ "type": "string"
987
+ },
988
+ "sessionUniqueId": {
989
+ "type": "string"
990
+ },
991
+ "sessionName": {
1024
992
  "type": "string"
993
+ },
994
+ "tty": {
995
+ "type": "string"
996
+ },
997
+ "isCurrentSession": {
998
+ "type": "boolean"
1025
999
  }
1026
1000
  },
1027
1001
  "required": [
1028
- "path",
1029
- "bytes",
1030
- "sha256"
1002
+ "windowId",
1003
+ "windowName",
1004
+ "tabIndex",
1005
+ "tabIndexZeroBased",
1006
+ "isCurrentTab",
1007
+ "sessionId",
1008
+ "sessionUniqueId",
1009
+ "sessionName",
1010
+ "tty",
1011
+ "isCurrentSession"
1031
1012
  ]
1032
1013
  },
1033
1014
  "evidence": {
@@ -1062,47 +1043,40 @@
1062
1043
  "evidence"
1063
1044
  ]
1064
1045
  },
1065
- "sourcePath": "src/fs/writeText",
1066
- "exportName": "writeText",
1067
- "sideEffect": "local_write"
1046
+ "sourcePath": "src/iterm/itermGetSessionInfo",
1047
+ "exportName": "itermGetSessionInfo",
1048
+ "sideEffect": "none"
1068
1049
  },
1069
1050
  {
1070
- "name": "gitRead",
1071
- "description": "Read repository information via allowlisted git read-only subcommands.",
1051
+ "name": "analyzeLog",
1052
+ "description": "Analyze log text via OpenAI-compatible LLM, identifying errors, root causes, and suggestions.",
1072
1053
  "inputSchema": {
1073
1054
  "type": "object",
1074
1055
  "properties": {
1075
- "path": {
1056
+ "logText": {
1076
1057
  "type": "string"
1077
1058
  },
1078
- "repoPath": {
1059
+ "log": {
1079
1060
  "type": "string"
1080
1061
  },
1081
- "command": {
1062
+ "text": {
1082
1063
  "type": "string"
1083
1064
  },
1084
- "subcommand": {
1085
- "type": "string"
1065
+ "chunkSize": {
1066
+ "type": "number"
1086
1067
  },
1087
- "args": {
1088
- "type": "array",
1089
- "items": {
1090
- "type": "string"
1091
- }
1068
+ "chunkOverlap": {
1069
+ "type": "number"
1092
1070
  },
1093
- "arguments": {
1094
- "type": "array",
1095
- "items": {
1096
- "type": "string"
1097
- }
1071
+ "model": {
1072
+ "type": "string"
1098
1073
  },
1099
1074
  "timeoutMs": {
1100
1075
  "type": "number"
1101
1076
  }
1102
1077
  },
1103
1078
  "required": [
1104
- "path",
1105
- "command"
1079
+ "logText"
1106
1080
  ]
1107
1081
  },
1108
1082
  "outputSchema": {
@@ -1111,28 +1085,16 @@
1111
1085
  "result": {
1112
1086
  "type": "object",
1113
1087
  "properties": {
1114
- "path": {
1115
- "type": "string"
1116
- },
1117
- "command": {
1118
- "type": "string"
1119
- },
1120
- "stdout": {
1121
- "type": "string"
1122
- },
1123
- "stderr": {
1088
+ "analysis": {
1124
1089
  "type": "string"
1125
1090
  },
1126
- "exitCode": {
1091
+ "chunksProcessed": {
1127
1092
  "type": "number"
1128
1093
  }
1129
1094
  },
1130
1095
  "required": [
1131
- "path",
1132
- "command",
1133
- "stdout",
1134
- "stderr",
1135
- "exitCode"
1096
+ "analysis",
1097
+ "chunksProcessed"
1136
1098
  ]
1137
1099
  },
1138
1100
  "evidence": {
@@ -1163,13 +1125,13 @@
1163
1125
  "evidence"
1164
1126
  ]
1165
1127
  },
1166
- "sourcePath": "src/git/gitTools",
1167
- "exportName": "gitRead",
1128
+ "sourcePath": "src/analyze/analyzeLog",
1129
+ "exportName": "analyzeLog",
1168
1130
  "sideEffect": "none"
1169
1131
  },
1170
1132
  {
1171
- "name": "gitLogHistory",
1172
- "description": "Track detailed git commit history, optionally scoped to a file and including patches.",
1133
+ "name": "analyzeProjectRepo",
1134
+ "description": "Build an index for a source-code repository and generate a whole-project understanding summary.",
1173
1135
  "inputSchema": {
1174
1136
  "type": "object",
1175
1137
  "properties": {
@@ -1179,44 +1141,443 @@
1179
1141
  "repoPath": {
1180
1142
  "type": "string"
1181
1143
  },
1182
- "filePath": {
1144
+ "projectPath": {
1183
1145
  "type": "string"
1184
1146
  },
1185
- "maxCount": {
1186
- "type": "number"
1187
- },
1188
- "since": {
1147
+ "outputIndexPath": {
1189
1148
  "type": "string"
1190
1149
  },
1191
- "until": {
1192
- "type": "string"
1150
+ "includeHidden": {
1151
+ "type": "object",
1152
+ "properties": {}
1193
1153
  },
1194
- "author": {
1195
- "type": "string"
1154
+ "maxFiles": {
1155
+ "type": "number"
1196
1156
  },
1197
- "grep": {
1198
- "type": "string"
1157
+ "maxFileBytes": {
1158
+ "type": "number"
1199
1159
  },
1200
- "revisionRange": {
1201
- "type": "string"
1160
+ "includeExtensions": {
1161
+ "type": "array",
1162
+ "items": {
1163
+ "type": "string"
1164
+ }
1202
1165
  },
1203
- "follow": {
1204
- "type": "object",
1205
- "properties": {}
1166
+ "excludeDirs": {
1167
+ "type": "array",
1168
+ "items": {
1169
+ "type": "string"
1170
+ }
1206
1171
  },
1207
- "includePatch": {
1172
+ "model": {
1173
+ "type": "string"
1174
+ },
1175
+ "timeoutMs": {
1176
+ "type": "number"
1177
+ }
1178
+ },
1179
+ "required": [
1180
+ "path"
1181
+ ]
1182
+ },
1183
+ "outputSchema": {
1184
+ "type": "object",
1185
+ "properties": {
1186
+ "result": {
1187
+ "type": "object",
1188
+ "properties": {
1189
+ "repoRoot": {
1190
+ "type": "string"
1191
+ },
1192
+ "indexPath": {
1193
+ "type": "string"
1194
+ },
1195
+ "totalIndexedFiles": {
1196
+ "type": "number"
1197
+ },
1198
+ "truncated": {
1199
+ "type": "boolean"
1200
+ },
1201
+ "skippedBinary": {
1202
+ "type": "number"
1203
+ },
1204
+ "indexSplit": {
1205
+ "type": "boolean"
1206
+ },
1207
+ "indexPartPaths": {
1208
+ "type": "array",
1209
+ "items": {
1210
+ "type": "string"
1211
+ }
1212
+ },
1213
+ "llmUsed": {
1214
+ "type": "boolean"
1215
+ },
1216
+ "partialCount": {
1217
+ "type": "number"
1218
+ },
1219
+ "model": {
1220
+ "type": "string"
1221
+ },
1222
+ "understanding": {
1223
+ "type": "string"
1224
+ }
1225
+ },
1226
+ "required": [
1227
+ "repoRoot",
1228
+ "indexPath",
1229
+ "totalIndexedFiles",
1230
+ "truncated",
1231
+ "skippedBinary",
1232
+ "indexSplit",
1233
+ "indexPartPaths",
1234
+ "llmUsed",
1235
+ "partialCount",
1236
+ "model",
1237
+ "understanding"
1238
+ ]
1239
+ },
1240
+ "evidence": {
1241
+ "type": "array",
1242
+ "items": {
1243
+ "type": "object",
1244
+ "properties": {
1245
+ "type": {
1246
+ "type": "string"
1247
+ },
1248
+ "summary": {
1249
+ "type": "string"
1250
+ },
1251
+ "createdAt": {
1252
+ "type": "string"
1253
+ }
1254
+ },
1255
+ "required": [
1256
+ "type",
1257
+ "summary",
1258
+ "createdAt"
1259
+ ]
1260
+ }
1261
+ }
1262
+ },
1263
+ "required": [
1264
+ "result",
1265
+ "evidence"
1266
+ ]
1267
+ },
1268
+ "sourcePath": "src/analyze/analyzeProjectRepo",
1269
+ "exportName": "analyzeProjectRepo",
1270
+ "sideEffect": "local_write"
1271
+ },
1272
+ {
1273
+ "name": "askProjectRepo",
1274
+ "description": "Ask a concrete question about a repository based on .project-index.json (or split parts).",
1275
+ "inputSchema": {
1276
+ "type": "object",
1277
+ "properties": {
1278
+ "path": {
1279
+ "type": "string"
1280
+ },
1281
+ "repoPath": {
1282
+ "type": "string"
1283
+ },
1284
+ "projectPath": {
1285
+ "type": "string"
1286
+ },
1287
+ "question": {
1288
+ "type": "string"
1289
+ },
1290
+ "query": {
1291
+ "type": "string"
1292
+ },
1293
+ "q": {
1294
+ "type": "string"
1295
+ },
1296
+ "indexPath": {
1297
+ "type": "string"
1298
+ },
1299
+ "topK": {
1300
+ "type": "number"
1301
+ },
1302
+ "maxSnippetChars": {
1303
+ "type": "number"
1304
+ },
1305
+ "model": {
1306
+ "type": "string"
1307
+ },
1308
+ "timeoutMs": {
1309
+ "type": "number"
1310
+ }
1311
+ },
1312
+ "required": [
1313
+ "path",
1314
+ "question"
1315
+ ]
1316
+ },
1317
+ "outputSchema": {
1318
+ "type": "object",
1319
+ "properties": {
1320
+ "result": {
1321
+ "type": "object",
1322
+ "properties": {
1323
+ "repoRoot": {
1324
+ "type": "string"
1325
+ },
1326
+ "indexPath": {
1327
+ "type": "string"
1328
+ },
1329
+ "question": {
1330
+ "type": "string"
1331
+ },
1332
+ "model": {
1333
+ "type": "string"
1334
+ },
1335
+ "answer": {
1336
+ "type": "string"
1337
+ },
1338
+ "matchedFiles": {
1339
+ "type": "array",
1340
+ "items": {
1341
+ "type": "object",
1342
+ "properties": {
1343
+ "path": {
1344
+ "type": "string"
1345
+ },
1346
+ "score": {
1347
+ "type": "number"
1348
+ },
1349
+ "source": {
1350
+ "type": "string",
1351
+ "enum": [
1352
+ "index",
1353
+ "live_scan"
1354
+ ]
1355
+ }
1356
+ },
1357
+ "required": [
1358
+ "path",
1359
+ "score",
1360
+ "source"
1361
+ ]
1362
+ }
1363
+ },
1364
+ "retrievalMode": {
1365
+ "type": "string"
1366
+ },
1367
+ "deepReadUsed": {
1368
+ "type": "boolean"
1369
+ },
1370
+ "deepReadPaths": {
1371
+ "type": "array",
1372
+ "items": {
1373
+ "type": "string"
1374
+ }
1375
+ }
1376
+ },
1377
+ "required": [
1378
+ "repoRoot",
1379
+ "indexPath",
1380
+ "question",
1381
+ "model",
1382
+ "answer",
1383
+ "matchedFiles",
1384
+ "retrievalMode",
1385
+ "deepReadUsed",
1386
+ "deepReadPaths"
1387
+ ]
1388
+ },
1389
+ "evidence": {
1390
+ "type": "array",
1391
+ "items": {
1392
+ "type": "object",
1393
+ "properties": {
1394
+ "type": {
1395
+ "type": "string"
1396
+ },
1397
+ "summary": {
1398
+ "type": "string"
1399
+ },
1400
+ "createdAt": {
1401
+ "type": "string"
1402
+ }
1403
+ },
1404
+ "required": [
1405
+ "type",
1406
+ "summary",
1407
+ "createdAt"
1408
+ ]
1409
+ }
1410
+ }
1411
+ },
1412
+ "required": [
1413
+ "result",
1414
+ "evidence"
1415
+ ]
1416
+ },
1417
+ "sourcePath": "src/analyze/askProjectRepo",
1418
+ "exportName": "askProjectRepo",
1419
+ "sideEffect": "none"
1420
+ },
1421
+ {
1422
+ "name": "embedText",
1423
+ "description": "Convert text into embedding vectors via OpenAI-compatible API.",
1424
+ "inputSchema": {
1425
+ "type": "object",
1426
+ "properties": {
1427
+ "text": {
1428
+ "type": "string"
1429
+ },
1430
+ "texts": {
1431
+ "type": "array",
1432
+ "items": {
1433
+ "type": "string"
1434
+ }
1435
+ },
1436
+ "model": {
1437
+ "type": "string"
1438
+ },
1439
+ "timeoutMs": {
1440
+ "type": "number"
1441
+ }
1442
+ }
1443
+ },
1444
+ "outputSchema": {
1445
+ "type": "object",
1446
+ "properties": {
1447
+ "result": {
1448
+ "type": "object",
1449
+ "properties": {
1450
+ "embeddings": {
1451
+ "type": "array",
1452
+ "items": {
1453
+ "type": "array",
1454
+ "items": {
1455
+ "type": "number"
1456
+ }
1457
+ }
1458
+ },
1459
+ "model": {
1460
+ "type": "string"
1461
+ },
1462
+ "dimensions": {
1463
+ "type": "number"
1464
+ },
1465
+ "count": {
1466
+ "type": "number"
1467
+ }
1468
+ },
1469
+ "required": [
1470
+ "embeddings",
1471
+ "model",
1472
+ "dimensions",
1473
+ "count"
1474
+ ]
1475
+ },
1476
+ "evidence": {
1477
+ "type": "array",
1478
+ "items": {
1479
+ "type": "object",
1480
+ "properties": {
1481
+ "type": {
1482
+ "type": "string"
1483
+ },
1484
+ "summary": {
1485
+ "type": "string"
1486
+ },
1487
+ "createdAt": {
1488
+ "type": "string"
1489
+ }
1490
+ },
1491
+ "required": [
1492
+ "type",
1493
+ "summary",
1494
+ "createdAt"
1495
+ ]
1496
+ }
1497
+ }
1498
+ },
1499
+ "required": [
1500
+ "result",
1501
+ "evidence"
1502
+ ]
1503
+ },
1504
+ "sourcePath": "src/analyze/embedText",
1505
+ "exportName": "embedText",
1506
+ "sideEffect": "none"
1507
+ },
1508
+ {
1509
+ "name": "runCommand",
1510
+ "description": "Run an allowlisted command in the sandbox via spawn (no shell), with timeout and output limits.",
1511
+ "inputSchema": {
1512
+ "type": "object",
1513
+ "properties": {
1514
+ "command": {
1515
+ "type": "string"
1516
+ },
1517
+ "cmd": {
1518
+ "type": "string"
1519
+ },
1520
+ "args": {
1521
+ "type": "array",
1522
+ "items": {
1523
+ "type": "string"
1524
+ }
1525
+ },
1526
+ "arguments": {
1527
+ "type": "array",
1528
+ "items": {
1529
+ "type": "string"
1530
+ }
1531
+ },
1532
+ "cwd": {
1533
+ "type": "string"
1534
+ },
1535
+ "timeoutMs": {
1536
+ "type": "number"
1537
+ }
1538
+ },
1539
+ "required": [
1540
+ "command"
1541
+ ]
1542
+ },
1543
+ "outputSchema": {
1544
+ "type": "object",
1545
+ "properties": {
1546
+ "result": {},
1547
+ "evidence": {
1548
+ "type": "array",
1549
+ "items": {}
1550
+ }
1551
+ },
1552
+ "required": [
1553
+ "result",
1554
+ "evidence"
1555
+ ]
1556
+ },
1557
+ "sourcePath": "src/exec/runCommand",
1558
+ "exportName": "runCommand",
1559
+ "sideEffect": "local_write"
1560
+ },
1561
+ {
1562
+ "name": "deletePath",
1563
+ "description": "Delete a file or directory in the sandbox. Requires confirm=true to proceed.",
1564
+ "inputSchema": {
1565
+ "type": "object",
1566
+ "properties": {
1567
+ "path": {
1568
+ "type": "string"
1569
+ },
1570
+ "recursive": {
1208
1571
  "type": "object",
1209
1572
  "properties": {}
1210
1573
  },
1211
- "patchMaxCommits": {
1212
- "type": "number"
1213
- },
1214
- "timeoutMs": {
1215
- "type": "number"
1574
+ "confirm": {
1575
+ "type": "boolean"
1216
1576
  }
1217
1577
  },
1218
1578
  "required": [
1219
- "path"
1579
+ "path",
1580
+ "confirm"
1220
1581
  ]
1221
1582
  },
1222
1583
  "outputSchema": {
@@ -1228,71 +1589,17 @@
1228
1589
  "path": {
1229
1590
  "type": "string"
1230
1591
  },
1231
- "filePath": {
1232
- "type": "string"
1233
- },
1234
- "total": {
1235
- "type": "number"
1236
- },
1237
- "commits": {
1238
- "type": "array",
1239
- "items": {
1240
- "type": "object",
1241
- "properties": {
1242
- "hash": {
1243
- "type": "string"
1244
- },
1245
- "authorName": {
1246
- "type": "string"
1247
- },
1248
- "authorEmail": {
1249
- "type": "string"
1250
- },
1251
- "date": {
1252
- "type": "string"
1253
- },
1254
- "subject": {
1255
- "type": "string"
1256
- },
1257
- "body": {
1258
- "type": "string"
1259
- }
1260
- },
1261
- "required": [
1262
- "hash",
1263
- "authorName",
1264
- "authorEmail",
1265
- "date",
1266
- "subject",
1267
- "body"
1268
- ]
1269
- }
1592
+ "deleted": {
1593
+ "type": "boolean"
1270
1594
  },
1271
- "patches": {
1272
- "type": "array",
1273
- "items": {
1274
- "type": "object",
1275
- "properties": {
1276
- "hash": {
1277
- "type": "string"
1278
- },
1279
- "patch": {
1280
- "type": "string"
1281
- }
1282
- },
1283
- "required": [
1284
- "hash",
1285
- "patch"
1286
- ]
1287
- }
1595
+ "type": {
1596
+ "type": "string"
1288
1597
  }
1289
1598
  },
1290
1599
  "required": [
1291
1600
  "path",
1292
- "filePath",
1293
- "total",
1294
- "commits",
1295
- "patches"
1601
+ "deleted",
1602
+ "type"
1296
1603
  ]
1297
1604
  },
1298
1605
  "evidence": {
@@ -1303,6 +1610,9 @@
1303
1610
  "type": {
1304
1611
  "type": "string"
1305
1612
  },
1613
+ "ref": {
1614
+ "type": "string"
1615
+ },
1306
1616
  "summary": {
1307
1617
  "type": "string"
1308
1618
  },
@@ -1312,6 +1622,7 @@
1312
1622
  },
1313
1623
  "required": [
1314
1624
  "type",
1625
+ "ref",
1315
1626
  "summary",
1316
1627
  "createdAt"
1317
1628
  ]
@@ -1323,40 +1634,36 @@
1323
1634
  "evidence"
1324
1635
  ]
1325
1636
  },
1326
- "sourcePath": "src/git/gitTools",
1327
- "exportName": "gitLogHistory",
1328
- "sideEffect": "none"
1637
+ "sourcePath": "src/fs/deletePath",
1638
+ "exportName": "deletePath",
1639
+ "sideEffect": "destructive"
1329
1640
  },
1330
1641
  {
1331
- "name": "gitSwitchBranch",
1332
- "description": "Switch git branch in a repository.",
1642
+ "name": "listDir",
1643
+ "description": "List files and subdirectories in a sandbox directory, optionally recursive with depth limit.",
1333
1644
  "inputSchema": {
1334
1645
  "type": "object",
1335
1646
  "properties": {
1336
1647
  "path": {
1337
1648
  "type": "string"
1338
1649
  },
1339
- "repoPath": {
1340
- "type": "string"
1341
- },
1342
- "branch": {
1343
- "type": "string"
1650
+ "maxEntries": {
1651
+ "type": "number"
1344
1652
  },
1345
- "create": {
1653
+ "includeHidden": {
1346
1654
  "type": "object",
1347
1655
  "properties": {}
1348
1656
  },
1349
- "trackRemote": {
1657
+ "recursive": {
1350
1658
  "type": "object",
1351
1659
  "properties": {}
1352
1660
  },
1353
- "timeoutMs": {
1661
+ "maxDepth": {
1354
1662
  "type": "number"
1355
1663
  }
1356
1664
  },
1357
1665
  "required": [
1358
- "path",
1359
- "branch"
1666
+ "path"
1360
1667
  ]
1361
1668
  },
1362
1669
  "outputSchema": {
@@ -1368,33 +1675,50 @@
1368
1675
  "path": {
1369
1676
  "type": "string"
1370
1677
  },
1371
- "branch": {
1372
- "type": "string"
1678
+ "entries": {
1679
+ "type": "array",
1680
+ "items": {
1681
+ "type": "object",
1682
+ "properties": {
1683
+ "name": {
1684
+ "type": "string"
1685
+ },
1686
+ "kind": {
1687
+ "type": "string",
1688
+ "enum": [
1689
+ "directory",
1690
+ "file",
1691
+ "symlink",
1692
+ "other"
1693
+ ]
1694
+ },
1695
+ "size": {
1696
+ "type": "number"
1697
+ },
1698
+ "mtime": {
1699
+ "type": "string"
1700
+ }
1701
+ },
1702
+ "required": [
1703
+ "name",
1704
+ "kind",
1705
+ "size",
1706
+ "mtime"
1707
+ ]
1708
+ }
1373
1709
  },
1374
- "created": {
1375
- "type": "boolean"
1710
+ "totalEntries": {
1711
+ "type": "number"
1376
1712
  },
1377
- "trackedRemote": {
1713
+ "truncated": {
1378
1714
  "type": "boolean"
1379
- },
1380
- "stdout": {
1381
- "type": "string"
1382
- },
1383
- "stderr": {
1384
- "type": "string"
1385
- },
1386
- "exitCode": {
1387
- "type": "number"
1388
1715
  }
1389
1716
  },
1390
1717
  "required": [
1391
1718
  "path",
1392
- "branch",
1393
- "created",
1394
- "trackedRemote",
1395
- "stdout",
1396
- "stderr",
1397
- "exitCode"
1719
+ "entries",
1720
+ "totalEntries",
1721
+ "truncated"
1398
1722
  ]
1399
1723
  },
1400
1724
  "evidence": {
@@ -1405,6 +1729,9 @@
1405
1729
  "type": {
1406
1730
  "type": "string"
1407
1731
  },
1732
+ "ref": {
1733
+ "type": "string"
1734
+ },
1408
1735
  "summary": {
1409
1736
  "type": "string"
1410
1737
  },
@@ -1414,6 +1741,7 @@
1414
1741
  },
1415
1742
  "required": [
1416
1743
  "type",
1744
+ "ref",
1417
1745
  "summary",
1418
1746
  "createdAt"
1419
1747
  ]
@@ -1425,37 +1753,20 @@
1425
1753
  "evidence"
1426
1754
  ]
1427
1755
  },
1428
- "sourcePath": "src/git/gitTools",
1429
- "exportName": "gitSwitchBranch",
1430
- "sideEffect": "local_write"
1756
+ "sourcePath": "src/fs/listDir",
1757
+ "exportName": "listDir",
1758
+ "sideEffect": "none"
1431
1759
  },
1432
1760
  {
1433
- "name": "gitPull",
1434
- "description": "Pull updates from remote in a repository.",
1761
+ "name": "readText",
1762
+ "description": "Read a UTF-8 text file from the sandbox.",
1435
1763
  "inputSchema": {
1436
1764
  "type": "object",
1437
1765
  "properties": {
1438
1766
  "path": {
1439
1767
  "type": "string"
1440
1768
  },
1441
- "repoPath": {
1442
- "type": "string"
1443
- },
1444
- "remote": {
1445
- "type": "string"
1446
- },
1447
- "branch": {
1448
- "type": "string"
1449
- },
1450
- "rebase": {
1451
- "type": "object",
1452
- "properties": {}
1453
- },
1454
- "ffOnly": {
1455
- "type": "object",
1456
- "properties": {}
1457
- },
1458
- "timeoutMs": {
1769
+ "maxBytes": {
1459
1770
  "type": "number"
1460
1771
  }
1461
1772
  },
@@ -1472,37 +1783,17 @@
1472
1783
  "path": {
1473
1784
  "type": "string"
1474
1785
  },
1475
- "remote": {
1476
- "type": "string"
1477
- },
1478
- "branch": {
1479
- "type": "string"
1480
- },
1481
- "ffOnly": {
1482
- "type": "boolean"
1483
- },
1484
- "rebase": {
1485
- "type": "boolean"
1486
- },
1487
- "stdout": {
1488
- "type": "string"
1489
- },
1490
- "stderr": {
1786
+ "text": {
1491
1787
  "type": "string"
1492
1788
  },
1493
- "exitCode": {
1789
+ "bytes": {
1494
1790
  "type": "number"
1495
1791
  }
1496
1792
  },
1497
1793
  "required": [
1498
1794
  "path",
1499
- "remote",
1500
- "branch",
1501
- "ffOnly",
1502
- "rebase",
1503
- "stdout",
1504
- "stderr",
1505
- "exitCode"
1795
+ "text",
1796
+ "bytes"
1506
1797
  ]
1507
1798
  },
1508
1799
  "evidence": {
@@ -1513,6 +1804,9 @@
1513
1804
  "type": {
1514
1805
  "type": "string"
1515
1806
  },
1807
+ "ref": {
1808
+ "type": "string"
1809
+ },
1516
1810
  "summary": {
1517
1811
  "type": "string"
1518
1812
  },
@@ -1522,6 +1816,7 @@
1522
1816
  },
1523
1817
  "required": [
1524
1818
  "type",
1819
+ "ref",
1525
1820
  "summary",
1526
1821
  "createdAt"
1527
1822
  ]
@@ -1533,42 +1828,47 @@
1533
1828
  "evidence"
1534
1829
  ]
1535
1830
  },
1536
- "sourcePath": "src/git/gitTools",
1537
- "exportName": "gitPull",
1538
- "sideEffect": "local_write"
1831
+ "sourcePath": "src/fs/readText",
1832
+ "exportName": "readText",
1833
+ "sideEffect": "none"
1539
1834
  },
1540
1835
  {
1541
- "name": "gitPrView",
1542
- "description": "View a GitHub pull request using GitHub CLI (gh pr view).",
1836
+ "name": "searchText",
1837
+ "description": "Search files in the sandbox by regex pattern, with glob filtering and match limits.",
1543
1838
  "inputSchema": {
1544
1839
  "type": "object",
1545
1840
  "properties": {
1841
+ "root": {
1842
+ "type": "string"
1843
+ },
1546
1844
  "path": {
1547
1845
  "type": "string"
1548
1846
  },
1549
- "repoPath": {
1847
+ "dir": {
1848
+ "type": "string"
1849
+ },
1850
+ "directory": {
1851
+ "type": "string"
1852
+ },
1853
+ "query": {
1854
+ "type": "string"
1855
+ },
1856
+ "q": {
1857
+ "type": "string"
1858
+ },
1859
+ "glob": {
1550
1860
  "type": "string"
1551
1861
  },
1552
- "prNumber": {
1862
+ "maxMatches": {
1553
1863
  "type": "number"
1554
1864
  },
1555
- "comments": {
1556
- "type": "object",
1557
- "properties": {}
1558
- },
1559
- "jsonFields": {
1560
- "type": "array",
1561
- "items": {
1562
- "type": "string"
1563
- }
1564
- },
1565
- "timeoutMs": {
1865
+ "maxFiles": {
1566
1866
  "type": "number"
1567
1867
  }
1568
1868
  },
1569
1869
  "required": [
1570
- "path",
1571
- "prNumber"
1870
+ "root",
1871
+ "query"
1572
1872
  ]
1573
1873
  },
1574
1874
  "outputSchema": {
@@ -1577,25 +1877,51 @@
1577
1877
  "result": {
1578
1878
  "type": "object",
1579
1879
  "properties": {
1580
- "path": {
1880
+ "root": {
1581
1881
  "type": "string"
1582
1882
  },
1583
- "prNumber": {
1584
- "type": "number"
1883
+ "query": {
1884
+ "type": "string"
1585
1885
  },
1586
- "fields": {
1886
+ "matches": {
1587
1887
  "type": "array",
1588
1888
  "items": {
1589
- "type": "string"
1889
+ "type": "object",
1890
+ "properties": {
1891
+ "file": {
1892
+ "type": "string"
1893
+ },
1894
+ "lineNo": {
1895
+ "type": "number"
1896
+ },
1897
+ "excerpt": {
1898
+ "type": "string"
1899
+ }
1900
+ },
1901
+ "required": [
1902
+ "file",
1903
+ "lineNo",
1904
+ "excerpt"
1905
+ ]
1590
1906
  }
1591
1907
  },
1592
- "pr": {}
1908
+ "totalMatches": {
1909
+ "type": "number"
1910
+ },
1911
+ "filesScanned": {
1912
+ "type": "number"
1913
+ },
1914
+ "truncated": {
1915
+ "type": "boolean"
1916
+ }
1593
1917
  },
1594
1918
  "required": [
1595
- "path",
1596
- "prNumber",
1597
- "fields",
1598
- "pr"
1919
+ "root",
1920
+ "query",
1921
+ "matches",
1922
+ "totalMatches",
1923
+ "filesScanned",
1924
+ "truncated"
1599
1925
  ]
1600
1926
  },
1601
1927
  "evidence": {
@@ -1606,6 +1932,9 @@
1606
1932
  "type": {
1607
1933
  "type": "string"
1608
1934
  },
1935
+ "ref": {
1936
+ "type": "string"
1937
+ },
1609
1938
  "summary": {
1610
1939
  "type": "string"
1611
1940
  },
@@ -1615,6 +1944,7 @@
1615
1944
  },
1616
1945
  "required": [
1617
1946
  "type",
1947
+ "ref",
1618
1948
  "summary",
1619
1949
  "createdAt"
1620
1950
  ]
@@ -1626,49 +1956,22 @@
1626
1956
  "evidence"
1627
1957
  ]
1628
1958
  },
1629
- "sourcePath": "src/git/gitTools",
1630
- "exportName": "gitPrView",
1959
+ "sourcePath": "src/fs/searchText",
1960
+ "exportName": "searchText",
1631
1961
  "sideEffect": "none"
1632
1962
  },
1633
1963
  {
1634
- "name": "downloadFile",
1635
- "description": "Download a file from a URL and save to the sandbox with size limit and SHA-256 integrity hash.",
1964
+ "name": "sha256",
1965
+ "description": "Compute SHA-256 hash of a file in the sandbox.",
1636
1966
  "inputSchema": {
1637
1967
  "type": "object",
1638
1968
  "properties": {
1639
- "url": {
1640
- "type": "string"
1641
- },
1642
- "uri": {
1643
- "type": "string"
1644
- },
1645
- "destPath": {
1646
- "type": "string"
1647
- },
1648
- "destination": {
1649
- "type": "string"
1650
- },
1651
- "filePath": {
1969
+ "path": {
1652
1970
  "type": "string"
1653
- },
1654
- "headers": {
1655
- "type": "object",
1656
- "properties": {}
1657
- },
1658
- "timeoutMs": {
1659
- "type": "number"
1660
- },
1661
- "maxBytes": {
1662
- "type": "number"
1663
- },
1664
- "overwrite": {
1665
- "type": "object",
1666
- "properties": {}
1667
1971
  }
1668
1972
  },
1669
1973
  "required": [
1670
- "url",
1671
- "destPath"
1974
+ "path"
1672
1975
  ]
1673
1976
  },
1674
1977
  "outputSchema": {
@@ -1677,28 +1980,20 @@
1677
1980
  "result": {
1678
1981
  "type": "object",
1679
1982
  "properties": {
1680
- "destPath": {
1983
+ "sha256": {
1681
1984
  "type": "string"
1682
1985
  },
1683
- "bytes": {
1684
- "type": "number"
1685
- },
1686
- "sha256": {
1986
+ "path": {
1687
1987
  "type": "string"
1688
1988
  },
1689
- "status": {
1989
+ "bytes": {
1690
1990
  "type": "number"
1691
- },
1692
- "url": {
1693
- "type": "string"
1694
1991
  }
1695
1992
  },
1696
1993
  "required": [
1697
- "destPath",
1698
- "bytes",
1699
1994
  "sha256",
1700
- "status",
1701
- "url"
1995
+ "path",
1996
+ "bytes"
1702
1997
  ]
1703
1998
  },
1704
1999
  "evidence": {
@@ -1733,35 +2028,31 @@
1733
2028
  "evidence"
1734
2029
  ]
1735
2030
  },
1736
- "sourcePath": "src/http/downloadFile",
1737
- "exportName": "downloadFile",
1738
- "sideEffect": "local_write"
2031
+ "sourcePath": "src/fs/sha256",
2032
+ "exportName": "sha256",
2033
+ "sideEffect": "none"
1739
2034
  },
1740
2035
  {
1741
- "name": "duckduckgoSearch",
1742
- "description": "Search the web via DuckDuckGo (no API key required), with HTML fallback when no instant answers.",
2036
+ "name": "writeText",
2037
+ "description": "Create or overwrite a UTF-8 text file in the sandbox, with auto mkdir and overwrite protection.",
1743
2038
  "inputSchema": {
1744
2039
  "type": "object",
1745
2040
  "properties": {
1746
- "query": {
2041
+ "path": {
1747
2042
  "type": "string"
1748
2043
  },
1749
- "q": {
2044
+ "content": {
1750
2045
  "type": "string"
1751
2046
  },
1752
- "maxResults": {
1753
- "type": "number"
1754
- },
1755
- "timeoutMs": {
1756
- "type": "number"
2047
+ "overwrite": {
2048
+ "type": "object",
2049
+ "properties": {}
1757
2050
  },
1758
- "maxBytes": {
1759
- "type": "number"
2051
+ "mkdirp": {
2052
+ "type": "object",
2053
+ "properties": {}
1760
2054
  }
1761
- },
1762
- "required": [
1763
- "query"
1764
- ]
2055
+ }
1765
2056
  },
1766
2057
  "outputSchema": {
1767
2058
  "type": "object",
@@ -1769,68 +2060,20 @@
1769
2060
  "result": {
1770
2061
  "type": "object",
1771
2062
  "properties": {
1772
- "query": {
1773
- "type": "string"
1774
- },
1775
- "abstract": {
1776
- "type": "string"
1777
- },
1778
- "abstractUrl": {
2063
+ "path": {
1779
2064
  "type": "string"
1780
2065
  },
1781
- "abstractSource": {
1782
- "type": "string"
2066
+ "bytes": {
2067
+ "type": "number"
1783
2068
  },
1784
- "heading": {
2069
+ "sha256": {
1785
2070
  "type": "string"
1786
- },
1787
- "results": {
1788
- "type": "array",
1789
- "items": {
1790
- "type": "object",
1791
- "properties": {
1792
- "url": {
1793
- "type": "string"
1794
- },
1795
- "title": {
1796
- "type": "string"
1797
- },
1798
- "snippet": {
1799
- "type": "string"
1800
- }
1801
- },
1802
- "required": [
1803
- "url",
1804
- "title"
1805
- ]
1806
- }
1807
- },
1808
- "relatedTopics": {
1809
- "type": "array",
1810
- "items": {
1811
- "type": "object",
1812
- "properties": {
1813
- "text": {
1814
- "type": "string"
1815
- },
1816
- "url": {
1817
- "type": "string"
1818
- }
1819
- },
1820
- "required": [
1821
- "text"
1822
- ]
1823
- }
1824
2071
  }
1825
2072
  },
1826
2073
  "required": [
1827
- "query",
1828
- "abstract",
1829
- "abstractUrl",
1830
- "abstractSource",
1831
- "heading",
1832
- "results",
1833
- "relatedTopics"
2074
+ "path",
2075
+ "bytes",
2076
+ "sha256"
1834
2077
  ]
1835
2078
  },
1836
2079
  "evidence": {
@@ -1865,46 +2108,47 @@
1865
2108
  "evidence"
1866
2109
  ]
1867
2110
  },
1868
- "sourcePath": "src/http/duckduckgoSearch",
1869
- "exportName": "duckduckgoSearch",
1870
- "sideEffect": "none"
2111
+ "sourcePath": "src/fs/writeText",
2112
+ "exportName": "writeText",
2113
+ "sideEffect": "local_write"
1871
2114
  },
1872
2115
  {
1873
- "name": "fetchJson",
1874
- "description": "Fetch a URL and return the response as parsed JSON.",
2116
+ "name": "gitRead",
2117
+ "description": "Read repository information via allowlisted git read-only subcommands.",
1875
2118
  "inputSchema": {
1876
2119
  "type": "object",
1877
2120
  "properties": {
1878
- "url": {
2121
+ "path": {
1879
2122
  "type": "string"
1880
2123
  },
1881
- "uri": {
2124
+ "repoPath": {
1882
2125
  "type": "string"
1883
2126
  },
1884
- "method": {
1885
- "type": "string",
1886
- "enum": [
1887
- "GET",
1888
- "POST"
1889
- ]
2127
+ "command": {
2128
+ "type": "string"
1890
2129
  },
1891
- "headers": {
1892
- "type": "object",
1893
- "properties": {}
2130
+ "subcommand": {
2131
+ "type": "string"
1894
2132
  },
1895
- "body": {
1896
- "type": "object",
1897
- "properties": {}
2133
+ "args": {
2134
+ "type": "array",
2135
+ "items": {
2136
+ "type": "string"
2137
+ }
2138
+ },
2139
+ "arguments": {
2140
+ "type": "array",
2141
+ "items": {
2142
+ "type": "string"
2143
+ }
1898
2144
  },
1899
2145
  "timeoutMs": {
1900
2146
  "type": "number"
1901
- },
1902
- "maxBytes": {
1903
- "type": "number"
1904
2147
  }
1905
2148
  },
1906
2149
  "required": [
1907
- "url"
2150
+ "path",
2151
+ "command"
1908
2152
  ]
1909
2153
  },
1910
2154
  "outputSchema": {
@@ -1913,22 +2157,28 @@
1913
2157
  "result": {
1914
2158
  "type": "object",
1915
2159
  "properties": {
1916
- "url": {
2160
+ "path": {
1917
2161
  "type": "string"
1918
2162
  },
1919
- "status": {
1920
- "type": "number"
2163
+ "command": {
2164
+ "type": "string"
1921
2165
  },
1922
- "json": {},
1923
- "bytes": {
2166
+ "stdout": {
2167
+ "type": "string"
2168
+ },
2169
+ "stderr": {
2170
+ "type": "string"
2171
+ },
2172
+ "exitCode": {
1924
2173
  "type": "number"
1925
2174
  }
1926
2175
  },
1927
2176
  "required": [
1928
- "url",
1929
- "status",
1930
- "json",
1931
- "bytes"
2177
+ "path",
2178
+ "command",
2179
+ "stdout",
2180
+ "stderr",
2181
+ "exitCode"
1932
2182
  ]
1933
2183
  },
1934
2184
  "evidence": {
@@ -1939,9 +2189,6 @@
1939
2189
  "type": {
1940
2190
  "type": "string"
1941
2191
  },
1942
- "ref": {
1943
- "type": "string"
1944
- },
1945
2192
  "summary": {
1946
2193
  "type": "string"
1947
2194
  },
@@ -1951,7 +2198,6 @@
1951
2198
  },
1952
2199
  "required": [
1953
2200
  "type",
1954
- "ref",
1955
2201
  "summary",
1956
2202
  "createdAt"
1957
2203
  ]
@@ -1963,31 +2209,60 @@
1963
2209
  "evidence"
1964
2210
  ]
1965
2211
  },
1966
- "sourcePath": "src/http/fetchJson",
1967
- "exportName": "fetchJson",
2212
+ "sourcePath": "src/git/gitTools",
2213
+ "exportName": "gitRead",
1968
2214
  "sideEffect": "none"
1969
2215
  },
1970
2216
  {
1971
- "name": "fetchPageMainContent",
1972
- "description": "Fetch a web page and extract its main readable content, stripping navigation, headers, and boilerplate.",
2217
+ "name": "gitLogHistory",
2218
+ "description": "Track detailed git commit history, optionally scoped to a file and including patches.",
1973
2219
  "inputSchema": {
1974
2220
  "type": "object",
1975
2221
  "properties": {
1976
- "url": {
2222
+ "path": {
1977
2223
  "type": "string"
1978
2224
  },
1979
- "uri": {
2225
+ "repoPath": {
1980
2226
  "type": "string"
1981
2227
  },
1982
- "timeoutMs": {
2228
+ "filePath": {
2229
+ "type": "string"
2230
+ },
2231
+ "maxCount": {
1983
2232
  "type": "number"
1984
2233
  },
1985
- "maxBytes": {
2234
+ "since": {
2235
+ "type": "string"
2236
+ },
2237
+ "until": {
2238
+ "type": "string"
2239
+ },
2240
+ "author": {
2241
+ "type": "string"
2242
+ },
2243
+ "grep": {
2244
+ "type": "string"
2245
+ },
2246
+ "revisionRange": {
2247
+ "type": "string"
2248
+ },
2249
+ "follow": {
2250
+ "type": "object",
2251
+ "properties": {}
2252
+ },
2253
+ "includePatch": {
2254
+ "type": "object",
2255
+ "properties": {}
2256
+ },
2257
+ "patchMaxCommits": {
2258
+ "type": "number"
2259
+ },
2260
+ "timeoutMs": {
1986
2261
  "type": "number"
1987
2262
  }
1988
2263
  },
1989
2264
  "required": [
1990
- "url"
2265
+ "path"
1991
2266
  ]
1992
2267
  },
1993
2268
  "outputSchema": {
@@ -1996,32 +2271,74 @@
1996
2271
  "result": {
1997
2272
  "type": "object",
1998
2273
  "properties": {
1999
- "url": {
2000
- "type": "string"
2001
- },
2002
- "status": {
2003
- "type": "number"
2004
- },
2005
- "title": {
2274
+ "path": {
2006
2275
  "type": "string"
2007
2276
  },
2008
- "mainContent": {
2277
+ "filePath": {
2009
2278
  "type": "string"
2010
2279
  },
2011
- "bytes": {
2280
+ "total": {
2012
2281
  "type": "number"
2013
2282
  },
2014
- "isHtml": {
2015
- "type": "boolean"
2283
+ "commits": {
2284
+ "type": "array",
2285
+ "items": {
2286
+ "type": "object",
2287
+ "properties": {
2288
+ "hash": {
2289
+ "type": "string"
2290
+ },
2291
+ "authorName": {
2292
+ "type": "string"
2293
+ },
2294
+ "authorEmail": {
2295
+ "type": "string"
2296
+ },
2297
+ "date": {
2298
+ "type": "string"
2299
+ },
2300
+ "subject": {
2301
+ "type": "string"
2302
+ },
2303
+ "body": {
2304
+ "type": "string"
2305
+ }
2306
+ },
2307
+ "required": [
2308
+ "hash",
2309
+ "authorName",
2310
+ "authorEmail",
2311
+ "date",
2312
+ "subject",
2313
+ "body"
2314
+ ]
2315
+ }
2316
+ },
2317
+ "patches": {
2318
+ "type": "array",
2319
+ "items": {
2320
+ "type": "object",
2321
+ "properties": {
2322
+ "hash": {
2323
+ "type": "string"
2324
+ },
2325
+ "patch": {
2326
+ "type": "string"
2327
+ }
2328
+ },
2329
+ "required": [
2330
+ "hash",
2331
+ "patch"
2332
+ ]
2333
+ }
2016
2334
  }
2017
2335
  },
2018
2336
  "required": [
2019
- "url",
2020
- "status",
2021
- "title",
2022
- "mainContent",
2023
- "bytes",
2024
- "isHtml"
2337
+ "path",
2338
+ "filePath",
2339
+ "total",
2340
+ "commits",
2341
+ "patches"
2025
2342
  ]
2026
2343
  },
2027
2344
  "evidence": {
@@ -2032,9 +2349,6 @@
2032
2349
  "type": {
2033
2350
  "type": "string"
2034
2351
  },
2035
- "ref": {
2036
- "type": "string"
2037
- },
2038
2352
  "summary": {
2039
2353
  "type": "string"
2040
2354
  },
@@ -2044,7 +2358,6 @@
2044
2358
  },
2045
2359
  "required": [
2046
2360
  "type",
2047
- "ref",
2048
2361
  "summary",
2049
2362
  "createdAt"
2050
2363
  ]
@@ -2056,46 +2369,40 @@
2056
2369
  "evidence"
2057
2370
  ]
2058
2371
  },
2059
- "sourcePath": "src/http/fetchPageMainContent",
2060
- "exportName": "fetchPageMainContent",
2372
+ "sourcePath": "src/git/gitTools",
2373
+ "exportName": "gitLogHistory",
2061
2374
  "sideEffect": "none"
2062
2375
  },
2063
2376
  {
2064
- "name": "fetchText",
2065
- "description": "Fetch a URL and return the response body as text. Supports GET and POST.",
2377
+ "name": "gitSwitchBranch",
2378
+ "description": "Switch git branch in a repository.",
2066
2379
  "inputSchema": {
2067
2380
  "type": "object",
2068
2381
  "properties": {
2069
- "url": {
2382
+ "path": {
2070
2383
  "type": "string"
2071
2384
  },
2072
- "uri": {
2385
+ "repoPath": {
2073
2386
  "type": "string"
2074
2387
  },
2075
- "method": {
2076
- "type": "string",
2077
- "enum": [
2078
- "GET",
2079
- "POST"
2080
- ]
2388
+ "branch": {
2389
+ "type": "string"
2081
2390
  },
2082
- "headers": {
2391
+ "create": {
2083
2392
  "type": "object",
2084
2393
  "properties": {}
2085
2394
  },
2086
- "body": {
2395
+ "trackRemote": {
2087
2396
  "type": "object",
2088
2397
  "properties": {}
2089
2398
  },
2090
2399
  "timeoutMs": {
2091
2400
  "type": "number"
2092
- },
2093
- "maxBytes": {
2094
- "type": "number"
2095
2401
  }
2096
2402
  },
2097
2403
  "required": [
2098
- "url"
2404
+ "path",
2405
+ "branch"
2099
2406
  ]
2100
2407
  },
2101
2408
  "outputSchema": {
@@ -2104,29 +2411,36 @@
2104
2411
  "result": {
2105
2412
  "type": "object",
2106
2413
  "properties": {
2107
- "url": {
2414
+ "path": {
2108
2415
  "type": "string"
2109
2416
  },
2110
- "status": {
2111
- "type": "number"
2417
+ "branch": {
2418
+ "type": "string"
2112
2419
  },
2113
- "headers": {
2114
- "type": "object",
2115
- "properties": {}
2420
+ "created": {
2421
+ "type": "boolean"
2116
2422
  },
2117
- "text": {
2423
+ "trackedRemote": {
2424
+ "type": "boolean"
2425
+ },
2426
+ "stdout": {
2118
2427
  "type": "string"
2119
2428
  },
2120
- "bytes": {
2429
+ "stderr": {
2430
+ "type": "string"
2431
+ },
2432
+ "exitCode": {
2121
2433
  "type": "number"
2122
2434
  }
2123
2435
  },
2124
2436
  "required": [
2125
- "url",
2126
- "status",
2127
- "headers",
2128
- "text",
2129
- "bytes"
2437
+ "path",
2438
+ "branch",
2439
+ "created",
2440
+ "trackedRemote",
2441
+ "stdout",
2442
+ "stderr",
2443
+ "exitCode"
2130
2444
  ]
2131
2445
  },
2132
2446
  "evidence": {
@@ -2137,9 +2451,6 @@
2137
2451
  "type": {
2138
2452
  "type": "string"
2139
2453
  },
2140
- "ref": {
2141
- "type": "string"
2142
- },
2143
2454
  "summary": {
2144
2455
  "type": "string"
2145
2456
  },
@@ -2149,7 +2460,6 @@
2149
2460
  },
2150
2461
  "required": [
2151
2462
  "type",
2152
- "ref",
2153
2463
  "summary",
2154
2464
  "createdAt"
2155
2465
  ]
@@ -2161,23 +2471,33 @@
2161
2471
  "evidence"
2162
2472
  ]
2163
2473
  },
2164
- "sourcePath": "src/http/fetchText",
2165
- "exportName": "fetchText",
2166
- "sideEffect": "none"
2474
+ "sourcePath": "src/git/gitTools",
2475
+ "exportName": "gitSwitchBranch",
2476
+ "sideEffect": "local_write"
2167
2477
  },
2168
2478
  {
2169
- "name": "head",
2170
- "description": "Send an HTTP HEAD request to check URL status and headers without downloading the body.",
2479
+ "name": "gitPull",
2480
+ "description": "Pull updates from remote in a repository.",
2171
2481
  "inputSchema": {
2172
2482
  "type": "object",
2173
2483
  "properties": {
2174
- "url": {
2484
+ "path": {
2175
2485
  "type": "string"
2176
2486
  },
2177
- "uri": {
2487
+ "repoPath": {
2488
+ "type": "string"
2489
+ },
2490
+ "remote": {
2491
+ "type": "string"
2492
+ },
2493
+ "branch": {
2178
2494
  "type": "string"
2179
2495
  },
2180
- "headers": {
2496
+ "rebase": {
2497
+ "type": "object",
2498
+ "properties": {}
2499
+ },
2500
+ "ffOnly": {
2181
2501
  "type": "object",
2182
2502
  "properties": {}
2183
2503
  },
@@ -2186,7 +2506,7 @@
2186
2506
  }
2187
2507
  },
2188
2508
  "required": [
2189
- "url"
2509
+ "path"
2190
2510
  ]
2191
2511
  },
2192
2512
  "outputSchema": {
@@ -2195,21 +2515,40 @@
2195
2515
  "result": {
2196
2516
  "type": "object",
2197
2517
  "properties": {
2198
- "url": {
2518
+ "path": {
2199
2519
  "type": "string"
2200
2520
  },
2201
- "status": {
2202
- "type": "number"
2521
+ "remote": {
2522
+ "type": "string"
2203
2523
  },
2204
- "headers": {
2205
- "type": "object",
2206
- "properties": {}
2524
+ "branch": {
2525
+ "type": "string"
2526
+ },
2527
+ "ffOnly": {
2528
+ "type": "boolean"
2529
+ },
2530
+ "rebase": {
2531
+ "type": "boolean"
2532
+ },
2533
+ "stdout": {
2534
+ "type": "string"
2535
+ },
2536
+ "stderr": {
2537
+ "type": "string"
2538
+ },
2539
+ "exitCode": {
2540
+ "type": "number"
2207
2541
  }
2208
2542
  },
2209
2543
  "required": [
2210
- "url",
2211
- "status",
2212
- "headers"
2544
+ "path",
2545
+ "remote",
2546
+ "branch",
2547
+ "ffOnly",
2548
+ "rebase",
2549
+ "stdout",
2550
+ "stderr",
2551
+ "exitCode"
2213
2552
  ]
2214
2553
  },
2215
2554
  "evidence": {
@@ -2220,9 +2559,6 @@
2220
2559
  "type": {
2221
2560
  "type": "string"
2222
2561
  },
2223
- "ref": {
2224
- "type": "string"
2225
- },
2226
2562
  "summary": {
2227
2563
  "type": "string"
2228
2564
  },
@@ -2232,7 +2568,6 @@
2232
2568
  },
2233
2569
  "required": [
2234
2570
  "type",
2235
- "ref",
2236
2571
  "summary",
2237
2572
  "createdAt"
2238
2573
  ]
@@ -2244,51 +2579,42 @@
2244
2579
  "evidence"
2245
2580
  ]
2246
2581
  },
2247
- "sourcePath": "src/http/head",
2248
- "exportName": "head",
2249
- "sideEffect": "none"
2582
+ "sourcePath": "src/git/gitTools",
2583
+ "exportName": "gitPull",
2584
+ "sideEffect": "local_write"
2250
2585
  },
2251
2586
  {
2252
- "name": "yahooFinanceQuote",
2253
- "description": "Fetch real-time stock quotes (price, change, volume) from Yahoo Finance (no API key required).",
2587
+ "name": "gitPrView",
2588
+ "description": "View a GitHub pull request using GitHub CLI (gh pr view).",
2254
2589
  "inputSchema": {
2255
2590
  "type": "object",
2256
2591
  "properties": {
2257
- "symbols": {
2258
- "type": "array",
2259
- "items": {}
2592
+ "path": {
2593
+ "type": "string"
2260
2594
  },
2261
- "symbol": {
2262
- "type": "object",
2263
- "properties": {}
2595
+ "repoPath": {
2596
+ "type": "string"
2264
2597
  },
2265
- "tickers": {
2598
+ "prNumber": {
2599
+ "type": "number"
2600
+ },
2601
+ "comments": {
2266
2602
  "type": "object",
2267
2603
  "properties": {}
2268
2604
  },
2269
- "range": {
2270
- "type": "string",
2271
- "enum": [
2272
- "1d",
2273
- "5d",
2274
- "1mo",
2275
- "3mo",
2276
- "6mo",
2277
- "1y",
2278
- "2y",
2279
- "5y",
2280
- "max"
2281
- ]
2605
+ "jsonFields": {
2606
+ "type": "array",
2607
+ "items": {
2608
+ "type": "string"
2609
+ }
2282
2610
  },
2283
2611
  "timeoutMs": {
2284
2612
  "type": "number"
2285
- },
2286
- "maxBytes": {
2287
- "type": "number"
2288
2613
  }
2289
2614
  },
2290
2615
  "required": [
2291
- "symbols"
2616
+ "path",
2617
+ "prNumber"
2292
2618
  ]
2293
2619
  },
2294
2620
  "outputSchema": {
@@ -2297,75 +2623,25 @@
2297
2623
  "result": {
2298
2624
  "type": "object",
2299
2625
  "properties": {
2300
- "symbols": {
2301
- "type": "array",
2302
- "items": {
2303
- "type": "string"
2304
- }
2626
+ "path": {
2627
+ "type": "string"
2305
2628
  },
2306
- "quotes": {
2629
+ "prNumber": {
2630
+ "type": "number"
2631
+ },
2632
+ "fields": {
2307
2633
  "type": "array",
2308
2634
  "items": {
2309
- "type": "object",
2310
- "properties": {
2311
- "symbol": {
2312
- "type": "string"
2313
- },
2314
- "currency": {
2315
- "type": "string"
2316
- },
2317
- "price": {
2318
- "type": "number"
2319
- },
2320
- "previousClose": {
2321
- "type": "number"
2322
- },
2323
- "change": {
2324
- "type": "number"
2325
- },
2326
- "changePercent": {
2327
- "type": "number"
2328
- },
2329
- "open": {
2330
- "type": "number"
2331
- },
2332
- "high": {
2333
- "type": "number"
2334
- },
2335
- "low": {
2336
- "type": "number"
2337
- },
2338
- "volume": {
2339
- "type": "number"
2340
- },
2341
- "timestamp": {
2342
- "type": "number"
2343
- }
2344
- },
2345
- "required": [
2346
- "symbol"
2347
- ]
2635
+ "type": "string"
2348
2636
  }
2349
2637
  },
2350
- "range": {
2351
- "type": "string",
2352
- "enum": [
2353
- "1d",
2354
- "5d",
2355
- "1mo",
2356
- "3mo",
2357
- "6mo",
2358
- "1y",
2359
- "2y",
2360
- "5y",
2361
- "max"
2362
- ]
2363
- }
2638
+ "pr": {}
2364
2639
  },
2365
2640
  "required": [
2366
- "symbols",
2367
- "quotes",
2368
- "range"
2641
+ "path",
2642
+ "prNumber",
2643
+ "fields",
2644
+ "pr"
2369
2645
  ]
2370
2646
  },
2371
2647
  "evidence": {
@@ -2376,9 +2652,6 @@
2376
2652
  "type": {
2377
2653
  "type": "string"
2378
2654
  },
2379
- "ref": {
2380
- "type": "string"
2381
- },
2382
2655
  "summary": {
2383
2656
  "type": "string"
2384
2657
  },
@@ -2388,7 +2661,6 @@
2388
2661
  },
2389
2662
  "required": [
2390
2663
  "type",
2391
- "ref",
2392
2664
  "summary",
2393
2665
  "createdAt"
2394
2666
  ]
@@ -2400,39 +2672,50 @@
2400
2672
  "evidence"
2401
2673
  ]
2402
2674
  },
2403
- "sourcePath": "src/http/yahooFinance",
2404
- "exportName": "yahooFinanceQuote",
2675
+ "sourcePath": "src/git/gitTools",
2676
+ "exportName": "gitPrView",
2405
2677
  "sideEffect": "none"
2406
2678
  },
2407
2679
  {
2408
- "name": "itermCreateWindow",
2409
- "description": "Create a new iTerm2 window, optionally with profile/command and initial names.",
2680
+ "name": "downloadFile",
2681
+ "description": "Download a file from a URL and save to the sandbox with size limit and SHA-256 integrity hash.",
2410
2682
  "inputSchema": {
2411
2683
  "type": "object",
2412
2684
  "properties": {
2413
- "profile": {
2685
+ "url": {
2414
2686
  "type": "string"
2415
2687
  },
2416
- "command": {
2688
+ "uri": {
2417
2689
  "type": "string"
2418
2690
  },
2419
- "cmd": {
2691
+ "destPath": {
2420
2692
  "type": "string"
2421
2693
  },
2422
- "activate": {
2694
+ "destination": {
2695
+ "type": "string"
2696
+ },
2697
+ "filePath": {
2698
+ "type": "string"
2699
+ },
2700
+ "headers": {
2423
2701
  "type": "object",
2424
2702
  "properties": {}
2425
2703
  },
2426
- "windowName": {
2427
- "type": "string"
2704
+ "timeoutMs": {
2705
+ "type": "number"
2428
2706
  },
2429
- "tabName": {
2430
- "type": "string"
2707
+ "maxBytes": {
2708
+ "type": "number"
2431
2709
  },
2432
- "sessionName": {
2433
- "type": "string"
2710
+ "overwrite": {
2711
+ "type": "object",
2712
+ "properties": {}
2434
2713
  }
2435
- }
2714
+ },
2715
+ "required": [
2716
+ "url",
2717
+ "destPath"
2718
+ ]
2436
2719
  },
2437
2720
  "outputSchema": {
2438
2721
  "type": "object",
@@ -2440,32 +2723,28 @@
2440
2723
  "result": {
2441
2724
  "type": "object",
2442
2725
  "properties": {
2443
- "profile": {
2444
- "type": "string"
2445
- },
2446
- "commandText": {
2726
+ "destPath": {
2447
2727
  "type": "string"
2448
2728
  },
2449
- "windowId": {
2450
- "type": "number"
2451
- },
2452
- "tabIndex": {
2729
+ "bytes": {
2453
2730
  "type": "number"
2454
2731
  },
2455
- "sessionId": {
2732
+ "sha256": {
2456
2733
  "type": "string"
2457
2734
  },
2458
- "sessionUniqueId": {
2735
+ "status": {
2736
+ "type": "number"
2737
+ },
2738
+ "url": {
2459
2739
  "type": "string"
2460
2740
  }
2461
2741
  },
2462
2742
  "required": [
2463
- "profile",
2464
- "commandText",
2465
- "windowId",
2466
- "tabIndex",
2467
- "sessionId",
2468
- "sessionUniqueId"
2743
+ "destPath",
2744
+ "bytes",
2745
+ "sha256",
2746
+ "status",
2747
+ "url"
2469
2748
  ]
2470
2749
  },
2471
2750
  "evidence": {
@@ -2500,39 +2779,35 @@
2500
2779
  "evidence"
2501
2780
  ]
2502
2781
  },
2503
- "sourcePath": "src/iterm/itermTools",
2504
- "exportName": "itermCreateWindow",
2782
+ "sourcePath": "src/http/downloadFile",
2783
+ "exportName": "downloadFile",
2505
2784
  "sideEffect": "local_write"
2506
2785
  },
2507
2786
  {
2508
- "name": "itermCreateTab",
2509
- "description": "Create a new tab in an iTerm2 window.",
2787
+ "name": "duckduckgoSearch",
2788
+ "description": "Search the web via DuckDuckGo (no API key required), with HTML fallback when no instant answers.",
2510
2789
  "inputSchema": {
2511
2790
  "type": "object",
2512
- "properties": {
2513
- "windowId": {
2514
- "type": "number"
2515
- },
2516
- "profile": {
2517
- "type": "string"
2518
- },
2519
- "command": {
2791
+ "properties": {
2792
+ "query": {
2520
2793
  "type": "string"
2521
2794
  },
2522
- "cmd": {
2795
+ "q": {
2523
2796
  "type": "string"
2524
2797
  },
2525
- "tabName": {
2526
- "type": "string"
2798
+ "maxResults": {
2799
+ "type": "number"
2527
2800
  },
2528
- "sessionName": {
2529
- "type": "string"
2801
+ "timeoutMs": {
2802
+ "type": "number"
2530
2803
  },
2531
- "activate": {
2532
- "type": "object",
2533
- "properties": {}
2804
+ "maxBytes": {
2805
+ "type": "number"
2534
2806
  }
2535
- }
2807
+ },
2808
+ "required": [
2809
+ "query"
2810
+ ]
2536
2811
  },
2537
2812
  "outputSchema": {
2538
2813
  "type": "object",
@@ -2540,32 +2815,68 @@
2540
2815
  "result": {
2541
2816
  "type": "object",
2542
2817
  "properties": {
2543
- "windowId": {
2544
- "type": "number"
2545
- },
2546
- "profile": {
2818
+ "query": {
2547
2819
  "type": "string"
2548
2820
  },
2549
- "commandText": {
2821
+ "abstract": {
2550
2822
  "type": "string"
2551
2823
  },
2552
- "tabIndex": {
2553
- "type": "number"
2824
+ "abstractUrl": {
2825
+ "type": "string"
2554
2826
  },
2555
- "sessionId": {
2827
+ "abstractSource": {
2556
2828
  "type": "string"
2557
2829
  },
2558
- "sessionUniqueId": {
2830
+ "heading": {
2559
2831
  "type": "string"
2832
+ },
2833
+ "results": {
2834
+ "type": "array",
2835
+ "items": {
2836
+ "type": "object",
2837
+ "properties": {
2838
+ "url": {
2839
+ "type": "string"
2840
+ },
2841
+ "title": {
2842
+ "type": "string"
2843
+ },
2844
+ "snippet": {
2845
+ "type": "string"
2846
+ }
2847
+ },
2848
+ "required": [
2849
+ "url",
2850
+ "title"
2851
+ ]
2852
+ }
2853
+ },
2854
+ "relatedTopics": {
2855
+ "type": "array",
2856
+ "items": {
2857
+ "type": "object",
2858
+ "properties": {
2859
+ "text": {
2860
+ "type": "string"
2861
+ },
2862
+ "url": {
2863
+ "type": "string"
2864
+ }
2865
+ },
2866
+ "required": [
2867
+ "text"
2868
+ ]
2869
+ }
2560
2870
  }
2561
2871
  },
2562
2872
  "required": [
2563
- "windowId",
2564
- "profile",
2565
- "commandText",
2566
- "tabIndex",
2567
- "sessionId",
2568
- "sessionUniqueId"
2873
+ "query",
2874
+ "abstract",
2875
+ "abstractUrl",
2876
+ "abstractSource",
2877
+ "heading",
2878
+ "results",
2879
+ "relatedTopics"
2569
2880
  ]
2570
2881
  },
2571
2882
  "evidence": {
@@ -2600,46 +2911,47 @@
2600
2911
  "evidence"
2601
2912
  ]
2602
2913
  },
2603
- "sourcePath": "src/iterm/itermTools",
2604
- "exportName": "itermCreateTab",
2605
- "sideEffect": "local_write"
2914
+ "sourcePath": "src/http/duckduckgoSearch",
2915
+ "exportName": "duckduckgoSearch",
2916
+ "sideEffect": "none"
2606
2917
  },
2607
2918
  {
2608
- "name": "itermSplitPane",
2609
- "description": "Split an iTerm2 session into a new pane.",
2919
+ "name": "fetchJson",
2920
+ "description": "Fetch a URL and return the response as parsed JSON.",
2610
2921
  "inputSchema": {
2611
2922
  "type": "object",
2612
2923
  "properties": {
2613
- "windowId": {
2614
- "type": "number"
2615
- },
2616
- "tabIndex": {
2617
- "type": "number"
2924
+ "url": {
2925
+ "type": "string"
2618
2926
  },
2619
- "sessionId": {
2927
+ "uri": {
2620
2928
  "type": "string"
2621
2929
  },
2622
- "direction": {
2930
+ "method": {
2623
2931
  "type": "string",
2624
2932
  "enum": [
2625
- "horizontal",
2626
- "vertical"
2933
+ "GET",
2934
+ "POST"
2627
2935
  ]
2628
2936
  },
2629
- "profile": {
2630
- "type": "string"
2631
- },
2632
- "command": {
2633
- "type": "string"
2634
- },
2635
- "cmd": {
2636
- "type": "string"
2937
+ "headers": {
2938
+ "type": "object",
2939
+ "properties": {}
2637
2940
  },
2638
- "activate": {
2941
+ "body": {
2639
2942
  "type": "object",
2640
2943
  "properties": {}
2944
+ },
2945
+ "timeoutMs": {
2946
+ "type": "number"
2947
+ },
2948
+ "maxBytes": {
2949
+ "type": "number"
2641
2950
  }
2642
- }
2951
+ },
2952
+ "required": [
2953
+ "url"
2954
+ ]
2643
2955
  },
2644
2956
  "outputSchema": {
2645
2957
  "type": "object",
@@ -2647,36 +2959,22 @@
2647
2959
  "result": {
2648
2960
  "type": "object",
2649
2961
  "properties": {
2650
- "direction": {
2651
- "type": "string"
2652
- },
2653
- "profile": {
2654
- "type": "string"
2655
- },
2656
- "commandText": {
2962
+ "url": {
2657
2963
  "type": "string"
2658
2964
  },
2659
- "windowId": {
2965
+ "status": {
2660
2966
  "type": "number"
2661
2967
  },
2662
- "tabIndex": {
2968
+ "json": {},
2969
+ "bytes": {
2663
2970
  "type": "number"
2664
- },
2665
- "sessionId": {
2666
- "type": "string"
2667
- },
2668
- "sessionUniqueId": {
2669
- "type": "string"
2670
2971
  }
2671
2972
  },
2672
2973
  "required": [
2673
- "direction",
2674
- "profile",
2675
- "commandText",
2676
- "windowId",
2677
- "tabIndex",
2678
- "sessionId",
2679
- "sessionUniqueId"
2974
+ "url",
2975
+ "status",
2976
+ "json",
2977
+ "bytes"
2680
2978
  ]
2681
2979
  },
2682
2980
  "evidence": {
@@ -2711,35 +3009,32 @@
2711
3009
  "evidence"
2712
3010
  ]
2713
3011
  },
2714
- "sourcePath": "src/iterm/itermTools",
2715
- "exportName": "itermSplitPane",
2716
- "sideEffect": "local_write"
3012
+ "sourcePath": "src/http/fetchJson",
3013
+ "exportName": "fetchJson",
3014
+ "sideEffect": "none"
2717
3015
  },
2718
3016
  {
2719
- "name": "itermRename",
2720
- "description": "Rename iTerm2 window/tab/session targets.",
3017
+ "name": "fetchPageMainContent",
3018
+ "description": "Fetch a web page and extract its main readable content, stripping navigation, headers, and boilerplate.",
2721
3019
  "inputSchema": {
2722
3020
  "type": "object",
2723
3021
  "properties": {
2724
- "windowId": {
2725
- "type": "number"
2726
- },
2727
- "tabIndex": {
2728
- "type": "number"
2729
- },
2730
- "sessionId": {
3022
+ "url": {
2731
3023
  "type": "string"
2732
3024
  },
2733
- "windowName": {
3025
+ "uri": {
2734
3026
  "type": "string"
2735
3027
  },
2736
- "tabName": {
2737
- "type": "string"
3028
+ "timeoutMs": {
3029
+ "type": "number"
2738
3030
  },
2739
- "sessionName": {
2740
- "type": "string"
3031
+ "maxBytes": {
3032
+ "type": "number"
2741
3033
  }
2742
- }
3034
+ },
3035
+ "required": [
3036
+ "url"
3037
+ ]
2743
3038
  },
2744
3039
  "outputSchema": {
2745
3040
  "type": "object",
@@ -2747,39 +3042,32 @@
2747
3042
  "result": {
2748
3043
  "type": "object",
2749
3044
  "properties": {
2750
- "windowName": {
2751
- "type": "object",
2752
- "properties": {}
2753
- },
2754
- "tabName": {
2755
- "type": "object",
2756
- "properties": {}
2757
- },
2758
- "sessionName": {
2759
- "type": "object",
2760
- "properties": {}
2761
- },
2762
- "windowId": {
2763
- "type": "number"
3045
+ "url": {
3046
+ "type": "string"
2764
3047
  },
2765
- "tabIndex": {
3048
+ "status": {
2766
3049
  "type": "number"
2767
3050
  },
2768
- "sessionId": {
3051
+ "title": {
2769
3052
  "type": "string"
2770
3053
  },
2771
- "sessionUniqueId": {
3054
+ "mainContent": {
2772
3055
  "type": "string"
3056
+ },
3057
+ "bytes": {
3058
+ "type": "number"
3059
+ },
3060
+ "isHtml": {
3061
+ "type": "boolean"
2773
3062
  }
2774
3063
  },
2775
3064
  "required": [
2776
- "windowName",
2777
- "tabName",
2778
- "sessionName",
2779
- "windowId",
2780
- "tabIndex",
2781
- "sessionId",
2782
- "sessionUniqueId"
3065
+ "url",
3066
+ "status",
3067
+ "title",
3068
+ "mainContent",
3069
+ "bytes",
3070
+ "isHtml"
2783
3071
  ]
2784
3072
  },
2785
3073
  "evidence": {
@@ -2814,41 +3102,47 @@
2814
3102
  "evidence"
2815
3103
  ]
2816
3104
  },
2817
- "sourcePath": "src/iterm/itermTools",
2818
- "exportName": "itermRename",
2819
- "sideEffect": "local_write"
3105
+ "sourcePath": "src/http/fetchPageMainContent",
3106
+ "exportName": "fetchPageMainContent",
3107
+ "sideEffect": "none"
2820
3108
  },
2821
3109
  {
2822
- "name": "itermSetBackgroundColor",
2823
- "description": "Set iTerm2 session background color.",
3110
+ "name": "fetchText",
3111
+ "description": "Fetch a URL and return the response body as text. Supports GET and POST.",
2824
3112
  "inputSchema": {
2825
3113
  "type": "object",
2826
- "properties": {
2827
- "windowId": {
2828
- "type": "number"
2829
- },
2830
- "tabIndex": {
2831
- "type": "number"
2832
- },
2833
- "sessionId": {
3114
+ "properties": {
3115
+ "url": {
2834
3116
  "type": "string"
2835
3117
  },
2836
- "hex": {
3118
+ "uri": {
2837
3119
  "type": "string"
2838
3120
  },
2839
- "red": {
2840
- "type": "number"
3121
+ "method": {
3122
+ "type": "string",
3123
+ "enum": [
3124
+ "GET",
3125
+ "POST"
3126
+ ]
2841
3127
  },
2842
- "green": {
2843
- "type": "number"
3128
+ "headers": {
3129
+ "type": "object",
3130
+ "properties": {}
2844
3131
  },
2845
- "blue": {
3132
+ "body": {
3133
+ "type": "object",
3134
+ "properties": {}
3135
+ },
3136
+ "timeoutMs": {
2846
3137
  "type": "number"
2847
3138
  },
2848
- "alpha": {
3139
+ "maxBytes": {
2849
3140
  "type": "number"
2850
3141
  }
2851
- }
3142
+ },
3143
+ "required": [
3144
+ "url"
3145
+ ]
2852
3146
  },
2853
3147
  "outputSchema": {
2854
3148
  "type": "object",
@@ -2856,48 +3150,29 @@
2856
3150
  "result": {
2857
3151
  "type": "object",
2858
3152
  "properties": {
2859
- "color": {
2860
- "type": "object",
2861
- "properties": {
2862
- "red": {
2863
- "type": "number"
2864
- },
2865
- "green": {
2866
- "type": "number"
2867
- },
2868
- "blue": {
2869
- "type": "number"
2870
- },
2871
- "alpha": {
2872
- "type": "number"
2873
- }
2874
- },
2875
- "required": [
2876
- "red",
2877
- "green",
2878
- "blue",
2879
- "alpha"
2880
- ]
3153
+ "url": {
3154
+ "type": "string"
2881
3155
  },
2882
- "windowId": {
3156
+ "status": {
2883
3157
  "type": "number"
2884
3158
  },
2885
- "tabIndex": {
2886
- "type": "number"
3159
+ "headers": {
3160
+ "type": "object",
3161
+ "properties": {}
2887
3162
  },
2888
- "sessionId": {
3163
+ "text": {
2889
3164
  "type": "string"
2890
3165
  },
2891
- "sessionUniqueId": {
2892
- "type": "string"
3166
+ "bytes": {
3167
+ "type": "number"
2893
3168
  }
2894
3169
  },
2895
3170
  "required": [
2896
- "color",
2897
- "windowId",
2898
- "tabIndex",
2899
- "sessionId",
2900
- "sessionUniqueId"
3171
+ "url",
3172
+ "status",
3173
+ "headers",
3174
+ "text",
3175
+ "bytes"
2901
3176
  ]
2902
3177
  },
2903
3178
  "evidence": {
@@ -2932,35 +3207,32 @@
2932
3207
  "evidence"
2933
3208
  ]
2934
3209
  },
2935
- "sourcePath": "src/iterm/itermTools",
2936
- "exportName": "itermSetBackgroundColor",
2937
- "sideEffect": "local_write"
3210
+ "sourcePath": "src/http/fetchText",
3211
+ "exportName": "fetchText",
3212
+ "sideEffect": "none"
2938
3213
  },
2939
3214
  {
2940
- "name": "itermSendText",
2941
- "description": "Send text to an iTerm2 session as if typed.",
3215
+ "name": "head",
3216
+ "description": "Send an HTTP HEAD request to check URL status and headers without downloading the body.",
2942
3217
  "inputSchema": {
2943
3218
  "type": "object",
2944
3219
  "properties": {
2945
- "text": {
3220
+ "url": {
2946
3221
  "type": "string"
2947
3222
  },
2948
- "windowId": {
2949
- "type": "number"
2950
- },
2951
- "tabIndex": {
2952
- "type": "number"
2953
- },
2954
- "sessionId": {
3223
+ "uri": {
2955
3224
  "type": "string"
2956
3225
  },
2957
- "newline": {
3226
+ "headers": {
2958
3227
  "type": "object",
2959
3228
  "properties": {}
3229
+ },
3230
+ "timeoutMs": {
3231
+ "type": "number"
2960
3232
  }
2961
3233
  },
2962
3234
  "required": [
2963
- "text"
3235
+ "url"
2964
3236
  ]
2965
3237
  },
2966
3238
  "outputSchema": {
@@ -2969,32 +3241,21 @@
2969
3241
  "result": {
2970
3242
  "type": "object",
2971
3243
  "properties": {
2972
- "text": {
3244
+ "url": {
2973
3245
  "type": "string"
2974
3246
  },
2975
- "newline": {
2976
- "type": "boolean"
2977
- },
2978
- "windowId": {
2979
- "type": "number"
2980
- },
2981
- "tabIndex": {
3247
+ "status": {
2982
3248
  "type": "number"
2983
3249
  },
2984
- "sessionId": {
2985
- "type": "string"
2986
- },
2987
- "sessionUniqueId": {
2988
- "type": "string"
3250
+ "headers": {
3251
+ "type": "object",
3252
+ "properties": {}
2989
3253
  }
2990
3254
  },
2991
3255
  "required": [
2992
- "text",
2993
- "newline",
2994
- "windowId",
2995
- "tabIndex",
2996
- "sessionId",
2997
- "sessionUniqueId"
3256
+ "url",
3257
+ "status",
3258
+ "headers"
2998
3259
  ]
2999
3260
  },
3000
3261
  "evidence": {
@@ -3029,16 +3290,52 @@
3029
3290
  "evidence"
3030
3291
  ]
3031
3292
  },
3032
- "sourcePath": "src/iterm/itermTools",
3033
- "exportName": "itermSendText",
3034
- "sideEffect": "local_write"
3293
+ "sourcePath": "src/http/head",
3294
+ "exportName": "head",
3295
+ "sideEffect": "none"
3035
3296
  },
3036
3297
  {
3037
- "name": "itermListWindows",
3038
- "description": "List iTerm2 windows, tabs, and sessions.",
3298
+ "name": "yahooFinanceQuote",
3299
+ "description": "Fetch real-time stock quotes (price, change, volume) from Yahoo Finance (no API key required).",
3039
3300
  "inputSchema": {
3040
3301
  "type": "object",
3041
- "properties": {}
3302
+ "properties": {
3303
+ "symbols": {
3304
+ "type": "array",
3305
+ "items": {}
3306
+ },
3307
+ "symbol": {
3308
+ "type": "object",
3309
+ "properties": {}
3310
+ },
3311
+ "tickers": {
3312
+ "type": "object",
3313
+ "properties": {}
3314
+ },
3315
+ "range": {
3316
+ "type": "string",
3317
+ "enum": [
3318
+ "1d",
3319
+ "5d",
3320
+ "1mo",
3321
+ "3mo",
3322
+ "6mo",
3323
+ "1y",
3324
+ "2y",
3325
+ "5y",
3326
+ "max"
3327
+ ]
3328
+ },
3329
+ "timeoutMs": {
3330
+ "type": "number"
3331
+ },
3332
+ "maxBytes": {
3333
+ "type": "number"
3334
+ }
3335
+ },
3336
+ "required": [
3337
+ "symbols"
3338
+ ]
3042
3339
  },
3043
3340
  "outputSchema": {
3044
3341
  "type": "object",
@@ -3046,63 +3343,75 @@
3046
3343
  "result": {
3047
3344
  "type": "object",
3048
3345
  "properties": {
3049
- "sessions": {
3346
+ "symbols": {
3347
+ "type": "array",
3348
+ "items": {
3349
+ "type": "string"
3350
+ }
3351
+ },
3352
+ "quotes": {
3050
3353
  "type": "array",
3051
3354
  "items": {
3052
3355
  "type": "object",
3053
3356
  "properties": {
3054
- "windowId": {
3055
- "type": "number"
3357
+ "symbol": {
3358
+ "type": "string"
3056
3359
  },
3057
- "windowName": {
3360
+ "currency": {
3058
3361
  "type": "string"
3059
3362
  },
3060
- "tabIndex": {
3363
+ "price": {
3061
3364
  "type": "number"
3062
3365
  },
3063
- "tabIndexZeroBased": {
3366
+ "previousClose": {
3064
3367
  "type": "number"
3065
3368
  },
3066
- "isCurrentTab": {
3067
- "type": "boolean"
3369
+ "change": {
3370
+ "type": "number"
3068
3371
  },
3069
- "sessionId": {
3070
- "type": "string"
3372
+ "changePercent": {
3373
+ "type": "number"
3071
3374
  },
3072
- "sessionUniqueId": {
3073
- "type": "string"
3375
+ "open": {
3376
+ "type": "number"
3074
3377
  },
3075
- "sessionName": {
3076
- "type": "string"
3378
+ "high": {
3379
+ "type": "number"
3077
3380
  },
3078
- "tty": {
3079
- "type": "string"
3381
+ "low": {
3382
+ "type": "number"
3080
3383
  },
3081
- "isCurrentSession": {
3082
- "type": "boolean"
3384
+ "volume": {
3385
+ "type": "number"
3386
+ },
3387
+ "timestamp": {
3388
+ "type": "number"
3083
3389
  }
3084
3390
  },
3085
3391
  "required": [
3086
- "windowId",
3087
- "windowName",
3088
- "tabIndex",
3089
- "tabIndexZeroBased",
3090
- "isCurrentTab",
3091
- "sessionId",
3092
- "sessionUniqueId",
3093
- "sessionName",
3094
- "tty",
3095
- "isCurrentSession"
3392
+ "symbol"
3096
3393
  ]
3097
3394
  }
3098
3395
  },
3099
- "count": {
3100
- "type": "number"
3396
+ "range": {
3397
+ "type": "string",
3398
+ "enum": [
3399
+ "1d",
3400
+ "5d",
3401
+ "1mo",
3402
+ "3mo",
3403
+ "6mo",
3404
+ "1y",
3405
+ "2y",
3406
+ "5y",
3407
+ "max"
3408
+ ]
3101
3409
  }
3102
3410
  },
3103
3411
  "required": [
3104
- "sessions",
3105
- "count"
3412
+ "symbols",
3413
+ "quotes",
3414
+ "range"
3106
3415
  ]
3107
3416
  },
3108
3417
  "evidence": {
@@ -3137,8 +3446,8 @@
3137
3446
  "evidence"
3138
3447
  ]
3139
3448
  },
3140
- "sourcePath": "src/iterm/itermTools",
3141
- "exportName": "itermListWindows",
3449
+ "sourcePath": "src/http/yahooFinance",
3450
+ "exportName": "yahooFinanceQuote",
3142
3451
  "sideEffect": "none"
3143
3452
  },
3144
3453
  {