typeclaw 0.49.0 → 0.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (502) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/bash-sandbox-env.d.ts +15 -0
  4. package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
  5. package/dist/types/agent/bash-sandbox.d.ts +94 -0
  6. package/dist/types/agent/compaction.d.ts +8 -0
  7. package/dist/types/agent/git-nudge.d.ts +6 -0
  8. package/dist/types/agent/guard-types.d.ts +25 -0
  9. package/dist/types/agent/guards.d.ts +7 -0
  10. package/dist/types/agent/idle-compaction.d.ts +8 -0
  11. package/dist/types/agent/index.d.ts +151 -0
  12. package/dist/types/agent/live-subagents.d.ts +113 -0
  13. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  14. package/dist/types/agent/loop-guard.d.ts +67 -0
  15. package/dist/types/agent/model-fallback.d.ts +29 -0
  16. package/dist/types/agent/model-overrides.d.ts +8 -0
  17. package/dist/types/agent/multimodal/index.d.ts +2 -0
  18. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  19. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  20. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  21. package/dist/types/agent/network/response-body.d.ts +1 -0
  22. package/dist/types/agent/network/safe-http.d.ts +46 -0
  23. package/dist/types/agent/output-allowance.d.ts +4 -0
  24. package/dist/types/agent/plugin-tools.d.ts +58 -0
  25. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  26. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  27. package/dist/types/agent/provider-error.d.ts +23 -0
  28. package/dist/types/agent/reload-tool.d.ts +10 -0
  29. package/dist/types/agent/restart/index.d.ts +31 -0
  30. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  31. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  32. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  33. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  34. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  35. package/dist/types/agent/self.d.ts +1 -0
  36. package/dist/types/agent/session-meta.d.ts +28 -0
  37. package/dist/types/agent/session-origin.d.ts +65 -0
  38. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  39. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  40. package/dist/types/agent/subagent-drain.d.ts +25 -0
  41. package/dist/types/agent/subagent-session.d.ts +3 -0
  42. package/dist/types/agent/subagents.d.ts +153 -0
  43. package/dist/types/agent/system-prompt-composition.d.ts +17 -0
  44. package/dist/types/agent/system-prompt.d.ts +7 -0
  45. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  46. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  47. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  48. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  49. package/dist/types/agent/todo/continuation.d.ts +21 -0
  50. package/dist/types/agent/todo/scope.d.ts +6 -0
  51. package/dist/types/agent/todo/store.d.ts +16 -0
  52. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  53. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  54. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  55. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  56. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  57. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  58. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  59. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  60. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  61. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  62. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  63. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  64. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  65. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  66. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  67. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  68. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  69. package/dist/types/agent/tools/ddg.d.ts +27 -0
  70. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  71. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  72. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  73. package/dist/types/agent/tools/restart.d.ts +25 -0
  74. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  75. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  76. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  77. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  78. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  79. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  80. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  81. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  82. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  83. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  84. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  85. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  86. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  87. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  88. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  89. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  90. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  91. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  92. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  93. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  94. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  95. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  96. package/dist/types/agent/tools/websearch.d.ts +17 -0
  97. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  98. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  99. package/dist/types/agent/turn-runner.d.ts +36 -0
  100. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  101. package/dist/types/browser/dockerfile.d.ts +2 -0
  102. package/dist/types/browser/registry.d.ts +49 -0
  103. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  104. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  105. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  106. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  107. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  108. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  109. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  110. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  111. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  112. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  113. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  114. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  115. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  116. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  117. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  118. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  119. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  120. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  121. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  122. package/dist/types/channels/background-handoff.d.ts +56 -0
  123. package/dist/types/channels/background-obligations.d.ts +135 -0
  124. package/dist/types/channels/catch-up.d.ts +26 -0
  125. package/dist/types/channels/commands.d.ts +2 -0
  126. package/dist/types/channels/completion-claim.d.ts +20 -0
  127. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  128. package/dist/types/channels/continuity-types.d.ts +75 -0
  129. package/dist/types/channels/describe-error.d.ts +1 -0
  130. package/dist/types/channels/engagement.d.ts +34 -0
  131. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  132. package/dist/types/channels/github-repo.d.ts +2 -0
  133. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  134. package/dist/types/channels/github-review-check.d.ts +135 -0
  135. package/dist/types/channels/github-review-claim.d.ts +3 -0
  136. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  137. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  138. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  139. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  140. package/dist/types/channels/inbound-journal.d.ts +272 -0
  141. package/dist/types/channels/last-alive.d.ts +3 -0
  142. package/dist/types/channels/membership-cache.d.ts +27 -0
  143. package/dist/types/channels/membership.d.ts +21 -0
  144. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  145. package/dist/types/channels/participants.d.ts +4 -0
  146. package/dist/types/channels/persistence.d.ts +32 -0
  147. package/dist/types/channels/recovery-notice.d.ts +26 -0
  148. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  149. package/dist/types/channels/router.d.ts +760 -0
  150. package/dist/types/channels/schema.d.ts +501 -0
  151. package/dist/types/channels/session-handoff.d.ts +58 -0
  152. package/dist/types/channels/session-search.d.ts +29 -0
  153. package/dist/types/channels/types.d.ts +414 -0
  154. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  155. package/dist/types/cli/builtins.d.ts +2 -0
  156. package/dist/types/cli/command-meta.d.ts +9 -0
  157. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  158. package/dist/types/coding-agent/broker.d.ts +22 -0
  159. package/dist/types/coding-agent/claude.d.ts +22 -0
  160. package/dist/types/coding-agent/codex.d.ts +19 -0
  161. package/dist/types/coding-agent/index.d.ts +71 -0
  162. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  163. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  164. package/dist/types/coding-agent/omo.d.ts +133 -0
  165. package/dist/types/coding-agent/runner.d.ts +35 -0
  166. package/dist/types/coding-agent/tool.d.ts +27 -0
  167. package/dist/types/coding-agent/worktree.d.ts +22 -0
  168. package/dist/types/commands/index.d.ts +45 -0
  169. package/dist/types/config/config.d.ts +827 -0
  170. package/dist/types/config/index.d.ts +3 -0
  171. package/dist/types/config/model-overrides.d.ts +3 -0
  172. package/dist/types/config/providers.d.ts +1458 -0
  173. package/dist/types/config/reloadable.d.ts +9 -0
  174. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  175. package/dist/types/container/build-cache.d.ts +39 -0
  176. package/dist/types/container/compose-project.d.ts +1 -0
  177. package/dist/types/container/controller.d.ts +25 -0
  178. package/dist/types/container/docker-app.d.ts +23 -0
  179. package/dist/types/container/exit-reason.d.ts +10 -0
  180. package/dist/types/container/index.d.ts +14 -0
  181. package/dist/types/container/log-archive.d.ts +68 -0
  182. package/dist/types/container/log-colors.d.ts +3 -0
  183. package/dist/types/container/log-timestamps.d.ts +9 -0
  184. package/dist/types/container/logs.d.ts +37 -0
  185. package/dist/types/container/memory-limit.d.ts +13 -0
  186. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  187. package/dist/types/container/oom-events.d.ts +18 -0
  188. package/dist/types/container/port.d.ts +18 -0
  189. package/dist/types/container/require-running.d.ts +16 -0
  190. package/dist/types/container/restart.d.ts +32 -0
  191. package/dist/types/container/shared.d.ts +93 -0
  192. package/dist/types/container/shell.d.ts +35 -0
  193. package/dist/types/container/start.d.ts +145 -0
  194. package/dist/types/container/stats.d.ts +31 -0
  195. package/dist/types/container/status.d.ts +25 -0
  196. package/dist/types/container/stop.d.ts +24 -0
  197. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  198. package/dist/types/container/verify-running.d.ts +49 -0
  199. package/dist/types/cron/consumer.d.ts +42 -0
  200. package/dist/types/cron/count-state.d.ts +24 -0
  201. package/dist/types/cron/index.d.ts +21 -0
  202. package/dist/types/cron/list.d.ts +33 -0
  203. package/dist/types/cron/reloadable.d.ts +11 -0
  204. package/dist/types/cron/scheduler.d.ts +51 -0
  205. package/dist/types/cron/schema.d.ts +108 -0
  206. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  207. package/dist/types/dependencies/bins.d.ts +22 -0
  208. package/dist/types/dependencies/index.d.ts +2 -0
  209. package/dist/types/eval/cell.d.ts +26 -0
  210. package/dist/types/eval/config.d.ts +19 -0
  211. package/dist/types/eval/dispatch.d.ts +7 -0
  212. package/dist/types/eval/kernel.d.ts +28 -0
  213. package/dist/types/eval/process.d.ts +23 -0
  214. package/dist/types/eval/protocol.d.ts +34 -0
  215. package/dist/types/eval/sandbox.d.ts +10 -0
  216. package/dist/types/eval/tool.d.ts +17 -0
  217. package/dist/types/eval/wire.d.ts +33 -0
  218. package/dist/types/git/bound-gc-config.d.ts +4 -0
  219. package/dist/types/git/hookless.d.ts +1 -0
  220. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  221. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  222. package/dist/types/git/resolve-identity.d.ts +10 -0
  223. package/dist/types/git/run.d.ts +24 -0
  224. package/dist/types/git/system-commit.d.ts +2 -0
  225. package/dist/types/hostd/client.d.ts +13 -0
  226. package/dist/types/hostd/models.d.ts +1 -0
  227. package/dist/types/hostd/paths.d.ts +17 -0
  228. package/dist/types/hostd/protocol.d.ts +93 -0
  229. package/dist/types/hostd/spawn.d.ts +17 -0
  230. package/dist/types/hostd/version.d.ts +18 -0
  231. package/dist/types/init/auto-upgrade.d.ts +41 -0
  232. package/dist/types/init/cli-version.d.ts +7 -0
  233. package/dist/types/init/dockerfile.d.ts +34 -0
  234. package/dist/types/init/ensure-deps.d.ts +17 -0
  235. package/dist/types/init/env-file.d.ts +3 -0
  236. package/dist/types/init/gitignore.d.ts +5 -0
  237. package/dist/types/init/local-source-stamp.d.ts +3 -0
  238. package/dist/types/init/packagejson.d.ts +7 -0
  239. package/dist/types/init/paths.d.ts +3 -0
  240. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  241. package/dist/types/init/run-bun-install.d.ts +16 -0
  242. package/dist/types/init/windows-dev-link.d.ts +8 -0
  243. package/dist/types/mcp/catalog.d.ts +7 -0
  244. package/dist/types/mcp/client.d.ts +58 -0
  245. package/dist/types/mcp/manager.d.ts +56 -0
  246. package/dist/types/mcp/tools.d.ts +23 -0
  247. package/dist/types/models/embedding-model.d.ts +20 -0
  248. package/dist/types/models/transformers-version.d.ts +1 -0
  249. package/dist/types/network/internal-destinations.d.ts +29 -0
  250. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  251. package/dist/types/operations/incidents.d.ts +47 -0
  252. package/dist/types/operations/index.d.ts +3 -0
  253. package/dist/types/operations/remediations.d.ts +25 -0
  254. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  255. package/dist/types/permissions/builtins.d.ts +25 -0
  256. package/dist/types/permissions/grant.d.ts +19 -0
  257. package/dist/types/permissions/index.d.ts +6 -0
  258. package/dist/types/permissions/match-rule.d.ts +28 -0
  259. package/dist/types/permissions/permissions.d.ts +42 -0
  260. package/dist/types/permissions/resolve.d.ts +25 -0
  261. package/dist/types/permissions/schema.d.ts +14 -0
  262. package/dist/types/plugin/context.d.ts +20 -0
  263. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  264. package/dist/types/plugin/define.d.ts +46 -0
  265. package/dist/types/plugin/hooks.d.ts +52 -0
  266. package/dist/types/plugin/index.d.ts +11 -0
  267. package/dist/types/plugin/load-skill.d.ts +14 -0
  268. package/dist/types/plugin/loader.d.ts +25 -0
  269. package/dist/types/plugin/manager.d.ts +42 -0
  270. package/dist/types/plugin/registry.d.ts +73 -0
  271. package/dist/types/plugin/skills.d.ts +11 -0
  272. package/dist/types/plugin/types.d.ts +336 -0
  273. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  274. package/dist/types/reload/client.d.ts +11 -0
  275. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  276. package/dist/types/reload/format.d.ts +2 -0
  277. package/dist/types/reload/index.d.ts +6 -0
  278. package/dist/types/reload/recover.d.ts +22 -0
  279. package/dist/types/reload/registry.d.ts +10 -0
  280. package/dist/types/reload/types.d.ts +25 -0
  281. package/dist/types/role-claim/client.d.ts +20 -0
  282. package/dist/types/role-claim/code.d.ts +4 -0
  283. package/dist/types/role-claim/controller.d.ts +59 -0
  284. package/dist/types/role-claim/index.d.ts +6 -0
  285. package/dist/types/role-claim/match-rule.d.ts +9 -0
  286. package/dist/types/role-claim/pending.d.ts +35 -0
  287. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  288. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  289. package/dist/types/sandbox/availability.d.ts +21 -0
  290. package/dist/types/sandbox/build.d.ts +7 -0
  291. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  292. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  293. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  294. package/dist/types/sandbox/dev-source.d.ts +4 -0
  295. package/dist/types/sandbox/env-exposure.d.ts +3 -0
  296. package/dist/types/sandbox/errors.d.ts +20 -0
  297. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  298. package/dist/types/sandbox/index.d.ts +14 -0
  299. package/dist/types/sandbox/package-install.d.ts +1 -0
  300. package/dist/types/sandbox/policy.d.ts +71 -0
  301. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  302. package/dist/types/sandbox/quote.d.ts +2 -0
  303. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  304. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  305. package/dist/types/sandbox/symlinks.d.ts +6 -0
  306. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  307. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  308. package/dist/types/secrets/defaults.d.ts +21 -0
  309. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  310. package/dist/types/secrets/hydrate.d.ts +7 -0
  311. package/dist/types/secrets/index.d.ts +7 -0
  312. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  313. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  314. package/dist/types/secrets/resolve.d.ts +14 -0
  315. package/dist/types/secrets/schema.d.ts +840 -0
  316. package/dist/types/secrets/storage.d.ts +56 -0
  317. package/dist/types/shared/host-locale.d.ts +1 -0
  318. package/dist/types/shared/index.d.ts +5 -0
  319. package/dist/types/shared/local-time.d.ts +4 -0
  320. package/dist/types/shared/platform.d.ts +2 -0
  321. package/dist/types/shared/protocol.d.ts +424 -0
  322. package/dist/types/shared/style-text.d.ts +3 -0
  323. package/dist/types/shared/wsl.d.ts +17 -0
  324. package/dist/types/stream/broker.d.ts +2 -0
  325. package/dist/types/stream/index.d.ts +2 -0
  326. package/dist/types/stream/types.d.ts +71 -0
  327. package/package.json +13 -6
  328. package/scripts/build-plugin-types.ts +105 -0
  329. package/scripts/check-plugin-sdk.ts +111 -0
  330. package/scripts/require-parallel.ts +5 -32
  331. package/src/agent/bash-sandbox-env.ts +104 -0
  332. package/src/agent/bash-sandbox-proc.ts +70 -0
  333. package/src/agent/bash-sandbox.ts +225 -0
  334. package/src/agent/compaction.ts +22 -10
  335. package/src/agent/guard-types.ts +3 -0
  336. package/src/agent/guards.ts +4 -0
  337. package/src/agent/idle-compaction.ts +178 -0
  338. package/src/agent/index.ts +139 -172
  339. package/src/agent/live-subagents.ts +19 -0
  340. package/src/agent/multimodal/look-at.ts +22 -9
  341. package/src/agent/output-allowance.ts +7 -0
  342. package/src/agent/plugin-tools.ts +39 -377
  343. package/src/agent/reviewer-bash-policy.ts +41 -1
  344. package/src/agent/session-origin.ts +28 -11
  345. package/src/agent/subagent-cache-keepalive.ts +198 -0
  346. package/src/agent/subagent-completion-reminder.ts +2 -2
  347. package/src/agent/subagent-session.ts +6 -0
  348. package/src/agent/subagents.ts +46 -8
  349. package/src/agent/system-prompt-composition.ts +141 -0
  350. package/src/agent/system-prompt.ts +5 -5
  351. package/src/agent/todo/scope.ts +1 -1
  352. package/src/agent/tool-file-safety.ts +6 -1
  353. package/src/agent/tools/channel-edit.ts +20 -10
  354. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  355. package/src/agent/tools/channel-handoff.ts +72 -0
  356. package/src/agent/tools/channel-read.ts +57 -10
  357. package/src/agent/tools/channel-reply.ts +33 -26
  358. package/src/agent/tools/channel-send.ts +21 -13
  359. package/src/agent/tools/channel-session-search.ts +35 -0
  360. package/src/agent/tools/curl-impersonate.ts +11 -4
  361. package/src/agent/tools/ddg.ts +84 -16
  362. package/src/agent/tools/spawn-subagent.ts +27 -11
  363. package/src/agent/tools/stream-snapshot.ts +15 -2
  364. package/src/agent/tools/subagent-access.ts +11 -4
  365. package/src/agent/tools-without-local-file-operands.ts +4 -0
  366. package/src/browser/bsk-shim.mjs +74 -0
  367. package/src/browser/dockerfile.ts +84 -0
  368. package/src/browser/egress.ts +104 -0
  369. package/src/browser/fill-secret.ts +307 -0
  370. package/src/browser/managed-browser.ts +205 -0
  371. package/src/browser/registry.ts +110 -0
  372. package/src/browser/relay.ts +231 -0
  373. package/src/browser/sandbox-entry.ts +167 -0
  374. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  375. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  376. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  377. package/src/bundled-plugins/doc-render/index.ts +0 -10
  378. package/src/bundled-plugins/doc-render/render.ts +83 -111
  379. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  380. package/src/bundled-plugins/explorer/explorer.ts +1 -1
  381. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  382. package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
  383. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  384. package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
  385. package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
  386. package/src/bundled-plugins/managed-browser/index.ts +179 -0
  387. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  388. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  389. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  390. package/src/bundled-plugins/memory/dreaming.ts +4 -1
  391. package/src/bundled-plugins/memory/load-memory.ts +2 -4
  392. package/src/bundled-plugins/memory/memory-logger.ts +74 -2
  393. package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
  394. package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
  395. package/src/bundled-plugins/operator/operator.ts +1 -1
  396. package/src/bundled-plugins/qa/index.ts +11 -0
  397. package/src/bundled-plugins/qa/qa.ts +160 -0
  398. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  399. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  400. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  401. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  402. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  403. package/src/bundled-plugins/security/index.ts +53 -34
  404. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  405. package/src/bundled-plugins/security/policies/private-surface-read.ts +166 -201
  406. package/src/channels/adapter-namespace.ts +13 -0
  407. package/src/channels/adapters/discord-bot-reference.ts +5 -4
  408. package/src/channels/adapters/discord-bot.ts +98 -5
  409. package/src/channels/adapters/discord-classify.ts +8 -3
  410. package/src/channels/adapters/discord.ts +29 -0
  411. package/src/channels/adapters/github/index.ts +16 -0
  412. package/src/channels/adapters/github/last-alive.ts +4 -16
  413. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  414. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  415. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  416. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  417. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  418. package/src/channels/adapters/slack-bot.ts +299 -67
  419. package/src/channels/adapters/slack-classify.ts +1 -0
  420. package/src/channels/catch-up.ts +137 -0
  421. package/src/channels/continuation-willingness.ts +2 -2
  422. package/src/channels/continuity-types.ts +1 -0
  423. package/src/channels/engagement.ts +17 -1
  424. package/src/channels/github-false-receipt.ts +3 -3
  425. package/src/channels/github-rereview-guard.ts +9 -5
  426. package/src/channels/github-review-check.ts +5 -1
  427. package/src/channels/github-review-verdict-coordinator.ts +68 -2
  428. package/src/channels/github-token-bridge.ts +24 -0
  429. package/src/channels/last-alive.ts +34 -0
  430. package/src/channels/manager.ts +8 -1
  431. package/src/channels/router.ts +515 -243
  432. package/src/channels/session-handoff.fixture.ts +144 -0
  433. package/src/channels/session-handoff.ts +175 -0
  434. package/src/channels/session-search.ts +71 -0
  435. package/src/channels/subagent-completion-bridge.ts +3 -2
  436. package/src/channels/types.ts +12 -2
  437. package/src/cli/channel.ts +2 -3
  438. package/src/cli/hostd.ts +3 -0
  439. package/src/cli/init.ts +2 -3
  440. package/src/cli/model.ts +132 -3
  441. package/src/coding-agent/index.ts +7 -1
  442. package/src/coding-agent/omo-stream.ts +40 -0
  443. package/src/coding-agent/runner.ts +30 -8
  444. package/src/config/config.ts +126 -22
  445. package/src/config/model-overrides.ts +59 -0
  446. package/src/config/models-mutation.ts +185 -2
  447. package/src/config/providers-mutation.ts +12 -4
  448. package/src/config/providers.ts +69 -4
  449. package/src/container/start.ts +132 -5
  450. package/src/doctor/checks.ts +33 -22
  451. package/src/doctor/index.ts +48 -12
  452. package/src/doctor/operational-incidents.ts +16 -1
  453. package/src/doctor/plugin-bridge.ts +14 -1
  454. package/src/doctor/stage.ts +14 -0
  455. package/src/doctor/types.ts +6 -0
  456. package/src/eval/cell.ts +93 -0
  457. package/src/eval/config.ts +32 -0
  458. package/src/eval/dispatch.ts +67 -0
  459. package/src/eval/entry.ts +261 -0
  460. package/src/eval/kernel.ts +154 -0
  461. package/src/eval/process.ts +113 -0
  462. package/src/eval/protocol.ts +26 -0
  463. package/src/eval/redeclare.ts +174 -0
  464. package/src/eval/sandbox.ts +114 -0
  465. package/src/eval/tool.ts +98 -0
  466. package/src/eval/wire.ts +93 -0
  467. package/src/hostd/daemon.ts +13 -1
  468. package/src/init/auto-upgrade.ts +7 -1
  469. package/src/init/dockerfile.ts +57 -12
  470. package/src/init/index.ts +4 -3
  471. package/src/init/local-source-stamp.ts +68 -0
  472. package/src/init/models-dev.ts +4 -0
  473. package/src/init/validate-api-key.ts +3 -0
  474. package/src/operations/classify-tool-outcome.ts +1 -1
  475. package/src/permissions/builtins.ts +7 -0
  476. package/src/permissions/permissions.ts +18 -9
  477. package/src/permissions/resolve.ts +7 -1
  478. package/src/plugin/context.ts +2 -0
  479. package/src/plugin/core-tool-names.ts +6 -1
  480. package/src/plugin/hooks.ts +137 -0
  481. package/src/plugin/index.ts +6 -0
  482. package/src/plugin/manager.ts +4 -0
  483. package/src/plugin/types.ts +60 -0
  484. package/src/run/bundled-plugins.ts +6 -0
  485. package/src/run/index.ts +24 -14
  486. package/src/run/llm-fetch-observer.ts +12 -15
  487. package/src/sandbox/canonical-secrets.ts +4 -0
  488. package/src/sandbox/dev-source.ts +26 -0
  489. package/src/sandbox/env-exposure.ts +20 -0
  490. package/src/sandbox/hidden-paths.ts +16 -2
  491. package/src/secrets/storage.ts +13 -0
  492. package/src/server/index.ts +46 -11
  493. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  494. package/src/skills/typeclaw-config/SKILL.md +57 -5
  495. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  496. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  497. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  498. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  499. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  500. package/typeclaw.schema.json +488 -5
  501. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  502. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -0,0 +1,105 @@
