@code-yeongyu/senpi 2026.6.4 → 2026.6.6-3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1050) hide show
  1. package/CHANGELOG.md +39 -1
  2. package/README.md +19 -4
  3. package/dist/bun/cli.d.ts.map +1 -1
  4. package/dist/bun/cli.js.map +1 -1
  5. package/dist/bun/register-bedrock.d.ts.map +1 -1
  6. package/dist/bun/restore-sandbox-env.d.ts.map +1 -1
  7. package/dist/bun/restore-sandbox-env.js.map +1 -1
  8. package/dist/cli/args.d.ts +1 -0
  9. package/dist/cli/args.d.ts.map +1 -1
  10. package/dist/cli/args.js +12 -2
  11. package/dist/cli/args.js.map +1 -1
  12. package/dist/cli/config-selector.d.ts.map +1 -1
  13. package/dist/cli/config-selector.js.map +1 -1
  14. package/dist/cli/file-processor.d.ts.map +1 -1
  15. package/dist/cli/file-processor.js.map +1 -1
  16. package/dist/cli/initial-message.d.ts +1 -1
  17. package/dist/cli/initial-message.d.ts.map +1 -1
  18. package/dist/cli/initial-message.js.map +1 -1
  19. package/dist/cli/list-models.d.ts.map +1 -1
  20. package/dist/cli/list-models.js.map +1 -1
  21. package/dist/cli/session-picker.d.ts.map +1 -1
  22. package/dist/cli/session-picker.js.map +1 -1
  23. package/dist/cli-main.d.ts.map +1 -1
  24. package/dist/cli-main.js.map +1 -1
  25. package/dist/cli.d.ts.map +1 -1
  26. package/dist/cli.js.map +1 -1
  27. package/dist/config.d.ts.map +1 -1
  28. package/dist/config.js.map +1 -1
  29. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  30. package/dist/core/agent-session-runtime.js +0 -8
  31. package/dist/core/agent-session-runtime.js.map +1 -1
  32. package/dist/core/agent-session-services.d.ts.map +1 -1
  33. package/dist/core/agent-session-services.js.map +1 -1
  34. package/dist/core/agent-session.d.ts +32 -0
  35. package/dist/core/agent-session.d.ts.map +1 -1
  36. package/dist/core/agent-session.js +51 -79
  37. package/dist/core/agent-session.js.map +1 -1
  38. package/dist/core/auth-guidance.d.ts.map +1 -1
  39. package/dist/core/auth-guidance.js.map +1 -1
  40. package/dist/core/auth-storage.d.ts +4 -0
  41. package/dist/core/auth-storage.d.ts.map +1 -1
  42. package/dist/core/auth-storage.js +4 -8
  43. package/dist/core/auth-storage.js.map +1 -1
  44. package/dist/core/bash-executor.d.ts.map +1 -1
  45. package/dist/core/bash-executor.js.map +1 -1
  46. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  47. package/dist/core/compaction/branch-summarization.js.map +1 -1
  48. package/dist/core/compaction/compaction.d.ts.map +1 -1
  49. package/dist/core/compaction/compaction.js.map +1 -1
  50. package/dist/core/compaction/index.d.ts.map +1 -1
  51. package/dist/core/compaction/utils.d.ts.map +1 -1
  52. package/dist/core/compaction/utils.js.map +1 -1
  53. package/dist/core/defaults.d.ts.map +1 -1
  54. package/dist/core/diagnostics.d.ts.map +1 -1
  55. package/dist/core/dynamic-prompt/build.d.ts.map +1 -1
  56. package/dist/core/dynamic-prompt/build.js.map +1 -1
  57. package/dist/core/dynamic-prompt/exploration.d.ts.map +1 -1
  58. package/dist/core/dynamic-prompt/exploration.js.map +1 -1
  59. package/dist/core/dynamic-prompt/identity.d.ts.map +1 -1
  60. package/dist/core/dynamic-prompt/identity.js.map +1 -1
  61. package/dist/core/dynamic-prompt/index.d.ts.map +1 -1
  62. package/dist/core/dynamic-prompt/intent-gate.d.ts.map +1 -1
  63. package/dist/core/dynamic-prompt/intent-gate.js.map +1 -1
  64. package/dist/core/dynamic-prompt/parallel-tools.d.ts.map +1 -1
  65. package/dist/core/dynamic-prompt/parallel-tools.js.map +1 -1
  66. package/dist/core/dynamic-prompt/policies.d.ts.map +1 -1
  67. package/dist/core/dynamic-prompt/policies.js.map +1 -1
  68. package/dist/core/dynamic-prompt/style.d.ts.map +1 -1
  69. package/dist/core/dynamic-prompt/style.js.map +1 -1
  70. package/dist/core/dynamic-prompt/tool-categorization.d.ts.map +1 -1
  71. package/dist/core/dynamic-prompt/tool-categorization.js.map +1 -1
  72. package/dist/core/dynamic-prompt/tool-section.d.ts.map +1 -1
  73. package/dist/core/dynamic-prompt/tool-section.js.map +1 -1
  74. package/dist/core/dynamic-prompt/types.d.ts.map +1 -1
  75. package/dist/core/dynamic-prompt/verification.d.ts.map +1 -1
  76. package/dist/core/dynamic-prompt/verification.js.map +1 -1
  77. package/dist/core/event-bus.d.ts.map +1 -1
  78. package/dist/core/event-bus.js.map +1 -1
  79. package/dist/core/exec.d.ts.map +1 -1
  80. package/dist/core/exec.js.map +1 -1
  81. package/dist/core/export-html/ansi-to-html.d.ts.map +1 -1
  82. package/dist/core/export-html/ansi-to-html.js.map +1 -1
  83. package/dist/core/export-html/index.d.ts.map +1 -1
  84. package/dist/core/export-html/index.js.map +1 -1
  85. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  86. package/dist/core/export-html/tool-renderer.js.map +1 -1
  87. package/dist/core/extensions/builtin/anthropic-bash/index.d.ts.map +1 -1
  88. package/dist/core/extensions/builtin/anthropic-bash/index.js.map +1 -1
  89. package/dist/core/extensions/builtin/anthropic-web-search/index.d.ts.map +1 -1
  90. package/dist/core/extensions/builtin/anthropic-web-search/index.js.map +1 -1
  91. package/dist/core/extensions/builtin/bash-timeout/index.d.ts.map +1 -1
  92. package/dist/core/extensions/builtin/bash-timeout/index.js.map +1 -1
  93. package/dist/core/extensions/builtin/bash-timeout/timeout.d.ts.map +1 -1
  94. package/dist/core/extensions/builtin/bash-timeout/timeout.js.map +1 -1
  95. package/dist/core/extensions/builtin/compaction/checkpoint-state.d.ts.map +1 -1
  96. package/dist/core/extensions/builtin/compaction/checkpoint-state.js.map +1 -1
  97. package/dist/core/extensions/builtin/compaction/circuit-breaker.d.ts.map +1 -1
  98. package/dist/core/extensions/builtin/compaction/circuit-breaker.js.map +1 -1
  99. package/dist/core/extensions/builtin/compaction/context-reduction.d.ts.map +1 -1
  100. package/dist/core/extensions/builtin/compaction/context-reduction.js +1 -1
  101. package/dist/core/extensions/builtin/compaction/context-reduction.js.map +1 -1
  102. package/dist/core/extensions/builtin/compaction/degradation-monitor.d.ts.map +1 -1
  103. package/dist/core/extensions/builtin/compaction/degradation-monitor.js.map +1 -1
  104. package/dist/core/extensions/builtin/compaction/index.d.ts.map +1 -1
  105. package/dist/core/extensions/builtin/compaction/index.js.map +1 -1
  106. package/dist/core/extensions/builtin/compaction/openai-remote.d.ts.map +1 -1
  107. package/dist/core/extensions/builtin/compaction/openai-remote.js.map +1 -1
  108. package/dist/core/extensions/builtin/compaction/overflow-detection.d.ts.map +1 -1
  109. package/dist/core/extensions/builtin/compaction/overflow-detection.js.map +1 -1
  110. package/dist/core/extensions/builtin/compaction/per-turn-cap.d.ts.map +1 -1
  111. package/dist/core/extensions/builtin/compaction/per-turn-cap.js.map +1 -1
  112. package/dist/core/extensions/builtin/compaction/policy.d.ts.map +1 -1
  113. package/dist/core/extensions/builtin/compaction/policy.js.map +1 -1
  114. package/dist/core/extensions/builtin/compaction/prompts.d.ts.map +1 -1
  115. package/dist/core/extensions/builtin/compaction/prompts.js.map +1 -1
  116. package/dist/core/extensions/builtin/compaction/repair-tool-pairs.d.ts.map +1 -1
  117. package/dist/core/extensions/builtin/compaction/repair-tool-pairs.js.map +1 -1
  118. package/dist/core/extensions/builtin/compaction/restoration-tracker.d.ts.map +1 -1
  119. package/dist/core/extensions/builtin/compaction/restoration-tracker.js.map +1 -1
  120. package/dist/core/extensions/builtin/compaction/speculative.d.ts.map +1 -1
  121. package/dist/core/extensions/builtin/compaction/speculative.js.map +1 -1
  122. package/dist/core/extensions/builtin/compaction/state.d.ts.map +1 -1
  123. package/dist/core/extensions/builtin/compaction/state.js.map +1 -1
  124. package/dist/core/extensions/builtin/compaction/todo-bridge.d.ts.map +1 -1
  125. package/dist/core/extensions/builtin/compaction/todo-bridge.js.map +1 -1
  126. package/dist/core/extensions/builtin/compaction/tool-truncation.d.ts.map +1 -1
  127. package/dist/core/extensions/builtin/compaction/tool-truncation.js.map +1 -1
  128. package/dist/core/extensions/builtin/diff.d.ts.map +1 -1
  129. package/dist/core/extensions/builtin/diff.js.map +1 -1
  130. package/dist/core/extensions/builtin/files.d.ts.map +1 -1
  131. package/dist/core/extensions/builtin/files.js.map +1 -1
  132. package/dist/core/extensions/builtin/gpt-apply-patch/apply.d.ts.map +1 -1
  133. package/dist/core/extensions/builtin/gpt-apply-patch/apply.js.map +1 -1
  134. package/dist/core/extensions/builtin/gpt-apply-patch/constants.d.ts.map +1 -1
  135. package/dist/core/extensions/builtin/gpt-apply-patch/constants.js.map +1 -1
  136. package/dist/core/extensions/builtin/gpt-apply-patch/errors.d.ts.map +1 -1
  137. package/dist/core/extensions/builtin/gpt-apply-patch/errors.js +0 -2
  138. package/dist/core/extensions/builtin/gpt-apply-patch/errors.js.map +1 -1
  139. package/dist/core/extensions/builtin/gpt-apply-patch/extension.d.ts.map +1 -1
  140. package/dist/core/extensions/builtin/gpt-apply-patch/extension.js.map +1 -1
  141. package/dist/core/extensions/builtin/gpt-apply-patch/index.d.ts.map +1 -1
  142. package/dist/core/extensions/builtin/gpt-apply-patch/params.d.ts.map +1 -1
  143. package/dist/core/extensions/builtin/gpt-apply-patch/params.js.map +1 -1
  144. package/dist/core/extensions/builtin/gpt-apply-patch/parser.d.ts.map +1 -1
  145. package/dist/core/extensions/builtin/gpt-apply-patch/parser.js.map +1 -1
  146. package/dist/core/extensions/builtin/gpt-apply-patch/patch-diff.d.ts.map +1 -1
  147. package/dist/core/extensions/builtin/gpt-apply-patch/patch-diff.js.map +1 -1
  148. package/dist/core/extensions/builtin/gpt-apply-patch/patch-replace.d.ts.map +1 -1
  149. package/dist/core/extensions/builtin/gpt-apply-patch/patch-replace.js.map +1 -1
  150. package/dist/core/extensions/builtin/gpt-apply-patch/preview-format.d.ts.map +1 -1
  151. package/dist/core/extensions/builtin/gpt-apply-patch/preview-format.js.map +1 -1
  152. package/dist/core/extensions/builtin/gpt-apply-patch/preview.d.ts.map +1 -1
  153. package/dist/core/extensions/builtin/gpt-apply-patch/preview.js.map +1 -1
  154. package/dist/core/extensions/builtin/gpt-apply-patch/seek-sequence.d.ts.map +1 -1
  155. package/dist/core/extensions/builtin/gpt-apply-patch/seek-sequence.js.map +1 -1
  156. package/dist/core/extensions/builtin/gpt-apply-patch/streaming-parser.d.ts.map +1 -1
  157. package/dist/core/extensions/builtin/gpt-apply-patch/streaming-parser.js +7 -5
  158. package/dist/core/extensions/builtin/gpt-apply-patch/streaming-parser.js.map +1 -1
  159. package/dist/core/extensions/builtin/gpt-apply-patch/streaming-render.d.ts.map +1 -1
  160. package/dist/core/extensions/builtin/gpt-apply-patch/streaming-render.js.map +1 -1
  161. package/dist/core/extensions/builtin/gpt-apply-patch/text.d.ts.map +1 -1
  162. package/dist/core/extensions/builtin/gpt-apply-patch/text.js.map +1 -1
  163. package/dist/core/extensions/builtin/gpt-apply-patch/tool.d.ts.map +1 -1
  164. package/dist/core/extensions/builtin/gpt-apply-patch/tool.js.map +1 -1
  165. package/dist/core/extensions/builtin/gpt-apply-patch/types.d.ts.map +1 -1
  166. package/dist/core/extensions/builtin/gpt-apply-patch/workspace.d.ts.map +1 -1
  167. package/dist/core/extensions/builtin/gpt-apply-patch/workspace.js.map +1 -1
  168. package/dist/core/extensions/builtin/history-search/filter.d.ts.map +1 -1
  169. package/dist/core/extensions/builtin/history-search/filter.js.map +1 -1
  170. package/dist/core/extensions/builtin/history-search/index.d.ts.map +1 -1
  171. package/dist/core/extensions/builtin/history-search/index.js.map +1 -1
  172. package/dist/core/extensions/builtin/history-search/indexer.d.ts.map +1 -1
  173. package/dist/core/extensions/builtin/history-search/indexer.js.map +1 -1
  174. package/dist/core/extensions/builtin/history-search/overlay.d.ts.map +1 -1
  175. package/dist/core/extensions/builtin/history-search/overlay.js +3 -6
  176. package/dist/core/extensions/builtin/history-search/overlay.js.map +1 -1
  177. package/dist/core/extensions/builtin/history-search/types.d.ts.map +1 -1
  178. package/dist/core/extensions/builtin/index.d.ts.map +1 -1
  179. package/dist/core/extensions/builtin/kimi-web-search/index.d.ts.map +1 -1
  180. package/dist/core/extensions/builtin/kimi-web-search/index.js.map +1 -1
  181. package/dist/core/extensions/builtin/openai-web-search/index.d.ts.map +1 -1
  182. package/dist/core/extensions/builtin/openai-web-search/index.js.map +1 -1
  183. package/dist/core/extensions/builtin/permission-system/arity.d.ts.map +1 -1
  184. package/dist/core/extensions/builtin/permission-system/arity.js.map +1 -1
  185. package/dist/core/extensions/builtin/permission-system/cli.d.ts.map +1 -1
  186. package/dist/core/extensions/builtin/permission-system/cli.js.map +1 -1
  187. package/dist/core/extensions/builtin/permission-system/config.d.ts.map +1 -1
  188. package/dist/core/extensions/builtin/permission-system/config.js.map +1 -1
  189. package/dist/core/extensions/builtin/permission-system/evaluate.d.ts.map +1 -1
  190. package/dist/core/extensions/builtin/permission-system/evaluate.js.map +1 -1
  191. package/dist/core/extensions/builtin/permission-system/events.d.ts.map +1 -1
  192. package/dist/core/extensions/builtin/permission-system/events.js.map +1 -1
  193. package/dist/core/extensions/builtin/permission-system/external-dir.d.ts.map +1 -1
  194. package/dist/core/extensions/builtin/permission-system/external-dir.js.map +1 -1
  195. package/dist/core/extensions/builtin/permission-system/index.d.ts.map +1 -1
  196. package/dist/core/extensions/builtin/permission-system/index.js.map +1 -1
  197. package/dist/core/extensions/builtin/permission-system/non-interactive.d.ts.map +1 -1
  198. package/dist/core/extensions/builtin/permission-system/non-interactive.js.map +1 -1
  199. package/dist/core/extensions/builtin/permission-system/parsers.d.ts.map +1 -1
  200. package/dist/core/extensions/builtin/permission-system/parsers.js +3 -1
  201. package/dist/core/extensions/builtin/permission-system/parsers.js.map +1 -1
  202. package/dist/core/extensions/builtin/permission-system/prompt.d.ts.map +1 -1
  203. package/dist/core/extensions/builtin/permission-system/prompt.js.map +1 -1
  204. package/dist/core/extensions/builtin/permission-system/service.d.ts.map +1 -1
  205. package/dist/core/extensions/builtin/permission-system/service.js +2 -5
  206. package/dist/core/extensions/builtin/permission-system/service.js.map +1 -1
  207. package/dist/core/extensions/builtin/permission-system/settings.d.ts.map +1 -1
  208. package/dist/core/extensions/builtin/permission-system/settings.js.map +1 -1
  209. package/dist/core/extensions/builtin/permission-system/storage.d.ts.map +1 -1
  210. package/dist/core/extensions/builtin/permission-system/storage.js.map +1 -1
  211. package/dist/core/extensions/builtin/permission-system/types.d.ts.map +1 -1
  212. package/dist/core/extensions/builtin/permission-system/types.js +3 -5
  213. package/dist/core/extensions/builtin/permission-system/types.js.map +1 -1
  214. package/dist/core/extensions/builtin/permission-system/wildcard.d.ts.map +1 -1
  215. package/dist/core/extensions/builtin/permission-system/wildcard.js.map +1 -1
  216. package/dist/core/extensions/builtin/prompt-preset/claude-opus-4-5.d.ts.map +1 -1
  217. package/dist/core/extensions/builtin/prompt-preset/claude-opus-4-5.js.map +1 -1
  218. package/dist/core/extensions/builtin/prompt-preset/claude-opus-4-6.d.ts.map +1 -1
  219. package/dist/core/extensions/builtin/prompt-preset/claude-opus-4-6.js.map +1 -1
  220. package/dist/core/extensions/builtin/prompt-preset/claude-opus-4-7.d.ts.map +1 -1
  221. package/dist/core/extensions/builtin/prompt-preset/claude-opus-4-7.js.map +1 -1
  222. package/dist/core/extensions/builtin/prompt-preset/file-operations.d.ts.map +1 -1
  223. package/dist/core/extensions/builtin/prompt-preset/file-operations.js.map +1 -1
  224. package/dist/core/extensions/builtin/prompt-preset/gpt-5.2.d.ts.map +1 -1
  225. package/dist/core/extensions/builtin/prompt-preset/gpt-5.2.js.map +1 -1
  226. package/dist/core/extensions/builtin/prompt-preset/gpt-5.3-codex.d.ts.map +1 -1
  227. package/dist/core/extensions/builtin/prompt-preset/gpt-5.3-codex.js.map +1 -1
  228. package/dist/core/extensions/builtin/prompt-preset/gpt-5.4.d.ts.map +1 -1
  229. package/dist/core/extensions/builtin/prompt-preset/gpt-5.4.js.map +1 -1
  230. package/dist/core/extensions/builtin/prompt-preset/gpt-5.5.d.ts.map +1 -1
  231. package/dist/core/extensions/builtin/prompt-preset/gpt-5.5.js.map +1 -1
  232. package/dist/core/extensions/builtin/prompt-preset/gpt-5.d.ts.map +1 -1
  233. package/dist/core/extensions/builtin/prompt-preset/gpt-5.js.map +1 -1
  234. package/dist/core/extensions/builtin/prompt-preset/index.d.ts.map +1 -1
  235. package/dist/core/extensions/builtin/prompt-preset/index.js.map +1 -1
  236. package/dist/core/extensions/builtin/prompt-preset/kimi-k2-6.d.ts.map +1 -1
  237. package/dist/core/extensions/builtin/prompt-preset/kimi-k2-6.js.map +1 -1
  238. package/dist/core/extensions/builtin/prompt-preset/presets.d.ts.map +1 -1
  239. package/dist/core/extensions/builtin/prompt-preset/presets.js.map +1 -1
  240. package/dist/core/extensions/builtin/prompt-preset/settings.d.ts.map +1 -1
  241. package/dist/core/extensions/builtin/prompt-preset/settings.js.map +1 -1
  242. package/dist/core/extensions/builtin/prompt-url-widget.d.ts.map +1 -1
  243. package/dist/core/extensions/builtin/prompt-url-widget.js.map +1 -1
  244. package/dist/core/extensions/builtin/redraws.d.ts.map +1 -1
  245. package/dist/core/extensions/builtin/redraws.js.map +1 -1
  246. package/dist/core/extensions/builtin/service-tier.d.ts.map +1 -1
  247. package/dist/core/extensions/builtin/service-tier.js.map +1 -1
  248. package/dist/core/extensions/builtin/session-observer/index.d.ts.map +1 -1
  249. package/dist/core/extensions/builtin/session-observer/index.js.map +1 -1
  250. package/dist/core/extensions/builtin/session-observer/loader.d.ts.map +1 -1
  251. package/dist/core/extensions/builtin/session-observer/loader.js.map +1 -1
  252. package/dist/core/extensions/builtin/session-observer/overlay-format.d.ts.map +1 -1
  253. package/dist/core/extensions/builtin/session-observer/overlay-format.js.map +1 -1
  254. package/dist/core/extensions/builtin/session-observer/overlay.d.ts.map +1 -1
  255. package/dist/core/extensions/builtin/session-observer/overlay.js +13 -18
  256. package/dist/core/extensions/builtin/session-observer/overlay.js.map +1 -1
  257. package/dist/core/extensions/builtin/session-observer/scanner.d.ts.map +1 -1
  258. package/dist/core/extensions/builtin/session-observer/scanner.js.map +1 -1
  259. package/dist/core/extensions/builtin/session-observer/text.d.ts.map +1 -1
  260. package/dist/core/extensions/builtin/session-observer/text.js.map +1 -1
  261. package/dist/core/extensions/builtin/session-observer/transcript-entries.d.ts.map +1 -1
  262. package/dist/core/extensions/builtin/session-observer/transcript-entries.js.map +1 -1
  263. package/dist/core/extensions/builtin/session-observer/transcript-format.d.ts.map +1 -1
  264. package/dist/core/extensions/builtin/session-observer/transcript-format.js.map +1 -1
  265. package/dist/core/extensions/builtin/session-observer/transcript.d.ts.map +1 -1
  266. package/dist/core/extensions/builtin/session-observer/transcript.js.map +1 -1
  267. package/dist/core/extensions/builtin/session-observer/types.d.ts.map +1 -1
  268. package/dist/core/extensions/builtin/system-messages.d.ts.map +1 -1
  269. package/dist/core/extensions/builtin/system-messages.js.map +1 -1
  270. package/dist/core/extensions/builtin/todotools/continuation/config.d.ts +1 -1
  271. package/dist/core/extensions/builtin/todotools/continuation/config.d.ts.map +1 -1
  272. package/dist/core/extensions/builtin/todotools/continuation/config.js.map +1 -1
  273. package/dist/core/extensions/builtin/todotools/continuation/index.d.ts.map +1 -1
  274. package/dist/core/extensions/builtin/todotools/continuation/prompt.d.ts.map +1 -1
  275. package/dist/core/extensions/builtin/todotools/continuation/prompt.js.map +1 -1
  276. package/dist/core/extensions/builtin/todotools/continuation/runtime.d.ts.map +1 -1
  277. package/dist/core/extensions/builtin/todotools/continuation/runtime.js.map +1 -1
  278. package/dist/core/extensions/builtin/todotools/index.d.ts.map +1 -1
  279. package/dist/core/extensions/builtin/todotools/index.js.map +1 -1
  280. package/dist/core/extensions/builtin/todotools/prompt.d.ts.map +1 -1
  281. package/dist/core/extensions/builtin/todotools/settings.d.ts.map +1 -1
  282. package/dist/core/extensions/builtin/todotools/settings.js.map +1 -1
  283. package/dist/core/extensions/builtin/todotools/state.d.ts.map +1 -1
  284. package/dist/core/extensions/builtin/todotools/state.js.map +1 -1
  285. package/dist/core/extensions/builtin/todotools/system-messages.d.ts.map +1 -1
  286. package/dist/core/extensions/builtin/todotools/system-messages.js.map +1 -1
  287. package/dist/core/extensions/builtin/todotools/tools/todoread.d.ts.map +1 -1
  288. package/dist/core/extensions/builtin/todotools/tools/todoread.js.map +1 -1
  289. package/dist/core/extensions/builtin/todotools/tools/todowrite.d.ts.map +1 -1
  290. package/dist/core/extensions/builtin/todotools/tools/todowrite.js.map +1 -1
  291. package/dist/core/extensions/builtin/tool-pair-guard/index.d.ts.map +1 -1
  292. package/dist/core/extensions/builtin/tool-pair-guard/index.js.map +1 -1
  293. package/dist/core/extensions/builtin/tool-pair-guard/sanitize-anthropic-payload.d.ts.map +1 -1
  294. package/dist/core/extensions/builtin/tool-pair-guard/sanitize-anthropic-payload.js.map +1 -1
  295. package/dist/core/extensions/builtin/tool-pair-guard/sanitize-openai-chat-completions-payload.d.ts.map +1 -1
  296. package/dist/core/extensions/builtin/tool-pair-guard/sanitize-openai-chat-completions-payload.js.map +1 -1
  297. package/dist/core/extensions/builtin/tool-pair-guard/sanitize-openai-responses-payload.d.ts.map +1 -1
  298. package/dist/core/extensions/builtin/tool-pair-guard/sanitize-openai-responses-payload.js.map +1 -1
  299. package/dist/core/extensions/builtin/tps.d.ts.map +1 -1
  300. package/dist/core/extensions/builtin/tps.js.map +1 -1
  301. package/dist/core/extensions/index.d.ts.map +1 -1
  302. package/dist/core/extensions/loader.d.ts.map +1 -1
  303. package/dist/core/extensions/loader.js.map +1 -1
  304. package/dist/core/extensions/runner.d.ts.map +1 -1
  305. package/dist/core/extensions/runner.js +35 -43
  306. package/dist/core/extensions/runner.js.map +1 -1
  307. package/dist/core/extensions/types.d.ts +1 -1
  308. package/dist/core/extensions/types.d.ts.map +1 -1
  309. package/dist/core/extensions/types.js.map +1 -1
  310. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  311. package/dist/core/extensions/wrapper.js.map +1 -1
  312. package/dist/core/footer-data-provider.d.ts.map +1 -1
  313. package/dist/core/footer-data-provider.js +17 -18
  314. package/dist/core/footer-data-provider.js.map +1 -1
  315. package/dist/core/http-dispatcher.d.ts.map +1 -1
  316. package/dist/core/http-dispatcher.js.map +1 -1
  317. package/dist/core/index.d.ts.map +1 -1
  318. package/dist/core/keybindings.d.ts +1 -1
  319. package/dist/core/keybindings.d.ts.map +1 -1
  320. package/dist/core/keybindings.js +0 -1
  321. package/dist/core/keybindings.js.map +1 -1
  322. package/dist/core/messages.d.ts.map +1 -1
  323. package/dist/core/messages.js.map +1 -1
  324. package/dist/core/model-registry.d.ts.map +1 -1
  325. package/dist/core/model-registry.js +8 -10
  326. package/dist/core/model-registry.js.map +1 -1
  327. package/dist/core/model-resolver.d.ts.map +1 -1
  328. package/dist/core/model-resolver.js.map +1 -1
  329. package/dist/core/output-guard.d.ts.map +1 -1
  330. package/dist/core/output-guard.js.map +1 -1
  331. package/dist/core/package-manager.d.ts +1 -0
  332. package/dist/core/package-manager.d.ts.map +1 -1
  333. package/dist/core/package-manager.js +25 -13
  334. package/dist/core/package-manager.js.map +1 -1
  335. package/dist/core/prompt-templates.d.ts.map +1 -1
  336. package/dist/core/prompt-templates.js.map +1 -1
  337. package/dist/core/provider-attribution.d.ts.map +1 -1
  338. package/dist/core/provider-attribution.js.map +1 -1
  339. package/dist/core/provider-display-names.d.ts.map +1 -1
  340. package/dist/core/resolve-config-value.d.ts.map +1 -1
  341. package/dist/core/resolve-config-value.js.map +1 -1
  342. package/dist/core/resource-loader.d.ts +1 -0
  343. package/dist/core/resource-loader.d.ts.map +1 -1
  344. package/dist/core/resource-loader.js +26 -53
  345. package/dist/core/resource-loader.js.map +1 -1
  346. package/dist/core/sdk.d.ts.map +1 -1
  347. package/dist/core/sdk.js.map +1 -1
  348. package/dist/core/session-cwd.d.ts.map +1 -1
  349. package/dist/core/session-cwd.js +0 -1
  350. package/dist/core/session-cwd.js.map +1 -1
  351. package/dist/core/session-manager.d.ts.map +1 -1
  352. package/dist/core/session-manager.js +7 -11
  353. package/dist/core/session-manager.js.map +1 -1
  354. package/dist/core/session-work-barrier.d.ts.map +1 -1
  355. package/dist/core/session-work-barrier.js +5 -3
  356. package/dist/core/session-work-barrier.js.map +1 -1
  357. package/dist/core/settings-manager.d.ts +10 -2
  358. package/dist/core/settings-manager.d.ts.map +1 -1
  359. package/dist/core/settings-manager.js +77 -46
  360. package/dist/core/settings-manager.js.map +1 -1
  361. package/dist/core/skills.d.ts.map +1 -1
  362. package/dist/core/skills.js.map +1 -1
  363. package/dist/core/slash-commands.d.ts.map +1 -1
  364. package/dist/core/slash-commands.js +1 -0
  365. package/dist/core/slash-commands.js.map +1 -1
  366. package/dist/core/source-info.d.ts.map +1 -1
  367. package/dist/core/source-info.js.map +1 -1
  368. package/dist/core/system-prompt.d.ts.map +1 -1
  369. package/dist/core/system-prompt.js.map +1 -1
  370. package/dist/core/telemetry.d.ts.map +1 -1
  371. package/dist/core/telemetry.js.map +1 -1
  372. package/dist/core/thinking-levels.d.ts.map +1 -1
  373. package/dist/core/thinking-levels.js.map +1 -1
  374. package/dist/core/timings.d.ts.map +1 -1
  375. package/dist/core/timings.js.map +1 -1
  376. package/dist/core/tools/bash.d.ts.map +1 -1
  377. package/dist/core/tools/bash.js +9 -6
  378. package/dist/core/tools/bash.js.map +1 -1
  379. package/dist/core/tools/diff-render.d.ts.map +1 -1
  380. package/dist/core/tools/diff-render.js.map +1 -1
  381. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  382. package/dist/core/tools/edit-diff.js.map +1 -1
  383. package/dist/core/tools/edit.d.ts.map +1 -1
  384. package/dist/core/tools/edit.js.map +1 -1
  385. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  386. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  387. package/dist/core/tools/find.d.ts.map +1 -1
  388. package/dist/core/tools/find.js +1 -1
  389. package/dist/core/tools/find.js.map +1 -1
  390. package/dist/core/tools/grep.d.ts.map +1 -1
  391. package/dist/core/tools/grep.js +1 -1
  392. package/dist/core/tools/grep.js.map +1 -1
  393. package/dist/core/tools/index.d.ts.map +1 -1
  394. package/dist/core/tools/index.js.map +1 -1
  395. package/dist/core/tools/ls.d.ts.map +1 -1
  396. package/dist/core/tools/ls.js +1 -1
  397. package/dist/core/tools/ls.js.map +1 -1
  398. package/dist/core/tools/output-accumulator.d.ts.map +1 -1
  399. package/dist/core/tools/output-accumulator.js +12 -18
  400. package/dist/core/tools/output-accumulator.js.map +1 -1
  401. package/dist/core/tools/path-utils.d.ts.map +1 -1
  402. package/dist/core/tools/path-utils.js.map +1 -1
  403. package/dist/core/tools/read.d.ts.map +1 -1
  404. package/dist/core/tools/read.js +1 -1
  405. package/dist/core/tools/read.js.map +1 -1
  406. package/dist/core/tools/render-utils.d.ts.map +1 -1
  407. package/dist/core/tools/render-utils.js.map +1 -1
  408. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  409. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  410. package/dist/core/tools/truncate.d.ts.map +1 -1
  411. package/dist/core/tools/truncate.js.map +1 -1
  412. package/dist/core/tools/write.d.ts.map +1 -1
  413. package/dist/core/tools/write.js +1 -2
  414. package/dist/core/tools/write.js.map +1 -1
  415. package/dist/core/trust-manager.d.ts +9 -0
  416. package/dist/core/trust-manager.d.ts.map +1 -0
  417. package/dist/core/trust-manager.js +133 -0
  418. package/dist/core/trust-manager.js.map +1 -0
  419. package/dist/index.d.ts +2 -1
  420. package/dist/index.d.ts.map +1 -1
  421. package/dist/index.js +1 -0
  422. package/dist/index.js.map +1 -1
  423. package/dist/main.d.ts.map +1 -1
  424. package/dist/main.js +54 -2
  425. package/dist/main.js.map +1 -1
  426. package/dist/migrations.d.ts.map +1 -1
  427. package/dist/migrations.js.map +1 -1
  428. package/dist/modes/index.d.ts.map +1 -1
  429. package/dist/modes/interactive/components/armin.d.ts.map +1 -1
  430. package/dist/modes/interactive/components/armin.js +6 -10
  431. package/dist/modes/interactive/components/armin.js.map +1 -1
  432. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  433. package/dist/modes/interactive/components/assistant-message.js +2 -11
  434. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  435. package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
  436. package/dist/modes/interactive/components/bash-execution.js +6 -11
  437. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  438. package/dist/modes/interactive/components/bordered-loader.d.ts.map +1 -1
  439. package/dist/modes/interactive/components/bordered-loader.js +0 -3
  440. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  441. package/dist/modes/interactive/components/branch-summary-message.d.ts.map +1 -1
  442. package/dist/modes/interactive/components/branch-summary-message.js +1 -3
  443. package/dist/modes/interactive/components/branch-summary-message.js.map +1 -1
  444. package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +1 -1
  445. package/dist/modes/interactive/components/compaction-summary-message.js +1 -3
  446. package/dist/modes/interactive/components/compaction-summary-message.js.map +1 -1
  447. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  448. package/dist/modes/interactive/components/config-selector.js +5 -15
  449. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  450. package/dist/modes/interactive/components/countdown-timer.d.ts.map +1 -1
  451. package/dist/modes/interactive/components/countdown-timer.js +0 -5
  452. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  453. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  454. package/dist/modes/interactive/components/custom-editor.js +1 -8
  455. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  456. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
  457. package/dist/modes/interactive/components/custom-message.js +1 -6
  458. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  459. package/dist/modes/interactive/components/daxnuts.d.ts.map +1 -1
  460. package/dist/modes/interactive/components/daxnuts.js +6 -8
  461. package/dist/modes/interactive/components/daxnuts.js.map +1 -1
  462. package/dist/modes/interactive/components/diff.d.ts.map +1 -1
  463. package/dist/modes/interactive/components/diff.js +2 -2
  464. package/dist/modes/interactive/components/diff.js.map +1 -1
  465. package/dist/modes/interactive/components/dynamic-border.d.ts.map +1 -1
  466. package/dist/modes/interactive/components/dynamic-border.js +0 -1
  467. package/dist/modes/interactive/components/dynamic-border.js.map +1 -1
  468. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -1
  469. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -1
  470. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  471. package/dist/modes/interactive/components/extension-editor.js +1 -6
  472. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  473. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  474. package/dist/modes/interactive/components/extension-input.js +2 -8
  475. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  476. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  477. package/dist/modes/interactive/components/extension-selector.js +1 -9
  478. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  479. package/dist/modes/interactive/components/favorite-models-selector.d.ts.map +1 -1
  480. package/dist/modes/interactive/components/favorite-models-selector.js +9 -15
  481. package/dist/modes/interactive/components/favorite-models-selector.js.map +1 -1
  482. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  483. package/dist/modes/interactive/components/footer.js +10 -3
  484. package/dist/modes/interactive/components/footer.js.map +1 -1
  485. package/dist/modes/interactive/components/index.d.ts +1 -0
  486. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  487. package/dist/modes/interactive/components/index.js +1 -0
  488. package/dist/modes/interactive/components/index.js.map +1 -1
  489. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +1 -1
  490. package/dist/modes/interactive/components/keybinding-hints.js.map +1 -1
  491. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  492. package/dist/modes/interactive/components/login-dialog.js +3 -9
  493. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  494. package/dist/modes/interactive/components/model-favorites.d.ts.map +1 -1
  495. package/dist/modes/interactive/components/model-favorites.js.map +1 -1
  496. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  497. package/dist/modes/interactive/components/model-selector.js +9 -22
  498. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  499. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
  500. package/dist/modes/interactive/components/oauth-selector.js +3 -12
  501. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  502. package/dist/modes/interactive/components/session-selector-search.d.ts.map +1 -1
  503. package/dist/modes/interactive/components/session-selector-search.js.map +1 -1
  504. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  505. package/dist/modes/interactive/components/session-selector.js +33 -58
  506. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  507. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  508. package/dist/modes/interactive/components/settings-selector.js +0 -4
  509. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  510. package/dist/modes/interactive/components/show-images-selector.d.ts.map +1 -1
  511. package/dist/modes/interactive/components/show-images-selector.js +0 -1
  512. package/dist/modes/interactive/components/show-images-selector.js.map +1 -1
  513. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  514. package/dist/modes/interactive/components/skill-invocation-message.js +1 -3
  515. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  516. package/dist/modes/interactive/components/theme-selector.d.ts.map +1 -1
  517. package/dist/modes/interactive/components/theme-selector.js +0 -2
  518. package/dist/modes/interactive/components/theme-selector.js.map +1 -1
  519. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  520. package/dist/modes/interactive/components/thinking-selector.js +0 -1
  521. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  522. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  523. package/dist/modes/interactive/components/tool-execution.js +9 -28
  524. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  525. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  526. package/dist/modes/interactive/components/tree-selector.js +18 -32
  527. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  528. package/dist/modes/interactive/components/trust-selector.d.ts +20 -0
  529. package/dist/modes/interactive/components/trust-selector.d.ts.map +1 -0
  530. package/dist/modes/interactive/components/trust-selector.js +81 -0
  531. package/dist/modes/interactive/components/trust-selector.js.map +1 -0
  532. package/dist/modes/interactive/components/user-message-selector.d.ts.map +1 -1
  533. package/dist/modes/interactive/components/user-message-selector.js +3 -6
  534. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  535. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  536. package/dist/modes/interactive/components/user-message.js +0 -1
  537. package/dist/modes/interactive/components/user-message.js.map +1 -1
  538. package/dist/modes/interactive/components/visual-truncate.d.ts.map +1 -1
  539. package/dist/modes/interactive/components/visual-truncate.js.map +1 -1
  540. package/dist/modes/interactive/interactive-mode.d.ts +24 -0
  541. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  542. package/dist/modes/interactive/interactive-mode.js +112 -101
  543. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  544. package/dist/modes/interactive/session-info-format.d.ts.map +1 -1
  545. package/dist/modes/interactive/session-info-format.js.map +1 -1
  546. package/dist/modes/interactive/startup-tools.d.ts.map +1 -1
  547. package/dist/modes/interactive/startup-tools.js.map +1 -1
  548. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  549. package/dist/modes/interactive/theme/theme.js +0 -6
  550. package/dist/modes/interactive/theme/theme.js.map +1 -1
  551. package/dist/modes/interactive/working-status.d.ts.map +1 -1
  552. package/dist/modes/interactive/working-status.js.map +1 -1
  553. package/dist/modes/print-mode.d.ts.map +1 -1
  554. package/dist/modes/print-mode.js.map +1 -1
  555. package/dist/modes/provider-native-rendering.d.ts.map +1 -1
  556. package/dist/modes/provider-native-rendering.js.map +1 -1
  557. package/dist/modes/rpc/jsonl.d.ts.map +1 -1
  558. package/dist/modes/rpc/jsonl.js.map +1 -1
  559. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  560. package/dist/modes/rpc/rpc-client.js +7 -8
  561. package/dist/modes/rpc/rpc-client.js.map +1 -1
  562. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  563. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  564. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  565. package/dist/package-manager-cli.d.ts.map +1 -1
  566. package/dist/package-manager-cli.js +56 -9
  567. package/dist/package-manager-cli.js.map +1 -1
  568. package/dist/self-update-bootstrap.d.ts.map +1 -1
  569. package/dist/self-update-bootstrap.js.map +1 -1
  570. package/dist/utils/ansi.d.ts.map +1 -1
  571. package/dist/utils/ansi.js.map +1 -1
  572. package/dist/utils/changelog.d.ts.map +1 -1
  573. package/dist/utils/changelog.js.map +1 -1
  574. package/dist/utils/child-process.d.ts.map +1 -1
  575. package/dist/utils/child-process.js.map +1 -1
  576. package/dist/utils/clipboard-image.d.ts.map +1 -1
  577. package/dist/utils/clipboard-image.js.map +1 -1
  578. package/dist/utils/clipboard-native.d.ts.map +1 -1
  579. package/dist/utils/clipboard-native.js.map +1 -1
  580. package/dist/utils/clipboard.d.ts.map +1 -1
  581. package/dist/utils/clipboard.js.map +1 -1
  582. package/dist/utils/deprecation.d.ts.map +1 -1
  583. package/dist/utils/deprecation.js.map +1 -1
  584. package/dist/utils/exif-orientation.d.ts.map +1 -1
  585. package/dist/utils/exif-orientation.js.map +1 -1
  586. package/dist/utils/frontmatter.d.ts.map +1 -1
  587. package/dist/utils/frontmatter.js.map +1 -1
  588. package/dist/utils/fs-watch.d.ts.map +1 -1
  589. package/dist/utils/fs-watch.js.map +1 -1
  590. package/dist/utils/git.d.ts.map +1 -1
  591. package/dist/utils/git.js.map +1 -1
  592. package/dist/utils/html.d.ts.map +1 -1
  593. package/dist/utils/html.js.map +1 -1
  594. package/dist/utils/image-convert.d.ts.map +1 -1
  595. package/dist/utils/image-convert.js.map +1 -1
  596. package/dist/utils/image-resize-core.d.ts.map +1 -1
  597. package/dist/utils/image-resize-core.js.map +1 -1
  598. package/dist/utils/image-resize-worker.d.ts.map +1 -1
  599. package/dist/utils/image-resize-worker.js.map +1 -1
  600. package/dist/utils/image-resize.d.ts.map +1 -1
  601. package/dist/utils/image-resize.js.map +1 -1
  602. package/dist/utils/json.d.ts.map +1 -1
  603. package/dist/utils/json.js.map +1 -1
  604. package/dist/utils/mime.d.ts.map +1 -1
  605. package/dist/utils/mime.js.map +1 -1
  606. package/dist/utils/open-browser.d.ts.map +1 -1
  607. package/dist/utils/open-browser.js.map +1 -1
  608. package/dist/utils/paths.d.ts.map +1 -1
  609. package/dist/utils/paths.js.map +1 -1
  610. package/dist/utils/photon.d.ts.map +1 -1
  611. package/dist/utils/photon.js.map +1 -1
  612. package/dist/utils/pi-user-agent.d.ts.map +1 -1
  613. package/dist/utils/pi-user-agent.js.map +1 -1
  614. package/dist/utils/shell.d.ts.map +1 -1
  615. package/dist/utils/shell.js.map +1 -1
  616. package/dist/utils/sleep.d.ts.map +1 -1
  617. package/dist/utils/sleep.js.map +1 -1
  618. package/dist/utils/syntax-highlight.d.ts.map +1 -1
  619. package/dist/utils/syntax-highlight.js.map +1 -1
  620. package/dist/utils/tools-manager.d.ts.map +1 -1
  621. package/dist/utils/tools-manager.js.map +1 -1
  622. package/dist/utils/version-check.d.ts.map +1 -1
  623. package/dist/utils/version-check.js.map +1 -1
  624. package/dist/utils/windows-self-update.d.ts.map +1 -1
  625. package/dist/utils/windows-self-update.js.map +1 -1
  626. package/docs/extensions.md +1 -1
  627. package/docs/packages.md +3 -1
  628. package/docs/prompt-templates.md +1 -1
  629. package/docs/settings.md +10 -0
  630. package/docs/skills.md +3 -3
  631. package/docs/themes.md +1 -1
  632. package/docs/usage.md +15 -3
  633. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  634. package/examples/extensions/custom-provider-anthropic/package.json +1 -1
  635. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  636. package/examples/extensions/gondolin/package-lock.json +2 -2
  637. package/examples/extensions/gondolin/package.json +1 -1
  638. package/examples/extensions/minimal-mode.ts +6 -6
  639. package/examples/extensions/sandbox/package-lock.json +2 -2
  640. package/examples/extensions/sandbox/package.json +1 -1
  641. package/examples/extensions/with-deps/package-lock.json +2 -2
  642. package/examples/extensions/with-deps/package.json +1 -1
  643. package/node_modules/@earendil-works/pi-agent-core/dist/agent-loop.d.ts.map +1 -1
  644. package/node_modules/@earendil-works/pi-agent-core/dist/agent-loop.js.map +1 -1
  645. package/node_modules/@earendil-works/pi-agent-core/dist/agent.d.ts +7 -0
  646. package/node_modules/@earendil-works/pi-agent-core/dist/agent.d.ts.map +1 -1
  647. package/node_modules/@earendil-works/pi-agent-core/dist/agent.js +2 -27
  648. package/node_modules/@earendil-works/pi-agent-core/dist/agent.js.map +1 -1
  649. package/node_modules/@earendil-works/pi-agent-core/dist/harness/agent-harness.d.ts.map +1 -1
  650. package/node_modules/@earendil-works/pi-agent-core/dist/harness/agent-harness.js +7 -20
  651. package/node_modules/@earendil-works/pi-agent-core/dist/harness/agent-harness.js.map +1 -1
  652. package/node_modules/@earendil-works/pi-agent-core/dist/harness/compaction/branch-summarization.d.ts.map +1 -1
  653. package/node_modules/@earendil-works/pi-agent-core/dist/harness/compaction/branch-summarization.js.map +1 -1
  654. package/node_modules/@earendil-works/pi-agent-core/dist/harness/compaction/compaction.d.ts.map +1 -1
  655. package/node_modules/@earendil-works/pi-agent-core/dist/harness/compaction/compaction.js.map +1 -1
  656. package/node_modules/@earendil-works/pi-agent-core/dist/harness/compaction/utils.d.ts.map +1 -1
  657. package/node_modules/@earendil-works/pi-agent-core/dist/harness/compaction/utils.js.map +1 -1
  658. package/node_modules/@earendil-works/pi-agent-core/dist/harness/env/nodejs.d.ts.map +1 -1
  659. package/node_modules/@earendil-works/pi-agent-core/dist/harness/env/nodejs.js +0 -3
  660. package/node_modules/@earendil-works/pi-agent-core/dist/harness/env/nodejs.js.map +1 -1
  661. package/node_modules/@earendil-works/pi-agent-core/dist/harness/messages.d.ts.map +1 -1
  662. package/node_modules/@earendil-works/pi-agent-core/dist/harness/messages.js.map +1 -1
  663. package/node_modules/@earendil-works/pi-agent-core/dist/harness/prompt-templates.d.ts.map +1 -1
  664. package/node_modules/@earendil-works/pi-agent-core/dist/harness/prompt-templates.js.map +1 -1
  665. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/jsonl-repo.d.ts.map +1 -1
  666. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/jsonl-repo.js +0 -3
  667. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/jsonl-repo.js.map +1 -1
  668. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/jsonl-storage.d.ts.map +1 -1
  669. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/jsonl-storage.js +0 -7
  670. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/jsonl-storage.js.map +1 -1
  671. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/memory-repo.d.ts.map +1 -1
  672. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/memory-repo.js +3 -1
  673. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/memory-repo.js.map +1 -1
  674. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/memory-storage.d.ts.map +1 -1
  675. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/memory-storage.js +0 -5
  676. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/memory-storage.js.map +1 -1
  677. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/repo-utils.d.ts.map +1 -1
  678. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/repo-utils.js.map +1 -1
  679. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/session.d.ts.map +1 -1
  680. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/session.js +0 -1
  681. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/session.js.map +1 -1
  682. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/uuid.d.ts.map +1 -1
  683. package/node_modules/@earendil-works/pi-agent-core/dist/harness/session/uuid.js.map +1 -1
  684. package/node_modules/@earendil-works/pi-agent-core/dist/harness/skills.d.ts.map +1 -1
  685. package/node_modules/@earendil-works/pi-agent-core/dist/harness/skills.js.map +1 -1
  686. package/node_modules/@earendil-works/pi-agent-core/dist/harness/system-prompt.d.ts.map +1 -1
  687. package/node_modules/@earendil-works/pi-agent-core/dist/harness/system-prompt.js.map +1 -1
  688. package/node_modules/@earendil-works/pi-agent-core/dist/harness/types.d.ts.map +1 -1
  689. package/node_modules/@earendil-works/pi-agent-core/dist/harness/types.js +0 -16
  690. package/node_modules/@earendil-works/pi-agent-core/dist/harness/types.js.map +1 -1
  691. package/node_modules/@earendil-works/pi-agent-core/dist/harness/utils/shell-output.d.ts.map +1 -1
  692. package/node_modules/@earendil-works/pi-agent-core/dist/harness/utils/shell-output.js.map +1 -1
  693. package/node_modules/@earendil-works/pi-agent-core/dist/harness/utils/truncate.d.ts.map +1 -1
  694. package/node_modules/@earendil-works/pi-agent-core/dist/harness/utils/truncate.js.map +1 -1
  695. package/node_modules/@earendil-works/pi-agent-core/dist/index.d.ts.map +1 -1
  696. package/node_modules/@earendil-works/pi-agent-core/dist/node.d.ts.map +1 -1
  697. package/node_modules/@earendil-works/pi-agent-core/dist/proxy.d.ts.map +1 -1
  698. package/node_modules/@earendil-works/pi-agent-core/dist/proxy.js.map +1 -1
  699. package/node_modules/@earendil-works/pi-agent-core/dist/types.d.ts.map +1 -1
  700. package/node_modules/@earendil-works/pi-agent-core/package.json +6 -6
  701. package/node_modules/@earendil-works/pi-ai/dist/api-registry.d.ts.map +1 -1
  702. package/node_modules/@earendil-works/pi-ai/dist/api-registry.js.map +1 -1
  703. package/node_modules/@earendil-works/pi-ai/dist/bedrock-provider.d.ts.map +1 -1
  704. package/node_modules/@earendil-works/pi-ai/dist/cli.d.ts.map +1 -1
  705. package/node_modules/@earendil-works/pi-ai/dist/cli.js.map +1 -1
  706. package/node_modules/@earendil-works/pi-ai/dist/env-api-keys.d.ts.map +1 -1
  707. package/node_modules/@earendil-works/pi-ai/dist/env-api-keys.js.map +1 -1
  708. package/node_modules/@earendil-works/pi-ai/dist/image-models.d.ts.map +1 -1
  709. package/node_modules/@earendil-works/pi-ai/dist/image-models.generated.d.ts +30 -0
  710. package/node_modules/@earendil-works/pi-ai/dist/image-models.generated.d.ts.map +1 -1
  711. package/node_modules/@earendil-works/pi-ai/dist/image-models.generated.js +30 -0
  712. package/node_modules/@earendil-works/pi-ai/dist/image-models.generated.js.map +1 -1
  713. package/node_modules/@earendil-works/pi-ai/dist/image-models.js.map +1 -1
  714. package/node_modules/@earendil-works/pi-ai/dist/images-api-registry.d.ts.map +1 -1
  715. package/node_modules/@earendil-works/pi-ai/dist/images-api-registry.js.map +1 -1
  716. package/node_modules/@earendil-works/pi-ai/dist/images.d.ts.map +1 -1
  717. package/node_modules/@earendil-works/pi-ai/dist/images.js.map +1 -1
  718. package/node_modules/@earendil-works/pi-ai/dist/index.d.ts.map +1 -1
  719. package/node_modules/@earendil-works/pi-ai/dist/models.d.ts.map +1 -1
  720. package/node_modules/@earendil-works/pi-ai/dist/models.generated.d.ts +174 -29
  721. package/node_modules/@earendil-works/pi-ai/dist/models.generated.d.ts.map +1 -1
  722. package/node_modules/@earendil-works/pi-ai/dist/models.generated.js +178 -54
  723. package/node_modules/@earendil-works/pi-ai/dist/models.generated.js.map +1 -1
  724. package/node_modules/@earendil-works/pi-ai/dist/models.js.map +1 -1
  725. package/node_modules/@earendil-works/pi-ai/dist/oauth.d.ts.map +1 -1
  726. package/node_modules/@earendil-works/pi-ai/dist/providers/amazon-bedrock.d.ts.map +1 -1
  727. package/node_modules/@earendil-works/pi-ai/dist/providers/amazon-bedrock.js.map +1 -1
  728. package/node_modules/@earendil-works/pi-ai/dist/providers/anthropic.d.ts.map +1 -1
  729. package/node_modules/@earendil-works/pi-ai/dist/providers/anthropic.js.map +1 -1
  730. package/node_modules/@earendil-works/pi-ai/dist/providers/azure-openai-responses.d.ts.map +1 -1
  731. package/node_modules/@earendil-works/pi-ai/dist/providers/azure-openai-responses.js.map +1 -1
  732. package/node_modules/@earendil-works/pi-ai/dist/providers/cloudflare.d.ts.map +1 -1
  733. package/node_modules/@earendil-works/pi-ai/dist/providers/cloudflare.js.map +1 -1
  734. package/node_modules/@earendil-works/pi-ai/dist/providers/faux.d.ts.map +1 -1
  735. package/node_modules/@earendil-works/pi-ai/dist/providers/faux.js.map +1 -1
  736. package/node_modules/@earendil-works/pi-ai/dist/providers/github-copilot-headers.d.ts.map +1 -1
  737. package/node_modules/@earendil-works/pi-ai/dist/providers/github-copilot-headers.js.map +1 -1
  738. package/node_modules/@earendil-works/pi-ai/dist/providers/google-shared.d.ts.map +1 -1
  739. package/node_modules/@earendil-works/pi-ai/dist/providers/google-shared.js.map +1 -1
  740. package/node_modules/@earendil-works/pi-ai/dist/providers/google-vertex.d.ts.map +1 -1
  741. package/node_modules/@earendil-works/pi-ai/dist/providers/google-vertex.js.map +1 -1
  742. package/node_modules/@earendil-works/pi-ai/dist/providers/google.d.ts.map +1 -1
  743. package/node_modules/@earendil-works/pi-ai/dist/providers/google.js.map +1 -1
  744. package/node_modules/@earendil-works/pi-ai/dist/providers/images/openrouter.d.ts.map +1 -1
  745. package/node_modules/@earendil-works/pi-ai/dist/providers/images/openrouter.js.map +1 -1
  746. package/node_modules/@earendil-works/pi-ai/dist/providers/images/register-builtins.d.ts.map +1 -1
  747. package/node_modules/@earendil-works/pi-ai/dist/providers/images/register-builtins.js.map +1 -1
  748. package/node_modules/@earendil-works/pi-ai/dist/providers/mistral.d.ts.map +1 -1
  749. package/node_modules/@earendil-works/pi-ai/dist/providers/mistral.js +3 -3
  750. package/node_modules/@earendil-works/pi-ai/dist/providers/mistral.js.map +1 -1
  751. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-codex-responses.d.ts.map +1 -1
  752. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-codex-responses.js +0 -7
  753. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-codex-responses.js.map +1 -1
  754. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-completions.d.ts.map +1 -1
  755. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-completions.js +1 -1
  756. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-completions.js.map +1 -1
  757. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-prompt-cache.d.ts.map +1 -1
  758. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-prompt-cache.js.map +1 -1
  759. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-responses-shared.d.ts.map +1 -1
  760. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-responses-shared.js.map +1 -1
  761. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-responses.d.ts.map +1 -1
  762. package/node_modules/@earendil-works/pi-ai/dist/providers/openai-responses.js.map +1 -1
  763. package/node_modules/@earendil-works/pi-ai/dist/providers/register-builtins.d.ts.map +1 -1
  764. package/node_modules/@earendil-works/pi-ai/dist/providers/register-builtins.js.map +1 -1
  765. package/node_modules/@earendil-works/pi-ai/dist/providers/simple-options.d.ts.map +1 -1
  766. package/node_modules/@earendil-works/pi-ai/dist/providers/simple-options.js.map +1 -1
  767. package/node_modules/@earendil-works/pi-ai/dist/providers/transform-messages.d.ts.map +1 -1
  768. package/node_modules/@earendil-works/pi-ai/dist/providers/transform-messages.js.map +1 -1
  769. package/node_modules/@earendil-works/pi-ai/dist/session-resources.d.ts.map +1 -1
  770. package/node_modules/@earendil-works/pi-ai/dist/session-resources.js.map +1 -1
  771. package/node_modules/@earendil-works/pi-ai/dist/stream.d.ts.map +1 -1
  772. package/node_modules/@earendil-works/pi-ai/dist/stream.js.map +1 -1
  773. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/context-transformer.d.ts.map +1 -1
  774. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/context-transformer.js.map +1 -1
  775. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/index.d.ts.map +1 -1
  776. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/index.js.map +1 -1
  777. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/gemma4.d.ts.map +1 -1
  778. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/gemma4.js +10 -8
  779. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/gemma4.js.map +1 -1
  780. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/hermes.d.ts.map +1 -1
  781. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/hermes.js.map +1 -1
  782. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/json-mix.d.ts.map +1 -1
  783. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/json-mix.js.map +1 -1
  784. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/morph-xml.d.ts.map +1 -1
  785. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/morph-xml.js.map +1 -1
  786. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/xml-tool-tag-scanner.d.ts.map +1 -1
  787. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/xml-tool-tag-scanner.js.map +1 -1
  788. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/yaml-xml.d.ts.map +1 -1
  789. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/protocols/yaml-xml.js.map +1 -1
  790. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/stream-wrapper.d.ts.map +1 -1
  791. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/stream-wrapper.js.map +1 -1
  792. package/node_modules/@earendil-works/pi-ai/dist/tool-call-middleware/types.d.ts.map +1 -1
  793. package/node_modules/@earendil-works/pi-ai/dist/types.d.ts +1 -1
  794. package/node_modules/@earendil-works/pi-ai/dist/types.d.ts.map +1 -1
  795. package/node_modules/@earendil-works/pi-ai/dist/types.js.map +1 -1
  796. package/node_modules/@earendil-works/pi-ai/dist/utils/abort-signals.d.ts.map +1 -1
  797. package/node_modules/@earendil-works/pi-ai/dist/utils/abort-signals.js.map +1 -1
  798. package/node_modules/@earendil-works/pi-ai/dist/utils/diagnostics.d.ts.map +1 -1
  799. package/node_modules/@earendil-works/pi-ai/dist/utils/diagnostics.js.map +1 -1
  800. package/node_modules/@earendil-works/pi-ai/dist/utils/event-stream.d.ts.map +1 -1
  801. package/node_modules/@earendil-works/pi-ai/dist/utils/event-stream.js +3 -7
  802. package/node_modules/@earendil-works/pi-ai/dist/utils/event-stream.js.map +1 -1
  803. package/node_modules/@earendil-works/pi-ai/dist/utils/hash.d.ts.map +1 -1
  804. package/node_modules/@earendil-works/pi-ai/dist/utils/hash.js.map +1 -1
  805. package/node_modules/@earendil-works/pi-ai/dist/utils/headers.d.ts.map +1 -1
  806. package/node_modules/@earendil-works/pi-ai/dist/utils/headers.js.map +1 -1
  807. package/node_modules/@earendil-works/pi-ai/dist/utils/json-parse.d.ts.map +1 -1
  808. package/node_modules/@earendil-works/pi-ai/dist/utils/json-parse.js.map +1 -1
  809. package/node_modules/@earendil-works/pi-ai/dist/utils/node-http-proxy.d.ts.map +1 -1
  810. package/node_modules/@earendil-works/pi-ai/dist/utils/node-http-proxy.js.map +1 -1
  811. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/anthropic.d.ts.map +1 -1
  812. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/anthropic.js.map +1 -1
  813. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/device-code.d.ts.map +1 -1
  814. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/device-code.js.map +1 -1
  815. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/github-copilot.d.ts.map +1 -1
  816. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/github-copilot.js.map +1 -1
  817. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/index.d.ts.map +1 -1
  818. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/index.js.map +1 -1
  819. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/oauth-page.d.ts.map +1 -1
  820. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/oauth-page.js.map +1 -1
  821. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/openai-codex.d.ts.map +1 -1
  822. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/openai-codex.js.map +1 -1
  823. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/pkce.d.ts.map +1 -1
  824. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/pkce.js.map +1 -1
  825. package/node_modules/@earendil-works/pi-ai/dist/utils/oauth/types.d.ts.map +1 -1
  826. package/node_modules/@earendil-works/pi-ai/dist/utils/overflow.d.ts.map +1 -1
  827. package/node_modules/@earendil-works/pi-ai/dist/utils/overflow.js.map +1 -1
  828. package/node_modules/@earendil-works/pi-ai/dist/utils/sanitize-unicode.d.ts.map +1 -1
  829. package/node_modules/@earendil-works/pi-ai/dist/utils/sanitize-unicode.js.map +1 -1
  830. package/node_modules/@earendil-works/pi-ai/dist/utils/tool-pair-repair.d.ts.map +1 -1
  831. package/node_modules/@earendil-works/pi-ai/dist/utils/tool-pair-repair.js.map +1 -1
  832. package/node_modules/@earendil-works/pi-ai/dist/utils/typebox-helpers.d.ts.map +1 -1
  833. package/node_modules/@earendil-works/pi-ai/dist/utils/typebox-helpers.js.map +1 -1
  834. package/node_modules/@earendil-works/pi-ai/dist/utils/validation.d.ts.map +1 -1
  835. package/node_modules/@earendil-works/pi-ai/dist/utils/validation.js.map +1 -1
  836. package/node_modules/@earendil-works/pi-ai/package.json +5 -5
  837. package/node_modules/@earendil-works/pi-tui/dist/autocomplete.d.ts +1 -1
  838. package/node_modules/@earendil-works/pi-tui/dist/autocomplete.d.ts.map +1 -1
  839. package/node_modules/@earendil-works/pi-tui/dist/autocomplete.js +0 -3
  840. package/node_modules/@earendil-works/pi-tui/dist/autocomplete.js.map +1 -1
  841. package/node_modules/@earendil-works/pi-tui/dist/components/box.d.ts.map +1 -1
  842. package/node_modules/@earendil-works/pi-tui/dist/components/box.js +1 -6
  843. package/node_modules/@earendil-works/pi-tui/dist/components/box.js.map +1 -1
  844. package/node_modules/@earendil-works/pi-tui/dist/components/cancellable-loader.d.ts.map +1 -1
  845. package/node_modules/@earendil-works/pi-tui/dist/components/cancellable-loader.js +4 -3
  846. package/node_modules/@earendil-works/pi-tui/dist/components/cancellable-loader.js.map +1 -1
  847. package/node_modules/@earendil-works/pi-tui/dist/components/editor.d.ts.map +1 -1
  848. package/node_modules/@earendil-works/pi-tui/dist/components/editor.js +43 -54
  849. package/node_modules/@earendil-works/pi-tui/dist/components/editor.js.map +1 -1
  850. package/node_modules/@earendil-works/pi-tui/dist/components/image.d.ts.map +1 -1
  851. package/node_modules/@earendil-works/pi-tui/dist/components/image.js +0 -8
  852. package/node_modules/@earendil-works/pi-tui/dist/components/image.js.map +1 -1
  853. package/node_modules/@earendil-works/pi-tui/dist/components/input.d.ts.map +1 -1
  854. package/node_modules/@earendil-works/pi-tui/dist/components/input.js +14 -14
  855. package/node_modules/@earendil-works/pi-tui/dist/components/input.js.map +1 -1
  856. package/node_modules/@earendil-works/pi-tui/dist/components/loader.d.ts.map +1 -1
  857. package/node_modules/@earendil-works/pi-tui/dist/components/loader.js +11 -13
  858. package/node_modules/@earendil-works/pi-tui/dist/components/loader.js.map +1 -1
  859. package/node_modules/@earendil-works/pi-tui/dist/components/markdown.d.ts.map +1 -1
  860. package/node_modules/@earendil-works/pi-tui/dist/components/markdown.js +0 -11
  861. package/node_modules/@earendil-works/pi-tui/dist/components/markdown.js.map +1 -1
  862. package/node_modules/@earendil-works/pi-tui/dist/components/select-list.d.ts.map +1 -1
  863. package/node_modules/@earendil-works/pi-tui/dist/components/select-list.js +4 -9
  864. package/node_modules/@earendil-works/pi-tui/dist/components/select-list.js.map +1 -1
  865. package/node_modules/@earendil-works/pi-tui/dist/components/settings-list.d.ts.map +1 -1
  866. package/node_modules/@earendil-works/pi-tui/dist/components/settings-list.js +4 -12
  867. package/node_modules/@earendil-works/pi-tui/dist/components/settings-list.js.map +1 -1
  868. package/node_modules/@earendil-works/pi-tui/dist/components/spacer.d.ts.map +1 -1
  869. package/node_modules/@earendil-works/pi-tui/dist/components/spacer.js +0 -1
  870. package/node_modules/@earendil-works/pi-tui/dist/components/spacer.js.map +1 -1
  871. package/node_modules/@earendil-works/pi-tui/dist/components/text.d.ts.map +1 -1
  872. package/node_modules/@earendil-works/pi-tui/dist/components/text.js +0 -8
  873. package/node_modules/@earendil-works/pi-tui/dist/components/text.js.map +1 -1
  874. package/node_modules/@earendil-works/pi-tui/dist/components/truncated-text.d.ts.map +1 -1
  875. package/node_modules/@earendil-works/pi-tui/dist/components/truncated-text.js +0 -3
  876. package/node_modules/@earendil-works/pi-tui/dist/components/truncated-text.js.map +1 -1
  877. package/node_modules/@earendil-works/pi-tui/dist/editor-component.d.ts.map +1 -1
  878. package/node_modules/@earendil-works/pi-tui/dist/fuzzy.d.ts.map +1 -1
  879. package/node_modules/@earendil-works/pi-tui/dist/fuzzy.js.map +1 -1
  880. package/node_modules/@earendil-works/pi-tui/dist/index.d.ts.map +1 -1
  881. package/node_modules/@earendil-works/pi-tui/dist/keybindings.d.ts.map +1 -1
  882. package/node_modules/@earendil-works/pi-tui/dist/keybindings.js +2 -4
  883. package/node_modules/@earendil-works/pi-tui/dist/keybindings.js.map +1 -1
  884. package/node_modules/@earendil-works/pi-tui/dist/keys.d.ts.map +1 -1
  885. package/node_modules/@earendil-works/pi-tui/dist/keys.js.map +1 -1
  886. package/node_modules/@earendil-works/pi-tui/dist/kill-ring.d.ts.map +1 -1
  887. package/node_modules/@earendil-works/pi-tui/dist/kill-ring.js +3 -1
  888. package/node_modules/@earendil-works/pi-tui/dist/kill-ring.js.map +1 -1
  889. package/node_modules/@earendil-works/pi-tui/dist/native-modifiers.d.ts.map +1 -1
  890. package/node_modules/@earendil-works/pi-tui/dist/native-modifiers.js.map +1 -1
  891. package/node_modules/@earendil-works/pi-tui/dist/slash-command-autocomplete.d.ts.map +1 -1
  892. package/node_modules/@earendil-works/pi-tui/dist/slash-command-autocomplete.js.map +1 -1
  893. package/node_modules/@earendil-works/pi-tui/dist/stdin-buffer.d.ts.map +1 -1
  894. package/node_modules/@earendil-works/pi-tui/dist/stdin-buffer.js +4 -6
  895. package/node_modules/@earendil-works/pi-tui/dist/stdin-buffer.js.map +1 -1
  896. package/node_modules/@earendil-works/pi-tui/dist/terminal-image.d.ts.map +1 -1
  897. package/node_modules/@earendil-works/pi-tui/dist/terminal-image.js.map +1 -1
  898. package/node_modules/@earendil-works/pi-tui/dist/terminal.d.ts.map +1 -1
  899. package/node_modules/@earendil-works/pi-tui/dist/terminal.js +24 -29
  900. package/node_modules/@earendil-works/pi-tui/dist/terminal.js.map +1 -1
  901. package/node_modules/@earendil-works/pi-tui/dist/tui.d.ts.map +1 -1
  902. package/node_modules/@earendil-works/pi-tui/dist/tui.js +25 -27
  903. package/node_modules/@earendil-works/pi-tui/dist/tui.js.map +1 -1
  904. package/node_modules/@earendil-works/pi-tui/dist/undo-stack.d.ts.map +1 -1
  905. package/node_modules/@earendil-works/pi-tui/dist/undo-stack.js +3 -1
  906. package/node_modules/@earendil-works/pi-tui/dist/undo-stack.js.map +1 -1
  907. package/node_modules/@earendil-works/pi-tui/dist/utils.d.ts.map +1 -1
  908. package/node_modules/@earendil-works/pi-tui/dist/utils.js +14 -12
  909. package/node_modules/@earendil-works/pi-tui/dist/utils.js.map +1 -1
  910. package/node_modules/@earendil-works/pi-tui/dist/word-navigation.d.ts.map +1 -1
  911. package/node_modules/@earendil-works/pi-tui/dist/word-navigation.js.map +1 -1
  912. package/node_modules/@earendil-works/pi-tui/package.json +1 -1
  913. package/node_modules/@types/node/README.md +3 -3
  914. package/node_modules/@types/node/assert/strict.d.ts +3 -55
  915. package/node_modules/@types/node/assert.d.ts +49 -177
  916. package/node_modules/@types/node/async_hooks.d.ts +151 -43
  917. package/node_modules/@types/node/buffer.buffer.d.ts +2 -8
  918. package/node_modules/@types/node/buffer.d.ts +43 -212
  919. package/node_modules/@types/node/child_process.d.ts +23 -133
  920. package/node_modules/@types/node/cluster.d.ts +238 -384
  921. package/node_modules/@types/node/compatibility/iterators.d.ts +1 -0
  922. package/node_modules/@types/node/console.d.ts +45 -404
  923. package/node_modules/@types/node/constants.d.ts +3 -10
  924. package/node_modules/@types/node/crypto.d.ts +640 -1127
  925. package/node_modules/@types/node/dgram.d.ts +14 -77
  926. package/node_modules/@types/node/diagnostics_channel.d.ts +3 -29
  927. package/node_modules/@types/node/dns/promises.d.ts +4 -10
  928. package/node_modules/@types/node/dns.d.ts +130 -177
  929. package/node_modules/@types/node/domain.d.ts +12 -32
  930. package/node_modules/@types/node/events.d.ts +872 -840
  931. package/node_modules/@types/node/fs/promises.d.ts +193 -20
  932. package/node_modules/@types/node/fs.d.ts +754 -435
  933. package/node_modules/@types/node/globals.d.ts +8 -30
  934. package/node_modules/@types/node/globals.typedarray.d.ts +63 -0
  935. package/node_modules/@types/node/http.d.ts +363 -305
  936. package/node_modules/@types/node/http2.d.ts +545 -781
  937. package/node_modules/@types/node/https.d.ts +64 -243
  938. package/node_modules/@types/node/index.d.ts +26 -6
  939. package/node_modules/@types/node/inspector/promises.d.ts +35 -0
  940. package/node_modules/@types/node/inspector.d.ts +68 -57
  941. package/node_modules/@types/node/inspector.generated.d.ts +764 -410
  942. package/node_modules/@types/node/module.d.ts +53 -189
  943. package/node_modules/@types/node/net.d.ts +101 -207
  944. package/node_modules/@types/node/os.d.ts +11 -19
  945. package/node_modules/@types/node/package.json +13 -3
  946. package/node_modules/@types/node/path/posix.d.ts +8 -0
  947. package/node_modules/@types/node/path/win32.d.ts +8 -0
  948. package/node_modules/@types/node/path.d.ts +119 -141
  949. package/node_modules/@types/node/perf_hooks.d.ts +317 -673
  950. package/node_modules/@types/node/process.d.ts +277 -157
  951. package/node_modules/@types/node/punycode.d.ts +3 -31
  952. package/node_modules/@types/node/querystring.d.ts +3 -16
  953. package/node_modules/@types/node/quic.d.ts +897 -0
  954. package/node_modules/@types/node/readline/promises.d.ts +3 -6
  955. package/node_modules/@types/node/readline.d.ts +65 -152
  956. package/node_modules/@types/node/repl.d.ts +101 -109
  957. package/node_modules/@types/node/sea.d.ts +9 -115
  958. package/node_modules/@types/node/sqlite.d.ts +415 -68
  959. package/node_modules/@types/node/stream/consumers.d.ts +91 -15
  960. package/node_modules/@types/node/stream/iter.d.ts +301 -0
  961. package/node_modules/@types/node/stream/promises.d.ts +136 -15
  962. package/node_modules/@types/node/stream/web.d.ts +179 -501
  963. package/node_modules/@types/node/stream.d.ts +577 -490
  964. package/node_modules/@types/node/string_decoder.d.ts +3 -43
  965. package/node_modules/@types/node/test/reporters.d.ts +59 -0
  966. package/node_modules/@types/node/test.d.ts +402 -286
  967. package/node_modules/@types/node/timers/promises.d.ts +3 -18
  968. package/node_modules/@types/node/timers.d.ts +3 -141
  969. package/node_modules/@types/node/tls.d.ts +115 -241
  970. package/node_modules/@types/node/trace_events.d.ts +3 -97
  971. package/node_modules/@types/node/ts5.6/buffer.buffer.d.ts +2 -8
  972. package/node_modules/@types/node/ts5.6/compatibility/float16array.d.ts +71 -0
  973. package/node_modules/@types/node/ts5.6/globals.typedarray.d.ts +2 -0
  974. package/node_modules/@types/node/ts5.6/index.d.ts +28 -6
  975. package/node_modules/@types/node/ts5.7/compatibility/float16array.d.ts +72 -0
  976. package/node_modules/@types/node/ts5.7/index.d.ts +119 -0
  977. package/node_modules/@types/node/tty.d.ts +57 -40
  978. package/node_modules/@types/node/url.d.ts +156 -584
  979. package/node_modules/@types/node/util/types.d.ts +558 -0
  980. package/node_modules/@types/node/util.d.ts +167 -1096
  981. package/node_modules/@types/node/v8.d.ts +75 -15
  982. package/node_modules/@types/node/vm.d.ts +334 -198
  983. package/node_modules/@types/node/wasi.d.ts +24 -74
  984. package/node_modules/@types/node/web-globals/abortcontroller.d.ts +27 -2
  985. package/node_modules/@types/node/web-globals/blob.d.ts +23 -0
  986. package/node_modules/@types/node/web-globals/console.d.ts +9 -0
  987. package/node_modules/@types/node/web-globals/crypto.d.ts +39 -0
  988. package/node_modules/@types/node/web-globals/encoding.d.ts +11 -0
  989. package/node_modules/@types/node/web-globals/events.d.ts +9 -0
  990. package/node_modules/@types/node/web-globals/fetch.d.ts +14 -0
  991. package/node_modules/@types/node/web-globals/importmeta.d.ts +13 -0
  992. package/node_modules/@types/node/web-globals/messaging.d.ts +23 -0
  993. package/node_modules/@types/node/web-globals/navigator.d.ts +3 -0
  994. package/node_modules/@types/node/web-globals/performance.d.ts +45 -0
  995. package/node_modules/@types/node/web-globals/streams.d.ts +115 -0
  996. package/node_modules/@types/node/web-globals/timers.d.ts +44 -0
  997. package/node_modules/@types/node/web-globals/url.d.ts +24 -0
  998. package/node_modules/@types/node/worker_threads.d.ts +280 -393
  999. package/node_modules/@types/node/zlib/iter.d.ts +131 -0
  1000. package/node_modules/@types/node/zlib.d.ts +7 -165
  1001. package/node_modules/undici-types/agent.d.ts +13 -12
  1002. package/node_modules/undici-types/api.d.ts +26 -26
  1003. package/node_modules/undici-types/balanced-pool.d.ts +13 -12
  1004. package/node_modules/undici-types/cache-interceptor.d.ts +179 -0
  1005. package/node_modules/undici-types/client-stats.d.ts +15 -0
  1006. package/node_modules/undici-types/client.d.ts +34 -19
  1007. package/node_modules/undici-types/connector.d.ts +4 -2
  1008. package/node_modules/undici-types/cookies.d.ts +2 -0
  1009. package/node_modules/undici-types/diagnostics-channel.d.ts +18 -10
  1010. package/node_modules/undici-types/dispatcher.d.ts +127 -104
  1011. package/node_modules/undici-types/env-http-proxy-agent.d.ts +4 -3
  1012. package/node_modules/undici-types/errors.d.ts +82 -54
  1013. package/node_modules/undici-types/eventsource.d.ts +9 -4
  1014. package/node_modules/undici-types/fetch.d.ts +22 -20
  1015. package/node_modules/undici-types/formdata.d.ts +7 -7
  1016. package/node_modules/undici-types/global-dispatcher.d.ts +4 -4
  1017. package/node_modules/undici-types/global-origin.d.ts +5 -5
  1018. package/node_modules/undici-types/h2c-client.d.ts +73 -0
  1019. package/node_modules/undici-types/handlers.d.ts +8 -8
  1020. package/node_modules/undici-types/header.d.ts +157 -1
  1021. package/node_modules/undici-types/index.d.ts +67 -47
  1022. package/node_modules/undici-types/interceptors.d.ts +71 -8
  1023. package/node_modules/undici-types/mock-agent.d.ts +36 -18
  1024. package/node_modules/undici-types/mock-call-history.d.ts +111 -0
  1025. package/node_modules/undici-types/mock-client.d.ts +6 -4
  1026. package/node_modules/undici-types/mock-errors.d.ts +3 -3
  1027. package/node_modules/undici-types/mock-interceptor.d.ts +21 -20
  1028. package/node_modules/undici-types/mock-pool.d.ts +6 -4
  1029. package/node_modules/undici-types/package.json +1 -1
  1030. package/node_modules/undici-types/patch.d.ts +0 -4
  1031. package/node_modules/undici-types/pool-stats.d.ts +8 -8
  1032. package/node_modules/undici-types/pool.d.ts +15 -13
  1033. package/node_modules/undici-types/proxy-agent.d.ts +5 -4
  1034. package/node_modules/undici-types/readable.d.ts +19 -16
  1035. package/node_modules/undici-types/retry-agent.d.ts +1 -1
  1036. package/node_modules/undici-types/retry-handler.d.ts +19 -10
  1037. package/node_modules/undici-types/round-robin-pool.d.ts +41 -0
  1038. package/node_modules/undici-types/snapshot-agent.d.ts +109 -0
  1039. package/node_modules/undici-types/socks5-proxy-agent.d.ts +25 -0
  1040. package/node_modules/undici-types/util.d.ts +3 -3
  1041. package/node_modules/undici-types/utility.d.ts +7 -0
  1042. package/node_modules/undici-types/webidl.d.ts +148 -29
  1043. package/node_modules/undici-types/websocket.d.ts +48 -10
  1044. package/npm-shrinkwrap.json +21 -21
  1045. package/package.json +13 -8
  1046. package/node_modules/@types/node/compatibility/disposable.d.ts +0 -14
  1047. package/node_modules/@types/node/compatibility/index.d.ts +0 -9
  1048. package/node_modules/@types/node/compatibility/indexable.d.ts +0 -20
  1049. package/node_modules/undici-types/file.d.ts +0 -39
  1050. package/node_modules/undici-types/filereader.d.ts +0 -54
