typeclaw 0.48.13 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +13 -6
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/dump-system-prompt.ts +52 -110
  317. package/scripts/require-parallel.ts +5 -32
  318. package/src/agent/guard-types.ts +3 -0
  319. package/src/agent/guards.ts +4 -0
  320. package/src/agent/idle-compaction.ts +174 -0
  321. package/src/agent/index.ts +210 -80
  322. package/src/agent/live-sessions.ts +2 -2
  323. package/src/agent/live-subagents.ts +20 -0
  324. package/src/agent/multimodal/look-at.ts +22 -9
  325. package/src/agent/plugin-tools.ts +66 -12
  326. package/src/agent/prompt-cache-key.ts +42 -0
  327. package/src/agent/provider-error.ts +179 -10
  328. package/src/agent/restart-handoff/index.ts +7 -14
  329. package/src/agent/reviewer-activity.ts +68 -0
  330. package/src/agent/reviewer-bash-policy.ts +41 -1
  331. package/src/agent/session-origin.ts +58 -9
  332. package/src/agent/subagent-cache-keepalive.ts +198 -0
  333. package/src/agent/subagent-session.ts +6 -0
  334. package/src/agent/subagents.ts +59 -9
  335. package/src/agent/system-prompt.ts +68 -202
  336. package/src/agent/todo/continuation-policy.ts +12 -4
  337. package/src/agent/tool-file-safety.ts +119 -15
  338. package/src/agent/tool-not-found-nudge.ts +1 -1
  339. package/src/agent/tools/channel-edit.ts +20 -10
  340. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  341. package/src/agent/tools/channel-handoff.ts +72 -0
  342. package/src/agent/tools/channel-history-render.ts +2 -1
  343. package/src/agent/tools/channel-read.ts +57 -10
  344. package/src/agent/tools/channel-reply.ts +55 -30
  345. package/src/agent/tools/channel-send.ts +69 -19
  346. package/src/agent/tools/channel-session-search.ts +35 -0
  347. package/src/agent/tools/curl-impersonate.ts +22 -6
  348. package/src/agent/tools/ddg.ts +13 -5
  349. package/src/agent/tools/post-github-review.ts +77 -15
  350. package/src/agent/tools/skip-response.ts +2 -2
  351. package/src/agent/tools/spawn-subagent.ts +190 -23
  352. package/src/agent/tools/stream-snapshot.ts +15 -2
  353. package/src/agent/tools/subagent-access.ts +11 -4
  354. package/src/agent/tools/subagent-output.ts +8 -0
  355. package/src/browser/bsk-shim.mjs +74 -0
  356. package/src/browser/dockerfile.ts +84 -0
  357. package/src/browser/egress.ts +104 -0
  358. package/src/browser/managed-browser.ts +205 -0
  359. package/src/browser/registry.ts +110 -0
  360. package/src/browser/relay.ts +231 -0
  361. package/src/browser/sandbox-entry.ts +167 -0
  362. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  363. package/src/bundled-plugins/backup/README.md +10 -9
  364. package/src/bundled-plugins/backup/runner.ts +140 -58
  365. package/src/bundled-plugins/backup/subagents.ts +58 -26
  366. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  367. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  368. package/src/bundled-plugins/doc-render/index.ts +0 -10
  369. package/src/bundled-plugins/doc-render/render.ts +83 -111
  370. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  371. package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
  372. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  373. package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
  374. package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
  375. package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
  376. package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
  377. package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
  378. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  379. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  380. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  381. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  382. package/src/bundled-plugins/operator/operator.ts +15 -4
  383. package/src/bundled-plugins/qa/index.ts +11 -0
  384. package/src/bundled-plugins/qa/qa.ts +160 -0
  385. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  386. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  387. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  388. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  389. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  390. package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
  391. package/src/bundled-plugins/security/index.ts +103 -36
  392. package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
  393. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  394. package/src/channels/adapter-namespace.ts +13 -0
  395. package/src/channels/adapters/discord-bot-reactions.ts +18 -0
  396. package/src/channels/adapters/discord-bot.ts +219 -72
  397. package/src/channels/adapters/discord-reactions.ts +18 -0
  398. package/src/channels/adapters/discord.ts +114 -8
  399. package/src/channels/adapters/github/inbound.ts +103 -8
  400. package/src/channels/adapters/github/index.ts +267 -19
  401. package/src/channels/adapters/github/last-alive.ts +15 -0
  402. package/src/channels/adapters/github/outbound.ts +54 -18
  403. package/src/channels/adapters/github/pending-review-store.ts +141 -0
  404. package/src/channels/adapters/github/permission-guidance.ts +1 -0
  405. package/src/channels/adapters/github/reactions.ts +100 -0
  406. package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
  407. package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
  408. package/src/channels/adapters/github/recovery.ts +106 -0
  409. package/src/channels/adapters/github/review-check.ts +510 -0
  410. package/src/channels/adapters/github/review-submitter.ts +34 -2
  411. package/src/channels/adapters/instagram.ts +32 -14
  412. package/src/channels/adapters/kakaotalk.ts +22 -7
  413. package/src/channels/adapters/line.ts +18 -3
  414. package/src/channels/adapters/outbound-account.ts +20 -0
  415. package/src/channels/adapters/own-reactions.ts +66 -0
  416. package/src/channels/adapters/recovery-correlation.ts +214 -0
  417. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  418. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  419. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  420. package/src/channels/adapters/slack-bot-classify.ts +19 -11
  421. package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
  422. package/src/channels/adapters/slack-bot-reactions.ts +18 -0
  423. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  424. package/src/channels/adapters/slack-bot.ts +424 -124
  425. package/src/channels/adapters/slack-classify.ts +26 -4
  426. package/src/channels/adapters/slack-inbound-revision.ts +96 -0
  427. package/src/channels/adapters/slack-reactions.ts +18 -0
  428. package/src/channels/adapters/slack-thread-ts.ts +6 -0
  429. package/src/channels/adapters/slack.ts +48 -3
  430. package/src/channels/adapters/teams.ts +14 -4
  431. package/src/channels/adapters/telegram-bot.ts +56 -10
  432. package/src/channels/adapters/webex-bot.ts +12 -2
  433. package/src/channels/adapters/webex.ts +12 -2
  434. package/src/channels/background-handoff.ts +434 -0
  435. package/src/channels/background-obligations.ts +893 -0
  436. package/src/channels/catch-up.ts +137 -0
  437. package/src/channels/continuation-willingness.ts +2 -2
  438. package/src/channels/continuity-types.ts +272 -0
  439. package/src/channels/engagement.ts +17 -1
  440. package/src/channels/github-false-receipt.ts +3 -3
  441. package/src/channels/github-rereview-guard.ts +9 -5
  442. package/src/channels/github-review-check.ts +598 -0
  443. package/src/channels/github-review-turn-ledger.ts +102 -28
  444. package/src/channels/github-review-verdict-coordinator.ts +72 -12
  445. package/src/channels/github-token-bridge.ts +35 -5
  446. package/src/channels/inbound-journal.ts +1738 -0
  447. package/src/channels/index.ts +6 -1
  448. package/src/channels/last-alive.ts +34 -0
  449. package/src/channels/manager.ts +25 -8
  450. package/src/channels/recovery-dispatcher.ts +264 -0
  451. package/src/channels/recovery-notice.ts +94 -0
  452. package/src/channels/recovery-outbox.ts +459 -0
  453. package/src/channels/router.ts +2951 -736
  454. package/src/channels/schema.ts +8 -1
  455. package/src/channels/session-handoff.fixture.ts +144 -0
  456. package/src/channels/session-handoff.ts +175 -0
  457. package/src/channels/session-search.ts +71 -0
  458. package/src/channels/subagent-completion-bridge.ts +17 -14
  459. package/src/channels/types.ts +133 -18
  460. package/src/channels/waiting-reactions.ts +664 -0
  461. package/src/cli/channel.ts +2 -3
  462. package/src/cli/compose.ts +7 -4
  463. package/src/cli/hostd.ts +49 -3
  464. package/src/cli/init.ts +2 -3
  465. package/src/cli/inspect.ts +11 -14
  466. package/src/cli/model.ts +132 -3
  467. package/src/coding-agent/broker-body.ts +38 -0
  468. package/src/coding-agent/broker.ts +290 -0
  469. package/src/coding-agent/claude.ts +95 -0
  470. package/src/coding-agent/codex.ts +104 -0
  471. package/src/coding-agent/index.ts +512 -0
  472. package/src/coding-agent/omo-state.ts +69 -0
  473. package/src/coding-agent/omo-stream.ts +138 -0
  474. package/src/coding-agent/omo.ts +192 -0
  475. package/src/coding-agent/runner.ts +285 -0
  476. package/src/coding-agent/tool.ts +62 -0
  477. package/src/coding-agent/worktree.ts +355 -0
  478. package/src/compose/restart.ts +10 -3
  479. package/src/compose/start.ts +20 -3
  480. package/src/config/config.ts +121 -25
  481. package/src/config/model-overrides.ts +59 -0
  482. package/src/config/models-mutation.ts +185 -2
  483. package/src/config/providers-mutation.ts +12 -4
  484. package/src/config/providers.ts +71 -9
  485. package/src/container/exit-reason.ts +44 -0
  486. package/src/container/index.ts +5 -0
  487. package/src/container/log-archive.ts +51 -13
  488. package/src/container/memory-limit.ts +1 -1
  489. package/src/container/memory-oversubscription.ts +36 -6
  490. package/src/container/oom-events.ts +86 -0
  491. package/src/container/restart.ts +2 -0
  492. package/src/container/shared.ts +8 -1
  493. package/src/container/start.ts +120 -17
  494. package/src/container/stop.ts +6 -2
  495. package/src/container/tool-oom-priority.ts +32 -0
  496. package/src/cron/consumer.ts +10 -4
  497. package/src/cron/reloadable.ts +23 -2
  498. package/src/doctor/checks.ts +22 -8
  499. package/src/hostd/daemon.ts +33 -11
  500. package/src/hostd/spawn.ts +106 -5
  501. package/src/hostd/version.ts +20 -0
  502. package/src/hostd/watchdog.ts +241 -0
  503. package/src/init/auto-upgrade.ts +7 -1
  504. package/src/init/dockerfile.ts +112 -602
  505. package/src/init/index.ts +6 -6
  506. package/src/init/local-source-stamp.ts +68 -0
  507. package/src/init/models-dev.ts +4 -0
  508. package/src/init/validate-api-key.ts +3 -0
  509. package/src/mcp/client.ts +3 -1
  510. package/src/operations/classify-tool-outcome.ts +45 -1
  511. package/src/operations/incidents.ts +10 -5
  512. package/src/permissions/builtins.ts +7 -0
  513. package/src/permissions/permissions.ts +18 -9
  514. package/src/permissions/resolve.ts +7 -1
  515. package/src/plugin/context.ts +2 -0
  516. package/src/plugin/core-tool-names.ts +1 -1
  517. package/src/plugin/define.ts +1 -0
  518. package/src/plugin/hooks.ts +137 -0
  519. package/src/plugin/index.ts +7 -0
  520. package/src/plugin/manager.ts +4 -0
  521. package/src/plugin/types.ts +66 -1
  522. package/src/run/background-handoff-boot.ts +86 -0
  523. package/src/run/bundled-plugins.ts +6 -0
  524. package/src/run/index.ts +107 -97
  525. package/src/run/llm-fetch-observer.ts +12 -15
  526. package/src/run/resource-sample.ts +19 -0
  527. package/src/sandbox/build.ts +4 -0
  528. package/src/sandbox/canonical-secrets.ts +4 -0
  529. package/src/sandbox/coding-agent.ts +214 -0
  530. package/src/sandbox/dev-source.ts +26 -0
  531. package/src/sandbox/hidden-paths.ts +16 -2
  532. package/src/sandbox/policy.ts +1 -0
  533. package/src/sandbox/runtime-private.ts +4 -1
  534. package/src/secrets/coding-agent-auth.ts +97 -0
  535. package/src/secrets/index.ts +0 -16
  536. package/src/secrets/storage.ts +13 -0
  537. package/src/server/command-runner.ts +6 -2
  538. package/src/server/index.ts +101 -40
  539. package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
  540. package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
  541. package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
  542. package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
  543. package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
  544. package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
  545. package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
  546. package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
  547. package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
  548. package/src/skills/typeclaw-config/SKILL.md +60 -26
  549. package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
  550. package/src/skills/typeclaw-cron/SKILL.md +1 -1
  551. package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
  552. package/src/skills/typeclaw-memory/SKILL.md +3 -3
  553. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  554. package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
  555. package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
  556. package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
  557. package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
  558. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  559. package/src/skills/typeclaw-plugins/SKILL.md +15 -15
  560. package/src/skills/typeclaw-skills/SKILL.md +19 -2
  561. package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
  562. package/typeclaw.schema.json +448 -6
  563. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  564. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
  565. package/src/secrets/claude-credentials-json.ts +0 -129
  566. package/src/secrets/codex-auth-json.ts +0 -102
  567. package/src/secrets/export-claude-credentials-file.ts +0 -270
  568. package/src/secrets/export-codex-auth-file.ts +0 -250
  569. package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
  570. package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
  571. package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
  572. package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
