@humain/terminal 0.0.2 → 0.0.3-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (680) hide show
  1. package/CHANGELOG.md +241 -24
  2. package/README.md +143 -119
  3. package/dist/cli/args.d.ts +4 -2
  4. package/dist/cli/args.d.ts.map +1 -1
  5. package/dist/cli/args.js +37 -39
  6. package/dist/cli/args.js.map +1 -1
  7. package/dist/cli/auth-check.d.ts +19 -0
  8. package/dist/cli/auth-check.d.ts.map +1 -0
  9. package/dist/cli/auth-check.js +50 -0
  10. package/dist/cli/auth-check.js.map +1 -0
  11. package/dist/cli/auth-command.d.ts +24 -0
  12. package/dist/cli/auth-command.d.ts.map +1 -0
  13. package/dist/cli/auth-command.js +103 -0
  14. package/dist/cli/auth-command.js.map +1 -0
  15. package/dist/cli/config-selector.d.ts.map +1 -1
  16. package/dist/cli/config-selector.js +2 -2
  17. package/dist/cli/config-selector.js.map +1 -1
  18. package/dist/cli/credential-print.d.ts +5 -15
  19. package/dist/cli/credential-print.d.ts.map +1 -1
  20. package/dist/cli/credential-print.js +42 -83
  21. package/dist/cli/credential-print.js.map +1 -1
  22. package/dist/cli/experimental/auth.d.ts +16 -0
  23. package/dist/cli/experimental/auth.d.ts.map +1 -0
  24. package/dist/cli/experimental/auth.js +13 -0
  25. package/dist/cli/experimental/auth.js.map +1 -0
  26. package/dist/cli/experimental/cli.d.ts +6 -0
  27. package/dist/cli/experimental/cli.d.ts.map +1 -0
  28. package/dist/cli/experimental/cli.js +5 -0
  29. package/dist/cli/experimental/cli.js.map +1 -0
  30. package/dist/cli/experimental/command-options.d.ts +17 -0
  31. package/dist/cli/experimental/command-options.d.ts.map +1 -0
  32. package/dist/cli/experimental/command-options.js +35 -0
  33. package/dist/cli/experimental/command-options.js.map +1 -0
  34. package/dist/cli/experimental/command.d.ts +63 -0
  35. package/dist/cli/experimental/command.d.ts.map +1 -0
  36. package/dist/cli/experimental/command.js +130 -0
  37. package/dist/cli/experimental/command.js.map +1 -0
  38. package/dist/cli/experimental/commands/client.d.ts +13 -0
  39. package/dist/cli/experimental/commands/client.d.ts.map +1 -0
  40. package/dist/cli/experimental/commands/client.js +25 -0
  41. package/dist/cli/experimental/commands/client.js.map +1 -0
  42. package/dist/cli/experimental/commands/pi.d.ts +15 -0
  43. package/dist/cli/experimental/commands/pi.d.ts.map +1 -0
  44. package/dist/cli/experimental/commands/pi.js +28 -0
  45. package/dist/cli/experimental/commands/pi.js.map +1 -0
  46. package/dist/cli/experimental/commands/server.d.ts +13 -0
  47. package/dist/cli/experimental/commands/server.d.ts.map +1 -0
  48. package/dist/cli/experimental/commands/server.js +25 -0
  49. package/dist/cli/experimental/commands/server.js.map +1 -0
  50. package/dist/cli/experimental/transport-address.d.ts +10 -0
  51. package/dist/cli/experimental/transport-address.d.ts.map +1 -0
  52. package/dist/cli/experimental/transport-address.js +38 -0
  53. package/dist/cli/experimental/transport-address.js.map +1 -0
  54. package/dist/cli/list-models.d.ts +1 -1
  55. package/dist/cli/list-models.d.ts.map +1 -1
  56. package/dist/cli/list-models.js +2 -2
  57. package/dist/cli/list-models.js.map +1 -1
  58. package/dist/cli/startup-ui.d.ts +1 -1
  59. package/dist/cli/startup-ui.d.ts.map +1 -1
  60. package/dist/cli/startup-ui.js +2 -2
  61. package/dist/cli/startup-ui.js.map +1 -1
  62. package/dist/client/index.d.ts +3 -0
  63. package/dist/client/index.d.ts.map +1 -0
  64. package/dist/client/index.js +3 -0
  65. package/dist/client/index.js.map +1 -0
  66. package/dist/client/remote-session.d.ts +53 -0
  67. package/dist/client/remote-session.d.ts.map +1 -0
  68. package/dist/client/remote-session.js +340 -0
  69. package/dist/client/remote-session.js.map +1 -0
  70. package/dist/client/transcript.d.ts +12 -0
  71. package/dist/client/transcript.d.ts.map +1 -0
  72. package/dist/client/transcript.js +98 -0
  73. package/dist/client/transcript.js.map +1 -0
  74. package/dist/core/agent-session-services.d.ts +1 -0
  75. package/dist/core/agent-session-services.d.ts.map +1 -1
  76. package/dist/core/agent-session-services.js +1 -0
  77. package/dist/core/agent-session-services.js.map +1 -1
  78. package/dist/core/agent-session.d.ts +1 -10
  79. package/dist/core/agent-session.d.ts.map +1 -1
  80. package/dist/core/agent-session.js +72 -70
  81. package/dist/core/agent-session.js.map +1 -1
  82. package/dist/core/auth-storage.d.ts +25 -9
  83. package/dist/core/auth-storage.d.ts.map +1 -1
  84. package/dist/core/auth-storage.js +237 -39
  85. package/dist/core/auth-storage.js.map +1 -1
  86. package/dist/core/extensions/index.d.ts +1 -1
  87. package/dist/core/extensions/index.d.ts.map +1 -1
  88. package/dist/core/extensions/index.js.map +1 -1
  89. package/dist/core/extensions/loader.d.ts.map +1 -1
  90. package/dist/core/extensions/loader.js +60 -41
  91. package/dist/core/extensions/loader.js.map +1 -1
  92. package/dist/core/extensions/runner.d.ts +2 -1
  93. package/dist/core/extensions/runner.d.ts.map +1 -1
  94. package/dist/core/extensions/runner.js +3 -0
  95. package/dist/core/extensions/runner.js.map +1 -1
  96. package/dist/core/extensions/types.d.ts +27 -4
  97. package/dist/core/extensions/types.d.ts.map +1 -1
  98. package/dist/core/extensions/types.js.map +1 -1
  99. package/dist/core/http-dispatcher.d.ts.map +1 -1
  100. package/dist/core/http-dispatcher.js +5 -0
  101. package/dist/core/http-dispatcher.js.map +1 -1
  102. package/dist/core/keybindings.d.ts +45 -5
  103. package/dist/core/keybindings.d.ts.map +1 -1
  104. package/dist/core/keybindings.js.map +1 -1
  105. package/dist/core/model-config.d.ts +29 -5
  106. package/dist/core/model-config.d.ts.map +1 -1
  107. package/dist/core/model-config.js +4 -0
  108. package/dist/core/model-config.js.map +1 -1
  109. package/dist/core/model-registry.d.ts +5 -3
  110. package/dist/core/model-registry.d.ts.map +1 -1
  111. package/dist/core/model-registry.js +13 -10
  112. package/dist/core/model-registry.js.map +1 -1
  113. package/dist/core/model-resolver.d.ts +4 -3
  114. package/dist/core/model-resolver.d.ts.map +1 -1
  115. package/dist/core/model-resolver.js +42 -10
  116. package/dist/core/model-resolver.js.map +1 -1
  117. package/dist/core/model-runtime.d.ts +30 -13
  118. package/dist/core/model-runtime.d.ts.map +1 -1
  119. package/dist/core/model-runtime.js +233 -73
  120. package/dist/core/model-runtime.js.map +1 -1
  121. package/dist/core/models-store.d.ts +12 -7
  122. package/dist/core/models-store.d.ts.map +1 -1
  123. package/dist/core/models-store.js +83 -14
  124. package/dist/core/models-store.js.map +1 -1
  125. package/dist/core/package-manager.d.ts +6 -3
  126. package/dist/core/package-manager.d.ts.map +1 -1
  127. package/dist/core/package-manager.js +80 -61
  128. package/dist/core/package-manager.js.map +1 -1
  129. package/dist/core/pi-manifest.d.ts +8 -0
  130. package/dist/core/pi-manifest.d.ts.map +1 -0
  131. package/dist/core/pi-manifest.js +28 -0
  132. package/dist/core/pi-manifest.js.map +1 -0
  133. package/dist/core/provider-composer.d.ts +4 -1
  134. package/dist/core/provider-composer.d.ts.map +1 -1
  135. package/dist/core/provider-composer.js +36 -15
  136. package/dist/core/provider-composer.js.map +1 -1
  137. package/dist/core/remote-catalog-provider.d.ts.map +1 -1
  138. package/dist/core/remote-catalog-provider.js +73 -67
  139. package/dist/core/remote-catalog-provider.js.map +1 -1
  140. package/dist/core/resource-loader.d.ts.map +1 -1
  141. package/dist/core/resource-loader.js +2 -2
  142. package/dist/core/resource-loader.js.map +1 -1
  143. package/dist/core/runtime-credentials.d.ts +5 -5
  144. package/dist/core/runtime-credentials.d.ts.map +1 -1
  145. package/dist/core/runtime-credentials.js +11 -8
  146. package/dist/core/runtime-credentials.js.map +1 -1
  147. package/dist/core/sdk.d.ts +1 -1
  148. package/dist/core/sdk.d.ts.map +1 -1
  149. package/dist/core/sdk.js +2 -2
  150. package/dist/core/sdk.js.map +1 -1
  151. package/dist/core/session-manager.d.ts.map +1 -1
  152. package/dist/core/session-manager.js +3 -1
  153. package/dist/core/session-manager.js.map +1 -1
  154. package/dist/core/settings-manager.d.ts +12 -0
  155. package/dist/core/settings-manager.d.ts.map +1 -1
  156. package/dist/core/settings-manager.js +40 -16
  157. package/dist/core/settings-manager.js.map +1 -1
  158. package/dist/core/system-prompt.d.ts.map +1 -1
  159. package/dist/core/system-prompt.js +8 -0
  160. package/dist/core/system-prompt.js.map +1 -1
  161. package/dist/core/tools/bash.d.ts +5 -1
  162. package/dist/core/tools/bash.d.ts.map +1 -1
  163. package/dist/core/tools/bash.js +16 -15
  164. package/dist/core/tools/bash.js.map +1 -1
  165. package/dist/core/tools/edit.d.ts +4 -0
  166. package/dist/core/tools/edit.d.ts.map +1 -1
  167. package/dist/core/tools/edit.js +11 -7
  168. package/dist/core/tools/edit.js.map +1 -1
  169. package/dist/core/tools/find.d.ts +7 -0
  170. package/dist/core/tools/find.d.ts.map +1 -1
  171. package/dist/core/tools/find.js +16 -19
  172. package/dist/core/tools/find.js.map +1 -1
  173. package/dist/core/tools/grep.d.ts +4 -0
  174. package/dist/core/tools/grep.d.ts.map +1 -1
  175. package/dist/core/tools/grep.js +5 -1
  176. package/dist/core/tools/grep.js.map +1 -1
  177. package/dist/core/tools/ls.d.ts +4 -0
  178. package/dist/core/tools/ls.d.ts.map +1 -1
  179. package/dist/core/tools/ls.js +5 -1
  180. package/dist/core/tools/ls.js.map +1 -1
  181. package/dist/core/tools/read.d.ts +4 -0
  182. package/dist/core/tools/read.d.ts.map +1 -1
  183. package/dist/core/tools/read.js +7 -3
  184. package/dist/core/tools/read.js.map +1 -1
  185. package/dist/core/tools/write.d.ts +4 -0
  186. package/dist/core/tools/write.d.ts.map +1 -1
  187. package/dist/core/tools/write.js +6 -2
  188. package/dist/core/tools/write.js.map +1 -1
  189. package/dist/extensions/llama/index.d.ts.map +1 -1
  190. package/dist/extensions/llama/index.js +11 -2
  191. package/dist/extensions/llama/index.js.map +1 -1
  192. package/dist/extensions/llama/provider.d.ts.map +1 -1
  193. package/dist/extensions/llama/provider.js +21 -7
  194. package/dist/extensions/llama/provider.js.map +1 -1
  195. package/dist/humain/agent-execution-protocol.d.ts +218 -0
  196. package/dist/humain/agent-execution-protocol.d.ts.map +1 -0
  197. package/dist/humain/agent-execution-protocol.js +204 -0
  198. package/dist/humain/agent-execution-protocol.js.map +1 -0
  199. package/dist/humain/agent-execution-runtime.d.ts +35 -0
  200. package/dist/humain/agent-execution-runtime.d.ts.map +1 -0
  201. package/dist/humain/agent-execution-runtime.js +170 -0
  202. package/dist/humain/agent-execution-runtime.js.map +1 -0
  203. package/dist/humain/index.d.ts.map +1 -1
  204. package/dist/humain/index.js +8 -7
  205. package/dist/humain/index.js.map +1 -1
  206. package/dist/humain/mcp-adapter/vendor/CHANGELOG.md +660 -0
  207. package/dist/humain/mcp-adapter/vendor/LICENSE +21 -0
  208. package/dist/humain/mcp-adapter/vendor/README.md +733 -0
  209. package/dist/humain/mcp-adapter/vendor/abort.ts +34 -0
  210. package/dist/humain/mcp-adapter/vendor/agent-dir.ts +60 -0
  211. package/dist/humain/mcp-adapter/vendor/agent-plugin-loader.ts +377 -0
  212. package/dist/humain/mcp-adapter/vendor/app-bridge.bundle.js +67 -0
  213. package/dist/humain/mcp-adapter/vendor/banner.png +0 -0
  214. package/dist/humain/mcp-adapter/vendor/cli.js +209 -0
  215. package/dist/humain/mcp-adapter/vendor/commands.ts +627 -0
  216. package/dist/humain/mcp-adapter/vendor/config.ts +1226 -0
  217. package/dist/humain/mcp-adapter/vendor/consent-manager.ts +64 -0
  218. package/dist/humain/mcp-adapter/vendor/direct-tools.ts +604 -0
  219. package/dist/humain/mcp-adapter/vendor/elicitation-handler.ts +348 -0
  220. package/dist/humain/mcp-adapter/vendor/error-signal.ts +21 -0
  221. package/dist/humain/mcp-adapter/vendor/errors.ts +223 -0
  222. package/dist/humain/mcp-adapter/vendor/glimpse-ui.ts +80 -0
  223. package/dist/humain/mcp-adapter/vendor/host-html-template.ts +461 -0
  224. package/dist/humain/mcp-adapter/vendor/index.bundle.d.mts +4 -0
  225. package/dist/humain/mcp-adapter/vendor/index.bundle.mjs +15923 -0
  226. package/dist/humain/mcp-adapter/vendor/index.ts +898 -0
  227. package/dist/humain/mcp-adapter/vendor/init.ts +649 -0
  228. package/dist/humain/mcp-adapter/vendor/json-schema-validator.ts +69 -0
  229. package/dist/humain/mcp-adapter/vendor/lifecycle.ts +147 -0
  230. package/dist/humain/mcp-adapter/vendor/logger.ts +169 -0
  231. package/dist/humain/mcp-adapter/vendor/mcp-auth-flow.ts +993 -0
  232. package/dist/humain/mcp-adapter/vendor/mcp-auth.ts +1000 -0
  233. package/dist/humain/mcp-adapter/vendor/mcp-callback-server.ts +510 -0
  234. package/dist/humain/mcp-adapter/vendor/mcp-code.ts +354 -0
  235. package/dist/humain/mcp-adapter/vendor/mcp-keyring-helper.cjs +89 -0
  236. package/dist/humain/mcp-adapter/vendor/mcp-oauth-provider.ts +616 -0
  237. package/dist/humain/mcp-adapter/vendor/mcp-output-guard.ts +408 -0
  238. package/dist/humain/mcp-adapter/vendor/mcp-panel.ts +1015 -0
  239. package/dist/humain/mcp-adapter/vendor/mcp-probe.ts +187 -0
  240. package/dist/humain/mcp-adapter/vendor/mcp-script-worker.mjs +130 -0
  241. package/dist/humain/mcp-adapter/vendor/mcp-setup-panel.ts +666 -0
  242. package/dist/humain/mcp-adapter/vendor/mcp-status.ts +109 -0
  243. package/dist/humain/mcp-adapter/vendor/mcp-trace.ts +306 -0
  244. package/dist/humain/mcp-adapter/vendor/metadata-cache.ts +353 -0
  245. package/dist/humain/mcp-adapter/vendor/npx-resolver.ts +543 -0
  246. package/dist/humain/mcp-adapter/vendor/oauth-handler.ts +30 -0
  247. package/dist/humain/mcp-adapter/vendor/oauth.ts +48 -0
  248. package/dist/humain/mcp-adapter/vendor/onboarding-state.ts +76 -0
  249. package/dist/humain/mcp-adapter/vendor/package.json +178 -0
  250. package/dist/humain/mcp-adapter/vendor/panel-keys.ts +53 -0
  251. package/dist/humain/mcp-adapter/vendor/prompts.ts +353 -0
  252. package/dist/humain/mcp-adapter/vendor/proxy-modes.ts +1331 -0
  253. package/dist/humain/mcp-adapter/vendor/resource-tools.ts +17 -0
  254. package/dist/humain/mcp-adapter/vendor/runtime-owner.ts +91 -0
  255. package/dist/humain/mcp-adapter/vendor/sampling-handler.ts +284 -0
  256. package/dist/humain/mcp-adapter/vendor/search-ranking.ts +206 -0
  257. package/dist/humain/mcp-adapter/vendor/server-manager.ts +1124 -0
  258. package/dist/humain/mcp-adapter/vendor/session-recovery.ts +151 -0
  259. package/dist/humain/mcp-adapter/vendor/skills/mcp-scripting/SKILL.md +38 -0
  260. package/dist/humain/mcp-adapter/vendor/state.ts +62 -0
  261. package/dist/humain/mcp-adapter/vendor/tool-approval.ts +182 -0
  262. package/dist/humain/mcp-adapter/vendor/tool-metadata.ts +276 -0
  263. package/dist/humain/mcp-adapter/vendor/tool-registrar.ts +253 -0
  264. package/dist/humain/mcp-adapter/vendor/tool-result-renderer.ts +423 -0
  265. package/dist/humain/mcp-adapter/vendor/ts-shape.ts +149 -0
  266. package/dist/humain/mcp-adapter/vendor/types.ts +859 -0
  267. package/dist/humain/mcp-adapter/vendor/ui-app-bridge-helpers.ts +40 -0
  268. package/dist/humain/mcp-adapter/vendor/ui-resource-handler.ts +250 -0
  269. package/dist/humain/mcp-adapter/vendor/ui-server.ts +866 -0
  270. package/dist/humain/mcp-adapter/vendor/ui-session.ts +570 -0
  271. package/dist/humain/mcp-adapter/vendor/ui-stream-types.ts +89 -0
  272. package/dist/humain/mcp-adapter/vendor/ui-tool-visibility.ts +25 -0
  273. package/dist/humain/mcp-adapter/vendor/unix-socket-transport.ts +85 -0
  274. package/dist/humain/mcp-adapter/vendor/utils.ts +310 -0
  275. package/dist/humain/mcp-adapter.d.ts +3 -0
  276. package/dist/humain/mcp-adapter.d.ts.map +1 -0
  277. package/dist/humain/mcp-adapter.js +5 -0
  278. package/dist/humain/mcp-adapter.js.map +1 -0
  279. package/dist/humain/pi-agent-execution-host.d.ts +34 -0
  280. package/dist/humain/pi-agent-execution-host.d.ts.map +1 -0
  281. package/dist/humain/pi-agent-execution-host.js +77 -0
  282. package/dist/humain/pi-agent-execution-host.js.map +1 -0
  283. package/dist/humain/web-access/host.d.ts +4 -0
  284. package/dist/humain/web-access/host.d.ts.map +1 -0
  285. package/dist/humain/web-access/host.js +3 -0
  286. package/dist/humain/web-access/host.js.map +1 -0
  287. package/dist/humain/web-access/index.d.ts +3 -0
  288. package/dist/humain/web-access/index.d.ts.map +1 -0
  289. package/dist/humain/web-access/index.js +5 -0
  290. package/dist/humain/web-access/index.js.map +1 -0
  291. package/dist/humain/web-access/vendor/activity.d.ts +34 -0
  292. package/dist/humain/web-access/vendor/activity.d.ts.map +1 -0
  293. package/dist/humain/web-access/vendor/activity.js +68 -0
  294. package/dist/humain/web-access/vendor/activity.js.map +1 -0
  295. package/dist/humain/web-access/vendor/anysearch.d.ts +8 -0
  296. package/dist/humain/web-access/vendor/anysearch.d.ts.map +1 -0
  297. package/dist/humain/web-access/vendor/anysearch.js +167 -0
  298. package/dist/humain/web-access/vendor/anysearch.js.map +1 -0
  299. package/dist/humain/web-access/vendor/bocha.d.ts +4 -0
  300. package/dist/humain/web-access/vendor/bocha.d.ts.map +1 -0
  301. package/dist/humain/web-access/vendor/bocha.js +219 -0
  302. package/dist/humain/web-access/vendor/bocha.js.map +1 -0
  303. package/dist/humain/web-access/vendor/brave.d.ts +4 -0
  304. package/dist/humain/web-access/vendor/brave.d.ts.map +1 -0
  305. package/dist/humain/web-access/vendor/brave.js +194 -0
  306. package/dist/humain/web-access/vendor/brave.js.map +1 -0
  307. package/dist/humain/web-access/vendor/brightdata-unlocker.d.ts +12 -0
  308. package/dist/humain/web-access/vendor/brightdata-unlocker.d.ts.map +1 -0
  309. package/dist/humain/web-access/vendor/brightdata-unlocker.js +230 -0
  310. package/dist/humain/web-access/vendor/brightdata-unlocker.js.map +1 -0
  311. package/dist/humain/web-access/vendor/brightdata.d.ts +8 -0
  312. package/dist/humain/web-access/vendor/brightdata.d.ts.map +1 -0
  313. package/dist/humain/web-access/vendor/brightdata.js +519 -0
  314. package/dist/humain/web-access/vendor/brightdata.js.map +1 -0
  315. package/dist/humain/web-access/vendor/chrome-cookies.d.ts +10 -0
  316. package/dist/humain/web-access/vendor/chrome-cookies.d.ts.map +1 -0
  317. package/dist/humain/web-access/vendor/chrome-cookies.js +438 -0
  318. package/dist/humain/web-access/vendor/chrome-cookies.js.map +1 -0
  319. package/dist/humain/web-access/vendor/content-find.d.ts +11 -0
  320. package/dist/humain/web-access/vendor/content-find.d.ts.map +1 -0
  321. package/dist/humain/web-access/vendor/content-find.js +117 -0
  322. package/dist/humain/web-access/vendor/content-find.js.map +1 -0
  323. package/dist/humain/web-access/vendor/credential-source.d.ts +28 -0
  324. package/dist/humain/web-access/vendor/credential-source.d.ts.map +1 -0
  325. package/dist/humain/web-access/vendor/credential-source.js +151 -0
  326. package/dist/humain/web-access/vendor/credential-source.js.map +1 -0
  327. package/dist/humain/web-access/vendor/curator-page.d.ts +29 -0
  328. package/dist/humain/web-access/vendor/curator-page.d.ts.map +1 -0
  329. package/dist/humain/web-access/vendor/curator-page.js +3554 -0
  330. package/dist/humain/web-access/vendor/curator-page.js.map +1 -0
  331. package/dist/humain/web-access/vendor/curator-server.d.ts +93 -0
  332. package/dist/humain/web-access/vendor/curator-server.d.ts.map +1 -0
  333. package/dist/humain/web-access/vendor/curator-server.js +688 -0
  334. package/dist/humain/web-access/vendor/curator-server.js.map +1 -0
  335. package/dist/humain/web-access/vendor/datalab-pdf-extract.d.ts +60 -0
  336. package/dist/humain/web-access/vendor/datalab-pdf-extract.d.ts.map +1 -0
  337. package/dist/humain/web-access/vendor/datalab-pdf-extract.js +416 -0
  338. package/dist/humain/web-access/vendor/datalab-pdf-extract.js.map +1 -0
  339. package/dist/humain/web-access/vendor/declared-web-links.d.ts +16 -0
  340. package/dist/humain/web-access/vendor/declared-web-links.d.ts.map +1 -0
  341. package/dist/humain/web-access/vendor/declared-web-links.js +168 -0
  342. package/dist/humain/web-access/vendor/declared-web-links.js.map +1 -0
  343. package/dist/humain/web-access/vendor/duckduckgo.d.ts +4 -0
  344. package/dist/humain/web-access/vendor/duckduckgo.d.ts.map +1 -0
  345. package/dist/humain/web-access/vendor/duckduckgo.js +123 -0
  346. package/dist/humain/web-access/vendor/duckduckgo.js.map +1 -0
  347. package/dist/humain/web-access/vendor/exa.d.ts +10 -0
  348. package/dist/humain/web-access/vendor/exa.d.ts.map +1 -0
  349. package/dist/humain/web-access/vendor/exa.js +426 -0
  350. package/dist/humain/web-access/vendor/exa.js.map +1 -0
  351. package/dist/humain/web-access/vendor/extract.d.ts +46 -0
  352. package/dist/humain/web-access/vendor/extract.d.ts.map +1 -0
  353. package/dist/humain/web-access/vendor/extract.js +1064 -0
  354. package/dist/humain/web-access/vendor/extract.js.map +1 -0
  355. package/dist/humain/web-access/vendor/feature-config.d.ts +3 -0
  356. package/dist/humain/web-access/vendor/feature-config.d.ts.map +1 -0
  357. package/dist/humain/web-access/vendor/feature-config.js +27 -0
  358. package/dist/humain/web-access/vendor/feature-config.js.map +1 -0
  359. package/dist/humain/web-access/vendor/fetch-params.d.ts +25 -0
  360. package/dist/humain/web-access/vendor/fetch-params.d.ts.map +1 -0
  361. package/dist/humain/web-access/vendor/fetch-params.js +57 -0
  362. package/dist/humain/web-access/vendor/fetch-params.js.map +1 -0
  363. package/dist/humain/web-access/vendor/firecrawl.d.ts +12 -0
  364. package/dist/humain/web-access/vendor/firecrawl.d.ts.map +1 -0
  365. package/dist/humain/web-access/vendor/firecrawl.js +239 -0
  366. package/dist/humain/web-access/vendor/firecrawl.js.map +1 -0
  367. package/dist/humain/web-access/vendor/gemini-api.d.ts +27 -0
  368. package/dist/humain/web-access/vendor/gemini-api.d.ts.map +1 -0
  369. package/dist/humain/web-access/vendor/gemini-api.js +230 -0
  370. package/dist/humain/web-access/vendor/gemini-api.js.map +1 -0
  371. package/dist/humain/web-access/vendor/gemini-pdf-extract.d.ts +9 -0
  372. package/dist/humain/web-access/vendor/gemini-pdf-extract.d.ts.map +1 -0
  373. package/dist/humain/web-access/vendor/gemini-pdf-extract.js +85 -0
  374. package/dist/humain/web-access/vendor/gemini-pdf-extract.js.map +1 -0
  375. package/dist/humain/web-access/vendor/gemini-search.d.ts +40 -0
  376. package/dist/humain/web-access/vendor/gemini-search.d.ts.map +1 -0
  377. package/dist/humain/web-access/vendor/gemini-search.js +814 -0
  378. package/dist/humain/web-access/vendor/gemini-search.js.map +1 -0
  379. package/dist/humain/web-access/vendor/gemini-url-context.d.ts +4 -0
  380. package/dist/humain/web-access/vendor/gemini-url-context.d.ts.map +1 -0
  381. package/dist/humain/web-access/vendor/gemini-url-context.js +101 -0
  382. package/dist/humain/web-access/vendor/gemini-url-context.js.map +1 -0
  383. package/dist/humain/web-access/vendor/gemini-web-config.d.ts +4 -0
  384. package/dist/humain/web-access/vendor/gemini-web-config.d.ts.map +1 -0
  385. package/dist/humain/web-access/vendor/gemini-web-config.js +42 -0
  386. package/dist/humain/web-access/vendor/gemini-web-config.js.map +1 -0
  387. package/dist/humain/web-access/vendor/gemini-web.d.ts +18 -0
  388. package/dist/humain/web-access/vendor/gemini-web.d.ts.map +1 -0
  389. package/dist/humain/web-access/vendor/gemini-web.js +385 -0
  390. package/dist/humain/web-access/vendor/gemini-web.js.map +1 -0
  391. package/dist/humain/web-access/vendor/github-api.d.ts +7 -0
  392. package/dist/humain/web-access/vendor/github-api.d.ts.map +1 -0
  393. package/dist/humain/web-access/vendor/github-api.js +160 -0
  394. package/dist/humain/web-access/vendor/github-api.js.map +1 -0
  395. package/dist/humain/web-access/vendor/github-extract.d.ts +13 -0
  396. package/dist/humain/web-access/vendor/github-extract.d.ts.map +1 -0
  397. package/dist/humain/web-access/vendor/github-extract.js +635 -0
  398. package/dist/humain/web-access/vendor/github-extract.js.map +1 -0
  399. package/dist/humain/web-access/vendor/index.d.ts +4 -0
  400. package/dist/humain/web-access/vendor/index.d.ts.map +1 -0
  401. package/dist/humain/web-access/vendor/index.js +3002 -0
  402. package/dist/humain/web-access/vendor/index.js.map +1 -0
  403. package/dist/humain/web-access/vendor/jina-search.d.ts +8 -0
  404. package/dist/humain/web-access/vendor/jina-search.d.ts.map +1 -0
  405. package/dist/humain/web-access/vendor/jina-search.js +255 -0
  406. package/dist/humain/web-access/vendor/jina-search.js.map +1 -0
  407. package/dist/humain/web-access/vendor/kagi.d.ts +15 -0
  408. package/dist/humain/web-access/vendor/kagi.d.ts.map +1 -0
  409. package/dist/humain/web-access/vendor/kagi.js +262 -0
  410. package/dist/humain/web-access/vendor/kagi.js.map +1 -0
  411. package/dist/humain/web-access/vendor/ollama.d.ts +15 -0
  412. package/dist/humain/web-access/vendor/ollama.d.ts.map +1 -0
  413. package/dist/humain/web-access/vendor/ollama.js +216 -0
  414. package/dist/humain/web-access/vendor/ollama.js.map +1 -0
  415. package/dist/humain/web-access/vendor/openai-search.d.ts +15 -0
  416. package/dist/humain/web-access/vendor/openai-search.d.ts.map +1 -0
  417. package/dist/humain/web-access/vendor/openai-search.js +459 -0
  418. package/dist/humain/web-access/vendor/openai-search.js.map +1 -0
  419. package/dist/humain/web-access/vendor/page-query.d.ts +16 -0
  420. package/dist/humain/web-access/vendor/page-query.d.ts.map +1 -0
  421. package/dist/humain/web-access/vendor/page-query.js +79 -0
  422. package/dist/humain/web-access/vendor/page-query.js.map +1 -0
  423. package/dist/humain/web-access/vendor/parallel.d.ts +12 -0
  424. package/dist/humain/web-access/vendor/parallel.d.ts.map +1 -0
  425. package/dist/humain/web-access/vendor/parallel.js +343 -0
  426. package/dist/humain/web-access/vendor/parallel.js.map +1 -0
  427. package/dist/humain/web-access/vendor/pdf-extract.d.ts +44 -0
  428. package/dist/humain/web-access/vendor/pdf-extract.d.ts.map +1 -0
  429. package/dist/humain/web-access/vendor/pdf-extract.js +298 -0
  430. package/dist/humain/web-access/vendor/pdf-extract.js.map +1 -0
  431. package/dist/humain/web-access/vendor/perplexity.d.ts +20 -0
  432. package/dist/humain/web-access/vendor/perplexity.d.ts.map +1 -0
  433. package/dist/humain/web-access/vendor/perplexity.js +159 -0
  434. package/dist/humain/web-access/vendor/perplexity.js.map +1 -0
  435. package/dist/humain/web-access/vendor/querit.d.ts +10 -0
  436. package/dist/humain/web-access/vendor/querit.d.ts.map +1 -0
  437. package/dist/humain/web-access/vendor/querit.js +335 -0
  438. package/dist/humain/web-access/vendor/querit.js.map +1 -0
  439. package/dist/humain/web-access/vendor/render-search-error.d.ts +57 -0
  440. package/dist/humain/web-access/vendor/render-search-error.d.ts.map +1 -0
  441. package/dist/humain/web-access/vendor/render-search-error.js +130 -0
  442. package/dist/humain/web-access/vendor/render-search-error.js.map +1 -0
  443. package/dist/humain/web-access/vendor/rsc-extract.d.ts +12 -0
  444. package/dist/humain/web-access/vendor/rsc-extract.d.ts.map +1 -0
  445. package/dist/humain/web-access/vendor/rsc-extract.js +329 -0
  446. package/dist/humain/web-access/vendor/rsc-extract.js.map +1 -0
  447. package/dist/humain/web-access/vendor/search1api.d.ts +10 -0
  448. package/dist/humain/web-access/vendor/search1api.d.ts.map +1 -0
  449. package/dist/humain/web-access/vendor/search1api.js +251 -0
  450. package/dist/humain/web-access/vendor/search1api.js.map +1 -0
  451. package/dist/humain/web-access/vendor/searchinfinity.d.ts +8 -0
  452. package/dist/humain/web-access/vendor/searchinfinity.d.ts.map +1 -0
  453. package/dist/humain/web-access/vendor/searchinfinity.js +229 -0
  454. package/dist/humain/web-access/vendor/searchinfinity.js.map +1 -0
  455. package/dist/humain/web-access/vendor/searxng.d.ts +4 -0
  456. package/dist/humain/web-access/vendor/searxng.d.ts.map +1 -0
  457. package/dist/humain/web-access/vendor/searxng.js +238 -0
  458. package/dist/humain/web-access/vendor/searxng.js.map +1 -0
  459. package/dist/humain/web-access/vendor/serpbase.d.ts +4 -0
  460. package/dist/humain/web-access/vendor/serpbase.d.ts.map +1 -0
  461. package/dist/humain/web-access/vendor/serpbase.js +211 -0
  462. package/dist/humain/web-access/vendor/serpbase.js.map +1 -0
  463. package/dist/humain/web-access/vendor/serpdive.d.ts +8 -0
  464. package/dist/humain/web-access/vendor/serpdive.d.ts.map +1 -0
  465. package/dist/humain/web-access/vendor/serpdive.js +267 -0
  466. package/dist/humain/web-access/vendor/serpdive.js.map +1 -0
  467. package/dist/humain/web-access/vendor/source-check.d.ts +99 -0
  468. package/dist/humain/web-access/vendor/source-check.d.ts.map +1 -0
  469. package/dist/humain/web-access/vendor/source-check.js +205 -0
  470. package/dist/humain/web-access/vendor/source-check.js.map +1 -0
  471. package/dist/humain/web-access/vendor/ssrf-protection.d.ts +50 -0
  472. package/dist/humain/web-access/vendor/ssrf-protection.d.ts.map +1 -0
  473. package/dist/humain/web-access/vendor/ssrf-protection.js +466 -0
  474. package/dist/humain/web-access/vendor/ssrf-protection.js.map +1 -0
  475. package/dist/humain/web-access/vendor/storage.d.ts +55 -0
  476. package/dist/humain/web-access/vendor/storage.d.ts.map +1 -0
  477. package/dist/humain/web-access/vendor/storage.js +485 -0
  478. package/dist/humain/web-access/vendor/storage.js.map +1 -0
  479. package/dist/humain/web-access/vendor/summary-model-scope.d.ts +25 -0
  480. package/dist/humain/web-access/vendor/summary-model-scope.d.ts.map +1 -0
  481. package/dist/humain/web-access/vendor/summary-model-scope.js +98 -0
  482. package/dist/humain/web-access/vendor/summary-model-scope.js.map +1 -0
  483. package/dist/humain/web-access/vendor/summary-review.d.ts +24 -0
  484. package/dist/humain/web-access/vendor/summary-review.d.ts.map +1 -0
  485. package/dist/humain/web-access/vendor/summary-review.js +341 -0
  486. package/dist/humain/web-access/vendor/summary-review.js.map +1 -0
  487. package/dist/humain/web-access/vendor/tavily.d.ts +8 -0
  488. package/dist/humain/web-access/vendor/tavily.d.ts.map +1 -0
  489. package/dist/humain/web-access/vendor/tavily.js +194 -0
  490. package/dist/humain/web-access/vendor/tavily.js.map +1 -0
  491. package/dist/humain/web-access/vendor/tinyfish.d.ts +11 -0
  492. package/dist/humain/web-access/vendor/tinyfish.d.ts.map +1 -0
  493. package/dist/humain/web-access/vendor/tinyfish.js +331 -0
  494. package/dist/humain/web-access/vendor/tinyfish.js.map +1 -0
  495. package/dist/humain/web-access/vendor/utils.d.ts +20 -0
  496. package/dist/humain/web-access/vendor/utils.d.ts.map +1 -0
  497. package/dist/humain/web-access/vendor/utils.js +91 -0
  498. package/dist/humain/web-access/vendor/utils.js.map +1 -0
  499. package/dist/humain/web-access/vendor/video-extract.d.ts +16 -0
  500. package/dist/humain/web-access/vendor/video-extract.d.ts.map +1 -0
  501. package/dist/humain/web-access/vendor/video-extract.js +335 -0
  502. package/dist/humain/web-access/vendor/video-extract.js.map +1 -0
  503. package/dist/humain/web-access/vendor/xai-search.d.ts +13 -0
  504. package/dist/humain/web-access/vendor/xai-search.d.ts.map +1 -0
  505. package/dist/humain/web-access/vendor/xai-search.js +331 -0
  506. package/dist/humain/web-access/vendor/xai-search.js.map +1 -0
  507. package/dist/humain/web-access/vendor/youtube-extract.d.ts +27 -0
  508. package/dist/humain/web-access/vendor/youtube-extract.d.ts.map +1 -0
  509. package/dist/humain/web-access/vendor/youtube-extract.js +282 -0
  510. package/dist/humain/web-access/vendor/youtube-extract.js.map +1 -0
  511. package/dist/index.d.ts +7 -4
  512. package/dist/index.d.ts.map +1 -1
  513. package/dist/index.js +5 -2
  514. package/dist/index.js.map +1 -1
  515. package/dist/main.d.ts +2 -2
  516. package/dist/main.d.ts.map +1 -1
  517. package/dist/main.js +169 -102
  518. package/dist/main.js.map +1 -1
  519. package/dist/modes/agent-exec-mode.d.ts +14 -0
  520. package/dist/modes/agent-exec-mode.d.ts.map +1 -0
  521. package/dist/modes/agent-exec-mode.js +92 -0
  522. package/dist/modes/agent-exec-mode.js.map +1 -0
  523. package/dist/modes/index.d.ts +4 -2
  524. package/dist/modes/index.d.ts.map +1 -1
  525. package/dist/modes/index.js +2 -1
  526. package/dist/modes/index.js.map +1 -1
  527. package/dist/modes/interactive/components/assistant-message.d.ts +5 -2
  528. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  529. package/dist/modes/interactive/components/assistant-message.js +13 -4
  530. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  531. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  532. package/dist/modes/interactive/components/custom-editor.js +7 -0
  533. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  534. package/dist/modes/interactive/components/earendil-announcement.d.ts +5 -0
  535. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -0
  536. package/dist/modes/interactive/components/earendil-announcement.js +40 -0
  537. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -0
  538. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  539. package/dist/modes/interactive/components/footer.js +1 -1
  540. package/dist/modes/interactive/components/footer.js.map +1 -1
  541. package/dist/modes/interactive/components/markdown-transform.d.ts +3 -0
  542. package/dist/modes/interactive/components/markdown-transform.d.ts.map +1 -0
  543. package/dist/modes/interactive/components/markdown-transform.js +19 -0
  544. package/dist/modes/interactive/components/markdown-transform.js.map +1 -0
  545. package/dist/modes/interactive/components/mermaid.d.ts +11 -0
  546. package/dist/modes/interactive/components/mermaid.d.ts.map +1 -0
  547. package/dist/modes/interactive/components/mermaid.js +75 -0
  548. package/dist/modes/interactive/components/mermaid.js.map +1 -0
  549. package/dist/modes/interactive/components/model-selector.d.ts +1 -1
  550. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  551. package/dist/modes/interactive/components/model-selector.js +16 -4
  552. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  553. package/dist/modes/interactive/components/scoped-models-selector.d.ts +4 -0
  554. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  555. package/dist/modes/interactive/components/scoped-models-selector.js +26 -0
  556. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  557. package/dist/modes/interactive/components/settings-selector.d.ts +8 -2
  558. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  559. package/dist/modes/interactive/components/settings-selector.js +30 -0
  560. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  561. package/dist/modes/interactive/components/user-message.d.ts +3 -1
  562. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  563. package/dist/modes/interactive/components/user-message.js +9 -2
  564. package/dist/modes/interactive/components/user-message.js.map +1 -1
  565. package/dist/modes/interactive/interactive-mode.d.ts +45 -9
  566. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  567. package/dist/modes/interactive/interactive-mode.js +581 -211
  568. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  569. package/dist/modes/interactive/theme/dark.json +1 -0
  570. package/dist/modes/interactive/theme/light.json +1 -0
  571. package/dist/modes/interactive/theme/theme-controller.d.ts +3 -0
  572. package/dist/modes/interactive/theme/theme-controller.d.ts.map +1 -1
  573. package/dist/modes/interactive/theme/theme-controller.js +10 -1
  574. package/dist/modes/interactive/theme/theme-controller.js.map +1 -1
  575. package/dist/modes/interactive/theme/theme-schema.json +5 -1
  576. package/dist/modes/interactive/theme/theme.d.ts +2 -2
  577. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  578. package/dist/modes/interactive/theme/theme.js +24 -6
  579. package/dist/modes/interactive/theme/theme.js.map +1 -1
  580. package/dist/modes/json-event.d.ts +28 -0
  581. package/dist/modes/json-event.d.ts.map +1 -0
  582. package/dist/modes/json-event.js +12 -0
  583. package/dist/modes/json-event.js.map +1 -0
  584. package/dist/modes/print-mode.d.ts.map +1 -1
  585. package/dist/modes/print-mode.js +12 -2
  586. package/dist/modes/print-mode.js.map +1 -1
  587. package/dist/modes/rpc/rpc-client.d.ts +12 -5
  588. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  589. package/dist/modes/rpc/rpc-client.js +55 -1
  590. package/dist/modes/rpc/rpc-client.js.map +1 -1
  591. package/dist/modes/rpc/rpc-mode.d.ts +1 -1
  592. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  593. package/dist/modes/rpc/rpc-mode.js +13 -3
  594. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  595. package/dist/modes/rpc/rpc-types.d.ts +15 -0
  596. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  597. package/dist/modes/rpc/rpc-types.js.map +1 -1
  598. package/dist/package-manager-cli.d.ts.map +1 -1
  599. package/dist/package-manager-cli.js +11 -9
  600. package/dist/package-manager-cli.js.map +1 -1
  601. package/dist/rpc-entry.d.ts.map +1 -1
  602. package/dist/rpc-entry.js +3 -2
  603. package/dist/rpc-entry.js.map +1 -1
  604. package/dist/server/create-harness.d.ts +26 -0
  605. package/dist/server/create-harness.d.ts.map +1 -0
  606. package/dist/server/create-harness.js +104 -0
  607. package/dist/server/create-harness.js.map +1 -0
  608. package/dist/utils/abort.d.ts +5 -0
  609. package/dist/utils/abort.d.ts.map +1 -0
  610. package/dist/utils/abort.js +48 -0
  611. package/dist/utils/abort.js.map +1 -0
  612. package/dist/utils/clipboard.d.ts +1 -1
  613. package/dist/utils/clipboard.d.ts.map +1 -1
  614. package/dist/utils/clipboard.js +22 -2
  615. package/dist/utils/clipboard.js.map +1 -1
  616. package/dist/utils/management-http.d.ts +23 -0
  617. package/dist/utils/management-http.d.ts.map +1 -0
  618. package/dist/utils/management-http.js +50 -0
  619. package/dist/utils/management-http.js.map +1 -0
  620. package/dist/utils/paths.d.ts +3 -0
  621. package/dist/utils/paths.d.ts.map +1 -1
  622. package/dist/utils/paths.js +23 -1
  623. package/dist/utils/paths.js.map +1 -1
  624. package/dist/utils/tool-result-images.d.ts +19 -0
  625. package/dist/utils/tool-result-images.d.ts.map +1 -0
  626. package/dist/utils/tool-result-images.js +45 -0
  627. package/dist/utils/tool-result-images.js.map +1 -0
  628. package/dist/utils/tools-manager.d.ts.map +1 -1
  629. package/dist/utils/tools-manager.js +13 -25
  630. package/dist/utils/tools-manager.js.map +1 -1
  631. package/dist/utils/version-check.d.ts +4 -0
  632. package/dist/utils/version-check.d.ts.map +1 -1
  633. package/dist/utils/version-check.js +23 -5
  634. package/dist/utils/version-check.js.map +1 -1
  635. package/docs/compaction.md +2 -2
  636. package/docs/custom-provider.md +7 -5
  637. package/docs/extensions.md +30 -5
  638. package/docs/humain-terminal.md +21 -1
  639. package/docs/json.md +24 -19
  640. package/docs/keybindings.md +46 -14
  641. package/docs/models.md +32 -11
  642. package/docs/providers.md +9 -1
  643. package/docs/quickstart.md +39 -37
  644. package/docs/rpc.md +31 -11
  645. package/docs/sdk.md +21 -2
  646. package/docs/security.md +21 -21
  647. package/docs/session-format.md +14 -14
  648. package/docs/settings.md +4 -1
  649. package/docs/themes.md +5 -3
  650. package/docs/usage.md +7 -0
  651. package/examples/extensions/custom-compaction.ts +3 -18
  652. package/examples/extensions/custom-provider-anthropic/index.ts +5 -1
  653. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  654. package/examples/extensions/custom-provider-anthropic/package.json +1 -1
  655. package/examples/extensions/custom-provider-gitlab-duo/index.ts +5 -1
  656. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  657. package/examples/extensions/doom-overlay/wad-finder.ts +7 -3
  658. package/examples/extensions/gondolin/package-lock.json +2 -2
  659. package/examples/extensions/gondolin/package.json +1 -1
  660. package/examples/extensions/handoff.ts +4 -13
  661. package/examples/extensions/qna.ts +5 -9
  662. package/examples/extensions/sandbox/package-lock.json +2 -2
  663. package/examples/extensions/sandbox/package.json +1 -1
  664. package/examples/extensions/summarize.ts +9 -20
  665. package/examples/extensions/with-deps/package-lock.json +2 -2
  666. package/examples/extensions/with-deps/package.json +1 -1
  667. package/examples/rpc-extension-ui.ts +11 -2
  668. package/examples/sdk/02-custom-model.ts +2 -3
  669. package/examples/sdk/09-api-keys-and-oauth.ts +1 -1
  670. package/examples/sdk/12-full-control.ts +1 -1
  671. package/examples/sdk/README.md +1 -1
  672. package/npm-shrinkwrap.json +2771 -535
  673. package/package.json +40 -11
  674. package/src/humain/mcp-adapter/UPSTREAM.md +15 -0
  675. package/src/humain/mcp-adapter/upstream.json +7 -0
  676. package/src/humain/mcp-adapter/vendor/CHANGELOG.md +660 -0
  677. package/src/humain/mcp-adapter/vendor/LICENSE +21 -0
  678. package/src/humain/web-access/UPSTREAM.md +17 -0
  679. package/src/humain/web-access/upstream.json +23 -0
  680. package/src/humain/web-access/vendor/LICENSE +21 -0
