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
@@ -1,4 +1,6 @@
1
1
  import { lstatSync } from 'node:fs'
2
+ import { mkdtemp, rm } from 'node:fs/promises'
3
+ import { tmpdir } from 'node:os'
2
4
  import { join } from 'node:path'
3
5
 
4
6
  import { hooklessGitArgs } from '@/git/hookless'
@@ -100,79 +102,148 @@ export async function runBackup(options: BackupRunnerOptions, deps: BackupRunner
100
102
  timeoutMs: COMMIT_TIMEOUT_MS,
101
103
  })
102
104
  if (status.exitCode !== 0) return { ok: false, kind: 'aborted', reason: `git status failed: ${shortErr(status)}` }
103
- const snapshot = selectStagingSnapshot(parsePorcelain(status.stdout), cwd)
104
- if (snapshot.paths.length === 0 && snapshot.forcePaths.length === 0) return { ok: true, kind: 'clean' }
105
-
106
- if (snapshot.paths.length > 0) {
107
- const add = await deps.gitSpawn([...repo.gitArgs, 'add', '--', ...snapshot.paths], {
105
+ const entries = parsePorcelain(status.stdout)
106
+ // Only index-known, absent worktree paths that were NEVER in HEAD are
107
+ // stale additions (including removed intent-to-add entries). A tracked
108
+ // deletion still in HEAD is backup work; memory/ belongs to another writer.
109
+ const missing = uniquePaths(
110
+ entries
111
+ .filter((entry) => entry.kind === 'tracked' && (entry.status[0] === 'A' || entry.status[1] === 'D'))
112
+ .flatMap((entry) => entry.paths)
113
+ .filter((path) => !isAgentOwned(path) && !hasDirectoryEntry(join(cwd, path))),
114
+ )
115
+ const head =
116
+ missing.length > 0
117
+ ? await deps.gitSpawn([...repo.gitArgs, 'ls-tree', '-r', '--name-only', '-z', 'HEAD', '--', ...missing], {
118
+ cwd,
119
+ timeoutMs: COMMIT_TIMEOUT_MS,
120
+ })
121
+ : { exitCode: 0, stdout: '', stderr: '', timedOut: false }
122
+ if (head.exitCode !== 0) {
123
+ const exists = await deps.gitSpawn([...repo.gitArgs, 'rev-parse', '--verify', 'HEAD'], {
108
124
  cwd,
109
125
  timeoutMs: COMMIT_TIMEOUT_MS,
110
126
  })
111
- if (add.exitCode !== 0) {
112
- const retry = await retryAfterVanishedUntracked(cwd, deps, repo, snapshot)
113
- if (!retry || retry.exitCode !== 0) {
114
- return { ok: false, kind: 'commit-failed', reason: `git add failed: ${shortErr(retry ?? add)}` }
115
- }
116
- }
127
+ if (exists.exitCode === 0)
128
+ return { ok: false, kind: 'commit-failed', reason: `git ls-tree failed: ${shortErr(head)}` }
117
129
  }
118
- if (snapshot.forcePaths.length > 0) {
119
- const addF = await deps.gitSpawn([...repo.gitArgs, 'add', '-f', '--', ...snapshot.forcePaths], {
130
+ const headPaths = new Set(head.stdout.split('\0'))
131
+ const missingAdds = missing.filter((path) => !headPaths.has(path))
132
+ if (missingAdds.length > 0) {
133
+ const removed = await deps.gitSpawn([...repo.gitArgs, 'add', '-u', '--', ...missingAdds], {
120
134
  cwd,
121
135
  timeoutMs: COMMIT_TIMEOUT_MS,
122
136
  })
123
- if (addF.exitCode !== 0) {
124
- return { ok: false, kind: 'commit-failed', reason: `git add -f failed: ${shortErr(addF)}` }
125
- }
137
+ if (removed.exitCode !== 0)
138
+ return { ok: false, kind: 'commit-failed', reason: `git add -u failed: ${shortErr(removed)}` }
126
139
  }
127
-
128
- const stagedCheck = await deps.gitSpawn([...repo.gitArgs, 'diff', '--cached', '--quiet'], {
140
+ const removedPaths = new Set(missingAdds)
141
+ const snapshot = selectStagingSnapshot(
142
+ entries.filter((entry) => !entry.paths.every((path) => removedPaths.has(path))),
129
143
  cwd,
130
- timeoutMs: COMMIT_TIMEOUT_MS,
131
- })
132
- if (stagedCheck.exitCode === 0) return { ok: true, kind: 'clean' }
144
+ )
145
+ if (snapshot.paths.length === 0 && snapshot.forcePaths.length === 0) return { ok: true, kind: 'clean' }
133
146
 
134
- const diffstat = await deps.gitSpawn([...repo.gitArgs, 'diff', '--cached', '--stat'], {
135
- cwd,
136
- timeoutMs: COMMIT_TIMEOUT_MS,
137
- })
138
- const message = await deps.pickCommitMessage({
139
- status: status.stdout.replaceAll('\0', '\n').slice(0, 4096),
140
- diffstat: diffstat.stdout.slice(0, 4096),
141
- })
147
+ // Keep the staged snapshot out of the shared index while the message subagent
148
+ // runs. Other writers may commit the entire shared index during that window.
149
+ const indexDir = await mkdtemp(join(tmpdir(), 'typeclaw-backup-index-'))
150
+ const indexEnv = { GIT_INDEX_FILE: join(indexDir, 'index') }
151
+ const privateGit = (args: string[]) =>
152
+ deps.gitSpawn([...repo.gitArgs, ...args], { cwd, timeoutMs: COMMIT_TIMEOUT_MS, env: indexEnv })
153
+ const readHead = async (): Promise<GitSpawnResult> => {
154
+ const result = await privateGit(['read-tree', 'HEAD'])
155
+ if (result.exitCode === 0) return result
156
+ const head = await privateGit(['rev-parse', '--verify', 'HEAD'])
157
+ return head.exitCode === 0 ? result : privateGit(['read-tree', '--empty'])
158
+ }
159
+ const stageSnapshot = async (paths: string[], forcePaths: string[]): Promise<GitSpawnResult | undefined> => {
160
+ if (paths.length > 0) {
161
+ const add = await privateGit(['add', '-f', '--', ...paths])
162
+ if (add.exitCode !== 0) {
163
+ const retry = await retryAfterVanishedUntracked(cwd, deps, repo, snapshot, indexEnv, true)
164
+ if (!retry || retry.exitCode !== 0) return retry ?? add
165
+ }
166
+ }
167
+ if (forcePaths.length > 0) {
168
+ const add = await privateGit(['add', '-f', '--', ...forcePaths])
169
+ if (add.exitCode !== 0) return add
170
+ }
171
+ return undefined
172
+ }
173
+ try {
174
+ const init = await readHead()
175
+ if (init.exitCode !== 0)
176
+ return { ok: false, kind: 'commit-failed', reason: `git read-tree failed: ${shortErr(init)}` }
177
+ const staged = await stageSnapshot(snapshot.paths, snapshot.forcePaths)
178
+ if (staged) return { ok: false, kind: 'commit-failed', reason: `git add failed: ${shortErr(staged)}` }
179
+
180
+ const stagedCheck = await privateGit(['diff', '--cached', '--quiet'])
181
+ if (stagedCheck.exitCode === 0) return { ok: true, kind: 'clean' }
182
+ if (stagedCheck.exitCode !== 1)
183
+ return { ok: false, kind: 'commit-failed', reason: `git diff failed: ${shortErr(stagedCheck)}` }
184
+
185
+ const diffstat = await privateGit(['diff', '--cached', '--stat'])
186
+ const message = await deps.pickCommitMessage({
187
+ status: status.stdout.replaceAll('\0', '\n').slice(0, 4096),
188
+ diffstat: diffstat.stdout.slice(0, 4096),
189
+ })
142
190
 
143
- // `pickCommitMessage` may spawn a subagent (the backup plugin's
144
- // `backup-message`) whose session JSONL lands under `sessions/` after we
145
- // already staged. Without this second pass that file would sit dirty in
146
- // the worktree until the NEXT backup cycle, which would then commit it
147
- // and create another orphan via the same path — a steady-state of
148
- // one-cycle-behind churn. Re-status, filter to `sessions/` additions
149
- // only (don't accidentally stage user work that arrived during the
150
- // window), and force-add anything new.
151
- const reStatus = await deps.gitSpawn([...repo.gitArgs, 'status', '--porcelain=v1', '-z', '--untracked-files=all'], {
152
- cwd,
153
- timeoutMs: COMMIT_TIMEOUT_MS,
154
- })
155
- if (reStatus.exitCode === 0) {
156
- const lateForce = selectForcePaths(parsePorcelain(reStatus.stdout), cwd, ['sessions/'])
157
- if (lateForce.length > 0) {
158
- const lateAdd = await deps.gitSpawn([...repo.gitArgs, 'add', '-f', '--', ...lateForce], {
191
+ // The message subagent may create a sessions/ path after the first snapshot.
192
+ // Re-read only for those paths; other new work must wait for the next pass.
193
+ const reStatus = await deps.gitSpawn([...repo.gitArgs, 'status', '--porcelain=v1', '-z', '--untracked-files=all'], {
194
+ cwd,
195
+ timeoutMs: COMMIT_TIMEOUT_MS,
196
+ })
197
+ const lateEntries = reStatus.exitCode === 0 ? parsePorcelain(reStatus.stdout) : []
198
+ const lateForce = selectForcePaths(lateEntries, cwd, ['sessions/'])
199
+ const selected = uniquePaths([...snapshot.paths, ...snapshot.forcePaths, ...lateForce]).filter(
200
+ (path) => !snapshot.untrackedPaths.has(path) || hasDirectoryEntry(join(cwd, path)),
201
+ )
202
+ const selectedSet = new Set(selected)
203
+ // Porcelain still reports tracked deletions not yet committed by another
204
+ // writer; absent paths no longer reported after the message window were
205
+ // already committed and cannot be passed to git commit --only.
206
+ const reported = new Set((reStatus.exitCode === 0 ? lateEntries : entries).flatMap((entry) => entry.paths))
207
+ const paths = selected.filter((path) => hasDirectoryEntry(join(cwd, path)) || reported.has(path))
208
+ if (paths.length === 0) return { ok: true, kind: 'clean' }
209
+
210
+ // --only constructs Git's own temporary index from the current HEAD and
211
+ // refreshes the real index for just these paths. Only previously untracked
212
+ // paths need intent-to-add entries in the real index for pathspec matching.
213
+ const candidates = uniquePaths(
214
+ [...entries, ...lateEntries]
215
+ .filter((entry) => entry.kind === 'untracked')
216
+ .flatMap((entry) => entry.paths)
217
+ .filter((path) => selectedSet.has(path) && hasDirectoryEntry(join(cwd, path))),
218
+ )
219
+ if (candidates.length > 0) {
220
+ const intent = await deps.gitSpawn([...repo.gitArgs, 'add', '-N', '-f', '--', ...candidates], {
159
221
  cwd,
160
222
  timeoutMs: COMMIT_TIMEOUT_MS,
161
223
  })
162
- if (lateAdd.exitCode !== 0) {
163
- return { ok: false, kind: 'commit-failed', reason: `git add -f (post-message) failed: ${shortErr(lateAdd)}` }
164
- }
224
+ if (intent.exitCode !== 0)
225
+ return { ok: false, kind: 'commit-failed', reason: `git add -N failed: ${shortErr(intent)}` }
226
+ }
227
+ const commit = await deps.gitSpawn(
228
+ [...repo.gitArgs, 'commit', '--only', '-m', sanitizeCommitMessage(message), '--', ...paths],
229
+ {
230
+ cwd,
231
+ timeoutMs: COMMIT_TIMEOUT_MS,
232
+ },
233
+ )
234
+ if (commit.exitCode !== 0) {
235
+ // A concurrent whole-index commit may have consumed the selected paths.
236
+ const pending = await deps.gitSpawn([...repo.gitArgs, 'status', '--porcelain=v1', '-z', '--', ...paths], {
237
+ cwd,
238
+ timeoutMs: COMMIT_TIMEOUT_MS,
239
+ })
240
+ if (pending.exitCode === 0 && pending.stdout === '') return { ok: true, kind: 'clean' }
241
+ return { ok: false, kind: 'commit-failed', reason: `git commit failed: ${shortErr(commit)}` }
165
242
  }
243
+ } finally {
244
+ await rm(indexDir, { recursive: true, force: true })
166
245
  }
167
246
 
168
- const safeMessage = sanitizeCommitMessage(message)
169
- const commit = await deps.gitSpawn([...repo.gitArgs, 'commit', '-m', safeMessage], {
170
- cwd,
171
- timeoutMs: COMMIT_TIMEOUT_MS,
172
- })
173
- if (commit.exitCode !== 0)
174
- return { ok: false, kind: 'commit-failed', reason: `git commit failed: ${shortErr(commit)}` }
175
-
176
247
  if (!pushToOrigin) return { ok: true, kind: 'committed' }
177
248
 
178
249
  const plan = await resolvePushPlan(cwd, deps, repo)
@@ -422,7 +493,7 @@ function selectStagingSnapshot(entries: readonly PorcelainEntry[], cwd: string):
422
493
  if (isAgentOwned(path)) continue
423
494
  const forceAdded = FORCE_ADD_PREFIXES.some((prefix) => path.startsWith(prefix))
424
495
  if (entry.kind === 'untracked') {
425
- if (forceAdded || !hasDirectoryEntry(join(cwd, path))) continue
496
+ if (forceAdded || !hasDirectoryEntry(join(cwd, path)) || isNestedRepository(join(cwd, path))) continue
426
497
  untrackedPaths.add(path)
427
498
  }
428
499
  paths.push(path)
@@ -436,6 +507,8 @@ async function retryAfterVanishedUntracked(
436
507
  deps: BackupRunnerDeps,
437
508
  repo: AgentGit,
438
509
  snapshot: StagingSnapshot,
510
+ env?: Record<string, string>,
511
+ force = false,
439
512
  ): Promise<GitSpawnResult | undefined> {
440
513
  const reread = await deps.gitSpawn([...repo.gitArgs, 'status', '--porcelain=v1', '-z', '--untracked-files=all'], {
441
514
  cwd,
@@ -455,7 +528,11 @@ async function retryAfterVanishedUntracked(
455
528
 
456
529
  const retryPaths = snapshot.paths.filter((path) => !vanished.has(path))
457
530
  if (retryPaths.length === 0) return { exitCode: 0, stdout: '', stderr: '', timedOut: false }
458
- return deps.gitSpawn([...repo.gitArgs, 'add', '--', ...retryPaths], { cwd, timeoutMs: COMMIT_TIMEOUT_MS })
531
+ return deps.gitSpawn([...repo.gitArgs, 'add', ...(force ? ['-f'] : []), '--', ...retryPaths], {
532
+ cwd,
533
+ timeoutMs: COMMIT_TIMEOUT_MS,
534
+ env,
535
+ })
459
536
  }
460
537
 
461
538
  function selectForcePaths(
@@ -476,6 +553,11 @@ function hasDirectoryEntry(path: string): boolean {
476
553
  return lstatSync(path, { throwIfNoEntry: false }) !== undefined
477
554
  }
478
555
 
556
+ function isNestedRepository(path: string): boolean {
557
+ if (!lstatSync(path, { throwIfNoEntry: false })?.isDirectory()) return false
558
+ return hasDirectoryEntry(join(path, '.git'))
559
+ }
560
+
479
561
  function uniquePaths(paths: readonly string[]): string[] {
480
562
  return [...new Set(paths)]
481
563
  }
@@ -1,9 +1,9 @@
1
- import { mkdir, readFile, rm, writeFile } from 'node:fs/promises'
1
+ import { appendFile, mkdir, readFile, rm, writeFile } from 'node:fs/promises'
2
2
  import { join } from 'node:path'
3
3
 
4
4
  import { z } from 'zod'
5
5
 
6
- import { bashTool, readTool, type Subagent, writeTool } from '@/plugin'
6
+ import { bashTool, readTool, type Subagent } from '@/plugin'
7
7
 
8
8
  const messagePayloadSchema = z.object({
9
9
  agentDir: z.string(),
@@ -33,9 +33,8 @@ A periodic backup is about to commit dirty files in the agent folder. Your only
33
33
  The user message gives you:
34
34
  - The output of \`git status --porcelain=v1 --untracked-files=all\` (truncated)
35
35
  - The output of \`git diff --cached --stat\` (truncated)
36
- - An absolute file path you must write the commit message to
37
36
 
38
- # What to write
37
+ # What to return
39
38
 
40
39
  A single commit message in conventional-commit-ish style:
41
40
  - Subject line under 72 characters, imperative mood, lowercase first word, no trailing period.
@@ -49,11 +48,9 @@ Examples:
49
48
 
50
49
  # Hard rules
51
50
 
52
- 1. **Write exactly one file.** Use the \`write\` tool with the absolute path the user gave you. Do not write anywhere else. Do not read other files. Do not run commands.
53
- 2. **Output is the file contents only.** No prose to the user, no explanation, no apologies. The runner ignores everything except the file you wrote.
54
- 3. **Be honest about uncertainty.** If the diff looks like a mix of unrelated changes, write \`chore: backup\` rather than guessing a misleading subject.
55
- 4. **Never include secrets, API keys, or paths that would identify the user's machine.** Stick to repo-relative descriptions.
56
- 5. **Stop when the file is written.** Do not continue after the \`write\` succeeds.`
51
+ 1. **Return only the commit message as your final answer.** No prose, explanation, or apologies. Do not write files, read other files, or run commands.
52
+ 2. **Be honest about uncertainty.** If the diff looks like a mix of unrelated changes, return \`chore: backup\` rather than guessing a misleading subject.
53
+ 3. **Never include secrets, API keys, or paths that would identify the user's machine.** Stick to repo-relative descriptions.`
57
54
 
58
55
  export const DIAGNOSE_FAILURE_SYSTEM_PROMPT = `You are typeclaw's backup failure-diagnosis subagent.
59
56
 
@@ -68,7 +65,7 @@ The user message gives you:
68
65
 
69
66
  # Tools
70
67
 
71
- You have \`bash\`, \`read\`, and \`write\`. Use \`bash\` to inspect git state (\`git status\`, \`git remote -v\`, \`git log -5 --oneline\`, \`git config --get remote.origin.url\`).
68
+ You have \`bash\` and \`read\`. Use \`bash\` to inspect git state (\`git status\`, \`git remote -v\`, \`git log -5 --oneline\`, \`git config --get remote.origin.url\`).
72
69
 
73
70
  # Allowed actions
74
71
 
@@ -77,7 +74,7 @@ You MAY:
77
74
  - Set up a missing upstream branch via \`git push -u origin <branch>\` if it's clear that's the only issue.
78
75
  - Retry \`git push\` once after fixing a clear, narrow issue.
79
76
 
80
- **When you run \`git push\` (either to set upstream or to retry), do not add an acknowledgement argument.** Security guards are permission-only; this recovery subagent inherits the operator role that launched the approved backup workflow. If your push retry fails again, write the diagnosis and stop.
77
+ **When you run \`git push\` (either to set upstream or to retry), do not add an acknowledgement argument.** Security guards are permission-only; this recovery subagent inherits the operator role that launched the approved backup workflow. If your push retry fails again, return the diagnosis and stop.
81
78
 
82
79
  You MUST NOT:
83
80
  - Force-push (\`--force\`, \`--force-with-lease\`).
@@ -87,16 +84,16 @@ You MUST NOT:
87
84
 
88
85
  # Output
89
86
 
90
- Write a brief diagnosis (3-8 lines) describing:
87
+ Return a brief diagnosis (3-8 lines) describing:
91
88
  1. What the actual cause was (e.g. "no upstream tracking branch", "remote is ahead and rebase conflicted", "auth failed").
92
89
  2. What you did about it (or why you didn't).
93
90
  3. What the user should do next, if anything.
94
91
 
95
- Append your diagnosis to \`<agentDir>/sessions/backup-diagnostics.log\` with a timestamp prefix. Keep it short — this log is for the human, not the model.
92
+ Return only the diagnosis as your final answer. The backup runtime appends it with a timestamp to \`<agentDir>/sessions/backup-diagnostics.log\`; do not write that file yourself. Keep it short — this log is for the human, not the model.
96
93
 
97
94
  # When in doubt
98
95
 
99
- Do nothing destructive. Write the diagnosis and stop. The user can recover manually.`
96
+ Do nothing destructive. Return the diagnosis and stop. The user can recover manually.`
100
97
 
101
98
  export type CreateCommitMessageSubagentOptions = {
102
99
  fallbackMessage?: string
@@ -108,16 +105,24 @@ export function createCommitMessageSubagent(
108
105
  const fallback = options.fallbackMessage ?? 'chore: backup'
109
106
  return {
110
107
  systemPrompt: COMMIT_MESSAGE_SYSTEM_PROMPT,
111
- tools: [writeTool],
108
+ tools: [],
112
109
  payloadSchema: messagePayloadSchema,
113
110
  inFlightKey: (payload) => payload.agentDir,
114
111
  handler: async (ctx, runSession) => {
115
- const userPrompt = buildCommitMessagePrompt(ctx.payload)
112
+ let message = ''
116
113
  try {
117
- await runSession({ userPrompt })
114
+ await runSession({
115
+ userPrompt: buildCommitMessagePrompt(ctx.payload),
116
+ onFinalMessage: (text) => {
117
+ message = text ?? ''
118
+ },
119
+ })
118
120
  } catch {
119
- await writeFile(ctx.payload.outputPath, fallback, 'utf8').catch(() => undefined)
121
+ message = ''
120
122
  }
123
+ await writeFile(ctx.payload.outputPath, normalizeCommitMessageResponse(message) || fallback, 'utf8').catch(
124
+ () => undefined,
125
+ )
121
126
  },
122
127
  }
123
128
  }
@@ -125,24 +130,51 @@ export function createCommitMessageSubagent(
125
130
  export function createDiagnoseFailureSubagent(): Subagent<DiagnoseFailurePayload> {
126
131
  return {
127
132
  systemPrompt: DIAGNOSE_FAILURE_SYSTEM_PROMPT,
128
- tools: [bashTool, readTool, writeTool],
133
+ tools: [bashTool, readTool],
129
134
  payloadSchema: diagnosePayloadSchema,
130
135
  inFlightKey: (payload) => payload.agentDir,
131
136
  handler: async (ctx, runSession) => {
132
- const userPrompt = buildDiagnosePrompt(ctx.payload)
137
+ let diagnosis = ''
133
138
  try {
134
- await runSession({ userPrompt })
139
+ await runSession({
140
+ userPrompt: buildDiagnosePrompt(ctx.payload),
141
+ onFinalMessage: (text) => {
142
+ diagnosis = text ?? ''
143
+ },
144
+ })
135
145
  } catch {
136
- // Diagnosis is advisory; failures here must not propagate.
146
+ return
147
+ }
148
+ if (diagnosis.trim()) {
149
+ await appendFile(
150
+ join(ctx.payload.agentDir, 'sessions', 'backup-diagnostics.log'),
151
+ `${new Date().toISOString()} ${diagnosis.trim()}\n`,
152
+ 'utf8',
153
+ ).catch(() => undefined)
137
154
  }
138
155
  },
139
156
  }
140
157
  }
141
158
 
159
+ // The runner already bounds subject length and preserves an optional body.
160
+ // Remove model presentation wrappers here so neither a fence label nor quotes
161
+ // can become the Git subject line.
162
+ function normalizeCommitMessageResponse(raw: string): string {
163
+ const trimmed = raw.trim()
164
+ const fenced = trimmed.match(/^```[^\n]*\n([\s\S]*?)\n```$/)
165
+ const content = (fenced?.[1] ?? trimmed).trim()
166
+ const pair =
167
+ content.startsWith('"') && content.endsWith('"')
168
+ ? '"'
169
+ : content.startsWith("'") && content.endsWith("'")
170
+ ? "'"
171
+ : null
172
+ return (pair && content.length >= 2 ? content.slice(1, -1) : content).trim()
173
+ }
174
+
142
175
  function buildCommitMessagePrompt(p: CommitMessagePayload): string {
143
176
  return [
144
- `Agent folder: ${p.agentDir}`,
145
- `Write the commit message to: ${p.outputPath}`,
177
+ 'Choose a commit message for these changes:',
146
178
  '',
147
179
  '## git status --porcelain=v1 --untracked-files=all',
148
180
  '```',
@@ -154,7 +186,7 @@ function buildCommitMessagePrompt(p: CommitMessagePayload): string {
154
186
  p.diffstat.trim() || '(empty)',
155
187
  '```',
156
188
  '',
157
- 'Write the commit message and stop.',
189
+ 'Return the commit message and stop.',
158
190
  ].join('\n')
159
191
  }
160
192
 
@@ -174,7 +206,7 @@ function buildDiagnosePrompt(p: DiagnoseFailurePayload): string {
174
206
  p.stdout.trim() || '(empty)',
175
207
  '```',
176
208
  '',
177
- 'Inspect the repo, do the smallest safe action if any, and write your diagnosis to the log file.',
209
+ 'Inspect the repo, do the smallest safe action if any, and return your diagnosis.',
178
210
  ].join('\n')
179
211
  }
180
212
 
@@ -0,0 +1,89 @@
1
+ import { join } from 'node:path'
2
+
3
+ import { z } from 'zod'
4
+
5
+ import type { BrowserEngineId, BrowserExtensionId } from '@/browser/registry'
6
+ import { bashTool, findTool, grepTool, lsTool, readTool, type Subagent, writeTool } from '@/plugin'
7
+
8
+ const BUNDLED_PLUGINS_DIR = join(import.meta.dir, '..')
9
+
10
+ export type BrowserDriverId = BrowserEngineId | BrowserExtensionId
11
+
12
+ export type BrowserDrivers = {
13
+ engines: readonly BrowserEngineId[]
14
+ extensions: readonly BrowserExtensionId[]
15
+ }
16
+
17
+ // Mirrors where agent-browser and managed-browser ship each driver's skill.
18
+ export function driverSkillPath(id: BrowserDriverId): string {
19
+ return id === 'agent-browser'
20
+ ? join(BUNDLED_PLUGINS_DIR, 'agent-browser', 'skills', 'agent-browser', 'SKILL.md')
21
+ : join(BUNDLED_PLUGINS_DIR, 'managed-browser', 'skills', id, id, 'SKILL.md')
22
+ }
23
+
24
+ export function buildBrowserSystemPrompt({ engines, extensions }: BrowserDrivers): string {
25
+ const skills = [...engines, ...extensions].map((id) => `- \`${id}\` — ${driverSkillPath(id)}`).join('\n')
26
+ return `You are a web-browsing subagent running inside TypeClaw. Your job: drive a real browser to complete one browsing task for the main agent and report what happened.
27
+
28
+ ## Your context
29
+
30
+ - The main agent delegates ALL web browsing to you so the page snapshots and screenshots stay out of its context.
31
+ - You do not talk to the user; the main agent does. Your final message is the whole report.
32
+ - You cannot spawn subagents.
33
+
34
+ ## How to browse
35
+
36
+ Before your first browser command, read the skill for the driver you will use. Enabled drivers (prefer the first unless the task says otherwise):
37
+
38
+ ${skills}
39
+
40
+ Drive the browser with \`bash\`. Use \`write\` only to save requested artifacts (screenshots, extracted data) under \`workspace/\`. Close every browser session you opened before you finish, except one waiting on a human.
41
+
42
+ If a step needs a human (login, 2FA, CAPTCHA, payment confirmation), follow the skill's human-handoff instructions (e.g. start the dashboard), leave that session open, and stop. Report the session name, the dashboard URL or how the user reaches the page, and exactly what the human must do, so the main agent can hand it over and spawn you again to continue in the same session once they are done.
43
+
44
+ ## Final report
45
+
46
+ 1. **Outcome** — succeeded / partially succeeded / failed, in one sentence.
47
+ 2. **Result** — the information or confirmation the task asked for, with the URLs it came from.
48
+ 3. **Artifacts** — absolute paths of anything you saved.
49
+ 4. **Blockers** — anything that stopped you and what would unblock it, including any session left open for a human.`
50
+ }
51
+
52
+ // `profile` is dropped, not passed through: the browsing tier is fixed (see
53
+ // createBrowserSubagent), so a parent must not move it via a per-spawn `profile`.
54
+ export const browserPayloadSchema = z
55
+ .object({
56
+ requestId: z.string().optional(),
57
+ prompt: z.string().optional(),
58
+ description: z.string().optional(),
59
+ })
60
+ .passthrough()
61
+ .transform(({ profile: _profile, ...rest }) => rest)
62
+
63
+ export type BrowserPayload = z.infer<typeof browserPayloadSchema>
64
+
65
+ // Browser flows (multi-page navigation, form fills) outlast a scout lookup;
66
+ // bound a wedged run so it never blocks the parent forever.
67
+ export const BROWSER_TIMEOUT_MS = 900_000
68
+
69
+ export function createBrowserSubagent(drivers: BrowserDrivers): Subagent<BrowserPayload> {
70
+ return {
71
+ systemPrompt: buildBrowserSystemPrompt(drivers),
72
+ // The deep model at low effort, like omo's deep-low browser lane: strong
73
+ // agentic UI handling without deliberating before every click. Without a
74
+ // configured `deep` profile this resolves to plain `default` (its own level).
75
+ profile: 'deep',
76
+ thinkingLevel: 'low',
77
+ timeoutMs: BROWSER_TIMEOUT_MS,
78
+ tools: [readTool, grepTool, findTool, lsTool, bashTool, writeTool],
79
+ payloadSchema: browserPayloadSchema,
80
+ visibility: 'public',
81
+ rosterDescription:
82
+ 'ALL web browsing — navigate, click, fill forms, log in, screenshot, scrape JS-rendered pages; deep model at low thinking (default profile if no deep); never drive a browser yourself',
83
+ inFlightKey: (payload) => payload?.requestId ?? `anon-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
84
+ toolResultBudget: {
85
+ maxTotalBytes: 1_000_000,
86
+ toolNames: ['read', 'grep', 'find', 'ls', 'bash', 'write'],
87
+ },
88
+ }
89
+ }
@@ -0,0 +1,12 @@
1
+ import { getConfig } from '@/config'
2
+ import { definePlugin } from '@/plugin'
3
+
4
+ import { createBrowserSubagent } from './browser-agent'
5
+
6
+ export default definePlugin({
7
+ plugin: async () => ({
8
+ subagents: {
9
+ browser: createBrowserSubagent(getConfig().browser),
10
+ },
11
+ }),
12
+ })
@@ -9,20 +9,10 @@ import { definePlugin } from '@/plugin'
9
9
  // path — keep them in lockstep.
10
10
  export const RENDER_SCRIPT_AGENT_RELATIVE_PATH = 'node_modules/typeclaw/src/bundled-plugins/doc-render/render.ts'
11
11
 
12
- // In-container path of the bundled themed report library, relative to the agent
13
- // root. The skill tells the agent to copy this next to its markdown and
14
- // `#import "lib.typ"`, because Typst's workspace sandbox only resolves imports
15
- // under the render's working directory. Keep in lockstep with the skill.
16
- export const TEMPLATE_LIB_AGENT_RELATIVE_PATH = 'node_modules/typeclaw/src/bundled-plugins/doc-render/templates/lib.typ'
17
-
18
12
  export function renderScriptPath(): string {
19
13
  return join(import.meta.dir, 'render.ts')
20
14
  }
21
15
 
22
- export function templateLibPath(): string {
23
- return join(import.meta.dir, 'templates', 'lib.typ')
24
- }
25
-
26
16
  export default definePlugin({
27
17
  plugin: async () => ({
28
18
  skillsDirs: [join(import.meta.dir, 'skills')],