typeclaw 0.48.13 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +13 -6
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/dump-system-prompt.ts +52 -110
  317. package/scripts/require-parallel.ts +5 -32
  318. package/src/agent/guard-types.ts +3 -0
  319. package/src/agent/guards.ts +4 -0
  320. package/src/agent/idle-compaction.ts +174 -0
  321. package/src/agent/index.ts +210 -80
  322. package/src/agent/live-sessions.ts +2 -2
  323. package/src/agent/live-subagents.ts +20 -0
  324. package/src/agent/multimodal/look-at.ts +22 -9
  325. package/src/agent/plugin-tools.ts +66 -12
  326. package/src/agent/prompt-cache-key.ts +42 -0
  327. package/src/agent/provider-error.ts +179 -10
  328. package/src/agent/restart-handoff/index.ts +7 -14
  329. package/src/agent/reviewer-activity.ts +68 -0
  330. package/src/agent/reviewer-bash-policy.ts +41 -1
  331. package/src/agent/session-origin.ts +58 -9
  332. package/src/agent/subagent-cache-keepalive.ts +198 -0
  333. package/src/agent/subagent-session.ts +6 -0
  334. package/src/agent/subagents.ts +59 -9
  335. package/src/agent/system-prompt.ts +68 -202
  336. package/src/agent/todo/continuation-policy.ts +12 -4
  337. package/src/agent/tool-file-safety.ts +119 -15
  338. package/src/agent/tool-not-found-nudge.ts +1 -1
  339. package/src/agent/tools/channel-edit.ts +20 -10
  340. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  341. package/src/agent/tools/channel-handoff.ts +72 -0
  342. package/src/agent/tools/channel-history-render.ts +2 -1
  343. package/src/agent/tools/channel-read.ts +57 -10
  344. package/src/agent/tools/channel-reply.ts +55 -30
  345. package/src/agent/tools/channel-send.ts +69 -19
  346. package/src/agent/tools/channel-session-search.ts +35 -0
  347. package/src/agent/tools/curl-impersonate.ts +22 -6
  348. package/src/agent/tools/ddg.ts +13 -5
  349. package/src/agent/tools/post-github-review.ts +77 -15
  350. package/src/agent/tools/skip-response.ts +2 -2
  351. package/src/agent/tools/spawn-subagent.ts +190 -23
  352. package/src/agent/tools/stream-snapshot.ts +15 -2
  353. package/src/agent/tools/subagent-access.ts +11 -4
  354. package/src/agent/tools/subagent-output.ts +8 -0
  355. package/src/browser/bsk-shim.mjs +74 -0
  356. package/src/browser/dockerfile.ts +84 -0
  357. package/src/browser/egress.ts +104 -0
  358. package/src/browser/managed-browser.ts +205 -0
  359. package/src/browser/registry.ts +110 -0
  360. package/src/browser/relay.ts +231 -0
  361. package/src/browser/sandbox-entry.ts +167 -0
  362. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  363. package/src/bundled-plugins/backup/README.md +10 -9
  364. package/src/bundled-plugins/backup/runner.ts +140 -58
  365. package/src/bundled-plugins/backup/subagents.ts +58 -26
  366. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  367. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  368. package/src/bundled-plugins/doc-render/index.ts +0 -10
  369. package/src/bundled-plugins/doc-render/render.ts +83 -111
  370. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  371. package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
  372. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  373. package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
  374. package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
  375. package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
  376. package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
  377. package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
  378. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  379. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  380. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  381. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  382. package/src/bundled-plugins/operator/operator.ts +15 -4
  383. package/src/bundled-plugins/qa/index.ts +11 -0
  384. package/src/bundled-plugins/qa/qa.ts +160 -0
  385. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  386. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  387. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  388. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  389. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  390. package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
  391. package/src/bundled-plugins/security/index.ts +103 -36
  392. package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
  393. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  394. package/src/channels/adapter-namespace.ts +13 -0
  395. package/src/channels/adapters/discord-bot-reactions.ts +18 -0
  396. package/src/channels/adapters/discord-bot.ts +219 -72
  397. package/src/channels/adapters/discord-reactions.ts +18 -0
  398. package/src/channels/adapters/discord.ts +114 -8
  399. package/src/channels/adapters/github/inbound.ts +103 -8
  400. package/src/channels/adapters/github/index.ts +267 -19
  401. package/src/channels/adapters/github/last-alive.ts +15 -0
  402. package/src/channels/adapters/github/outbound.ts +54 -18
  403. package/src/channels/adapters/github/pending-review-store.ts +141 -0
  404. package/src/channels/adapters/github/permission-guidance.ts +1 -0
  405. package/src/channels/adapters/github/reactions.ts +100 -0
  406. package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
  407. package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
  408. package/src/channels/adapters/github/recovery.ts +106 -0
  409. package/src/channels/adapters/github/review-check.ts +510 -0
  410. package/src/channels/adapters/github/review-submitter.ts +34 -2
  411. package/src/channels/adapters/instagram.ts +32 -14
  412. package/src/channels/adapters/kakaotalk.ts +22 -7
  413. package/src/channels/adapters/line.ts +18 -3
  414. package/src/channels/adapters/outbound-account.ts +20 -0
  415. package/src/channels/adapters/own-reactions.ts +66 -0
  416. package/src/channels/adapters/recovery-correlation.ts +214 -0
  417. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  418. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  419. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  420. package/src/channels/adapters/slack-bot-classify.ts +19 -11
  421. package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
  422. package/src/channels/adapters/slack-bot-reactions.ts +18 -0
  423. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  424. package/src/channels/adapters/slack-bot.ts +424 -124
  425. package/src/channels/adapters/slack-classify.ts +26 -4
  426. package/src/channels/adapters/slack-inbound-revision.ts +96 -0
  427. package/src/channels/adapters/slack-reactions.ts +18 -0
  428. package/src/channels/adapters/slack-thread-ts.ts +6 -0
  429. package/src/channels/adapters/slack.ts +48 -3
  430. package/src/channels/adapters/teams.ts +14 -4
  431. package/src/channels/adapters/telegram-bot.ts +56 -10
  432. package/src/channels/adapters/webex-bot.ts +12 -2
  433. package/src/channels/adapters/webex.ts +12 -2
  434. package/src/channels/background-handoff.ts +434 -0
  435. package/src/channels/background-obligations.ts +893 -0
  436. package/src/channels/catch-up.ts +137 -0
  437. package/src/channels/continuation-willingness.ts +2 -2
  438. package/src/channels/continuity-types.ts +272 -0
  439. package/src/channels/engagement.ts +17 -1
  440. package/src/channels/github-false-receipt.ts +3 -3
  441. package/src/channels/github-rereview-guard.ts +9 -5
  442. package/src/channels/github-review-check.ts +598 -0
  443. package/src/channels/github-review-turn-ledger.ts +102 -28
  444. package/src/channels/github-review-verdict-coordinator.ts +72 -12
  445. package/src/channels/github-token-bridge.ts +35 -5
  446. package/src/channels/inbound-journal.ts +1738 -0
  447. package/src/channels/index.ts +6 -1
  448. package/src/channels/last-alive.ts +34 -0
  449. package/src/channels/manager.ts +25 -8
  450. package/src/channels/recovery-dispatcher.ts +264 -0
  451. package/src/channels/recovery-notice.ts +94 -0
  452. package/src/channels/recovery-outbox.ts +459 -0
  453. package/src/channels/router.ts +2951 -736
  454. package/src/channels/schema.ts +8 -1
  455. package/src/channels/session-handoff.fixture.ts +144 -0
  456. package/src/channels/session-handoff.ts +175 -0
  457. package/src/channels/session-search.ts +71 -0
  458. package/src/channels/subagent-completion-bridge.ts +17 -14
  459. package/src/channels/types.ts +133 -18
  460. package/src/channels/waiting-reactions.ts +664 -0
  461. package/src/cli/channel.ts +2 -3
  462. package/src/cli/compose.ts +7 -4
  463. package/src/cli/hostd.ts +49 -3
  464. package/src/cli/init.ts +2 -3
  465. package/src/cli/inspect.ts +11 -14
  466. package/src/cli/model.ts +132 -3
  467. package/src/coding-agent/broker-body.ts +38 -0
  468. package/src/coding-agent/broker.ts +290 -0
  469. package/src/coding-agent/claude.ts +95 -0
  470. package/src/coding-agent/codex.ts +104 -0
  471. package/src/coding-agent/index.ts +512 -0
  472. package/src/coding-agent/omo-state.ts +69 -0
  473. package/src/coding-agent/omo-stream.ts +138 -0
  474. package/src/coding-agent/omo.ts +192 -0
  475. package/src/coding-agent/runner.ts +285 -0
  476. package/src/coding-agent/tool.ts +62 -0
  477. package/src/coding-agent/worktree.ts +355 -0
  478. package/src/compose/restart.ts +10 -3
  479. package/src/compose/start.ts +20 -3
  480. package/src/config/config.ts +121 -25
  481. package/src/config/model-overrides.ts +59 -0
  482. package/src/config/models-mutation.ts +185 -2
  483. package/src/config/providers-mutation.ts +12 -4
  484. package/src/config/providers.ts +71 -9
  485. package/src/container/exit-reason.ts +44 -0
  486. package/src/container/index.ts +5 -0
  487. package/src/container/log-archive.ts +51 -13
  488. package/src/container/memory-limit.ts +1 -1
  489. package/src/container/memory-oversubscription.ts +36 -6
  490. package/src/container/oom-events.ts +86 -0
  491. package/src/container/restart.ts +2 -0
  492. package/src/container/shared.ts +8 -1
  493. package/src/container/start.ts +120 -17
  494. package/src/container/stop.ts +6 -2
  495. package/src/container/tool-oom-priority.ts +32 -0
  496. package/src/cron/consumer.ts +10 -4
  497. package/src/cron/reloadable.ts +23 -2
  498. package/src/doctor/checks.ts +22 -8
  499. package/src/hostd/daemon.ts +33 -11
  500. package/src/hostd/spawn.ts +106 -5
  501. package/src/hostd/version.ts +20 -0
  502. package/src/hostd/watchdog.ts +241 -0
  503. package/src/init/auto-upgrade.ts +7 -1
  504. package/src/init/dockerfile.ts +112 -602
  505. package/src/init/index.ts +6 -6
  506. package/src/init/local-source-stamp.ts +68 -0
  507. package/src/init/models-dev.ts +4 -0
  508. package/src/init/validate-api-key.ts +3 -0
  509. package/src/mcp/client.ts +3 -1
  510. package/src/operations/classify-tool-outcome.ts +45 -1
  511. package/src/operations/incidents.ts +10 -5
  512. package/src/permissions/builtins.ts +7 -0
  513. package/src/permissions/permissions.ts +18 -9
  514. package/src/permissions/resolve.ts +7 -1
  515. package/src/plugin/context.ts +2 -0
  516. package/src/plugin/core-tool-names.ts +1 -1
  517. package/src/plugin/define.ts +1 -0
  518. package/src/plugin/hooks.ts +137 -0
  519. package/src/plugin/index.ts +7 -0
  520. package/src/plugin/manager.ts +4 -0
  521. package/src/plugin/types.ts +66 -1
  522. package/src/run/background-handoff-boot.ts +86 -0
  523. package/src/run/bundled-plugins.ts +6 -0
  524. package/src/run/index.ts +107 -97
  525. package/src/run/llm-fetch-observer.ts +12 -15
  526. package/src/run/resource-sample.ts +19 -0
  527. package/src/sandbox/build.ts +4 -0
  528. package/src/sandbox/canonical-secrets.ts +4 -0
  529. package/src/sandbox/coding-agent.ts +214 -0
  530. package/src/sandbox/dev-source.ts +26 -0
  531. package/src/sandbox/hidden-paths.ts +16 -2
  532. package/src/sandbox/policy.ts +1 -0
  533. package/src/sandbox/runtime-private.ts +4 -1
  534. package/src/secrets/coding-agent-auth.ts +97 -0
  535. package/src/secrets/index.ts +0 -16
  536. package/src/secrets/storage.ts +13 -0
  537. package/src/server/command-runner.ts +6 -2
  538. package/src/server/index.ts +101 -40
  539. package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
  540. package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
  541. package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
  542. package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
  543. package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
  544. package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
  545. package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
  546. package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
  547. package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
  548. package/src/skills/typeclaw-config/SKILL.md +60 -26
  549. package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
  550. package/src/skills/typeclaw-cron/SKILL.md +1 -1
  551. package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
  552. package/src/skills/typeclaw-memory/SKILL.md +3 -3
  553. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  554. package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
  555. package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
  556. package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
  557. package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
  558. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  559. package/src/skills/typeclaw-plugins/SKILL.md +15 -15
  560. package/src/skills/typeclaw-skills/SKILL.md +19 -2
  561. package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
  562. package/typeclaw.schema.json +448 -6
  563. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  564. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
  565. package/src/secrets/claude-credentials-json.ts +0 -129
  566. package/src/secrets/codex-auth-json.ts +0 -102
  567. package/src/secrets/export-claude-credentials-file.ts +0 -270
  568. package/src/secrets/export-codex-auth-file.ts +0 -250
  569. package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
  570. package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
  571. package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
  572. package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
