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
@@ -14,6 +14,7 @@ export type DiscordMessagePointer = {
14
14
  }
15
15
 
16
16
  export async function enrichDiscordMessageReferences(args: {
17
+ adapter: 'discord' | 'discord-bot'
17
18
  text: string
18
19
  reply?: DiscordMessagePointer
19
20
  fetchMessage: DiscordReferenceFetch
@@ -25,7 +26,7 @@ export async function enrichDiscordMessageReferences(args: {
25
26
  if (args.reply !== undefined) {
26
27
  const parent = await fetchSafely(args.fetchMessage, args.reply)
27
28
  if (parent !== null) {
28
- sources.push(toSource(parent))
29
+ sources.push(toSource(args.adapter, parent))
29
30
  hasReply = true
30
31
  }
31
32
  }
@@ -33,7 +34,7 @@ export async function enrichDiscordMessageReferences(args: {
33
34
  const links = extractDiscordMessageLinks(args.text).slice(0, args.linkLimit ?? 3)
34
35
  for (const link of links) {
35
36
  const message = await fetchSafely(args.fetchMessage, link)
36
- if (message !== null) sources.push(toSource(message))
37
+ if (message !== null) sources.push(toSource(args.adapter, message))
37
38
  }
38
39
 
39
40
  if (sources.length === 0) return { text: args.text }
@@ -68,9 +69,9 @@ async function fetchSafely(
68
69
  }
69
70
  }
70
71
 
71
- function toSource(message: DiscordResolvedReference): QuoteAnchorSource {
72
+ function toSource(adapter: 'discord' | 'discord-bot', message: DiscordResolvedReference): QuoteAnchorSource {
72
73
  return {
73
- adapter: 'discord-bot',
74
+ adapter,
74
75
  authorId: message.authorId,
75
76
  authorName: message.authorName,
76
77
  text: message.text,
@@ -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,
@@ -1192,6 +1275,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1192
1275
  const hintedText = addDiscordMentionHints(verdict.payload.text, mentionUserMap(event.mentions), { botUserId })
1193
1276
  const replyMessageId = event.message_reference?.message_id
1194
1277
  const referenceResult = await enrichDiscordMessageReferences({
1278
+ adapter: 'discord-bot',
1195
1279
  text: hintedText,
1196
1280
  ...(replyMessageId !== undefined
1197
1281
  ? { reply: { channelId: event.message_reference?.channel_id ?? event.channel_id, messageId: replyMessageId } }
@@ -1264,6 +1348,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1264
1348
  listener.on('connected', (info) => {
1265
1349
  connected = true
1266
1350
  botUserId = info.user.id
1351
+ if (started) void options.router.catchUp('discord-bot')
1267
1352
  logger.info(`[discord-bot] connected as ${info.user.username} (${info.user.id})`)
1268
1353
  // For bots, the gateway's user.id IS the application id — the same
1269
1354
  // value is required for both /me lookups and /applications/{id}/
@@ -1295,6 +1380,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1295
1380
  })
1296
1381
  listener.on('disconnected', () => {
1297
1382
  connected = false
1383
+ options.router.disconnectCatchUp('discord-bot')
1298
1384
  logger.warn('[discord-bot] disconnected; SDK will reconnect with backoff')
1299
1385
  })
1300
1386
  listener.on('error', (err) => {
@@ -1302,7 +1388,10 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1302
1388
  // when a terminal Gateway close stops the listener. Match that
1303
1389
  // distinct SDK error contract without treating transient transport
1304
1390
  // errors as disconnects.
1305
- if (isTerminalGatewayClose(err)) connected = false
1391
+ if (isTerminalGatewayClose(err)) {
1392
+ connected = false
1393
+ options.router.disconnectCatchUp('discord-bot')
1394
+ }
1306
1395
  logger.error(`[discord-bot] gateway error: ${describeError(err)}`)
1307
1396
  })
1308
1397
  listener.on('message_create', (event) => {
@@ -1323,6 +1412,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1323
1412
  options.router.registerChannelNameResolver('discord-bot', channelResolver)
1324
1413
  options.router.registerSelfIdentity('discord-bot', selfIdentityResolver)
1325
1414
  options.router.registerHistory('discord-bot', historyCallback)
1415
+ options.router.registerMissedInbound('discord-bot', missedInbound)
1326
1416
  options.router.registerMessageGet('discord-bot', messageGetCallback)
1327
1417
  options.router.registerList('discord-bot', listCallback)
1328
1418
  options.router.registerEditMessage('discord-bot', editMessageCallback)
@@ -1347,6 +1437,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1347
1437
  options.router.unregisterChannelNameResolver('discord-bot', channelResolver)
1348
1438
  options.router.unregisterSelfIdentity('discord-bot', selfIdentityResolver)
1349
1439
  options.router.unregisterHistory('discord-bot', historyCallback)
1440
+ options.router.unregisterMissedInbound('discord-bot', missedInbound)
1350
1441
  options.router.unregisterMessageGet('discord-bot', messageGetCallback)
1351
1442
  options.router.unregisterList('discord-bot', listCallback)
1352
1443
  options.router.unregisterEditMessage('discord-bot', editMessageCallback)
@@ -1405,6 +1496,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1405
1496
  async stop(): Promise<void> {
1406
1497
  if (!started) return
1407
1498
  started = false
1499
+ options.router.disconnectCatchUp('discord-bot')
1408
1500
  options.router.unregisterOutbound('discord-bot', outboundCallback)
1409
1501
  options.router.unregisterReaction('discord-bot', reactionCallback)
1410
1502
  options.router.unregisterRemoveReaction('discord-bot', removeReactionCallback)
@@ -1415,6 +1507,7 @@ export function createDiscordBotAdapter(options: DiscordBotAdapterOptions): Disc
1415
1507
  options.router.unregisterChannelNameResolver('discord-bot', channelResolver)
1416
1508
  options.router.unregisterSelfIdentity('discord-bot', selfIdentityResolver)
1417
1509
  options.router.unregisterHistory('discord-bot', historyCallback)
1510
+ options.router.unregisterMissedInbound('discord-bot', missedInbound)
1418
1511
  options.router.unregisterRecoveryAdapter('discord-bot', recoveryCallbacks)
1419
1512
  options.router.unregisterMessageGet('discord-bot', messageGetCallback)
1420
1513
  options.router.unregisterList('discord-bot', listCallback)
@@ -8,13 +8,18 @@ import { encodeDiscordReactionRef } from './discord-reactions'
8
8
 
9
9
  export type DiscordInboundMessageEvent = DiscordGatewayMessageCreateEvent
10
10
 
11
- // WORKAROUND: the USER-token SDK type omits `author.bot` and
12
- // `message_reference`, but the listener spreads the raw Discord payload
13
- // (`{ ...d }`), so both fields exist at runtime. Narrow locally instead of
11
+ // WORKAROUND: the USER-token SDK type omits `author.bot`, `message_reference`,
12
+ // and `referenced_message`, but the listener spreads the raw Discord payload
13
+ // (`{ ...d }`), so they exist at runtime. Narrow locally instead of
14
14
  // augmenting the SDK type globally — do not "simplify" this away.
15
15
  export type RawDiscordMessageCreateEvent = DiscordGatewayMessageCreateEvent & {
16
16
  author: { bot?: boolean }
17
17
  message_reference?: { message_id?: string; channel_id?: string; guild_id?: string }
18
+ referenced_message?: {
19
+ id: string
20
+ content: string
21
+ author: { id: string; username: string; global_name?: string | null }
22
+ } | null
18
23
  }
19
24
 
20
25
  export type InboundDropReason = 'self_author' | 'no_user' | 'empty_content' | 'pre_connect'
@@ -40,11 +40,13 @@ import type { DiscordAccountRecord } from '@/secrets/schema'
40
40
 
41
41
  import { describeError } from '../describe-error'
42
42
  import { createDiscordAuthorResolver } from './discord-author-resolver'
43
+ import { enrichDiscordMessageReferences, type DiscordResolvedReference } from './discord-bot-reference'
43
44
  import { createDiscordChannelResolver } from './discord-channel-resolver'
44
45
  import {
45
46
  classifyInbound,
46
47
  type DiscordAttachmentCarrier,
47
48
  type InboundDropReason,
49
+ type RawDiscordMessageCreateEvent,
48
50
  splitDiscordAttachments,
49
51
  } from './discord-classify'
50
52
  import { createDiscordUserEditMessageCallback } from './discord-edit'
@@ -356,8 +358,24 @@ export function createDiscordAdapter(options: DiscordAdapterOptions): DiscordAda
356
358
  mimetype: file.content_type,
357
359
  }))
358
360
  const room = verdict.payload.isDm ? undefined : await channelResolver.resolveRoom(verdict.payload.chat)
361
+ const raw = event as RawDiscordMessageCreateEvent
362
+ const replyMessageId = raw.message_reference?.message_id
363
+ const { referenceContext } = await enrichDiscordMessageReferences({
364
+ adapter: 'discord',
365
+ text: verdict.payload.text,
366
+ ...(replyMessageId !== undefined
367
+ ? { reply: { channelId: raw.message_reference?.channel_id ?? event.channel_id, messageId: replyMessageId } }
368
+ : {}),
369
+ // Reply gateway events already carry the parent inline; only links and
370
+ // replies Discord did not expand (deleted/inaccessible parents) cost a fetch.
371
+ fetchMessage: async (channelId, messageId) =>
372
+ raw.referenced_message?.id === messageId
373
+ ? toResolvedReference(raw.referenced_message)
374
+ : toResolvedReference(await client.getMessage(channelId, messageId)),
375
+ })
359
376
  const payload = {
360
377
  ...verdict.payload,
378
+ ...(referenceContext !== undefined ? { referenceContext } : {}),
361
379
  authorName: await authorResolver.resolve(verdict.payload.authorId),
362
380
  ...(room !== undefined ? { room } : {}),
363
381
  ...(attachments.length > 0 ? { attachments } : {}),
@@ -580,6 +598,17 @@ function parseDiscordTimestamp(timestamp: string): number {
580
598
  return Number.isFinite(millis) ? millis : 0
581
599
  }
582
600
 
601
+ function toResolvedReference(message: {
602
+ content: string
603
+ author: { id: string; username: string; global_name?: string | null }
604
+ }): DiscordResolvedReference {
605
+ return {
606
+ authorId: message.author.id,
607
+ authorName: message.author.global_name ?? message.author.username,
608
+ text: message.content,
609
+ }
610
+ }
611
+
583
612
  const DISCORD_ATTACHMENT_HOSTS = new Set(['cdn.discordapp.com', 'media.discordapp.net'])
584
613
 
585
614
  function clampLimit(requested: number, max: number): number {
@@ -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
  }