@@ -0,0 +1,290 @@
1
+ import { randomBytes, timingSafeEqual } from 'node:crypto'
2
+ import { once } from 'node:events'
3
+ import { createServer, request as httpRequest, type IncomingMessage, type ServerResponse } from 'node:http'
4
+ import { request as httpsRequest } from 'node:https'
5
+
6
+ import type { CodingAgentAuth, CodingAgentAuthResolver, CodingAgentProvider } from '@/secrets/coding-agent-auth'
7
+
8
+ import { readCodingBody } from './broker-body'
9
+
10
+ const MAX_STREAMS = 4
11
+ const ANTHROPIC_ROUTES = new Set(['/v1/messages', '/v1/messages/count_tokens'])
12
+ const ANTHROPIC_HEADERS = ['anthropic-version', 'anthropic-beta', 'user-agent', 'x-app'] as const
13
+ const CODEX_HEADERS = ['user-agent', 'originator', 'version', 'session_id', 'x-codex-turn-metadata'] as const
14
+ const OMO_CODEX_HEADERS = [
15
+ ...CODEX_HEADERS,
16
+ 'openai-beta',
17
+ 'session-id',
18
+ 'thread-id',
19
+ 'x-client-request-id',
20
+ 'x-codex-routing-hint',
21
+ ] as const
22
+ const REJECTED_HEADERS = [
23
+ 'proxy-authorization',
24
+ 'forwarded',
25
+ 'x-forwarded-host',
26
+ 'x-forwarded-for',
27
+ 'anthropic-organization-id',
28
+ 'anthropic-workspace-id',
29
+ 'x-organization-id',
30
+ 'x-workspace-id',
31
+ 'chatgpt-account-id',
32
+ 'openai-organization',
33
+ 'openai-project',
34
+ ] as const
35
+
36
+ export class SecretScrubber {
37
+ private pending = ''
38
+ constructor(private readonly secrets: readonly string[]) {}
39
+
40
+ push(text: string, final = false): string {
41
+ this.pending += text
42
+ const secrets = this.secrets.filter(Boolean)
43
+ const keep = Math.max(1, ...secrets.map((s) => s.length)) - 1
44
+ let index = 0
45
+ let output = ''
46
+ while (index < this.pending.length && (final || index < this.pending.length - keep)) {
47
+ const secret = secrets.find((value) => this.pending.startsWith(value, index))
48
+ if (secret) {
49
+ output += '[redacted]'
50
+ index += secret.length
51
+ } else {
52
+ output += this.pending[index]
53
+ index++
54
+ }
55
+ }
56
+ this.pending = this.pending.slice(index)
57
+ return output
58
+ }
59
+ }
60
+
61
+ export type CodingBroker = {
62
+ readonly baseUrl: string
63
+ readonly capability: string
64
+ close(): Promise<void>
65
+ }
66
+
67
+ export async function startCodingBroker(
68
+ options: {
69
+ provider?: CodingAgentProvider
70
+ engine?: 'claude' | 'codex' | 'omo'
71
+ auth: CodingAgentAuthResolver
72
+ allowedModels: readonly string[]
73
+ deadline: number
74
+ signal?: AbortSignal
75
+ },
76
+ // Dependency injection for wire-level tests only. No config/tool operand can select a destination.
77
+ testDependencies?: { upstream: URL },
78
+ ): Promise<CodingBroker> {
79
+ const provider = options.provider ?? 'anthropic'
80
+ const omo = options.engine === 'omo'
81
+ const oauthShape =
82
+ omo &&
83
+ provider === 'anthropic' &&
84
+ (await options.auth.resolve(options.signal, undefined, provider)).type === 'oauth'
85
+ // Senpi 2026.10.10 selects OAuth body/tool shaping by this prefix. It is
86
+ // still a fresh local capability, never an upstream OAuth credential.
87
+ const capability = `${oauthShape ? 'sk-ant-oat01-' : ''}${randomBytes(32).toString('hex')}`
88
+ const controller = new AbortController()
89
+ const signal = options.signal ? AbortSignal.any([controller.signal, options.signal]) : controller.signal
90
+ const upstream =
91
+ testDependencies?.upstream ??
92
+ new URL(provider === 'anthropic' ? 'https://api.anthropic.com' : 'https://chatgpt.com')
93
+ let active = 0
94
+ let closed = false
95
+ const server = createServer({ maxHeaderSize: 16 * 1024 }, (req, res) => {
96
+ void handle(req, res).catch(() => {
97
+ if (!res.headersSent) reject(res, 502, 'upstream_unavailable')
98
+ else res.destroy()
99
+ })
100
+ })
101
+ server.maxHeadersCount = 64
102
+ server.on('connect', (_req, socket) => socket.end('HTTP/1.1 405 Method Not Allowed\r\nConnection: close\r\n\r\n'))
103
+ server.on('upgrade', (_req, socket) => socket.end('HTTP/1.1 400 Bad Request\r\nConnection: close\r\n\r\n'))
104
+ const listening = once(server, 'listening')
105
+ server.listen(0, '127.0.0.1')
106
+ await listening
107
+ const address = server.address()
108
+ if (!address || typeof address === 'string') throw new Error('Coding broker could not bind loopback.')
109
+ const baseUrl = `http://127.0.0.1:${address.port}`
110
+ let closing: Promise<void> | undefined
111
+ const close = (): Promise<void> => {
112
+ if (closing) return closing
113
+ closed = true
114
+ controller.abort()
115
+ clearTimeout(timer)
116
+ options.signal?.removeEventListener('abort', onAbort)
117
+ closing = new Promise<void>((resolve) => {
118
+ server.close(() => resolve())
119
+ server.closeAllConnections()
120
+ })
121
+ return closing
122
+ }
123
+ const onAbort = () => {
124
+ void close()
125
+ }
126
+ const timer = setTimeout(onAbort, Math.max(1, options.deadline - Date.now()))
127
+ options.signal?.addEventListener('abort', onAbort, { once: true })
128
+ if (signal.aborted) await close()
129
+ return { baseUrl, capability, close }
130
+
131
+ async function handle(req: IncomingMessage, res: ServerResponse): Promise<void> {
132
+ if (closed || signal.aborted || Date.now() >= options.deadline) return reject(res, 401, 'capability_expired')
133
+ const provided = req.headers.authorization
134
+ const expected = `Bearer ${capability}`
135
+ if (
136
+ typeof provided !== 'string' ||
137
+ provided.length !== expected.length ||
138
+ !timingSafeEqual(Buffer.from(provided), Buffer.from(expected))
139
+ )
140
+ return reject(res, 401, 'invalid_capability')
141
+ // Inspect the raw origin-form target; WHATWG URL would normalize traversal away.
142
+ const target = req.url ?? ''
143
+ const [route, query, extra] = target.split('?')
144
+ if (
145
+ req.method !== 'POST' ||
146
+ !route ||
147
+ !(provider === 'anthropic'
148
+ ? ANTHROPIC_ROUTES.has(route)
149
+ : route === (omo ? '/v1/codex/responses' : '/v1/responses')) ||
150
+ extra !== undefined ||
151
+ (query !== undefined && (provider !== 'anthropic' || query !== 'beta=true')) ||
152
+ req.rawHeaders.length > 128
153
+ ) {
154
+ return reject(res, 400, 'unsupported_request')
155
+ }
156
+ if (
157
+ req.headers.upgrade ||
158
+ (req.headers['content-encoding'] !== undefined &&
159
+ !(omo && provider === 'openai-codex' && req.headers['content-encoding'] === 'zstd')) ||
160
+ REJECTED_HEADERS.some((name) => req.headers[name] !== undefined) ||
161
+ req.headers.host !== new URL(baseUrl).host ||
162
+ !req.headers['content-type']?.startsWith('application/json')
163
+ )
164
+ return reject(res, 400, 'unsupported_headers')
165
+ if (active >= MAX_STREAMS) return reject(res, 429, 'concurrency_limit')
166
+ active++
167
+ const disconnected = new AbortController()
168
+ const requestSignal = AbortSignal.any([signal, disconnected.signal])
169
+ res.on('close', () => disconnected.abort())
170
+ try {
171
+ const read = await readCodingBody(req, requestSignal)
172
+ if ('code' in read) return reject(res, read.status, read.code)
173
+ const body = read.body
174
+ let value: unknown
175
+ try {
176
+ value = JSON.parse(body.toString('utf8'))
177
+ } catch {
178
+ return reject(res, 400, 'invalid_json')
179
+ }
180
+ if (!isObject(value) || typeof value.model !== 'string' || !options.allowedModels.includes(value.model)) {
181
+ return reject(res, 400, 'unsupported_model')
182
+ }
183
+ if (['url', 'base_url', 'baseURL', 'endpoint', 'upstream', 'destination'].some((key) => key in value)) {
184
+ return reject(res, 400, 'unsupported_destination')
185
+ }
186
+ let auth = await options.auth.resolve(requestSignal, undefined, provider)
187
+ const secrets = new Set(auth.secrets)
188
+ let response = await forward(auth)
189
+ if (response.statusCode === 401) {
190
+ response.destroy()
191
+ auth = await options.auth.resolve(requestSignal, auth, provider)
192
+ auth.secrets.forEach((secret) => secrets.add(secret))
193
+ response = await forward(auth)
194
+ }
195
+ const status = response.statusCode ?? 502
196
+ const allSecrets = [...secrets, capability]
197
+ const scrub = (text: string) => new SecretScrubber(allSecrets).push(text, true)
198
+ for (const [key, value] of Object.entries(response.headers)) {
199
+ if (typeof value !== 'string') continue
200
+ // Provider-prefixed rate-limit names are untrusted text too.
201
+ if (allSecrets.some((secret) => secret.length > 0 && key.includes(secret.toLowerCase()))) continue
202
+ if (key === 'request-id' || key === 'x-request-id') res.setHeader(key, scrub(value).slice(0, 200))
203
+ if (
204
+ (key === 'retry-after' || key.startsWith('anthropic-ratelimit-') || key.startsWith('x-ratelimit-')) &&
205
+ /^[0-9T:Z.+-]{1,64}$/.test(value)
206
+ ) {
207
+ res.setHeader(key, scrub(value))
208
+ }
209
+ }
210
+ if (status >= 300) {
211
+ response.destroy()
212
+ return reject(
213
+ res,
214
+ status === 429 ? 429 : status === 401 || status === 403 ? 401 : 502,
215
+ status === 429
216
+ ? 'rate_limit'
217
+ : status === 401 || status === 403
218
+ ? 'authentication_required'
219
+ : 'upstream_unavailable',
220
+ )
221
+ }
222
+ // The ChatGPT Codex backend streams SSE with no Content-Type header at all.
223
+ const contentType = response.headers['content-type'] ?? (provider === 'openai-codex' ? 'text/event-stream' : '')
224
+ if (!/^(application\/json|text\/event-stream)(;|$)/i.test(contentType)) {
225
+ response.destroy()
226
+ return reject(res, 502, 'unsupported_response')
227
+ }
228
+ res.statusCode = status
229
+ res.setHeader('content-type', contentType.split(';')[0] ?? 'application/json')
230
+ const scrubber = new SecretScrubber(allSecrets)
231
+ const decoder = new TextDecoder()
232
+ for await (const chunk of response) {
233
+ requestSignal.throwIfAborted()
234
+ const text = scrubber.push(decoder.decode(chunk, { stream: true }))
235
+ if (text && !res.write(text)) await once(res, 'drain', { signal: requestSignal })
236
+ }
237
+ res.end(scrubber.push(decoder.decode(), true))
238
+
239
+ function forward(credential: CodingAgentAuth): Promise<IncomingMessage> {
240
+ if ((credential.provider ?? 'anthropic') !== provider)
241
+ throw new Error('Inference credential provider mismatch.')
242
+ const headers: Record<string, string> = {
243
+ 'content-type': 'application/json',
244
+ ...(provider === 'anthropic' ? { 'anthropic-version': '2023-06-01' } : { accept: 'text/event-stream' }),
245
+ }
246
+ for (const key of provider === 'anthropic' ? ANTHROPIC_HEADERS : omo ? OMO_CODEX_HEADERS : CODEX_HEADERS) {
247
+ const value = req.headers[key]
248
+ if (typeof value === 'string') headers[key] = value
249
+ }
250
+ if (credential.provider === 'openai-codex') {
251
+ headers.authorization = `Bearer ${credential.token}`
252
+ headers['ChatGPT-Account-Id'] = credential.accountId
253
+ } else if (credential.type === 'oauth') {
254
+ headers.authorization = `Bearer ${credential.token}`
255
+ headers['anthropic-beta'] = [
256
+ ...new Set([
257
+ ...(headers['anthropic-beta'] ?? '').split(',').filter(Boolean),
258
+ 'claude-code-20250219',
259
+ 'oauth-2025-04-20',
260
+ ]),
261
+ ].join(',')
262
+ headers['x-app'] = 'cli'
263
+ } else headers['x-api-key'] = credential.token
264
+ // node:https does not honor ambient HTTP_PROXY/CA/URL overrides. Never follow Location.
265
+ return new Promise((resolve, rejectRequest) => {
266
+ const request = (upstream.protocol === 'https:' ? httpsRequest : httpRequest)(
267
+ new URL(provider === 'anthropic' ? target : '/backend-api/codex/responses', upstream),
268
+ { method: 'POST', headers, signal: requestSignal, rejectUnauthorized: true },
269
+ resolve,
270
+ )
271
+ request.on('error', () => rejectRequest(new Error('Inference transport failed.')))
272
+ // Forward the inspected JSON, never compressed bytes or an encoding
273
+ // header from the untrusted client.
274
+ request.end(JSON.stringify(value))
275
+ })
276
+ }
277
+ } finally {
278
+ active--
279
+ }
280
+ }
281
+ }
282
+
283
+ function reject(res: ServerResponse, status: number, code: string): void {
284
+ res.writeHead(status, { 'content-type': 'application/json', connection: 'close' })
285
+ res.end(JSON.stringify({ type: 'error', error: { type: code, message: code } }))
286
+ }
287
+
288
+ function isObject(value: unknown): value is Record<string, unknown> {
289
+ return typeof value === 'object' && value !== null && !Array.isArray(value)
290
+ }
@@ -0,0 +1,95 @@
1
+ import { z } from 'zod'
2
+
3
+ export const CLAUDE_CODE_VERSION = '2.1.299'
4
+ // Explicit compatibility set, not an open-ended provider allowlist.
5
+ export const CLAUDE_AUXILIARY_MODELS = ['claude-haiku-4-5-20251001', 'claude-sonnet-4-6', 'claude-opus-4-7'] as const
6
+ export type CodingMode = 'code' | 'plan'
7
+
8
+ export function claudeArguments(options: {
9
+ model: string
10
+ mode: CodingMode
11
+ sessionId: string
12
+ resume: boolean
13
+ }): string[] {
14
+ return [
15
+ 'claude',
16
+ '-p',
17
+ '--output-format',
18
+ 'stream-json',
19
+ '--verbose',
20
+ '--model',
21
+ options.model,
22
+ '--permission-mode',
23
+ options.mode === 'plan' ? 'plan' : 'dontAsk',
24
+ '--allowedTools',
25
+ 'Read,Edit,Write,Bash,Agent,Glob,Grep',
26
+ '--settings',
27
+ JSON.stringify({ sandbox: { enabled: false } }),
28
+ options.resume ? '--resume' : '--session-id',
29
+ options.sessionId,
30
+ ]
31
+ }
32
+
33
+ export function claudeEnvironment(configDir: string, baseUrl: string, capability: string): Record<string, string> {
34
+ return {
35
+ CLAUDE_CONFIG_DIR: configDir,
36
+ ANTHROPIC_BASE_URL: baseUrl,
37
+ ANTHROPIC_AUTH_TOKEN: capability,
38
+ CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1',
39
+ ANTHROPIC_DEFAULT_HAIKU_MODEL: CLAUDE_AUXILIARY_MODELS[0],
40
+ ANTHROPIC_DEFAULT_SONNET_MODEL: CLAUDE_AUXILIARY_MODELS[1],
41
+ ANTHROPIC_DEFAULT_OPUS_MODEL: CLAUDE_AUXILIARY_MODELS[2],
42
+ }
43
+ }
44
+
45
+ const eventSchema = z
46
+ .object({
47
+ type: z.string(),
48
+ session_id: z.string().uuid().optional(),
49
+ subtype: z.string().optional(),
50
+ is_error: z.boolean().optional(),
51
+ result: z.string().optional(),
52
+ permission_denials: z.array(z.unknown()).optional(),
53
+ })
54
+ .passthrough()
55
+
56
+ export class ClaudeStreamParser {
57
+ sessionId: string | undefined
58
+ finalMessage = ''
59
+ terminal = false
60
+ failed = false
61
+ permissionDenied = false
62
+ malformed = false
63
+ private pending = ''
64
+
65
+ push(text: string): void {
66
+ this.pending += text
67
+ if (this.pending.length > 4 * 1024 * 1024) throw new Error('Claude event exceeds the 4 MiB event limit.')
68
+ let newline: number
69
+ while ((newline = this.pending.indexOf('\n')) !== -1) {
70
+ const line = this.pending.slice(0, newline)
71
+ this.pending = this.pending.slice(newline + 1)
72
+ this.line(line)
73
+ }
74
+ }
75
+
76
+ finish(): void {
77
+ if (this.pending.trim()) this.line(this.pending)
78
+ this.pending = ''
79
+ }
80
+
81
+ private line(line: string): void {
82
+ if (!line.trim()) return
83
+ try {
84
+ const event = eventSchema.parse(JSON.parse(line))
85
+ if (event.session_id) this.sessionId = event.session_id
86
+ if (event.type !== 'result') return
87
+ this.terminal = true
88
+ this.failed = event.is_error === true || event.subtype !== 'success'
89
+ this.permissionDenied = (event.permission_denials?.length ?? 0) > 0
90
+ this.finalMessage = event.result ?? ''
91
+ } catch {
92
+ this.malformed = true
93
+ }
94
+ }
95
+ }
@@ -0,0 +1,104 @@
1
+ import { z } from 'zod'
2
+
3
+ export const CODEX_CLI_VERSION = '0.162.1'
4
+
5
+ export function codexArguments(options: { readonly sessionId: string; readonly resume: boolean }): string[] {
6
+ // The runner must establish outer bwrap confinement before executing this argv.
7
+ return [
8
+ 'codex',
9
+ 'exec',
10
+ '--json',
11
+ '--dangerously-bypass-approvals-and-sandbox',
12
+ ...(options.resume ? ['resume', options.sessionId] : []),
13
+ '-',
14
+ ]
15
+ }
16
+
17
+ export function codexEnvironment(configDir: string, capability: string): Record<string, string> {
18
+ return { CODEX_HOME: configDir, TYPECLAW_CODING_AGENT_CAPABILITY: capability }
19
+ }
20
+
21
+ export function codexConfig(model: string, baseUrl: string): string {
22
+ return `model_provider = "typeclaw"
23
+ model = ${JSON.stringify(model)}
24
+ approval_policy = "never"
25
+ check_for_update_on_startup = false
26
+ cli_auth_credentials_store = "ephemeral"
27
+
28
+ [model_providers.typeclaw]
29
+ name = "TypeClaw coding broker"
30
+ base_url = ${JSON.stringify(`${baseUrl}/v1`)}
31
+ wire_api = "responses"
32
+ requires_openai_auth = false
33
+ env_key = "TYPECLAW_CODING_AGENT_CAPABILITY"
34
+ supports_websockets = false
35
+ supports_standalone_web_search = false
36
+
37
+ [model_providers.typeclaw.capabilities]
38
+ remote_compaction = "unsupported"
39
+ `
40
+ }
41
+
42
+ const eventSchema = z.object({ type: z.string() }).passthrough()
43
+ const threadSchema = z.object({ thread_id: z.string().uuid() })
44
+ const itemSchema = z.object({
45
+ item: z.object({ type: z.string(), text: z.string().optional(), status: z.string().optional() }),
46
+ })
47
+
48
+ export class CodexStreamParser {
49
+ sessionId: string | undefined
50
+ finalMessage = ''
51
+ terminal = false
52
+ failed = false
53
+ permissionDenied = false
54
+ malformed = false
55
+ private pending = ''
56
+
57
+ push(text: string): void {
58
+ this.pending += text
59
+ if (this.pending.length > 4 * 1024 * 1024) throw new Error('Codex event exceeds the 4 MiB event limit.')
60
+ let newline: number
61
+ while ((newline = this.pending.indexOf('\n')) !== -1) {
62
+ const line = this.pending.slice(0, newline)
63
+ this.pending = this.pending.slice(newline + 1)
64
+ this.line(line)
65
+ }
66
+ }
67
+
68
+ finish(): void {
69
+ if (this.pending.trim()) this.line(this.pending)
70
+ this.pending = ''
71
+ }
72
+
73
+ private line(line: string): void {
74
+ if (!line.trim()) return
75
+ try {
76
+ const event = eventSchema.parse(JSON.parse(line))
77
+ switch (event.type) {
78
+ case 'thread.started':
79
+ this.sessionId = threadSchema.parse(event).thread_id
80
+ break
81
+ case 'turn.started':
82
+ this.terminal = false
83
+ this.finalMessage = ''
84
+ break
85
+ case 'item.completed': {
86
+ const { item } = itemSchema.parse(event)
87
+ if (item.type === 'agent_message') this.finalMessage = z.string().parse(item.text)
88
+ if (item.type === 'command_execution' && item.status === 'declined') this.permissionDenied = true
89
+ break
90
+ }
91
+ case 'turn.completed':
92
+ this.terminal = true
93
+ break
94
+ case 'turn.failed':
95
+ case 'error':
96
+ this.terminal = true
97
+ this.failed = true
98
+ break
99
+ }
100
+ } catch {
101
+ this.malformed = true
102
+ }
103
+ }
104
+ }