1
+ #!/usr/bin/env bun
2
+
3
+ import { rm } from 'node:fs/promises'
4
+ import { dirname, join, relative } from 'node:path'
5
+ import { fileURLToPath } from 'node:url'
6
+
7
+ import * as ts from '@typescript/typescript6'
8
+
9
+ const root = join(dirname(fileURLToPath(import.meta.url)), '..')
10
+ const sourceRoot = join(root, 'src')
11
+ const outputRoot = join(root, 'dist', 'types')
12
+ const configPath = join(root, 'tsconfig.json')
13
+ const config = ts.readConfigFile(configPath, ts.sys.readFile)
14
+ if (config.error) throw new Error(ts.flattenDiagnosticMessageText(config.error.messageText, '\n'))
15
+ const parsed = ts.parseJsonConfigFileContent(config.config, ts.sys, root)
16
+ const options: ts.CompilerOptions = {
17
+ ...parsed.options,
18
+ noEmit: false,
19
+ noEmitOnError: true,
20
+ declaration: true,
21
+ declarationMap: false,
22
+ emitDeclarationOnly: true,
23
+ rootDir: sourceRoot,
24
+ outDir: outputRoot,
25
+ }
26
+ const program = ts.createProgram([join(sourceRoot, 'plugin', 'index.ts')], options)
27
+ const resolutionCache = ts.createModuleResolutionCache(root, (path) => path, options)
28
+
29
+ // Keep the emitted graph self-contained: consumers must not inherit our @/*
30
+ // aliases. Explicit .js specifiers also work with NodeNext declaration lookup.
31
+ const rewriteImports: ts.TransformerFactory<ts.SourceFile | ts.Bundle> = (context) => {
32
+ return (source) => {
33
+ if (ts.isBundle(source)) return source
34
+ const rewrite = (specifier: ts.StringLiteral): ts.StringLiteral => {
35
+ if (!specifier.text.startsWith('@/') && !specifier.text.startsWith('.')) return specifier
36
+ const resolved = ts.resolveModuleName(
37
+ specifier.text,
38
+ source.fileName,
39
+ options,
40
+ ts.sys,
41
+ resolutionCache,
42
+ ).resolvedModule
43
+ if (!resolved) throw new Error(`Cannot resolve SDK declaration import ${specifier.text} in ${source.fileName}`)
44
+ let path = relative(dirname(source.fileName), resolved.resolvedFileName).replaceAll('\\', '/')
45
+ path = path
46
+ .replace(/\.tsx?$/, '.js')
47
+ .replace(/\.mts$/, '.mjs')
48
+ .replace(/\.cts$/, '.cjs')
49
+ return context.factory.createStringLiteral(path.startsWith('.') ? path : `./${path}`)
50
+ }
51
+ const visit: ts.Visitor = (node) => {
52
+ if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier))
53
+ return context.factory.updateImportDeclaration(
54
+ node,
55
+ node.modifiers,
56
+ node.importClause,
57
+ rewrite(node.moduleSpecifier),
58
+ node.attributes,
59
+ )
60
+ if (ts.isExportDeclaration(node) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier))
61
+ return context.factory.updateExportDeclaration(
62
+ node,
63
+ node.modifiers,
64
+ node.isTypeOnly,
65
+ node.exportClause,
66
+ rewrite(node.moduleSpecifier),
67
+ node.attributes,
68
+ )
69
+ if (ts.isImportTypeNode(node) && ts.isLiteralTypeNode(node.argument) && ts.isStringLiteral(node.argument.literal))
70
+ return context.factory.updateImportTypeNode(
71
+ node,
72
+ context.factory.createLiteralTypeNode(rewrite(node.argument.literal)),
73
+ node.attributes,
74
+ node.qualifier,
75
+ node.typeArguments,
76
+ node.isTypeOf,
77
+ )
78
+ return ts.visitEachChild(node, visit, context)
79
+ }
80
+ return ts.visitNode(source, visit) as ts.SourceFile
81
+ }
82
+ }
83
+
84
+ const diagnostics = [...parsed.errors, ...ts.getPreEmitDiagnostics(program)]
85
+ if (diagnostics.some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error)) {
86
+ console.error(
87
+ ts.formatDiagnostics(diagnostics, {
88
+ getCanonicalFileName: (path) => path,
89
+ getCurrentDirectory: () => root,
90
+ getNewLine: () => '\n',
91
+ }),
92
+ )
93
+ process.exit(1)
94
+ }
95
+ await rm(outputRoot, { recursive: true, force: true })
96
+ const result = program.emit(undefined, undefined, undefined, true, { afterDeclarations: [rewriteImports] })
97
+ if (result.emitSkipped || result.diagnostics.some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error))
98
+ throw new Error(
99
+ ts.formatDiagnostics(result.diagnostics, {
100
+ getCanonicalFileName: (path) => path,
101
+ getCurrentDirectory: () => root,
102
+ getNewLine: () => '\n',
103
+ }),
104
+ )
105
+ console.log('Built public plugin declarations under dist/types')
@@ -0,0 +1,111 @@
1
+ #!/usr/bin/env bun
2
+
3
+ import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
4
+ import { tmpdir } from 'node:os'
5
+ import { dirname, join } from 'node:path'
6
+ import { fileURLToPath } from 'node:url'
7
+
8
+ const root = join(dirname(fileURLToPath(import.meta.url)), '..')
9
+ const scratch = await mkdtemp(join(tmpdir(), 'typeclaw-plugin-sdk-'))
10
+ const manifest = await Bun.file(join(root, 'package.json')).json()
11
+ const bunTypes = await Bun.file(join(root, 'node_modules', '@types', 'bun', 'package.json')).json()
12
+
13
+ async function run(argv: string[], cwd: string): Promise<string> {
14
+ const child = Bun.spawn(argv, { cwd, stdin: 'ignore', stdout: 'pipe', stderr: 'pipe' })
15
+ const [stdout, stderr, code] = await Promise.all([
16
+ new Response(child.stdout).text(),
17
+ new Response(child.stderr).text(),
18
+ child.exited,
19
+ ])
20
+ if (code !== 0) throw new Error(`${argv.join(' ')} failed (${code})\n${stdout}\n${stderr}`)
21
+ return stdout
22
+ }
23
+
24
+ try {
25
+ // Exercise the real prepack lifecycle. Installing with scripts disabled then
26
+ // proves declaration consumers do not need our dev compiler or install hook.
27
+ await run(['npm', 'pack', '--pack-destination', scratch], root)
28
+ const archiveName = `typeclaw-${manifest.version}.tgz`
29
+ const consumer = join(scratch, 'consumer')
30
+ await mkdir(consumer)
31
+ await writeFile(
32
+ join(consumer, 'package.json'),
33
+ JSON.stringify({
34
+ name: 'example-plugin-consumer',
35
+ private: true,
36
+ type: 'module',
37
+ dependencies: { typeclaw: `file:../${archiveName}`, zod: manifest.dependencies.zod },
38
+ devDependencies: { '@types/bun': bunTypes.version },
39
+ }),
40
+ )
41
+ await run([process.execPath, 'install', '--ignore-scripts'], consumer)
42
+ await writeFile(
43
+ join(consumer, 'tsconfig.json'),
44
+ JSON.stringify({
45
+ compilerOptions: {
46
+ target: 'ESNext',
47
+ module: 'Preserve',
48
+ moduleResolution: 'bundler',
49
+ strict: true,
50
+ skipLibCheck: true,
51
+ noEmit: true,
52
+ types: ['bun'],
53
+ },
54
+ include: ['plugin.ts'],
55
+ }),
56
+ )
57
+ await writeFile(
58
+ join(consumer, 'plugin.ts'),
59
+ `
60
+ import { definePlugin, type Hooks } from 'typeclaw/plugin'
61
+ import { z } from 'zod'
62
+ const hooks = {
63
+ 'tool.before': (event) => {
64
+ const tool: string = event.tool
65
+ // @ts-expect-error tool identifiers must remain strings, not any
66
+ const invalid: number = event.tool
67
+ return tool ? undefined : { block: true as const, reason: 'empty tool' }
68
+ },
69
+ } satisfies Hooks
70
+ // @ts-expect-error unsupported hook names must not become valid or any
71
+ const unsupported: keyof Hooks = 'session.strat'
72
+ export default definePlugin({
73
+ configSchema: z.object({ enabled: z.boolean() }),
74
+ plugin: async (ctx) => {
75
+ const enabled: boolean = ctx.config.enabled
76
+ // @ts-expect-error schema-inferred config must not become any
77
+ const invalid: string = ctx.config.enabled
78
+ return enabled ? { hooks } : {}
79
+ },
80
+ })
81
+ `,
82
+ )
83
+ for (const [module, resolution] of [
84
+ ['Preserve', 'bundler'],
85
+ ['NodeNext', 'NodeNext'],
86
+ ]) {
87
+ const output = await run(
88
+ [
89
+ process.execPath,
90
+ 'run',
91
+ 'typecheck',
92
+ '--project',
93
+ join(consumer, 'tsconfig.json'),
94
+ '--module',
95
+ module!,
96
+ '--moduleResolution',
97
+ resolution!,
98
+ '--listFiles',
99
+ ],
100
+ root,
101
+ )
102
+ const files = output.split(/\r?\n/).map((file) => file.replaceAll('\\', '/'))
103
+ if (files.some((file) => file.includes('/node_modules/typeclaw/src/')))
104
+ throw new Error('The public SDK pulled TypeClaw implementation sources into the consumer.')
105
+ if (!files.some((file) => file.endsWith('/node_modules/typeclaw/dist/types/plugin/index.d.ts')))
106
+ throw new Error('The packed public SDK declaration entry was not resolved.')
107
+ console.log(`Packed plugin consumer passed ${resolution} resolution without source imports or @/* aliases`)
108
+ }
109
+ } finally {
110
+ await rm(scratch, { recursive: true, force: true })
111
+ }
@@ -1,6 +1,6 @@
1
- // Preloaded by bunfig.toml `[test] preload`. Two responsibilities:
2
- // 1. Deny `bun test` without --parallel.
3
- // 2. Raise the per-test default timeout from Bun's 5000ms.
1
+ // Preloaded by bunfig.toml `[test] preload` to deny `bun test` without
2
+ // --parallel. The default timeout belongs in bunfig.toml, not this preload,
3
+ // so an explicit CLI --timeout keeps its normal precedence.
4
4
  //
