typeclaw 0.48.13 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +13 -6
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/dump-system-prompt.ts +52 -110
  317. package/scripts/require-parallel.ts +5 -32
  318. package/src/agent/guard-types.ts +3 -0
  319. package/src/agent/guards.ts +4 -0
  320. package/src/agent/idle-compaction.ts +174 -0
  321. package/src/agent/index.ts +210 -80
  322. package/src/agent/live-sessions.ts +2 -2
  323. package/src/agent/live-subagents.ts +20 -0
  324. package/src/agent/multimodal/look-at.ts +22 -9
  325. package/src/agent/plugin-tools.ts +66 -12
  326. package/src/agent/prompt-cache-key.ts +42 -0
  327. package/src/agent/provider-error.ts +179 -10
  328. package/src/agent/restart-handoff/index.ts +7 -14
  329. package/src/agent/reviewer-activity.ts +68 -0
  330. package/src/agent/reviewer-bash-policy.ts +41 -1
  331. package/src/agent/session-origin.ts +58 -9
  332. package/src/agent/subagent-cache-keepalive.ts +198 -0
  333. package/src/agent/subagent-session.ts +6 -0
  334. package/src/agent/subagents.ts +59 -9
  335. package/src/agent/system-prompt.ts +68 -202
  336. package/src/agent/todo/continuation-policy.ts +12 -4
  337. package/src/agent/tool-file-safety.ts +119 -15
  338. package/src/agent/tool-not-found-nudge.ts +1 -1
  339. package/src/agent/tools/channel-edit.ts +20 -10
  340. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  341. package/src/agent/tools/channel-handoff.ts +72 -0
  342. package/src/agent/tools/channel-history-render.ts +2 -1
  343. package/src/agent/tools/channel-read.ts +57 -10
  344. package/src/agent/tools/channel-reply.ts +55 -30
  345. package/src/agent/tools/channel-send.ts +69 -19
  346. package/src/agent/tools/channel-session-search.ts +35 -0
  347. package/src/agent/tools/curl-impersonate.ts +22 -6
  348. package/src/agent/tools/ddg.ts +13 -5
  349. package/src/agent/tools/post-github-review.ts +77 -15
  350. package/src/agent/tools/skip-response.ts +2 -2
  351. package/src/agent/tools/spawn-subagent.ts +190 -23
  352. package/src/agent/tools/stream-snapshot.ts +15 -2
  353. package/src/agent/tools/subagent-access.ts +11 -4
  354. package/src/agent/tools/subagent-output.ts +8 -0
  355. package/src/browser/bsk-shim.mjs +74 -0
  356. package/src/browser/dockerfile.ts +84 -0
  357. package/src/browser/egress.ts +104 -0
  358. package/src/browser/managed-browser.ts +205 -0
  359. package/src/browser/registry.ts +110 -0
  360. package/src/browser/relay.ts +231 -0
  361. package/src/browser/sandbox-entry.ts +167 -0
  362. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  363. package/src/bundled-plugins/backup/README.md +10 -9
  364. package/src/bundled-plugins/backup/runner.ts +140 -58
  365. package/src/bundled-plugins/backup/subagents.ts +58 -26
  366. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  367. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  368. package/src/bundled-plugins/doc-render/index.ts +0 -10
  369. package/src/bundled-plugins/doc-render/render.ts +83 -111
  370. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  371. package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
  372. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  373. package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
  374. package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
  375. package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
  376. package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
  377. package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
  378. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  379. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  380. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  381. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  382. package/src/bundled-plugins/operator/operator.ts +15 -4
  383. package/src/bundled-plugins/qa/index.ts +11 -0
  384. package/src/bundled-plugins/qa/qa.ts +160 -0
  385. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  386. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  387. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  388. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  389. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  390. package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
  391. package/src/bundled-plugins/security/index.ts +103 -36
  392. package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
  393. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  394. package/src/channels/adapter-namespace.ts +13 -0
  395. package/src/channels/adapters/discord-bot-reactions.ts +18 -0
  396. package/src/channels/adapters/discord-bot.ts +219 -72
  397. package/src/channels/adapters/discord-reactions.ts +18 -0
  398. package/src/channels/adapters/discord.ts +114 -8
  399. package/src/channels/adapters/github/inbound.ts +103 -8
  400. package/src/channels/adapters/github/index.ts +267 -19
  401. package/src/channels/adapters/github/last-alive.ts +15 -0
  402. package/src/channels/adapters/github/outbound.ts +54 -18
  403. package/src/channels/adapters/github/pending-review-store.ts +141 -0
  404. package/src/channels/adapters/github/permission-guidance.ts +1 -0
  405. package/src/channels/adapters/github/reactions.ts +100 -0
  406. package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
  407. package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
  408. package/src/channels/adapters/github/recovery.ts +106 -0
  409. package/src/channels/adapters/github/review-check.ts +510 -0
  410. package/src/channels/adapters/github/review-submitter.ts +34 -2
  411. package/src/channels/adapters/instagram.ts +32 -14
  412. package/src/channels/adapters/kakaotalk.ts +22 -7
  413. package/src/channels/adapters/line.ts +18 -3
  414. package/src/channels/adapters/outbound-account.ts +20 -0
  415. package/src/channels/adapters/own-reactions.ts +66 -0
  416. package/src/channels/adapters/recovery-correlation.ts +214 -0
  417. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  418. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  419. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  420. package/src/channels/adapters/slack-bot-classify.ts +19 -11
  421. package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
  422. package/src/channels/adapters/slack-bot-reactions.ts +18 -0
  423. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  424. package/src/channels/adapters/slack-bot.ts +424 -124
  425. package/src/channels/adapters/slack-classify.ts +26 -4
  426. package/src/channels/adapters/slack-inbound-revision.ts +96 -0
  427. package/src/channels/adapters/slack-reactions.ts +18 -0
  428. package/src/channels/adapters/slack-thread-ts.ts +6 -0
  429. package/src/channels/adapters/slack.ts +48 -3
  430. package/src/channels/adapters/teams.ts +14 -4
  431. package/src/channels/adapters/telegram-bot.ts +56 -10
  432. package/src/channels/adapters/webex-bot.ts +12 -2
  433. package/src/channels/adapters/webex.ts +12 -2
  434. package/src/channels/background-handoff.ts +434 -0
  435. package/src/channels/background-obligations.ts +893 -0
  436. package/src/channels/catch-up.ts +137 -0
  437. package/src/channels/continuation-willingness.ts +2 -2
  438. package/src/channels/continuity-types.ts +272 -0
  439. package/src/channels/engagement.ts +17 -1
  440. package/src/channels/github-false-receipt.ts +3 -3
  441. package/src/channels/github-rereview-guard.ts +9 -5
  442. package/src/channels/github-review-check.ts +598 -0
  443. package/src/channels/github-review-turn-ledger.ts +102 -28
  444. package/src/channels/github-review-verdict-coordinator.ts +72 -12
  445. package/src/channels/github-token-bridge.ts +35 -5
  446. package/src/channels/inbound-journal.ts +1738 -0
  447. package/src/channels/index.ts +6 -1
  448. package/src/channels/last-alive.ts +34 -0
  449. package/src/channels/manager.ts +25 -8
  450. package/src/channels/recovery-dispatcher.ts +264 -0
  451. package/src/channels/recovery-notice.ts +94 -0
  452. package/src/channels/recovery-outbox.ts +459 -0
  453. package/src/channels/router.ts +2951 -736
  454. package/src/channels/schema.ts +8 -1
  455. package/src/channels/session-handoff.fixture.ts +144 -0
  456. package/src/channels/session-handoff.ts +175 -0
  457. package/src/channels/session-search.ts +71 -0
  458. package/src/channels/subagent-completion-bridge.ts +17 -14
  459. package/src/channels/types.ts +133 -18
  460. package/src/channels/waiting-reactions.ts +664 -0
  461. package/src/cli/channel.ts +2 -3
  462. package/src/cli/compose.ts +7 -4
  463. package/src/cli/hostd.ts +49 -3
  464. package/src/cli/init.ts +2 -3
  465. package/src/cli/inspect.ts +11 -14
  466. package/src/cli/model.ts +132 -3
  467. package/src/coding-agent/broker-body.ts +38 -0
  468. package/src/coding-agent/broker.ts +290 -0
  469. package/src/coding-agent/claude.ts +95 -0
  470. package/src/coding-agent/codex.ts +104 -0
  471. package/src/coding-agent/index.ts +512 -0
  472. package/src/coding-agent/omo-state.ts +69 -0
  473. package/src/coding-agent/omo-stream.ts +138 -0
  474. package/src/coding-agent/omo.ts +192 -0
  475. package/src/coding-agent/runner.ts +285 -0
  476. package/src/coding-agent/tool.ts +62 -0
  477. package/src/coding-agent/worktree.ts +355 -0
  478. package/src/compose/restart.ts +10 -3
  479. package/src/compose/start.ts +20 -3
  480. package/src/config/config.ts +121 -25
  481. package/src/config/model-overrides.ts +59 -0
  482. package/src/config/models-mutation.ts +185 -2
  483. package/src/config/providers-mutation.ts +12 -4
  484. package/src/config/providers.ts +71 -9
  485. package/src/container/exit-reason.ts +44 -0
  486. package/src/container/index.ts +5 -0
  487. package/src/container/log-archive.ts +51 -13
  488. package/src/container/memory-limit.ts +1 -1
  489. package/src/container/memory-oversubscription.ts +36 -6
  490. package/src/container/oom-events.ts +86 -0
  491. package/src/container/restart.ts +2 -0
  492. package/src/container/shared.ts +8 -1
  493. package/src/container/start.ts +120 -17
  494. package/src/container/stop.ts +6 -2
  495. package/src/container/tool-oom-priority.ts +32 -0
  496. package/src/cron/consumer.ts +10 -4
  497. package/src/cron/reloadable.ts +23 -2
  498. package/src/doctor/checks.ts +22 -8
  499. package/src/hostd/daemon.ts +33 -11
  500. package/src/hostd/spawn.ts +106 -5
  501. package/src/hostd/version.ts +20 -0
  502. package/src/hostd/watchdog.ts +241 -0
  503. package/src/init/auto-upgrade.ts +7 -1
  504. package/src/init/dockerfile.ts +112 -602
  505. package/src/init/index.ts +6 -6
  506. package/src/init/local-source-stamp.ts +68 -0
  507. package/src/init/models-dev.ts +4 -0
  508. package/src/init/validate-api-key.ts +3 -0
  509. package/src/mcp/client.ts +3 -1
  510. package/src/operations/classify-tool-outcome.ts +45 -1
  511. package/src/operations/incidents.ts +10 -5
  512. package/src/permissions/builtins.ts +7 -0
  513. package/src/permissions/permissions.ts +18 -9
  514. package/src/permissions/resolve.ts +7 -1
  515. package/src/plugin/context.ts +2 -0
  516. package/src/plugin/core-tool-names.ts +1 -1
  517. package/src/plugin/define.ts +1 -0
  518. package/src/plugin/hooks.ts +137 -0
  519. package/src/plugin/index.ts +7 -0
  520. package/src/plugin/manager.ts +4 -0
  521. package/src/plugin/types.ts +66 -1
  522. package/src/run/background-handoff-boot.ts +86 -0
  523. package/src/run/bundled-plugins.ts +6 -0
  524. package/src/run/index.ts +107 -97
  525. package/src/run/llm-fetch-observer.ts +12 -15
  526. package/src/run/resource-sample.ts +19 -0
  527. package/src/sandbox/build.ts +4 -0
  528. package/src/sandbox/canonical-secrets.ts +4 -0
  529. package/src/sandbox/coding-agent.ts +214 -0
  530. package/src/sandbox/dev-source.ts +26 -0
  531. package/src/sandbox/hidden-paths.ts +16 -2
  532. package/src/sandbox/policy.ts +1 -0
  533. package/src/sandbox/runtime-private.ts +4 -1
  534. package/src/secrets/coding-agent-auth.ts +97 -0
  535. package/src/secrets/index.ts +0 -16
  536. package/src/secrets/storage.ts +13 -0
  537. package/src/server/command-runner.ts +6 -2
  538. package/src/server/index.ts +101 -40
  539. package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
  540. package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
  541. package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
  542. package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
  543. package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
  544. package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
  545. package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
  546. package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
  547. package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
  548. package/src/skills/typeclaw-config/SKILL.md +60 -26
  549. package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
  550. package/src/skills/typeclaw-cron/SKILL.md +1 -1
  551. package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
  552. package/src/skills/typeclaw-memory/SKILL.md +3 -3
  553. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  554. package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
  555. package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
  556. package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
  557. package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
  558. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  559. package/src/skills/typeclaw-plugins/SKILL.md +15 -15
  560. package/src/skills/typeclaw-skills/SKILL.md +19 -2
  561. package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
  562. package/typeclaw.schema.json +448 -6
  563. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  564. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
  565. package/src/secrets/claude-credentials-json.ts +0 -129
  566. package/src/secrets/codex-auth-json.ts +0 -102
  567. package/src/secrets/export-claude-credentials-file.ts +0 -270
  568. package/src/secrets/export-codex-auth-file.ts +0 -250
  569. package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
  570. package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
  571. package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
  572. package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
