typeclaw 0.49.0 → 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 (442) 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 +9 -2
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/require-parallel.ts +5 -32
  317. package/src/agent/guard-types.ts +3 -0
  318. package/src/agent/guards.ts +4 -0
  319. package/src/agent/idle-compaction.ts +174 -0
  320. package/src/agent/index.ts +74 -16
  321. package/src/agent/live-subagents.ts +19 -0
  322. package/src/agent/multimodal/look-at.ts +22 -9
  323. package/src/agent/plugin-tools.ts +13 -1
  324. package/src/agent/reviewer-bash-policy.ts +41 -1
  325. package/src/agent/session-origin.ts +26 -10
  326. package/src/agent/subagent-cache-keepalive.ts +198 -0
  327. package/src/agent/subagent-session.ts +6 -0
  328. package/src/agent/subagents.ts +46 -8
  329. package/src/agent/system-prompt.ts +1 -1
  330. package/src/agent/tool-file-safety.ts +6 -1
  331. package/src/agent/tools/channel-edit.ts +20 -10
  332. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  333. package/src/agent/tools/channel-handoff.ts +72 -0
  334. package/src/agent/tools/channel-read.ts +57 -10
  335. package/src/agent/tools/channel-reply.ts +33 -26
  336. package/src/agent/tools/channel-send.ts +21 -13
  337. package/src/agent/tools/channel-session-search.ts +35 -0
  338. package/src/agent/tools/curl-impersonate.ts +11 -4
  339. package/src/agent/tools/ddg.ts +13 -5
  340. package/src/agent/tools/spawn-subagent.ts +27 -11
  341. package/src/agent/tools/stream-snapshot.ts +15 -2
  342. package/src/agent/tools/subagent-access.ts +11 -4
  343. package/src/browser/bsk-shim.mjs +74 -0
  344. package/src/browser/dockerfile.ts +84 -0
  345. package/src/browser/egress.ts +104 -0
  346. package/src/browser/managed-browser.ts +205 -0
  347. package/src/browser/registry.ts +110 -0
  348. package/src/browser/relay.ts +231 -0
  349. package/src/browser/sandbox-entry.ts +167 -0
  350. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  351. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  352. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  353. package/src/bundled-plugins/doc-render/index.ts +0 -10
  354. package/src/bundled-plugins/doc-render/render.ts +83 -111
  355. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  356. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  357. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  358. package/src/bundled-plugins/github-cli-auth/index.ts +75 -59
  359. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  360. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  361. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  362. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  363. package/src/bundled-plugins/operator/operator.ts +1 -1
  364. package/src/bundled-plugins/qa/index.ts +11 -0
  365. package/src/bundled-plugins/qa/qa.ts +160 -0
  366. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  367. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  368. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  369. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  370. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  371. package/src/bundled-plugins/security/index.ts +53 -34
  372. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  373. package/src/channels/adapter-namespace.ts +13 -0
  374. package/src/channels/adapters/discord-bot.ts +97 -5
  375. package/src/channels/adapters/github/index.ts +16 -0
  376. package/src/channels/adapters/github/last-alive.ts +4 -16
  377. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  378. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  379. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  380. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  381. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  382. package/src/channels/adapters/slack-bot.ts +299 -67
  383. package/src/channels/adapters/slack-classify.ts +1 -0
  384. package/src/channels/catch-up.ts +137 -0
  385. package/src/channels/continuation-willingness.ts +2 -2
  386. package/src/channels/continuity-types.ts +1 -0
  387. package/src/channels/engagement.ts +17 -1
  388. package/src/channels/github-false-receipt.ts +3 -3
  389. package/src/channels/github-rereview-guard.ts +9 -5
  390. package/src/channels/github-token-bridge.ts +24 -0
  391. package/src/channels/last-alive.ts +34 -0
  392. package/src/channels/manager.ts +8 -1
  393. package/src/channels/router.ts +427 -136
  394. package/src/channels/session-handoff.fixture.ts +144 -0
  395. package/src/channels/session-handoff.ts +175 -0
  396. package/src/channels/session-search.ts +71 -0
  397. package/src/channels/types.ts +12 -2
  398. package/src/cli/channel.ts +2 -3
  399. package/src/cli/init.ts +2 -3
  400. package/src/cli/model.ts +132 -3
  401. package/src/coding-agent/index.ts +7 -1
  402. package/src/coding-agent/omo-stream.ts +40 -0
  403. package/src/coding-agent/runner.ts +30 -8
  404. package/src/config/config.ts +111 -22
  405. package/src/config/model-overrides.ts +59 -0
  406. package/src/config/models-mutation.ts +185 -2
  407. package/src/config/providers-mutation.ts +12 -4
  408. package/src/config/providers.ts +59 -0
  409. package/src/container/start.ts +95 -4
  410. package/src/doctor/checks.ts +8 -6
  411. package/src/hostd/daemon.ts +13 -1
  412. package/src/init/auto-upgrade.ts +7 -1
  413. package/src/init/dockerfile.ts +57 -12
  414. package/src/init/index.ts +4 -3
  415. package/src/init/local-source-stamp.ts +68 -0
  416. package/src/init/models-dev.ts +4 -0
  417. package/src/init/validate-api-key.ts +3 -0
  418. package/src/permissions/builtins.ts +7 -0
  419. package/src/permissions/permissions.ts +18 -9
  420. package/src/permissions/resolve.ts +7 -1
  421. package/src/plugin/context.ts +2 -0
  422. package/src/plugin/hooks.ts +137 -0
  423. package/src/plugin/index.ts +6 -0
  424. package/src/plugin/manager.ts +4 -0
  425. package/src/plugin/types.ts +60 -0
  426. package/src/run/bundled-plugins.ts +6 -0
  427. package/src/run/index.ts +24 -14
  428. package/src/run/llm-fetch-observer.ts +12 -15
  429. package/src/sandbox/canonical-secrets.ts +4 -0
  430. package/src/sandbox/dev-source.ts +26 -0
  431. package/src/sandbox/hidden-paths.ts +16 -2
  432. package/src/secrets/storage.ts +13 -0
  433. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  434. package/src/skills/typeclaw-config/SKILL.md +39 -5
  435. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  436. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  437. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  438. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  439. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  440. package/typeclaw.schema.json +436 -5
  441. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  442. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -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 {
@@ -0,0 +1,89 @@
1
+ import { join } from 'node:path'
2
+
3
+ import { z } from 'zod'
4
+
5
+ import type { BrowserEngineId, BrowserExtensionId } from '@/browser/registry'
6
+ import { bashTool, findTool, grepTool, lsTool, readTool, type Subagent, writeTool } from '@/plugin'
7
+
8
+ const BUNDLED_PLUGINS_DIR = join(import.meta.dir, '..')
9
+
10
+ export type BrowserDriverId = BrowserEngineId | BrowserExtensionId
11
+
12
+ export type BrowserDrivers = {
13
+ engines: readonly BrowserEngineId[]
14
+ extensions: readonly BrowserExtensionId[]
15
+ }
16
+
17
+ // Mirrors where agent-browser and managed-browser ship each driver's skill.
18
+ export function driverSkillPath(id: BrowserDriverId): string {
19
+ return id === 'agent-browser'
20
+ ? join(BUNDLED_PLUGINS_DIR, 'agent-browser', 'skills', 'agent-browser', 'SKILL.md')
21
+ : join(BUNDLED_PLUGINS_DIR, 'managed-browser', 'skills', id, id, 'SKILL.md')
22
+ }
23
+
24
+ export function buildBrowserSystemPrompt({ engines, extensions }: BrowserDrivers): string {
25
+ const skills = [...engines, ...extensions].map((id) => `- \`${id}\` — ${driverSkillPath(id)}`).join('\n')
26
+ return `You are a web-browsing subagent running inside TypeClaw. Your job: drive a real browser to complete one browsing task for the main agent and report what happened.
27
+
28
+ ## Your context
29
+
30
+ - The main agent delegates ALL web browsing to you so the page snapshots and screenshots stay out of its context.
31
+ - You do not talk to the user; the main agent does. Your final message is the whole report.
32
+ - You cannot spawn subagents.
33
+
34
+ ## How to browse
35
+
36
+ Before your first browser command, read the skill for the driver you will use. Enabled drivers (prefer the first unless the task says otherwise):
37
+
38
+ ${skills}
39
+
40
+ Drive the browser with \`bash\`. Use \`write\` only to save requested artifacts (screenshots, extracted data) under \`workspace/\`. Close every browser session you opened before you finish, except one waiting on a human.
41
+
42
+ If a step needs a human (login, 2FA, CAPTCHA, payment confirmation), follow the skill's human-handoff instructions (e.g. start the dashboard), leave that session open, and stop. Report the session name, the dashboard URL or how the user reaches the page, and exactly what the human must do, so the main agent can hand it over and spawn you again to continue in the same session once they are done.
43
+
44
+ ## Final report
45
+
46
+ 1. **Outcome** — succeeded / partially succeeded / failed, in one sentence.
47
+ 2. **Result** — the information or confirmation the task asked for, with the URLs it came from.
48
+ 3. **Artifacts** — absolute paths of anything you saved.
49
+ 4. **Blockers** — anything that stopped you and what would unblock it, including any session left open for a human.`
50
+ }
51
+
52
+ // `profile` is dropped, not passed through: the browsing tier is fixed (see
53
+ // createBrowserSubagent), so a parent must not move it via a per-spawn `profile`.
54
+ export const browserPayloadSchema = z
55
+ .object({
56
+ requestId: z.string().optional(),
57
+ prompt: z.string().optional(),
58
+ description: z.string().optional(),
59
+ })
60
+ .passthrough()
61
+ .transform(({ profile: _profile, ...rest }) => rest)
62
+
63
+ export type BrowserPayload = z.infer<typeof browserPayloadSchema>
64
+
65
+ // Browser flows (multi-page navigation, form fills) outlast a scout lookup;
66
+ // bound a wedged run so it never blocks the parent forever.
67
+ export const BROWSER_TIMEOUT_MS = 900_000
68
+
69
+ export function createBrowserSubagent(drivers: BrowserDrivers): Subagent<BrowserPayload> {
70
+ return {
71
+ systemPrompt: buildBrowserSystemPrompt(drivers),
72
+ // The deep model at low effort, like omo's deep-low browser lane: strong
73
+ // agentic UI handling without deliberating before every click. Without a
74
+ // configured `deep` profile this resolves to plain `default` (its own level).
75
+ profile: 'deep',
76
+ thinkingLevel: 'low',
77
+ timeoutMs: BROWSER_TIMEOUT_MS,
78
+ tools: [readTool, grepTool, findTool, lsTool, bashTool, writeTool],
79
+ payloadSchema: browserPayloadSchema,
80
+ visibility: 'public',
81
+ rosterDescription:
82
+ 'ALL web browsing — navigate, click, fill forms, log in, screenshot, scrape JS-rendered pages; deep model at low thinking (default profile if no deep); never drive a browser yourself',
83
+ inFlightKey: (payload) => payload?.requestId ?? `anon-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
84
+ toolResultBudget: {
85
+ maxTotalBytes: 1_000_000,
86
+ toolNames: ['read', 'grep', 'find', 'ls', 'bash', 'write'],
87
+ },
88
+ }
89
+ }
@@ -0,0 +1,12 @@
1
+ import { getConfig } from '@/config'
2
+ import { definePlugin } from '@/plugin'
3
+
4
+ import { createBrowserSubagent } from './browser-agent'
5
+
6
+ export default definePlugin({
7
+ plugin: async () => ({
8
+ subagents: {
9
+ browser: createBrowserSubagent(getConfig().browser),
10
+ },
11
+ }),
12
+ })
@@ -9,20 +9,10 @@ import { definePlugin } from '@/plugin'
9
9
  // path — keep them in lockstep.
10
10
  export const RENDER_SCRIPT_AGENT_RELATIVE_PATH = 'node_modules/typeclaw/src/bundled-plugins/doc-render/render.ts'
11
11
 
12
- // In-container path of the bundled themed report library, relative to the agent
13
- // root. The skill tells the agent to copy this next to its markdown and
14
- // `#import "lib.typ"`, because Typst's workspace sandbox only resolves imports
15
- // under the render's working directory. Keep in lockstep with the skill.
16
- export const TEMPLATE_LIB_AGENT_RELATIVE_PATH = 'node_modules/typeclaw/src/bundled-plugins/doc-render/templates/lib.typ'
17
-
18
12
  export function renderScriptPath(): string {
19
13
  return join(import.meta.dir, 'render.ts')
20
14
  }
21
15
 
22
- export function templateLibPath(): string {
23
- return join(import.meta.dir, 'templates', 'lib.typ')
24
- }
25
-
26
16
  export default definePlugin({
27
17
  plugin: async () => ({
28
18
  skillsDirs: [join(import.meta.dir, 'skills')],