@poolzin/pool-bot 2026.2.11 → 2026.2.18

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 (535) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/dist/agents/agent-scope.js +4 -0
  3. package/dist/agents/announce-idempotency.js +14 -0
  4. package/dist/agents/auth-profiles/usage.js +22 -0
  5. package/dist/agents/auth-profiles.js +1 -1
  6. package/dist/agents/auth-profiles.resolve-auth-profile-order.fixtures.js +23 -0
  7. package/dist/agents/bash-tools.exec-runtime.js +438 -0
  8. package/dist/agents/bash-tools.shared.js +6 -0
  9. package/dist/agents/cli-runner/reliability.js +61 -0
  10. package/dist/agents/cli-watchdog-defaults.js +11 -0
  11. package/dist/agents/command-poll-backoff.js +63 -0
  12. package/dist/agents/current-time.js +16 -0
  13. package/dist/agents/glob-pattern.js +42 -0
  14. package/dist/agents/memory-search.js +33 -0
  15. package/dist/agents/model-alias-lines.js +18 -0
  16. package/dist/agents/model-auth-label.js +61 -0
  17. package/dist/agents/model-fallback.js +59 -8
  18. package/dist/agents/models-config.e2e-harness.js +115 -0
  19. package/dist/agents/ollama-stream.js +11 -3
  20. package/dist/agents/openclaw-tools.js +135 -0
  21. package/dist/agents/pi-auth-json.js +118 -0
  22. package/dist/agents/pi-embedded-runner/run.overflow-compaction.mocks.shared.js +147 -0
  23. package/dist/agents/pi-embedded-subscribe.e2e-harness.js +90 -0
  24. package/dist/agents/pi-embedded-subscribe.handlers.compaction.js +63 -0
  25. package/dist/agents/pi-embedded-subscribe.handlers.tools.media.test-helpers.js +30 -0
  26. package/dist/agents/pi-extensions/session-manager-runtime-registry.js +23 -0
  27. package/dist/agents/pi-tools.before-tool-call.js +145 -4
  28. package/dist/agents/pi-tools.js +29 -9
  29. package/dist/agents/pi-tools.policy.js +85 -92
  30. package/dist/agents/pi-tools.schema.js +54 -27
  31. package/dist/agents/queued-file-writer.js +22 -0
  32. package/dist/agents/sandbox/docker.js +133 -40
  33. package/dist/agents/sandbox/fs-bridge.js +146 -0
  34. package/dist/agents/sandbox/fs-paths.js +205 -0
  35. package/dist/agents/sandbox/hash.js +4 -0
  36. package/dist/agents/sandbox/validate-sandbox-security.js +157 -0
  37. package/dist/agents/sandbox-paths.js +3 -0
  38. package/dist/agents/sandbox-tool-policy.js +26 -0
  39. package/dist/agents/sanitize-for-prompt.js +18 -0
  40. package/dist/agents/session-dirs.js +20 -0
  41. package/dist/agents/session-write-lock.js +203 -39
  42. package/dist/agents/skills/filter.js +24 -0
  43. package/dist/agents/skills/tools-dir.js +9 -0
  44. package/dist/agents/skills-install-download.js +290 -0
  45. package/dist/agents/skills-install-output.js +30 -0
  46. package/dist/agents/skills-install.download-test-utils.js +36 -0
  47. package/dist/agents/skills.e2e-test-helpers.js +13 -0
  48. package/dist/agents/subagent-announce-queue.js +59 -15
  49. package/dist/agents/subagent-depth.js +137 -0
  50. package/dist/agents/subagent-registry.js +448 -96
  51. package/dist/agents/subagent-spawn.js +262 -0
  52. package/dist/agents/system-prompt.js +52 -10
  53. package/dist/agents/test-helpers/fast-tool-stubs.js +18 -0
  54. package/dist/agents/test-helpers/host-sandbox-fs-bridge.js +74 -0
  55. package/dist/agents/tool-display-common.js +782 -0
  56. package/dist/agents/tool-loop-detection.js +466 -0
  57. package/dist/agents/tool-policy.js +6 -0
  58. package/dist/agents/tools/image-tool.js +1 -1
  59. package/dist/agents/tools/sessions-access.js +178 -0
  60. package/dist/agents/tools/sessions-resolution.js +206 -0
  61. package/dist/agents/tools/subagents-tool.js +616 -0
  62. package/dist/agents/workspace-dir.js +18 -0
  63. package/dist/agents/workspace-dirs.js +14 -0
  64. package/dist/agents/workspace.js +70 -0
  65. package/dist/auto-reply/heartbeat-reply-payload.js +18 -0
  66. package/dist/auto-reply/reply/commands-export-session.js +163 -0
  67. package/dist/auto-reply/reply/commands-mesh.js +245 -0
  68. package/dist/auto-reply/reply/commands-setunset.js +28 -0
  69. package/dist/auto-reply/reply/commands-slash-parse.js +31 -0
  70. package/dist/auto-reply/reply/commands-system-prompt.js +117 -0
  71. package/dist/auto-reply/reply/directive-handling.levels.js +17 -0
  72. package/dist/auto-reply/reply/directive-handling.params.js +1 -0
  73. package/dist/auto-reply/reply/directive-parsing.js +36 -0
  74. package/dist/auto-reply/reply/dispatcher-registry.js +43 -0
  75. package/dist/auto-reply/reply/elevated-unavailable.js +20 -0
  76. package/dist/auto-reply/reply/post-compaction-audit.js +96 -0
  77. package/dist/auto-reply/reply/post-compaction-context.js +98 -0
  78. package/dist/auto-reply/reply/reply-delivery.js +92 -0
  79. package/dist/auto-reply/reply/session-reset-prompt.js +1 -0
  80. package/dist/auto-reply/reply/session-run-accounting.js +33 -0
  81. package/dist/auto-reply/reply.directive.directive-behavior.e2e-harness.js +115 -0
  82. package/dist/auto-reply/reply.directive.directive-behavior.e2e-mocks.js +12 -0
  83. package/dist/browser/bridge-auth-registry.js +26 -0
  84. package/dist/browser/client-actions-url.js +10 -0
  85. package/dist/browser/control-auth.js +73 -0
  86. package/dist/browser/csrf.js +64 -0
  87. package/dist/browser/http-auth.js +52 -0
  88. package/dist/browser/paths.js +37 -0
  89. package/dist/browser/proxy-files.js +32 -0
  90. package/dist/browser/pw-ai-state.js +7 -0
  91. package/dist/browser/resolved-config-refresh.js +42 -0
  92. package/dist/browser/routes/path-output.js +1 -0
  93. package/dist/browser/server-context.chrome-test-harness.js +20 -0
  94. package/dist/browser/server-middleware.js +31 -0
  95. package/dist/browser/test-port.js +16 -0
  96. package/dist/build-info.json +3 -3
  97. package/dist/canvas-host/file-resolver.js +43 -0
  98. package/dist/channels/account-summary.js +19 -0
  99. package/dist/channels/draft-stream-loop.js +77 -0
  100. package/dist/channels/plugins/account-helpers.js +26 -0
  101. package/dist/channels/telegram/allow-from.js +10 -0
  102. package/dist/cli/browser-cli-resize.js +22 -0
  103. package/dist/cli/browser-cli-shared.js +8 -0
  104. package/dist/cli/clawbot-cli.js +5 -0
  105. package/dist/cli/completion-cli.js +566 -0
  106. package/dist/cli/config-cli.js +63 -5
  107. package/dist/cli/daemon-cli/lifecycle-core.js +256 -0
  108. package/dist/cli/daemon-cli/register-service-commands.js +60 -0
  109. package/dist/cli/daemon-cli-compat.js +80 -0
  110. package/dist/cli/nodes-cli/pairing-render.js +26 -0
  111. package/dist/cli/program/action-reparse.js +17 -0
  112. package/dist/cli/program/command-registry.js +17 -0
  113. package/dist/cli/program/program-context.js +8 -0
  114. package/dist/cli/program/register.subclis.js +7 -0
  115. package/dist/cli/program/routes.js +233 -0
  116. package/dist/cli/qr-cli.js +132 -0
  117. package/dist/cli/requirements-test-fixtures.js +17 -0
  118. package/dist/cli/respawn-policy.js +4 -0
  119. package/dist/cli/shared/parse-port.js +18 -0
  120. package/dist/cli/skills-cli.format.js +241 -0
  121. package/dist/cli/update-cli/progress.js +121 -0
  122. package/dist/cli/update-cli/restart-helper.js +108 -0
  123. package/dist/cli/update-cli/shared.js +196 -0
  124. package/dist/cli/update-cli/status.js +97 -0
  125. package/dist/cli/update-cli/suppress-deprecations.js +17 -0
  126. package/dist/cli/update-cli/update-command.js +506 -0
  127. package/dist/cli/update-cli/wizard.js +130 -0
  128. package/dist/cli/update-cli.js +3 -9
  129. package/dist/cli/windows-argv.js +69 -0
  130. package/dist/commands/auth-choice-legacy.js +20 -0
  131. package/dist/commands/auth-choice.apply-helpers.js +8 -0
  132. package/dist/commands/channel-test-helpers.js +19 -0
  133. package/dist/commands/cleanup-plan.js +10 -0
  134. package/dist/commands/cleanup-utils.js +7 -0
  135. package/dist/commands/config-validation.js +15 -0
  136. package/dist/commands/doctor-completion.js +112 -0
  137. package/dist/commands/doctor-memory-search.js +119 -0
  138. package/dist/commands/doctor-session-locks.js +73 -0
  139. package/dist/commands/doctor.e2e-harness.js +364 -0
  140. package/dist/commands/gateway-presence.js +19 -0
  141. package/dist/commands/model-default.js +35 -0
  142. package/dist/commands/models/fallbacks-shared.js +102 -0
  143. package/dist/commands/models/shared.js +24 -0
  144. package/dist/commands/onboard-auth.config-gateways.js +64 -0
  145. package/dist/commands/onboard-auth.config-litellm.js +45 -0
  146. package/dist/commands/onboard-auth.config-shared.js +116 -0
  147. package/dist/commands/onboard-config.js +16 -0
  148. package/dist/commands/onboard-non-interactive.test-helpers.js +31 -0
  149. package/dist/commands/onboard-provider-auth-flags.js +136 -0
  150. package/dist/commands/openai-codex-oauth.js +40 -0
  151. package/dist/commands/test-runtime-config-helpers.js +21 -0
  152. package/dist/commands/test-wizard-helpers.js +68 -0
  153. package/dist/commands/vllm-setup.js +66 -0
  154. package/dist/compat/legacy-names.js +2 -0
  155. package/dist/config/backup-rotation.js +19 -0
  156. package/dist/config/env-preserve.js +122 -0
  157. package/dist/config/includes-scan.js +78 -0
  158. package/dist/config/plugins-allowlist.js +13 -0
  159. package/dist/config/schema.help.js +256 -0
  160. package/dist/config/schema.hints.js +189 -0
  161. package/dist/config/schema.irc.js +20 -0
  162. package/dist/config/schema.labels.js +317 -0
  163. package/dist/config/sessions/delivery-info.js +40 -0
  164. package/dist/config/types.irc.js +1 -0
  165. package/dist/config/zod-schema.agent-defaults.js +14 -0
  166. package/dist/config/zod-schema.agent-model.js +10 -0
  167. package/dist/config/zod-schema.agent-runtime.js +14 -0
  168. package/dist/config/zod-schema.allowdeny.js +35 -0
  169. package/dist/config/zod-schema.sensitive.js +4 -0
  170. package/dist/control-ui/assets/index-HRr1grwl.js.map +1 -1
  171. package/dist/cron/isolated-agent/skills-snapshot.js +26 -0
  172. package/dist/cron/isolated-agent/subagent-followup.js +127 -0
  173. package/dist/cron/isolated-agent.mocks.js +12 -0
  174. package/dist/cron/isolated-agent.test-setup.js +22 -0
  175. package/dist/cron/legacy-delivery.js +43 -0
  176. package/dist/cron/webhook-url.js +22 -0
  177. package/dist/daemon/arg-split.js +40 -0
  178. package/dist/daemon/exec-file.js +23 -0
  179. package/dist/daemon/output.js +6 -0
  180. package/dist/daemon/runtime-format.js +31 -0
  181. package/dist/daemon/schtasks-exec.js +4 -0
  182. package/dist/daemon/service-audit.js +22 -0
  183. package/dist/discord/client.js +41 -0
  184. package/dist/discord/components-registry.js +57 -0
  185. package/dist/discord/components.js +816 -0
  186. package/dist/discord/guilds.js +12 -0
  187. package/dist/discord/monitor/gateway-plugin.js +48 -0
  188. package/dist/discord/monitor/presence.js +30 -0
  189. package/dist/discord/send.components.js +115 -0
  190. package/dist/discord/send.shared.js +4 -0
  191. package/dist/discord/ui.js +26 -0
  192. package/dist/discord/voice-message.js +254 -0
  193. package/dist/gateway/agent-event-assistant-text.js +5 -0
  194. package/dist/gateway/agent-prompt.js +33 -0
  195. package/dist/gateway/auth-rate-limit.js +136 -0
  196. package/dist/gateway/channel-health-monitor.js +114 -0
  197. package/dist/gateway/control-ui-contract.js +1 -0
  198. package/dist/gateway/control-ui-csp.js +15 -0
  199. package/dist/gateway/gateway-config-prompts.shared.js +25 -0
  200. package/dist/gateway/http-auth-helpers.js +18 -0
  201. package/dist/gateway/http-common.js +18 -0
  202. package/dist/gateway/http-endpoint-helpers.js +27 -0
  203. package/dist/gateway/node-invoke-sanitize.js +11 -0
  204. package/dist/gateway/node-invoke-system-run-approval.js +205 -0
  205. package/dist/gateway/probe-auth.js +21 -0
  206. package/dist/gateway/protocol/index.js +7 -2
  207. package/dist/gateway/protocol/schema/mesh.js +54 -0
  208. package/dist/gateway/protocol/schema/protocol-schemas.js +7 -0
  209. package/dist/gateway/protocol/schema.js +1 -0
  210. package/dist/gateway/server/ws-connection/auth-messages.js +54 -0
  211. package/dist/gateway/server-channels.js +11 -0
  212. package/dist/gateway/server-methods/attachment-normalize.js +16 -0
  213. package/dist/gateway/server-methods/base-hash.js +8 -0
  214. package/dist/gateway/server-methods/mesh.js +700 -0
  215. package/dist/gateway/server-methods/nodes.handlers.invoke-result.js +55 -0
  216. package/dist/gateway/server-methods/restart-request.js +13 -0
  217. package/dist/gateway/server-methods/validation.js +8 -0
  218. package/dist/gateway/server.agent.gateway-server-agent.mocks.js +35 -0
  219. package/dist/gateway/server.e2e-registry-helpers.js +1 -0
  220. package/dist/gateway/server.e2e-ws-harness.js +20 -0
  221. package/dist/gateway/test-helpers.js +2 -0
  222. package/dist/gateway/test-helpers.server.js +3 -1
  223. package/dist/gateway/test-http-response.js +12 -0
  224. package/dist/gateway/test-openai-responses-model.js +20 -0
  225. package/dist/gateway/test-temp-config.js +30 -0
  226. package/dist/gateway/test-with-server.js +32 -0
  227. package/dist/hooks/bundled/bootstrap-extra-files/handler.js +46 -0
  228. package/dist/imessage/monitor/abort-handler.js +23 -0
  229. package/dist/imessage/monitor/inbound-processing.js +346 -0
  230. package/dist/imessage/monitor/parse-notification.js +64 -0
  231. package/dist/imessage/target-parsing-helpers.js +92 -0
  232. package/dist/infra/archive.js +244 -20
  233. package/dist/infra/detect-package-manager.js +26 -0
  234. package/dist/infra/exec-approvals-allowlist.js +257 -0
  235. package/dist/infra/exec-approvals-analysis.js +770 -0
  236. package/dist/infra/exec-approvals.js +13 -0
  237. package/dist/infra/file-lock.js +1 -0
  238. package/dist/infra/gemini-auth.js +39 -0
  239. package/dist/infra/heartbeat-active-hours.js +85 -0
  240. package/dist/infra/heartbeat-events-filter.js +50 -0
  241. package/dist/infra/heartbeat-runner.test-utils.js +39 -0
  242. package/dist/infra/http-body.js +265 -0
  243. package/dist/infra/install-package-dir.js +50 -0
  244. package/dist/infra/install-safe-path.js +49 -0
  245. package/dist/infra/json-files.js +49 -0
  246. package/dist/infra/jsonl-socket.js +52 -0
  247. package/dist/infra/map-size.js +14 -0
  248. package/dist/infra/net/hostname.js +7 -0
  249. package/dist/infra/npm-registry-spec.js +39 -0
  250. package/dist/infra/openclaw-root.js +109 -0
  251. package/dist/infra/outbound/delivery-queue.js +214 -0
  252. package/dist/infra/outbound/identity.js +23 -0
  253. package/dist/infra/outbound/message-action-params.js +307 -0
  254. package/dist/infra/outbound/tool-payload.js +21 -0
  255. package/dist/infra/package-json.js +23 -0
  256. package/dist/infra/pairing-files.js +19 -0
  257. package/dist/infra/pairing-token.js +9 -0
  258. package/dist/infra/path-prepend.js +51 -0
  259. package/dist/infra/path-safety.js +16 -0
  260. package/dist/infra/process-respawn.js +49 -0
  261. package/dist/infra/runtime-status.js +16 -0
  262. package/dist/infra/session-cost-usage.types.js +1 -0
  263. package/dist/infra/session-maintenance-warning.js +89 -0
  264. package/dist/infra/system-run-command.js +78 -0
  265. package/dist/infra/tmp-openclaw-dir.js +81 -0
  266. package/dist/infra/tmp-poolbot-dir.js +2 -0
  267. package/dist/infra/update-channels.js +19 -0
  268. package/dist/line/actions.js +45 -0
  269. package/dist/line/channel-access-token.js +9 -0
  270. package/dist/line/flex-templates/basic-cards.js +332 -0
  271. package/dist/line/flex-templates/common.js +18 -0
  272. package/dist/line/flex-templates/media-control-cards.js +453 -0
  273. package/dist/line/flex-templates/message.js +10 -0
  274. package/dist/line/flex-templates/schedule-cards.js +399 -0
  275. package/dist/line/flex-templates/types.js +1 -0
  276. package/dist/line/webhook-node.js +100 -0
  277. package/dist/line/webhook-utils.js +11 -0
  278. package/dist/logging/diagnostic-session-state.js +73 -0
  279. package/dist/logging/diagnostic.js +22 -0
  280. package/dist/logging/timestamps.js +14 -0
  281. package/dist/markdown/whatsapp.js +62 -0
  282. package/dist/media/base64.js +34 -0
  283. package/dist/media/local-roots.js +32 -0
  284. package/dist/media/outbound-attachment.js +10 -0
  285. package/dist/media/read-response-with-limit.js +41 -0
  286. package/dist/media/sniff-mime-from-base64.js +19 -0
  287. package/dist/media-understanding/audio-preflight.js +67 -0
  288. package/dist/media-understanding/fs.js +13 -0
  289. package/dist/media-understanding/output-extract.js +26 -0
  290. package/dist/media-understanding/providers/audio.test-helpers.js +34 -0
  291. package/dist/media-understanding/providers/google/inline-data.js +64 -0
  292. package/dist/media-understanding/providers/shared.js +7 -0
  293. package/dist/media-understanding/runner.entries.js +459 -0
  294. package/dist/memory/batch-error-utils.js +11 -0
  295. package/dist/memory/batch-http.js +27 -0
  296. package/dist/memory/batch-output.js +29 -0
  297. package/dist/memory/batch-runner.js +22 -0
  298. package/dist/memory/batch-upload.js +23 -0
  299. package/dist/memory/batch-utils.js +26 -0
  300. package/dist/memory/embeddings-debug.js +11 -0
  301. package/dist/memory/embeddings-remote-client.js +22 -0
  302. package/dist/memory/embeddings-remote-fetch.js +14 -0
  303. package/dist/memory/embeddings.js +36 -9
  304. package/dist/memory/hybrid.js +24 -5
  305. package/dist/memory/manager-embedding-ops.js +616 -0
  306. package/dist/memory/manager-sync-ops.js +953 -0
  307. package/dist/memory/manager.js +76 -28
  308. package/dist/memory/mmr.js +164 -0
  309. package/dist/memory/qmd-manager.js +1061 -0
  310. package/dist/memory/qmd-query-parser.js +107 -0
  311. package/dist/memory/qmd-scope.js +93 -0
  312. package/dist/memory/query-expansion.js +331 -0
  313. package/dist/memory/search-manager.js +0 -1
  314. package/dist/memory/sync-index.js +21 -0
  315. package/dist/memory/sync-progress.js +22 -0
  316. package/dist/memory/sync-stale.js +30 -0
  317. package/dist/memory/temporal-decay.js +119 -0
  318. package/dist/memory/test-embeddings-mock.js +16 -0
  319. package/dist/memory/test-manager-helpers.js +14 -0
  320. package/dist/memory/test-runtime-mocks.js +11 -0
  321. package/dist/node-host/invoke-browser.js +177 -0
  322. package/dist/node-host/invoke.js +685 -0
  323. package/dist/pairing/setup-code.js +285 -0
  324. package/dist/plugin-sdk/account-id.js +1 -0
  325. package/dist/plugin-sdk/agent-media-payload.js +13 -0
  326. package/dist/plugin-sdk/allow-from.js +47 -0
  327. package/dist/plugin-sdk/command-auth.js +23 -0
  328. package/dist/plugin-sdk/config-paths.js +9 -0
  329. package/dist/plugin-sdk/file-lock.js +116 -0
  330. package/dist/plugin-sdk/json-store.js +31 -0
  331. package/dist/plugin-sdk/onboarding.js +28 -0
  332. package/dist/plugin-sdk/provider-auth-result.js +29 -0
  333. package/dist/plugin-sdk/slack-message-actions.js +133 -0
  334. package/dist/plugin-sdk/status-helpers.js +35 -0
  335. package/dist/plugin-sdk/text-chunking.js +31 -0
  336. package/dist/plugin-sdk/tool-send.js +12 -0
  337. package/dist/plugin-sdk/webhook-path.js +27 -0
  338. package/dist/plugin-sdk/webhook-targets.js +34 -0
  339. package/dist/plugins/hooks.test-helpers.js +21 -0
  340. package/dist/plugins/uninstall.js +171 -0
  341. package/dist/process/kill-tree.js +98 -0
  342. package/dist/process/supervisor/adapters/child.js +143 -0
  343. package/dist/process/supervisor/adapters/env.js +13 -0
  344. package/dist/process/supervisor/adapters/pty.js +148 -0
  345. package/dist/process/supervisor/index.js +10 -0
  346. package/dist/process/supervisor/registry.js +117 -0
  347. package/dist/process/supervisor/supervisor.js +244 -0
  348. package/dist/process/supervisor/types.js +1 -0
  349. package/dist/providers/google-shared.test-helpers.js +75 -0
  350. package/dist/security/audit-channel.js +419 -0
  351. package/dist/security/audit-tool-policy.js +1 -0
  352. package/dist/security/scan-paths.js +12 -0
  353. package/dist/sessions/input-provenance.js +55 -0
  354. package/dist/sessions/session-key-utils.js +7 -0
  355. package/dist/shared/chat-content.js +31 -0
  356. package/dist/shared/chat-envelope.js +45 -0
  357. package/dist/shared/config-eval.js +117 -0
  358. package/dist/shared/device-auth.js +16 -0
  359. package/dist/shared/entry-metadata.js +9 -0
  360. package/dist/shared/entry-status.js +25 -0
  361. package/dist/shared/frontmatter.js +98 -0
  362. package/dist/shared/model-param-b.js +19 -0
  363. package/dist/shared/net/ipv4.js +17 -0
  364. package/dist/shared/node-match.js +53 -0
  365. package/dist/shared/pid-alive.js +12 -0
  366. package/dist/shared/process-scoped-map.js +10 -0
  367. package/dist/shared/requirements.js +128 -0
  368. package/dist/shared/subagents-format.js +84 -0
  369. package/dist/shared/usage-aggregates.js +28 -0
  370. package/dist/signal/monitor/mentions.js +45 -0
  371. package/dist/signal/rpc-context.js +19 -0
  372. package/dist/slack/blocks-fallback.js +76 -0
  373. package/dist/slack/blocks-input.js +40 -0
  374. package/dist/slack/draft-stream.js +106 -0
  375. package/dist/slack/message-actions.js +51 -0
  376. package/dist/slack/modal-metadata.js +32 -0
  377. package/dist/slack/monitor/events/interactions.js +462 -0
  378. package/dist/slack/monitor/room-context.js +17 -0
  379. package/dist/slack/stream-mode.js +41 -0
  380. package/dist/telegram/bot-native-command-menu.js +64 -0
  381. package/dist/telegram/bot.media.e2e-harness.js +81 -0
  382. package/dist/telegram/button-types.js +1 -0
  383. package/dist/telegram/group-access.js +65 -0
  384. package/dist/telegram/outbound-params.js +21 -0
  385. package/dist/telegram/poll-vote-cache.js +21 -0
  386. package/dist/terminal/health-style.js +36 -0
  387. package/dist/test-utils/chunk-test-helpers.js +21 -0
  388. package/dist/test-utils/env.js +72 -0
  389. package/dist/test-utils/exec-assertions.js +12 -0
  390. package/dist/test-utils/imessage-test-plugin.js +54 -0
  391. package/dist/test-utils/mock-http-response.js +17 -0
  392. package/dist/test-utils/vitest-mock-fn.js +1 -0
  393. package/dist/tts/tts-core.js +550 -0
  394. package/dist/utils/chunk-items.js +10 -0
  395. package/dist/utils/reaction-level.js +52 -0
  396. package/dist/utils/safe-json.js +22 -0
  397. package/dist/utils/with-timeout.js +14 -0
  398. package/dist/web/media.js +17 -5
  399. package/dist/whatsapp/resolve-outbound-target.js +42 -0
  400. package/dist/wizard/onboarding.completion.js +74 -0
  401. package/extensions/bluebubbles/package.json +1 -1
  402. package/extensions/bluebubbles/src/account-resolve.ts +29 -0
  403. package/extensions/bluebubbles/src/monitor-normalize.ts +796 -0
  404. package/extensions/bluebubbles/src/monitor-processing.ts +1007 -0
  405. package/extensions/bluebubbles/src/monitor-reply-cache.ts +185 -0
  406. package/extensions/bluebubbles/src/monitor-shared.ts +51 -0
  407. package/extensions/bluebubbles/src/multipart.ts +32 -0
  408. package/extensions/bluebubbles/src/send-helpers.ts +53 -0
  409. package/extensions/bluebubbles/src/test-harness.ts +50 -0
  410. package/extensions/bluebubbles/src/test-mocks.ts +11 -0
  411. package/extensions/copilot-proxy/package.json +1 -1
  412. package/extensions/device-pair/index.ts +554 -0
  413. package/extensions/diagnostics-otel/package.json +1 -1
  414. package/extensions/discord/package.json +1 -1
  415. package/extensions/discord/src/channel.js +366 -0
  416. package/extensions/discord/src/runtime.js +10 -0
  417. package/extensions/feishu/index.ts +63 -0
  418. package/extensions/feishu/src/accounts.ts +114 -0
  419. package/extensions/feishu/src/bitable.ts +739 -0
  420. package/extensions/feishu/src/bot.ts +965 -0
  421. package/extensions/feishu/src/channel.ts +351 -0
  422. package/extensions/feishu/src/client.ts +118 -0
  423. package/extensions/feishu/src/config-schema.ts +206 -0
  424. package/extensions/feishu/src/dedup.ts +33 -0
  425. package/extensions/feishu/src/directory.ts +177 -0
  426. package/extensions/feishu/src/doc-schema.ts +47 -0
  427. package/extensions/feishu/src/docx.ts +536 -0
  428. package/extensions/feishu/src/drive-schema.ts +46 -0
  429. package/extensions/feishu/src/drive.ts +227 -0
  430. package/extensions/feishu/src/dynamic-agent.ts +131 -0
  431. package/extensions/feishu/src/media.ts +449 -0
  432. package/extensions/feishu/src/mention.ts +126 -0
  433. package/extensions/feishu/src/monitor.ts +330 -0
  434. package/extensions/feishu/src/onboarding.ts +359 -0
  435. package/extensions/feishu/src/outbound.ts +55 -0
  436. package/extensions/feishu/src/perm-schema.ts +52 -0
  437. package/extensions/feishu/src/perm.ts +173 -0
  438. package/extensions/feishu/src/policy.ts +84 -0
  439. package/extensions/feishu/src/probe.ts +44 -0
  440. package/extensions/feishu/src/reactions.ts +160 -0
  441. package/extensions/feishu/src/reply-dispatcher.ts +239 -0
  442. package/extensions/feishu/src/runtime.ts +14 -0
  443. package/extensions/feishu/src/send-result.ts +29 -0
  444. package/extensions/feishu/src/send.ts +335 -0
  445. package/extensions/feishu/src/streaming-card.ts +223 -0
  446. package/extensions/feishu/src/targets.ts +78 -0
  447. package/extensions/feishu/src/tools-config.ts +21 -0
  448. package/extensions/feishu/src/types.ts +81 -0
  449. package/extensions/feishu/src/typing.ts +80 -0
  450. package/extensions/feishu/src/wiki-schema.ts +55 -0
  451. package/extensions/feishu/src/wiki.ts +232 -0
  452. package/extensions/google-antigravity-auth/package.json +1 -1
  453. package/extensions/google-gemini-cli-auth/package.json +1 -1
  454. package/extensions/googlechat/package.json +1 -1
  455. package/extensions/imessage/package.json +1 -1
  456. package/extensions/imessage/src/channel.js +253 -0
  457. package/extensions/imessage/src/runtime.js +10 -0
  458. package/extensions/irc/index.ts +17 -0
  459. package/extensions/irc/src/accounts.ts +268 -0
  460. package/extensions/irc/src/channel.ts +367 -0
  461. package/extensions/irc/src/client.ts +439 -0
  462. package/extensions/irc/src/config-schema.ts +97 -0
  463. package/extensions/irc/src/connect-options.ts +30 -0
  464. package/extensions/irc/src/control-chars.ts +22 -0
  465. package/extensions/irc/src/inbound.ts +334 -0
  466. package/extensions/irc/src/monitor.ts +147 -0
  467. package/extensions/irc/src/normalize.ts +117 -0
  468. package/extensions/irc/src/onboarding.ts +479 -0
  469. package/extensions/irc/src/policy.ts +157 -0
  470. package/extensions/irc/src/probe.ts +53 -0
  471. package/extensions/irc/src/protocol.ts +169 -0
  472. package/extensions/irc/src/runtime.ts +14 -0
  473. package/extensions/irc/src/send.ts +88 -0
  474. package/extensions/irc/src/types.ts +93 -0
  475. package/extensions/line/package.json +1 -1
  476. package/extensions/llm-task/package.json +1 -1
  477. package/extensions/lobster/package.json +1 -1
  478. package/extensions/matrix/CHANGELOG.md +5 -0
  479. package/extensions/matrix/package.json +1 -1
  480. package/extensions/matrix/src/matrix/client-bootstrap.ts +39 -0
  481. package/extensions/mattermost/package.json +1 -1
  482. package/extensions/mattermost/src/mattermost/monitor-onchar.ts +25 -0
  483. package/extensions/mattermost/src/mattermost/monitor-websocket.ts +221 -0
  484. package/extensions/mattermost/src/mattermost/reactions.ts +130 -0
  485. package/extensions/mattermost/src/mattermost/reconnect.ts +103 -0
  486. package/extensions/memory-core/package.json +1 -1
  487. package/extensions/memory-lancedb/package.json +1 -1
  488. package/extensions/minimax-portal-auth/index.ts +161 -0
  489. package/extensions/minimax-portal-auth/oauth.ts +247 -0
  490. package/extensions/msteams/CHANGELOG.md +5 -0
  491. package/extensions/msteams/package.json +1 -1
  492. package/extensions/msteams/src/file-lock.ts +1 -0
  493. package/extensions/msteams/src/graph.ts +92 -0
  494. package/extensions/msteams/src/mentions.ts +114 -0
  495. package/extensions/msteams/src/test-runtime.ts +16 -0
  496. package/extensions/nextcloud-talk/package.json +1 -1
  497. package/extensions/nostr/CHANGELOG.md +5 -0
  498. package/extensions/nostr/package.json +1 -1
  499. package/extensions/open-prose/package.json +1 -1
  500. package/extensions/openai-codex-auth/index.ts +177 -0
  501. package/extensions/phone-control/index.ts +421 -0
  502. package/extensions/shared/resolve-target-test-helpers.ts +66 -0
  503. package/extensions/signal/package.json +1 -1
  504. package/extensions/signal/src/channel.js +273 -0
  505. package/extensions/signal/src/runtime.js +10 -0
  506. package/extensions/slack/package.json +1 -1
  507. package/extensions/slack/src/channel.js +489 -0
  508. package/extensions/slack/src/runtime.js +10 -0
  509. package/extensions/talk-voice/index.ts +150 -0
  510. package/extensions/telegram/package.json +1 -1
  511. package/extensions/telegram/src/channel.js +424 -0
  512. package/extensions/telegram/src/runtime.js +10 -0
  513. package/extensions/thread-ownership/index.ts +133 -0
  514. package/extensions/tlon/package.json +1 -1
  515. package/extensions/tlon/src/account-fields.ts +25 -0
  516. package/extensions/tlon/src/urbit/base-url.ts +57 -0
  517. package/extensions/tlon/src/urbit/channel-client.ts +157 -0
  518. package/extensions/tlon/src/urbit/channel-ops.ts +164 -0
  519. package/extensions/tlon/src/urbit/context.ts +47 -0
  520. package/extensions/tlon/src/urbit/errors.ts +51 -0
  521. package/extensions/tlon/src/urbit/fetch.ts +39 -0
  522. package/extensions/twitch/CHANGELOG.md +5 -0
  523. package/extensions/twitch/package.json +1 -1
  524. package/extensions/twitch/src/test-fixtures.ts +30 -0
  525. package/extensions/voice-call/CHANGELOG.md +5 -0
  526. package/extensions/voice-call/package.json +1 -1
  527. package/extensions/voice-call/src/allowlist.ts +19 -0
  528. package/extensions/whatsapp/package.json +1 -1
  529. package/extensions/whatsapp/src/channel.js +429 -0
  530. package/extensions/whatsapp/src/runtime.js +10 -0
  531. package/extensions/zalo/CHANGELOG.md +5 -0
  532. package/extensions/zalo/package.json +1 -1
  533. package/extensions/zalouser/CHANGELOG.md +5 -0
  534. package/extensions/zalouser/package.json +1 -1
  535. package/package.json +1 -1
