typeclaw 0.49.0 → 0.51.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 (502) 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/bash-sandbox-env.d.ts +15 -0
  4. package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
  5. package/dist/types/agent/bash-sandbox.d.ts +94 -0
  6. package/dist/types/agent/compaction.d.ts +8 -0
  7. package/dist/types/agent/git-nudge.d.ts +6 -0
  8. package/dist/types/agent/guard-types.d.ts +25 -0
  9. package/dist/types/agent/guards.d.ts +7 -0
  10. package/dist/types/agent/idle-compaction.d.ts +8 -0
  11. package/dist/types/agent/index.d.ts +151 -0
  12. package/dist/types/agent/live-subagents.d.ts +113 -0
  13. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  14. package/dist/types/agent/loop-guard.d.ts +67 -0
  15. package/dist/types/agent/model-fallback.d.ts +29 -0
  16. package/dist/types/agent/model-overrides.d.ts +8 -0
  17. package/dist/types/agent/multimodal/index.d.ts +2 -0
  18. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  19. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  20. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  21. package/dist/types/agent/network/response-body.d.ts +1 -0
  22. package/dist/types/agent/network/safe-http.d.ts +46 -0
  23. package/dist/types/agent/output-allowance.d.ts +4 -0
  24. package/dist/types/agent/plugin-tools.d.ts +58 -0
  25. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  26. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  27. package/dist/types/agent/provider-error.d.ts +23 -0
  28. package/dist/types/agent/reload-tool.d.ts +10 -0
  29. package/dist/types/agent/restart/index.d.ts +31 -0
  30. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  31. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  32. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  33. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  34. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  35. package/dist/types/agent/self.d.ts +1 -0
  36. package/dist/types/agent/session-meta.d.ts +28 -0
  37. package/dist/types/agent/session-origin.d.ts +65 -0
  38. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  39. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  40. package/dist/types/agent/subagent-drain.d.ts +25 -0
  41. package/dist/types/agent/subagent-session.d.ts +3 -0
  42. package/dist/types/agent/subagents.d.ts +153 -0
  43. package/dist/types/agent/system-prompt-composition.d.ts +17 -0
  44. package/dist/types/agent/system-prompt.d.ts +7 -0
  45. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  46. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  47. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  48. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  49. package/dist/types/agent/todo/continuation.d.ts +21 -0
  50. package/dist/types/agent/todo/scope.d.ts +6 -0
  51. package/dist/types/agent/todo/store.d.ts +16 -0
  52. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  53. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  54. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  55. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  56. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  57. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  58. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  59. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  60. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  61. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  62. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  63. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  64. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  65. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  66. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  67. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  68. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  69. package/dist/types/agent/tools/ddg.d.ts +27 -0
  70. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  71. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  72. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  73. package/dist/types/agent/tools/restart.d.ts +25 -0
  74. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  75. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  76. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  77. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  78. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  79. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  80. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  81. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  82. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  83. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  84. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  85. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  86. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  87. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  88. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  89. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  90. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  91. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  92. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  93. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  94. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  95. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  96. package/dist/types/agent/tools/websearch.d.ts +17 -0
  97. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  98. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  99. package/dist/types/agent/turn-runner.d.ts +36 -0
  100. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  101. package/dist/types/browser/dockerfile.d.ts +2 -0
  102. package/dist/types/browser/registry.d.ts +49 -0
  103. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  104. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  105. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  106. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  107. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  108. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  109. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  110. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  111. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  112. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  113. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  114. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  115. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  116. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  117. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  118. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  119. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  120. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  121. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  122. package/dist/types/channels/background-handoff.d.ts +56 -0
  123. package/dist/types/channels/background-obligations.d.ts +135 -0
  124. package/dist/types/channels/catch-up.d.ts +26 -0
  125. package/dist/types/channels/commands.d.ts +2 -0
  126. package/dist/types/channels/completion-claim.d.ts +20 -0
  127. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  128. package/dist/types/channels/continuity-types.d.ts +75 -0
  129. package/dist/types/channels/describe-error.d.ts +1 -0
  130. package/dist/types/channels/engagement.d.ts +34 -0
  131. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  132. package/dist/types/channels/github-repo.d.ts +2 -0
  133. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  134. package/dist/types/channels/github-review-check.d.ts +135 -0
  135. package/dist/types/channels/github-review-claim.d.ts +3 -0
  136. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  137. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  138. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  139. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  140. package/dist/types/channels/inbound-journal.d.ts +272 -0
  141. package/dist/types/channels/last-alive.d.ts +3 -0
  142. package/dist/types/channels/membership-cache.d.ts +27 -0
  143. package/dist/types/channels/membership.d.ts +21 -0
  144. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  145. package/dist/types/channels/participants.d.ts +4 -0
  146. package/dist/types/channels/persistence.d.ts +32 -0
  147. package/dist/types/channels/recovery-notice.d.ts +26 -0
  148. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  149. package/dist/types/channels/router.d.ts +760 -0
  150. package/dist/types/channels/schema.d.ts +501 -0
  151. package/dist/types/channels/session-handoff.d.ts +58 -0
  152. package/dist/types/channels/session-search.d.ts +29 -0
  153. package/dist/types/channels/types.d.ts +414 -0
  154. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  155. package/dist/types/cli/builtins.d.ts +2 -0
  156. package/dist/types/cli/command-meta.d.ts +9 -0
  157. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  158. package/dist/types/coding-agent/broker.d.ts +22 -0
  159. package/dist/types/coding-agent/claude.d.ts +22 -0
  160. package/dist/types/coding-agent/codex.d.ts +19 -0
  161. package/dist/types/coding-agent/index.d.ts +71 -0
  162. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  163. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  164. package/dist/types/coding-agent/omo.d.ts +133 -0
  165. package/dist/types/coding-agent/runner.d.ts +35 -0
  166. package/dist/types/coding-agent/tool.d.ts +27 -0
  167. package/dist/types/coding-agent/worktree.d.ts +22 -0
  168. package/dist/types/commands/index.d.ts +45 -0
  169. package/dist/types/config/config.d.ts +827 -0
  170. package/dist/types/config/index.d.ts +3 -0
  171. package/dist/types/config/model-overrides.d.ts +3 -0
  172. package/dist/types/config/providers.d.ts +1458 -0
  173. package/dist/types/config/reloadable.d.ts +9 -0
  174. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  175. package/dist/types/container/build-cache.d.ts +39 -0
  176. package/dist/types/container/compose-project.d.ts +1 -0
  177. package/dist/types/container/controller.d.ts +25 -0
  178. package/dist/types/container/docker-app.d.ts +23 -0
  179. package/dist/types/container/exit-reason.d.ts +10 -0
  180. package/dist/types/container/index.d.ts +14 -0
  181. package/dist/types/container/log-archive.d.ts +68 -0
  182. package/dist/types/container/log-colors.d.ts +3 -0
  183. package/dist/types/container/log-timestamps.d.ts +9 -0
  184. package/dist/types/container/logs.d.ts +37 -0
  185. package/dist/types/container/memory-limit.d.ts +13 -0
  186. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  187. package/dist/types/container/oom-events.d.ts +18 -0
  188. package/dist/types/container/port.d.ts +18 -0
  189. package/dist/types/container/require-running.d.ts +16 -0
  190. package/dist/types/container/restart.d.ts +32 -0
  191. package/dist/types/container/shared.d.ts +93 -0
  192. package/dist/types/container/shell.d.ts +35 -0
  193. package/dist/types/container/start.d.ts +145 -0
  194. package/dist/types/container/stats.d.ts +31 -0
  195. package/dist/types/container/status.d.ts +25 -0
  196. package/dist/types/container/stop.d.ts +24 -0
  197. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  198. package/dist/types/container/verify-running.d.ts +49 -0
  199. package/dist/types/cron/consumer.d.ts +42 -0
  200. package/dist/types/cron/count-state.d.ts +24 -0
  201. package/dist/types/cron/index.d.ts +21 -0
  202. package/dist/types/cron/list.d.ts +33 -0
  203. package/dist/types/cron/reloadable.d.ts +11 -0
  204. package/dist/types/cron/scheduler.d.ts +51 -0
  205. package/dist/types/cron/schema.d.ts +108 -0
  206. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  207. package/dist/types/dependencies/bins.d.ts +22 -0
  208. package/dist/types/dependencies/index.d.ts +2 -0
  209. package/dist/types/eval/cell.d.ts +26 -0
  210. package/dist/types/eval/config.d.ts +19 -0
  211. package/dist/types/eval/dispatch.d.ts +7 -0
  212. package/dist/types/eval/kernel.d.ts +28 -0
  213. package/dist/types/eval/process.d.ts +23 -0
  214. package/dist/types/eval/protocol.d.ts +34 -0
  215. package/dist/types/eval/sandbox.d.ts +10 -0
  216. package/dist/types/eval/tool.d.ts +17 -0
  217. package/dist/types/eval/wire.d.ts +33 -0
  218. package/dist/types/git/bound-gc-config.d.ts +4 -0
  219. package/dist/types/git/hookless.d.ts +1 -0
  220. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  221. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  222. package/dist/types/git/resolve-identity.d.ts +10 -0
  223. package/dist/types/git/run.d.ts +24 -0
  224. package/dist/types/git/system-commit.d.ts +2 -0
  225. package/dist/types/hostd/client.d.ts +13 -0
  226. package/dist/types/hostd/models.d.ts +1 -0
  227. package/dist/types/hostd/paths.d.ts +17 -0
  228. package/dist/types/hostd/protocol.d.ts +93 -0
  229. package/dist/types/hostd/spawn.d.ts +17 -0
  230. package/dist/types/hostd/version.d.ts +18 -0
  231. package/dist/types/init/auto-upgrade.d.ts +41 -0
  232. package/dist/types/init/cli-version.d.ts +7 -0
  233. package/dist/types/init/dockerfile.d.ts +34 -0
  234. package/dist/types/init/ensure-deps.d.ts +17 -0
  235. package/dist/types/init/env-file.d.ts +3 -0
  236. package/dist/types/init/gitignore.d.ts +5 -0
  237. package/dist/types/init/local-source-stamp.d.ts +3 -0
  238. package/dist/types/init/packagejson.d.ts +7 -0
  239. package/dist/types/init/paths.d.ts +3 -0
  240. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  241. package/dist/types/init/run-bun-install.d.ts +16 -0
  242. package/dist/types/init/windows-dev-link.d.ts +8 -0
  243. package/dist/types/mcp/catalog.d.ts +7 -0
  244. package/dist/types/mcp/client.d.ts +58 -0
  245. package/dist/types/mcp/manager.d.ts +56 -0
  246. package/dist/types/mcp/tools.d.ts +23 -0
  247. package/dist/types/models/embedding-model.d.ts +20 -0
  248. package/dist/types/models/transformers-version.d.ts +1 -0
  249. package/dist/types/network/internal-destinations.d.ts +29 -0
  250. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  251. package/dist/types/operations/incidents.d.ts +47 -0
  252. package/dist/types/operations/index.d.ts +3 -0
  253. package/dist/types/operations/remediations.d.ts +25 -0
  254. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  255. package/dist/types/permissions/builtins.d.ts +25 -0
  256. package/dist/types/permissions/grant.d.ts +19 -0
  257. package/dist/types/permissions/index.d.ts +6 -0
  258. package/dist/types/permissions/match-rule.d.ts +28 -0
  259. package/dist/types/permissions/permissions.d.ts +42 -0
  260. package/dist/types/permissions/resolve.d.ts +25 -0
  261. package/dist/types/permissions/schema.d.ts +14 -0
  262. package/dist/types/plugin/context.d.ts +20 -0
  263. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  264. package/dist/types/plugin/define.d.ts +46 -0
  265. package/dist/types/plugin/hooks.d.ts +52 -0
  266. package/dist/types/plugin/index.d.ts +11 -0
  267. package/dist/types/plugin/load-skill.d.ts +14 -0
  268. package/dist/types/plugin/loader.d.ts +25 -0
  269. package/dist/types/plugin/manager.d.ts +42 -0
  270. package/dist/types/plugin/registry.d.ts +73 -0
  271. package/dist/types/plugin/skills.d.ts +11 -0
  272. package/dist/types/plugin/types.d.ts +336 -0
  273. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  274. package/dist/types/reload/client.d.ts +11 -0
  275. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  276. package/dist/types/reload/format.d.ts +2 -0
  277. package/dist/types/reload/index.d.ts +6 -0
  278. package/dist/types/reload/recover.d.ts +22 -0
  279. package/dist/types/reload/registry.d.ts +10 -0
  280. package/dist/types/reload/types.d.ts +25 -0
  281. package/dist/types/role-claim/client.d.ts +20 -0
  282. package/dist/types/role-claim/code.d.ts +4 -0
  283. package/dist/types/role-claim/controller.d.ts +59 -0
  284. package/dist/types/role-claim/index.d.ts +6 -0
  285. package/dist/types/role-claim/match-rule.d.ts +9 -0
  286. package/dist/types/role-claim/pending.d.ts +35 -0
  287. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  288. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  289. package/dist/types/sandbox/availability.d.ts +21 -0
  290. package/dist/types/sandbox/build.d.ts +7 -0
  291. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  292. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  293. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  294. package/dist/types/sandbox/dev-source.d.ts +4 -0
  295. package/dist/types/sandbox/env-exposure.d.ts +3 -0
  296. package/dist/types/sandbox/errors.d.ts +20 -0
  297. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  298. package/dist/types/sandbox/index.d.ts +14 -0
  299. package/dist/types/sandbox/package-install.d.ts +1 -0
  300. package/dist/types/sandbox/policy.d.ts +71 -0
  301. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  302. package/dist/types/sandbox/quote.d.ts +2 -0
  303. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  304. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  305. package/dist/types/sandbox/symlinks.d.ts +6 -0
  306. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  307. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  308. package/dist/types/secrets/defaults.d.ts +21 -0
  309. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  310. package/dist/types/secrets/hydrate.d.ts +7 -0
  311. package/dist/types/secrets/index.d.ts +7 -0
  312. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  313. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  314. package/dist/types/secrets/resolve.d.ts +14 -0
  315. package/dist/types/secrets/schema.d.ts +840 -0
  316. package/dist/types/secrets/storage.d.ts +56 -0
  317. package/dist/types/shared/host-locale.d.ts +1 -0
  318. package/dist/types/shared/index.d.ts +5 -0
  319. package/dist/types/shared/local-time.d.ts +4 -0
  320. package/dist/types/shared/platform.d.ts +2 -0
  321. package/dist/types/shared/protocol.d.ts +424 -0
  322. package/dist/types/shared/style-text.d.ts +3 -0
  323. package/dist/types/shared/wsl.d.ts +17 -0
  324. package/dist/types/stream/broker.d.ts +2 -0
  325. package/dist/types/stream/index.d.ts +2 -0
  326. package/dist/types/stream/types.d.ts +71 -0
  327. package/package.json +13 -6
  328. package/scripts/build-plugin-types.ts +105 -0
  329. package/scripts/check-plugin-sdk.ts +111 -0
  330. package/scripts/require-parallel.ts +5 -32
  331. package/src/agent/bash-sandbox-env.ts +104 -0
  332. package/src/agent/bash-sandbox-proc.ts +70 -0
  333. package/src/agent/bash-sandbox.ts +225 -0
  334. package/src/agent/compaction.ts +22 -10
  335. package/src/agent/guard-types.ts +3 -0
  336. package/src/agent/guards.ts +4 -0
  337. package/src/agent/idle-compaction.ts +178 -0
  338. package/src/agent/index.ts +139 -172
  339. package/src/agent/live-subagents.ts +19 -0
  340. package/src/agent/multimodal/look-at.ts +22 -9
  341. package/src/agent/output-allowance.ts +7 -0
  342. package/src/agent/plugin-tools.ts +39 -377
  343. package/src/agent/reviewer-bash-policy.ts +41 -1
  344. package/src/agent/session-origin.ts +28 -11
  345. package/src/agent/subagent-cache-keepalive.ts +198 -0
  346. package/src/agent/subagent-completion-reminder.ts +2 -2
  347. package/src/agent/subagent-session.ts +6 -0
  348. package/src/agent/subagents.ts +46 -8
  349. package/src/agent/system-prompt-composition.ts +141 -0
  350. package/src/agent/system-prompt.ts +5 -5
  351. package/src/agent/todo/scope.ts +1 -1
  352. package/src/agent/tool-file-safety.ts +6 -1
  353. package/src/agent/tools/channel-edit.ts +20 -10
  354. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  355. package/src/agent/tools/channel-handoff.ts +72 -0
  356. package/src/agent/tools/channel-read.ts +57 -10
  357. package/src/agent/tools/channel-reply.ts +33 -26
  358. package/src/agent/tools/channel-send.ts +21 -13
  359. package/src/agent/tools/channel-session-search.ts +35 -0
  360. package/src/agent/tools/curl-impersonate.ts +11 -4
  361. package/src/agent/tools/ddg.ts +84 -16
  362. package/src/agent/tools/spawn-subagent.ts +27 -11
  363. package/src/agent/tools/stream-snapshot.ts +15 -2
  364. package/src/agent/tools/subagent-access.ts +11 -4
  365. package/src/agent/tools-without-local-file-operands.ts +4 -0
  366. package/src/browser/bsk-shim.mjs +74 -0
  367. package/src/browser/dockerfile.ts +84 -0
  368. package/src/browser/egress.ts +104 -0
  369. package/src/browser/fill-secret.ts +307 -0
  370. package/src/browser/managed-browser.ts +205 -0
  371. package/src/browser/registry.ts +110 -0
  372. package/src/browser/relay.ts +231 -0
  373. package/src/browser/sandbox-entry.ts +167 -0
  374. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  375. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  376. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  377. package/src/bundled-plugins/doc-render/index.ts +0 -10
  378. package/src/bundled-plugins/doc-render/render.ts +83 -111
  379. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  380. package/src/bundled-plugins/explorer/explorer.ts +1 -1
  381. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  382. package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
  383. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  384. package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
  385. package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
  386. package/src/bundled-plugins/managed-browser/index.ts +179 -0
  387. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  388. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  389. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  390. package/src/bundled-plugins/memory/dreaming.ts +4 -1
  391. package/src/bundled-plugins/memory/load-memory.ts +2 -4
  392. package/src/bundled-plugins/memory/memory-logger.ts +74 -2
  393. package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
  394. package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
  395. package/src/bundled-plugins/operator/operator.ts +1 -1
  396. package/src/bundled-plugins/qa/index.ts +11 -0
  397. package/src/bundled-plugins/qa/qa.ts +160 -0
  398. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  399. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  400. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  401. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  402. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  403. package/src/bundled-plugins/security/index.ts +53 -34
  404. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  405. package/src/bundled-plugins/security/policies/private-surface-read.ts +166 -201
  406. package/src/channels/adapter-namespace.ts +13 -0
  407. package/src/channels/adapters/discord-bot-reference.ts +5 -4
  408. package/src/channels/adapters/discord-bot.ts +98 -5
  409. package/src/channels/adapters/discord-classify.ts +8 -3
  410. package/src/channels/adapters/discord.ts +29 -0
  411. package/src/channels/adapters/github/index.ts +16 -0
  412. package/src/channels/adapters/github/last-alive.ts +4 -16
  413. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  414. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  415. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  416. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  417. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  418. package/src/channels/adapters/slack-bot.ts +299 -67
  419. package/src/channels/adapters/slack-classify.ts +1 -0
  420. package/src/channels/catch-up.ts +137 -0
  421. package/src/channels/continuation-willingness.ts +2 -2
  422. package/src/channels/continuity-types.ts +1 -0
  423. package/src/channels/engagement.ts +17 -1
  424. package/src/channels/github-false-receipt.ts +3 -3
  425. package/src/channels/github-rereview-guard.ts +9 -5
  426. package/src/channels/github-review-check.ts +5 -1
  427. package/src/channels/github-review-verdict-coordinator.ts +68 -2
  428. package/src/channels/github-token-bridge.ts +24 -0
  429. package/src/channels/last-alive.ts +34 -0
  430. package/src/channels/manager.ts +8 -1
  431. package/src/channels/router.ts +515 -243
  432. package/src/channels/session-handoff.fixture.ts +144 -0
  433. package/src/channels/session-handoff.ts +175 -0
  434. package/src/channels/session-search.ts +71 -0
  435. package/src/channels/subagent-completion-bridge.ts +3 -2
  436. package/src/channels/types.ts +12 -2
  437. package/src/cli/channel.ts +2 -3
  438. package/src/cli/hostd.ts +3 -0
  439. package/src/cli/init.ts +2 -3
  440. package/src/cli/model.ts +132 -3
  441. package/src/coding-agent/index.ts +7 -1
  442. package/src/coding-agent/omo-stream.ts +40 -0
  443. package/src/coding-agent/runner.ts +30 -8
  444. package/src/config/config.ts +126 -22
  445. package/src/config/model-overrides.ts +59 -0
  446. package/src/config/models-mutation.ts +185 -2
  447. package/src/config/providers-mutation.ts +12 -4
  448. package/src/config/providers.ts +69 -4
  449. package/src/container/start.ts +132 -5
  450. package/src/doctor/checks.ts +33 -22
  451. package/src/doctor/index.ts +48 -12
  452. package/src/doctor/operational-incidents.ts +16 -1
  453. package/src/doctor/plugin-bridge.ts +14 -1
  454. package/src/doctor/stage.ts +14 -0
  455. package/src/doctor/types.ts +6 -0
  456. package/src/eval/cell.ts +93 -0
  457. package/src/eval/config.ts +32 -0
  458. package/src/eval/dispatch.ts +67 -0
  459. package/src/eval/entry.ts +261 -0
  460. package/src/eval/kernel.ts +154 -0
  461. package/src/eval/process.ts +113 -0
  462. package/src/eval/protocol.ts +26 -0
  463. package/src/eval/redeclare.ts +174 -0
  464. package/src/eval/sandbox.ts +114 -0
  465. package/src/eval/tool.ts +98 -0
  466. package/src/eval/wire.ts +93 -0
  467. package/src/hostd/daemon.ts +13 -1
  468. package/src/init/auto-upgrade.ts +7 -1
  469. package/src/init/dockerfile.ts +57 -12
  470. package/src/init/index.ts +4 -3
  471. package/src/init/local-source-stamp.ts +68 -0
  472. package/src/init/models-dev.ts +4 -0
  473. package/src/init/validate-api-key.ts +3 -0
  474. package/src/operations/classify-tool-outcome.ts +1 -1
  475. package/src/permissions/builtins.ts +7 -0
  476. package/src/permissions/permissions.ts +18 -9
  477. package/src/permissions/resolve.ts +7 -1
  478. package/src/plugin/context.ts +2 -0
  479. package/src/plugin/core-tool-names.ts +6 -1
  480. package/src/plugin/hooks.ts +137 -0
  481. package/src/plugin/index.ts +6 -0
  482. package/src/plugin/manager.ts +4 -0
  483. package/src/plugin/types.ts +60 -0
  484. package/src/run/bundled-plugins.ts +6 -0
  485. package/src/run/index.ts +24 -14
  486. package/src/run/llm-fetch-observer.ts +12 -15
  487. package/src/sandbox/canonical-secrets.ts +4 -0
  488. package/src/sandbox/dev-source.ts +26 -0
  489. package/src/sandbox/env-exposure.ts +20 -0
  490. package/src/sandbox/hidden-paths.ts +16 -2
  491. package/src/secrets/storage.ts +13 -0
  492. package/src/server/index.ts +46 -11
  493. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  494. package/src/skills/typeclaw-config/SKILL.md +57 -5
  495. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  496. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  497. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  498. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  499. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  500. package/typeclaw.schema.json +488 -5
  501. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  502. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -1,7 +1,7 @@