5
5
  // Why deny serial runs: Serial runs are ~3.4x slower (44s → 13s, see commit
6
6
  // 1c66d5e), and Bun has no bunfig knob for the flag yet (verified against
@@ -18,39 +18,12 @@
18
18
  //
19
19
  // Bypass with TYPECLAW_ALLOW_SERIAL_TESTS=1 when debugging a flaky test
20
20
  // where worker contention obscures the failure.
21
- //
22
- // Why raise the default timeout: A growing number of tests in this repo
23
- // either spawn child processes (`bun run typeclaw …` via Bun.spawn from
24
- // src/cli/index.test.ts, src/cli/role.test.ts, src/cli/status.test.ts,
25
- // src/init/dockerfile.test.ts agent-browser wrapper, etc.) or boot the
26
- // in-process agent (`startAgent({ port: 0, … })` from src/run/plugin.test.ts).
27
- // Both shapes have a happy-path cost well under 1s but a worst-case cost
28
- // that races Bun's 5000ms ceiling under `--parallel` contention. The
29
- // repeating failure mode is "this test timed out after 5000ms" appearing
30
- // on different tests across runs at a rough ~3-15% rate per full-suite
31
- // invocation — not a real bug, just resource starvation. Raising the
32
- // default to 30s eliminates the false positives without masking real
33
- // hangs (a wedged test still fails, just 6x slower than before). The
34
- // happy path is unaffected because tests complete in their actual
35
- // runtime, not the timeout budget.
36
- //
37
- // 30s was chosen as ~75x the observed happy-path cold-start (~400ms) for
38
- // the heaviest subprocess tests, matching the in-house convention used in
39
- // pi-coding-agent's subprocess fixtures and Bun's own integration-test
40
- // suites (see oven-sh/bun test/cli/install/*.test.ts which set 5-minute
41
- // timeouts for full installs). Individual tests that genuinely need more
42
- // can still pass an explicit 3rd arg to `test()` to override locally.
43
-
44
- import { setDefaultTimeout } from 'bun:test'
45
21
 
