typeclaw 0.49.0 → 0.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (502) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/bash-sandbox-env.d.ts +15 -0
  4. package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
  5. package/dist/types/agent/bash-sandbox.d.ts +94 -0
  6. package/dist/types/agent/compaction.d.ts +8 -0
  7. package/dist/types/agent/git-nudge.d.ts +6 -0
  8. package/dist/types/agent/guard-types.d.ts +25 -0
  9. package/dist/types/agent/guards.d.ts +7 -0
  10. package/dist/types/agent/idle-compaction.d.ts +8 -0
  11. package/dist/types/agent/index.d.ts +151 -0
  12. package/dist/types/agent/live-subagents.d.ts +113 -0
  13. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  14. package/dist/types/agent/loop-guard.d.ts +67 -0
  15. package/dist/types/agent/model-fallback.d.ts +29 -0
  16. package/dist/types/agent/model-overrides.d.ts +8 -0
  17. package/dist/types/agent/multimodal/index.d.ts +2 -0
  18. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  19. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  20. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  21. package/dist/types/agent/network/response-body.d.ts +1 -0
  22. package/dist/types/agent/network/safe-http.d.ts +46 -0
  23. package/dist/types/agent/output-allowance.d.ts +4 -0
  24. package/dist/types/agent/plugin-tools.d.ts +58 -0
  25. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  26. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  27. package/dist/types/agent/provider-error.d.ts +23 -0
  28. package/dist/types/agent/reload-tool.d.ts +10 -0
  29. package/dist/types/agent/restart/index.d.ts +31 -0
  30. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  31. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  32. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  33. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  34. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  35. package/dist/types/agent/self.d.ts +1 -0
  36. package/dist/types/agent/session-meta.d.ts +28 -0
  37. package/dist/types/agent/session-origin.d.ts +65 -0
  38. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  39. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  40. package/dist/types/agent/subagent-drain.d.ts +25 -0
  41. package/dist/types/agent/subagent-session.d.ts +3 -0
  42. package/dist/types/agent/subagents.d.ts +153 -0
  43. package/dist/types/agent/system-prompt-composition.d.ts +17 -0
  44. package/dist/types/agent/system-prompt.d.ts +7 -0
  45. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  46. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  47. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  48. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  49. package/dist/types/agent/todo/continuation.d.ts +21 -0
  50. package/dist/types/agent/todo/scope.d.ts +6 -0
  51. package/dist/types/agent/todo/store.d.ts +16 -0
  52. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  53. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  54. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  55. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  56. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  57. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  58. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  59. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  60. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  61. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  62. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  63. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  64. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  65. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  66. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  67. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  68. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  69. package/dist/types/agent/tools/ddg.d.ts +27 -0
  70. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  71. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  72. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  73. package/dist/types/agent/tools/restart.d.ts +25 -0
  74. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  75. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  76. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  77. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  78. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  79. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  80. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  81. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  82. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  83. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  84. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  85. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  86. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  87. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  88. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  89. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  90. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  91. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  92. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  93. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  94. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  95. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  96. package/dist/types/agent/tools/websearch.d.ts +17 -0
  97. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  98. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  99. package/dist/types/agent/turn-runner.d.ts +36 -0
  100. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  101. package/dist/types/browser/dockerfile.d.ts +2 -0
  102. package/dist/types/browser/registry.d.ts +49 -0
  103. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  104. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  105. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  106. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  107. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  108. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  109. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  110. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  111. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  112. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  113. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  114. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  115. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  116. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  117. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  118. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  119. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  120. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  121. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  122. package/dist/types/channels/background-handoff.d.ts +56 -0
  123. package/dist/types/channels/background-obligations.d.ts +135 -0
  124. package/dist/types/channels/catch-up.d.ts +26 -0
  125. package/dist/types/channels/commands.d.ts +2 -0
  126. package/dist/types/channels/completion-claim.d.ts +20 -0
  127. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  128. package/dist/types/channels/continuity-types.d.ts +75 -0
  129. package/dist/types/channels/describe-error.d.ts +1 -0
  130. package/dist/types/channels/engagement.d.ts +34 -0
  131. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  132. package/dist/types/channels/github-repo.d.ts +2 -0
  133. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  134. package/dist/types/channels/github-review-check.d.ts +135 -0
  135. package/dist/types/channels/github-review-claim.d.ts +3 -0
  136. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  137. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  138. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  139. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  140. package/dist/types/channels/inbound-journal.d.ts +272 -0
  141. package/dist/types/channels/last-alive.d.ts +3 -0
  142. package/dist/types/channels/membership-cache.d.ts +27 -0
  143. package/dist/types/channels/membership.d.ts +21 -0
  144. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  145. package/dist/types/channels/participants.d.ts +4 -0
  146. package/dist/types/channels/persistence.d.ts +32 -0
  147. package/dist/types/channels/recovery-notice.d.ts +26 -0
  148. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  149. package/dist/types/channels/router.d.ts +760 -0
  150. package/dist/types/channels/schema.d.ts +501 -0
  151. package/dist/types/channels/session-handoff.d.ts +58 -0
  152. package/dist/types/channels/session-search.d.ts +29 -0
  153. package/dist/types/channels/types.d.ts +414 -0
  154. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  155. package/dist/types/cli/builtins.d.ts +2 -0
  156. package/dist/types/cli/command-meta.d.ts +9 -0
  157. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  158. package/dist/types/coding-agent/broker.d.ts +22 -0
  159. package/dist/types/coding-agent/claude.d.ts +22 -0
  160. package/dist/types/coding-agent/codex.d.ts +19 -0
  161. package/dist/types/coding-agent/index.d.ts +71 -0
  162. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  163. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  164. package/dist/types/coding-agent/omo.d.ts +133 -0
  165. package/dist/types/coding-agent/runner.d.ts +35 -0
  166. package/dist/types/coding-agent/tool.d.ts +27 -0
  167. package/dist/types/coding-agent/worktree.d.ts +22 -0
  168. package/dist/types/commands/index.d.ts +45 -0
  169. package/dist/types/config/config.d.ts +827 -0
  170. package/dist/types/config/index.d.ts +3 -0
  171. package/dist/types/config/model-overrides.d.ts +3 -0
  172. package/dist/types/config/providers.d.ts +1458 -0
  173. package/dist/types/config/reloadable.d.ts +9 -0
  174. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  175. package/dist/types/container/build-cache.d.ts +39 -0
  176. package/dist/types/container/compose-project.d.ts +1 -0
  177. package/dist/types/container/controller.d.ts +25 -0
  178. package/dist/types/container/docker-app.d.ts +23 -0
  179. package/dist/types/container/exit-reason.d.ts +10 -0
  180. package/dist/types/container/index.d.ts +14 -0
  181. package/dist/types/container/log-archive.d.ts +68 -0
  182. package/dist/types/container/log-colors.d.ts +3 -0
  183. package/dist/types/container/log-timestamps.d.ts +9 -0
  184. package/dist/types/container/logs.d.ts +37 -0
  185. package/dist/types/container/memory-limit.d.ts +13 -0
  186. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  187. package/dist/types/container/oom-events.d.ts +18 -0
  188. package/dist/types/container/port.d.ts +18 -0
  189. package/dist/types/container/require-running.d.ts +16 -0
  190. package/dist/types/container/restart.d.ts +32 -0
  191. package/dist/types/container/shared.d.ts +93 -0
  192. package/dist/types/container/shell.d.ts +35 -0
  193. package/dist/types/container/start.d.ts +145 -0
  194. package/dist/types/container/stats.d.ts +31 -0
  195. package/dist/types/container/status.d.ts +25 -0
  196. package/dist/types/container/stop.d.ts +24 -0
  197. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  198. package/dist/types/container/verify-running.d.ts +49 -0
  199. package/dist/types/cron/consumer.d.ts +42 -0
  200. package/dist/types/cron/count-state.d.ts +24 -0
  201. package/dist/types/cron/index.d.ts +21 -0
  202. package/dist/types/cron/list.d.ts +33 -0
  203. package/dist/types/cron/reloadable.d.ts +11 -0
  204. package/dist/types/cron/scheduler.d.ts +51 -0
  205. package/dist/types/cron/schema.d.ts +108 -0
  206. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  207. package/dist/types/dependencies/bins.d.ts +22 -0
  208. package/dist/types/dependencies/index.d.ts +2 -0
  209. package/dist/types/eval/cell.d.ts +26 -0
  210. package/dist/types/eval/config.d.ts +19 -0
  211. package/dist/types/eval/dispatch.d.ts +7 -0
  212. package/dist/types/eval/kernel.d.ts +28 -0
  213. package/dist/types/eval/process.d.ts +23 -0
  214. package/dist/types/eval/protocol.d.ts +34 -0
  215. package/dist/types/eval/sandbox.d.ts +10 -0
  216. package/dist/types/eval/tool.d.ts +17 -0
  217. package/dist/types/eval/wire.d.ts +33 -0
  218. package/dist/types/git/bound-gc-config.d.ts +4 -0
  219. package/dist/types/git/hookless.d.ts +1 -0
  220. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  221. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  222. package/dist/types/git/resolve-identity.d.ts +10 -0
  223. package/dist/types/git/run.d.ts +24 -0
  224. package/dist/types/git/system-commit.d.ts +2 -0
  225. package/dist/types/hostd/client.d.ts +13 -0
  226. package/dist/types/hostd/models.d.ts +1 -0
  227. package/dist/types/hostd/paths.d.ts +17 -0
  228. package/dist/types/hostd/protocol.d.ts +93 -0
  229. package/dist/types/hostd/spawn.d.ts +17 -0
  230. package/dist/types/hostd/version.d.ts +18 -0
  231. package/dist/types/init/auto-upgrade.d.ts +41 -0
  232. package/dist/types/init/cli-version.d.ts +7 -0
  233. package/dist/types/init/dockerfile.d.ts +34 -0
  234. package/dist/types/init/ensure-deps.d.ts +17 -0
  235. package/dist/types/init/env-file.d.ts +3 -0
  236. package/dist/types/init/gitignore.d.ts +5 -0
  237. package/dist/types/init/local-source-stamp.d.ts +3 -0
  238. package/dist/types/init/packagejson.d.ts +7 -0
  239. package/dist/types/init/paths.d.ts +3 -0
  240. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  241. package/dist/types/init/run-bun-install.d.ts +16 -0
  242. package/dist/types/init/windows-dev-link.d.ts +8 -0
  243. package/dist/types/mcp/catalog.d.ts +7 -0
  244. package/dist/types/mcp/client.d.ts +58 -0
  245. package/dist/types/mcp/manager.d.ts +56 -0
  246. package/dist/types/mcp/tools.d.ts +23 -0
  247. package/dist/types/models/embedding-model.d.ts +20 -0
  248. package/dist/types/models/transformers-version.d.ts +1 -0
  249. package/dist/types/network/internal-destinations.d.ts +29 -0
  250. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  251. package/dist/types/operations/incidents.d.ts +47 -0
  252. package/dist/types/operations/index.d.ts +3 -0
  253. package/dist/types/operations/remediations.d.ts +25 -0
  254. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  255. package/dist/types/permissions/builtins.d.ts +25 -0
  256. package/dist/types/permissions/grant.d.ts +19 -0
  257. package/dist/types/permissions/index.d.ts +6 -0
  258. package/dist/types/permissions/match-rule.d.ts +28 -0
  259. package/dist/types/permissions/permissions.d.ts +42 -0
  260. package/dist/types/permissions/resolve.d.ts +25 -0
  261. package/dist/types/permissions/schema.d.ts +14 -0
  262. package/dist/types/plugin/context.d.ts +20 -0
  263. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  264. package/dist/types/plugin/define.d.ts +46 -0
  265. package/dist/types/plugin/hooks.d.ts +52 -0
  266. package/dist/types/plugin/index.d.ts +11 -0
  267. package/dist/types/plugin/load-skill.d.ts +14 -0
  268. package/dist/types/plugin/loader.d.ts +25 -0
  269. package/dist/types/plugin/manager.d.ts +42 -0
  270. package/dist/types/plugin/registry.d.ts +73 -0
  271. package/dist/types/plugin/skills.d.ts +11 -0
  272. package/dist/types/plugin/types.d.ts +336 -0
  273. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  274. package/dist/types/reload/client.d.ts +11 -0
  275. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  276. package/dist/types/reload/format.d.ts +2 -0
  277. package/dist/types/reload/index.d.ts +6 -0
  278. package/dist/types/reload/recover.d.ts +22 -0
  279. package/dist/types/reload/registry.d.ts +10 -0
  280. package/dist/types/reload/types.d.ts +25 -0
  281. package/dist/types/role-claim/client.d.ts +20 -0
  282. package/dist/types/role-claim/code.d.ts +4 -0
  283. package/dist/types/role-claim/controller.d.ts +59 -0
  284. package/dist/types/role-claim/index.d.ts +6 -0
  285. package/dist/types/role-claim/match-rule.d.ts +9 -0
  286. package/dist/types/role-claim/pending.d.ts +35 -0
  287. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  288. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  289. package/dist/types/sandbox/availability.d.ts +21 -0
  290. package/dist/types/sandbox/build.d.ts +7 -0
  291. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  292. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  293. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  294. package/dist/types/sandbox/dev-source.d.ts +4 -0
  295. package/dist/types/sandbox/env-exposure.d.ts +3 -0
  296. package/dist/types/sandbox/errors.d.ts +20 -0
  297. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  298. package/dist/types/sandbox/index.d.ts +14 -0
  299. package/dist/types/sandbox/package-install.d.ts +1 -0
  300. package/dist/types/sandbox/policy.d.ts +71 -0
  301. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  302. package/dist/types/sandbox/quote.d.ts +2 -0
  303. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  304. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  305. package/dist/types/sandbox/symlinks.d.ts +6 -0
  306. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  307. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  308. package/dist/types/secrets/defaults.d.ts +21 -0
  309. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  310. package/dist/types/secrets/hydrate.d.ts +7 -0
  311. package/dist/types/secrets/index.d.ts +7 -0
  312. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  313. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  314. package/dist/types/secrets/resolve.d.ts +14 -0
  315. package/dist/types/secrets/schema.d.ts +840 -0
  316. package/dist/types/secrets/storage.d.ts +56 -0
  317. package/dist/types/shared/host-locale.d.ts +1 -0
  318. package/dist/types/shared/index.d.ts +5 -0
  319. package/dist/types/shared/local-time.d.ts +4 -0
  320. package/dist/types/shared/platform.d.ts +2 -0
  321. package/dist/types/shared/protocol.d.ts +424 -0
  322. package/dist/types/shared/style-text.d.ts +3 -0
  323. package/dist/types/shared/wsl.d.ts +17 -0
  324. package/dist/types/stream/broker.d.ts +2 -0
  325. package/dist/types/stream/index.d.ts +2 -0
  326. package/dist/types/stream/types.d.ts +71 -0
  327. package/package.json +13 -6
  328. package/scripts/build-plugin-types.ts +105 -0
  329. package/scripts/check-plugin-sdk.ts +111 -0
  330. package/scripts/require-parallel.ts +5 -32
  331. package/src/agent/bash-sandbox-env.ts +104 -0
  332. package/src/agent/bash-sandbox-proc.ts +70 -0
  333. package/src/agent/bash-sandbox.ts +225 -0
  334. package/src/agent/compaction.ts +22 -10
  335. package/src/agent/guard-types.ts +3 -0
  336. package/src/agent/guards.ts +4 -0
  337. package/src/agent/idle-compaction.ts +178 -0
  338. package/src/agent/index.ts +139 -172
  339. package/src/agent/live-subagents.ts +19 -0
  340. package/src/agent/multimodal/look-at.ts +22 -9
  341. package/src/agent/output-allowance.ts +7 -0
  342. package/src/agent/plugin-tools.ts +39 -377
  343. package/src/agent/reviewer-bash-policy.ts +41 -1
  344. package/src/agent/session-origin.ts +28 -11
  345. package/src/agent/subagent-cache-keepalive.ts +198 -0
  346. package/src/agent/subagent-completion-reminder.ts +2 -2
  347. package/src/agent/subagent-session.ts +6 -0
  348. package/src/agent/subagents.ts +46 -8
  349. package/src/agent/system-prompt-composition.ts +141 -0
  350. package/src/agent/system-prompt.ts +5 -5
  351. package/src/agent/todo/scope.ts +1 -1
  352. package/src/agent/tool-file-safety.ts +6 -1
  353. package/src/agent/tools/channel-edit.ts +20 -10
  354. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  355. package/src/agent/tools/channel-handoff.ts +72 -0
  356. package/src/agent/tools/channel-read.ts +57 -10
  357. package/src/agent/tools/channel-reply.ts +33 -26
  358. package/src/agent/tools/channel-send.ts +21 -13
  359. package/src/agent/tools/channel-session-search.ts +35 -0
  360. package/src/agent/tools/curl-impersonate.ts +11 -4
  361. package/src/agent/tools/ddg.ts +84 -16
  362. package/src/agent/tools/spawn-subagent.ts +27 -11
  363. package/src/agent/tools/stream-snapshot.ts +15 -2
  364. package/src/agent/tools/subagent-access.ts +11 -4
  365. package/src/agent/tools-without-local-file-operands.ts +4 -0
  366. package/src/browser/bsk-shim.mjs +74 -0
  367. package/src/browser/dockerfile.ts +84 -0
  368. package/src/browser/egress.ts +104 -0
  369. package/src/browser/fill-secret.ts +307 -0
  370. package/src/browser/managed-browser.ts +205 -0
  371. package/src/browser/registry.ts +110 -0
  372. package/src/browser/relay.ts +231 -0
  373. package/src/browser/sandbox-entry.ts +167 -0
  374. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  375. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  376. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  377. package/src/bundled-plugins/doc-render/index.ts +0 -10
  378. package/src/bundled-plugins/doc-render/render.ts +83 -111
  379. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  380. package/src/bundled-plugins/explorer/explorer.ts +1 -1
  381. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  382. package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
  383. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  384. package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
  385. package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
  386. package/src/bundled-plugins/managed-browser/index.ts +179 -0
  387. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  388. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  389. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  390. package/src/bundled-plugins/memory/dreaming.ts +4 -1
  391. package/src/bundled-plugins/memory/load-memory.ts +2 -4
  392. package/src/bundled-plugins/memory/memory-logger.ts +74 -2
  393. package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
  394. package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
  395. package/src/bundled-plugins/operator/operator.ts +1 -1
  396. package/src/bundled-plugins/qa/index.ts +11 -0
  397. package/src/bundled-plugins/qa/qa.ts +160 -0
  398. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  399. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  400. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  401. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  402. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  403. package/src/bundled-plugins/security/index.ts +53 -34
  404. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  405. package/src/bundled-plugins/security/policies/private-surface-read.ts +166 -201
  406. package/src/channels/adapter-namespace.ts +13 -0
  407. package/src/channels/adapters/discord-bot-reference.ts +5 -4
  408. package/src/channels/adapters/discord-bot.ts +98 -5
  409. package/src/channels/adapters/discord-classify.ts +8 -3
  410. package/src/channels/adapters/discord.ts +29 -0
  411. package/src/channels/adapters/github/index.ts +16 -0
  412. package/src/channels/adapters/github/last-alive.ts +4 -16
  413. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  414. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  415. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  416. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  417. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  418. package/src/channels/adapters/slack-bot.ts +299 -67
  419. package/src/channels/adapters/slack-classify.ts +1 -0
  420. package/src/channels/catch-up.ts +137 -0
  421. package/src/channels/continuation-willingness.ts +2 -2
  422. package/src/channels/continuity-types.ts +1 -0
  423. package/src/channels/engagement.ts +17 -1
  424. package/src/channels/github-false-receipt.ts +3 -3
  425. package/src/channels/github-rereview-guard.ts +9 -5
  426. package/src/channels/github-review-check.ts +5 -1
  427. package/src/channels/github-review-verdict-coordinator.ts +68 -2
  428. package/src/channels/github-token-bridge.ts +24 -0
  429. package/src/channels/last-alive.ts +34 -0
  430. package/src/channels/manager.ts +8 -1
  431. package/src/channels/router.ts +515 -243
  432. package/src/channels/session-handoff.fixture.ts +144 -0
  433. package/src/channels/session-handoff.ts +175 -0
  434. package/src/channels/session-search.ts +71 -0
  435. package/src/channels/subagent-completion-bridge.ts +3 -2
  436. package/src/channels/types.ts +12 -2
  437. package/src/cli/channel.ts +2 -3
  438. package/src/cli/hostd.ts +3 -0
  439. package/src/cli/init.ts +2 -3
  440. package/src/cli/model.ts +132 -3
  441. package/src/coding-agent/index.ts +7 -1
  442. package/src/coding-agent/omo-stream.ts +40 -0
  443. package/src/coding-agent/runner.ts +30 -8
  444. package/src/config/config.ts +126 -22
  445. package/src/config/model-overrides.ts +59 -0
  446. package/src/config/models-mutation.ts +185 -2
  447. package/src/config/providers-mutation.ts +12 -4
  448. package/src/config/providers.ts +69 -4
  449. package/src/container/start.ts +132 -5
  450. package/src/doctor/checks.ts +33 -22
  451. package/src/doctor/index.ts +48 -12
  452. package/src/doctor/operational-incidents.ts +16 -1
  453. package/src/doctor/plugin-bridge.ts +14 -1
  454. package/src/doctor/stage.ts +14 -0
  455. package/src/doctor/types.ts +6 -0
  456. package/src/eval/cell.ts +93 -0
  457. package/src/eval/config.ts +32 -0
  458. package/src/eval/dispatch.ts +67 -0
  459. package/src/eval/entry.ts +261 -0
  460. package/src/eval/kernel.ts +154 -0
  461. package/src/eval/process.ts +113 -0
  462. package/src/eval/protocol.ts +26 -0
  463. package/src/eval/redeclare.ts +174 -0
  464. package/src/eval/sandbox.ts +114 -0
  465. package/src/eval/tool.ts +98 -0
  466. package/src/eval/wire.ts +93 -0
  467. package/src/hostd/daemon.ts +13 -1
  468. package/src/init/auto-upgrade.ts +7 -1
  469. package/src/init/dockerfile.ts +57 -12
  470. package/src/init/index.ts +4 -3
  471. package/src/init/local-source-stamp.ts +68 -0
  472. package/src/init/models-dev.ts +4 -0
  473. package/src/init/validate-api-key.ts +3 -0
  474. package/src/operations/classify-tool-outcome.ts +1 -1
  475. package/src/permissions/builtins.ts +7 -0
  476. package/src/permissions/permissions.ts +18 -9
  477. package/src/permissions/resolve.ts +7 -1
  478. package/src/plugin/context.ts +2 -0
  479. package/src/plugin/core-tool-names.ts +6 -1
  480. package/src/plugin/hooks.ts +137 -0
  481. package/src/plugin/index.ts +6 -0
  482. package/src/plugin/manager.ts +4 -0
  483. package/src/plugin/types.ts +60 -0
  484. package/src/run/bundled-plugins.ts +6 -0
  485. package/src/run/index.ts +24 -14
  486. package/src/run/llm-fetch-observer.ts +12 -15
  487. package/src/sandbox/canonical-secrets.ts +4 -0
  488. package/src/sandbox/dev-source.ts +26 -0
  489. package/src/sandbox/env-exposure.ts +20 -0
  490. package/src/sandbox/hidden-paths.ts +16 -2
  491. package/src/secrets/storage.ts +13 -0
  492. package/src/server/index.ts +46 -11
  493. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  494. package/src/skills/typeclaw-config/SKILL.md +57 -5
  495. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  496. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  497. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  498. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  499. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  500. package/typeclaw.schema.json +488 -5
  501. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  502. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -0,0 +1,95 @@
