typeclaw 0.49.0 → 0.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (502) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/bash-sandbox-env.d.ts +15 -0
  4. package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
  5. package/dist/types/agent/bash-sandbox.d.ts +94 -0
  6. package/dist/types/agent/compaction.d.ts +8 -0
  7. package/dist/types/agent/git-nudge.d.ts +6 -0
  8. package/dist/types/agent/guard-types.d.ts +25 -0
  9. package/dist/types/agent/guards.d.ts +7 -0
  10. package/dist/types/agent/idle-compaction.d.ts +8 -0
  11. package/dist/types/agent/index.d.ts +151 -0
  12. package/dist/types/agent/live-subagents.d.ts +113 -0
  13. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  14. package/dist/types/agent/loop-guard.d.ts +67 -0
  15. package/dist/types/agent/model-fallback.d.ts +29 -0
  16. package/dist/types/agent/model-overrides.d.ts +8 -0
  17. package/dist/types/agent/multimodal/index.d.ts +2 -0
  18. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  19. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  20. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  21. package/dist/types/agent/network/response-body.d.ts +1 -0
  22. package/dist/types/agent/network/safe-http.d.ts +46 -0
  23. package/dist/types/agent/output-allowance.d.ts +4 -0
  24. package/dist/types/agent/plugin-tools.d.ts +58 -0
  25. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  26. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  27. package/dist/types/agent/provider-error.d.ts +23 -0
  28. package/dist/types/agent/reload-tool.d.ts +10 -0
  29. package/dist/types/agent/restart/index.d.ts +31 -0
  30. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  31. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  32. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  33. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  34. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  35. package/dist/types/agent/self.d.ts +1 -0
  36. package/dist/types/agent/session-meta.d.ts +28 -0
  37. package/dist/types/agent/session-origin.d.ts +65 -0
  38. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  39. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  40. package/dist/types/agent/subagent-drain.d.ts +25 -0
  41. package/dist/types/agent/subagent-session.d.ts +3 -0
  42. package/dist/types/agent/subagents.d.ts +153 -0
  43. package/dist/types/agent/system-prompt-composition.d.ts +17 -0
  44. package/dist/types/agent/system-prompt.d.ts +7 -0
  45. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  46. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  47. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  48. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  49. package/dist/types/agent/todo/continuation.d.ts +21 -0
  50. package/dist/types/agent/todo/scope.d.ts +6 -0
  51. package/dist/types/agent/todo/store.d.ts +16 -0
  52. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  53. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  54. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  55. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  56. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  57. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  58. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  59. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  60. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  61. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  62. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  63. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  64. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  65. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  66. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  67. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  68. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  69. package/dist/types/agent/tools/ddg.d.ts +27 -0
  70. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  71. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  72. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  73. package/dist/types/agent/tools/restart.d.ts +25 -0
  74. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  75. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  76. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  77. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  78. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  79. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  80. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  81. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  82. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  83. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  84. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  85. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  86. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  87. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  88. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  89. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  90. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  91. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  92. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  93. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  94. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  95. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  96. package/dist/types/agent/tools/websearch.d.ts +17 -0
  97. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  98. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  99. package/dist/types/agent/turn-runner.d.ts +36 -0
  100. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  101. package/dist/types/browser/dockerfile.d.ts +2 -0
  102. package/dist/types/browser/registry.d.ts +49 -0
  103. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  104. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  105. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  106. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  107. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  108. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  109. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  110. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  111. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  112. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  113. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  114. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  115. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  116. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  117. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  118. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  119. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  120. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  121. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  122. package/dist/types/channels/background-handoff.d.ts +56 -0
  123. package/dist/types/channels/background-obligations.d.ts +135 -0
  124. package/dist/types/channels/catch-up.d.ts +26 -0
  125. package/dist/types/channels/commands.d.ts +2 -0
  126. package/dist/types/channels/completion-claim.d.ts +20 -0
  127. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  128. package/dist/types/channels/continuity-types.d.ts +75 -0
  129. package/dist/types/channels/describe-error.d.ts +1 -0
  130. package/dist/types/channels/engagement.d.ts +34 -0
  131. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  132. package/dist/types/channels/github-repo.d.ts +2 -0
  133. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  134. package/dist/types/channels/github-review-check.d.ts +135 -0
  135. package/dist/types/channels/github-review-claim.d.ts +3 -0
  136. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  137. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  138. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  139. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  140. package/dist/types/channels/inbound-journal.d.ts +272 -0
  141. package/dist/types/channels/last-alive.d.ts +3 -0
  142. package/dist/types/channels/membership-cache.d.ts +27 -0
  143. package/dist/types/channels/membership.d.ts +21 -0
  144. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  145. package/dist/types/channels/participants.d.ts +4 -0
  146. package/dist/types/channels/persistence.d.ts +32 -0
  147. package/dist/types/channels/recovery-notice.d.ts +26 -0
  148. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  149. package/dist/types/channels/router.d.ts +760 -0
  150. package/dist/types/channels/schema.d.ts +501 -0
  151. package/dist/types/channels/session-handoff.d.ts +58 -0
  152. package/dist/types/channels/session-search.d.ts +29 -0
  153. package/dist/types/channels/types.d.ts +414 -0
  154. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  155. package/dist/types/cli/builtins.d.ts +2 -0
  156. package/dist/types/cli/command-meta.d.ts +9 -0
  157. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  158. package/dist/types/coding-agent/broker.d.ts +22 -0
  159. package/dist/types/coding-agent/claude.d.ts +22 -0
  160. package/dist/types/coding-agent/codex.d.ts +19 -0
  161. package/dist/types/coding-agent/index.d.ts +71 -0
  162. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  163. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  164. package/dist/types/coding-agent/omo.d.ts +133 -0
  165. package/dist/types/coding-agent/runner.d.ts +35 -0
  166. package/dist/types/coding-agent/tool.d.ts +27 -0
  167. package/dist/types/coding-agent/worktree.d.ts +22 -0
  168. package/dist/types/commands/index.d.ts +45 -0
  169. package/dist/types/config/config.d.ts +827 -0
  170. package/dist/types/config/index.d.ts +3 -0
  171. package/dist/types/config/model-overrides.d.ts +3 -0
  172. package/dist/types/config/providers.d.ts +1458 -0
  173. package/dist/types/config/reloadable.d.ts +9 -0
  174. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  175. package/dist/types/container/build-cache.d.ts +39 -0
  176. package/dist/types/container/compose-project.d.ts +1 -0
  177. package/dist/types/container/controller.d.ts +25 -0
  178. package/dist/types/container/docker-app.d.ts +23 -0
  179. package/dist/types/container/exit-reason.d.ts +10 -0
  180. package/dist/types/container/index.d.ts +14 -0
  181. package/dist/types/container/log-archive.d.ts +68 -0
  182. package/dist/types/container/log-colors.d.ts +3 -0
  183. package/dist/types/container/log-timestamps.d.ts +9 -0
  184. package/dist/types/container/logs.d.ts +37 -0
  185. package/dist/types/container/memory-limit.d.ts +13 -0
  186. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  187. package/dist/types/container/oom-events.d.ts +18 -0
  188. package/dist/types/container/port.d.ts +18 -0
  189. package/dist/types/container/require-running.d.ts +16 -0
  190. package/dist/types/container/restart.d.ts +32 -0
  191. package/dist/types/container/shared.d.ts +93 -0
  192. package/dist/types/container/shell.d.ts +35 -0
  193. package/dist/types/container/start.d.ts +145 -0
  194. package/dist/types/container/stats.d.ts +31 -0
  195. package/dist/types/container/status.d.ts +25 -0
  196. package/dist/types/container/stop.d.ts +24 -0
  197. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  198. package/dist/types/container/verify-running.d.ts +49 -0
  199. package/dist/types/cron/consumer.d.ts +42 -0
  200. package/dist/types/cron/count-state.d.ts +24 -0
  201. package/dist/types/cron/index.d.ts +21 -0
  202. package/dist/types/cron/list.d.ts +33 -0
  203. package/dist/types/cron/reloadable.d.ts +11 -0
  204. package/dist/types/cron/scheduler.d.ts +51 -0
  205. package/dist/types/cron/schema.d.ts +108 -0
  206. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  207. package/dist/types/dependencies/bins.d.ts +22 -0
  208. package/dist/types/dependencies/index.d.ts +2 -0
  209. package/dist/types/eval/cell.d.ts +26 -0
  210. package/dist/types/eval/config.d.ts +19 -0
  211. package/dist/types/eval/dispatch.d.ts +7 -0
  212. package/dist/types/eval/kernel.d.ts +28 -0
  213. package/dist/types/eval/process.d.ts +23 -0
  214. package/dist/types/eval/protocol.d.ts +34 -0
  215. package/dist/types/eval/sandbox.d.ts +10 -0
  216. package/dist/types/eval/tool.d.ts +17 -0
  217. package/dist/types/eval/wire.d.ts +33 -0
  218. package/dist/types/git/bound-gc-config.d.ts +4 -0
  219. package/dist/types/git/hookless.d.ts +1 -0
  220. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  221. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  222. package/dist/types/git/resolve-identity.d.ts +10 -0
  223. package/dist/types/git/run.d.ts +24 -0
  224. package/dist/types/git/system-commit.d.ts +2 -0
  225. package/dist/types/hostd/client.d.ts +13 -0
  226. package/dist/types/hostd/models.d.ts +1 -0
  227. package/dist/types/hostd/paths.d.ts +17 -0
  228. package/dist/types/hostd/protocol.d.ts +93 -0
  229. package/dist/types/hostd/spawn.d.ts +17 -0
  230. package/dist/types/hostd/version.d.ts +18 -0
  231. package/dist/types/init/auto-upgrade.d.ts +41 -0
  232. package/dist/types/init/cli-version.d.ts +7 -0
  233. package/dist/types/init/dockerfile.d.ts +34 -0
  234. package/dist/types/init/ensure-deps.d.ts +17 -0
  235. package/dist/types/init/env-file.d.ts +3 -0
  236. package/dist/types/init/gitignore.d.ts +5 -0
  237. package/dist/types/init/local-source-stamp.d.ts +3 -0
  238. package/dist/types/init/packagejson.d.ts +7 -0
  239. package/dist/types/init/paths.d.ts +3 -0
  240. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  241. package/dist/types/init/run-bun-install.d.ts +16 -0
  242. package/dist/types/init/windows-dev-link.d.ts +8 -0
  243. package/dist/types/mcp/catalog.d.ts +7 -0
  244. package/dist/types/mcp/client.d.ts +58 -0
  245. package/dist/types/mcp/manager.d.ts +56 -0
  246. package/dist/types/mcp/tools.d.ts +23 -0
  247. package/dist/types/models/embedding-model.d.ts +20 -0
  248. package/dist/types/models/transformers-version.d.ts +1 -0
  249. package/dist/types/network/internal-destinations.d.ts +29 -0
  250. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  251. package/dist/types/operations/incidents.d.ts +47 -0
  252. package/dist/types/operations/index.d.ts +3 -0
  253. package/dist/types/operations/remediations.d.ts +25 -0
  254. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  255. package/dist/types/permissions/builtins.d.ts +25 -0
  256. package/dist/types/permissions/grant.d.ts +19 -0
  257. package/dist/types/permissions/index.d.ts +6 -0
  258. package/dist/types/permissions/match-rule.d.ts +28 -0
  259. package/dist/types/permissions/permissions.d.ts +42 -0
  260. package/dist/types/permissions/resolve.d.ts +25 -0
  261. package/dist/types/permissions/schema.d.ts +14 -0
  262. package/dist/types/plugin/context.d.ts +20 -0
  263. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  264. package/dist/types/plugin/define.d.ts +46 -0
  265. package/dist/types/plugin/hooks.d.ts +52 -0
  266. package/dist/types/plugin/index.d.ts +11 -0
  267. package/dist/types/plugin/load-skill.d.ts +14 -0
  268. package/dist/types/plugin/loader.d.ts +25 -0
  269. package/dist/types/plugin/manager.d.ts +42 -0
  270. package/dist/types/plugin/registry.d.ts +73 -0
  271. package/dist/types/plugin/skills.d.ts +11 -0
  272. package/dist/types/plugin/types.d.ts +336 -0
  273. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  274. package/dist/types/reload/client.d.ts +11 -0
  275. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  276. package/dist/types/reload/format.d.ts +2 -0
  277. package/dist/types/reload/index.d.ts +6 -0
  278. package/dist/types/reload/recover.d.ts +22 -0
  279. package/dist/types/reload/registry.d.ts +10 -0
  280. package/dist/types/reload/types.d.ts +25 -0
  281. package/dist/types/role-claim/client.d.ts +20 -0
  282. package/dist/types/role-claim/code.d.ts +4 -0
  283. package/dist/types/role-claim/controller.d.ts +59 -0
  284. package/dist/types/role-claim/index.d.ts +6 -0
  285. package/dist/types/role-claim/match-rule.d.ts +9 -0
  286. package/dist/types/role-claim/pending.d.ts +35 -0
  287. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  288. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  289. package/dist/types/sandbox/availability.d.ts +21 -0
  290. package/dist/types/sandbox/build.d.ts +7 -0
  291. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  292. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  293. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  294. package/dist/types/sandbox/dev-source.d.ts +4 -0
  295. package/dist/types/sandbox/env-exposure.d.ts +3 -0
  296. package/dist/types/sandbox/errors.d.ts +20 -0
  297. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  298. package/dist/types/sandbox/index.d.ts +14 -0
  299. package/dist/types/sandbox/package-install.d.ts +1 -0
  300. package/dist/types/sandbox/policy.d.ts +71 -0
  301. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  302. package/dist/types/sandbox/quote.d.ts +2 -0
  303. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  304. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  305. package/dist/types/sandbox/symlinks.d.ts +6 -0
  306. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  307. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  308. package/dist/types/secrets/defaults.d.ts +21 -0
  309. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  310. package/dist/types/secrets/hydrate.d.ts +7 -0
  311. package/dist/types/secrets/index.d.ts +7 -0
  312. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  313. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  314. package/dist/types/secrets/resolve.d.ts +14 -0
  315. package/dist/types/secrets/schema.d.ts +840 -0
  316. package/dist/types/secrets/storage.d.ts +56 -0
  317. package/dist/types/shared/host-locale.d.ts +1 -0
  318. package/dist/types/shared/index.d.ts +5 -0
  319. package/dist/types/shared/local-time.d.ts +4 -0
  320. package/dist/types/shared/platform.d.ts +2 -0
  321. package/dist/types/shared/protocol.d.ts +424 -0
  322. package/dist/types/shared/style-text.d.ts +3 -0
  323. package/dist/types/shared/wsl.d.ts +17 -0
  324. package/dist/types/stream/broker.d.ts +2 -0
  325. package/dist/types/stream/index.d.ts +2 -0
  326. package/dist/types/stream/types.d.ts +71 -0
  327. package/package.json +13 -6
  328. package/scripts/build-plugin-types.ts +105 -0
  329. package/scripts/check-plugin-sdk.ts +111 -0
  330. package/scripts/require-parallel.ts +5 -32
  331. package/src/agent/bash-sandbox-env.ts +104 -0
  332. package/src/agent/bash-sandbox-proc.ts +70 -0
  333. package/src/agent/bash-sandbox.ts +225 -0
  334. package/src/agent/compaction.ts +22 -10
  335. package/src/agent/guard-types.ts +3 -0
  336. package/src/agent/guards.ts +4 -0
  337. package/src/agent/idle-compaction.ts +178 -0
  338. package/src/agent/index.ts +139 -172
  339. package/src/agent/live-subagents.ts +19 -0
  340. package/src/agent/multimodal/look-at.ts +22 -9
  341. package/src/agent/output-allowance.ts +7 -0
  342. package/src/agent/plugin-tools.ts +39 -377
  343. package/src/agent/reviewer-bash-policy.ts +41 -1
  344. package/src/agent/session-origin.ts +28 -11
  345. package/src/agent/subagent-cache-keepalive.ts +198 -0
  346. package/src/agent/subagent-completion-reminder.ts +2 -2
  347. package/src/agent/subagent-session.ts +6 -0
  348. package/src/agent/subagents.ts +46 -8
  349. package/src/agent/system-prompt-composition.ts +141 -0
  350. package/src/agent/system-prompt.ts +5 -5
  351. package/src/agent/todo/scope.ts +1 -1
  352. package/src/agent/tool-file-safety.ts +6 -1
  353. package/src/agent/tools/channel-edit.ts +20 -10
  354. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  355. package/src/agent/tools/channel-handoff.ts +72 -0
  356. package/src/agent/tools/channel-read.ts +57 -10
  357. package/src/agent/tools/channel-reply.ts +33 -26
  358. package/src/agent/tools/channel-send.ts +21 -13
  359. package/src/agent/tools/channel-session-search.ts +35 -0
  360. package/src/agent/tools/curl-impersonate.ts +11 -4
  361. package/src/agent/tools/ddg.ts +84 -16
  362. package/src/agent/tools/spawn-subagent.ts +27 -11
  363. package/src/agent/tools/stream-snapshot.ts +15 -2
  364. package/src/agent/tools/subagent-access.ts +11 -4
  365. package/src/agent/tools-without-local-file-operands.ts +4 -0
  366. package/src/browser/bsk-shim.mjs +74 -0
  367. package/src/browser/dockerfile.ts +84 -0
  368. package/src/browser/egress.ts +104 -0
  369. package/src/browser/fill-secret.ts +307 -0
  370. package/src/browser/managed-browser.ts +205 -0
  371. package/src/browser/registry.ts +110 -0
  372. package/src/browser/relay.ts +231 -0
  373. package/src/browser/sandbox-entry.ts +167 -0
  374. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  375. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  376. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  377. package/src/bundled-plugins/doc-render/index.ts +0 -10
  378. package/src/bundled-plugins/doc-render/render.ts +83 -111
  379. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  380. package/src/bundled-plugins/explorer/explorer.ts +1 -1
  381. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  382. package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
  383. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  384. package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
  385. package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
  386. package/src/bundled-plugins/managed-browser/index.ts +179 -0
  387. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  388. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  389. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  390. package/src/bundled-plugins/memory/dreaming.ts +4 -1
  391. package/src/bundled-plugins/memory/load-memory.ts +2 -4
  392. package/src/bundled-plugins/memory/memory-logger.ts +74 -2
  393. package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
  394. package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
  395. package/src/bundled-plugins/operator/operator.ts +1 -1
  396. package/src/bundled-plugins/qa/index.ts +11 -0
  397. package/src/bundled-plugins/qa/qa.ts +160 -0
  398. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  399. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  400. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  401. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  402. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  403. package/src/bundled-plugins/security/index.ts +53 -34
  404. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  405. package/src/bundled-plugins/security/policies/private-surface-read.ts +166 -201
  406. package/src/channels/adapter-namespace.ts +13 -0
  407. package/src/channels/adapters/discord-bot-reference.ts +5 -4
  408. package/src/channels/adapters/discord-bot.ts +98 -5
  409. package/src/channels/adapters/discord-classify.ts +8 -3
  410. package/src/channels/adapters/discord.ts +29 -0
  411. package/src/channels/adapters/github/index.ts +16 -0
  412. package/src/channels/adapters/github/last-alive.ts +4 -16
  413. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  414. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  415. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  416. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  417. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  418. package/src/channels/adapters/slack-bot.ts +299 -67
  419. package/src/channels/adapters/slack-classify.ts +1 -0
  420. package/src/channels/catch-up.ts +137 -0
  421. package/src/channels/continuation-willingness.ts +2 -2
  422. package/src/channels/continuity-types.ts +1 -0
  423. package/src/channels/engagement.ts +17 -1
  424. package/src/channels/github-false-receipt.ts +3 -3
  425. package/src/channels/github-rereview-guard.ts +9 -5
  426. package/src/channels/github-review-check.ts +5 -1
  427. package/src/channels/github-review-verdict-coordinator.ts +68 -2
  428. package/src/channels/github-token-bridge.ts +24 -0
  429. package/src/channels/last-alive.ts +34 -0
  430. package/src/channels/manager.ts +8 -1
  431. package/src/channels/router.ts +515 -243
  432. package/src/channels/session-handoff.fixture.ts +144 -0
  433. package/src/channels/session-handoff.ts +175 -0
  434. package/src/channels/session-search.ts +71 -0
  435. package/src/channels/subagent-completion-bridge.ts +3 -2
  436. package/src/channels/types.ts +12 -2
  437. package/src/cli/channel.ts +2 -3
  438. package/src/cli/hostd.ts +3 -0
  439. package/src/cli/init.ts +2 -3
  440. package/src/cli/model.ts +132 -3
  441. package/src/coding-agent/index.ts +7 -1
  442. package/src/coding-agent/omo-stream.ts +40 -0
  443. package/src/coding-agent/runner.ts +30 -8
  444. package/src/config/config.ts +126 -22
  445. package/src/config/model-overrides.ts +59 -0
  446. package/src/config/models-mutation.ts +185 -2
  447. package/src/config/providers-mutation.ts +12 -4
  448. package/src/config/providers.ts +69 -4
  449. package/src/container/start.ts +132 -5
  450. package/src/doctor/checks.ts +33 -22
  451. package/src/doctor/index.ts +48 -12
  452. package/src/doctor/operational-incidents.ts +16 -1
  453. package/src/doctor/plugin-bridge.ts +14 -1
  454. package/src/doctor/stage.ts +14 -0
  455. package/src/doctor/types.ts +6 -0
  456. package/src/eval/cell.ts +93 -0
  457. package/src/eval/config.ts +32 -0
  458. package/src/eval/dispatch.ts +67 -0
  459. package/src/eval/entry.ts +261 -0
  460. package/src/eval/kernel.ts +154 -0
  461. package/src/eval/process.ts +113 -0
  462. package/src/eval/protocol.ts +26 -0
  463. package/src/eval/redeclare.ts +174 -0
  464. package/src/eval/sandbox.ts +114 -0
  465. package/src/eval/tool.ts +98 -0
  466. package/src/eval/wire.ts +93 -0
  467. package/src/hostd/daemon.ts +13 -1
  468. package/src/init/auto-upgrade.ts +7 -1
  469. package/src/init/dockerfile.ts +57 -12
  470. package/src/init/index.ts +4 -3
  471. package/src/init/local-source-stamp.ts +68 -0
  472. package/src/init/models-dev.ts +4 -0
  473. package/src/init/validate-api-key.ts +3 -0
  474. package/src/operations/classify-tool-outcome.ts +1 -1
  475. package/src/permissions/builtins.ts +7 -0
  476. package/src/permissions/permissions.ts +18 -9
  477. package/src/permissions/resolve.ts +7 -1
  478. package/src/plugin/context.ts +2 -0
  479. package/src/plugin/core-tool-names.ts +6 -1
  480. package/src/plugin/hooks.ts +137 -0
  481. package/src/plugin/index.ts +6 -0
  482. package/src/plugin/manager.ts +4 -0
  483. package/src/plugin/types.ts +60 -0
  484. package/src/run/bundled-plugins.ts +6 -0
  485. package/src/run/index.ts +24 -14
  486. package/src/run/llm-fetch-observer.ts +12 -15
  487. package/src/sandbox/canonical-secrets.ts +4 -0
  488. package/src/sandbox/dev-source.ts +26 -0
  489. package/src/sandbox/env-exposure.ts +20 -0
  490. package/src/sandbox/hidden-paths.ts +16 -2
  491. package/src/secrets/storage.ts +13 -0
  492. package/src/server/index.ts +46 -11
  493. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  494. package/src/skills/typeclaw-config/SKILL.md +57 -5
  495. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  496. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  497. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  498. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  499. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  500. package/typeclaw.schema.json +488 -5
  501. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  502. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -1,13 +1,16 @@
