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,355 @@
1
+ import { spawn } from 'node:child_process'
2
+ import { once } from 'node:events'
3
+ import { constants } from 'node:fs'
4
+ import { lstat, mkdir, open, realpath, rename, rm } from 'node:fs/promises'
5
+ import { dirname, join, resolve } from 'node:path'
6
+
7
+ import { createAndOpenAnchoredDirectory, writeFileAnchored } from '@/agent/tool-file-safety'
8
+ import {
9
+ codingSourceMaskDirs,
10
+ CODING_MASK_FILES,
11
+ CODING_SOURCE,
12
+ assertCodingDirectory,
13
+ prepareCodingCommand,
14
+ } from '@/sandbox/coding-agent'
15
+ import { DEFAULT_SANDBOX_ENV } from '@/sandbox/policy'
16
+
17
+ export type CodingExecutor = (argv: readonly string[], cwd: string, env?: Record<string, string>) => Promise<string>
18
+ export type CodingWorkspace = {
19
+ readonly source: string
20
+ readonly taskRoot: string
21
+ readonly baseSha: string
22
+ readonly sourceIdentity: string
23
+ }
24
+ export type ChangeArtifacts = {
25
+ readonly changedFiles: readonly string[]
26
+ readonly untrackedFiles: readonly string[]
27
+ readonly patchPath: string
28
+ readonly oversized: boolean
29
+ }
30
+ const MAX_ARTIFACT = 64 * 1024 * 1024
31
+
32
+ // This executor is constructed by the trusted service, never supplied by a model.
33
+ export function codingGitExecutor(
34
+ source: string,
35
+ taskRoot: string,
36
+ signal?: AbortSignal,
37
+ mode: 'code' | 'plan' | 'snapshot' = 'code',
38
+ ): CodingExecutor {
39
+ return async (argv, cwd, env) => {
40
+ const prepared = await prepareCodingCommand(argv, {
41
+ source,
42
+ taskRoot,
43
+ mode,
44
+ cwd,
45
+ env: {
46
+ GIT_CONFIG_NOSYSTEM: '1',
47
+ GIT_CONFIG_GLOBAL: '/dev/null',
48
+ GIT_TERMINAL_PROMPT: '0',
49
+ GIT_OPTIONAL_LOCKS: '0',
50
+ ...env,
51
+ },
52
+ })
53
+ try {
54
+ return await runCodingProcess(
55
+ ['bash', '-c', `exec ${prepared.commandString}`],
56
+ cwd,
57
+ prepared.spawnEnv,
58
+ signal,
59
+ prepared.extraFiles,
60
+ )
61
+ } finally {
62
+ await prepared.cleanup()
63
+ }
64
+ }
65
+ }
66
+
67
+ export async function runCodingProcess(
68
+ argv: readonly string[],
69
+ cwd: string,
70
+ env: Record<string, string> = DEFAULT_SANDBOX_ENV,
71
+ signal?: AbortSignal,
72
+ extraFiles: Array<number | 'ignore'> = [],
73
+ ): Promise<string> {
74
+ signal = signal ? AbortSignal.any([signal, AbortSignal.timeout(60_000)]) : AbortSignal.timeout(60_000)
75
+ const [program, ...args] = argv
76
+ if (!program) throw new Error('Empty Git command.')
77
+ const child = spawn(program, args, { cwd, env, detached: true, stdio: ['ignore', 'pipe', 'pipe', ...extraFiles] })
78
+ const exited = once(child, 'close')
79
+ const cancel = () => {
80
+ if (child.pid === undefined) return
81
+ try {
82
+ process.kill(-child.pid, 'SIGKILL')
83
+ } catch (error) {
84
+ if (!(error instanceof Error && 'code' in error && error.code === 'ESRCH')) throw error
85
+ }
86
+ }
87
+ signal?.addEventListener('abort', cancel, { once: true })
88
+ if (signal?.aborted) cancel()
89
+ const consume = async (stream: NodeJS.ReadableStream): Promise<string> => {
90
+ const chunks: Uint8Array[] = []
91
+ let size = 0
92
+ for await (const value of stream) {
93
+ const bytes = Buffer.isBuffer(value) ? value : Buffer.from(value)
94
+ size += bytes.byteLength
95
+ if (size > MAX_ARTIFACT) {
96
+ cancel()
97
+ throw new Error('Coding artifact exceeds 64 MiB; partial work is preserved.')
98
+ }
99
+ chunks.push(bytes)
100
+ }
101
+ return Buffer.concat(chunks).toString('utf8')
102
+ }
103
+ if (!child.stdout || !child.stderr) throw new Error('Git pipes unavailable.')
104
+ const reads = [consume(child.stdout), consume(child.stderr)]
105
+ try {
106
+ const [output, , exit] = await Promise.all([...reads, exited])
107
+ if (!Array.isArray(exit) || exit[0] !== 0)
108
+ throw new Error('Sandboxed Git operation failed; source or task Git state may be unsupported.')
109
+ if (typeof output !== 'string') throw new Error('Git output unavailable.')
110
+ return output
111
+ } finally {
112
+ signal?.removeEventListener('abort', cancel)
113
+ cancel()
114
+ await Promise.allSettled([exited, ...reads])
115
+ }
116
+ }
117
+
118
+ export async function createCodingWorkspace(
119
+ source: string,
120
+ taskRoot: string,
121
+ execute: CodingExecutor,
122
+ sourcePath = CODING_SOURCE,
123
+ ): Promise<CodingWorkspace> {
124
+ await assertCodingDirectory(source)
125
+ await assertCodingDirectory(taskRoot)
126
+ const identity = await lstat(source)
127
+ const git = (...args: string[]) =>
128
+ execute(['git', '--no-replace-objects', '-c', 'core.hooksPath=/dev/null', ...args], taskRoot)
129
+ const root = (await git('-C', sourcePath, 'rev-parse', '--show-toplevel')).trim()
130
+ if (root !== sourcePath) throw new Error('Select a repository root, not a subdirectory.')
131
+ const baseSha = (await git('-C', sourcePath, 'rev-parse', '--verify', 'HEAD^{commit}')).trim()
132
+ if (!/^[a-f0-9]{40,64}$/.test(baseSha)) throw new Error('Source has no committed HEAD.')
133
+ const tree = (await git('-C', sourcePath, 'ls-tree', '-rz', '--name-only', baseSha)).split('\0').filter(Boolean)
134
+ const protectedPath = tree.find(
135
+ (name) =>
136
+ CODING_MASK_FILES.some((file) => name === file) ||
137
+ codingSourceMaskDirs(source, taskRoot).some((dir) => name === dir || name.startsWith(`${dir}/`)),
138
+ )
139
+ if (protectedPath)
140
+ throw new Error(
141
+ 'Selected source revision contains a protected canonical/private path. Select a clean committed revision.',
142
+ )
143
+ await git('init', '--bare', join(taskRoot, 'git'))
144
+ // file transport copies objects and --depth=1 excludes unrelated history.
145
+ await git(
146
+ '--git-dir',
147
+ join(taskRoot, 'git'),
148
+ '-c',
149
+ 'protocol.file.allow=always',
150
+ 'fetch',
151
+ '--depth=1',
152
+ '--no-tags',
153
+ `file://${sourcePath}`,
154
+ baseSha,
155
+ )
156
+ await git('--git-dir', join(taskRoot, 'git'), 'worktree', 'add', '--detach', join(taskRoot, 'worktree'), baseSha)
157
+ const after = await lstat(source)
158
+ if (identity.dev !== after.dev || identity.ino !== after.ino) throw new Error('Source repository identity changed.')
159
+ return { source, taskRoot, baseSha, sourceIdentity: `${identity.dev}:${identity.ino}` }
160
+ }
161
+
162
+ export async function captureCodingChanges(
163
+ workspace: CodingWorkspace,
164
+ execute: CodingExecutor,
165
+ writeArtifact: (path: string, text: string) => Promise<void>,
166
+ ): Promise<ChangeArtifacts> {
167
+ const { taskRoot, baseSha } = workspace
168
+ await assertCodingDirectory(taskRoot)
169
+ const cwd = join(taskRoot, 'worktree')
170
+ const git = (...args: string[]) =>
171
+ execute(['git', '--no-replace-objects', '-c', 'core.hooksPath=/dev/null', ...args], cwd)
172
+ const untrackedFiles = (await git('ls-files', '--others', '--exclude-standard', '-z')).split('\0').filter(Boolean)
173
+ // Temporary index lives in sandbox scratch, not in the CLI's mutable index.
174
+ const temporary = `/tmp/typeclaw-index-${crypto.randomUUID()}`
175
+ // Each bwrap invocation has fresh /tmp: construct and consume the index in ONE process.
176
+ // The helper script is code we supply, with paths passed as positional parameters.
177
+ const script = [
178
+ 'set -euo pipefail',
179
+ // A model-controlled replace ref must not redefine the recorded baseline.
180
+ 'export GIT_NO_REPLACE_OBJECTS=1',
181
+ 'index="$(git rev-parse --git-path index)"',
182
+ 'objects="$(git rev-parse --git-path objects)"',
183
+ 'export GIT_INDEX_FILE="$1"',
184
+ 'export GIT_OBJECT_DIRECTORY="$1.objects"',
185
+ 'export GIT_ALTERNATE_OBJECT_DIRECTORIES="$objects"',
186
+ 'mkdir "$GIT_OBJECT_DIRECTORY"',
187
+ 'trap \'rm -f "$GIT_INDEX_FILE"; rm -rf "$GIT_OBJECT_DIRECTORY"\' EXIT',
188
+ 'if [ -f "$index" ]; then cp "$index" "$GIT_INDEX_FILE"; else git -c core.hooksPath=/dev/null read-tree HEAD; fi',
189
+ // Clear each flag separately: Git applies only one flag operation per update.
190
+ 'git ls-files -z | git -c core.hooksPath=/dev/null update-index --no-assume-unchanged -z --stdin',
191
+ 'git ls-files -z | git -c core.hooksPath=/dev/null update-index --no-skip-worktree -z --stdin',
192
+ 'git -c core.hooksPath=/dev/null add -A -- .',
193
+ 'if [ "$3" = patch ]; then',
194
+ ' git -c core.hooksPath=/dev/null diff --cached --binary --full-index --no-ext-diff --no-textconv "$2" --',
195
+ 'else',
196
+ ' git -c core.hooksPath=/dev/null diff --cached --raw --numstat -z --no-renames --no-ext-diff --no-textconv "$2" --',
197
+ 'fi',
198
+ ].join('\n')
199
+ let patch: string
200
+ try {
201
+ patch = await execute(['bash', '-c', script, 'capture', temporary, baseSha, 'patch'], cwd)
202
+ } catch (error) {
203
+ if (error instanceof Error && error.message.includes('64 MiB')) {
204
+ return { changedFiles: [], untrackedFiles, patchPath: join(taskRoot, 'output', 'changes.patch'), oversized: true }
205
+ }
206
+ throw error
207
+ }
208
+ const inventory = await execute(['bash', '-c', script, 'capture', temporary, baseSha, 'inventory'], cwd)
209
+ const records = inventory.split('\0').filter(Boolean)
210
+ const changes: Array<{
211
+ path: string
212
+ status: string
213
+ oldMode: string
214
+ mode: string
215
+ binary: boolean
216
+ untracked: boolean
217
+ }> = []
218
+ const binary = new Set<string>()
219
+ for (let i = 0; i < records.length; i++) {
220
+ const record = records[i] ?? ''
221
+ const raw = /^:(\d+) (\d+) [a-f0-9]+ [a-f0-9]+ ([A-Z])$/.exec(record)
222
+ if (raw) {
223
+ const path = records[++i]
224
+ if (!path || !raw[1] || !raw[2] || !raw[3]) throw new Error('Git change inventory is incomplete.')
225
+ changes.push({
226
+ path,
227
+ status: raw[3],
228
+ oldMode: raw[1],
229
+ mode: raw[2],
230
+ binary: false,
231
+ untracked: untrackedFiles.includes(path),
232
+ })
233
+ } else if (record.startsWith('-\t-\t')) binary.add(record.slice(4))
234
+ }
235
+ for (const change of changes) change.binary = binary.has(change.path)
236
+ const changedFiles = changes.map((change) => change.path)
237
+ const patchPath = join(taskRoot, 'output', 'changes.patch')
238
+ await writeArtifact(patchPath, patch)
239
+ await writeArtifact(
240
+ join(taskRoot, 'output', 'changes.json'),
241
+ JSON.stringify(
242
+ {
243
+ baseSha,
244
+ changedFiles,
245
+ untrackedFiles,
246
+ changes,
247
+ },
248
+ null,
249
+ 2,
250
+ ),
251
+ )
252
+ return { changedFiles, untrackedFiles, patchPath, oversized: false }
253
+ }
254
+
255
+ export async function writeCodingArtifact(agentDir: string, targetPath: string, text: string): Promise<void> {
256
+ await writeFileAnchored({ agentDir, targetPath, data: Buffer.from(text), tool: 'coding_agent' })
257
+ }
258
+
259
+ export async function createTaskDirectory(agentDir: string, taskId: string): Promise<string> {
260
+ const root = join(agentDir, 'workspace', 'coding-agents')
261
+ const taskRoot = join(root, taskId)
262
+ if (process.platform === 'linux') {
263
+ const parent = await createAndOpenAnchoredDirectory(root)
264
+ try {
265
+ const anchored = `/proc/self/fd/${parent.fd}/${taskId}`
266
+ await mkdir(anchored, { mode: 0o700 })
267
+ const task = await open(anchored, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW)
268
+ try {
269
+ for (const part of ['claude', 'codex', 'output'])
270
+ await mkdir(`/proc/self/fd/${task.fd}/${part}`, { mode: 0o700 })
271
+ } finally {
272
+ await task.close()
273
+ }
274
+ } finally {
275
+ await parent.close()
276
+ }
277
+ return taskRoot
278
+ }
279
+ // Dev-stage fixture setup. Production invocation still requires Linux bwrap.
280
+ // No-follow every existing component, including the shared workspace.
281
+ for (const path of [agentDir, join(agentDir, 'workspace'), root]) {
282
+ await mkdir(path, { recursive: true })
283
+ await assertCodingDirectory(path)
284
+ }
285
+ await mkdir(taskRoot, { mode: 0o700 })
286
+ for (const part of ['claude', 'codex', 'output']) await mkdir(join(taskRoot, part), { mode: 0o700 })
287
+ return taskRoot
288
+ }
289
+
290
+ export async function disposeCodingWorkspace(workspace: CodingWorkspace, execute: CodingExecutor): Promise<void> {
291
+ await assertCodingDirectory(workspace.taskRoot)
292
+ const exists = await lstat(join(workspace.taskRoot, 'worktree')).catch((error: unknown) => {
293
+ if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return undefined
294
+ throw error
295
+ })
296
+ if (exists)
297
+ await execute(
298
+ [
299
+ 'git',
300
+ '--git-dir',
301
+ join(workspace.taskRoot, 'git'),
302
+ 'worktree',
303
+ 'remove',
304
+ '--force',
305
+ join(workspace.taskRoot, 'worktree'),
306
+ ],
307
+ workspace.taskRoot,
308
+ )
309
+ if (process.platform === 'linux') {
310
+ const parent = await createAndOpenAnchoredDirectory(dirname(workspace.taskRoot), false)
311
+ try {
312
+ await rm(`/proc/self/fd/${parent.fd}/${workspace.taskRoot.split('/').at(-1)}`, { recursive: true })
313
+ } finally {
314
+ await parent.close()
315
+ }
316
+ } else await rm(workspace.taskRoot, { recursive: true })
317
+ }
318
+
319
+ export async function writeTaskRegistry(path: string, text: string): Promise<void> {
320
+ await mkdir(dirname(path), { recursive: true })
321
+ await assertCodingDirectory(dirname(path))
322
+ const parent = process.platform === 'linux' ? await createAndOpenAnchoredDirectory(dirname(path), false) : undefined
323
+ try {
324
+ const target = parent ? `/proc/self/fd/${parent.fd}/coding-agent-tasks.json` : path
325
+ const temporary = `${target}.${crypto.randomUUID()}.tmp`
326
+ const file = await open(
327
+ temporary,
328
+ constants.O_CREAT | constants.O_EXCL | constants.O_WRONLY | constants.O_NOFOLLOW,
329
+ 0o600,
330
+ )
331
+ try {
332
+ await file.writeFile(text)
333
+ } finally {
334
+ await file.close()
335
+ }
336
+ await rename(temporary, target)
337
+ } finally {
338
+ await parent?.close()
339
+ }
340
+ }
341
+
342
+ export async function resolveCodingSource(
343
+ agentDir: string,
344
+ repo: string,
345
+ mountNames: readonly string[],
346
+ ): Promise<string> {
347
+ const target = resolve(agentDir, repo)
348
+ const roots = [agentDir, ...mountNames.map((name) => join(agentDir, 'mounts', name))]
349
+ if (!roots.some((root) => target === root || target.startsWith(`${join(agentDir, 'workspace')}/`))) {
350
+ throw new Error('Repository is not an accessible agent, workspace, or configured mount root.')
351
+ }
352
+ const actual = await realpath(target)
353
+ if (actual !== target) throw new Error('Repository symlink aliases are not supported; select the configured root.')
354
+ return actual
355
+ }
@@ -2,7 +2,7 @@ import { validateConfig } from '@/config'
2
2
  import { type Controller, resolveController } from '@/container'
