@iowarp/clio-coder 0.3.1 → 0.3.3

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 (601) hide show
  1. package/CHANGELOG.md +233 -373
  2. package/CONTRIBUTING.md +23 -23
  3. package/README.md +284 -613
  4. package/dist/{acp-FPR54DGL.js → acp-P2AQILE2.js} +43 -53
  5. package/dist/{agents-OGPIHPJH.js → agents-72W3BI7I.js} +43 -26
  6. package/dist/assets/codewiki.json +1 -1
  7. package/dist/{auth-IC3K6NIZ.js → auth-5TWEIYDN.js} +20 -12
  8. package/dist/chunk-2DJ2KNFG.js +2095 -0
  9. package/dist/{chunk-IS3ONKU3.js → chunk-2IR2NMPA.js} +6 -4
  10. package/dist/chunk-2SFS6XQE.js +122 -0
  11. package/dist/{chunk-PV4JUBVJ.js → chunk-2TLUCQVG.js} +40 -21
  12. package/dist/chunk-2VTFPG5O.js +48 -0
  13. package/dist/chunk-4BJ5BYCE.js +61 -0
  14. package/dist/{chunk-474KN5II.js → chunk-4BPJXDWC.js} +111 -181
  15. package/dist/chunk-4VP4KH3K.js +962 -0
  16. package/dist/chunk-4XUGQOHA.js +797 -0
  17. package/dist/chunk-4ZG3XFUR.js +77 -0
  18. package/dist/chunk-5B2AEOW5.js +5407 -0
  19. package/dist/{chunk-K2ITRMHZ.js → chunk-5TSRNF4G.js} +6 -138
  20. package/dist/{chunk-4QKXUHSR.js → chunk-5UFT4SUX.js} +70 -20
  21. package/dist/{chunk-OLBBMFRD.js → chunk-5UUP6MWO.js} +24 -62
  22. package/dist/chunk-65DEGPJ6.js +52 -0
  23. package/dist/chunk-6EJMN2Y3.js +17 -0
  24. package/dist/chunk-6N5PTWMY.js +136 -0
  25. package/dist/chunk-6SGHMWE3.js +277 -0
  26. package/dist/chunk-6XLNIQDB.js +27 -0
  27. package/dist/chunk-7CR24IG7.js +242 -0
  28. package/dist/chunk-7MNJORFF.js +22 -0
  29. package/dist/{chunk-KY56HMHH.js → chunk-A3CYT5EX.js} +125 -31
  30. package/dist/chunk-AGYYIBLL.js +1069 -0
  31. package/dist/{chunk-GB6QRBXN.js → chunk-APJ265NV.js} +54 -1187
  32. package/dist/{chunk-673JJUWJ.js → chunk-BMEMKKIT.js} +2 -2
  33. package/dist/chunk-CBCAPZAA.js +229 -0
  34. package/dist/chunk-CMZWFGD2.js +352 -0
  35. package/dist/chunk-COU2UHX6.js +400 -0
  36. package/dist/chunk-DSELYM6W.js +1077 -0
  37. package/dist/chunk-DUYJ5IO6.js +644 -0
  38. package/dist/chunk-ECH6PKUQ.js +39 -0
  39. package/dist/chunk-ED4KHGC3.js +143 -0
  40. package/dist/chunk-EKMEHE4H.js +340 -0
  41. package/dist/chunk-FCSXB6T2.js +338 -0
  42. package/dist/chunk-FJ3H4MN5.js +48 -0
  43. package/dist/{chunk-RPTR2H26.js → chunk-FNTMWMX5.js} +21 -15
  44. package/dist/chunk-FQ4SKYE4.js +29 -0
  45. package/dist/chunk-G4BMMOKF.js +182 -0
  46. package/dist/{chunk-ZPY3JZ5E.js → chunk-GGXXDWE4.js} +183 -1233
  47. package/dist/chunk-HC4CLZ2Y.js +68 -0
  48. package/dist/{chunk-LU4TK2PR.js → chunk-HFSBBKSQ.js} +5 -56
  49. package/dist/{chunk-PIUMUEMV.js → chunk-HKIYEGME.js} +10 -6
  50. package/dist/chunk-I4HZDVNP.js +73 -0
  51. package/dist/chunk-IKCO5N3L.js +162 -0
  52. package/dist/chunk-IR4CFBFN.js +56 -0
  53. package/dist/{chunk-R5KLMSBV.js → chunk-J5Q24KAG.js} +2 -2
  54. package/dist/chunk-J7CWMCQD.js +255 -0
  55. package/dist/{chunk-K5XEMXTI.js → chunk-JVCV3ICN.js} +1 -1
  56. package/dist/chunk-KZWTDYJF.js +217 -0
  57. package/dist/chunk-LBMZMYH2.js +285 -0
  58. package/dist/{chunk-G34LV2PF.js → chunk-LM5TQCJZ.js} +84 -170
  59. package/dist/chunk-LW6DSM3M.js +5135 -0
  60. package/dist/chunk-LWLEKMDQ.js +3482 -0
  61. package/dist/{chunk-H6F6BYOH.js → chunk-LZSJBIVT.js} +7003 -7434
  62. package/dist/{chunk-HQQID6OA.js → chunk-M6SHUN7Q.js} +5 -5
  63. package/dist/{chunk-FST4FYJB.js → chunk-MFFY33HR.js} +99 -140
  64. package/dist/{chunk-BSU2YIWB.js → chunk-MVVUPGPW.js} +131 -136
  65. package/dist/chunk-OAO4GE4M.js +619 -0
  66. package/dist/{chunk-Q3RUPKEJ.js → chunk-OC7FIQPC.js} +58 -189
  67. package/dist/chunk-OKGUZO2U.js +34 -0
  68. package/dist/{chunk-GAEBEQVI.js → chunk-OOJYHWRB.js} +32 -346
  69. package/dist/{chunk-Q5WJOSJ7.js → chunk-OQ33BKR3.js} +2 -1
  70. package/dist/chunk-OQE5J4C6.js +73 -0
  71. package/dist/{chunk-KKNLWXI6.js → chunk-ORBHGJC5.js} +8 -8
  72. package/dist/{chunk-MAR7Y6HW.js → chunk-PAJK6MAQ.js} +23 -16
  73. package/dist/{chunk-M5T5VO65.js → chunk-PIWWS5BL.js} +837 -635
  74. package/dist/chunk-POHLU5DW.js +1186 -0
  75. package/dist/chunk-QKMUKYO7.js +4961 -0
  76. package/dist/chunk-SRDMMSEP.js +16405 -0
  77. package/dist/chunk-SST6Z5JA.js +80 -0
  78. package/dist/chunk-STBPMHSX.js +2456 -0
  79. package/dist/chunk-T6YILFSB.js +80 -0
  80. package/dist/chunk-TZK7PACC.js +174 -0
  81. package/dist/chunk-TZTZS7QK.js +227 -0
  82. package/dist/{chunk-ASND7OZK.js → chunk-UFIIWP2H.js} +13 -13
  83. package/dist/chunk-UOV2BYIW.js +107 -0
  84. package/dist/{chunk-PFEFKVGL.js → chunk-V6RTAOC2.js} +13 -11
  85. package/dist/chunk-VAKQQHWR.js +434 -0
  86. package/dist/chunk-VG7TBQIY.js +128 -0
  87. package/dist/chunk-VJWL6YS5.js +244 -0
  88. package/dist/{chunk-EYOKLTMF.js → chunk-VPAYEGVX.js} +17 -3
  89. package/dist/chunk-WEH5XRJQ.js +32 -0
  90. package/dist/chunk-X4RCMKVQ.js +641 -0
  91. package/dist/{chunk-TEKV33Q5.js → chunk-X6IAEBZR.js} +65 -33
  92. package/dist/chunk-XBXAASKX.js +18 -0
  93. package/dist/chunk-XN3L4EYL.js +46 -0
  94. package/dist/{chunk-RDLVBZEO.js → chunk-YCWGATWI.js} +6 -4
  95. package/dist/chunk-YHZX5GEU.js +193 -0
  96. package/dist/chunk-YXLYO42X.js +91 -0
  97. package/dist/{chunk-NMOX6HFD.js → chunk-ZDOOVTXZ.js} +29 -77
  98. package/dist/chunk-ZI647VB5.js +37 -0
  99. package/dist/{chunk-C4PTHK7P.js → chunk-ZWLZP4ZT.js} +5 -5
  100. package/dist/chunk-ZWMF7253.js +1882 -0
  101. package/dist/cli/index.js +62 -54
  102. package/dist/clio-JOU4FXVA.js +25 -0
  103. package/dist/code-nav-7AX6FYE6.js +600 -0
  104. package/dist/codewiki/build-worker.js +66 -0
  105. package/dist/compile-cache-CVJMMODC.js +18 -0
  106. package/dist/{components-DMAOEKFB.js → components-KELWS457.js} +11 -6
  107. package/dist/{config-IRUQ7SE4.js → config-XCDVKR23.js} +92 -55
  108. package/dist/configure-4GAP54ZW.js +42 -0
  109. package/dist/{context-5RADCKTR.js → context-4UOGGLQ5.js} +71 -35
  110. package/dist/context-5VKGUVJJ.js +866 -0
  111. package/dist/{context-3KWFLHJG.js → context-77FM5DV5.js} +15 -13
  112. package/dist/{context-clear-7TSNPAAI.js → context-clear-XXJRLCJJ.js} +54 -28
  113. package/dist/{context-index-W4RLWOQH.js → context-index-BZ4UYMTC.js} +30 -24
  114. package/dist/dispatch-runner-QPRDDBDX.js +1997 -0
  115. package/dist/{docs-5AWSPS37.js → docs-2C2LTVT2.js} +23 -10
  116. package/dist/{doctor-UC5NAJYQ.js → doctor-HR46URBJ.js} +27 -17
  117. package/dist/{eval-U6TJHRLX.js → eval-XSSNATB4.js} +29 -16
  118. package/dist/{evidence-YEGUW4L3.js → evidence-6HG2PY2B.js} +46 -26
  119. package/dist/{evolve-TXARCTPG.js → evolve-K7YU3NCY.js} +45 -25
  120. package/dist/{extensions-OZFJ3A3G.js → extensions-QVDOHDGJ.js} +16 -7
  121. package/dist/{fleet-6G3DHNYE.js → fleet-VY3HHKN6.js} +163 -54
  122. package/dist/{fleet-preflight-DSNT37JK.js → fleet-preflight-DDN536IT.js} +7 -4
  123. package/dist/{init-KZ5QTF6M.js → init-JYGXI3FK.js} +69 -32
  124. package/dist/{memory-73ESV5YC.js → memory-WFZMGYHX.js} +48 -27
  125. package/dist/{models-A4PVNWJK.js → models-I5QWSEOM.js} +39 -25
  126. package/dist/monitor-GE4ID3IA.js +661 -0
  127. package/dist/{chunk-FCIH3BIZ.js → orchestrator-EM5MC3HM.js} +15979 -12407
  128. package/dist/{paths-C4H6IV77.js → paths-UXLN5YYZ.js} +10 -5
  129. package/dist/{preload-6WVMHX3A.js → preload-P6DGH2PZ.js} +2 -2
  130. package/dist/{reset-BGW6OGMV.js → reset-L2FQEE3E.js} +16 -10
  131. package/dist/{run-YTPEYQOH.js → run-ZU3QMZPZ.js} +101 -61
  132. package/dist/{share-YIFFV4NQ.js → share-S5BZQC5I.js} +15 -8
  133. package/dist/{skills-2V6RA3OQ.js → skills-X5VXCRNQ.js} +34 -14
  134. package/dist/{skills-eval-S2TVJO4F.js → skills-eval-WKIHWTHR.js} +70 -34
  135. package/dist/steer-GGWFUJUD.js +77 -0
  136. package/dist/{targets-TYXLPB23.js → targets-SNCPI2NR.js} +43 -27
  137. package/dist/terminal-lease-BNAHVHBS.js +395 -0
  138. package/dist/{trace-GGOJ6Q6Z.js → trace-PNCASAXC.js} +41 -16
  139. package/dist/{chunk-N6F52NLF.js → tree-sitter-HGKH6LG4.js} +28 -2306
  140. package/dist/{uninstall-LLLT4F4W.js → uninstall-FZCQCDKC.js} +10 -5
  141. package/dist/{upgrade-33G2LMM5.js → upgrade-JQHHPQ4K.js} +45 -25
  142. package/dist/{usage-ZAFSXKKG.js → usage-OR4O5SMZ.js} +62 -31
  143. package/dist/verify-375KUB3Y.js +716 -0
  144. package/dist/web-fetch-2YHJ3KTG.js +638 -0
  145. package/dist/{wiki-generate-NUQCVOQ3.js → wiki-generate-UEXP2ARI.js} +74 -34
  146. package/dist/worker/entry.js +221 -36
  147. package/dist/workspace-G4ZWUIPR.js +22 -0
  148. package/docs/README.md +22 -17
  149. package/docs/acp.md +168 -16
  150. package/docs/alcf-provider.md +1 -1
  151. package/docs/architecture.md +136 -7
  152. package/docs/artifact-versions.md +1 -1
  153. package/docs/built-in-agents.md +1 -1
  154. package/docs/capacity-and-scheduling.md +1 -1
  155. package/docs/commands-and-modes.md +114 -71
  156. package/docs/config-knobs-audit.md +1 -3
  157. package/docs/configuration-and-targets.md +174 -46
  158. package/docs/context-engine.md +29 -6
  159. package/docs/development-pipeline.md +26 -1
  160. package/docs/dispatch-architecture-rationale.md +1 -1
  161. package/docs/documentation-coverage.md +2 -2
  162. package/docs/documentation-guide.md +1 -1
  163. package/docs/environment-variables.md +13 -5
  164. package/docs/eval-runner.md +1 -1
  165. package/docs/evals-internal.md +1 -1
  166. package/docs/evidence-and-memory.md +6 -2
  167. package/docs/evolution.md +2 -2
  168. package/docs/exit-codes-and-output.md +15 -9
  169. package/docs/extensions-and-sharing.md +9 -9
  170. package/docs/fleet-dispatch.md +7 -5
  171. package/docs/git-commit-provenance.md +120 -0
  172. package/docs/glossary.md +1 -1
  173. package/docs/installation-and-lifecycle.md +34 -27
  174. package/docs/middleware-and-components.md +1 -1
  175. package/docs/model-catalog.md +45 -14
  176. package/docs/observability.md +8 -5
  177. package/docs/performance-methodology.md +491 -0
  178. package/docs/pi-boundary.md +72 -0
  179. package/docs/proactive-memory.md +3 -3
  180. package/docs/prompt-envelope-and-tools.md +24 -3
  181. package/docs/provider-adapter-cookbook.md +57 -4
  182. package/docs/release-cut-checklist.md +129 -115
  183. package/docs/safety-model.md +9 -5
  184. package/docs/scientific-validation.md +3 -3
  185. package/docs/session-lifecycle.md +55 -12
  186. package/docs/skills-marketplace.md +12 -8
  187. package/docs/time-conventions.md +1 -1
  188. package/docs/tool-usage.md +3 -3
  189. package/docs/trace-store.md +1 -1
  190. package/docs/troubleshooting.md +10 -7
  191. package/docs/tui-design.md +47 -10
  192. package/docs/worker-dispatch-mechanics.md +1 -1
  193. package/package.json +19 -22
  194. package/skills/coding/ast-grep/SKILL.md +136 -0
  195. package/skills/coding/ast-grep/evals.md +56 -0
  196. package/skills/coding/ast-grep/references/rule_reference.md +297 -0
  197. package/skills/coding/coding-standards/SKILL.md +113 -0
  198. package/skills/coding/coding-standards/evals.md +34 -0
  199. package/skills/coding/prototype/SKILL.md +86 -0
  200. package/skills/coding/prototype/evals.md +42 -0
  201. package/skills/coding/prototype/references/LOGIC.md +67 -0
  202. package/skills/coding/prototype/references/UI.md +112 -0
  203. package/skills/coding/tdd/SKILL.md +101 -0
  204. package/skills/coding/tdd/evals.md +41 -0
  205. package/skills/coding/tdd/references/mocking.md +59 -0
  206. package/skills/coding/tdd/references/tests.md +77 -0
  207. package/skills/context/context-handoff/SKILL.md +126 -0
  208. package/skills/context/context-handoff/evals.md +57 -0
  209. package/skills/context/context-handoff/scripts/new-handoff.sh +26 -0
  210. package/skills/context/context-prime/SKILL.md +95 -0
  211. package/skills/context/context-prime/evals.md +54 -0
  212. package/skills/meta/clio-dev/SKILL.md +91 -0
  213. package/skills/meta/clio-dev/evals.md +45 -0
  214. package/skills/meta/clio-test/SKILL.md +130 -0
  215. package/skills/meta/clio-test/evals.md +43 -0
  216. package/skills/meta/clio-test/references/harness.md +97 -0
  217. package/skills/meta/clio-test/references/test-map.md +59 -0
  218. package/skills/meta/credentials/SKILL.md +125 -0
  219. package/skills/meta/credentials/evals.md +104 -0
  220. package/skills/meta/find-skills/SKILL.md +72 -0
  221. package/skills/meta/find-skills/evals.md +47 -0
  222. package/skills/meta/herdr/SKILL.md +127 -0
  223. package/skills/meta/herdr/evals.md +38 -0
  224. package/skills/meta/skill-craft/SKILL.md +102 -0
  225. package/skills/meta/skill-craft/evals.md +41 -0
  226. package/skills/planning/architecture/SKILL.md +129 -0
  227. package/skills/planning/architecture/evals.md +36 -0
  228. package/skills/planning/backlog/SKILL.md +90 -0
  229. package/skills/planning/backlog/evals.md +43 -0
  230. package/skills/planning/prd/SKILL.md +82 -0
  231. package/skills/planning/prd/evals.md +49 -0
  232. package/skills/planning/product-intent/SKILL.md +112 -0
  233. package/skills/planning/product-intent/evals.md +36 -0
  234. package/skills/planning/tech-spec/SKILL.md +115 -0
  235. package/skills/planning/tech-spec/evals.md +47 -0
  236. package/skills/registry.yaml +136 -0
  237. package/skills/research/arxiv-literature/SKILL.md +104 -0
  238. package/skills/research/arxiv-literature/evals.md +58 -0
  239. package/skills/research/experiment-protocol/SKILL.md +122 -0
  240. package/skills/research/experiment-protocol/evals.md +91 -0
  241. package/skills/research/scientific-debugging/SKILL.md +119 -0
  242. package/skills/research/scientific-debugging/evals.md +138 -0
  243. package/skills/research/scientific-modernization/SKILL.md +138 -0
  244. package/skills/research/scientific-modernization/evals.md +84 -0
  245. package/skills/workflow/design-council/SKILL.md +139 -0
  246. package/skills/workflow/design-council/evals.md +97 -0
  247. package/skills/workflow/grill-me/SKILL.md +186 -0
  248. package/skills/workflow/grill-me/evals.md +78 -0
  249. package/skills/workflow/workflow-distiller/SKILL.md +136 -0
  250. package/skills/workflow/workflow-distiller/evals.md +107 -0
  251. package/src/cli/acp.ts +31 -4
  252. package/src/cli/clio.ts +68 -6
  253. package/src/cli/config-inspect.ts +28 -22
  254. package/src/cli/configure.ts +47 -9
  255. package/src/cli/context-clear.ts +2 -2
  256. package/src/cli/context-index.ts +21 -23
  257. package/src/cli/context.ts +13 -8
  258. package/src/cli/default-target.ts +9 -17
  259. package/src/cli/docs.ts +11 -5
  260. package/src/cli/evidence.ts +4 -1
  261. package/src/cli/extensions.ts +10 -1
  262. package/src/cli/fleet.ts +47 -6
  263. package/src/cli/index.ts +55 -26
  264. package/src/cli/memory.ts +3 -1
  265. package/src/cli/models.ts +1 -1
  266. package/src/cli/modes/json-stream.ts +37 -1
  267. package/src/cli/modes/print.ts +24 -9
  268. package/src/cli/run.ts +2 -2
  269. package/src/cli/skills-eval.ts +23 -8
  270. package/src/cli/skills.ts +19 -4
  271. package/src/cli/targets.ts +4 -0
  272. package/src/cli/text-layout.ts +15 -5
  273. package/src/cli/trace.ts +62 -14
  274. package/src/cli/upgrade.ts +18 -2
  275. package/src/cli/usage.ts +10 -3
  276. package/src/cli/wiki-generate.ts +2 -1
  277. package/src/core/agent-environment.ts +7 -0
  278. package/src/core/bash-exec.ts +72 -1
  279. package/src/core/boot-trace.ts +9 -4
  280. package/src/core/bus-events.ts +20 -4
  281. package/src/core/commit-attribution.ts +157 -0
  282. package/src/core/compile-cache.ts +159 -0
  283. package/src/core/config.ts +131 -2
  284. package/src/core/defaults.ts +39 -5
  285. package/src/core/domain-loader.ts +12 -5
  286. package/src/core/git-commit-attribution.ts +387 -0
  287. package/src/core/incomplete-installation.ts +45 -0
  288. package/src/core/response-schema.ts +1 -1
  289. package/src/core/safe-exec.ts +13 -1
  290. package/src/core/settings-layers.ts +155 -21
  291. package/src/core/skill-activation.ts +1 -1
  292. package/src/core/startup-timer.ts +3 -3
  293. package/src/core/state-file-lock.ts +13 -1
  294. package/src/core/termination.ts +78 -5
  295. package/src/domains/config/classify.ts +15 -3
  296. package/src/domains/config/extension.ts +19 -13
  297. package/src/domains/config/index.ts +10 -0
  298. package/src/domains/config/keybindings.ts +45 -9
  299. package/src/domains/context/bootstrap-prompt.ts +1 -1
  300. package/src/domains/context/bootstrap.ts +111 -18
  301. package/src/domains/context/clear.ts +16 -11
  302. package/src/domains/context/clio-md.ts +111 -9
  303. package/src/domains/context/codewiki/artifact.ts +400 -0
  304. package/src/domains/context/codewiki/build-worker-protocol.ts +24 -0
  305. package/src/domains/context/codewiki/build-worker.ts +54 -0
  306. package/src/domains/context/codewiki/coordinator.ts +182 -0
  307. package/src/domains/context/codewiki/indexer.ts +59 -144
  308. package/src/domains/context/codewiki/paths.ts +67 -0
  309. package/src/domains/context/codewiki/schema.ts +80 -0
  310. package/src/domains/context/codewiki/tree-sitter.ts +1 -1
  311. package/src/domains/context/contract.ts +11 -5
  312. package/src/domains/context/extension.ts +94 -143
  313. package/src/domains/context/fingerprint.ts +3 -1
  314. package/src/domains/context/index.ts +12 -22
  315. package/src/domains/context/project-metadata.ts +19 -0
  316. package/src/domains/context/prompt-context.ts +9 -10
  317. package/src/domains/context/refresh.ts +29 -21
  318. package/src/domains/context/runtime.ts +17 -0
  319. package/src/domains/context/wiki/generate.ts +39 -34
  320. package/src/domains/context/wiki/plan.ts +1 -1
  321. package/src/domains/context/wiki/prompts.ts +21 -8
  322. package/src/domains/dispatch/code-step.ts +20 -1
  323. package/src/domains/dispatch/extension.ts +158 -21
  324. package/src/domains/dispatch/failure-classification.ts +6 -0
  325. package/src/domains/dispatch/fleet-commit-attribution.ts +56 -0
  326. package/src/domains/dispatch/orphan-recovery.ts +50 -8
  327. package/src/domains/dispatch/receipt-integrity.ts +5 -0
  328. package/src/domains/dispatch/state.ts +31 -6
  329. package/src/domains/dispatch/transport.ts +2 -1
  330. package/src/domains/dispatch/types.ts +14 -0
  331. package/src/domains/dispatch/worker-spawn.ts +21 -2
  332. package/src/domains/eval/metrics/context.ts +1 -1
  333. package/src/domains/eval/types.ts +0 -1
  334. package/src/domains/evidence/build.ts +41 -1
  335. package/src/domains/lifecycle/migrations/2026-08-18-lmstudio-runtime-id.ts +52 -0
  336. package/src/domains/lifecycle/migrations/index.ts +24 -4
  337. package/src/domains/middleware/hooks-io.ts +12 -0
  338. package/src/domains/middleware/skills-reminder.ts +30 -15
  339. package/src/domains/prompts/compiler.ts +142 -84
  340. package/src/domains/prompts/contract.ts +18 -2
  341. package/src/domains/prompts/extension.ts +39 -7
  342. package/src/domains/prompts/fragment-loader.ts +0 -1
  343. package/src/domains/prompts/fragments/identity/clio.md +2 -4
  344. package/src/domains/prompts/fragments/identity/docs-routing.md +10 -0
  345. package/src/domains/prompts/fragments/identity/self-awareness.md +1 -45
  346. package/src/domains/prompts/fragments/operating/contract.md +4 -50
  347. package/src/domains/prompts/fragments/operating/delegation.md +42 -0
  348. package/src/domains/prompts/fragments/operating/skills.md +26 -0
  349. package/src/domains/prompts/fragments/operating/worker.md +16 -0
  350. package/src/domains/prompts/fragments/safety/auto-edit.md +5 -5
  351. package/src/domains/prompts/fragments/safety/full-auto.md +3 -3
  352. package/src/domains/prompts/fragments/safety/read-only.md +4 -4
  353. package/src/domains/prompts/fragments/safety/suggest.md +2 -2
  354. package/src/domains/prompts/fragments/wiki/page.md +10 -0
  355. package/src/domains/prompts/fragments/wiki/plan.md +10 -0
  356. package/src/domains/prompts/preload.ts +3 -3
  357. package/src/domains/providers/auth/api-key.ts +1 -1
  358. package/src/domains/providers/auth/backend-file.ts +20 -10
  359. package/src/domains/providers/auth/backend-memory.ts +59 -4
  360. package/src/domains/providers/auth/boot-status.ts +65 -0
  361. package/src/domains/providers/auth/oauth.ts +2 -1
  362. package/src/domains/providers/auth/storage.ts +97 -38
  363. package/src/domains/providers/capabilities.ts +12 -4
  364. package/src/domains/providers/contract.ts +15 -4
  365. package/src/domains/providers/extension.ts +18 -6
  366. package/src/domains/providers/model-runtime-capabilities.ts +15 -4
  367. package/src/domains/providers/models/local-models/clio-local-coding-targets.yaml +118 -35
  368. package/src/domains/providers/plugins.ts +5 -3
  369. package/src/domains/providers/probe/fingerprint.ts +25 -5
  370. package/src/domains/providers/registry.ts +31 -10
  371. package/src/domains/providers/runtimes/boot-manifest.ts +55 -0
  372. package/src/domains/providers/runtimes/builtins.ts +2 -2
  373. package/src/domains/providers/runtimes/common/lmstudio-http.ts +423 -0
  374. package/src/domains/providers/runtimes/common/local-synth.ts +6 -7
  375. package/src/domains/providers/runtimes/local-native/lmstudio.ts +241 -0
  376. package/src/domains/providers/support.ts +6 -3
  377. package/src/domains/providers/types/local-model-quirks.ts +7 -9
  378. package/src/domains/providers/types/runtime-descriptor.ts +12 -1
  379. package/src/domains/providers/types/target-descriptor.ts +22 -0
  380. package/src/domains/resources/contract.ts +0 -1
  381. package/src/domains/resources/extension.ts +1 -3
  382. package/src/domains/resources/loader.ts +3 -4
  383. package/src/domains/resources/prompts/loader.ts +16 -2
  384. package/src/domains/resources/prompts/substitute.ts +1 -65
  385. package/src/domains/resources/skills/content-hash.ts +2 -0
  386. package/src/domains/resources/skills/install.ts +17 -0
  387. package/src/domains/resources/skills/loader.ts +17 -10
  388. package/src/domains/resources/skills/marketplace.ts +55 -9
  389. package/src/domains/safety/action-classifier.ts +4 -2
  390. package/src/domains/safety/audit.ts +8 -2
  391. package/src/domains/safety/extension.ts +1 -1
  392. package/src/domains/session/compaction/branch-summary.ts +3 -2
  393. package/src/domains/session/compaction/cut-point.ts +2 -1
  394. package/src/domains/session/compaction/tokens.ts +2 -1
  395. package/src/domains/session/context-ledger.ts +14 -0
  396. package/src/domains/session/contract.ts +15 -0
  397. package/src/domains/session/decision-board.ts +190 -0
  398. package/src/domains/session/entries.ts +66 -3
  399. package/src/domains/session/extension.ts +93 -12
  400. package/src/domains/session/retry.ts +10 -18
  401. package/src/domains/session/session-artifacts.ts +107 -0
  402. package/src/domains/session/task-board.ts +207 -13
  403. package/src/domains/session/tree/active-path.ts +44 -5
  404. package/src/domains/session/tree/fork.ts +26 -27
  405. package/src/domains/session/tree/preview.ts +2 -2
  406. package/src/domains/session/workspace/git-probe.ts +17 -11
  407. package/src/domains/user-tasks/store.ts +297 -0
  408. package/src/engine/acp/errors.ts +96 -0
  409. package/src/engine/acp/server.ts +1728 -146
  410. package/src/engine/acp/transport.ts +135 -14
  411. package/src/engine/acp/types.ts +26 -0
  412. package/src/engine/agent.ts +3 -3
  413. package/src/engine/ai.ts +32 -27
  414. package/src/engine/alcf-oauth.ts +26 -19
  415. package/src/engine/api-registry.ts +223 -0
  416. package/src/engine/apis/index.ts +3 -7
  417. package/src/engine/apis/llamacpp-residency.ts +49 -9
  418. package/src/engine/apis/lmstudio-residency.ts +5 -21
  419. package/src/engine/apis/lmstudio.ts +243 -0
  420. package/src/engine/apis/ollama-native.ts +24 -3
  421. package/src/engine/apis/openai-completions.ts +170 -91
  422. package/src/engine/apis/residency.ts +139 -3
  423. package/src/engine/apis/types.ts +16 -0
  424. package/src/engine/env-api-keys.ts +98 -0
  425. package/src/engine/gemma-channel-filter.ts +223 -0
  426. package/src/engine/instrumented-tui.ts +192 -0
  427. package/src/engine/messages.ts +14 -0
  428. package/src/engine/models.ts +42 -0
  429. package/src/engine/oauth.ts +16 -12
  430. package/src/engine/prompt-templates.ts +1 -0
  431. package/src/engine/provider-payload.ts +16 -59
  432. package/src/engine/strip-tokenizer-sentinels.ts +1 -1
  433. package/src/engine/truncate.ts +9 -0
  434. package/src/engine/tui.ts +17 -9
  435. package/src/engine/types.ts +3 -6
  436. package/src/engine/worker-runtime-capabilities.ts +5 -0
  437. package/src/engine/worker-runtime.ts +1 -1
  438. package/src/engine/worker-tools.ts +9 -4
  439. package/src/entry/boot-options.ts +50 -0
  440. package/src/entry/orchestrator.ts +288 -150
  441. package/src/interactive/application-controller.ts +89 -2
  442. package/src/interactive/chat-loop.ts +266 -41
  443. package/src/interactive/chat-panel.ts +715 -278
  444. package/src/interactive/chat-renderer.ts +306 -85
  445. package/src/interactive/clio-editor.ts +3 -8
  446. package/src/interactive/command-fallbacks.ts +2 -2
  447. package/src/interactive/context-overlay.ts +27 -1
  448. package/src/interactive/editor-submit.ts +253 -24
  449. package/src/interactive/export-html/ansi-to-html.ts +161 -0
  450. package/src/interactive/export-html/index.ts +51 -0
  451. package/src/interactive/export-html/template.ts +45 -0
  452. package/src/interactive/export-html/tool-renderer.ts +54 -0
  453. package/src/interactive/footer/dashboard.ts +4 -0
  454. package/src/interactive/footer/notifications.ts +1 -1
  455. package/src/interactive/footer/widgets.ts +42 -22
  456. package/src/interactive/footer-panel.ts +8 -3
  457. package/src/interactive/format-time.ts +14 -2
  458. package/src/interactive/interactive-application.ts +203 -17
  459. package/src/interactive/interactive-event-projection.ts +18 -1
  460. package/src/interactive/interactive-input-runtime.ts +50 -4
  461. package/src/interactive/interactive-presentation.ts +151 -19
  462. package/src/interactive/interactive-shell.ts +268 -14
  463. package/src/interactive/interactive-slash-runtime.ts +184 -117
  464. package/src/interactive/interactive-tickers.ts +38 -7
  465. package/src/interactive/keybinding-manager.ts +1 -1
  466. package/src/interactive/layout.ts +40 -3
  467. package/src/interactive/overlay-frame.ts +1 -1
  468. package/src/interactive/overlay-general-openers.ts +58 -1
  469. package/src/interactive/overlay-key-routing.ts +3 -0
  470. package/src/interactive/overlay-lifecycle.ts +13 -0
  471. package/src/interactive/overlay-permission-lifecycle.ts +2 -1
  472. package/src/interactive/overlay-session-lifecycle.ts +69 -12
  473. package/src/interactive/overlays/ask-user.ts +146 -24
  474. package/src/interactive/overlays/decisions.ts +300 -0
  475. package/src/interactive/overlays/help-reference.ts +15 -10
  476. package/src/interactive/overlays/model-selector.ts +34 -16
  477. package/src/interactive/overlays/session-selector.ts +18 -0
  478. package/src/interactive/overlays/settings.ts +105 -17
  479. package/src/interactive/overlays/skills-hub.ts +4 -4
  480. package/src/interactive/overlays/tree-selector.ts +41 -6
  481. package/src/interactive/render-trace.ts +499 -90
  482. package/src/interactive/renderers/compaction-summary.ts +2 -2
  483. package/src/interactive/renderers/diff.ts +115 -104
  484. package/src/interactive/renderers/mermaid.ts +53 -0
  485. package/src/interactive/renderers/tool-execution.ts +516 -168
  486. package/src/interactive/renderers/worker-entry.ts +20 -4
  487. package/src/interactive/session-switch-settlement.ts +10 -0
  488. package/src/interactive/slash-autocomplete.ts +6 -114
  489. package/src/interactive/slash-commands.ts +135 -47
  490. package/src/interactive/slash-spec.ts +9 -38
  491. package/src/interactive/status/controller.ts +5 -1
  492. package/src/interactive/status/index.ts +12 -1
  493. package/src/interactive/status/reasoning.ts +87 -0
  494. package/src/interactive/status/summary.ts +13 -2
  495. package/src/interactive/stdout-backpressure.ts +99 -0
  496. package/src/interactive/stream-pacer.ts +530 -0
  497. package/src/interactive/stream-pacing-policy.ts +66 -0
  498. package/src/interactive/tasks-overlay.ts +368 -14
  499. package/src/interactive/terminal-lease.ts +485 -0
  500. package/src/interactive/theme/tokens.ts +1 -1
  501. package/src/interactive/transcript-detail.ts +120 -0
  502. package/src/interactive/turn-context.ts +4 -3
  503. package/src/interactive/turn-persistence.ts +30 -13
  504. package/src/interactive/turn-queues.ts +12 -0
  505. package/src/interactive/turn-recovery.ts +25 -8
  506. package/src/interactive/turn-runtime.ts +79 -12
  507. package/src/interactive/turn-state.ts +10 -0
  508. package/src/interactive/view/artifacts.ts +114 -4
  509. package/src/interactive/view/view-overlay.ts +3 -0
  510. package/src/interactive/welcome-dashboard.ts +17 -16
  511. package/src/interactive/worker-receipts.ts +52 -3
  512. package/src/interactive/worker-stream.ts +5 -1
  513. package/src/tools/agent-tools.ts +23 -3
  514. package/src/tools/artifact.ts +2 -2
  515. package/src/tools/ask-user.ts +23 -13
  516. package/src/tools/bash.ts +30 -2
  517. package/src/tools/bootstrap.ts +34 -431
  518. package/src/tools/builtin-tool-catalog.ts +271 -0
  519. package/src/tools/codewiki/code-nav-surface.ts +29 -0
  520. package/src/tools/codewiki/code-nav.ts +8 -22
  521. package/src/tools/codewiki/shared.ts +41 -38
  522. package/src/tools/context/docs-engine.ts +14 -3
  523. package/src/tools/context/index.ts +107 -28
  524. package/src/tools/context/surface.ts +19 -0
  525. package/src/tools/core-bootstrap.ts +168 -0
  526. package/src/tools/credential-present.ts +5 -5
  527. package/src/tools/dispatch-admission.ts +533 -0
  528. package/src/tools/dispatch-background.ts +54 -0
  529. package/src/tools/dispatch-event-text.ts +6 -0
  530. package/src/tools/dispatch-plan.ts +9 -4
  531. package/src/tools/dispatch-run-events.ts +238 -0
  532. package/src/tools/dispatch-runner.ts +2370 -0
  533. package/src/tools/dispatch-scout-admission.ts +295 -0
  534. package/src/tools/dispatch-types.ts +77 -0
  535. package/src/tools/dispatch.ts +67 -3161
  536. package/src/tools/find.ts +4 -2
  537. package/src/tools/grep.ts +2 -2
  538. package/src/tools/lazy-tool.ts +60 -0
  539. package/src/tools/ledger.ts +3 -3
  540. package/src/tools/monitor-surface.ts +36 -0
  541. package/src/tools/monitor.ts +2 -32
  542. package/src/tools/observers.ts +2 -2
  543. package/src/tools/presentation.ts +107 -0
  544. package/src/tools/registry.ts +45 -27
  545. package/src/tools/safe-exec.ts +2 -2
  546. package/src/tools/steer-surface.ts +17 -0
  547. package/src/tools/steer.ts +2 -13
  548. package/src/tools/tasks.ts +108 -11
  549. package/src/tools/truncate.ts +25 -184
  550. package/src/tools/verify/frontend.ts +3 -1
  551. package/src/tools/verify/index.ts +3 -38
  552. package/src/tools/verify/surface.ts +46 -0
  553. package/src/tools/web-fetch-surface.ts +23 -0
  554. package/src/tools/web-fetch.ts +2 -20
  555. package/src/tools/write.ts +7 -2
  556. package/src/worker/entry.ts +39 -2
  557. package/src/worker/spec-contract.ts +26 -5
  558. package/dist/chunk-7SS2CTV2.js +0 -61361
  559. package/dist/chunk-DKGKUHFA.js +0 -924
  560. package/dist/chunk-GEP36Y4X.js +0 -12796
  561. package/dist/chunk-XYWBQRDM.js +0 -137
  562. package/dist/clio-BZVGEUFJ.js +0 -58
  563. package/dist/configure-S7S6F6CL.js +0 -32
  564. package/docs/html/agents_blueprint.html +0 -936
  565. package/docs/html/alcf_blueprint.html +0 -324
  566. package/docs/html/architecture_blueprint.html +0 -850
  567. package/docs/html/commands_blueprint.html +0 -939
  568. package/docs/html/config_knobs_audit_blueprint.html +0 -178
  569. package/docs/html/configuration_blueprint.html +0 -1080
  570. package/docs/html/context_blueprint.html +0 -603
  571. package/docs/html/documentation_blueprint.html +0 -832
  572. package/docs/html/environment_blueprint.html +0 -404
  573. package/docs/html/eval_blueprint.html +0 -743
  574. package/docs/html/evals_internal_blueprint.html +0 -190
  575. package/docs/html/evolution_blueprint.html +0 -674
  576. package/docs/html/extensions_blueprint.html +0 -2065
  577. package/docs/html/fleet_dispatch_blueprint.html +0 -286
  578. package/docs/html/index.html +0 -919
  579. package/docs/html/lifecycle_blueprint.html +0 -723
  580. package/docs/html/memory_blueprint.html +0 -699
  581. package/docs/html/middleware_blueprint.html +0 -664
  582. package/docs/html/models_blueprint.html +0 -2366
  583. package/docs/html/observability_blueprint.html +0 -683
  584. package/docs/html/provider_adapter_blueprint.html +0 -245
  585. package/docs/html/safety_blueprint.html +0 -1386
  586. package/docs/html/shared.css +0 -571
  587. package/docs/html/shared.js +0 -143
  588. package/docs/html/skills_blueprint.html +0 -671
  589. package/docs/html/soak_blueprint.html +0 -182
  590. package/docs/html/tool_usage_blueprint.html +0 -350
  591. package/docs/html/tools_blueprint.html +0 -2249
  592. package/docs/html/trace_blueprint.html +0 -235
  593. package/docs/html/tui_design_blueprint.html +0 -374
  594. package/docs/html/validation_blueprint.html +0 -961
  595. package/docs/html/worker_dispatch_blueprint.html +0 -231
  596. package/src/core/release.ts +0 -2
  597. package/src/domains/providers/runtimes/common/lmstudio-logger.ts +0 -32
  598. package/src/domains/providers/runtimes/local-native/lmstudio-native.ts +0 -491
  599. package/src/engine/apis/lmstudio-native.ts +0 -1438
  600. package/src/engine/apis/thinking-replay.ts +0 -11
  601. package/src/tools/string-enum.ts +0 -15