1
+ import { createHash } from 'node:crypto'
2
+
3
+ import { GITHUB_API_BASE, githubJsonHeaders } from '@/channels/adapters/github/auth-pat'
4
+ import type { ToolResult } from '@/plugin'
5
+
6
+ export type GitAuthCredential = { source: string; token: string }
7
+ export type GitAuthLoginResolver = (token: string) => Promise<string | null>
8
+
9
+ let loginResolverForTests: GitAuthLoginResolver | undefined
10
+
11
+ export function setGitAuthLoginResolverForTests(resolver: GitAuthLoginResolver | undefined): void {
12
+ loginResolverForTests = resolver
13
+ }
14
+
15
+ export function createGitAuthLoginResolver(
16
+ lookup: GitAuthLoginResolver = async (token) => {
17
+ if (loginResolverForTests !== undefined) return await loginResolverForTests(token)
18
+ const response = await fetch(`${GITHUB_API_BASE}/user`, {
19
+ headers: githubJsonHeaders(token),
20
+ signal: AbortSignal.timeout(2_000),
21
+ redirect: 'error',
22
+ })
23
+ if (!response.ok) return null
24
+ const user: unknown = await response.json()
25
+ return user !== null && typeof user === 'object' && 'login' in user && typeof user.login === 'string'
26
+ ? user.login
27
+ : null
28
+ },
29
+ ): GitAuthLoginResolver {
30
+ const cache = new Map<string, Promise<string | null>>()
31
+ return (token) => {
32
+ const key = createHash('sha256').update(token).digest('hex')
33
+ let login = cache.get(key)
34
+ if (login === undefined) {
35
+ // Lookup is advisory: neither network errors nor response bodies may replace
36
+ // the git failure or expose a credential through an exception.
37
+ login = Promise.resolve()
38
+ .then(() => lookup(token))
39
+ .catch(() => null)
40
+ cache.set(key, login)
41
+ }
42
+ return login
43
+ }
44
+ }
45
+
46
+ export async function appendGitAuthDiagnostic(options: {
47
+ result: ToolResult
48
+ credentials: readonly GitAuthCredential[]
49
+ ghCredential?: GitAuthCredential
50
+ push: boolean
51
+ resolveLogin: GitAuthLoginResolver
52
+ }): Promise<void> {
53
+ const { result } = options
54
+ const text = result.content
55
+ .filter((part) => part.type === 'text')
56
+ .map((part) => part.text)
57
+ .join('\n')
58
+ const details = result.details
59
+ const failed =
60
+ (details !== null &&
61
+ typeof details === 'object' &&
62
+ (('error' in details && typeof details.error === 'string') ||
63
+ ('exitCode' in details && typeof details.exitCode === 'number' && details.exitCode !== 0))) ||
64
+ /Command (?:failed|exited) with (?:exit )?code [1-9]\d*/i.test(text)
65
+ if (!failed) return
66
+ // These are git/GitHub protocol errors, not natural-language intent matching.
67
+ if (
68
+ !/\b(?:401|403)\b|Permission to .+ denied to |Authentication failed|Invalid username or password|Resource not accessible/i.test(
69
+ text,
70
+ ) &&
71
+ !(options.push && /Repository not found/i.test(text))
72
+ )
73
+ return
74
+
75
+ const used = await Promise.all(
76
+ options.credentials.map(async (credential) => ({
77
+ source: credential.source,
78
+ login: (await options.resolveLogin(credential.token)) ?? 'unknown',
79
+ })),
80
+ )
81
+ let advice = `[github-cli-auth:gitCredential] Git used ${used.map(({ source, login }) => `${source} (login: ${login})`).join('; ')}.`
82
+ if (options.ghCredential !== undefined) {
83
+ const ghLogin = (await options.resolveLogin(options.ghCredential.token)) ?? 'unknown'
84
+ if (used.some(({ login }) => login !== ghLogin)) {
85
+ advice += ` gh for this repo would use ${options.ghCredential.source} (login: ${ghLogin}).`
86
+ }
87
+ }
88
+ advice +=
89
+ ' Operator: fix or remove the mismatched credential (github in secrets.json for the repo token, GH_TOKEN in the agent .env for the declared PAT), then run typeclaw restart. The host gh login never funds git push.'
90
+ // Do not trust lookup output to be secret-free, even when provided by /user.
91
+ for (const credential of [...options.credentials, ...(options.ghCredential ? [options.ghCredential] : [])]) {
92
+ advice = advice.replaceAll(credential.token, '[redacted]')
93
+ }
94
+ result.content.push({ type: 'text', text: advice })
95
+ }
@@ -13,10 +13,11 @@ const NUDGE_TEXT =
13
13
  '`gh api` does not accept `-R/--repo`; TypeClaw consumes it as the mint hint and ' +
