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,231 @@
1
+ import { timingSafeEqual } from 'node:crypto'
2
+ import { connect, createServer, type Server, type Socket } from 'node:net'
3
+
4
+ // The managed Chrome runs in a network-isolated sandbox, so its DevTools port
5
+ // is unreachable from model bash. This relay is the only path in: a loopback
6
+ // TCP listener that admits a connection only when its first HTTP request
7
+ // carries the session token, then forwards it to Chrome's DevTools socket.
8
+ // The token reaches bash only for roles holding `browser.shared`, so a
9
+ // lower-privilege session cannot drive pages another role is logged into.
10
+
11
+ const MAX_HEAD_BYTES = 64 * 1024
12
+ const BROWSER_PATH = /^\/devtools\/browser\/[^/?#]*/
13
+
14
+ export type CdpRelayOptions = {
15
+ token: string
16
+ // Unix socket bridged to Chrome's private DevTools port.
17
+ upstreamSocket: string
18
+ host?: string
19
+ port?: number
20
+ }
21
+
22
+ export type CdpRelay = {
23
+ port: number
24
+ close: () => Promise<void>
25
+ }
26
+
27
+ export async function startCdpRelay(options: CdpRelayOptions): Promise<CdpRelay> {
28
+ const host = options.host ?? '127.0.0.1'
29
+ const server = createServer((client) => handleClient(client, options, host, server))
30
+ await new Promise<void>((resolve, reject) => {
31
+ server.once('error', reject)
32
+ server.listen(options.port ?? 0, host, () => resolve())
33
+ })
34
+ const address = server.address()
35
+ if (address === null || typeof address === 'string') throw new Error('CDP relay did not bind a TCP port')
36
+ return { port: address.port, close: () => closeServer(server) }
37
+ }
38
+
39
+ export function cdpWebSocketUrl(port: number, token: string): string {
40
+ return `ws://127.0.0.1:${port}/devtools/browser/typeclaw?token=${encodeURIComponent(token)}`
41
+ }
42
+
43
+ function handleClient(client: Socket, options: CdpRelayOptions, host: string, server: Server): void {
44
+ let buffered = Buffer.alloc(0)
45
+ const onData = (chunk: Buffer): void => {
46
+ buffered = Buffer.concat([buffered, chunk])
47
+ const headEnd = buffered.indexOf('\r\n\r\n')
48
+ if (headEnd === -1) {
49
+ if (buffered.length > MAX_HEAD_BYTES) client.destroy()
50
+ return
51
+ }
52
+ client.off('data', onData)
53
+ client.pause()
54
+ const head = buffered.subarray(0, headEnd).toString('latin1')
55
+ const rest = buffered.subarray(headEnd + 4)
56
+ const request = parseHead(head)
57
+ if (request === null || !tokenMatches(request.token, options.token)) {
58
+ client.end('HTTP/1.1 401 Unauthorized\r\nContent-Length: 0\r\nConnection: close\r\n\r\n')
59
+ return
60
+ }
61
+ const relayPort = (server.address() as { port: number }).port
62
+ if (request.isUpgrade) {
63
+ pipeUpgrade(client, options.upstreamSocket, request, rest)
64
+ } else {
65
+ void answerDiscovery(client, options, request.path, `${host}:${relayPort}`)
66
+ }
67
+ }
68
+ client.on('data', onData)
69
+ client.on('error', () => client.destroy())
70
+ }
71
+
72
+ type ParsedHead = {
73
+ method: string
74
+ path: string
75
+ token: string | undefined
76
+ isUpgrade: boolean
77
+ headerLines: string[]
78
+ }
79
+
80
+ function parseHead(head: string): ParsedHead | null {
81
+ const [requestLine, ...headerLines] = head.split('\r\n')
82
+ const match = /^([A-Z]+) (\S+) HTTP\/1\.[01]$/.exec(requestLine ?? '')
83
+ if (match === null) return null
84
+ let url: URL
85
+ try {
86
+ url = new URL(match[2]!, 'http://relay.invalid')
87
+ } catch {
88
+ return null
89
+ }
90
+ const queryToken = url.searchParams.get('token') ?? undefined
91
+ url.searchParams.delete('token')
92
+ const authorization = headerLines
93
+ .find((line) => line.toLowerCase().startsWith('authorization:'))
94
+ ?.slice('authorization:'.length)
95
+ .trim()
96
+ const headerToken = authorization?.toLowerCase().startsWith('bearer ') ? authorization.slice(7).trim() : undefined
97
+ const isUpgrade = headerLines.some((line) => /^upgrade:\s*websocket\s*$/i.test(line))
98
+ return {
99
+ method: match[1]!,
100
+ path: `${url.pathname}${url.search}`,
101
+ token: queryToken ?? headerToken,
102
+ isUpgrade,
103
+ headerLines: headerLines.filter((line) => !line.toLowerCase().startsWith('authorization:')),
104
+ }
105
+ }
106
+
107
+ function tokenMatches(candidate: string | undefined, expected: string): boolean {
108
+ if (candidate === undefined) return false
109
+ const a = Buffer.from(candidate)
110
+ const b = Buffer.from(expected)
111
+ return a.length === b.length && timingSafeEqual(a, b)
112
+ }
113
+
114
+ // Chrome's browser target id changes on every launch, so clients connect to a
115
+ // stable `/devtools/browser/<anything>` path and the relay substitutes the
116
+ // live id discovered from Chrome itself.
117
+ function pipeUpgrade(client: Socket, upstreamSocket: string, request: ParsedHead, rest: Buffer): void {
118
+ void resolveBrowserPath(upstreamSocket, request.path).then(
119
+ (path) => {
120
+ const upstream = connect(upstreamSocket)
121
+ upstream.on('connect', () => {
122
+ upstream.write(`${request.method} ${path} HTTP/1.1\r\n${request.headerLines.join('\r\n')}\r\n\r\n`)
123
+ if (rest.length > 0) upstream.write(rest)
124
+ client.pipe(upstream)
125
+ upstream.pipe(client)
126
+ client.resume()
127
+ })
128
+ upstream.on('error', () => client.destroy())
129
+ upstream.on('close', () => client.destroy())
130
+ client.on('close', () => upstream.destroy())
131
+ },
132
+ () => client.end('HTTP/1.1 502 Bad Gateway\r\nContent-Length: 0\r\nConnection: close\r\n\r\n'),
133
+ )
134
+ }
135
+
136
+ async function resolveBrowserPath(upstreamSocket: string, path: string): Promise<string> {
137
+ if (!BROWSER_PATH.test(path)) return path
138
+ const version = (await fetchUpstreamJson(upstreamSocket, '/json/version')) as { webSocketDebuggerUrl?: string }
139
+ const live = version.webSocketDebuggerUrl === undefined ? undefined : new URL(version.webSocketDebuggerUrl).pathname
140
+ if (live === undefined) throw new Error('Chrome did not report a browser target')
141
+ return path.replace(BROWSER_PATH, live)
142
+ }
143
+
144
+ // `/json/*` answers embed Chrome's private `127.0.0.1:9222`; rewrite them to
145
+ // the relay (with the token) so a client that discovers over HTTP reconnects
146
+ // through the relay instead of to an address it cannot reach.
147
+ async function answerDiscovery(client: Socket, options: CdpRelayOptions, path: string, relayHost: string) {
148
+ try {
149
+ const body = await fetchUpstreamText(options.upstreamSocket, path)
150
+ const rewritten = body.replace(
151
+ /ws:\/\/[^/"]+(\/devtools\/[^"]+)/g,
152
+ (_all, devtoolsPath: string) => `ws://${relayHost}${devtoolsPath}?token=${encodeURIComponent(options.token)}`,
153
+ )
154
+ const bytes = Buffer.from(rewritten)
155
+ client.write(
156
+ `HTTP/1.1 200 OK\r\nContent-Type: application/json; charset=UTF-8\r\nContent-Length: ${bytes.length}\r\nConnection: close\r\n\r\n`,
157
+ )
158
+ client.end(bytes)
159
+ } catch {
160
+ client.end('HTTP/1.1 502 Bad Gateway\r\nContent-Length: 0\r\nConnection: close\r\n\r\n')
161
+ }
162
+ }
163
+
164
+ async function fetchUpstreamJson(upstreamSocket: string, path: string): Promise<unknown> {
165
+ return JSON.parse(await fetchUpstreamText(upstreamSocket, path)) as unknown
166
+ }
167
+
168
+ async function fetchUpstreamText(upstreamSocket: string, path: string): Promise<string> {
169
+ const response = await fetch(`http://127.0.0.1${path}`, { unix: upstreamSocket } as RequestInit)
170
+ if (!response.ok) throw new Error(`DevTools answered ${response.status} for ${path}`)
171
+ return response.text()
172
+ }
173
+
174
+ // Token-gated raw byte relay for the BrowserSkill daemon socket: the client
175
+ // sends the token and a newline, then speaks the daemon's own protocol. A
176
+ // `<token> describe` line instead returns `describe()` (the daemon's
177
+ // daemon.json, which the CLI cross-checks against the IPC daemon's pid).
178
+ export async function startTokenStreamRelay(options: {
179
+ token: string
180
+ upstreamSocket: string
181
+ describe?: () => Promise<string>
182
+ }): Promise<CdpRelay> {
183
+ const server = createServer((client) => {
184
+ let buffered = Buffer.alloc(0)
185
+ const onData = (chunk: Buffer): void => {
186
+ buffered = Buffer.concat([buffered, chunk])
187
+ const newline = buffered.indexOf('\n')
188
+ if (newline === -1) {
189
+ if (buffered.length > 1024) client.destroy()
190
+ return
191
+ }
192
+ client.off('data', onData)
193
+ client.pause()
194
+ const [candidate, verb] = buffered.subarray(0, newline).toString('latin1').split(' ')
195
+ if (!tokenMatches(candidate, options.token)) {
196
+ client.destroy()
197
+ return
198
+ }
199
+ if (verb === 'describe' && options.describe !== undefined) {
200
+ options.describe().then(
201
+ (text) => client.end(text),
202
+ () => client.destroy(),
203
+ )
204
+ return
205
+ }
206
+ const upstream = connect(options.upstreamSocket)
207
+ upstream.on('connect', () => {
208
+ const rest = buffered.subarray(newline + 1)
209
+ if (rest.length > 0) upstream.write(rest)
210
+ client.pipe(upstream)
211
+ upstream.pipe(client)
212
+ client.resume()
213
+ })
214
+ upstream.on('error', () => client.destroy())
215
+ upstream.on('close', () => client.destroy())
216
+ client.on('close', () => upstream.destroy())
217
+ }
218
+ client.on('data', onData)
219
+ client.on('error', () => client.destroy())
220
+ })
221
+ await new Promise<void>((resolve, reject) => {
222
+ server.once('error', reject)
223
+ server.listen(0, '127.0.0.1', () => resolve())
224
+ })
225
+ const address = server.address() as { port: number }
226
+ return { port: address.port, close: () => closeServer(server) }
227
+ }
228
+
229
+ function closeServer(server: Server): Promise<void> {
230
+ return new Promise((resolve) => server.close(() => resolve()))
231
+ }
@@ -0,0 +1,167 @@
1
+ import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises'
2
+ import { connect, createServer, type Socket } from 'node:net'
3
+ import { join } from 'node:path'
4
+
5
+ import { BSK_BIN, BSK_DAEMON_PORT } from './registry'
6
+
7
+ // Runs INSIDE the browser's bwrap sandbox, which has no network namespace of
8
+ // its own beyond loopback and no view of /agent outside the browser files
9
+ // directory. It bridges two filesystem sockets (which cross network
10
+ // namespaces) to the private loopback: egress for Chrome's SOCKS proxy, and the
11
+ // DevTools socket the runtime's token relay dials. Exits when Chrome exits so
12
+ // the runtime supervisor restarts the whole set.
13
+
14
+ export type SandboxEntryConfig = {
15
+ chrome: string
16
+ runDir: string
17
+ profileDir: string
18
+ downloadsDir: string
19
+ extensionDirs: string[]
20
+ // Without an X display (docker.file.xvfb off) Chrome must run headless or it exits at startup.
21
+ headless: boolean
22
+ bsk?: { home: string }
23
+ }
24
+
25
+ const SOCKS_PORT = 1080
26
+ const DEVTOOLS_PORT = 9222
27
+
28
+ export function egressSocket(runDir: string): string {
29
+ return join(runDir, 'egress.sock')
30
+ }
31
+
32
+ export function devtoolsSocket(runDir: string): string {
33
+ return join(runDir, 'devtools.sock')
34
+ }
35
+
36
+ export function chromeArgs(config: SandboxEntryConfig): string[] {
37
+ const args = [
38
+ `--remote-debugging-port=${DEVTOOLS_PORT}`,
39
+ '--remote-debugging-address=127.0.0.1',
40
+ `--user-data-dir=${config.profileDir}`,
41
+ `--proxy-server=socks5://127.0.0.1:${SOCKS_PORT}`,
42
+ // Chromium sends loopback direct by default, which here is the sandbox's own
43
+ // empty loopback; route it through the bridge so container dev servers load.
44
+ // The BrowserSkill daemon is the one service that lives on sandbox loopback.
45
+ `--proxy-bypass-list=<-loopback>;127.0.0.1:${BSK_DAEMON_PORT}`,
46
+ '--no-first-run',
47
+ '--no-default-browser-check',
48
+ '--disable-dev-shm-usage',
49
+ '--window-size=1920,1080',
50
+ ]
51
+ if (config.headless) args.push('--headless=new')
52
+ if (config.extensionDirs.length > 0) {
53
+ const list = config.extensionDirs.join(',')
54
+ args.push(`--load-extension=${list}`, `--disable-extensions-except=${list}`)
55
+ }
56
+ args.push('about:blank')
57
+ return args
58
+ }
59
+
60
+ async function main(config: SandboxEntryConfig): Promise<void> {
61
+ await clearSingletonLocks(config.profileDir)
62
+ await writeDownloadPreference(config)
63
+ await rm(devtoolsSocket(config.runDir), { force: true })
64
+ const servers = [
65
+ bridge(`127.0.0.1:${SOCKS_PORT}`, () => connect(egressSocket(config.runDir)), { port: SOCKS_PORT }),
66
+ bridge(devtoolsSocket(config.runDir), () => connect({ host: '127.0.0.1', port: DEVTOOLS_PORT }), {
67
+ path: devtoolsSocket(config.runDir),
68
+ }),
69
+ ]
70
+ await Promise.all(servers.map((s) => s.listening))
71
+
72
+ const chrome = Bun.spawn([config.chrome, ...chromeArgs(config)], { stdout: 'ignore', stderr: 'ignore' })
73
+ const bsk =
74
+ config.bsk === undefined
75
+ ? undefined
76
+ : Bun.spawn([BSK_BIN, 'daemon', 'start', '--foreground'], {
77
+ env: { ...process.env, BSK_HOME: config.bsk.home, BSK_AUTO_START: '0' },
78
+ stdout: 'ignore',
79
+ stderr: 'ignore',
80
+ })
81
+ const code = await chrome.exited
82
+ bsk?.kill()
83
+ process.exit(code)
84
+ }
85
+
86
+ function bridge(
87
+ label: string,
88
+ dial: () => Socket,
89
+ listen: { port: number } | { path: string },
90
+ ): { listening: Promise<void> } {
91
+ const server = createServer((inbound) => {
92
+ const outbound = dial()
93
+ inbound.pipe(outbound)
94
+ outbound.pipe(inbound)
95
+ const close = (): void => {
96
+ inbound.destroy()
97
+ outbound.destroy()
98
+ }
99
+ inbound.on('error', close)
100
+ outbound.on('error', close)
101
+ inbound.on('close', close)
102
+ outbound.on('close', close)
103
+ })
104
+ const listening = new Promise<void>((resolve, reject) => {
105
+ server.once('error', (error) => reject(new Error(`${label}: ${String(error)}`)))
106
+ if ('port' in listen) server.listen(listen.port, '127.0.0.1', () => resolve())
107
+ else server.listen(listen.path, () => resolve())
108
+ })
109
+ return { listening }
110
+ }
111
+
112
+ // Downloads land in the browser files directory, which privileged bash sees at
113
+ // the same path; Chrome's default ~/Downloads would be lost on the sandbox tmpfs.
114
+ // Merged into the persisted Preferences so the rest of the profile's settings survive.
115
+ export async function writeDownloadPreference(config: SandboxEntryConfig): Promise<void> {
116
+ const defaultProfile = join(config.profileDir, 'Default')
117
+ await mkdir(defaultProfile, { recursive: true })
118
+ await mkdir(config.downloadsDir, { recursive: true })
119
+ const file = join(defaultProfile, 'Preferences')
120
+ const existing = await readPreferences(file)
121
+ const preferences = {
122
+ ...existing,
123
+ download: { ...asRecord(existing['download']), default_directory: config.downloadsDir, prompt_for_download: false },
124
+ savefile: { ...asRecord(existing['savefile']), default_directory: config.downloadsDir },
125
+ }
126
+ // Same-directory temp + rename: an interrupted boot never leaves a truncated file.
127
+ const temp = `${file}.typeclaw-tmp`
128
+ await writeFile(temp, JSON.stringify(preferences))
129
+ await rename(temp, file)
130
+ }
131
+
132
+ // A malformed file must not keep Chrome down on every boot: set it aside for
133
+ // diagnosis and start from empty preferences.
134
+ async function readPreferences(file: string): Promise<Record<string, unknown>> {
135
+ let text: string
136
+ try {
137
+ text = await readFile(file, 'utf8')
138
+ } catch {
139
+ return {}
140
+ }
141
+ try {
142
+ const parsed: unknown = JSON.parse(text)
143
+ if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed))
144
+ return parsed as Record<string, unknown>
145
+ } catch {
146
+ // fall through to quarantine
147
+ }
148
+ await rename(file, `${file}.corrupt-${Date.now()}`).catch(() => {})
149
+ return {}
150
+ }
151
+
152
+ // The profile outlives the container, and Chrome refuses a profile whose lock
153
+ // names another host (every container has a new hostname). Whatever Chrome held
154
+ // it before has exited, since this entry only runs after the previous one did.
155
+ export async function clearSingletonLocks(profileDir: string): Promise<void> {
156
+ await Promise.all(
157
+ ['SingletonLock', 'SingletonSocket', 'SingletonCookie'].map((name) => rm(join(profileDir, name), { force: true })),
158
+ )
159
+ }
160
+
161
+ function asRecord(value: unknown): Record<string, unknown> {
162
+ return value !== null && typeof value === 'object' ? (value as Record<string, unknown>) : {}
163
+ }
164
+
165
+ if (import.meta.main) {
166
+ await main(JSON.parse(process.argv[2] ?? '{}') as SandboxEntryConfig)
167
+ }
@@ -1,5 +1,6 @@
1
1
  import { join } from 'node:path'