@@ -0,0 +1,3002 @@
1
+ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
2
+ if (typeof path === "string" && /^\.\.?\//.test(path)) {
3
+ return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
4
+ return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
5
+ });
6
+ }
7
+ return path;
8
+ };
9
+ import { Box, Text, truncateToWidth } from "@earendil-works/pi-tui";
10
+ import { Type } from "typebox";
11
+ import { StringEnum, complete } from "@earendil-works/pi-ai/compat";
12
+ import { normalizeFetchContentParams } from "./fetch-params.js";
13
+ import { findContent } from "./content-find.js";
14
+ import { answerFromPage } from "./page-query.js";
15
+ import { clearCloneCache } from "./github-extract.js";
16
+ import { getConfiguredSearchRouting, normalizeSearchProviderSelection, RESOLVED_SEARCH_PROVIDERS, SEARCH_PROVIDERS, search } from "./gemini-search.js";
17
+ import { formatSeconds, getWebSearchConfigDir, getWebSearchConfigPath, resolveCuratorNetworkConfig } from "./utils.js";
18
+ import { clearResults, deleteResult, generateId, getAllResults, getResult, restoreFromSession, storeFetchedContentResult, storeResult, } from "./storage.js";
19
+ import { activityMonitor } from "./activity.js";
20
+ import { startCuratorServer } from "./curator-server.js";
21
+ import { buildDeterministicSummary, generateSummaryDraft, SUMMARY_GENERATION_DEADLINE_MS, } from "./summary-review.js";
22
+ import { randomUUID } from "node:crypto";
23
+ import { execFileSync } from "node:child_process";
24
+ import { createRequire } from "node:module";
25
+ import { platform } from "node:os";
26
+ import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
27
+ import { join } from "node:path";
28
+ import { isPerplexityAvailable } from "./perplexity.js";
29
+ import { isExaAvailable } from "./exa.js";
30
+ import { isGeminiApiAvailable } from "./gemini-api.js";
31
+ import { getActiveGoogleEmail, getGeminiWebAvailabilityDiagnostic, isGeminiWebAvailable } from "./gemini-web.js";
32
+ import { isBrowserCookieAccessAllowed } from "./gemini-web-config.js";
33
+ import { isBraveAvailable } from "./brave.js";
34
+ import { isOpenAISearchAvailable } from "./openai-search.js";
35
+ import { isParallelAvailable } from "./parallel.js";
36
+ import { isTinyFishAvailable } from "./tinyfish.js";
37
+ import { isSearch1APIAvailable } from "./search1api.js";
38
+ import { isSearchinfinityAvailable } from "./searchinfinity.js";
39
+ import { isQueritAvailable } from "./querit.js";
40
+ import { isTavilyAvailable } from "./tavily.js";
41
+ import { isJinaSearchAvailable } from "./jina-search.js";
42
+ import { isSerpdiveAvailable } from "./serpdive.js";
43
+ import { isKagiAvailable } from "./kagi.js";
44
+ import { isBochaAvailable } from "./bocha.js";
45
+ import { isOllamaAvailable } from "./ollama.js";
46
+ import { isSearXNGAvailable } from "./searxng.js";
47
+ import { isDuckDuckGoAvailable } from "./duckduckgo.js";
48
+ import { isAnySearchAvailable } from "./anysearch.js";
49
+ import { isXaiSearchAvailable } from "./xai-search.js";
50
+ import { isBrightDataAvailable } from "./brightdata.js";
51
+ import { isSerpBaseAvailable } from "./serpbase.js";
52
+ import { buildSearchErrorPlan } from "./render-search-error.js";
53
+ import { findModelWithProviderRouting, loadEnabledModelPatterns, modelMatchesEnabledPatterns } from "./summary-model-scope.js";
54
+ import { buildResearchArtifact, withClaimAssessment, storeResearchArtifact, getResearchArtifact, } from "./source-check.js";
55
+ const WEB_SEARCH_CONFIG_PATH = getWebSearchConfigPath();
56
+ let extractModulePromise;
57
+ async function fetchAllContent(urls, signal, options) {
58
+ const extractModule = await (extractModulePromise ??= import("./extract.js"));
59
+ return extractModule.fetchAllContent(urls, signal, options);
60
+ }
61
+ function isAbortError(err) {
62
+ return (err instanceof Error ? err.message : String(err)).toLowerCase().includes("abort");
63
+ }
64
+ /** Shared collapsed/expanded renderer for an error/cancel plan produced by
65
+ * buildSearchErrorPlan(). Used by every tool renderResult's error branch so
66
+ * Ctrl+O (app.tools.expand) reveals diagnostics instead of a dead-end single line. */
67
+ function renderSearchErrorPlan(plan, expanded, theme) {
68
+ if (expanded) {
69
+ return new Text(plan.expanded.map((l, i) => i === 0 ? theme.fg("error", l) : theme.fg("toolOutput", l)).join("\n"), 0, 0);
70
+ }
71
+ const box = new Box(1, 0, (t) => theme.bg("toolErrorBg", t));
72
+ box.addChild(new Text(theme.fg("error", plan.expanded[0]), 0, 0));
73
+ for (const line of plan.collapsed) {
74
+ box.addChild(new Text(theme.fg("dim", line), 0, 0));
75
+ }
76
+ if (plan.expandHint) {
77
+ box.addChild(new Text(theme.fg("muted", plan.expandHint), 0, 0));
78
+ }
79
+ return box;
80
+ }
81
+ function parseConfigRoot(raw) {
82
+ let parsed;
83
+ try {
84
+ parsed = JSON.parse(raw);
85
+ }
86
+ catch (err) {
87
+ const message = err instanceof Error ? err.message : String(err);
88
+ throw new Error(`Failed to parse ${WEB_SEARCH_CONFIG_PATH}: ${message}`);
89
+ }
90
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
91
+ throw new Error(`Invalid config in ${WEB_SEARCH_CONFIG_PATH}: expected a JSON object`);
92
+ }
93
+ return parsed;
94
+ }
95
+ function loadConfig() {
96
+ if (!existsSync(WEB_SEARCH_CONFIG_PATH))
97
+ return {};
98
+ return parseConfigRoot(readFileSync(WEB_SEARCH_CONFIG_PATH, "utf-8"));
99
+ }
100
+ function saveConfig(updates) {
101
+ let config = {};
102
+ if (existsSync(WEB_SEARCH_CONFIG_PATH)) {
103
+ config = parseConfigRoot(readFileSync(WEB_SEARCH_CONFIG_PATH, "utf-8"));
104
+ }
105
+ Object.assign(config, updates);
106
+ const dir = getWebSearchConfigDir();
107
+ if (!existsSync(dir))
108
+ mkdirSync(dir, { recursive: true });
109
+ writeFileSync(WEB_SEARCH_CONFIG_PATH, JSON.stringify(config, null, 2) + "\n");
110
+ }
111
+ const DEFAULT_TOOL_NAMES = {
112
+ webSearch: "web_search",
113
+ sourceCheck: "source_check",
114
+ fetchContent: "fetch_content",
115
+ getSearchContent: "get_search_content",
116
+ };
117
+ const TOOL_NAME_PATTERN = /^[A-Za-z][A-Za-z0-9_-]{0,63}$/;
118
+ const DEFAULT_SHORTCUTS = { curate: "ctrl+shift+s", activity: "ctrl+shift+w" };
119
+ const DEFAULT_CURATOR_TIMEOUT_SECONDS = 20;
120
+ const DEFAULT_REMOTE_CURATOR_TIMEOUT_SECONDS = 60;
121
+ const MAX_CURATOR_TIMEOUT_SECONDS = 600;
122
+ const MAX_SUMMARY_GENERATION_DEADLINE_MS = 600_000;
123
+ function searchProviderSchema(description) {
124
+ return Type.Union([
125
+ StringEnum([...SEARCH_PROVIDERS]),
126
+ Type.Array(StringEnum([...RESOLVED_SEARCH_PROVIDERS]), { minItems: 1 }),
127
+ ], { description });
128
+ }
129
+ function isToolEnabled(config, key) {
130
+ const override = config.tools?.[key]?.enabled;
131
+ if (typeof override === "boolean")
132
+ return override;
133
+ return key !== "webSearch" && key !== "sourceCheck" || config.webSearch?.enabled !== false;
134
+ }
135
+ function isCommandEnabled(config, name) {
136
+ return config.commands?.[name]?.enabled !== false;
137
+ }
138
+ function joinToolNames(names) {
139
+ if (names.length === 0)
140
+ return "stored content";
141
+ if (names.length === 1)
142
+ return names[0];
143
+ if (names.length === 2)
144
+ return `${names[0]} or ${names[1]}`;
145
+ return `${names.slice(0, -1).join(", ")}, or ${names[names.length - 1]}`;
146
+ }
147
+ function resolveToolNames(config) {
148
+ if (config.toolNames !== undefined && (!config.toolNames || typeof config.toolNames !== "object" || Array.isArray(config.toolNames))) {
149
+ throw new Error(`toolNames in ${WEB_SEARCH_CONFIG_PATH} must be an object`);
150
+ }
151
+ const names = { ...DEFAULT_TOOL_NAMES };
152
+ for (const key of Object.keys(DEFAULT_TOOL_NAMES)) {
153
+ const value = config.toolNames?.[key];
154
+ if (value === undefined)
155
+ continue;
156
+ if (typeof value !== "string")
157
+ throw new Error(`toolNames.${key} in ${WEB_SEARCH_CONFIG_PATH} must be a string`);
158
+ const trimmed = value.trim();
159
+ if (!TOOL_NAME_PATTERN.test(trimmed)) {
160
+ throw new Error(`toolNames.${key} in ${WEB_SEARCH_CONFIG_PATH} must start with a letter and contain only letters, numbers, underscores, or hyphens`);
161
+ }
162
+ names[key] = trimmed;
163
+ }
164
+ const registeredKeys = Object.keys(DEFAULT_TOOL_NAMES)
165
+ .filter(key => isToolEnabled(config, key));
166
+ const seen = new Map();
167
+ for (const key of registeredKeys) {
168
+ const name = names[key];
169
+ const previous = seen.get(name);
170
+ if (previous)
171
+ throw new Error(`toolNames.${key} duplicates toolNames.${previous} in ${WEB_SEARCH_CONFIG_PATH}`);
172
+ seen.set(name, key);
173
+ }
174
+ return names;
175
+ }
176
+ function loadConfigForExtensionInit() {
177
+ try {
178
+ return loadConfig();
179
+ }
180
+ catch (err) {
181
+ const message = err instanceof Error ? err.message : String(err);
182
+ console.error(`[pi-web-access] ${message}`);
183
+ return {};
184
+ }
185
+ }
186
+ function normalizeProviderInput(value, label = "provider") {
187
+ if (value === undefined)
188
+ return undefined;
189
+ return normalizeSearchProviderSelection(value, label);
190
+ }
191
+ function resolveRequestedProvider(requested) {
192
+ const normalizedRequested = normalizeProviderInput(requested);
193
+ if (normalizedRequested && normalizedRequested !== "auto")
194
+ return normalizedRequested;
195
+ const config = loadConfig();
196
+ return normalizeProviderInput(config.searchProvider ?? config.provider, `provider in ${WEB_SEARCH_CONFIG_PATH}`) ?? "auto";
197
+ }
198
+ function toCuratorProvider(provider) {
199
+ if (Array.isArray(provider))
200
+ return "all";
201
+ return provider === "auto" ? undefined : provider;
202
+ }
203
+ function resolveCuratorSearchProvider(requested, current) {
204
+ const normalized = normalizeProviderInput(requested);
205
+ if (!normalized || normalized === "auto")
206
+ return current;
207
+ if (normalized === "all" && Array.isArray(current))
208
+ return current;
209
+ return normalized;
210
+ }
211
+ function normalizeRecencyFilter(value) {
212
+ return value === "day" || value === "week" || value === "month" || value === "year"
213
+ ? value
214
+ : undefined;
215
+ }
216
+ function normalizeCuratorTimeoutSeconds(value) {
217
+ if (typeof value !== "number" || !Number.isFinite(value))
218
+ return undefined;
219
+ const normalized = Math.floor(value);
220
+ if (normalized < 1)
221
+ return undefined;
222
+ return Math.min(normalized, MAX_CURATOR_TIMEOUT_SECONDS);
223
+ }
224
+ function resolveWorkflow(input, hasUI) {
225
+ const normalized = typeof input === "string" ? input.trim().toLowerCase() : "";
226
+ if (normalized === "auto-summary")
227
+ return "auto-summary";
228
+ if (!hasUI)
229
+ return "none";
230
+ if (normalized === "none")
231
+ return "none";
232
+ return "summary-review";
233
+ }
234
+ function normalizeQueryList(queryList) {
235
+ const normalized = [];
236
+ for (const query of queryList) {
237
+ if (typeof query !== "string")
238
+ continue;
239
+ const trimmed = query.trim();
240
+ if (trimmed.length > 0)
241
+ normalized.push(trimmed);
242
+ }
243
+ return normalized;
244
+ }
245
+ function getCuratorTimeoutSeconds() {
246
+ const source = loadConfig();
247
+ const explicit = normalizeCuratorTimeoutSeconds(source.curatorTimeoutSeconds);
248
+ if (explicit !== undefined)
249
+ return explicit;
250
+ // Remote users must notice and click a printed link, so allow more idle time.
251
+ return resolveCuratorNetworkConfig().enabled ? DEFAULT_REMOTE_CURATOR_TIMEOUT_SECONDS : DEFAULT_CURATOR_TIMEOUT_SECONDS;
252
+ }
253
+ export function getSummaryGenerationDeadlineMs() {
254
+ const value = loadConfig().summaryGenerationDeadlineMs;
255
+ if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value) || value <= 0) {
256
+ return SUMMARY_GENERATION_DEADLINE_MS;
257
+ }
258
+ return Math.min(value, MAX_SUMMARY_GENERATION_DEADLINE_MS);
259
+ }
260
+ function shouldAutoOpenCuratorBrowser(config) {
261
+ if (config.autoOpenBrowser === false)
262
+ return false;
263
+ if (resolveCuratorNetworkConfig().enabled && config.autoOpenBrowser !== true)
264
+ return false;
265
+ return true;
266
+ }
267
+ async function getProviderAvailability(ctx) {
268
+ const geminiWebAvail = await isGeminiWebAvailable();
269
+ const geminiApiAvail = isGeminiApiAvailable();
270
+ const providers = {
271
+ openai: await isOpenAISearchAvailable(ctx),
272
+ brave: isBraveAvailable(),
273
+ parallel: isParallelAvailable(),
274
+ tinyfish: isTinyFishAvailable(),
275
+ search1api: isSearch1APIAvailable(),
276
+ searchinfinity: isSearchinfinityAvailable(),
277
+ querit: isQueritAvailable(),
278
+ tavily: isTavilyAvailable(),
279
+ jina: isJinaSearchAvailable(),
280
+ serpdive: isSerpdiveAvailable(),
281
+ kagi: isKagiAvailable(),
282
+ bocha: isBochaAvailable(),
283
+ ollama: isOllamaAvailable(),
284
+ searxng: isSearXNGAvailable(),
285
+ duckduckgo: isDuckDuckGoAvailable(),
286
+ perplexity: isPerplexityAvailable(),
287
+ exa: isExaAvailable(),
288
+ gemini: geminiApiAvail || !!geminiWebAvail,
289
+ anysearch: isAnySearchAvailable(),
290
+ xai: await isXaiSearchAvailable(ctx),
291
+ brightdata: isBrightDataAvailable(),
292
+ serpbase: isSerpBaseAvailable(),
293
+ };
294
+ return {
295
+ // DuckDuckGo, AnySearch, xAI, Bright Data, and SerpBase are explicit-only, so they never make `all` eligible.
296
+ all: Object.entries(providers).some(([provider, available]) => provider !== "duckduckgo" && provider !== "anysearch" && provider !== "xai" && provider !== "brightdata" && provider !== "serpbase" && provider !== "gemini" && available) || geminiApiAvail,
297
+ ...providers,
298
+ };
299
+ }
300
+ function shouldPreferOpenAI(options) {
301
+ if (!options)
302
+ return true;
303
+ if (options.recencyFilter)
304
+ return false;
305
+ if (typeof options.numResults === "number" && Number.isFinite(options.numResults) && Math.floor(options.numResults) !== 5) {
306
+ return false;
307
+ }
308
+ return true;
309
+ }
310
+ async function loadCuratorBootstrap(requestedProvider, ctx, options) {
311
+ const provider = resolveRequestedProvider(requestedProvider);
312
+ const availableProviders = await getProviderAvailability(ctx);
313
+ if (Array.isArray(provider))
314
+ availableProviders.all = true;
315
+ return {
316
+ availableProviders,
317
+ defaultProvider: resolveProvider(provider, availableProviders, options),
318
+ timeoutSeconds: getCuratorTimeoutSeconds(),
319
+ };
320
+ }
321
+ function firstAvailableProvider(available, preferOpenAI, fallback) {
322
+ if (available.searxng)
323
+ return "searxng";
324
+ if (preferOpenAI && available.openai)
325
+ return "openai";
326
+ if (available.exa)
327
+ return "exa";
328
+ if (available.brave)
329
+ return "brave";
330
+ if (available.parallel)
331
+ return "parallel";
332
+ if (available.tinyfish)
333
+ return "tinyfish";
334
+ if (available.search1api)
335
+ return "search1api";
336
+ if (available.searchinfinity)
337
+ return "searchinfinity";
338
+ if (available.querit)
339
+ return "querit";
340
+ if (available.tavily)
341
+ return "tavily";
342
+ if (available.jina)
343
+ return "jina";
344
+ if (available.serpdive)
345
+ return "serpdive";
346
+ if (available.kagi)
347
+ return "kagi";
348
+ if (available.bocha)
349
+ return "bocha";
350
+ if (available.ollama)
351
+ return "ollama";
352
+ if (available.perplexity)
353
+ return "perplexity";
354
+ if (available.gemini)
355
+ return "gemini";
356
+ return fallback;
357
+ }
358
+ function resolveProvider(provider, available, options) {
359
+ if (Array.isArray(provider))
360
+ return "all";
361
+ const preferOpenAI = shouldPreferOpenAI(options);
362
+ if (provider === "auto") {
363
+ const routing = getConfiguredSearchRouting();
364
+ if (routing) {
365
+ for (const candidate of routing.providers) {
366
+ if (available[candidate])
367
+ return candidate;
368
+ }
369
+ return routing.providers[0];
370
+ }
371
+ return firstAvailableProvider(available, preferOpenAI, "exa");
372
+ }
373
+ if (provider === "all" && !available.all) {
374
+ return firstAvailableProvider(available, preferOpenAI, "exa");
375
+ }
376
+ if (provider === "openai" && !available.openai) {
377
+ return firstAvailableProvider(available, false, "openai");
378
+ }
379
+ if (provider === "brave" && !available.brave) {
380
+ return firstAvailableProvider(available, preferOpenAI, "brave");
381
+ }
382
+ if (provider === "parallel" && !available.parallel) {
383
+ return firstAvailableProvider(available, preferOpenAI, "parallel");
384
+ }
385
+ if (provider === "tinyfish" && !available.tinyfish) {
386
+ return firstAvailableProvider(available, preferOpenAI, "tinyfish");
387
+ }
388
+ if (provider === "search1api" && !available.search1api) {
389
+ return firstAvailableProvider(available, preferOpenAI, "search1api");
390
+ }
391
+ if (provider === "searchinfinity" && !available.searchinfinity) {
392
+ return firstAvailableProvider(available, preferOpenAI, "searchinfinity");
393
+ }
394
+ if (provider === "querit" && !available.querit) {
395
+ return firstAvailableProvider(available, preferOpenAI, "querit");
396
+ }
397
+ if (provider === "tavily" && !available.tavily) {
398
+ return firstAvailableProvider(available, preferOpenAI, "tavily");
399
+ }
400
+ if (provider === "jina" && !available.jina) {
401
+ return firstAvailableProvider(available, preferOpenAI, "jina");
402
+ }
403
+ if (provider === "serpdive" && !available.serpdive) {
404
+ return firstAvailableProvider(available, preferOpenAI, "serpdive");
405
+ }
406
+ if (provider === "kagi" && !available.kagi) {
407
+ return firstAvailableProvider(available, preferOpenAI, "kagi");
408
+ }
409
+ if (provider === "bocha" && !available.bocha) {
410
+ return firstAvailableProvider(available, preferOpenAI, "bocha");
411
+ }
412
+ if (provider === "ollama" && !available.ollama) {
413
+ return firstAvailableProvider(available, preferOpenAI, "ollama");
414
+ }
415
+ if (provider === "searxng" && !available.searxng) {
416
+ return firstAvailableProvider(available, preferOpenAI, "searxng");
417
+ }
418
+ if (provider === "exa" && !available.exa) {
419
+ return firstAvailableProvider(available, preferOpenAI, "exa");
420
+ }
421
+ if (provider === "perplexity" && !available.perplexity) {
422
+ return firstAvailableProvider(available, preferOpenAI, "perplexity");
423
+ }
424
+ if (provider === "gemini" && !available.gemini) {
425
+ return firstAvailableProvider(available, preferOpenAI, "gemini");
426
+ }
427
+ return provider;
428
+ }
429
+ const pendingFetches = new Map();
430
+ let sessionActive = false;
431
+ let widgetVisible = false;
432
+ let widgetUnsubscribe = null;
433
+ const pendingCurates = new Map();
434
+ const activeCurators = new Map();
435
+ const glimpseWins = new Map();
436
+ const DEFAULT_MAX_INLINE_CONTENT_CHARS = 30_000;
437
+ const MAX_INLINE_CONTENT_CHARS = 200_000;
438
+ function getMaxInlineContentChars() {
439
+ const value = loadConfig().maxInlineContentChars;
440
+ if (typeof value !== "number" || !Number.isFinite(value) || !Number.isInteger(value) || value <= 0) {
441
+ return DEFAULT_MAX_INLINE_CONTENT_CHARS;
442
+ }
443
+ return Math.min(value, MAX_INLINE_CONTENT_CHARS);
444
+ }
445
+ function stripThumbnails(results) {
446
+ return results.map(({ thumbnail, frames, ...rest }) => rest);
447
+ }
448
+ function initialContentSlice(content, maxChars) {
449
+ let endOffset = Math.min(content.length, maxChars);
450
+ if (endOffset < content.length) {
451
+ const lineBreak = content.lastIndexOf("\n", endOffset);
452
+ if (lineBreak >= Math.floor(maxChars * 0.8))
453
+ endOffset = lineBreak + 1;
454
+ }
455
+ const text = content.slice(0, endOffset);
456
+ return {
457
+ text,
458
+ endOffset,
459
+ totalBytes: Buffer.byteLength(content),
460
+ totalLines: content.length === 0 ? 0 : content.split("\n").length,
461
+ shownBytes: Buffer.byteLength(text),
462
+ shownLines: text.length === 0 ? 0 : text.split("\n").length,
463
+ };
464
+ }
465
+ function normalizeFindQueries(value) {
466
+ const queries = (Array.isArray(value) ? value : [value]).map(query => query.trim()).filter(Boolean);
467
+ if (queries.length === 0)
468
+ throw new Error("findText must contain at least one non-empty string");
469
+ return queries;
470
+ }
471
+ function formatSearchSummary(results, answer) {
472
+ if (results.length === 0) {
473
+ return answer ? `${answer}\n\n---\n\n**Sources:**\nNo sources returned.` : "No results found.";
474
+ }
475
+ let output = answer ? `${answer}\n\n---\n\n**Sources:**\n` : "";
476
+ output += results.map((r, i) => `${i + 1}. ${r.title}\n ${r.url}`).join("\n\n");
477
+ return output;
478
+ }
479
+ function formatSourceCheckResult(artifact, getSearchContentTool = DEFAULT_TOOL_NAMES.getSearchContent) {
480
+ const assessment = artifact.claims?.[0];
481
+ const lines = [`# Source check: ${artifact.query}`, ""];
482
+ if (assessment) {
483
+ lines.push(`**Status:** ${assessment.status} (confidence ${assessment.confidence.toFixed(2)})`);
484
+ lines.push(`**Rationale:** ${assessment.rationale}`);
485
+ if (assessment.supporting_passages.length > 0)
486
+ lines.push(`**Supporting passages:** ${assessment.supporting_passages.join(", ")}`);
487
+ if (assessment.contradicting_passages.length > 0)
488
+ lines.push(`**Contradicting passages:** ${assessment.contradicting_passages.join(", ")}`);
489
+ lines.push("");
490
+ }
491
+ if (artifact.sources.length > 0) {
492
+ lines.push("## Sources");
493
+ for (const source of artifact.sources)
494
+ lines.push(`${source.rank}. [${source.quality}] ${source.title}\n ${source.url}`);
495
+ lines.push("");
496
+ }
497
+ if (artifact.errors?.length)
498
+ lines.push(`Search errors: ${artifact.errors.map((entry) => `${entry.query}: ${entry.error}`).join("; ")}`);
499
+ lines.push(getSearchContentTool
500
+ ? `Artifact responseId: ${artifact.id} (retrievable via ${getSearchContentTool}).`
501
+ : `Artifact responseId: ${artifact.id}. Content retrieval is not registered.`);
502
+ return lines.join("\n");
503
+ }
504
+ function duplicateQuerySet(results) {
505
+ const counts = new Map();
506
+ for (const result of results) {
507
+ counts.set(result.query, (counts.get(result.query) ?? 0) + 1);
508
+ }
509
+ const duplicates = new Set();
510
+ for (const [query, count] of counts) {
511
+ if (count > 1)
512
+ duplicates.add(query);
513
+ }
514
+ return duplicates;
515
+ }
516
+ function formatQueryHeader(query, provider, duplicateQueries) {
517
+ const suffix = duplicateQueries.has(query) && provider ? ` (${provider})` : "";
518
+ return `## Query: "${query}"${suffix}\n\n`;
519
+ }
520
+ function hasFullInlineCoverage(urls, inlineContent) {
521
+ if (!inlineContent || inlineContent.length === 0)
522
+ return false;
523
+ const coveredUrls = new Set(inlineContent.map(c => c.url));
524
+ return urls.every(url => coveredUrls.has(url));
525
+ }
526
+ function formatFullResults(queryData) {
527
+ let output = `## Results for: "${queryData.query}"\n\n`;
528
+ if (queryData.answer) {
529
+ output += `${queryData.answer}\n\n---\n\n`;
530
+ }
531
+ for (const r of queryData.results) {
532
+ output += `### ${r.title}\n${r.url}\n\n`;
533
+ }
534
+ return output;
535
+ }
536
+ function abortPendingFetches() {
537
+ for (const controller of pendingFetches.values()) {
538
+ controller.abort();
539
+ }
540
+ pendingFetches.clear();
541
+ }
542
+ function closeCurator(callId) {
543
+ if (callId !== undefined) {
544
+ const win = glimpseWins.get(callId);
545
+ glimpseWins.delete(callId);
546
+ try {
547
+ win?.close();
548
+ }
549
+ catch { }
550
+ pendingCurates.get(callId)?.cancel("stale");
551
+ pendingCurates.delete(callId);
552
+ const curator = activeCurators.get(callId);
553
+ activeCurators.delete(callId);
554
+ try {
555
+ curator?.close();
556
+ }
557
+ catch { }
558
+ return;
559
+ }
560
+ for (const win of glimpseWins.values()) {
561
+ try {
562
+ win.close();
563
+ }
564
+ catch { }
565
+ }
566
+ glimpseWins.clear();
567
+ for (const pc of pendingCurates.values()) {
568
+ try {
569
+ pc.cancel("stale");
570
+ }
571
+ catch { }
572
+ }
573
+ pendingCurates.clear();
574
+ for (const curator of activeCurators.values()) {
575
+ try {
576
+ curator.close();
577
+ }
578
+ catch { }
579
+ }
580
+ activeCurators.clear();
581
+ }
582
+ async function openInBrowser(pi, url) {
583
+ const plat = platform();
584
+ const result = plat === "darwin"
585
+ ? await pi.exec("open", [url])
586
+ : plat === "win32"
587
+ ? await pi.exec("cmd", ["/c", "start", "", url])
588
+ : await pi.exec("xdg-open", [url]);
589
+ if (result.code !== 0) {
590
+ throw new Error(result.stderr || `Failed to open browser (exit code ${result.code})`);
591
+ }
592
+ }
593
+ let glimpseOpen;
594
+ function findGlimpseMjs() {
595
+ try {
596
+ const req = createRequire(import.meta.url);
597
+ return req.resolve("glimpseui");
598
+ }
599
+ catch {
600
+ // Optional dependency.
601
+ }
602
+ try {
603
+ const globalRoot = execFileSync("npm", ["root", "-g"], { encoding: "utf-8" }).trim();
604
+ const entry = join(globalRoot, "glimpseui", "src", "glimpse.mjs");
605
+ if (existsSync(entry))
606
+ return entry;
607
+ }
608
+ catch {
609
+ // npm may be unavailable.
610
+ }
611
+ return null;
612
+ }
613
+ async function getGlimpseOpen() {
614
+ if (glimpseOpen !== undefined)
615
+ return glimpseOpen;
616
+ const resolved = findGlimpseMjs();
617
+ if (resolved) {
618
+ try {
619
+ glimpseOpen = (await import(__rewriteRelativeImportExtension(resolved))).open;
620
+ return glimpseOpen;
621
+ }
622
+ catch { }
623
+ }
624
+ glimpseOpen = null;
625
+ return glimpseOpen;
626
+ }
627
+ function openInGlimpse(open, url, title) {
628
+ const shellHTML = `<!DOCTYPE html>
629
+ <html>
630
+ <head><meta charset="UTF-8"><title>${title}</title></head>
631
+ <body style="margin:0; background:#1a1a2e;">
632
+ <script>window.location.replace(${JSON.stringify(url)});</script>
633
+ </body>
634
+ </html>`;
635
+ const win = open(shellHTML, {
636
+ width: 800,
637
+ height: 900,
638
+ title,
639
+ });
640
+ let maxHeight = 1200;
641
+ win.on("ready", (info) => {
642
+ const visibleHeight = info?.screen?.visibleHeight;
643
+ if (typeof visibleHeight === "number" && visibleHeight > 0) {
644
+ maxHeight = Math.floor(visibleHeight * 0.85);
645
+ }
646
+ });
647
+ win.on("message", (data) => {
648
+ if (!data || typeof data !== "object")
649
+ return;
650
+ const msg = data;
651
+ if (msg.type !== "resize" || typeof msg.height !== "number")
652
+ return;
653
+ const clamped = Math.max(400, Math.min(Math.round(msg.height), maxHeight));
654
+ win._write({ type: "resize", width: 800, height: clamped });
655
+ });
656
+ return win;
657
+ }
658
+ function extractDomain(url) {
659
+ try {
660
+ return new URL(url).hostname;
661
+ }
662
+ catch {
663
+ return url;
664
+ }
665
+ }
666
+ function toCuratorSearchEntries(response) {
667
+ const providerResponses = response.provider === "all" && response.providerResponses?.length
668
+ ? response.providerResponses
669
+ : [response];
670
+ const entries = providerResponses.map(result => ({
671
+ answer: result.answer,
672
+ results: result.results.map(source => ({ ...source, domain: extractDomain(source.url) })),
673
+ provider: result.provider,
674
+ }));
675
+ for (const failure of response.providerErrors ?? []) {
676
+ entries.push({
677
+ answer: "",
678
+ results: [],
679
+ provider: failure.provider,
680
+ error: failure.error,
681
+ });
682
+ }
683
+ return entries;
684
+ }
685
+ function indexedCuratorEntryToQueryResult(entry) {
686
+ return {
687
+ query: entry.query,
688
+ answer: entry.answer,
689
+ results: entry.results.map(source => ({
690
+ title: source.title,
691
+ url: source.url,
692
+ snippet: source.snippet ?? "",
693
+ })),
694
+ error: entry.error ?? null,
695
+ provider: entry.provider,
696
+ };
697
+ }
698
+ function updateWidget(ctx) {
699
+ const theme = ctx.ui.theme;
700
+ const entries = activityMonitor.getEntries();
701
+ const lines = [];
702
+ lines.push(theme.fg("accent", "─── Web Search Activity " + "─".repeat(36)));
703
+ if (entries.length === 0) {
704
+ lines.push(theme.fg("muted", " No activity yet"));
705
+ }
706
+ else {
707
+ for (const e of entries) {
708
+ lines.push(" " + formatEntryLine(e, theme));
709
+ }
710
+ }
711
+ lines.push(theme.fg("accent", "─".repeat(60)));
712
+ const rateInfo = activityMonitor.getRateLimitInfo();
713
+ const resetMs = rateInfo.oldestTimestamp ? Math.max(0, rateInfo.oldestTimestamp + rateInfo.windowMs - Date.now()) : 0;
714
+ const resetSec = Math.ceil(resetMs / 1000);
715
+ lines.push(theme.fg("muted", `Rate: ${rateInfo.used}/${rateInfo.max}`) +
716
+ (resetMs > 0 ? theme.fg("dim", ` (resets in ${resetSec}s)`) : ""));
717
+ ctx.ui.setWidget("web-activity", lines);
718
+ }
719
+ function formatEntryLine(entry, theme) {
720
+ const typeStr = entry.type === "api" ? "API" : "GET";
721
+ const target = entry.type === "api"
722
+ ? `"${truncateToWidth(entry.query || "", 28, "")}"`
723
+ : truncateToWidth(entry.url?.replace(/^https?:\/\//, "") || "", 30, "");
724
+ const duration = entry.endTime
725
+ ? `${((entry.endTime - entry.startTime) / 1000).toFixed(1)}s`
726
+ : `${((Date.now() - entry.startTime) / 1000).toFixed(1)}s`;
727
+ let statusStr;
728
+ let indicator;
729
+ if (entry.error) {
730
+ statusStr = "err";
731
+ indicator = theme.fg("error", "✗");
732
+ }
733
+ else if (entry.status === null) {
734
+ statusStr = "...";
735
+ indicator = theme.fg("warning", "⋯");
736
+ }
737
+ else if (entry.status === 0) {
738
+ statusStr = "abort";
739
+ indicator = theme.fg("muted", "○");
740
+ }
741
+ else {
742
+ statusStr = String(entry.status);
743
+ indicator = entry.status >= 200 && entry.status < 300 ? theme.fg("success", "✓") : theme.fg("error", "✗");
744
+ }
745
+ return `${typeStr.padEnd(4)} ${target.padEnd(32)} ${statusStr.padStart(5)} ${duration.padStart(5)} ${indicator}`;
746
+ }
747
+ function handleSessionChange(ctx) {
748
+ abortPendingFetches();
749
+ closeCurator();
750
+ clearCloneCache();
751
+ sessionActive = true;
752
+ restoreFromSession(ctx);
753
+ // Unsubscribe before clear() to avoid callback with stale ctx
754
+ widgetUnsubscribe?.();
755
+ widgetUnsubscribe = null;
756
+ activityMonitor.clear();
757
+ if (widgetVisible) {
758
+ // Re-subscribe with new ctx
759
+ widgetUnsubscribe = activityMonitor.onUpdate(() => updateWidget(ctx));
760
+ updateWidget(ctx);
761
+ }
762
+ }
763
+ export default function (pi) {
764
+ const initConfig = loadConfigForExtensionInit();
765
+ const toolNames = resolveToolNames(initConfig);
766
+ const webSearchEnabled = isToolEnabled(initConfig, "webSearch");
767
+ const sourceCheckEnabled = isToolEnabled(initConfig, "sourceCheck");
768
+ const fetchContentEnabled = isToolEnabled(initConfig, "fetchContent");
769
+ const getSearchContentEnabled = isToolEnabled(initConfig, "getSearchContent");
770
+ const storedContentSources = joinToolNames([
771
+ ...(webSearchEnabled ? [toolNames.webSearch] : []),
772
+ ...(sourceCheckEnabled ? [toolNames.sourceCheck] : []),
773
+ ...(fetchContentEnabled ? [toolNames.fetchContent] : []),
774
+ ]);
775
+ const searchQueryDescription = webSearchEnabled
776
+ ? `Get content for this query (${toolNames.webSearch})`
777
+ : "Get content for a stored search query";
778
+ const fetchContentStorageNote = getSearchContentEnabled
779
+ ? `Full original content is stored for retrieval with ${toolNames.getSearchContent}.`
780
+ : "Full original content is stored internally, but the retrieval tool is not registered.";
781
+ const curateKey = initConfig.shortcuts?.curate || DEFAULT_SHORTCUTS.curate;
782
+ const activityKey = initConfig.shortcuts?.activity || DEFAULT_SHORTCUTS.activity;
783
+ function startBackgroundFetch(urls) {
784
+ if (urls.length === 0)
785
+ return null;
786
+ const fetchId = generateId();
787
+ const controller = new AbortController();
788
+ pendingFetches.set(fetchId, controller);
789
+ fetchAllContent(urls, controller.signal)
790
+ .then((fetched) => {
791
+ if (!sessionActive || !pendingFetches.has(fetchId))
792
+ return;
793
+ const data = {
794
+ id: fetchId,
795
+ type: "fetch",
796
+ timestamp: Date.now(),
797
+ urls: stripThumbnails(fetched),
798
+ };
799
+ pi.appendEntry("web-search-results", storeFetchedContentResult(fetchId, data));
800
+ const ok = fetched.filter(f => !f.error).length;
801
+ pi.sendMessage({
802
+ customType: "web-search-content-ready",
803
+ content: `Content fetched for ${ok}/${fetched.length} URLs [${fetchId}]. Full page content now available.`,
804
+ display: true,
805
+ }, { triggerTurn: true });
806
+ })
807
+ .catch((err) => {
808
+ if (!sessionActive || !pendingFetches.has(fetchId))
809
+ return;
810
+ const message = err instanceof Error ? err.message : String(err);
811
+ const isAbort = (err instanceof Error && err.name === "AbortError") || message.toLowerCase().includes("abort");
812
+ if (!isAbort) {
813
+ pi.sendMessage({
814
+ customType: "web-search-error",
815
+ content: `Content fetch failed [${fetchId}]: ${message}`,
816
+ display: true,
817
+ }, { triggerTurn: false });
818
+ }
819
+ })
820
+ .finally(() => { pendingFetches.delete(fetchId); });
821
+ return fetchId;
822
+ }
823
+ function storeAndPublishSearch(results) {
824
+ const id = generateId();
825
+ const data = {
826
+ id, type: "search", timestamp: Date.now(), queries: results,
827
+ };
828
+ storeResult(id, data);
829
+ pi.appendEntry("web-search-results", data);
830
+ return id;
831
+ }
832
+ function normalizeSummaryMeta(meta, summaryText) {
833
+ const normalizedText = summaryText.trim();
834
+ if (!meta) {
835
+ return {
836
+ model: null,
837
+ durationMs: 0,
838
+ tokenEstimate: normalizedText.length > 0 ? Math.max(1, Math.ceil(normalizedText.length / 4)) : 0,
839
+ fallbackUsed: false,
840
+ edited: false,
841
+ };
842
+ }
843
+ return {
844
+ model: meta.model,
845
+ durationMs: Number.isFinite(meta.durationMs) && meta.durationMs >= 0 ? meta.durationMs : 0,
846
+ tokenEstimate: Number.isFinite(meta.tokenEstimate) && meta.tokenEstimate >= 0
847
+ ? meta.tokenEstimate
848
+ : (normalizedText.length > 0 ? Math.max(1, Math.ceil(normalizedText.length / 4)) : 0),
849
+ fallbackUsed: meta.fallbackUsed === true,
850
+ fallbackReason: meta.fallbackReason,
851
+ phase: meta.phase,
852
+ edited: meta.edited === true,
853
+ };
854
+ }
855
+ function buildCurationCancelledReturn(reason, partial) {
856
+ const message = `Search curation cancelled (${reason}).`;
857
+ const cancelledQueries = partial?.queries?.length
858
+ ? partial.queries.map(q => ({
859
+ query: q.query,
860
+ provider: q.provider ?? null,
861
+ error: q.error,
862
+ resultCount: q.results?.length ?? 0,
863
+ }))
864
+ : undefined;
865
+ const extraLines = [];
866
+ if (partial?.curatorUrl)
867
+ extraLines.push(`curator: ${partial.curatorUrl}`);
868
+ if (partial?.browserOpenError)
869
+ extraLines.push(`browser open error: ${partial.browserOpenError}`);
870
+ return {
871
+ content: [{ type: "text", text: message }],
872
+ details: {
873
+ error: message,
874
+ cancelled: true,
875
+ cancelReason: reason,
876
+ browserConnected: partial?.browserConnected,
877
+ lastHeartbeatAgeMs: partial?.lastHeartbeatAgeMs,
878
+ queryCount: partial?.queryCount,
879
+ cancelledQueries,
880
+ extraLines: extraLines.length > 0 ? extraLines : undefined,
881
+ },
882
+ };
883
+ }
884
+ async function resolveFirstAvailableModel(ctx, candidates) {
885
+ const enabledModelPatterns = loadEnabledModelPatterns(ctx);
886
+ for (const { provider, id } of candidates) {
887
+ const model = findModelWithProviderRouting(ctx.modelRegistry, provider, id);
888
+ if (!model || !modelMatchesEnabledPatterns(model, enabledModelPatterns))
889
+ continue;
890
+ const auth = await ctx.modelRegistry.getApiKeyAndHeaders(model);
891
+ if (auth.ok && auth.apiKey)
892
+ return { model, apiKey: auth.apiKey, headers: auth.headers };
893
+ }
894
+ throw new Error(`No enabled model available: ${candidates.map(c => `${c.provider}/${c.id}`).join(", ")}`);
895
+ }
896
+ async function rewriteSearchQuery(query, ctx, signal) {
897
+ const { model, apiKey, headers } = await resolveFirstAvailableModel(ctx, [
898
+ { provider: "anthropic", id: "claude-haiku-4-5" },
899
+ { provider: "google", id: "gemini-3.6-flash" },
900
+ { provider: "openai", id: "gpt-4.1-mini" },
901
+ ]);
902
+ const response = await complete(model, {
903
+ messages: [{
904
+ role: "user",
905
+ content: [{ type: "text", text: `Rewrite this web search query to get better, more specific results. Add relevant year qualifiers, precise technical terms, and specificity. Return ONLY the improved query text, nothing else.\n\nQuery: ${query}` }],
906
+ timestamp: Date.now(),
907
+ }],
908
+ }, { apiKey, headers, signal });
909
+ if (response.stopReason === "aborted")
910
+ throw new Error("Aborted");
911
+ const contentParts = Array.isArray(response.content) ? response.content : [];
912
+ const text = contentParts
913
+ .map(part => part.type === "text" ? part.text : "")
914
+ .join("")
915
+ .trim();
916
+ if (!text)
917
+ throw new Error("Rewrite returned empty response");
918
+ return text;
919
+ }
920
+ async function generateSummaryForSelectedIndices(selectedQueryIndices, resultsByIndex, summaryContext, signal, modelOverride, feedback) {
921
+ const selectedResults = [];
922
+ for (const qi of selectedQueryIndices) {
923
+ const result = resultsByIndex.get(qi);
924
+ if (result)
925
+ selectedResults.push(result);
926
+ }
927
+ if (selectedResults.length === 0) {
928
+ throw new Error("No selected results available for summary generation");
929
+ }
930
+ try {
931
+ return await generateSummaryDraft(selectedResults, summaryContext, signal, modelOverride, feedback, undefined, getSummaryGenerationDeadlineMs());
932
+ }
933
+ catch (err) {
934
+ const isEmptyResponse = err instanceof Error && err.message.includes("Summary model returned empty response");
935
+ if (!isEmptyResponse)
936
+ throw err;
937
+ const deterministic = buildDeterministicSummary(selectedResults);
938
+ return {
939
+ summary: deterministic.summary,
940
+ meta: {
941
+ ...deterministic.meta,
942
+ fallbackReason: "summary-model-empty-response",
943
+ },
944
+ };
945
+ }
946
+ }
947
+ async function loadSummaryModelChoices(summaryContext) {
948
+ const summaryModels = [];
949
+ const seen = new Set();
950
+ const availableValues = new Set();
951
+ const addModel = (provider, id) => {
952
+ const value = `${provider}/${id}`;
953
+ if (seen.has(value))
954
+ return;
955
+ seen.add(value);
956
+ summaryModels.push({ value, label: value });
957
+ };
958
+ let enabledModelPatterns = null;
959
+ let scopeLoaded = true;
960
+ try {
961
+ enabledModelPatterns = loadEnabledModelPatterns(summaryContext);
962
+ const availableModels = summaryContext.modelRegistry.getAvailable();
963
+ for (const model of availableModels) {
964
+ if (!modelMatchesEnabledPatterns(model, enabledModelPatterns))
965
+ continue;
966
+ const value = `${model.provider}/${model.id}`;
967
+ availableValues.add(value);
968
+ addModel(model.provider, model.id);
969
+ }
970
+ }
971
+ catch (err) {
972
+ scopeLoaded = false;
973
+ const message = err instanceof Error ? err.message : String(err);
974
+ console.error(`Failed to load summary models: ${message}`);
975
+ }
976
+ const currentModelValue = summaryContext.model
977
+ ? `${summaryContext.model.provider}/${summaryContext.model.id}`
978
+ : null;
979
+ if (scopeLoaded && summaryContext.model && currentModelValue && !seen.has(currentModelValue) && modelMatchesEnabledPatterns(summaryContext.model, enabledModelPatterns)) {
980
+ addModel(summaryContext.model.provider, summaryContext.model.id);
981
+ }
982
+ const config = loadConfig();
983
+ const configuredSummaryModel = typeof config.summaryModel === "string" ? config.summaryModel.trim() : "";
984
+ const preferredDefaults = [
985
+ { provider: "anthropic", id: "claude-haiku-4-5" },
986
+ { provider: "openai-codex", id: "gpt-5.3-codex-spark" },
987
+ ];
988
+ const resolveAvailableModelValue = (selector) => {
989
+ const slashIndex = selector.indexOf("/");
990
+ if (slashIndex <= 0 || slashIndex >= selector.length - 1)
991
+ return null;
992
+ const model = findModelWithProviderRouting(summaryContext.modelRegistry, selector.slice(0, slashIndex), selector.slice(slashIndex + 1));
993
+ if (!model)
994
+ return null;
995
+ const value = `${model.provider}/${model.id}`;
996
+ return availableValues.has(value) ? value : null;
997
+ };
998
+ let defaultSummaryModel = null;
999
+ if (scopeLoaded && configuredSummaryModel.length > 0) {
1000
+ defaultSummaryModel = availableValues.has(configuredSummaryModel)
1001
+ ? configuredSummaryModel
1002
+ : resolveAvailableModelValue(configuredSummaryModel);
1003
+ }
1004
+ if (scopeLoaded && !defaultSummaryModel) {
1005
+ for (const preferred of preferredDefaults) {
1006
+ const model = findModelWithProviderRouting(summaryContext.modelRegistry, preferred.provider, preferred.id);
1007
+ const value = model ? `${model.provider}/${model.id}` : null;
1008
+ if (value && availableValues.has(value)) {
1009
+ defaultSummaryModel = value;
1010
+ break;
1011
+ }
1012
+ }
1013
+ }
1014
+ return { summaryModels, defaultSummaryModel };
1015
+ }
1016
+ function resolveSummaryForSubmit(payload, resultsByIndex) {
1017
+ const submittedSummary = typeof payload.summary === "string" ? payload.summary.trim() : "";
1018
+ if (submittedSummary.length > 0) {
1019
+ return {
1020
+ approvedSummary: submittedSummary,
1021
+ summaryMeta: normalizeSummaryMeta(payload.summaryMeta, submittedSummary),
1022
+ };
1023
+ }
1024
+ const selected = filterByQueryIndices(payload.selectedQueryIndices, resultsByIndex).results;
1025
+ const fallbackResults = selected.length > 0 ? selected : [...resultsByIndex.values()];
1026
+ const deterministic = buildDeterministicSummary(fallbackResults);
1027
+ return {
1028
+ approvedSummary: deterministic.summary,
1029
+ summaryMeta: deterministic.meta,
1030
+ };
1031
+ }
1032
+ function buildSearchReturn(opts) {
1033
+ const sc = opts.results.filter(r => !r.error).length;
1034
+ const tr = opts.results.reduce((sum, r) => sum + r.results.length, 0);
1035
+ const hasApprovedSummary = typeof opts.approvedSummary === "string" && opts.approvedSummary.trim().length > 0;
1036
+ let output = "";
1037
+ if (hasApprovedSummary) {
1038
+ output = opts.approvedSummary.trim();
1039
+ }
1040
+ else {
1041
+ if (opts.curated) {
1042
+ output += "[These results were manually curated by the user in the browser. Use them as-is — do not re-search or discard.]\n\n";
1043
+ }
1044
+ const duplicateQueries = opts.curated ? duplicateQuerySet(opts.results) : new Set();
1045
+ for (const { query, answer, results, error, provider } of opts.results) {
1046
+ if (opts.queryList.length > 1) {
1047
+ output += opts.curated
1048
+ ? formatQueryHeader(query, provider, duplicateQueries)
1049
+ : `## Query: "${query}"\n\n`;
1050
+ }
1051
+ if (error)
1052
+ output += `Error: ${error}\n\n`;
1053
+ else
1054
+ output += formatSearchSummary(results, answer) + "\n\n";
1055
+ }
1056
+ }
1057
+ const hasInlineReady = hasFullInlineCoverage(opts.urls, opts.inlineContent);
1058
+ let fetchId = null;
1059
+ if (hasInlineReady && opts.inlineContent) {
1060
+ fetchId = generateId();
1061
+ const data = {
1062
+ id: fetchId,
1063
+ type: "fetch",
1064
+ timestamp: Date.now(),
1065
+ urls: opts.inlineContent,
1066
+ };
1067
+ pi.appendEntry("web-search-results", storeFetchedContentResult(fetchId, data));
1068
+ if (!hasApprovedSummary) {
1069
+ output += `---\nFull content for ${opts.inlineContent.length} sources available [${fetchId}].`;
1070
+ }
1071
+ }
1072
+ else if (opts.includeContent) {
1073
+ fetchId = startBackgroundFetch(opts.urls);
1074
+ if (fetchId && !hasApprovedSummary) {
1075
+ output += `---\nContent fetching in background [${fetchId}]. Will notify when ready.`;
1076
+ }
1077
+ }
1078
+ const searchId = storeAndPublishSearch(opts.results);
1079
+ const isBackgroundFetch = fetchId !== null && !hasInlineReady;
1080
+ return {
1081
+ content: [{ type: "text", text: output.trim() }],
1082
+ details: {
1083
+ queries: opts.queryList,
1084
+ queryCount: opts.queryList.length,
1085
+ successfulQueries: sc,
1086
+ totalResults: tr,
1087
+ includeContent: opts.includeContent,
1088
+ fetchId,
1089
+ fetchUrls: isBackgroundFetch ? opts.urls : undefined,
1090
+ searchId,
1091
+ ...(opts.curated ? {
1092
+ curated: true,
1093
+ curatedFrom: opts.curatedFrom,
1094
+ curatedQueries: opts.results.map(r => ({
1095
+ query: r.query,
1096
+ provider: r.provider || null,
1097
+ answer: r.answer || null,
1098
+ sources: r.results.map(s => ({ title: s.title, url: s.url })),
1099
+ error: r.error,
1100
+ })),
1101
+ } : {}),
1102
+ ...((opts.workflow && hasApprovedSummary)
1103
+ ? {
1104
+ summary: {
1105
+ text: opts.approvedSummary.trim(),
1106
+ workflow: opts.workflow,
1107
+ model: opts.summaryMeta?.model ?? null,
1108
+ durationMs: opts.summaryMeta?.durationMs ?? 0,
1109
+ tokenEstimate: opts.summaryMeta?.tokenEstimate ?? 0,
1110
+ fallbackUsed: opts.summaryMeta?.fallbackUsed === true,
1111
+ fallbackReason: opts.summaryMeta?.fallbackReason,
1112
+ phase: opts.summaryMeta?.phase,
1113
+ edited: opts.summaryMeta?.edited === true,
1114
+ },
1115
+ }
1116
+ : {}),
1117
+ },
1118
+ };
1119
+ }
1120
+ function filterByQueryIndices(selectedQueryIndices, results) {
1121
+ const filteredResults = [];
1122
+ const filteredUrls = [];
1123
+ for (const qi of selectedQueryIndices) {
1124
+ const r = results.get(qi);
1125
+ if (r) {
1126
+ filteredResults.push(r);
1127
+ for (const res of r.results) {
1128
+ if (!filteredUrls.includes(res.url))
1129
+ filteredUrls.push(res.url);
1130
+ }
1131
+ }
1132
+ }
1133
+ return { results: filteredResults, urls: filteredUrls };
1134
+ }
1135
+ function collectAllResultsAndUrls(resultsByIndex) {
1136
+ const results = [...resultsByIndex.values()];
1137
+ const urls = [];
1138
+ for (const result of results) {
1139
+ for (const source of result.results) {
1140
+ if (!urls.includes(source.url))
1141
+ urls.push(source.url);
1142
+ }
1143
+ }
1144
+ return { results, urls };
1145
+ }
1146
+ async function openCuratorBrowser(callId, pc, ctx, searchesComplete = true) {
1147
+ if (pendingCurates.get(callId) !== pc)
1148
+ return;
1149
+ let handle = null;
1150
+ const sendCuratorFallbackUpdate = (message) => {
1151
+ if (!handle)
1152
+ return;
1153
+ pc.onUpdate?.({
1154
+ content: [{ type: "text", text: `${message}\nOpen manually: ${handle.url}` }],
1155
+ details: {
1156
+ phase: "curator-fallback",
1157
+ progress: searchesComplete ? 1 : 0.5,
1158
+ curatorUrl: handle.url,
1159
+ timeoutSeconds: pc.timeoutSeconds,
1160
+ shortcut: curateKey,
1161
+ browserOpenError: pc.browserOpenError,
1162
+ },
1163
+ });
1164
+ };
1165
+ try {
1166
+ pc.phase = "curating";
1167
+ const searchAbort = new AbortController();
1168
+ const addSearchSignal = pc.signal
1169
+ ? AbortSignal.any([pc.signal, searchAbort.signal])
1170
+ : searchAbort.signal;
1171
+ const sessionToken = randomUUID();
1172
+ handle = await startCuratorServer({
1173
+ queries: pc.queryList,
1174
+ sessionToken,
1175
+ timeout: pc.timeoutSeconds,
1176
+ availableProviders: pc.availableProviders,
1177
+ defaultProvider: pc.defaultProvider,
1178
+ searchProvider: toCuratorProvider(pc.searchProvider) ?? "auto",
1179
+ summaryModels: pc.summaryModels,
1180
+ defaultSummaryModel: pc.defaultSummaryModel,
1181
+ }, {
1182
+ async onSummarize(selectedQueryIndices, summarizeSignal, model, feedback) {
1183
+ if (pendingCurates.get(callId) !== pc)
1184
+ throw new Error("Curator session is no longer active.");
1185
+ pc.onUpdate?.({
1186
+ content: [{ type: "text", text: "Generating summary draft..." }],
1187
+ details: { phase: "generating-summary", progress: 0.9, curatorUrl: pc.curatorUrl, timeoutSeconds: pc.timeoutSeconds, shortcut: curateKey },
1188
+ });
1189
+ const draft = await generateSummaryForSelectedIndices(selectedQueryIndices, pc.searchResults, pc.summaryContext, summarizeSignal, model, feedback);
1190
+ if (pendingCurates.get(callId) !== pc)
1191
+ throw new Error("Curator session is no longer active.");
1192
+ pc.onUpdate?.({
1193
+ content: [{ type: "text", text: "Summary draft ready — waiting for approval..." }],
1194
+ details: { phase: "waiting-for-approval", progress: 1, curatorUrl: pc.curatorUrl, timeoutSeconds: pc.timeoutSeconds, shortcut: curateKey },
1195
+ });
1196
+ return draft;
1197
+ },
1198
+ onSubmit(payload) {
1199
+ if (pendingCurates.get(callId) !== pc)
1200
+ return;
1201
+ searchAbort.abort();
1202
+ const filtered = payload.selectedQueryIndices.length > 0
1203
+ ? filterByQueryIndices(payload.selectedQueryIndices, pc.searchResults)
1204
+ : collectAllResultsAndUrls(pc.searchResults);
1205
+ const filteredInline = pc.allInlineContent.filter(c => filtered.urls.includes(c.url));
1206
+ const base = {
1207
+ queryList: filtered.results.map(r => r.query),
1208
+ results: filtered.results,
1209
+ urls: filtered.urls,
1210
+ includeContent: pc.includeContent,
1211
+ inlineContent: filteredInline.length > 0 ? filteredInline : undefined,
1212
+ curated: true,
1213
+ curatedFrom: pc.searchResults.size,
1214
+ };
1215
+ if (!payload.rawResults) {
1216
+ const resolvedSummary = resolveSummaryForSubmit(payload, pc.searchResults);
1217
+ base.workflow = pc.workflow;
1218
+ base.approvedSummary = resolvedSummary.approvedSummary;
1219
+ base.summaryMeta = resolvedSummary.summaryMeta;
1220
+ }
1221
+ pc.finish(buildSearchReturn(base));
1222
+ closeCurator(callId);
1223
+ },
1224
+ onCancel(reason) {
1225
+ if (pendingCurates.get(callId) !== pc)
1226
+ return;
1227
+ searchAbort.abort();
1228
+ if (reason === "timeout") {
1229
+ const resolvedSummary = resolveSummaryForSubmit({ selectedQueryIndices: [], summary: undefined, summaryMeta: undefined }, pc.searchResults);
1230
+ const all = collectAllResultsAndUrls(pc.searchResults);
1231
+ const filteredInline = pc.allInlineContent.filter(c => all.urls.includes(c.url));
1232
+ pc.finish(buildSearchReturn({
1233
+ queryList: all.results.map(r => r.query),
1234
+ results: all.results,
1235
+ urls: all.urls,
1236
+ includeContent: pc.includeContent,
1237
+ inlineContent: filteredInline.length > 0 ? filteredInline : undefined,
1238
+ curated: true,
1239
+ curatedFrom: pc.searchResults.size,
1240
+ workflow: pc.workflow,
1241
+ approvedSummary: resolvedSummary.approvedSummary,
1242
+ summaryMeta: resolvedSummary.summaryMeta,
1243
+ }));
1244
+ }
1245
+ else {
1246
+ const conn = activeCurators.get(callId)?.getConnectionState();
1247
+ pc.finish(buildCurationCancelledReturn(reason, {
1248
+ queries: Array.from(pc.searchResults.values()),
1249
+ queryCount: pc.queryList.length,
1250
+ browserConnected: conn?.browserConnected,
1251
+ lastHeartbeatAgeMs: conn?.lastHeartbeatAgeMs,
1252
+ curatorUrl: pc.curatorUrl,
1253
+ browserOpenError: pc.browserOpenError,
1254
+ }));
1255
+ }
1256
+ closeCurator(callId);
1257
+ },
1258
+ onProviderChange(provider) {
1259
+ if (pendingCurates.get(callId) !== pc)
1260
+ return;
1261
+ const normalized = normalizeProviderInput(provider);
1262
+ if (!normalized || normalized === "auto" || Array.isArray(normalized))
1263
+ return;
1264
+ pc.defaultProvider = normalized;
1265
+ pc.searchProvider = normalized;
1266
+ try {
1267
+ saveConfig({ provider: normalized });
1268
+ }
1269
+ catch (err) {
1270
+ const message = err instanceof Error ? err.message : String(err);
1271
+ console.error(`Failed to persist default provider: ${message}`);
1272
+ }
1273
+ },
1274
+ async onAddSearch(query, provider) {
1275
+ if (pendingCurates.get(callId) !== pc)
1276
+ throw new Error("Curator session is no longer active.");
1277
+ const requestedProvider = resolveCuratorSearchProvider(provider, pc.searchProvider);
1278
+ const response = await search(query, {
1279
+ provider: requestedProvider,
1280
+ numResults: pc.numResults,
1281
+ recencyFilter: pc.recencyFilter,
1282
+ domainFilter: pc.domainFilter,
1283
+ includeContent: pc.includeContent,
1284
+ signal: addSearchSignal,
1285
+ extensionContext: ctx,
1286
+ });
1287
+ if (pendingCurates.get(callId) !== pc)
1288
+ throw new Error("Curator session is no longer active.");
1289
+ if (response.inlineContent)
1290
+ pc.allInlineContent.push(...response.inlineContent);
1291
+ return toCuratorSearchEntries(response);
1292
+ },
1293
+ onAddSearchResults(entries) {
1294
+ if (pendingCurates.get(callId) !== pc)
1295
+ return;
1296
+ for (const entry of entries) {
1297
+ pc.searchResults.set(entry.queryIndex, indexedCuratorEntryToQueryResult(entry));
1298
+ }
1299
+ },
1300
+ async onRewriteQuery(query, rewriteSignal) {
1301
+ if (pendingCurates.get(callId) !== pc)
1302
+ throw new Error("Curator session is no longer active.");
1303
+ return rewriteSearchQuery(query, pc.summaryContext, rewriteSignal);
1304
+ },
1305
+ });
1306
+ if (pendingCurates.get(callId) !== pc) {
1307
+ handle.close();
1308
+ return;
1309
+ }
1310
+ activeCurators.set(callId, handle);
1311
+ pc.curatorUrl = handle.url;
1312
+ for (const [qi, data] of pc.searchResults) {
1313
+ const slotIndex = pc.resultSlots.get(qi);
1314
+ if (data.error) {
1315
+ handle.pushError(qi, data.error, data.provider, { query: data.query, slotIndex });
1316
+ }
1317
+ else {
1318
+ handle.pushResult(qi, {
1319
+ answer: data.answer,
1320
+ results: data.results.map(r => ({ ...r, domain: extractDomain(r.url) })),
1321
+ provider: data.provider || pc.defaultProvider,
1322
+ query: data.query,
1323
+ slotIndex,
1324
+ });
1325
+ }
1326
+ }
1327
+ if (searchesComplete)
1328
+ handle.searchesDone();
1329
+ pc.onUpdate?.({
1330
+ content: [{ type: "text", text: searchesComplete ? "Waiting for summary approval in browser..." : "Searches streaming to browser..." }],
1331
+ details: {
1332
+ phase: "curating",
1333
+ progress: searchesComplete ? 1 : 0.5,
1334
+ curatorUrl: handle.url,
1335
+ timeoutSeconds: pc.timeoutSeconds,
1336
+ shortcut: curateKey,
1337
+ },
1338
+ });
1339
+ if (!shouldAutoOpenCuratorBrowser(loadConfig())) {
1340
+ sendCuratorFallbackUpdate("Search curator is running. Open the curator URL manually.");
1341
+ return;
1342
+ }
1343
+ const open = platform() === "darwin" ? await getGlimpseOpen() : null;
1344
+ if (open) {
1345
+ try {
1346
+ const win = openInGlimpse(open, handle.url, "Search Curator");
1347
+ glimpseWins.set(callId, win);
1348
+ win.on("closed", () => {
1349
+ if (glimpseWins.get(callId) === win) {
1350
+ glimpseWins.delete(callId);
1351
+ closeCurator(callId);
1352
+ }
1353
+ });
1354
+ return;
1355
+ }
1356
+ catch (err) {
1357
+ const message = err instanceof Error ? err.message : String(err);
1358
+ console.error(`Failed to open Glimpse curator window: ${message}`);
1359
+ glimpseWins.delete(callId);
1360
+ }
1361
+ }
1362
+ await openInBrowser(pi, handle.url);
1363
+ }
1364
+ catch (err) {
1365
+ const message = err instanceof Error ? err.message : String(err);
1366
+ console.error(`Failed to open curator UI: ${message}`);
1367
+ if (handle && activeCurators.get(callId) === handle && pendingCurates.get(callId) === pc) {
1368
+ pc.browserOpenError = message;
1369
+ sendCuratorFallbackUpdate("Search curator is running, but the browser did not open automatically.");
1370
+ }
1371
+ else if (pendingCurates.get(callId) === pc || (handle && activeCurators.get(callId) === handle)) {
1372
+ closeCurator(callId);
1373
+ }
1374
+ }
1375
+ }
1376
+ pi.registerShortcut(curateKey, {
1377
+ description: "Review search results",
1378
+ handler: async (ctx) => {
1379
+ const entries = [...pendingCurates.entries()];
1380
+ if (entries.length === 0)
1381
+ return;
1382
+ const [callId, pc] = entries[entries.length - 1];
1383
+ if (pc.phase === "searching") {
1384
+ pc.browserPromise = openCuratorBrowser(callId, pc, ctx, false);
1385
+ ctx.ui.notify("Opening curator — remaining searches will stream in", "info");
1386
+ return;
1387
+ }
1388
+ },
1389
+ });
1390
+ pi.registerShortcut(activityKey, {
1391
+ description: "Toggle web search activity",
1392
+ handler: async (ctx) => {
1393
+ widgetVisible = !widgetVisible;
1394
+ if (widgetVisible) {
1395
+ widgetUnsubscribe = activityMonitor.onUpdate(() => updateWidget(ctx));
1396
+ updateWidget(ctx);
1397
+ }
1398
+ else {
1399
+ widgetUnsubscribe?.();
1400
+ widgetUnsubscribe = null;
1401
+ ctx.ui.setWidget("web-activity", undefined);
1402
+ }
1403
+ },
1404
+ });
1405
+ pi.on("session_start", async (_event, ctx) => handleSessionChange(ctx));
1406
+ pi.on("session_tree", async (_event, ctx) => handleSessionChange(ctx));
1407
+ pi.on("session_shutdown", () => {
1408
+ sessionActive = false;
1409
+ abortPendingFetches();
1410
+ closeCurator();
1411
+ clearCloneCache();
1412
+ clearResults();
1413
+ // Unsubscribe before clear() to avoid callback with stale ctx
1414
+ widgetUnsubscribe?.();
1415
+ widgetUnsubscribe = null;
1416
+ activityMonitor.clear();
1417
+ widgetVisible = false;
1418
+ });
1419
+ if (webSearchEnabled)
1420
+ pi.registerTool({
1421
+ name: toolNames.webSearch,
1422
+ label: "Web Search",
1423
+ description: `Search the web using OpenAI, Brave, Parallel, TinyFish, Search1API, Searchinfinity, Querit, Tavily, Jina, SERPdive, Kagi, Bocha, Ollama, SearXNG, DuckDuckGo, Exa, Perplexity, Gemini, AnySearch, xAI, Bright Data, or SerpBase. Pass a provider array to search only those providers simultaneously, or use provider "all" to search every eligible provider except DuckDuckGo, AnySearch, xAI, Bright Data, and SerpBase. Returns an AI-synthesized answer with source citations. OpenAI search uses a Codex subscription or OpenAI API key; xAI search uses a SuperGrok/X Premium subscription or xAI API key. DuckDuckGo, AnySearch, xAI, Bright Data, and SerpBase are available only when explicitly selected. For comprehensive research, prefer queries (plural) with 2-4 varied angles over a single query — each query gets its own synthesized answer, so varying phrasing and scope gives much broader coverage. When includeContent is true, full page content is fetched in the background. Searches auto-open the interactive browser curator and stream results live; set workflow to "none" to skip curation or "auto-summary" for a model-generated summary without the browser curator. The configured provider is used when provider is omitted or set to auto; omit provider unless explicitly overriding it. Without a configured provider, auto-selects OpenAI when suitable and available, then Exa, Brave, Parallel, TinyFish, Search1API, Searchinfinity, Querit, Tavily, Jina, SERPdive, Kagi, Bocha, Ollama, Perplexity, Gemini API, or Gemini Web. When SearXNG is configured, it is preferred first for local/private search.`,
1424
+ promptSnippet: "Use for web research questions. Prefer {queries:[...]} with 2-4 varied angles over a single query for broader coverage. Omit provider unless explicitly overriding the configured default.",
1425
+ parameters: Type.Object({
1426
+ query: Type.Optional(Type.String({ description: "Single search query. For research tasks, prefer 'queries' with multiple varied angles instead." })),
1427
+ queries: Type.Optional(Type.Array(Type.String(), { description: "Multiple queries searched in sequence, each returning its own synthesized answer. Prefer this for research — vary phrasing, scope, and angle across 2-4 queries to maximize coverage. Good: ['React vs Vue performance benchmarks 2026', 'React vs Vue developer experience comparison', 'React ecosystem size vs Vue ecosystem']. Bad: ['React vs Vue', 'React vs Vue comparison', 'React vs Vue review'] (too similar, redundant results)." })),
1428
+ numResults: Type.Optional(Type.Number({ description: "Results per query (default: 5, max: 20)" })),
1429
+ includeContent: Type.Optional(Type.Boolean({ description: "Fetch full page content (async)" })),
1430
+ recencyFilter: Type.Optional(StringEnum(["day", "week", "month", "year"], { description: "Filter by recency" })),
1431
+ domainFilter: Type.Optional(Type.Array(Type.String(), { description: "Limit to domains (prefix with - to exclude)" })),
1432
+ provider: Type.Optional(searchProviderSchema("Search provider or non-empty list of providers to search simultaneously; use all to search every eligible provider except DuckDuckGo, AnySearch, xAI, Bright Data, and SerpBase, omit this field to use the configured provider, or use auto when none is configured")),
1433
+ workflow: Type.Optional(StringEnum(["none", "summary-review", "auto-summary"], {
1434
+ description: "Search workflow mode: none = no curator, summary-review = open curator with auto summary draft (default), auto-summary = generate summary without opening curator",
1435
+ })),
1436
+ }),
1437
+ async execute(callId, params, signal, onUpdate, ctx) {
1438
+ const rawQueryList = Array.isArray(params.queries)
1439
+ ? params.queries
1440
+ : (params.query !== undefined ? [params.query] : []);
1441
+ const queryList = normalizeQueryList(rawQueryList);
1442
+ const configWorkflow = loadConfigForExtensionInit().workflow;
1443
+ const workflow = resolveWorkflow(params.workflow ?? configWorkflow, ctx?.hasUI !== false);
1444
+ const shouldCurate = workflow === "summary-review";
1445
+ const recencyFilter = normalizeRecencyFilter(params.recencyFilter);
1446
+ if (queryList.length === 0) {
1447
+ return {
1448
+ content: [{ type: "text", text: "Error: No query provided. Use 'query' or 'queries' parameter." }],
1449
+ details: { error: "No query provided" },
1450
+ };
1451
+ }
1452
+ if (shouldCurate && !ctx) {
1453
+ return {
1454
+ content: [{ type: "text", text: "Error: Curation requires an active extension context." }],
1455
+ details: { error: "Missing extension context" },
1456
+ };
1457
+ }
1458
+ if (shouldCurate) {
1459
+ closeCurator(callId);
1460
+ let resolvePromise = () => { };
1461
+ const promise = new Promise((resolve) => {
1462
+ resolvePromise = resolve;
1463
+ });
1464
+ const includeContent = params.includeContent ?? false;
1465
+ const searchResults = new Map();
1466
+ const resultSlots = new Map();
1467
+ const allInlineContent = [];
1468
+ let nextResultIndex = queryList.length;
1469
+ const searchAbort = new AbortController();
1470
+ const searchSignal = signal
1471
+ ? AbortSignal.any([signal, searchAbort.signal])
1472
+ : searchAbort.signal;
1473
+ let cancelled = false;
1474
+ const requestedProvider = resolveRequestedProvider(params.provider);
1475
+ const bootstrap = await loadCuratorBootstrap(requestedProvider, ctx, {
1476
+ numResults: params.numResults,
1477
+ recencyFilter,
1478
+ });
1479
+ const availableProviders = bootstrap.availableProviders;
1480
+ const defaultProvider = bootstrap.defaultProvider;
1481
+ const searchProvider = requestedProvider;
1482
+ const curatorTimeoutSeconds = bootstrap.timeoutSeconds;
1483
+ const curatorWorkflow = "summary-review";
1484
+ const summaryContext = {
1485
+ model: ctx.model,
1486
+ modelRegistry: ctx.modelRegistry,
1487
+ cwd: ctx.cwd,
1488
+ isProjectTrusted: () => ctx.isProjectTrusted(),
1489
+ };
1490
+ const summaryModelChoices = await loadSummaryModelChoices(summaryContext);
1491
+ const pc = {
1492
+ phase: "searching",
1493
+ workflow: curatorWorkflow,
1494
+ summaryContext,
1495
+ searchResults,
1496
+ resultSlots,
1497
+ allInlineContent,
1498
+ queryList,
1499
+ includeContent,
1500
+ numResults: params.numResults,
1501
+ recencyFilter,
1502
+ domainFilter: params.domainFilter,
1503
+ availableProviders,
1504
+ defaultProvider,
1505
+ searchProvider,
1506
+ summaryModels: summaryModelChoices.summaryModels,
1507
+ defaultSummaryModel: summaryModelChoices.defaultSummaryModel,
1508
+ timeoutSeconds: curatorTimeoutSeconds,
1509
+ onUpdate: onUpdate,
1510
+ signal,
1511
+ abortSearches: () => {
1512
+ if (!searchAbort.signal.aborted)
1513
+ searchAbort.abort();
1514
+ },
1515
+ finish: () => { },
1516
+ cancel: () => { },
1517
+ };
1518
+ const finish = (value) => {
1519
+ if (cancelled)
1520
+ return;
1521
+ cancelled = true;
1522
+ pc.abortSearches();
1523
+ signal?.removeEventListener("abort", onAbort);
1524
+ pendingCurates.delete(callId);
1525
+ resolvePromise(value);
1526
+ };
1527
+ const cancel = (reason = "stale") => {
1528
+ if (cancelled)
1529
+ return;
1530
+ const conn = activeCurators.get(callId)?.getConnectionState();
1531
+ finish(buildCurationCancelledReturn(reason, {
1532
+ queries: Array.from(searchResults.values()),
1533
+ queryCount: queryList.length,
1534
+ browserConnected: conn?.browserConnected,
1535
+ lastHeartbeatAgeMs: conn?.lastHeartbeatAgeMs,
1536
+ curatorUrl: pc.curatorUrl,
1537
+ browserOpenError: pc.browserOpenError,
1538
+ }));
1539
+ };
1540
+ pc.finish = finish;
1541
+ pc.cancel = cancel;
1542
+ const onAbort = () => closeCurator(callId);
1543
+ pendingCurates.set(callId, pc);
1544
+ signal?.addEventListener("abort", onAbort, { once: true });
1545
+ pc.browserPromise = openCuratorBrowser(callId, pc, ctx, false);
1546
+ for (let qi = 0; qi < queryList.length; qi++) {
1547
+ if (signal?.aborted || cancelled || searchAbort.signal.aborted)
1548
+ break;
1549
+ onUpdate?.({
1550
+ content: [{ type: "text", text: `Searching ${qi + 1}/${queryList.length}: "${queryList[qi]}"...` }],
1551
+ details: { phase: "searching", progress: qi / queryList.length, currentQuery: queryList[qi] },
1552
+ });
1553
+ const requestedProvider = pc.searchProvider;
1554
+ try {
1555
+ const response = await search(queryList[qi], {
1556
+ provider: requestedProvider,
1557
+ numResults: params.numResults,
1558
+ recencyFilter,
1559
+ domainFilter: params.domainFilter,
1560
+ includeContent: params.includeContent,
1561
+ signal: searchSignal,
1562
+ extensionContext: ctx,
1563
+ });
1564
+ if (signal?.aborted || cancelled || searchAbort.signal.aborted)
1565
+ break;
1566
+ if (response.inlineContent)
1567
+ allInlineContent.push(...response.inlineContent);
1568
+ const entries = toCuratorSearchEntries(response);
1569
+ const curator = activeCurators.get(callId);
1570
+ for (let entryIndex = 0; entryIndex < entries.length; entryIndex++) {
1571
+ const entry = entries[entryIndex];
1572
+ const resultIndex = entryIndex === 0 ? qi : nextResultIndex++;
1573
+ const indexedEntry = {
1574
+ ...entry,
1575
+ queryIndex: resultIndex,
1576
+ query: queryList[qi],
1577
+ };
1578
+ searchResults.set(resultIndex, indexedCuratorEntryToQueryResult(indexedEntry));
1579
+ resultSlots.set(resultIndex, qi);
1580
+ if (curator) {
1581
+ if (entry.error) {
1582
+ curator.pushError(resultIndex, entry.error, entry.provider, { query: queryList[qi], slotIndex: qi });
1583
+ }
1584
+ else {
1585
+ curator.pushResult(resultIndex, { ...entry, query: queryList[qi], slotIndex: qi });
1586
+ }
1587
+ }
1588
+ }
1589
+ }
1590
+ catch (err) {
1591
+ if (signal?.aborted || cancelled || searchAbort.signal.aborted)
1592
+ break;
1593
+ const message = err instanceof Error ? err.message : String(err);
1594
+ const failedProvider = toCuratorProvider(requestedProvider);
1595
+ searchResults.set(qi, { query: queryList[qi], answer: "", results: [], error: message, provider: failedProvider });
1596
+ resultSlots.set(qi, qi);
1597
+ const curator = activeCurators.get(callId);
1598
+ if (curator) {
1599
+ curator.pushError(qi, message, failedProvider, { query: queryList[qi], slotIndex: qi });
1600
+ }
1601
+ }
1602
+ }
1603
+ if (signal?.aborted || cancelled || searchAbort.signal.aborted) {
1604
+ cancel();
1605
+ return promise;
1606
+ }
1607
+ await pc.browserPromise;
1608
+ const curator = activeCurators.get(callId);
1609
+ if (curator && !cancelled) {
1610
+ curator.searchesDone();
1611
+ if (pc.browserOpenError) {
1612
+ pc.onUpdate?.({
1613
+ content: [{ type: "text", text: `All searches complete. Open the curator manually: ${pc.curatorUrl}` }],
1614
+ details: {
1615
+ phase: "curator-fallback",
1616
+ progress: 1,
1617
+ curatorUrl: pc.curatorUrl,
1618
+ timeoutSeconds: pc.timeoutSeconds,
1619
+ shortcut: curateKey,
1620
+ browserOpenError: pc.browserOpenError,
1621
+ },
1622
+ });
1623
+ }
1624
+ else {
1625
+ pc.onUpdate?.({
1626
+ content: [{ type: "text", text: "All searches complete — waiting for summary approval in browser..." }],
1627
+ details: {
1628
+ phase: "curating",
1629
+ progress: 1,
1630
+ curatorUrl: pc.curatorUrl,
1631
+ timeoutSeconds: pc.timeoutSeconds,
1632
+ shortcut: curateKey,
1633
+ },
1634
+ });
1635
+ }
1636
+ }
1637
+ return promise;
1638
+ }
1639
+ const searchResults = [];
1640
+ const allUrls = [];
1641
+ const allInlineContent = [];
1642
+ const resolvedProvider = resolveRequestedProvider(params.provider);
1643
+ for (let i = 0; i < queryList.length; i++) {
1644
+ const query = queryList[i];
1645
+ onUpdate?.({
1646
+ content: [{ type: "text", text: `Searching ${i + 1}/${queryList.length}: "${query}"...` }],
1647
+ details: { phase: "search", progress: i / queryList.length, currentQuery: query },
1648
+ });
1649
+ try {
1650
+ const { answer, results, inlineContent, provider } = await search(query, {
1651
+ provider: resolvedProvider,
1652
+ numResults: params.numResults,
1653
+ recencyFilter,
1654
+ domainFilter: params.domainFilter,
1655
+ includeContent: params.includeContent,
1656
+ signal,
1657
+ extensionContext: ctx,
1658
+ });
1659
+ searchResults.push({ query, answer, results, error: null, provider });
1660
+ for (const r of results) {
1661
+ if (!allUrls.includes(r.url)) {
1662
+ allUrls.push(r.url);
1663
+ }
1664
+ }
1665
+ if (inlineContent)
1666
+ allInlineContent.push(...inlineContent);
1667
+ }
1668
+ catch (err) {
1669
+ if (signal?.aborted || isAbortError(err))
1670
+ throw err;
1671
+ const message = err instanceof Error ? err.message : String(err);
1672
+ const requestedProvider = toCuratorProvider(resolvedProvider);
1673
+ searchResults.push({ query, answer: "", results: [], error: message, provider: requestedProvider });
1674
+ }
1675
+ }
1676
+ let approvedSummary;
1677
+ let summaryMeta;
1678
+ if (workflow === "auto-summary") {
1679
+ if (!ctx) {
1680
+ return {
1681
+ content: [{ type: "text", text: "Error: Auto-summary requires an active extension context." }],
1682
+ details: { error: "Missing extension context" },
1683
+ };
1684
+ }
1685
+ onUpdate?.({
1686
+ content: [{ type: "text", text: "Generating summary..." }],
1687
+ details: { phase: "generating-summary", progress: 1 },
1688
+ });
1689
+ const summaryContext = {
1690
+ model: ctx.model,
1691
+ modelRegistry: ctx.modelRegistry,
1692
+ cwd: ctx.cwd,
1693
+ isProjectTrusted: () => ctx.isProjectTrusted(),
1694
+ };
1695
+ const summaryModelChoices = await loadSummaryModelChoices(summaryContext);
1696
+ const generated = await generateSummaryDraft(searchResults, summaryContext, signal, summaryModelChoices.defaultSummaryModel ?? undefined, undefined, undefined, getSummaryGenerationDeadlineMs());
1697
+ approvedSummary = generated.summary;
1698
+ summaryMeta = generated.meta;
1699
+ }
1700
+ return buildSearchReturn({
1701
+ queryList,
1702
+ results: searchResults,
1703
+ urls: allUrls,
1704
+ includeContent: params.includeContent ?? false,
1705
+ inlineContent: allInlineContent.length > 0 ? allInlineContent : undefined,
1706
+ workflow: workflow === "auto-summary" ? "auto-summary" : undefined,
1707
+ approvedSummary,
1708
+ summaryMeta,
1709
+ });
1710
+ },
1711
+ renderCall(args, theme) {
1712
+ const input = args;
1713
+ const rawQueryList = Array.isArray(input.queries)
1714
+ ? input.queries
1715
+ : (input.query !== undefined ? [input.query] : []);
1716
+ const queryList = normalizeQueryList(rawQueryList);
1717
+ if (queryList.length === 0) {
1718
+ return new Text(theme.fg("toolTitle", theme.bold("search ")) + theme.fg("error", "(no query)"), 0, 0);
1719
+ }
1720
+ if (queryList.length === 1) {
1721
+ const q = queryList[0];
1722
+ const display = q.length > 60 ? q.slice(0, 57) + "..." : q;
1723
+ return new Text(theme.fg("toolTitle", theme.bold("search ")) + theme.fg("accent", `"${display}"`), 0, 0);
1724
+ }
1725
+ const lines = [theme.fg("toolTitle", theme.bold("search ")) + theme.fg("accent", `${queryList.length} queries`)];
1726
+ for (const q of queryList.slice(0, 5)) {
1727
+ const display = q.length > 50 ? q.slice(0, 47) + "..." : q;
1728
+ lines.push(theme.fg("muted", ` "${display}"`));
1729
+ }
1730
+ if (queryList.length > 5) {
1731
+ lines.push(theme.fg("muted", ` ... and ${queryList.length - 5} more`));
1732
+ }
1733
+ return new Text(lines.join("\n"), 0, 0);
1734
+ },
1735
+ renderResult(result, { expanded, isPartial }, theme) {
1736
+ const details = result.details;
1737
+ if (isPartial) {
1738
+ if (details?.phase === "curator-fallback") {
1739
+ const lines = [theme.fg("warning", "Open the search curator manually:")];
1740
+ if (details?.curatorUrl)
1741
+ lines.push(theme.fg("muted", ` ${details.curatorUrl}`));
1742
+ if (details?.browserOpenError)
1743
+ lines.push(theme.fg("dim", ` auto-open failed: ${details.browserOpenError}`));
1744
+ const timeout = typeof details?.timeoutSeconds === "number" ? details.timeoutSeconds : undefined;
1745
+ const shortcut = typeof details?.shortcut === "string" ? details.shortcut : curateKey;
1746
+ lines.push(theme.fg("dim", timeout ? ` auto-submits after ${timeout}s idle; ${shortcut} reopens` : ` ${shortcut} reopens`));
1747
+ return new Text(lines.join("\n"), 0, 0);
1748
+ }
1749
+ if (details?.phase === "curating" || details?.phase === "waiting-for-approval" || details?.phase === "generating-summary") {
1750
+ const phaseText = details?.phase === "generating-summary"
1751
+ ? "generating summary draft..."
1752
+ : details?.phase === "waiting-for-approval"
1753
+ ? "summary draft ready; approve in browser..."
1754
+ : "waiting for summary approval in browser...";
1755
+ const lines = [theme.fg("accent", phaseText)];
1756
+ if (details?.curatorUrl) {
1757
+ lines.push(theme.fg("muted", ` ${details.curatorUrl}`));
1758
+ }
1759
+ const timeout = typeof details?.timeoutSeconds === "number" ? details.timeoutSeconds : undefined;
1760
+ const shortcut = typeof details?.shortcut === "string" ? details.shortcut : curateKey;
1761
+ if (timeout) {
1762
+ lines.push(theme.fg("dim", ` auto-submits after ${timeout}s idle; ${shortcut} reopens`));
1763
+ }
1764
+ else {
1765
+ lines.push(theme.fg("dim", ` ${shortcut} reopens`));
1766
+ }
1767
+ return new Text(lines.join("\n"), 0, 0);
1768
+ }
1769
+ if (details?.phase === "searching") {
1770
+ const progress = details?.progress ?? 0;
1771
+ const bar = "\u2588".repeat(Math.floor(progress * 10)) + "\u2591".repeat(10 - Math.floor(progress * 10));
1772
+ const query = details?.currentQuery || "";
1773
+ const display = query.length > 40 ? query.slice(0, 37) + "..." : query;
1774
+ return new Text(theme.fg("accent", `[${bar}] ${display}`), 0, 0);
1775
+ }
1776
+ const progress = details?.progress ?? 0;
1777
+ const bar = "\u2588".repeat(Math.floor(progress * 10)) + "\u2591".repeat(10 - Math.floor(progress * 10));
1778
+ return new Text(theme.fg("accent", `[${bar}] ${details?.phase || "searching"}`), 0, 0);
1779
+ }
1780
+ if (details?.error) {
1781
+ // Expandable Ctrl+O diagnostics: which queries completed, per-query errors,
1782
+ // browser connection state, cancel reason. See render-search-error.ts.
1783
+ const plan = buildSearchErrorPlan(details);
1784
+ if (plan)
1785
+ return renderSearchErrorPlan(plan, expanded, theme);
1786
+ return new Text(theme.fg("error", `Error: ${details.error}`), 0, 0);
1787
+ }
1788
+ let statusLine;
1789
+ const queryInfo = details?.queryCount === 1 ? "" : `${details?.successfulQueries}/${details?.queryCount} queries, `;
1790
+ statusLine = theme.fg("success", `${queryInfo}${details?.totalResults ?? 0} sources`);
1791
+ if (details?.curated && details?.curatedFrom) {
1792
+ statusLine += theme.fg("muted", ` (${details.queryCount}/${details.curatedFrom} queries curated)`);
1793
+ }
1794
+ if (details?.fetchId && details?.fetchUrls) {
1795
+ statusLine += theme.fg("muted", ` (fetching ${details.fetchUrls.length} URLs)`);
1796
+ }
1797
+ else if (details?.fetchId) {
1798
+ statusLine += theme.fg("muted", " (content ready)");
1799
+ }
1800
+ // Build expanded lines first so collapsed view can reference total count
1801
+ const lines = [statusLine];
1802
+ if (details?.summary?.text) {
1803
+ lines.push("");
1804
+ lines.push(theme.fg("accent", `── Summary (${details.summary.workflow}) ` + "─".repeat(32)));
1805
+ lines.push("");
1806
+ for (const line of details.summary.text.split("\n")) {
1807
+ lines.push(` ${line}`);
1808
+ }
1809
+ lines.push("");
1810
+ const metaParts = [
1811
+ details.summary.model ? `model=${details.summary.model}` : "model=deterministic",
1812
+ `duration=${details.summary.durationMs}ms`,
1813
+ `tokens~${details.summary.tokenEstimate}`,
1814
+ details.summary.fallbackUsed ? "fallback=true" : "fallback=false",
1815
+ details.summary.phase ? `phase=${details.summary.phase}` : "",
1816
+ details.summary.edited ? "edited=true" : "edited=false",
1817
+ ];
1818
+ if (details.summary.fallbackReason) {
1819
+ metaParts.push(`reason=${details.summary.fallbackReason}`);
1820
+ }
1821
+ lines.push(theme.fg("dim", " " + metaParts.filter(Boolean).join(" · ")));
1822
+ }
1823
+ const queryDetails = details?.curatedQueries;
1824
+ if (queryDetails?.length) {
1825
+ const kept = queryDetails.length;
1826
+ const from = details?.curatedFrom ?? kept;
1827
+ lines.push("");
1828
+ lines.push(theme.fg("accent", `\u2500\u2500 Curated Results (${kept} of ${from} queries kept) ` + "\u2500".repeat(24)));
1829
+ for (const cq of queryDetails) {
1830
+ lines.push("");
1831
+ const dq = cq.query.length > 65 ? cq.query.slice(0, 62) + "..." : cq.query;
1832
+ const providerLabel = cq.provider ? ` (${cq.provider})` : "";
1833
+ lines.push(theme.fg("accent", ` "${dq}"${providerLabel}`));
1834
+ if (cq.error) {
1835
+ lines.push(theme.fg("error", ` ${cq.error}`));
1836
+ }
1837
+ else if (cq.answer) {
1838
+ lines.push("");
1839
+ for (const line of cq.answer.split("\n")) {
1840
+ lines.push(` ${line}`);
1841
+ }
1842
+ }
1843
+ if (cq.sources.length > 0) {
1844
+ lines.push("");
1845
+ for (const s of cq.sources) {
1846
+ const domain = s.url.replace(/^https?:\/\//, "").replace(/\/.*$/, "");
1847
+ const title = s.title.length > 50 ? s.title.slice(0, 47) + "..." : s.title;
1848
+ lines.push(theme.fg("muted", ` \u25b8 ${title}`) + theme.fg("dim", ` \u00b7 ${domain}`));
1849
+ }
1850
+ }
1851
+ }
1852
+ lines.push("");
1853
+ }
1854
+ else {
1855
+ const textContent = result.content.find((c) => c.type === "text")?.text || "";
1856
+ const preview = textContent.length > 500 ? textContent.slice(0, 500) + "..." : textContent;
1857
+ for (const line of preview.split("\n")) {
1858
+ lines.push(theme.fg("dim", line));
1859
+ }
1860
+ }
1861
+ if (details?.fetchUrls && details.fetchUrls.length > 0) {
1862
+ if (details.curated) {
1863
+ lines.push(theme.fg("muted", `Fetching ${details.fetchUrls.length} URLs in background`));
1864
+ }
1865
+ else {
1866
+ lines.push(theme.fg("muted", "Fetching:"));
1867
+ for (const u of details.fetchUrls.slice(0, 5)) {
1868
+ const display = u.length > 60 ? u.slice(0, 57) + "..." : u;
1869
+ lines.push(theme.fg("dim", " " + display));
1870
+ }
1871
+ if (details.fetchUrls.length > 5) {
1872
+ lines.push(theme.fg("dim", ` ... and ${details.fetchUrls.length - 5} more`));
1873
+ }
1874
+ }
1875
+ }
1876
+ const totalLines = lines.length;
1877
+ if (!expanded) {
1878
+ const box = new Box(1, 0);
1879
+ box.addChild(new Text(statusLine, 0, 0));
1880
+ let collapsedLines = 1; // statusLine
1881
+ const summaryPreview = details?.summary?.text?.trim() || "";
1882
+ if (summaryPreview) {
1883
+ const preview = summaryPreview.length > 120 ? summaryPreview.slice(0, 117) + "..." : summaryPreview;
1884
+ box.addChild(new Text(theme.fg("dim", preview), 0, 0));
1885
+ collapsedLines++;
1886
+ }
1887
+ else if (details?.curatedQueries?.length) {
1888
+ for (const cq of details.curatedQueries.slice(0, 3)) {
1889
+ const dq = cq.query.length > 55 ? cq.query.slice(0, 52) + "..." : cq.query;
1890
+ const srcCount = cq.sources?.length ?? 0;
1891
+ const suffix = cq.error ? theme.fg("error", " (error)") : theme.fg("dim", ` · ${srcCount} sources`);
1892
+ box.addChild(new Text(theme.fg("accent", ` "${dq}"`) + suffix, 0, 0));
1893
+ collapsedLines++;
1894
+ }
1895
+ if (details.curatedQueries.length > 3) {
1896
+ box.addChild(new Text(theme.fg("dim", ` ... and ${details.curatedQueries.length - 3} more`), 0, 0));
1897
+ collapsedLines++;
1898
+ }
1899
+ }
1900
+ else {
1901
+ const textContent = result.content.find((c) => c.type === "text")?.text || "";
1902
+ const firstContentLine = textContent.split("\n").find(l => {
1903
+ const t = l.trim();
1904
+ return t && !t.startsWith("[") && !t.startsWith("#") && !t.startsWith("---");
1905
+ });
1906
+ const fallbackLine = (firstContentLine?.trim() || "").replace(/\*\*/g, "");
1907
+ if (fallbackLine) {
1908
+ const preview = fallbackLine.length > 120 ? fallbackLine.slice(0, 117) + "..." : fallbackLine;
1909
+ box.addChild(new Text(theme.fg("dim", preview), 0, 0));
1910
+ collapsedLines++;
1911
+ }
1912
+ }
1913
+ const moreLines = Math.max(0, totalLines - collapsedLines);
1914
+ if (moreLines > 0) {
1915
+ box.addChild(new Text(theme.fg("muted", `\n... (${moreLines} more lines, ${totalLines} total, ctrl+o to expand)`), 0, 0));
1916
+ }
1917
+ return box;
1918
+ }
1919
+ return new Text(lines.join("\n"), 0, 0);
1920
+ },
1921
+ });
1922
+ if (sourceCheckEnabled)
1923
+ pi.registerTool({
1924
+ name: toolNames.sourceCheck,
1925
+ label: "Source Check",
1926
+ description: "Check a claim against web sources and return a bounded machine-readable research artifact with exact passage citations.",
1927
+ promptSnippet: "Verify a claim with structured source evidence and passage-level citations.",
1928
+ parameters: Type.Object({
1929
+ claim: Type.String({ description: "The assertion to check against web sources." }),
1930
+ queries: Type.Optional(Type.Array(Type.String(), { description: "Search queries (default: the claim)." })),
1931
+ numResults: Type.Optional(Type.Number({ description: "Results per query (default: 5, max: 20)." })),
1932
+ fetchContent: Type.Optional(Type.Boolean({ description: "Fetch up to 5 result pages for exact passage extraction." })),
1933
+ recencyFilter: Type.Optional(StringEnum(["day", "week", "month", "year"], { description: "Filter by recency." })),
1934
+ domainFilter: Type.Optional(Type.Array(Type.String(), { description: "Limit to domains; prefix with - to exclude." })),
1935
+ provider: Type.Optional(searchProviderSchema("Search provider or non-empty list of providers to search simultaneously; all searches every eligible provider except DuckDuckGo, AnySearch, xAI, Bright Data, and SerpBase")),
1936
+ }),
1937
+ async execute(_callId, params, signal, _onUpdate, ctx) {
1938
+ const claim = typeof params.claim === "string" ? params.claim.trim() : "";
1939
+ if (!claim) {
1940
+ return { content: [{ type: "text", text: "Error: 'claim' is required." }], details: { error: "Missing claim" } };
1941
+ }
1942
+ const requestedQueries = Array.isArray(params.queries)
1943
+ ? params.queries.filter((query) => typeof query === "string").map((query) => query.trim()).filter(Boolean)
1944
+ : [];
1945
+ const queries = (requestedQueries.length > 0 ? requestedQueries : [claim]).slice(0, 8);
1946
+ const numResults = typeof params.numResults === "number" && Number.isFinite(params.numResults)
1947
+ ? Math.min(20, Math.max(1, Math.floor(params.numResults)))
1948
+ : 5;
1949
+ const domainFilter = Array.isArray(params.domainFilter)
1950
+ ? params.domainFilter.filter((domain) => typeof domain === "string")
1951
+ : undefined;
1952
+ const recencyFilter = normalizeRecencyFilter(params.recencyFilter);
1953
+ const resultsByUrl = new Map();
1954
+ const summaries = [];
1955
+ const errors = [];
1956
+ let provider;
1957
+ for (const query of queries) {
1958
+ if (signal?.aborted)
1959
+ break;
1960
+ try {
1961
+ const response = await search(query, {
1962
+ provider: resolveRequestedProvider(params.provider),
1963
+ numResults,
1964
+ recencyFilter,
1965
+ domainFilter,
1966
+ signal,
1967
+ extensionContext: ctx,
1968
+ });
1969
+ if (signal?.aborted)
1970
+ break;
1971
+ provider ??= response.provider;
1972
+ if (response.answer)
1973
+ summaries.push(`${query}: ${response.answer}`);
1974
+ for (const result of response.results) {
1975
+ if (!resultsByUrl.has(result.url))
1976
+ resultsByUrl.set(result.url, result);
1977
+ }
1978
+ }
1979
+ catch (err) {
1980
+ if (signal?.aborted || isAbortError(err))
1981
+ break;
1982
+ errors.push({ query, error: err instanceof Error ? err.message : String(err) });
1983
+ }
1984
+ }
1985
+ const results = [...resultsByUrl.values()].slice(0, 20).map((result, index) => ({ ...result, rank: index + 1 }));
1986
+ let fetched = [];
1987
+ if (params.fetchContent && results.length > 0) {
1988
+ const urls = results.slice(0, 5).map((result) => result.url);
1989
+ try {
1990
+ fetched = await fetchAllContent(urls, signal);
1991
+ }
1992
+ catch (err) {
1993
+ if (signal?.aborted || isAbortError(err))
1994
+ throw err;
1995
+ fetched = urls.map((url) => ({ url, title: "", content: "", error: err instanceof Error ? err.message : String(err) }));
1996
+ }
1997
+ }
1998
+ const artifact = withClaimAssessment(buildResearchArtifact({
1999
+ query: claim,
2000
+ provider,
2001
+ summary: summaries.length > 0 ? summaries.join("\n\n") : undefined,
2002
+ results,
2003
+ fetched,
2004
+ recency: recencyFilter,
2005
+ domainFilter,
2006
+ }), [claim]);
2007
+ if (errors.length > 0)
2008
+ artifact.errors = errors;
2009
+ storeResearchArtifact(artifact);
2010
+ pi.appendEntry("web-search-results", {
2011
+ id: artifact.id,
2012
+ type: "research",
2013
+ timestamp: artifact.timestamp,
2014
+ artifact,
2015
+ });
2016
+ return {
2017
+ content: [{ type: "text", text: formatSourceCheckResult(artifact, getSearchContentEnabled ? toolNames.getSearchContent : null) }],
2018
+ details: { responseId: artifact.id, artifact, sourceCount: artifact.sources.length, passageCount: artifact.passages.length },
2019
+ };
2020
+ },
2021
+ });
2022
+ if (fetchContentEnabled)
2023
+ pi.registerTool({
2024
+ name: toolNames.fetchContent,
2025
+ label: "Fetch Content",
2026
+ description: `Fetch URL(s) and extract readable content as markdown. Use mode "raw" for exact textual HTTP response bodies or mode "answer" with prompt to answer using only fetched content. Direct image URLs return resized image content. Supports YouTube transcripts, GitHub repositories, PDFs, and local videos. ${fetchContentStorageNote}`,
2027
+ promptSnippet: "Use to fetch readable or raw URL content, direct images, GitHub repos, and videos. Mode answer answers a prompt using only the fetched source.",
2028
+ parameters: Type.Object({
2029
+ url: Type.Optional(Type.String({ description: "Single URL to fetch" })),
2030
+ urls: Type.Optional(Type.Array(Type.String(), { description: "Multiple URLs (parallel)" })),
2031
+ forceClone: Type.Optional(Type.Boolean({
2032
+ description: "Force cloning large GitHub repositories that exceed the size threshold",
2033
+ })),
2034
+ prompt: Type.Optional(Type.String({
2035
+ description: "Question or instruction for video analysis, or the page-local question required by mode answer.",
2036
+ })),
2037
+ mode: Type.Optional(StringEnum(["readable", "raw", "answer"], {
2038
+ description: "Fetch mode: readable (default extraction), raw (exact textual HTTP body), or answer (answer prompt using only fetched content).",
2039
+ })),
2040
+ answerModel: Type.Optional(Type.String({
2041
+ description: "Optional provider/model-id override for mode answer. Defaults to the current Pi model.",
2042
+ })),
2043
+ timestamp: Type.Optional(Type.String({
2044
+ description: "Extract video frame(s) at a timestamp or time range. Single: '1:23:45', '23:45', or '85' (seconds). Range: '23:41-25:00' extracts evenly-spaced frames across that span (default 6). Use frames with ranges to control density; single+frames uses a fixed 5s interval. YouTube requires yt-dlp + ffmpeg; local videos require ffmpeg. Use a range when you know the approximate area but not the exact moment — you'll get a contact sheet to visually identify the right frame.",
2045
+ })),
2046
+ frames: Type.Optional(Type.Integer({
2047
+ minimum: 1,
2048
+ maximum: 12,
2049
+ description: "Number of frames to extract. Use with timestamp range for custom density, with single timestamp to get N frames at 5s intervals, or alone to sample across the entire video. Requires yt-dlp + ffmpeg for YouTube, ffmpeg for local video.",
2050
+ })),
2051
+ model: Type.Optional(Type.String({
2052
+ description: "Override the Gemini model for video/YouTube analysis (e.g. 'gemini-3.6-flash'). Defaults to config or gemini-3.6-flash.",
2053
+ })),
2054
+ }),
2055
+ async execute(_toolCallId, params, signal, onUpdate, ctx) {
2056
+ let normalized;
2057
+ try {
2058
+ normalized = normalizeFetchContentParams(params);
2059
+ }
2060
+ catch (err) {
2061
+ const error = err instanceof Error ? err.message : String(err);
2062
+ return { content: [{ type: "text", text: `Error: ${error}` }], details: { error } };
2063
+ }
2064
+ const { urlList, options } = normalized;
2065
+ const mode = options.mode ?? "readable";
2066
+ if (mode === "answer" && !options.prompt) {
2067
+ return { content: [{ type: "text", text: "Error: mode answer requires prompt." }], details: { error: "mode answer requires prompt" } };
2068
+ }
2069
+ if (mode === "raw" && (options.forceClone === true || options.timestamp || options.frames || options.prompt || options.model || options.answerModel)) {
2070
+ return { content: [{ type: "text", text: "Error: mode raw cannot be combined with forceClone, prompt, timestamp, frames, model, or answerModel." }], details: { error: "Incompatible raw mode options" } };
2071
+ }
2072
+ if (mode !== "answer" && options.answerModel) {
2073
+ return { content: [{ type: "text", text: "Error: answerModel requires mode answer." }], details: { error: "answerModel requires mode answer" } };
2074
+ }
2075
+ if (mode === "answer" && options.model) {
2076
+ return { content: [{ type: "text", text: "Error: use answerModel, not model, with mode answer." }], details: { error: "model is incompatible with mode answer" } };
2077
+ }
2078
+ if (urlList.length === 0) {
2079
+ return {
2080
+ content: [{ type: "text", text: "Error: No URL provided." }],
2081
+ details: { error: "No URL provided" },
2082
+ };
2083
+ }
2084
+ onUpdate?.({
2085
+ content: [{ type: "text", text: `Fetching ${urlList.length} URL(s)...` }],
2086
+ details: { phase: "fetch", progress: 0 },
2087
+ });
2088
+ const { answerModel: _answerModel, ...extractionOptions } = options;
2089
+ const fetchOptions = mode === "answer"
2090
+ ? (() => {
2091
+ const { prompt: _prompt, ...rest } = extractionOptions;
2092
+ return rest;
2093
+ })()
2094
+ : extractionOptions;
2095
+ const fetchResults = await fetchAllContent(urlList, signal, fetchOptions);
2096
+ const presentedResults = mode === "answer"
2097
+ ? await Promise.all(fetchResults.map(async result => {
2098
+ if (result.error)
2099
+ return result;
2100
+ if (result.thumbnail || result.mimeType?.startsWith("image/")) {
2101
+ return { ...result, error: "Page answer requires textual fetched content" };
2102
+ }
2103
+ try {
2104
+ const answer = await answerFromPage({
2105
+ question: options.prompt,
2106
+ pageText: result.content,
2107
+ sourceUrl: result.url,
2108
+ ...(options.answerModel ? { model: options.answerModel } : {}),
2109
+ }, ctx, signal);
2110
+ return { ...result, content: answer.text };
2111
+ }
2112
+ catch (err) {
2113
+ return { ...result, error: `Page answer failed: ${err instanceof Error ? err.message : String(err)}` };
2114
+ }
2115
+ }))
2116
+ : fetchResults;
2117
+ const successful = presentedResults.filter((r) => !r.error).length;
2118
+ const totalChars = presentedResults.reduce((sum, r) => sum + r.content.length, 0);
2119
+ // ALWAYS store results (even for single URL)
2120
+ const responseId = generateId();
2121
+ const data = {
2122
+ id: responseId,
2123
+ type: "fetch",
2124
+ timestamp: Date.now(),
2125
+ urls: stripThumbnails(fetchResults),
2126
+ };
2127
+ pi.appendEntry("web-search-results", storeFetchedContentResult(responseId, data));
2128
+ // Single URL: return content directly (possibly truncated) with responseId
2129
+ if (urlList.length === 1) {
2130
+ const result = presentedResults[0];
2131
+ if (result.error) {
2132
+ return {
2133
+ content: [{ type: "text", text: `Error: ${result.error}` }],
2134
+ details: { urls: urlList, urlCount: 1, successful: 0, error: result.error, responseId, prompt: params.prompt, timestamp: params.timestamp, frames: params.frames },
2135
+ };
2136
+ }
2137
+ const fullLength = result.content.length;
2138
+ const slice = initialContentSlice(result.content, getMaxInlineContentChars());
2139
+ const truncated = slice.endOffset < fullLength;
2140
+ let output = slice.text;
2141
+ if (truncated) {
2142
+ output += `\n\n---\nShowing ${slice.endOffset} of ${fullLength} chars, ${slice.shownBytes} of ${slice.totalBytes} bytes, and ${slice.shownLines} of ${slice.totalLines} lines. `;
2143
+ output += getSearchContentEnabled
2144
+ ? `Use ${toolNames.getSearchContent}({ responseId: "${responseId}", urlIndex: 0, offset: ${slice.endOffset} }) for the next slice.`
2145
+ : "Content retrieval is not registered.";
2146
+ }
2147
+ const content = [];
2148
+ if (result.frames?.length) {
2149
+ for (const frame of result.frames) {
2150
+ content.push({ type: "image", data: frame.data, mimeType: frame.mimeType });
2151
+ content.push({ type: "text", text: `Frame at ${frame.timestamp}` });
2152
+ }
2153
+ }
2154
+ else if (result.thumbnail) {
2155
+ content.push({ type: "image", data: result.thumbnail.data, mimeType: result.thumbnail.mimeType });
2156
+ }
2157
+ content.push({ type: "text", text: output });
2158
+ const imageCount = (result.frames?.length ?? 0) + (result.thumbnail ? 1 : 0);
2159
+ return {
2160
+ content,
2161
+ details: {
2162
+ urls: urlList,
2163
+ urlCount: 1,
2164
+ successful: 1,
2165
+ totalChars: fullLength,
2166
+ title: result.title,
2167
+ responseId,
2168
+ truncated,
2169
+ hasImage: imageCount > 0,
2170
+ imageCount,
2171
+ prompt: params.prompt,
2172
+ timestamp: params.timestamp,
2173
+ frames: params.frames,
2174
+ duration: result.duration,
2175
+ mode,
2176
+ mimeType: result.mimeType,
2177
+ status: result.status,
2178
+ totalBytes: slice.totalBytes,
2179
+ totalLines: slice.totalLines,
2180
+ shownBytes: slice.shownBytes,
2181
+ shownLines: slice.shownLines,
2182
+ },
2183
+ };
2184
+ }
2185
+ // Multi-URL: existing behavior (summary + responseId)
2186
+ let output = "## Fetched URLs\n\n";
2187
+ for (const { url, title, content, error } of presentedResults) {
2188
+ if (error) {
2189
+ output += `- ${url}: Error - ${error}\n`;
2190
+ }
2191
+ else {
2192
+ output += `- ${title || url} (${content.length} chars)\n`;
2193
+ }
2194
+ }
2195
+ output += getSearchContentEnabled
2196
+ ? `\n---\nUse ${toolNames.getSearchContent}({ responseId: "${responseId}", urlIndex: 0 }) to retrieve bounded content slices.`
2197
+ : "\n---\nContent retrieval is not registered.";
2198
+ return {
2199
+ content: [{ type: "text", text: output }],
2200
+ details: { urls: urlList, urlCount: urlList.length, successful, totalChars, responseId },
2201
+ };
2202
+ },
2203
+ renderCall(args, theme) {
2204
+ const { urlList, options } = normalizeFetchContentParams(args);
2205
+ const { prompt, timestamp, frames, model, mode, answerModel } = options;
2206
+ if (urlList.length === 0) {
2207
+ return new Text(theme.fg("toolTitle", theme.bold("fetch ")) + theme.fg("error", "(no URL)"), 0, 0);
2208
+ }
2209
+ const lines = [];
2210
+ if (urlList.length === 1) {
2211
+ const display = urlList[0].length > 60 ? urlList[0].slice(0, 57) + "..." : urlList[0];
2212
+ lines.push(theme.fg("toolTitle", theme.bold("fetch ")) + theme.fg("accent", display));
2213
+ }
2214
+ else {
2215
+ lines.push(theme.fg("toolTitle", theme.bold("fetch ")) + theme.fg("accent", `${urlList.length} URLs`));
2216
+ for (const u of urlList.slice(0, 5)) {
2217
+ const display = u.length > 60 ? u.slice(0, 57) + "..." : u;
2218
+ lines.push(theme.fg("muted", " " + display));
2219
+ }
2220
+ if (urlList.length > 5) {
2221
+ lines.push(theme.fg("muted", ` ... and ${urlList.length - 5} more`));
2222
+ }
2223
+ }
2224
+ if (mode && mode !== "readable") {
2225
+ lines.push(theme.fg("dim", " mode: ") + theme.fg("warning", mode));
2226
+ }
2227
+ if (timestamp) {
2228
+ lines.push(theme.fg("dim", " timestamp: ") + theme.fg("warning", timestamp));
2229
+ }
2230
+ if (typeof frames === "number") {
2231
+ lines.push(theme.fg("dim", " frames: ") + theme.fg("warning", String(frames)));
2232
+ }
2233
+ if (prompt) {
2234
+ const display = prompt.length > 250 ? prompt.slice(0, 247) + "..." : prompt;
2235
+ lines.push(theme.fg("dim", " prompt: ") + theme.fg("muted", `"${display}"`));
2236
+ }
2237
+ if (model) {
2238
+ lines.push(theme.fg("dim", " model: ") + theme.fg("warning", model));
2239
+ }
2240
+ if (answerModel) {
2241
+ lines.push(theme.fg("dim", " answer model: ") + theme.fg("warning", answerModel));
2242
+ }
2243
+ return new Text(lines.join("\n"), 0, 0);
2244
+ },
2245
+ renderResult(result, { expanded, isPartial }, theme) {
2246
+ const details = result.details;
2247
+ if (isPartial) {
2248
+ const progress = details?.progress ?? 0;
2249
+ const bar = "\u2588".repeat(Math.floor(progress * 10)) + "\u2591".repeat(10 - Math.floor(progress * 10));
2250
+ return new Text(theme.fg("accent", `[${bar}] ${details?.phase || "fetching"}`), 0, 0);
2251
+ }
2252
+ if (details?.error) {
2253
+ const fd = details;
2254
+ const extras = [];
2255
+ if (typeof fd.urlCount === "number" || typeof fd.successful === "number") {
2256
+ extras.push(`urls: ${fd.successful ?? 0}/${fd.urlCount ?? 0} succeeded`);
2257
+ }
2258
+ if (fd.responseId)
2259
+ extras.push(`response id: ${fd.responseId}`);
2260
+ if (fd.urls && fd.urls.length > 0) {
2261
+ for (const u of fd.urls.slice(0, 8))
2262
+ extras.push(` \u25b8 ${u}`);
2263
+ if (fd.urls.length > 8)
2264
+ extras.push(` ... and ${fd.urls.length - 8} more`);
2265
+ }
2266
+ const plan = buildSearchErrorPlan({ error: details.error, extraLines: extras });
2267
+ if (plan)
2268
+ return renderSearchErrorPlan(plan, expanded, theme);
2269
+ return new Text(theme.fg("error", `Error: ${details.error}`), 0, 0);
2270
+ }
2271
+ if (details?.urlCount === 1) {
2272
+ const title = details?.title || "Untitled";
2273
+ const imgCount = details?.imageCount ?? (details?.hasImage ? 1 : 0);
2274
+ const imageBadge = imgCount > 1
2275
+ ? theme.fg("accent", ` [${imgCount} images]`)
2276
+ : imgCount === 1
2277
+ ? theme.fg("accent", " [image]")
2278
+ : "";
2279
+ let statusLine = theme.fg("success", title) + theme.fg("muted", ` (${details?.totalChars ?? 0} chars)`) + imageBadge;
2280
+ if (details?.truncated) {
2281
+ statusLine += theme.fg("warning", " [truncated]");
2282
+ }
2283
+ if (typeof details?.duration === "number") {
2284
+ statusLine += theme.fg("muted", ` | ${formatSeconds(Math.floor(details.duration))} total`);
2285
+ }
2286
+ const textContent = result.content.find((c) => c.type === "text")?.text || "";
2287
+ if (!expanded) {
2288
+ const brief = textContent.length > 200 ? textContent.slice(0, 200) + "..." : textContent;
2289
+ return new Text(statusLine + "\n" + theme.fg("dim", brief), 0, 0);
2290
+ }
2291
+ const lines = [statusLine];
2292
+ if (details?.prompt) {
2293
+ const display = details.prompt.length > 250 ? details.prompt.slice(0, 247) + "..." : details.prompt;
2294
+ lines.push(theme.fg("dim", ` prompt: "${display}"`));
2295
+ }
2296
+ if (details?.timestamp) {
2297
+ lines.push(theme.fg("dim", ` timestamp: ${details.timestamp}`));
2298
+ }
2299
+ if (typeof details?.frames === "number") {
2300
+ lines.push(theme.fg("dim", ` frames: ${details.frames}`));
2301
+ }
2302
+ const preview = textContent.length > 500 ? textContent.slice(0, 500) + "..." : textContent;
2303
+ lines.push(theme.fg("dim", preview));
2304
+ return new Text(lines.join("\n"), 0, 0);
2305
+ }
2306
+ const countColor = (details?.successful ?? 0) > 0 ? "success" : "error";
2307
+ const statusLine = theme.fg(countColor, `${details?.successful}/${details?.urlCount} URLs`) + theme.fg("muted", getSearchContentEnabled ? " (content stored)" : " (content fetched)");
2308
+ if (!expanded) {
2309
+ return new Text(statusLine, 0, 0);
2310
+ }
2311
+ const textContent = result.content.find((c) => c.type === "text")?.text || "";
2312
+ const preview = textContent.length > 500 ? textContent.slice(0, 500) + "..." : textContent;
2313
+ return new Text(statusLine + "\n" + theme.fg("dim", preview), 0, 0);
2314
+ },
2315
+ });
2316
+ if (getSearchContentEnabled)
2317
+ pi.registerTool({
2318
+ name: toolNames.getSearchContent,
2319
+ label: "Get Search Content",
2320
+ description: `Retrieve bounded content slices or find matching passages in a previous ${storedContentSources} call.`,
2321
+ promptSnippet: `Use after ${storedContentSources} to retrieve stored content via responseId. Use findText to locate passages without paging through the full content.`,
2322
+ parameters: Type.Object({
2323
+ responseId: Type.String({ description: `The responseId from ${storedContentSources}` }),
2324
+ query: Type.Optional(Type.String({ description: searchQueryDescription })),
2325
+ queryIndex: Type.Optional(Type.Number({ description: "Get content for query at index" })),
2326
+ url: Type.Optional(Type.String({ description: "Get content for this URL" })),
2327
+ urlIndex: Type.Optional(Type.Number({ description: "Get content for URL at index" })),
2328
+ offset: Type.Optional(Type.Number({ description: "Character offset for fetched URL content slices (default 0). Cannot be combined with findText." })),
2329
+ limit: Type.Optional(Type.Number({ description: "Maximum characters to return for fetched URL content slices (default and max are set by maxInlineContentChars). Cannot be combined with findText." })),
2330
+ findText: Type.Optional(Type.Union([
2331
+ Type.String({ minLength: 1, maxLength: 500 }),
2332
+ Type.Array(Type.String({ minLength: 1, maxLength: 500 }), { minItems: 1, maxItems: 10 }),
2333
+ ], { description: "Text or texts to find in the selected stored content. Cannot be combined with offset or limit." })),
2334
+ findMode: Type.Optional(StringEnum(["exact", "case-insensitive", "fuzzy"], { description: "Matching mode for findText (default: case-insensitive). Requires findText." })),
2335
+ }),
2336
+ async execute(_toolCallId, params) {
2337
+ if (params.findText !== undefined && (params.offset !== undefined || params.limit !== undefined)) {
2338
+ return { content: [{ type: "text", text: "findText cannot be combined with offset or limit" }], details: { error: "Incompatible find options" } };
2339
+ }
2340
+ if (params.findMode !== undefined && params.findText === undefined) {
2341
+ return { content: [{ type: "text", text: "findMode requires findText" }], details: { error: "findMode requires findText" } };
2342
+ }
2343
+ const data = getResult(params.responseId);
2344
+ if (!data) {
2345
+ return {
2346
+ content: [{ type: "text", text: `Error: No stored results for "${params.responseId}"` }],
2347
+ details: { error: "Not found", responseId: params.responseId },
2348
+ };
2349
+ }
2350
+ if (data.type === "research") {
2351
+ const artifact = getResearchArtifact(params.responseId);
2352
+ if (!artifact) {
2353
+ return {
2354
+ content: [{ type: "text", text: `Error: artifact ${params.responseId} not found` }],
2355
+ details: { error: "Artifact not found", responseId: params.responseId },
2356
+ };
2357
+ }
2358
+ const serialized = JSON.stringify(artifact, null, 2);
2359
+ const maxInlineContentChars = getMaxInlineContentChars();
2360
+ const offset = params.offset ?? 0;
2361
+ const limit = params.limit ?? maxInlineContentChars;
2362
+ if (!Number.isInteger(offset) || offset < 0) {
2363
+ return { content: [{ type: "text", text: "offset must be a non-negative integer" }], details: { error: "Invalid offset", offset } };
2364
+ }
2365
+ if (!Number.isInteger(limit) || limit <= 0 || limit > maxInlineContentChars) {
2366
+ return { content: [{ type: "text", text: `limit must be an integer from 1 to ${maxInlineContentChars}` }], details: { error: "Invalid limit", limit, maxLimit: maxInlineContentChars } };
2367
+ }
2368
+ if (offset > serialized.length) {
2369
+ return { content: [{ type: "text", text: `offset ${offset} is out of range (0-${serialized.length})` }], details: { error: "Offset out of range", offset, contentLength: serialized.length } };
2370
+ }
2371
+ const endOffset = Math.min(offset + limit, serialized.length);
2372
+ const artifactSlice = serialized.slice(offset, endOffset);
2373
+ const hasMore = endOffset < serialized.length;
2374
+ return {
2375
+ content: [{ type: "text", text: artifactSlice }],
2376
+ details: { responseId: artifact.id, type: "research", contentLength: serialized.length, offset, limit, returnedChars: artifactSlice.length, nextOffset: hasMore ? endOffset : null, truncated: hasMore },
2377
+ };
2378
+ }
2379
+ if (data.type === "search" && data.queries) {
2380
+ let queryData;
2381
+ if (params.query !== undefined) {
2382
+ queryData = data.queries.find((q) => q.query === params.query);
2383
+ if (!queryData) {
2384
+ const available = data.queries.map((q) => `"${q.query}"`).join(", ");
2385
+ return {
2386
+ content: [{ type: "text", text: `Query "${params.query}" not found. Available: ${available}` }],
2387
+ details: { error: "Query not found" },
2388
+ };
2389
+ }
2390
+ }
2391
+ else if (params.queryIndex !== undefined) {
2392
+ queryData = data.queries[params.queryIndex];
2393
+ if (!queryData) {
2394
+ return {
2395
+ content: [{ type: "text", text: `Index ${params.queryIndex} out of range (0-${data.queries.length - 1})` }],
2396
+ details: { error: "Index out of range" },
2397
+ };
2398
+ }
2399
+ }
2400
+ else {
2401
+ const available = data.queries.map((q, i) => `${i}: "${q.query}"`).join(", ");
2402
+ return {
2403
+ content: [{ type: "text", text: `Specify query or queryIndex. Available: ${available}` }],
2404
+ details: { error: "No query specified" },
2405
+ };
2406
+ }
2407
+ if (queryData.error) {
2408
+ return {
2409
+ content: [{ type: "text", text: `Error for "${queryData.query}": ${queryData.error}` }],
2410
+ details: { error: queryData.error, query: queryData.query },
2411
+ };
2412
+ }
2413
+ const fullResults = formatFullResults(queryData);
2414
+ if (params.findText !== undefined) {
2415
+ try {
2416
+ const found = findContent(fullResults, normalizeFindQueries(params.findText), (params.findMode ?? "case-insensitive"));
2417
+ const { text, ...findDetails } = found;
2418
+ return {
2419
+ content: [{ type: "text", text }],
2420
+ details: { query: queryData.query, resultCount: queryData.results.length, findMode: params.findMode ?? "case-insensitive", ...findDetails },
2421
+ };
2422
+ }
2423
+ catch (err) {
2424
+ const error = err instanceof Error ? err.message : String(err);
2425
+ return { content: [{ type: "text", text: error }], details: { error, query: queryData.query } };
2426
+ }
2427
+ }
2428
+ return {
2429
+ content: [{ type: "text", text: fullResults }],
2430
+ details: { query: queryData.query, resultCount: queryData.results.length },
2431
+ };
2432
+ }
2433
+ if (data.type === "fetch" && data.urls) {
2434
+ let urlData;
2435
+ let selectedUrlIndex = -1;
2436
+ if (params.url !== undefined) {
2437
+ selectedUrlIndex = data.urls.findIndex((u) => u.url === params.url);
2438
+ urlData = data.urls[selectedUrlIndex];
2439
+ if (!urlData) {
2440
+ const available = data.urls.map((u) => u.url).join("\n ");
2441
+ return {
2442
+ content: [{ type: "text", text: `URL not found. Available:\n ${available}` }],
2443
+ details: { error: "URL not found" },
2444
+ };
2445
+ }
2446
+ }
2447
+ else if (params.urlIndex !== undefined) {
2448
+ selectedUrlIndex = params.urlIndex;
2449
+ urlData = data.urls[selectedUrlIndex];
2450
+ if (!urlData) {
2451
+ return {
2452
+ content: [{ type: "text", text: `Index ${params.urlIndex} out of range (0-${data.urls.length - 1})` }],
2453
+ details: { error: "Index out of range" },
2454
+ };
2455
+ }
2456
+ }
2457
+ else {
2458
+ const available = data.urls.map((u, i) => `${i}: ${u.url}`).join("\n ");
2459
+ return {
2460
+ content: [{ type: "text", text: `Specify url or urlIndex. Available:\n ${available}` }],
2461
+ details: { error: "No URL specified" },
2462
+ };
2463
+ }
2464
+ if (urlData.error) {
2465
+ return {
2466
+ content: [{ type: "text", text: `Error for ${urlData.url}: ${urlData.error}` }],
2467
+ details: { error: urlData.error, url: urlData.url },
2468
+ };
2469
+ }
2470
+ if (params.findText !== undefined) {
2471
+ try {
2472
+ const found = findContent(urlData.content, normalizeFindQueries(params.findText), (params.findMode ?? "case-insensitive"));
2473
+ const { text, ...findDetails } = found;
2474
+ return {
2475
+ content: [{ type: "text", text: `# ${urlData.title || urlData.url}\n\n${text}` }],
2476
+ details: { url: urlData.url, title: urlData.title, contentLength: urlData.content.length, findMode: params.findMode ?? "case-insensitive", ...findDetails },
2477
+ };
2478
+ }
2479
+ catch (err) {
2480
+ const error = err instanceof Error ? err.message : String(err);
2481
+ return { content: [{ type: "text", text: error }], details: { error, url: urlData.url } };
2482
+ }
2483
+ }
2484
+ const maxInlineContentChars = getMaxInlineContentChars();
2485
+ const offset = params.offset ?? 0;
2486
+ const limit = params.limit ?? maxInlineContentChars;
2487
+ if (!Number.isInteger(offset) || offset < 0) {
2488
+ return {
2489
+ content: [{ type: "text", text: "offset must be a non-negative integer" }],
2490
+ details: { error: "Invalid offset", offset },
2491
+ };
2492
+ }
2493
+ if (!Number.isInteger(limit) || limit <= 0 || limit > maxInlineContentChars) {
2494
+ return {
2495
+ content: [{ type: "text", text: `limit must be an integer from 1 to ${maxInlineContentChars}` }],
2496
+ details: { error: "Invalid limit", limit, maxLimit: maxInlineContentChars },
2497
+ };
2498
+ }
2499
+ if (offset > urlData.content.length) {
2500
+ return {
2501
+ content: [{ type: "text", text: `offset ${offset} is out of range (0-${urlData.content.length})` }],
2502
+ details: { error: "Offset out of range", offset, contentLength: urlData.content.length },
2503
+ };
2504
+ }
2505
+ const endOffset = Math.min(offset + limit, urlData.content.length);
2506
+ const contentSlice = urlData.content.slice(offset, endOffset);
2507
+ const hasMore = endOffset < urlData.content.length;
2508
+ let text = `# ${urlData.title || urlData.url}\n\n${contentSlice}`;
2509
+ if (hasMore || offset > 0) {
2510
+ text += `\n\n---\nShowing chars ${offset}-${endOffset} of ${urlData.content.length}.`;
2511
+ if (hasMore) {
2512
+ text += ` Use ${toolNames.getSearchContent}({ responseId: "${params.responseId}", urlIndex: ${selectedUrlIndex}, offset: ${endOffset}, limit: ${limit} }) for the next slice.`;
2513
+ }
2514
+ }
2515
+ return {
2516
+ content: [{ type: "text", text }],
2517
+ details: {
2518
+ url: urlData.url,
2519
+ title: urlData.title,
2520
+ contentLength: urlData.content.length,
2521
+ offset,
2522
+ limit,
2523
+ returnedChars: contentSlice.length,
2524
+ nextOffset: hasMore ? endOffset : null,
2525
+ truncated: hasMore,
2526
+ },
2527
+ };
2528
+ }
2529
+ return {
2530
+ content: [{ type: "text", text: "Invalid stored data format" }],
2531
+ details: { error: "Invalid data" },
2532
+ };
2533
+ },
2534
+ renderCall(args, theme) {
2535
+ const { responseId, query, queryIndex, url, urlIndex, offset, findText } = args;
2536
+ let target = "";
2537
+ if (query)
2538
+ target = `query="${query}"`;
2539
+ else if (queryIndex !== undefined)
2540
+ target = `queryIndex=${queryIndex}`;
2541
+ else if (url)
2542
+ target = url.length > 30 ? url.slice(0, 27) + "..." : url;
2543
+ else if (urlIndex !== undefined)
2544
+ target = `urlIndex=${urlIndex}`;
2545
+ if (offset !== undefined)
2546
+ target += target ? ` @ ${offset}` : `offset=${offset}`;
2547
+ if (findText !== undefined) {
2548
+ const queries = Array.isArray(findText) ? findText : [findText];
2549
+ target += `${target ? " · " : ""}find ${queries.length}`;
2550
+ }
2551
+ return new Text(theme.fg("toolTitle", theme.bold("get_content ")) + theme.fg("accent", target || responseId.slice(0, 8)), 0, 0);
2552
+ },
2553
+ renderResult(result, { expanded }, theme) {
2554
+ const details = result.details;
2555
+ if (details?.error) {
2556
+ const extras = [];
2557
+ if (details.query)
2558
+ extras.push(`query: ${details.query}`);
2559
+ if (details.url)
2560
+ extras.push(`url: ${details.url}`);
2561
+ else if (details.title)
2562
+ extras.push(`resource: ${details.title}`);
2563
+ const plan = buildSearchErrorPlan({ error: details.error, extraLines: extras });
2564
+ if (plan)
2565
+ return renderSearchErrorPlan(plan, expanded, theme);
2566
+ return new Text(theme.fg("error", `Error: ${details.error}`), 0, 0);
2567
+ }
2568
+ let statusLine;
2569
+ if (typeof details?.matchCount === "number") {
2570
+ statusLine = theme.fg("success", details?.title || details?.query || "Content") + theme.fg("muted", ` (${details.matchCount} matches, ${details.returnedMatches ?? 0} shown)`);
2571
+ }
2572
+ else if (details?.query) {
2573
+ statusLine = theme.fg("success", `"${details.query}"`) + theme.fg("muted", ` (${details.resultCount} results)`);
2574
+ }
2575
+ else {
2576
+ const start = details?.offset ?? 0;
2577
+ const returned = details?.returnedChars ?? details?.contentLength ?? 0;
2578
+ const end = start + returned;
2579
+ const slice = details?.nextOffset !== undefined || start > 0
2580
+ ? `, showing ${start}-${end}`
2581
+ : "";
2582
+ statusLine = theme.fg("success", details?.title || "Content") + theme.fg("muted", ` (${details?.contentLength ?? 0} chars${slice})`);
2583
+ }
2584
+ if (!expanded) {
2585
+ return new Text(statusLine, 0, 0);
2586
+ }
2587
+ const textContent = result.content.find((c) => c.type === "text")?.text || "";
2588
+ const preview = textContent.length > 500 ? textContent.slice(0, 500) + "..." : textContent;
2589
+ return new Text(statusLine + "\n" + theme.fg("dim", preview), 0, 0);
2590
+ },
2591
+ });
2592
+ if (isCommandEnabled(initConfig, "websearch"))
2593
+ pi.registerCommand("websearch", {
2594
+ description: "Open web search curator",
2595
+ handler: async (args, ctx) => {
2596
+ const sessionToken = randomUUID();
2597
+ const commandCallId = `cmd:${sessionToken}`;
2598
+ closeCurator(commandCallId);
2599
+ const raw = args.trim();
2600
+ const queries = raw.length > 0
2601
+ ? normalizeQueryList(raw.split(","))
2602
+ : [];
2603
+ let bootstrap;
2604
+ try {
2605
+ bootstrap = await loadCuratorBootstrap(undefined, ctx);
2606
+ }
2607
+ catch (err) {
2608
+ const message = err instanceof Error ? err.message : String(err);
2609
+ ctx.ui.notify(`Failed to load web search config: ${message}`, "error");
2610
+ return;
2611
+ }
2612
+ const availableProviders = bootstrap.availableProviders;
2613
+ const initialProvider = bootstrap.defaultProvider;
2614
+ const curatorTimeoutSeconds = bootstrap.timeoutSeconds;
2615
+ let currentProvider = initialProvider;
2616
+ const commandConfig = loadConfig();
2617
+ const rawSearchProvider = normalizeProviderInput(commandConfig.searchProvider ?? commandConfig.provider ?? "auto", `provider in ${WEB_SEARCH_CONFIG_PATH}`) ?? "auto";
2618
+ let currentSearchProvider = Array.isArray(rawSearchProvider)
2619
+ ? rawSearchProvider
2620
+ : rawSearchProvider === "auto" ? "auto" : initialProvider;
2621
+ const summaryContext = {
2622
+ model: ctx.model,
2623
+ modelRegistry: ctx.modelRegistry,
2624
+ cwd: ctx.cwd,
2625
+ isProjectTrusted: () => ctx.isProjectTrusted(),
2626
+ };
2627
+ const summaryModelChoices = await loadSummaryModelChoices(summaryContext);
2628
+ ctx.ui.notify("Opening web search curator...", "info");
2629
+ const collected = new Map();
2630
+ const searchAbort = new AbortController();
2631
+ let aborted = false;
2632
+ let commandHandle = null;
2633
+ const isCommandActive = () => commandHandle !== null && activeCurators.get(commandCallId) === commandHandle;
2634
+ function sendFollowUpFromReturn(payload) {
2635
+ pi.sendMessage({
2636
+ customType: "web-search-results",
2637
+ content: payload.content,
2638
+ display: true,
2639
+ details: payload.details,
2640
+ }, { triggerTurn: true, deliverAs: "followUp" });
2641
+ }
2642
+ try {
2643
+ const handle = await startCuratorServer({
2644
+ queries,
2645
+ sessionToken,
2646
+ timeout: curatorTimeoutSeconds,
2647
+ availableProviders,
2648
+ defaultProvider: initialProvider,
2649
+ searchProvider: toCuratorProvider(currentSearchProvider) ?? "auto",
2650
+ summaryModels: summaryModelChoices.summaryModels,
2651
+ defaultSummaryModel: summaryModelChoices.defaultSummaryModel,
2652
+ }, {
2653
+ async onSummarize(selectedQueryIndices, summarizeSignal, model, feedback) {
2654
+ if (commandHandle && !isCommandActive()) {
2655
+ throw new Error("Curator session is no longer active.");
2656
+ }
2657
+ return generateSummaryForSelectedIndices(selectedQueryIndices, collected, summaryContext, summarizeSignal, model, feedback);
2658
+ },
2659
+ onSubmit(payload) {
2660
+ if (commandHandle && !isCommandActive())
2661
+ return;
2662
+ aborted = true;
2663
+ searchAbort.abort();
2664
+ const filtered = payload.selectedQueryIndices.length > 0
2665
+ ? filterByQueryIndices(payload.selectedQueryIndices, collected)
2666
+ : collectAllResultsAndUrls(collected);
2667
+ const base = {
2668
+ queryList: filtered.results.map(r => r.query),
2669
+ results: filtered.results,
2670
+ urls: filtered.urls,
2671
+ includeContent: false,
2672
+ curated: true,
2673
+ curatedFrom: collected.size,
2674
+ };
2675
+ if (!payload.rawResults) {
2676
+ const resolvedSummary = resolveSummaryForSubmit(payload, collected);
2677
+ base.workflow = "summary-review";
2678
+ base.approvedSummary = resolvedSummary.approvedSummary;
2679
+ base.summaryMeta = resolvedSummary.summaryMeta;
2680
+ }
2681
+ sendFollowUpFromReturn(buildSearchReturn(base));
2682
+ closeCurator(commandCallId);
2683
+ },
2684
+ onCancel(reason) {
2685
+ if (commandHandle && !isCommandActive())
2686
+ return;
2687
+ aborted = true;
2688
+ searchAbort.abort();
2689
+ if (reason === "timeout") {
2690
+ const all = collectAllResultsAndUrls(collected);
2691
+ const resolvedSummary = resolveSummaryForSubmit({ selectedQueryIndices: [], summary: undefined, summaryMeta: undefined }, collected);
2692
+ sendFollowUpFromReturn(buildSearchReturn({
2693
+ queryList: all.results.map(r => r.query),
2694
+ results: all.results,
2695
+ urls: all.urls,
2696
+ includeContent: false,
2697
+ curated: true,
2698
+ curatedFrom: collected.size,
2699
+ workflow: "summary-review",
2700
+ approvedSummary: resolvedSummary.approvedSummary,
2701
+ summaryMeta: resolvedSummary.summaryMeta,
2702
+ }));
2703
+ }
2704
+ closeCurator(commandCallId);
2705
+ },
2706
+ onProviderChange(provider) {
2707
+ if (commandHandle && !isCommandActive())
2708
+ return;
2709
+ const normalized = normalizeProviderInput(provider);
2710
+ if (!normalized || normalized === "auto" || Array.isArray(normalized))
2711
+ return;
2712
+ currentProvider = normalized;
2713
+ currentSearchProvider = normalized;
2714
+ try {
2715
+ saveConfig({ provider: normalized });
2716
+ }
2717
+ catch (err) {
2718
+ const message = err instanceof Error ? err.message : String(err);
2719
+ console.error(`Failed to persist default provider: ${message}`);
2720
+ }
2721
+ },
2722
+ async onAddSearch(query, provider) {
2723
+ if (commandHandle && !isCommandActive()) {
2724
+ throw new Error("Curator session is no longer active.");
2725
+ }
2726
+ const requestedProvider = resolveCuratorSearchProvider(provider, currentSearchProvider);
2727
+ const response = await search(query, {
2728
+ provider: requestedProvider,
2729
+ signal: searchAbort.signal,
2730
+ extensionContext: ctx,
2731
+ });
2732
+ if (commandHandle && !isCommandActive()) {
2733
+ throw new Error("Curator session is no longer active.");
2734
+ }
2735
+ return toCuratorSearchEntries(response);
2736
+ },
2737
+ onAddSearchResults(entries) {
2738
+ if (commandHandle && !isCommandActive())
2739
+ return;
2740
+ for (const entry of entries) {
2741
+ collected.set(entry.queryIndex, indexedCuratorEntryToQueryResult(entry));
2742
+ }
2743
+ },
2744
+ async onRewriteQuery(query, rewriteSignal) {
2745
+ if (commandHandle && !isCommandActive()) {
2746
+ throw new Error("Curator session is no longer active.");
2747
+ }
2748
+ return rewriteSearchQuery(query, summaryContext, rewriteSignal);
2749
+ },
2750
+ });
2751
+ commandHandle = handle;
2752
+ activeCurators.set(commandCallId, handle);
2753
+ let browserOpenError = null;
2754
+ if (!shouldAutoOpenCuratorBrowser(loadConfig())) {
2755
+ ctx.ui.notify(`Search curator is running. Open manually: ${handle.url}`, "info");
2756
+ }
2757
+ else {
2758
+ const open = platform() === "darwin" ? await getGlimpseOpen() : null;
2759
+ if (open) {
2760
+ try {
2761
+ const win = openInGlimpse(open, handle.url, "Search Curator");
2762
+ glimpseWins.set(commandCallId, win);
2763
+ win.on("closed", () => {
2764
+ if (glimpseWins.get(commandCallId) === win) {
2765
+ glimpseWins.delete(commandCallId);
2766
+ closeCurator(commandCallId);
2767
+ }
2768
+ });
2769
+ }
2770
+ catch (err) {
2771
+ const message = err instanceof Error ? err.message : String(err);
2772
+ console.error(`Failed to open Glimpse curator window: ${message}`);
2773
+ glimpseWins.delete(commandCallId);
2774
+ try {
2775
+ await openInBrowser(pi, handle.url);
2776
+ }
2777
+ catch (browserErr) {
2778
+ browserOpenError = browserErr instanceof Error ? browserErr.message : String(browserErr);
2779
+ }
2780
+ }
2781
+ }
2782
+ else {
2783
+ try {
2784
+ await openInBrowser(pi, handle.url);
2785
+ }
2786
+ catch (browserErr) {
2787
+ browserOpenError = browserErr instanceof Error ? browserErr.message : String(browserErr);
2788
+ }
2789
+ }
2790
+ if (browserOpenError) {
2791
+ console.error(`Failed to open curator UI: ${browserOpenError}`);
2792
+ ctx.ui.notify(`Search curator is running, but the browser did not open automatically. Open manually: ${handle.url}`, "info");
2793
+ }
2794
+ }
2795
+ if (queries.length > 0) {
2796
+ (async () => {
2797
+ let nextResultIndex = queries.length;
2798
+ for (let qi = 0; qi < queries.length; qi++) {
2799
+ if (aborted || !isCommandActive())
2800
+ break;
2801
+ const requestedProvider = currentSearchProvider;
2802
+ try {
2803
+ const response = await search(queries[qi], {
2804
+ provider: requestedProvider,
2805
+ signal: searchAbort.signal,
2806
+ extensionContext: ctx,
2807
+ });
2808
+ if (aborted || !isCommandActive())
2809
+ break;
2810
+ const entries = toCuratorSearchEntries(response);
2811
+ for (let entryIndex = 0; entryIndex < entries.length; entryIndex++) {
2812
+ const entry = entries[entryIndex];
2813
+ const resultIndex = entryIndex === 0 ? qi : nextResultIndex++;
2814
+ const indexedEntry = {
2815
+ ...entry,
2816
+ queryIndex: resultIndex,
2817
+ query: queries[qi],
2818
+ };
2819
+ collected.set(resultIndex, indexedCuratorEntryToQueryResult(indexedEntry));
2820
+ if (entry.error) {
2821
+ handle.pushError(resultIndex, entry.error, entry.provider, { query: queries[qi], slotIndex: qi });
2822
+ }
2823
+ else {
2824
+ handle.pushResult(resultIndex, { ...entry, query: queries[qi], slotIndex: qi });
2825
+ }
2826
+ }
2827
+ }
2828
+ catch (err) {
2829
+ if (aborted || !isCommandActive())
2830
+ break;
2831
+ const message = err instanceof Error ? err.message : String(err);
2832
+ const failedProvider = toCuratorProvider(requestedProvider);
2833
+ handle.pushError(qi, message, failedProvider, { query: queries[qi], slotIndex: qi });
2834
+ collected.set(qi, { query: queries[qi], answer: "", results: [], error: message, provider: failedProvider });
2835
+ }
2836
+ }
2837
+ if (!aborted && isCommandActive())
2838
+ handle.searchesDone();
2839
+ })();
2840
+ }
2841
+ else {
2842
+ if (isCommandActive())
2843
+ handle.searchesDone();
2844
+ }
2845
+ }
2846
+ catch (err) {
2847
+ closeCurator(commandCallId);
2848
+ const message = err instanceof Error ? err.message : String(err);
2849
+ ctx.ui.notify(`Failed to open curator: ${message}`, "error");
2850
+ }
2851
+ },
2852
+ });
2853
+ if (isCommandEnabled(initConfig, "curator"))
2854
+ pi.registerCommand("curator", {
2855
+ description: "Toggle or configure the search curator workflow",
2856
+ handler: async (args, ctx) => {
2857
+ const arg = args.trim().toLowerCase();
2858
+ let newWorkflow;
2859
+ if (arg.length === 0) {
2860
+ const current = resolveWorkflow(loadConfigForExtensionInit().workflow, true);
2861
+ newWorkflow = current === "none" ? "summary-review" : "none";
2862
+ }
2863
+ else if (arg === "on") {
2864
+ newWorkflow = "summary-review";
2865
+ }
2866
+ else if (arg === "off") {
2867
+ newWorkflow = "none";
2868
+ }
2869
+ else if (arg === "none" || arg === "summary-review" || arg === "auto-summary") {
2870
+ newWorkflow = arg;
2871
+ }
2872
+ else {
2873
+ ctx.ui.notify(`Unknown option: ${arg}. Use on, off, summary-review, or auto-summary.`, "error");
2874
+ return;
2875
+ }
2876
+ try {
2877
+ saveConfig({ workflow: newWorkflow });
2878
+ }
2879
+ catch (err) {
2880
+ const message = err instanceof Error ? err.message : String(err);
2881
+ ctx.ui.notify(`Failed to save config: ${message}`, "error");
2882
+ return;
2883
+ }
2884
+ const label = newWorkflow === "none"
2885
+ ? `Curator disabled — ${toolNames.webSearch} will return raw results`
2886
+ : newWorkflow === "auto-summary"
2887
+ ? `Auto-summary enabled — ${toolNames.webSearch} will generate a summary without opening the curator`
2888
+ : `Curator enabled — ${toolNames.webSearch} will open curator and auto-generate a summary draft`;
2889
+ pi.sendMessage({
2890
+ customType: "curator-config",
2891
+ content: [{ type: "text", text: label }],
2892
+ display: true,
2893
+ details: { workflow: newWorkflow },
2894
+ }, { triggerTurn: false, deliverAs: "followUp" });
2895
+ },
2896
+ });
2897
+ if (isCommandEnabled(initConfig, "google-account"))
2898
+ pi.registerCommand("google-account", {
2899
+ description: "Show the active Google account for Gemini Web",
2900
+ handler: async () => {
2901
+ if (!isBrowserCookieAccessAllowed()) {
2902
+ pi.sendMessage({
2903
+ customType: "google-account",
2904
+ content: [{ type: "text", text: `Gemini Web browser cookie access is disabled. Set allowBrowserCookies: true in ${WEB_SEARCH_CONFIG_PATH} to enable it.` }],
2905
+ display: true,
2906
+ details: { available: false, cookieAccessAllowed: false },
2907
+ }, { triggerTurn: true, deliverAs: "followUp" });
2908
+ return;
2909
+ }
2910
+ const cookies = await isGeminiWebAvailable();
2911
+ if (!cookies) {
2912
+ const diagnostic = getGeminiWebAvailabilityDiagnostic();
2913
+ const text = diagnostic
2914
+ ? `Gemini Web is unavailable: ${diagnostic}`
2915
+ : "Gemini Web is unavailable. Sign into gemini.google.com in a supported Chromium-based browser.";
2916
+ pi.sendMessage({
2917
+ customType: "google-account",
2918
+ content: [{ type: "text", text }],
2919
+ display: true,
2920
+ details: { available: false, cookieAccessAllowed: true, diagnostic },
2921
+ }, { triggerTurn: true, deliverAs: "followUp" });
2922
+ return;
2923
+ }
2924
+ const email = await getActiveGoogleEmail(cookies);
2925
+ const text = email
2926
+ ? `Active Google account: ${email}`
2927
+ : "Gemini Web is available, but the active Google account could not be determined.";
2928
+ pi.sendMessage({
2929
+ customType: "google-account",
2930
+ content: [{ type: "text", text }],
2931
+ display: true,
2932
+ details: { available: true, email: email ?? null },
2933
+ }, { triggerTurn: true, deliverAs: "followUp" });
2934
+ },
2935
+ });
2936
+ if (isCommandEnabled(initConfig, "search"))
2937
+ pi.registerCommand("search", {
2938
+ description: "Browse stored web search results",
2939
+ handler: async (_args, ctx) => {
2940
+ const results = getAllResults();
2941
+ if (results.length === 0) {
2942
+ ctx.ui.notify("No stored search results", "info");
2943
+ return;
2944
+ }
2945
+ const options = results.map((r) => {
2946
+ const age = Math.floor((Date.now() - r.timestamp) / 60000);
2947
+ const ageStr = age < 60 ? `${age}m ago` : `${Math.floor(age / 60)}h ago`;
2948
+ if (r.type === "search" && r.queries) {
2949
+ const query = r.queries[0]?.query || "unknown";
2950
+ return `[${r.id.slice(0, 6)}] "${query}" (${r.queries.length} queries) - ${ageStr}`;
2951
+ }
2952
+ if (r.type === "fetch" && (r.urls || r.urlMetadata)) {
2953
+ return `[${r.id.slice(0, 6)}] ${(r.urls ?? r.urlMetadata ?? []).length} URLs fetched - ${ageStr}`;
2954
+ }
2955
+ return `[${r.id.slice(0, 6)}] ${r.type} - ${ageStr}`;
2956
+ });
2957
+ const choice = await ctx.ui.select("Stored Search Results", options);
2958
+ if (!choice)
2959
+ return;
2960
+ const match = choice.match(/^\[([a-z0-9]+)\]/);
2961
+ if (!match)
2962
+ return;
2963
+ const selected = results.find((r) => r.id.startsWith(match[1]));
2964
+ if (!selected)
2965
+ return;
2966
+ const actions = ["View details", "Delete"];
2967
+ const action = await ctx.ui.select(`Result ${selected.id.slice(0, 6)}`, actions);
2968
+ if (action === "Delete") {
2969
+ deleteResult(selected.id);
2970
+ ctx.ui.notify(`Deleted ${selected.id.slice(0, 6)}`, "info");
2971
+ }
2972
+ else if (action === "View details") {
2973
+ let info = `ID: ${selected.id}\nType: ${selected.type}\nAge: ${Math.floor((Date.now() - selected.timestamp) / 60000)}m\n\n`;
2974
+ if (selected.type === "search" && selected.queries) {
2975
+ info += "Queries:\n";
2976
+ const queries = selected.queries.slice(0, 10);
2977
+ for (const q of queries) {
2978
+ info += `- "${q.query}" (${q.results.length} results)\n`;
2979
+ }
2980
+ if (selected.queries.length > 10) {
2981
+ info += `... and ${selected.queries.length - 10} more\n`;
2982
+ }
2983
+ }
2984
+ if (selected.type === "fetch" && (selected.urls || selected.urlMetadata)) {
2985
+ info += "URLs:\n";
2986
+ const urlItems = selected.urls ?? selected.urlMetadata ?? [];
2987
+ const urls = urlItems.slice(0, 10);
2988
+ for (const u of urls) {
2989
+ const urlDisplay = u.url.length > 50 ? u.url.slice(0, 47) + "..." : u.url;
2990
+ const contentLength = "content" in u ? u.content.length : u.contentLength;
2991
+ info += `- ${urlDisplay} (${u.error || `${contentLength} chars`})\n`;
2992
+ }
2993
+ if (urlItems.length > 10) {
2994
+ info += `... and ${urlItems.length - 10} more\n`;
2995
+ }
2996
+ }
2997
+ ctx.ui.notify(info, "info");
2998
+ }
2999
+ },
3000
+ });
3001
+ }
3002
+ //# sourceMappingURL=index.js.map