typeclaw 0.48.13 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +13 -6
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/dump-system-prompt.ts +52 -110
  317. package/scripts/require-parallel.ts +5 -32
  318. package/src/agent/guard-types.ts +3 -0
  319. package/src/agent/guards.ts +4 -0
  320. package/src/agent/idle-compaction.ts +174 -0
  321. package/src/agent/index.ts +210 -80
  322. package/src/agent/live-sessions.ts +2 -2
  323. package/src/agent/live-subagents.ts +20 -0
  324. package/src/agent/multimodal/look-at.ts +22 -9
  325. package/src/agent/plugin-tools.ts +66 -12
  326. package/src/agent/prompt-cache-key.ts +42 -0
  327. package/src/agent/provider-error.ts +179 -10
  328. package/src/agent/restart-handoff/index.ts +7 -14
  329. package/src/agent/reviewer-activity.ts +68 -0
  330. package/src/agent/reviewer-bash-policy.ts +41 -1
  331. package/src/agent/session-origin.ts +58 -9
  332. package/src/agent/subagent-cache-keepalive.ts +198 -0
  333. package/src/agent/subagent-session.ts +6 -0
  334. package/src/agent/subagents.ts +59 -9
  335. package/src/agent/system-prompt.ts +68 -202
  336. package/src/agent/todo/continuation-policy.ts +12 -4
  337. package/src/agent/tool-file-safety.ts +119 -15
  338. package/src/agent/tool-not-found-nudge.ts +1 -1
  339. package/src/agent/tools/channel-edit.ts +20 -10
  340. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  341. package/src/agent/tools/channel-handoff.ts +72 -0
  342. package/src/agent/tools/channel-history-render.ts +2 -1
  343. package/src/agent/tools/channel-read.ts +57 -10
  344. package/src/agent/tools/channel-reply.ts +55 -30
  345. package/src/agent/tools/channel-send.ts +69 -19
  346. package/src/agent/tools/channel-session-search.ts +35 -0
  347. package/src/agent/tools/curl-impersonate.ts +22 -6
  348. package/src/agent/tools/ddg.ts +13 -5
  349. package/src/agent/tools/post-github-review.ts +77 -15
  350. package/src/agent/tools/skip-response.ts +2 -2
  351. package/src/agent/tools/spawn-subagent.ts +190 -23
  352. package/src/agent/tools/stream-snapshot.ts +15 -2
  353. package/src/agent/tools/subagent-access.ts +11 -4
  354. package/src/agent/tools/subagent-output.ts +8 -0
  355. package/src/browser/bsk-shim.mjs +74 -0
  356. package/src/browser/dockerfile.ts +84 -0
  357. package/src/browser/egress.ts +104 -0
  358. package/src/browser/managed-browser.ts +205 -0
  359. package/src/browser/registry.ts +110 -0
  360. package/src/browser/relay.ts +231 -0
  361. package/src/browser/sandbox-entry.ts +167 -0
  362. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  363. package/src/bundled-plugins/backup/README.md +10 -9
  364. package/src/bundled-plugins/backup/runner.ts +140 -58
  365. package/src/bundled-plugins/backup/subagents.ts +58 -26
  366. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  367. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  368. package/src/bundled-plugins/doc-render/index.ts +0 -10
  369. package/src/bundled-plugins/doc-render/render.ts +83 -111
  370. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  371. package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
  372. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  373. package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
  374. package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
  375. package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
  376. package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
  377. package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
  378. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  379. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  380. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  381. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  382. package/src/bundled-plugins/operator/operator.ts +15 -4
  383. package/src/bundled-plugins/qa/index.ts +11 -0
  384. package/src/bundled-plugins/qa/qa.ts +160 -0
  385. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  386. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  387. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  388. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  389. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  390. package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
  391. package/src/bundled-plugins/security/index.ts +103 -36
  392. package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
  393. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  394. package/src/channels/adapter-namespace.ts +13 -0
  395. package/src/channels/adapters/discord-bot-reactions.ts +18 -0
  396. package/src/channels/adapters/discord-bot.ts +219 -72
  397. package/src/channels/adapters/discord-reactions.ts +18 -0
  398. package/src/channels/adapters/discord.ts +114 -8
  399. package/src/channels/adapters/github/inbound.ts +103 -8
  400. package/src/channels/adapters/github/index.ts +267 -19
  401. package/src/channels/adapters/github/last-alive.ts +15 -0
  402. package/src/channels/adapters/github/outbound.ts +54 -18
  403. package/src/channels/adapters/github/pending-review-store.ts +141 -0
  404. package/src/channels/adapters/github/permission-guidance.ts +1 -0
  405. package/src/channels/adapters/github/reactions.ts +100 -0
  406. package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
  407. package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
  408. package/src/channels/adapters/github/recovery.ts +106 -0
  409. package/src/channels/adapters/github/review-check.ts +510 -0
  410. package/src/channels/adapters/github/review-submitter.ts +34 -2
  411. package/src/channels/adapters/instagram.ts +32 -14
  412. package/src/channels/adapters/kakaotalk.ts +22 -7
  413. package/src/channels/adapters/line.ts +18 -3
  414. package/src/channels/adapters/outbound-account.ts +20 -0
  415. package/src/channels/adapters/own-reactions.ts +66 -0
  416. package/src/channels/adapters/recovery-correlation.ts +214 -0
  417. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  418. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  419. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  420. package/src/channels/adapters/slack-bot-classify.ts +19 -11
  421. package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
  422. package/src/channels/adapters/slack-bot-reactions.ts +18 -0
  423. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  424. package/src/channels/adapters/slack-bot.ts +424 -124
  425. package/src/channels/adapters/slack-classify.ts +26 -4
  426. package/src/channels/adapters/slack-inbound-revision.ts +96 -0
  427. package/src/channels/adapters/slack-reactions.ts +18 -0
  428. package/src/channels/adapters/slack-thread-ts.ts +6 -0
  429. package/src/channels/adapters/slack.ts +48 -3
  430. package/src/channels/adapters/teams.ts +14 -4
  431. package/src/channels/adapters/telegram-bot.ts +56 -10
  432. package/src/channels/adapters/webex-bot.ts +12 -2
  433. package/src/channels/adapters/webex.ts +12 -2
  434. package/src/channels/background-handoff.ts +434 -0
  435. package/src/channels/background-obligations.ts +893 -0
  436. package/src/channels/catch-up.ts +137 -0
  437. package/src/channels/continuation-willingness.ts +2 -2
  438. package/src/channels/continuity-types.ts +272 -0
  439. package/src/channels/engagement.ts +17 -1
  440. package/src/channels/github-false-receipt.ts +3 -3
  441. package/src/channels/github-rereview-guard.ts +9 -5
  442. package/src/channels/github-review-check.ts +598 -0
  443. package/src/channels/github-review-turn-ledger.ts +102 -28
  444. package/src/channels/github-review-verdict-coordinator.ts +72 -12
  445. package/src/channels/github-token-bridge.ts +35 -5
  446. package/src/channels/inbound-journal.ts +1738 -0
  447. package/src/channels/index.ts +6 -1
  448. package/src/channels/last-alive.ts +34 -0
  449. package/src/channels/manager.ts +25 -8
  450. package/src/channels/recovery-dispatcher.ts +264 -0
  451. package/src/channels/recovery-notice.ts +94 -0
  452. package/src/channels/recovery-outbox.ts +459 -0
  453. package/src/channels/router.ts +2951 -736
  454. package/src/channels/schema.ts +8 -1
  455. package/src/channels/session-handoff.fixture.ts +144 -0
  456. package/src/channels/session-handoff.ts +175 -0
  457. package/src/channels/session-search.ts +71 -0
  458. package/src/channels/subagent-completion-bridge.ts +17 -14
  459. package/src/channels/types.ts +133 -18
  460. package/src/channels/waiting-reactions.ts +664 -0
  461. package/src/cli/channel.ts +2 -3
  462. package/src/cli/compose.ts +7 -4
  463. package/src/cli/hostd.ts +49 -3
  464. package/src/cli/init.ts +2 -3
  465. package/src/cli/inspect.ts +11 -14
  466. package/src/cli/model.ts +132 -3
  467. package/src/coding-agent/broker-body.ts +38 -0
  468. package/src/coding-agent/broker.ts +290 -0
  469. package/src/coding-agent/claude.ts +95 -0
  470. package/src/coding-agent/codex.ts +104 -0
  471. package/src/coding-agent/index.ts +512 -0
  472. package/src/coding-agent/omo-state.ts +69 -0
  473. package/src/coding-agent/omo-stream.ts +138 -0
  474. package/src/coding-agent/omo.ts +192 -0
  475. package/src/coding-agent/runner.ts +285 -0
  476. package/src/coding-agent/tool.ts +62 -0
  477. package/src/coding-agent/worktree.ts +355 -0
  478. package/src/compose/restart.ts +10 -3
  479. package/src/compose/start.ts +20 -3
  480. package/src/config/config.ts +121 -25
  481. package/src/config/model-overrides.ts +59 -0
  482. package/src/config/models-mutation.ts +185 -2
  483. package/src/config/providers-mutation.ts +12 -4
  484. package/src/config/providers.ts +71 -9
  485. package/src/container/exit-reason.ts +44 -0
  486. package/src/container/index.ts +5 -0
  487. package/src/container/log-archive.ts +51 -13
  488. package/src/container/memory-limit.ts +1 -1
  489. package/src/container/memory-oversubscription.ts +36 -6
  490. package/src/container/oom-events.ts +86 -0
  491. package/src/container/restart.ts +2 -0
  492. package/src/container/shared.ts +8 -1
  493. package/src/container/start.ts +120 -17
  494. package/src/container/stop.ts +6 -2
  495. package/src/container/tool-oom-priority.ts +32 -0
  496. package/src/cron/consumer.ts +10 -4
  497. package/src/cron/reloadable.ts +23 -2
  498. package/src/doctor/checks.ts +22 -8
  499. package/src/hostd/daemon.ts +33 -11
  500. package/src/hostd/spawn.ts +106 -5
  501. package/src/hostd/version.ts +20 -0
  502. package/src/hostd/watchdog.ts +241 -0
  503. package/src/init/auto-upgrade.ts +7 -1
  504. package/src/init/dockerfile.ts +112 -602
  505. package/src/init/index.ts +6 -6
  506. package/src/init/local-source-stamp.ts +68 -0
  507. package/src/init/models-dev.ts +4 -0
  508. package/src/init/validate-api-key.ts +3 -0
  509. package/src/mcp/client.ts +3 -1
  510. package/src/operations/classify-tool-outcome.ts +45 -1
  511. package/src/operations/incidents.ts +10 -5
  512. package/src/permissions/builtins.ts +7 -0
  513. package/src/permissions/permissions.ts +18 -9
  514. package/src/permissions/resolve.ts +7 -1
  515. package/src/plugin/context.ts +2 -0
  516. package/src/plugin/core-tool-names.ts +1 -1
  517. package/src/plugin/define.ts +1 -0
  518. package/src/plugin/hooks.ts +137 -0
  519. package/src/plugin/index.ts +7 -0
  520. package/src/plugin/manager.ts +4 -0
  521. package/src/plugin/types.ts +66 -1
  522. package/src/run/background-handoff-boot.ts +86 -0
  523. package/src/run/bundled-plugins.ts +6 -0
  524. package/src/run/index.ts +107 -97
  525. package/src/run/llm-fetch-observer.ts +12 -15
  526. package/src/run/resource-sample.ts +19 -0
  527. package/src/sandbox/build.ts +4 -0
  528. package/src/sandbox/canonical-secrets.ts +4 -0
  529. package/src/sandbox/coding-agent.ts +214 -0
  530. package/src/sandbox/dev-source.ts +26 -0
  531. package/src/sandbox/hidden-paths.ts +16 -2
  532. package/src/sandbox/policy.ts +1 -0
  533. package/src/sandbox/runtime-private.ts +4 -1
  534. package/src/secrets/coding-agent-auth.ts +97 -0
  535. package/src/secrets/index.ts +0 -16
  536. package/src/secrets/storage.ts +13 -0
  537. package/src/server/command-runner.ts +6 -2
  538. package/src/server/index.ts +101 -40
  539. package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
  540. package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
  541. package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
  542. package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
  543. package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
  544. package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
  545. package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
  546. package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
  547. package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
  548. package/src/skills/typeclaw-config/SKILL.md +60 -26
  549. package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
  550. package/src/skills/typeclaw-cron/SKILL.md +1 -1
  551. package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
  552. package/src/skills/typeclaw-memory/SKILL.md +3 -3
  553. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  554. package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
  555. package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
  556. package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
  557. package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
  558. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  559. package/src/skills/typeclaw-plugins/SKILL.md +15 -15
  560. package/src/skills/typeclaw-skills/SKILL.md +19 -2
  561. package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
  562. package/typeclaw.schema.json +448 -6
  563. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  564. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
  565. package/src/secrets/claude-credentials-json.ts +0 -129
  566. package/src/secrets/codex-auth-json.ts +0 -102
  567. package/src/secrets/export-claude-credentials-file.ts +0 -270
  568. package/src/secrets/export-codex-auth-file.ts +0 -250
  569. package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
  570. package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
  571. package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
  572. package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