2
2
 
3
+ import { getConfig } from '@/config'
3
4
  import { definePlugin } from '@/plugin'
4
5
  import { publishForwardRequest, subscribeForwardResult } from '@/portbroker'
5
6
 
@@ -23,6 +24,7 @@ let unsubscribeForwardResult: (() => void) | null = null
23
24
 
24
25
  export default definePlugin({
25
26
  plugin: async (ctx) => {
27
+ if (!getConfig().browser.engines.includes('agent-browser')) return {}
26
28
  requestDashboardForward(ctx.logger)
27
29
 
28
30
  return {
@@ -38,13 +38,14 @@ If a new prompt arrives while the runner is in flight, the runner finishes its c
38
38
 
39
39
  ## What it commits
40
40
 
41
- The runner stages an explicit snapshot from NUL-delimited porcelain status:
41
+ The runner builds an explicit snapshot from NUL-delimited porcelain status:
42
42
 
43
- - **Tracked changes**, including deletions and both rename/copy endpoints, are staged even when an endpoint is no longer present on disk.
43
+ - **Tracked changes**, including deletions and both rename/copy endpoints, remain selected even when an endpoint is no longer present on disk. A selected index entry absent from both HEAD and the worktree (including a removed intent-to-add) is cleared from the index instead of committed; excluded `memory/` paths are never touched.
44
44
  - **Ordinary untracked paths** are staged only while still present. If one disappears between snapshot and `git add`, the runner re-reads status and retries that same snapshot once without the vanished path; paths discovered during that re-read are never added.
45
- - **`memory/`** remains excluded. Present **`sessions/` and `todo/`** paths remain force-added; tracked deletions under those prefixes stay in the ordinary snapshot. The post-message pass re-stages only `sessions/` paths that appeared while the message was selected.
45
+ - **Untracked nested Git repositories** — an untracked non-bare repository outside `sessions/` and `todo/`, i.e. a directory with its own `.git` file or directory such as a linked worktree or a nested clone — are skipped. Staging one would record a `160000` gitlink instead of its contents.
46
+ - **`memory/`** remains excluded. Present **`sessions/` and `todo/`** paths reported by porcelain remain force-added; tracked deletions under those prefixes stay in the ordinary snapshot. The post-message pass selects only porcelain-visible late `sessions/` paths.
46
47
 
47
- Commit message comes from the `backup-message` subagent, which sees a truncated `git status` and `git diff --cached --stat` and writes a single conventional-ish commit message to a tmp file. On any failure the runner falls back to `chore: backup`.
48
+ The runner stages the selected paths in a temporary private Git index for its diffstat, without exposing backup entries in the shared index while `backup-message` selects a message. Git then commits **only** selected paths against its current HEAD; unrelated staged files and intervening commits stay intact. A post-message status drops deletion paths already committed by another writer, and an already-clean selection returns clean rather than a false failure. Discovery of force-added paths is unchanged: gitignored untracked files omitted by porcelain status are not discovered here, while explicitly staged ignored files remain eligible. The `backup-message` subagent sees a truncated status and private-index diffstat and returns a conventional-ish subject as its final response. Trusted backup code writes that response to an ephemeral tmp file for the runner to consume; the model has no file tools. On any failure the runner falls back to `chore: backup`.
48
49
 
49
50
  ## What it pushes
50
51
 
@@ -58,7 +59,7 @@ On non-fast-forward rejection (either push shape), the runner runs `git fetch` t
58
59
 
59
60
  **Credentials.** The runner spawns `git` directly (not via the `bash` tool), so the `github-cli-auth` plugin's `tool.before` credential injection does **not** fire for it. For **GitHub App auth** the backup plugin mints a per-repo installation token for `origin`'s github.com slug and injects it into the runner's git env via the same `GIT_ASKPASS` helper the bash path uses (token in `TYPECLAW_GIT_TOKEN`, never in argv/config; ssh remotes rewritten to https via `insteadOf`). Classic/fine-grained PATs, SSH-key, and credential-helper setups are left untouched — the runner uses its inherited process env. Non-github origins are never minted for.
60
61
 
61
- If any network step fails (rebase conflict, auth failure, network timeout), the runner aborts cleanly and spawns the `backup-diagnose` subagent. That subagent has `bash`, `read`, and `write` tools and writes a short human-readable report to `<agentDir>/sessions/backup-diagnostics.log`. The diagnose subagent is explicitly forbidden from force-pushing or resolving merge conflicts itself.
62
+ If any network step fails (rebase conflict, auth failure, network timeout), the runner aborts cleanly and spawns the `backup-diagnose` subagent. That subagent has `bash` and `read` tools, returns a short human-readable diagnosis, and trusted backup code appends it to `<agentDir>/sessions/backup-diagnostics.log`. The diagnose subagent is explicitly forbidden from force-pushing or resolving merge conflicts itself.
62
63
 
63
64
  ## What it maintains
64
65
 
@@ -76,16 +77,16 @@ Because the backup force-commits `sessions/` every idle window, each cycle lands
76
77
  | Kind | Name | Notes |
77
78
  | -------- | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
78
79
  | Subagent | `backup` | Runner orchestrator. No LLM call — `handler` directly invokes the deterministic `runBackup`. Coalesced per `agentDir`. |
79
- | Subagent | `backup-message` | Picks commit message from the diff. Has only the `write` tool. Coalesced per `agentDir`. |
80
- | Subagent | `backup-diagnose` | Diagnoses push/rebase failures. Has `bash`, `read`, `write`. Coalesced per `agentDir`. |
80
+ | Subagent | `backup-message` | Picks commit message from the diff. Has no tools; trusted code stores its final response. Coalesced per `agentDir`. |
81
+ | Subagent | `backup-diagnose` | Diagnoses push/rebase failures. Has `bash` and `read`; trusted code appends its final response to the diagnostics log. Coalesced per `agentDir`. |
81
82
  | Hook | `session.turn.start` / `.end` | Maintains the active-turn counter. Excludes self-induced turns (the three subagents above) so the backup never gates against itself. |
82
83
  | Hook | `session.idle` | Debouncer (idleMs). Resets the timer on every event. On fire, checks the active-turn counter and spawns `backup` if zero. |
83
84
  | Hook | `session.end` | Removes the session from the active-turn set on session close. Defensive: if a session ends mid-turn (network drop), `session.turn.end` may not have fired. |
84
85
 
85
86
  ## Files on disk
86
87
 
87
- - **`<agentDir>/.typeclaw/backup-message.tmp`** — ephemeral. Written by `backup-message` subagent, read and then deleted by the runner. The directory is created on demand. Not gitignored because it always cleans itself up before commit.
88
- - **`<agentDir>/sessions/backup-diagnostics.log`** — append-only log written by `backup-diagnose` when push/rebase fails. Lives under `sessions/` so it gets force-added by the next successful backup. Read this file when investigating why the backup plugin stopped working.
88
+ - **`<agentDir>/.typeclaw/backup-message.tmp`** — ephemeral. Written by trusted backup code, read and then deleted by the runner. The directory is created on demand. Not gitignored because it always cleans itself up before commit.
89
+ - **`<agentDir>/sessions/backup-diagnostics.log`** — append-only log written by trusted backup code from `backup-diagnose`'s final response when push/rebase fails. Lives under `sessions/` so it gets force-added by the next successful backup. Read this file when investigating why the backup plugin stopped working.
89
90
 
90
91
  ## Why this design
91
92