@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,85 @@
1
+ import { createConnection, type Socket } from "node:net";
2
+ import { ReadBuffer, serializeMessage } from "@modelcontextprotocol/client";
3
+ import type { Transport } from "@modelcontextprotocol/client";
4
+ import type { JSONRPCMessage } from "@modelcontextprotocol/client";
5
+
6
+ /** MCP JSONL transport for an explicitly configured Unix-domain socket. */
7
+ export class UnixSocketClientTransport implements Transport {
8
+ private socket: Socket | undefined;
9
+ private readonly readBuffer = new ReadBuffer();
10
+
11
+ onclose?: () => void;
12
+ onerror?: (error: Error) => void;
13
+ onmessage?: (message: JSONRPCMessage) => void;
14
+
15
+ constructor(private readonly socketPath: string) {}
16
+
17
+ async start(): Promise<void> {
18
+ if (this.socket) {
19
+ throw new Error("UnixSocketClientTransport already started");
20
+ }
21
+
22
+ await new Promise<void>((resolve, reject) => {
23
+ const socket = createConnection(this.socketPath);
24
+ this.socket = socket;
25
+ let connected = false;
26
+
27
+ socket.once("connect", () => {
28
+ connected = true;
29
+ resolve();
30
+ });
31
+ socket.on("data", chunk => {
32
+ try {
33
+ this.readBuffer.append(chunk);
34
+ while (true) {
35
+ const message = this.readBuffer.readMessage();
36
+ if (message === null) break;
37
+ this.onmessage?.(message);
38
+ }
39
+ } catch (error) {
40
+ const cause = error instanceof Error ? error : new Error(String(error));
41
+ this.onerror?.(cause);
42
+ void this.close();
43
+ }
44
+ });
45
+ socket.on("error", error => {
46
+ if (!connected) reject(error);
47
+ this.onerror?.(error);
48
+ });
49
+ socket.on("close", () => {
50
+ if (this.socket === socket) this.socket = undefined;
51
+ this.readBuffer.clear();
52
+ this.onclose?.();
53
+ });
54
+ });
55
+ }
56
+
57
+ async close(): Promise<void> {
58
+ const socket = this.socket;
59
+ this.socket = undefined;
60
+ this.readBuffer.clear();
61
+ if (!socket || socket.destroyed) return;
62
+
63
+ await new Promise<void>(resolve => {
64
+ const timeout = setTimeout(() => socket.destroy(), 2_000);
65
+ timeout.unref();
66
+ socket.once("close", () => {
67
+ clearTimeout(timeout);
68
+ resolve();
69
+ });
70
+ socket.end();
71
+ });
72
+ }
73
+
74
+ async send(message: JSONRPCMessage): Promise<void> {
75
+ const socket = this.socket;
76
+ if (!socket || socket.destroyed) throw new Error("Unix socket is not connected");
77
+
78
+ await new Promise<void>((resolve, reject) => {
79
+ socket.write(serializeMessage(message), error => {
80
+ if (error) reject(error);
81
+ else resolve();
82
+ });
83
+ });
84
+ }
85
+ }
@@ -0,0 +1,310 @@
1
+ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
2
+ import { spawnSync } from "node:child_process";
3
+ import { homedir, platform } from "node:os";
4
+ import { extname, isAbsolute, join } from "node:path";
5
+ import type { McpConfig, ServerEntry } from "./types.ts";
6
+
7
+ async function execOpen(pi: ExtensionAPI, target: string, browser?: string, signal?: AbortSignal) {
8
+ const os = platform();
9
+
10
+ if (os === "darwin") {
11
+ if (browser) {
12
+ // An absolute executable path (e.g. from $BROWSER) names a launcher
13
+ // binary. App bundles still go through `open -a`, which handles them.
14
+ return isAbsolute(browser) && extname(browser).toLowerCase() !== ".app"
15
+ ? pi.exec(browser, [target], signal ? { signal } : {})
16
+ : pi.exec("open", ["-a", browser, target], signal ? { signal } : {});
17
+ }
18
+ return pi.exec("open", [target], signal ? { signal } : {});
19
+ }
20
+ if (os === "win32") {
21
+ return browser
22
+ ? pi.exec("cmd", ["/c", "start", "", browser, target], signal ? { signal } : {})
23
+ : pi.exec("cmd", ["/c", "start", "", target], signal ? { signal } : {});
24
+ }
25
+ return browser
26
+ ? pi.exec(browser, [target], signal ? { signal } : {})
27
+ : pi.exec("xdg-open", [target], signal ? { signal } : {});
28
+ }
29
+
30
+ export async function openUrl(pi: ExtensionAPI, url: string, browser?: string, signal?: AbortSignal): Promise<void> {
31
+ const result = await execOpen(pi, url, browser, signal);
32
+ if (result.code !== 0) {
33
+ throw new Error(result.stderr || `Failed to open browser (exit code ${result.code})`);
34
+ }
35
+ }
36
+
37
+ export async function openPath(pi: ExtensionAPI, targetPath: string): Promise<void> {
38
+ const result = await execOpen(pi, targetPath);
39
+ if (result.code !== 0) {
40
+ throw new Error(result.stderr || `Failed to open path (exit code ${result.code})`);
41
+ }
42
+ }
43
+
44
+ export async function parallelLimit<T, R>(
45
+ items: T[],
46
+ limit: number,
47
+ fn: (item: T) => Promise<R>
48
+ ): Promise<R[]> {
49
+ const results: R[] = [];
50
+ const iterator = items.entries();
51
+
52
+ async function worker() {
53
+ while (true) {
54
+ const next = iterator.next();
55
+ if (next.done) return;
56
+ const [index, item] = next.value;
57
+ results[index] = await fn(item);
58
+ }
59
+ }
60
+
61
+ const workers = Array(Math.min(limit, items.length)).fill(null).map(() => worker());
62
+ await Promise.all(workers);
63
+ return results;
64
+ }
65
+
66
+ export function getConfigPathFromArgv(): string | undefined {
67
+ const idx = process.argv.indexOf("--mcp-config");
68
+ if (idx >= 0 && idx + 1 < process.argv.length) {
69
+ return process.argv[idx + 1];
70
+ }
71
+ return undefined;
72
+ }
73
+
74
+ export function interpolateEnvVars(value: string): string {
75
+ return value
76
+ .replace(/\$\{(\w+)\}/g, (_, name) => process.env[name] ?? "")
77
+ .replace(/\$env:(\w+)/g, (_, name) => process.env[name] ?? "")
78
+ .replace(/\{env:(\w+)\}/g, (_, name) => process.env[name] ?? "");
79
+ }
80
+
81
+ function getMissingEnvVars(value: string): string[] {
82
+ const missing = new Set<string>();
83
+ for (const match of value.matchAll(/\$\{(\w+)\}|\$env:(\w+)|\{env:(\w+)\}/g)) {
84
+ const name = match[1] ?? match[2] ?? match[3];
85
+ if (name && process.env[name] === undefined) {
86
+ missing.add(name);
87
+ }
88
+ }
89
+ return [...missing];
90
+ }
91
+
92
+ export function toStringRecord(value: unknown): Record<string, string> | undefined {
93
+ if (!value || typeof value !== "object" || Array.isArray(value)) return undefined;
94
+
95
+ const result: Record<string, string> = {};
96
+ for (const [key, entry] of Object.entries(value)) {
97
+ if (typeof entry === "string") result[key] = entry;
98
+ }
99
+ return Object.keys(result).length > 0 ? result : undefined;
100
+ }
101
+
102
+ function interpolateSecretExpression(value: string): string {
103
+ if (value.startsWith("!!")) return interpolateEnvVars(value.slice(1));
104
+ return value.startsWith("!") ? value : interpolateEnvVars(value);
105
+ }
106
+
107
+ export function interpolateEnvRecord(values: Record<string, string> | undefined): Record<string, string> | undefined {
108
+ if (!values) return undefined;
109
+
110
+ return Object.fromEntries(Object.entries(values).map(([key, value]) => [
111
+ key,
112
+ interpolateSecretExpression(value),
113
+ ]));
114
+ }
115
+
116
+ const COMMAND_SECRET_TIMEOUT_MS = 10_000;
117
+ const COMMAND_SECRET_MAX_OUTPUT_BYTES = 1024 * 1024;
118
+
119
+ /** Resolve a secret value, executing only a single leading `!` command marker. */
120
+ export function resolveCommandSecret(value: string, context: string): string;
121
+ export function resolveCommandSecret(value: undefined, context: string): undefined;
122
+ export function resolveCommandSecret(value: string | undefined, context: string): string | undefined;
123
+ export function resolveCommandSecret(value: string | undefined, context: string): string | undefined {
124
+ if (value === undefined) return undefined;
125
+ if (value.startsWith("!!")) return interpolateEnvVars(value.slice(1));
126
+ if (!value.startsWith("!")) return interpolateEnvVars(value);
127
+
128
+ const result = spawnSync(value.slice(1), {
129
+ shell: true,
130
+ encoding: "utf8",
131
+ timeout: COMMAND_SECRET_TIMEOUT_MS,
132
+ maxBuffer: COMMAND_SECRET_MAX_OUTPUT_BYTES,
133
+ stdio: ["ignore", "pipe", "ignore"],
134
+ windowsHide: true,
135
+ });
136
+ if (result.error) {
137
+ const code = (result.error as NodeJS.ErrnoException).code;
138
+ const reason = code === "ETIMEDOUT"
139
+ ? "command timed out after 10 seconds"
140
+ : code === "ENOBUFS"
141
+ ? "command output exceeded 1 MiB"
142
+ : "command failed to start";
143
+ throw new Error(`Failed to resolve ${context}: ${reason}`);
144
+ }
145
+ if (result.status !== 0) {
146
+ throw new Error(`Failed to resolve ${context}: command exited with code ${result.status ?? "unknown"}`);
147
+ }
148
+
149
+ const resolved = result.stdout.trim();
150
+ if (!resolved) throw new Error(`Failed to resolve ${context}: command returned empty output`);
151
+ return resolved;
152
+ }
153
+
154
+ /** Resolve command markers in a configured record without mutating the input. */
155
+ export function resolveCommandSecretsRecord(
156
+ values: Record<string, string> | undefined,
157
+ context: (key: string) => string,
158
+ ): Record<string, string> | undefined {
159
+ if (!values) return undefined;
160
+
161
+ return Object.fromEntries(Object.entries(values).map(([key, value]) => [
162
+ key,
163
+ resolveCommandSecret(value, context(key)),
164
+ ]));
165
+ }
166
+
167
+ export function resolveServerUrl(definition: Pick<ServerEntry, "url">): string | undefined {
168
+ if (definition.url == null) return undefined;
169
+ if (typeof definition.url !== "string") {
170
+ throw new Error("MCP server URL must be a string");
171
+ }
172
+
173
+ const missing = getMissingEnvVars(definition.url);
174
+ if (missing.length > 0) {
175
+ throw new Error(`Missing environment variable${missing.length === 1 ? "" : "s"} in MCP server URL: ${missing.join(", ")}`);
176
+ }
177
+
178
+ const resolved = interpolateEnvVars(definition.url);
179
+ try {
180
+ new URL(resolved);
181
+ } catch (error) {
182
+ throw new Error(`Invalid MCP server URL after environment interpolation: ${resolved}`, { cause: error });
183
+ }
184
+ return resolved;
185
+ }
186
+
187
+ export function resolveConfigPath(value: string | undefined): string | undefined {
188
+ if (value === undefined) return undefined;
189
+
190
+ const resolved = interpolateEnvVars(value);
191
+ if (resolved === "~") return homedir();
192
+ if (resolved.startsWith("~/") || resolved.startsWith("~\\")) {
193
+ return join(homedir(), resolved.slice(2));
194
+ }
195
+ return resolved;
196
+ }
197
+
198
+ export function resolveBearerToken(definition: Pick<ServerEntry, "bearerToken" | "bearerTokenEnv">): string | undefined {
199
+ if (definition.bearerToken !== undefined) {
200
+ return interpolateSecretExpression(definition.bearerToken);
201
+ }
202
+ return definition.bearerTokenEnv ? process.env[definition.bearerTokenEnv] : undefined;
203
+ }
204
+
205
+ /** Remove OSC control strings, including payloads that have no terminator. */
206
+ export function stripOscSequences(text: string): string {
207
+ let result = "";
208
+ let index = 0;
209
+ while (index < text.length) {
210
+ const isEscOsc = text.charCodeAt(index) === 0x1b && text[index + 1] === "]";
211
+ const isC1Osc = text.charCodeAt(index) === 0x9d;
212
+ if (!isEscOsc && !isC1Osc) {
213
+ result += text[index++];
214
+ continue;
215
+ }
216
+
217
+ index += isEscOsc ? 2 : 1;
218
+ while (index < text.length) {
219
+ const code = text.charCodeAt(index++);
220
+ if (code === 0x07 || code === 0x9c) break;
221
+ if (code === 0x1b && text[index] === "\\") {
222
+ index++;
223
+ break;
224
+ }
225
+ }
226
+ }
227
+ return result;
228
+ }
229
+
230
+ export function sanitizeTerminalText(text: string): string {
231
+ return stripOscSequences(text)
232
+ .replace(/(?:\x1b\[[0-?]*[ -/]*[@-~]|\x1b[@-Z\\-_])/g, "")
233
+ .replace(/[\u0000-\u001f\u007f-\u009f]+/g, " ")
234
+ .replace(/\s+/g, " ")
235
+ .trim();
236
+ }
237
+
238
+ export function formatTerminalError(error: unknown): string {
239
+ const messages: string[] = [];
240
+ const seen = new Set<unknown>();
241
+ const collect = (value: unknown) => {
242
+ if (seen.has(value)) return;
243
+ if ((typeof value === "object" && value !== null) || typeof value === "function") seen.add(value);
244
+
245
+ if (value instanceof AggregateError) {
246
+ const countBefore = messages.length;
247
+ for (const nested of value.errors) collect(nested);
248
+ if (value.cause !== undefined) collect(value.cause);
249
+ if (messages.length === countBefore && value.message) messages.push(value.message);
250
+ return;
251
+ }
252
+ if (value instanceof Error) {
253
+ if (value.message) messages.push(value.message);
254
+ if (value.cause !== undefined) collect(value.cause);
255
+ return;
256
+ }
257
+ messages.push(String(value));
258
+ };
259
+
260
+ collect(error);
261
+ return sanitizeTerminalText([...new Set(messages)].join(": "));
262
+ }
263
+
264
+ export function truncateAtWord(text: string, target: number): string {
265
+ if (!text || text.length <= target) return text;
266
+
267
+ const truncated = text.slice(0, target);
268
+ const lastSpace = truncated.lastIndexOf(" ");
269
+
270
+ if (lastSpace > target * 0.6) {
271
+ return truncated.slice(0, lastSpace) + "...";
272
+ }
273
+
274
+ return truncated + "...";
275
+ }
276
+
277
+ export function normalizeDirectToolInputSchema(schema: unknown): Record<string, unknown> {
278
+ const inputSchema = schema && typeof schema === "object" && !Array.isArray(schema)
279
+ ? schema as Record<string, unknown>
280
+ : { type: "object", properties: {} };
281
+ const { $schema, additionalProperties, ...normalized } = inputSchema;
282
+ return normalized;
283
+ }
284
+
285
+ export function formatAuthRequiredMessage(
286
+ config: Pick<McpConfig, "settings">,
287
+ serverName: string,
288
+ defaultMessage: string,
289
+ ): string {
290
+ const template = config.settings?.authRequiredMessage;
291
+ return template ? template.replaceAll("${server}", serverName) : defaultMessage;
292
+ }
293
+
294
+ export function formatMcpStatus(config: Pick<McpConfig, "settings">, message: string): string | undefined {
295
+ if (config.settings?.mcpFooterStatus === "off") return undefined;
296
+ return `${config.settings?.showStatusIcon === false ? "MCP: " : "🔌 MCP: "}${message}`;
297
+ }
298
+
299
+ /**
300
+ * Extract the adapter-owned UI stream mode from tool metadata.
301
+ */
302
+ export function extractToolUiStreamMode(toolMeta: Record<string, unknown> | undefined): "eager" | "stream-first" | undefined {
303
+ const uiMeta = toolMeta?.ui;
304
+ if (!uiMeta || typeof uiMeta !== "object") return undefined;
305
+ const streamMode = (uiMeta as Record<string, unknown>)["pi-mcp-adapter.streamMode"];
306
+ if (streamMode === "eager" || streamMode === "stream-first") {
307
+ return streamMode;
308
+ }
309
+ return undefined;
310
+ }
@@ -0,0 +1,3 @@
1
+ import type { ExtensionFactory } from "../core/extensions/types.ts";
2
+ export declare function createHumainMcpAdapterExtensionFactory(): ExtensionFactory;
3
+ //# sourceMappingURL=mcp-adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-adapter.d.ts","sourceRoot":"","sources":["../../src/humain/mcp-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,wBAAgB,sCAAsC,IAAI,gBAAgB,CAEzE","sourcesContent":["import type { ExtensionFactory } from \"../core/extensions/types.ts\";\nimport mcpAdapter from \"./mcp-adapter/vendor/index.bundle.mjs\";\n\nexport function createHumainMcpAdapterExtensionFactory(): ExtensionFactory {\n\treturn mcpAdapter;\n}\n"]}
@@ -0,0 +1,5 @@
1
+ import mcpAdapter from "./mcp-adapter/vendor/index.bundle.mjs";
2
+ export function createHumainMcpAdapterExtensionFactory() {
3
+ return mcpAdapter;
4
+ }
5
+ //# sourceMappingURL=mcp-adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp-adapter.js","sourceRoot":"","sources":["../../src/humain/mcp-adapter.ts"],"names":[],"mappings":"AACA,OAAO,UAAU,MAAM,uCAAuC,CAAC;AAE/D,MAAM,UAAU,sCAAsC,GAAqB;IAC1E,OAAO,UAAU,CAAC;AAAA,CAClB","sourcesContent":["import type { ExtensionFactory } from \"../core/extensions/types.ts\";\nimport mcpAdapter from \"./mcp-adapter/vendor/index.bundle.mjs\";\n\nexport function createHumainMcpAdapterExtensionFactory(): ExtensionFactory {\n\treturn mcpAdapter;\n}\n"]}
@@ -0,0 +1,34 @@
1
+ import type { CreateAgentSessionOptions } from "../core/sdk.ts";
2
+ import type { HumainAgentRouteRef } from "./agent-execution-protocol.ts";
3
+ import type { HumainAgentExecutionHost } from "./agent-execution-runtime.ts";
4
+ type PiRoute = Pick<CreateAgentSessionOptions, "model" | "thinkingLevel">;
5
+ interface PiAgentSessionPort {
6
+ abort(): Promise<void>;
7
+ dispose(): void;
8
+ getLastAssistantText(): string | undefined;
9
+ readonly isIdle: boolean;
10
+ readonly messages: ReadonlyArray<{
11
+ role: string;
12
+ stopReason?: string;
13
+ }>;
14
+ prompt(text: string, options: {
15
+ expandPromptTemplates: false;
16
+ source: "rpc";
17
+ }): Promise<void>;
18
+ waitForIdle(): Promise<void>;
19
+ }
20
+ type SessionFactory = (options: CreateAgentSessionOptions) => Promise<{
21
+ session: PiAgentSessionPort;
22
+ }>;
23
+ export interface CreatePiAgentExecutionHostOptions {
24
+ cwd: string;
25
+ agentDir?: string;
26
+ baseSessionOptions?: Omit<CreateAgentSessionOptions, "agentDir" | "cwd" | "model" | "sessionManager" | "thinkingLevel">;
27
+ resolveRoute(routeRef: HumainAgentRouteRef): PiRoute | undefined;
28
+ createSession?: SessionFactory;
29
+ }
30
+ export type CreateAdmittedPiAgentExecutionHostOptions = Omit<CreatePiAgentExecutionHostOptions, "resolveRoute"> & PiRoute;
31
+ export declare function createAdmittedPiAgentExecutionHost(options: CreateAdmittedPiAgentExecutionHostOptions): HumainAgentExecutionHost;
32
+ export declare function createPiAgentExecutionHost(options: CreatePiAgentExecutionHostOptions): HumainAgentExecutionHost;
33
+ export {};
34
+ //# sourceMappingURL=pi-agent-execution-host.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-agent-execution-host.d.ts","sourceRoot":"","sources":["../../src/humain/pi-agent-execution-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAGhE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAEX,wBAAwB,EAExB,MAAM,8BAA8B,CAAC;AAItC,KAAK,OAAO,GAAG,IAAI,CAAC,yBAAyB,EAAE,OAAO,GAAG,eAAe,CAAC,CAAC;AAC1E,UAAU,kBAAkB;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,IAAI,IAAI,CAAC;IAChB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,qBAAqB,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9F,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AACD,KAAK,cAAc,GAAG,CAAC,OAAO,EAAE,yBAAyB,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,kBAAkB,CAAA;CAAE,CAAC,CAAC;AAEvG,MAAM,WAAW,iCAAiC;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,IAAI,CACxB,yBAAyB,EACzB,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,gBAAgB,GAAG,eAAe,CACjE,CAAC;IACF,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,aAAa,CAAC,EAAE,cAAc,CAAC;CAC/B;AAED,MAAM,MAAM,yCAAyC,GAAG,IAAI,CAAC,iCAAiC,EAAE,cAAc,CAAC,GAC9G,OAAO,CAAC;AAET,wBAAgB,kCAAkC,CACjD,OAAO,EAAE,yCAAyC,GAChD,wBAAwB,CAM1B;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iCAAiC,GAAG,wBAAwB,CA8D/G","sourcesContent":["import type { CreateAgentSessionOptions } from \"../core/sdk.ts\";\nimport { createAgentSession } from \"../core/sdk.ts\";\nimport { SessionManager } from \"../core/session-manager.ts\";\nimport type { HumainAgentRouteRef } from \"./agent-execution-protocol.ts\";\nimport type {\n\tHumainAgentExecutionHandle,\n\tHumainAgentExecutionHost,\n\tHumainAgentHostCompletion,\n} from \"./agent-execution-runtime.ts\";\n\nconst UNKNOWN_USAGE = { status: \"unknown\" } as const;\n\ntype PiRoute = Pick<CreateAgentSessionOptions, \"model\" | \"thinkingLevel\">;\ninterface PiAgentSessionPort {\n\tabort(): Promise<void>;\n\tdispose(): void;\n\tgetLastAssistantText(): string | undefined;\n\treadonly isIdle: boolean;\n\treadonly messages: ReadonlyArray<{ role: string; stopReason?: string }>;\n\tprompt(text: string, options: { expandPromptTemplates: false; source: \"rpc\" }): Promise<void>;\n\twaitForIdle(): Promise<void>;\n}\ntype SessionFactory = (options: CreateAgentSessionOptions) => Promise<{ session: PiAgentSessionPort }>;\n\nexport interface CreatePiAgentExecutionHostOptions {\n\tcwd: string;\n\tagentDir?: string;\n\tbaseSessionOptions?: Omit<\n\t\tCreateAgentSessionOptions,\n\t\t\"agentDir\" | \"cwd\" | \"model\" | \"sessionManager\" | \"thinkingLevel\"\n\t>;\n\tresolveRoute(routeRef: HumainAgentRouteRef): PiRoute | undefined;\n\tcreateSession?: SessionFactory;\n}\n\nexport type CreateAdmittedPiAgentExecutionHostOptions = Omit<CreatePiAgentExecutionHostOptions, \"resolveRoute\"> &\n\tPiRoute;\n\nexport function createAdmittedPiAgentExecutionHost(\n\toptions: CreateAdmittedPiAgentExecutionHostOptions,\n): HumainAgentExecutionHost {\n\tconst { model, thinkingLevel, ...hostOptions } = options;\n\treturn createPiAgentExecutionHost({\n\t\t...hostOptions,\n\t\tresolveRoute: () => (model ? { model, thinkingLevel } : undefined),\n\t});\n}\n\nexport function createPiAgentExecutionHost(options: CreatePiAgentExecutionHostOptions): HumainAgentExecutionHost {\n\tconst sessionFactory = options.createSession ?? createAgentSession;\n\treturn {\n\t\tasync launch(request) {\n\t\t\tconst route = options.resolveRoute(request.routeRef);\n\t\t\tif (!route?.model) return null;\n\t\t\tconst { session } = await sessionFactory({\n\t\t\t\t...options.baseSessionOptions,\n\t\t\t\tcwd: options.cwd,\n\t\t\t\tagentDir: options.agentDir,\n\t\t\t\tmodel: route.model,\n\t\t\t\tthinkingLevel: route.thinkingLevel,\n\t\t\t\tsessionManager: SessionManager.inMemory(options.cwd),\n\t\t\t});\n\t\t\tlet cancellationRequested = false;\n\t\t\tconst completion = (async (): Promise<HumainAgentHostCompletion> => {\n\t\t\t\ttry {\n\t\t\t\t\tawait session.prompt(request.task, { expandPromptTemplates: false, source: \"rpc\" });\n\t\t\t\t\tconst usage = UNKNOWN_USAGE;\n\t\t\t\t\tconst lastAssistant = session.messages\n\t\t\t\t\t\t.slice()\n\t\t\t\t\t\t.reverse()\n\t\t\t\t\t\t.find((message) => message.role === \"assistant\");\n\t\t\t\t\tconst stopReason = lastAssistant && \"stopReason\" in lastAssistant ? lastAssistant.stopReason : undefined;\n\t\t\t\t\tif (stopReason === \"aborted\" || cancellationRequested) {\n\t\t\t\t\t\treturn { kind: \"cancelled\", terminationConfirmed: session.isIdle, usage };\n\t\t\t\t\t}\n\t\t\t\t\tif (stopReason === \"error\") {\n\t\t\t\t\t\treturn { kind: \"failed\", failureCode: \"adapter_execution_failed\", usage };\n\t\t\t\t\t}\n\t\t\t\t\tconst summary = session.getLastAssistantText()?.trim();\n\t\t\t\t\tif (!summary) return { kind: \"failed\", failureCode: \"invalid_adapter_result\", usage };\n\t\t\t\t\treturn { kind: \"succeeded\", output: { summary, artifacts: [] }, usage };\n\t\t\t\t} catch {\n\t\t\t\t\treturn cancellationRequested\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\tkind: \"cancelled\",\n\t\t\t\t\t\t\t\tterminationConfirmed: session.isIdle,\n\t\t\t\t\t\t\t\tusage: UNKNOWN_USAGE,\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: {\n\t\t\t\t\t\t\t\tkind: \"failed\",\n\t\t\t\t\t\t\t\tfailureCode: \"adapter_execution_failed\",\n\t\t\t\t\t\t\t\tusage: UNKNOWN_USAGE,\n\t\t\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t})();\n\t\t\tconst handle: HumainAgentExecutionHandle = {\n\t\t\t\tcompletion,\n\t\t\t\tasync cancel() {\n\t\t\t\t\tcancellationRequested = true;\n\t\t\t\t\tawait session.abort();\n\t\t\t\t\tawait session.waitForIdle();\n\t\t\t\t\treturn { terminationConfirmed: session.isIdle };\n\t\t\t\t},\n\t\t\t\tdispose() {\n\t\t\t\t\tsession.dispose();\n\t\t\t\t},\n\t\t\t};\n\t\t\treturn handle;\n\t\t},\n\t};\n}\n"]}
@@ -0,0 +1,77 @@
1
+ import { createAgentSession } from "../core/sdk.js";
2
+ import { SessionManager } from "../core/session-manager.js";
3
+ const UNKNOWN_USAGE = { status: "unknown" };
4
+ export function createAdmittedPiAgentExecutionHost(options) {
5
+ const { model, thinkingLevel, ...hostOptions } = options;
6
+ return createPiAgentExecutionHost({
7
+ ...hostOptions,
8
+ resolveRoute: () => (model ? { model, thinkingLevel } : undefined),
9
+ });
10
+ }
11
+ export function createPiAgentExecutionHost(options) {
12
+ const sessionFactory = options.createSession ?? createAgentSession;
13
+ return {
14
+ async launch(request) {
15
+ const route = options.resolveRoute(request.routeRef);
16
+ if (!route?.model)
17
+ return null;
18
+ const { session } = await sessionFactory({
19
+ ...options.baseSessionOptions,
20
+ cwd: options.cwd,
21
+ agentDir: options.agentDir,
22
+ model: route.model,
23
+ thinkingLevel: route.thinkingLevel,
24
+ sessionManager: SessionManager.inMemory(options.cwd),
25
+ });
26
+ let cancellationRequested = false;
27
+ const completion = (async () => {
28
+ try {
29
+ await session.prompt(request.task, { expandPromptTemplates: false, source: "rpc" });
30
+ const usage = UNKNOWN_USAGE;
31
+ const lastAssistant = session.messages
32
+ .slice()
33
+ .reverse()
34
+ .find((message) => message.role === "assistant");
35
+ const stopReason = lastAssistant && "stopReason" in lastAssistant ? lastAssistant.stopReason : undefined;
36
+ if (stopReason === "aborted" || cancellationRequested) {
37
+ return { kind: "cancelled", terminationConfirmed: session.isIdle, usage };
38
+ }
39
+ if (stopReason === "error") {
40
+ return { kind: "failed", failureCode: "adapter_execution_failed", usage };
41
+ }
42
+ const summary = session.getLastAssistantText()?.trim();
43
+ if (!summary)
44
+ return { kind: "failed", failureCode: "invalid_adapter_result", usage };
45
+ return { kind: "succeeded", output: { summary, artifacts: [] }, usage };
46
+ }
47
+ catch {
48
+ return cancellationRequested
49
+ ? {
50
+ kind: "cancelled",
51
+ terminationConfirmed: session.isIdle,
52
+ usage: UNKNOWN_USAGE,
53
+ }
54
+ : {
55
+ kind: "failed",
56
+ failureCode: "adapter_execution_failed",
57
+ usage: UNKNOWN_USAGE,
58
+ };
59
+ }
60
+ })();
61
+ const handle = {
62
+ completion,
63
+ async cancel() {
64
+ cancellationRequested = true;
65
+ await session.abort();
66
+ await session.waitForIdle();
67
+ return { terminationConfirmed: session.isIdle };
68
+ },
69
+ dispose() {
70
+ session.dispose();
71
+ },
72
+ };
73
+ return handle;
74
+ },
75
+ };
76
+ }
77
+ //# sourceMappingURL=pi-agent-execution-host.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pi-agent-execution-host.js","sourceRoot":"","sources":["../../src/humain/pi-agent-execution-host.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAQ5D,MAAM,aAAa,GAAG,EAAE,MAAM,EAAE,SAAS,EAAW,CAAC;AA4BrD,MAAM,UAAU,kCAAkC,CACjD,OAAkD,EACvB;IAC3B,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;IACzD,OAAO,0BAA0B,CAAC;QACjC,GAAG,WAAW;QACd,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;KAClE,CAAC,CAAC;AAAA,CACH;AAED,MAAM,UAAU,0BAA0B,CAAC,OAA0C,EAA4B;IAChH,MAAM,cAAc,GAAG,OAAO,CAAC,aAAa,IAAI,kBAAkB,CAAC;IACnE,OAAO;QACN,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE;YACrB,MAAM,KAAK,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACrD,IAAI,CAAC,KAAK,EAAE,KAAK;gBAAE,OAAO,IAAI,CAAC;YAC/B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,CAAC;gBACxC,GAAG,OAAO,CAAC,kBAAkB;gBAC7B,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,cAAc,EAAE,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC;aACpD,CAAC,CAAC;YACH,IAAI,qBAAqB,GAAG,KAAK,CAAC;YAClC,MAAM,UAAU,GAAG,CAAC,KAAK,IAAwC,EAAE,CAAC;gBACnE,IAAI,CAAC;oBACJ,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;oBACpF,MAAM,KAAK,GAAG,aAAa,CAAC;oBAC5B,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ;yBACpC,KAAK,EAAE;yBACP,OAAO,EAAE;yBACT,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;oBAClD,MAAM,UAAU,GAAG,aAAa,IAAI,YAAY,IAAI,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;oBACzG,IAAI,UAAU,KAAK,SAAS,IAAI,qBAAqB,EAAE,CAAC;wBACvD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;oBAC3E,CAAC;oBACD,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;wBAC5B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE,KAAK,EAAE,CAAC;oBAC3E,CAAC;oBACD,MAAM,OAAO,GAAG,OAAO,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,CAAC;oBACvD,IAAI,CAAC,OAAO;wBAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE,KAAK,EAAE,CAAC;oBACtF,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;gBACzE,CAAC;gBAAC,MAAM,CAAC;oBACR,OAAO,qBAAqB;wBAC3B,CAAC,CAAC;4BACA,IAAI,EAAE,WAAW;4BACjB,oBAAoB,EAAE,OAAO,CAAC,MAAM;4BACpC,KAAK,EAAE,aAAa;yBACpB;wBACF,CAAC,CAAC;4BACA,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,0BAA0B;4BACvC,KAAK,EAAE,aAAa;yBACpB,CAAC;gBACL,CAAC;YAAA,CACD,CAAC,EAAE,CAAC;YACL,MAAM,MAAM,GAA+B;gBAC1C,UAAU;gBACV,KAAK,CAAC,MAAM,GAAG;oBACd,qBAAqB,GAAG,IAAI,CAAC;oBAC7B,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;oBACtB,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;oBAC5B,OAAO,EAAE,oBAAoB,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;gBAAA,CAChD;gBACD,OAAO,GAAG;oBACT,OAAO,CAAC,OAAO,EAAE,CAAC;gBAAA,CAClB;aACD,CAAC;YACF,OAAO,MAAM,CAAC;QAAA,CACd;KACD,CAAC;AAAA,CACF","sourcesContent":["import type { CreateAgentSessionOptions } from \"../core/sdk.ts\";\nimport { createAgentSession } from \"../core/sdk.ts\";\nimport { SessionManager } from \"../core/session-manager.ts\";\nimport type { HumainAgentRouteRef } from \"./agent-execution-protocol.ts\";\nimport type {\n\tHumainAgentExecutionHandle,\n\tHumainAgentExecutionHost,\n\tHumainAgentHostCompletion,\n} from \"./agent-execution-runtime.ts\";\n\nconst UNKNOWN_USAGE = { status: \"unknown\" } as const;\n\ntype PiRoute = Pick<CreateAgentSessionOptions, \"model\" | \"thinkingLevel\">;\ninterface PiAgentSessionPort {\n\tabort(): Promise<void>;\n\tdispose(): void;\n\tgetLastAssistantText(): string | undefined;\n\treadonly isIdle: boolean;\n\treadonly messages: ReadonlyArray<{ role: string; stopReason?: string }>;\n\tprompt(text: string, options: { expandPromptTemplates: false; source: \"rpc\" }): Promise<void>;\n\twaitForIdle(): Promise<void>;\n}\ntype SessionFactory = (options: CreateAgentSessionOptions) => Promise<{ session: PiAgentSessionPort }>;\n\nexport interface CreatePiAgentExecutionHostOptions {\n\tcwd: string;\n\tagentDir?: string;\n\tbaseSessionOptions?: Omit<\n\t\tCreateAgentSessionOptions,\n\t\t\"agentDir\" | \"cwd\" | \"model\" | \"sessionManager\" | \"thinkingLevel\"\n\t>;\n\tresolveRoute(routeRef: HumainAgentRouteRef): PiRoute | undefined;\n\tcreateSession?: SessionFactory;\n}\n\nexport type CreateAdmittedPiAgentExecutionHostOptions = Omit<CreatePiAgentExecutionHostOptions, \"resolveRoute\"> &\n\tPiRoute;\n\nexport function createAdmittedPiAgentExecutionHost(\n\toptions: CreateAdmittedPiAgentExecutionHostOptions,\n): HumainAgentExecutionHost {\n\tconst { model, thinkingLevel, ...hostOptions } = options;\n\treturn createPiAgentExecutionHost({\n\t\t...hostOptions,\n\t\tresolveRoute: () => (model ? { model, thinkingLevel } : undefined),\n\t});\n}\n\nexport function createPiAgentExecutionHost(options: CreatePiAgentExecutionHostOptions): HumainAgentExecutionHost {\n\tconst sessionFactory = options.createSession ?? createAgentSession;\n\treturn {\n\t\tasync launch(request) {\n\t\t\tconst route = options.resolveRoute(request.routeRef);\n\t\t\tif (!route?.model) return null;\n\t\t\tconst { session } = await sessionFactory({\n\t\t\t\t...options.baseSessionOptions,\n\t\t\t\tcwd: options.cwd,\n\t\t\t\tagentDir: options.agentDir,\n\t\t\t\tmodel: route.model,\n\t\t\t\tthinkingLevel: route.thinkingLevel,\n\t\t\t\tsessionManager: SessionManager.inMemory(options.cwd),\n\t\t\t});\n\t\t\tlet cancellationRequested = false;\n\t\t\tconst completion = (async (): Promise<HumainAgentHostCompletion> => {\n\t\t\t\ttry {\n\t\t\t\t\tawait session.prompt(request.task, { expandPromptTemplates: false, source: \"rpc\" });\n\t\t\t\t\tconst usage = UNKNOWN_USAGE;\n\t\t\t\t\tconst lastAssistant = session.messages\n\t\t\t\t\t\t.slice()\n\t\t\t\t\t\t.reverse()\n\t\t\t\t\t\t.find((message) => message.role === \"assistant\");\n\t\t\t\t\tconst stopReason = lastAssistant && \"stopReason\" in lastAssistant ? lastAssistant.stopReason : undefined;\n\t\t\t\t\tif (stopReason === \"aborted\" || cancellationRequested) {\n\t\t\t\t\t\treturn { kind: \"cancelled\", terminationConfirmed: session.isIdle, usage };\n\t\t\t\t\t}\n\t\t\t\t\tif (stopReason === \"error\") {\n\t\t\t\t\t\treturn { kind: \"failed\", failureCode: \"adapter_execution_failed\", usage };\n\t\t\t\t\t}\n\t\t\t\t\tconst summary = session.getLastAssistantText()?.trim();\n\t\t\t\t\tif (!summary) return { kind: \"failed\", failureCode: \"invalid_adapter_result\", usage };\n\t\t\t\t\treturn { kind: \"succeeded\", output: { summary, artifacts: [] }, usage };\n\t\t\t\t} catch {\n\t\t\t\t\treturn cancellationRequested\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\tkind: \"cancelled\",\n\t\t\t\t\t\t\t\tterminationConfirmed: session.isIdle,\n\t\t\t\t\t\t\t\tusage: UNKNOWN_USAGE,\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: {\n\t\t\t\t\t\t\t\tkind: \"failed\",\n\t\t\t\t\t\t\t\tfailureCode: \"adapter_execution_failed\",\n\t\t\t\t\t\t\t\tusage: UNKNOWN_USAGE,\n\t\t\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t})();\n\t\t\tconst handle: HumainAgentExecutionHandle = {\n\t\t\t\tcompletion,\n\t\t\t\tasync cancel() {\n\t\t\t\t\tcancellationRequested = true;\n\t\t\t\t\tawait session.abort();\n\t\t\t\t\tawait session.waitForIdle();\n\t\t\t\t\treturn { terminationConfirmed: session.isIdle };\n\t\t\t\t},\n\t\t\t\tdispose() {\n\t\t\t\t\tsession.dispose();\n\t\t\t\t},\n\t\t\t};\n\t\t\treturn handle;\n\t\t},\n\t};\n}\n"]}
@@ -0,0 +1,4 @@
1
+ export { getAgentDir } from "../../config.ts";
2
+ export type { AgentToolResult, ExtensionAPI, ExtensionContext } from "../../core/extensions/types.ts";
3
+ export { resizeImage } from "../../utils/image-resize.ts";
4
+ //# sourceMappingURL=host.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../../src/humain/web-access/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACtG,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC","sourcesContent":["export { getAgentDir } from \"../../config.ts\";\nexport type { AgentToolResult, ExtensionAPI, ExtensionContext } from \"../../core/extensions/types.ts\";\nexport { resizeImage } from \"../../utils/image-resize.ts\";\n"]}
@@ -0,0 +1,3 @@
1
+ export { getAgentDir } from "../../config.js";
2
+ export { resizeImage } from "../../utils/image-resize.js";
3
+ //# sourceMappingURL=host.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"host.js","sourceRoot":"","sources":["../../../src/humain/web-access/host.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC","sourcesContent":["export { getAgentDir } from \"../../config.ts\";\nexport type { AgentToolResult, ExtensionAPI, ExtensionContext } from \"../../core/extensions/types.ts\";\nexport { resizeImage } from \"../../utils/image-resize.ts\";\n"]}
@@ -0,0 +1,3 @@
1
+ import type { ExtensionFactory } from "../../core/extensions/types.ts";
2
+ export declare function createHumainWebAccessExtensionFactory(): ExtensionFactory;
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/humain/web-access/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGvE,wBAAgB,qCAAqC,IAAI,gBAAgB,CAExE","sourcesContent":["import type { ExtensionFactory } from \"../../core/extensions/types.ts\";\nimport webAccessExtension from \"./vendor/index.ts\";\n\nexport function createHumainWebAccessExtensionFactory(): ExtensionFactory {\n\treturn webAccessExtension;\n}\n"]}
@@ -0,0 +1,5 @@
1
+ import webAccessExtension from "./vendor/index.js";
2
+ export function createHumainWebAccessExtensionFactory() {
3
+ return webAccessExtension;
4
+ }
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/humain/web-access/index.ts"],"names":[],"mappings":"AACA,OAAO,kBAAkB,MAAM,mBAAmB,CAAC;AAEnD,MAAM,UAAU,qCAAqC,GAAqB;IACzE,OAAO,kBAAkB,CAAC;AAAA,CAC1B","sourcesContent":["import type { ExtensionFactory } from \"../../core/extensions/types.ts\";\nimport webAccessExtension from \"./vendor/index.ts\";\n\nexport function createHumainWebAccessExtensionFactory(): ExtensionFactory {\n\treturn webAccessExtension;\n}\n"]}
@@ -0,0 +1,34 @@
1
+ export interface ActivityEntry {
2
+ id: string;
3
+ type: "api" | "fetch";
4
+ startTime: number;
5
+ endTime?: number;
6
+ query?: string;
7
+ url?: string;
8
+ status: number | null;
9
+ error?: string;
10
+ }
11
+ export interface RateLimitInfo {
12
+ used: number;
13
+ max: number;
14
+ oldestTimestamp: number | null;
15
+ windowMs: number;
16
+ }
17
+ export declare class ActivityMonitor {
18
+ private entries;
19
+ private readonly maxEntries;
20
+ private listeners;
21
+ private rateLimitInfo;
22
+ private nextId;
23
+ logStart(partial: Omit<ActivityEntry, "id" | "startTime" | "status">): string;
24
+ logComplete(id: string, status: number): void;
25
+ logError(id: string, error: string): void;
26
+ getEntries(): readonly ActivityEntry[];
27
+ getRateLimitInfo(): RateLimitInfo;
28
+ updateRateLimit(info: RateLimitInfo): void;
29
+ onUpdate(callback: () => void): () => void;
30
+ clear(): void;
31
+ private notify;
32
+ }
33
+ export declare const activityMonitor: ActivityMonitor;
34
+ //# sourceMappingURL=activity.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../../src/humain/web-access/vendor/activity.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,GAAG,CAAC,EAAE,MAAM,CAAC;IAGb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAM;IACjC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,aAAa,CAA+E;IACpG,OAAO,CAAC,MAAM,CAAK;IAEnB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,GAAG,QAAQ,CAAC,GAAG,MAAM,CAc5E;IAED,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAO5C;IAED,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOxC;IAED,UAAU,IAAI,SAAS,aAAa,EAAE,CAErC;IAED,gBAAgB,IAAI,aAAa,CAEhC;IAED,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAGzC;IAED,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGzC;IAED,KAAK,IAAI,IAAI,CAIZ;IAED,OAAO,CAAC,MAAM;CAQd;AAED,eAAO,MAAM,eAAe,iBAAwB,CAAC","sourcesContent":["// Types\nexport interface ActivityEntry {\n\tid: string;\n\ttype: \"api\" | \"fetch\";\n\tstartTime: number;\n\tendTime?: number;\n\n\t// For API calls\n\tquery?: string;\n\n\t// For URL fetches\n\turl?: string;\n\n\t// Result - status is number (HTTP code) or null (pending/network error)\n\tstatus: number | null;\n\terror?: string;\n}\n\nexport interface RateLimitInfo {\n\tused: number;\n\tmax: number;\n\toldestTimestamp: number | null;\n\twindowMs: number;\n}\n\nexport class ActivityMonitor {\n\tprivate entries: ActivityEntry[] = [];\n\tprivate readonly maxEntries = 10;\n\tprivate listeners = new Set<() => void>();\n\tprivate rateLimitInfo: RateLimitInfo = { used: 0, max: 10, oldestTimestamp: null, windowMs: 60000 };\n\tprivate nextId = 1;\n\n\tlogStart(partial: Omit<ActivityEntry, \"id\" | \"startTime\" | \"status\">): string {\n\t\tconst id = `act-${this.nextId++}`;\n\t\tconst entry: ActivityEntry = {\n\t\t\t...partial,\n\t\t\tid,\n\t\t\tstartTime: Date.now(),\n\t\t\tstatus: null,\n\t\t};\n\t\tthis.entries.push(entry);\n\t\tif (this.entries.length > this.maxEntries) {\n\t\t\tthis.entries.shift();\n\t\t}\n\t\tthis.notify();\n\t\treturn id;\n\t}\n\n\tlogComplete(id: string, status: number): void {\n\t\tconst entry = this.entries.find((e) => e.id === id);\n\t\tif (entry) {\n\t\t\tentry.endTime = Date.now();\n\t\t\tentry.status = status;\n\t\t\tthis.notify();\n\t\t}\n\t}\n\n\tlogError(id: string, error: string): void {\n\t\tconst entry = this.entries.find((e) => e.id === id);\n\t\tif (entry) {\n\t\t\tentry.endTime = Date.now();\n\t\t\tentry.error = error;\n\t\t\tthis.notify();\n\t\t}\n\t}\n\n\tgetEntries(): readonly ActivityEntry[] {\n\t\treturn this.entries;\n\t}\n\n\tgetRateLimitInfo(): RateLimitInfo {\n\t\treturn this.rateLimitInfo;\n\t}\n\n\tupdateRateLimit(info: RateLimitInfo): void {\n\t\tthis.rateLimitInfo = info;\n\t\tthis.notify();\n\t}\n\n\tonUpdate(callback: () => void): () => void {\n\t\tthis.listeners.add(callback);\n\t\treturn () => this.listeners.delete(callback);\n\t}\n\n\tclear(): void {\n\t\tthis.entries = [];\n\t\tthis.rateLimitInfo = { used: 0, max: 10, oldestTimestamp: null, windowMs: 60000 };\n\t\tthis.notify();\n\t}\n\n\tprivate notify(): void {\n\t\tfor (const cb of this.listeners) {\n\t\t\ttry {\n\t\t\t\tcb();\n\t\t\t} catch {\n\t\t\t}\n\t\t}\n\t}\n}\n\nexport const activityMonitor = new ActivityMonitor();\n"]}