1
1
  import agentBrowserPlugin from '@/bundled-plugins/agent-browser'
2
2
  import backupPlugin from '@/bundled-plugins/backup'
3
+ import browserAgentPlugin from '@/bundled-plugins/browser-agent'
3
4
  import bunHygienePlugin from '@/bundled-plugins/bun-hygiene'
4
5
  import docRenderPlugin from '@/bundled-plugins/doc-render'
5
6
  import explorerPlugin from '@/bundled-plugins/explorer'
6
7
  import githubCliAuthPlugin from '@/bundled-plugins/github-cli-auth'
7
8
  import guardPlugin from '@/bundled-plugins/guard'
9
+ import browserPlugin from '@/bundled-plugins/managed-browser'
8
10
  import memoryPlugin from '@/bundled-plugins/memory'
9
11
  import operatorPlugin from '@/bundled-plugins/operator'
10
12
  import plannerPlugin from '@/bundled-plugins/planner'
13
+ import qaPlugin from '@/bundled-plugins/qa'
11
14
  import researcherPlugin from '@/bundled-plugins/researcher'
12
15
  import reviewerPlugin from '@/bundled-plugins/reviewer'
13
16
  import scoutPlugin from '@/bundled-plugins/scout'
@@ -59,10 +62,13 @@ export const BUNDLED_PLUGINS: ResolvedPlugin[] = [
59
62
  { name: 'memory', version: undefined, source: '<bundled>', defined: memoryPlugin },
60
63
  { name: 'backup', version: undefined, source: '<bundled>', defined: backupPlugin },
61
64
  { name: 'agent-browser', version: undefined, source: '<bundled>', defined: agentBrowserPlugin },
65
+ { name: 'managed-browser', version: undefined, source: '<bundled>', defined: browserPlugin },
62
66
  { name: 'doc-render', version: undefined, source: '<bundled>', defined: docRenderPlugin },
63
67
  { name: 'explorer', version: undefined, source: '<bundled>', defined: explorerPlugin },
68
+ { name: 'browser-agent', version: undefined, source: '<bundled>', defined: browserAgentPlugin },
64
69
  { name: 'scout', version: undefined, source: '<bundled>', defined: scoutPlugin },
65
70
  { name: 'reviewer', version: undefined, source: '<bundled>', defined: reviewerPlugin },
71
+ { name: 'qa', version: undefined, source: '<bundled>', defined: qaPlugin },
66
72
  { name: 'researcher', version: undefined, source: '<bundled>', defined: researcherPlugin },
67
73
  { name: 'planner', version: undefined, source: '<bundled>', defined: plannerPlugin },
68
74
  { name: 'operator', version: undefined, source: '<bundled>', defined: operatorPlugin },
package/src/run/index.ts CHANGED
@@ -9,6 +9,7 @@ import { LiveSubagentRegistry, newestRunningBackgroundChildStartedAt } from '@/a
9
9
  import { requestContainerRestart } from '@/agent/restart'
10
10
  import { sessionMetaPayload } from '@/agent/session-meta'
11
11
  import type { SessionOrigin } from '@/agent/session-origin'
12
+ import { createSubagentSessionManager } from '@/agent/subagent-session'
12
13
  import {
13
14
  awaitWithSubagentTimeout,
14
15
  createSubagentConsumer,
@@ -317,6 +318,7 @@ async function startAgentRuntime(
317
318
  resolveGithubTokenForRepo: githubTokenBridge.resolveTokenForRepo,
318
319
  hasGithubAppTokenResolver: githubTokenBridge.hasAppTokenResolver,
319
320
  getGithubAppSelfLogin: githubTokenBridge.getAppSelfLogin,
321
+ resolveGithubPatForRepo: githubTokenBridge.resolvePatForRepo,
320
322
  ...(cwdConfig.roles !== undefined ? { roles: cwdConfig.roles } : {}),
321
323
  })
322
324
  // Emit the container's fixed resource limits BEFORE vector startup. The
@@ -430,7 +432,7 @@ async function startAgentRuntime(
430
432
  })