@@ -0,0 +1,638 @@
1
+ import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
2
+ import {
3
+ webFetchToolSurface
4
+ } from "./chunk-ZI647VB5.js";
5
+ import {
6
+ truncateUtf8
7
+ } from "./chunk-6XLNIQDB.js";
8
+ import "./chunk-5B2AEOW5.js";
9
+ import "./chunk-CGKSTWHD.js";
10
+ import {
11
+ init_esm_shims
12
+ } from "./chunk-3R73A4XB.js";
13
+
14
+ // src/tools/web-fetch.ts
15
+ init_esm_shims();
16
+ var DEFAULT_TIMEOUT_MS = 3e4;
17
+ var DEFAULT_MAX_BYTES = 6e5;
18
+ var HARD_MAX_BYTES = 5e6;
19
+ var ERROR_PREVIEW_BYTES = 8e3;
20
+ var TRUNCATION_MARKER = "\n[output truncated]";
21
+ var HTML_SAMPLE_BYTES = 4096;
22
+ var DEFAULT_HEADERS = {
23
+ "User-Agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0 Safari/537.36 clio-coder-web-fetch/1.0",
24
+ Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,text/markdown,text/plain;q=0.8,*/*;q=0.5",
25
+ "Accept-Language": "en-US,en;q=0.9"
26
+ };
27
+ function parseHeaders(raw) {
28
+ if (raw === void 0 || raw === null) return {};
29
+ if (typeof raw !== "object" || Array.isArray(raw)) return null;
30
+ const out = {};
31
+ for (const [key, value] of Object.entries(raw)) {
32
+ if (typeof value !== "string") return null;
33
+ out[key] = value;
34
+ }
35
+ return out;
36
+ }
37
+ function truncate(text, maxBytes) {
38
+ return truncateUtf8(text, maxBytes, TRUNCATION_MARKER);
39
+ }
40
+ function decodeUtf8Prefix(bytes, maxBytes) {
41
+ let cut = Math.min(maxBytes, bytes.byteLength);
42
+ while (cut > 0) {
43
+ const nextByte = bytes[cut];
44
+ if (nextByte === void 0 || (nextByte & 192) !== 128) break;
45
+ cut -= 1;
46
+ }
47
+ return bytes.subarray(0, cut).toString("utf8");
48
+ }
49
+ async function readResponseText(response, maxBytes) {
50
+ if (!response.body) return { text: "", bytesRead: 0, truncated: false };
51
+ const reader = response.body.getReader();
52
+ const chunks = [];
53
+ let totalBytes = 0;
54
+ let truncated = false;
55
+ try {
56
+ for (; ; ) {
57
+ const { done, value } = await reader.read();
58
+ if (done) break;
59
+ if (!value) continue;
60
+ const chunk = Buffer.from(value);
61
+ const remaining = maxBytes + 4 - totalBytes;
62
+ if (remaining > 0) {
63
+ const kept = chunk.byteLength > remaining ? chunk.subarray(0, remaining) : chunk;
64
+ chunks.push(kept);
65
+ totalBytes += kept.byteLength;
66
+ }
67
+ if (totalBytes > maxBytes || chunk.byteLength > remaining) {
68
+ truncated = true;
69
+ await reader.cancel();
70
+ break;
71
+ }
72
+ }
73
+ } finally {
74
+ reader.releaseLock();
75
+ }
76
+ const bytes = Buffer.concat(chunks, totalBytes);
77
+ if (truncated || bytes.byteLength > maxBytes) {
78
+ return {
79
+ text: `${decodeUtf8Prefix(bytes, maxBytes)}${TRUNCATION_MARKER}`,
80
+ bytesRead: bytes.byteLength,
81
+ truncated: true
82
+ };
83
+ }
84
+ return { text: bytes.toString("utf8"), bytesRead: bytes.byteLength, truncated: false };
85
+ }
86
+ function headerValue(response, name) {
87
+ return response.headers.get(name) ?? "";
88
+ }
89
+ function looksLikeHtml(text) {
90
+ return /<!doctype\s+html|<html[\s>]|<head[\s>]|<body[\s>]|<article[\s>]|<main[\s>]/i.test(
91
+ text.slice(0, HTML_SAMPLE_BYTES)
92
+ );
93
+ }
94
+ function isProbablyBinary(contentType, text) {
95
+ if (/^(image|audio|video)\//i.test(contentType)) return true;
96
+ if (/application\/(pdf|zip|octet-stream|x-tar|gzip)/i.test(contentType)) return true;
97
+ return text.includes("\0");
98
+ }
99
+ function safeFromCodePoint(code, original) {
100
+ return Number.isInteger(code) && code >= 0 && code <= 1114111 ? String.fromCodePoint(code) : original;
101
+ }
102
+ function decodeEntities(value) {
103
+ return value.replace(/&#(\d+);/g, (m, code) => safeFromCodePoint(Number(code), m)).replace(/&#x([0-9a-f]+);/gi, (m, code) => safeFromCodePoint(Number.parseInt(code, 16), m)).replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#39;|&apos;/gi, "'");
104
+ }
105
+ function stripTags(value) {
106
+ return decodeEntities(
107
+ value.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim()
108
+ );
109
+ }
110
+ function stripCodeTags(value) {
111
+ return decodeEntities(value.replace(/<[^>]+>/g, ""));
112
+ }
113
+ function firstMatch(html, regex) {
114
+ const match = regex.exec(html);
115
+ return match?.[1] ? stripTags(match[1]) : void 0;
116
+ }
117
+ function attrValue(tag, attr) {
118
+ const regex = new RegExp(`${attr}\\s*=\\s*(["'])(.*?)\\1`, "i");
119
+ const match = regex.exec(tag);
120
+ return match?.[2] ? decodeEntities(match[2].trim()) : void 0;
121
+ }
122
+ function absolutizeUrl(href, baseUrl) {
123
+ try {
124
+ return new URL(href, baseUrl).toString();
125
+ } catch {
126
+ return href;
127
+ }
128
+ }
129
+ function removeBoilerplate(html) {
130
+ return html.replace(/<!--[\s\S]*?-->/g, " ").replace(/<script\b[\s\S]*?<\/script>/gi, " ").replace(/<style\b[\s\S]*?<\/style>/gi, " ").replace(/<noscript\b[\s\S]*?<\/noscript>/gi, " ").replace(/<template\b[\s\S]*?<\/template>/gi, " ").replace(/<svg\b[\s\S]*?<\/svg>/gi, " ").replace(/<canvas\b[\s\S]*?<\/canvas>/gi, " ").replace(/<iframe\b[\s\S]*?<\/iframe>/gi, " ").replace(/<form\b[\s\S]*?<\/form>/gi, " ");
131
+ }
132
+ function scoreContent(fragment) {
133
+ const text = stripTags(fragment);
134
+ const links = (fragment.match(/<a\b/gi) ?? []).length;
135
+ const paragraphs = (fragment.match(/<p\b|<li\b|<h[1-6]\b/gi) ?? []).length;
136
+ return text.length + paragraphs * 80 - links * 20;
137
+ }
138
+ function extractMainHtml(html) {
139
+ const cleaned = removeBoilerplate(html);
140
+ const candidates = [];
141
+ for (const regex of [
142
+ /<main\b[^>]*>([\s\S]*?)<\/main>/gi,
143
+ /<article\b[^>]*>([\s\S]*?)<\/article>/gi,
144
+ /<div\b[^>]*(?:id|class)=["'][^"']*(?:content|main|post|article|entry|docs|markdown)[^"']*["'][^>]*>([\s\S]*?)<\/div>/gi
145
+ ]) {
146
+ for (const match of cleaned.matchAll(regex)) {
147
+ if (match[1]) candidates.push(match[1]);
148
+ }
149
+ }
150
+ if (candidates.length === 0) {
151
+ const body = /<body\b[^>]*>([\s\S]*?)<\/body>/i.exec(cleaned);
152
+ return body?.[1] ?? cleaned;
153
+ }
154
+ return candidates.sort((a, b) => scoreContent(b) - scoreContent(a))[0] ?? cleaned;
155
+ }
156
+ function htmlToMarkdown(html, baseUrl) {
157
+ let out = html;
158
+ const codeBlocks = [];
159
+ out = out.replace(/<pre\b[^>]*>([\s\S]*?)<\/pre>/gi, (_, code) => {
160
+ const placeholder = `
161
+
162
+ @@CLIO_CODE_${codeBlocks.length}@@
163
+
164
+ `;
165
+ codeBlocks.push(`
166
+
167
+ \`\`\`
168
+ ${stripCodeTags(code).replace(/^\n+|\n+$/g, "")}
169
+ \`\`\`
170
+
171
+ `);
172
+ return placeholder;
173
+ });
174
+ out = out.replace(/<br\s*\/?>/gi, "\n");
175
+ out = out.replace(
176
+ /<h([1-6])\b[^>]*>([\s\S]*?)<\/h\1>/gi,
177
+ (_, level, text) => `
178
+
179
+ ${"#".repeat(Number(level))} ${stripTags(text)}
180
+
181
+ `
182
+ );
183
+ out = out.replace(
184
+ /<blockquote\b[^>]*>([\s\S]*?)<\/blockquote>/gi,
185
+ (_, text) => `
186
+
187
+ > ${stripTags(text)}
188
+
189
+ `
190
+ );
191
+ out = out.replace(/<li\b[^>]*>([\s\S]*?)<\/li>/gi, (_, text) => `
192
+ - ${stripTags(text)}`);
193
+ out = out.replace(
194
+ /<a\b[^>]*href\s*=\s*(["'])(.*?)\1[^>]*>([\s\S]*?)<\/a>/gi,
195
+ (_, _q, href, text) => {
196
+ const label = stripTags(text);
197
+ if (!label) return "";
198
+ const url = absolutizeUrl(decodeEntities(href), baseUrl);
199
+ return label === url ? url : `[${label}](${url})`;
200
+ }
201
+ );
202
+ out = out.replace(/<img\b[^>]*>/gi, (tag) => {
203
+ const alt = attrValue(tag, "alt");
204
+ const src = attrValue(tag, "src");
205
+ if (!alt && !src) return " ";
206
+ if (!alt) return " ";
207
+ return src ? `![${alt}](${absolutizeUrl(src, baseUrl)})` : alt;
208
+ });
209
+ out = out.replace(/<\/(p|div|section|article|main|tr|table|ul|ol)>/gi, "\n\n");
210
+ out = out.replace(/<\/(td|th)>/gi, " | ");
211
+ out = out.replace(/<[^>]+>/g, " ");
212
+ out = decodeEntities(out);
213
+ for (const [index, block] of codeBlocks.entries()) {
214
+ out = out.replace(`@@CLIO_CODE_${index}@@`, () => block);
215
+ }
216
+ return out.split("\n").map((line) => line.replace(/[ \t]+/g, " ").trimEnd()).join("\n").replace(/\n{3,}/g, "\n\n").replace(/^[ \t]+|[ \t]+$/g, "").trim();
217
+ }
218
+ function extractWebFetchContent(rawText, contentType, finalUrl, format) {
219
+ const wantsRaw = format === "raw";
220
+ const isHtml = /\bhtml\b/i.test(contentType) || looksLikeHtml(rawText);
221
+ if (wantsRaw || !isHtml) {
222
+ return { format: wantsRaw ? "raw" : "text", content: rawText.trim() };
223
+ }
224
+ const title = firstMatch(rawText, /<title\b[^>]*>([\s\S]*?)<\/title>/i);
225
+ const descriptionTag = /<meta\b[^>]*(?:name|property)=["'](?:description|og:description)["'][^>]*>/i.exec(
226
+ rawText
227
+ )?.[0];
228
+ const canonicalTag = /<link\b[^>]*rel=["']canonical["'][^>]*>/i.exec(rawText)?.[0];
229
+ const description = descriptionTag ? attrValue(descriptionTag, "content") : void 0;
230
+ const canonical = canonicalTag ? attrValue(canonicalTag, "href") : void 0;
231
+ const extracted = {
232
+ format: "markdown",
233
+ content: htmlToMarkdown(extractMainHtml(rawText), finalUrl)
234
+ };
235
+ if (title) extracted.title = title;
236
+ if (description) extracted.description = description;
237
+ if (canonical) extracted.canonical = absolutizeUrl(canonical, finalUrl);
238
+ return extracted;
239
+ }
240
+ function arxivIdFromUrl(url) {
241
+ if (url.hostname === "arxiv.org" || url.hostname === "www.arxiv.org") {
242
+ const match = /^\/(?:abs|pdf|html)\/([^/?#]+?)(?:\.pdf)?$/i.exec(url.pathname);
243
+ return match?.[1]?.replace(/v\d+$/i, "") ?? null;
244
+ }
245
+ if (url.hostname === "alphaxiv.org" || url.hostname === "www.alphaxiv.org") {
246
+ const match = /^\/(?:abs|overview)\/([^/?#]+?)(?:\.md)?$/i.exec(url.pathname);
247
+ return match?.[1]?.replace(/v\d+$/i, "") ?? null;
248
+ }
249
+ if (url.hostname === "ar5iv.labs.arxiv.org") {
250
+ const match = /^\/html\/([^/?#]+)$/i.exec(url.pathname);
251
+ return match?.[1]?.replace(/v\d+$/i, "") ?? null;
252
+ }
253
+ return null;
254
+ }
255
+ function xmlText(xml, tag) {
256
+ const match = new RegExp(`<${tag}\\b[^>]*>([\\s\\S]*?)<\\/${tag}>`, "i").exec(xml);
257
+ return match?.[1] ? decodeEntities(
258
+ match[1].replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim()
259
+ ) : void 0;
260
+ }
261
+ function xmlTexts(xml, tag) {
262
+ const out = [];
263
+ const regex = new RegExp(`<${tag}\\b[^>]*>([\\s\\S]*?)<\\/${tag}>`, "gi");
264
+ for (const match of xml.matchAll(regex)) {
265
+ if (match[1])
266
+ out.push(
267
+ decodeEntities(
268
+ match[1].replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim()
269
+ )
270
+ );
271
+ }
272
+ return out;
273
+ }
274
+ function arxivCategories(entryXml) {
275
+ const categories = [];
276
+ for (const match of entryXml.matchAll(/<category\b[^>]*term=["']([^"']+)["'][^>]*>/gi)) {
277
+ if (match[1] && !categories.includes(match[1])) categories.push(match[1]);
278
+ }
279
+ return categories;
280
+ }
281
+ function parseArxivEntry(entry, fallbackId) {
282
+ const idUrl = xmlText(entry, "id");
283
+ const parsedId = idUrl ? /\/abs\/([^/?#]+)/i.exec(idUrl)?.[1]?.replace(/v\d+$/i, "") : void 0;
284
+ const paper = {
285
+ id: parsedId ?? fallbackId,
286
+ authors: xmlTexts(entry, "name"),
287
+ categories: arxivCategories(entry)
288
+ };
289
+ const title = xmlText(entry, "title");
290
+ const published = xmlText(entry, "published");
291
+ const updated = xmlText(entry, "updated");
292
+ const abstract = xmlText(entry, "summary");
293
+ if (title) paper.title = title;
294
+ if (published) paper.published = published;
295
+ if (updated) paper.updated = updated;
296
+ if (abstract) paper.abstract = abstract;
297
+ return paper;
298
+ }
299
+ async function fetchArxivPaperSummary(paperId, init, maxBytes) {
300
+ const metadataUrl = `https://export.arxiv.org/api/query?id_list=${encodeURIComponent(paperId)}`;
301
+ const response = await fetch(metadataUrl, init);
302
+ if (response.status < 200 || response.status >= 300) return null;
303
+ const read = await readResponseText(response, Math.min(12e4, maxBytes));
304
+ const entry = /<entry\b[^>]*>([\s\S]*?)<\/entry>/i.exec(read.text)?.[1];
305
+ if (!entry) return null;
306
+ const paper = parseArxivEntry(entry, paperId);
307
+ let alphaxivRead = null;
308
+ const alphaUrl = `https://alphaxiv.org/overview/${encodeURIComponent(paperId)}.md`;
309
+ try {
310
+ const alpha = await fetch(alphaUrl, init);
311
+ if (alpha.status >= 200 && alpha.status < 300) {
312
+ alphaxivRead = await readResponseText(alpha, Math.min(8e4, Math.max(0, maxBytes - read.bytesRead)));
313
+ if (alphaxivRead.text.trim().length > 0) paper.alphaxivOverview = alphaxivRead.text.trim();
314
+ }
315
+ } catch {
316
+ }
317
+ const lines = [
318
+ `URL: https://arxiv.org/abs/${paper.id}`,
319
+ "Status: 200",
320
+ "Format: arxiv-paper",
321
+ `Paper ID: ${paper.id}`
322
+ ];
323
+ if (paper.title) lines.push(`Title: ${paper.title}`);
324
+ if (paper.authors.length > 0) lines.push(`Authors: ${paper.authors.join(", ")}`);
325
+ if (paper.published) lines.push(`Published: ${paper.published}`);
326
+ if (paper.updated) lines.push(`Updated: ${paper.updated}`);
327
+ if (paper.categories.length > 0) lines.push(`Categories: ${paper.categories.join(", ")}`);
328
+ lines.push(
329
+ "Links:",
330
+ `- arXiv: https://arxiv.org/abs/${paper.id}`,
331
+ `- PDF: https://arxiv.org/pdf/${paper.id}`,
332
+ `- AlphaXiv: https://alphaxiv.org/abs/${paper.id}`,
333
+ `- ar5iv HTML: https://ar5iv.labs.arxiv.org/html/${paper.id}`
334
+ );
335
+ if (paper.abstract) lines.push("", "Abstract:", paper.abstract);
336
+ if (paper.alphaxivOverview) lines.push("", "AlphaXiv overview:", paper.alphaxivOverview);
337
+ const bytesRead = read.bytesRead + (alphaxivRead?.bytesRead ?? 0);
338
+ return {
339
+ kind: "ok",
340
+ output: truncate(lines.join("\n"), maxBytes),
341
+ details: {
342
+ url: `https://arxiv.org/abs/${paper.id}`,
343
+ status: 200,
344
+ contentType: "application/atom+xml",
345
+ format: "arxiv-paper",
346
+ bytesRead,
347
+ truncated: read.truncated || (alphaxivRead?.truncated ?? false)
348
+ }
349
+ };
350
+ }
351
+ function arxivApiUrl(url) {
352
+ return url.hostname === "export.arxiv.org" && url.pathname === "/api/query";
353
+ }
354
+ async function fetchArxivApiSummary(url, init, maxBytes) {
355
+ const response = await fetch(url, init);
356
+ if (response.status < 200 || response.status >= 300) return null;
357
+ const read = await readResponseText(response, Math.min(24e4, maxBytes));
358
+ const entries = Array.from(read.text.matchAll(/<entry\b[^>]*>([\s\S]*?)<\/entry>/gi)).map((match, index) => match[1] ? parseArxivEntry(match[1], `entry-${index + 1}`) : null).filter((entry) => entry !== null);
359
+ if (entries.length === 0) return null;
360
+ const total = xmlText(read.text, "opensearch:totalResults") ?? String(entries.length);
361
+ const query = url.searchParams.get("search_query") ?? url.searchParams.get("id_list") ?? "arxiv query";
362
+ const lines = [
363
+ `URL: ${url.toString()}`,
364
+ "Status: 200",
365
+ "Format: arxiv-search-results",
366
+ `Query: ${query}`,
367
+ `Returned: ${entries.length}`,
368
+ `Total results: ${total}`,
369
+ "",
370
+ "Papers:"
371
+ ];
372
+ for (const [index, paper] of entries.entries()) {
373
+ lines.push("", `## ${index + 1}. ${paper.title ?? paper.id}`);
374
+ lines.push(`Paper ID: ${paper.id}`);
375
+ if (paper.authors.length > 0)
376
+ lines.push(`Authors: ${paper.authors.slice(0, 8).join(", ")}${paper.authors.length > 8 ? ", et al." : ""}`);
377
+ if (paper.published) lines.push(`Published: ${paper.published}`);
378
+ if (paper.updated) lines.push(`Updated: ${paper.updated}`);
379
+ if (paper.categories.length > 0) lines.push(`Categories: ${paper.categories.join(", ")}`);
380
+ lines.push(`Links: https://arxiv.org/abs/${paper.id} | https://arxiv.org/pdf/${paper.id}`);
381
+ if (paper.abstract) lines.push("Abstract:", truncate(paper.abstract, 1600));
382
+ }
383
+ return {
384
+ kind: "ok",
385
+ output: truncate(lines.join("\n"), maxBytes),
386
+ details: {
387
+ url: url.toString(),
388
+ status: 200,
389
+ contentType: "application/atom+xml",
390
+ format: "arxiv-search-results",
391
+ bytesRead: read.bytesRead,
392
+ truncated: read.truncated
393
+ }
394
+ };
395
+ }
396
+ function repoTreeTarget(url) {
397
+ const parts = url.pathname.split("/").filter(Boolean);
398
+ if (url.hostname === "github.com" && parts.length >= 5 && parts[2] === "tree") {
399
+ const [owner, repo, , branch, ...pathParts] = parts;
400
+ const pathPart = pathParts.join("/");
401
+ return {
402
+ kind: "github",
403
+ apiUrl: `https://api.github.com/repos/${owner}/${repo}/contents/${pathPart}?ref=${branch}`,
404
+ rawBaseUrl: `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${pathPart}`.replace(/\/$/, ""),
405
+ label: `${owner}/${repo}/${pathPart}`
406
+ };
407
+ }
408
+ if (url.hostname.includes("gitlab") && parts.length >= 5) {
409
+ const treeIndex = parts.findIndex((part, index) => part === "tree" && parts[index - 1] === "-");
410
+ if (treeIndex >= 2) {
411
+ const project = parts.slice(0, treeIndex - 1).join("/");
412
+ const branch = parts[treeIndex + 1];
413
+ if (!branch) return null;
414
+ const pathPart = parts.slice(treeIndex + 2).join("/");
415
+ const encodedProject = encodeURIComponent(project);
416
+ return {
417
+ kind: "gitlab",
418
+ apiUrl: `${url.origin}/api/v4/projects/${encodedProject}/repository/tree?path=${encodeURIComponent(pathPart)}&ref=${encodeURIComponent(branch)}&per_page=100`,
419
+ rawBaseUrl: `${url.origin}/${project}/-/raw/${branch}/${pathPart}`.replace(/\/$/, ""),
420
+ label: `${project}/${pathPart}`
421
+ };
422
+ }
423
+ }
424
+ return null;
425
+ }
426
+ function repoEntryName(entry) {
427
+ if (!entry || typeof entry !== "object") return null;
428
+ const record = entry;
429
+ return typeof record.name === "string" ? record.name : null;
430
+ }
431
+ function repoEntryIsFile(entry) {
432
+ if (!entry || typeof entry !== "object") return false;
433
+ const record = entry;
434
+ return record.type === "file" || record.type === "blob";
435
+ }
436
+ function importantRepoFiles(entries) {
437
+ const priority = [/^README\.md$/i, /^SKILL\.md$/i, /^INSTALL\.md$/i, /^VERIFY\.md$/i, /\.md$/i];
438
+ const names = entries.filter(repoEntryIsFile).map(repoEntryName).filter((name) => name !== null);
439
+ const selected = [];
440
+ for (const pattern of priority) {
441
+ for (const name of names) {
442
+ if (selected.includes(name) || !pattern.test(name)) continue;
443
+ selected.push(name);
444
+ if (selected.length >= 6) return selected;
445
+ }
446
+ }
447
+ return selected;
448
+ }
449
+ async function fetchRepoTreeSummary(target, init, maxBytes) {
450
+ const apiResponse = await fetch(target.apiUrl, init);
451
+ if (apiResponse.status < 200 || apiResponse.status >= 300) return null;
452
+ const apiRead = await readResponseText(apiResponse, Math.min(2e5, maxBytes));
453
+ let entries;
454
+ try {
455
+ const parsed = JSON.parse(apiRead.text);
456
+ entries = Array.isArray(parsed) ? parsed : [];
457
+ } catch {
458
+ return null;
459
+ }
460
+ const files = importantRepoFiles(entries);
461
+ const allNames = entries.map(repoEntryName).filter((name) => name !== null).slice(0, 60);
462
+ const sections = [
463
+ `URL: ${target.apiUrl}`,
464
+ "Status: 200",
465
+ `Format: repository-${target.kind}-tree-summary`,
466
+ `Repository path: ${target.label}`,
467
+ "",
468
+ "Directory entries:",
469
+ ...allNames.map((name) => `- ${name}`)
470
+ ];
471
+ let remaining = maxBytes - Buffer.byteLength(sections.join("\n"));
472
+ for (const file of files) {
473
+ if (remaining <= 2e3) break;
474
+ const rawUrl = `${target.rawBaseUrl}/${file}`;
475
+ const rawResponse = await fetch(rawUrl, init);
476
+ if (rawResponse.status < 200 || rawResponse.status >= 300) continue;
477
+ const rawRead = await readResponseText(rawResponse, Math.min(8e4, remaining));
478
+ sections.push("", `--- ${file} ---`, rawRead.text.trim());
479
+ remaining -= Buffer.byteLength(rawRead.text);
480
+ }
481
+ return {
482
+ kind: "ok",
483
+ output: truncate(sections.join("\n"), maxBytes),
484
+ details: {
485
+ url: target.apiUrl,
486
+ status: 200,
487
+ contentType: "application/json",
488
+ format: `repository-${target.kind}-tree-summary`,
489
+ bytesRead: apiRead.bytesRead,
490
+ truncated: apiRead.truncated
491
+ }
492
+ };
493
+ }
494
+ function formatOutput(args) {
495
+ const lines = [
496
+ `URL: ${args.url}`,
497
+ `Status: ${args.status}`,
498
+ `Content-Type: ${args.contentType || "unknown"}`,
499
+ `Format: ${args.extracted.format}`,
500
+ `Bytes read: ${args.bytesRead}${args.truncated ? " (truncated)" : ""}`
501
+ ];
502
+ if (args.extracted.title) lines.push(`Title: ${args.extracted.title}`);
503
+ if (args.extracted.description) lines.push(`Description: ${args.extracted.description}`);
504
+ if (args.extracted.canonical) lines.push(`Canonical: ${args.extracted.canonical}`);
505
+ lines.push("", "Content:", args.extracted.content || "[empty]");
506
+ return truncate(lines.join("\n"), args.maxBytes);
507
+ }
508
+ var webFetchTool = {
509
+ ...webFetchToolSurface,
510
+ async run(args, options) {
511
+ const urlArg = typeof args.url === "string" ? args.url : null;
512
+ if (!urlArg) return { kind: "error", message: "web_fetch: missing url argument" };
513
+ let parsed;
514
+ try {
515
+ parsed = new URL(urlArg);
516
+ } catch {
517
+ return { kind: "error", message: `web_fetch: invalid url: ${urlArg}` };
518
+ }
519
+ if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
520
+ return { kind: "error", message: `web_fetch: unsupported scheme ${parsed.protocol} (must be http or https)` };
521
+ }
522
+ const method = typeof args.method === "string" && args.method.length > 0 ? args.method.toUpperCase() : "GET";
523
+ const userHeaders = parseHeaders(args.headers);
524
+ if (userHeaders === null) {
525
+ return { kind: "error", message: "web_fetch: headers must be a Record<string,string>" };
526
+ }
527
+ const headers = { ...DEFAULT_HEADERS, ...userHeaders };
528
+ const hasBody = typeof args.body === "string";
529
+ const body = hasBody ? args.body : void 0;
530
+ const timeoutMs = typeof args.timeout_ms === "number" && args.timeout_ms > 0 ? args.timeout_ms : DEFAULT_TIMEOUT_MS;
531
+ const requestedMaxBytes = typeof args.max_bytes === "number" && args.max_bytes > 0 ? args.max_bytes : DEFAULT_MAX_BYTES;
532
+ const maxBytes = Math.min(Math.floor(requestedMaxBytes), HARD_MAX_BYTES);
533
+ const format = typeof args.format === "string" ? args.format.toLowerCase() : "auto";
534
+ if (!["auto", "markdown", "raw"].includes(format)) {
535
+ return { kind: "error", message: "web_fetch: format must be one of auto, markdown, raw" };
536
+ }
537
+ const externalSignal = options?.signal;
538
+ const controller = new AbortController();
539
+ let externalAborted = false;
540
+ let timedOut = false;
541
+ const onExternalAbort = () => {
542
+ externalAborted = true;
543
+ controller.abort();
544
+ };
545
+ if (externalSignal?.aborted) {
546
+ onExternalAbort();
547
+ } else {
548
+ externalSignal?.addEventListener("abort", onExternalAbort, { once: true });
549
+ }
550
+ const timer = setTimeout(() => {
551
+ timedOut = true;
552
+ controller.abort();
553
+ }, timeoutMs);
554
+ try {
555
+ const init = {
556
+ method,
557
+ headers,
558
+ signal: controller.signal,
559
+ redirect: "follow"
560
+ };
561
+ if (body !== void 0) init.body = body;
562
+ if (method === "GET" && body === void 0 && format !== "raw") {
563
+ if (arxivApiUrl(parsed)) {
564
+ const arxivApiSummary = await fetchArxivApiSummary(parsed, init, maxBytes);
565
+ if (arxivApiSummary) return arxivApiSummary;
566
+ }
567
+ const arxivId = arxivIdFromUrl(parsed);
568
+ if (arxivId) {
569
+ const arxivSummary = await fetchArxivPaperSummary(arxivId, init, maxBytes);
570
+ if (arxivSummary) return arxivSummary;
571
+ }
572
+ const repoTarget = repoTreeTarget(parsed);
573
+ if (repoTarget) {
574
+ const repoSummary = await fetchRepoTreeSummary(repoTarget, init, maxBytes);
575
+ if (repoSummary) return repoSummary;
576
+ }
577
+ }
578
+ const response = await fetch(parsed, init);
579
+ const contentType = headerValue(response, "content-type");
580
+ const readLimit = response.status >= 200 && response.status < 300 ? maxBytes : Math.min(ERROR_PREVIEW_BYTES, maxBytes);
581
+ const read = await readResponseText(response, readLimit);
582
+ if (response.status < 200 || response.status >= 300) {
583
+ const preview = extractWebFetchContent(read.text, contentType, response.url || parsed.toString(), "auto").content;
584
+ return {
585
+ kind: "error",
586
+ message: `web_fetch: HTTP ${response.status}: ${response.statusText}${preview ? `
587
+ Preview:
588
+ ${truncate(preview, ERROR_PREVIEW_BYTES)}` : ""}`
589
+ };
590
+ }
591
+ if (isProbablyBinary(contentType, read.text)) {
592
+ return { kind: "error", message: `web_fetch: binary or unsupported content type: ${contentType || "unknown"}` };
593
+ }
594
+ const finalUrl = response.url || parsed.toString();
595
+ const extracted = extractWebFetchContent(read.text, contentType, finalUrl, format);
596
+ return {
597
+ kind: "ok",
598
+ output: formatOutput({
599
+ url: finalUrl,
600
+ status: response.status,
601
+ contentType,
602
+ bytesRead: read.bytesRead,
603
+ truncated: read.truncated,
604
+ extracted,
605
+ maxBytes
606
+ }),
607
+ details: {
608
+ url: finalUrl,
609
+ status: response.status,
610
+ contentType,
611
+ format: extracted.format,
612
+ bytesRead: read.bytesRead,
613
+ truncated: read.truncated
614
+ }
615
+ };
616
+ } catch (err) {
617
+ if (err instanceof Error && err.name === "AbortError") {
618
+ if (externalAborted) {
619
+ return { kind: "error", message: "web_fetch: request aborted" };
620
+ }
621
+ if (timedOut) {
622
+ return { kind: "error", message: `web_fetch: timeout after ${timeoutMs}ms` };
623
+ }
624
+ return { kind: "error", message: "web_fetch: request aborted" };
625
+ }
626
+ const msg = err instanceof Error ? err.message : String(err);
627
+ return { kind: "error", message: `web_fetch: ${msg}` };
628
+ } finally {
629
+ clearTimeout(timer);
630
+ externalSignal?.removeEventListener("abort", onExternalAbort);
631
+ }
632
+ }
633
+ };
634
+ export {
635
+ extractWebFetchContent,
636
+ webFetchTool
637
+ };
638
+ //# sourceMappingURL=web-fetch-2YHJ3KTG.js.map