@@ -1,89 +1,42 @@
1
- /**
2
- * Much of the Node.js core API is built around an idiomatic asynchronous
3
- * event-driven architecture in which certain kinds of objects (called "emitters")
4
- * emit named events that cause `Function` objects ("listeners") to be called.
5
- *
6
- * For instance: a `net.Server` object emits an event each time a peer
7
- * connects to it; a `fs.ReadStream` emits an event when the file is opened;
8
- * a `stream` emits an event whenever data is available to be read.
9
- *
10
- * All objects that emit events are instances of the `EventEmitter` class. These
11
- * objects expose an `eventEmitter.on()` function that allows one or more
12
- * functions to be attached to named events emitted by the object. Typically,
13
- * event names are camel-cased strings but any valid JavaScript property key
14
- * can be used.
15
- *
16
- * When the `EventEmitter` object emits an event, all of the functions attached
17
- * to that specific event are called _synchronously_. Any values returned by the
18
- * called listeners are _ignored_ and discarded.
19
- *
20
- * The following example shows a simple `EventEmitter` instance with a single
21
- * listener. The `eventEmitter.on()` method is used to register listeners, while
22
- * the `eventEmitter.emit()` method is used to trigger the event.
23
- *
24
- * ```js
25
- * import { EventEmitter } from 'node:events';
26
- *
27
- * class MyEmitter extends EventEmitter {}
28
- *
29
- * const myEmitter = new MyEmitter();
30
- * myEmitter.on('event', () => {
31
- * console.log('an event occurred!');
32
- * });
33
- * myEmitter.emit('event');
34
- * ```
35
- * @see [source](https://github.com/nodejs/node/blob/v22.x/lib/events.js)
36
- */
37
- declare module "events" {
1
+ declare module "node:events" {
38
2
  import { AsyncResource, AsyncResourceOptions } from "node:async_hooks";
3
+ // #region Event map helpers
4
+ type EventMap<T> = Record<keyof T, any[]>;
5
+ type IfEventMap<Events extends EventMap<Events>, True, False> = {} extends Events ? False : True;
6
+ type Args<Events extends EventMap<Events>, EventName extends string | symbol> = IfEventMap<
7
+ Events,
8
+ EventName extends keyof Events ? Events[EventName]
9
+ : EventName extends keyof EventEmitterEventMap ? EventEmitterEventMap[EventName]
10
+ : any[],
11
+ any[]
12
+ >;
13
+ type EventNames<Events extends EventMap<Events>, EventName extends string | symbol> = IfEventMap<
14
+ Events,
15
+ EventName | (keyof Events & (string | symbol)) | keyof EventEmitterEventMap,
16
+ string | symbol
17
+ >;
18
+ type Listener<Events extends EventMap<Events>, EventName extends string | symbol> = IfEventMap<
19
+ Events,
20
+ (
21
+ ...args: EventName extends keyof Events ? Events[EventName]
22
+ : EventName extends keyof EventEmitterEventMap ? EventEmitterEventMap[EventName]
23
+ : any[]
24
+ ) => void,
25
+ (...args: any[]) => void
26
+ >;
27
+ interface EventEmitterEventMap {
28
+ newListener: [eventName: string | symbol, listener: (...args: any[]) => void];
29
+ removeListener: [eventName: string | symbol, listener: (...args: any[]) => void];
30
+ }
31
+ // #endregion
39
32
  interface EventEmitterOptions {
40
33
  /**
41
- * Enables automatic capturing of promise rejection.
34
+ * It enables
35
+ * [automatic capturing of promise rejection](https://nodejs.org/docs/latest-v25.x/api/events.html#capture-rejections-of-promises).
36
+ * @default false
42
37
  */
43
38
  captureRejections?: boolean | undefined;
44
39
  }
45
- interface StaticEventEmitterOptions {
46
- /**
47
- * Can be used to cancel awaiting events.
48
- */
49
- signal?: AbortSignal | undefined;
50
- }
51
- interface StaticEventEmitterIteratorOptions extends StaticEventEmitterOptions {
52
- /**
53
- * Names of events that will end the iteration.
54
- */
55
- close?: string[] | undefined;
56
- /**
57
- * The high watermark. The emitter is paused every time the size of events being buffered is higher than it.
58
- * Supported only on emitters implementing `pause()` and `resume()` methods.
59
- * @default Number.MAX_SAFE_INTEGER
60
- */
61
- highWaterMark?: number | undefined;
62
- /**
63
- * The low watermark. The emitter is resumed every time the size of events being buffered is lower than it.
64
- * Supported only on emitters implementing `pause()` and `resume()` methods.
65
- * @default 1
66
- */
67
- lowWaterMark?: number | undefined;
68
- }
69
- interface EventEmitter<T extends EventMap<T> = DefaultEventMap> extends NodeJS.EventEmitter<T> {}
70
- type EventMap<T> = Record<keyof T, any[]> | DefaultEventMap;
71
- type DefaultEventMap = [never];
72
- type AnyRest = [...args: any[]];
73
- type Args<K, T> = T extends DefaultEventMap ? AnyRest : (
74
- K extends keyof T ? T[K] : never
75
- );
76
- type Key<K, T> = T extends DefaultEventMap ? string | symbol : K | keyof T;
77
- type Key2<K, T> = T extends DefaultEventMap ? string | symbol : K & keyof T;
78
- type Listener<K, T, F> = T extends DefaultEventMap ? F : (
79
- K extends keyof T ? (
80
- T[K] extends unknown[] ? (...args: T[K]) => void : never
81
- )
82
- : never
83
- );
84
- type Listener1<K, T> = Listener<K, T, (...args: any[]) => void>;
85
- type Listener2<K, T> = Listener<K, T, Function>;
86
-
87
40
  /**
88
41
  * The `EventEmitter` class is defined and exposed by the `node:events` module:
89
42
  *
@@ -97,603 +50,202 @@ declare module "events" {
97
50
  * It supports the following option:
98
51
  * @since v0.1.26
99
52
  */
100
- class EventEmitter<T extends EventMap<T> = DefaultEventMap> {
53
+ class EventEmitter<T extends EventMap<T> = any> {
101
54
  constructor(options?: EventEmitterOptions);
102
-
103
- [EventEmitter.captureRejectionSymbol]?<K>(error: Error, event: Key<K, T>, ...args: Args<K, T>): void;
104
-
105
- /**
106
- * Creates a `Promise` that is fulfilled when the `EventEmitter` emits the given
107
- * event or that is rejected if the `EventEmitter` emits `'error'` while waiting.
108
- * The `Promise` will resolve with an array of all the arguments emitted to the
109
- * given event.
110
- *
111
- * This method is intentionally generic and works with the web platform [EventTarget](https://dom.spec.whatwg.org/#interface-eventtarget) interface, which has no special`'error'` event
112
- * semantics and does not listen to the `'error'` event.
113
- *
114
- * ```js
115
- * import { once, EventEmitter } from 'node:events';
116
- * import process from 'node:process';
117
- *
118
- * const ee = new EventEmitter();
119
- *
120
- * process.nextTick(() => {
121
- * ee.emit('myevent', 42);
122
- * });
123
- *
124
- * const [value] = await once(ee, 'myevent');
125
- * console.log(value);
126
- *
127
- * const err = new Error('kaboom');
128
- * process.nextTick(() => {
129
- * ee.emit('error', err);
130
- * });
131
- *
132
- * try {
133
- * await once(ee, 'myevent');
134
- * } catch (err) {
135
- * console.error('error happened', err);
136
- * }
137
- * ```
138
- *
139
- * The special handling of the `'error'` event is only used when `events.once()` is used to wait for another event. If `events.once()` is used to wait for the
140
- * '`error'` event itself, then it is treated as any other kind of event without
141
- * special handling:
142
- *
143
- * ```js
144
- * import { EventEmitter, once } from 'node:events';
145
- *
146
- * const ee = new EventEmitter();
147
- *
148
- * once(ee, 'error')
149
- * .then(([err]) => console.log('ok', err.message))
150
- * .catch((err) => console.error('error', err.message));
151
- *
152
- * ee.emit('error', new Error('boom'));
153
- *
154
- * // Prints: ok boom
155
- * ```
156
- *
157
- * An `AbortSignal` can be used to cancel waiting for the event:
158
- *
159
- * ```js
160
- * import { EventEmitter, once } from 'node:events';
161
- *
162
- * const ee = new EventEmitter();
163
- * const ac = new AbortController();
164
- *
165
- * async function foo(emitter, event, signal) {
166
- * try {
167
- * await once(emitter, event, { signal });
168
- * console.log('event emitted!');
169
- * } catch (error) {
170
- * if (error.name === 'AbortError') {
171
- * console.error('Waiting for the event was canceled!');
172
- * } else {
173
- * console.error('There was an error', error.message);
174
- * }
175
- * }
176
- * }
177
- *
178
- * foo(ee, 'foo', ac.signal);
179
- * ac.abort(); // Abort waiting for the event
180
- * ee.emit('foo'); // Prints: Waiting for the event was canceled!
181
- * ```
182
- * @since v11.13.0, v10.16.0
183
- */
184
- static once(
185
- emitter: NodeJS.EventEmitter,
186
- eventName: string | symbol,
187
- options?: StaticEventEmitterOptions,
188
- ): Promise<any[]>;
189
- static once(emitter: EventTarget, eventName: string, options?: StaticEventEmitterOptions): Promise<any[]>;
190
- /**
191
- * ```js
192
- * import { on, EventEmitter } from 'node:events';
193
- * import process from 'node:process';
194
- *
195
- * const ee = new EventEmitter();
196
- *
197
- * // Emit later on
198
- * process.nextTick(() => {
199
- * ee.emit('foo', 'bar');
200
- * ee.emit('foo', 42);
201
- * });
202
- *
203
- * for await (const event of on(ee, 'foo')) {
204
- * // The execution of this inner block is synchronous and it
205
- * // processes one event at a time (even with await). Do not use
206
- * // if concurrent execution is required.
207
- * console.log(event); // prints ['bar'] [42]
208
- * }
209
- * // Unreachable here
210
- * ```
211
- *
212
- * Returns an `AsyncIterator` that iterates `eventName` events. It will throw
213
- * if the `EventEmitter` emits `'error'`. It removes all listeners when
214
- * exiting the loop. The `value` returned by each iteration is an array
215
- * composed of the emitted event arguments.
216
- *
217
- * An `AbortSignal` can be used to cancel waiting on events:
218
- *
219
- * ```js
220
- * import { on, EventEmitter } from 'node:events';
221
- * import process from 'node:process';
222
- *
223
- * const ac = new AbortController();
224
- *
225
- * (async () => {
226
- * const ee = new EventEmitter();
227
- *
228
- * // Emit later on
229
- * process.nextTick(() => {
230
- * ee.emit('foo', 'bar');
231
- * ee.emit('foo', 42);
232
- * });
233
- *
234
- * for await (const event of on(ee, 'foo', { signal: ac.signal })) {
235
- * // The execution of this inner block is synchronous and it
236
- * // processes one event at a time (even with await). Do not use
237
- * // if concurrent execution is required.
238
- * console.log(event); // prints ['bar'] [42]
239
- * }
240
- * // Unreachable here
241
- * })();
242
- *
243
- * process.nextTick(() => ac.abort());
244
- * ```
245
- *
246
- * Use the `close` option to specify an array of event names that will end the iteration:
247
- *
248
- * ```js
249
- * import { on, EventEmitter } from 'node:events';
250
- * import process from 'node:process';
251
- *
252
- * const ee = new EventEmitter();
253
- *
254
- * // Emit later on
255
- * process.nextTick(() => {
256
- * ee.emit('foo', 'bar');
257
- * ee.emit('foo', 42);
258
- * ee.emit('close');
259
- * });
260
- *
261
- * for await (const event of on(ee, 'foo', { close: ['close'] })) {
262
- * console.log(event); // prints ['bar'] [42]
263
- * }
264
- * // the loop will exit after 'close' is emitted
265
- * console.log('done'); // prints 'done'
266
- * ```
267
- * @since v13.6.0, v12.16.0
268
- * @return An `AsyncIterator` that iterates `eventName` events emitted by the `emitter`
269
- */
270
- static on(
271
- emitter: NodeJS.EventEmitter,
272
- eventName: string | symbol,
273
- options?: StaticEventEmitterIteratorOptions,
274
- ): NodeJS.AsyncIterator<any[]>;
275
- static on(
276
- emitter: EventTarget,
277
- eventName: string,
278
- options?: StaticEventEmitterIteratorOptions,
279
- ): NodeJS.AsyncIterator<any[]>;
280
- /**
281
- * A class method that returns the number of listeners for the given `eventName` registered on the given `emitter`.
282
- *
283
- * ```js
284
- * import { EventEmitter, listenerCount } from 'node:events';
285
- *
286
- * const myEmitter = new EventEmitter();
287
- * myEmitter.on('event', () => {});
288
- * myEmitter.on('event', () => {});
289
- * console.log(listenerCount(myEmitter, 'event'));
290
- * // Prints: 2
291
- * ```
292
- * @since v0.9.12
293
- * @deprecated Since v3.2.0 - Use `listenerCount` instead.
294
- * @param emitter The emitter to query
295
- * @param eventName The event name
296
- */
297
- static listenerCount(emitter: NodeJS.EventEmitter, eventName: string | symbol): number;
298
- /**
299
- * Returns a copy of the array of listeners for the event named `eventName`.
300
- *
301
- * For `EventEmitter`s this behaves exactly the same as calling `.listeners` on
302
- * the emitter.
303
- *
304
- * For `EventTarget`s this is the only way to get the event listeners for the
305
- * event target. This is useful for debugging and diagnostic purposes.
306
- *
307
- * ```js
308
- * import { getEventListeners, EventEmitter } from 'node:events';
309
- *
310
- * {
311
- * const ee = new EventEmitter();
312
- * const listener = () => console.log('Events are fun');
313
- * ee.on('foo', listener);
314
- * console.log(getEventListeners(ee, 'foo')); // [ [Function: listener] ]
315
- * }
316
- * {
317
- * const et = new EventTarget();
318
- * const listener = () => console.log('Events are fun');
319
- * et.addEventListener('foo', listener);
320
- * console.log(getEventListeners(et, 'foo')); // [ [Function: listener] ]
321
- * }
322
- * ```
323
- * @since v15.2.0, v14.17.0
324
- */
325
- static getEventListeners(emitter: EventTarget | NodeJS.EventEmitter, name: string | symbol): Function[];
326
- /**
327
- * Returns the currently set max amount of listeners.
328
- *
329
- * For `EventEmitter`s this behaves exactly the same as calling `.getMaxListeners` on
330
- * the emitter.
331
- *
332
- * For `EventTarget`s this is the only way to get the max event listeners for the
333
- * event target. If the number of event handlers on a single EventTarget exceeds
334
- * the max set, the EventTarget will print a warning.
335
- *
336
- * ```js
337
- * import { getMaxListeners, setMaxListeners, EventEmitter } from 'node:events';
338
- *
339
- * {
340
- * const ee = new EventEmitter();
341
- * console.log(getMaxListeners(ee)); // 10
342
- * setMaxListeners(11, ee);
343
- * console.log(getMaxListeners(ee)); // 11
344
- * }
345
- * {
346
- * const et = new EventTarget();
347
- * console.log(getMaxListeners(et)); // 10
348
- * setMaxListeners(11, et);
349
- * console.log(getMaxListeners(et)); // 11
350
- * }
351
- * ```
352
- * @since v19.9.0
353
- */
354
- static getMaxListeners(emitter: EventTarget | NodeJS.EventEmitter): number;
355
- /**
356
- * ```js
357
- * import { setMaxListeners, EventEmitter } from 'node:events';
358
- *
359
- * const target = new EventTarget();
360
- * const emitter = new EventEmitter();
361
- *
362
- * setMaxListeners(5, target, emitter);
363
- * ```
364
- * @since v15.4.0
365
- * @param n A non-negative number. The maximum number of listeners per `EventTarget` event.
366
- * @param eventTargets Zero or more {EventTarget} or {EventEmitter} instances. If none are specified, `n` is set as the default max for all newly created {EventTarget} and {EventEmitter}
367
- * objects.
368
- */
369
- static setMaxListeners(n?: number, ...eventTargets: Array<EventTarget | NodeJS.EventEmitter>): void;
370
- /**
371
- * Listens once to the `abort` event on the provided `signal`.
372
- *
373
- * Listening to the `abort` event on abort signals is unsafe and may
374
- * lead to resource leaks since another third party with the signal can
375
- * call `e.stopImmediatePropagation()`. Unfortunately Node.js cannot change
376
- * this since it would violate the web standard. Additionally, the original
377
- * API makes it easy to forget to remove listeners.
378
- *
379
- * This API allows safely using `AbortSignal`s in Node.js APIs by solving these
380
- * two issues by listening to the event such that `stopImmediatePropagation` does
381
- * not prevent the listener from running.
382
- *
383
- * Returns a disposable so that it may be unsubscribed from more easily.
384
- *
385
- * ```js
386
- * import { addAbortListener } from 'node:events';
387
- *
388
- * function example(signal) {
389
- * let disposable;
390
- * try {
391
- * signal.addEventListener('abort', (e) => e.stopImmediatePropagation());
392
- * disposable = addAbortListener(signal, (e) => {
393
- * // Do something when signal is aborted.
394
- * });
395
- * } finally {
396
- * disposable?.[Symbol.dispose]();
397
- * }
398
- * }
399
- * ```
400
- * @since v20.5.0
401
- * @return Disposable that removes the `abort` listener.
402
- */
403
- static addAbortListener(signal: AbortSignal, resource: (event: Event) => void): Disposable;
404
- /**
405
- * This symbol shall be used to install a listener for only monitoring `'error'` events. Listeners installed using this symbol are called before the regular `'error'` listeners are called.
406
- *
407
- * Installing a listener using this symbol does not change the behavior once an `'error'` event is emitted. Therefore, the process will still crash if no
408
- * regular `'error'` listener is installed.
409
- * @since v13.6.0, v12.17.0
410
- */
411
- static readonly errorMonitor: unique symbol;
412
- /**
413
- * Value: `Symbol.for('nodejs.rejection')`
414
- *
415
- * See how to write a custom `rejection handler`.
416
- * @since v13.4.0, v12.16.0
417
- */
418
- static readonly captureRejectionSymbol: unique symbol;
419
- /**
420
- * Value: [boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type)
421
- *
422
- * Change the default `captureRejections` option on all new `EventEmitter` objects.
423
- * @since v13.4.0, v12.16.0
424
- */
425
- static captureRejections: boolean;
426
- /**
427
- * By default, a maximum of `10` listeners can be registered for any single
428
- * event. This limit can be changed for individual `EventEmitter` instances
429
- * using the `emitter.setMaxListeners(n)` method. To change the default
430
- * for _all_`EventEmitter` instances, the `events.defaultMaxListeners` property
431
- * can be used. If this value is not a positive number, a `RangeError` is thrown.
432
- *
433
- * Take caution when setting the `events.defaultMaxListeners` because the
434
- * change affects _all_ `EventEmitter` instances, including those created before
435
- * the change is made. However, calling `emitter.setMaxListeners(n)` still has
436
- * precedence over `events.defaultMaxListeners`.
437
- *
438
- * This is not a hard limit. The `EventEmitter` instance will allow
439
- * more listeners to be added but will output a trace warning to stderr indicating
440
- * that a "possible EventEmitter memory leak" has been detected. For any single
441
- * `EventEmitter`, the `emitter.getMaxListeners()` and `emitter.setMaxListeners()` methods can be used to
442
- * temporarily avoid this warning:
443
- *
444
- * ```js
445
- * import { EventEmitter } from 'node:events';
446
- * const emitter = new EventEmitter();
447
- * emitter.setMaxListeners(emitter.getMaxListeners() + 1);
448
- * emitter.once('event', () => {
449
- * // do stuff
450
- * emitter.setMaxListeners(Math.max(emitter.getMaxListeners() - 1, 0));
451
- * });
452
- * ```
453
- *
454
- * The `--trace-warnings` command-line flag can be used to display the
455
- * stack trace for such warnings.
456
- *
457
- * The emitted warning can be inspected with `process.on('warning')` and will
458
- * have the additional `emitter`, `type`, and `count` properties, referring to
459
- * the event emitter instance, the event's name and the number of attached
460
- * listeners, respectively.
461
- * Its `name` property is set to `'MaxListenersExceededWarning'`.
462
- * @since v0.11.2
463
- */
464
- static defaultMaxListeners: number;
465
- }
466
- import internal = require("node:events");
467
- namespace EventEmitter {
468
- // Should just be `export { EventEmitter }`, but that doesn't work in TypeScript 3.4
469
- export { internal as EventEmitter };
470
- export interface Abortable {
471
- /**
472
- * When provided the corresponding `AbortController` can be used to cancel an asynchronous action.
473
- */
474
- signal?: AbortSignal | undefined;
475
- }
476
-
477
- export interface EventEmitterReferencingAsyncResource extends AsyncResource {
478
- readonly eventEmitter: EventEmitterAsyncResource;
479
- }
480
-
481
- export interface EventEmitterAsyncResourceOptions extends AsyncResourceOptions, EventEmitterOptions {
482
- /**
483
- * The type of async event, this is required when instantiating `EventEmitterAsyncResource`
484
- * directly rather than as a child class.
485
- * @default new.target.name if instantiated as a child class.
486
- */
487
- name?: string | undefined;
488
- }
489
-
490
- /**
491
- * Integrates `EventEmitter` with `AsyncResource` for `EventEmitter`s that
492
- * require manual async tracking. Specifically, all events emitted by instances
493
- * of `events.EventEmitterAsyncResource` will run within its `async context`.
494
- *
495
- * ```js
496
- * import { EventEmitterAsyncResource, EventEmitter } from 'node:events';
497
- * import { notStrictEqual, strictEqual } from 'node:assert';
498
- * import { executionAsyncId, triggerAsyncId } from 'node:async_hooks';
499
- *
500
- * // Async tracking tooling will identify this as 'Q'.
501
- * const ee1 = new EventEmitterAsyncResource({ name: 'Q' });
502
- *
503
- * // 'foo' listeners will run in the EventEmitters async context.
504
- * ee1.on('foo', () => {
505
- * strictEqual(executionAsyncId(), ee1.asyncId);
506
- * strictEqual(triggerAsyncId(), ee1.triggerAsyncId);
507
- * });
508
- *
509
- * const ee2 = new EventEmitter();
510
- *
511
- * // 'foo' listeners on ordinary EventEmitters that do not track async
512
- * // context, however, run in the same async context as the emit().
513
- * ee2.on('foo', () => {
514
- * notStrictEqual(executionAsyncId(), ee2.asyncId);
515
- * notStrictEqual(triggerAsyncId(), ee2.triggerAsyncId);
516
- * });
517
- *
518
- * Promise.resolve().then(() => {
519
- * ee1.emit('foo');
520
- * ee2.emit('foo');
521
- * });
522
- * ```
523
- *
524
- * The `EventEmitterAsyncResource` class has the same methods and takes the
525
- * same options as `EventEmitter` and `AsyncResource` themselves.
526
- * @since v17.4.0, v16.14.0
527
- */
528
- export class EventEmitterAsyncResource extends EventEmitter {
529
- /**
530
- * @param options Only optional in child class.
531
- */
532
- constructor(options?: EventEmitterAsyncResourceOptions);
533
- /**
534
- * Call all `destroy` hooks. This should only ever be called once. An error will
535
- * be thrown if it is called more than once. This **must** be manually called. If
536
- * the resource is left to be collected by the GC then the `destroy` hooks will
537
- * never be called.
538
- */
539
- emitDestroy(): void;
540
- /**
541
- * The unique `asyncId` assigned to the resource.
542
- */
543
- readonly asyncId: number;
544
- /**
545
- * The same triggerAsyncId that is passed to the AsyncResource constructor.
546
- */
547
- readonly triggerAsyncId: number;
548
- /**
549
- * The returned `AsyncResource` object has an additional `eventEmitter` property
550
- * that provides a reference to this `EventEmitterAsyncResource`.
551
- */
552
- readonly asyncResource: EventEmitterReferencingAsyncResource;
553
- }
554
- /**
555
- * The `NodeEventTarget` is a Node.js-specific extension to `EventTarget`
556
- * that emulates a subset of the `EventEmitter` API.
557
- * @since v14.5.0
558
- */
559
- export interface NodeEventTarget extends EventTarget {
560
- /**
561
- * Node.js-specific extension to the `EventTarget` class that emulates the
562
- * equivalent `EventEmitter` API. The only difference between `addListener()` and
563
- * `addEventListener()` is that `addListener()` will return a reference to the
564
- * `EventTarget`.
565
- * @since v14.5.0
566
- */
567
- addListener(type: string, listener: (arg: any) => void): this;
568
- /**
569
- * Node.js-specific extension to the `EventTarget` class that dispatches the
570
- * `arg` to the list of handlers for `type`.
571
- * @since v15.2.0
572
- * @returns `true` if event listeners registered for the `type` exist,
573
- * otherwise `false`.
574
- */
575
- emit(type: string, arg: any): boolean;
576
- /**
577
- * Node.js-specific extension to the `EventTarget` class that returns an array
578
- * of event `type` names for which event listeners are registered.
579
- * @since 14.5.0
580
- */
581
- eventNames(): string[];
582
- /**
583
- * Node.js-specific extension to the `EventTarget` class that returns the number
584
- * of event listeners registered for the `type`.
585
- * @since v14.5.0
586
- */
587
- listenerCount(type: string): number;
588
- /**
589
- * Node.js-specific extension to the `EventTarget` class that sets the number
590
- * of max event listeners as `n`.
591
- * @since v14.5.0
592
- */
593
- setMaxListeners(n: number): void;
594
- /**
595
- * Node.js-specific extension to the `EventTarget` class that returns the number
596
- * of max event listeners.
597
- * @since v14.5.0
598
- */
599
- getMaxListeners(): number;
600
- /**
601
- * Node.js-specific alias for `eventTarget.removeEventListener()`.
602
- * @since v14.5.0
603
- */
604
- off(type: string, listener: (arg: any) => void, options?: EventListenerOptions): this;
605
- /**
606
- * Node.js-specific alias for `eventTarget.addEventListener()`.
607
- * @since v14.5.0
608
- */
609
- on(type: string, listener: (arg: any) => void): this;
610
- /**
611
- * Node.js-specific extension to the `EventTarget` class that adds a `once`
612
- * listener for the given event `type`. This is equivalent to calling `on`
613
- * with the `once` option set to `true`.
614
- * @since v14.5.0
615
- */
616
- once(type: string, listener: (arg: any) => void): this;
617
- /**
618
- * Node.js-specific extension to the `EventTarget` class. If `type` is specified,
619
- * removes all registered listeners for `type`, otherwise removes all registered
620
- * listeners.
621
- * @since v14.5.0
622
- */
623
- removeAllListeners(type?: string): this;
624
- /**
625
- * Node.js-specific extension to the `EventTarget` class that removes the
626
- * `listener` for the given `type`. The only difference between `removeListener()`
627
- * and `removeEventListener()` is that `removeListener()` will return a reference
628
- * to the `EventTarget`.
629
- * @since v14.5.0
630
- */
631
- removeListener(type: string, listener: (arg: any) => void, options?: EventListenerOptions): this;
632
- }
633
55
  }
56
+ interface EventEmitter<T extends EventMap<T> = any> extends NodeJS.EventEmitter<T> {}
634
57
  global {
635
58
  namespace NodeJS {
636
- interface EventEmitter<T extends EventMap<T> = DefaultEventMap> {
637
- [EventEmitter.captureRejectionSymbol]?<K>(error: Error, event: Key<K, T>, ...args: Args<K, T>): void;
638
- /**
639
- * Alias for `emitter.on(eventName, listener)`.
640
- * @since v0.1.26
641
- */
642
- addListener<K>(eventName: Key<K, T>, listener: Listener1<K, T>): this;
59
+ interface EventEmitter<T extends EventMap<T> = any> {
643
60
  /**
644
- * Adds the `listener` function to the end of the listeners array for the event
645
- * named `eventName`. No checks are made to see if the `listener` has already
646
- * been added. Multiple calls passing the same combination of `eventName` and
647
- * `listener` will result in the `listener` being added, and called, multiple times.
61
+ * The `Symbol.for('nodejs.rejection')` method is called in case a
62
+ * promise rejection happens when emitting an event and
63
+ * `captureRejections` is enabled on the emitter.
64
+ * It is possible to use `events.captureRejectionSymbol` in
65
+ * place of `Symbol.for('nodejs.rejection')`.
648
66
  *
649
67
  * ```js
650
- * server.on('connection', (stream) => {
651
- * console.log('someone connected!');
652
- * });
653
- * ```
68
+ * import { EventEmitter, captureRejectionSymbol } from 'node:events';
654
69
  *
655
- * Returns a reference to the `EventEmitter`, so that calls can be chained.
70
+ * class MyClass extends EventEmitter {
71
+ * constructor() {
72
+ * super({ captureRejections: true });
73
+ * }
656
74
  *
657
- * By default, event listeners are invoked in the order they are added. The `emitter.prependListener()` method can be used as an alternative to add the
658
- * event listener to the beginning of the listeners array.
75
+ * [captureRejectionSymbol](err, event, ...args) {
76
+ * console.log('rejection happened for', event, 'with', err, ...args);
77
+ * this.destroy(err);
78
+ * }
659
79
  *
660
- * ```js
661
- * import { EventEmitter } from 'node:events';
662
- * const myEE = new EventEmitter();
663
- * myEE.on('foo', () => console.log('a'));
664
- * myEE.prependListener('foo', () => console.log('b'));
665
- * myEE.emit('foo');
666
- * // Prints:
667
- * // b
668
- * // a
80
+ * destroy(err) {
81
+ * // Tear the resource down here.
82
+ * }
83
+ * }
669
84
  * ```
670
- * @since v0.1.101
671
- * @param eventName The name of the event.
672
- * @param listener The callback function
85
+ * @since v13.4.0, v12.16.0
673
86
  */
674
- on<K>(eventName: Key<K, T>, listener: Listener1<K, T>): this;
87
+ [EventEmitter.captureRejectionSymbol]?(error: Error, event: string | symbol, ...args: any[]): void;
675
88
  /**
676
- * Adds a **one-time** `listener` function for the event named `eventName`. The
677
- * next time `eventName` is triggered, this listener is removed and then invoked.
678
- *
679
- * ```js
680
- * server.once('connection', (stream) => {
681
- * console.log('Ah, we have our first user!');
682
- * });
683
- * ```
684
- *
685
- * Returns a reference to the `EventEmitter`, so that calls can be chained.
89
+ * Alias for `emitter.on(eventName, listener)`.
90
+ * @since v0.1.26
91
+ */
92
+ addListener<E extends string | symbol>(eventName: EventNames<T, E>, listener: Listener<T, E>): this;
93
+ /**
94
+ * Synchronously calls each of the listeners registered for the event named
95
+ * `eventName`, in the order they were registered, passing the supplied arguments
96
+ * to each.
686
97
  *
687
- * By default, event listeners are invoked in the order they are added. The `emitter.prependOnceListener()` method can be used as an alternative to add the
688
- * event listener to the beginning of the listeners array.
98
+ * Returns `true` if the event had listeners, `false` otherwise.
689
99
  *
690
100
  * ```js
691
101
  * import { EventEmitter } from 'node:events';
692
- * const myEE = new EventEmitter();
693
- * myEE.once('foo', () => console.log('a'));
694
- * myEE.prependOnceListener('foo', () => console.log('b'));
695
- * myEE.emit('foo');
696
- * // Prints:
102
+ * const myEmitter = new EventEmitter();
103
+ *
104
+ * // First listener
105
+ * myEmitter.on('event', function firstListener() {
106
+ * console.log('Helloooo! first listener');
107
+ * });
108
+ * // Second listener
109
+ * myEmitter.on('event', function secondListener(arg1, arg2) {
110
+ * console.log(`event with parameters ${arg1}, ${arg2} in second listener`);
111
+ * });
112
+ * // Third listener
113
+ * myEmitter.on('event', function thirdListener(...args) {
114
+ * const parameters = args.join(', ');
115
+ * console.log(`event with parameters ${parameters} in third listener`);
116
+ * });
117
+ *
118
+ * console.log(myEmitter.listeners('event'));
119
+ *
120
+ * myEmitter.emit('event', 1, 2, 3, 4, 5);
121
+ *
122
+ * // Prints:
123
+ * // [
124
+ * // [Function: firstListener],
125
+ * // [Function: secondListener],
126
+ * // [Function: thirdListener]
127
+ * // ]
128
+ * // Helloooo! first listener
129
+ * // event with parameters 1, 2 in second listener
130
+ * // event with parameters 1, 2, 3, 4, 5 in third listener
131
+ * ```
132
+ * @since v0.1.26
133
+ */
134
+ emit<E extends string | symbol>(eventName: EventNames<T, E>, ...args: Args<T, E>): boolean;
135
+ /**
136
+ * Returns an array listing the events for which the emitter has registered
137
+ * listeners.
138
+ *
139
+ * ```js
140
+ * import { EventEmitter } from 'node:events';
141
+ *
142
+ * const myEE = new EventEmitter();
143
+ * myEE.on('foo', () => {});
144
+ * myEE.on('bar', () => {});
145
+ *
146
+ * const sym = Symbol('symbol');
147
+ * myEE.on(sym, () => {});
148
+ *
149
+ * console.log(myEE.eventNames());
150
+ * // Prints: [ 'foo', 'bar', Symbol(symbol) ]
151
+ * ```
152
+ * @since v6.0.0
153
+ */
154
+ eventNames(): (string | symbol)[];
155
+ /**
156
+ * Returns the current max listener value for the `EventEmitter` which is either
157
+ * set by `emitter.setMaxListeners(n)` or defaults to
158
+ * `events.defaultMaxListeners`.
159
+ * @since v1.0.0
160
+ */
161
+ getMaxListeners(): number;
162
+ /**
163
+ * Returns the number of listeners listening for the event named `eventName`.
164
+ * If `listener` is provided, it will return how many times the listener is found
165
+ * in the list of the listeners of the event.
166
+ * @since v3.2.0
167
+ * @param eventName The name of the event being listened for
168
+ * @param listener The event handler function
169
+ */
170
+ listenerCount<E extends string | symbol>(
171
+ eventName: EventNames<T, E>,
172
+ listener?: Listener<T, E>,
173
+ ): number;
174
+ /**
175
+ * Returns a copy of the array of listeners for the event named `eventName`.
176
+ *
177
+ * ```js
178
+ * server.on('connection', (stream) => {
179
+ * console.log('someone connected!');
180
+ * });
181
+ * console.log(util.inspect(server.listeners('connection')));
182
+ * // Prints: [ [Function] ]
183
+ * ```
184
+ * @since v0.1.26
185
+ */
186
+ listeners<E extends string | symbol>(eventName: EventNames<T, E>): Listener<T, E>[];
187
+ /**
188
+ * Alias for `emitter.removeListener()`.
189
+ * @since v10.0.0
190
+ */
191
+ off<E extends string | symbol>(eventName: EventNames<T, E>, listener: Listener<T, E>): this;
192
+ /**
193
+ * Adds the `listener` function to the end of the listeners array for the
194
+ * event named `eventName`. No checks are made to see if the `listener` has
195
+ * already been added. Multiple calls passing the same combination of `eventName`
196
+ * and `listener` will result in the `listener` being added, and called, multiple
197
+ * times.
198
+ *
199
+ * ```js
200
+ * server.on('connection', (stream) => {
201
+ * console.log('someone connected!');
202
+ * });
203
+ * ```
204
+ *
205
+ * Returns a reference to the `EventEmitter`, so that calls can be chained.
206
+ *
207
+ * By default, event listeners are invoked in the order they are added. The
208
+ * `emitter.prependListener()` method can be used as an alternative to add the
209
+ * event listener to the beginning of the listeners array.
210
+ *
211
+ * ```js
212
+ * import { EventEmitter } from 'node:events';
213
+ * const myEE = new EventEmitter();
214
+ * myEE.on('foo', () => console.log('a'));
215
+ * myEE.prependListener('foo', () => console.log('b'));
216
+ * myEE.emit('foo');
217
+ * // Prints:
218
+ * // b
219
+ * // a
220
+ * ```
221
+ * @since v0.1.101
222
+ * @param eventName The name of the event.
223
+ * @param listener The callback function
224
+ */
225
+ on<E extends string | symbol>(eventName: EventNames<T, E>, listener: Listener<T, E>): this;
226
+ /**
227
+ * Adds a **one-time** `listener` function for the event named `eventName`. The
228
+ * next time `eventName` is triggered, this listener is removed and then invoked.
229
+ *
230
+ * ```js
231
+ * server.once('connection', (stream) => {
232
+ * console.log('Ah, we have our first user!');
233
+ * });
234
+ * ```
235
+ *
236
+ * Returns a reference to the `EventEmitter`, so that calls can be chained.
237
+ *
238
+ * By default, event listeners are invoked in the order they are added. The
239
+ * `emitter.prependOnceListener()` method can be used as an alternative to add the
240
+ * event listener to the beginning of the listeners array.
241
+ *
242
+ * ```js
243
+ * import { EventEmitter } from 'node:events';
244
+ * const myEE = new EventEmitter();
245
+ * myEE.once('foo', () => console.log('a'));
246
+ * myEE.prependOnceListener('foo', () => console.log('b'));
247
+ * myEE.emit('foo');
248
+ * // Prints:
697
249
  * // b
698
250
  * // a
699
251
  * ```
@@ -701,9 +253,92 @@ declare module "events" {
701
253
  * @param eventName The name of the event.
702
254
  * @param listener The callback function
703
255
  */
704
- once<K>(eventName: Key<K, T>, listener: Listener1<K, T>): this;
256
+ once<E extends string | symbol>(eventName: EventNames<T, E>, listener: Listener<T, E>): this;
705
257
  /**
706
- * Removes the specified `listener` from the listener array for the event named `eventName`.
258
+ * Adds the `listener` function to the _beginning_ of the listeners array for the
259
+ * event named `eventName`. No checks are made to see if the `listener` has
260
+ * already been added. Multiple calls passing the same combination of `eventName`
261
+ * and `listener` will result in the `listener` being added, and called, multiple
262
+ * times.
263
+ *
264
+ * ```js
265
+ * server.prependListener('connection', (stream) => {
266
+ * console.log('someone connected!');
267
+ * });
268
+ * ```
269
+ *
270
+ * Returns a reference to the `EventEmitter`, so that calls can be chained.
271
+ * @since v6.0.0
272
+ * @param eventName The name of the event.
273
+ * @param listener The callback function
274
+ */
275
+ prependListener<E extends string | symbol>(eventName: EventNames<T, E>, listener: Listener<T, E>): this;
276
+ /**
277
+ * Adds a **one-time** `listener` function for the event named `eventName` to the
278
+ * _beginning_ of the listeners array. The next time `eventName` is triggered, this
279
+ * listener is removed, and then invoked.
280
+ *
281
+ * ```js
282
+ * server.prependOnceListener('connection', (stream) => {
283
+ * console.log('Ah, we have our first user!');
284
+ * });
285
+ * ```
286
+ *
287
+ * Returns a reference to the `EventEmitter`, so that calls can be chained.
288
+ * @since v6.0.0
289
+ * @param eventName The name of the event.
290
+ * @param listener The callback function
291
+ */
292
+ prependOnceListener<E extends string | symbol>(
293
+ eventName: EventNames<T, E>,
294
+ listener: Listener<T, E>,
295
+ ): this;
296
+ /**
297
+ * Returns a copy of the array of listeners for the event named `eventName`,
298
+ * including any wrappers (such as those created by `.once()`).
299
+ *
300
+ * ```js
301
+ * import { EventEmitter } from 'node:events';
302
+ * const emitter = new EventEmitter();
303
+ * emitter.once('log', () => console.log('log once'));
304
+ *
305
+ * // Returns a new Array with a function `onceWrapper` which has a property
306
+ * // `listener` which contains the original listener bound above
307
+ * const listeners = emitter.rawListeners('log');
308
+ * const logFnWrapper = listeners[0];
309
+ *
310
+ * // Logs "log once" to the console and does not unbind the `once` event
311
+ * logFnWrapper.listener();
312
+ *
313
+ * // Logs "log once" to the console and removes the listener
314
+ * logFnWrapper();
315
+ *
316
+ * emitter.on('log', () => console.log('log persistently'));
317
+ * // Will return a new Array with a single function bound by `.on()` above
318
+ * const newListeners = emitter.rawListeners('log');
319
+ *
320
+ * // Logs "log persistently" twice
321
+ * newListeners[0]();
322
+ * emitter.emit('log');
323
+ * ```
324
+ * @since v9.4.0
325
+ */
326
+ rawListeners<E extends string | symbol>(eventName: EventNames<T, E>): Listener<T, E>[];
327
+ /**
328
+ * Removes all listeners, or those of the specified `eventName`.
329
+ *
330
+ * It is bad practice to remove listeners added elsewhere in the code,
331
+ * particularly when the `EventEmitter` instance was created by some other
332
+ * component or module (e.g. sockets or file streams).
333
+ *
334
+ * Returns a reference to the `EventEmitter`, so that calls can be chained.
335
+ * @since v0.1.26
336
+ */
337
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
338
+ removeAllListeners<E extends string | symbol>(eventName?: EventNames<T, E>): this;
339
+ /**
340
+ * Removes the specified `listener` from the listener array for the event named
341
+ * `eventName`.
707
342
  *
708
343
  * ```js
709
344
  * const callback = (stream) => {
@@ -720,8 +355,10 @@ declare module "events" {
720
355
  * called multiple times to remove each instance.
721
356
  *
722
357
  * Once an event is emitted, all listeners attached to it at the
723
- * time of emitting are called in order. This implies that any `removeListener()` or `removeAllListeners()` calls _after_ emitting and _before_ the last listener finishes execution
724
- * will not remove them from`emit()` in progress. Subsequent events behave as expected.
358
+ * time of emitting are called in order. This implies that any
359
+ * `removeListener()` or `removeAllListeners()` calls _after_ emitting and
360
+ * _before_ the last listener finishes execution will not remove them from
361
+ * `emit()` in progress. Subsequent events behave as expected.
725
362
  *
726
363
  * ```js
727
364
  * import { EventEmitter } from 'node:events';
@@ -756,14 +393,15 @@ declare module "events" {
756
393
  * ```
757
394
  *
758
395
  * Because listeners are managed using an internal array, calling this will
759
- * change the position indices of any listener registered _after_ the listener
396
+ * change the position indexes of any listener registered _after_ the listener
760
397
  * being removed. This will not impact the order in which listeners are called,
761
398
  * but it means that any copies of the listener array as returned by
762
399
  * the `emitter.listeners()` method will need to be recreated.
763
400
  *
764
401
  * When a single function has been added as a handler multiple times for a single
765
402
  * event (as in the example below), `removeListener()` will remove the most
766
- * recently added instance. In the example the `once('ping')` listener is removed:
403
+ * recently added instance. In the example the `once('ping')`
404
+ * listener is removed:
767
405
  *
768
406
  * ```js
769
407
  * import { EventEmitter } from 'node:events';
@@ -784,193 +422,587 @@ declare module "events" {
784
422
  * Returns a reference to the `EventEmitter`, so that calls can be chained.
785
423
  * @since v0.1.26
786
424
  */
787
- removeListener<K>(eventName: Key<K, T>, listener: Listener1<K, T>): this;
788
- /**
789
- * Alias for `emitter.removeListener()`.
790
- * @since v10.0.0
791
- */
792
- off<K>(eventName: Key<K, T>, listener: Listener1<K, T>): this;
793
- /**
794
- * Removes all listeners, or those of the specified `eventName`.
795
- *
796
- * It is bad practice to remove listeners added elsewhere in the code,
797
- * particularly when the `EventEmitter` instance was created by some other
798
- * component or module (e.g. sockets or file streams).
799
- *
800
- * Returns a reference to the `EventEmitter`, so that calls can be chained.
801
- * @since v0.1.26
802
- */
803
- removeAllListeners(eventName?: Key<unknown, T>): this;
425
+ removeListener<E extends string | symbol>(eventName: EventNames<T, E>, listener: Listener<T, E>): this;
804
426
  /**
805
427
  * By default `EventEmitter`s will print a warning if more than `10` listeners are
806
428
  * added for a particular event. This is a useful default that helps finding
807
429
  * memory leaks. The `emitter.setMaxListeners()` method allows the limit to be
808
- * modified for this specific `EventEmitter` instance. The value can be set to `Infinity` (or `0`) to indicate an unlimited number of listeners.
430
+ * modified for this specific `EventEmitter` instance. The value can be set to
431
+ * `Infinity` (or `0`) to indicate an unlimited number of listeners.
809
432
  *
810
433
  * Returns a reference to the `EventEmitter`, so that calls can be chained.
811
434
  * @since v0.3.5
812
435
  */
813
436
  setMaxListeners(n: number): this;
814
- /**
815
- * Returns the current max listener value for the `EventEmitter` which is either
816
- * set by `emitter.setMaxListeners(n)` or defaults to {@link EventEmitter.defaultMaxListeners}.
817
- * @since v1.0.0
818
- */
819
- getMaxListeners(): number;
820
- /**
821
- * Returns a copy of the array of listeners for the event named `eventName`.
822
- *
823
- * ```js
824
- * server.on('connection', (stream) => {
825
- * console.log('someone connected!');
826
- * });
827
- * console.log(util.inspect(server.listeners('connection')));
828
- * // Prints: [ [Function] ]
829
- * ```
830
- * @since v0.1.26
831
- */
832
- listeners<K>(eventName: Key<K, T>): Array<Listener2<K, T>>;
833
- /**
834
- * Returns a copy of the array of listeners for the event named `eventName`,
835
- * including any wrappers (such as those created by `.once()`).
836
- *
837
- * ```js
838
- * import { EventEmitter } from 'node:events';
839
- * const emitter = new EventEmitter();
840
- * emitter.once('log', () => console.log('log once'));
841
- *
842
- * // Returns a new Array with a function `onceWrapper` which has a property
843
- * // `listener` which contains the original listener bound above
844
- * const listeners = emitter.rawListeners('log');
845
- * const logFnWrapper = listeners[0];
846
- *
847
- * // Logs "log once" to the console and does not unbind the `once` event
848
- * logFnWrapper.listener();
849
- *
850
- * // Logs "log once" to the console and removes the listener
851
- * logFnWrapper();
852
- *
853
- * emitter.on('log', () => console.log('log persistently'));
854
- * // Will return a new Array with a single function bound by `.on()` above
855
- * const newListeners = emitter.rawListeners('log');
856
- *
857
- * // Logs "log persistently" twice
858
- * newListeners[0]();
859
- * emitter.emit('log');
860
- * ```
861
- * @since v9.4.0
862
- */
863
- rawListeners<K>(eventName: Key<K, T>): Array<Listener2<K, T>>;
864
- /**
865
- * Synchronously calls each of the listeners registered for the event named `eventName`, in the order they were registered, passing the supplied arguments
866
- * to each.
867
- *
868
- * Returns `true` if the event had listeners, `false` otherwise.
869
- *
870
- * ```js
871
- * import { EventEmitter } from 'node:events';
872
- * const myEmitter = new EventEmitter();
873
- *
874
- * // First listener
875
- * myEmitter.on('event', function firstListener() {
876
- * console.log('Helloooo! first listener');
877
- * });
878
- * // Second listener
879
- * myEmitter.on('event', function secondListener(arg1, arg2) {
880
- * console.log(`event with parameters ${arg1}, ${arg2} in second listener`);
881
- * });
882
- * // Third listener
883
- * myEmitter.on('event', function thirdListener(...args) {
884
- * const parameters = args.join(', ');
885
- * console.log(`event with parameters ${parameters} in third listener`);
886
- * });
887
- *
888
- * console.log(myEmitter.listeners('event'));
889
- *
890
- * myEmitter.emit('event', 1, 2, 3, 4, 5);
891
- *
892
- * // Prints:
893
- * // [
894
- * // [Function: firstListener],
895
- * // [Function: secondListener],
896
- * // [Function: thirdListener]
897
- * // ]
898
- * // Helloooo! first listener
899
- * // event with parameters 1, 2 in second listener
900
- * // event with parameters 1, 2, 3, 4, 5 in third listener
901
- * ```
902
- * @since v0.1.26
903
- */
904
- emit<K>(eventName: Key<K, T>, ...args: Args<K, T>): boolean;
905
- /**
906
- * Returns the number of listeners listening for the event named `eventName`.
907
- * If `listener` is provided, it will return how many times the listener is found
908
- * in the list of the listeners of the event.
909
- * @since v3.2.0
910
- * @param eventName The name of the event being listened for
911
- * @param listener The event handler function
912
- */
913
- listenerCount<K>(eventName: Key<K, T>, listener?: Listener2<K, T>): number;
914
- /**
915
- * Adds the `listener` function to the _beginning_ of the listeners array for the
916
- * event named `eventName`. No checks are made to see if the `listener` has
917
- * already been added. Multiple calls passing the same combination of `eventName`
918
- * and `listener` will result in the `listener` being added, and called, multiple times.
919
- *
920
- * ```js
921
- * server.prependListener('connection', (stream) => {
922
- * console.log('someone connected!');
923
- * });
924
- * ```
925
- *
926
- * Returns a reference to the `EventEmitter`, so that calls can be chained.
927
- * @since v6.0.0
928
- * @param eventName The name of the event.
929
- * @param listener The callback function
930
- */
931
- prependListener<K>(eventName: Key<K, T>, listener: Listener1<K, T>): this;
932
- /**
933
- * Adds a **one-time**`listener` function for the event named `eventName` to the _beginning_ of the listeners array. The next time `eventName` is triggered, this
934
- * listener is removed, and then invoked.
935
- *
936
- * ```js
937
- * server.prependOnceListener('connection', (stream) => {
938
- * console.log('Ah, we have our first user!');
939
- * });
940
- * ```
941
- *
942
- * Returns a reference to the `EventEmitter`, so that calls can be chained.
943
- * @since v6.0.0
944
- * @param eventName The name of the event.
945
- * @param listener The callback function
946
- */
947
- prependOnceListener<K>(eventName: Key<K, T>, listener: Listener1<K, T>): this;
948
- /**
949
- * Returns an array listing the events for which the emitter has registered
950
- * listeners. The values in the array are strings or `Symbol`s.
951
- *
952
- * ```js
953
- * import { EventEmitter } from 'node:events';
954
- *
955
- * const myEE = new EventEmitter();
956
- * myEE.on('foo', () => {});
957
- * myEE.on('bar', () => {});
958
- *
959
- * const sym = Symbol('symbol');
960
- * myEE.on(sym, () => {});
961
- *
962
- * console.log(myEE.eventNames());
963
- * // Prints: [ 'foo', 'bar', Symbol(symbol) ]
964
- * ```
965
- * @since v6.0.0
966
- */
967
- eventNames(): Array<(string | symbol) & Key2<unknown, T>>;
968
437
  }
969
438
  }
970
439
  }
440
+ namespace EventEmitter {
441
+ export { EventEmitter, EventEmitterEventMap, EventEmitterOptions };
442
+ }
443
+ namespace EventEmitter {
444
+ interface Abortable {
445
+ signal?: AbortSignal | undefined;
446
+ }
447
+ /**
448
+ * See how to write a custom [rejection handler](https://nodejs.org/docs/latest-v25.x/api/events.html#emittersymbolfornodejsrejectionerr-eventname-args).
449
+ * @since v13.4.0, v12.16.0
450
+ */
451
+ const captureRejectionSymbol: unique symbol;
452
+ /**
453
+ * Change the default `captureRejections` option on all new `EventEmitter` objects.
454
+ * @since v13.4.0, v12.16.0
455
+ */
456
+ let captureRejections: boolean;
457
+ /**
458
+ * By default, a maximum of `10` listeners can be registered for any single
459
+ * event. This limit can be changed for individual `EventEmitter` instances
460
+ * using the `emitter.setMaxListeners(n)` method. To change the default
461
+ * for _all_ `EventEmitter` instances, the `events.defaultMaxListeners`
462
+ * property can be used. If this value is not a positive number, a `RangeError`
463
+ * is thrown.
464
+ *
465
+ * Take caution when setting the `events.defaultMaxListeners` because the
466
+ * change affects _all_ `EventEmitter` instances, including those created before
467
+ * the change is made. However, calling `emitter.setMaxListeners(n)` still has
468
+ * precedence over `events.defaultMaxListeners`.
469
+ *
470
+ * This is not a hard limit. The `EventEmitter` instance will allow
471
+ * more listeners to be added but will output a trace warning to stderr indicating
472
+ * that a "possible EventEmitter memory leak" has been detected. For any single
473
+ * `EventEmitter`, the `emitter.getMaxListeners()` and `emitter.setMaxListeners()`
474
+ * methods can be used to temporarily avoid this warning:
475
+ *
476
+ * `defaultMaxListeners` has no effect on `AbortSignal` instances. While it is
477
+ * still possible to use `emitter.setMaxListeners(n)` to set a warning limit
478
+ * for individual `AbortSignal` instances, per default `AbortSignal` instances will not warn.
479
+ *
480
+ * ```js
481
+ * import { EventEmitter } from 'node:events';
482
+ * const emitter = new EventEmitter();
483
+ * emitter.setMaxListeners(emitter.getMaxListeners() + 1);
484
+ * emitter.once('event', () => {
485
+ * // do stuff
486
+ * emitter.setMaxListeners(Math.max(emitter.getMaxListeners() - 1, 0));
487
+ * });
488
+ * ```
489
+ *
490
+ * The `--trace-warnings` command-line flag can be used to display the
491
+ * stack trace for such warnings.
492
+ *
493
+ * The emitted warning can be inspected with `process.on('warning')` and will
494
+ * have the additional `emitter`, `type`, and `count` properties, referring to
495
+ * the event emitter instance, the event's name and the number of attached
496
+ * listeners, respectively.
497
+ * Its `name` property is set to `'MaxListenersExceededWarning'`.
498
+ * @since v0.11.2
499
+ */
500
+ let defaultMaxListeners: number;
501
+ /**
502
+ * This symbol shall be used to install a listener for only monitoring `'error'`
503
+ * events. Listeners installed using this symbol are called before the regular
504
+ * `'error'` listeners are called.
505
+ *
506
+ * Installing a listener using this symbol does not change the behavior once an
507
+ * `'error'` event is emitted. Therefore, the process will still crash if no
508
+ * regular `'error'` listener is installed.
509
+ * @since v13.6.0, v12.17.0
510
+ */
511
+ const errorMonitor: unique symbol;
512
+ /**
513
+ * Listens once to the `abort` event on the provided `signal`.
514
+ *
515
+ * Listening to the `abort` event on abort signals is unsafe and may
516
+ * lead to resource leaks since another third party with the signal can
517
+ * call `e.stopImmediatePropagation()`. Unfortunately Node.js cannot change
518
+ * this since it would violate the web standard. Additionally, the original
519
+ * API makes it easy to forget to remove listeners.
520
+ *
521
+ * This API allows safely using `AbortSignal`s in Node.js APIs by solving these
522
+ * two issues by listening to the event such that `stopImmediatePropagation` does
523
+ * not prevent the listener from running.
524
+ *
525
+ * Returns a disposable so that it may be unsubscribed from more easily.
526
+ *
527
+ * ```js
528
+ * import { addAbortListener } from 'node:events';
529
+ *
530
+ * function example(signal) {
531
+ * signal.addEventListener('abort', (e) => e.stopImmediatePropagation());
532
+ * // addAbortListener() returns a disposable, so the `using` keyword ensures
533
+ * // the abort listener is automatically removed when this scope exits.
534
+ * using _ = addAbortListener(signal, (e) => {
535
+ * // Do something when signal is aborted.
536
+ * });
537
+ * }
538
+ * ```
539
+ * @since v20.5.0
540
+ * @return Disposable that removes the `abort` listener.
541
+ */
542
+ function addAbortListener(signal: AbortSignal, resource: (event: Event) => void): Disposable;
543
+ /**
544
+ * Returns a copy of the array of listeners for the event named `eventName`.
545
+ *
546
+ * For `EventEmitter`s this behaves exactly the same as calling `.listeners` on
547
+ * the emitter.
548
+ *
549
+ * For `EventTarget`s this is the only way to get the event listeners for the
550
+ * event target. This is useful for debugging and diagnostic purposes.
551
+ *
552
+ * ```js
553
+ * import { getEventListeners, EventEmitter } from 'node:events';
554
+ *
555
+ * {
556
+ * const ee = new EventEmitter();
557
+ * const listener = () => console.log('Events are fun');
558
+ * ee.on('foo', listener);
559
+ * console.log(getEventListeners(ee, 'foo')); // [ [Function: listener] ]
560
+ * }
561
+ * {
562
+ * const et = new EventTarget();
563
+ * const listener = () => console.log('Events are fun');
564
+ * et.addEventListener('foo', listener);
565
+ * console.log(getEventListeners(et, 'foo')); // [ [Function: listener] ]
566
+ * }
567
+ * ```
568
+ * @since v15.2.0, v14.17.0
569
+ */
570
+ function getEventListeners(emitter: EventEmitter, name: string | symbol): ((...args: any[]) => void)[];
571
+ function getEventListeners(emitter: EventTarget, name: string): ((...args: any[]) => void)[];
572
+ /**
573
+ * Returns the currently set max amount of listeners.
574
+ *
575
+ * For `EventEmitter`s this behaves exactly the same as calling `.getMaxListeners` on
576
+ * the emitter.
577
+ *
578
+ * For `EventTarget`s this is the only way to get the max event listeners for the
579
+ * event target. If the number of event handlers on a single EventTarget exceeds
580
+ * the max set, the EventTarget will print a warning.
581
+ *
582
+ * ```js
583
+ * import { getMaxListeners, setMaxListeners, EventEmitter } from 'node:events';
584
+ *
585
+ * {
586
+ * const ee = new EventEmitter();
587
+ * console.log(getMaxListeners(ee)); // 10
588
+ * setMaxListeners(11, ee);
589
+ * console.log(getMaxListeners(ee)); // 11
590
+ * }
591
+ * {
592
+ * const et = new EventTarget();
593
+ * console.log(getMaxListeners(et)); // 10
594
+ * setMaxListeners(11, et);
595
+ * console.log(getMaxListeners(et)); // 11
596
+ * }
597
+ * ```
598
+ * @since v19.9.0
599
+ */
600
+ function getMaxListeners(emitter: EventEmitter | EventTarget): number;
601
+ /**
602
+ * Returns the number of registered listeners for the event named `eventName`.
603
+ *
604
+ * For `EventEmitter`s this behaves exactly the same as calling `.listenerCount`
605
+ * on the emitter.
606
+ *
607
+ * For `EventTarget`s this is the only way to obtain the listener count. This can
608
+ * be useful for debugging and diagnostic purposes.
609
+ * @since v0.9.12
610
+ */
611
+ function listenerCount(emitter: EventEmitter, eventName: string | symbol): number;
612
+ function listenerCount(emitter: EventTarget, eventName: string): number;
613
+ interface OnOptions extends Abortable {
614
+ /**
615
+ * Names of events that will end the iteration.
616
+ */
617
+ close?: readonly string[] | undefined;
618
+ /**
619
+ * The high watermark. The emitter is paused every time the size of events
620
+ * being buffered is higher than it. Supported only on emitters implementing
621
+ * `pause()` and `resume()` methods.
622
+ * @default Number.MAX_SAFE_INTEGER
623
+ */
624
+ highWaterMark?: number | undefined;
625
+ /**
626
+ * The low watermark. The emitter is resumed every time the size of events
627
+ * being buffered is lower than it. Supported only on emitters implementing
628
+ * `pause()` and `resume()` methods.
629
+ * @default 1
630
+ */
631
+ lowWaterMark?: number | undefined;
632
+ }
633
+ /**
634
+ * ```js
635
+ * import { on, EventEmitter } from 'node:events';
636
+ * import process from 'node:process';
637
+ *
638
+ * const ee = new EventEmitter();
639
+ *
640
+ * // Emit later on
641
+ * process.nextTick(() => {
642
+ * ee.emit('foo', 'bar');
643
+ * ee.emit('foo', 42);
644
+ * });
645
+ *
646
+ * for await (const event of on(ee, 'foo')) {
647
+ * // The execution of this inner block is synchronous and it
648
+ * // processes one event at a time (even with await). Do not use
649
+ * // if concurrent execution is required.
650
+ * console.log(event); // prints ['bar'] [42]
651
+ * }
652
+ * // Unreachable here
653
+ * ```
654
+ *
655
+ * Returns an `AsyncIterator` that iterates `eventName` events. It will throw
656
+ * if the `EventEmitter` emits `'error'`. It removes all listeners when
657
+ * exiting the loop. The `value` returned by each iteration is an array
658
+ * composed of the emitted event arguments.
659
+ *
660
+ * An `AbortSignal` can be used to cancel waiting on events:
661
+ *
662
+ * ```js
663
+ * import { on, EventEmitter } from 'node:events';
664
+ * import process from 'node:process';
665
+ *
666
+ * const ac = new AbortController();
667
+ *
668
+ * (async () => {
669
+ * const ee = new EventEmitter();
670
+ *
671
+ * // Emit later on
672
+ * process.nextTick(() => {
673
+ * ee.emit('foo', 'bar');
674
+ * ee.emit('foo', 42);
675
+ * });
676
+ *
677
+ * for await (const event of on(ee, 'foo', { signal: ac.signal })) {
678
+ * // The execution of this inner block is synchronous and it
679
+ * // processes one event at a time (even with await). Do not use
680
+ * // if concurrent execution is required.
681
+ * console.log(event); // prints ['bar'] [42]
682
+ * }
683
+ * // Unreachable here
684
+ * })();
685
+ *
686
+ * process.nextTick(() => ac.abort());
687
+ * ```
688
+ * @since v13.6.0, v12.16.0
689
+ * @returns `AsyncIterator` that iterates `eventName` events emitted by the `emitter`
690
+ */
691
+ function on(
692
+ emitter: EventEmitter,
693
+ eventName: string | symbol,
694
+ options?: OnOptions,
695
+ ): NodeJS.AsyncIterator<any[]>;
696
+ function on(
697
+ emitter: EventTarget,
698
+ eventName: string,
699
+ options?: OnOptions,
700
+ ): NodeJS.AsyncIterator<any[]>;
701
+ interface OnceOptions extends Abortable {}
702
+ /**
703
+ * Creates a `Promise` that is fulfilled when the `EventEmitter` emits the given
704
+ * event or that is rejected if the `EventEmitter` emits `'error'` while waiting.
705
+ * The `Promise` will resolve with an array of all the arguments emitted to the
706
+ * given event.
707
+ *
708
+ * This method is intentionally generic and works with the web platform
709
+ * [EventTarget][WHATWG-EventTarget] interface, which has no special
710
+ * `'error'` event semantics and does not listen to the `'error'` event.
711
+ *
712
+ * ```js
713
+ * import { once, EventEmitter } from 'node:events';
714
+ * import process from 'node:process';
715
+ *
716
+ * const ee = new EventEmitter();
717
+ *
718
+ * process.nextTick(() => {
719
+ * ee.emit('myevent', 42);
720
+ * });
721
+ *
722
+ * const [value] = await once(ee, 'myevent');
723
+ * console.log(value);
724
+ *
725
+ * const err = new Error('kaboom');
726
+ * process.nextTick(() => {
727
+ * ee.emit('error', err);
728
+ * });
729
+ *
730
+ * try {
731
+ * await once(ee, 'myevent');
732
+ * } catch (err) {
733
+ * console.error('error happened', err);
734
+ * }
735
+ * ```
736
+ *
737
+ * The special handling of the `'error'` event is only used when `events.once()`
738
+ * is used to wait for another event. If `events.once()` is used to wait for the
739
+ * '`error'` event itself, then it is treated as any other kind of event without
740
+ * special handling:
741
+ *
742
+ * ```js
743
+ * import { EventEmitter, once } from 'node:events';
744
+ *
745
+ * const ee = new EventEmitter();
746
+ *
747
+ * once(ee, 'error')
748
+ * .then(([err]) => console.log('ok', err.message))
749
+ * .catch((err) => console.error('error', err.message));
750
+ *
751
+ * ee.emit('error', new Error('boom'));
752
+ *
753
+ * // Prints: ok boom
754
+ * ```
755
+ *
756
+ * An `AbortSignal` can be used to cancel waiting for the event:
757
+ *
758
+ * ```js
759
+ * import { EventEmitter, once } from 'node:events';
760
+ *
761
+ * const ee = new EventEmitter();
762
+ * const ac = new AbortController();
763
+ *
764
+ * async function foo(emitter, event, signal) {
765
+ * try {
766
+ * await once(emitter, event, { signal });
767
+ * console.log('event emitted!');
768
+ * } catch (error) {
769
+ * if (error.name === 'AbortError') {
770
+ * console.error('Waiting for the event was canceled!');
771
+ * } else {
772
+ * console.error('There was an error', error.message);
773
+ * }
774
+ * }
775
+ * }
776
+ *
777
+ * foo(ee, 'foo', ac.signal);
778
+ * ac.abort(); // Prints: Waiting for the event was canceled!
779
+ * ```
780
+ * @since v11.13.0, v10.16.0
781
+ */
782
+ function once(
783
+ emitter: EventEmitter,
784
+ eventName: string | symbol,
785
+ options?: OnceOptions,
786
+ ): Promise<any[]>;
787
+ function once(emitter: EventTarget, eventName: string, options?: OnceOptions): Promise<any[]>;
788
+ /**
789
+ * ```js
790
+ * import { setMaxListeners, EventEmitter } from 'node:events';
791
+ *
792
+ * const target = new EventTarget();
793
+ * const emitter = new EventEmitter();
794
+ *
795
+ * setMaxListeners(5, target, emitter);
796
+ * ```
797
+ * @since v15.4.0
798
+ * @param n A non-negative number. The maximum number of listeners per `EventTarget` event.
799
+ * @param eventTargets Zero or more `EventTarget`
800
+ * or `EventEmitter` instances. If none are specified, `n` is set as the default
801
+ * max for all newly created `EventTarget` and `EventEmitter` objects.
802
+ * objects.
803
+ */
804
+ function setMaxListeners(n: number, ...eventTargets: ReadonlyArray<EventEmitter | EventTarget>): void;
805
+ /**
806
+ * This is the interface from which event-emitting Node.js APIs inherit in the types package.
807
+ * **It is not intended for consumer use.**
808
+ *
809
+ * It provides event-mapped definitions similar to EventEmitter, except that its signatures
810
+ * are deliberately permissive: they provide type _hinting_, but not rigid type-checking,
811
+ * for compatibility reasons.
812
+ *
813
+ * Classes that inherit directly from EventEmitter in JavaScript can inherit directly from
814
+ * this interface in the type definitions. Classes that are more than one inheritance level
815
+ * away from EventEmitter (eg. `net.Socket` > `stream.Duplex` > `EventEmitter`) must instead
816
+ * copy these method definitions into the derived class. Search "#region InternalEventEmitter"
817
+ * for examples.
818
+ * @internal
819
+ */
820
+ interface InternalEventEmitter<T extends EventMap<T>> extends EventEmitter {
821
+ addListener<E extends keyof T>(eventName: E, listener: (...args: T[E]) => void): this;
822
+ addListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
823
+ emit<E extends keyof T>(eventName: E, ...args: T[E]): boolean;
824
+ emit(eventName: string | symbol, ...args: any[]): boolean;
825
+ listenerCount<E extends keyof T>(eventName: E, listener?: (...args: T[E]) => void): number;
826
+ listenerCount(eventName: string | symbol, listener?: (...args: any[]) => void): number;
827
+ listeners<E extends keyof T>(eventName: E): ((...args: T[E]) => void)[];
828
+ listeners(eventName: string | symbol): ((...args: any[]) => void)[];
829
+ off<E extends keyof T>(eventName: E, listener: (...args: T[E]) => void): this;
830
+ off(eventName: string | symbol, listener: (...args: any[]) => void): this;
831
+ on<E extends keyof T>(eventName: E, listener: (...args: T[E]) => void): this;
832
+ on(eventName: string | symbol, listener: (...args: any[]) => void): this;
833
+ once<E extends keyof T>(eventName: E, listener: (...args: T[E]) => void): this;
834
+ once(eventName: string | symbol, listener: (...args: any[]) => void): this;
835
+ prependListener<E extends keyof T>(eventName: E, listener: (...args: T[E]) => void): this;
836
+ prependListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
837
+ prependOnceListener<E extends keyof T>(eventName: E, listener: (...args: T[E]) => void): this;
838
+ prependOnceListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
839
+ rawListeners<E extends keyof T>(eventName: E): ((...args: T[E]) => void)[];
840
+ rawListeners(eventName: string | symbol): ((...args: any[]) => void)[];
841
+ // eslint-disable-next-line @definitelytyped/no-unnecessary-generics
842
+ removeAllListeners<E extends keyof T>(eventName?: E): this;
843
+ removeAllListeners(eventName?: string | symbol): this;
844
+ removeListener<E extends keyof T>(eventName: E, listener: (...args: T[E]) => void): this;
845
+ removeListener(eventName: string | symbol, listener: (...args: any[]) => void): this;
846
+ }
847
+ interface EventEmitterReferencingAsyncResource extends AsyncResource {
848
+ readonly eventEmitter: EventEmitterAsyncResource;
849
+ }
850
+ interface EventEmitterAsyncResourceOptions extends AsyncResourceOptions, EventEmitterOptions {
851
+ /**
852
+ * The type of async event.
853
+ * @default new.target.name
854
+ */
855
+ name?: string | undefined;
856
+ }
857
+ /**
858
+ * Integrates `EventEmitter` with `AsyncResource` for `EventEmitter`s that
859
+ * require manual async tracking. Specifically, all events emitted by instances
860
+ * of `events.EventEmitterAsyncResource` will run within its [async context](https://nodejs.org/docs/latest-v25.x/api/async_context.html).
861
+ *
862
+ * ```js
863
+ * import { EventEmitterAsyncResource, EventEmitter } from 'node:events';
864
+ * import { notStrictEqual, strictEqual } from 'node:assert';
865
+ * import { executionAsyncId, triggerAsyncId } from 'node:async_hooks';
866
+ *
867
+ * // Async tracking tooling will identify this as 'Q'.
868
+ * const ee1 = new EventEmitterAsyncResource({ name: 'Q' });
869
+ *
870
+ * // 'foo' listeners will run in the EventEmitters async context.
871
+ * ee1.on('foo', () => {
872
+ * strictEqual(executionAsyncId(), ee1.asyncId);
873
+ * strictEqual(triggerAsyncId(), ee1.triggerAsyncId);
874
+ * });
875
+ *
876
+ * const ee2 = new EventEmitter();
877
+ *
878
+ * // 'foo' listeners on ordinary EventEmitters that do not track async
879
+ * // context, however, run in the same async context as the emit().
880
+ * ee2.on('foo', () => {
881
+ * notStrictEqual(executionAsyncId(), ee2.asyncId);
882
+ * notStrictEqual(triggerAsyncId(), ee2.triggerAsyncId);
883
+ * });
884
+ *
885
+ * Promise.resolve().then(() => {
886
+ * ee1.emit('foo');
887
+ * ee2.emit('foo');
888
+ * });
889
+ * ```
890
+ *
891
+ * The `EventEmitterAsyncResource` class has the same methods and takes the
892
+ * same options as `EventEmitter` and `AsyncResource` themselves.
893
+ * @since v17.4.0, v16.14.0
894
+ */
895
+ class EventEmitterAsyncResource extends EventEmitter {
896
+ constructor(options?: EventEmitterAsyncResourceOptions);
897
+ /**
898
+ * The unique `asyncId` assigned to the resource.
899
+ */
900
+ readonly asyncId: number;
901
+ /**
902
+ * The returned `AsyncResource` object has an additional `eventEmitter` property
903
+ * that provides a reference to this `EventEmitterAsyncResource`.
904
+ */
905
+ readonly asyncResource: EventEmitterReferencingAsyncResource;
906
+ /**
907
+ * Call all `destroy` hooks. This should only ever be called once. An error will
908
+ * be thrown if it is called more than once. This **must** be manually called. If
909
+ * the resource is left to be collected by the GC then the `destroy` hooks will
910
+ * never be called.
911
+ */
912
+ emitDestroy(): void;
913
+ /**
914
+ * The same `triggerAsyncId` that is passed to the
915
+ * `AsyncResource` constructor.
916
+ */
917
+ readonly triggerAsyncId: number;
918
+ }
919
+ /**
920
+ * The `NodeEventTarget` is a Node.js-specific extension to `EventTarget`
921
+ * that emulates a subset of the `EventEmitter` API.
922
+ * @since v14.5.0
923
+ */
924
+ interface NodeEventTarget extends EventTarget {
925
+ /**
926
+ * Node.js-specific extension to the `EventTarget` class that emulates the
927
+ * equivalent `EventEmitter` API. The only difference between `addListener()` and
928
+ * `addEventListener()` is that `addListener()` will return a reference to the
929
+ * `EventTarget`.
930
+ * @since v14.5.0
931
+ */
932
+ addListener(type: string, listener: (arg: any) => void): this;
933
+ /**
934
+ * Node.js-specific extension to the `EventTarget` class that dispatches the
935
+ * `arg` to the list of handlers for `type`.
936
+ * @since v15.2.0
937
+ * @returns `true` if event listeners registered for the `type` exist,
938
+ * otherwise `false`.
939
+ */
940
+ emit(type: string, arg: any): boolean;
941
+ /**
942
+ * Node.js-specific extension to the `EventTarget` class that returns an array
943
+ * of event `type` names for which event listeners are registered.
944
+ * @since 14.5.0
945
+ */
946
+ eventNames(): string[];
947
+ /**
948
+ * Node.js-specific extension to the `EventTarget` class that returns the number
949
+ * of event listeners registered for the `type`.
950
+ * @since v14.5.0
951
+ */
952
+ listenerCount(type: string): number;
953
+ /**
954
+ * Node.js-specific extension to the `EventTarget` class that sets the number
955
+ * of max event listeners as `n`.
956
+ * @since v14.5.0
957
+ */
958
+ setMaxListeners(n: number): void;
959
+ /**
960
+ * Node.js-specific extension to the `EventTarget` class that returns the number
961
+ * of max event listeners.
962
+ * @since v14.5.0
963
+ */
964
+ getMaxListeners(): number;
965
+ /**
966
+ * Node.js-specific alias for `eventTarget.removeEventListener()`.
967
+ * @since v14.5.0
968
+ */
969
+ off(type: string, listener: (arg: any) => void, options?: EventListenerOptions): this;
970
+ /**
971
+ * Node.js-specific alias for `eventTarget.addEventListener()`.
972
+ * @since v14.5.0
973
+ */
974
+ on(type: string, listener: (arg: any) => void): this;
975
+ /**
976
+ * Node.js-specific extension to the `EventTarget` class that adds a `once`
977
+ * listener for the given event `type`. This is equivalent to calling `on`
978
+ * with the `once` option set to `true`.
979
+ * @since v14.5.0
980
+ */
981
+ once(type: string, listener: (arg: any) => void): this;
982
+ /**
983
+ * Node.js-specific extension to the `EventTarget` class. If `type` is specified,
984
+ * removes all registered listeners for `type`, otherwise removes all registered
985
+ * listeners.
986
+ * @since v14.5.0
987
+ */
988
+ removeAllListeners(type?: string): this;
989
+ /**
990
+ * Node.js-specific extension to the `EventTarget` class that removes the
991
+ * `listener` for the given `type`. The only difference between `removeListener()`
992
+ * and `removeEventListener()` is that `removeListener()` will return a reference
993
+ * to the `EventTarget`.
994
+ * @since v14.5.0
995
+ */
996
+ removeListener(type: string, listener: (arg: any) => void, options?: EventListenerOptions): this;
997
+ }
998
+ /** @internal */
999
+ type InternalEventTargetEventProperties<T> = {
1000
+ [K in keyof T & string as `on${K}`]: ((ev: T[K]) => void) | null;
1001
+ };
1002
+ }
971
1003
  export = EventEmitter;
972
1004
  }
973
- declare module "node:events" {
974
- import events = require("events");
1005
+ declare module "events" {
1006
+ import events = require("node:events");
975
1007
  export = events;
976
1008
  }