@@ -0,0 +1,95 @@
1
+ import { createHash } from 'node:crypto'
2
+
3
+ import { GITHUB_API_BASE, githubJsonHeaders } from '@/channels/adapters/github/auth-pat'
4
+ import type { ToolResult } from '@/plugin'
5
+
6
+ export type GitAuthCredential = { source: string; token: string }
7
+ export type GitAuthLoginResolver = (token: string) => Promise<string | null>
8
+
9
+ let loginResolverForTests: GitAuthLoginResolver | undefined
10
+
11
+ export function setGitAuthLoginResolverForTests(resolver: GitAuthLoginResolver | undefined): void {
12
+ loginResolverForTests = resolver
13
+ }
14
+
15
+ export function createGitAuthLoginResolver(
16
+ lookup: GitAuthLoginResolver = async (token) => {
17
+ if (loginResolverForTests !== undefined) return await loginResolverForTests(token)
18
+ const response = await fetch(`${GITHUB_API_BASE}/user`, {
19
+ headers: githubJsonHeaders(token),
20
+ signal: AbortSignal.timeout(2_000),
21
+ redirect: 'error',
22
+ })
23
+ if (!response.ok) return null
24
+ const user: unknown = await response.json()
25
+ return user !== null && typeof user === 'object' && 'login' in user && typeof user.login === 'string'
26
+ ? user.login
27
+ : null
28
+ },
29
+ ): GitAuthLoginResolver {
30
+ const cache = new Map<string, Promise<string | null>>()
31
+ return (token) => {
32
+ const key = createHash('sha256').update(token).digest('hex')
33
+ let login = cache.get(key)
34
+ if (login === undefined) {
35
+ // Lookup is advisory: neither network errors nor response bodies may replace
36
+ // the git failure or expose a credential through an exception.
37
+ login = Promise.resolve()
38
+ .then(() => lookup(token))
39
+ .catch(() => null)
40
+ cache.set(key, login)
41
+ }
42
+ return login
43
+ }
44
+ }
45
+
46
+ export async function appendGitAuthDiagnostic(options: {
47
+ result: ToolResult
48
+ credentials: readonly GitAuthCredential[]
49
+ ghCredential?: GitAuthCredential
50
+ push: boolean
51
+ resolveLogin: GitAuthLoginResolver
52
+ }): Promise<void> {
53
+ const { result } = options
54
+ const text = result.content
55
+ .filter((part) => part.type === 'text')
56
+ .map((part) => part.text)
57
+ .join('\n')
58
+ const details = result.details
59
+ const failed =
60
+ (details !== null &&
61
+ typeof details === 'object' &&
62
+ (('error' in details && typeof details.error === 'string') ||
63
+ ('exitCode' in details && typeof details.exitCode === 'number' && details.exitCode !== 0))) ||
64
+ /Command (?:failed|exited) with (?:exit )?code [1-9]\d*/i.test(text)
65
+ if (!failed) return
66
+ // These are git/GitHub protocol errors, not natural-language intent matching.
67
+ if (
68
+ !/\b(?:401|403)\b|Permission to .+ denied to |Authentication failed|Invalid username or password|Resource not accessible/i.test(
69
+ text,
70
+ ) &&
71
+ !(options.push && /Repository not found/i.test(text))
72
+ )
73
+ return
74
+
75
+ const used = await Promise.all(
76
+ options.credentials.map(async (credential) => ({
77
+ source: credential.source,
78
+ login: (await options.resolveLogin(credential.token)) ?? 'unknown',
79
+ })),
80
+ )
81
+ let advice = `[github-cli-auth:gitCredential] Git used ${used.map(({ source, login }) => `${source} (login: ${login})`).join('; ')}.`
82
+ if (options.ghCredential !== undefined) {
83
+ const ghLogin = (await options.resolveLogin(options.ghCredential.token)) ?? 'unknown'
84
+ if (used.some(({ login }) => login !== ghLogin)) {
85
+ advice += ` gh for this repo would use ${options.ghCredential.source} (login: ${ghLogin}).`
86
+ }
87
+ }
88
+ advice +=
89
+ ' Operator: fix or remove the mismatched credential (github in secrets.json for the repo token, GH_TOKEN in the agent .env for the declared PAT), then run typeclaw restart. The host gh login never funds git push.'
90
+ // Do not trust lookup output to be secret-free, even when provided by /user.
91
+ for (const credential of [...options.credentials, ...(options.ghCredential ? [options.ghCredential] : [])]) {
92
+ advice = advice.replaceAll(credential.token, '[redacted]')
93
+ }
94
+ result.content.push({ type: 'text', text: advice })
95
+ }
@@ -0,0 +1,135 @@
1
+ import type { GitCommandDecision, GitResolvers } from './git-command'
2
+
3
+ // Destination grant for `git push` by actors that lack the `gitExfil` bypass:
4
+ // the repos the operator configured for the GitHub channel
5
+ // (`channels.github.repos`) under App auth. The security plugin asks
6
+ // this module whether a push it would otherwise block targets a granted repo;
7
+ // github-cli-auth then re-resolves the same command to fund it and must land on
8
+ // the exact destination the grant authorized, or the push is refused.
9
+ //
10
+ // The grant authorizes publishing branch CONTENT to that repo. It is not a
11
+ // confidentiality control: git objects are not scanned for secrets.
12
+
13
+ export type GithubPushGrant = { repos: readonly string[] }
14
+ // `command` is what actually runs: the model's spelling is discarded so repo
15
+ // config (remote.<name>.push mappings with `+`, push.default=upstream,
16
+ // push.followTags, submodule recursion) and abbreviated tag names cannot widen a
17
+ // one-branch grant. A source that is not refs/heads/<branch> fails to resolve.
18
+ export type GrantedPush = { repoSlug: string; pushUrls: readonly string[]; command: string }
19
+ export type GrantedPushDecision = { kind: 'allow'; push: GrantedPush } | { kind: 'deny'; reason: string }
20
+
21
+ // One local branch name (or HEAD) pushed to the same-named remote branch.
22
+ // Excludes `src:dst` retargeting, `:dst` deletion, `+` force, reflog `@{`,
23
+ // `..` traversal, leading `-`, and tag/full refs.
24
+ const PLAIN_BRANCH = /^(?!-)(?!refs\/)(?!.*\.\.)(?!.*@\{)[A-Za-z0-9._/-]+$/
25
+
26
+ export async function resolveGrantedPush(
27
+ decision: GitCommandDecision,
28
+ grant: GithubPushGrant,
29
+ resolvers: Pick<GitResolvers, 'resolveCurrentBranch'>,
30
+ ): Promise<GrantedPushDecision> {
31
+ const provenance = decision.kind === 'inject' ? decision.pushProvenance : undefined
32
+ const needsHead = provenance?.kind === 'configured-remote' && provenance.refspecs[0] === 'HEAD'
33
+ let currentBranch: string | null = null
34
+ if (needsHead) {
35
+ try {
36
+ currentBranch = await resolvers.resolveCurrentBranch(provenance.sourceCwd)
37
+ } catch {
38
+ currentBranch = null
39
+ }
40
+ }
41
+ return authorizeGrantedPush(decision, grant, currentBranch)
42
+ }
43
+
44
+ export function authorizeGrantedPush(
45
+ decision: GitCommandDecision,
46
+ grant: GithubPushGrant,
47
+ currentBranch: string | null = null,
48
+ ): GrantedPushDecision {
49
+ if (decision.kind !== 'inject' || decision.access !== 'write') {
50
+ return deny('the push could not be resolved to a single GitHub repository')
51
+ }
52
+ const provenance = decision.pushProvenance
53
+ if (provenance?.kind !== 'configured-remote' || !provenance.complete) {
54
+ return deny('only a push through a configured remote of a resolvable checkout can use the grant')
55
+ }
56
+ const [repoSlug, ...extra] = provenance.repoSlugs.map(canonical)
57
+ if (repoSlug === undefined || extra.length > 0) {
58
+ return deny('the remote must point at exactly one GitHub repository')
59
+ }
60
+ if (!grant.repos.map(canonical).includes(repoSlug)) {
61
+ return deny(`\`${repoSlug}\` is not listed in channels.github.repos`)
62
+ }
63
+ const [refspec, ...moreRefspecs] = provenance.refspecs
64
+ if (refspec === undefined || moreRefspecs.length > 0 || !PLAIN_BRANCH.test(refspec)) {
65
+ return deny('the grant covers pushing exactly one branch by name (e.g. `git -C <checkout> push <remote> <branch>`)')
66
+ }
67
+ const branch = refspec === 'HEAD' ? currentBranch : refspec
68
+ if (branch === null || branch === 'HEAD' || !PLAIN_BRANCH.test(branch)) {
69
+ return deny('`HEAD` must be a checked-out branch; name the branch explicitly')
70
+ }
71
+ const command = buildGrantedPushCommand({
72
+ cwd: provenance.sourceCwd,
73
+ remote: provenance.remote,
74
+ branch,
75
+ setUpstream: provenance.setUpstream,
76
+ })
77
+ return { kind: 'allow', push: { repoSlug, pushUrls: provenance.pushUrls, command } }
78
+ }
79
+
80
+ export function buildGrantedPushCommand(options: {
81
+ cwd: string
82
+ remote: string
83
+ branch: string
84
+ setUpstream: boolean
85
+ }): string {
86
+ const ref = `refs/heads/${options.branch}`
87
+ return [
88
+ 'git',
89
+ '-C',
90
+ quote(options.cwd),
91
+ 'push',
92
+ '--no-follow-tags',
93
+ '--recurse-submodules=no',
94
+ ...(options.setUpstream ? ['--set-upstream'] : []),
95
+ quote(options.remote),
96
+ quote(`${ref}:${ref}`),
97
+ ].join(' ')
98
+ }
99
+
100
+ function quote(value: string): string {
101
+ return `'${value.replaceAll("'", "'\\''")}'`
102
+ }
103
+
104
+ const grantedPushes = new Map<string, GrantedPush>()
105
+
106
+ export function recordGrantedPush(callId: string, push: GrantedPush): void {
107
+ grantedPushes.set(callId, push)
108
+ }
109
+
110
+ export function takeGrantedPush(callId: string): GrantedPush | undefined {
111
+ const push = grantedPushes.get(callId)
112
+ grantedPushes.delete(callId)
113
+ return push
114
+ }
115
+
116
+ export function matchesGrantedPush(decision: GitCommandDecision, granted: GrantedPush): boolean {
117
+ if (decision.kind !== 'inject' || decision.access !== 'write') return false
118
+ const provenance = decision.pushProvenance
119
+ if (provenance?.kind !== 'configured-remote') return false
120
+ const slugs = provenance.repoSlugs.map(canonical)
121
+ return (
122
+ slugs.length === 1 &&
123
+ slugs[0] === granted.repoSlug &&
124
+ provenance.pushUrls.length === granted.pushUrls.length &&
125
+ provenance.pushUrls.every((url, index) => url === granted.pushUrls[index])
126
+ )
127
+ }
128
+
129
+ function canonical(slug: string): string {
130
+ return slug.toLocaleLowerCase().replace(/\.git$/i, '')
131
+ }
132
+
133
+ function deny(reason: string): GrantedPushDecision {
134
+ return { kind: 'deny', reason }
135
+ }
@@ -11,26 +11,23 @@ import {
11
11
  guardGithubReviewRoundDismissal,
12
12
  releaseGithubReviewRoundDismissal,
13
13
  } from '@/channels/github-review-verdict-coordinator'
14
+ import type { GithubTokenCredential } from '@/channels/github-token-bridge'
14
15
  import { hasEnvKey, readEnvFile } from '@/init/env-file'
15
16
  import { CORE_PERMISSIONS } from '@/permissions/builtins'
16
- import { definePlugin } from '@/plugin'
17
+ import { definePlugin, type ToolBeforeEvent } from '@/plugin'
17
18
 
18
19
  import { createGithubEffectiveApprovalResolver, createGithubHeadShaResolver } from './effective-approval'
19
20
  import {
20
21
  analyzeGhCommand,
21
22
  canInjectPatIntoPassThroughGh,
22
23
  effectiveGhTokensForAuthenticatedUserEndpoint,
24
+ effectiveGhTokensForCommand,
25
+ hasGhInvocation,
23
26
  usesGhApiGraphqlEndpoint,
24
27
  } from './gh-command'
25
28
  import { detectReviewDismissal } from './gh-review-detect'
26
- import {
27
- cleanupPreparedGithubStorePush,
28
- GH_STORE_AMBIENT_AUTH_KEYS,
29
- planGithubStorePush,
30
- prepareGithubStorePush,
31
- resolveGithubCliStoreToken,
32
- } from './gh-store'
33
29
  import { ensureGitAskPassHelper, resolveSandboxGitAskPassPath } from './git-askpass'
30
+ import { appendGitAuthDiagnostic, createGitAuthLoginResolver, type GitAuthCredential } from './git-auth-diagnostic'
34
31
  import {
35
32
  analyzeGitCommand,
36
33
  createSessionTmpGitResolvers,
@@ -38,8 +35,17 @@ import {
38
35
  resolveGhDefaultRepoFromCwd,
39
36
  } from './git-command'
40
37
  import { buildGitCredentialEnv, type GitRepoCredential } from './git-credential-env'
38
+ import { matchesGrantedPush, takeGrantedPush } from './granted-push'
41
39
  import { checkGraphqlAuthNudge } from './graphql-auth-nudge'
42
- import { commitReviewIfSucceeded, dismissalMutationSucceeded, noteReviewCommand } from './review-recorder'
40
+ import { verifyReviewTokenAccount } from './review-account'
41
+ import {
42
+ capturedReviewAccountIdentity,
43
+ commitReviewIfSucceeded,
44
+ discardReviewCommand,
45
+ dismissalMutationSucceeded,
46
+ noteReviewCommand,
47
+ type NoteReviewResult,
48
+ } from './review-recorder'
43
49
  import { classifyGhToken, shouldMintAppToken } from './token-class'
44
50
 
45
51
  const REPO_LIST_RE = /\bgh\s+repo\s+list\b/
@@ -76,6 +82,16 @@ export default definePlugin({
76
82
  const resolveTokenForRepo = ctx.github.resolveTokenForRepo
77
83
  const hasAppTokenResolver = ctx.github.hasAppTokenResolver
78
84
  const trustedGitTransportEnv: NodeJS.ProcessEnv = { ...process.env }
85
+ const reviewCredentials = new Map<string, GithubTokenCredential>()
86
+ const resolveGitAuthLogin = createGitAuthLoginResolver()
87
+ const gitAuthDiagnostics = new Map<
88
+ string,
89
+ {
90
+ credentials: GitAuthCredential[]
91
+ ghCredential?: GitAuthCredential
92
+ push: boolean
93
+ }
94
+ >()
79
95
 
80
96
  // Every model-driven bash masks the canonical credential files. A role may
81
97
  // still USE a PAT through this runtime-owned overlay, which injects one
@@ -176,21 +192,19 @@ export default definePlugin({
176
192
  // names both remedies instead of guessing one. The closing lines exist because
177
193
  // a mute refusal here is indistinguishable from broken auth, so the caller
178
194
  // retries credential-management commands that are themselves blocked.
195
+ const grantedPushMismatchReason =
196
+ 'This push was allowed for one configured channels.github.repos destination, but the credential broker resolved a different one (the remote may have changed). Re-run the push; if it repeats, check the remote with `git remote -v`.'
179
197
  const missingAppAuthForPushReason =
180
198
  'Pushing to github.com needs an eligible credential and validated destination, and TypeClaw has nothing it can give this git command. ' +
181
199
  'Operator remedy: declare `GH_TOKEN` in the agent `.env` and restart, configure GitHub App auth under ' +
182
- '`channels.github` for per-repo short-lived tokens, or authenticate host `gh` with ' +
183
- '`gh auth login --hostname github.com`; the next real `typeclaw start` or `typeclaw restart` automatically captures ' +
184
- 'that active account into the trusted-runtime store (a start against an already-running container is a no-op). ' +
200
+ '`channels.github` for per-repo short-lived tokens, or (PAT channel auth) list the repo in ' +
201
+ '`channels.github.repos[]` so its PAT can fund the push. ' +
202
+ 'The host `gh` login never funds a push, even when ' +
203
+ '`githubCli.importHostAuth` is enabled. ' +
185
204
  'If App auth is already configured, the adapter failed to start — check ' +
186
205
  '`typeclaw logs`. Do not retry with ' +
187
206
  '`gh auth setup-git`, a credential helper, or a tokenized remote URL: those are blocked and the ' +
188
207
  'credential files are masked in this sandbox.'
189
- const multiPushStoreReason =
190
- 'The trusted GitHub CLI credential store can fund exactly one configured push repository. ' +
191
- 'This remote has multiple GitHub push destinations; use an authoritative declared PAT or GitHub App auth, ' +
192
- 'or configure exactly one push URL.'
193
-
194
208
  let warnedSandboxedPatWithheld = false
195
209
  const warnSandboxedPatWithheldOnce = (): void => {
196
210
  if (warnedSandboxedPatWithheld) return
@@ -226,13 +240,17 @@ export default definePlugin({
226
240
  selfLogin: ctx.github.getAppSelfLogin ?? (() => null),
227
241
  isAppAuth: hasAppTokenResolver,
228
242
  })
243
+ const resolveHeadSha = createGithubHeadShaResolver({ resolveToken })
229
244
  configureReviewVerdictCoordinator({
230
245
  resolveEffectiveApproval,
231
- resolveHeadSha: createGithubHeadShaResolver({ resolveToken }),
246
+ resolveHeadSha,
232
247
  logger: ctx.logger,
233
248
  })
234
249
  const verdictGuard = createSharedReviewVerdictGuard()
235
- const pendingDismissals = new Map<string, { workspace: string; prNumber: number }>()
250
+ const pendingDismissals = new Map<
251
+ string,
252
+ { workspace: string; prNumber: number; commitSha?: string; startedAt: number }
253
+ >()
236
254
 
237
255
  type HookResult = void | { block: true; reason: string }
238
256
 
@@ -278,7 +296,7 @@ export default definePlugin({
278
296
  // 'fall-through' means "not a repo-targeting gh command" so the caller can
279
297
  // try the git path on the same command (e.g. `git ... # gh` substrings).
280
298
  const handleGhCommand = async (params: {
281
- event: { callId: string; args: Record<string, unknown>; origin?: SessionOrigin }
299
+ event: Pick<ToolBeforeEvent, 'callId' | 'args' | 'origin' | 'sessionId'>
282
300
  command: string
283
301
  }): Promise<HookResult | 'fall-through'> => {
284
302
  const { event, command } = params
@@ -327,10 +345,12 @@ export default definePlugin({
327
345
  if (leaseClaimed) await verdictGuard.release({ callId: event.callId, outcome: 'failed' })
328
346
  if (dismissalLeaseClaimed) releaseGithubReviewRoundDismissal(event.callId, false)
329
347
  pendingDismissals.delete(event.callId)
348
+ discardReviewCommand(event.callId)
330
349
  return block
331
350
  }
332
351
  const dismissal = detectReviewDismissal(command)
333
352
  if (dismissal !== null) {
353
+ const startedAt = Date.now()
334
354
  const block = await guardGithubReviewRoundDismissal({
335
355
  callId: event.callId,
336
356
  workspace: dismissal.workspace,
@@ -341,9 +361,21 @@ export default definePlugin({
341
361
  })
342
362
  if (block !== null) return block
343
363
  dismissalLeaseClaimed = event.origin?.kind === 'channel' && event.origin.githubReviewRound !== undefined
344
- pendingDismissals.set(event.callId, dismissal)
364
+ pendingDismissals.set(event.callId, {
365
+ ...dismissal,
366
+ startedAt,
367
+ commitSha:
368
+ event.origin?.kind === 'channel' && event.origin.githubReviewRound !== undefined
369
+ ? event.origin.githubReviewRound.headSha
370
+ : ((await resolveHeadSha(dismissal)) ?? undefined),
371
+ })
372
+ }
373
+ let review: NoteReviewResult
374
+ try {
375
+ review = await noteReviewCommand({ callId: event.callId, command, sessionId: event.sessionId })
376
+ } catch (error) {
377
+ return await blockAfterLease({ block: true, reason: `Cannot capture review coverage: ${String(error)}` })
345
378
  }
346
- const review = await noteReviewCommand({ callId: event.callId, command })
347
379
  if (review.detected !== null) {
348
380
  const block = await verdictGuard.guard({
349
381
  callId: event.callId,
@@ -354,7 +386,7 @@ export default definePlugin({
354
386
  ? { round: event.origin.githubReviewRound, thread: event.origin.thread }
355
387
  : {}),
356
388
  })
357
- if (block !== null) return block
389
+ if (block !== null) return blockAfterLease(block)
358
390
  leaseClaimed = true
359
391
  }
360
392
  if (review.dump !== null) return blockAfterLease(review.dump)
@@ -384,7 +416,10 @@ export default definePlugin({
384
416
  }
385
417
 
386
418
  if (decision.kind === 'pass-through') {
387
- const patOverlay = canUsePat(event.origin) ? processPatOverlay() : undefined
419
+ // The caller routes on a raw `gh` substring, so `git commit -m "...wright..."`
420
+ // lands here. With no real `gh` invocation there is nothing to broker the
421
+ // PAT to: fall through without the overlay instead of blocking.
422
+ const patOverlay = canUsePat(event.origin) && hasGhInvocation(command) ? processPatOverlay() : undefined
388
423
  if (patOverlay !== undefined) {
389
424
  if (!canInjectPatIntoPassThroughGh(command)) {
390
425
  return blockAfterLease({
@@ -471,6 +506,7 @@ export default definePlugin({
471
506
 
472
507
  const result = await resolveTokenForRepo(decision.repoSlug)
473
508
  if (result.kind === 'unavailable') return blockAfterLease({ block: true, reason: result.reason })
509
+ reviewCredentials.set(event.callId, result)
474
510
  // Inject via the internal env overlay (delivered to the spawn / bwrap
475
511
  // --setenv by the bash wrapper) so the token never enters the command
476
512
  // string, where it could leak through logs or later hooks. When the repo
@@ -495,6 +531,10 @@ export default definePlugin({
495
531
  cwd: agentDir,
496
532
  resolvers: createSessionTmpGitResolvers(agentDir, sessionId),
497
533
  })
534
+ const grantedPush = takeGrantedPush(event.callId)
535
+ if (grantedPush !== undefined && (!hasAppTokenResolver() || !matchesGrantedPush(decision, grantedPush))) {
536
+ return { block: true, reason: grantedPushMismatchReason }
537
+ }
498
538
  if (decision.kind === 'pass-through') return
499
539
  if (decision.kind === 'block') return { block: true, reason: decision.reason }
500
540
 
@@ -514,6 +554,20 @@ export default definePlugin({
514
554
  decision.pushProvenance?.kind === 'configured-remote'
515
555
  ? decision.pushProvenance.repoSlugs
516
556
  : [decision.repoSlug.toLocaleLowerCase()]
557
+ const noteGitCredential = (credentials: GitAuthCredential[]): void => {
558
+ // Match handleGhCommand's no-minter precedence. With a minter, gh uses
559
+ // the same per-repo credential as git, so no comparison is needed.
560
+ const ghToken = !hasAppTokenResolver()
561
+ ? (sandboxInheritedGhToken() ?? (canUsePat(event.origin) ? effectiveProcessToken() : undefined))
562
+ : undefined
563
+ gitAuthDiagnostics.set(event.callId, {
564
+ credentials,
565
+ ...(ghToken !== undefined
566
+ ? { ghCredential: { source: `github repo token via ${ghToken.envName}`, token: ghToken.value } }
567
+ : {}),
568
+ push: decision.access === 'write',
569
+ })
570
+ }
517
571
 
518
572
  if (!hasAppTokenResolver()) {
519
573
  const declared = declaredGitCredentialState()
@@ -537,54 +591,42 @@ export default definePlugin({
537
591
  // Withhold wins only when the same ambient names are absent from the overlay.
538
592
  event.args[TYPECLAW_INTERNAL_BASH_WITHHOLD_ENV] = ['GH_TOKEN', 'GITHUB_TOKEN']
539
593
  if (decision.rewrittenCommand !== undefined) event.args.command = decision.rewrittenCommand
594
+ noteGitCredential([{ source: `declared .env ${declared.envName}`, token: declared.value }])
540
595
  return
541
596
  }
542
597
  if (decision.access !== 'write') return
543
- if (declared.kind !== 'absent') return { block: true, reason: missingAppAuthForPushReason }
544
- if (destinationRepos.length !== 1) return { block: true, reason: multiPushStoreReason }
545
-
546
- const askpass = await ensureGitAskPassHelper(resolveSandboxGitAskPassPath())
547
- const plan = await planGithubStorePush(decision, { agentDir, sessionId, askpassPath: askpass })
548
- if (plan === null) return { block: true, reason: missingAppAuthForPushReason }
549
- const storeToken = await resolveGithubCliStoreToken()
550
- if (storeToken === null) return { block: true, reason: missingAppAuthForPushReason }
551
- const credentialEnv = await buildGitCredentialOverlay(
552
- [{ repoSlug: plan.repo, token: storeToken }],
553
- event.args[TYPECLAW_INTERNAL_BASH_ENV],
554
- { expectedRemote: plan.remote, trustedEnv: {} },
555
- )
556
- event.args[TYPECLAW_INTERNAL_BASH_ENV] = credentialEnv
557
- const inheritedNames = [
558
- ...Object.keys(process.env),
559
- ...Object.keys(credentialEnv),
560
- 'SSH_ASKPASS',
561
- 'SSH_AUTH_SOCK',
562
- 'HTTP_PROXY',
563
- 'HTTPS_PROXY',
564
- 'ALL_PROXY',
565
- 'http_proxy',
566
- 'https_proxy',
567
- 'all_proxy',
568
- ]
569
- event.args[TYPECLAW_INTERNAL_BASH_WITHHOLD_ENV] = [
570
- ...new Set([
571
- ...GH_STORE_AMBIENT_AUTH_KEYS,
572
- ...inheritedNames.filter(
573
- (name) => name.startsWith('GIT_') || name.startsWith('SSH_') || /proxy/i.test(name),
574
- ),
575
- ]),
576
- ]
577
- event.args[TYPECLAW_INTERNAL_BASH_PREPARE] = async () => {
578
- const prepared = await prepareGithubStorePush(plan)
579
- if (prepared === null) throw new Error(missingAppAuthForPushReason)
580
- return {
581
- command: prepared.command,
582
- env: prepared.env,
583
- mount: prepared.mount,
584
- cleanup: async () => await cleanupPreparedGithubStorePush(prepared.backingGitDir),
598
+ // PAT-mode channel auth lends its PAT for configured repos (the adapter enforces
599
+ // repos[]). Only an absent `.env` declaration falls through here: an invalid one
600
+ // stays blocked rather than being silently replaced by a different credential.
601
+ if (declared.kind === 'absent' && canUsePat(event.origin) && ctx.github.resolvePatForRepo !== undefined) {
602
+ const credentials: GitRepoCredential[] = []
603
+ for (const repoSlug of destinationRepos) {
604
+ const result = await ctx.github.resolvePatForRepo(repoSlug)
605
+ if (result.kind === 'unavailable') {
606
+ return { block: true, reason: `${missingAppAuthForPushReason} Channel PAT: ${result.reason}` }
607
+ }
608
+ credentials.push({ repoSlug, token: result.token })
585
609
  }
610
+ event.args[TYPECLAW_INTERNAL_BASH_ENV] = await buildGitCredentialOverlay(
611
+ credentials,
612
+ event.args[TYPECLAW_INTERNAL_BASH_ENV],
613
+ {
614
+ expectedRemote:
615
+ decision.pushProvenance?.kind === 'configured-remote' ? decision.pushProvenance.remote : undefined,
616
+ pushUrls:
617
+ decision.pushProvenance?.kind === 'configured-remote' ? decision.pushProvenance.pushUrls : undefined,
618
+ trustedEnv: trustedGitTransportEnv,
619
+ },
620
+ )
621
+ event.args[TYPECLAW_INTERNAL_BASH_WITHHOLD_ENV] = ['GH_TOKEN', 'GITHUB_TOKEN']
622
+ if (decision.rewrittenCommand !== undefined) event.args.command = decision.rewrittenCommand
623
+ noteGitCredential(credentials.map(({ token }) => ({ source: 'GitHub channel PAT', token })))
624
+ return
586
625
  }
587
- return
626
+ // The host `gh` login is the operator's identity, not the agent's, so it never funds
627
+ // a push: anything it signed would land on GitHub as the operator. App auth and an
628
+ // authoritative declared PAT stay the authorized push credentials.
629
+ return { block: true, reason: missingAppAuthForPushReason }
588
630
  }
589
631
  const credentials: GitRepoCredential[] = []
590
632
  for (const repoSlug of destinationRepos) {
@@ -613,7 +655,14 @@ export default definePlugin({
613
655
  trustedEnv: trustedGitTransportEnv,
614
656
  },
615
657
  )
616
- if (decision.rewrittenCommand !== undefined) event.args.command = decision.rewrittenCommand
658
+ if (grantedPush !== undefined) event.args.command = grantedPush.command
659
+ else if (decision.rewrittenCommand !== undefined) event.args.command = decision.rewrittenCommand
660
+ noteGitCredential(
661
+ credentials.map(({ repoSlug, token }) => ({
662
+ source: `per-repo GitHub App token for ${repoSlug}`,
663
+ token,
664
+ })),
665
+ )
617
666
  return
618
667
  }
619
668
 
@@ -626,6 +675,38 @@ export default definePlugin({
626
675
 
627
676
  if (command.includes('gh')) {
628
677
  const ghResult = await handleGhCommand({ event, command })
678
+ const minted = reviewCredentials.get(event.callId)
679
+ reviewCredentials.delete(event.callId)
680
+ const expectedAccountIdentity = capturedReviewAccountIdentity(event.callId)
681
+ const blocked = typeof ghResult === 'object' && ghResult?.block === true
682
+ if (!blocked && expectedAccountIdentity !== undefined) {
683
+ const inherited = sandboxInheritedGhToken()
684
+ const rawOverlay = event.args[TYPECLAW_INTERNAL_BASH_ENV]
685
+ const overlay =
686
+ rawOverlay !== null && typeof rawOverlay === 'object' ? (rawOverlay as Record<string, string>) : {}
687
+ const tokens = effectiveGhTokensForCommand(String(event.args.command), {
688
+ ...(inherited !== undefined ? { [inherited.envName]: inherited.value } : {}),
689
+ ...overlay,
690
+ })
691
+ try {
692
+ if (tokens.length === 0) throw new Error('No authenticated review invocation')
693
+ for (const token of tokens) {
694
+ if (
695
+ !(await verifyReviewTokenAccount({
696
+ token,
697
+ expectedAccountIdentity,
698
+ ...(minted !== undefined ? { minted } : {}),
699
+ }))
700
+ ) {
701
+ throw new Error('original GitHub review account identity changed')
702
+ }
703
+ }
704
+ } catch (error) {
705
+ discardReviewCommand(event.callId)
706
+ await verdictGuard.release({ callId: event.callId, outcome: 'failed' })
707
+ return { block: true, reason: `Cannot authorize review account: ${String(error)}` }
708
+ }
709
+ }
629
710
  if (ghResult !== 'fall-through') return ghResult
630
711
  }
631
712
 
@@ -635,6 +716,11 @@ export default definePlugin({
635
716
  return
636
717
  },
637
718
  'tool.after': async (event) => {
719
+ const gitAuth = gitAuthDiagnostics.get(event.callId)
720
+ gitAuthDiagnostics.delete(event.callId)
721
+ if (event.tool === 'bash' && gitAuth !== undefined) {
722
+ await appendGitAuthDiagnostic({ result: event.result, ...gitAuth, resolveLogin: resolveGitAuthLogin })
723
+ }
638
724
  checkGraphqlAuthNudge({ tool: event.tool, result: event.result })
639
725
  const dismissal = pendingDismissals.get(event.callId)
640
726
  pendingDismissals.delete(event.callId)
@@ -651,10 +737,12 @@ export default definePlugin({
651
737
  if (dismissalMutationSucceeded(event.result)) {
652
738
  const effective = await resolveEffectiveApproval(dismissal)
653
739
  if (effective.ok && effective.effective === 'DISMISSED') {
654
- recordVerifiedDismissal({
740
+ await recordVerifiedDismissal({
655
741
  sessionId: event.sessionId,
656
742
  workspace: dismissal.workspace,
657
743
  prNumber: dismissal.prNumber,
744
+ commitSha: dismissal.commitSha,
745
+ startedAt: dismissal.startedAt,
658
746
  })
659
747
  verified = true
660
748
  }
@@ -663,7 +751,7 @@ export default definePlugin({
663
751
  releaseGithubReviewRoundDismissal(event.callId, verified)
664
752
  }
665
753
  }
666
- const review = commitReviewIfSucceeded({
754
+ const review = await commitReviewIfSucceeded({
667
755
  sessionId: event.sessionId,
668
756
  callId: event.callId,
669
757
  result: event.result,
@@ -0,0 +1,23 @@
1
+ import { GITHUB_API_BASE, githubJsonHeaders } from '@/channels/adapters/github/auth-pat'
2
+ import type { GithubTokenCredential } from '@/channels/github-token-bridge'
3
+
4
+ export type ReviewAccountFetch = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>
5
+ export async function verifyReviewTokenAccount(options: {
6
+ token: string | undefined
7
+ expectedAccountIdentity: string
8
+ minted?: GithubTokenCredential
9
+ fetchImpl?: ReviewAccountFetch
10
+ }): Promise<boolean> {
11
+ if (!options.token) return false
12
+ if (options.minted?.token === options.token && options.minted.accountIdentity !== undefined) {
13
+ return options.minted.accountIdentity === options.expectedAccountIdentity
14
+ }
15
+ if (options.token.startsWith('ghs_')) return false
16
+ const response = await (options.fetchImpl ?? fetch)(`${GITHUB_API_BASE}/user`, {
17
+ headers: githubJsonHeaders(options.token),
18
+ signal: AbortSignal.timeout(10_000),
19
+ })
20
+ if (!response.ok) return false
21
+ const user = (await response.json()) as { id?: unknown }
22
+ return Number.isSafeInteger(user.id) && Number(user.id) > 0 && `github:${user.id}` === options.expectedAccountIdentity
23
+ }