@@ -0,0 +1,664 @@
1
+ import { createHash, randomUUID } from 'node:crypto'
2
+ import { closeSync, fsyncSync, mkdirSync, openSync, readFileSync, renameSync, unlinkSync, writeFileSync } from 'node:fs'
3
+ import { readdir } from 'node:fs/promises'
4
+ import { join } from 'node:path'
5
+ import { setImmediate } from 'node:timers/promises'
6
+
7
+ import type {
8
+ ChannelKey,
9
+ OwnReactionTarget,
10
+ ReactionRef,
11
+ ReactionRequest,
12
+ ReactionResult,
13
+ RemoveOwnReactionRequest,
14
+ RemoveOwnReactionResult,
15
+ } from './types'
16
+
17
+ export interface WaitingReactionHandle {
18
+ readonly req: ReactionRequest
19
+ readonly ownerId: string
20
+ readonly ready: Promise<ReactionRef | null>
21
+ readonly generation: number
22
+ readonly epoch: string
23
+ }
24
+
25
+ export interface ProtectedAcknowledgmentScope {
26
+ conversation: ChannelKey
27
+ kind: string
28
+ }
29
+
30
+ interface ProtectedAcknowledgmentIdentity extends ProtectedAcknowledgmentScope {
31
+ id: string
32
+ target: ReactionRef
33
+ emoji: string
34
+ }
35
+
36
+ function sameConversation(first: ChannelKey, second: ChannelKey): boolean {
37
+ return (
38
+ first.adapter === second.adapter &&
39
+ first.workspace === second.workspace &&
40
+ first.chat === second.chat &&
41
+ (first.thread ?? null) === (second.thread ?? null)
42
+ )
43
+ }
44
+
45
+ function acknowledgmentIdentity(
46
+ scope: ProtectedAcknowledgmentScope,
47
+ prepared: OwnReactionTarget,
48
+ ): ProtectedAcknowledgmentIdentity {
49
+ const conversation = { ...scope.conversation, thread: scope.conversation.thread ?? null }
50
+ const target = { ...prepared.target }
51
+ return {
52
+ conversation,
53
+ kind: scope.kind,
54
+ target,
55
+ emoji: prepared.emoji,
56
+ id: createHash('sha256')
57
+ .update(
58
+ JSON.stringify([
59
+ conversation.adapter,
60
+ conversation.workspace,
61
+ conversation.chat,
62
+ conversation.thread,
63
+ target.adapter,
64
+ target.value,
65
+ prepared.emoji,
66
+ scope.kind,
67
+ ]),
68
+ )
69
+ .digest('hex'),
70
+ }
71
+ }
72
+
73
+ interface Owner {
74
+ ownerId: string
75
+ generation: number
76
+ epoch: string
77
+ protected: boolean
78
+ acknowledgment?: ProtectedAcknowledgmentIdentity
79
+ }
80
+ interface TupleRecord {
81
+ schemaVersion: 1
82
+ desired: 'present' | 'absent'
83
+ key: string
84
+ req: ReactionRequest
85
+ prepared: OwnReactionTarget
86
+ generation: number
87
+ owners: Owner[]
88
+ phase: 'adding' | 'present' | 'removing' | 'blocked' | 'absent'
89
+ failure?: RemoveOwnReactionResult
90
+ retryAt?: number
91
+ }
92
+ interface Reservation {
93
+ handle: WaitingReactionHandle
94
+ protected: boolean
95
+ acknowledgmentScope?: ProtectedAcknowledgmentScope
96
+ released: boolean
97
+ key?: string
98
+ prepared?: OwnReactionTarget
99
+ preparation: Promise<void>
100
+ }
101
+
102
+ /** One runtime owns this journal. A new epoch takes over only after the old runtime stops. */
103
+ export function createWaitingReactionCoordinator(options: {
104
+ agentDir: string
105
+ epoch?: string
106
+ add: (req: ReactionRequest, prepared: OwnReactionTarget) => Promise<ReactionResult>
107
+ prepare: (req: ReactionRequest) => Promise<OwnReactionTarget | null>
108
+ remove: (req: RemoveOwnReactionRequest) => Promise<RemoveOwnReactionResult>
109
+ }) {
110
+ const epoch = options.epoch ?? randomUUID()
111
+ const directory = join(options.agentDir, 'channels', 'waiting-reactions')
112
+ let ownerGeneration = 0
113
+ const reservations = new Map<string, Reservation>()
114
+ const tupleReservations = new Map<string, Set<Reservation>>()
115
+ const preparing = new Set<Reservation>()
116
+ const retiredOwners = new Set<string>()
117
+ const lanes = new Map<string, Promise<unknown>>()
118
+ const snapshots = new WeakMap<TupleRecord, string>()
119
+
120
+ function lane<T>(key: string, operation: () => Promise<T>): Promise<T> {
121
+ const next = (lanes.get(key) ?? Promise.resolve()).catch(() => {}).then(operation)
122
+ lanes.set(key, next)
123
+ void next
124
+ .finally(() => {
125
+ if (lanes.get(key) === next) lanes.delete(key)
126
+ })
127
+ .catch(() => {})
128
+ return next
129
+ }
130
+
131
+ function path(key: string): string {
132
+ return join(directory, `${key}.json`)
133
+ }
134
+
135
+ function syncDirectory(directoryPath: string): void {
136
+ // Windows dev cannot fsync directories; ordinary file fsync remains mandatory.
137
+ if (process.platform === 'win32') return
138
+ const fd = openSync(directoryPath, 'r')
139
+ try {
140
+ fsyncSync(fd)
141
+ } finally {
142
+ closeSync(fd)
143
+ }
144
+ }
145
+
146
+ function saveIfChanged(record: TupleRecord): void {
147
+ record.desired = record.owners.length > 0 ? 'present' : 'absent'
148
+ if (snapshots.get(record) !== JSON.stringify(record)) save(record)
149
+ }
150
+
151
+ function retireAbsent(record: TupleRecord): void {
152
+ if (record.phase !== 'absent' || record.owners.length > 0 || live(record.key).length > 0) return
153
+ if ([...preparing].some((owner) => !owner.released && owner.handle.req.adapter === record.req.adapter)) return
154
+ const latest = load(record.key)
155
+ if (
156
+ !latest ||
157
+ latest.phase !== 'absent' ||
158
+ latest.generation !== record.generation ||
159
+ latest.owners.length > 0 ||
160
+ live(record.key).length > 0
161
+ )
162
+ return
163
+ try {
164
+ unlinkSync(path(record.key))
165
+ } catch (error) {
166
+ if ((error as NodeJS.ErrnoException).code === 'ENOENT') return
167
+ throw error
168
+ }
169
+ syncDirectory(directory)
170
+ }
171
+
172
+ function save(record: TupleRecord): void {
173
+ record.desired = record.owners.length > 0 ? 'present' : 'absent'
174
+ const createdDirectory = mkdirSync(directory, { recursive: true, mode: 0o700 })
175
+ const temp = join(directory, `${record.key}.${randomUUID()}.tmp`)
176
+ try {
177
+ const fd = openSync(temp, 'wx', 0o600)
178
+ try {
179
+ writeFileSync(fd, JSON.stringify(record))
180
+ fsyncSync(fd)
181
+ } finally {
182
+ closeSync(fd)
183
+ }
184
+ renameSync(temp, path(record.key))
185
+ syncDirectory(directory)
186
+ if (createdDirectory) {
187
+ for (const parent of [join(options.agentDir, 'channels'), options.agentDir]) {
188
+ syncDirectory(parent)
189
+ }
190
+ }
191
+ snapshots.set(record, JSON.stringify(record))
192
+ } catch (error) {
193
+ try {
194
+ unlinkSync(temp)
195
+ } catch (cleanupError) {
196
+ if ((cleanupError as NodeJS.ErrnoException).code !== 'ENOENT') report(cleanupError)
197
+ }
198
+ throw error
199
+ }
200
+ }
201
+
202
+ function load(key: string): TupleRecord | undefined {
203
+ try {
204
+ const record = JSON.parse(readFileSync(path(key), 'utf8')) as TupleRecord
205
+ const validRef = (ref: ReactionRef | undefined) =>
206
+ ref !== null &&
207
+ typeof ref === 'object' &&
208
+ typeof ref.adapter === 'string' &&
209
+ typeof ref.value === 'string' &&
210
+ ref.value.length > 0
211
+ const validString = (value: unknown) => typeof value === 'string' && value.length > 0
212
+ const validAcknowledgment = (owner: Owner): boolean => {
213
+ const acknowledgment = owner.acknowledgment
214
+ if (acknowledgment === undefined) return true
215
+ if (
216
+ !owner.protected ||
217
+ !acknowledgment ||
218
+ !validString(acknowledgment.kind) ||
219
+ !validString(acknowledgment.id) ||
220
+ !validRef(acknowledgment.target) ||
221
+ !acknowledgment.conversation ||
222
+ acknowledgment.conversation.adapter !== record.req?.adapter ||
223
+ !validString(acknowledgment.conversation.workspace) ||
224
+ !validString(acknowledgment.conversation.chat) ||
225
+ (acknowledgment.conversation.thread != null && typeof acknowledgment.conversation.thread !== 'string') ||
226
+ acknowledgment.target.adapter !== record.prepared?.target.adapter ||
227
+ acknowledgment.target.value !== record.prepared?.target.value ||
228
+ acknowledgment.emoji !== record.prepared?.emoji
229
+ )
230
+ return false
231
+ return acknowledgment.id === acknowledgmentIdentity(acknowledgment, record.prepared).id
232
+ }
233
+ if (
234
+ !record ||
235
+ record.schemaVersion !== 1 ||
236
+ record.key !== key ||
237
+ !Number.isSafeInteger(record.generation) ||
238
+ record.generation < 0 ||
239
+ !['adding', 'present', 'removing', 'blocked', 'absent'].includes(record.phase) ||
240
+ !['present', 'absent'].includes(record.desired) ||
241
+ !record.req ||
242
+ !validString(record.req.adapter) ||
243
+ !validString(record.req.workspace) ||
244
+ !validString(record.req.chat) ||
245
+ !validString(record.req.emoji) ||
246
+ !validRef(record.req.reactionRef) ||
247
+ (record.req.thread != null && typeof record.req.thread !== 'string') ||
248
+ !record.prepared ||
249
+ !validString(record.prepared.accountIdentity) ||
250
+ !validString(record.prepared.emoji) ||
251
+ !validRef(record.prepared.target) ||
252
+ record.prepared.target.adapter !== record.req.adapter ||
253
+ record.req.reactionRef.adapter !== record.req.adapter ||
254
+ !Array.isArray(record.owners) ||
255
+ record.owners.some(
256
+ (owner) =>
257
+ !owner ||
258
+ !validString(owner.ownerId) ||
259
+ !validString(owner.epoch) ||
260
+ typeof owner.protected !== 'boolean' ||
261
+ !Number.isSafeInteger(owner.generation) ||
262
+ owner.generation < 1 ||
263
+ !validAcknowledgment(owner),
264
+ ) ||
265
+ record.desired !== (record.owners.length > 0 ? 'present' : 'absent') ||
266
+ new Set(record.owners.map((owner) => owner.ownerId)).size !== record.owners.length ||
267
+ (record.retryAt !== undefined && (!Number.isFinite(record.retryAt) || record.retryAt < 0)) ||
268
+ (record.failure !== undefined &&
269
+ (record.failure.ok !== false ||
270
+ !['unsupported', 'transient', 'rate-limit', 'permission', 'identity'].includes(record.failure.code) ||
271
+ typeof record.failure.error !== 'string' ||
272
+ (record.failure.retryAfter !== undefined &&
273
+ (!Number.isFinite(record.failure.retryAfter) || record.failure.retryAfter < 0)))) ||
274
+ createHash('sha256')
275
+ .update(
276
+ JSON.stringify([
277
+ record.req.adapter,
278
+ record.prepared.accountIdentity,
279
+ record.prepared.target.adapter,
280
+ record.prepared.target.value,
281
+ record.prepared.emoji,
282
+ ]),
283
+ )
284
+ .digest('hex') !== key
285
+ ) {
286
+ throw new Error('Invalid waiting reaction journal')
287
+ }
288
+ snapshots.set(record, JSON.stringify(record))
289
+ record.owners = record.owners.filter(
290
+ (owner) => !retiredOwners.has(owner.ownerId) && (owner.protected || owner.epoch === epoch),
291
+ )
292
+ return record
293
+ } catch (error) {
294
+ if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined
295
+ throw error
296
+ }
297
+ }
298
+
299
+ function live(key: string): Reservation[] {
300
+ return [...(tupleReservations.get(key) ?? [])].filter((owner) => !owner.released)
301
+ }
302
+
303
+ function mergeOwners(record: TupleRecord): void {
304
+ for (const owner of live(record.key)) {
305
+ if (
306
+ !record.owners.some(
307
+ (item) => item.ownerId === owner.handle.ownerId && item.generation === owner.handle.generation,
308
+ )
309
+ ) {
310
+ record.owners.push({
311
+ ownerId: owner.handle.ownerId,
312
+ generation: owner.handle.generation,
313
+ epoch,
314
+ protected: owner.protected,
315
+ ...(owner.acknowledgmentScope
316
+ ? { acknowledgment: acknowledgmentIdentity(owner.acknowledgmentScope, record.prepared) }
317
+ : {}),
318
+ })
319
+ }
320
+ }
321
+ }
322
+
323
+ async function ensurePresent(
324
+ record: TupleRecord,
325
+ acquiredPreparation?: OwnReactionTarget,
326
+ ): Promise<ReactionRef | null> {
327
+ mergeOwners(record)
328
+ record.generation++
329
+ if (record.phase === 'present') {
330
+ saveIfChanged(record)
331
+ return record.prepared.target
332
+ }
333
+ const captured = acquiredPreparation ?? live(record.key).find((owner) => owner.prepared)?.prepared
334
+ const prepared = captured ?? (await options.prepare(record.req))
335
+ if (
336
+ !prepared ||
337
+ prepared.accountIdentity !== record.prepared.accountIdentity ||
338
+ prepared.target.adapter !== record.prepared.target.adapter ||
339
+ prepared.target.value !== record.prepared.target.value ||
340
+ prepared.emoji !== record.prepared.emoji
341
+ )
342
+ return null
343
+ record.prepared = prepared
344
+ record.phase = 'adding'
345
+ delete record.failure
346
+ delete record.retryAt
347
+ // Fsync the intent before the transport can observe the add, including a crash inside add.
348
+ save(record)
349
+ if (record.owners.length === 0) return null
350
+ const result = await options.add(record.req, record.prepared)
351
+ if (!result.ok) {
352
+ // Unsupported is a definite preflight refusal, not an uncertain transport outcome.
353
+ if (result.code === 'unsupported') {
354
+ record.phase = 'absent'
355
+ save(record)
356
+ }
357
+ return null
358
+ }
359
+ record.phase = 'present'
360
+ save(record)
361
+ return record.prepared.target
362
+ }
363
+
364
+ async function ensureAbsent(record: TupleRecord): Promise<void> {
365
+ // Preparation publishes canonical reservations before it queues work on this lane.
366
+ await Promise.all(
367
+ [...preparing]
368
+ .filter((owner) => owner.handle.req.adapter === record.req.adapter)
369
+ .map((owner) => owner.preparation),
370
+ )
371
+ mergeOwners(record)
372
+ if (record.owners.length > 0) {
373
+ if (live(record.key).length > 0 && record.phase !== 'present') await ensurePresent(record)
374
+ else saveIfChanged(record)
375
+ return
376
+ }
377
+ if (record.phase === 'absent') {
378
+ retireAbsent(record)
379
+ return
380
+ }
381
+ if (record.retryAt !== undefined && Date.now() < record.retryAt) {
382
+ saveIfChanged(record)
383
+ return
384
+ }
385
+ record.generation++
386
+ record.phase = 'removing'
387
+ save(record)
388
+ const generation = record.generation
389
+ // No await between the final owner/generation check and transport invocation.
390
+ const latest = load(record.key)
391
+ if (!latest || latest.generation !== generation || latest.owners.length > 0 || live(record.key).length > 0) return
392
+ let result: RemoveOwnReactionResult
393
+ try {
394
+ result = await options.remove({
395
+ adapter: record.req.adapter,
396
+ workspace: record.req.workspace,
397
+ chat: record.req.chat,
398
+ thread: record.req.thread,
399
+ target: record.prepared.target,
400
+ emoji: record.prepared.emoji,
401
+ expectedAccountIdentity: record.prepared.accountIdentity,
402
+ })
403
+ } catch (error) {
404
+ result = { ok: false, code: 'transient', error: String(error) }
405
+ }
406
+ if (!result.ok) {
407
+ record.phase = 'blocked'
408
+ record.failure = result
409
+ const delay = result.retryAfter ?? (result.code === 'transient' || result.code === 'rate-limit' ? 1_000 : 0)
410
+ record.retryAt = Date.now() + Math.max(0, delay)
411
+ save(record)
412
+ return
413
+ }
414
+ // Publish absence before retirement; pending canonical owners still rely on this tuple.
415
+ record.phase = 'absent'
416
+ delete record.failure
417
+ delete record.retryAt
418
+ save(record)
419
+ if (live(record.key).length > 0) await ensurePresent(record)
420
+ else retireAbsent(record)
421
+ }
422
+
423
+ function report(error: unknown): void {
424
+ console.warn('[waiting-reactions] Durable reaction operation failed:', error)
425
+ }
426
+
427
+ function acquire(
428
+ req: ReactionRequest,
429
+ protectedPresence = false,
430
+ acknowledgmentScope?: ProtectedAcknowledgmentScope,
431
+ ): WaitingReactionHandle {
432
+ const ownerId = randomUUID()
433
+ let resolveReady!: (ref: ReactionRef | null) => void
434
+ const ready = new Promise<ReactionRef | null>((resolve) => {
435
+ resolveReady = resolve
436
+ })
437
+ const handle: WaitingReactionHandle = {
438
+ req: { ...req, reactionRef: { ...req.reactionRef } },
439
+ ownerId,
440
+ generation: ++ownerGeneration,
441
+ epoch,
442
+ ready,
443
+ }
444
+ const reservation: Reservation = {
445
+ handle,
446
+ protected: protectedPresence,
447
+ ...(protectedPresence && acknowledgmentScope
448
+ ? {
449
+ acknowledgmentScope: {
450
+ conversation: { ...acknowledgmentScope.conversation },
451
+ kind: acknowledgmentScope.kind,
452
+ },
453
+ }
454
+ : {}),
455
+ released: false,
456
+ preparation: Promise.resolve(),
457
+ }
458
+ // Reserve synchronously: release/recovery must see this owner even before prepare resolves.
459
+ reservations.set(ownerId, reservation)
460
+ preparing.add(reservation)
461
+ const preparationKey = `prepare:${JSON.stringify(handle.req)}`
462
+ reservation.preparation = lane(preparationKey, async () => {
463
+ const prepared = await options.prepare(handle.req)
464
+ if (!prepared) return
465
+ const key = createHash('sha256')
466
+ .update(
467
+ JSON.stringify([
468
+ handle.req.adapter,
469
+ prepared.accountIdentity,
470
+ prepared.target.adapter,
471
+ prepared.target.value,
472
+ prepared.emoji,
473
+ ]),
474
+ )
475
+ .digest('hex')
476
+ reservation.key = key
477
+ reservation.prepared = prepared
478
+ let owners = tupleReservations.get(key)
479
+ if (!owners) {
480
+ owners = new Set()
481
+ tupleReservations.set(key, owners)
482
+ }
483
+ owners.add(reservation)
484
+ void lane(key, async () => {
485
+ if (reservation.released) return null
486
+ const record: TupleRecord = load(key) ?? {
487
+ schemaVersion: 1,
488
+ desired: 'present',
489
+ key,
490
+ req: handle.req,
491
+ prepared,
492
+ generation: 0,
493
+ owners: [],
494
+ phase: 'adding',
495
+ }
496
+ record.prepared = prepared
497
+ return ensurePresent(record, prepared)
498
+ }).then(resolveReady, (error) => {
499
+ report(error)
500
+ resolveReady(null)
501
+ })
502
+ })
503
+ .catch((error) => {
504
+ report(error)
505
+ })
506
+ .finally(() => {
507
+ preparing.delete(reservation)
508
+ if (!reservation.key) resolveReady(null)
509
+ })
510
+ return handle
511
+ }
512
+
513
+ async function release(handle: WaitingReactionHandle): Promise<void> {
514
+ const owner = reservations.get(handle.ownerId)
515
+ // Handles are capability tokens: a stale/foreign callback cannot retire another owner.
516
+ if (!owner || owner.handle !== handle || owner.released) return
517
+ owner.released = true
518
+ retiredOwners.add(handle.ownerId)
519
+ await owner.preparation
520
+ if (!owner.key) {
521
+ reservations.delete(handle.ownerId)
522
+ retiredOwners.delete(handle.ownerId)
523
+ return
524
+ }
525
+ try {
526
+ await lane(owner.key, async () => {
527
+ const record = load(owner.key!)
528
+ if (!record) return
529
+ record.owners = record.owners.filter(
530
+ (item) =>
531
+ item.ownerId !== handle.ownerId || item.generation !== handle.generation || item.epoch !== handle.epoch,
532
+ )
533
+ await ensureAbsent(record)
534
+ })
535
+ retiredOwners.delete(handle.ownerId)
536
+ } catch (error) {
537
+ report(error)
538
+ }
539
+ const owners = tupleReservations.get(owner.key)
540
+ owners?.delete(owner)
541
+ if (owners?.size === 0) tupleReservations.delete(owner.key)
542
+ reservations.delete(handle.ownerId)
543
+ }
544
+
545
+ // Only the router's genuine-reply decision may use this path. Capture live
546
+ // capabilities now; future acknowledgments in the same conversation survive.
547
+ async function retireAcknowledgments(conversation: ChannelKey): Promise<void> {
548
+ const capturedConversation = { ...conversation }
549
+ const current = [...reservations.values()].filter(
550
+ (owner) =>
551
+ !owner.released &&
552
+ owner.protected &&
553
+ owner.acknowledgmentScope &&
554
+ sameConversation(owner.acknowledgmentScope.conversation, capturedConversation),
555
+ )
556
+ const capturedIds = new Set(current.map((owner) => owner.handle.ownerId))
557
+ const releases = current.map((owner) => release(owner.handle))
558
+ let files: string[]
559
+ try {
560
+ files = await readdir(directory)
561
+ } catch (error) {
562
+ if ((error as NodeJS.ErrnoException).code !== 'ENOENT') report(error)
563
+ await Promise.all(releases)
564
+ return
565
+ }
566
+ for (let offset = 0; offset < files.length; offset += 16) {
567
+ await setImmediate()
568
+ await Promise.all(
569
+ files
570
+ .slice(offset, offset + 16)
571
+ .filter((file) => /^[a-f0-9]{64}\.json$/.test(file))
572
+ .map(async (file) => {
573
+ const key = file.slice(0, -5)
574
+ try {
575
+ const record = load(key)
576
+ if (!record) return
577
+ const claims = record.owners.filter(
578
+ (owner) =>
579
+ owner.protected &&
580
+ owner.acknowledgment &&
581
+ sameConversation(owner.acknowledgment.conversation, capturedConversation) &&
582
+ (owner.epoch !== epoch || capturedIds.has(owner.ownerId) || !reservations.has(owner.ownerId)),
583
+ )
584
+ if (claims.length === 0) return
585
+ await lane(key, async () => {
586
+ const latest = load(key)
587
+ if (!latest) return
588
+ latest.owners = latest.owners.filter(
589
+ (owner) =>
590
+ !claims.some(
591
+ (claim) =>
592
+ owner.ownerId === claim.ownerId &&
593
+ owner.generation === claim.generation &&
594
+ owner.epoch === claim.epoch &&
595
+ owner.acknowledgment?.id === claim.acknowledgment?.id,
596
+ ),
597
+ )
598
+ await ensureAbsent(latest)
599
+ })
600
+ } catch (error) {
601
+ report(error)
602
+ }
603
+ }),
604
+ )
605
+ }
606
+ await Promise.all(releases)
607
+ }
608
+
609
+ const recoveries = new Map<string, Promise<void>>()
610
+ const recoveringTuples = new Map<string, Promise<void>>()
611
+
612
+ async function recoverRecords(adapter?: ReactionRequest['adapter']): Promise<void> {
613
+ await Promise.all(
614
+ [...preparing]
615
+ .filter((owner) => !adapter || owner.handle.req.adapter === adapter)
616
+ .map((owner) => owner.preparation),
617
+ )
618
+ let files: string[]
619
+ try {
620
+ files = await readdir(directory)
621
+ } catch (error) {
622
+ if ((error as NodeJS.ErrnoException).code !== 'ENOENT') report(error)
623
+ return
624
+ }
625
+ for (let offset = 0; offset < files.length; offset += 16) {
626
+ // Bound synchronous tuple work and give reply timers a turn even for protected history.
627
+ await setImmediate()
628
+ await Promise.all(
629
+ files
630
+ .slice(offset, offset + 16)
631
+ .filter((file) => /^[a-f0-9]{64}\.json$/.test(file))
632
+ .map((file) => {
633
+ const key = file.slice(0, -5)
634
+ const existing = recoveringTuples.get(key)
635
+ if (existing) return existing
636
+ const pending = lane(key, async () => {
637
+ const record = load(key)
638
+ if (!record || (adapter && record.req.adapter !== adapter)) return
639
+ await ensureAbsent(record)
640
+ })
641
+ .catch(report)
642
+ .finally(() => {
643
+ recoveringTuples.delete(key)
644
+ })
645
+ recoveringTuples.set(key, pending)
646
+ return pending
647
+ }),
648
+ )
649
+ }
650
+ }
651
+
652
+ function recover(adapter?: ReactionRequest['adapter']): Promise<void> {
653
+ const key = adapter ?? '*'
654
+ const existing = recoveries.get(key)
655
+ if (existing) return existing
656
+ const pending = recoverRecords(adapter).finally(() => {
657
+ recoveries.delete(key)
658
+ })
659
+ recoveries.set(key, pending)
660
+ return pending
661
+ }
662
+
663
+ return { acquire, release, recover, retireAcknowledgments }
664
+ }
@@ -1220,8 +1220,7 @@ async function promptGithubCredentials(cwd: string): Promise<{
1220
1220
  // length checks below to avoid a TypeError on the "leave blank" path.
1221
1221
  const enteredSecret = typeof secret === 'string' ? secret : ''
1222
1222
  const reposRaw = await text({
1223
- message: 'Repositories to allow (comma-separated owner/repo)',
1224
- validate: (value) => (parseRepos(value ?? '').length > 0 ? undefined : 'At least one owner/repo is required'),
1223
+ message: 'Repositories to allow (comma-separated owner/repo, leave blank to skip)',
1225
1224
  })
1226
1225
  if (isCancel(reposRaw)) {
1227
1226
  cancel('Aborted.')
@@ -1234,7 +1233,7 @@ async function promptGithubCredentials(cwd: string): Promise<{
1234
1233
  ...(webhookUrl !== undefined ? { webhookUrl } : {}),
1235
1234
  webhookPort: Number(port),
1236
1235
  ...(namedCreds !== undefined ? namedCreds : {}),
1237
- repos: parseRepos(reposRaw),
1236
+ repos: parseRepos(reposRaw ?? ''),
1238
1237
  auth,
1239
1238
  }
1240
1239
  }