3
3
 
4
4
  import { discoverAgents, type AgentEntry } from './discover'
5
- import type { AgentResult, StartSuccess } from './start'
5
+ import { checkFleetMemory, type AgentResult, type StartSuccess } from './start'
6
6
  import type { StopSuccess } from './stop'
7
7
 
8
8
  export type RestartData = { stop: StopSuccess; start: StartSuccess }
@@ -22,16 +22,21 @@ export type ComposeRestartOptions = {
22
22
 
23
23
  export type ComposeRestartDeps = {
24
24
  restart?: Controller['restart']
25
+ checkMemory?: () => Promise<string[] | null>
25
26
  }
26
27
 
27
28
  export type ComposeRestartResult = {
28
29
  agents: AgentEntry[]
29
30
  results: AgentResult<RestartData>[]
31
+ memoryWarning: string[] | null
30
32
  }
31
33
 
32
34
  export async function composeRestart(
33
35
  { rootCwd, preferredHostPort, forceBuild = false, cliEntry, onProgress }: ComposeRestartOptions,
34
- { restart = (options) => resolveController().restart(options) }: ComposeRestartDeps = {},
36
+ {
37
+ restart = (options) => resolveController().restart(options),
38
+ checkMemory = checkFleetMemory,
39
+ }: ComposeRestartDeps = {},
35
40
  ): Promise<ComposeRestartResult> {
36
41
  const agents = discoverAgents(rootCwd)
37
42
  const results = await Promise.all(
@@ -50,7 +55,8 @@ export async function composeRestart(
50
55
  return result
51
56
  }),
52
57
  )
53
- return { agents, results }
58
+ const memoryWarning = results.some((r) => r.ok) ? await checkMemory() : null
59
+ return { agents, results, memoryWarning }
54
60
  }
