@humain/terminal 0.0.2 → 0.0.3-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (680) hide show
  1. package/CHANGELOG.md +241 -24
  2. package/README.md +143 -119
  3. package/dist/cli/args.d.ts +4 -2
  4. package/dist/cli/args.d.ts.map +1 -1
  5. package/dist/cli/args.js +37 -39
  6. package/dist/cli/args.js.map +1 -1
  7. package/dist/cli/auth-check.d.ts +19 -0
  8. package/dist/cli/auth-check.d.ts.map +1 -0
  9. package/dist/cli/auth-check.js +50 -0
  10. package/dist/cli/auth-check.js.map +1 -0
  11. package/dist/cli/auth-command.d.ts +24 -0
  12. package/dist/cli/auth-command.d.ts.map +1 -0
  13. package/dist/cli/auth-command.js +103 -0
  14. package/dist/cli/auth-command.js.map +1 -0
  15. package/dist/cli/config-selector.d.ts.map +1 -1
  16. package/dist/cli/config-selector.js +2 -2
  17. package/dist/cli/config-selector.js.map +1 -1
  18. package/dist/cli/credential-print.d.ts +5 -15
  19. package/dist/cli/credential-print.d.ts.map +1 -1
  20. package/dist/cli/credential-print.js +42 -83
  21. package/dist/cli/credential-print.js.map +1 -1
  22. package/dist/cli/experimental/auth.d.ts +16 -0
  23. package/dist/cli/experimental/auth.d.ts.map +1 -0
  24. package/dist/cli/experimental/auth.js +13 -0
  25. package/dist/cli/experimental/auth.js.map +1 -0
  26. package/dist/cli/experimental/cli.d.ts +6 -0
  27. package/dist/cli/experimental/cli.d.ts.map +1 -0
  28. package/dist/cli/experimental/cli.js +5 -0
  29. package/dist/cli/experimental/cli.js.map +1 -0
  30. package/dist/cli/experimental/command-options.d.ts +17 -0
  31. package/dist/cli/experimental/command-options.d.ts.map +1 -0
  32. package/dist/cli/experimental/command-options.js +35 -0
  33. package/dist/cli/experimental/command-options.js.map +1 -0
  34. package/dist/cli/experimental/command.d.ts +63 -0
  35. package/dist/cli/experimental/command.d.ts.map +1 -0
  36. package/dist/cli/experimental/command.js +130 -0
  37. package/dist/cli/experimental/command.js.map +1 -0
  38. package/dist/cli/experimental/commands/client.d.ts +13 -0
  39. package/dist/cli/experimental/commands/client.d.ts.map +1 -0
  40. package/dist/cli/experimental/commands/client.js +25 -0
  41. package/dist/cli/experimental/commands/client.js.map +1 -0
  42. package/dist/cli/experimental/commands/pi.d.ts +15 -0
  43. package/dist/cli/experimental/commands/pi.d.ts.map +1 -0
  44. package/dist/cli/experimental/commands/pi.js +28 -0
  45. package/dist/cli/experimental/commands/pi.js.map +1 -0
  46. package/dist/cli/experimental/commands/server.d.ts +13 -0
  47. package/dist/cli/experimental/commands/server.d.ts.map +1 -0
  48. package/dist/cli/experimental/commands/server.js +25 -0
  49. package/dist/cli/experimental/commands/server.js.map +1 -0
  50. package/dist/cli/experimental/transport-address.d.ts +10 -0
  51. package/dist/cli/experimental/transport-address.d.ts.map +1 -0
  52. package/dist/cli/experimental/transport-address.js +38 -0
  53. package/dist/cli/experimental/transport-address.js.map +1 -0
  54. package/dist/cli/list-models.d.ts +1 -1
  55. package/dist/cli/list-models.d.ts.map +1 -1
  56. package/dist/cli/list-models.js +2 -2
  57. package/dist/cli/list-models.js.map +1 -1
  58. package/dist/cli/startup-ui.d.ts +1 -1
  59. package/dist/cli/startup-ui.d.ts.map +1 -1
  60. package/dist/cli/startup-ui.js +2 -2
  61. package/dist/cli/startup-ui.js.map +1 -1
  62. package/dist/client/index.d.ts +3 -0
  63. package/dist/client/index.d.ts.map +1 -0
  64. package/dist/client/index.js +3 -0
  65. package/dist/client/index.js.map +1 -0
  66. package/dist/client/remote-session.d.ts +53 -0
  67. package/dist/client/remote-session.d.ts.map +1 -0
  68. package/dist/client/remote-session.js +340 -0
  69. package/dist/client/remote-session.js.map +1 -0
  70. package/dist/client/transcript.d.ts +12 -0
  71. package/dist/client/transcript.d.ts.map +1 -0
  72. package/dist/client/transcript.js +98 -0
  73. package/dist/client/transcript.js.map +1 -0
  74. package/dist/core/agent-session-services.d.ts +1 -0
  75. package/dist/core/agent-session-services.d.ts.map +1 -1
  76. package/dist/core/agent-session-services.js +1 -0
  77. package/dist/core/agent-session-services.js.map +1 -1
  78. package/dist/core/agent-session.d.ts +1 -10
  79. package/dist/core/agent-session.d.ts.map +1 -1
  80. package/dist/core/agent-session.js +72 -70
  81. package/dist/core/agent-session.js.map +1 -1
  82. package/dist/core/auth-storage.d.ts +25 -9
  83. package/dist/core/auth-storage.d.ts.map +1 -1
  84. package/dist/core/auth-storage.js +237 -39
  85. package/dist/core/auth-storage.js.map +1 -1
  86. package/dist/core/extensions/index.d.ts +1 -1
  87. package/dist/core/extensions/index.d.ts.map +1 -1
  88. package/dist/core/extensions/index.js.map +1 -1
  89. package/dist/core/extensions/loader.d.ts.map +1 -1
  90. package/dist/core/extensions/loader.js +60 -41
  91. package/dist/core/extensions/loader.js.map +1 -1
  92. package/dist/core/extensions/runner.d.ts +2 -1
  93. package/dist/core/extensions/runner.d.ts.map +1 -1
  94. package/dist/core/extensions/runner.js +3 -0
  95. package/dist/core/extensions/runner.js.map +1 -1
  96. package/dist/core/extensions/types.d.ts +27 -4
  97. package/dist/core/extensions/types.d.ts.map +1 -1
  98. package/dist/core/extensions/types.js.map +1 -1
  99. package/dist/core/http-dispatcher.d.ts.map +1 -1
  100. package/dist/core/http-dispatcher.js +5 -0
  101. package/dist/core/http-dispatcher.js.map +1 -1
  102. package/dist/core/keybindings.d.ts +45 -5
  103. package/dist/core/keybindings.d.ts.map +1 -1
  104. package/dist/core/keybindings.js.map +1 -1
  105. package/dist/core/model-config.d.ts +29 -5
  106. package/dist/core/model-config.d.ts.map +1 -1
  107. package/dist/core/model-config.js +4 -0
  108. package/dist/core/model-config.js.map +1 -1
  109. package/dist/core/model-registry.d.ts +5 -3
  110. package/dist/core/model-registry.d.ts.map +1 -1
  111. package/dist/core/model-registry.js +13 -10
  112. package/dist/core/model-registry.js.map +1 -1
  113. package/dist/core/model-resolver.d.ts +4 -3
  114. package/dist/core/model-resolver.d.ts.map +1 -1
  115. package/dist/core/model-resolver.js +42 -10
  116. package/dist/core/model-resolver.js.map +1 -1
  117. package/dist/core/model-runtime.d.ts +30 -13
  118. package/dist/core/model-runtime.d.ts.map +1 -1
  119. package/dist/core/model-runtime.js +233 -73
  120. package/dist/core/model-runtime.js.map +1 -1
  121. package/dist/core/models-store.d.ts +12 -7
  122. package/dist/core/models-store.d.ts.map +1 -1
  123. package/dist/core/models-store.js +83 -14
  124. package/dist/core/models-store.js.map +1 -1
  125. package/dist/core/package-manager.d.ts +6 -3
  126. package/dist/core/package-manager.d.ts.map +1 -1
  127. package/dist/core/package-manager.js +80 -61
  128. package/dist/core/package-manager.js.map +1 -1
  129. package/dist/core/pi-manifest.d.ts +8 -0
  130. package/dist/core/pi-manifest.d.ts.map +1 -0
  131. package/dist/core/pi-manifest.js +28 -0
  132. package/dist/core/pi-manifest.js.map +1 -0
  133. package/dist/core/provider-composer.d.ts +4 -1
  134. package/dist/core/provider-composer.d.ts.map +1 -1
  135. package/dist/core/provider-composer.js +36 -15
  136. package/dist/core/provider-composer.js.map +1 -1
  137. package/dist/core/remote-catalog-provider.d.ts.map +1 -1
  138. package/dist/core/remote-catalog-provider.js +73 -67
  139. package/dist/core/remote-catalog-provider.js.map +1 -1
  140. package/dist/core/resource-loader.d.ts.map +1 -1
  141. package/dist/core/resource-loader.js +2 -2
  142. package/dist/core/resource-loader.js.map +1 -1
  143. package/dist/core/runtime-credentials.d.ts +5 -5
  144. package/dist/core/runtime-credentials.d.ts.map +1 -1
  145. package/dist/core/runtime-credentials.js +11 -8
  146. package/dist/core/runtime-credentials.js.map +1 -1
  147. package/dist/core/sdk.d.ts +1 -1
  148. package/dist/core/sdk.d.ts.map +1 -1
  149. package/dist/core/sdk.js +2 -2
  150. package/dist/core/sdk.js.map +1 -1
  151. package/dist/core/session-manager.d.ts.map +1 -1
  152. package/dist/core/session-manager.js +3 -1
  153. package/dist/core/session-manager.js.map +1 -1
  154. package/dist/core/settings-manager.d.ts +12 -0
  155. package/dist/core/settings-manager.d.ts.map +1 -1
  156. package/dist/core/settings-manager.js +40 -16
  157. package/dist/core/settings-manager.js.map +1 -1
  158. package/dist/core/system-prompt.d.ts.map +1 -1
  159. package/dist/core/system-prompt.js +8 -0
  160. package/dist/core/system-prompt.js.map +1 -1
  161. package/dist/core/tools/bash.d.ts +5 -1
  162. package/dist/core/tools/bash.d.ts.map +1 -1
  163. package/dist/core/tools/bash.js +16 -15
  164. package/dist/core/tools/bash.js.map +1 -1
  165. package/dist/core/tools/edit.d.ts +4 -0
  166. package/dist/core/tools/edit.d.ts.map +1 -1
  167. package/dist/core/tools/edit.js +11 -7
  168. package/dist/core/tools/edit.js.map +1 -1
  169. package/dist/core/tools/find.d.ts +7 -0
  170. package/dist/core/tools/find.d.ts.map +1 -1
  171. package/dist/core/tools/find.js +16 -19
  172. package/dist/core/tools/find.js.map +1 -1
  173. package/dist/core/tools/grep.d.ts +4 -0
  174. package/dist/core/tools/grep.d.ts.map +1 -1
  175. package/dist/core/tools/grep.js +5 -1
  176. package/dist/core/tools/grep.js.map +1 -1
  177. package/dist/core/tools/ls.d.ts +4 -0
  178. package/dist/core/tools/ls.d.ts.map +1 -1
  179. package/dist/core/tools/ls.js +5 -1
  180. package/dist/core/tools/ls.js.map +1 -1
  181. package/dist/core/tools/read.d.ts +4 -0
  182. package/dist/core/tools/read.d.ts.map +1 -1
  183. package/dist/core/tools/read.js +7 -3
  184. package/dist/core/tools/read.js.map +1 -1
  185. package/dist/core/tools/write.d.ts +4 -0
  186. package/dist/core/tools/write.d.ts.map +1 -1
  187. package/dist/core/tools/write.js +6 -2
  188. package/dist/core/tools/write.js.map +1 -1
  189. package/dist/extensions/llama/index.d.ts.map +1 -1
  190. package/dist/extensions/llama/index.js +11 -2
  191. package/dist/extensions/llama/index.js.map +1 -1
  192. package/dist/extensions/llama/provider.d.ts.map +1 -1
  193. package/dist/extensions/llama/provider.js +21 -7
  194. package/dist/extensions/llama/provider.js.map +1 -1
  195. package/dist/humain/agent-execution-protocol.d.ts +218 -0
  196. package/dist/humain/agent-execution-protocol.d.ts.map +1 -0
  197. package/dist/humain/agent-execution-protocol.js +204 -0
  198. package/dist/humain/agent-execution-protocol.js.map +1 -0
  199. package/dist/humain/agent-execution-runtime.d.ts +35 -0
  200. package/dist/humain/agent-execution-runtime.d.ts.map +1 -0
  201. package/dist/humain/agent-execution-runtime.js +170 -0
  202. package/dist/humain/agent-execution-runtime.js.map +1 -0
  203. package/dist/humain/index.d.ts.map +1 -1
  204. package/dist/humain/index.js +8 -7
  205. package/dist/humain/index.js.map +1 -1
  206. package/dist/humain/mcp-adapter/vendor/CHANGELOG.md +660 -0
  207. package/dist/humain/mcp-adapter/vendor/LICENSE +21 -0
  208. package/dist/humain/mcp-adapter/vendor/README.md +733 -0
  209. package/dist/humain/mcp-adapter/vendor/abort.ts +34 -0
  210. package/dist/humain/mcp-adapter/vendor/agent-dir.ts +60 -0
  211. package/dist/humain/mcp-adapter/vendor/agent-plugin-loader.ts +377 -0
  212. package/dist/humain/mcp-adapter/vendor/app-bridge.bundle.js +67 -0
  213. package/dist/humain/mcp-adapter/vendor/banner.png +0 -0
  214. package/dist/humain/mcp-adapter/vendor/cli.js +209 -0
  215. package/dist/humain/mcp-adapter/vendor/commands.ts +627 -0
  216. package/dist/humain/mcp-adapter/vendor/config.ts +1226 -0
  217. package/dist/humain/mcp-adapter/vendor/consent-manager.ts +64 -0
  218. package/dist/humain/mcp-adapter/vendor/direct-tools.ts +604 -0
  219. package/dist/humain/mcp-adapter/vendor/elicitation-handler.ts +348 -0
  220. package/dist/humain/mcp-adapter/vendor/error-signal.ts +21 -0
  221. package/dist/humain/mcp-adapter/vendor/errors.ts +223 -0
  222. package/dist/humain/mcp-adapter/vendor/glimpse-ui.ts +80 -0
  223. package/dist/humain/mcp-adapter/vendor/host-html-template.ts +461 -0
  224. package/dist/humain/mcp-adapter/vendor/index.bundle.d.mts +4 -0
  225. package/dist/humain/mcp-adapter/vendor/index.bundle.mjs +15923 -0
  226. package/dist/humain/mcp-adapter/vendor/index.ts +898 -0
  227. package/dist/humain/mcp-adapter/vendor/init.ts +649 -0
  228. package/dist/humain/mcp-adapter/vendor/json-schema-validator.ts +69 -0
  229. package/dist/humain/mcp-adapter/vendor/lifecycle.ts +147 -0
  230. package/dist/humain/mcp-adapter/vendor/logger.ts +169 -0
  231. package/dist/humain/mcp-adapter/vendor/mcp-auth-flow.ts +993 -0
  232. package/dist/humain/mcp-adapter/vendor/mcp-auth.ts +1000 -0
  233. package/dist/humain/mcp-adapter/vendor/mcp-callback-server.ts +510 -0
  234. package/dist/humain/mcp-adapter/vendor/mcp-code.ts +354 -0
  235. package/dist/humain/mcp-adapter/vendor/mcp-keyring-helper.cjs +89 -0
  236. package/dist/humain/mcp-adapter/vendor/mcp-oauth-provider.ts +616 -0
  237. package/dist/humain/mcp-adapter/vendor/mcp-output-guard.ts +408 -0
  238. package/dist/humain/mcp-adapter/vendor/mcp-panel.ts +1015 -0
  239. package/dist/humain/mcp-adapter/vendor/mcp-probe.ts +187 -0
  240. package/dist/humain/mcp-adapter/vendor/mcp-script-worker.mjs +130 -0
  241. package/dist/humain/mcp-adapter/vendor/mcp-setup-panel.ts +666 -0
  242. package/dist/humain/mcp-adapter/vendor/mcp-status.ts +109 -0
  243. package/dist/humain/mcp-adapter/vendor/mcp-trace.ts +306 -0
  244. package/dist/humain/mcp-adapter/vendor/metadata-cache.ts +353 -0
  245. package/dist/humain/mcp-adapter/vendor/npx-resolver.ts +543 -0
  246. package/dist/humain/mcp-adapter/vendor/oauth-handler.ts +30 -0
  247. package/dist/humain/mcp-adapter/vendor/oauth.ts +48 -0
  248. package/dist/humain/mcp-adapter/vendor/onboarding-state.ts +76 -0
  249. package/dist/humain/mcp-adapter/vendor/package.json +178 -0
  250. package/dist/humain/mcp-adapter/vendor/panel-keys.ts +53 -0
  251. package/dist/humain/mcp-adapter/vendor/prompts.ts +353 -0
  252. package/dist/humain/mcp-adapter/vendor/proxy-modes.ts +1331 -0
  253. package/dist/humain/mcp-adapter/vendor/resource-tools.ts +17 -0
  254. package/dist/humain/mcp-adapter/vendor/runtime-owner.ts +91 -0
  255. package/dist/humain/mcp-adapter/vendor/sampling-handler.ts +284 -0
  256. package/dist/humain/mcp-adapter/vendor/search-ranking.ts +206 -0
  257. package/dist/humain/mcp-adapter/vendor/server-manager.ts +1124 -0
  258. package/dist/humain/mcp-adapter/vendor/session-recovery.ts +151 -0
  259. package/dist/humain/mcp-adapter/vendor/skills/mcp-scripting/SKILL.md +38 -0
  260. package/dist/humain/mcp-adapter/vendor/state.ts +62 -0
  261. package/dist/humain/mcp-adapter/vendor/tool-approval.ts +182 -0
  262. package/dist/humain/mcp-adapter/vendor/tool-metadata.ts +276 -0
  263. package/dist/humain/mcp-adapter/vendor/tool-registrar.ts +253 -0
  264. package/dist/humain/mcp-adapter/vendor/tool-result-renderer.ts +423 -0
  265. package/dist/humain/mcp-adapter/vendor/ts-shape.ts +149 -0
  266. package/dist/humain/mcp-adapter/vendor/types.ts +859 -0
  267. package/dist/humain/mcp-adapter/vendor/ui-app-bridge-helpers.ts +40 -0
  268. package/dist/humain/mcp-adapter/vendor/ui-resource-handler.ts +250 -0
  269. package/dist/humain/mcp-adapter/vendor/ui-server.ts +866 -0
  270. package/dist/humain/mcp-adapter/vendor/ui-session.ts +570 -0
  271. package/dist/humain/mcp-adapter/vendor/ui-stream-types.ts +89 -0
  272. package/dist/humain/mcp-adapter/vendor/ui-tool-visibility.ts +25 -0
  273. package/dist/humain/mcp-adapter/vendor/unix-socket-transport.ts +85 -0
  274. package/dist/humain/mcp-adapter/vendor/utils.ts +310 -0
  275. package/dist/humain/mcp-adapter.d.ts +3 -0
  276. package/dist/humain/mcp-adapter.d.ts.map +1 -0
  277. package/dist/humain/mcp-adapter.js +5 -0
  278. package/dist/humain/mcp-adapter.js.map +1 -0
  279. package/dist/humain/pi-agent-execution-host.d.ts +34 -0
  280. package/dist/humain/pi-agent-execution-host.d.ts.map +1 -0
  281. package/dist/humain/pi-agent-execution-host.js +77 -0
  282. package/dist/humain/pi-agent-execution-host.js.map +1 -0
  283. package/dist/humain/web-access/host.d.ts +4 -0
  284. package/dist/humain/web-access/host.d.ts.map +1 -0
  285. package/dist/humain/web-access/host.js +3 -0
  286. package/dist/humain/web-access/host.js.map +1 -0
  287. package/dist/humain/web-access/index.d.ts +3 -0
  288. package/dist/humain/web-access/index.d.ts.map +1 -0
  289. package/dist/humain/web-access/index.js +5 -0
  290. package/dist/humain/web-access/index.js.map +1 -0
  291. package/dist/humain/web-access/vendor/activity.d.ts +34 -0
  292. package/dist/humain/web-access/vendor/activity.d.ts.map +1 -0
  293. package/dist/humain/web-access/vendor/activity.js +68 -0
  294. package/dist/humain/web-access/vendor/activity.js.map +1 -0
  295. package/dist/humain/web-access/vendor/anysearch.d.ts +8 -0
  296. package/dist/humain/web-access/vendor/anysearch.d.ts.map +1 -0
  297. package/dist/humain/web-access/vendor/anysearch.js +167 -0
  298. package/dist/humain/web-access/vendor/anysearch.js.map +1 -0
  299. package/dist/humain/web-access/vendor/bocha.d.ts +4 -0
  300. package/dist/humain/web-access/vendor/bocha.d.ts.map +1 -0
  301. package/dist/humain/web-access/vendor/bocha.js +219 -0
  302. package/dist/humain/web-access/vendor/bocha.js.map +1 -0
  303. package/dist/humain/web-access/vendor/brave.d.ts +4 -0
  304. package/dist/humain/web-access/vendor/brave.d.ts.map +1 -0
  305. package/dist/humain/web-access/vendor/brave.js +194 -0
  306. package/dist/humain/web-access/vendor/brave.js.map +1 -0
  307. package/dist/humain/web-access/vendor/brightdata-unlocker.d.ts +12 -0
  308. package/dist/humain/web-access/vendor/brightdata-unlocker.d.ts.map +1 -0
  309. package/dist/humain/web-access/vendor/brightdata-unlocker.js +230 -0
  310. package/dist/humain/web-access/vendor/brightdata-unlocker.js.map +1 -0
  311. package/dist/humain/web-access/vendor/brightdata.d.ts +8 -0
  312. package/dist/humain/web-access/vendor/brightdata.d.ts.map +1 -0
  313. package/dist/humain/web-access/vendor/brightdata.js +519 -0
  314. package/dist/humain/web-access/vendor/brightdata.js.map +1 -0
  315. package/dist/humain/web-access/vendor/chrome-cookies.d.ts +10 -0
  316. package/dist/humain/web-access/vendor/chrome-cookies.d.ts.map +1 -0
  317. package/dist/humain/web-access/vendor/chrome-cookies.js +438 -0
  318. package/dist/humain/web-access/vendor/chrome-cookies.js.map +1 -0
  319. package/dist/humain/web-access/vendor/content-find.d.ts +11 -0
  320. package/dist/humain/web-access/vendor/content-find.d.ts.map +1 -0
  321. package/dist/humain/web-access/vendor/content-find.js +117 -0
  322. package/dist/humain/web-access/vendor/content-find.js.map +1 -0
  323. package/dist/humain/web-access/vendor/credential-source.d.ts +28 -0
  324. package/dist/humain/web-access/vendor/credential-source.d.ts.map +1 -0
  325. package/dist/humain/web-access/vendor/credential-source.js +151 -0
  326. package/dist/humain/web-access/vendor/credential-source.js.map +1 -0
  327. package/dist/humain/web-access/vendor/curator-page.d.ts +29 -0
  328. package/dist/humain/web-access/vendor/curator-page.d.ts.map +1 -0
  329. package/dist/humain/web-access/vendor/curator-page.js +3554 -0
  330. package/dist/humain/web-access/vendor/curator-page.js.map +1 -0
  331. package/dist/humain/web-access/vendor/curator-server.d.ts +93 -0
  332. package/dist/humain/web-access/vendor/curator-server.d.ts.map +1 -0
  333. package/dist/humain/web-access/vendor/curator-server.js +688 -0
  334. package/dist/humain/web-access/vendor/curator-server.js.map +1 -0
  335. package/dist/humain/web-access/vendor/datalab-pdf-extract.d.ts +60 -0
  336. package/dist/humain/web-access/vendor/datalab-pdf-extract.d.ts.map +1 -0
  337. package/dist/humain/web-access/vendor/datalab-pdf-extract.js +416 -0
  338. package/dist/humain/web-access/vendor/datalab-pdf-extract.js.map +1 -0
  339. package/dist/humain/web-access/vendor/declared-web-links.d.ts +16 -0
  340. package/dist/humain/web-access/vendor/declared-web-links.d.ts.map +1 -0
  341. package/dist/humain/web-access/vendor/declared-web-links.js +168 -0
  342. package/dist/humain/web-access/vendor/declared-web-links.js.map +1 -0
  343. package/dist/humain/web-access/vendor/duckduckgo.d.ts +4 -0
  344. package/dist/humain/web-access/vendor/duckduckgo.d.ts.map +1 -0
  345. package/dist/humain/web-access/vendor/duckduckgo.js +123 -0
  346. package/dist/humain/web-access/vendor/duckduckgo.js.map +1 -0
  347. package/dist/humain/web-access/vendor/exa.d.ts +10 -0
  348. package/dist/humain/web-access/vendor/exa.d.ts.map +1 -0
  349. package/dist/humain/web-access/vendor/exa.js +426 -0
  350. package/dist/humain/web-access/vendor/exa.js.map +1 -0
  351. package/dist/humain/web-access/vendor/extract.d.ts +46 -0
  352. package/dist/humain/web-access/vendor/extract.d.ts.map +1 -0
  353. package/dist/humain/web-access/vendor/extract.js +1064 -0
  354. package/dist/humain/web-access/vendor/extract.js.map +1 -0
  355. package/dist/humain/web-access/vendor/feature-config.d.ts +3 -0
  356. package/dist/humain/web-access/vendor/feature-config.d.ts.map +1 -0
  357. package/dist/humain/web-access/vendor/feature-config.js +27 -0
  358. package/dist/humain/web-access/vendor/feature-config.js.map +1 -0
  359. package/dist/humain/web-access/vendor/fetch-params.d.ts +25 -0
  360. package/dist/humain/web-access/vendor/fetch-params.d.ts.map +1 -0
  361. package/dist/humain/web-access/vendor/fetch-params.js +57 -0
  362. package/dist/humain/web-access/vendor/fetch-params.js.map +1 -0
  363. package/dist/humain/web-access/vendor/firecrawl.d.ts +12 -0
  364. package/dist/humain/web-access/vendor/firecrawl.d.ts.map +1 -0
  365. package/dist/humain/web-access/vendor/firecrawl.js +239 -0
  366. package/dist/humain/web-access/vendor/firecrawl.js.map +1 -0
  367. package/dist/humain/web-access/vendor/gemini-api.d.ts +27 -0
  368. package/dist/humain/web-access/vendor/gemini-api.d.ts.map +1 -0
  369. package/dist/humain/web-access/vendor/gemini-api.js +230 -0
  370. package/dist/humain/web-access/vendor/gemini-api.js.map +1 -0
  371. package/dist/humain/web-access/vendor/gemini-pdf-extract.d.ts +9 -0
  372. package/dist/humain/web-access/vendor/gemini-pdf-extract.d.ts.map +1 -0
  373. package/dist/humain/web-access/vendor/gemini-pdf-extract.js +85 -0
  374. package/dist/humain/web-access/vendor/gemini-pdf-extract.js.map +1 -0
  375. package/dist/humain/web-access/vendor/gemini-search.d.ts +40 -0
  376. package/dist/humain/web-access/vendor/gemini-search.d.ts.map +1 -0
  377. package/dist/humain/web-access/vendor/gemini-search.js +814 -0
  378. package/dist/humain/web-access/vendor/gemini-search.js.map +1 -0
  379. package/dist/humain/web-access/vendor/gemini-url-context.d.ts +4 -0
  380. package/dist/humain/web-access/vendor/gemini-url-context.d.ts.map +1 -0
  381. package/dist/humain/web-access/vendor/gemini-url-context.js +101 -0
  382. package/dist/humain/web-access/vendor/gemini-url-context.js.map +1 -0
  383. package/dist/humain/web-access/vendor/gemini-web-config.d.ts +4 -0
  384. package/dist/humain/web-access/vendor/gemini-web-config.d.ts.map +1 -0
  385. package/dist/humain/web-access/vendor/gemini-web-config.js +42 -0
  386. package/dist/humain/web-access/vendor/gemini-web-config.js.map +1 -0
  387. package/dist/humain/web-access/vendor/gemini-web.d.ts +18 -0
  388. package/dist/humain/web-access/vendor/gemini-web.d.ts.map +1 -0
  389. package/dist/humain/web-access/vendor/gemini-web.js +385 -0
  390. package/dist/humain/web-access/vendor/gemini-web.js.map +1 -0
  391. package/dist/humain/web-access/vendor/github-api.d.ts +7 -0
  392. package/dist/humain/web-access/vendor/github-api.d.ts.map +1 -0
  393. package/dist/humain/web-access/vendor/github-api.js +160 -0
  394. package/dist/humain/web-access/vendor/github-api.js.map +1 -0
  395. package/dist/humain/web-access/vendor/github-extract.d.ts +13 -0
  396. package/dist/humain/web-access/vendor/github-extract.d.ts.map +1 -0
  397. package/dist/humain/web-access/vendor/github-extract.js +635 -0
  398. package/dist/humain/web-access/vendor/github-extract.js.map +1 -0
  399. package/dist/humain/web-access/vendor/index.d.ts +4 -0
  400. package/dist/humain/web-access/vendor/index.d.ts.map +1 -0
  401. package/dist/humain/web-access/vendor/index.js +3002 -0
  402. package/dist/humain/web-access/vendor/index.js.map +1 -0
  403. package/dist/humain/web-access/vendor/jina-search.d.ts +8 -0
  404. package/dist/humain/web-access/vendor/jina-search.d.ts.map +1 -0
  405. package/dist/humain/web-access/vendor/jina-search.js +255 -0
  406. package/dist/humain/web-access/vendor/jina-search.js.map +1 -0
  407. package/dist/humain/web-access/vendor/kagi.d.ts +15 -0
  408. package/dist/humain/web-access/vendor/kagi.d.ts.map +1 -0
  409. package/dist/humain/web-access/vendor/kagi.js +262 -0
  410. package/dist/humain/web-access/vendor/kagi.js.map +1 -0
  411. package/dist/humain/web-access/vendor/ollama.d.ts +15 -0
  412. package/dist/humain/web-access/vendor/ollama.d.ts.map +1 -0
  413. package/dist/humain/web-access/vendor/ollama.js +216 -0
  414. package/dist/humain/web-access/vendor/ollama.js.map +1 -0
  415. package/dist/humain/web-access/vendor/openai-search.d.ts +15 -0
  416. package/dist/humain/web-access/vendor/openai-search.d.ts.map +1 -0
  417. package/dist/humain/web-access/vendor/openai-search.js +459 -0
  418. package/dist/humain/web-access/vendor/openai-search.js.map +1 -0
  419. package/dist/humain/web-access/vendor/page-query.d.ts +16 -0
  420. package/dist/humain/web-access/vendor/page-query.d.ts.map +1 -0
  421. package/dist/humain/web-access/vendor/page-query.js +79 -0
  422. package/dist/humain/web-access/vendor/page-query.js.map +1 -0
  423. package/dist/humain/web-access/vendor/parallel.d.ts +12 -0
  424. package/dist/humain/web-access/vendor/parallel.d.ts.map +1 -0
  425. package/dist/humain/web-access/vendor/parallel.js +343 -0
  426. package/dist/humain/web-access/vendor/parallel.js.map +1 -0
  427. package/dist/humain/web-access/vendor/pdf-extract.d.ts +44 -0
  428. package/dist/humain/web-access/vendor/pdf-extract.d.ts.map +1 -0
  429. package/dist/humain/web-access/vendor/pdf-extract.js +298 -0
  430. package/dist/humain/web-access/vendor/pdf-extract.js.map +1 -0
  431. package/dist/humain/web-access/vendor/perplexity.d.ts +20 -0
  432. package/dist/humain/web-access/vendor/perplexity.d.ts.map +1 -0
  433. package/dist/humain/web-access/vendor/perplexity.js +159 -0
  434. package/dist/humain/web-access/vendor/perplexity.js.map +1 -0
  435. package/dist/humain/web-access/vendor/querit.d.ts +10 -0
  436. package/dist/humain/web-access/vendor/querit.d.ts.map +1 -0
  437. package/dist/humain/web-access/vendor/querit.js +335 -0
  438. package/dist/humain/web-access/vendor/querit.js.map +1 -0
  439. package/dist/humain/web-access/vendor/render-search-error.d.ts +57 -0
  440. package/dist/humain/web-access/vendor/render-search-error.d.ts.map +1 -0
  441. package/dist/humain/web-access/vendor/render-search-error.js +130 -0
  442. package/dist/humain/web-access/vendor/render-search-error.js.map +1 -0
  443. package/dist/humain/web-access/vendor/rsc-extract.d.ts +12 -0
  444. package/dist/humain/web-access/vendor/rsc-extract.d.ts.map +1 -0
  445. package/dist/humain/web-access/vendor/rsc-extract.js +329 -0
  446. package/dist/humain/web-access/vendor/rsc-extract.js.map +1 -0
  447. package/dist/humain/web-access/vendor/search1api.d.ts +10 -0
  448. package/dist/humain/web-access/vendor/search1api.d.ts.map +1 -0
  449. package/dist/humain/web-access/vendor/search1api.js +251 -0
  450. package/dist/humain/web-access/vendor/search1api.js.map +1 -0
  451. package/dist/humain/web-access/vendor/searchinfinity.d.ts +8 -0
  452. package/dist/humain/web-access/vendor/searchinfinity.d.ts.map +1 -0
  453. package/dist/humain/web-access/vendor/searchinfinity.js +229 -0
  454. package/dist/humain/web-access/vendor/searchinfinity.js.map +1 -0
  455. package/dist/humain/web-access/vendor/searxng.d.ts +4 -0
  456. package/dist/humain/web-access/vendor/searxng.d.ts.map +1 -0
  457. package/dist/humain/web-access/vendor/searxng.js +238 -0
  458. package/dist/humain/web-access/vendor/searxng.js.map +1 -0
  459. package/dist/humain/web-access/vendor/serpbase.d.ts +4 -0
  460. package/dist/humain/web-access/vendor/serpbase.d.ts.map +1 -0
  461. package/dist/humain/web-access/vendor/serpbase.js +211 -0
  462. package/dist/humain/web-access/vendor/serpbase.js.map +1 -0
  463. package/dist/humain/web-access/vendor/serpdive.d.ts +8 -0
  464. package/dist/humain/web-access/vendor/serpdive.d.ts.map +1 -0
  465. package/dist/humain/web-access/vendor/serpdive.js +267 -0
  466. package/dist/humain/web-access/vendor/serpdive.js.map +1 -0
  467. package/dist/humain/web-access/vendor/source-check.d.ts +99 -0
  468. package/dist/humain/web-access/vendor/source-check.d.ts.map +1 -0
  469. package/dist/humain/web-access/vendor/source-check.js +205 -0
  470. package/dist/humain/web-access/vendor/source-check.js.map +1 -0
  471. package/dist/humain/web-access/vendor/ssrf-protection.d.ts +50 -0
  472. package/dist/humain/web-access/vendor/ssrf-protection.d.ts.map +1 -0
  473. package/dist/humain/web-access/vendor/ssrf-protection.js +466 -0
  474. package/dist/humain/web-access/vendor/ssrf-protection.js.map +1 -0
  475. package/dist/humain/web-access/vendor/storage.d.ts +55 -0
  476. package/dist/humain/web-access/vendor/storage.d.ts.map +1 -0
  477. package/dist/humain/web-access/vendor/storage.js +485 -0
  478. package/dist/humain/web-access/vendor/storage.js.map +1 -0
  479. package/dist/humain/web-access/vendor/summary-model-scope.d.ts +25 -0
  480. package/dist/humain/web-access/vendor/summary-model-scope.d.ts.map +1 -0
  481. package/dist/humain/web-access/vendor/summary-model-scope.js +98 -0
  482. package/dist/humain/web-access/vendor/summary-model-scope.js.map +1 -0
  483. package/dist/humain/web-access/vendor/summary-review.d.ts +24 -0
  484. package/dist/humain/web-access/vendor/summary-review.d.ts.map +1 -0
  485. package/dist/humain/web-access/vendor/summary-review.js +341 -0
  486. package/dist/humain/web-access/vendor/summary-review.js.map +1 -0
  487. package/dist/humain/web-access/vendor/tavily.d.ts +8 -0
  488. package/dist/humain/web-access/vendor/tavily.d.ts.map +1 -0
  489. package/dist/humain/web-access/vendor/tavily.js +194 -0
  490. package/dist/humain/web-access/vendor/tavily.js.map +1 -0
  491. package/dist/humain/web-access/vendor/tinyfish.d.ts +11 -0
  492. package/dist/humain/web-access/vendor/tinyfish.d.ts.map +1 -0
  493. package/dist/humain/web-access/vendor/tinyfish.js +331 -0
  494. package/dist/humain/web-access/vendor/tinyfish.js.map +1 -0
  495. package/dist/humain/web-access/vendor/utils.d.ts +20 -0
  496. package/dist/humain/web-access/vendor/utils.d.ts.map +1 -0
  497. package/dist/humain/web-access/vendor/utils.js +91 -0
  498. package/dist/humain/web-access/vendor/utils.js.map +1 -0
  499. package/dist/humain/web-access/vendor/video-extract.d.ts +16 -0
  500. package/dist/humain/web-access/vendor/video-extract.d.ts.map +1 -0
  501. package/dist/humain/web-access/vendor/video-extract.js +335 -0
  502. package/dist/humain/web-access/vendor/video-extract.js.map +1 -0
  503. package/dist/humain/web-access/vendor/xai-search.d.ts +13 -0
  504. package/dist/humain/web-access/vendor/xai-search.d.ts.map +1 -0
  505. package/dist/humain/web-access/vendor/xai-search.js +331 -0
  506. package/dist/humain/web-access/vendor/xai-search.js.map +1 -0
  507. package/dist/humain/web-access/vendor/youtube-extract.d.ts +27 -0
  508. package/dist/humain/web-access/vendor/youtube-extract.d.ts.map +1 -0
  509. package/dist/humain/web-access/vendor/youtube-extract.js +282 -0
  510. package/dist/humain/web-access/vendor/youtube-extract.js.map +1 -0
  511. package/dist/index.d.ts +7 -4
  512. package/dist/index.d.ts.map +1 -1
  513. package/dist/index.js +5 -2
  514. package/dist/index.js.map +1 -1
  515. package/dist/main.d.ts +2 -2
  516. package/dist/main.d.ts.map +1 -1
  517. package/dist/main.js +169 -102
  518. package/dist/main.js.map +1 -1
  519. package/dist/modes/agent-exec-mode.d.ts +14 -0
  520. package/dist/modes/agent-exec-mode.d.ts.map +1 -0
  521. package/dist/modes/agent-exec-mode.js +92 -0
  522. package/dist/modes/agent-exec-mode.js.map +1 -0
  523. package/dist/modes/index.d.ts +4 -2
  524. package/dist/modes/index.d.ts.map +1 -1
  525. package/dist/modes/index.js +2 -1
  526. package/dist/modes/index.js.map +1 -1
  527. package/dist/modes/interactive/components/assistant-message.d.ts +5 -2
  528. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  529. package/dist/modes/interactive/components/assistant-message.js +13 -4
  530. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  531. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  532. package/dist/modes/interactive/components/custom-editor.js +7 -0
  533. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  534. package/dist/modes/interactive/components/earendil-announcement.d.ts +5 -0
  535. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -0
  536. package/dist/modes/interactive/components/earendil-announcement.js +40 -0
  537. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -0
  538. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  539. package/dist/modes/interactive/components/footer.js +1 -1
  540. package/dist/modes/interactive/components/footer.js.map +1 -1
  541. package/dist/modes/interactive/components/markdown-transform.d.ts +3 -0
  542. package/dist/modes/interactive/components/markdown-transform.d.ts.map +1 -0
  543. package/dist/modes/interactive/components/markdown-transform.js +19 -0
  544. package/dist/modes/interactive/components/markdown-transform.js.map +1 -0
  545. package/dist/modes/interactive/components/mermaid.d.ts +11 -0
  546. package/dist/modes/interactive/components/mermaid.d.ts.map +1 -0
  547. package/dist/modes/interactive/components/mermaid.js +75 -0
  548. package/dist/modes/interactive/components/mermaid.js.map +1 -0
  549. package/dist/modes/interactive/components/model-selector.d.ts +1 -1
  550. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  551. package/dist/modes/interactive/components/model-selector.js +16 -4
  552. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  553. package/dist/modes/interactive/components/scoped-models-selector.d.ts +4 -0
  554. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  555. package/dist/modes/interactive/components/scoped-models-selector.js +26 -0
  556. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  557. package/dist/modes/interactive/components/settings-selector.d.ts +8 -2
  558. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  559. package/dist/modes/interactive/components/settings-selector.js +30 -0
  560. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  561. package/dist/modes/interactive/components/user-message.d.ts +3 -1
  562. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  563. package/dist/modes/interactive/components/user-message.js +9 -2
  564. package/dist/modes/interactive/components/user-message.js.map +1 -1
  565. package/dist/modes/interactive/interactive-mode.d.ts +45 -9
  566. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  567. package/dist/modes/interactive/interactive-mode.js +581 -211
  568. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  569. package/dist/modes/interactive/theme/dark.json +1 -0
  570. package/dist/modes/interactive/theme/light.json +1 -0
  571. package/dist/modes/interactive/theme/theme-controller.d.ts +3 -0
  572. package/dist/modes/interactive/theme/theme-controller.d.ts.map +1 -1
  573. package/dist/modes/interactive/theme/theme-controller.js +10 -1
  574. package/dist/modes/interactive/theme/theme-controller.js.map +1 -1
  575. package/dist/modes/interactive/theme/theme-schema.json +5 -1
  576. package/dist/modes/interactive/theme/theme.d.ts +2 -2
  577. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  578. package/dist/modes/interactive/theme/theme.js +24 -6
  579. package/dist/modes/interactive/theme/theme.js.map +1 -1
  580. package/dist/modes/json-event.d.ts +28 -0
  581. package/dist/modes/json-event.d.ts.map +1 -0
  582. package/dist/modes/json-event.js +12 -0
  583. package/dist/modes/json-event.js.map +1 -0
  584. package/dist/modes/print-mode.d.ts.map +1 -1
  585. package/dist/modes/print-mode.js +12 -2
  586. package/dist/modes/print-mode.js.map +1 -1
  587. package/dist/modes/rpc/rpc-client.d.ts +12 -5
  588. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  589. package/dist/modes/rpc/rpc-client.js +55 -1
  590. package/dist/modes/rpc/rpc-client.js.map +1 -1
  591. package/dist/modes/rpc/rpc-mode.d.ts +1 -1
  592. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  593. package/dist/modes/rpc/rpc-mode.js +13 -3
  594. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  595. package/dist/modes/rpc/rpc-types.d.ts +15 -0
  596. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  597. package/dist/modes/rpc/rpc-types.js.map +1 -1
  598. package/dist/package-manager-cli.d.ts.map +1 -1
  599. package/dist/package-manager-cli.js +11 -9
  600. package/dist/package-manager-cli.js.map +1 -1
  601. package/dist/rpc-entry.d.ts.map +1 -1
  602. package/dist/rpc-entry.js +3 -2
  603. package/dist/rpc-entry.js.map +1 -1
  604. package/dist/server/create-harness.d.ts +26 -0
  605. package/dist/server/create-harness.d.ts.map +1 -0
  606. package/dist/server/create-harness.js +104 -0
  607. package/dist/server/create-harness.js.map +1 -0
  608. package/dist/utils/abort.d.ts +5 -0
  609. package/dist/utils/abort.d.ts.map +1 -0
  610. package/dist/utils/abort.js +48 -0
  611. package/dist/utils/abort.js.map +1 -0
  612. package/dist/utils/clipboard.d.ts +1 -1
  613. package/dist/utils/clipboard.d.ts.map +1 -1
  614. package/dist/utils/clipboard.js +22 -2
  615. package/dist/utils/clipboard.js.map +1 -1
  616. package/dist/utils/management-http.d.ts +23 -0
  617. package/dist/utils/management-http.d.ts.map +1 -0
  618. package/dist/utils/management-http.js +50 -0
  619. package/dist/utils/management-http.js.map +1 -0
  620. package/dist/utils/paths.d.ts +3 -0
  621. package/dist/utils/paths.d.ts.map +1 -1
  622. package/dist/utils/paths.js +23 -1
  623. package/dist/utils/paths.js.map +1 -1
  624. package/dist/utils/tool-result-images.d.ts +19 -0
  625. package/dist/utils/tool-result-images.d.ts.map +1 -0
  626. package/dist/utils/tool-result-images.js +45 -0
  627. package/dist/utils/tool-result-images.js.map +1 -0
  628. package/dist/utils/tools-manager.d.ts.map +1 -1
  629. package/dist/utils/tools-manager.js +13 -25
  630. package/dist/utils/tools-manager.js.map +1 -1
  631. package/dist/utils/version-check.d.ts +4 -0
  632. package/dist/utils/version-check.d.ts.map +1 -1
  633. package/dist/utils/version-check.js +23 -5
  634. package/dist/utils/version-check.js.map +1 -1
  635. package/docs/compaction.md +2 -2
  636. package/docs/custom-provider.md +7 -5
  637. package/docs/extensions.md +30 -5
  638. package/docs/humain-terminal.md +21 -1
  639. package/docs/json.md +24 -19
  640. package/docs/keybindings.md +46 -14
  641. package/docs/models.md +32 -11
  642. package/docs/providers.md +9 -1
  643. package/docs/quickstart.md +39 -37
  644. package/docs/rpc.md +31 -11
  645. package/docs/sdk.md +21 -2
  646. package/docs/security.md +21 -21
  647. package/docs/session-format.md +14 -14
  648. package/docs/settings.md +4 -1
  649. package/docs/themes.md +5 -3
  650. package/docs/usage.md +7 -0
  651. package/examples/extensions/custom-compaction.ts +3 -18
  652. package/examples/extensions/custom-provider-anthropic/index.ts +5 -1
  653. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  654. package/examples/extensions/custom-provider-anthropic/package.json +1 -1
  655. package/examples/extensions/custom-provider-gitlab-duo/index.ts +5 -1
  656. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  657. package/examples/extensions/doom-overlay/wad-finder.ts +7 -3
  658. package/examples/extensions/gondolin/package-lock.json +2 -2
  659. package/examples/extensions/gondolin/package.json +1 -1
  660. package/examples/extensions/handoff.ts +4 -13
  661. package/examples/extensions/qna.ts +5 -9
  662. package/examples/extensions/sandbox/package-lock.json +2 -2
  663. package/examples/extensions/sandbox/package.json +1 -1
  664. package/examples/extensions/summarize.ts +9 -20
  665. package/examples/extensions/with-deps/package-lock.json +2 -2
  666. package/examples/extensions/with-deps/package.json +1 -1
  667. package/examples/rpc-extension-ui.ts +11 -2
  668. package/examples/sdk/02-custom-model.ts +2 -3
  669. package/examples/sdk/09-api-keys-and-oauth.ts +1 -1
  670. package/examples/sdk/12-full-control.ts +1 -1
  671. package/examples/sdk/README.md +1 -1
  672. package/npm-shrinkwrap.json +2771 -535
  673. package/package.json +40 -11
  674. package/src/humain/mcp-adapter/UPSTREAM.md +15 -0
  675. package/src/humain/mcp-adapter/upstream.json +7 -0
  676. package/src/humain/mcp-adapter/vendor/CHANGELOG.md +660 -0
  677. package/src/humain/mcp-adapter/vendor/LICENSE +21 -0
  678. package/src/humain/web-access/UPSTREAM.md +17 -0
  679. package/src/humain/web-access/upstream.json +23 -0
  680. package/src/humain/web-access/vendor/LICENSE +21 -0