14
14
  'strips it before running the command with the right token injected.'
15
15
 
16
- // The shell strips quotes/escapes, so we match the raw `gh ... graphql` substring
17
- // rather than parse — the nudge is advisory, so a loose match is acceptable and a
18
- // false positive only appends a hint to an unrelated failure. Captured through to
19
- // end of line so we can inspect the SAME invocation's flags (see REPO_FLAG).
16
+ // Matched against the command the agent ran, not the tool output: a bash result
17
+ // carries only the process output, so gh's "gh auth login" stderr never names the
18
+ // graphql call that produced it. The nudge is advisory, so a loose substring match
19
+ // is acceptable. Captured through to end of line so we can inspect the SAME
20
+ // invocation's flags (see REPO_FLAG).
20
21
  const GRAPHQL_INVOCATION = /\bgh\b[^\n]*\bapi\b[^\n]*\bgraphql\b[^\n]*/
21
22
 
22
23
  // `-R foo`, `-R=foo`, `--repo foo`, `--repo=foo`. Word-boundary anchored so a
@@ -37,8 +38,12 @@ const AUTH_FAILURE_SIGNATURES = [
37
38
  'gh auth login',
38
39
  ]
39
40
 
40
- export function checkGraphqlAuthNudge(options: { tool: string; result: ToolResult }): void {
41
- if (options.tool !== 'bash') return
41
+ export function checkGraphqlAuthNudge(options: {
42
+ tool: string
43
+ command: string | undefined
44
+ result: ToolResult
45
+ }): void {
46
+ if (options.tool !== 'bash' || options.command === undefined) return
42
47
 
43
48
  // Only meaningful when no usable process token exists. An operator token or a
44
49
  // runtime-seeded PAT means graphql already authenticates, so the advice would
@@ -47,7 +52,7 @@ export function checkGraphqlAuthNudge(options: { tool: string; result: ToolResul
47
52
  if (tokenClass !== 'none') return
48
53
 
49
54
  const text = collectText(options.result.content)
50
- const invocation = GRAPHQL_INVOCATION.exec(text)
55
+ const invocation = GRAPHQL_INVOCATION.exec(options.command)
51
56
  if (invocation === null) return
52
57
  if (!AUTH_FAILURE_SIGNATURES.some((sig) => text.includes(sig))) return
53
58
  if (text.includes(GRAPHQL_AUTH_NUDGE_TAG)) return
@@ -22,17 +22,12 @@ import {
22
22
  canInjectPatIntoPassThroughGh,
23
23
  effectiveGhTokensForAuthenticatedUserEndpoint,
24
24
  effectiveGhTokensForCommand,
25
+ hasGhInvocation,
25
26
  usesGhApiGraphqlEndpoint,
26
27
  } from './gh-command'
27
28
  import { detectReviewDismissal } from './gh-review-detect'
28
- import {
29
- cleanupPreparedGithubStorePush,
30
- GH_STORE_AMBIENT_AUTH_KEYS,
31
- planGithubStorePush,
32
- prepareGithubStorePush,
33
- resolveGithubCliStoreToken,
34
- } from './gh-store'
35
29
  import { ensureGitAskPassHelper, resolveSandboxGitAskPassPath } from './git-askpass'
30
+ import { appendGitAuthDiagnostic, createGitAuthLoginResolver, type GitAuthCredential } from './git-auth-diagnostic'
36
31
  import {
37
32
  analyzeGitCommand,
38
33
  createSessionTmpGitResolvers,
@@ -88,6 +83,18 @@ export default definePlugin({
88
83
  const hasAppTokenResolver = ctx.github.hasAppTokenResolver
89
84
  const trustedGitTransportEnv: NodeJS.ProcessEnv = { ...process.env }
90
85
  const reviewCredentials = new Map<string, GithubTokenCredential>()
86
+ // tool.after only sees the bash output, so the graphql nudge needs the command
87
+ // that ran; keyed by callId like gitAuthDiagnostics.
88
+ const passThroughGraphqlCommands = new Map<string, string>()
89
+ const resolveGitAuthLogin = createGitAuthLoginResolver()
90
+ const gitAuthDiagnostics = new Map<
91
+ string,
92
+ {
93
+ credentials: GitAuthCredential[]
94
+ ghCredential?: GitAuthCredential
95
+ push: boolean
96
+ }
97
+ >()
91
98
 
92
99
  // Every model-driven bash masks the canonical credential files. A role may
93
100
  // still USE a PAT through this runtime-owned overlay, which injects one
@@ -193,18 +200,14 @@ export default definePlugin({
193
200
  const missingAppAuthForPushReason =
194
201
  'Pushing to github.com needs an eligible credential and validated destination, and TypeClaw has nothing it can give this git command. ' +
195
202
  'Operator remedy: declare `GH_TOKEN` in the agent `.env` and restart, configure GitHub App auth under ' +
196
- '`channels.github` for per-repo short-lived tokens, or authenticate host `gh` with ' +
197
- '`gh auth login --hostname github.com`; the next real `typeclaw start` or `typeclaw restart` automatically captures ' +
198
- 'that active account into the trusted-runtime store (a start against an already-running container is a no-op). ' +
203
+ '`channels.github` for per-repo short-lived tokens, or (PAT channel auth) list the repo in ' +
204
+ '`channels.github.repos[]` so its PAT can fund the push. ' +
205
+ 'The host `gh` login never funds a push, even when ' +
206
+ '`githubCli.importHostAuth` is enabled. ' +
199
207
  'If App auth is already configured, the adapter failed to start — check ' +
200
208
  '`typeclaw logs`. Do not retry with ' +
201
209
  '`gh auth setup-git`, a credential helper, or a tokenized remote URL: those are blocked and the ' +
202
210
  'credential files are masked in this sandbox.'
203
- const multiPushStoreReason =
204
- 'The trusted GitHub CLI credential store can fund exactly one configured push repository. ' +
205
- 'This remote has multiple GitHub push destinations; use an authoritative declared PAT or GitHub App auth, ' +
206
- 'or configure exactly one push URL.'
207
-
208
211
  let warnedSandboxedPatWithheld = false
209
212
  const warnSandboxedPatWithheldOnce = (): void => {
210
213
  if (warnedSandboxedPatWithheld) return
@@ -382,6 +385,9 @@ export default definePlugin({
382
385
  workspace: review.detected.workspace,
383
386
  prNumber: review.detected.prNumber,
384
387
  verdict: review.detected.verdict,
388
+ ...(review.detected.reviewedHeadSha !== undefined
389
+ ? { reviewedHeadSha: review.detected.reviewedHeadSha }
390
+ : {}),
385
391
  ...(event.origin?.kind === 'channel' && event.origin.githubReviewRound !== undefined
386
392
  ? { round: event.origin.githubReviewRound, thread: event.origin.thread }
387
393
  : {}),
@@ -416,7 +422,10 @@ export default definePlugin({
416
422
  }
417
423
 
418
424
  if (decision.kind === 'pass-through') {
419
- const patOverlay = canUsePat(event.origin) ? processPatOverlay() : undefined
425
+ // The caller routes on a raw `gh` substring, so `git commit -m "...wright..."`
426
+ // lands here. With no real `gh` invocation there is nothing to broker the
427
+ // PAT to: fall through without the overlay instead of blocking.
428
+ const patOverlay = canUsePat(event.origin) && hasGhInvocation(command) ? processPatOverlay() : undefined
420
429
  if (patOverlay !== undefined) {
421
430
  if (!canInjectPatIntoPassThroughGh(command)) {
422
431
  return blockAfterLease({
@@ -430,6 +439,7 @@ export default definePlugin({
430
439
  const overlay = existing !== null && typeof existing === 'object' ? (existing as Record<string, string>) : {}
431
440
  event.args[TYPECLAW_INTERNAL_BASH_ENV] = { ...overlay, ...patOverlay }
432
441
  }
442
+ if (usesGhApiGraphqlEndpoint(command)) passThroughGraphqlCommands.set(event.callId, command)
433
443
  return 'fall-through'
434
444
  }
435
445
 
@@ -551,6 +561,20 @@ export default definePlugin({
551
561
  decision.pushProvenance?.kind === 'configured-remote'
552
562
  ? decision.pushProvenance.repoSlugs
553
563
  : [decision.repoSlug.toLocaleLowerCase()]
564
+ const noteGitCredential = (credentials: GitAuthCredential[]): void => {
565
+ // Match handleGhCommand's no-minter precedence. With a minter, gh uses
566
+ // the same per-repo credential as git, so no comparison is needed.
567
+ const ghToken = !hasAppTokenResolver()
568
+ ? (sandboxInheritedGhToken() ?? (canUsePat(event.origin) ? effectiveProcessToken() : undefined))
569
+ : undefined
570
+ gitAuthDiagnostics.set(event.callId, {
571
+ credentials,
572
+ ...(ghToken !== undefined
573
+ ? { ghCredential: { source: `github repo token via ${ghToken.envName}`, token: ghToken.value } }
574
+ : {}),
575
+ push: decision.access === 'write',
576
+ })
577
+ }
554
578
 
555
579
  if (!hasAppTokenResolver()) {
556
580
  const declared = declaredGitCredentialState()
@@ -574,54 +598,42 @@ export default definePlugin({
574
598
  // Withhold wins only when the same ambient names are absent from the overlay.
575
599
  event.args[TYPECLAW_INTERNAL_BASH_WITHHOLD_ENV] = ['GH_TOKEN', 'GITHUB_TOKEN']
576
600
  if (decision.rewrittenCommand !== undefined) event.args.command = decision.rewrittenCommand
601
+ noteGitCredential([{ source: `declared .env ${declared.envName}`, token: declared.value }])
577
602
  return
578
603
  }
579
604
  if (decision.access !== 'write') return
580
- if (declared.kind !== 'absent') return { block: true, reason: missingAppAuthForPushReason }
581
- if (destinationRepos.length !== 1) return { block: true, reason: multiPushStoreReason }
582
-
583
- const askpass = await ensureGitAskPassHelper(resolveSandboxGitAskPassPath())
584
- const plan = await planGithubStorePush(decision, { agentDir, sessionId, askpassPath: askpass })
585
- if (plan === null) return { block: true, reason: missingAppAuthForPushReason }
586
- const storeToken = await resolveGithubCliStoreToken()
587
- if (storeToken === null) return { block: true, reason: missingAppAuthForPushReason }
588
- const credentialEnv = await buildGitCredentialOverlay(
589
- [{ repoSlug: plan.repo, token: storeToken }],
590
- event.args[TYPECLAW_INTERNAL_BASH_ENV],
591
- { expectedRemote: plan.remote, trustedEnv: {} },
592
- )
593
- event.args[TYPECLAW_INTERNAL_BASH_ENV] = credentialEnv
594
- const inheritedNames = [
595
- ...Object.keys(process.env),
596
- ...Object.keys(credentialEnv),
597
- 'SSH_ASKPASS',
598
- 'SSH_AUTH_SOCK',
599
- 'HTTP_PROXY',
600
- 'HTTPS_PROXY',
601
- 'ALL_PROXY',
602
- 'http_proxy',
603
- 'https_proxy',
604
- 'all_proxy',
605
- ]
606
- event.args[TYPECLAW_INTERNAL_BASH_WITHHOLD_ENV] = [
607
- ...new Set([
608
- ...GH_STORE_AMBIENT_AUTH_KEYS,
609
- ...inheritedNames.filter(
610
- (name) => name.startsWith('GIT_') || name.startsWith('SSH_') || /proxy/i.test(name),
611
- ),
612
- ]),
613
- ]
614
- event.args[TYPECLAW_INTERNAL_BASH_PREPARE] = async () => {
615
- const prepared = await prepareGithubStorePush(plan)
616
- if (prepared === null) throw new Error(missingAppAuthForPushReason)
617
- return {
618
- command: prepared.command,
619
- env: prepared.env,
620
- mount: prepared.mount,
621
- cleanup: async () => await cleanupPreparedGithubStorePush(prepared.backingGitDir),
605
+ // PAT-mode channel auth lends its PAT for configured repos (the adapter enforces
606
+ // repos[]). Only an absent `.env` declaration falls through here: an invalid one
607
+ // stays blocked rather than being silently replaced by a different credential.
608
+ if (declared.kind === 'absent' && canUsePat(event.origin) && ctx.github.resolvePatForRepo !== undefined) {
609
+ const credentials: GitRepoCredential[] = []
610
+ for (const repoSlug of destinationRepos) {
611
+ const result = await ctx.github.resolvePatForRepo(repoSlug)
612
+ if (result.kind === 'unavailable') {
613
+ return { block: true, reason: `${missingAppAuthForPushReason} Channel PAT: ${result.reason}` }
614
+ }
615
+ credentials.push({ repoSlug, token: result.token })
622
616
  }
617
+ event.args[TYPECLAW_INTERNAL_BASH_ENV] = await buildGitCredentialOverlay(
618
+ credentials,
619
+ event.args[TYPECLAW_INTERNAL_BASH_ENV],
620
+ {
621
+ expectedRemote:
622
+ decision.pushProvenance?.kind === 'configured-remote' ? decision.pushProvenance.remote : undefined,
623
+ pushUrls:
624
+ decision.pushProvenance?.kind === 'configured-remote' ? decision.pushProvenance.pushUrls : undefined,
625
+ trustedEnv: trustedGitTransportEnv,
626
+ },
627
+ )
628
+ event.args[TYPECLAW_INTERNAL_BASH_WITHHOLD_ENV] = ['GH_TOKEN', 'GITHUB_TOKEN']
629
+ if (decision.rewrittenCommand !== undefined) event.args.command = decision.rewrittenCommand
630
+ noteGitCredential(credentials.map(({ token }) => ({ source: 'GitHub channel PAT', token })))
631
+ return
623
632
  }
624
- return
633
+ // The host `gh` login is the operator's identity, not the agent's, so it never funds
634
+ // a push: anything it signed would land on GitHub as the operator. App auth and an
635
+ // authoritative declared PAT stay the authorized push credentials.
636
+ return { block: true, reason: missingAppAuthForPushReason }
625
637
  }
626
638
  const credentials: GitRepoCredential[] = []
627
639
  for (const repoSlug of destinationRepos) {
@@ -652,6 +664,12 @@ export default definePlugin({
652
664
  )
653
665
  if (grantedPush !== undefined) event.args.command = grantedPush.command
654
666
  else if (decision.rewrittenCommand !== undefined) event.args.command = decision.rewrittenCommand
667
+ noteGitCredential(
668
+ credentials.map(({ repoSlug, token }) => ({
669
+ source: `per-repo GitHub App token for ${repoSlug}`,
670
+ token,
671
+ })),
672
+ )
655
673
  return
656
674
  }
657
675
 
@@ -705,7 +723,14 @@ export default definePlugin({
705
723
  return
706
724
  },
707
725
  'tool.after': async (event) => {
708
- checkGraphqlAuthNudge({ tool: event.tool, result: event.result })
726
+ const gitAuth = gitAuthDiagnostics.get(event.callId)
727
+ gitAuthDiagnostics.delete(event.callId)
728
+ if (event.tool === 'bash' && gitAuth !== undefined) {
729
+ await appendGitAuthDiagnostic({ result: event.result, ...gitAuth, resolveLogin: resolveGitAuthLogin })
730
+ }
731
+ const graphqlCommand = passThroughGraphqlCommands.get(event.callId)
732
+ passThroughGraphqlCommands.delete(event.callId)
733
+ checkGraphqlAuthNudge({ tool: event.tool, command: graphqlCommand, result: event.result })
709
734
  const dismissal = pendingDismissals.get(event.callId)
710
735
  pendingDismissals.delete(event.callId)
711
736
  if (dismissal !== undefined) {
@@ -0,0 +1,179 @@
1
+ import { join } from 'node:path'
2
+
3
+ import { z } from 'zod'
4
+
5
+ import { TYPECLAW_INTERNAL_BASH_ENV } from '@/agent/plugin-tools'
6
+ import { fillSecretIntoFocusedField, type FillSecretOutcome } from '@/browser/fill-secret'
7
+ import { type ManagedBrowser, startManagedBrowser } from '@/browser/managed-browser'
8
+ import { BROWSER_ENGINES, type BrowserConfig, needsManagedBrowser } from '@/browser/registry'
9
+ import { getConfig } from '@/config'
10
+ import { readEnvFile } from '@/init/env-file'
11
+ import type { PermissionService } from '@/permissions'
12
+ import { CORE_PERMISSIONS } from '@/permissions/builtins'
13
+ import { definePlugin, defineTool, type Hooks } from '@/plugin'
14
+ import { resolveFillableEnvNames, SECRET_ENV_PREFIX } from '@/sandbox/env-exposure'
15
+
16
+ const SKILLS_ROOT = join(import.meta.dir, 'skills')
17
+
18
+ export default definePlugin({
19
+ plugin: async (ctx) => {
20
+ // Boot snapshot: `browser` is restart-required, matching the image layers
21
+ // and the browser process started below.
22
+ const browser = getConfig().browser
23
+ const skillsDirs = browserSkillDirs(browser)
24
+ if (!needsManagedBrowser(browser)) return { skillsDirs }
25
+
26
+ let managed: ManagedBrowser
27
+ try {
28
+ managed = await startManagedBrowser({ agentDir: ctx.agentDir, browser, logger: ctx.logger })
29
+ } catch (error) {
30
+ ctx.logger.error(`managed browser failed to start; browser engines are unavailable: ${String(error)}`)
31
+ return { skillsDirs }
32
+ }
33
+ const overlay = browserEnvOverlay(browser, managed)
34
+ const bashHook = sharedBrowserBashHook(ctx.permissions, overlay)
35
+ const fillGuard = fillSecretGuardHook(ctx.permissions)
36
+
37
+ return {
38
+ skillsDirs,
39
+ tools: { [FILL_SECRET_TOOL]: createFillSecretTool(managed.cdpUrl) },
40
+ hooks: {
41
+ 'tool.before': async (event, hookCtx) => {
42
+ await bashHook(event, hookCtx)
43
+ return fillGuard(event, hookCtx)
44
+ },
45
+ },
46
+ onDispose: () => managed.stop(),
47
+ }
48
+ },
49
+ })
50
+
51
+ export function sharedBrowserBashHook(
52
+ permissions: PermissionService,
53
+ overlay: Record<string, string>,
54
+ ): NonNullable<Hooks['tool.before']> {
55
+ return (event) => {
56
+ if (event.tool !== 'bash') return
57
+ if (!permissions.has(event.origin, CORE_PERMISSIONS.browserShared)) return
58
+ const existing = event.args[TYPECLAW_INTERNAL_BASH_ENV]
59
+ const current = existing !== null && typeof existing === 'object' ? (existing as Record<string, string>) : {}
60
+ event.args[TYPECLAW_INTERNAL_BASH_ENV] = { ...current, ...overlay }
61
+ }
62
+ }
63
+
64
+ export const FILL_SECRET_TOOL = 'browser_fill_secret'
65
+
66
+ // The tool drives the shared browser, so it needs `browser.shared` like bash's
67
+ // CDP URL does. Typing the withheld TYPECLAW_SECRET_* tier is runtime-owned
68
+ // credential use, which `fs.see.secrets` authorizes; ordinary .env vars are
69
+ // already in that role's bash, so typing them needs nothing more. This gates
70
+ // who may USE a secret, not who may observe it: every `browser.shared` holder
71
+ // drives the same pages over CDP and can watch what is typed there.
72
+ export function fillSecretGuardHook(permissions: PermissionService): NonNullable<Hooks['tool.before']> {
73
+ return (event) => {
74
+ if (event.tool !== FILL_SECRET_TOOL) return
75
+ if (!permissions.has(event.origin, CORE_PERMISSIONS.browserShared)) {
76
+ return { block: true, reason: `${FILL_SECRET_TOOL} needs the ${CORE_PERMISSIONS.browserShared} permission` }
77
+ }
78
+ const name = event.args['name']
79
+ if (
80
+ typeof name === 'string' &&
81
+ name.startsWith(SECRET_ENV_PREFIX) &&
82
+ !permissions.has(event.origin, CORE_PERMISSIONS.fsSeeSecrets)
83
+ ) {
84
+ return {
85
+ block: true,
86
+ reason: `${SECRET_ENV_PREFIX}* values need the ${CORE_PERMISSIONS.fsSeeSecrets} permission`,
87
+ }
88
+ }
89
+ }
90
+ }
91
+
92
+ export function createFillSecretTool(
93
+ cdpUrl: string,
94
+ fill: typeof fillSecretIntoFocusedField = fillSecretIntoFocusedField,
95
+ ) {
96
+ return defineTool({
97
+ description: [
98
+ 'Type the value of a .env variable into the focused field of a shared-browser tab without the value ever entering your context.',
99
+ 'Focus the field first with your browser engine (click it), then call this. Pass `url` (exact or prefix) when several tabs are open.',
100
+ `Accepts any ordinary .env variable and the ${SECRET_ENV_PREFIX}* tier, which is hidden from bash and reachable only through this tool.`,
101
+ 'With `submit: true` it submits the field (form submit, else Enter) and waits for the page to navigate; if it does not, the field is cleared so the value is not left on the page.',
102
+ 'The result names the tab and field, never the value. Never read the field back, screenshot a non-password field after filling, or echo the variable.',
103
+ ].join(' '),
104
+ parameters: z.object({
105
+ name: z.string().describe('The .env variable name, e.g. TYPECLAW_SECRET_GITHUB_PASSWORD'),
106
+ url: z.string().optional().describe('Exact URL or prefix of the target tab'),
107
+ submit: z.boolean().default(false),
108
+ }),
109
+ fileOperands: { nonFile: ['name', 'url'] },
110
+ execute: async (args, ctx) => {
111
+ const fillable = new Set(resolveFillableEnvNames(readEnvFile(ctx.agentDir), process.env))
112
+ if (!fillable.has(args.name)) {
113
+ return text(
114
+ `${args.name} is not a fillable variable: declare it with a non-empty value in .env (runtime controls are never fillable).`,
115
+ )
116
+ }
117
+ const value = process.env[args.name]
118
+ if (value === undefined || value.length === 0) {
119
+ return text(
120
+ `${args.name} is in .env but not loaded yet; the operator must restart the agent after editing .env.`,
121
+ )
122
+ }
123
+ const outcome = await fill({
124
+ cdpUrl,
125
+ value,
126
+ submit: args.submit,
127
+ ...(args.url === undefined ? {} : { url: args.url }),
128
+ })
129
+ return text(describeOutcome(args.name, outcome))
130
+ },
131
+ })
132
+ }
133
+
134
+ function describeOutcome(name: string, outcome: FillSecretOutcome): string {
135
+ switch (outcome.status) {
136
+ case 'refused':
137
+ return `Not filled: ${outcome.reason}.`
138
+ case 'filled':
139
+ return `Filled ${name} into ${outcome.field} on ${outcome.url}.`
140
+ case 'submitted':
141
+ return `Filled ${name} into ${outcome.field} on ${outcome.url} and submitted; the page navigated.`
142
+ case 'not-navigated':
143
+ return (
144
+ `Filled ${name} into ${outcome.field} on ${outcome.url} and submitted, but the page did not navigate. ` +
145
+ (outcome.cleared
146
+ ? 'The field was cleared; check the page for an error.'
147
+ : 'The field could not be cleared (cross-origin frame); check the page for an error.')
148
+ )
149
+ }
150
+ }
151
+
152
+ function text(value: string) {
153
+ return { content: [{ type: 'text' as const, text: value }] }
154
+ }
155
+
156
+ export function browserSkillDirs(browser: BrowserConfig): string[] {
157
+ const ids = [...browser.engines.filter((id) => id !== 'agent-browser'), ...browser.extensions]
158
+ // One root per id (skills/<id>/<skill>/SKILL.md) so disabled engines stay out of the catalog.
159
+ return ids.map((id) => join(SKILLS_ROOT, id))
160
+ }
161
+
162
+ export function browserEnvOverlay(
163
+ browser: BrowserConfig,
164
+ managed: Pick<ManagedBrowser, 'cdpUrl' | 'filesDir' | 'bskRelay' | 'token'>,
165
+ ) {
166
+ const env: Record<string, string> = {
167
+ TYPECLAW_BROWSER_CDP_URL: managed.cdpUrl,
168
+ TYPECLAW_BROWSER_FILES: managed.filesDir,
169
+ }
170
+ // agent-browser is in every image and bundled skills (qa, PDF) call it
171
+ // directly, so it always joins the shared browser while one is running.
172
+ for (const id of new Set(['agent-browser' as const, ...browser.engines])) {
173
+ Object.assign(env, BROWSER_ENGINES[id].env(managed.cdpUrl))
174
+ }
175
+ if (managed.bskRelay !== undefined) {
176
+ Object.assign(env, { TYPECLAW_BSK_RELAY: managed.bskRelay, TYPECLAW_BSK_TOKEN: managed.token })
177
+ }
178
+ return env
179
+ }
@@ -0,0 +1,27 @@
1
+ ---
2
+ name: browser-use
3
+ description: Browser Use CLI for driving the shared TypeClaw browser from Python snippets over CDP. Use for browsing, clicking, scraping and screenshots when you prefer Python helpers.
4
+ ---
5
+
6
+ # browser-use
7
+
8
+ The `browser-use` CLI runs a Python snippet with browser helpers pre-imported. `$BU_CDP_WS` points it at the shared browser. If the variable is unset, this session's role cannot use the shared browser (it needs the `browser.shared` permission) or the browser failed to start; the operator log (`typeclaw logs`) names which. Do not try to start Chrome yourself.
9
+
10
+ ```bash
11
+ browser-use <<'PY'
12
+ new_tab("https://example.com")
13
+ wait_for_load()
14
+ print(page_info())
15
+ PY
16
+ ```
17
+
18
+ Run `browser-use skill` once to read the full helper reference (`ensure_real_tab`, `click_at_xy`, `cdp(...)`, screenshots). Its tabs are marked with a horse emoji in the title; keep to those.
19
+
20
+ Never run `browser-use --update`, `browser-use auth login`, or remote/cloud daemons (`start_remote_daemon`): the version is pinned by TypeClaw and cloud browsers are not part of this setup.
21
+
22
+ ## Shared browser rules
23
+
24
+ - One TypeClaw-managed Chrome serves every engine and every session that has `browser.shared`. Logins and tabs persist across bash calls and sessions.
25
+ - Work only in tabs you opened. Never navigate or close a tab another engine or session is using.
26
+ - Files: downloads land in `$TYPECLAW_BROWSER_FILES`; to upload a file, copy it there first and pass that path. Chrome cannot see other paths.
27
+ - The browser runs in its own sandbox with no view of the agent folder, so `file://` URLs outside `$TYPECLAW_BROWSER_FILES` fail by design.
@@ -0,0 +1,28 @@
1
+ ---
2
+ name: browserskill
3
+ description: BrowserSkill (bsk) CLI driving the shared TypeClaw browser through its extension. Use for semantic page observation, table/list extraction, recording traces, and website debugging evidence.
4
+ ---
5
+
6
+ # browserskill
7
+
8
+ The `bsk` CLI talks to a daemon TypeClaw runs next to the shared browser; the BrowserSkill extension is preloaded and connected. `bsk` reaches that daemon through `$TYPECLAW_BSK_RELAY`; do not set `BSK_HOME` yourself. If the variable is unset, this session's role cannot use the shared browser (it needs the `browser.shared` permission) or the browser failed to start; the operator log (`typeclaw logs`) names which. Do not try to start Chrome yourself.
9
+
10
+ ```bash
11
+ bsk status --json # a connected browser must be listed
12
+ SID=$(bsk session start --json | jq -r .session_id)
13
+ bsk navigate https://example.com --session "$SID"
14
+ bsk snapshot --session "$SID" # @eN refs
15
+ bsk click @e3 --session "$SID"
16
+ bsk session stop "$SID" # always stop, success or failure
17
+ ```
18
+
19
+ - Sessions open their own Agent Window. Never borrow an existing tab: borrowing asks a human to confirm, and nobody can click it here.
20
+ - `bsk --help` and `bsk <command> --help` list everything (`extract`, `observe`, `record`, `debug`).
21
+ - Never run `bsk update`, `bsk daemon stop`, or `bsk daemon restart`; TypeClaw owns the daemon and its version.
22
+
23
+ ## Shared browser rules
24
+
25
+ - One TypeClaw-managed Chrome serves every engine and every session that has `browser.shared`. Logins and tabs persist across bash calls and sessions.
26
+ - Work only in tabs you opened. Never navigate or close a tab another engine or session is using.
27
+ - Files: downloads land in `$TYPECLAW_BROWSER_FILES`; to upload a file, copy it there first and pass that path. Chrome cannot see other paths.
28
+ - The browser runs in its own sandbox with no view of the agent folder, so `file://` URLs outside `$TYPECLAW_BROWSER_FILES` fail by design.
@@ -0,0 +1,40 @@
1
+ ---
2
+ name: omowright
3
+ description: Playwright-shaped browser automation library (OmOWright) for the shared TypeClaw browser. Use for browsing, clicking, form filling, accessibility snapshots, scrolling feeds and collecting JSON from network responses while scrolling.
4
+ ---
5
+
6
+ # omowright
7
+
8
+ OmOWright is a JavaScript library with the Playwright API shape (`page.goto`, `page.locator(ref).click()`, `page.mouse.wheel`, `page.keyboard.type`, `page.screenshot`). Write a short Bun script and run it with `bun`. Each script connects to the shared browser, so state survives between scripts.
9
+
10
+ `$OMOWRIGHT_CDP_URL` holds the connection URL. If the variable is unset, this session's role cannot use the shared browser (it needs the `browser.shared` permission) or the browser failed to start; the operator log (`typeclaw logs`) names which. Do not try to start Chrome yourself.
11
+
12
+ ```js
13
+ // save as /tmp/browse.mjs, run: bun /tmp/browse.mjs
14
+ import { compactSnapshot, connect, createAgentTabs } from '/usr/local/lib/typeclaw-browser/omowright/index.js'
15
+
16
+ const url = process.env.OMOWRIGHT_CDP_URL
17
+ // The relay requires the token on every request; omowright drops the URL query
18
+ // for HTTP discovery (listTargets), so pass it as an Authorization header too.
19
+ const token = new URL(url).searchParams.get('token')
20
+ const browser = await connect(url, {
21
+ client: { authorizer: { resolveAuthorization: async () => `Bearer ${token}` } },
22
+ })
23
+ const tabs = createAgentTabs(browser) // background tabs that never steal focus
24
+ const page = await tabs.open('https://example.com')
25
+ console.log(compactSnapshot(await page.snapshot())) // refs like [ref=e1]
26
+ await page.locator('e1').click()
27
+ process.exit(0) // leaves the tab and browser running
28
+ ```
29
+
30
+ - Prefer `compactSnapshot(await page.snapshot())` over screenshots; re-snapshots come back as a diff.
31
+ - Long lists: `createNetworkSnoop` + `collectWhileScrolling` read the page's JSON instead of scraping rows.
32
+ - Canvas or custom widgets: `createCua(page)` gives coordinate-level clicks and scrolls.
33
+ - `connectPipe()` and `connectBrowserSkill()` launch or find other browsers; do not use them here.
34
+
35
+ ## Shared browser rules
36
+
37
+ - One TypeClaw-managed Chrome serves every engine and every session that has `browser.shared`. Logins and tabs persist across bash calls and sessions.
38
+ - Work only in tabs you opened. Never navigate or close a tab another engine or session is using.
39
+ - Files: downloads land in `$TYPECLAW_BROWSER_FILES`; to upload a file, copy it there first and pass that path. Chrome cannot see other paths.
40
+ - The browser runs in its own sandbox with no view of the agent folder, so `file://` URLs outside `$TYPECLAW_BROWSER_FILES` fail by design.
@@ -622,7 +622,10 @@ async function recomputeShardFrontmatter(agentDir: string, slug: string, logger:
622
622
  heading: parsed.frontmatter.heading || synthesizeHeadingFromBody(parsed.body) || slug,
623
623
  cites,
624
624
  days: dates.length,
625
- lastReinforced: dates.at(-1) ?? formatLocalDate(),
625
+ // No dated citation (e.g. only pre-cutover line-range citations, which
626
+ // parseCitations drops) is no evidence of reinforcement, so keep the prior
627
+ // date instead of stamping today and making a stale shard look fresh.
628
+ lastReinforced: dates.at(-1) ?? parsed.frontmatter.lastReinforced,
626
629
  ...(tags !== undefined ? { tags } : {}),
627
630
  }
628
631
  const nextRaw = renderShard(nextFrontmatter, parsed.body)