@@ -0,0 +1,118 @@
1
+ import fs from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { ensureAuthProfileStore } from "./auth-profiles.js";
4
+ import { normalizeProviderId } from "./model-selection.js";
5
+ async function readAuthJson(filePath) {
6
+ try {
7
+ const raw = await fs.readFile(filePath, "utf8");
8
+ const parsed = JSON.parse(raw);
9
+ if (!parsed || typeof parsed !== "object") {
10
+ return {};
11
+ }
12
+ return parsed;
13
+ }
14
+ catch {
15
+ return {};
16
+ }
17
+ }
18
+ /**
19
+ * Convert an OpenClaw auth-profiles credential to pi-coding-agent auth.json format.
20
+ * Returns null if the credential cannot be converted.
21
+ */
22
+ function convertCredential(cred) {
23
+ if (cred.type === "api_key") {
24
+ const key = typeof cred.key === "string" ? cred.key.trim() : "";
25
+ if (!key) {
26
+ return null;
27
+ }
28
+ return { type: "api_key", key };
29
+ }
30
+ if (cred.type === "token") {
31
+ // pi-coding-agent treats static tokens as api_key type
32
+ const token = typeof cred.token === "string" ? cred.token.trim() : "";
33
+ if (!token) {
34
+ return null;
35
+ }
36
+ const expires = typeof cred.expires === "number"
37
+ ? cred.expires
38
+ : Number.NaN;
39
+ if (Number.isFinite(expires) && expires > 0 && Date.now() >= expires) {
40
+ return null;
41
+ }
42
+ return { type: "api_key", key: token };
43
+ }
44
+ if (cred.type === "oauth") {
45
+ const accessRaw = cred.access;
46
+ const refreshRaw = cred.refresh;
47
+ const expiresRaw = cred.expires;
48
+ const access = typeof accessRaw === "string" ? accessRaw.trim() : "";
49
+ const refresh = typeof refreshRaw === "string" ? refreshRaw.trim() : "";
50
+ const expires = typeof expiresRaw === "number" ? expiresRaw : Number.NaN;
51
+ if (!access || !refresh || !Number.isFinite(expires) || expires <= 0) {
52
+ return null;
53
+ }
54
+ return { type: "oauth", access, refresh, expires };
55
+ }
56
+ return null;
57
+ }
58
+ /**
59
+ * Check if two auth.json credentials are equivalent.
60
+ */
61
+ function credentialsEqual(a, b) {
62
+ if (!a || typeof a !== "object") {
63
+ return false;
64
+ }
65
+ if (a.type !== b.type) {
66
+ return false;
67
+ }
68
+ if (a.type === "api_key" && b.type === "api_key") {
69
+ return a.key === b.key;
70
+ }
71
+ if (a.type === "oauth" && b.type === "oauth") {
72
+ return a.access === b.access && a.refresh === b.refresh && a.expires === b.expires;
73
+ }
74
+ return false;
75
+ }
76
+ /**
77
+ * pi-coding-agent's ModelRegistry/AuthStorage expects credentials in auth.json.
78
+ *
79
+ * OpenClaw stores credentials in auth-profiles.json instead. This helper
80
+ * bridges all credentials into agentDir/auth.json so pi-coding-agent can
81
+ * (a) consider providers authenticated and (b) include built-in models in its
82
+ * registry/catalog output.
83
+ *
84
+ * Syncs all credential types: api_key, token (as api_key), and oauth.
85
+ */
86
+ export async function ensurePiAuthJsonFromAuthProfiles(agentDir) {
87
+ const store = ensureAuthProfileStore(agentDir, { allowKeychainPrompt: false });
88
+ const authPath = path.join(agentDir, "auth.json");
89
+ // Group profiles by provider, taking the first valid profile for each
90
+ const providerCredentials = new Map();
91
+ for (const [, cred] of Object.entries(store.profiles)) {
92
+ const provider = normalizeProviderId(String(cred.provider ?? "")).trim();
93
+ if (!provider || providerCredentials.has(provider)) {
94
+ continue;
95
+ }
96
+ const converted = convertCredential(cred);
97
+ if (converted) {
98
+ providerCredentials.set(provider, converted);
99
+ }
100
+ }
101
+ if (providerCredentials.size === 0) {
102
+ return { wrote: false, authPath };
103
+ }
104
+ const existing = await readAuthJson(authPath);
105
+ let changed = false;
106
+ for (const [provider, cred] of providerCredentials) {
107
+ if (!credentialsEqual(existing[provider], cred)) {
108
+ existing[provider] = cred;
109
+ changed = true;
110
+ }
111
+ }
112
+ if (!changed) {
113
+ return { wrote: false, authPath };
114
+ }
115
+ await fs.mkdir(agentDir, { recursive: true, mode: 0o700 });
116
+ await fs.writeFile(authPath, `${JSON.stringify(existing, null, 2)}\n`, { mode: 0o600 });
117
+ return { wrote: true, authPath };
118
+ }
@@ -0,0 +1,147 @@
1
+ import { vi } from "vitest";
2
+ vi.mock("../auth-profiles.js", () => ({
3
+ isProfileInCooldown: vi.fn(() => false),
4
+ markAuthProfileFailure: vi.fn(async () => { }),
5
+ markAuthProfileGood: vi.fn(async () => { }),
6
+ markAuthProfileUsed: vi.fn(async () => { }),
7
+ }));
8
+ vi.mock("../usage.js", () => ({
9
+ normalizeUsage: vi.fn((usage) => usage && typeof usage === "object" ? usage : undefined),
10
+ derivePromptTokens: vi.fn((usage) => {
11
+ if (!usage) {
12
+ return undefined;
13
+ }
14
+ const input = usage.input ?? 0;
15
+ const cacheRead = usage.cacheRead ?? 0;
16
+ const cacheWrite = usage.cacheWrite ?? 0;
17
+ const sum = input + cacheRead + cacheWrite;
18
+ return sum > 0 ? sum : undefined;
19
+ }),
20
+ hasNonzeroUsage: vi.fn(() => false),
21
+ }));
22
+ vi.mock("../workspace-run.js", () => ({
23
+ resolveRunWorkspaceDir: vi.fn((params) => ({
24
+ workspaceDir: params.workspaceDir,
25
+ usedFallback: false,
26
+ fallbackReason: undefined,
27
+ agentId: "main",
28
+ })),
29
+ redactRunIdentifier: vi.fn((value) => value ?? ""),
30
+ }));
31
+ vi.mock("../pi-embedded-helpers.js", () => ({
32
+ formatBillingErrorMessage: vi.fn(() => ""),
33
+ classifyFailoverReason: vi.fn(() => null),
34
+ formatAssistantErrorText: vi.fn(() => ""),
35
+ isAuthAssistantError: vi.fn(() => false),
36
+ isBillingAssistantError: vi.fn(() => false),
37
+ isCompactionFailureError: vi.fn(() => false),
38
+ isLikelyContextOverflowError: vi.fn((msg) => {
39
+ const lower = (msg ?? "").toLowerCase();
40
+ return lower.includes("request_too_large") || lower.includes("context window exceeded");
41
+ }),
42
+ isFailoverAssistantError: vi.fn(() => false),
43
+ isFailoverErrorMessage: vi.fn(() => false),
44
+ parseImageSizeError: vi.fn(() => null),
45
+ parseImageDimensionError: vi.fn(() => null),
46
+ isRateLimitAssistantError: vi.fn(() => false),
47
+ isTimeoutErrorMessage: vi.fn(() => false),
48
+ pickFallbackThinkingLevel: vi.fn(() => null),
49
+ }));
50
+ vi.mock("./run/attempt.js", () => ({
51
+ runEmbeddedAttempt: vi.fn(),
52
+ }));
53
+ vi.mock("./compact.js", () => ({
54
+ compactEmbeddedPiSessionDirect: vi.fn(),
55
+ }));
56
+ vi.mock("./model.js", () => ({
57
+ resolveModel: vi.fn(() => ({
58
+ model: {
59
+ id: "test-model",
60
+ provider: "anthropic",
61
+ contextWindow: 200000,
62
+ api: "messages",
63
+ },
64
+ error: null,
65
+ authStorage: {
66
+ setRuntimeApiKey: vi.fn(),
67
+ },
68
+ modelRegistry: {},
69
+ })),
70
+ }));
71
+ vi.mock("../model-auth.js", () => ({
72
+ ensureAuthProfileStore: vi.fn(() => ({})),
73
+ getApiKeyForModel: vi.fn(async () => ({
74
+ apiKey: "test-key",
75
+ profileId: "test-profile",
76
+ source: "test",
77
+ })),
78
+ resolveAuthProfileOrder: vi.fn(() => []),
79
+ }));
80
+ vi.mock("../models-config.js", () => ({
81
+ ensureOpenClawModelsJson: vi.fn(async () => { }),
82
+ }));
83
+ vi.mock("../context-window-guard.js", () => ({
84
+ CONTEXT_WINDOW_HARD_MIN_TOKENS: 1000,
85
+ CONTEXT_WINDOW_WARN_BELOW_TOKENS: 5000,
86
+ evaluateContextWindowGuard: vi.fn(() => ({
87
+ shouldWarn: false,
88
+ shouldBlock: false,
89
+ tokens: 200000,
90
+ source: "model",
91
+ })),
92
+ resolveContextWindowInfo: vi.fn(() => ({
93
+ tokens: 200000,
94
+ source: "model",
95
+ })),
96
+ }));
97
+ vi.mock("../../process/command-queue.js", () => ({
98
+ enqueueCommandInLane: vi.fn((_lane, task) => task()),
99
+ }));
100
+ vi.mock("../../utils/message-channel.js", () => ({
101
+ isMarkdownCapableMessageChannel: vi.fn(() => true),
102
+ }));
103
+ vi.mock("../agent-paths.js", () => ({
104
+ resolveOpenClawAgentDir: vi.fn(() => "/tmp/agent-dir"),
105
+ }));
106
+ vi.mock("../defaults.js", () => ({
107
+ DEFAULT_CONTEXT_TOKENS: 200000,
108
+ DEFAULT_MODEL: "test-model",
109
+ DEFAULT_PROVIDER: "anthropic",
110
+ }));
111
+ vi.mock("../failover-error.js", () => ({
112
+ FailoverError: class extends Error {
113
+ },
114
+ resolveFailoverStatus: vi.fn(),
115
+ }));
116
+ vi.mock("./lanes.js", () => ({
117
+ resolveSessionLane: vi.fn(() => "session-lane"),
118
+ resolveGlobalLane: vi.fn(() => "global-lane"),
119
+ }));
120
+ vi.mock("./logger.js", () => ({
121
+ log: {
122
+ debug: vi.fn(),
123
+ info: vi.fn(),
124
+ warn: vi.fn(),
125
+ error: vi.fn(),
126
+ isEnabled: vi.fn(() => false),
127
+ },
128
+ }));
129
+ vi.mock("./run/payloads.js", () => ({
130
+ buildEmbeddedRunPayloads: vi.fn(() => []),
131
+ }));
132
+ vi.mock("./tool-result-truncation.js", () => ({
133
+ truncateOversizedToolResultsInSession: vi.fn(async () => ({
134
+ truncated: false,
135
+ truncatedCount: 0,
136
+ reason: "no oversized tool results",
137
+ })),
138
+ sessionLikelyHasOversizedToolResults: vi.fn(() => false),
139
+ }));
140
+ vi.mock("./utils.js", () => ({
141
+ describeUnknownError: vi.fn((err) => {
142
+ if (err instanceof Error) {
143
+ return err.message;
144
+ }
145
+ return String(err);
146
+ }),
147
+ }));
@@ -0,0 +1,90 @@
1
+ import { expect } from "vitest";
2
+ import { subscribeEmbeddedPiSession } from "./pi-embedded-subscribe.js";
3
+ export function createStubSessionHarness() {
4
+ let handler;
5
+ const session = {
6
+ subscribe: (fn) => {
7
+ handler = fn;
8
+ return () => { };
9
+ },
10
+ };
11
+ return { session, emit: (evt) => handler?.(evt) };
12
+ }
13
+ export function createSubscribedSessionHarness(params) {
14
+ const { sessionExtras, ...subscribeParams } = params;
15
+ const { session, emit } = createStubSessionHarness();
16
+ const mergedSession = Object.assign(session, sessionExtras ?? {});
17
+ const subscription = subscribeEmbeddedPiSession({
18
+ ...subscribeParams,
19
+ session: mergedSession,
20
+ });
21
+ return { emit, session: mergedSession, subscription };
22
+ }
23
+ export function createParagraphChunkedBlockReplyHarness(params) {
24
+ const onBlockReply = params.onBlockReply ?? (() => { });
25
+ const { emit, subscription } = createSubscribedSessionHarness({
26
+ runId: params.runId ?? "run",
27
+ onBlockReply,
28
+ blockReplyBreak: "message_end",
29
+ blockReplyChunking: {
30
+ ...params.chunking,
31
+ breakPreference: "paragraph",
32
+ },
33
+ });
34
+ return { emit, onBlockReply, subscription };
35
+ }
36
+ export function extractAgentEventPayloads(calls) {
37
+ return calls
38
+ .map((call) => {
39
+ const first = call?.[0];
40
+ const data = first?.data;
41
+ return data && typeof data === "object" ? data : undefined;
42
+ })
43
+ .filter((value) => Boolean(value));
44
+ }
45
+ export function extractTextPayloads(calls) {
46
+ return calls
47
+ .map((call) => {
48
+ const payload = call?.[0];
49
+ return typeof payload?.text === "string" ? payload.text : undefined;
50
+ })
51
+ .filter((text) => Boolean(text));
52
+ }
53
+ export function emitMessageStartAndEndForAssistantText(params) {
54
+ const assistantMessage = {
55
+ role: "assistant",
56
+ content: [{ type: "text", text: params.text }],
57
+ };
58
+ params.emit({ type: "message_start", message: assistantMessage });
59
+ params.emit({ type: "message_end", message: assistantMessage });
60
+ }
61
+ export function emitAssistantTextDeltaAndEnd(params) {
62
+ params.emit({
63
+ type: "message_update",
64
+ message: { role: "assistant" },
65
+ assistantMessageEvent: {
66
+ type: "text_delta",
67
+ delta: params.text,
68
+ },
69
+ });
70
+ const assistantMessage = {
71
+ role: "assistant",
72
+ content: [{ type: "text", text: params.text }],
73
+ };
74
+ params.emit({ type: "message_end", message: assistantMessage });
75
+ }
76
+ export function expectFencedChunks(calls, expectedPrefix) {
77
+ expect(calls.length).toBeGreaterThan(1);
78
+ for (const call of calls) {
79
+ const chunk = call[0]?.text;
80
+ expect(typeof chunk === "string" && chunk.startsWith(expectedPrefix)).toBe(true);
81
+ const fenceCount = typeof chunk === "string" ? (chunk.match(/```/g)?.length ?? 0) : 0;
82
+ expect(fenceCount).toBeGreaterThanOrEqual(2);
83
+ }
84
+ }
85
+ export function expectSingleAgentEventText(calls, text) {
86
+ const payloads = extractAgentEventPayloads(calls);
87
+ expect(payloads).toHaveLength(1);
88
+ expect(payloads[0]?.text).toBe(text);
89
+ expect(payloads[0]?.delta).toBe(text);
90
+ }
@@ -0,0 +1,63 @@
1
+ import { emitAgentEvent } from "../infra/agent-events.js";
2
+ import { getGlobalHookRunner } from "../plugins/hook-runner-global.js";
3
+ export function handleAutoCompactionStart(ctx) {
4
+ ctx.state.compactionInFlight = true;
5
+ ctx.incrementCompactionCount();
6
+ ctx.ensureCompactionPromise();
7
+ ctx.log.debug(`embedded run compaction start: runId=${ctx.params.runId}`);
8
+ emitAgentEvent({
9
+ runId: ctx.params.runId,
10
+ stream: "compaction",
11
+ data: { phase: "start" },
12
+ });
13
+ void ctx.params.onAgentEvent?.({
14
+ stream: "compaction",
15
+ data: { phase: "start" },
16
+ });
17
+ // Run before_compaction plugin hook (fire-and-forget)
18
+ const hookRunner = getGlobalHookRunner();
19
+ if (hookRunner?.hasHooks("before_compaction")) {
20
+ void hookRunner
21
+ .runBeforeCompaction({
22
+ messageCount: ctx.params.session.messages?.length ?? 0,
23
+ }, {})
24
+ .catch((err) => {
25
+ ctx.log.warn(`before_compaction hook failed: ${String(err)}`);
26
+ });
27
+ }
28
+ }
29
+ export function handleAutoCompactionEnd(ctx, evt) {
30
+ ctx.state.compactionInFlight = false;
31
+ const willRetry = Boolean(evt.willRetry);
32
+ if (willRetry) {
33
+ ctx.noteCompactionRetry();
34
+ ctx.resetForCompactionRetry();
35
+ ctx.log.debug(`embedded run compaction retry: runId=${ctx.params.runId}`);
36
+ }
37
+ else {
38
+ ctx.maybeResolveCompactionWait();
39
+ }
40
+ emitAgentEvent({
41
+ runId: ctx.params.runId,
42
+ stream: "compaction",
43
+ data: { phase: "end", willRetry },
44
+ });
45
+ void ctx.params.onAgentEvent?.({
46
+ stream: "compaction",
47
+ data: { phase: "end", willRetry },
48
+ });
49
+ // Run after_compaction plugin hook (fire-and-forget)
50
+ if (!willRetry) {
51
+ const hookRunnerEnd = getGlobalHookRunner();
52
+ if (hookRunnerEnd?.hasHooks("after_compaction")) {
53
+ void hookRunnerEnd
54
+ .runAfterCompaction({
55
+ messageCount: ctx.params.session.messages?.length ?? 0,
56
+ compactedCount: ctx.getCompactionCount(),
57
+ }, {})
58
+ .catch((err) => {
59
+ ctx.log.warn(`after_compaction hook failed: ${String(err)}`);
60
+ });
61
+ }
62
+ }
63
+ }
@@ -0,0 +1,30 @@
1
+ import { handleToolExecutionEnd, handleToolExecutionStart, } from "./pi-embedded-subscribe.handlers.tools.js";
2
+ /** Type-safe bridge: narrows parameter type so callers avoid assertions. */
3
+ function asFullContext(ctx) {
4
+ return ctx;
5
+ }
6
+ /** Typed wrapper around {@link handleToolExecutionStart}. */
7
+ export function callToolExecutionStart(ctx, evt) {
8
+ return handleToolExecutionStart(asFullContext(ctx), evt);
9
+ }
10
+ /** Typed wrapper around {@link handleToolExecutionEnd}. */
11
+ export async function callToolExecutionEnd(ctx, evt) {
12
+ return handleToolExecutionEnd(asFullContext(ctx), evt);
13
+ }
14
+ /**
15
+ * Check whether a mock-call argument is an object containing `mediaUrls`
16
+ * but NOT `text` (i.e. a "direct media" emission).
17
+ */
18
+ export function isDirectMediaCall(call) {
19
+ const arg = call[0];
20
+ if (!arg || typeof arg !== "object") {
21
+ return false;
22
+ }
23
+ return "mediaUrls" in arg && !("text" in arg);
24
+ }
25
+ /**
26
+ * Filter a vi.fn() mock's call log to only direct-media emissions.
27
+ */
28
+ export function filterDirectMediaCalls(mock) {
29
+ return mock.mock.calls.filter(isDirectMediaCall);
30
+ }
@@ -0,0 +1,23 @@
1
+ export function createSessionManagerRuntimeRegistry() {
2
+ // Session-scoped runtime registry keyed by object identity.
3
+ // The SessionManager instance must stay stable across set/get calls.
4
+ const registry = new WeakMap();
5
+ const set = (sessionManager, value) => {
6
+ if (!sessionManager || typeof sessionManager !== "object") {
7
+ return;
8
+ }
9
+ const key = sessionManager;
10
+ if (value === null) {
11
+ registry.delete(key);
12
+ return;
13
+ }
14
+ registry.set(key, value);
15
+ };
16
+ const get = (sessionManager) => {
17
+ if (!sessionManager || typeof sessionManager !== "object") {
18
+ return null;
19
+ }
20
+ return registry.get(sessionManager) ?? null;
21
+ };
22
+ return { set, get };
23
+ }
@@ -3,13 +3,108 @@ import { getGlobalHookRunner } from "../plugins/hook-runner-global.js";
3
3
  import { isPlainObject } from "../utils.js";
4
4
  import { normalizeToolName } from "./tool-policy.js";
5
5
  const log = createSubsystemLogger("agents/tools");
6
+ const BEFORE_TOOL_CALL_WRAPPED = Symbol("beforeToolCallWrapped");
7
+ const adjustedParamsByToolCallId = new Map();
8
+ const MAX_TRACKED_ADJUSTED_PARAMS = 1024;
9
+ const LOOP_WARNING_BUCKET_SIZE = 10;
10
+ const MAX_LOOP_WARNING_KEYS = 256;
11
+ function shouldEmitLoopWarning(state, warningKey, count) {
12
+ if (!state.toolLoopWarningBuckets) {
13
+ state.toolLoopWarningBuckets = new Map();
14
+ }
15
+ const bucket = Math.floor(count / LOOP_WARNING_BUCKET_SIZE);
16
+ const lastBucket = state.toolLoopWarningBuckets.get(warningKey) ?? 0;
17
+ if (bucket <= lastBucket) {
18
+ return false;
19
+ }
20
+ state.toolLoopWarningBuckets.set(warningKey, bucket);
21
+ if (state.toolLoopWarningBuckets.size > MAX_LOOP_WARNING_KEYS) {
22
+ const oldest = state.toolLoopWarningBuckets.keys().next().value;
23
+ if (oldest) {
24
+ state.toolLoopWarningBuckets.delete(oldest);
25
+ }
26
+ }
27
+ return true;
28
+ }
29
+ async function recordLoopOutcome(args) {
30
+ if (!args.ctx?.sessionKey) {
31
+ return;
32
+ }
33
+ try {
34
+ const { getDiagnosticSessionState } = await import("../logging/diagnostic-session-state.js");
35
+ const { recordToolCallOutcome } = await import("./tool-loop-detection.js");
36
+ const sessionState = getDiagnosticSessionState({
37
+ sessionKey: args.ctx.sessionKey,
38
+ sessionId: args.ctx?.agentId,
39
+ });
40
+ recordToolCallOutcome(sessionState, {
41
+ toolName: args.toolName,
42
+ toolParams: args.toolParams,
43
+ toolCallId: args.toolCallId,
44
+ result: args.result,
45
+ error: args.error,
46
+ config: args.ctx.loopDetection,
47
+ });
48
+ }
49
+ catch (err) {
50
+ log.warn(`tool loop outcome tracking failed: tool=${args.toolName} error=${String(err)}`);
51
+ }
52
+ }
6
53
  export async function runBeforeToolCallHook(args) {
54
+ const toolName = normalizeToolName(args.toolName || "tool");
55
+ const params = args.params;
56
+ if (args.ctx?.sessionKey) {
57
+ const { getDiagnosticSessionState } = await import("../logging/diagnostic-session-state.js");
58
+ const { logToolLoopAction } = await import("../logging/diagnostic.js");
59
+ const { detectToolCallLoop, recordToolCall } = await import("./tool-loop-detection.js");
60
+ const sessionState = getDiagnosticSessionState({
61
+ sessionKey: args.ctx.sessionKey,
62
+ sessionId: args.ctx?.agentId,
63
+ });
64
+ const loopResult = detectToolCallLoop(sessionState, toolName, params, args.ctx.loopDetection);
65
+ if (loopResult.stuck) {
66
+ if (loopResult.level === "critical") {
67
+ log.error(`Blocking ${toolName} due to critical loop: ${loopResult.message}`);
68
+ logToolLoopAction({
69
+ sessionKey: args.ctx.sessionKey,
70
+ sessionId: args.ctx?.agentId,
71
+ toolName,
72
+ level: "critical",
73
+ action: "block",
74
+ detector: loopResult.detector,
75
+ count: loopResult.count,
76
+ message: loopResult.message,
77
+ pairedToolName: loopResult.pairedToolName,
78
+ });
79
+ return {
80
+ blocked: true,
81
+ reason: loopResult.message,
82
+ };
83
+ }
84
+ else {
85
+ const warningKey = loopResult.warningKey ?? `${loopResult.detector}:${toolName}`;
86
+ if (shouldEmitLoopWarning(sessionState, warningKey, loopResult.count)) {
87
+ log.warn(`Loop warning for ${toolName}: ${loopResult.message}`);
88
+ logToolLoopAction({
89
+ sessionKey: args.ctx.sessionKey,
90
+ sessionId: args.ctx?.agentId,
91
+ toolName,
92
+ level: "warning",
93
+ action: "warn",
94
+ detector: loopResult.detector,
95
+ count: loopResult.count,
96
+ message: loopResult.message,
97
+ pairedToolName: loopResult.pairedToolName,
98
+ });
99
+ }
100
+ }
101
+ }
102
+ recordToolCall(sessionState, toolName, params, args.toolCallId, args.ctx.loopDetection);
103
+ }
7
104
  const hookRunner = getGlobalHookRunner();
8
105
  if (!hookRunner?.hasHooks("before_tool_call")) {
9
106
  return { blocked: false, params: args.params };
10
107
  }
11
- const toolName = normalizeToolName(args.toolName || "tool");
12
- const params = args.params;
13
108
  try {
14
109
  const normalizedParams = isPlainObject(params) ? params : {};
15
110
  const hookResult = await hookRunner.runBeforeToolCall({
@@ -45,7 +140,7 @@ export function wrapToolWithBeforeToolCallHook(tool, ctx) {
45
140
  return tool;
46
141
  }
47
142
  const toolName = tool.name || "tool";
48
- return {
143
+ const wrappedTool = {
49
144
  ...tool,
50
145
  execute: async (toolCallId, params, signal, onUpdate) => {
51
146
  const outcome = await runBeforeToolCallHook({
@@ -57,11 +152,57 @@ export function wrapToolWithBeforeToolCallHook(tool, ctx) {
57
152
  if (outcome.blocked) {
58
153
  throw new Error(outcome.reason);
59
154
  }
60
- return await execute(toolCallId, outcome.params, signal, onUpdate);
155
+ if (toolCallId) {
156
+ adjustedParamsByToolCallId.set(toolCallId, outcome.params);
157
+ if (adjustedParamsByToolCallId.size > MAX_TRACKED_ADJUSTED_PARAMS) {
158
+ const oldest = adjustedParamsByToolCallId.keys().next().value;
159
+ if (oldest) {
160
+ adjustedParamsByToolCallId.delete(oldest);
161
+ }
162
+ }
163
+ }
164
+ const normalizedToolName = normalizeToolName(toolName || "tool");
165
+ try {
166
+ const result = await execute(toolCallId, outcome.params, signal, onUpdate);
167
+ await recordLoopOutcome({
168
+ ctx,
169
+ toolName: normalizedToolName,
170
+ toolParams: outcome.params,
171
+ toolCallId,
172
+ result,
173
+ });
174
+ return result;
175
+ }
176
+ catch (err) {
177
+ await recordLoopOutcome({
178
+ ctx,
179
+ toolName: normalizedToolName,
180
+ toolParams: outcome.params,
181
+ toolCallId,
182
+ error: err,
183
+ });
184
+ throw err;
185
+ }
61
186
  },
62
187
  };
188
+ Object.defineProperty(wrappedTool, BEFORE_TOOL_CALL_WRAPPED, {
189
+ value: true,
190
+ enumerable: false,
191
+ });
192
+ return wrappedTool;
193
+ }
194
+ export function isToolWrappedWithBeforeToolCallHook(tool) {
195
+ const taggedTool = tool;
196
+ return taggedTool[BEFORE_TOOL_CALL_WRAPPED] === true;
197
+ }
198
+ export function consumeAdjustedParamsForToolCall(toolCallId) {
199
+ const params = adjustedParamsByToolCallId.get(toolCallId);
200
+ adjustedParamsByToolCallId.delete(toolCallId);
201
+ return params;
63
202
  }
64
203
  export const __testing = {
204
+ BEFORE_TOOL_CALL_WRAPPED,
205
+ adjustedParamsByToolCallId,
65
206
  runBeforeToolCallHook,
66
207
  isPlainObject,
67
208
  };