55
61
 
56
62
  async function runOne(
@@ -73,6 +79,7 @@ async function runOne(
73
79
  cliEntry,
74
80
  onStopped,
75
81
  streamOutput: false,
82
+ skipMemoryOversubscriptionCheck: true,
76
83
  onWarning: (warning) => warnings.push(warning),
77
84
  })
78
85
  if (!restarted.ok) return { name, ok: false, reason: restarted.reason, warnings }
@@ -1,5 +1,12 @@
1
1
  import { validateConfig } from '@/config'
2
- import { type Controller, resolveController, type StartResult } from '@/container'
2
+ import {
3
+ type Controller,
4
+ defaultDockerExec,
5
+ formatOversubscriptionWarning,
6
+ readFleetMemoryOversubscription,
7
+ resolveController,
8
+ type StartResult,
9
+ } from '@/container'
3
10
 
4
11
  import { discoverAgents, type AgentEntry } from './discover'
5
12
 
@@ -23,16 +30,19 @@ export type ComposeStartOptions = {
23
30
 
24
31
  export type ComposeStartDeps = {
25
32
  start?: Controller['start']
33
+ checkMemory?: () => Promise<string[] | null>
26
34
  }
27
35
 
28
36
  export type ComposeStartResult = {
29
37
  agents: AgentEntry[]
30
38
  results: AgentResult<StartSuccess>[]
39
+ // Fleet-wide, reported once — see readFleetMemoryOversubscription.
40
+ memoryWarning: string[] | null
31
41
  }
32
42
 
33
43
  export async function composeStart(
34
44
  { rootCwd, preferredHostPort, forceBuild = false, cliEntry, onProgress }: ComposeStartOptions,
35
- { start = (options) => resolveController().start(options) }: ComposeStartDeps = {},
45
+ { start = (options) => resolveController().start(options), checkMemory = checkFleetMemory }: ComposeStartDeps = {},
36
46
  ): Promise<ComposeStartResult> {
37
47
  const agents = discoverAgents(rootCwd)
38
48
  const results = await Promise.all(
@@ -43,7 +53,13 @@ export async function composeStart(
43
53
  return result
44
54
  }),
45
55
  )
46
- return { agents, results }
56
+ const memoryWarning = results.some((r) => r.ok) ? await checkMemory() : null
57
+ return { agents, results, memoryWarning }
58
+ }
59
+
60
+ export async function checkFleetMemory(): Promise<string[] | null> {
61
+ const warning = await readFleetMemoryOversubscription(defaultDockerExec)
62
+ return warning === null ? null : formatOversubscriptionWarning(warning)
47
63
  }
48
64
 
49
65
  async function runOne(
@@ -64,6 +80,7 @@ async function runOne(
64
80
  forceBuild,
65
81
  cliEntry,
66
82
  streamOutput: false,
83
+ skipMemoryOversubscriptionCheck: true,
67
84
  onWarning: (warning) => warnings.push(warning),
68
85
  })
69
86
  if (!data.ok) return { name, ok: false, reason: data.reason, warnings }