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,414 @@
1
+ import type { RecoveryFailure, RecoveryRecord } from "./continuity-types.js";
2
+ import type { AdapterId } from "./schema.js";
3
+ export type ChannelKey = {
4
+ adapter: AdapterId;
5
+ workspace: string;
6
+ chat: string;
7
+ thread: string | null;
8
+ };
9
+ export declare function fallbackChannelAccountIdentity(adapter: AdapterId, workspace: string, userId: string | null | undefined): string | undefined;
10
+ export type InboundAttachment = {
11
+ id: number;
12
+ kind: 'photo' | 'video' | 'audio' | 'file' | 'sticker' | 'multiphoto' | 'embed';
13
+ ref: string;
14
+ mimetype?: string;
15
+ filename?: string;
16
+ width?: number;
17
+ height?: number;
18
+ sizeBytes?: number;
19
+ };
20
+ export type GithubReviewFollowupRound = {
21
+ kind: 'push' | 'reply';
22
+ roundId: string;
23
+ workspace: string;
24
+ prNumber: number;
25
+ headSha: string;
26
+ carrierThread: string | null;
27
+ };
28
+ export type GithubReviewThreadCloseout = {
29
+ workspace: string;
30
+ prNumber: number;
31
+ rootCommentId: string;
32
+ deferUntil?: {
33
+ kind: 'review-state-unknown';
34
+ expiresAt: number;
35
+ };
36
+ };
37
+ export type RouteReceipt = {
38
+ kind: 'accepted';
39
+ inputId: string;
40
+ generation: number;
41
+ } | {
42
+ kind: 'duplicate';
43
+ inputId: string;
44
+ outcome?: 'delivered' | 'intentionally-suppressed';
45
+ } | {
46
+ kind: 'observed';
47
+ } | {
48
+ kind: 'denied';
49
+ } | {
50
+ kind: 'control';
51
+ };
52
+ export type InboundMessage = {
53
+ adapter: AdapterId;
54
+ workspace: string;
55
+ chat: string;
56
+ thread: string | null;
57
+ githubReviewRound?: GithubReviewFollowupRound;
58
+ githubPendingReview?: {
59
+ prId: number;
60
+ headSha: string;
61
+ kind: 'review' | 'rereview';
62
+ };
63
+ githubReviewThreadCloseout?: GithubReviewThreadCloseout;
64
+ room?: {
65
+ kind: 'thread';
66
+ parentChat?: string;
67
+ parentChatName?: string;
68
+ };
69
+ text: string;
70
+ routingNote?: string;
71
+ handoff?: true;
72
+ authorAdapter?: AdapterId;
73
+ referenceContext?: InboundReferenceContext;
74
+ attachments?: readonly InboundAttachment[];
75
+ externalMessageId: string;
76
+ accountIdentity?: string;
77
+ eventKind?: string;
78
+ revision?: string;
79
+ receiptId?: string;
80
+ authorId: string;
81
+ authorName: string;
82
+ authorIsBot: boolean;
83
+ isBotMention: boolean;
84
+ isBotMentionOnly?: boolean;
85
+ suppressSticky?: boolean;
86
+ replyToBotMessageId: string | null;
87
+ mentionsOthers: boolean;
88
+ replyToOtherMessageId: string | null;
89
+ isDm: boolean;
90
+ ts: number;
91
+ typingThread?: string;
92
+ reactionRef?: ReactionRef;
93
+ };
94
+ export type ReactionRef = {
95
+ adapter: AdapterId;
96
+ value: string;
97
+ };
98
+ export type ReactionRequest = {
99
+ adapter: AdapterId;
100
+ workspace: string;
101
+ chat: string;
102
+ thread?: string | null;
103
+ reactionRef: ReactionRef;
104
+ emoji: string;
105
+ };
106
+ export type RemoveReactionRequest = {
107
+ adapter: AdapterId;
108
+ workspace: string;
109
+ chat: string;
110
+ thread?: string | null;
111
+ reactionRef: ReactionRef;
112
+ };
113
+ export type ReactionErrorCode = 'permission-denied' | 'not-found' | 'unsupported' | 'rate-limited' | 'transient';
114
+ export type ReactionResult = {
115
+ ok: true;
116
+ reactionRef?: ReactionRef;
117
+ } | {
118
+ ok: false;
119
+ error: string;
120
+ code?: ReactionErrorCode;
121
+ };
122
+ export type ReactionCallback = (req: ReactionRequest) => Promise<ReactionResult>;
123
+ export type RemoveReactionCallback = (req: RemoveReactionRequest) => Promise<ReactionResult>;
124
+ export type OwnReactionTarget = {
125
+ accountIdentity: string;
126
+ target: ReactionRef;
127
+ emoji: string;
128
+ };
129
+ export type PrepareOwnReactionCallback = (req: ReactionRequest) => Promise<OwnReactionTarget | null>;
130
+ export type RemoveOwnReactionRequest = {
131
+ adapter: AdapterId;
132
+ workspace: string;
133
+ chat: string;
134
+ thread?: string | null;
135
+ target: ReactionRef;
136
+ emoji: string;
137
+ expectedAccountIdentity: string;
138
+ };
139
+ export type RemoveOwnReactionResult = {
140
+ ok: true;
141
+ } | {
142
+ ok: false;
143
+ code: 'unsupported' | 'transient' | 'rate-limit' | 'permission' | 'identity';
144
+ error: string;
145
+ retryAfter?: number;
146
+ };
147
+ export type RemoveOwnReactionCallback = (req: RemoveOwnReactionRequest) => Promise<RemoveOwnReactionResult>;
148
+ export type OutboundAttachment = {
149
+ path: string;
150
+ filename?: string;
151
+ };
152
+ export type SendOptions = {
153
+ accounting?: 'live-turn';
154
+ sessionId?: string;
155
+ turnId?: string;
156
+ claimGeneration?: number;
157
+ expectedAccountIdentity?: string;
158
+ coveredIds?: readonly string[];
159
+ } | {
160
+ accounting: 'recovery';
161
+ deliveryId: string;
162
+ coveredIds: readonly string[];
163
+ expectedAccountIdentity: string;
164
+ };
165
+ export type RecoveryReconcileResult = {
166
+ status: 'found';
167
+ messageId?: string;
168
+ messageIds?: readonly string[];
169
+ } | {
170
+ status: 'unknown' | 'unreconcilable';
171
+ };
172
+ export declare class RecoveryTransportError extends Error {
173
+ readonly failure: RecoveryFailure;
174
+ constructor(failure: RecoveryFailure);
175
+ }
176
+ export type RecoveryAdapterCallbacks = {
177
+ accountIdentity: (workspace?: string) => Promise<string | undefined>;
178
+ cachedAccountIdentity?: (workspace?: string) => string | undefined;
179
+ reconcile: (record: RecoveryRecord) => Promise<RecoveryReconcileResult>;
180
+ /**
181
+ * Whether this adapter has already re-admitted the interrupted work itself, so the restart
182
+ * notice would be wrong. `pending` defers the notice while that answer is still being decided.
183
+ */
184
+ redelivery?: (record: RecoveryRecord, eventKinds: readonly string[]) => RecoveryRedelivery;
185
+ };
186
+ export type RecoveryRedelivery = 'redelivered' | 'pending' | 'not-redelivered';
187
+ export type OutboundMessage = {
188
+ adapter: AdapterId;
189
+ workspace: string;
190
+ chat: string;
191
+ thread?: string | null;
192
+ text?: string;
193
+ link_previews?: boolean;
194
+ attachments?: OutboundAttachment[];
195
+ typingThread?: string;
196
+ replyTo?: OutboundReplyTo;
197
+ sendOptions?: SendOptions;
198
+ };
199
+ export type OutboundReplyTo = {
200
+ externalMessageId: string;
201
+ source?: QuoteAnchorSource;
202
+ };
203
+ export type QuoteAnchorSource = {
204
+ adapter: AdapterId;
205
+ authorId: string;
206
+ authorName: string;
207
+ text: string;
208
+ };
209
+ export type InboundReferenceContext = {
210
+ kind: 'reply' | 'quote' | 'link';
211
+ sources: readonly QuoteAnchorSource[];
212
+ };
213
+ export type SendErrorCode = 'duplicate' | 'turn-cap' | 'outbound-flood' | 'no-adapter' | 'callback-rejected' | 'skip-locked';
214
+ export type SendResult = {
215
+ ok: true;
216
+ messageId?: string;
217
+ messageIds?: readonly string[];
218
+ reactionRef?: ReactionRef;
219
+ deliveredText?: string;
220
+ } | {
221
+ ok: false;
222
+ error: string;
223
+ code?: SendErrorCode;
224
+ recoveryFailure?: RecoveryFailure;
225
+ };
226
+ export type OutboundCallback = (msg: OutboundMessage) => Promise<SendResult>;
227
+ export type EditMessageRequest = {
228
+ adapter: AdapterId;
229
+ workspace: string;
230
+ chat: string;
231
+ thread?: string | null;
232
+ messageId: string;
233
+ text: string;
234
+ };
235
+ export type EditMessageResult = {
236
+ ok: true;
237
+ deliveredText?: string;
238
+ } | {
239
+ ok: false;
240
+ error: string;
241
+ code?: 'not-found' | 'not-supported' | 'adapter-unavailable' | 'permission-denied';
242
+ };
243
+ export type EditMessageCallback = (req: EditMessageRequest) => Promise<EditMessageResult>;
244
+ export type TypingTarget = {
245
+ adapter: AdapterId;
246
+ workspace: string;
247
+ chat: string;
248
+ thread?: string | null;
249
+ typingThread?: string;
250
+ phase: 'tick' | 'stop';
251
+ };
252
+ export type TypingCallback = (target: TypingTarget) => Promise<void>;
253
+ export type ResolvedChannelNames = {
254
+ chatName?: string;
255
+ workspaceName?: string;
256
+ };
257
+ export type ChannelNameResolver = (key: ChannelKey) => Promise<ResolvedChannelNames>;
258
+ export type ChannelSelfIdentity = {
259
+ id: string;
260
+ username?: string;
261
+ };
262
+ export type ChannelSelfIdentityResolver = (workspace: string) => ChannelSelfIdentity | null;
263
+ export type ChannelHistoryMessage = {
264
+ externalMessageId: string;
265
+ authorId: string;
266
+ authorName: string;
267
+ text: string;
268
+ referenceContext?: InboundReferenceContext;
269
+ attachments?: readonly InboundAttachment[];
270
+ ts: number;
271
+ isBot: boolean;
272
+ replyToBotMessageId: string | null;
273
+ };
274
+ export type FetchHistoryArgs = {
275
+ chat: string;
276
+ thread: string | null;
277
+ limit: number;
278
+ cursor?: string;
279
+ prefetch?: boolean;
280
+ };
281
+ export type FetchHistoryResult = {
282
+ ok: true;
283
+ messages: ChannelHistoryMessage[];
284
+ nextCursor?: string;
285
+ } | {
286
+ ok: false;
287
+ error: string;
288
+ skipReason?: 'rate-limited';
289
+ };
290
+ export type HistoryCallback = (args: FetchHistoryArgs) => Promise<FetchHistoryResult>;
291
+ export type GetMessageArgs = {
292
+ chat: string;
293
+ thread: string | null;
294
+ messageId: string;
295
+ };
296
+ export type GetMessageResult = {
297
+ ok: true;
298
+ message: ChannelHistoryMessage;
299
+ } | {
300
+ ok: false;
301
+ error: string;
302
+ code?: 'not-found' | 'not-supported' | 'adapter-unavailable' | 'adapter-error';
303
+ };
304
+ export type MessageGetCallback = (args: GetMessageArgs) => Promise<GetMessageResult>;
305
+ export type ChannelListEntry = {
306
+ chat: string;
307
+ name: string;
308
+ kind: 'channel' | 'dm' | 'group' | 'thread';
309
+ isMember?: boolean;
310
+ };
311
+ export type ListChannelsArgs = {
312
+ workspace: string;
313
+ limit: number;
314
+ cursor?: string;
315
+ };
316
+ export type ListChannelsResult = {
317
+ ok: true;
318
+ entries: ChannelListEntry[];
319
+ nextCursor?: string;
320
+ } | {
321
+ ok: false;
322
+ error: string;
323
+ code?: 'not-supported' | 'adapter-unavailable' | 'adapter-error';
324
+ };
325
+ export type ListCallback = (args: ListChannelsArgs) => Promise<ListChannelsResult>;
326
+ export type FetchAttachmentArgs = {
327
+ ref: string;
328
+ filename?: string;
329
+ maxBytes?: number;
330
+ };
331
+ export type FetchAttachmentResult = {
332
+ ok: true;
333
+ buffer: Buffer;
334
+ filename: string;
335
+ mimetype?: string;
336
+ size: number;
337
+ } | {
338
+ ok: false;
339
+ error: string;
340
+ };
341
+ export type FetchAttachmentCallback = (args: FetchAttachmentArgs) => Promise<FetchAttachmentResult>;
342
+ export type ReviewThreadResolveRequest = {
343
+ adapter: AdapterId;
344
+ workspace: string;
345
+ chat: string;
346
+ rootCommentId: string;
347
+ };
348
+ export type ReviewThreadResolveResult = {
349
+ ok: true;
350
+ alreadyResolved?: boolean;
351
+ } | {
352
+ ok: false;
353
+ error: string;
354
+ code?: 'not-author' | 'no-match' | 'not-found' | 'unsupported' | 'permission-denied' | 'transient';
355
+ };
356
+ export type ReviewThreadResolver = (req: ReviewThreadResolveRequest) => Promise<ReviewThreadResolveResult>;
357
+ export type ReviewStateRequest = {
358
+ adapter: AdapterId;
359
+ workspace: string;
360
+ chat: string;
361
+ };
362
+ export type ReviewStateResult = {
363
+ ok: true;
364
+ selfBlocking: boolean;
365
+ selfBlockingReviewId: number | null;
366
+ approve: boolean;
367
+ reviewDecision?: GithubReviewDecision;
368
+ } | {
369
+ ok: false;
370
+ error: string;
371
+ code?: 'unsupported' | 'not-found' | 'permission-denied' | 'transient';
372
+ };
373
+ export type GithubReviewDecision = 'APPROVED' | 'CHANGES_REQUESTED' | 'REVIEW_REQUIRED';
374
+ export type ReviewStateResolver = (req: ReviewStateRequest) => Promise<ReviewStateResult>;
375
+ export type ReviewFinding = {
376
+ path: string;
377
+ line: number;
378
+ side?: 'LEFT' | 'RIGHT';
379
+ startLine?: number;
380
+ startSide?: 'LEFT' | 'RIGHT';
381
+ body: string;
382
+ };
383
+ export type SubmitReviewRequest = {
384
+ adapter: AdapterId;
385
+ workspace: string;
386
+ chat: string;
387
+ event: 'APPROVE' | 'REQUEST_CHANGES' | 'COMMENT';
388
+ body: string;
389
+ comments: ReviewFinding[];
390
+ expectedHeadSha?: string;
391
+ expectedAccountIdentity?: string;
392
+ sourceSessionId?: string;
393
+ };
394
+ export type SubmitReviewResult = {
395
+ ok: true;
396
+ reviewId: number;
397
+ state: string;
398
+ commitSha?: string;
399
+ downgraded?: boolean;
400
+ reanchored?: ReviewFinding[];
401
+ } | {
402
+ ok: false;
403
+ error: string;
404
+ code: SubmitReviewErrorCode;
405
+ submitted?: boolean;
406
+ };
407
+ export type SubmitReviewErrorCode = 'unsupported' | 'permission-denied' | 'bad-anchor' | 'not-found' | 'transient';
408
+ export type ReviewSubmitter = (req: SubmitReviewRequest) => Promise<SubmitReviewResult>;
409
+ export declare function channelKeyId(key: {
410
+ adapter: string;
411
+ workspace: string;
412
+ chat: string;
413
+ thread: string | null;
414
+ }): string;
@@ -0,0 +1,25 @@
1
+ import type { ChannelKey, OwnReactionTarget, ReactionRef, ReactionRequest, ReactionResult, RemoveOwnReactionRequest, RemoveOwnReactionResult } from "./types.js";
2
+ export interface WaitingReactionHandle {
3
+ readonly req: ReactionRequest;
4
+ readonly ownerId: string;
5
+ readonly ready: Promise<ReactionRef | null>;
6
+ readonly generation: number;
7
+ readonly epoch: string;
8
+ }
9
+ export interface ProtectedAcknowledgmentScope {
10
+ conversation: ChannelKey;
11
+ kind: string;
12
+ }
13
+ /** One runtime owns this journal. A new epoch takes over only after the old runtime stops. */
14
+ export declare function createWaitingReactionCoordinator(options: {
15
+ agentDir: string;
16
+ epoch?: string;
17
+ add: (req: ReactionRequest, prepared: OwnReactionTarget) => Promise<ReactionResult>;
18
+ prepare: (req: ReactionRequest) => Promise<OwnReactionTarget | null>;
19
+ remove: (req: RemoveOwnReactionRequest) => Promise<RemoveOwnReactionResult>;
20
+ }): {
21
+ acquire: (req: ReactionRequest, protectedPresence?: boolean, acknowledgmentScope?: ProtectedAcknowledgmentScope) => WaitingReactionHandle;
22
+ release: (handle: WaitingReactionHandle) => Promise<void>;
23
+ recover: (adapter?: ReactionRequest["adapter"]) => Promise<void>;
24
+ retireAcknowledgments: (conversation: ChannelKey) => Promise<void>;
25
+ };
@@ -0,0 +1,2 @@
1
+ export { BUILTIN_COMMAND_NAMES } from "./command-meta.js";
2
+ export type { BuiltinCommandName } from "./command-meta.js";
@@ -0,0 +1,9 @@
1
+ export type BuiltinCommandName = 'init' | 'run' | 'tui' | 'start' | 'stop' | 'restart' | 'status' | 'stats' | 'reload' | 'logs' | 'inspect' | 'memory' | 'shell' | 'compose' | 'channel' | 'cron' | 'tunnel' | 'role' | 'provider' | 'mcp' | 'model' | 'mount' | 'doctor' | 'usage' | 'update' | '_hostd' | '_update-check';
2
+ export type BuiltinCommandMeta = {
3
+ name: BuiltinCommandName;
4
+ description: string;
5
+ hidden?: boolean;
6
+ };
7
+ export declare const BUILTIN_COMMANDS: readonly BuiltinCommandMeta[];
8
+ export declare const BUILTIN_COMMAND_NAMES: readonly BuiltinCommandName[];
9
+ export declare function getBuiltinCommandDescription(name: BuiltinCommandName): string;
@@ -0,0 +1,7 @@
1
+ import type { IncomingMessage } from 'node:http';
2
+ export declare function readCodingBody(request: IncomingMessage, signal: AbortSignal): Promise<{
3
+ body: Buffer;
4
+ } | {
5
+ status: number;
6
+ code: string;
7
+ }>;
@@ -0,0 +1,22 @@
1
+ import type { CodingAgentAuthResolver, CodingAgentProvider } from "../secrets/coding-agent-auth.js";
2
+ export declare class SecretScrubber {
3
+ private readonly secrets;
4
+ private pending;
5
+ constructor(secrets: readonly string[]);
6
+ push(text: string, final?: boolean): string;
7
+ }
8
+ export type CodingBroker = {
9
+ readonly baseUrl: string;
10
+ readonly capability: string;
11
+ close(): Promise<void>;
12
+ };
13
+ export declare function startCodingBroker(options: {
14
+ provider?: CodingAgentProvider;
15
+ engine?: 'claude' | 'codex' | 'omo';
16
+ auth: CodingAgentAuthResolver;
17
+ allowedModels: readonly string[];
18
+ deadline: number;
19
+ signal?: AbortSignal;
20
+ }, testDependencies?: {
21
+ upstream: URL;
22
+ }): Promise<CodingBroker>;
@@ -0,0 +1,22 @@
1
+ export declare const CLAUDE_CODE_VERSION = "2.1.299";
2
+ export declare const CLAUDE_AUXILIARY_MODELS: readonly ["claude-haiku-4-5-20251001", "claude-sonnet-4-6", "claude-opus-4-7"];
3
+ export type CodingMode = 'code' | 'plan';
4
+ export declare function claudeArguments(options: {
5
+ model: string;
6
+ mode: CodingMode;
7
+ sessionId: string;
8
+ resume: boolean;
9
+ }): string[];
10
+ export declare function claudeEnvironment(configDir: string, baseUrl: string, capability: string): Record<string, string>;
11
+ export declare class ClaudeStreamParser {
12
+ sessionId: string | undefined;
13
+ finalMessage: string;
14
+ terminal: boolean;
15
+ failed: boolean;
16
+ permissionDenied: boolean;
17
+ malformed: boolean;
18
+ private pending;
19
+ push(text: string): void;
20
+ finish(): void;
21
+ private line;
22
+ }
@@ -0,0 +1,19 @@
1
+ export declare const CODEX_CLI_VERSION = "0.162.1";
2
+ export declare function codexArguments(options: {
3
+ readonly sessionId: string;
4
+ readonly resume: boolean;
5
+ }): string[];
6
+ export declare function codexEnvironment(configDir: string, capability: string): Record<string, string>;
7
+ export declare function codexConfig(model: string, baseUrl: string): string;
8
+ export declare class CodexStreamParser {
9
+ sessionId: string | undefined;
10
+ finalMessage: string;
11
+ terminal: boolean;
12
+ failed: boolean;
13
+ permissionDenied: boolean;
14
+ malformed: boolean;
15
+ private pending;
16
+ push(text: string): void;
17
+ finish(): void;
18
+ private line;
19
+ }
@@ -0,0 +1,71 @@
1
+ import { z } from 'zod';
2
+ import type { SessionOrigin } from "../agent/session-origin.js";
3
+ import type { PermissionService } from "../permissions/index.js";
4
+ import { type CodingAgentAuthResolver } from "../secrets/coding-agent-auth.js";
5
+ import { type CodingRunOptions, type CodingRunResult } from "./runner.js";
6
+ import { type CodingExecutor } from "./worktree.js";
7
+ export declare const codingRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
8
+ action: z.ZodLiteral<"run">;
9
+ engine: z.ZodEnum<{
10
+ claude: "claude";
11
+ codex: "codex";
12
+ omo: "omo";
13
+ }>;
14
+ repo: z.ZodOptional<z.ZodString>;
15
+ modelRef: z.ZodOptional<z.ZodString>;
16
+ taskId: z.ZodOptional<z.ZodString>;
17
+ prompt: z.ZodString;
18
+ mode: z.ZodOptional<z.ZodEnum<{
19
+ code: "code";
20
+ plan: "plan";
21
+ }>>;
22
+ timeoutSeconds: z.ZodDefault<z.ZodNumber>;
23
+ }, z.core.$strict>, z.ZodObject<{
24
+ action: z.ZodLiteral<"result">;
25
+ taskId: z.ZodString;
26
+ }, z.core.$strict>, z.ZodObject<{
27
+ action: z.ZodLiteral<"dispose">;
28
+ taskId: z.ZodString;
29
+ discard: z.ZodLiteral<true>;
30
+ }, z.core.$strict>], "action">;
31
+ export type CodingRequest = z.infer<typeof codingRequestSchema>;
32
+ export type CodingCaller = {
33
+ readonly sessionId: string;
34
+ readonly origin: SessionOrigin | undefined;
35
+ readonly permissions: PermissionService;
36
+ readonly onPrepared?: (receipt: Record<string, unknown>) => void;
37
+ };
38
+ type ServiceDependencies = {
39
+ auth?: () => Promise<CodingAgentAuthResolver>;
40
+ executor?: (source: string, root: string, signal?: AbortSignal) => CodingExecutor;
41
+ run?: (options: CodingRunOptions) => Promise<CodingRunResult>;
42
+ writeArtifact?: (path: string, text: string) => Promise<void>;
43
+ sourcePath?: (source: string) => string;
44
+ };
45
+ export declare class CodingAgentService {
46
+ readonly agentDir: string;
47
+ private readonly dependencies;
48
+ private readonly tasks;
49
+ private readonly active;
50
+ private readonly ready;
51
+ private auth;
52
+ private saving;
53
+ private stopped;
54
+ private registryUnavailable;
55
+ constructor(agentDir: string, dependencies?: ServiceDependencies);
56
+ execute(request: CodingRequest, caller: CodingCaller, signal?: AbortSignal): Promise<Record<string, unknown>>;
57
+ private executeRequest;
58
+ stop(): Promise<void>;
59
+ private create;
60
+ private invoke;
61
+ private authorizeTask;
62
+ private workspace;
63
+ private executor;
64
+ private receipt;
65
+ private resolver;
66
+ private load;
67
+ private save;
68
+ }
69
+ export declare function getCodingAgentService(agentDir: string): CodingAgentService;
70
+ export declare function retainCodingAgentService(agentDir: string): () => Promise<void>;
71
+ export {};
@@ -0,0 +1,2 @@
1
+ export declare function prepareOmoDirectories(configDir: string): Promise<void>;
2
+ export declare function hasOmoSession(configDir: string, sessionId: string, cwd: string): Promise<boolean>;
@@ -0,0 +1,22 @@
1
+ export declare class OmoDeltaFilter {
2
+ private pending;
3
+ push(text: string): string;
4
+ flush(): string;
5
+ }
6
+ export declare class OmoStreamParser {
7
+ private readonly expected;
8
+ sessionId: string | undefined;
9
+ finalMessage: string;
10
+ terminal: boolean;
11
+ failed: boolean;
12
+ permissionDenied: boolean;
13
+ malformed: boolean;
14
+ private pending;
15
+ constructor(expected: {
16
+ readonly sessionId: string;
17
+ readonly cwd: string;
18
+ });
19
+ push(text: string): void;
20
+ finish(): void;
21
+ private line;
22
+ }