typeclaw 0.49.0 → 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 (442) 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 +9 -2
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/require-parallel.ts +5 -32
  317. package/src/agent/guard-types.ts +3 -0
  318. package/src/agent/guards.ts +4 -0
  319. package/src/agent/idle-compaction.ts +174 -0
  320. package/src/agent/index.ts +74 -16
  321. package/src/agent/live-subagents.ts +19 -0
  322. package/src/agent/multimodal/look-at.ts +22 -9
  323. package/src/agent/plugin-tools.ts +13 -1
  324. package/src/agent/reviewer-bash-policy.ts +41 -1
  325. package/src/agent/session-origin.ts +26 -10
  326. package/src/agent/subagent-cache-keepalive.ts +198 -0
  327. package/src/agent/subagent-session.ts +6 -0
  328. package/src/agent/subagents.ts +46 -8
  329. package/src/agent/system-prompt.ts +1 -1
  330. package/src/agent/tool-file-safety.ts +6 -1
  331. package/src/agent/tools/channel-edit.ts +20 -10
  332. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  333. package/src/agent/tools/channel-handoff.ts +72 -0
  334. package/src/agent/tools/channel-read.ts +57 -10
  335. package/src/agent/tools/channel-reply.ts +33 -26
  336. package/src/agent/tools/channel-send.ts +21 -13
  337. package/src/agent/tools/channel-session-search.ts +35 -0
  338. package/src/agent/tools/curl-impersonate.ts +11 -4
  339. package/src/agent/tools/ddg.ts +13 -5
  340. package/src/agent/tools/spawn-subagent.ts +27 -11
  341. package/src/agent/tools/stream-snapshot.ts +15 -2
  342. package/src/agent/tools/subagent-access.ts +11 -4
  343. package/src/browser/bsk-shim.mjs +74 -0
  344. package/src/browser/dockerfile.ts +84 -0
  345. package/src/browser/egress.ts +104 -0
  346. package/src/browser/managed-browser.ts +205 -0
  347. package/src/browser/registry.ts +110 -0
  348. package/src/browser/relay.ts +231 -0
  349. package/src/browser/sandbox-entry.ts +167 -0
  350. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  351. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  352. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  353. package/src/bundled-plugins/doc-render/index.ts +0 -10
  354. package/src/bundled-plugins/doc-render/render.ts +83 -111
  355. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  356. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  357. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  358. package/src/bundled-plugins/github-cli-auth/index.ts +75 -59
  359. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  360. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  361. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  362. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  363. package/src/bundled-plugins/operator/operator.ts +1 -1
  364. package/src/bundled-plugins/qa/index.ts +11 -0
  365. package/src/bundled-plugins/qa/qa.ts +160 -0
  366. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  367. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  368. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  369. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  370. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  371. package/src/bundled-plugins/security/index.ts +53 -34
  372. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  373. package/src/channels/adapter-namespace.ts +13 -0
  374. package/src/channels/adapters/discord-bot.ts +97 -5
  375. package/src/channels/adapters/github/index.ts +16 -0
  376. package/src/channels/adapters/github/last-alive.ts +4 -16
  377. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  378. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  379. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  380. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  381. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  382. package/src/channels/adapters/slack-bot.ts +299 -67
  383. package/src/channels/adapters/slack-classify.ts +1 -0
  384. package/src/channels/catch-up.ts +137 -0
  385. package/src/channels/continuation-willingness.ts +2 -2
  386. package/src/channels/continuity-types.ts +1 -0
  387. package/src/channels/engagement.ts +17 -1
  388. package/src/channels/github-false-receipt.ts +3 -3
  389. package/src/channels/github-rereview-guard.ts +9 -5
  390. package/src/channels/github-token-bridge.ts +24 -0
  391. package/src/channels/last-alive.ts +34 -0
  392. package/src/channels/manager.ts +8 -1
  393. package/src/channels/router.ts +427 -136
  394. package/src/channels/session-handoff.fixture.ts +144 -0
  395. package/src/channels/session-handoff.ts +175 -0
  396. package/src/channels/session-search.ts +71 -0
  397. package/src/channels/types.ts +12 -2
  398. package/src/cli/channel.ts +2 -3
  399. package/src/cli/init.ts +2 -3
  400. package/src/cli/model.ts +132 -3
  401. package/src/coding-agent/index.ts +7 -1
  402. package/src/coding-agent/omo-stream.ts +40 -0
  403. package/src/coding-agent/runner.ts +30 -8
  404. package/src/config/config.ts +111 -22
  405. package/src/config/model-overrides.ts +59 -0
  406. package/src/config/models-mutation.ts +185 -2
  407. package/src/config/providers-mutation.ts +12 -4
  408. package/src/config/providers.ts +59 -0
  409. package/src/container/start.ts +95 -4
  410. package/src/doctor/checks.ts +8 -6
  411. package/src/hostd/daemon.ts +13 -1
  412. package/src/init/auto-upgrade.ts +7 -1
  413. package/src/init/dockerfile.ts +57 -12
  414. package/src/init/index.ts +4 -3
  415. package/src/init/local-source-stamp.ts +68 -0
  416. package/src/init/models-dev.ts +4 -0
  417. package/src/init/validate-api-key.ts +3 -0
  418. package/src/permissions/builtins.ts +7 -0
  419. package/src/permissions/permissions.ts +18 -9
  420. package/src/permissions/resolve.ts +7 -1
  421. package/src/plugin/context.ts +2 -0
  422. package/src/plugin/hooks.ts +137 -0
  423. package/src/plugin/index.ts +6 -0
  424. package/src/plugin/manager.ts +4 -0
  425. package/src/plugin/types.ts +60 -0
  426. package/src/run/bundled-plugins.ts +6 -0
  427. package/src/run/index.ts +24 -14
  428. package/src/run/llm-fetch-observer.ts +12 -15
  429. package/src/sandbox/canonical-secrets.ts +4 -0
  430. package/src/sandbox/dev-source.ts +26 -0
  431. package/src/sandbox/hidden-paths.ts +16 -2
  432. package/src/secrets/storage.ts +13 -0
  433. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  434. package/src/skills/typeclaw-config/SKILL.md +39 -5
  435. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  436. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  437. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  438. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  439. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  440. package/typeclaw.schema.json +436 -5
  441. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  442. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -0,0 +1,39 @@
