@asterxsk/kiln 0.1.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 (491) hide show
  1. package/README.md +155 -170
  2. package/agent/AGENTS.md +67 -67
  3. package/agent/README.md +5 -5
  4. package/agent/extensions/ask-user/index.ts +418 -418
  5. package/agent/extensions/ask-user/install.ps1 +4 -0
  6. package/agent/extensions/ask-user/install.sh +3 -0
  7. package/agent/extensions/ask-user/package-lock.json +769 -769
  8. package/agent/extensions/ask-user/package.json +19 -19
  9. package/agent/extensions/ask-user/prompt.ts +45 -45
  10. package/agent/extensions/ask-user/tsconfig.json +7 -7
  11. package/agent/extensions/background-terminals/docs/implementation-guide.md +942 -942
  12. package/agent/extensions/background-terminals/index.ts +627 -627
  13. package/agent/extensions/background-terminals/install.ps1 +4 -0
  14. package/agent/extensions/background-terminals/install.sh +3 -0
  15. package/agent/extensions/background-terminals/manager.test.ts +735 -735
  16. package/agent/extensions/background-terminals/output.test.ts +109 -109
  17. package/agent/extensions/background-terminals/package-lock.json +769 -769
  18. package/agent/extensions/background-terminals/package.json +17 -17
  19. package/agent/extensions/background-terminals/prompt.test.ts +125 -125
  20. package/agent/extensions/background-terminals/ps.test.ts +82 -82
  21. package/agent/extensions/background-terminals/result-delivery.test.ts +44 -44
  22. package/agent/extensions/background-terminals/src/domain.ts +87 -87
  23. package/agent/extensions/background-terminals/src/manager.ts +907 -907
  24. package/agent/extensions/background-terminals/src/output.ts +84 -84
  25. package/agent/extensions/background-terminals/src/prompt.ts +142 -142
  26. package/agent/extensions/background-terminals/src/result-delivery.ts +27 -27
  27. package/agent/extensions/background-terminals/src/runtime.ts +36 -36
  28. package/agent/extensions/background-terminals/src/ui/output-view.ts +79 -79
  29. package/agent/extensions/background-terminals/src/ui/ps.ts +621 -621
  30. package/agent/extensions/background-terminals/tsconfig.json +7 -7
  31. package/agent/extensions/destructive/install.ps1 +4 -0
  32. package/agent/extensions/destructive/install.sh +3 -0
  33. package/agent/extensions/file-search/index.spec.ts +443 -443
  34. package/agent/extensions/file-search/index.ts +459 -459
  35. package/agent/extensions/file-search/install.ps1 +4 -0
  36. package/agent/extensions/file-search/install.sh +3 -0
  37. package/agent/extensions/file-search/package-lock.json +2253 -2253
  38. package/agent/extensions/file-search/package.json +23 -23
  39. package/agent/extensions/file-search/src/args.ts +122 -122
  40. package/agent/extensions/file-search/src/binaries.ts +422 -422
  41. package/agent/extensions/file-search/src/output.ts +126 -126
  42. package/agent/extensions/file-search/src/process.ts +146 -146
  43. package/agent/extensions/file-search/src/prompt.ts +52 -52
  44. package/agent/extensions/file-search/tsconfig.json +7 -7
  45. package/agent/extensions/goal/install.ps1 +4 -0
  46. package/agent/extensions/goal/install.sh +3 -0
  47. package/agent/extensions/herdr-agent-state.ts +257 -0
  48. package/agent/extensions/kiln-update/README.md +25 -0
  49. package/agent/extensions/kiln-update/index.ts +99 -0
  50. package/agent/extensions/kiln-update/install.ps1 +27 -0
  51. package/agent/extensions/kiln-update/install.sh +24 -0
  52. package/agent/extensions/modelconf/PLAN.md +915 -915
  53. package/agent/extensions/modelconf/index.ts +296 -296
  54. package/agent/extensions/modelconf/install.ps1 +4 -0
  55. package/agent/extensions/modelconf/install.sh +3 -0
  56. package/agent/extensions/modelconf/src/ui/ModelConfView.ts +1101 -1101
  57. package/agent/extensions/pi-web-access/CHANGELOG.md +690 -690
  58. package/agent/extensions/pi-web-access/LICENSE +21 -21
  59. package/agent/extensions/pi-web-access/README.md +470 -470
  60. package/agent/extensions/pi-web-access/SECURITY.md +5 -5
  61. package/agent/extensions/pi-web-access/activity.ts +101 -101
  62. package/agent/extensions/pi-web-access/auth-fetch.ts +148 -148
  63. package/agent/extensions/pi-web-access/brightdata-unlocker.ts +272 -272
  64. package/agent/extensions/pi-web-access/chrome-cookies.ts +669 -669
  65. package/agent/extensions/pi-web-access/content-find.ts +139 -139
  66. package/agent/extensions/pi-web-access/credential-source.ts +191 -191
  67. package/agent/extensions/pi-web-access/data-uri-sanitize.ts +406 -406
  68. package/agent/extensions/pi-web-access/datalab-pdf-extract.ts +568 -568
  69. package/agent/extensions/pi-web-access/declared-web-links.ts +173 -173
  70. package/agent/extensions/pi-web-access/evidence/CONTRACT-EVIDENCE.md +496 -496
  71. package/agent/extensions/pi-web-access/evidence/contract-probe.mjs +140 -140
  72. package/agent/extensions/pi-web-access/exa.ts +526 -526
  73. package/agent/extensions/pi-web-access/extract.ts +1196 -1196
  74. package/agent/extensions/pi-web-access/feature-config.ts +29 -29
  75. package/agent/extensions/pi-web-access/fetch-params.ts +111 -111
  76. package/agent/extensions/pi-web-access/gemini-adc.ts +298 -298
  77. package/agent/extensions/pi-web-access/gemini-api.ts +353 -353
  78. package/agent/extensions/pi-web-access/gemini-pdf-extract.ts +108 -108
  79. package/agent/extensions/pi-web-access/gemini-url-context.ts +128 -128
  80. package/agent/extensions/pi-web-access/gemini-web-config.ts +101 -101
  81. package/agent/extensions/pi-web-access/gemini-web.ts +487 -487
  82. package/agent/extensions/pi-web-access/github-api.ts +197 -197
  83. package/agent/extensions/pi-web-access/github-extract.ts +746 -746
  84. package/agent/extensions/pi-web-access/github-issue-pr.ts +700 -700
  85. package/agent/extensions/pi-web-access/index.ts +1737 -1737
  86. package/agent/extensions/pi-web-access/package-lock.json +5808 -5808
  87. package/agent/extensions/pi-web-access/package.json +64 -64
  88. package/agent/extensions/pi-web-access/page-query.ts +96 -96
  89. package/agent/extensions/pi-web-access/pdf-extract.ts +409 -409
  90. package/agent/extensions/pi-web-access/promise-try.d.ts +7 -7
  91. package/agent/extensions/pi-web-access/query-rewrite.ts +51 -51
  92. package/agent/extensions/pi-web-access/render-search-error.ts +170 -170
  93. package/agent/extensions/pi-web-access/rsc-extract.ts +338 -338
  94. package/agent/extensions/pi-web-access/source-check.ts +282 -282
  95. package/agent/extensions/pi-web-access/ssrf-protection.ts +526 -526
  96. package/agent/extensions/pi-web-access/storage.ts +521 -521
  97. package/agent/extensions/pi-web-access/summary-model-scope.ts +125 -125
  98. package/agent/extensions/pi-web-access/test/auth-fetch.test.mjs +208 -208
  99. package/agent/extensions/pi-web-access/test/brightdata-unlocker.test.mjs +840 -840
  100. package/agent/extensions/pi-web-access/test/chrome-cookie-extraction.test.mjs +441 -441
  101. package/agent/extensions/pi-web-access/test/config-path.test.mjs +283 -283
  102. package/agent/extensions/pi-web-access/test/content-find.test.mjs +25 -25
  103. package/agent/extensions/pi-web-access/test/credential-source.test.mjs +118 -118
  104. package/agent/extensions/pi-web-access/test/data-uri-sanitize.test.mjs +210 -210
  105. package/agent/extensions/pi-web-access/test/datalab-pdf-extract.test.mjs +552 -552
  106. package/agent/extensions/pi-web-access/test/declared-web-links.test.mjs +212 -212
  107. package/agent/extensions/pi-web-access/test/fetch-answer-storage.test.mjs +40 -40
  108. package/agent/extensions/pi-web-access/test/fetch-cache-storage.test.mjs +334 -334
  109. package/agent/extensions/pi-web-access/test/fetch-content-domain-policy.test.mjs +95 -95
  110. package/agent/extensions/pi-web-access/test/fetch-modes.test.mjs +53 -53
  111. package/agent/extensions/pi-web-access/test/fetch-not-found-guidance.test.mjs +92 -92
  112. package/agent/extensions/pi-web-access/test/fetch-params.test.mjs +86 -86
  113. package/agent/extensions/pi-web-access/test/fetch-render-call.test.mjs +34 -34
  114. package/agent/extensions/pi-web-access/test/fetch-routing.test.mjs +173 -173
  115. package/agent/extensions/pi-web-access/test/gemini-adc-auth.test.mjs +257 -257
  116. package/agent/extensions/pi-web-access/test/gemini-api-transport.test.mjs +170 -170
  117. package/agent/extensions/pi-web-access/test/gemini-pdf-extract.test.mjs +133 -133
  118. package/agent/extensions/pi-web-access/test/gemini-web-cookie-opt-in.test.mjs +178 -178
  119. package/agent/extensions/pi-web-access/test/gemini-web-header-overflow.test.mjs +148 -148
  120. package/agent/extensions/pi-web-access/test/get-search-content.test.mjs +223 -223
  121. package/agent/extensions/pi-web-access/test/github-extract.test.mjs +378 -378
  122. package/agent/extensions/pi-web-access/test/github-issue-pr.test.mjs +565 -565
  123. package/agent/extensions/pi-web-access/test/inline-content-config.test.mjs +99 -99
  124. package/agent/extensions/pi-web-access/test/lazy-extract-load.test.mjs +118 -118
  125. package/agent/extensions/pi-web-access/test/local-video-oversize.test.mjs +52 -52
  126. package/agent/extensions/pi-web-access/test/package-typebox-dependency.test.mjs +50 -50
  127. package/agent/extensions/pi-web-access/test/page-query.test.mjs +51 -51
  128. package/agent/extensions/pi-web-access/test/pdf-config.test.mjs +140 -140
  129. package/agent/extensions/pi-web-access/test/pdf-extract.test.mjs +500 -500
  130. package/agent/extensions/pi-web-access/test/proxy-transport.test.mjs +286 -286
  131. package/agent/extensions/pi-web-access/test/query-rewrite.test.mjs +52 -52
  132. package/agent/extensions/pi-web-access/test/rsc-fallback.test.mjs +102 -102
  133. package/agent/extensions/pi-web-access/test/search-error-render.test.mjs +152 -152
  134. package/agent/extensions/pi-web-access/test/search-providers.test.mjs +274 -274
  135. package/agent/extensions/pi-web-access/test/source-check.test.mjs +179 -179
  136. package/agent/extensions/pi-web-access/test/ssrf-allow-ranges-config.test.mjs +205 -205
  137. package/agent/extensions/pi-web-access/test/ssrf-protection.test.mjs +456 -456
  138. package/agent/extensions/pi-web-access/test/tool-registration-config.test.mjs +182 -182
  139. package/agent/extensions/pi-web-access/test/youtube-extract-errors.test.mjs +64 -64
  140. package/agent/extensions/pi-web-access/tsconfig.json +11 -11
  141. package/agent/extensions/pi-web-access/utils.ts +451 -451
  142. package/agent/extensions/pi-web-access/video-extract.ts +392 -392
  143. package/agent/extensions/pi-web-access/youtube-extract.ts +328 -328
  144. package/agent/extensions/shared/activity-status.ts +31 -31
  145. package/agent/extensions/shared/child-session.test.ts +270 -270
  146. package/agent/extensions/shared/child-session.ts +148 -148
  147. package/agent/extensions/shared/context-utilization.test.ts +48 -48
  148. package/agent/extensions/shared/context-utilization.ts +47 -47
  149. package/agent/extensions/shared/dashboard-state.ts +99 -99
  150. package/agent/extensions/shared/install.ps1 +4 -0
  151. package/agent/extensions/shared/install.sh +3 -0
  152. package/agent/extensions/shared/tool-call-timeout.test.ts +117 -117
  153. package/agent/extensions/shared/tool-call-timeout.ts +104 -104
  154. package/agent/extensions/skillsconf/install.ps1 +4 -0
  155. package/agent/extensions/skillsconf/install.sh +3 -0
  156. package/agent/extensions/statusline/index.ts +282 -0
  157. package/agent/extensions/statusline/install.ps1 +27 -0
  158. package/agent/extensions/statusline/install.sh +24 -0
  159. package/agent/extensions/subagents/by-the-way.test.ts +29 -29
  160. package/agent/extensions/subagents/claude.test.ts +119 -119
  161. package/agent/extensions/subagents/codex.test.ts +102 -102
  162. package/agent/extensions/subagents/context-usage.test.ts +107 -107
  163. package/agent/extensions/subagents/docs/design-plan.md +568 -568
  164. package/agent/extensions/subagents/docs/effect-v4-extension-guide.md +354 -354
  165. package/agent/extensions/subagents/docs/effect-v4-notes.md +571 -571
  166. package/agent/extensions/subagents/index.ts +779 -779
  167. package/agent/extensions/subagents/install.ps1 +4 -0
  168. package/agent/extensions/subagents/install.sh +3 -0
  169. package/agent/extensions/subagents/manager.test.ts +276 -276
  170. package/agent/extensions/subagents/package-lock.json +2244 -2244
  171. package/agent/extensions/subagents/package.json +19 -19
  172. package/agent/extensions/subagents/result-delivery.test.ts +27 -27
  173. package/agent/extensions/subagents/src/backend.ts +73 -73
  174. package/agent/extensions/subagents/src/backends/claude.ts +701 -701
  175. package/agent/extensions/subagents/src/backends/codex.ts +1060 -1060
  176. package/agent/extensions/subagents/src/backends/pi.ts +575 -575
  177. package/agent/extensions/subagents/src/backends/stub.ts +300 -300
  178. package/agent/extensions/subagents/src/by-the-way.ts +21 -21
  179. package/agent/extensions/subagents/src/domain.ts +253 -253
  180. package/agent/extensions/subagents/src/format.ts +74 -74
  181. package/agent/extensions/subagents/src/manager.ts +736 -736
  182. package/agent/extensions/subagents/src/prompt.ts +92 -92
  183. package/agent/extensions/subagents/src/result-delivery.ts +20 -20
  184. package/agent/extensions/subagents/src/runtime.ts +53 -53
  185. package/agent/extensions/subagents/src/ui/takeover.ts +583 -583
  186. package/agent/extensions/subagents/src/ui/transcript.ts +201 -201
  187. package/agent/extensions/subagents/takeover.test.ts +29 -29
  188. package/agent/extensions/subagents/tsconfig.json +7 -7
  189. package/agent/extensions/taste/install.ps1 +4 -0
  190. package/agent/extensions/taste/install.sh +3 -0
  191. package/agent/extensions/todo/AGENTS.md +38 -38
  192. package/agent/extensions/todo/LICENSE +21 -21
  193. package/agent/extensions/todo/config.ts +55 -55
  194. package/agent/extensions/todo/index.ts +151 -151
  195. package/agent/extensions/todo/install.ps1 +4 -0
  196. package/agent/extensions/todo/install.sh +3 -0
  197. package/agent/extensions/todo/locales/de.json +17 -17
  198. package/agent/extensions/todo/locales/en.json +15 -15
  199. package/agent/extensions/todo/locales/es.json +17 -17
  200. package/agent/extensions/todo/locales/fr.json +17 -17
  201. package/agent/extensions/todo/locales/pt-BR.json +17 -17
  202. package/agent/extensions/todo/locales/pt.json +17 -17
  203. package/agent/extensions/todo/locales/ru.json +17 -17
  204. package/agent/extensions/todo/locales/uk.json +17 -17
  205. package/agent/extensions/todo/locales/zh.json +17 -17
  206. package/agent/extensions/todo/package-lock.json +3358 -3358
  207. package/agent/extensions/todo/package.json +67 -67
  208. package/agent/extensions/todo/state/i18n-bridge.ts +64 -64
  209. package/agent/extensions/todo/state/invariants.ts +20 -20
  210. package/agent/extensions/todo/state/replay.ts +38 -38
  211. package/agent/extensions/todo/state/selectors.ts +107 -107
  212. package/agent/extensions/todo/state/state-reducer.ts +326 -326
  213. package/agent/extensions/todo/state/state.ts +18 -18
  214. package/agent/extensions/todo/state/store.ts +82 -82
  215. package/agent/extensions/todo/state/task-graph.ts +57 -57
  216. package/agent/extensions/todo/todo-overlay.ts +200 -200
  217. package/agent/extensions/todo/todo.ts +155 -155
  218. package/agent/extensions/todo/tool/response-envelope.ts +109 -109
  219. package/agent/extensions/todo/tool/types.ts +206 -206
  220. package/agent/extensions/todo/view/format.ts +177 -177
  221. package/agent/extensions/trim-context/install.ps1 +4 -0
  222. package/agent/extensions/trim-context/install.sh +3 -0
  223. package/agent/keybindings.json +7 -7
  224. package/agent/version.txt +1 -0
  225. package/agent.bak.20260905-190020/AGENTS.md +67 -0
  226. package/agent.bak.20260905-190020/README.md +5 -0
  227. package/agent.bak.20260905-190020/extensions/ask-user/index.ts +418 -0
  228. package/agent.bak.20260905-190020/extensions/ask-user/package-lock.json +769 -0
  229. package/agent.bak.20260905-190020/extensions/ask-user/package.json +19 -0
  230. package/agent.bak.20260905-190020/extensions/ask-user/prompt.ts +45 -0
  231. package/agent.bak.20260905-190020/extensions/ask-user/tsconfig.json +7 -0
  232. package/agent.bak.20260905-190020/extensions/background-terminals/docs/implementation-guide.md +942 -0
  233. package/agent.bak.20260905-190020/extensions/background-terminals/index.ts +629 -0
  234. package/agent.bak.20260905-190020/extensions/background-terminals/install.ps1 +23 -0
  235. package/agent.bak.20260905-190020/extensions/background-terminals/install.sh +21 -0
  236. package/agent.bak.20260905-190020/extensions/background-terminals/package-lock.json +769 -0
  237. package/agent.bak.20260905-190020/extensions/background-terminals/package.json +17 -0
  238. package/agent.bak.20260905-190020/extensions/background-terminals/src/domain.ts +87 -0
  239. package/agent.bak.20260905-190020/extensions/background-terminals/src/manager.ts +907 -0
  240. package/agent.bak.20260905-190020/extensions/background-terminals/src/output.ts +84 -0
  241. package/agent.bak.20260905-190020/extensions/background-terminals/src/prompt.ts +142 -0
  242. package/agent.bak.20260905-190020/extensions/background-terminals/src/result-delivery.ts +27 -0
  243. package/agent.bak.20260905-190020/extensions/background-terminals/src/runtime.ts +36 -0
  244. package/agent.bak.20260905-190020/extensions/background-terminals/src/ui/output-view.ts +79 -0
  245. package/agent.bak.20260905-190020/extensions/background-terminals/src/ui/ps.ts +621 -0
  246. package/agent.bak.20260905-190020/extensions/background-terminals/src/widget-order.ts +121 -0
  247. package/agent.bak.20260905-190020/extensions/background-terminals/test/manager.test.ts +735 -0
  248. package/agent.bak.20260905-190020/extensions/background-terminals/test/output.test.ts +109 -0
  249. package/agent.bak.20260905-190020/extensions/background-terminals/test/prompt.test.ts +125 -0
  250. package/agent.bak.20260905-190020/extensions/background-terminals/test/ps.test.ts +82 -0
  251. package/agent.bak.20260905-190020/extensions/background-terminals/test/result-delivery.test.ts +44 -0
  252. package/agent.bak.20260905-190020/extensions/background-terminals/tsconfig.json +7 -0
  253. package/agent.bak.20260905-190020/extensions/destructive/README.md +34 -0
  254. package/agent.bak.20260905-190020/extensions/destructive/index.ts +124 -0
  255. package/agent.bak.20260905-190020/extensions/destructive/install.ps1 +23 -0
  256. package/agent.bak.20260905-190020/extensions/destructive/install.sh +21 -0
  257. package/agent.bak.20260905-190020/extensions/file-search/index.ts +459 -0
  258. package/agent.bak.20260905-190020/extensions/file-search/install.ps1 +23 -0
  259. package/agent.bak.20260905-190020/extensions/file-search/install.sh +21 -0
  260. package/agent.bak.20260905-190020/extensions/file-search/package-lock.json +2253 -0
  261. package/agent.bak.20260905-190020/extensions/file-search/package.json +23 -0
  262. package/agent.bak.20260905-190020/extensions/file-search/src/args.ts +122 -0
  263. package/agent.bak.20260905-190020/extensions/file-search/src/binaries.ts +422 -0
  264. package/agent.bak.20260905-190020/extensions/file-search/src/output.ts +126 -0
  265. package/agent.bak.20260905-190020/extensions/file-search/src/process.ts +146 -0
  266. package/agent.bak.20260905-190020/extensions/file-search/src/prompt.ts +52 -0
  267. package/agent.bak.20260905-190020/extensions/file-search/test/index.spec.ts +443 -0
  268. package/agent.bak.20260905-190020/extensions/file-search/tsconfig.json +7 -0
  269. package/agent.bak.20260905-190020/extensions/goal/README.md +50 -0
  270. package/agent.bak.20260905-190020/extensions/goal/index.ts +155 -0
  271. package/agent.bak.20260905-190020/extensions/goal/install.ps1 +23 -0
  272. package/agent.bak.20260905-190020/extensions/goal/install.sh +21 -0
  273. package/agent.bak.20260905-190020/extensions/kiln-update/README.md +25 -0
  274. package/agent.bak.20260905-190020/extensions/kiln-update/index.ts +99 -0
  275. package/agent.bak.20260905-190020/extensions/kiln-update/install.ps1 +23 -0
  276. package/agent.bak.20260905-190020/extensions/kiln-update/install.sh +21 -0
  277. package/agent.bak.20260905-190020/extensions/modelconf/PLAN.md +915 -0
  278. package/agent.bak.20260905-190020/extensions/modelconf/README.md +66 -0
  279. package/agent.bak.20260905-190020/extensions/modelconf/index.ts +296 -0
  280. package/agent.bak.20260905-190020/extensions/modelconf/install.ps1 +23 -0
  281. package/agent.bak.20260905-190020/extensions/modelconf/install.sh +21 -0
  282. package/agent.bak.20260905-190020/extensions/modelconf/package-lock.json +1809 -0
  283. package/agent.bak.20260905-190020/extensions/modelconf/package.json +13 -0
  284. package/agent.bak.20260905-190020/extensions/modelconf/src/fuzzy.ts +26 -0
  285. package/agent.bak.20260905-190020/extensions/modelconf/src/glob.ts +13 -0
  286. package/agent.bak.20260905-190020/extensions/modelconf/src/persistence.test.ts +46 -0
  287. package/agent.bak.20260905-190020/extensions/modelconf/src/persistence.ts +164 -0
  288. package/agent.bak.20260905-190020/extensions/modelconf/src/ui/ModelConfView.test.ts +75 -0
  289. package/agent.bak.20260905-190020/extensions/modelconf/src/ui/ModelConfView.ts +1101 -0
  290. package/agent.bak.20260905-190020/extensions/modelconf/tsconfig.json +15 -0
  291. package/agent.bak.20260905-190020/extensions/pi-web-access/CHANGELOG.md +690 -0
  292. package/agent.bak.20260905-190020/extensions/pi-web-access/LICENSE +21 -0
  293. package/agent.bak.20260905-190020/extensions/pi-web-access/README.md +470 -0
  294. package/agent.bak.20260905-190020/extensions/pi-web-access/SECURITY.md +5 -0
  295. package/agent.bak.20260905-190020/extensions/pi-web-access/activity.ts +101 -0
  296. package/agent.bak.20260905-190020/extensions/pi-web-access/auth-fetch.ts +148 -0
  297. package/agent.bak.20260905-190020/extensions/pi-web-access/banner.png +0 -0
  298. package/agent.bak.20260905-190020/extensions/pi-web-access/brightdata-unlocker.ts +272 -0
  299. package/agent.bak.20260905-190020/extensions/pi-web-access/chrome-cookies.ts +669 -0
  300. package/agent.bak.20260905-190020/extensions/pi-web-access/content-find.ts +139 -0
  301. package/agent.bak.20260905-190020/extensions/pi-web-access/credential-source.ts +191 -0
  302. package/agent.bak.20260905-190020/extensions/pi-web-access/data-uri-sanitize.ts +406 -0
  303. package/agent.bak.20260905-190020/extensions/pi-web-access/datalab-pdf-extract.ts +568 -0
  304. package/agent.bak.20260905-190020/extensions/pi-web-access/declared-web-links.ts +173 -0
  305. package/agent.bak.20260905-190020/extensions/pi-web-access/evidence/CONTRACT-EVIDENCE.md +496 -0
  306. package/agent.bak.20260905-190020/extensions/pi-web-access/evidence/contract-probe.mjs +140 -0
  307. package/agent.bak.20260905-190020/extensions/pi-web-access/exa.ts +526 -0
  308. package/agent.bak.20260905-190020/extensions/pi-web-access/extract.ts +1196 -0
  309. package/agent.bak.20260905-190020/extensions/pi-web-access/feature-config.ts +29 -0
  310. package/agent.bak.20260905-190020/extensions/pi-web-access/fetch-params.ts +111 -0
  311. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-adc.ts +298 -0
  312. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-api.ts +353 -0
  313. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-pdf-extract.ts +108 -0
  314. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-search.ts +21 -0
  315. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-url-context.ts +128 -0
  316. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-web-config.ts +101 -0
  317. package/agent.bak.20260905-190020/extensions/pi-web-access/gemini-web.ts +487 -0
  318. package/agent.bak.20260905-190020/extensions/pi-web-access/github-api.ts +197 -0
  319. package/agent.bak.20260905-190020/extensions/pi-web-access/github-extract.ts +746 -0
  320. package/agent.bak.20260905-190020/extensions/pi-web-access/github-issue-pr.ts +700 -0
  321. package/agent.bak.20260905-190020/extensions/pi-web-access/index.ts +1737 -0
  322. package/agent.bak.20260905-190020/extensions/pi-web-access/package-lock.json +5808 -0
  323. package/agent.bak.20260905-190020/extensions/pi-web-access/package.json +64 -0
  324. package/agent.bak.20260905-190020/extensions/pi-web-access/page-query.ts +96 -0
  325. package/agent.bak.20260905-190020/extensions/pi-web-access/pdf-extract.ts +409 -0
  326. package/agent.bak.20260905-190020/extensions/pi-web-access/pi-web-fetch-demo.mp4 +0 -0
  327. package/agent.bak.20260905-190020/extensions/pi-web-access/promise-try.d.ts +7 -0
  328. package/agent.bak.20260905-190020/extensions/pi-web-access/query-rewrite.ts +51 -0
  329. package/agent.bak.20260905-190020/extensions/pi-web-access/render-search-error.ts +170 -0
  330. package/agent.bak.20260905-190020/extensions/pi-web-access/rsc-extract.ts +338 -0
  331. package/agent.bak.20260905-190020/extensions/pi-web-access/search-types.ts +20 -0
  332. package/agent.bak.20260905-190020/extensions/pi-web-access/source-check.ts +282 -0
  333. package/agent.bak.20260905-190020/extensions/pi-web-access/ssrf-protection.ts +526 -0
  334. package/agent.bak.20260905-190020/extensions/pi-web-access/storage.ts +521 -0
  335. package/agent.bak.20260905-190020/extensions/pi-web-access/summary-model-scope.ts +125 -0
  336. package/agent.bak.20260905-190020/extensions/pi-web-access/test/auth-fetch.test.mjs +208 -0
  337. package/agent.bak.20260905-190020/extensions/pi-web-access/test/brightdata-unlocker.test.mjs +840 -0
  338. package/agent.bak.20260905-190020/extensions/pi-web-access/test/chrome-cookie-extraction.test.mjs +441 -0
  339. package/agent.bak.20260905-190020/extensions/pi-web-access/test/config-path.test.mjs +283 -0
  340. package/agent.bak.20260905-190020/extensions/pi-web-access/test/content-find.test.mjs +25 -0
  341. package/agent.bak.20260905-190020/extensions/pi-web-access/test/credential-source.test.mjs +118 -0
  342. package/agent.bak.20260905-190020/extensions/pi-web-access/test/data-uri-sanitize.test.mjs +210 -0
  343. package/agent.bak.20260905-190020/extensions/pi-web-access/test/datalab-pdf-extract.test.mjs +552 -0
  344. package/agent.bak.20260905-190020/extensions/pi-web-access/test/declared-web-links.test.mjs +212 -0
  345. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-answer-storage.test.mjs +40 -0
  346. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-cache-storage.test.mjs +334 -0
  347. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-content-domain-policy.test.mjs +95 -0
  348. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-modes.test.mjs +53 -0
  349. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-not-found-guidance.test.mjs +92 -0
  350. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-params.test.mjs +86 -0
  351. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-render-call.test.mjs +34 -0
  352. package/agent.bak.20260905-190020/extensions/pi-web-access/test/fetch-routing.test.mjs +173 -0
  353. package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-adc-auth.test.mjs +257 -0
  354. package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-api-transport.test.mjs +170 -0
  355. package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-pdf-extract.test.mjs +133 -0
  356. package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-web-cookie-opt-in.test.mjs +178 -0
  357. package/agent.bak.20260905-190020/extensions/pi-web-access/test/gemini-web-header-overflow.test.mjs +148 -0
  358. package/agent.bak.20260905-190020/extensions/pi-web-access/test/get-search-content.test.mjs +223 -0
  359. package/agent.bak.20260905-190020/extensions/pi-web-access/test/github-extract.test.mjs +378 -0
  360. package/agent.bak.20260905-190020/extensions/pi-web-access/test/github-issue-pr.test.mjs +565 -0
  361. package/agent.bak.20260905-190020/extensions/pi-web-access/test/inline-content-config.test.mjs +99 -0
  362. package/agent.bak.20260905-190020/extensions/pi-web-access/test/lazy-extract-load.test.mjs +118 -0
  363. package/agent.bak.20260905-190020/extensions/pi-web-access/test/local-video-oversize.test.mjs +52 -0
  364. package/agent.bak.20260905-190020/extensions/pi-web-access/test/package-typebox-dependency.test.mjs +50 -0
  365. package/agent.bak.20260905-190020/extensions/pi-web-access/test/page-query.test.mjs +51 -0
  366. package/agent.bak.20260905-190020/extensions/pi-web-access/test/pdf-config.test.mjs +140 -0
  367. package/agent.bak.20260905-190020/extensions/pi-web-access/test/pdf-extract.test.mjs +500 -0
  368. package/agent.bak.20260905-190020/extensions/pi-web-access/test/proxy-transport.test.mjs +286 -0
  369. package/agent.bak.20260905-190020/extensions/pi-web-access/test/query-rewrite.test.mjs +52 -0
  370. package/agent.bak.20260905-190020/extensions/pi-web-access/test/rsc-fallback.test.mjs +102 -0
  371. package/agent.bak.20260905-190020/extensions/pi-web-access/test/search-error-render.test.mjs +152 -0
  372. package/agent.bak.20260905-190020/extensions/pi-web-access/test/search-providers.test.mjs +274 -0
  373. package/agent.bak.20260905-190020/extensions/pi-web-access/test/source-check.test.mjs +179 -0
  374. package/agent.bak.20260905-190020/extensions/pi-web-access/test/ssrf-allow-ranges-config.test.mjs +205 -0
  375. package/agent.bak.20260905-190020/extensions/pi-web-access/test/ssrf-protection.test.mjs +456 -0
  376. package/agent.bak.20260905-190020/extensions/pi-web-access/test/summary-model-scope.test.mjs +106 -0
  377. package/agent.bak.20260905-190020/extensions/pi-web-access/test/tool-registration-config.test.mjs +182 -0
  378. package/agent.bak.20260905-190020/extensions/pi-web-access/test/web-search-answer-render.test.mjs +66 -0
  379. package/agent.bak.20260905-190020/extensions/pi-web-access/test/youtube-extract-errors.test.mjs +64 -0
  380. package/agent.bak.20260905-190020/extensions/pi-web-access/tsconfig.json +11 -0
  381. package/agent.bak.20260905-190020/extensions/pi-web-access/utils.ts +451 -0
  382. package/agent.bak.20260905-190020/extensions/pi-web-access/video-extract.ts +392 -0
  383. package/agent.bak.20260905-190020/extensions/pi-web-access/youtube-extract.ts +328 -0
  384. package/agent.bak.20260905-190020/extensions/shared/activity-status.ts +31 -0
  385. package/agent.bak.20260905-190020/extensions/shared/child-session.ts +148 -0
  386. package/agent.bak.20260905-190020/extensions/shared/context-utilization.ts +47 -0
  387. package/agent.bak.20260905-190020/extensions/shared/dashboard-state.ts +99 -0
  388. package/agent.bak.20260905-190020/extensions/shared/install.ps1 +23 -0
  389. package/agent.bak.20260905-190020/extensions/shared/install.sh +21 -0
  390. package/agent.bak.20260905-190020/extensions/shared/test/child-session.test.ts +270 -0
  391. package/agent.bak.20260905-190020/extensions/shared/test/context-utilization.test.ts +48 -0
  392. package/agent.bak.20260905-190020/extensions/shared/test/tool-call-timeout.test.ts +117 -0
  393. package/agent.bak.20260905-190020/extensions/shared/test/widget-order.test.ts +167 -0
  394. package/agent.bak.20260905-190020/extensions/shared/tool-call-timeout.ts +104 -0
  395. package/agent.bak.20260905-190020/extensions/skillsconf/README.md +74 -0
  396. package/agent.bak.20260905-190020/extensions/skillsconf/index.ts +92 -0
  397. package/agent.bak.20260905-190020/extensions/skillsconf/install.ps1 +23 -0
  398. package/agent.bak.20260905-190020/extensions/skillsconf/install.sh +21 -0
  399. package/agent.bak.20260905-190020/extensions/skillsconf/package-lock.json +1809 -0
  400. package/agent.bak.20260905-190020/extensions/skillsconf/package.json +18 -0
  401. package/agent.bak.20260905-190020/extensions/skillsconf/src/delete-skill.test.ts +64 -0
  402. package/agent.bak.20260905-190020/extensions/skillsconf/src/delete-skill.ts +45 -0
  403. package/agent.bak.20260905-190020/extensions/skillsconf/src/filter.test.ts +80 -0
  404. package/agent.bak.20260905-190020/extensions/skillsconf/src/filter.ts +74 -0
  405. package/agent.bak.20260905-190020/extensions/skillsconf/src/fuzzy.ts +26 -0
  406. package/agent.bak.20260905-190020/extensions/skillsconf/src/persistence.test.ts +72 -0
  407. package/agent.bak.20260905-190020/extensions/skillsconf/src/persistence.ts +169 -0
  408. package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/SkillConfView.test.ts +337 -0
  409. package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/SkillConfView.ts +758 -0
  410. package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/text-input.ts +91 -0
  411. package/agent.bak.20260905-190020/extensions/skillsconf/src/ui/tui-helpers.ts +144 -0
  412. package/agent.bak.20260905-190020/extensions/skillsconf/tsconfig.json +15 -0
  413. package/agent.bak.20260905-190020/extensions/statusline/install.ps1 +23 -0
  414. package/agent.bak.20260905-190020/extensions/statusline/install.sh +21 -0
  415. package/agent.bak.20260905-190020/extensions/subagents/docs/design-plan.md +568 -0
  416. package/agent.bak.20260905-190020/extensions/subagents/docs/effect-v4-extension-guide.md +354 -0
  417. package/agent.bak.20260905-190020/extensions/subagents/docs/effect-v4-notes.md +571 -0
  418. package/agent.bak.20260905-190020/extensions/subagents/index.ts +826 -0
  419. package/agent.bak.20260905-190020/extensions/subagents/install.ps1 +23 -0
  420. package/agent.bak.20260905-190020/extensions/subagents/install.sh +21 -0
  421. package/agent.bak.20260905-190020/extensions/subagents/package-lock.json +2244 -0
  422. package/agent.bak.20260905-190020/extensions/subagents/package.json +19 -0
  423. package/agent.bak.20260905-190020/extensions/subagents/src/backend.ts +73 -0
  424. package/agent.bak.20260905-190020/extensions/subagents/src/backends/claude.ts +701 -0
  425. package/agent.bak.20260905-190020/extensions/subagents/src/backends/codex.ts +1060 -0
  426. package/agent.bak.20260905-190020/extensions/subagents/src/backends/pi.ts +575 -0
  427. package/agent.bak.20260905-190020/extensions/subagents/src/backends/stub.ts +300 -0
  428. package/agent.bak.20260905-190020/extensions/subagents/src/by-the-way.ts +21 -0
  429. package/agent.bak.20260905-190020/extensions/subagents/src/domain.ts +253 -0
  430. package/agent.bak.20260905-190020/extensions/subagents/src/format.ts +74 -0
  431. package/agent.bak.20260905-190020/extensions/subagents/src/manager.ts +736 -0
  432. package/agent.bak.20260905-190020/extensions/subagents/src/prompt.ts +92 -0
  433. package/agent.bak.20260905-190020/extensions/subagents/src/result-delivery.ts +20 -0
  434. package/agent.bak.20260905-190020/extensions/subagents/src/runtime.ts +53 -0
  435. package/agent.bak.20260905-190020/extensions/subagents/src/ui/takeover.ts +583 -0
  436. package/agent.bak.20260905-190020/extensions/subagents/src/ui/transcript.ts +201 -0
  437. package/agent.bak.20260905-190020/extensions/subagents/src/widget-order.ts +121 -0
  438. package/agent.bak.20260905-190020/extensions/subagents/test/by-the-way.test.ts +29 -0
  439. package/agent.bak.20260905-190020/extensions/subagents/test/claude.test.ts +119 -0
  440. package/agent.bak.20260905-190020/extensions/subagents/test/codex.test.ts +102 -0
  441. package/agent.bak.20260905-190020/extensions/subagents/test/context-usage.test.ts +107 -0
  442. package/agent.bak.20260905-190020/extensions/subagents/test/manager.test.ts +276 -0
  443. package/agent.bak.20260905-190020/extensions/subagents/test/result-delivery.test.ts +27 -0
  444. package/agent.bak.20260905-190020/extensions/subagents/test/takeover.test.ts +29 -0
  445. package/agent.bak.20260905-190020/extensions/subagents/tsconfig.json +7 -0
  446. package/agent.bak.20260905-190020/extensions/taste/index.ts +443 -0
  447. package/agent.bak.20260905-190020/extensions/taste/install.ps1 +23 -0
  448. package/agent.bak.20260905-190020/extensions/taste/install.sh +21 -0
  449. package/agent.bak.20260905-190020/extensions/todo/AGENTS.md +38 -0
  450. package/agent.bak.20260905-190020/extensions/todo/LICENSE +21 -0
  451. package/agent.bak.20260905-190020/extensions/todo/config.ts +55 -0
  452. package/agent.bak.20260905-190020/extensions/todo/index.ts +151 -0
  453. package/agent.bak.20260905-190020/extensions/todo/install.ps1 +23 -0
  454. package/agent.bak.20260905-190020/extensions/todo/install.sh +21 -0
  455. package/agent.bak.20260905-190020/extensions/todo/locales/de.json +17 -0
  456. package/agent.bak.20260905-190020/extensions/todo/locales/en.json +15 -0
  457. package/agent.bak.20260905-190020/extensions/todo/locales/es.json +17 -0
  458. package/agent.bak.20260905-190020/extensions/todo/locales/fr.json +17 -0
  459. package/agent.bak.20260905-190020/extensions/todo/locales/pt-BR.json +17 -0
  460. package/agent.bak.20260905-190020/extensions/todo/locales/pt.json +17 -0
  461. package/agent.bak.20260905-190020/extensions/todo/locales/ru.json +17 -0
  462. package/agent.bak.20260905-190020/extensions/todo/locales/uk.json +17 -0
  463. package/agent.bak.20260905-190020/extensions/todo/locales/zh.json +17 -0
  464. package/agent.bak.20260905-190020/extensions/todo/package-lock.json +3358 -0
  465. package/agent.bak.20260905-190020/extensions/todo/package.json +67 -0
  466. package/agent.bak.20260905-190020/extensions/todo/state/i18n-bridge.ts +64 -0
  467. package/agent.bak.20260905-190020/extensions/todo/state/invariants.ts +20 -0
  468. package/agent.bak.20260905-190020/extensions/todo/state/replay.ts +38 -0
  469. package/agent.bak.20260905-190020/extensions/todo/state/selectors.ts +107 -0
  470. package/agent.bak.20260905-190020/extensions/todo/state/state-reducer.ts +326 -0
  471. package/agent.bak.20260905-190020/extensions/todo/state/state.ts +18 -0
  472. package/agent.bak.20260905-190020/extensions/todo/state/store.ts +82 -0
  473. package/agent.bak.20260905-190020/extensions/todo/state/task-graph.ts +57 -0
  474. package/agent.bak.20260905-190020/extensions/todo/todo-overlay.ts +204 -0
  475. package/agent.bak.20260905-190020/extensions/todo/todo.ts +155 -0
  476. package/agent.bak.20260905-190020/extensions/todo/tool/response-envelope.ts +109 -0
  477. package/agent.bak.20260905-190020/extensions/todo/tool/types.ts +206 -0
  478. package/agent.bak.20260905-190020/extensions/todo/view/format.ts +177 -0
  479. package/agent.bak.20260905-190020/extensions/todo/widget-order.ts +121 -0
  480. package/agent.bak.20260905-190020/extensions/trim-context/README.md +54 -0
  481. package/agent.bak.20260905-190020/extensions/trim-context/index.ts +487 -0
  482. package/agent.bak.20260905-190020/extensions/trim-context/install.ps1 +23 -0
  483. package/agent.bak.20260905-190020/extensions/trim-context/install.sh +21 -0
  484. package/agent.bak.20260905-190020/keybindings.json +7 -0
  485. package/bin/kiln.js +588 -358
  486. package/package.json +27 -21
  487. package/agent/install.ps1 +0 -527
  488. package/agent/install.sh +0 -511
  489. /package/{agent/extensions/status line → agent.bak.20260905-190020/extensions/ask-user}/install.ps1 +0 -0
  490. /package/{agent/extensions/status line → agent.bak.20260905-190020/extensions/ask-user}/install.sh +0 -0
  491. /package/{agent/extensions/status line → agent.bak.20260905-190020/extensions/statusline}/index.ts +0 -0
@@ -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
+ }