431
433
  if (githubCliExport.action === 'failed') {
432
434
  console.warn(
433
- '[run] trusted GitHub CLI store unavailable; store-backed GitHub pushes will not authenticate. ' +
435
+ '[run] trusted GitHub CLI store unavailable; brokered `gh` commands will not authenticate. ' +
434
436
  'On the host, run `gh auth login --hostname github.com`, then run a real `typeclaw restart`.',
435
437
  )
436
438
  }
@@ -482,6 +484,14 @@ async function startAgentRuntime(
482
484
  onRecoveryReady: () => {
483
485
  void recoveryDispatcher?.wake().catch((error) => console.warn(`[run] recovery wake failed: ${error}`))
484
486
  },
487
+ // Resolve the live bus at delivery time so plugin reloads take effect
488
+ // without rebuilding adapters, and no subscribers means no snapshot work.
489
+ slackBotMessageObserver: {
490
+ active: () => pluginRuntime.get().hooks.count('channel.message.observed') > 0,
491
+ observe: (event) => pluginRuntime.get().hooks.runChannelMessageObserved(event),
492
+ },
493
+ outboundReviewer: (event) => pluginRuntime.get().hooks.runChannelOutboundBefore(event),
494
+ outboundReviewerActive: () => pluginRuntime.get().hooks.count('channel.outbound.before') > 0,
485
495
  tunnelUrlForChannel: (name) => resolveTunnelUrlForChannel(name, tunnelManager),
486
496
  tunnelConfiguredForChannel: (name) => isTunnelConfiguredForChannel(name),
487
497
  createSessionForChannel: buildChannelSessionFactory({
@@ -557,7 +567,11 @@ async function startAgentRuntime(
557
567
  const snap = pluginRuntime.get()
558
568
  const entry = snap.pluginSubagentByShim.get(subagent)
559
569
  if (entry) {
560
- const sessionManager = SessionManager.create(cwd, sessionFactory.sessionDir())
570
+ const sessionManager = createSubagentSessionManager(
571
+ cwd,
572
+ sessionFactory.sessionDir(),
573
+ entry.pluginSubagent.ephemeral,
574
+ )
561
575
  const sessionId = sessionManager.getSessionId()
562
576
  const origin: SessionOrigin = {
563
577
  kind: 'subagent' as const,
@@ -605,6 +619,9 @@ async function startAgentRuntime(
605
619
  ...(resolveSubagentProfile(entry.pluginSubagent, subagentOptions) !== undefined
606
620
  ? { profile: resolveSubagentProfile(entry.pluginSubagent, subagentOptions) }
607
621
  : {}),
622
+ ...(entry.pluginSubagent.thinkingLevel !== undefined
623
+ ? { thinkingLevel: entry.pluginSubagent.thinkingLevel }
624
+ : {}),
608
625
  ...(entry.pluginSubagent.toolResultBudget !== undefined
609
626
  ? { toolResultBudget: entry.pluginSubagent.toolResultBudget }
610
627
  : {}),
@@ -1350,6 +1367,7 @@ type PluginOnlySubagentKeys = Exclude<keyof import('@/plugin').Subagent<any>, ke
1350
1367
  const PLUGIN_ONLY_KEYS_DROPPED_BY_SHIM = {
1351
1368
  tools: true,
1352
1369
  customTools: true,
1370
+ ephemeral: true,
1353
1371
  } satisfies Record<PluginOnlySubagentKeys, true>
1354
1372
  // Reference the table so it's not dead code. The value is a runtime no-op;
1355
1373
  // the load-bearing work is the `satisfies` clause above which forces
@@ -1357,17 +1375,9 @@ const PLUGIN_ONLY_KEYS_DROPPED_BY_SHIM = {
1357
1375
  void PLUGIN_ONLY_KEYS_DROPPED_BY_SHIM
1358
1376
 
1359
1377
  function pluginSubagentShim(subagent: import('@/plugin').Subagent<any>): InternalSubagent<any> {
1360
- // The two diverging fields (`tools` is `BuiltinToolRef[]` plugin-side vs
1361
- // `AgentSessionTools` internal-side; `customTools` similarly differs) are
1362
- // resolved later in `createSessionForSubagent` via the
1363
- // `pluginSubagentByShim` lookup, which recovers the original plugin
1364
- // reference. Every other plugin-side field lives on `SubagentShared` and is structurally
1365
- // assignable to the internal `Subagent`, so a rest-spread carries them
1366
- // verbatim — including `visibility` and `requiresSpecificPermission`,
1367
- // whose silent drop in the previous shim made every plugin-contributed
1368
- // public subagent (scout, explorer, operator) invisible to the
1369
- // `spawn_subagent` tool. The list of keys removed here is enforced
1370
- // exhaustive at compile time by `PLUGIN_ONLY_KEYS_DROPPED_BY_SHIM` above.
1371
- const { tools: _tools, customTools: _customTools, ...shared } = subagent
1378
+ // Plugin-only tools and transcript persistence are resolved by the native
1379
+ // factory through pluginSubagentByShim, which retains the original declaration.
1380
+ // The internal registry shim carries only the shared scheduling/role contract.
1381
+ const { tools: _tools, customTools: _customTools, ephemeral: _ephemeral, ...shared } = subagent
1372
1382
  return shared
1373
1383
  }
@@ -45,14 +45,12 @@ export type LlmFetchObserverOptions = {
45
45
  // Override the default pre-headers (TTFB) deadline applied to the outer
46
46
  // fetch(). When a provider silently holds a request without sending response
47
47
  // headers, this is the timer that releases the request so `pi-coding-agent`'s
48
- // `_isRetryableError` can retry. Default: 15_000 ms.
48
+ // `_isRetryableError` can retry. Default: 30_000 ms.
49
49
  //
50
- // Healthy turns return response headers within ~1s (observed Codex production
51
- // p50: ~860ms). Pathological-but-healthy upper bounds: TLS handshake on a cold
52
- // connection (~2s), prompt-prefill on a cache miss with large input (~3s),
53
- // edge routing slowness (~2s) — sum ~7s. 15s is ~2x that, so anything past it
54
- // is almost certainly the silent-hang failure mode rather than a real request
55
- // making progress. False-positive cost is one retry (~5s extra); false-negative
50
+ // Most providers return response headers within ~1s, but slow-but-healthy
51
+ // OpenAI-compatible providers (e.g. z.ai GLM) routinely take 12-16s to send
52
+ // headers on large prompts, so a 15s deadline aborted real requests. 30s keeps
53
+ // a margin over that tail while still bounding a silent hang. False-positive cost is one retry (~5s extra); false-negative
56
54
  // cost is the full Bun socket deadline (~268s). Aggressive wins.
57
55
  ttfbMs?: number
58
56
  // Override the sliding inter-chunk idle deadline applied to the SSE body
@@ -101,11 +99,11 @@ const ENV_OVERALL_MS = 'TYPECLAW_LLM_OVERALL_MS'
101
99
  const ENV_CODEX_TTFB_MS = 'TYPECLAW_CODEX_TTFB_MS'
102
100
  const ENV_CODEX_IDLE_MS = 'TYPECLAW_CODEX_IDLE_MS'
103
101
  const ENV_CODEX_OVERALL_MS = 'TYPECLAW_CODEX_OVERALL_MS'
104
- const DEFAULT_TTFB_MS = 15_000
102
+ const DEFAULT_TTFB_MS = 30_000
105
103
  const DEFAULT_IDLE_MS = 120_000
106
104
  const DEFAULT_OVERALL_MS = 300_000
107
105
  // Codex is healthy-FAST but silently hangs: observed header latency p50~1s /
108
- // p99~8s / max~10.8s, yet hung requests wait out the generic 15s floor. Pinning
106
+ // p99~8s / max~10.8s, yet hung requests wait out the generic 30s floor. Pinning
109
107
  // 13s detects hangs ~2s sooner with ~2.2s margin over the healthy max. Pinned,
110
108
  // not adaptive: codex's p95 (~5.6s) never crosses the floor so widening is a
111
109
  // no-op, and a longer deadline only makes each silent hang costlier to recover.
@@ -116,8 +114,7 @@ const LOG_PREFIX = '[llm-fetch]'
116
114
 
117
115
  // Adaptive TTFB: give a provider that is OBSERVED to be slow-but-healthy more
118
116
  // pre-headers room, without blunting silent-hang detection for fast providers.
119
- // A fixed 15s guillotine kills legitimately-slow providers (e.g. GLM cold-start
120
- // TTFB ~16.5s while its p50 is ~1s); a uniform higher default would let a truly
117
+ // A fixed floor kills legitimately-slow providers whose tail exceeds it; a uniform higher default would let a truly
121
118
  // hung FAST provider stall for the same widened window. So widening is scoped to
122
119
  // the specific origin whose recent successful header latency is actually high.
123
120
  //
@@ -125,15 +122,15 @@ const LOG_PREFIX = '[llm-fetch]'
125
122
  // are bimodal, mostly-1s with occasional 10–16s, so a mean-tracker sits low and
126
123
  // never widens for the spike). Nearest-rank p95 over the last ADAPTIVE_WINDOW_MS
127
124
  // of samples reacts to the current upper tail and forgets stale slowness.
128
- const ADAPTIVE_TTFB_FLOOR_MS = 15_000
129
- const ADAPTIVE_TTFB_CEIL_MS = 30_000
125
+ const ADAPTIVE_TTFB_FLOOR_MS = 30_000
126
+ const ADAPTIVE_TTFB_CEIL_MS = 60_000
130
127
  const ADAPTIVE_TTFB_MULTIPLIER = 2
131
128
  const ADAPTIVE_MIN_SAMPLES = 8
132
129
  const ADAPTIVE_MAX_SAMPLES = 32
133
130
  const ADAPTIVE_WINDOW_MS = 5 * 60_000
134
131
  // After a timeout at the CEIL budget, the origin is treated as slow-then-hung:
135
132
  // suppress all widening (learned + probe) and fail closed to the floor for this
136
- // long, so five rapid retries can't each inherit the 30s budget. A sub-floor
133
+ // long, so five rapid retries can't each inherit the ceil budget. A sub-floor
137
134
  // success clears the suppression early.
138
135
  const ADAPTIVE_COOLDOWN_MS = 5 * 60_000
139
136
 
@@ -256,7 +253,7 @@ export function defaultLlmFetchEndpoints(env: NodeJS.ProcessEnv = process.env):
256
253
  // GETs to the same host (auth probes, etc.) are deliberately ignored.
257
254
  match: (url, method) =>
258
255
  method === 'POST' && url.hostname === 'chatgpt.com' && url.pathname.includes('/codex/responses'),
259
- // TTFB is pinned to the codex-specific default (not the generic 15s) so a
256
+ // TTFB is pinned to the codex-specific default (not the generic 30s) so a
260
257
  // silent hang is caught fast and adaptation is bypassed for this endpoint;
261
258
  // an operator-set TYPECLAW_CODEX_TTFB_MS still wins. Idle/overall keep the
262
259
  // fall-through shape (unset → generic TYPECLAW_LLM_* / built-in default) so
@@ -3,6 +3,9 @@ import {
3
3
  LEGACY_AGENT_MESSENGER_CONFIG_RELATIVE_DIR,
4
4
  } from '@/agent-messenger/config-dir'
5
5
 
6
+ // The managed Chrome profile: cookies and logins persist across container restarts.
7
+ export const BROWSER_PROFILE_RELATIVE_DIR = '.typeclaw/browser-profile'
8
+
6
9
  // Runtime-owned credential stores: TypeClaw writes and reads these itself, and
7
10
  // no shipped skill ever invokes a CLI that reads them. Masked at EVERY role.
8
11
  export const RUNTIME_OWNED_SECRET_DIRS = [
@@ -12,6 +15,7 @@ export const RUNTIME_OWNED_SECRET_DIRS = [
12
15
  LEGACY_AGENT_MESSENGER_CONFIG_RELATIVE_DIR,
13
16
  '.typeclaw/home',
14
17
  '.typeclaw/logs',
18
+ BROWSER_PROFILE_RELATIVE_DIR,
15
19
  ] as const
16
20
 
17
21
  // SECURITY / classification: operator-provisioned CLI credential stores. TypeClaw
@@ -0,0 +1,26 @@
1
+ import { realpath } from 'node:fs/promises'
2
+ import { dirname, isAbsolute, relative } from 'node:path'
3
+ import { fileURLToPath } from 'node:url'
4
+
5
+ import type { SandboxMount } from './policy'
6
+
7
+ const RUNTIME_MODULE_FILE = fileURLToPath(import.meta.url)
8
+
9
+ // Dev mode (`file:`/`link:` typeclaw dep): files under node_modules/typeclaw
10
+ // are symlinks into a checkout outside the agent folder. `typeclaw start`
11
+ // mirror-mounts that checkout read-only into the container, but bwrap only
12
+ // binds the agent folder, so bundled SKILL.md symlinks dangle inside model
13
+ // bash. Bind only the checkout's `src/` (where every bundled skill lives),
14
+ // never the checkout root, so a developer's `.env` or `.git` stays out of the
15
+ // sandbox. The path comes from the running module's own realpath, which the
16
+ // model cannot redirect by rewriting node_modules. Registry installs resolve
17
+ // inside the agent folder and get no mount.
18
+ export async function resolveDevSourceMount(
19
+ agentDir: string,
20
+ moduleFile: string = RUNTIME_MODULE_FILE,
21
+ ): Promise<Extract<SandboxMount, { type: 'ro-bind' }> | undefined> {
22
+ const srcDir = dirname(dirname(await realpath(moduleFile)))
23
+ const rel = relative(await realpath(agentDir), srcDir)
24
+ if (rel === '' || (!rel.startsWith('..') && !isAbsolute(rel))) return undefined
25
+ return { type: 'ro-bind', source: srcDir, dest: srcDir }
26
+ }
@@ -54,6 +54,11 @@ const EXECUTION_CONTROL_ENV_NAMES = new Set<string>([
54
54
 
55
55
  const EXECUTION_CONTROL_ENV_PREFIXES = ['GIT_CONFIG', 'BASH_FUNC_'] as const
56
56
 
57
+ // Operator opt-in for values the model may type into a page but never read:
58
+ // withheld from bash, reachable only through the runtime-side
59
+ // `browser_fill_secret` tool, which types the value without returning it.
60
+ export const SECRET_ENV_PREFIX = 'TYPECLAW_SECRET_'
61
+
57
62
  const GIT_IDENTITY_ENV_NAMES = [
58
63
  'GIT_AUTHOR_NAME',
59
64
  'GIT_AUTHOR_EMAIL',
@@ -70,6 +75,7 @@ function isWithheldEnvName(name: string): boolean {
70
75
  if (RESERVED_SANDBOX_ENV_NAMES.has(name)) return true
71
76
  if (RUNTIME_OWNED_ENV_NAMES.has(name)) return true
72
77
  if (EXECUTION_CONTROL_ENV_NAMES.has(name)) return true
78
+ if (name.startsWith(SECRET_ENV_PREFIX)) return true
73
79
  return EXECUTION_CONTROL_ENV_PREFIXES.some((prefix) => name === prefix || name.startsWith(prefix))
74
80
  }
75
81
 
@@ -94,3 +100,17 @@ export function resolveExposableEnvNames(
94
100
  }
95
101
  return out
96
102
  }
103
+
104
+ // Names `browser_fill_secret` may type: everything bash already sees, plus the
105
+ // withheld `TYPECLAW_SECRET_*` tier. Runtime controls and sandbox-owned names
106
+ // stay out, so the tool can't plant a runtime token into a page for read-back.
107
+ export function resolveFillableEnvNames(
108
+ declaredEnv: ReadonlyMap<string, string>,
109
+ runtimeEnv: Readonly<Record<string, string | undefined>> = {},
110
+ ): string[] {
111
+ const out = resolveExposableEnvNames(declaredEnv, runtimeEnv)
112
+ for (const [name, fileValue] of declaredEnv) {
113
+ if (fileValue.length > 0 && name.startsWith(SECRET_ENV_PREFIX)) out.push(name)
114
+ }
115
+ return out
116
+ }
@@ -6,6 +6,7 @@ import { CORE_PERMISSIONS } from '@/permissions/builtins'
6
6
  import type { PermissionService } from '@/permissions/permissions'
7
7
 
8
8
  import {
9
+ BROWSER_PROFILE_RELATIVE_DIR,
9
10
  CANONICAL_AGENT_SECRET_DIRS,
10
11
  CANONICAL_AGENT_SECRET_FILES,
11
12
  OPERATOR_CLI_CREDENTIAL_DIRS,
@@ -121,11 +122,24 @@ async function verifyRequiredMaskTarget(target: string, kind: 'dir' | 'file'): P
121
122
  if (kind === 'dir' && isCanonicalSecretDir(target)) await rejectHardlinksUnderCanonicalDir(target)
122
123
  }
123
124
 
125
+ // The browser profile grows past the bounded scan through ordinary browsing
126
+ // (Chromium caches use about one file per entry), so scanning it per bash call
127
+ // would eventually block every command. Its only writer is the managed Chrome,
128
+ // which sees nothing but the profile and files directories, and every model tool
129
+ // masks it, so no alias can be planted while the runtime is up. Pre-existing
130
+ // aliases are refused once at browser boot instead (startManagedBrowser), which
131
+ // disables only the browser.
124
132
  function isCanonicalSecretDir(target: string): boolean {
125
- return CANONICAL_AGENT_SECRET_DIRS.some((dir) => target.endsWith(`${sep}${dir.split('/').join(sep)}`))
133
+ return CANONICAL_AGENT_SECRET_DIRS.some(
134
+ (dir) => dir !== BROWSER_PROFILE_RELATIVE_DIR && target.endsWith(`${sep}${dir.split('/').join(sep)}`),
135
+ )
126
136
  }
127
137
 
128
138
  async function rejectHardlinksUnderCanonicalDir(root: string): Promise<void> {
139
+ await rejectHardlinkAliases(root, MAX_CANONICAL_SECRET_SCAN_ENTRIES)
140
+ }
141
+
142
+ export async function rejectHardlinkAliases(root: string, maxEntries = Number.POSITIVE_INFINITY): Promise<void> {
129
143
  const pending = [root]
130
144
  let visited = 0
131
145
  while (pending.length > 0) {
@@ -136,7 +150,7 @@ async function rejectHardlinksUnderCanonicalDir(root: string): Promise<void> {
136
150
  try {
137
151
  for await (const entry of dir) {
138
152
  visited += 1
139
- if (visited > MAX_CANONICAL_SECRET_SCAN_ENTRIES) {
153
+ if (visited > maxEntries) {
140
154
  throw new SandboxMaskTargetError(root, 'canonical secret directory exceeds bounded hardlink scan')
141
155
  }
142
156
  const child = join(current, entry.name)
@@ -230,6 +230,19 @@ export class SecretsBackend implements CredentialStore {
230
230
  }
231
231
  }
232
232
 
233
+ removeGithubCliSync(): void {
234
+ if (!existsSync(this.secretsPath)) return
235
+ let release: (() => void) | undefined
236
+ try {
237
+ release = this.acquireSyncLockWithRetry()
238
+ const { githubCli, ...rest } = this.readEnvelope()
239
+ if (githubCli === undefined) return
240
+ this.writeEnvelopeAtomic(rest)
241
+ } finally {
242
+ release?.()
243
+ }
244
+ }
245
+
233
246
  readMcpCredentialSync(serverName: string): McpCredential | undefined {
234
247
  if (!existsSync(this.secretsPath)) return undefined
235
248
  let release: (() => void) | undefined
@@ -220,6 +220,7 @@ type SessionState = {
220
220
  // generation that ran session.start. A plugin reload mid-connection does
221
221
  // not re-target this session's lifecycle hooks.
222
222
  runtimeSnapshot: PluginRuntimeState | null
223
+ sessionStarted: boolean
223
224
  unsubTurnOutcome: Unsubscribe | null
224
225
  // Serializes outcome persistence and the idle continuation decision. The
225
226
  // tail always fulfills so one disk failure cannot poison every later turn;
@@ -313,6 +314,7 @@ export function createServer({
313
314
  runIdleContinuation: todoIdleContinuation = runIdleContinuation,
314
315
  }: ServerOptions) {
315
316
  const sessionStates = new WeakMap<Ws, SessionState>()
317
+ const initializingSessions = new WeakMap<Ws, Promise<void>>()
316
318
  const callIdToWs = new Map<string, AnyOwnerWs>()
317
319
 
318
320
  // The first TUI WS open per container lifetime checks for
@@ -513,8 +515,11 @@ export function createServer({
513
515
  if (rawWs.data.kind === 'tunnel-logs') return
514
516
  if (rawWs.data.kind === 'inspect') return
515
517
  const ws = rawWs as Ws
518
+ const initialized = Promise.withResolvers<void>()
519
+ initializingSessions.set(ws, initialized.promise)
516
520
  try {
517
521
  const handoff = await takeRestartHandoff()
522
+ if (ws.readyState !== WebSocket.OPEN) return
518
523
  const resumed = handoff !== null ? resumeFromHandoff(handoff, sessionFactory) : null
519
524
  const sessionManager = resumed ?? sessionFactory?.createPersisted()
520
525
  const sessionFileId = sessionManager?.getSessionId() ?? ws.data.sessionId
@@ -576,6 +581,7 @@ export function createServer({
576
581
  unsubClaim: null,
577
582
  activeClaimCode: null,
578
583
  runtimeSnapshot: runtimeSnapshot ?? null,
584
+ sessionStarted: false,
579
585
  unsubTurnOutcome: null,
580
586
  todoOutcomeWrite: Promise.resolve(true),
581
587
  todoContinuation: { recordTurnOutcome: todoOutcomeWriter, runIdleContinuation: todoIdleContinuation },
@@ -583,10 +589,14 @@ export function createServer({
583
589
  dispose,
584
590
  }
585
591
  sessionStates.set(ws, state)
592
+ // Close owns disposal, including a factory result that arrives after disconnect.
593
+ if (ws.readyState !== WebSocket.OPEN) return
586
594
 
587
595
  if (runtimeSnapshot !== undefined && agentDir !== undefined) {
596
+ state.sessionStarted = true
588
597
  await runtimeSnapshot.hooks.runSessionStart({ sessionId: sessionFileId, agentDir })
589
598
  }
599
+ if (ws.readyState !== WebSocket.OPEN) return
590
600
 
591
601
  if (agentDir !== undefined) {
592
602
  state.unsubTurnOutcome = subscribeTurnOutcome(state, agentDir, logger)
@@ -653,6 +663,7 @@ export function createServer({
653
663
  logger.error(`[server] ${sessionFileId}: clear abort suppression failed: ${describeErr(err)}`),
654
664
  )
655
665
  }
666
+ if (ws.readyState !== WebSocket.OPEN) return
656
667
  stream.publish({
657
668
  target: { kind: 'session', sessionId: sessionFileId },
658
669
  payload: { kind: 'prompt', text: ' ', delivery: 'queue' },
@@ -664,6 +675,9 @@ export function createServer({
664
675
  console.error(`session ${ws.data.sessionId}: open failed: ${message}`)
665
676
  send(ws, { type: 'error', message })
666
677
  ws.close()
678
+ } finally {
679
+ initialized.resolve()
680
+ initializingSessions.delete(ws)
667
681
  }
668
682
  },
669
683
  async message(rawWs, raw) {
@@ -903,26 +917,47 @@ export function createServer({
903
917
  return
904
918
  }
905
919
  const ws = rawWs as Ws
906
- const state = sessionStates.get(ws)
907
- state?.unsubBroadcast?.()
908
- state?.unsubPrompts?.()
909
- state?.unsubClaim?.()
910
- if (state?.activeClaimCode !== null && state?.activeClaimCode !== undefined && claimController) {
911
- claimController.cancelClaim(state.activeClaimCode)
912
- }
913
920
  commandRunner?.abortForOwner(ws)
914
921
  for (const [callId, owner] of callIdToWs) {
915
922
  if (owner === ws) callIdToWs.delete(callId)
916
923
  }
924
+ // Do not run session.end/dispose while session creation or session.start is pending.
925
+ await initializingSessions.get(ws)
926
+ const state = sessionStates.get(ws)
917
927
  try {
918
- if (state && state.runtimeSnapshot !== null) {
928
+ state?.unsubBroadcast?.()
929
+ state?.unsubPrompts?.()
930
+ state?.unsubClaim?.()
931
+ if (state?.activeClaimCode !== null && state?.activeClaimCode !== undefined && claimController) {
932
+ claimController.cancelClaim(state.activeClaimCode)
933
+ }
934
+ if (state?.sessionStarted && state.runtimeSnapshot !== null) {
919
935
  await state.runtimeSnapshot.hooks.runSessionEnd({ sessionId: state.sessionFileId, origin: state.origin })
920
936
  }
937
+ } catch (err) {
938
+ logger.error(
939
+ `[server] ${state?.sessionFileId ?? ws.data.sessionId}: close cleanup failed: ${describeErr(err)}`,
940
+ )
941
+ }
942
+ try {
943
+ try {
944
+ state?.unsubTurnOutcome?.()
945
+ } finally {
946
+ state?.session.dispose()
947
+ }
948
+ } catch (err) {
949
+ logger.error(
950
+ `[server] ${state?.sessionFileId ?? ws.data.sessionId}: session disposal failed: ${describeErr(err)}`,
951
+ )
952
+ }
953
+ try {
954
+ await state?.dispose()
955
+ } catch (err) {
956
+ logger.error(
957
+ `[server] ${state?.sessionFileId ?? ws.data.sessionId}: resource disposal failed: ${describeErr(err)}`,
958
+ )
921
959
  } finally {
922
960
  if (state) {
923
- state.unsubTurnOutcome?.()
924
- state.session.dispose()
925
- await state.dispose()
926
961
  liveSessionRegistry?.unregister(state.sessionFileId)
927
962
  }
928
963
  sessionStates.delete(ws)
@@ -10,9 +10,9 @@ GitHub renders normal Markdown in issues, PRs, discussions, and review comments.
10
10
  - For PR review threads, keep `thread` set to reply in-place. Omit `thread` for a top-level PR/issue comment.
11
11
  - When a review comment **you authored** has been addressed, resolve its thread by replying with `channel_reply({ …, resolve_review_thread: true })` — see "Resolving review threads you authored" below. The base principle is **whoever opened the thread closes it**: you resolve only the threads you started, never a human's (the runtime enforces this).
12
12
 
13
- ## Mid-turn status replies need `more_work_this_turn: true`
13
+ ## Mid-turn status replies need `continue_after_reply: true`
14
14
 
15
- A successful `channel_reply` ends your turn by default — the runtime stops the model right after the reply lands. That is correct for a final answer, but it will **silently truncate** a turn that still has work to do. If you post a status line like "Reviewing now, I'll be back with findings" and then expect to keep working (fetch the diff, spawn the reviewer, post the review) in the **same** turn, you must call `channel_reply({ text: "…", more_work_this_turn: true })`. Without `more_work_this_turn: true`, the turn ends at that status reply and the review never runs. Reserve `more_work_this_turn: true` for genuine multi-step turns; the final reply that wraps up the turn sets `more_work_this_turn: false`. The field is required — every `channel_reply` must set it explicitly, so never omit it.
15
+ A successful `channel_reply` ends your turn by default — the runtime stops the model right after the reply lands. That is correct for a final answer, but it will **silently truncate** a turn that still has work to do. If you post a status line like "Reviewing now, I'll be back with findings" and then expect to keep working (fetch the diff, spawn the reviewer, post the review) in the **same** turn, you must call `channel_reply({ text: "…", continue_after_reply: true })`. Without `continue_after_reply: true`, the turn ends at that status reply and the review never runs. Reserve `continue_after_reply: true` for genuine multi-step turns; the final reply that wraps up the turn sets `continue_after_reply: false`. The field is required — every `channel_reply` must set it explicitly, so never omit it.
16
16
 
17
17
  ## Inbound triage — do this first, every time
18
18
 
@@ -80,7 +80,7 @@ The flow:
80
80
  gh pr checkout <N> --repo owner/repo
81
81
  ```
82
82
 
83
- After the operator confirms the checkout, make the minimal fixes and commit them locally with `typeclaw-git` hygiene. Pushing is **not** host-stage only when an eligible broker credential exists. Credential precedence is GitHub App, then an authorized PAT declared in `.env`, then the trusted GitHub CLI store. A configured GitHub remote can use the store fallback from any accessible repository path. The store accepts one configured destination and does not accept explicit-URL or `--set-upstream` pushes.
83
+ After the operator confirms the checkout, make the minimal fixes and commit them locally with `typeclaw-git` hygiene. Pushing is **not** host-stage only when an eligible broker credential exists. Credential precedence is GitHub App, then an authorized PAT declared in `.env`. The trusted GitHub CLI store is never a push credential: it funds `gh` work only.
84
84
 
85
85
  ```sh
86
86
  git -C <checkout> push origin <branch>
@@ -236,7 +236,7 @@ A finding is "actionable" if its severity is `blocker`, `concern`, or `nit`. The
236
236
  - `comment` → post the summary as the substantive top-level PR reply with `channel_reply`. **Exception — re-reviews:** if an unresolved blocking obligation exists, a top-level comment discharges neither form of block. Use `post_github_review` to land a fresh formal verdict instead.
237
237
  - `request-changes` → call `post_github_review({ event: "REQUEST_CHANGES", body: "<summary>" })`. This combination is rare; faithfully encode the reviewer's verdict.
238
238
 
239
- The bundled `agent-browser` is **not** for PR reviews — `gh api` is faster and more reliable. Only use the browser when the API genuinely can't reach what you need.
239
+ The browser (`agent-browser` or any other enabled engine) is **not** for PR reviews — `gh api` is faster and more reliable. Only use the browser when the API genuinely can't reach what you need.
240
240
 
241
241
  ## Resolving review threads you authored
242
242
 
@@ -265,10 +265,10 @@ If the author merely **replied** without pushing (e.g. "this is intentional beca
265
265
  Once you have verified the fix, **acknowledge and resolve in one call**: pass `resolve_review_thread: true` to your `channel_reply`. The runtime resolves the thread you're replying in **before** it posts your acknowledgement, then posts the reply:
266
266
 
267
267
  ```
268
- channel_reply({ text: "Verified — the fix addresses the concern. Thanks!", more_work_this_turn: false, resolve_review_thread: true })
268
+ channel_reply({ text: "Verified — the fix addresses the concern. Thanks!", continue_after_reply: false, resolve_review_thread: true })
269
269
  ```
270
270
 
271
- This is the correct path and it removes a footgun. A bare `channel_reply` ends your turn the moment it lands, so a resolve attempted _after_ the acknowledgement would never run — the thread would stay open even though you "handled" it. The flag resolves first, so a normal final reply still closes the thread. You do **not** need `more_work_this_turn: true` for this: resolution happens inside the same call, before the turn ends.
271
+ This is the correct path and it removes a footgun. A bare `channel_reply` ends your turn the moment it lands, so a resolve attempted _after_ the acknowledgement would never run — the thread would stay open even though you "handled" it. The flag resolves first, so a normal final reply still closes the thread. You do **not** need `continue_after_reply: true` for this: resolution happens inside the same call, before the turn ends.
272
272
 
273
273
  Two guarantees make the flag safe to use as your default:
274
274
 
@@ -313,13 +313,13 @@ gh issue create --repo owner/repo --title 'Bug: ...' --body '...'
313
313
 
314
314
  ```
315
315
 
316
- For a pull request from any accessible project checkout, push the head branch yourself when an eligible broker credential exists. Credential precedence is GitHub App, then an authorized PAT declared in `.env`, then the trusted GitHub CLI store. The store can fund a configured GitHub remote from `workspace`, mounts, nested repositories, or `/tmp`; it requires one configured destination and does not accept explicit-URL or `--set-upstream` pushes. Name the checkout, remote, and branch explicitly:
316
+ For a pull request from any accessible project checkout, push the head branch yourself when an eligible broker credential exists. Credential precedence is GitHub App, then an authorized PAT declared in `.env`. The trusted GitHub CLI store is never a push credential: it funds `gh` work only. Name the checkout, remote, and branch explicitly:
317
317
 
318
318
  ```sh
319
319
  git -C <checkout> push <remote> <branch>
320
320
  ```
321
321
 
322
- If the trusted store is unavailable, ask the operator to run `gh auth login --hostname github.com` on the host. The next real `typeclaw start` or `typeclaw restart` refreshes the stored account automatically; a start that finds the container already running does not.
322
+ If a push is refused for missing credentials, ask the operator for GitHub App auth under `channels.github` or a `GH_TOKEN` in the agent `.env` — never a host `gh` login, which does not fund pushes. If brokered `gh` itself is unauthenticated, the operator enables `githubCli.importHostAuth` and runs `gh auth login --hostname github.com` on the host; the next real `typeclaw start` or `typeclaw restart` refreshes the stored account automatically, and a start that finds the container already running does not.
323
323
 
324
324
  Then open the PR yourself with every field explicit and inline: `gh pr create --repo owner/repo --title 'Fix: ...' --body '...' --head my-branch --base main` (add `--draft` if wanted). `--repo`, `--head`, `--base`, `--title` and `--body` are all required; `--fill`, `--body-file`, `--template`, `--editor`, `--web` and `--attach` are refused because they read local files or open an editor/browser while the credential is live. Without `--head`, gh would interrogate the checkout and offer to push, so always name the already-pushed branch.
325
325