1
+ import type { LoadableSkill } from '@/plugin'
2
+
3
+ export const HTTP_QA_SKILL: LoadableSkill = {
4
+ name: 'qa-http',
5
+ description:
6
+ 'QA an HTTP or JSON API: exercise endpoints with curl, capture status, headers, and bodies, chain requests through realistic workflows, and cover validation errors, auth failures, and idempotency.',
7
+ content: `# qa-http
8
+
9
+ You are QAing an HTTP API. Apply this on top of the QA loop and the \`<qa>\` output contract.
10
+
11
+ ## Reach the API
12
+
13
+ - **A deployed endpoint** — use it as given. Never send destructive requests (DELETE, bulk updates) to production unless the caller explicitly asked and named a test resource.
14
+ - **A repo or PR** — write one script that starts the server from the documented command, waits for its health endpoint or port with a bounded retry loop, runs your requests, and stops the server; run it in a single \`bash\` call (a server backgrounded in one call does not survive to the next). Record the start command.
15
+ - Credentials come from the caller or from env vars the operator already exposed. Never print a token into evidence; redact it as \`<redacted>\`.
16
+
17
+ ## Capture
18
+
19
+ Use \`curl -sS -i\` so the status line and headers are kept with the body. Save each response to \`/tmp/qa/<run-id>/<scenario>.http\`. If \`hurl\` is installed, a \`.hurl\` file with assertions is a fine way to make a flow repeatable; keep its report.
20
+
21
+ ## What to cover
22
+
23
+ 1. **Happy path** for each endpoint the request names: correct status, response shape, and the field values the contract promises.
24
+ 2. **Workflow chain**: create → read back → update → read back → delete → confirm gone. Capture ids from earlier responses rather than hardcoding them.
25
+ 3. **Validation**: missing field, wrong type, out-of-range value. Expect a 4xx with a message that names the field, never a 500.
26
+ 4. **Auth**: no credentials and wrong credentials return 401/403, never data.
27
+ 5. **Not found and method errors**: an unknown id returns 404; a wrong method returns 405 or the documented behavior.
28
+ 6. **Idempotency and retries** where the API promises them: the same PUT twice leaves the same state; a retried create with an idempotency key does not duplicate.
29
+ 7. **Non-ASCII payloads**: Korean or Japanese strings round-trip unchanged.
30
+
31
+ ## Severity
32
+
33
+ - **blocker** — wrong data, a 5xx on valid input, auth bypass, a broken contract field.
34
+ - **concern** — a 5xx on invalid input, a vague error, an undocumented status code.
35
+ - **nit** — header or formatting inconsistencies.
36
+
37
+ Return everything inside the \`<qa>\` block.
38
+ `,
39
+ }
@@ -0,0 +1,51 @@
1
+ import type { LoadableSkill } from '@/plugin'
2
+
3
+ export const PR_QA_SKILL: LoadableSkill = {
4
+ name: 'qa-pr',
5
+ description:
6
+ 'QA a pull request, branch, commit, or whole repository: acquire it at an exact SHA, install and build from a clean scratch clone, run the project’s own checks, then exercise the changed behavior through its real interface and compare against the base when attribution matters.',
7
+ content: `# qa-pr
8
+
9
+ You are QAing code that lives in a repository: a pull request, a branch, a commit, or an open-source project as a whole. Apply this on top of the QA loop and the \`<qa>\` output contract.
10
+
11
+ ## Acquire the target at an exact revision
12
+
13
+ - **GitHub PR** — \`gh pr view <n> --repo <owner>/<repo> --json title,body,headRefOid,baseRefOid,files\` gives intent, the head SHA, and the changed files. \`gh pr diff <n> --repo <owner>/<repo>\` gives the diff. Keep each \`gh\` call a single bare invocation (no pipes, \`&&\`, or redirects): the runtime injects a token into its environment.
14
+ - **Public repo** — \`git clone <url> /tmp/qa/<run-id>/head\`. A clone does not include pull-request refs, so for a PR (especially from a fork) also run \`git -C /tmp/qa/<run-id>/head fetch origin pull/<n>/head\`. Then \`git -C /tmp/qa/<run-id>/head checkout <headSha>\` and confirm \`git -C /tmp/qa/<run-id>/head rev-parse HEAD\` equals the head SHA.
15
+ - **Private GitHub repo** — call \`github_prepare_review_checkout\` with the repo slug, head SHA, and merge-base SHA. Its receipt is a read-only acquisition cache: make your writable tree with \`git clone <receipt-path> /tmp/qa/<run-id>/head\` and work only in the clone.
16
+ - **Base comparison** — when you must show the change caused (or fixed) a behavior, make a second clone at the merge base in \`/tmp/qa/<run-id>/base\` and run the same scenario on both.
17
+
18
+ Record the head SHA (and base SHA if used) in \`<target>\`.
19
+
20
+ ## Derive the acceptance criteria
21
+
22
+ 1. Read the PR title/body and linked issues: what does the author claim the change does? Each claim becomes a scenario.
23
+ 2. Read the diff to find the user-facing surface it touches: a CLI flag, an endpoint, a page, a library export, a config key.
24
+ 3. Read \`README\`, \`CONTRIBUTING\`, \`AGENTS.md\`, \`package.json\`/\`Makefile\`/\`pyproject.toml\`/\`Cargo.toml\` for the canonical install, build, test, and run commands. Use the project's commands, not ones you invent.
25
+ 4. Add one regression scenario on adjacent behavior the diff could break, and one edge case on the changed path.
26
+
27
+ ## Build and run the project's own checks
28
+
29
+ - Install with the lockfile the repo ships (\`bun install --frozen-lockfile\`, \`npm ci\`, \`pnpm install --frozen-lockfile\`, \`pip install -e .\`, \`cargo build\`, \`go build ./...\`).
30
+ - Run the documented typecheck, lint, and test commands. Record pass/fail counts and exit codes as scenarios.
31
+ - A check that also fails on the base revision is a **pre-existing failure**: report it in \`<coverage_gaps>\` or as a \`concern\`, never as a defect of this change. Only run the base when a failure needs attribution.
32
+ - If install or build cannot work in this environment (needs a GPU, a paid service, a platform you are not on), the run is \`inconclusive\` for those scenarios; say what is missing.
33
+
34
+ ## Exercise the changed behavior for real
35
+
36
+ Green tests are not the finish line: tests can be too narrow, and the author wrote them. Drive the changed behavior through its real interface:
37
+
38
+ - CLI change → run the built binary with the new flag/subcommand (load \`qa-cli\`).
39
+ - Web change → start the dev server and drive the page (load \`qa-web\`).
40
+ - API change → start the server and hit the endpoint (load \`qa-http\`).
41
+ - Library change → write a small script in your scratch dir that imports the public API and exercises the new behavior; keep its transcript.
42
+
43
+ ## Severity
44
+
45
+ - **blocker** — a stated claim of the PR does not hold, the build or the project's own tests break because of this change, or a regression on adjacent behavior.
46
+ - **concern** — an edge case on the changed path misbehaves, a missing error message, a docs claim that does not match behavior.
47
+ - **nit** — cosmetic output issues that do not affect correctness.
48
+
49
+ Return everything inside the \`<qa>\` block.
50
+ `,
51
+ }
@@ -0,0 +1,49 @@
1
+ import type { LoadableSkill } from '@/plugin'
2
+
3
+ export const WEB_QA_SKILL: LoadableSkill = {
4
+ name: 'qa-web',
5
+ description:
6
+ 'QA a web app or URL in a real browser: drive user flows with a browser engine (agent-browser by default), capture screenshots and console/network errors per step, and cover happy path, a negative path, and mobile plus desktop widths.',
7
+ content: `# qa-web
8
+
9
+ You are QAing something that renders in a browser. Apply this on top of the QA loop and the \`<qa>\` output contract.
10
+
11
+ ## Get a page to test
12
+
13
+ - **A deployed URL** — use it directly. Do not log in to accounts, submit payments, or send messages on a production site unless the caller explicitly asked you to and provided a test account.
14
+ - **A repo or PR** — install, then write one script that starts the dev or preview server from the project's documented command, waits until the port answers (\`curl -sf http://localhost:<port>\` in a bounded retry loop), runs your browser steps, and stops the server. Run it in a single \`bash\` call: a server backgrounded in one call does not survive to the next. Record the start command.
15
+
16
+ ## Drive the browser
17
+
18
+ The \`agent-browser\` CLI is always installed and is used below. If the operator enabled another engine (\`omowright\`, \`browser-use\`, \`browserskill\`), its skill is loaded and you may use it instead with the same loop. When TypeClaw's shared browser is running, agent-browser attaches to it automatically. The loop is observe → act → observe:
19
+
20
+ - \`agent-browser open <url>\` to load the page.
21
+ - \`agent-browser snapshot -i\` to get the interactive elements with \`@e\` refs; act on refs, not guessed selectors.
22
+ - \`agent-browser click @e3\`, \`agent-browser fill @e5 "text"\`, \`agent-browser press Enter\` to interact.
23
+ - \`agent-browser screenshot /tmp/qa/<run-id>/<scenario>-<step>.png\` after each meaningful step.
24
+ - Read console errors and failed requests after each flow; an uncaught exception or a 4xx/5xx on a load-bearing request is a finding even when the page looks fine.
25
+ - \`agent-browser close\` when done.
26
+
27
+ If the project already ships Playwright tests, running them is a check scenario, not a replacement for driving the flow yourself.
28
+
29
+ ## What to cover
30
+
31
+ 1. **Happy path** of every flow the request names, end to end, with the resulting state verified (the item appears in the list, the URL changes, the success message shows).
32
+ 2. **A negative path**: empty or invalid form input, a missing resource, an unauthorized action. The UI must say what went wrong.
33
+ 3. **Widths**: at least one desktop (about 1440 wide) and one phone-sized (about 390 wide) pass of the main screen. Clipped text, overlapping elements, or horizontal scroll of primary content are findings.
34
+ 4. **Reload and back**: state that should persist survives a reload; the back button does not break the flow.
35
+ 5. **Non-English text** when the product is used internationally: Korean or Japanese input renders and wraps without clipping.
36
+
37
+ ## Evidence
38
+
39
+ Every scenario cites its screenshots and the console/network excerpt. Describe what each screenshot shows in \`<observed>\`; the parent may not be able to open images.
40
+
41
+ ## Severity
42
+
43
+ - **blocker** — a named flow cannot complete, data is lost or wrong, an uncaught error breaks the page.
44
+ - **concern** — a negative path gives no feedback, layout breaks at one width, a console error that does not yet break the flow.
45
+ - **nit** — visual polish.
46
+
47
+ Return everything inside the \`<qa>\` block.
48
+ `,
49
+ }
@@ -141,6 +141,26 @@ function reportInternalGuardError(logger: PluginLogger, guard: string, error: un
141
141
  logger.error(`internal security guard error guard=${guard}${code}: ${detail}`)
142
142
  }