46
22
  const isParallelWorker = typeof process.env.BUN_TEST_WORKER_ID === 'string'
47
23
 
48
- if (isParallelWorker) {
49
- setDefaultTimeout(30_000)
50
- } else if (process.env.TYPECLAW_ALLOW_SERIAL_TESTS === '1') {
24
+ if (!isParallelWorker && process.env.TYPECLAW_ALLOW_SERIAL_TESTS === '1') {
51
25
  console.warn('[require-parallel] Running serially — TYPECLAW_ALLOW_SERIAL_TESTS=1 set.')
52
- setDefaultTimeout(30_000)
53
- } else {
26
+ } else if (!isParallelWorker) {
54
27
  console.error('')
55
28
  console.error(' ✗ `bun test` without --parallel is denied in this repo.')
56
29
  console.error('')
@@ -0,0 +1,104 @@
1
+ import { join } from 'node:path'
2
+
3
+ import { readEnvFile } from '@/init/env-file'
4
+ import { resolveExposableEnvNames } from '@/sandbox/env-exposure'
5
+ type BashEnvOverlay = Record<string, string>
6
+ const SECRET_BASH_ENV_NAMES = new Set(['GH_TOKEN', 'GITHUB_TOKEN'])
7
+ // Transport classifier for the TRUSTED hook-injected overlay only (e.g.
8
+ // github-cli-auth's per-repo GH_TOKEN). Token/secret-shaped names use `inherit`
9
+ // so their value never renders into the bwrap argv; plain names (GH_REPO) go
10
+ // via `set`. This is NOT a .env exposure filter — the overlay is populated by
11
+ // trusted runtime hooks, not operator .env.
12
+ const OVERLAY_SECRET_NAME_PATTERN = /(?:^|_)(?:TOKEN|SECRET|PASSWORD|API_KEY|PRIVATE_KEY|AUTH)$/i
13
+ function isOverlaySecretName(name: string): boolean {
14
+ return SECRET_BASH_ENV_NAMES.has(name) || OVERLAY_SECRET_NAME_PATTERN.test(name)
15
+ }
16
+
17
+ export function buildSandboxEnvPolicy(
18
+ overlay: BashEnvOverlay | undefined,
19
+ runtimeEnv: Record<string, string> | undefined,
20
+ exposableEnvNames: readonly string[] = [],
21
+ withhold: readonly string[] = [],
22
+ ): { inherit?: string[]; set?: Record<string, string>; withhold?: string[] } {
23
+ const requestedWithhold = new Set(withhold)
24
+ const overlayNames = new Set(Object.keys(overlay ?? {}))
25
+ // The overlay is a deliberate command-scoped replacement, while withholding
26
+ // only removes ambient values; an overlay therefore wins for the same name.
27
+ const effectiveWithhold = [...requestedWithhold].filter((name) => !overlayNames.has(name))
28
+ const effectiveWithholdSet = new Set(effectiveWithhold)
29
+ const set = Object.fromEntries(Object.entries(runtimeEnv ?? {}).filter(([key]) => !requestedWithhold.has(key)))
30
+ const inherit: string[] = []
31
+ const inheritSeen = new Set<string>()
32
+ const pushInherit = (key: string): void => {
33
+ if (effectiveWithholdSet.has(key) || Object.hasOwn(set, key) || inheritSeen.has(key)) return
34
+ inheritSeen.add(key)
35
+ inherit.push(key)
36
+ }
37
+ for (const [key, value] of Object.entries(overlay ?? {})) {
38
+ if (Object.hasOwn(set, key)) continue
39
+ if (isOverlaySecretName(key)) pushInherit(key)
40
+ else set[key] = value
41
+ }
42
+ // Operator-declared .env vars pass through by NAME (inherit), keeping values
43
+ // out of the rendered bwrap argv. Sandbox-integrity names were already dropped
44
+ // in resolveExposableEnvNames — these are the survivors.
45
+ for (const key of exposableEnvNames) pushInherit(key)
46
+ // Pass the entrypoint-exported Xvfb display (start_xvfb: `export DISPLAY=:99`)
47
+ // through --clearenv, else sandboxed `agent-browser --headed` dies with
48
+ // "Missing X server or $DISPLAY". Passing the runtime's OWN value (not a fixed
49
+ // ":99") keeps `docker.file.xvfb=false` advertising no display. Rendered via
50
+ // `set` (a display number is neither a credential nor shell-injectable), and no
51
+ // /tmp/.X11-unix bind is needed: Chrome reaches Xvfb over the netns-scoped
52
+ // abstract X11 socket while bash keeps network:'inherit'.
53
+ const display = process.env['DISPLAY']
54
+ if (
55
+ display !== undefined &&
56
+ display !== '' &&
57
+ !effectiveWithholdSet.has('DISPLAY') &&
58
+ !Object.hasOwn(set, 'DISPLAY') &&
59
+ !inheritSeen.has('DISPLAY')
60
+ ) {
61
+ set['DISPLAY'] = display
62
+ }
63
+ return {
64
+ ...(inherit.length > 0 ? { inherit } : {}),
65
+ ...(Object.keys(set).length > 0 ? { set } : {}),
66
+ ...(effectiveWithhold.length > 0 ? { withhold: effectiveWithhold } : {}),
67
+ }
68
+ }
69
+
70
+ export function spreadSandboxEnv(policy: ReturnType<typeof buildSandboxEnvPolicy>): {
71
+ env?: ReturnType<typeof buildSandboxEnvPolicy>
72
+ } {
73
+ return Object.keys(policy).length > 0 ? { env: policy } : {}
74
+ }
75
+
76
+ export function resolveExposableBashEnvNames(agentDir: string): { exposable: string[]; withheld: string[] } {
77
+ const declaredEnv = readEnvFile(agentDir)
78
+ const exposable = resolveExposableEnvNames(declaredEnv, process.env)
79
+ const exposableSet = new Set(exposable)
80
+ const withheld = [...declaredEnv]
81
+ .filter(([name, value]) => value.length > 0 && !exposableSet.has(name))
82
+ .map(([name]) => name)
83
+ return { exposable, withheld }
84
+ }
85
+
86
+ export function buildRoleScopedConfigEnv(
87
+ agentDir: string,
88
+ hiddenDirs: string[],
89
+ envOverlay: BashEnvOverlay | undefined,
90
+ ): BashEnvOverlay | undefined {
91
+ // Low-trust roles have workspace/ masked. Do not let container-global config
92
+ // env vars point CLIs back at that private surface: apps that honor XDG should
93
+ // still run, but their config must land in the sandbox's per-session /tmp.
94
+ // Trusted/owner have only the unconditional credential-dir masks, not the
95
+ // workspace root mask, so their command broker decides whether to set GWS.
96
+ const workspaceHidden = hiddenDirs.includes(join(agentDir, 'workspace'))
97
+ if (!workspaceHidden) return envOverlay
98
+
99
+ return {
100
+ ...envOverlay,
101
+ XDG_CONFIG_HOME: '/tmp/.config',
102
+ GWS_CONFIG_HOME: '/tmp/.config/gws',
103
+ }
104
+ }
@@ -0,0 +1,70 @@
1
+ import { config } from '@/config/config'
2
+ import { canMountRealProc, getProcBindSafetyVerdict, resolveProcBindSafetyWithRetry } from '@/sandbox'
3
+ // Picks the /proc strategy for a sandboxed bash call. The branch order is:
4
+ // 'real-proc' ONLY when the operator explicitly opted in (sandbox.realProc) AND
5
+ // the kernel permits the mount (canMountRealProc) — it adds PID isolation but
6
+ // needs CAP_SYS_ADMIN (unshare --mount-proc), so it is a deliberate, narrow
7
+ // opt-in; else 'proc-bind' (--ro-bind /proc, NO CAP_SYS_ADMIN) when its userns
8
+ // leak-block is verified safe; else 'tmpfs'. Because sandbox.realProc DEFAULTS
9
+ // FALSE, the first branch is normally skipped and proc-bind is the de-facto
10
+ // default — which is the point: the common path needs no broad outer capability.
11
+ // 'tmpfs' is the last-resort degraded mode where external packages can't run;
12
+ // reached only when proc-bind is DEFINITIVELY unavailable (a real cross-userns
13
+ // environ leak → fail closed) or its safety stays unverifiable after retries.
14
+ //
15
+ // Read from the boot-time `config` snapshot, NOT live getConfig(): sandbox is
16
+ // restart-required, and the strategy MUST track the boot-time CAP_SYS_ADMIN
17
+ // grant. A `typeclaw reload` flipping realProc would otherwise emit `unshare
18
+ // --mount-proc` in a container booted WITHOUT the cap (or vice versa). Both
19
+ // probes are cached process-globally, so this resolves to one spawn per
20
+ // container lifetime regardless of how many bash calls hit it.
21
+ // A tmpfs degrade carries WHY it happened so the caller can pick a permanent vs
22
+ // retryable error. 'definitive': the probe returned a real cross-userns leak
23
+ // ('unsafe') — the ONLY verdict proven permanent, so it fails closed for good.
24
+ // 'unverified': the safety probe never reached a definitive verdict within its
25
+ // retry budget. That covers BOTH a transient load spike AND a durable
26
+ // incapability (no usable namespaces, a bwrap that starts but cannot set up its
27
+ // sandbox): the probe cannot prove a NEGATIVE capability — only a leak is
28
+ // definitive — so a genuinely incapable host also lands here and simply keeps
29
+ // re-degrading on each call. Since 'inconclusive' is never cached, that costs a
30
+ // re-probe but is correct: the only false case is "capable but briefly
31
+ // saturated", which recovers; an incapable host stays degraded either way.
32
+ // Absent when the strategy is not tmpfs.
33
+ export type ProcStrategyResolution =
34
+ | { strategy: 'real-proc' | 'proc-bind'; degradeReason?: undefined }
35
+ | { strategy: 'tmpfs'; degradeReason: 'definitive' | 'unverified' }
36
+
37
+ export async function resolveProcStrategy(): Promise<ProcStrategyResolution> {
38
+ if (config.sandbox.realProc && (await canMountRealProc())) return { strategy: 'real-proc' }
39
+ // Retry an 'inconclusive' proc-bind probe (transient under load) before
40
+ // degrading — a single such hiccup must not break external-package runs on a
41
+ // capable host. 'unsafe' still fails closed with no retry.
42
+ const verdict = await resolveProcBindSafetyWithRetry(
43
+ () => getProcBindSafetyVerdict(),
44
+ (ms) => Bun.sleep(ms),
45
+ )
46
+ if (verdict === 'safe') return { strategy: 'proc-bind' }
47
+ // Degraded last resort: no working /proc strategy. External package runners
48
+ // (bunx/bun run <pkg-bin>) will fail with Bun's opaque "NotDir" because
49
+ // /proc/self/{fd,maps} are absent. Only a proven 'unsafe' (a real cross-userns
50
+ // leak) is DEFINITIVE — warn once (a real operator-facing limit). An
51
+ // 'inconclusive' is reported as retryable upstream and NOT warned (it would cry
52
+ // wolf every boot storm); a durably-incapable host re-degrades quietly here,
53
+ // since the probe cannot distinguish it from transient load.
54
+ if (verdict === 'unsafe') {
55
+ warnTmpfsProcFallbackOnce()
56
+ return { strategy: 'tmpfs', degradeReason: 'definitive' }
57
+ }
58
+ return { strategy: 'tmpfs', degradeReason: 'unverified' }
59
+ }
60
+
61
+ let tmpfsProcFallbackWarned = false
62
+ function warnTmpfsProcFallbackOnce(): void {
63
+ if (tmpfsProcFallbackWarned) return
64
+ tmpfsProcFallbackWarned = true
65
+ console.warn(
66
+ '[sandbox] degraded /proc mode: neither real-proc nor proc-bind is available on this host, ' +
67
+ 'so sandboxed external package runners (bunx / bun run <pkg-bin>) will fail. ' +
68
+ 'This needs a runtime with working user namespaces.',
69
+ )
70
+ }
@@ -0,0 +1,225 @@
1
+ import { join } from 'node:path'
2
+
3
+ import { config, getSandboxWritablePathSpecs } from '@/config/config'
4
+ import type { PermissionService } from '@/permissions/permissions'
5
+ import {
6
+ buildSandboxedCommand,
7
+ canWriteAgentRootInSandbox,
8
+ cleanupPrivilegedSandboxRuntime,
9
+ commandNeedsRealProc,
10
+ DEFAULT_SANDBOX_ENV,
11
+ DEPENDENCY_BIN_SANDBOX_DIR,
12
+ ensureBwrapAvailable,
13
+ ensureHiddenMaskTargets,
14
+ ensureSessionTmpDir,
15
+ reconcileDependencyBinWrappers,
16
+ resolveHiddenPaths,
17
+ resolvePrivilegedSandboxRuntime,
18
+ resolveProcSelfExe,
19
+ resolveProtectedZones,
20
+ resolveSandboxSymlinks,
21
+ resolveWritableZones,
22
+ SandboxDegradedProcError,
23
+ SandboxProcProbeUnverifiedError,
24
+ subtractMasked,
25
+ verifyHiddenMaskTargets,
26
+ verifyPrivilegedSandboxRuntime,
27
+ type SandboxMount,
28
+ type SandboxNetwork,
29
+ type SandboxPolicy,
30
+ type DependencyBinReconciliation,
31
+ } from '@/sandbox'
32
+ import { resolveDevSourceMount } from '@/sandbox/dev-source'
33
+
34
+ import {
35
+ buildRoleScopedConfigEnv,
36
+ buildSandboxEnvPolicy,
37
+ resolveExposableBashEnvNames,
38
+ spreadSandboxEnv,
39
+ } from './bash-sandbox-env'
40
+ import { resolveProcStrategy, type ProcStrategyResolution } from './bash-sandbox-proc'
41
+ import type { SessionOrigin } from './session-origin'
42
+ export type DeferredBashPreparationResult = {
43
+ command: string
44
+ env?: Record<string, string>
45
+ mount: Extract<SandboxMount, { type: 'ro-bind' }>
46
+ cleanup: () => Promise<void>
47
+ }
48
+ export type DeferredBashPreparation = () => Promise<DeferredBashPreparationResult>
49
+ export type BashSandboxBoundary = {
50
+ ensureAvailable: () => Promise<void>
51
+ buildCommand: typeof buildSandboxedCommand
52
+ resolveProcStrategy?: () => Promise<ProcStrategyResolution>
53
+ resolveRuntime?: typeof resolvePrivilegedSandboxRuntime
54
+ verifyRuntime?: typeof verifyPrivilegedSandboxRuntime
55
+ cleanupRuntime?: typeof cleanupPrivilegedSandboxRuntime
56
+ }
57
+
58
+ const DEFAULT_BASH_SANDBOX_BOUNDARY: BashSandboxBoundary = {
59
+ ensureAvailable: ensureBwrapAvailable,
60
+ buildCommand: buildSandboxedCommand,
61
+ }
62
+
63
+ type BashFilesystemPolicyOptions = {
64
+ agentDir: string
65
+ canWriteAgentRoot: boolean
66
+ masks: { dirs: string[]; files: string[] }
67
+ writable: { dirs: string[]; files: string[] }
68
+ protected: { dirs: string[]; files: string[] }
69
+ }
70
+
71
+ export type PreparedBashSandbox = {
72
+ commandString: string
73
+ policy: SandboxPolicy
74
+ verify: () => Promise<void>
75
+ cleanup: () => Promise<void>
76
+ spawnEnv: Record<string, string>
77
+ dependencyBins?: DependencyBinReconciliation
78
+ withheld: {
79
+ paths: { dirs: string[]; files: string[] }
80
+ envNames: string[]
81
+ }
82
+ }
83
+
84
+ export function buildBashFilesystemPolicy(options: BashFilesystemPolicyOptions) {
85
+ const { agentDir, canWriteAgentRoot, masks, writable, protected: protectedZones } = options
86
+ if (canWriteAgentRoot) {
87
+ return { writableRoot: { dir: agentDir }, masks, protected: protectedZones }
88
+ }
89
+ return { masks, writable, protected: protectedZones }
90
+ }
91
+
92
+ export type BashSandboxRequest = {
93
+ readonly command: string
94
+ readonly permissions: PermissionService
95
+ readonly origin: SessionOrigin | undefined
96
+ readonly agentDir: string
97
+ readonly sessionId: string
98
+ readonly envOverlay?: Record<string, string>
99
+ readonly envWithhold?: string[]
100
+ readonly deferredPreparation?: DeferredBashPreparation
101
+ readonly boundary?: BashSandboxBoundary
102
+ readonly network?: SandboxNetwork
103
+ }
104
+
105
+ // Shared preparation for model bash and eval. The caller owns verification
106
+ // immediately before spawn and cleanup after the process has exited.
107
+ export async function prepareBashSandbox(options: BashSandboxRequest): Promise<PreparedBashSandbox> {
108
+ const {
109
+ command: originalCommand,
110
+ permissions,
111
+ origin,
112
+ agentDir,
113
+ sessionId,
114
+ envOverlay,
115
+ envWithhold,
116
+ deferredPreparation,
117
+ } = options
118
+ const boundary = options.boundary ?? DEFAULT_BASH_SANDBOX_BOUNDARY
119
+ let preparation: DeferredBashPreparationResult | undefined
120
+ let privilegedRuntime: Awaited<ReturnType<typeof resolvePrivilegedSandboxRuntime>> | undefined
121
+ const cleanup = async (): Promise<void> => {
122
+ const tasks: Promise<void>[] = []
123
+ if (privilegedRuntime !== undefined) {
124
+ tasks.push((boundary.cleanupRuntime ?? cleanupPrivilegedSandboxRuntime)(privilegedRuntime))
125
+ }
126
+ if (preparation !== undefined) tasks.push(preparation.cleanup())
127
+ const outcomes = await Promise.allSettled(tasks)
128
+ const failure = outcomes.find((outcome) => outcome.status === 'rejected')
129
+ if (failure?.status === 'rejected') throw failure.reason
130
+ }
131
+ try {
132
+ preparation = await deferredPreparation?.()
133
+ const command = preparation?.command ?? originalCommand
134
+ const preparedEnvOverlay = preparation?.env === undefined ? envOverlay : { ...envOverlay, ...preparation.env }
135
+ const { dirs, files } = resolveHiddenPaths(permissions, origin, agentDir)
136
+ const envNames = resolveExposableBashEnvNames(agentDir)
137
+ const sandboxEnvOverlay = buildRoleScopedConfigEnv(agentDir, dirs, preparedEnvOverlay)
138
+ const effectiveEnvWithhold = (envWithhold ?? []).filter((name) => !Object.hasOwn(sandboxEnvOverlay ?? {}, name))
139
+ const maskTargets = await ensureHiddenMaskTargets({ dirs, files })
140
+ await boundary.ensureAvailable()
141
+ const sessionTmp = await ensureSessionTmpDir(sessionId)
142
+ const dependencyBins = await reconcileDependencyBinWrappers({ agentDir, sessionTmp })
143
+ const writable = subtractMasked(await resolveWritableZones(agentDir, getSandboxWritablePathSpecs(config)), {
144
+ dirs,
145
+ files,
146
+ })
147
+ const writableRoot = canWriteAgentRootInSandbox(permissions, origin)
148
+ const baseProtectedZones =
149
+ writableRoot || writable.dirs.includes(join(agentDir, '.git'))
150
+ ? subtractMasked(await resolveProtectedZones(agentDir), { dirs, files })
151
+ : { dirs: [], files: [] }
152
+ const protectedZones = {
153
+ dirs: baseProtectedZones.dirs,
154
+ files: [...new Set([...baseProtectedZones.files, ...dependencyBins.protectedFiles])],
155
+ }
156
+ const writableDirSet = new Set(writable.dirs)
157
+ const sandboxHome = DEFAULT_SANDBOX_ENV.HOME ?? '/tmp'
158
+ const symlinks = resolveSandboxSymlinks(agentDir, config.sandbox.symlinks, sandboxHome).filter((op) =>
159
+ writableDirSet.has(op.target),
160
+ )
161
+ const { strategy: proc, degradeReason } = await (boundary.resolveProcStrategy ?? resolveProcStrategy)()
162
+ if (proc === 'tmpfs' && commandNeedsRealProc(command)) {
163
+ throw degradeReason === 'unverified' ? new SandboxProcProbeUnverifiedError() : new SandboxDegradedProcError()
164
+ }
165
+ privilegedRuntime = await (boundary.resolveRuntime ?? resolvePrivilegedSandboxRuntime)({
166
+ agentDir,
167
+ command,
168
+ env: sandboxEnvOverlay,
169
+ })
170
+ await verifyHiddenMaskTargets(maskTargets)
171
+ const devSourceMount = await resolveDevSourceMount(agentDir)
172
+ const policy: SandboxPolicy = {
173
+ mounts: [
174
+ { type: 'ro-bind', source: agentDir, dest: agentDir },
175
+ { type: 'bind', source: sessionTmp, dest: '/tmp' },
176
+ // `/tmp` is writable, but PATH entries must remain runtime-owned for
177
+ // the lifetime of this command. Last-op-wins makes this narrow re-bind
178
+ // read-only without adding any broader filesystem exposure.
179
+ { type: 'ro-bind', source: dependencyBins.wrapperDir, dest: DEPENDENCY_BIN_SANDBOX_DIR },
180
+ // The running Bun ELF is runtime-owned, not a model-selected path.
181
+ // Dev/CI installations may place it outside /usr; expose only the
182
+ // executable, never its parent directory, under every proc strategy.
183
+ { type: 'ro-bind', source: process.execPath, dest: process.execPath },
184
+ ...(devSourceMount === undefined ? [] : [devSourceMount]),
185
+ ...(privilegedRuntime?.mounts ?? []),
186
+ ...(preparation === undefined ? [] : [preparation.mount]),
187
+ ],
188
+ ...buildBashFilesystemPolicy({
189
+ agentDir,
190
+ canWriteAgentRoot: writableRoot,
191
+ masks: maskTargets,
192
+ writable,
193
+ protected: protectedZones,
194
+ }),
195
+ symlinks,
196
+ network: options.network ?? 'inherit',
197
+ cwd: agentDir,
198
+ proc,
199
+ procSelfExe: resolveProcSelfExe(),
200
+ ...spreadSandboxEnv(
201
+ buildSandboxEnvPolicy(sandboxEnvOverlay, privilegedRuntime?.env, envNames.exposable, envWithhold),
202
+ ),
203
+ }
204
+ const { commandString, spawnEnv } = boundary.buildCommand(command, policy)
205
+ // The overlay carries command-scoped secret VALUES (e.g. a per-repo GH_TOKEN)
206
+ // that live in neither process.env nor argv; resolveSpawnEnv snapshots
207
+ // inherited names from process.env only, so merge the overlay values in here
208
+ // to complete the exact bwrap-parent env.
209
+ const mergedSpawnEnv =
210
+ spawnEnv !== undefined && sandboxEnvOverlay !== undefined ? { ...spawnEnv, ...sandboxEnvOverlay } : spawnEnv
211
+ const runtimeForResult = privilegedRuntime
212
+ return {
213
+ commandString,
214
+ policy,
215
+ verify: async () => (boundary.verifyRuntime ?? verifyPrivilegedSandboxRuntime)(runtimeForResult),
216
+ cleanup,
217
+ spawnEnv: mergedSpawnEnv,
218
+ dependencyBins,
219
+ withheld: { paths: maskTargets, envNames: [...new Set([...envNames.withheld, ...effectiveEnvWithhold])] },
220
+ }
221
+ } catch (error) {
222
+ await cleanup()
223
+ throw error
224
+ }
225
+ }