@@ -20,7 +20,7 @@ import { formatComposeStats } from './compose-stats'
20
20
  import { formatComposeStatus } from './compose-status'
21
21
  import { formatComposeUsage, formatComposeUsageJson } from './compose-usage'
22
22
  import { preflightDocker, printDockerGuidance } from './docker-preflight'
23
- import { c, errorLine, spinner } from './ui'
23
+ import { c, errorLine, log, spinner } from './ui'
24
24
  import { parseSince, parseUntil } from './usage-args'
25
25
 
26
26
  // Compose fans a docker command out across every agent folder. A down daemon
@@ -54,7 +54,7 @@ const startSub = defineCommand({
54
54
  await requireDockerOrExit()
55
55
  const board = makeBoard('Starting agents')
56
56
  const s = spinner()
57
- const { agents, results } = await composeStart({
57
+ const { agents, results, memoryWarning } = await composeStart({
58
58
  rootCwd: process.cwd(),
59
59
  preferredHostPort: Number(args.port),
60
60
  forceBuild: args.build,
@@ -73,6 +73,7 @@ const startSub = defineCommand({
73
73
  }
74
74
  const failed = results.reduce((n, r) => (r.ok ? n : n + 1), 0)
75
75
  board.finish(s, results, 'started', failed)
76
+ if (memoryWarning !== null) log.warn(memoryWarning.join('\n'))
76
77
  if (failed > 0) process.exit(1)
77
78
  },
78
79
  })
@@ -121,7 +122,7 @@ const restartSub = defineCommand({
121
122
  await requireDockerOrExit()
122
123
  const board = makeBoard('Restarting agents')
123
124
  const s = spinner()
124
- const { agents, results } = await composeRestart({
125
+ const { agents, results, memoryWarning } = await composeRestart({
125
126
  rootCwd: process.cwd(),
126
127
  preferredHostPort: Number(args.port),
127
128
  forceBuild: args.build,
@@ -142,6 +143,7 @@ const restartSub = defineCommand({
142
143
  }
143
144
  const failed = results.reduce((n, r) => (r.ok ? n : n + 1), 0)
144
145
  board.finish(s, results, 'restarted', failed)
146
+ if (memoryWarning !== null) log.warn(memoryWarning.join('\n'))
145
147
  if (failed > 0) process.exit(1)
146
148
  },
147
149
  })
@@ -381,7 +383,8 @@ function formatRestartDone<T extends { start: { hostPort: number } }>(result: Ag
381
383
  // line so compose start/restart don't silently drop what `typeclaw start` prints.
382
384
  function appendWarnings(head: string, warnings: string[] | undefined): string {
383
385
  if (warnings === undefined || warnings.length === 0) return head
384
- return [head, ...warnings.map((w) => ` ${c.yellow('⚠')} ${w}`)].join('\n')
386
+ // Continuation lines of a multi-line warning stay under its first line.
387
+ return [head, ...warnings.map((w) => ` ${c.yellow('⚠')} ${w.replaceAll('\n', '\n ')}`)].join('\n')
385
388
  }
386
389
 
387
390
  function emitComposeDoctor(report: ComposeDoctorReport, opts: { verbose: boolean; json: boolean }): void {
package/src/cli/hostd.ts CHANGED
@@ -8,6 +8,7 @@ import {
8
8
  type RestartOptions,
9
9
  type RestartResult,
10
10
  } from '@/container'
11
+ import { isDaemonReachable } from '@/hostd/client'
11
12
  import {
12
13
  applyCredentialRotation,
13
14
  type CredentialRotationApplyResult,
@@ -19,7 +20,8 @@ import { createKakaoRenewalManager } from '@/hostd/kakao-renewal-manager'
19
20
  import { createPortbrokerManager } from '@/hostd/portbroker-manager'
20
21
  import type { SupervisorLogEvent, SupervisorRestart } from '@/hostd/supervisor'
21
22
  import { createTeamsRenewalManager } from '@/hostd/teams-renewal-manager'
22
- import { computeSourceVersion, resolveSrcRoot, UNVERSIONED_SENTINEL } from '@/hostd/version'
23
+ import { computeSourceVersion, hostBunVersionWarning, resolveSrcRoot, UNVERSIONED_SENTINEL } from '@/hostd/version'
24
+ import { runWatchdog, spawnProcessWorker, watchForOrphaning } from '@/hostd/watchdog'
23
25
  import { createWebexRenewalManager } from '@/hostd/webex-renewal-manager'
24
26
  import { validateRestartDeps, type RestartDepsPreflightResult } from '@/init/restart-deps-preflight'
25
27
  import { requestReloadWithFallback } from '@/reload'
@@ -30,8 +32,29 @@ export const hostdCommand = defineCommand({
30
32
  description: 'internal: host-side typeclaw daemon (do not invoke directly)',
31
33
  hidden: true,
32
34
  },
33
- async run() {
35
+ args: {
36
+ worker: { type: 'boolean', description: 'internal: run the daemon itself under the watchdog' },
37
+ 'watchdog-pid': { type: 'string', description: 'internal: pid of the supervising watchdog parent' },
38
+ },
39
+ async run({ args }) {
34
40
  const cliEntry = process.argv[1] ?? ''
41
+ if (!args.worker) {
42
+ await runHostdWatchdog(cliEntry)
43
+ return
44
+ }
45
+ let shutdown: (() => void) | null = null
46
+ const watchdogPid = Number(args['watchdog-pid'])
47
+ if (Number.isSafeInteger(watchdogPid) && watchdogPid > 0) {
48
+ watchForOrphaning({
49
+ watchdogPid,
50
+ onOrphaned: () => {
51
+ writeLogLine(`[hostd] watchdog parent ${watchdogPid} is gone; exiting`)
52
+ if (shutdown) shutdown()
53
+ else process.exit(1)
54
+ },
55
+ })
56
+ }
57
+
35
58
  const srcRoot = resolveSrcRoot(cliEntry)
36
59
  const version = srcRoot === null ? UNVERSIONED_SENTINEL : await computeSourceVersion({ srcRoot })
37
60
 
@@ -97,7 +120,7 @@ export const hostdCommand = defineCommand({
97
120
  restart: hostdRestart,
98
121
  })
99
122
 
100
- const shutdown = (): void => {
123
+ shutdown = (): void => {
101
124
  void daemon
102
125
  .stop()
103
126
  .then(() => portbroker.drain())
@@ -113,6 +136,27 @@ export const hostdCommand = defineCommand({
113
136
  },
114
137
  })
115
138
 
139
+ const WATCHDOG_PROBE_TIMEOUT_MS = 2_000
140
+
141
+ async function runHostdWatchdog(cliEntry: string): Promise<void> {
142
+ const log = (message: string): void => writeLogLine(`[hostd-watchdog] ${message}`)
143
+ const bunWarning = hostBunVersionWarning(process.versions.bun)
144
+ if (bunWarning) log(`WARNING: ${bunWarning}`)
145
+
146
+ const watchdog = runWatchdog({
147
+ spawnWorker: () =>
148
+ spawnProcessWorker([process.execPath, cliEntry, '_hostd', '--worker', '--watchdog-pid', String(process.pid)]),
149
+ probe: () => isDaemonReachable(WATCHDOG_PROBE_TIMEOUT_MS),
150
+ onLog: log,
151
+ })
152
+ const shutdown = (): void => {
153
+ void watchdog.stop().then(() => process.exit(0))
154
+ }
155
+ process.on('SIGTERM', shutdown)
156
+ process.on('SIGINT', shutdown)
157
+ process.exit(await watchdog.done)
158
+ }
159
+
116
160
  export type HostdRestartDeps = {
117
161
  validateConfig: (cwd: string) => ValidateConfigResult
118
162
  loadConfigSync: (cwd: string) => Config
@@ -239,6 +283,8 @@ function formatLog(event: DaemonLogEvent | SupervisorLogEvent): string {
239
283
  return `[hostd] deregistered ${event.containerName} (${event.reason})`
240
284
  case 'registration-skipped':
241
285
  return `[hostd] skipped persisted registration ${event.containerName}: ${event.reason}`
286
+ case 'container-exited':
287
+ return `[hostd] ${event.containerName}: ${event.reason}`
242
288
  case 'restart-scheduled':
243
289
  return `[hostd] restart scheduled for ${event.containerName}${event.build ? ' (with rebuild)' : ''}`
244
290
  case 'restart-completed':
package/src/cli/init.ts CHANGED
@@ -1796,8 +1796,7 @@ async function runGithubFlow(cwd: string): Promise<StepResult<CollectedInputs['c
1796
1796
  // length checks below to avoid a TypeError on the "leave blank" path.
1797
1797
  const enteredSecret = typeof secret === 'string' ? secret : ''
1798
1798
  const reposRaw = await text({
1799
- message: 'Repositories to allow (comma-separated owner/repo)',
1800
- validate: (v) => (parseGithubRepos(v ?? '').length > 0 ? undefined : 'At least one owner/repo is required'),
1799
+ message: 'Repositories to allow (comma-separated owner/repo, leave blank to skip)',
1801
1800
  })
1802
1801
  if (isCancel(reposRaw)) return back()
1803
1802
  const resolvedSecret = enteredSecret.length > 0 ? enteredSecret : randomBytes(32).toString('hex')
@@ -1808,7 +1807,7 @@ async function runGithubFlow(cwd: string): Promise<StepResult<CollectedInputs['c
1808
1807
  ...(webhookUrl !== undefined ? { webhookUrl } : {}),
1809
1808
  webhookPort: Number(port),
1810
1809
  ...(namedCreds !== undefined ? namedCreds : {}),
1811
- repos: parseGithubRepos(reposRaw),
1810
+ repos: parseGithubRepos(reposRaw ?? ''),
1812
1811
  auth,
1813
1812
  },
1814
1813
  })
@@ -122,6 +122,17 @@ export async function runInspectViewer(opts: RunInspectViewerOptions): Promise<n
122
122
  sinceMs = Date.now() - d.ms
123
123
  }
124
124
 
125
+ const interactive = Boolean(process.stdin.isTTY)
126
+ // Reject picker-only invocations before probing Docker: no container state
127
+ // can make a non-interactive terminal capable of driving the picker.
128
+ if (!interactive && opts.sessionArg === undefined) {
129
+ process.stderr.write(`${errorLine('typeclaw inspect needs an interactive terminal to pick a session.')}\n`)
130
+ process.stderr.write(
131
+ 'Pass an explicit session id (`typeclaw inspect <id>`) or use `--json <id>` for a scriptable stream.\n',
132
+ )
133
+ return 2
134
+ }
135
+
125
136
  const containerRunning = (await requireContainerRunning({ cwd })).ok
126
137
  if (!containerRunning) {
127
138
  process.stderr.write(`${c.yellow('⚠')} container not running; showing read-only history and logs only\n`)
@@ -149,20 +160,6 @@ export async function runInspectViewer(opts: RunInspectViewerOptions): Promise<n
149
160
  preselectKey = 'logs'
150
161
  }
151
162
 
152
- const interactive = Boolean(process.stdin.isTTY)
153
-
154
- // Without a TTY, clack's picker keypress loop busy-spins kevent64 at 100% CPU
155
- // forever instead of resolving (e.g. `typeclaw inspect | head`, a daemon
156
- // spawn). A resolved session arg auto-opens without the picker, so only the
157
- // picker-mandatory case is refused — mirroring --json's explicit-id rule.
158
- if (!interactive && preselectKey === undefined) {
159
- process.stderr.write(`${errorLine('typeclaw inspect needs an interactive terminal to pick a session.')}\n`)
160
- process.stderr.write(
161
- 'Pass an explicit session id (`typeclaw inspect <id>`) or use `--json <id>` for a scriptable stream.\n',
162
- )
163
- return 2
164
- }
165
-
166
163
  const liveHint = interactive ? escHintLine(color) : undefined
167
164
  const inspectUrl = containerRunning ? await resolveInspectUrl(cwd) : undefined
168
165
  const liveSource = inspectUrl !== undefined ? buildLiveSource(inspectUrl) : undefined
package/src/cli/model.ts CHANGED
@@ -6,10 +6,16 @@ import { defineCommand } from 'citty'
6
6
 
7
7
  import { type CustomModelMeta, type ThinkingLevel, thinkingLevelSchema } from '@/config'
8
8
  import {
9
+ addOverrideMatch,
9
10
  addProfile,
11
+ listModelOverrides,
10
12
  listModelProfiles,
11
13
  listRegisteredModelRefs,
14
+ removeOverride,
15
+ removeOverrideMatch,
16
+ removeOverrideProfile,
12
17
  removeProfile,
18
+ setOverrideProfile,
13
19
  setProfile,
14
20
  setProfileThinkingLevel,
15
21
  } from '@/config/models-mutation'
@@ -62,15 +68,33 @@ const setSub = defineCommand({
62
68
  "reasoning effort for THIS profile (off|minimal|low|medium|high|xhigh|max|default); the `default` profile's level is the de-facto global default",
63
69
  required: false,
64
70
  },
71
+ override: {
72
+ type: 'string',
73
+ description: 'set the profile inside this `modelOverrides` entry instead of the global `models`',
74
+ required: false,
75
+ },
76
+ match: {
77
+ type: 'string',
78
+ description: "with --override: add this match rule (e.g. 'slack:*'); required when creating the override",
79
+ required: false,
80
+ },
65
81
  },
66
82
  async run({ args }) {
67
83
  const cwd = ensureAgentDir()
84
+ if (args.match !== undefined && args.override === undefined) {
85
+ console.error(errorLine('--match requires --override <name>.'))
86
+ process.exit(1)
87
+ }
68
88
  // `model set <ref>` shorthand targets the `default` profile; a shorthand ref
69
89
  // is resolved as an explicit ref (so its errors surface via resolvePickedRef's
70
90
  // exit-1 path), and a bare/named-profile invocation falls back to the picker.
71
91
  const shorthandRef = resolveShorthandRef(args.profile, args.ref)
72
92
  const profile = shorthandRef !== undefined ? 'default' : (args.profile ?? (await pickProfileName()))
73
93
  const picked = await resolvePickedRef(shorthandRef ?? args.ref, cwd)
94
+ if (args.override !== undefined) {
95
+ runSetOverrideProfile(cwd, args.override, profile, picked, args)
96
+ return
97
+ }
74
98
 
75
99
  intro(`Setting model profile: ${profile} → ${picked.ref}`)
76
100
 
@@ -207,17 +231,26 @@ const removeSub = defineCommand({
207
231
  description: 'profile name to remove',
208
232
  required: true,
209
233
  },
234
+ override: {
235
+ type: 'string',
236
+ description: 'remove the profile from this `modelOverrides` entry instead of the global `models`',
237
+ required: false,
238
+ },
210
239
  },
211
240
  async run({ args }) {
212
241
  const cwd = ensureAgentDir()
213
- intro(`Removing model profile: ${args.profile}`)
214
- const result = removeProfile(cwd, args.profile)
242
+ const scope = args.override !== undefined ? ` from override ${args.override}` : ''
243
+ intro(`Removing model profile: ${args.profile}${scope}`)
244
+ const result =
245
+ args.override !== undefined
246
+ ? removeOverrideProfile(cwd, args.override, args.profile)
247
+ : removeProfile(cwd, args.profile)
215
248
  if (!result.ok) {
216
249
  console.error(errorLine(result.reason))
217
250
  process.exit(1)
218
251
  }
219
252
  done({
220
- title: c.green(`Profile "${args.profile}" removed.`),
253
+ title: c.green(`Profile "${args.profile}" removed${scope}.`),
221
254
  hints: [{ label: 'If the agent is running:', command: 'typeclaw reload' }],
222
255
  })
223
256
  },
@@ -274,7 +307,60 @@ const listSub = defineCommand({
274
307
  }
275
308
  }
276
309
  }
310
+
311
+ for (const override of listModelOverrides(cwd)) {
312
+ console.log('')
313
+ console.log(`${c.bold(`override ${override.name}`)} ${c.dim(override.match.join(', '))}`)
314
+ for (const p of override.profiles) {
315
+ const thinking = p.thinkingLevel !== undefined ? ` ${c.dim(p.thinkingLevel)}` : ''
316
+ console.log(` ${p.profile.padEnd(profileWidth + 2)}${p.refs.join(' → ')}${thinking}`)
317
+ }
318
+ }
319
+ },
320
+ })
321
+
322
+ const overrideMatchSub = defineCommand({
323
+ meta: { name: 'match', description: 'add a match rule to a `modelOverrides` entry' },
324
+ args: {
325
+ name: { type: 'positional', description: 'override name', required: true },
326
+ rule: { type: 'positional', description: "match rule, e.g. 'slack:T0123/C0123'", required: true },
327
+ },
328
+ run({ args }) {
329
+ finishOverrideEdit(
330
+ addOverrideMatch(ensureAgentDir(), args.name, args.rule),
331
+ `Override "${args.name}" now matches ${args.rule}.`,
332
+ )
333
+ },
334
+ })
335
+
336
+ const overrideUnmatchSub = defineCommand({
337
+ meta: { name: 'unmatch', description: 'remove a match rule from a `modelOverrides` entry' },
338
+ args: {
339
+ name: { type: 'positional', description: 'override name', required: true },
340
+ rule: { type: 'positional', description: 'match rule to remove', required: true },
341
+ },
342
+ run({ args }) {
343
+ finishOverrideEdit(
344
+ removeOverrideMatch(ensureAgentDir(), args.name, args.rule),
345
+ `Override "${args.name}" no longer matches ${args.rule}.`,
346
+ )
347
+ },
348
+ })
349
+
350
+ const overrideRemoveSub = defineCommand({
351
+ meta: { name: 'remove', description: 'delete a `modelOverrides` entry' },
352
+ args: { name: { type: 'positional', description: 'override name', required: true } },
353
+ run({ args }) {
354
+ finishOverrideEdit(removeOverride(ensureAgentDir(), args.name), `Override "${args.name}" removed.`)
355
+ },
356
+ })
357
+
358
+ const overrideSub = defineCommand({
359
+ meta: {
360
+ name: 'override',
361
+ description: 'edit `modelOverrides` match rules (set profiles with `model set --override`)',
277
362
  },
363
+ subCommands: { match: overrideMatchSub, unmatch: overrideUnmatchSub, remove: overrideRemoveSub },
278
364
  })
279
365
 
280
366
  export const modelCommand = defineCommand({
@@ -288,9 +374,52 @@ export const modelCommand = defineCommand({
288
374
  remove: removeSub,
289
375
  list: listSub,
290
376
  thinking: thinkingSub,
377
+ override: overrideSub,
291
378
  },
292
379
  })
293
380
 
381
+ function runSetOverrideProfile(
382
+ cwd: string,
383
+ name: string,
384
+ profile: string,
385
+ picked: PickedModelRef,
386
+ args: { force?: boolean; thinking?: string; match?: string },
387
+ ): void {
388
+ let thinking: { level: ThinkingLevel | undefined } | undefined
389
+ if (args.thinking !== undefined) {
390
+ const parsed = parseThinkingArg(args.thinking)
391
+ if (!parsed.ok) {
392
+ console.error(errorLine(parsed.reason))
393
+ process.exit(1)
394
+ }
395
+ thinking = { level: parsed.level }
396
+ }
397
+ intro(`Setting model profile: ${profile} → ${picked.ref} in override ${name}`)
398
+ const result = setOverrideProfile(cwd, name, profile, picked.ref, {
399
+ force: args.force === true,
400
+ ...(args.match !== undefined ? { match: args.match } : {}),
401
+ ...(picked.meta !== undefined ? { meta: picked.meta } : {}),
402
+ ...(thinking !== undefined ? { thinkingLevel: thinking.level } : {}),
403
+ })
404
+ finishOverrideEdit(result, `Profile "${profile}" set in override "${name}".`, `${profile} → ${picked.ref}`)
405
+ }
406
+
407
+ function finishOverrideEdit(
408
+ result: { ok: true } | { ok: false; reason: string },
409
+ title: string,
410
+ details?: string,
411
+ ): void {
412
+ if (!result.ok) {
413
+ console.error(errorLine(result.reason))
414
+ process.exit(1)
415
+ }
416
+ done({
417
+ title: c.green(title),
418
+ ...(details !== undefined ? { details } : {}),
419
+ hints: [{ label: 'If the agent is running:', command: 'typeclaw reload' }],
420
+ })
421
+ }
422
+
294
423
  function ensureAgentDir(): string {
295
424
  const cwd = findAgentDir(process.cwd()) ?? process.cwd()
296
425
  if (!isInitialized(cwd)) {
@@ -0,0 +1,38 @@
1
+ import type { IncomingMessage } from 'node:http'
2
+ import { promisify } from 'node:util'
3
+ import { constants, zstdDecompress } from 'node:zlib'
4
+
5
+ const MAX_BODY = 32 * 1024 * 1024
6
+ const decompress = promisify(zstdDecompress)
7
+
8
+ export async function readCodingBody(
9
+ request: IncomingMessage,
10
+ signal: AbortSignal,
11
+ ): Promise<{ body: Buffer } | { status: number; code: string }> {
12
+ const chunks: Buffer[] = []
13
+ let size = 0
14
+ for await (const chunk of request) {
15
+ signal.throwIfAborted()
16
+ const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)
17
+ size += bytes.length
18
+ if (size > MAX_BODY) return { status: 413, code: 'request_too_large' }
19
+ chunks.push(bytes)
20
+ }
21
+ const compressed = Buffer.concat(chunks)
22
+ if (!request.headers['content-encoding']) return { body: compressed }
23
+ try {
24
+ // Both the output allocation and decoder window are bounded. Checking only
25
+ // compressed bytes would allow a tiny expansion bomb to exhaust the runtime.
26
+ const body = await decompress(compressed, {
27
+ maxOutputLength: MAX_BODY,
28
+ params: { [constants.ZSTD_d_windowLogMax]: 25 },
29
+ })
30
+ signal.throwIfAborted()
31
+ return { body }
32
+ } catch (error) {
33
+ if (signal.aborted) throw error
34
+ return error instanceof Error && 'code' in error && error.code === 'ERR_BUFFER_TOO_LARGE'
35
+ ? { status: 413, code: 'request_too_large' }
36
+ : { status: 400, code: 'invalid_compression' }
37
+ }
38
+ }