1
1
  // A channel turn ends after a successful `channel_reply` (the terminal-reply
2
2
  // abort in router.ts). When the model's reply PROMISES to keep working this
3
3
  // turn ("바로 확인해볼게요", "let me check", "I'll continue now") but it forgot
4
- // to set `channel_reply({ more_work_this_turn: true })`, the turn aborts and the promised
4
+ // to set `channel_reply({ continue_after_reply: true })`, the turn aborts and the promised
5
5
  // follow-up never runs. The router uses this detector to inject ONE bounded
6
6
  // reminder nudge so the model gets a second chance. See the empty-turn retry
7
7
  // (router.ts) for the sibling mechanism this mirrors.
@@ -73,7 +73,7 @@ const EN_PHRASES: readonly string[] = [
73
73
  // Action/config verb family. The retrieval verbs above ("check/look/look up")
74
74
  // miss the much larger class of "I'll DO X" promises — update/configure/set up/
75
75
  // schedule/fix/apply/create — which is exactly the class that silently truncates
76
- // when the model forgets `more_work_this_turn: true` (the cron-update production miss).
76
+ // when the model forgets `continue_after_reply: true` (the cron-update production miss).
77
77
  "i'll update",
78
78
  "i'll set up",
79
79
  "i'll set it up",
@@ -83,6 +83,7 @@ const principal = z.discriminatedUnion('kind', [
83
83
  chat: nonempty,
84
84
  parentChat: nonempty.optional(),
85
85
  lastInboundAuthorId: nonempty.optional(),
86
+ lastInboundAuthorAdapter: z.enum(ADAPTER_IDS).optional(),
86
87
  })
87
88
  .strict(),
88
89
  ])
