@asterxsk/kiln 0.2.0 → 0.3.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 (303) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +3 -18
  3. package/agent/extensions/AGENTS.md +68 -68
  4. package/agent/extensions/ask-user/install.ps1 +4 -0
  5. package/agent/extensions/ask-user/install.sh +3 -0
  6. package/agent/extensions/background-terminals/install.ps1 +4 -0
  7. package/agent/extensions/background-terminals/install.sh +3 -0
  8. package/agent/extensions/destructive/install.ps1 +4 -0
  9. package/agent/extensions/destructive/install.sh +3 -0
  10. package/agent/extensions/file-search/install.ps1 +4 -0
  11. package/agent/extensions/file-search/install.sh +3 -0
  12. package/agent/extensions/goal/install.ps1 +4 -0
  13. package/agent/extensions/goal/install.sh +3 -0
  14. package/agent/extensions/herdr-agent-state.ts +257 -0
  15. package/agent/extensions/kiln-update/README.md +25 -0
  16. package/agent/extensions/kiln-update/index.ts +99 -0
  17. package/agent/extensions/kiln-update/install.ps1 +27 -0
  18. package/agent/extensions/kiln-update/install.sh +24 -0
  19. package/agent/extensions/modelconf/install.ps1 +4 -0
  20. package/agent/extensions/modelconf/install.sh +3 -0
  21. package/agent/extensions/shared/install.ps1 +4 -0
  22. package/agent/extensions/shared/install.sh +3 -0
  23. package/agent/extensions/skillsconf/install.ps1 +4 -0
  24. package/agent/extensions/skillsconf/install.sh +3 -0
  25. package/agent/extensions/statusline/install.ps1 +4 -0
  26. package/agent/extensions/statusline/install.sh +3 -0
  27. package/agent/extensions/subagents/install.ps1 +4 -0
  28. package/agent/extensions/subagents/install.sh +3 -0
  29. package/agent/extensions/taste/index.ts +443 -0
  30. package/agent/extensions/taste/install.ps1 +27 -0
  31. package/agent/extensions/taste/install.sh +24 -0
  32. package/agent/extensions/todo/install.ps1 +4 -0
  33. package/agent/extensions/todo/install.sh +3 -0
  34. package/agent/extensions/trim-context/install.ps1 +4 -0
  35. package/agent/extensions/trim-context/install.sh +3 -0
  36. package/agent/version.txt +1 -0
  37. package/agent.bak.20260905-190020/AGENTS.md +67 -0
  38. package/agent.bak.20260905-190020/README.md +5 -0
  39. package/agent.bak.20260905-190020/extensions/ask-user/index.ts +418 -0
  40. package/agent.bak.20260905-190020/extensions/ask-user/install.ps1 +23 -0
  41. package/agent.bak.20260905-190020/extensions/ask-user/install.sh +21 -0
  42. package/agent.bak.20260905-190020/extensions/ask-user/package-lock.json +769 -0
  43. package/agent.bak.20260905-190020/extensions/ask-user/package.json +19 -0
  44. package/agent.bak.20260905-190020/extensions/ask-user/prompt.ts +45 -0
  45. package/agent.bak.20260905-190020/extensions/ask-user/tsconfig.json +7 -0
  46. package/agent.bak.20260905-190020/extensions/background-terminals/docs/implementation-guide.md +942 -0
  47. package/agent.bak.20260905-190020/extensions/background-terminals/index.ts +629 -0
  48. package/agent.bak.20260905-190020/extensions/background-terminals/install.ps1 +23 -0
  49. package/agent.bak.20260905-190020/extensions/background-terminals/install.sh +21 -0
  50. package/agent.bak.20260905-190020/extensions/background-terminals/package-lock.json +769 -0
  51. package/agent.bak.20260905-190020/extensions/background-terminals/package.json +17 -0
  52. package/agent.bak.20260905-190020/extensions/background-terminals/src/domain.ts +87 -0
  53. package/agent.bak.20260905-190020/extensions/background-terminals/src/manager.ts +907 -0
  54. package/agent.bak.20260905-190020/extensions/background-terminals/src/output.ts +84 -0
  55. package/agent.bak.20260905-190020/extensions/background-terminals/src/prompt.ts +142 -0
  56. package/agent.bak.20260905-190020/extensions/background-terminals/src/result-delivery.ts +27 -0
  57. package/agent.bak.20260905-190020/extensions/background-terminals/src/runtime.ts +36 -0
  58. package/agent.bak.20260905-190020/extensions/background-terminals/src/ui/output-view.ts +79 -0
  59. package/agent.bak.20260905-190020/extensions/background-terminals/src/ui/ps.ts +621 -0
  60. package/agent.bak.20260905-190020/extensions/background-terminals/src/widget-order.ts +121 -0
  61. package/agent.bak.20260905-190020/extensions/background-terminals/test/manager.test.ts +735 -0
  62. package/agent.bak.20260905-190020/extensions/background-terminals/test/output.test.ts +109 -0
  63. package/agent.bak.20260905-190020/extensions/background-terminals/test/prompt.test.ts +125 -0
  64. package/agent.bak.20260905-190020/extensions/background-terminals/test/ps.test.ts +82 -0
  65. package/agent.bak.20260905-190020/extensions/background-terminals/test/result-delivery.test.ts +44 -0
  66. package/agent.bak.20260905-190020/extensions/background-terminals/tsconfig.json +7 -0
  67. package/agent.bak.20260905-190020/extensions/destructive/README.md +34 -0
  68. package/agent.bak.20260905-190020/extensions/destructive/index.ts +124 -0
  69. package/agent.bak.20260905-190020/extensions/destructive/install.ps1 +23 -0
  70. package/agent.bak.20260905-190020/extensions/destructive/install.sh +21 -0
  71. package/agent.bak.20260905-190020/extensions/file-search/index.ts +459 -0
  72. package/agent.bak.20260905-190020/extensions/file-search/install.ps1 +23 -0
  73. package/agent.bak.20260905-190020/extensions/file-search/install.sh +21 -0
  74. package/agent.bak.20260905-190020/extensions/file-search/package-lock.json +2253 -0
  75. package/agent.bak.20260905-190020/extensions/file-search/package.json +23 -0
  76. package/agent.bak.20260905-190020/extensions/file-search/src/args.ts +122 -0
  77. package/agent.bak.20260905-190020/extensions/file-search/src/binaries.ts +422 -0
  78. package/agent.bak.20260905-190020/extensions/file-search/src/output.ts +126 -0
  79. package/agent.bak.20260905-190020/extensions/file-search/src/process.ts +146 -0
  80. package/agent.bak.20260905-190020/extensions/file-search/src/prompt.ts +52 -0
  81. package/agent.bak.20260905-190020/extensions/file-search/test/index.spec.ts +443 -0
  82. package/agent.bak.20260905-190020/extensions/file-search/tsconfig.json +7 -0
  83. package/agent.bak.20260905-190020/extensions/goal/README.md +50 -0
  84. package/agent.bak.20260905-190020/extensions/goal/index.ts +155 -0
  85. package/agent.bak.20260905-190020/extensions/goal/install.ps1 +23 -0
  86. package/agent.bak.20260905-190020/extensions/goal/install.sh +21 -0
  87. package/agent.bak.20260905-190020/extensions/kiln-update/README.md +25 -0
  88. package/agent.bak.20260905-190020/extensions/kiln-update/index.ts +99 -0
  89. package/agent.bak.20260905-190020/extensions/kiln-update/install.ps1 +23 -0
  90. package/agent.bak.20260905-190020/extensions/kiln-update/install.sh +21 -0
  91. package/agent.bak.20260905-190020/extensions/modelconf/PLAN.md +915 -0
  92. package/agent.bak.20260905-190020/extensions/modelconf/README.md +66 -0
  93. package/agent.bak.20260905-190020/extensions/modelconf/index.ts +296 -0
  94. package/agent.bak.20260905-190020/extensions/modelconf/install.ps1 +23 -0
  95. package/agent.bak.20260905-190020/extensions/modelconf/install.sh +21 -0
  96. package/agent.bak.20260905-190020/extensions/modelconf/package-lock.json +1809 -0
  97. package/agent.bak.20260905-190020/extensions/modelconf/package.json +13 -0
  98. package/agent.bak.20260905-190020/extensions/modelconf/src/fuzzy.ts +26 -0
  99. package/agent.bak.20260905-190020/extensions/modelconf/src/glob.ts +13 -0
  100. package/agent.bak.20260905-190020/extensions/modelconf/src/persistence.test.ts +46 -0
  101. package/agent.bak.20260905-190020/extensions/modelconf/src/persistence.ts +164 -0
  102. package/agent.bak.20260905-190020/extensions/modelconf/src/ui/ModelConfView.test.ts +75 -0
  103. package/agent.bak.20260905-190020/extensions/modelconf/src/ui/ModelConfView.ts +1101 -0
  104. package/agent.bak.20260905-190020/extensions/modelconf/tsconfig.json +15 -0
  105. package/agent.bak.20260905-190020/extensions/pi-web-access/CHANGELOG.md +690 -0
  106. package/agent.bak.20260905-190020/extensions/pi-web-access/LICENSE +21 -0
  107. package/agent.bak.20260905-190020/extensions/pi-web-access/README.md +470 -0
  108. package/agent.bak.20260905-190020/extensions/pi-web-access/SECURITY.md +5 -0
  109. package/agent.bak.20260905-190020/extensions/pi-web-access/activity.ts +101 -0
  110. package/agent.bak.20260905-190020/extensions/pi-web-access/auth-fetch.ts +148 -0
  111. package/agent.bak.20260905-190020/extensions/pi-web-access/banner.png +0 -0
  112. package/agent.bak.20260905-190020/extensions/pi-web-access/brightdata-unlocker.ts +272 -0
  113. package/agent.bak.20260905-190020/extensions/pi-web-access/chrome-cookies.ts +669 -0
  114. package/agent.bak.20260905-190020/extensions/pi-web-access/content-find.ts +139 -0
  115. package/agent.bak.20260905-190020/extensions/pi-web-access/credential-source.ts +191 -0
  116. package/agent.bak.20260905-190020/extensions/pi-web-access/data-uri-sanitize.ts +406 -0
  117. package/agent.bak.20260905-190020/extensions/pi-web-access/datalab-pdf-extract.ts +568 -0
  118. package/agent.bak.20260905-190020/extensions/pi-web-access/declared-web-links.ts +173 -0
  119. package/agent.bak.20260905-190020/extensions/pi-web-access/evidence/CONTRACT-EVIDENCE.md +496 -0
  120. package/agent.bak.20260905-190020/extensions/pi-web-access/evidence/contract-probe.mjs +140 -0
  121. package/agent.bak.20260905-190020/extensions/pi-web-access/exa.ts +526 -0
  122. package/agent.bak.20260905-190020/extensions/pi-web-access/extract.ts +1196 -0
  123. package/agent.bak.20260905-190020/extensions/pi-web-access/feature-config.ts +29 -0
  124. package/agent.bak.20260905-190020/extensions/pi-web-access/fetch-params.ts +111 -0
  125. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-adc.ts +298 -0
  126. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-api.ts +353 -0
  127. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-pdf-extract.ts +108 -0
  128. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-search.ts +21 -0
  129. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-url-context.ts +128 -0
  130. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-web-config.ts +101 -0
  131. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-web.ts +487 -0
  132. package/agent.bak.20260905-190020/extensions/pi-web-access/github-api.ts +197 -0
  133. package/agent.bak.20260905-190020/extensions/pi-web-access/github-extract.ts +746 -0
  134. package/agent.bak.20260905-190020/extensions/pi-web-access/github-issue-pr.ts +700 -0
  135. package/agent.bak.20260905-190020/extensions/pi-web-access/index.ts +1737 -0
  136. package/agent.bak.20260905-190020/extensions/pi-web-access/package-lock.json +5808 -0
  137. package/agent.bak.20260905-190020/extensions/pi-web-access/package.json +64 -0
  138. package/agent.bak.20260905-190020/extensions/pi-web-access/page-query.ts +96 -0
  139. package/agent.bak.20260905-190020/extensions/pi-web-access/pdf-extract.ts +409 -0
  140. package/agent.bak.20260905-190020/extensions/pi-web-access/pi-web-fetch-demo.mp4 +0 -0
  141. package/agent.bak.20260905-190020/extensions/pi-web-access/promise-try.d.ts +7 -0
  142. package/agent.bak.20260905-190020/extensions/pi-web-access/query-rewrite.ts +51 -0
  143. package/agent.bak.20260905-190020/extensions/pi-web-access/render-search-error.ts +170 -0
  144. package/agent.bak.20260905-190020/extensions/pi-web-access/rsc-extract.ts +338 -0
  145. package/agent.bak.20260905-190020/extensions/pi-web-access/search-types.ts +20 -0
  146. package/agent.bak.20260905-190020/extensions/pi-web-access/source-check.ts +282 -0
  147. package/agent.bak.20260905-190020/extensions/pi-web-access/ssrf-protection.ts +526 -0
  148. package/agent.bak.20260905-190020/extensions/pi-web-access/storage.ts +521 -0
  149. package/agent.bak.20260905-190020/extensions/pi-web-access/summary-model-scope.ts +125 -0
  150. package/agent.bak.20260905-190020/extensions/pi-web-access/test/auth-fetch.test.mjs +208 -0
  151. package/agent.bak.20260905-190020/extensions/pi-web-access/test/brightdata-unlocker.test.mjs +840 -0
  152. package/agent.bak.20260905-190020/extensions/pi-web-access/test/chrome-cookie-extraction.test.mjs +441 -0
  153. package/agent.bak.20260905-190020/extensions/pi-web-access/test/config-path.test.mjs +283 -0
  154. package/agent.bak.20260905-190020/extensions/pi-web-access/test/content-find.test.mjs +25 -0
  155. package/agent.bak.20260905-190020/extensions/pi-web-access/test/credential-source.test.mjs +118 -0
  156. package/agent.bak.20260905-190020/extensions/pi-web-access/test/data-uri-sanitize.test.mjs +210 -0
  157. package/agent.bak.20260905-190020/extensions/pi-web-access/test/datalab-pdf-extract.test.mjs +552 -0
  158. package/agent.bak.20260905-190020/extensions/pi-web-access/test/declared-web-links.test.mjs +212 -0
  159. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-answer-storage.test.mjs +40 -0
  160. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-cache-storage.test.mjs +334 -0
  161. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-content-domain-policy.test.mjs +95 -0
  162. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-modes.test.mjs +53 -0
  163. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-not-found-guidance.test.mjs +92 -0
  164. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-params.test.mjs +86 -0
  165. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-render-call.test.mjs +34 -0
  166. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-routing.test.mjs +173 -0
  167. package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-adc-auth.test.mjs +257 -0
  168. package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-api-transport.test.mjs +170 -0
  169. package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-pdf-extract.test.mjs +133 -0
  170. package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-web-cookie-opt-in.test.mjs +178 -0
  171. package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-web-header-overflow.test.mjs +148 -0
  172. package/agent.bak.20260905-190020/extensions/pi-web-access/test/get-search-content.test.mjs +223 -0
  173. package/agent.bak.20260905-190020/extensions/pi-web-access/test/github-extract.test.mjs +378 -0
  174. package/agent.bak.20260905-190020/extensions/pi-web-access/test/github-issue-pr.test.mjs +565 -0
  175. package/agent.bak.20260905-190020/extensions/pi-web-access/test/inline-content-config.test.mjs +99 -0
  176. package/agent.bak.20260905-190020/extensions/pi-web-access/test/lazy-extract-load.test.mjs +118 -0
  177. package/agent.bak.20260905-190020/extensions/pi-web-access/test/local-video-oversize.test.mjs +52 -0
  178. package/agent.bak.20260905-190020/extensions/pi-web-access/test/package-typebox-dependency.test.mjs +50 -0
  179. package/agent.bak.20260905-190020/extensions/pi-web-access/test/page-query.test.mjs +51 -0
  180. package/agent.bak.20260905-190020/extensions/pi-web-access/test/pdf-config.test.mjs +140 -0
  181. package/agent.bak.20260905-190020/extensions/pi-web-access/test/pdf-extract.test.mjs +500 -0
  182. package/agent.bak.20260905-190020/extensions/pi-web-access/test/proxy-transport.test.mjs +286 -0
  183. package/agent.bak.20260905-190020/extensions/pi-web-access/test/query-rewrite.test.mjs +52 -0
  184. package/agent.bak.20260905-190020/extensions/pi-web-access/test/rsc-fallback.test.mjs +102 -0
  185. package/agent.bak.20260905-190020/extensions/pi-web-access/test/search-error-render.test.mjs +152 -0
  186. package/agent.bak.20260905-190020/extensions/pi-web-access/test/search-providers.test.mjs +274 -0
  187. package/agent.bak.20260905-190020/extensions/pi-web-access/test/source-check.test.mjs +179 -0
  188. package/agent.bak.20260905-190020/extensions/pi-web-access/test/ssrf-allow-ranges-config.test.mjs +205 -0
  189. package/agent.bak.20260905-190020/extensions/pi-web-access/test/ssrf-protection.test.mjs +456 -0
  190. package/agent.bak.20260905-190020/extensions/pi-web-access/test/summary-model-scope.test.mjs +106 -0
  191. package/agent.bak.20260905-190020/extensions/pi-web-access/test/tool-registration-config.test.mjs +182 -0
  192. package/agent.bak.20260905-190020/extensions/pi-web-access/test/web-search-answer-render.test.mjs +66 -0
  193. package/agent.bak.20260905-190020/extensions/pi-web-access/test/youtube-extract-errors.test.mjs +64 -0
  194. package/agent.bak.20260905-190020/extensions/pi-web-access/tsconfig.json +11 -0
  195. package/agent.bak.20260905-190020/extensions/pi-web-access/utils.ts +451 -0
  196. package/agent.bak.20260905-190020/extensions/pi-web-access/video-extract.ts +392 -0
  197. package/agent.bak.20260905-190020/extensions/pi-web-access/youtube-extract.ts +328 -0
  198. package/agent.bak.20260905-190020/extensions/shared/activity-status.ts +31 -0
  199. package/agent.bak.20260905-190020/extensions/shared/child-session.ts +148 -0
  200. package/agent.bak.20260905-190020/extensions/shared/context-utilization.ts +47 -0
  201. package/agent.bak.20260905-190020/extensions/shared/dashboard-state.ts +99 -0
  202. package/agent.bak.20260905-190020/extensions/shared/install.ps1 +23 -0
  203. package/agent.bak.20260905-190020/extensions/shared/install.sh +21 -0
  204. package/agent.bak.20260905-190020/extensions/shared/test/child-session.test.ts +270 -0
  205. package/agent.bak.20260905-190020/extensions/shared/test/context-utilization.test.ts +48 -0
  206. package/agent.bak.20260905-190020/extensions/shared/test/tool-call-timeout.test.ts +117 -0
  207. package/agent.bak.20260905-190020/extensions/shared/test/widget-order.test.ts +167 -0
  208. package/agent.bak.20260905-190020/extensions/shared/tool-call-timeout.ts +104 -0
  209. package/agent.bak.20260905-190020/extensions/skillsconf/README.md +74 -0
  210. package/agent.bak.20260905-190020/extensions/skillsconf/index.ts +92 -0
  211. package/agent.bak.20260905-190020/extensions/skillsconf/install.ps1 +23 -0
  212. package/agent.bak.20260905-190020/extensions/skillsconf/install.sh +21 -0
  213. package/agent.bak.20260905-190020/extensions/skillsconf/package-lock.json +1809 -0
  214. package/agent.bak.20260905-190020/extensions/skillsconf/package.json +18 -0
  215. package/agent.bak.20260905-190020/extensions/skillsconf/src/delete-skill.test.ts +64 -0
  216. package/agent.bak.20260905-190020/extensions/skillsconf/src/delete-skill.ts +45 -0
  217. package/agent.bak.20260905-190020/extensions/skillsconf/src/filter.test.ts +80 -0
  218. package/agent.bak.20260905-190020/extensions/skillsconf/src/filter.ts +74 -0
  219. package/agent.bak.20260905-190020/extensions/skillsconf/src/fuzzy.ts +26 -0
  220. package/agent.bak.20260905-190020/extensions/skillsconf/src/persistence.test.ts +72 -0
  221. package/agent.bak.20260905-190020/extensions/skillsconf/src/persistence.ts +169 -0
  222. package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/SkillConfView.test.ts +337 -0
  223. package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/SkillConfView.ts +758 -0
  224. package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/text-input.ts +91 -0
  225. package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/tui-helpers.ts +144 -0
  226. package/agent.bak.20260905-190020/extensions/skillsconf/tsconfig.json +15 -0
  227. package/agent.bak.20260905-190020/extensions/statusline/index.ts +282 -0
  228. package/agent.bak.20260905-190020/extensions/statusline/install.ps1 +23 -0
  229. package/agent.bak.20260905-190020/extensions/statusline/install.sh +21 -0
  230. package/agent.bak.20260905-190020/extensions/subagents/docs/design-plan.md +568 -0
  231. package/agent.bak.20260905-190020/extensions/subagents/docs/effect-v4-extension-guide.md +354 -0
  232. package/agent.bak.20260905-190020/extensions/subagents/docs/effect-v4-notes.md +571 -0
  233. package/agent.bak.20260905-190020/extensions/subagents/index.ts +826 -0
  234. package/agent.bak.20260905-190020/extensions/subagents/install.ps1 +23 -0
  235. package/agent.bak.20260905-190020/extensions/subagents/install.sh +21 -0
  236. package/agent.bak.20260905-190020/extensions/subagents/package-lock.json +2244 -0
  237. package/agent.bak.20260905-190020/extensions/subagents/package.json +19 -0
  238. package/agent.bak.20260905-190020/extensions/subagents/src/backend.ts +73 -0
  239. package/agent.bak.20260905-190020/extensions/subagents/src/backends/claude.ts +701 -0
  240. package/agent.bak.20260905-190020/extensions/subagents/src/backends/codex.ts +1060 -0
  241. package/agent.bak.20260905-190020/extensions/subagents/src/backends/pi.ts +575 -0
  242. package/agent.bak.20260905-190020/extensions/subagents/src/backends/stub.ts +300 -0
  243. package/agent.bak.20260905-190020/extensions/subagents/src/by-the-way.ts +21 -0
  244. package/agent.bak.20260905-190020/extensions/subagents/src/domain.ts +253 -0
  245. package/agent.bak.20260905-190020/extensions/subagents/src/format.ts +74 -0
  246. package/agent.bak.20260905-190020/extensions/subagents/src/manager.ts +736 -0
  247. package/agent.bak.20260905-190020/extensions/subagents/src/prompt.ts +92 -0
  248. package/agent.bak.20260905-190020/extensions/subagents/src/result-delivery.ts +20 -0
  249. package/agent.bak.20260905-190020/extensions/subagents/src/runtime.ts +53 -0
  250. package/agent.bak.20260905-190020/extensions/subagents/src/ui/takeover.ts +583 -0
  251. package/agent.bak.20260905-190020/extensions/subagents/src/ui/transcript.ts +201 -0
  252. package/agent.bak.20260905-190020/extensions/subagents/src/widget-order.ts +121 -0
  253. package/agent.bak.20260905-190020/extensions/subagents/test/by-the-way.test.ts +29 -0
  254. package/agent.bak.20260905-190020/extensions/subagents/test/claude.test.ts +119 -0
  255. package/agent.bak.20260905-190020/extensions/subagents/test/codex.test.ts +102 -0
  256. package/agent.bak.20260905-190020/extensions/subagents/test/context-usage.test.ts +107 -0
  257. package/agent.bak.20260905-190020/extensions/subagents/test/manager.test.ts +276 -0
  258. package/agent.bak.20260905-190020/extensions/subagents/test/result-delivery.test.ts +27 -0
  259. package/agent.bak.20260905-190020/extensions/subagents/test/takeover.test.ts +29 -0
  260. package/agent.bak.20260905-190020/extensions/subagents/tsconfig.json +7 -0
  261. package/agent.bak.20260905-190020/extensions/taste/index.ts +443 -0
  262. package/agent.bak.20260905-190020/extensions/taste/install.ps1 +23 -0
  263. package/agent.bak.20260905-190020/extensions/taste/install.sh +21 -0
  264. package/agent.bak.20260905-190020/extensions/todo/AGENTS.md +38 -0
  265. package/agent.bak.20260905-190020/extensions/todo/LICENSE +21 -0
  266. package/agent.bak.20260905-190020/extensions/todo/config.ts +55 -0
  267. package/agent.bak.20260905-190020/extensions/todo/index.ts +151 -0
  268. package/agent.bak.20260905-190020/extensions/todo/install.ps1 +23 -0
  269. package/agent.bak.20260905-190020/extensions/todo/install.sh +21 -0
  270. package/agent.bak.20260905-190020/extensions/todo/locales/de.json +17 -0
  271. package/agent.bak.20260905-190020/extensions/todo/locales/en.json +15 -0
  272. package/agent.bak.20260905-190020/extensions/todo/locales/es.json +17 -0
  273. package/agent.bak.20260905-190020/extensions/todo/locales/fr.json +17 -0
  274. package/agent.bak.20260905-190020/extensions/todo/locales/pt-BR.json +17 -0
  275. package/agent.bak.20260905-190020/extensions/todo/locales/pt.json +17 -0
  276. package/agent.bak.20260905-190020/extensions/todo/locales/ru.json +17 -0
  277. package/agent.bak.20260905-190020/extensions/todo/locales/uk.json +17 -0
  278. package/agent.bak.20260905-190020/extensions/todo/locales/zh.json +17 -0
  279. package/agent.bak.20260905-190020/extensions/todo/package-lock.json +3358 -0
  280. package/agent.bak.20260905-190020/extensions/todo/package.json +67 -0
  281. package/agent.bak.20260905-190020/extensions/todo/state/i18n-bridge.ts +64 -0
  282. package/agent.bak.20260905-190020/extensions/todo/state/invariants.ts +20 -0
  283. package/agent.bak.20260905-190020/extensions/todo/state/replay.ts +38 -0
  284. package/agent.bak.20260905-190020/extensions/todo/state/selectors.ts +107 -0
  285. package/agent.bak.20260905-190020/extensions/todo/state/state-reducer.ts +326 -0
  286. package/agent.bak.20260905-190020/extensions/todo/state/state.ts +18 -0
  287. package/agent.bak.20260905-190020/extensions/todo/state/store.ts +82 -0
  288. package/agent.bak.20260905-190020/extensions/todo/state/task-graph.ts +57 -0
  289. package/agent.bak.20260905-190020/extensions/todo/todo-overlay.ts +204 -0
  290. package/agent.bak.20260905-190020/extensions/todo/todo.ts +155 -0
  291. package/agent.bak.20260905-190020/extensions/todo/tool/response-envelope.ts +109 -0
  292. package/agent.bak.20260905-190020/extensions/todo/tool/types.ts +206 -0
  293. package/agent.bak.20260905-190020/extensions/todo/view/format.ts +177 -0
  294. package/agent.bak.20260905-190020/extensions/todo/widget-order.ts +121 -0
  295. package/agent.bak.20260905-190020/extensions/trim-context/README.md +54 -0
  296. package/agent.bak.20260905-190020/extensions/trim-context/index.ts +487 -0
  297. package/agent.bak.20260905-190020/extensions/trim-context/install.ps1 +23 -0
  298. package/agent.bak.20260905-190020/extensions/trim-context/install.sh +21 -0
  299. package/agent.bak.20260905-190020/keybindings.json +7 -0
  300. package/bin/kiln.js +588 -471
  301. package/package.json +27 -27
  302. package/agent/install.ps1 +0 -637
  303. package/agent/install.sh +0 -620