143
143
 
144
+ // The medium-tier heuristic guards (secretExfilBash/Read, ssrf,
145
+ // sessionSearchSecrets) cover non-canonical surfaces: canonical credential
146
+ // stores stay masked by the bash sandbox and privateSurfaceRead regardless.
147
+ // A bug in one of them must not deny every tool call it inspects, so its
148
+ // internal error is logged for the operator and only that check is skipped.
149
+ // Promotion, taint, private-surface, and high-tier checks keep failing closed
150
+ // through the hook-level catch.
151
+ function runHeuristicGuard(
152
+ logger: PluginLogger,
153
+ guard: string,
154
+ run: () => SecurityBlock | undefined,
155
+ ): SecurityBlock | undefined {
156
+ try {
157
+ return run()
158
+ } catch (error) {
159
+ reportInternalGuardError(logger, guard, error)
160
+ return undefined
161
+ }
162
+ }
163
+
144
164
  export default definePlugin({
145
165
  permissions: Object.values(SECURITY_PERMISSIONS),
146
166
  // No wildcard exclusions: owner bypasses every security tier by default
@@ -239,16 +259,15 @@ export default definePlugin({
239
259
  )
240
260
  if (gitRemoteTaintedResult) return gitRemoteTaintedResult
241
261
 
242
- const secretExfilBashResult = canBypass(
243
- GUARD_SECRET_EXFIL_BASH_SEVERITY,
244
- SECURITY_PERMISSIONS.bypassSecretExfilBash,
262
+ const secretExfilBashResult = runHeuristicGuard(ctx.logger, 'secretExfilBash', () =>
263
+ canBypass(GUARD_SECRET_EXFIL_BASH_SEVERITY, SECURITY_PERMISSIONS.bypassSecretExfilBash)
264
+ ? undefined
265
+ : withPermissionHint(
266
+ checkSecretExfilBashGuard({ tool: event.tool, args: event.args }),
267
+ SECURITY_PERMISSIONS.bypassSecretExfilBash,
268
+ GUARD_SECRET_EXFIL_BASH_SEVERITY,
269
+ ),
245
270
  )
246
- ? undefined
247
- : withPermissionHint(
248
- checkSecretExfilBashGuard({ tool: event.tool, args: event.args }),
249
- SECURITY_PERMISSIONS.bypassSecretExfilBash,
250
- GUARD_SECRET_EXFIL_BASH_SEVERITY,
251
- )
252
271
  if (secretExfilBashResult) return secretExfilBashResult
253
272
 
254
273
  const gitExfilResult = canBypass(GUARD_GIT_EXFIL_SEVERITY, SECURITY_PERMISSIONS.bypassGitExfil)
@@ -263,16 +282,15 @@ export default definePlugin({
263
282
  if (pushGrant.kind !== 'allow') return withPushGrantHint(gitExfilResult, pushGrant)
264
283
  }
265
284
 
266
- const secretExfilReadResult = canBypass(
267
- GUARD_SECRET_EXFIL_READ_SEVERITY,
268
- SECURITY_PERMISSIONS.bypassSecretExfilRead,
285
+ const secretExfilReadResult = runHeuristicGuard(ctx.logger, 'secretExfilRead', () =>
286
+ canBypass(GUARD_SECRET_EXFIL_READ_SEVERITY, SECURITY_PERMISSIONS.bypassSecretExfilRead)
287
+ ? undefined
288
+ : withPermissionHint(
289
+ checkSecretExfilReadGuard({ tool: event.tool, args: event.args }),
290
+ SECURITY_PERMISSIONS.bypassSecretExfilRead,
291
+ GUARD_SECRET_EXFIL_READ_SEVERITY,
292
+ ),
269
293
  )
270
- ? undefined
271
- : withPermissionHint(
272
- checkSecretExfilReadGuard({ tool: event.tool, args: event.args }),
273
- SECURITY_PERMISSIONS.bypassSecretExfilRead,
274
- GUARD_SECRET_EXFIL_READ_SEVERITY,
275
- )
276
294
  if (secretExfilReadResult) return secretExfilReadResult
277
295
 
278
296
  // Not severity-bypassed: private directories remain role-derived,
@@ -293,25 +311,26 @@ export default definePlugin({
293
311
  )
294
312
  if (privateSurfaceReadResult) return privateSurfaceReadResult
295
313
 
296
- const ssrfResult = canBypass(GUARD_SSRF_SEVERITY, SECURITY_PERMISSIONS.bypassSsrf)
297
- ? undefined
298
- : withPermissionHint(
299
- checkSsrfGuard({ tool: event.tool, args: event.args }),
300
- SECURITY_PERMISSIONS.bypassSsrf,
301
- GUARD_SSRF_SEVERITY,
302
- )
314
+ const ssrfResult = runHeuristicGuard(ctx.logger, 'ssrf', () =>
315
+ canBypass(GUARD_SSRF_SEVERITY, SECURITY_PERMISSIONS.bypassSsrf)
316
+ ? undefined
317
+ : withPermissionHint(
318
+ checkSsrfGuard({ tool: event.tool, args: event.args }),
319
+ SECURITY_PERMISSIONS.bypassSsrf,
320
+ GUARD_SSRF_SEVERITY,
321
+ ),
322
+ )
303
323
  if (ssrfResult) return ssrfResult
304
324
 
305
- const sessionSearchSecretsResult = canBypass(
306
- GUARD_SESSION_SEARCH_SECRETS_SEVERITY,
307
- SECURITY_PERMISSIONS.bypassSessionSearchSecrets,
325
+ const sessionSearchSecretsResult = runHeuristicGuard(ctx.logger, 'sessionSearchSecrets', () =>
326
+ canBypass(GUARD_SESSION_SEARCH_SECRETS_SEVERITY, SECURITY_PERMISSIONS.bypassSessionSearchSecrets)
327
+ ? undefined
328
+ : withPermissionHint(
329
+ checkSessionSearchSecretsGuard({ tool: event.tool, args: event.args }),
330
+ SECURITY_PERMISSIONS.bypassSessionSearchSecrets,
331
+ GUARD_SESSION_SEARCH_SECRETS_SEVERITY,
332
+ ),
308
333
  )
309
- ? undefined
310
- : withPermissionHint(
311
- checkSessionSearchSecretsGuard({ tool: event.tool, args: event.args }),
312
- SECURITY_PERMISSIONS.bypassSessionSearchSecrets,
313
- GUARD_SESSION_SEARCH_SECRETS_SEVERITY,
314
- )
315
334
  if (sessionSearchSecretsResult) return sessionSearchSecretsResult
316
335
 
317
336
  const systemPromptLeakResult = canBypass(
@@ -59,6 +59,7 @@ const PROCESS_ENV_TARGETS: ReadonlyArray<string> = [
59
59
  'UPSTAGE_API_KEY',
60
60
  'MOONSHOT_API_KEY',
61
61
  'MOONSHOT_CODING_API_KEY',
62
+ 'INCEPTION_API_KEY',
62
63
  'GOOGLE_API_KEY',
63
64
  'GEMINI_API_KEY',
64
65
  'AWS_ACCESS_KEY_ID',
@@ -0,0 +1,13 @@
1
+ import type { AdapterId } from './schema'
2
+
3
+ // Only these account modes share platform user IDs. New/unlisted adapters
4
+ // retain their own namespace rather than accidentally linking identities.
5
+ const SHARED_NAMESPACES: Partial<Record<AdapterId, AdapterId>> = {
6
+ 'discord-bot': 'discord',
7
+ 'slack-bot': 'slack',
8
+ 'webex-bot': 'webex',
9
+ }
10
+
11
+ export function adapterNamespace(adapter: AdapterId): AdapterId {
12
+ return SHARED_NAMESPACES[adapter] ?? adapter
13
+ }
@@ -15,6 +15,7 @@ import {
15
15
  enrichHistoricalProvenance,
16
16
  type HistoricalProvenanceResolver,
17
17
  } from '@/bundled-plugins/memory/provenance-index'
18
+ import { CATCH_UP_CONVERSATION_LIMIT, type ListMissedInbound, type MissedInbound } from '@/channels/catch-up'
18
19
  import {
19
20
  DEFAULT_ATTACHMENT_MAX_BYTES,
20
21
  readAttachmentErrorSnippet,
@@ -31,6 +32,7 @@ import type { ChannelRouter } from '@/channels/router'
31
32
  import type { ChannelAdapterConfig } from '@/channels/schema'
32
33
  import type {
33
34
  ChannelHistoryMessage,
35
+ ChannelKey,
34
36
  ChannelListEntry,
35
37
  ChannelSelfIdentityResolver,
36
38
  FetchAttachmentCallback,
@@ -548,6 +550,8 @@ type DiscordRawHistoryMessage = {
548
550
  content: string
549
551
  timestamp: string
550
552
  mentions?: DiscordMentionUser[]
553
+ mention_everyone?: boolean
554
+ mention_roles?: string[]
551
555
  message_reference?: { message_id?: string; channel_id?: string }
552
556
  attachments?: DiscordFile[]
553
557
  embeds?: DiscordGatewayEmbed[]
@@ -582,10 +586,7 @@ export function createDiscordHistoryCallback(deps: {
582
586
  let raw: DiscordRawHistoryMessage[]
583
587
  let response: Response
584
588
  try {
585
- response = await fetchFn(`${DISCORD_API_BASE}/channels/${channelId}/messages?${params.toString()}`, {
586
- method: 'GET',
587
- headers: { Authorization: `Bot ${token}` },
588
- })
589
+ response = await fetchDiscordHistoryPage(token, fetchFn, channelId, params)
589
590
  } catch (err) {
590
591
  const message = describeError(err)
591
592
  logger.warn(`[discord-bot] history fetch failed: ${message}`)
@@ -617,6 +618,79 @@ export function createDiscordHistoryCallback(deps: {
617
618
  }
618
619
  }
619
620
 
621
+ function fetchDiscordHistoryPage(token: string, fetchFn: typeof fetch, channelId: string, params: URLSearchParams) {
622
+ return fetchFn(`${DISCORD_API_BASE}/channels/${channelId}/messages?${params.toString()}`, {
623
+ method: 'GET',
624
+ headers: { Authorization: `Bot ${token}` },
625
+ })
626
+ }
627
+
628
+ export function createDiscordMissedInboundCallback(deps: {
629
+ token: string
630
+ logger: DiscordBotAdapterLogger
631
+ configRef: () => ChannelAdapterConfig
632
+ botUserIdRef: () => string | null
633
+ targets: () => Promise<readonly ChannelKey[]>
634
+ room: (chat: string) => Promise<import('@/channels/types').InboundMessage['room']>
635
+ fetchImpl?: typeof fetch
636
+ }): ListMissedInbound {
637
+ const fetchFn = deps.fetchImpl ?? fetch
638
+ return async (since) => {
639
+ const botUserId = deps.botUserIdRef()
640
+ if (botUserId === null) return []
641
+ const result: MissedInbound[] = []
642
+ const targets = new Map((await deps.targets()).map((key) => [key.chat, key]))
643
+ // Only previously watched conversations: never enumerate every guild
644
+ // channel the token happens to be able to read. Threads are channels too.
645
+ for (const key of [...targets.values()].slice(0, CATCH_UP_CONVERSATION_LIMIT)) {
646
+ const response = await fetchDiscordHistoryPage(
647
+ deps.token,
648
+ fetchFn,
649
+ key.chat,
650
+ new URLSearchParams({ limit: '100' }),
651
+ )
652
+ if (!response.ok) {
653
+ deps.logger.warn(`[discord-bot] catch-up history ${key.chat} failed: http ${response.status}`)
654
+ if (response.status === 403 || response.status === 404) continue
655
+ throw new Error(`Discord catch-up history http ${response.status}`)
656
+ }
657
+ const rows = (await response.json()) as DiscordRawHistoryMessage[]
658
+ const latestTs = Math.max(0, ...rows.map((row) => Date.parse(row.timestamp)).filter(Number.isFinite))
659
+ const room = key.workspace === '@dm' ? undefined : await deps.room(key.chat)
660
+ for (const row of rows) {
661
+ if (Date.parse(row.timestamp) < since) continue
662
+ const verdict = classifyInbound(
663
+ {
664
+ ...row,
665
+ type: 'MESSAGE_CREATE',
666
+ ...(key.workspace === '@dm' ? {} : { guild_id: key.workspace }),
667
+ author: { ...row.author, username: row.author.username ?? row.author.id },
668
+ mentions: row.mentions?.map((user) => ({
669
+ id: user.id,
670
+ username: user.username ?? user.id,
671
+ global_name: user.global_name ?? undefined,
672
+ })),
673
+ },
674
+ deps.configRef(),
675
+ botUserId,
676
+ )
677
+ if (verdict.kind !== 'route') continue
678
+ result.push({
679
+ message: {
680
+ ...verdict.payload,
681
+ room,
682
+ accountIdentity: `discord-bot:${botUserId}`,
683
+ eventKind: 'message',
684
+ revision: 'original',
685
+ },
686
+ latestTs,
687
+ })
688
+ }
689
+ }
690
+ return result.sort((a, b) => a.message.ts - b.message.ts)
691
+ }
692
+ }
693
+
620
694
  // Fetch one message via GET /channels/{id}/messages/{message_id}. Reuses
621
695
  // mapDiscordMessage so a single message renders identically to a history entry.
622
696
  // A 404 from Discord (deleted/unknown id) maps to a soft not-found.
@@ -1123,6 +1197,15 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1123
1197
  })
1124
1198
 
1125
1199
  const listCallback = createDiscordListCallback({ token: options.token, logger })
1200
+ const missedInbound = createDiscordMissedInboundCallback({
1201
+ token: options.token,
1202
+ logger,
1203
+ configRef: options.configRef,
1204
+ fetchImpl,
1205
+ botUserIdRef: () => botUserId,
1206
+ targets: () => options.router.catchUpTargets('discord-bot'),
1207
+ room: threadRoomResolver,
1208
+ })
1126
1209
 
1127
1210
  const membershipResolver = createDiscordMembershipResolver({
1128
1211
  token: options.token,
@@ -1264,6 +1347,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1264
1347
  listener.on('connected', (info) => {
1265
1348
  connected = true
1266
1349
  botUserId = info.user.id
1350
+ if (started) void options.router.catchUp('discord-bot')
1267
1351
  logger.info(`[discord-bot] connected as ${info.user.username} (${info.user.id})`)
1268
1352
  // For bots, the gateway's user.id IS the application id — the same
1269
1353
  // value is required for both /me lookups and /applications/{id}/
@@ -1295,6 +1379,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1295
1379
  })
1296
1380
  listener.on('disconnected', () => {
1297
1381
  connected = false
1382
+ options.router.disconnectCatchUp('discord-bot')
1298
1383
  logger.warn('[discord-bot] disconnected; SDK will reconnect with backoff')
1299
1384
  })
1300
1385
  listener.on('error', (err) => {
@@ -1302,7 +1387,10 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1302
1387
  // when a terminal Gateway close stops the listener. Match that
1303
1388
  // distinct SDK error contract without treating transient transport
1304
1389
  // errors as disconnects.
1305
- if (isTerminalGatewayClose(err)) connected = false
1390
+ if (isTerminalGatewayClose(err)) {
1391
+ connected = false
1392
+ options.router.disconnectCatchUp('discord-bot')
1393
+ }
1306
1394
  logger.error(`[discord-bot] gateway error: ${describeError(err)}`)
1307
1395
  })
1308
1396
  listener.on('message_create', (event) => {
@@ -1323,6 +1411,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1323
1411
  options.router.registerChannelNameResolver('discord-bot', channelResolver)
1324
1412
  options.router.registerSelfIdentity('discord-bot', selfIdentityResolver)
1325
1413
  options.router.registerHistory('discord-bot', historyCallback)
1414
+ options.router.registerMissedInbound('discord-bot', missedInbound)
1326
1415
  options.router.registerMessageGet('discord-bot', messageGetCallback)
1327
1416
  options.router.registerList('discord-bot', listCallback)
1328
1417
  options.router.registerEditMessage('discord-bot', editMessageCallback)
@@ -1347,6 +1436,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1347
1436
  options.router.unregisterChannelNameResolver('discord-bot', channelResolver)
1348
1437
  options.router.unregisterSelfIdentity('discord-bot', selfIdentityResolver)
1349
1438
  options.router.unregisterHistory('discord-bot', historyCallback)
1439
+ options.router.unregisterMissedInbound('discord-bot', missedInbound)
1350
1440
  options.router.unregisterMessageGet('discord-bot', messageGetCallback)
1351
1441
  options.router.unregisterList('discord-bot', listCallback)
1352
1442
  options.router.unregisterEditMessage('discord-bot', editMessageCallback)
@@ -1405,6 +1495,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1405
1495
  async stop(): Promise<void> {
1406
1496
  if (!started) return
1407
1497
  started = false
1498
+ options.router.disconnectCatchUp('discord-bot')
1408
1499
  options.router.unregisterOutbound('discord-bot', outboundCallback)
1409
1500
  options.router.unregisterReaction('discord-bot', reactionCallback)
1410
1501
  options.router.unregisterRemoveReaction('discord-bot', removeReactionCallback)
@@ -1415,6 +1506,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1415
1506
  options.router.unregisterChannelNameResolver('discord-bot', channelResolver)
1416
1507
  options.router.unregisterSelfIdentity('discord-bot', selfIdentityResolver)
1417
1508
  options.router.unregisterHistory('discord-bot', historyCallback)
1509
+ options.router.unregisterMissedInbound('discord-bot', missedInbound)
1418
1510
  options.router.unregisterRecoveryAdapter('discord-bot', recoveryCallbacks)
1419
1511
  options.router.unregisterMessageGet('discord-bot', messageGetCallback)
1420
1512
  options.router.unregisterList('discord-bot', listCallback)
@@ -427,6 +427,22 @@ export function createGithubAdapter(options: GithubAdapterOptions): GithubAdapte
427
427
  }
428
428
  tokenRefreshTimer = setIntervalFn(refresh, tokenRefreshIntervalMs)
429
429
  }
430
+ // The channel PAT is the agent's own GitHub identity, so lend it to a git push
431
+ // for a configured repo instead of making the operator duplicate it in `.env`.
432
+ // repos[] is enforced here because this adapter owns it; the broker adds the
433
+ // role gate, so sandboxed roles still never receive the long-lived PAT.
434
+ if (options.githubTokenBridge !== undefined) {
435
+ unregisterTokenBridge = options.githubTokenBridge.registerPatResolver(async (repoSlug) => {
436
+ const allowed = new Set((options.configRef().repos ?? []).map(canonicalGithubRepo))
437
+ if (!allowed.has(canonicalGithubRepo(repoSlug))) {
438
+ throw new Error(
439
+ `repo \`${repoSlug}\` is not in this agent's configured \`channels.github.repos[]\`; ` +
440
+ 'refusing to lend the GitHub channel PAT for it. Add it to `repos[]` if the agent is meant to push there.',
441
+ )
442
+ }
443
+ return { token: await auth.token() }
444
+ })
445
+ }
430
446
  }
431
447
  if (options.secrets.auth.type === 'app' && options.githubTokenBridge !== undefined) {
432
448
  // Gate ad-hoc `gh` minting on the configured repos[]. The slug arrives
@@ -1,27 +1,15 @@
1
- import { mkdir, readFile, rename, writeFile } from 'node:fs/promises'
2
- import { join } from 'node:path'
1
+ import { readLastAlive, writeLastAlive } from '../../last-alive'
3
2
 
4
3
  // When the GitHub adapter was last known alive. Reconcile replays only PRs
5
4
  // opened since then: those are the deliveries a downtime or tunnel change could
6
5
  // have dropped, while anything older was either seen live or predates the repo
7
6
  // being watched.
8
7
 
9
- const FILE = 'github-last-alive.json'
10
-
11
8
  export async function readGithubLastAlive(agentDir: string): Promise<number | null> {
12
- try {
13
- const parsed = JSON.parse(await readFile(join(agentDir, 'channels', FILE), 'utf8')) as { at?: unknown }
14
- return typeof parsed.at === 'number' && Number.isFinite(parsed.at) ? parsed.at : null
15
- } catch {
16
- return null
17
- }
9
+ // Preserve GitHub's best-effort boot behavior on an unreadable marker.
10
+ return readLastAlive(agentDir, 'github').catch(() => null)
18
11
  }
19
12
 
20
13
  export async function writeGithubLastAlive(agentDir: string, at: number): Promise<void> {
21
- const dir = join(agentDir, 'channels')
22
- await mkdir(dir, { recursive: true })
23
- const path = join(dir, FILE)
24
- const tmp = `${path}.${process.pid}.tmp`
25
- await writeFile(tmp, JSON.stringify({ at }))
26
- await rename(tmp, path)
14
+ return writeLastAlive(agentDir, 'github', at)
27
15
  }
@@ -51,11 +51,22 @@ export async function downloadSlackAttachment(options: {
51
51
  throw new Error(`Slack attachment download failed (${response.status})${snippet === '' ? '' : `: ${snippet}`}`)
52
52
  }
53
53
  const contentType = response.headers.get('content-type')?.toLocaleLowerCase() ?? ''
54
- if (contentType.includes('text/html') || contentType.includes('application/xhtml+xml')) {
54
+ const htmlResponse = contentType.includes('text/html') || contentType.includes('application/xhtml+xml')
55
+ const expectedHtml =
56
+ options.metadata.mimetype === 'text/html' || options.metadata.mimetype === 'application/xhtml+xml'
57
+ if (htmlResponse && !expectedHtml) {
55
58
  await discardAttachmentResponse(response)
56
- throw new Error('Slack attachment download returned an HTML login response')
59
+ throw new Error('Slack attachment download returned HTML instead of the declared file type')
57
60
  }
58
- return { buffer: await readAttachmentResponse(response, options.maxBytes), url }
61
+ const buffer = await readAttachmentResponse(response, options.maxBytes)
62
+ // HTML is a legitimate email/file type. Detect the authentication protocol,
63
+ // not human-language words (an email may itself discuss signing in).
64
+ if (
65
+ expectedHtml &&
66
+ /<form\b[^>]*\baction\s*=\s*["'][^"']*\/(?:signin|login)(?:[/?#"'])/i.test(buffer.toString('utf8'))
67
+ )
68
+ throw new Error('Slack attachment download returned an HTML login response')
69
+ return { buffer, url }
59
70
  }
60
71
  }
61
72
 
@@ -3,6 +3,7 @@ const DEFAULT_TTL_MS = 60 * 60 * 1000
3
3
 
4
4
  export type SlackAuthorResolverOptions = {
5
5
  token: string
6
+ fetchImpl?: typeof fetch
6
7
  now?: () => number
7
8
  ttlMs?: number
8
9
  }
@@ -39,7 +40,7 @@ export function createSlackAuthorResolver(options: SlackAuthorResolverOptions):
39
40
  const existing = inflight.get(userId)
40
41
  if (existing) return existing
41
42
 
42
- const promise = fetchUserName(userId, options.token)
43
+ const promise = fetchUserName(userId, options.token, options.fetchImpl ?? fetch)
43
44
  .then((name) => {
44
45
  if (name !== userId) {
45
46
  cache.set(userId, { name, expiresAt: now() + ttlMs })
@@ -57,9 +58,9 @@ export function createSlackAuthorResolver(options: SlackAuthorResolverOptions):
57
58
  return { resolve }
58
59
  }
59
60
 
60
- async function fetchUserName(userId: string, token: string): Promise<string> {
61
+ async function fetchUserName(userId: string, token: string, fetchImpl: typeof fetch): Promise<string> {
61
62
  try {
62
- const response = await fetch(`${SLACK_API_BASE}/users.info?user=${encodeURIComponent(userId)}`, {
63
+ const response = await fetchImpl(`${SLACK_API_BASE}/users.info?user=${encodeURIComponent(userId)}`, {
63
64
  headers: { Authorization: `Bearer ${token}` },
64
65
  })
65
66
  if (!response.ok) return userId
@@ -5,6 +5,7 @@ const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000
5
5
 
6
6
  export type SlackChannelResolverOptions = {
7
7
  token: string
8
+ fetchImpl?: typeof fetch
8
9
  now?: () => number
9
10
  ttlMs?: number
10
11
  }
@@ -44,8 +45,10 @@ export function createSlackChannelResolver(options: SlackChannelResolverOptions)
44
45
  if (key.workspace === '@dm') return {}
45
46
 
46
47
  const [chatName, workspaceName] = await Promise.all([
47
- fetchCached(chatCache, key.chat, () => fetchChannelName(key.chat, options.token)),
48
- fetchCached(teamCache, key.workspace, () => fetchTeamName(key.workspace, options.token)),
48
+ fetchCached(chatCache, key.chat, () => fetchChannelName(key.chat, options.token, options.fetchImpl ?? fetch)),
49
+ fetchCached(teamCache, key.workspace, () =>
50
+ fetchTeamName(key.workspace, options.token, options.fetchImpl ?? fetch),
51
+ ),
49
52
  ])
50
53
 
51
54
  const result: ResolvedChannelNames = {}
@@ -55,9 +58,9 @@ export function createSlackChannelResolver(options: SlackChannelResolverOptions)
55
58
  }
56
59
  }
57
60
 
58
- async function fetchChannelName(channelId: string, token: string): Promise<string | null> {
61
+ async function fetchChannelName(channelId: string, token: string, fetchImpl: typeof fetch): Promise<string | null> {
59
62
  try {
60
- const response = await fetch(`${SLACK_API_BASE}/conversations.info?channel=${encodeURIComponent(channelId)}`, {
63
+ const response = await fetchImpl(`${SLACK_API_BASE}/conversations.info?channel=${encodeURIComponent(channelId)}`, {
61
64
  headers: { Authorization: `Bearer ${token}` },
62
65
  })
63
66
  if (!response.ok) return null
@@ -69,9 +72,9 @@ async function fetchChannelName(channelId: string, token: string): Promise<strin
69
72
  }
70
73
  }
71
74
 
72
- async function fetchTeamName(teamId: string, token: string): Promise<string | null> {
75
+ async function fetchTeamName(teamId: string, token: string, fetchImpl: typeof fetch): Promise<string | null> {
73
76
  try {
74
- const response = await fetch(`${SLACK_API_BASE}/team.info?team=${encodeURIComponent(teamId)}`, {
77
+ const response = await fetchImpl(`${SLACK_API_BASE}/team.info?team=${encodeURIComponent(teamId)}`, {
75
78
  headers: { Authorization: `Bearer ${token}` },
76
79
  })
77
80
  if (!response.ok) return null
@@ -221,6 +221,7 @@ export function describeSlackFile(file: SlackFile, id: number): InboundAttachmen
221
221
 
222
222
  export function renderPlaceholder(attachment: InboundAttachment): string {
223
223
  const parts: string[] = [`Slack attachment #${attachment.id}: ${attachment.kind}`]
224
+ parts.push(`file_id=${attachment.ref}`)
224
225
  if (attachment.mimetype !== undefined) parts.push(attachment.mimetype)
225
226
  if (attachment.filename !== undefined) parts.push(`name=${attachment.filename}`)
226
227
  return `[${parts.join(' ')}]`
@@ -154,6 +154,8 @@ export function commandResultReply(result: ExecuteCommandResult): string {
154
154
  // visible only to the invoker (vs. 'in_channel' which posts to everyone).
155
155
  // Control gestures should stay ephemeral — same rationale as Discord's
156
156
  // EPHEMERAL flag on interaction callbacks.
157
- export function buildSlashAckPayload(text: string): { response_type: 'ephemeral'; text: string } {
157
+ export type SlashAckPayload = { response_type: 'ephemeral'; text: string }
158
+
159
+ export function buildSlashAckPayload(text: string): SlashAckPayload {
158
160
  return { response_type: 'ephemeral', text }
159
161
  }