@@ -96,7 +96,7 @@ export function decideEngagement(input: EngagementInput): EngagementDecision {
96
96
 
97
97
  // Peer bots are excluded from the count — a 1-human-N-bot room is still
98
98
  // "solo" for the fallback at the bottom.
99
- const effectiveHumans = countEffectiveHumans(participants, input.membership, now)
99
+ const effectiveHumans = countEngagementHumans(message, participants, input.membership, now, botInThread)
100
100
 
101
101
  if (config.trigger.includes('dm') && message.isDm) return 'engage'
102
102
  if (config.trigger.includes('mention') && message.isBotMention) return 'engage'
@@ -281,6 +281,22 @@ function targetsSomeoneElse(
281
281
  return false
282
282
  }
283
283
 
284
+ // Membership is a room property, so a Slack thread inherits its parent
285
+ // channel's count. Once the bot is part of the thread, the thread's own
286
+ // speakers are the better signal: a thread between one human and the bot is a
287
+ // solo conversation even inside a crowded channel, and a second human posting
288
+ // there flips it back to multi-human.
289
+ export function countEngagementHumans(
290
+ message: InboundMessage,
291
+ participants: readonly ChannelParticipant[],
292
+ membership: MembershipCount | null,
293
+ now: number,
294
+ botInThread: boolean,
295
+ ): number {
296
+ if (botInThread && isThreadRoom(message)) return participants.filter((p) => p.isBot !== true).length
297
+ return countEffectiveHumans(participants, membership, now)
298
+ }
299
+
284
300
  export function countEffectiveHumans(
285
301
  participants: readonly ChannelParticipant[],
286
302
  membership: MembershipCount | null,
@@ -19,7 +19,7 @@ export type FalseReceiptInput = {
19
19
  chat: string
20
20
  thread: string | null
21
21
  text: string | undefined
22
- moreWorkThisTurn: boolean
22
+ continueAfterReply: boolean
23
23
  resolveReviewThread: boolean
24
24
  }
25
25
 
@@ -32,9 +32,9 @@ export function checkFalseReceipt(input: FalseReceiptInput): FalseReceiptDecisio
32
32
  if (claim === 'ignore') return { kind: 'allow' }
33
33
  if (claim === 'warn') return { kind: 'warn', notice: SOFT_NOTICE }
34
34
 
35
- // A turn the agent explicitly keeps alive (more_work_this_turn:true) is not yet
35
+ // A turn the agent explicitly keeps alive (continue_after_reply:true) is not yet
36
36
  // a receipt — the real action may still be coming. Never block; nudge instead.
37
- if (input.moreWorkThisTurn) return { kind: 'warn', notice: SOFT_NOTICE }
37
+ if (input.continueAfterReply) return { kind: 'warn', notice: SOFT_NOTICE }
38
38
 
39
39
  if (claim === 'block-resolve') {
40
40
  if (input.thread === null) return { kind: 'allow' }
@@ -19,10 +19,10 @@ export type RereviewGuardInput = {
19
19
  thread: string | null
20
20
  text: string | undefined
21
21
  wantsResolve: boolean
22
- // A mid-turn status reply (more_work_this_turn:true) is not the turn's receipt,
22
+ // A mid-turn status reply (continue_after_reply:true) is not the turn's receipt,
23
23
  // so it suppresses the warn-tier escalation below — but never the explicit
24
24
  // resolve, which is a real mutation. Mirrors the false-receipt guard's rule.
25
- moreWorkThisTurn: boolean
25
+ continueAfterReply: boolean
26
26
  getReviewState: (req: { adapter: 'github'; workspace: string; chat: string }) => Promise<ReviewStateResult>
27
27
  workspace: string
28
28
  round?: GithubReviewFollowupRound
@@ -42,7 +42,11 @@ export async function evaluateRereviewGuard(input: RereviewGuardInput): Promise<
42
42
  if (!isCloseoutAttempt(input)) return ALLOW
43
43
 
44
44
  const round = matchingRound(input)
45
- const state = await input.getReviewState({ adapter: 'github', workspace: input.workspace, chat: input.chat })
45
+ const request = { adapter: 'github', workspace: input.workspace, chat: input.chat } as const
46
+ let state = await input.getReviewState(request)
47
+ // One immediate re-query absorbs a single GitHub API blip, which would
48
+ // otherwise refuse a legitimate close-out the model has to re-author.
49
+ if (!state.ok && state.code === 'transient') state = await input.getReviewState(request)
46
50
 
47
51
  // Fail closed: an unverifiable review state is treated as a live block, so the
48
52
  // bot never strands a re-review on a transient API failure.
@@ -82,14 +86,14 @@ function matchingRound(input: RereviewGuardInput): GithubReviewFollowupRound | n
82
86
  // live CHANGES_REQUESTED, so casual approval-shaped chatter on an unblocked PR
83
87
  // still posts. Only POSITIVE warn phrases escalate — negative ones ("needs
84
88
  // changes", "still needs work") re-assert a block rather than strand it, so they
85
- // stay non-firing. `more_work_this_turn:true` exempts the warn escalation
89
+ // stay non-firing. `continue_after_reply:true` exempts the warn escalation
86
90
  // (mid-turn planning, not the receipt), but never the explicit resolve action.
87
91
  // Plain `ignore` text never fires.
88
92
  function isCloseoutAttempt(input: RereviewGuardInput): boolean {
89
93
  if (input.wantsResolve && input.thread !== null) return true
90
94
  const claim = classifyReviewClaim(input.text ?? '')
91
95
  if (claim === 'block-resolve' || claim === 'block-approve') return true
92
- return !input.moreWorkThisTurn && isPositiveWarnCloseout(input.text ?? '')
96
+ return !input.continueAfterReply && isPositiveWarnCloseout(input.text ?? '')
93
97
  }
94
98
 
95
99
  function unverifiableReason(error: string): string {
@@ -301,18 +301,22 @@ export class GithubReviewCheckTracker {
301
301
 
302
302
  // For a verdict posted without the reviewed head: only reviews that already
303
303
  // finished on this PR can be the ones it reports.
304
+ // When a reviewed head is supplied, complete only that commit's posting reviews.
304
305
  async completePostingReviews(
305
306
  repo: string,
306
307
  pullRequest: number,
307
308
  state: 'APPROVED' | 'CHANGES_REQUESTED' | 'COMMENTED',
309
+ headSha?: string,
308
310
  ): Promise<void> {
309
311
  const canonical = canonicalGithubRepo(repo)
312
+ const normalizedHead = headSha?.toLocaleLowerCase()
310
313
  const matching = [...this.leases.values()].filter(
311
314
  (lease) =>
312
315
  lease.outcome === undefined &&
313
316
  lease.phase === 'posting' &&
314
317
  lease.key.repo === canonical &&
315
- lease.key.pullRequest === pullRequest,
318
+ lease.key.pullRequest === pullRequest &&
319
+ (normalizedHead === undefined || lease.key.headSha === normalizedHead),
316
320
  )
317
321
  await Promise.all(matching.map((lease) => this.finish(lease, { kind: 'verdict', state })))
318
322
  }
@@ -1,5 +1,6 @@
1
1
  import { randomUUID } from 'node:crypto'
2
2
 
3
+ import { githubReviewChecks } from './github-review-check'
3
4
  import type { ReviewVerdict } from './github-review-turn-ledger'
4
5
  import type { GithubReviewFollowupRound } from './types'
5
6
 
@@ -131,6 +132,11 @@ const ROUND_HEAD_MOVED_REASON =
131
132
  'The pull request head moved past the commit this review round covers, so a verdict from this round would describe stale code. ' +
132
133
  'Do not submit it; the new push starts its own review round.'
133
134
 
135
+ const ROUND_SUPERSEDED_REASON =
136
+ 'A newer review round for this pull request replaced the one this session carries, at the same head commit. ' +
137
+ 'Its designated session submits the formal verdict, so do not submit one from this session and do not reply now: call `skip_response`. ' +
138
+ 'Once that verdict lands, close out only this thread with the technical outcome; never mention sessions, carriers, or review rounds on the PR.'
139
+
134
140
  function reviewedHeadRequiredReason(currentHead: string): string {
135
141
  return (
136
142
  `The pull request head moved to ${currentHead} after this review round opened. ` +
@@ -234,6 +240,11 @@ let reviewRounds = new Map<string, ReviewRoundState>()
234
240
  let expiredReviewRoundKeys = new Set<string>()
235
241
  type ReplyReviewRoundGeneration = { round: GithubReviewFollowupRound; createdAt: number }
236
242
  let replyReviewRoundGenerations = new Map<string, ReplyReviewRoundGeneration>()
243
+ // Round key -> key of the same-head counterpart it joined. Queued and persisted
244
+ // inbounds still carry the joiner's round and re-register it later; the alias
245
+ // keeps resolving to the canonical round after it completes, where the
246
+ // pending-only counterpart lookup would no longer find it.
247
+ let joinedRoundAliases = new Map<string, string>()
237
248
  let tokenSeq = 0
238
249
 
239
250
  export function githubReviewRoundKey(round: GithubReviewFollowupRound): string {
@@ -261,7 +272,7 @@ export function registerOrJoinReplyReviewRound(input: {
261
272
  replyReviewRoundGenerations.delete(correlationKey)
262
273
  }
263
274
 
264
- const round: GithubReviewFollowupRound = {
275
+ const candidate: GithubReviewFollowupRound = {
265
276
  kind: 'reply',
266
277
  roundId: (input.generateRoundId ?? randomUUID)(),
267
278
  workspace: input.workspace,
@@ -269,8 +280,8 @@ export function registerOrJoinReplyReviewRound(input: {
269
280
  headSha: input.headSha,
270
281
  carrierThread: input.thread,
271
282
  }
283
+ const round = registerGithubReviewRound(candidate, currentTime, now) ?? candidate
272
284
  replyReviewRoundGenerations.set(correlationKey, { round, createdAt: currentTime })
273
- registerGithubReviewRound(round, currentTime, now)
274
285
  return round
275
286
  }
276
287
 
@@ -281,6 +292,25 @@ export function registerGithubReviewRound(
281
292
  ): GithubReviewFollowupRound | null {
282
293
  const key = githubReviewRoundKey(round)
283
294
  if (expiredReviewRoundKeys.has(key)) return null
295
+ // A push round and a reply round on the same head ask for the same fresh
296
+ // verdict. A push re-check and a reply to the blocking review routinely land
297
+ // together, and evicting one for the other split sibling threads across
298
+ // rounds: the evicted carrier's verdict was then refused as superseded while
299
+ // the surviving round's carrier never owned the blocking obligation. Join the
300
+ // pending counterpart instead so one carrier answers for the head.
301
+ if (activeReviewRoundState(key, now) === undefined) {
302
+ const aliasKey = joinedRoundAliases.get(key)
303
+ if (aliasKey !== undefined) {
304
+ const canonical = activeReviewRoundState(aliasKey, now)
305
+ if (canonical !== undefined) return canonical.round
306
+ joinedRoundAliases.delete(key)
307
+ }
308
+ const counterpart = pendingSameHeadCounterpart(round, now)
309
+ if (counterpart !== undefined) {
310
+ joinedRoundAliases.set(key, githubReviewRoundKey(counterpart.round))
311
+ return counterpart.round
312
+ }
313
+ }
284
314
  for (const [candidateKey, state] of reviewRounds) {
285
315
  if (activeReviewRoundState(candidateKey, now) === undefined) continue
286
316
  if (candidateKey !== key && state.round.workspace === round.workspace && state.round.prNumber === round.prNumber) {
@@ -316,6 +346,9 @@ export function restoreGithubReviewRound(
316
346
  const registered = registerGithubReviewRound(round, createdAt, now)
317
347
  if (registered === null) return null
318
348
  const key = githubReviewRoundKey(registered)
349
+ // Joined a same-head counterpart: its live state is authoritative, and this
350
+ // record's persisted status describes a different round.
351
+ if (key !== githubReviewRoundKey(round)) return registered
319
352
  // Restoration is monotonic: a persisted `pending` record must never overwrite
320
353
  // an unexpired round this process already completed. A sibling session that
321
354
  // was idle-GC'd before completion still carries the stale status, and letting
@@ -459,6 +492,18 @@ export function isGithubReviewRoundSuperseded(round: GithubReviewFollowupRound,
459
492
  )
460
493
  }
461
494
 
495
+ function pendingSameHeadCounterpart(round: GithubReviewFollowupRound, now: () => number): ReviewRoundState | undefined {
496
+ expireReviewRounds(now)
497
+ return Array.from(reviewRounds.values()).find(
498
+ (state) =>
499
+ state.status === 'pending' &&
500
+ state.round.kind !== round.kind &&
501
+ state.round.workspace === round.workspace &&
502
+ state.round.prNumber === round.prNumber &&
503
+ state.round.headSha === round.headSha,
504
+ )
505
+ }
506
+
462
507
  function pendingPushRoundForPr(
463
508
  target: { workspace: string; prNumber: number },
464
509
  now: () => number = Date.now,
@@ -596,6 +641,9 @@ export function abortGithubReviewStateForPr(
596
641
  if (generation.round.workspace !== workspace || generation.round.prNumber !== prNumber) continue
597
642
  replyReviewRoundGenerations.delete(generationKey)
598
643
  }
644
+ for (const aliasKey of joinedRoundAliases.keys()) {
645
+ if (aliasKey.startsWith(`${key}#`)) joinedRoundAliases.delete(aliasKey)
646
+ }
599
647
 
600
648
  // A draft abort abandons local work, not output already observed on GitHub.
601
649
  // Keeping recentLandedByPr prevents a later ready event from duplicating it.
@@ -711,6 +759,17 @@ export function createApproveIdempotencyGuard(deps: {
711
759
  remote.ok &&
712
760
  remote.effective === 'CHANGES_REQUESTED'
713
761
 
762
+ const reviewedHeadSha = args.reviewedHeadSha ?? args.round?.headSha
763
+ if (
764
+ args.verdict === 'APPROVE' &&
765
+ remote.ok &&
766
+ remote.effective === 'APPROVED' &&
767
+ headSha !== null &&
768
+ (reviewedHeadSha === undefined || sameSha(reviewedHeadSha, headSha))
769
+ ) {
770
+ void githubReviewChecks.completePostingReviews(args.workspace, args.prNumber, 'APPROVED', headSha)
771
+ }
772
+
714
773
  // Layer 3 — duplicate-review cooldown. A recently-landed SAME verdict on the
715
774
  // SAME (or uncertain) head blocks a redundant re-publication for the window. It
716
775
  // fires on a bare NONE (read-after-write lag, the original shield) AND on the
@@ -869,6 +928,12 @@ async function evaluateRoundEligibility(
869
928
  // Re-read ownership after the await: a round registered meanwhile evicted this
870
929
  // one, and the registration below would evict it right back.
871
930
  const superseded = isGithubReviewRoundSuperseded(activeRound, now)
931
+ if (superseded && currentRoundHead === activeRound.headSha) {
932
+ logger.warn(
933
+ `[github] review round superseded at unchanged head pr=${activeRound.workspace}#${activeRound.prNumber} round=${activeRound.roundId} head=${currentRoundHead}`,
934
+ )
935
+ return { block: true, kind: 'round-ineligible', reason: ROUND_SUPERSEDED_REASON }
936
+ }
872
937
  if (superseded || (currentRoundHead !== activeRound.headSha && activeRound.kind === 'push')) {
873
938
  logger.warn(
874
939
  `[github] review round head moved pr=${activeRound.workspace}#${activeRound.prNumber} round=${activeRound.roundId} round_head=${activeRound.headSha} current_head=${currentRoundHead}${superseded ? ' superseded=true' : ''}`,
@@ -1022,6 +1087,7 @@ export function __resetReviewVerdictGuardForTest(): void {
1022
1087
  reviewRounds = new Map<string, ReviewRoundState>()
1023
1088
  expiredReviewRoundKeys = new Set<string>()
1024
1089
  replyReviewRoundGenerations = new Map<string, ReplyReviewRoundGeneration>()
1090
+ joinedRoundAliases = new Map<string, string>()
1025
1091
  tokenSeq = 0
1026
1092
  processEffectiveResolver = async () => ({ ok: false })
1027
1093
  processHeadShaResolver = async () => null
@@ -19,6 +19,11 @@ export type GithubTokenBridge = {
19
19
  // process-wide GH_TOKEN, so brokered gh paths cannot rely on its prefix.
20
20
  hasAppTokenResolver: () => boolean
21
21
  getAppSelfLogin: () => string | null
22
+ // PAT-mode channel auth: the adapter lends its stored PAT for git push to a
23
+ // configured repo. Kept apart from the App minter so PAT presence never flips
24
+ // hasAppTokenResolver() and the App-only paths (sandboxed minting, push grants).
25
+ resolvePatForRepo: ResolveGithubTokenForRepo
26
+ registerPatResolver: (resolver: (repoSlug: string) => Promise<GithubTokenCredential>) => () => void
22
27
  registerResolver: (
23
28
  resolver: (repoSlug: string) => Promise<GithubTokenCredential>,
24
29
  selfLogin?: () => string | null,
@@ -29,11 +34,30 @@ const NO_RESOLVER_REASON =
29
34
  'GitHub App token unavailable; the GitHub channel adapter is not running or failed to start. ' +
30
35
  'Check `typeclaw logs` and `secrets.json#channels.github`.'
31
36
 
37
+ const NO_PAT_RESOLVER_REASON =
38
+ 'No GitHub channel PAT is available; the GitHub channel is not configured with PAT auth, or its adapter is not running.'
39
+
32
40
  export function createGithubTokenBridge(): GithubTokenBridge {
33
41
  let current: ((repoSlug: string) => Promise<GithubTokenCredential>) | null = null
34
42
  let currentSelfLogin: (() => string | null) | null = null
43
+ let currentPat: ((repoSlug: string) => Promise<GithubTokenCredential>) | null = null
35
44
 
36
45
  return {
46
+ resolvePatForRepo: async (repoSlug) => {
47
+ const resolver = currentPat
48
+ if (resolver === null) return { kind: 'unavailable', reason: NO_PAT_RESOLVER_REASON }
49
+ try {
50
+ return { kind: 'token', ...(await resolver(repoSlug)) }
51
+ } catch (err) {
52
+ return { kind: 'unavailable', reason: describeError(err) }
53
+ }
54
+ },
55
+ registerPatResolver: (resolver) => {
56
+ currentPat = resolver
57
+ return () => {
58
+ if (currentPat === resolver) currentPat = null
59
+ }
60
+ },
37
61
  resolveTokenForRepo: async (repoSlug) => {
38
62
  const resolver = current
39
63
  if (resolver === null) return { kind: 'unavailable', reason: NO_RESOLVER_REASON }
@@ -0,0 +1,34 @@
1
+ import { randomUUID } from 'node:crypto'
2
+ import { mkdir, readFile, rename, writeFile } from 'node:fs/promises'
3
+ import { join } from 'node:path'
4
+
5
+ import { z } from 'zod'
6
+
7
+ import type { AdapterId } from './schema'
8
+
9
+ const markerSchema = z.object({ at: z.number().finite() })
10
+
11
+ export async function readLastAlive(agentDir: string, adapter: AdapterId): Promise<number | null> {
12
+ const dir = join(agentDir, 'channels')
13
+ const paths = [join(dir, `${adapter}-catch-up-last-alive.json`)]
14
+ if (adapter === 'github') paths.push(join(dir, 'github-last-alive.json'))
15
+ for (const path of paths) {
16
+ try {
17
+ const marker = markerSchema.safeParse(JSON.parse(await readFile(path, 'utf8')))
18
+ if (marker.success) return marker.data.at
19
+ } catch (error) {
20
+ if (!(error instanceof SyntaxError) && !(error instanceof Error && 'code' in error && error.code === 'ENOENT'))
21
+ throw error
22
+ }
23
+ }
24
+ return null
25
+ }
26
+
27
+ export async function writeLastAlive(agentDir: string, adapter: AdapterId, at: number): Promise<void> {
28
+ const dir = join(agentDir, 'channels')
29
+ await mkdir(dir, { recursive: true })
30
+ const path = join(dir, `${adapter}-catch-up-last-alive.json`)
31
+ const tmp = `${path}.${randomUUID()}.tmp`
32
+ await writeFile(tmp, JSON.stringify({ at }))
33
+ await rename(tmp, path)
34
+ }
@@ -21,7 +21,7 @@ import { createInstagramAdapter, type InstagramAdapter } from './adapters/instag
21
21
  import { createKakaotalkAdapter, type KakaotalkAdapter } from './adapters/kakaotalk'
22
22
  import { createLineAdapter, type LineAdapter } from './adapters/line'
23
23
  import { createSlackAdapter, type SlackAdapter } from './adapters/slack'
24
- import { createSlackBotAdapter, type SlackBotAdapter } from './adapters/slack-bot'
24
+ import { createSlackBotAdapter, type SlackBotAdapter, type SlackMessageObserver } from './adapters/slack-bot'
25
25
  import { createTeamsAdapter, type TeamsAdapter } from './adapters/teams'
26
26
  import { createTelegramBotAdapter, type TelegramBotAdapter } from './adapters/telegram-bot'
27
27
  import { createWebexAdapter, type WebexAdapter } from './adapters/webex'
@@ -36,6 +36,7 @@ import {
36
36
  type ChannelRouter,
37
37
  type ClaimHandler,
38
38
  type CreateSessionForChannel,
39
+ type ChannelOutboundReviewer,
39
40
  type RestartCommandContext,
40
41
  } from './router'
41
42
  import {
@@ -88,6 +89,9 @@ export type ChannelManagerOptions = {
88
89
  // cannot reply, which is fine for tests but a bug in production. See
89
90
  // src/run/index.ts where this is wired.
90
91
  createSessionForChannel?: CreateSessionForChannel
92
+ slackBotMessageObserver?: SlackMessageObserver
93
+ outboundReviewer?: ChannelOutboundReviewer
94
+ outboundReviewerActive?: () => boolean
91
95
  // Test seams: let fake adapters replace the real adapter wiring per id.
92
96
  createDiscordAdapter?: typeof createDiscordBotAdapter
93
97
  createDiscordUserAdapter?: typeof createDiscordAdapter
@@ -270,6 +274,8 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
270
274
  ...(options.cancelRunningSubagentsByWorkKey
271
275
  ? { cancelRunningSubagentsByWorkKey: options.cancelRunningSubagentsByWorkKey }
272
276
  : {}),
277
+ ...(options.outboundReviewer ? { reviewOutbound: options.outboundReviewer } : {}),
278
+ ...(options.outboundReviewerActive ? { outboundReviewerActive: options.outboundReviewerActive } : {}),
273
279
  })
274
280
  const createDiscordBot = options.createDiscordAdapter ?? createDiscordBotAdapter
275
281
  const createDiscordUser = options.createDiscordUserAdapter ?? createDiscordAdapter
@@ -354,6 +360,7 @@ export function createChannelManager(options: ChannelManagerOptions): ChannelMan
354
360
  appToken,
355
361
  logger,
356
362
  selfAliasesRef: () => router.getSelfAliases(),
363
+ ...(options.slackBotMessageObserver ? { messageObserver: options.slackBotMessageObserver } : {}),
357
364
  })
358
365
  }
359
366
  if (name === 'line') {