@@ -0,0 +1,117 @@
1
+ const CONTEXT_CHARS = 400;
2
+ const MAX_OUTPUT_CHARS = 20_000;
3
+ function normalize(value) {
4
+ return value.normalize("NFD").replace(/\p{Diacritic}/gu, "").toLocaleLowerCase();
5
+ }
6
+ function editDistanceWithin(left, right, maximum) {
7
+ if (Math.abs(left.length - right.length) > maximum)
8
+ return false;
9
+ let previous = Array.from({ length: right.length + 1 }, (_, index) => index);
10
+ for (let i = 1; i <= left.length; i++) {
11
+ const current = [i];
12
+ let rowMinimum = i;
13
+ for (let j = 1; j <= right.length; j++) {
14
+ const value = Math.min((previous[j] ?? 0) + 1, (current[j - 1] ?? 0) + 1, (previous[j - 1] ?? 0) + (left[i - 1] === right[j - 1] ? 0 : 1));
15
+ current[j] = value;
16
+ rowMinimum = Math.min(rowMinimum, value);
17
+ }
18
+ if (rowMinimum > maximum)
19
+ return false;
20
+ previous = current;
21
+ }
22
+ return (previous[right.length] ?? maximum + 1) <= maximum;
23
+ }
24
+ function literalMatches(text, query, caseInsensitive) {
25
+ const haystack = caseInsensitive ? text.toLocaleLowerCase() : text;
26
+ const needle = caseInsensitive ? query.toLocaleLowerCase() : query;
27
+ const matches = [];
28
+ for (let start = haystack.indexOf(needle); start >= 0; start = haystack.indexOf(needle, start + Math.max(needle.length, 1))) {
29
+ matches.push({ query, start, end: start + query.length });
30
+ }
31
+ return matches;
32
+ }
33
+ function fuzzyMatches(text, query) {
34
+ const queryTokens = normalize(query).match(/[\p{L}\p{N}]+/gu) ?? [];
35
+ if (queryTokens.length === 0)
36
+ return [];
37
+ const matches = [];
38
+ const paragraphs = /[^\n]+(?:\n(?!\n)[^\n]+)*/g;
39
+ for (const paragraph of text.matchAll(paragraphs)) {
40
+ const paragraphText = paragraph[0];
41
+ if (paragraphText.trim().length === 0 || paragraph.index === undefined)
42
+ continue;
43
+ const tokens = [...paragraphText.matchAll(/[\p{L}\p{N}]+/gu)];
44
+ const matched = queryTokens.filter(queryToken => tokens.some(token => {
45
+ const candidate = normalize(token[0]);
46
+ const maximum = queryToken.length >= 9 ? 2 : queryToken.length >= 5 ? 1 : 0;
47
+ return editDistanceWithin(queryToken, candidate, maximum);
48
+ }));
49
+ const required = queryTokens.length === 1 ? 1 : Math.ceil(queryTokens.length * 0.6);
50
+ if (matched.length < required)
51
+ continue;
52
+ const first = tokens.find(token => matched.some(queryToken => {
53
+ const maximum = queryToken.length >= 9 ? 2 : queryToken.length >= 5 ? 1 : 0;
54
+ return editDistanceWithin(queryToken, normalize(token[0]), maximum);
55
+ }));
56
+ const start = paragraph.index + (first?.index ?? 0);
57
+ matches.push({ query, start, end: start + (first?.[0].length ?? query.length) });
58
+ }
59
+ return matches;
60
+ }
61
+ function mergeRanges(textLength, matches) {
62
+ const ranges = [];
63
+ for (const match of [...matches].sort((left, right) => left.start - right.start)) {
64
+ const start = Math.max(0, match.start - CONTEXT_CHARS);
65
+ const end = Math.min(textLength, match.end + CONTEXT_CHARS);
66
+ const previous = ranges.at(-1);
67
+ if (previous && start <= previous.end) {
68
+ previous.end = Math.max(previous.end, end);
69
+ previous.matches.push(match);
70
+ }
71
+ else {
72
+ ranges.push({ start, end, matches: [match] });
73
+ }
74
+ }
75
+ return ranges;
76
+ }
77
+ export function findContent(text, queries, mode) {
78
+ const normalizedQueries = [...new Set(queries.map(query => query.trim()).filter(Boolean))];
79
+ const matches = normalizedQueries.flatMap(query => mode === "fuzzy"
80
+ ? fuzzyMatches(text, query)
81
+ : literalMatches(text, query, mode === "case-insensitive"));
82
+ const queryResults = normalizedQueries.map(query => ({
83
+ query,
84
+ matchCount: matches.filter(match => match.query === query).length,
85
+ }));
86
+ const heading = matches.length > 0 ? `Text matches (${mode})` : `Text matches (${mode}): no matches`;
87
+ const sections = [heading];
88
+ let formattedLength = heading.length;
89
+ let returnedMatches = 0;
90
+ for (const range of mergeRanges(text.length, matches)) {
91
+ const prefix = range.start > 0 ? "…" : "";
92
+ const suffix = range.end < text.length ? "…" : "";
93
+ const snippet = `${prefix}${text.slice(range.start, range.end).replace(/\s+/g, " ").trim()}${suffix}`;
94
+ const counts = [...new Set(range.matches.map(match => match.query))]
95
+ .map(query => `\"${query}\" ×${range.matches.filter(match => match.query === query).length}`)
96
+ .join(", ");
97
+ const section = `${sections.length}. ${counts}\n${snippet}`;
98
+ if (formattedLength + 2 + section.length > MAX_OUTPUT_CHARS)
99
+ break;
100
+ sections.push(section);
101
+ formattedLength += 2 + section.length;
102
+ returnedMatches += range.matches.length;
103
+ }
104
+ const missing = queryResults.filter(result => result.matchCount === 0).map(result => `\"${result.query}\"`);
105
+ const footer = [
106
+ ...(missing.length > 0 ? [`No matches: ${missing.join(", ")}`] : []),
107
+ ...(returnedMatches < matches.length ? [`Showing ${returnedMatches} of ${matches.length} matches.`] : []),
108
+ ];
109
+ for (const section of footer) {
110
+ if (formattedLength + 2 + section.length > MAX_OUTPUT_CHARS)
111
+ break;
112
+ sections.push(section);
113
+ formattedLength += 2 + section.length;
114
+ }
115
+ return { text: sections.join("\n\n"), matchCount: matches.length, returnedMatches, queryResults };
116
+ }
117
+ //# sourceMappingURL=content-find.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"content-find.js","sourceRoot":"","sources":["../../../../src/humain/web-access/vendor/content-find.ts"],"names":[],"mappings":"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","sourcesContent":["export type FindMode = \"exact\" | \"case-insensitive\" | \"fuzzy\";\n\nconst CONTEXT_CHARS = 400;\nconst MAX_OUTPUT_CHARS = 20_000;\n\ninterface Match {\n\tquery: string;\n\tstart: number;\n\tend: number;\n}\n\ninterface Range {\n\tstart: number;\n\tend: number;\n\tmatches: Match[];\n}\n\nfunction normalize(value: string): string {\n\treturn value.normalize(\"NFD\").replace(/\\p{Diacritic}/gu, \"\").toLocaleLowerCase();\n}\n\nfunction editDistanceWithin(left: string, right: string, maximum: number): boolean {\n\tif (Math.abs(left.length - right.length) > maximum) return false;\n\tlet previous = Array.from({ length: right.length + 1 }, (_, index) => index);\n\tfor (let i = 1; i <= left.length; i++) {\n\t\tconst current = [i];\n\t\tlet rowMinimum = i;\n\t\tfor (let j = 1; j <= right.length; j++) {\n\t\t\tconst value = Math.min(\n\t\t\t\t(previous[j] ?? 0) + 1,\n\t\t\t\t(current[j - 1] ?? 0) + 1,\n\t\t\t\t(previous[j - 1] ?? 0) + (left[i - 1] === right[j - 1] ? 0 : 1),\n\t\t\t);\n\t\t\tcurrent[j] = value;\n\t\t\trowMinimum = Math.min(rowMinimum, value);\n\t\t}\n\t\tif (rowMinimum > maximum) return false;\n\t\tprevious = current;\n\t}\n\treturn (previous[right.length] ?? maximum + 1) <= maximum;\n}\n\nfunction literalMatches(text: string, query: string, caseInsensitive: boolean): Match[] {\n\tconst haystack = caseInsensitive ? text.toLocaleLowerCase() : text;\n\tconst needle = caseInsensitive ? query.toLocaleLowerCase() : query;\n\tconst matches: Match[] = [];\n\tfor (let start = haystack.indexOf(needle); start >= 0; start = haystack.indexOf(needle, start + Math.max(needle.length, 1))) {\n\t\tmatches.push({ query, start, end: start + query.length });\n\t}\n\treturn matches;\n}\n\nfunction fuzzyMatches(text: string, query: string): Match[] {\n\tconst queryTokens = normalize(query).match(/[\\p{L}\\p{N}]+/gu) ?? [];\n\tif (queryTokens.length === 0) return [];\n\tconst matches: Match[] = [];\n\tconst paragraphs = /[^\\n]+(?:\\n(?!\\n)[^\\n]+)*/g;\n\tfor (const paragraph of text.matchAll(paragraphs)) {\n\t\tconst paragraphText = paragraph[0];\n\t\tif (paragraphText.trim().length === 0 || paragraph.index === undefined) continue;\n\t\tconst tokens = [...paragraphText.matchAll(/[\\p{L}\\p{N}]+/gu)];\n\t\tconst matched = queryTokens.filter(queryToken => tokens.some(token => {\n\t\t\tconst candidate = normalize(token[0]);\n\t\t\tconst maximum = queryToken.length >= 9 ? 2 : queryToken.length >= 5 ? 1 : 0;\n\t\t\treturn editDistanceWithin(queryToken, candidate, maximum);\n\t\t}));\n\t\tconst required = queryTokens.length === 1 ? 1 : Math.ceil(queryTokens.length * 0.6);\n\t\tif (matched.length < required) continue;\n\t\tconst first = tokens.find(token => matched.some(queryToken => {\n\t\t\tconst maximum = queryToken.length >= 9 ? 2 : queryToken.length >= 5 ? 1 : 0;\n\t\t\treturn editDistanceWithin(queryToken, normalize(token[0]), maximum);\n\t\t}));\n\t\tconst start = paragraph.index + (first?.index ?? 0);\n\t\tmatches.push({ query, start, end: start + (first?.[0].length ?? query.length) });\n\t}\n\treturn matches;\n}\n\nfunction mergeRanges(textLength: number, matches: Match[]): Range[] {\n\tconst ranges: Range[] = [];\n\tfor (const match of [...matches].sort((left, right) => left.start - right.start)) {\n\t\tconst start = Math.max(0, match.start - CONTEXT_CHARS);\n\t\tconst end = Math.min(textLength, match.end + CONTEXT_CHARS);\n\t\tconst previous = ranges.at(-1);\n\t\tif (previous && start <= previous.end) {\n\t\t\tprevious.end = Math.max(previous.end, end);\n\t\t\tprevious.matches.push(match);\n\t\t} else {\n\t\t\tranges.push({ start, end, matches: [match] });\n\t\t}\n\t}\n\treturn ranges;\n}\n\nexport function findContent(\n\ttext: string,\n\tqueries: string[],\n\tmode: FindMode,\n): { text: string; matchCount: number; returnedMatches: number; queryResults: Array<{ query: string; matchCount: number }> } {\n\tconst normalizedQueries = [...new Set(queries.map(query => query.trim()).filter(Boolean))];\n\tconst matches = normalizedQueries.flatMap(query => mode === \"fuzzy\"\n\t\t? fuzzyMatches(text, query)\n\t\t: literalMatches(text, query, mode === \"case-insensitive\"));\n\tconst queryResults = normalizedQueries.map(query => ({\n\t\tquery,\n\t\tmatchCount: matches.filter(match => match.query === query).length,\n\t}));\n\n\tconst heading = matches.length > 0 ? `Text matches (${mode})` : `Text matches (${mode}): no matches`;\n\tconst sections = [heading];\n\tlet formattedLength = heading.length;\n\tlet returnedMatches = 0;\n\tfor (const range of mergeRanges(text.length, matches)) {\n\t\tconst prefix = range.start > 0 ? \"…\" : \"\";\n\t\tconst suffix = range.end < text.length ? \"…\" : \"\";\n\t\tconst snippet = `${prefix}${text.slice(range.start, range.end).replace(/\\s+/g, \" \").trim()}${suffix}`;\n\t\tconst counts = [...new Set(range.matches.map(match => match.query))]\n\t\t\t.map(query => `\\\"${query}\\\" ×${range.matches.filter(match => match.query === query).length}`)\n\t\t\t.join(\", \");\n\t\tconst section = `${sections.length}. ${counts}\\n${snippet}`;\n\t\tif (formattedLength + 2 + section.length > MAX_OUTPUT_CHARS) break;\n\t\tsections.push(section);\n\t\tformattedLength += 2 + section.length;\n\t\treturnedMatches += range.matches.length;\n\t}\n\n\tconst missing = queryResults.filter(result => result.matchCount === 0).map(result => `\\\"${result.query}\\\"`);\n\tconst footer = [\n\t\t...(missing.length > 0 ? [`No matches: ${missing.join(\", \")}`] : []),\n\t\t...(returnedMatches < matches.length ? [`Showing ${returnedMatches} of ${matches.length} matches.`] : []),\n\t];\n\tfor (const section of footer) {\n\t\tif (formattedLength + 2 + section.length > MAX_OUTPUT_CHARS) break;\n\t\tsections.push(section);\n\t\tformattedLength += 2 + section.length;\n\t}\n\n\treturn { text: sections.join(\"\\n\\n\"), matchCount: matches.length, returnedMatches, queryResults };\n}\n"]}
@@ -0,0 +1,28 @@
1
+ export type CredentialFailureCategory = "invalid-source" | "command-failed" | "command-timeout" | "command-aborted" | "command-empty" | "command-invalid-output" | "command-output-too-large" | "environment-empty";
2
+ export declare class CredentialResolutionError extends Error {
3
+ readonly provider: string;
4
+ readonly category: CredentialFailureCategory;
5
+ constructor(provider: string, category: CredentialFailureCategory);
6
+ }
7
+ export interface CredentialCommandResult {
8
+ stdout: string | Buffer;
9
+ }
10
+ export interface CredentialCommandOptions {
11
+ signal?: AbortSignal;
12
+ timeoutMs: number;
13
+ maxOutputBytes: number;
14
+ environment: Record<string, string>;
15
+ }
16
+ export type CredentialCommandRunner = (command: string, options: CredentialCommandOptions) => Promise<CredentialCommandResult>;
17
+ export interface CredentialOptions {
18
+ provider: string;
19
+ configuredValue?: unknown;
20
+ environmentValue?: unknown;
21
+ environment?: Record<string, string | undefined>;
22
+ signal?: AbortSignal;
23
+ runCommand?: CredentialCommandRunner;
24
+ }
25
+ export declare function redactCredential(text: string, credential: string | null | undefined): string;
26
+ export declare function hasCredentialSource(options: CredentialOptions): boolean;
27
+ export declare function resolveCredential(options: CredentialOptions): Promise<string | null>;
28
+ //# sourceMappingURL=credential-source.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"credential-source.d.ts","sourceRoot":"","sources":["../../../../src/humain/web-access/vendor/credential-source.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,yBAAyB,GAClC,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,iBAAiB,GACjB,eAAe,GACf,wBAAwB,GACxB,0BAA0B,GAC1B,mBAAmB,CAAC;AAEvB,qBAAa,yBAA0B,SAAQ,KAAK;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAE7C,YAAY,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,yBAAyB,EAMhE;CACD;AAED,MAAM,WAAW,uBAAuB;IACvC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,MAAM,uBAAuB,GAAG,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,wBAAwB,KAC7B,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAEtC,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACrC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE5F;AA+DD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAKvE;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwC1F","sourcesContent":["import { exec } from \"node:child_process\";\nimport { promisify } from \"node:util\";\n\nconst execAsync = promisify(exec);\nconst COMMAND_TIMEOUT_MS = 5_000;\nconst MAX_CREDENTIAL_BYTES = 16_384;\nconst ENV_SOURCE = /^\\$(?:([A-Za-z_][A-Za-z0-9_]*)|\\{([A-Za-z_][A-Za-z0-9_]*)\\})$/;\nconst OP_SESSION_NAME = /^OP_SESSION_[A-Za-z0-9_]+$/;\nconst COMMAND_ENVIRONMENT_NAMES = [\n\t\"HOME\",\n\t\"USER\",\n\t\"LOGNAME\",\n\t\"PATH\",\n\t\"LANG\",\n\t\"LC_ALL\",\n\t\"LC_CTYPE\",\n\t\"TERM\",\n\t\"TMPDIR\",\n\t\"XDG_CONFIG_HOME\",\n\t\"XDG_RUNTIME_DIR\",\n\t\"DBUS_SESSION_BUS_ADDRESS\",\n\t\"SSH_AUTH_SOCK\",\n\t\"WSL_DISTRO_NAME\",\n\t\"WSL_INTEROP\",\n] as const;\n\nexport type CredentialFailureCategory =\n\t| \"invalid-source\"\n\t| \"command-failed\"\n\t| \"command-timeout\"\n\t| \"command-aborted\"\n\t| \"command-empty\"\n\t| \"command-invalid-output\"\n\t| \"command-output-too-large\"\n\t| \"environment-empty\";\n\nexport class CredentialResolutionError extends Error {\n\treadonly provider: string;\n\treadonly category: CredentialFailureCategory;\n\n\tconstructor(provider: string, category: CredentialFailureCategory) {\n\t\tconst suffix = category === \"command-aborted\" ? \"aborted\" : category;\n\t\tsuper(`${provider} credential resolution failed: ${suffix}`);\n\t\tthis.name = \"CredentialResolutionError\";\n\t\tthis.provider = provider;\n\t\tthis.category = category;\n\t}\n}\n\nexport interface CredentialCommandResult {\n\tstdout: string | Buffer;\n}\n\nexport interface CredentialCommandOptions {\n\tsignal?: AbortSignal;\n\ttimeoutMs: number;\n\tmaxOutputBytes: number;\n\tenvironment: Record<string, string>;\n}\n\nexport type CredentialCommandRunner = (\n\tcommand: string,\n\toptions: CredentialCommandOptions,\n) => Promise<CredentialCommandResult>;\n\nexport interface CredentialOptions {\n\tprovider: string;\n\tconfiguredValue?: unknown;\n\tenvironmentValue?: unknown;\n\tenvironment?: Record<string, string | undefined>;\n\tsignal?: AbortSignal;\n\trunCommand?: CredentialCommandRunner;\n}\n\nexport function redactCredential(text: string, credential: string | null | undefined): string {\n\treturn credential ? text.split(credential).join(\"[redacted]\") : text;\n}\n\nfunction normalize(value: unknown): string | null {\n\tif (typeof value !== \"string\") return null;\n\tconst normalized = value.trim();\n\treturn normalized.length > 0 ? normalized : null;\n}\n\nfunction commandEnvironment(source: Record<string, string | undefined>): Record<string, string> {\n\tconst environment: Record<string, string> = {};\n\tfor (const name of COMMAND_ENVIRONMENT_NAMES) {\n\t\tconst value = source[name];\n\t\tif (value !== undefined) environment[name] = value;\n\t}\n\tfor (const [name, value] of Object.entries(source)) {\n\t\tif (value !== undefined && OP_SESSION_NAME.test(name)) environment[name] = value;\n\t}\n\treturn environment;\n}\n\nfunction configuredSource(options: CredentialOptions): string | null {\n\treturn normalize(options.configuredValue);\n}\n\nfunction explicitEnvironmentName(source: string): string | null {\n\tconst match = source.match(ENV_SOURCE);\n\treturn match ? match[1] ?? match[2] : null;\n}\n\nfunction escapedSource(source: string): string | null {\n\tif (source.startsWith(\"$$\") || source.startsWith(\"$!\")) return source.slice(1);\n\treturn null;\n}\n\nfunction isMalformedExplicitSource(source: string): boolean {\n\treturn source.startsWith(\"$\") && escapedSource(source) === null && explicitEnvironmentName(source) === null;\n}\n\nasync function defaultRunCommand(\n\tcommand: string,\n\toptions: CredentialCommandOptions,\n): Promise<CredentialCommandResult> {\n\tconst result = await execAsync(command, {\n\t\tencoding: \"utf8\",\n\t\tenv: options.environment,\n\t\tmaxBuffer: options.maxOutputBytes + 1,\n\t\tsignal: options.signal,\n\t\ttimeout: options.timeoutMs,\n\t\twindowsHide: true,\n\t});\n\treturn { stdout: result.stdout };\n}\n\nfunction commandFailureCategory(error: unknown, signal?: AbortSignal): CredentialFailureCategory {\n\tif (signal?.aborted) return \"command-aborted\";\n\tif (error && typeof error === \"object\") {\n\t\tconst code = (error as { code?: string }).code;\n\t\tif (code === \"ERR_CHILD_PROCESS_STDIO_MAXBUFFER\") return \"command-output-too-large\";\n\t\tif ((error as { killed?: boolean }).killed || code === \"ETIMEDOUT\") return \"command-timeout\";\n\t}\n\treturn \"command-failed\";\n}\n\nexport function hasCredentialSource(options: CredentialOptions): boolean {\n\tconst source = configuredSource(options);\n\tif (source?.startsWith(\"!\")) return true;\n\tif (source?.startsWith(\"$\")) return true;\n\treturn normalize(options.environmentValue) !== null || source !== null;\n}\n\nexport async function resolveCredential(options: CredentialOptions): Promise<string | null> {\n\tconst source = configuredSource(options);\n\tconst escaped = source ? escapedSource(source) : null;\n\tif (escaped !== null) return escaped;\n\tif (source?.startsWith(\"!\")) {\n\t\tconst command = source.slice(1).trim();\n\t\tif (!command) throw new CredentialResolutionError(options.provider, \"invalid-source\");\n\t\tlet result: CredentialCommandResult;\n\t\ttry {\n\t\t\tresult = await (options.runCommand ?? defaultRunCommand)(command, {\n\t\t\t\tsignal: options.signal,\n\t\t\t\ttimeoutMs: COMMAND_TIMEOUT_MS,\n\t\t\t\tmaxOutputBytes: MAX_CREDENTIAL_BYTES,\n\t\t\t\tenvironment: commandEnvironment(options.environment ?? process.env),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tthrow new CredentialResolutionError(options.provider, commandFailureCategory(error, options.signal));\n\t\t}\n\t\tconst stdout = Buffer.isBuffer(result.stdout) ? result.stdout.toString(\"utf8\") : result.stdout;\n\t\tif (Buffer.byteLength(stdout, \"utf8\") > MAX_CREDENTIAL_BYTES) {\n\t\t\tthrow new CredentialResolutionError(options.provider, \"command-output-too-large\");\n\t\t}\n\t\tconst value = stdout.trim();\n\t\tif (!value) throw new CredentialResolutionError(options.provider, \"command-empty\");\n\t\tif (/[\\0-\\x1f\\x7f]/.test(value)) {\n\t\t\tthrow new CredentialResolutionError(options.provider, \"command-invalid-output\");\n\t\t}\n\t\treturn value;\n\t}\n\tif (source && isMalformedExplicitSource(source)) {\n\t\tthrow new CredentialResolutionError(options.provider, \"invalid-source\");\n\t}\n\tif (source?.startsWith(\"$\")) {\n\t\tconst name = explicitEnvironmentName(source);\n\t\tif (!name) throw new CredentialResolutionError(options.provider, \"invalid-source\");\n\t\tconst value = normalize((options.environment ?? process.env)[name]);\n\t\tif (!value) throw new CredentialResolutionError(options.provider, \"environment-empty\");\n\t\treturn value;\n\t}\n\treturn normalize(options.environmentValue) ?? source;\n}\n"]}
@@ -0,0 +1,151 @@
1
+ import { exec } from "node:child_process";
2
+ import { promisify } from "node:util";
3
+ const execAsync = promisify(exec);
4
+ const COMMAND_TIMEOUT_MS = 5_000;
5
+ const MAX_CREDENTIAL_BYTES = 16_384;
6
+ const ENV_SOURCE = /^\$(?:([A-Za-z_][A-Za-z0-9_]*)|\{([A-Za-z_][A-Za-z0-9_]*)\})$/;
7
+ const OP_SESSION_NAME = /^OP_SESSION_[A-Za-z0-9_]+$/;
8
+ const COMMAND_ENVIRONMENT_NAMES = [
9
+ "HOME",
10
+ "USER",
11
+ "LOGNAME",
12
+ "PATH",
13
+ "LANG",
14
+ "LC_ALL",
15
+ "LC_CTYPE",
16
+ "TERM",
17
+ "TMPDIR",
18
+ "XDG_CONFIG_HOME",
19
+ "XDG_RUNTIME_DIR",
20
+ "DBUS_SESSION_BUS_ADDRESS",
21
+ "SSH_AUTH_SOCK",
22
+ "WSL_DISTRO_NAME",
23
+ "WSL_INTEROP",
24
+ ];
25
+ export class CredentialResolutionError extends Error {
26
+ provider;
27
+ category;
28
+ constructor(provider, category) {
29
+ const suffix = category === "command-aborted" ? "aborted" : category;
30
+ super(`${provider} credential resolution failed: ${suffix}`);
31
+ this.name = "CredentialResolutionError";
32
+ this.provider = provider;
33
+ this.category = category;
34
+ }
35
+ }
36
+ export function redactCredential(text, credential) {
37
+ return credential ? text.split(credential).join("[redacted]") : text;
38
+ }
39
+ function normalize(value) {
40
+ if (typeof value !== "string")
41
+ return null;
42
+ const normalized = value.trim();
43
+ return normalized.length > 0 ? normalized : null;
44
+ }
45
+ function commandEnvironment(source) {
46
+ const environment = {};
47
+ for (const name of COMMAND_ENVIRONMENT_NAMES) {
48
+ const value = source[name];
49
+ if (value !== undefined)
50
+ environment[name] = value;
51
+ }
52
+ for (const [name, value] of Object.entries(source)) {
53
+ if (value !== undefined && OP_SESSION_NAME.test(name))
54
+ environment[name] = value;
55
+ }
56
+ return environment;
57
+ }
58
+ function configuredSource(options) {
59
+ return normalize(options.configuredValue);
60
+ }
61
+ function explicitEnvironmentName(source) {
62
+ const match = source.match(ENV_SOURCE);
63
+ return match ? match[1] ?? match[2] : null;
64
+ }
65
+ function escapedSource(source) {
66
+ if (source.startsWith("$$") || source.startsWith("$!"))
67
+ return source.slice(1);
68
+ return null;
69
+ }
70
+ function isMalformedExplicitSource(source) {
71
+ return source.startsWith("$") && escapedSource(source) === null && explicitEnvironmentName(source) === null;
72
+ }
73
+ async function defaultRunCommand(command, options) {
74
+ const result = await execAsync(command, {
75
+ encoding: "utf8",
76
+ env: options.environment,
77
+ maxBuffer: options.maxOutputBytes + 1,
78
+ signal: options.signal,
79
+ timeout: options.timeoutMs,
80
+ windowsHide: true,
81
+ });
82
+ return { stdout: result.stdout };
83
+ }
84
+ function commandFailureCategory(error, signal) {
85
+ if (signal?.aborted)
86
+ return "command-aborted";
87
+ if (error && typeof error === "object") {
88
+ const code = error.code;
89
+ if (code === "ERR_CHILD_PROCESS_STDIO_MAXBUFFER")
90
+ return "command-output-too-large";
91
+ if (error.killed || code === "ETIMEDOUT")
92
+ return "command-timeout";
93
+ }
94
+ return "command-failed";
95
+ }
96
+ export function hasCredentialSource(options) {
97
+ const source = configuredSource(options);
98
+ if (source?.startsWith("!"))
99
+ return true;
100
+ if (source?.startsWith("$"))
101
+ return true;
102
+ return normalize(options.environmentValue) !== null || source !== null;
103
+ }
104
+ export async function resolveCredential(options) {
105
+ const source = configuredSource(options);
106
+ const escaped = source ? escapedSource(source) : null;
107
+ if (escaped !== null)
108
+ return escaped;
109
+ if (source?.startsWith("!")) {
110
+ const command = source.slice(1).trim();
111
+ if (!command)
112
+ throw new CredentialResolutionError(options.provider, "invalid-source");
113
+ let result;
114
+ try {
115
+ result = await (options.runCommand ?? defaultRunCommand)(command, {
116
+ signal: options.signal,
117
+ timeoutMs: COMMAND_TIMEOUT_MS,
118
+ maxOutputBytes: MAX_CREDENTIAL_BYTES,
119
+ environment: commandEnvironment(options.environment ?? process.env),
120
+ });
121
+ }
122
+ catch (error) {
123
+ throw new CredentialResolutionError(options.provider, commandFailureCategory(error, options.signal));
124
+ }
125
+ const stdout = Buffer.isBuffer(result.stdout) ? result.stdout.toString("utf8") : result.stdout;
126
+ if (Buffer.byteLength(stdout, "utf8") > MAX_CREDENTIAL_BYTES) {
127
+ throw new CredentialResolutionError(options.provider, "command-output-too-large");
128
+ }
129
+ const value = stdout.trim();
130
+ if (!value)
131
+ throw new CredentialResolutionError(options.provider, "command-empty");
132
+ if (/[\0-\x1f\x7f]/.test(value)) {
133
+ throw new CredentialResolutionError(options.provider, "command-invalid-output");
134
+ }
135
+ return value;
136
+ }
137
+ if (source && isMalformedExplicitSource(source)) {
138
+ throw new CredentialResolutionError(options.provider, "invalid-source");
139
+ }
140
+ if (source?.startsWith("$")) {
141
+ const name = explicitEnvironmentName(source);
142
+ if (!name)
143
+ throw new CredentialResolutionError(options.provider, "invalid-source");
144
+ const value = normalize((options.environment ?? process.env)[name]);
145
+ if (!value)
146
+ throw new CredentialResolutionError(options.provider, "environment-empty");
147
+ return value;
148
+ }
149
+ return normalize(options.environmentValue) ?? source;
150
+ }
151
+ //# sourceMappingURL=credential-source.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"credential-source.js","sourceRoot":"","sources":["../../../../src/humain/web-access/vendor/credential-source.ts"],"names":[],"mappings":"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","sourcesContent":["import { exec } from \"node:child_process\";\nimport { promisify } from \"node:util\";\n\nconst execAsync = promisify(exec);\nconst COMMAND_TIMEOUT_MS = 5_000;\nconst MAX_CREDENTIAL_BYTES = 16_384;\nconst ENV_SOURCE = /^\\$(?:([A-Za-z_][A-Za-z0-9_]*)|\\{([A-Za-z_][A-Za-z0-9_]*)\\})$/;\nconst OP_SESSION_NAME = /^OP_SESSION_[A-Za-z0-9_]+$/;\nconst COMMAND_ENVIRONMENT_NAMES = [\n\t\"HOME\",\n\t\"USER\",\n\t\"LOGNAME\",\n\t\"PATH\",\n\t\"LANG\",\n\t\"LC_ALL\",\n\t\"LC_CTYPE\",\n\t\"TERM\",\n\t\"TMPDIR\",\n\t\"XDG_CONFIG_HOME\",\n\t\"XDG_RUNTIME_DIR\",\n\t\"DBUS_SESSION_BUS_ADDRESS\",\n\t\"SSH_AUTH_SOCK\",\n\t\"WSL_DISTRO_NAME\",\n\t\"WSL_INTEROP\",\n] as const;\n\nexport type CredentialFailureCategory =\n\t| \"invalid-source\"\n\t| \"command-failed\"\n\t| \"command-timeout\"\n\t| \"command-aborted\"\n\t| \"command-empty\"\n\t| \"command-invalid-output\"\n\t| \"command-output-too-large\"\n\t| \"environment-empty\";\n\nexport class CredentialResolutionError extends Error {\n\treadonly provider: string;\n\treadonly category: CredentialFailureCategory;\n\n\tconstructor(provider: string, category: CredentialFailureCategory) {\n\t\tconst suffix = category === \"command-aborted\" ? \"aborted\" : category;\n\t\tsuper(`${provider} credential resolution failed: ${suffix}`);\n\t\tthis.name = \"CredentialResolutionError\";\n\t\tthis.provider = provider;\n\t\tthis.category = category;\n\t}\n}\n\nexport interface CredentialCommandResult {\n\tstdout: string | Buffer;\n}\n\nexport interface CredentialCommandOptions {\n\tsignal?: AbortSignal;\n\ttimeoutMs: number;\n\tmaxOutputBytes: number;\n\tenvironment: Record<string, string>;\n}\n\nexport type CredentialCommandRunner = (\n\tcommand: string,\n\toptions: CredentialCommandOptions,\n) => Promise<CredentialCommandResult>;\n\nexport interface CredentialOptions {\n\tprovider: string;\n\tconfiguredValue?: unknown;\n\tenvironmentValue?: unknown;\n\tenvironment?: Record<string, string | undefined>;\n\tsignal?: AbortSignal;\n\trunCommand?: CredentialCommandRunner;\n}\n\nexport function redactCredential(text: string, credential: string | null | undefined): string {\n\treturn credential ? text.split(credential).join(\"[redacted]\") : text;\n}\n\nfunction normalize(value: unknown): string | null {\n\tif (typeof value !== \"string\") return null;\n\tconst normalized = value.trim();\n\treturn normalized.length > 0 ? normalized : null;\n}\n\nfunction commandEnvironment(source: Record<string, string | undefined>): Record<string, string> {\n\tconst environment: Record<string, string> = {};\n\tfor (const name of COMMAND_ENVIRONMENT_NAMES) {\n\t\tconst value = source[name];\n\t\tif (value !== undefined) environment[name] = value;\n\t}\n\tfor (const [name, value] of Object.entries(source)) {\n\t\tif (value !== undefined && OP_SESSION_NAME.test(name)) environment[name] = value;\n\t}\n\treturn environment;\n}\n\nfunction configuredSource(options: CredentialOptions): string | null {\n\treturn normalize(options.configuredValue);\n}\n\nfunction explicitEnvironmentName(source: string): string | null {\n\tconst match = source.match(ENV_SOURCE);\n\treturn match ? match[1] ?? match[2] : null;\n}\n\nfunction escapedSource(source: string): string | null {\n\tif (source.startsWith(\"$$\") || source.startsWith(\"$!\")) return source.slice(1);\n\treturn null;\n}\n\nfunction isMalformedExplicitSource(source: string): boolean {\n\treturn source.startsWith(\"$\") && escapedSource(source) === null && explicitEnvironmentName(source) === null;\n}\n\nasync function defaultRunCommand(\n\tcommand: string,\n\toptions: CredentialCommandOptions,\n): Promise<CredentialCommandResult> {\n\tconst result = await execAsync(command, {\n\t\tencoding: \"utf8\",\n\t\tenv: options.environment,\n\t\tmaxBuffer: options.maxOutputBytes + 1,\n\t\tsignal: options.signal,\n\t\ttimeout: options.timeoutMs,\n\t\twindowsHide: true,\n\t});\n\treturn { stdout: result.stdout };\n}\n\nfunction commandFailureCategory(error: unknown, signal?: AbortSignal): CredentialFailureCategory {\n\tif (signal?.aborted) return \"command-aborted\";\n\tif (error && typeof error === \"object\") {\n\t\tconst code = (error as { code?: string }).code;\n\t\tif (code === \"ERR_CHILD_PROCESS_STDIO_MAXBUFFER\") return \"command-output-too-large\";\n\t\tif ((error as { killed?: boolean }).killed || code === \"ETIMEDOUT\") return \"command-timeout\";\n\t}\n\treturn \"command-failed\";\n}\n\nexport function hasCredentialSource(options: CredentialOptions): boolean {\n\tconst source = configuredSource(options);\n\tif (source?.startsWith(\"!\")) return true;\n\tif (source?.startsWith(\"$\")) return true;\n\treturn normalize(options.environmentValue) !== null || source !== null;\n}\n\nexport async function resolveCredential(options: CredentialOptions): Promise<string | null> {\n\tconst source = configuredSource(options);\n\tconst escaped = source ? escapedSource(source) : null;\n\tif (escaped !== null) return escaped;\n\tif (source?.startsWith(\"!\")) {\n\t\tconst command = source.slice(1).trim();\n\t\tif (!command) throw new CredentialResolutionError(options.provider, \"invalid-source\");\n\t\tlet result: CredentialCommandResult;\n\t\ttry {\n\t\t\tresult = await (options.runCommand ?? defaultRunCommand)(command, {\n\t\t\t\tsignal: options.signal,\n\t\t\t\ttimeoutMs: COMMAND_TIMEOUT_MS,\n\t\t\t\tmaxOutputBytes: MAX_CREDENTIAL_BYTES,\n\t\t\t\tenvironment: commandEnvironment(options.environment ?? process.env),\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tthrow new CredentialResolutionError(options.provider, commandFailureCategory(error, options.signal));\n\t\t}\n\t\tconst stdout = Buffer.isBuffer(result.stdout) ? result.stdout.toString(\"utf8\") : result.stdout;\n\t\tif (Buffer.byteLength(stdout, \"utf8\") > MAX_CREDENTIAL_BYTES) {\n\t\t\tthrow new CredentialResolutionError(options.provider, \"command-output-too-large\");\n\t\t}\n\t\tconst value = stdout.trim();\n\t\tif (!value) throw new CredentialResolutionError(options.provider, \"command-empty\");\n\t\tif (/[\\0-\\x1f\\x7f]/.test(value)) {\n\t\t\tthrow new CredentialResolutionError(options.provider, \"command-invalid-output\");\n\t\t}\n\t\treturn value;\n\t}\n\tif (source && isMalformedExplicitSource(source)) {\n\t\tthrow new CredentialResolutionError(options.provider, \"invalid-source\");\n\t}\n\tif (source?.startsWith(\"$\")) {\n\t\tconst name = explicitEnvironmentName(source);\n\t\tif (!name) throw new CredentialResolutionError(options.provider, \"invalid-source\");\n\t\tconst value = normalize((options.environment ?? process.env)[name]);\n\t\tif (!value) throw new CredentialResolutionError(options.provider, \"environment-empty\");\n\t\treturn value;\n\t}\n\treturn normalize(options.environmentValue) ?? source;\n}\n"]}
@@ -0,0 +1,29 @@
1
+ export declare function generateCuratorPage(queries: string[], sessionToken: string, timeout: number, availableProviders: {
2
+ all: boolean;
3
+ openai: boolean;
4
+ brave: boolean;
5
+ parallel: boolean;
6
+ tinyfish: boolean;
7
+ search1api: boolean;
8
+ searchinfinity: boolean;
9
+ querit: boolean;
10
+ tavily: boolean;
11
+ jina: boolean;
12
+ serpdive: boolean;
13
+ kagi: boolean;
14
+ bocha: boolean;
15
+ ollama: boolean;
16
+ searxng: boolean;
17
+ duckduckgo: boolean;
18
+ perplexity: boolean;
19
+ exa: boolean;
20
+ gemini: boolean;
21
+ anysearch: boolean;
22
+ xai: boolean;
23
+ brightdata: boolean;
24
+ serpbase: boolean;
25
+ }, defaultProvider: string, searchProvider: string, summaryModels: Array<{
26
+ value: string;
27
+ label: string;
28
+ }>, defaultSummaryModel: string | null): string;
29
+ //# sourceMappingURL=curator-page.d.ts.map