@@ -0,0 +1,140 @@
1
+ // Regenerates evidence/CONTRACT-EVIDENCE.md from REAL calls against the
2
+ // SERPdive API. Run it with your own key to reproduce the file:
3
+ //
4
+ // SERPDIVE_API_KEY=sd_live_… node evidence/contract-probe.mjs
5
+ //
6
+ // The key is read from the environment and never written to the output —
7
+ // the script asserts that before exiting.
8
+ import fs from 'node:fs';
9
+
10
+ const KEY = process.env.SERPDIVE_API_KEY;
11
+ if (!KEY) {
12
+ console.error('SERPDIVE_API_KEY is not set. Get a key at https://serpdive.com/dashboard/keys');
13
+ process.exit(1);
14
+ }
15
+ const URL = 'https://api.serpdive.com/v1/search';
16
+ const out = [];
17
+ const say = (s = '') => out.push(s);
18
+
19
+ async function call(body, { key = KEY, abortAfterMs = null } = {}) {
20
+ const ctrl = new AbortController();
21
+ if (abortAfterMs) setTimeout(() => ctrl.abort(), abortAfterMs);
22
+ const t0 = Date.now();
23
+ try {
24
+ const res = await fetch(URL, {
25
+ method: 'POST',
26
+ headers: { 'content-type': 'application/json', ...(key ? { authorization: `Bearer ${key}` } : {}) },
27
+ body: JSON.stringify(body),
28
+ signal: ctrl.signal,
29
+ });
30
+ const json = await res.json().catch(() => null);
31
+ return { status: res.status, ms: Date.now() - t0, json };
32
+ } catch (err) {
33
+ return { status: null, ms: Date.now() - t0, aborted: err.name === 'AbortError', err: err.name };
34
+ }
35
+ }
36
+
37
+ // Reduce a response to its SHAPE: keep the structure, truncate the content.
38
+ function shape(j) {
39
+ if (!j) return null;
40
+ const c = JSON.parse(JSON.stringify(j));
41
+ if (Array.isArray(c.results)) {
42
+ c.results = c.results.slice(0, 2).map((r) => ({
43
+ ...r,
44
+ content: typeof r.content === 'string' ? `${r.content.slice(0, 90)}… (${r.content.length} chars)` : r.content,
45
+ }));
46
+ if (j.results.length > 2) c.results.push(`… ${j.results.length - 2} more, same shape`);
47
+ }
48
+ if (typeof c.answer === 'string') c.answer = `${c.answer.slice(0, 160)}… (${j.answer.length} chars)`;
49
+ return c;
50
+ }
51
+
52
+ async function section(title, note, body, opts = {}) {
53
+ const r = await call(body, opts);
54
+ const keyLine = !('key' in opts)
55
+ ? 'authorization: Bearer sd_live_… # a valid key, redacted'
56
+ : opts.key === null
57
+ ? '(no authorization header sent)'
58
+ : `authorization: Bearer ${opts.key}`;
59
+ say(`### ${title}`);
60
+ say();
61
+ if (note) { say(note); say(); }
62
+ say('```http');
63
+ say('POST https://api.serpdive.com/v1/search');
64
+ say(keyLine);
65
+ say('content-type: application/json');
66
+ say();
67
+ say(JSON.stringify(body));
68
+ say('```');
69
+ say();
70
+ if (r.aborted) {
71
+ say(`Client aborted after ${opts.abortAfterMs} ms → \`${r.err}\` raised locally; no response body.`);
72
+ } else {
73
+ say(`\`HTTP ${r.status}\` in ${r.ms} ms`);
74
+ say();
75
+ say('```json');
76
+ say(JSON.stringify(shape(r.json), null, 2));
77
+ say('```');
78
+ }
79
+ say();
80
+ return r;
81
+ }
82
+
83
+ const Q = 'best open source vector databases';
84
+
85
+ say('# SERPdive API — contract evidence');
86
+ say();
87
+ say('Every block below is a real call against `https://api.serpdive.com/v1/search`, captured on '
88
+ + new Date().toISOString().slice(0, 10) + '. Reproduce any of them with your own key: the script that');
89
+ say('generated this file is `evidence/contract-probe.mjs`. Page content is truncated to keep the file');
90
+ say('readable — nothing else is edited, and the API key is redacted.');
91
+ say();
92
+ say('---');
93
+ say();
94
+ say('## 1. Default request and response shape');
95
+ say();
96
+ await section('Query only', 'The whole request surface is `query`, `model`, `answer`, `max_results`. Everything else is ignored.', { query: Q });
97
+
98
+ say('## 2. Models');
99
+ say();
100
+ await section('krill — free tier', 'No answer synthesis on this tier: requesting one is ignored rather than refused (see §3).', { query: Q, model: 'krill' });
101
+ await section('mako — 1 credit', null, { query: Q, model: 'mako' });
102
+ await section('moby — 1.5 credits', 'Full readable page content; note the content lengths against mako above.', { query: Q, model: 'moby' });
103
+
104
+ say('## 3. `answer`');
105
+ say();
106
+ await section('answer: true with mako', 'The `answer` key is present only when requested.', { query: Q, model: 'mako', answer: true });
107
+ await section('answer: true with krill', 'Silently ignored on the free tier — no `answer` key, no error, still a complete result.', { query: Q, model: 'krill', answer: true });
108
+
109
+ say('## 4. `max_results` is a cap, never a minimum');
110
+ say();
111
+ say('A cap, applied at the edge after the search. The engine still reads a full corpus, so a small');
112
+ say('cap trims the response, not the work — and asking for more does not produce more.');
113
+ say();
114
+ for (const [n, note] of [
115
+ [1, null],
116
+ [3, null],
117
+ [10, 'The ceiling of the range. Fewer come back when fewer are judged relevant — see §1, where no cap returned 5.'],
118
+ [50, 'Above the range: clamped down to 10, silently. Never a 400.'],
119
+ [0, 'Below the range: clamped UP to 1, silently — it is the minimum of the range, NOT a way to say "no cap". One result comes back.'],
120
+ ['abc', 'Unparseable, and this is the asymmetry worth knowing: an out-of-range NUMBER is clamped into the range, but a value that is not a number at all drops the cap entirely and the default applies. Same for null or an absent field.'],
121
+ ]) {
122
+ await section(`max_results: ${JSON.stringify(n)}`, note, { query: Q, model: 'krill', max_results: n });
123
+ }
124
+
125
+ say('## 5. Errors');
126
+ say();
127
+ await section('Missing query', null, { model: 'krill' });
128
+ await section('Invalid key', null, { query: Q }, { key: 'sd_live_not_a_real_key' });
129
+ await section('No key at all', null, { query: Q }, { key: null });
130
+
131
+ say('## 6. Abort');
132
+ say();
133
+ await section('Client aborts mid-flight', 'The request is cancellable at any point; the provider maps this to the framework abort path.', { query: Q, model: 'krill' }, { abortAfterMs: 300 });
134
+
135
+ const path = new URL('./CONTRACT-EVIDENCE.md', import.meta.url).pathname;
136
+ fs.writeFileSync(path, out.join('\n'));
137
+ console.log(`written: ${path}`);
138
+ console.log(`${out.join('\n').length} characters`);
139
+ if (out.join('\n').includes(KEY)) console.error('!! THE API KEY APPEARS IN THE OUTPUT — not written');
140
+ else console.log('verified: the key appears nowhere in the output');
@@ -0,0 +1,526 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { activityMonitor } from "./activity.ts";
3
+ import type { ExtractedContent } from "./extract.ts";
4
+ import type { SearchOptions, SearchResponse } from "./search-types.ts";
5
+ import { hasCredentialSource, redactCredential, resolveCredential } from "./credential-source.ts";
6
+ import { fetchWithCredentialRedirects, getWebSearchConfigPath, resolveApiBaseUrl } from "./utils.ts";
7
+
8
+ const EXA_API_BASE_URL = "https://api.exa.ai";
9
+ const EXA_MCP_URL = "https://mcp.exa.ai/mcp";
10
+ const CONFIG_PATH = getWebSearchConfigPath();
11
+ const EXA_MCP_ADVANCED_TOOL = "web_search_advanced_exa";
12
+ const EXA_MCP_BASIC_TOOL = "web_search_exa";
13
+
14
+ interface WebSearchConfig {
15
+ exaApiKey?: unknown;
16
+ exaBaseUrl?: unknown;
17
+ }
18
+
19
+ interface ExaAnswerResponse {
20
+ answer?: string;
21
+ citations?: Array<{ url?: string; title?: string; text?: string; publishedDate?: string }>;
22
+ }
23
+
24
+ interface ExaSearchResponse {
25
+ results?: Array<{
26
+ title?: string;
27
+ url?: string;
28
+ publishedDate?: string;
29
+ author?: string;
30
+ text?: string;
31
+ highlights?: unknown;
32
+ highlightScores?: number[];
33
+ }>;
34
+ }
35
+
36
+ interface ExaMcpRpcResponse {
37
+ result?: {
38
+ content?: Array<{ type?: string; text?: string }>;
39
+ isError?: boolean;
40
+ };
41
+ error?: {
42
+ code?: number;
43
+ message?: string;
44
+ };
45
+ }
46
+
47
+ export type ExaSearchResult = SearchResponse | null;
48
+
49
+ export interface ExaSearchOptions extends SearchOptions {
50
+ includeContent?: boolean;
51
+ }
52
+
53
+ type McpParsedResult = { title: string; url: string; content: string };
54
+
55
+ let cachedConfig: WebSearchConfig | null = null;
56
+
57
+ function loadConfig(): WebSearchConfig {
58
+ if (cachedConfig) return cachedConfig;
59
+ if (!existsSync(CONFIG_PATH)) {
60
+ cachedConfig = {};
61
+ return cachedConfig;
62
+ }
63
+
64
+ const raw = readFileSync(CONFIG_PATH, "utf-8");
65
+ try {
66
+ cachedConfig = JSON.parse(raw) as WebSearchConfig;
67
+ return cachedConfig;
68
+ } catch (err) {
69
+ const message = err instanceof Error ? err.message : String(err);
70
+ throw new Error(`Failed to parse ${CONFIG_PATH}: ${message}`);
71
+ }
72
+ }
73
+
74
+ async function getApiKey(signal?: AbortSignal): Promise<string | null> {
75
+ return resolveCredential({
76
+ provider: "Exa",
77
+ configuredValue: loadConfig().exaApiKey,
78
+ environmentValue: process.env.EXA_API_KEY,
79
+ signal,
80
+ });
81
+ }
82
+
83
+ function getApiBaseUrl(): string {
84
+ return resolveApiBaseUrl({
85
+ configKey: "exaBaseUrl",
86
+ configuredValue: loadConfig().exaBaseUrl,
87
+ defaultValue: EXA_API_BASE_URL,
88
+ environmentKey: "EXA_BASE_URL",
89
+ environmentValue: process.env.EXA_BASE_URL,
90
+ });
91
+ }
92
+
93
+ function exaApiHeaders(apiKey: string): Record<string, string> {
94
+ return {
95
+ "x-api-key": apiKey,
96
+ "Content-Type": "application/json",
97
+ "x-exa-integration": "pi-web-access",
98
+ };
99
+ }
100
+
101
+ function requestSignal(signal?: AbortSignal): AbortSignal {
102
+ const timeout = AbortSignal.timeout(60000);
103
+ return signal ? AbortSignal.any([signal, timeout]) : timeout;
104
+ }
105
+
106
+ function recencyToStartDate(filter: string): string {
107
+ const now = new Date();
108
+ const offsets: Record<string, number> = {
109
+ day: 1,
110
+ week: 7,
111
+ month: 30,
112
+ year: 365,
113
+ };
114
+ const days = offsets[filter] ?? 0;
115
+ return new Date(now.getTime() - days * 86400000).toISOString();
116
+ }
117
+
118
+ function mapDomainFilter(domainFilter: string[] | undefined): { includeDomains?: string[]; excludeDomains?: string[] } {
119
+ if (!domainFilter?.length) return {};
120
+ const includeDomains = domainFilter
121
+ .filter(d => !d.startsWith("-") && d.trim().length > 0)
122
+ .map(d => d.trim());
123
+ const excludeDomains = domainFilter
124
+ .filter(d => d.startsWith("-"))
125
+ .map(d => d.slice(1).trim())
126
+ .filter(Boolean);
127
+ return {
128
+ ...(includeDomains.length ? { includeDomains } : {}),
129
+ ...(excludeDomains.length ? { excludeDomains } : {}),
130
+ };
131
+ }
132
+
133
+ function exaSearchArgs(query: string, options: ExaSearchOptions): Record<string, unknown> {
134
+ const startDate = options.recencyFilter ? recencyToStartDate(options.recencyFilter) : null;
135
+ return {
136
+ query,
137
+ type: "auto",
138
+ numResults: options.numResults ?? 5,
139
+ ...mapDomainFilter(options.domainFilter),
140
+ ...(startDate ? { startPublishedDate: startDate } : {}),
141
+ };
142
+ }
143
+
144
+ function normalizeHighlights(value: unknown): string[] {
145
+ if (!Array.isArray(value)) return [];
146
+ return value.filter((item): item is string => typeof item === "string" && item.trim().length > 0);
147
+ }
148
+
149
+ function buildAnswerFromSearchResults(results: ExaSearchResponse["results"]): string {
150
+ if (!results?.length) return "";
151
+ const parts: string[] = [];
152
+ for (let i = 0; i < results.length; i++) {
153
+ const item = results[i];
154
+ if (!item?.url) continue;
155
+ const highlights = normalizeHighlights(item.highlights);
156
+ const content = highlights.length > 0
157
+ ? highlights.join(" ")
158
+ : typeof item.text === "string" ? item.text.trim().slice(0, 1000) : "";
159
+ if (!content) continue;
160
+ const sourceTitle = item.title || `Source ${i + 1}`;
161
+ parts.push(`${content}\nSource: ${sourceTitle} (${item.url})`);
162
+ }
163
+ return parts.join("\n\n");
164
+ }
165
+
166
+ function mapResults(results: ExaSearchResponse["results"] | ExaAnswerResponse["citations"]): SearchResponse["results"] {
167
+ if (!Array.isArray(results)) return [];
168
+ const mapped: SearchResponse["results"] = [];
169
+ for (let i = 0; i < results.length; i++) {
170
+ const item = results[i];
171
+ if (!item?.url) continue;
172
+ mapped.push({
173
+ title: item.title || `Source ${i + 1}`,
174
+ url: item.url,
175
+ snippet: "",
176
+ });
177
+ }
178
+ return mapped;
179
+ }
180
+
181
+ function mapInlineContent(results: ExaSearchResponse["results"]): ExtractedContent[] {
182
+ if (!results?.length) return [];
183
+ return results
184
+ .filter((r): r is NonNullable<ExaSearchResponse["results"]>[number] & { url: string; text: string } =>
185
+ !!r?.url && typeof r.text === "string" && r.text.length > 0)
186
+ .map(r => ({
187
+ url: r.url,
188
+ title: r.title || "",
189
+ content: r.text,
190
+ error: null,
191
+ }));
192
+ }
193
+
194
+ function toSearchResponse(
195
+ answer: string,
196
+ results: SearchResponse["results"],
197
+ inlineContent: ExtractedContent[] | null,
198
+ ): SearchResponse {
199
+ const response: SearchResponse = { answer, results };
200
+ if (inlineContent?.length) response.inlineContent = inlineContent;
201
+ return response;
202
+ }
203
+
204
+ export async function callExaMcp(
205
+ toolName: string,
206
+ args: Record<string, unknown>,
207
+ signal?: AbortSignal,
208
+ ): Promise<string> {
209
+ const response = await fetch(`${EXA_MCP_URL}?tools=${toolName}`, {
210
+ method: "POST",
211
+ headers: {
212
+ "Content-Type": "application/json",
213
+ "Accept": "application/json, text/event-stream",
214
+ "x-exa-source": "pi-web-access",
215
+ },
216
+ body: JSON.stringify({
217
+ jsonrpc: "2.0",
218
+ id: 1,
219
+ method: "tools/call",
220
+ params: {
221
+ name: toolName,
222
+ arguments: args,
223
+ },
224
+ }),
225
+ signal: requestSignal(signal),
226
+ });
227
+
228
+ if (!response.ok) {
229
+ const errorText = await response.text();
230
+ if (response.status === 429) {
231
+ throw new Error(
232
+ `Exa MCP rate limit reached (429). Add "exaApiKey" to ${CONFIG_PATH} for unthrottled Exa search: ${errorText.slice(0, 200)}`,
233
+ );
234
+ }
235
+ throw new Error(`Exa MCP error ${response.status}: ${errorText.slice(0, 300)}`);
236
+ }
237
+
238
+ const body = await response.text();
239
+ const dataLines = body.split("\n").filter(line => line.startsWith("data:"));
240
+
241
+ let parsed: ExaMcpRpcResponse | null = null;
242
+ for (const line of dataLines) {
243
+ const payload = line.slice(5).trim();
244
+ if (!payload) continue;
245
+ try {
246
+ const candidate = JSON.parse(payload) as ExaMcpRpcResponse;
247
+ if (candidate?.result || candidate?.error) {
248
+ parsed = candidate;
249
+ break;
250
+ }
251
+ } catch {
252
+ }
253
+ }
254
+
255
+ if (!parsed) {
256
+ try {
257
+ const candidate = JSON.parse(body) as ExaMcpRpcResponse;
258
+ if (candidate?.result || candidate?.error) {
259
+ parsed = candidate;
260
+ }
261
+ } catch {
262
+ }
263
+ }
264
+
265
+ if (!parsed) {
266
+ throw new Error("Exa MCP returned an empty response");
267
+ }
268
+
269
+ if (parsed.error) {
270
+ const code = typeof parsed.error.code === "number" ? ` ${parsed.error.code}` : "";
271
+ const message = parsed.error.message || "Unknown error";
272
+ throw new Error(`Exa MCP error${code}: ${message}`);
273
+ }
274
+
275
+ if (parsed.result?.isError) {
276
+ const message = parsed.result.content
277
+ ?.find(item => item.type === "text" && typeof item.text === "string")
278
+ ?.text?.trim();
279
+ throw new Error(message || "Exa MCP returned an error");
280
+ }
281
+
282
+ const text = parsed.result?.content
283
+ ?.find(item => item.type === "text" && typeof item.text === "string" && item.text.trim().length > 0)
284
+ ?.text;
285
+
286
+ if (!text) {
287
+ throw new Error("Exa MCP returned empty content");
288
+ }
289
+
290
+ return text;
291
+ }
292
+
293
+ function parseMcpResults(text: string): McpParsedResult[] | null {
294
+ const blocks = text.split(/(?=^Title: )/m).filter(block => block.trim().length > 0);
295
+ const parsed = blocks.map(block => {
296
+ const title = block.match(/^Title: (.+)/m)?.[1]?.trim() ?? "";
297
+ const url = block.match(/^URL: (.+)/m)?.[1]?.trim() ?? "";
298
+ let content = "";
299
+ const textStart = block.indexOf("\nText: ");
300
+ if (textStart >= 0) {
301
+ content = block.slice(textStart + 7).trim();
302
+ } else {
303
+ const hlMatch = block.match(/\nHighlights:\s*\n/);
304
+ if (hlMatch?.index != null) {
305
+ content = block.slice(hlMatch.index + hlMatch[0].length).trim();
306
+ }
307
+ }
308
+ content = content.replace(/\n---\s*$/, "").trim();
309
+ return { title, url, content };
310
+ }).filter(result => result.url.length > 0);
311
+ return parsed.length > 0 ? parsed : null;
312
+ }
313
+
314
+ function buildAnswerFromMcpResults(results: McpParsedResult[]): string {
315
+ if (results.length === 0) return "";
316
+ const parts: string[] = [];
317
+ for (let i = 0; i < results.length; i++) {
318
+ const result = results[i];
319
+ const snippet = result.content.replace(/\s+/g, " ").trim().slice(0, 500);
320
+ if (!snippet) continue;
321
+ const sourceTitle = result.title || `Source ${i + 1}`;
322
+ parts.push(`${snippet}\nSource: ${sourceTitle} (${result.url})`);
323
+ }
324
+ return parts.join("\n\n");
325
+ }
326
+
327
+ function mapMcpInlineContent(results: McpParsedResult[]): ExtractedContent[] {
328
+ return results
329
+ .filter(result => result.content.length > 0)
330
+ .map(result => ({
331
+ url: result.url,
332
+ title: result.title,
333
+ content: result.content,
334
+ error: null,
335
+ }));
336
+ }
337
+
338
+ function buildMcpQuery(query: string, options: ExaSearchOptions): string {
339
+ const parts = [query];
340
+ if (options.domainFilter?.length) {
341
+ for (const d of options.domainFilter) {
342
+ parts.push(d.startsWith("-") ? `-site:${d.slice(1)}` : `site:${d}`);
343
+ }
344
+ }
345
+ if (options.recencyFilter) {
346
+ const now = new Date();
347
+ switch (options.recencyFilter) {
348
+ case "day": parts.push("past 24 hours"); break;
349
+ case "week": parts.push("past week"); break;
350
+ case "month": parts.push(`${now.toLocaleString("en", { month: "long" })} ${now.getFullYear()}`); break;
351
+ case "year": parts.push(String(now.getFullYear())); break;
352
+ }
353
+ }
354
+ return parts.join(" ");
355
+ }
356
+
357
+ function isAbortMessage(message: string): boolean {
358
+ return message.toLowerCase().includes("abort");
359
+ }
360
+
361
+ function parseJsonMcpResults(text: string): ExaSearchResponse["results"] | null {
362
+ try {
363
+ const results = (JSON.parse(text) as ExaSearchResponse).results;
364
+ return Array.isArray(results) && results.length > 0 ? results : null;
365
+ } catch {
366
+ return null;
367
+ }
368
+ }
369
+
370
+ /**
371
+ * Calls one Exa MCP search tool and normalizes its payload. `web_search_advanced_exa`
372
+ * returns the raw Exa search JSON; `web_search_exa` returns a formatted text block.
373
+ */
374
+ async function searchWithExaMcpTool(
375
+ tool: string,
376
+ args: Record<string, unknown>,
377
+ options: ExaSearchOptions,
378
+ ): Promise<SearchResponse | null> {
379
+ const text = await callExaMcp(tool, args, options.signal);
380
+
381
+ const jsonResults = parseJsonMcpResults(text);
382
+ if (jsonResults) {
383
+ return toSearchResponse(
384
+ buildAnswerFromSearchResults(jsonResults),
385
+ mapResults(jsonResults),
386
+ options.includeContent ? mapInlineContent(jsonResults) : null,
387
+ );
388
+ }
389
+
390
+ const textResults = parseMcpResults(text);
391
+ if (!textResults) return null;
392
+
393
+ return toSearchResponse(
394
+ buildAnswerFromMcpResults(textResults),
395
+ mapResults(textResults),
396
+ options.includeContent ? mapMcpInlineContent(textResults) : null,
397
+ );
398
+ }
399
+
400
+ /** Filtered searches need the advanced tool, which not every deployment exposes. */
401
+ async function searchWithFilteredExaMcp(
402
+ query: string,
403
+ options: ExaSearchOptions,
404
+ basicArgs: Record<string, unknown>,
405
+ ): Promise<SearchResponse | null> {
406
+ try {
407
+ return await searchWithExaMcpTool(EXA_MCP_ADVANCED_TOOL, {
408
+ ...exaSearchArgs(query, options),
409
+ enableHighlights: true,
410
+ textMaxCharacters: options.includeContent ? 50000 : 3000,
411
+ }, options);
412
+ } catch (err) {
413
+ if (isAbortMessage(err instanceof Error ? err.message : String(err))) throw err;
414
+ // The basic tool ignores every argument except query/numResults, so the
415
+ // filters degrade into the query text.
416
+ return searchWithExaMcpTool(EXA_MCP_BASIC_TOOL, basicArgs, options);
417
+ }
418
+ }
419
+
420
+ async function searchWithExaMcp(query: string, options: ExaSearchOptions = {}): Promise<SearchResponse | null> {
421
+ const activityId = activityMonitor.logStart({ type: "api", query });
422
+ const basicArgs = { query: buildMcpQuery(query, options), numResults: options.numResults ?? 5 };
423
+ const filtered = !!options.includeContent || !!options.recencyFilter || !!options.domainFilter?.length;
424
+
425
+ try {
426
+ const response = filtered
427
+ ? await searchWithFilteredExaMcp(query, options, basicArgs)
428
+ : await searchWithExaMcpTool(EXA_MCP_BASIC_TOOL, basicArgs, options);
429
+ activityMonitor.logComplete(activityId, 200);
430
+ return response;
431
+ } catch (err) {
432
+ const message = err instanceof Error ? err.message : String(err);
433
+ if (isAbortMessage(message)) {
434
+ activityMonitor.logComplete(activityId, 0);
435
+ } else {
436
+ activityMonitor.logError(activityId, message);
437
+ }
438
+ throw err;
439
+ }
440
+ }
441
+
442
+ export function isExaAvailable(): boolean {
443
+ return true;
444
+ }
445
+
446
+ export function hasExaApiKey(): boolean {
447
+ return hasCredentialSource({
448
+ provider: "Exa",
449
+ configuredValue: loadConfig().exaApiKey,
450
+ environmentValue: process.env.EXA_API_KEY,
451
+ });
452
+ }
453
+
454
+ export async function searchWithExa(query: string, options: ExaSearchOptions = {}): Promise<ExaSearchResult> {
455
+ const apiKey = await getApiKey(options.signal);
456
+ if (!apiKey) {
457
+ return searchWithExaMcp(query, options);
458
+ }
459
+
460
+ const apiBaseUrl = getApiBaseUrl();
461
+ const useSearch = options.includeContent
462
+ || !!options.recencyFilter
463
+ || !!options.domainFilter?.length
464
+ || !!(options.numResults && options.numResults !== 5);
465
+
466
+ const activityId = activityMonitor.logStart({ type: "api", query });
467
+
468
+ try {
469
+ if (!useSearch) {
470
+ const response = await fetchWithCredentialRedirects(`${apiBaseUrl}/answer`, {
471
+ method: "POST",
472
+ headers: exaApiHeaders(apiKey),
473
+ body: JSON.stringify({ query }),
474
+ signal: requestSignal(options.signal),
475
+ }, ["x-api-key"]);
476
+
477
+ if (!response.ok) {
478
+ const errorText = redactCredential(await response.text(), apiKey);
479
+ throw new Error(`Exa API error ${response.status}: ${errorText.slice(0, 300)}`);
480
+ }
481
+
482
+ const data = await response.json() as ExaAnswerResponse;
483
+ activityMonitor.logComplete(activityId, response.status);
484
+ return {
485
+ answer: data.answer || "",
486
+ results: mapResults(data.citations),
487
+ };
488
+ }
489
+
490
+ const response = await fetchWithCredentialRedirects(`${apiBaseUrl}/search`, {
491
+ method: "POST",
492
+ headers: exaApiHeaders(apiKey),
493
+ body: JSON.stringify({
494
+ ...exaSearchArgs(query, options),
495
+ contents: options.includeContent
496
+ ? { text: true, highlights: true }
497
+ : { highlights: true },
498
+ }),
499
+ signal: requestSignal(options.signal),
500
+ }, ["x-api-key"]);
501
+
502
+ if (!response.ok) {
503
+ const errorText = redactCredential(await response.text(), apiKey);
504
+ throw new Error(`Exa API error ${response.status}: ${errorText.slice(0, 300)}`);
505
+ }
506
+
507
+ const data = await response.json() as ExaSearchResponse;
508
+ activityMonitor.logComplete(activityId, response.status);
509
+
510
+ return toSearchResponse(
511
+ buildAnswerFromSearchResults(data.results),
512
+ mapResults(data.results),
513
+ options.includeContent ? mapInlineContent(data.results) : null,
514
+ );
515
+ } catch (err) {
516
+ const message = err instanceof Error ? err.message : String(err);
517
+ const redactedMessage = redactCredential(message, apiKey);
518
+ if (isAbortMessage(redactedMessage)) {
519
+ activityMonitor.logComplete(activityId, 0);
520
+ } else {
521
+ activityMonitor.logError(activityId, redactedMessage);
522
+ }
523
+ if (redactedMessage === message) throw err;
524
+ throw new Error(redactedMessage);
525
+ }
526
+ }