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
@@ -1,129 +0,0 @@
1
- import type { ProviderCredential } from './schema'
2
-
3
- // Emit the on-disk shape Claude Code consumes at ~/.claude/.credentials.json
4
- // (Linux/Windows; macOS keeps this same JSON inside the Keychain entry
5
- // "Claude Code-credentials"). The single required top-level key is
6
- // `claudeAiOauth`. Field names use camelCase, not snake_case — diverging
7
- // from Codex CLI's `tokens.access_token` shape but matching every
8
- // third-party Claude Code integration we surveyed (ATLAS_OS, OmniRoute,
9
- // jcode, paperclip, opencode-claude-auth).
10
- //
11
- // `expiresAt` is MILLISECONDS since epoch, not seconds and not ISO. The
12
- // CLI carries no top-level expiry field outside `claudeAiOauth` — token
13
- // expiry is recorded both as `expiresAt` here and embedded in the JWT
14
- // `exp` claim of `accessToken`. The runtime exporter (export-claude-
15
- // credentials-file.ts) uses the JWT exp for its newer-wins compare,
16
- // mirroring the Codex CLI exporter's approach, because `expiresAt` is
17
- // the field Claude Code itself rewrites on in-place refresh.
18
- //
19
- // `mcpOAuth` (MCP server OAuth state) may coexist alongside
20
- // `claudeAiOauth` in the same file. This emitter accepts an optional
21
- // `preserveMcpOAuth` block so callers that read-merge-write the file
22
- // don't drop unrelated state. Codex CLI's file is fully owned by the
23
- // OAuth credential and has no equivalent; this is the one extra
24
- // complication versus emitCodexAuthJson.
25
- export type ClaudeAiOauthBlock = {
26
- accessToken: string
27
- refreshToken: string
28
- expiresAt: number
29
- scopes?: string[]
30
- subscriptionType?: string
31
- }
32
-
33
- export type EmitClaudeCredentialsJsonOptions = {
34
- preserveMcpOAuth?: unknown
35
- }
36
-
37
- export function emitClaudeCredentialsJson(
38
- credential: ProviderCredential,
39
- options: EmitClaudeCredentialsJsonOptions = {},
40
- ): string {
41
- if (credential.type !== 'oauth') {
42
- throw new Error('emitClaudeCredentialsJson only accepts oauth-typed credentials')
43
- }
44
- const fields = credential as ProviderCredential & {
45
- access?: unknown
46
- refresh?: unknown
47
- expires?: unknown
48
- scopes?: unknown
49
- subscriptionType?: unknown
50
- }
51
- const access = fields.access
52
- const refresh = fields.refresh
53
- if (typeof access !== 'string' || access.length === 0) {
54
- throw new Error('credential is missing a non-empty `access` field')
55
- }
56
- if (typeof refresh !== 'string' || refresh.length === 0) {
57
- throw new Error('credential is missing a non-empty `refresh` field')
58
- }
59
-
60
- // Resolution order for `expiresAt`:
61
- // 1. `expires` on the credential (pi-ai writes absolute ms epoch here).
62
- // 2. JWT `exp` claim decoded from `access`.
63
- // 3. 0 — Claude Code treats a missing/zero expiry as "expired" and
64
- // triggers an immediate refresh on next use, which is the safe
65
- // fallback when neither source is available.
66
- const expiresAt = readExpiryMs(fields, access)
67
-
68
- const claudeAiOauth: ClaudeAiOauthBlock = {
69
- accessToken: access,
70
- refreshToken: refresh,
71
- expiresAt,
72
- }
73
- if (Array.isArray(fields.scopes) && fields.scopes.every((s): s is string => typeof s === 'string')) {
74
- claudeAiOauth.scopes = fields.scopes
75
- }
76
- if (typeof fields.subscriptionType === 'string' && fields.subscriptionType.length > 0) {
77
- claudeAiOauth.subscriptionType = fields.subscriptionType
78
- }
79
-
80
- // Read-merge-write: preserve any existing `mcpOAuth` block the caller
81
- // supplied. The emitter doesn't read disk itself (that's the exporter's
82
- // job); the caller passes whatever it found at the existing file path.
83
- const out: Record<string, unknown> = { claudeAiOauth }
84
- if (options.preserveMcpOAuth !== undefined) {
85
- out['mcpOAuth'] = options.preserveMcpOAuth
86
- }
87
- return `${JSON.stringify(out, null, 2)}\n`
88
- }
89
-
90
- // Extracts the JWT `exp` claim (seconds since epoch) and converts to ms.
91
- // Used by the runtime exporter's newer-wins compare and by emit's
92
- // `expiresAt` fallback. Returns null on any decode failure; the caller
93
- // treats that as "unknown freshness". Logic mirrors
94
- // decodeCodexAccessTokenExpiryMs verbatim — Claude Code OAuth access
95
- // tokens are standard JWTs with the same base64url-encoded payload
96
- // shape Codex uses.
97
- export function decodeClaudeAccessTokenExpiryMs(accessToken: string): number | null {
98
- const parts = accessToken.split('.')
99
- if (parts.length !== 3) return null
100
- const middle = parts[1] ?? ''
101
- if (middle === '') return null
102
- const normalized = middle.replace(/-/g, '+').replace(/_/g, '/')
103
- const padded = normalized + '='.repeat((4 - (normalized.length % 4)) % 4)
104
- let payload: Record<string, unknown>
105
- try {
106
- const decoded = typeof atob === 'function' ? atob(padded) : Buffer.from(padded, 'base64').toString('utf8')
107
- const parsed: unknown = JSON.parse(decoded)
108
- if (!isPlainObject(parsed)) return null
109
- payload = parsed
110
- } catch {
111
- return null
112
- }
113
- const exp = payload['exp']
114
- if (typeof exp !== 'number' || !Number.isFinite(exp)) return null
115
- return Math.floor(exp * 1000)
116
- }
117
-
118
- function readExpiryMs(fields: { expires?: unknown }, accessToken: string): number {
119
- if (typeof fields.expires === 'number' && Number.isFinite(fields.expires)) {
120
- return fields.expires
121
- }
122
- const fromJwt = decodeClaudeAccessTokenExpiryMs(accessToken)
123
- if (fromJwt !== null) return fromJwt
124
- return 0
125
- }
126
-
127
- function isPlainObject(value: unknown): value is Record<string, unknown> {
128
- return typeof value === 'object' && value !== null && !Array.isArray(value)
129
- }
@@ -1,102 +0,0 @@
1
- import type { ProviderCredential } from './schema'
2
-
3
- // Emit the on-disk shape Codex CLI consumes at ~/.codex/auth.json: a `tokens`
4
- // object with id_token, access_token, refresh_token, and optional account_id.
5
- // No top-level `expires` — codex re-derives expiry from the JWT `exp` claim.
6
- //
7
- // id_token is load-bearing: codex's deserializer (token_data.rs) declares
8
- // `id_token: IdTokenInfo` with no Option/#[serde(default)], so omitting it
9
- // fails the whole auth.json load with `missing field id_token` before any
10
- // model call. codex parses it via `parse_chatgpt_jwt_claims`, which accepts
11
- // any decodable 3-part JWT and treats every claim as optional.
12
- //
13
- // We prefer a real captured id_token (`idToken`/`id_token` on the credential,
14
- // e.g. from a future pi-ai that persists it) and fall back to `access`. The
15
- // fallback is sound because this flow's access token is itself a ChatGPT-claims
16
- // JWT (carries `https://api.openai.com/auth`), so codex reads the same
17
- // plan/account fields from it — self-healing agents whose stored credential
18
- // predates id_token capture, without a re-login.
19
- export function emitCodexAuthJson(credential: ProviderCredential): string {
20
- if (credential.type !== 'oauth') {
21
- throw new Error('emitCodexAuthJson only accepts oauth-typed credentials')
22
- }
23
- const fields = credential as ProviderCredential & {
24
- access?: unknown
25
- refresh?: unknown
26
- accountId?: unknown
27
- idToken?: unknown
28
- id_token?: unknown
29
- }
30
- const access = fields.access
31
- const refresh = fields.refresh
32
- if (typeof access !== 'string' || access.length === 0) {
33
- throw new Error('credential is missing a non-empty `access` field')
34
- }
35
- if (typeof refresh !== 'string' || refresh.length === 0) {
36
- throw new Error('credential is missing a non-empty `refresh` field')
37
- }
38
-
39
- const capturedIdToken = firstNonEmptyString(fields.idToken, fields.id_token)
40
- const idToken = capturedIdToken ?? access
41
-
42
- const tokens: Record<string, string> = {
43
- id_token: idToken,
44
- access_token: access,
45
- refresh_token: refresh,
46
- }
47
- if (typeof fields.accountId === 'string' && fields.accountId.length > 0) {
48
- tokens['account_id'] = fields.accountId
49
- }
50
- return `${JSON.stringify({ tokens }, null, 2)}\n`
51
- }
52
-
53
- function firstNonEmptyString(...values: unknown[]): string | null {
54
- for (const value of values) {
55
- if (typeof value === 'string' && value.length > 0) return value
56
- }
57
- return null
58
- }
59
-
60
- // Extracts the JWT `exp` claim (seconds since epoch) and converts to ms.
61
- // Used by the runtime exporter's newer-wins compare: ~/.codex/auth.json
62
- // carries no top-level expiry, but the JWT inside `tokens.access_token`
63
- // does. Returns null on any decode failure; the caller treats that as
64
- // "unknown freshness" and falls back to overwriting from typeclaw's copy.
65
- export function decodeCodexAccessTokenExpiryMs(accessToken: string): number | null {
66
- const payload = decodeJwtPayload(accessToken)
67
- if (payload === null) return null
68
- const exp = payload['exp']
69
- if (typeof exp !== 'number' || !Number.isFinite(exp)) return null
70
- return Math.floor(exp * 1000)
71
- }
72
-
73
- // True when the string decodes the way codex's `decode_jwt_payload` requires:
74
- // three non-empty dot-separated parts with a base64url payload that is a JSON
75
- // object. codex runs exactly this on `tokens.id_token` (via
76
- // `parse_chatgpt_jwt_claims`) and rejects the whole auth.json if it fails, so
77
- // the exporter uses this to decide whether an on-disk id_token is usable —
78
- // not just non-empty.
79
- export function isDecodableJwt(token: string): boolean {
80
- return decodeJwtPayload(token) !== null
81
- }
82
-
83
- function decodeJwtPayload(jwt: string): Record<string, unknown> | null {
84
- const parts = jwt.split('.')
85
- if (parts.length !== 3) return null
86
- const middle = parts[1] ?? ''
87
- if (middle === '') return null
88
- // base64url → base64, then pad to a multiple of 4 (atob is strict).
89
- const normalized = middle.replace(/-/g, '+').replace(/_/g, '/')
90
- const padded = normalized + '='.repeat((4 - (normalized.length % 4)) % 4)
91
- try {
92
- const decoded = typeof atob === 'function' ? atob(padded) : Buffer.from(padded, 'base64').toString('utf8')
93
- const parsed: unknown = JSON.parse(decoded)
94
- return isPlainObject(parsed) ? parsed : null
95
- } catch {
96
- return null
97
- }
98
- }
99
-
100
- function isPlainObject(value: unknown): value is Record<string, unknown> {
101
- return typeof value === 'object' && value !== null && !Array.isArray(value)
102
- }
@@ -1,270 +0,0 @@
1
- import {
2
- chmodSync,
3
- mkdirSync,
4
- readFileSync,
5
- readlinkSync,
6
- renameSync,
7
- statSync,
8
- unlinkSync,
9
- writeFileSync,
10
- } from 'node:fs'
11
- import { homedir } from 'node:os'
12
- import { dirname, isAbsolute, join, posix, resolve } from 'node:path'
13
-
14
- import { decodeClaudeAccessTokenExpiryMs, emitClaudeCredentialsJson } from './claude-credentials-json'
15
- import type { ProviderCredential, Providers } from './schema'
16
- import { SecretsBackend } from './storage'
17
-
18
- const FILE_MODE = 0o600
19
- const DIR_MODE = 0o700
20
- export const CLAUDE_CREDENTIALS_FILE_NAME = '.credentials.json'
21
- export const CLAUDE_DEFAULT_CONFIG_DIR_NAME = '.claude'
22
- export const CLAUDE_CREDENTIALS_RELATIVE_PATH = posix.join(CLAUDE_DEFAULT_CONFIG_DIR_NAME, CLAUDE_CREDENTIALS_FILE_NAME)
23
-
24
- export type ExportClaudeCredentialsFileResult =
25
- | { action: 'skipped'; reason: SkipReason }
26
- | { action: 'wrote'; path: string }
27
- | { action: 'failed'; reason: string }
28
-
29
- export type SkipReason =
30
- | 'claude-code-disabled'
31
- | 'no-anthropic-credential'
32
- | 'credential-not-oauth'
33
- | 'on-disk-is-fresher'
34
-
35
- export type ExportClaudeCredentialsFileOptions = {
36
- claudeCodeEnabled: boolean
37
- providers: Providers
38
- homeDir?: string
39
- configDir?: string
40
- now?: () => number
41
- log?: (message: string) => void
42
- }
43
-
44
- // Writes typeclaw's anthropic OAuth credential to
45
- // $CLAUDE_CONFIG_DIR/.credentials.json (or $HOME/.claude/.credentials.json
46
- // by default) when it's safe to do so. Container HOME is /home/agent and
47
- // ephemeral; this boot-time export reconstructs the CLI file from secrets.json
48
- // after provider OAuth refresh has updated the canonical credential.
49
- //
50
- // Three guards, cheapest first. The first two return without ever touching
51
- // the filesystem, which keeps the 90% case (users who don't enable
52
- // Claude Code) at zero overhead on every container start.
53
- export function exportClaudeCredentialsFileIfApplicable(
54
- options: ExportClaudeCredentialsFileOptions,
55
- ): ExportClaudeCredentialsFileResult {
56
- if (!options.claudeCodeEnabled) return { action: 'skipped', reason: 'claude-code-disabled' }
57
-
58
- const credential = options.providers['anthropic']
59
- if (credential === undefined) return { action: 'skipped', reason: 'no-anthropic-credential' }
60
- if (credential.type !== 'oauth') return { action: 'skipped', reason: 'credential-not-oauth' }
61
-
62
- const targetPath = resolveClaudeCredentialsPath({
63
- ...(options.homeDir !== undefined ? { homeDir: options.homeDir } : {}),
64
- ...(options.configDir !== undefined ? { configDir: options.configDir } : {}),
65
- })
66
-
67
- try {
68
- const existing = readExisting(targetPath)
69
- if (!shouldOverwrite(existing, credential, options.now ?? Date.now)) {
70
- return { action: 'skipped', reason: 'on-disk-is-fresher' }
71
- }
72
- const mcpOAuthOpt = existing?.mcpOAuth !== undefined ? { preserveMcpOAuth: existing.mcpOAuth } : {}
73
- const contents = emitClaudeCredentialsJson(credential, mcpOAuthOpt)
74
- writeAtomic(targetPath, contents)
75
- return { action: 'wrote', path: targetPath }
76
- } catch (err) {
77
- const reason = err instanceof Error ? err.message : String(err)
78
- options.log?.(`exportClaudeCredentialsFile: ${reason}`)
79
- return { action: 'failed', reason }
80
- }
81
- }
82
-
83
- type ExistingFile = {
84
- onDiskAccessToken: string | null
85
- onDiskExpiresAt: number | null
86
- mcpOAuth: unknown
87
- }
88
-
89
- // Read once, parse once. Returns null when the file is missing OR
90
- // unparseable. Returning null short-circuits both branches of the
91
- // overwrite decision (the no-disk-file recovery path) AND drops any
92
- // non-recoverable mcpOAuth state — but if the file is unparseable
93
- // there's nothing to recover anyway. When parsing succeeds, we hand
94
- // back the access token (for the newer-wins compare) and the raw
95
- // mcpOAuth block (for read-merge-write preservation).
96
- function readExisting(targetPath: string): ExistingFile | null {
97
- let raw: string
98
- try {
99
- raw = readFileSync(targetPath, 'utf8')
100
- } catch {
101
- return null
102
- }
103
- let parsed: unknown
104
- try {
105
- parsed = JSON.parse(raw)
106
- } catch {
107
- return null
108
- }
109
- if (typeof parsed !== 'object' || parsed === null) return null
110
- const obj = parsed as Record<string, unknown>
111
- const claudeBlock = obj['claudeAiOauth']
112
- let onDiskAccessToken: string | null = null
113
- let onDiskExpiresAt: number | null = null
114
- if (typeof claudeBlock === 'object' && claudeBlock !== null) {
115
- const claudeObj = claudeBlock as Record<string, unknown>
116
- const access = claudeObj['accessToken']
117
- if (typeof access === 'string' && access.length > 0) onDiskAccessToken = access
118
- const expiresAt = claudeObj['expiresAt']
119
- if (typeof expiresAt === 'number' && Number.isFinite(expiresAt) && expiresAt > 0) {
120
- onDiskExpiresAt = expiresAt
121
- }
122
- }
123
- return { onDiskAccessToken, onDiskExpiresAt, mcpOAuth: obj['mcpOAuth'] }
124
- }
125
-
126
- // Newer-wins: skip the write unless typeclaw's stored credential is
127
- // strictly fresher than the on-disk expiry. Claude Code rotates tokens
128
- // in-place (issue #53063 in anthropics/claude-code confirms it rewrites
129
- // .credentials.json with a fresher accessToken/refreshToken/expiresAt
130
- // on every successful refresh), so on a restart the file may legitimately
131
- // be ahead of secrets.json. We must not clobber that.
132
- //
133
- // Ties skip: when expiries match there's nothing to gain from a write,
134
- // and avoiding the I/O keeps the steady state at zero churn.
135
- //
136
- // existing === null OR existing.onDiskAccessToken === null OR expiry
137
- // undecodable from both expiresAt and JWT → return true. That's the "we
138
- // have a valid credential, the file is unusable, replace it" recovery case.
139
- function shouldOverwrite(
140
- existing: ExistingFile | null,
141
- credential: ProviderCredential & { expires?: unknown; access?: unknown },
142
- now: () => number,
143
- ): boolean {
144
- if (existing === null) return true
145
- if (existing.onDiskAccessToken === null) return true
146
- const onDiskExpiry = readOnDiskExpiry(existing)
147
- if (onDiskExpiry === null) return true
148
- const credentialExpiry = readCredentialExpiry(credential, now)
149
- return credentialExpiry > onDiskExpiry
150
- }
151
-
152
- function readOnDiskExpiry(existing: ExistingFile): number | null {
153
- if (existing.onDiskExpiresAt !== null) return existing.onDiskExpiresAt
154
- if (existing.onDiskAccessToken === null) return null
155
- return decodeClaudeAccessTokenExpiryMs(existing.onDiskAccessToken)
156
- }
157
-
158
- // Resolution order for the credential's expiry:
159
- // 1. The `expires` field pi-ai writes (absolute ms epoch).
160
- // 2. The JWT `exp` claim decoded from `access`.
161
- // 3. Now — guarantees we still write on first boot when the credential
162
- // lacks both, rather than silently skipping forever.
163
- function readCredentialExpiry(credential: { expires?: unknown; access?: unknown }, now: () => number): number {
164
- if (typeof credential.expires === 'number' && Number.isFinite(credential.expires)) {
165
- return credential.expires
166
- }
167
- if (typeof credential.access === 'string') {
168
- const fromJwt = decodeClaudeAccessTokenExpiryMs(credential.access)
169
- if (fromJwt !== null) return fromJwt
170
- }
171
- return now()
172
- }
173
-
174
- export function resolveClaudeCredentialsPath(options: { homeDir?: string; configDir?: string } = {}): string {
175
- const configDir = resolveClaudeConfigDir(options.configDir)
176
- if (configDir !== null) return join(configDir, CLAUDE_CREDENTIALS_FILE_NAME)
177
- return join(options.homeDir ?? homedir(), CLAUDE_CREDENTIALS_RELATIVE_PATH)
178
- }
179
-
180
- function resolveClaudeConfigDir(configDir: string | undefined): string | null {
181
- const raw = configDir ?? process.env['CLAUDE_CONFIG_DIR']
182
- const trimmed = raw?.trim()
183
- return trimmed === undefined || trimmed.length === 0 ? null : trimmed
184
- }
185
-
186
- // Atomic temp-then-rename, mirroring export-codex-auth-file.ts's
187
- // writeAtomic. The directory is created with 0700 and the file with 0600
188
- // because the credential carries a long-lived refresh token — leaking it
189
- // via lax permissions defeats the whole point. The 0600 chmod after
190
- // rename is belt-and-suspenders: writeFileSync's `mode` is applied at
191
- // create time, but umask can mask it down on some filesystems.
192
- //
193
- // Symlink preservation remains a safety property even though TypeClaw no longer
194
- // plants one here. An operator or external tool may preconfigure the credentials
195
- // path as a symlink; POSIX rename(2) replaces that directory entry instead of
196
- // following it. Resolve the target and rename there so the caller's symlink
197
- // survives. The temp file MUST live alongside the real target because
198
- // renameSync across filesystems fails with EXDEV.
199
- function writeAtomic(targetPath: string, contents: string): void {
200
- const realTarget = resolveSymlinkTarget(targetPath)
201
- const dir = dirname(realTarget)
202
- mkdirSync(dir, { recursive: true, mode: DIR_MODE })
203
- const tmp = `${realTarget}.${process.pid}.${Date.now()}.tmp`
204
- writeFileSync(tmp, contents, { encoding: 'utf8', mode: FILE_MODE })
205
- try {
206
- renameSync(tmp, realTarget)
207
- } catch (err) {
208
- try {
209
- unlinkSync(tmp)
210
- } catch {
211
- // best-effort cleanup of the temp file when rename fails
212
- }
213
- throw err
214
- }
215
- try {
216
- statSync(realTarget)
217
- chmodSync(realTarget, FILE_MODE)
218
- } catch {
219
- // ignore — file vanished between rename and chmod is benign
220
- }
221
- }
222
-
223
- // Returns the absolute path renameSync should target. When `path` is a symlink,
224
- // returns the resolved absolute target so we write through the link instead of
225
- // replacing it. Otherwise returns the path unchanged. readlinkSync throws EINVAL
226
- // when the path exists but isn't a symlink and ENOENT when nothing is there —
227
- // both cases fall through to the original path.
228
- function resolveSymlinkTarget(path: string): string {
229
- let link: string
230
- try {
231
- link = readlinkSync(path)
232
- } catch {
233
- return path
234
- }
235
- return isAbsolute(link) ? link : resolve(dirname(path), link)
236
- }
237
-
238
- export type ExportClaudeCredentialsFileForAgentOptions = {
239
- agentDir: string
240
- claudeCodeEnabled: boolean
241
- homeDir?: string
242
- configDir?: string
243
- log?: (message: string) => void
244
- }
245
-
246
- // Boot-time convenience wrapper for src/run/index.ts. Mirrors
247
- // exportCodexAuthFileForAgent: takes agentDir, never throws, returns a
248
- // result the caller can ignore. Secrets-file read failures are caught
249
- // and surfaced as 'failed' so the agent boot is never blocked by a
250
- // missing or malformed secrets.json.
251
- export function exportClaudeCredentialsFileForAgent(
252
- options: ExportClaudeCredentialsFileForAgentOptions,
253
- ): ExportClaudeCredentialsFileResult {
254
- if (!options.claudeCodeEnabled) return { action: 'skipped', reason: 'claude-code-disabled' }
255
- let providers: Providers
256
- try {
257
- providers = new SecretsBackend(join(options.agentDir, 'secrets.json')).tryReadProvidersSync()
258
- } catch (err) {
259
- const reason = err instanceof Error ? err.message : String(err)
260
- options.log?.(`exportClaudeCredentialsFile: ${reason}`)
261
- return { action: 'failed', reason }
262
- }
263
- return exportClaudeCredentialsFileIfApplicable({
264
- claudeCodeEnabled: options.claudeCodeEnabled,
265
- providers,
266
- ...(options.homeDir !== undefined ? { homeDir: options.homeDir } : {}),
267
- ...(options.configDir !== undefined ? { configDir: options.configDir } : {}),
268
- ...(options.log !== undefined ? { log: options.log } : {}),
269
- })
270
- }