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,336 @@
1
+ import type { z } from 'zod';
2
+ import type { SessionOrigin } from "../agent/session-origin.js";
3
+ import type { SubagentShared } from "../agent/subagents.js";
4
+ import type { ResolveGithubTokenForRepo } from "../channels/github-token-bridge.js";
5
+ import type { PermissionService } from "../permissions/index.js";
6
+ export type ContentPart = {
7
+ type: 'text';
8
+ text: string;
9
+ } | {
10
+ type: 'image';
11
+ mimeType: string;
12
+ data: string;
13
+ };
14
+ export type ToolResult = {
15
+ content: ContentPart[];
16
+ details?: unknown;
17
+ };
18
+ export type ToolLogger = {
19
+ info: (msg: string) => void;
20
+ warn: (msg: string) => void;
21
+ error: (msg: string) => void;
22
+ };
23
+ export type ToolContext = {
24
+ signal: AbortSignal | undefined;
25
+ sessionId: string;
26
+ agentDir: string;
27
+ logger: ToolLogger;
28
+ };
29
+ export type ToolFileOperands = {
30
+ input?: readonly string[];
31
+ output?: readonly string[];
32
+ create?: readonly string[];
33
+ destructive?: readonly string[];
34
+ nonFile?: readonly string[];
35
+ };
36
+ export type Tool<P = unknown> = {
37
+ description: string;
38
+ parameters: z.ZodType<P>;
39
+ fileOperands?: ToolFileOperands;
40
+ execute: (args: P, ctx: ToolContext) => Promise<ToolResult>;
41
+ };
42
+ export type BuiltinToolRef = {
43
+ readonly __builtinTool: string;
44
+ };
45
+ export type SubagentContext<P = unknown> = {
46
+ userPrompt: string;
47
+ agentDir: string;
48
+ payload: P;
49
+ };
50
+ export type RunSession = (override?: {
51
+ userPrompt?: string;
52
+ onFinalMessage?: (message: string | null) => void;
53
+ }) => Promise<void>;
54
+ export type Subagent<P = unknown> = SubagentShared<P> & {
55
+ tools?: BuiltinToolRef[];
56
+ customTools?: Tool<any>[];
57
+ ephemeral?: boolean;
58
+ };
59
+ export type PluginPromptCronJob = {
60
+ schedule: string;
61
+ kind: 'prompt';
62
+ prompt: string;
63
+ enabled?: boolean;
64
+ timezone?: string;
65
+ subagent?: string;
66
+ payload?: unknown;
67
+ };
68
+ export type PluginExecCronJob = {
69
+ schedule: string;
70
+ kind: 'exec';
71
+ command: string[];
72
+ enabled?: boolean;
73
+ timezone?: string;
74
+ };
75
+ export type PluginHandlerCronJob = {
76
+ schedule: string;
77
+ kind: 'handler';
78
+ handler: (ctx: CronHandlerContext) => Promise<void>;
79
+ enabled?: boolean;
80
+ timezone?: string;
81
+ };
82
+ export type PluginCronJob = PluginPromptCronJob | PluginExecCronJob | PluginHandlerCronJob;
83
+ export type CronHandlerContext = {
84
+ readonly jobId: string;
85
+ readonly name: string;
86
+ readonly agentDir: string;
87
+ readonly logger: PluginLogger;
88
+ readonly signal: AbortSignal;
89
+ readonly permissions: PermissionService;
90
+ readonly origin: SessionOrigin;
91
+ readonly prompt: (text: string) => Promise<string>;
92
+ readonly subagent: (name: string, payload?: unknown) => Promise<void>;
93
+ readonly exec: (cmd: TemplateStringsArray, ...values: unknown[]) => Promise<CommandExecResult>;
94
+ };
95
+ export type PluginSkill = {
96
+ description: string;
97
+ content: string;
98
+ frontmatter?: Record<string, unknown>;
99
+ };
100
+ export type SessionStartEvent = {
101
+ sessionId: string;
102
+ agentDir: string;
103
+ };
104
+ export type SessionEndEvent = {
105
+ sessionId: string;
106
+ origin?: SessionOrigin;
107
+ };
108
+ export type SessionIdleEvent = {
109
+ sessionId: string;
110
+ parentTranscriptPath: string | undefined;
111
+ idleMs: number;
112
+ origin?: SessionOrigin;
113
+ };
114
+ export type SessionTurnStartEvent = {
115
+ sessionId: string;
116
+ agentDir: string;
117
+ userPrompt: string;
118
+ origin?: SessionOrigin;
119
+ retrievalContext?: {
120
+ results: string;
121
+ };
122
+ };
123
+ export type SessionTurnEndEvent = {
124
+ sessionId: string;
125
+ agentDir: string;
126
+ origin?: SessionOrigin;
127
+ };
128
+ export type SessionPromptEvent = {
129
+ prompt: string;
130
+ sessionId: string;
131
+ agentDir: string;
132
+ origin?: SessionOrigin;
133
+ };
134
+ export type ToolProvenance = 'first-party' | 'plugin';
135
+ export type ToolBeforeEvent = {
136
+ tool: string;
137
+ sessionId: string;
138
+ callId: string;
139
+ args: Record<string, unknown>;
140
+ origin?: SessionOrigin;
141
+ toolProvenance?: ToolProvenance;
142
+ fileOperands?: ToolFileOperands;
143
+ };
144
+ export type ToolBeforeResult = void | undefined | {
145
+ block: true;
146
+ reason: string;
147
+ };
148
+ export type ToolAfterEvent = {
149
+ tool: string;
150
+ sessionId: string;
151
+ callId: string;
152
+ result: ToolResult;
153
+ };
154
+ export type HookContext = {
155
+ agentDir: string;
156
+ pluginName: string;
157
+ logger: PluginLogger;
158
+ };
159
+ export type SlackObservedMessage = {
160
+ readonly type: 'message';
161
+ readonly channel: string;
162
+ readonly ts?: string;
163
+ readonly subtype?: string;
164
+ readonly text?: string;
165
+ readonly user?: string;
166
+ readonly thread_ts?: string;
167
+ readonly event_ts?: string;
168
+ readonly deleted_ts?: string;
169
+ readonly message?: Readonly<Record<string, unknown>>;
170
+ readonly previous_message?: Readonly<Record<string, unknown>>;
171
+ readonly [key: string]: unknown;
172
+ };
173
+ export type ChannelMessageObservedEvent = {
174
+ readonly adapter: 'slack-bot';
175
+ readonly workspace: string | null;
176
+ readonly selfUserId: string | null;
177
+ readonly receivedAt: number;
178
+ readonly event: SlackObservedMessage;
179
+ };
180
+ export type ChannelOutboundOrigin = {
181
+ readonly kind: SessionOrigin['kind'];
182
+ readonly jobId?: string;
183
+ };
184
+ export type ChannelOutboundBeforeEvent = {
185
+ readonly adapter: string;
186
+ readonly workspace: string;
187
+ readonly chat: string;
188
+ readonly thread?: string;
189
+ readonly text: string;
190
+ readonly op: 'send' | 'edit';
191
+ readonly messageId?: string;
192
+ readonly source: 'tool' | 'system';
193
+ readonly outputKind?: 'substantive' | 'status' | 'meta';
194
+ readonly origin?: ChannelOutboundOrigin;
195
+ };
196
+ export type ChannelOutboundBeforeResult = {
197
+ text: string;
198
+ } | undefined;
199
+ export type Hooks = {
200
+ 'session.start'?: (event: SessionStartEvent, ctx: HookContext) => Promise<void> | void;
201
+ 'session.end'?: (event: SessionEndEvent, ctx: HookContext) => Promise<void> | void;
202
+ 'session.idle'?: (event: SessionIdleEvent, ctx: HookContext) => Promise<void> | void;
203
+ 'session.prompt'?: (event: SessionPromptEvent, ctx: HookContext) => Promise<void> | void;
204
+ 'session.turn.start'?: (event: SessionTurnStartEvent, ctx: HookContext) => Promise<void> | void;
205
+ 'session.turn.end'?: (event: SessionTurnEndEvent, ctx: HookContext) => Promise<void> | void;
206
+ 'tool.before'?: (event: ToolBeforeEvent, ctx: HookContext) => Promise<ToolBeforeResult> | ToolBeforeResult;
207
+ 'tool.after'?: (event: ToolAfterEvent, ctx: HookContext) => Promise<void> | void;
208
+ 'channel.message.observed'?: (event: ChannelMessageObservedEvent, ctx: HookContext) => Promise<void> | void;
209
+ 'channel.outbound.before'?: (event: ChannelOutboundBeforeEvent, ctx: HookContext) => Promise<ChannelOutboundBeforeResult> | ChannelOutboundBeforeResult;
210
+ };
211
+ export type HookName = keyof Hooks;
212
+ export type PluginLogger = {
213
+ info: (msg: string) => void;
214
+ warn: (msg: string) => void;
215
+ error: (msg: string) => void;
216
+ };
217
+ export type SpawnSubagentOptions = {
218
+ parentSessionId?: string;
219
+ spawnedByOrigin?: SessionOrigin;
220
+ };
221
+ export type PluginContext<TConfig = never> = {
222
+ readonly name: string;
223
+ readonly version: string | undefined;
224
+ readonly agentDir: string;
225
+ readonly config: TConfig;
226
+ readonly logger: PluginLogger;
227
+ readonly permissions: PermissionService;
228
+ readonly github: PluginGithubServices;
229
+ spawnSubagent: (name: string, payload?: unknown, options?: SpawnSubagentOptions) => Promise<void>;
230
+ };
231
+ export type PluginGithubServices = {
232
+ resolveTokenForRepo: ResolveGithubTokenForRepo;
233
+ hasAppTokenResolver: () => boolean;
234
+ getAppSelfLogin?: () => string | null;
235
+ resolvePatForRepo?: ResolveGithubTokenForRepo;
236
+ };
237
+ export type PluginExports = {
238
+ tools?: Record<string, Tool<any>>;
239
+ subagents?: Record<string, Subagent<any>>;
240
+ cronJobs?: Record<string, PluginCronJob>;
241
+ skills?: Record<string, PluginSkill>;
242
+ skillsDirs?: string[];
243
+ hooks?: Hooks;
244
+ doctorChecks?: Record<string, PluginDoctorCheck>;
245
+ onDispose?: () => void | Promise<void>;
246
+ };
247
+ export type PluginDoctorCheck = {
248
+ description: string;
249
+ category?: string;
250
+ run: (ctx: PluginDoctorContext) => Promise<PluginCheckResult>;
251
+ };
252
+ export type PluginDoctorContext = {
253
+ readonly pluginName: string;
254
+ readonly agentDir: string;
255
+ readonly config: unknown;
256
+ readonly logger: PluginLogger;
257
+ };
258
+ export type PluginCheckStatus = 'ok' | 'warning' | 'error';
259
+ export type PluginCheckResult = {
260
+ status: PluginCheckStatus;
261
+ message: string;
262
+ details?: string[];
263
+ fix?: PluginFixSuggestion;
264
+ };
265
+ export type PluginFixSuggestion = {
266
+ description: string;
267
+ apply?: (ctx: PluginDoctorContext) => Promise<PluginFixResult>;
268
+ };
269
+ export type PluginFixResult = {
270
+ summary: string;
271
+ changedPaths: string[];
272
+ };
273
+ export type DefinedPlugin<TConfig = never> = {
274
+ readonly configSchema?: z.ZodType<TConfig>;
275
+ readonly permissions?: readonly string[];
276
+ readonly ownerWildcardExclusions?: readonly string[];
277
+ readonly commands?: Record<string, PluginCommand>;
278
+ readonly plugin: (ctx: PluginContext<TConfig>) => Promise<PluginExports>;
279
+ };
280
+ export type PluginCommand = ContainerCommand | HostCommand | EitherCommand;
281
+ export type ContainerCommand<A = unknown> = {
282
+ readonly surface: 'container';
283
+ readonly description: string;
284
+ readonly args?: z.ZodObject<z.ZodRawShape>;
285
+ readonly permissions?: readonly string[];
286
+ readonly isolated?: boolean;
287
+ readonly run: (ctx: ContainerCommandContext, args: A) => Promise<number>;
288
+ };
289
+ export type HostCommand<A = unknown> = {
290
+ readonly surface: 'host';
291
+ readonly description: string;
292
+ readonly args?: z.ZodObject<z.ZodRawShape>;
293
+ readonly run: (ctx: HostCommandContext, args: A) => Promise<number>;
294
+ };
295
+ export type EitherCommand<A = unknown> = {
296
+ readonly surface: 'either';
297
+ readonly description: string;
298
+ readonly args?: z.ZodObject<z.ZodRawShape>;
299
+ readonly run: (ctx: EitherCommandContext, args: A) => Promise<number>;
300
+ };
301
+ export type CommandStreams = {
302
+ readonly stdin: ReadableStream<Uint8Array>;
303
+ readonly stdout: WritableStream<Uint8Array>;
304
+ readonly stderr: WritableStream<Uint8Array>;
305
+ };
306
+ export type CommandExecResult = {
307
+ readonly stdout: string;
308
+ readonly stderr: string;
309
+ readonly exitCode: number;
310
+ };
311
+ export type ContainerCommandContext = CommandStreams & {
312
+ readonly name: string;
313
+ readonly version: string | undefined;
314
+ readonly agentDir: string;
315
+ readonly logger: PluginLogger;
316
+ readonly permissions: PermissionService;
317
+ readonly origin: SessionOrigin;
318
+ readonly signal: AbortSignal;
319
+ readonly prompt: (text: string) => Promise<string>;
320
+ readonly subagent: (name: string, payload?: unknown) => Promise<void>;
321
+ readonly exec: (cmd: TemplateStringsArray, ...values: unknown[]) => Promise<CommandExecResult>;
322
+ };
323
+ export type HostCommandContext = CommandStreams & {
324
+ readonly name: string;
325
+ readonly version: string | undefined;
326
+ readonly agentDir: string;
327
+ readonly logger: PluginLogger;
328
+ readonly signal: AbortSignal;
329
+ };
330
+ export type EitherCommandContext = CommandStreams & {
331
+ readonly name: string;
332
+ readonly version: string | undefined;
333
+ readonly agentDir: string;
334
+ readonly logger: PluginLogger;
335
+ readonly signal: AbortSignal;
336
+ };
@@ -0,0 +1,11 @@
1
+ import { z } from 'zod';
2
+ export type LeafKind = 'string' | 'number' | 'boolean' | 'unknown';
3
+ export type LeafDescription = {
4
+ kind: LeafKind;
5
+ required: boolean;
6
+ defaultValue: string | undefined;
7
+ description: string | undefined;
8
+ };
9
+ export declare function describeLeaf(leaf: unknown): LeafDescription;
10
+ export declare function coerceFlag(leaf: unknown, raw: string | true, key: string): unknown;
11
+ export declare function isPrimitiveZodObject(schema: unknown): schema is z.ZodObject<z.ZodRawShape>;
@@ -0,0 +1,11 @@
1
+ import type { ReloadCause, ReloadResult } from "./types.js";
2
+ export type RequestReloadOptions = {
3
+ url: string;
4
+ scope?: string;
5
+ cause?: ReloadCause;
6
+ timeoutMs?: number;
7
+ };
8
+ export declare class ReloadConnectionError extends Error {
9
+ constructor(message: string);
10
+ }
11
+ export declare function requestReload({ url, scope, cause, timeoutMs, }: RequestReloadOptions): Promise<ReloadResult[]>;
@@ -0,0 +1,11 @@
1
+ import { type DockerExec } from "../container/index.js";
2
+ import type { ReloadCause, ReloadResult } from "./types.js";
3
+ export type RequestReloadViaDockerExecOptions = {
4
+ cwd: string;
5
+ token: string | null;
6
+ scope?: string;
7
+ cause?: ReloadCause;
8
+ timeoutMs?: number;
9
+ exec?: DockerExec;
10
+ };
11
+ export declare function requestReloadViaDockerExec({ cwd, token, scope, cause, timeoutMs, exec, }: RequestReloadViaDockerExecOptions): Promise<ReloadResult[]>;
@@ -0,0 +1,2 @@
1
+ import type { ReloadResult } from "./types.js";
2
+ export declare function formatChannelReloadSummary(results: readonly ReloadResult[]): string;
@@ -0,0 +1,6 @@
1
+ export { ReloadConnectionError, requestReload, type RequestReloadOptions } from "./client.js";
2
+ export { requestReloadViaDockerExec, type RequestReloadViaDockerExecOptions } from "./docker-exec-client.js";
3
+ export { formatChannelReloadSummary } from "./format.js";
4
+ export { ReloadRegistry } from "./registry.js";
5
+ export { requestReloadWithFallback, type RequestReloadWithFallbackOptions, type RequestReloadWithFallbackResult, } from "./recover.js";
6
+ export type { Reloadable, ReloadAllResult, ReloadCause, ReloadContext, ReloadResult } from "./types.js";
@@ -0,0 +1,22 @@
1
+ import { requestReload } from "./client.js";
2
+ import { requestReloadViaDockerExec } from "./docker-exec-client.js";
3
+ import type { ReloadCause, ReloadResult } from "./types.js";
4
+ export type RequestReloadWithFallbackOptions = {
5
+ url: string;
6
+ cwd?: string;
7
+ token?: string | null;
8
+ scope?: string;
9
+ cause?: ReloadCause;
10
+ timeoutMs?: number;
11
+ reload?: typeof requestReload;
12
+ reloadViaDockerExec?: typeof requestReloadViaDockerExec;
13
+ };
14
+ export type RequestReloadWithFallbackResult = {
15
+ transport: 'host';
16
+ results: ReloadResult[];
17
+ } | {
18
+ transport: 'container-local';
19
+ results: ReloadResult[];
20
+ hostError: string;
21
+ };
22
+ export declare function requestReloadWithFallback({ url, cwd, token, scope, cause, timeoutMs, reload, reloadViaDockerExec, }: RequestReloadWithFallbackOptions): Promise<RequestReloadWithFallbackResult>;
@@ -0,0 +1,10 @@
1
+ import type { Reloadable, ReloadAllResult, ReloadContext, ReloadResult } from "./types.js";
2
+ export declare class ReloadRegistry {
3
+ private items;
4
+ register(item: Reloadable): void;
5
+ has(scope: string): boolean;
6
+ get(scope: string): Reloadable | undefined;
7
+ list(): Reloadable[];
8
+ reloadAll(context?: ReloadContext): Promise<ReloadAllResult>;
9
+ reloadOne(scope: string, context?: ReloadContext): Promise<ReloadResult>;
10
+ }
@@ -0,0 +1,25 @@
1
+ export type ReloadResult = {
2
+ scope: string;
3
+ ok: true;
4
+ summary: string;
5
+ details?: unknown;
6
+ } | {
7
+ scope: string;
8
+ ok: false;
9
+ reason: string;
10
+ };
11
+ export type ReloadCause = {
12
+ kind: 'credential-rotation';
13
+ adapter: string;
14
+ };
15
+ export type ReloadContext = {
16
+ cause?: ReloadCause;
17
+ };
18
+ export type Reloadable = {
19
+ scope: string;
20
+ description: string;
21
+ reload: (context?: ReloadContext) => Promise<ReloadResult>;
22
+ };
23
+ export type ReloadAllResult = {
24
+ results: ReloadResult[];
25
+ };
@@ -0,0 +1,20 @@
1
+ import type { ClaimCompletedPayload, ClaimErrorPayload, ClaimStartedPayload } from "../shared/index.js";
2
+ export type ClaimSessionOptions = {
3
+ url: string;
4
+ role: string;
5
+ channel?: string;
6
+ ttlMs?: number;
7
+ openTimeoutMs?: number;
8
+ connectTimeoutMs?: number;
9
+ onStarted?: (payload: ClaimStartedPayload) => void;
10
+ };
11
+ export type ClaimSessionResult = {
12
+ kind: 'completed';
13
+ payload: ClaimCompletedPayload;
14
+ } | {
15
+ kind: 'error';
16
+ payload: ClaimErrorPayload;
17
+ } | {
18
+ kind: 'timeout';
19
+ };
20
+ export declare function runClaimSession(opts: ClaimSessionOptions): Promise<ClaimSessionResult>;
@@ -0,0 +1,4 @@
1
+ export declare const CLAIM_CODE_PREFIX = "claim-";
2
+ export declare function generateClaimCode(): string;
3
+ export declare function extractClaimCode(text: string): string | null;
4
+ export declare function normalizeClaimCode(code: string): string;
@@ -0,0 +1,59 @@
1
+ import type { ClaimHandler } from "../channels/router.js";
2
+ import { type PermissionService } from "../permissions/index.js";
3
+ import { type PendingClaim, type PendingClaimRegistry } from "./pending.js";
4
+ export type ClaimCompletedEvent = {
5
+ kind: 'completed';
6
+ code: string;
7
+ role: string;
8
+ matchRule: string;
9
+ adapter: string;
10
+ authorId: string;
11
+ };
12
+ export type ClaimErrorEvent = {
13
+ kind: 'error';
14
+ code: string;
15
+ reason: string;
16
+ };
17
+ export type ClaimCancelledEvent = {
18
+ kind: 'cancelled';
19
+ code: string;
20
+ };
21
+ export type ClaimResultEvent = ClaimCompletedEvent | ClaimErrorEvent | ClaimCancelledEvent;
22
+ export type ClaimController = {
23
+ startClaim: (input: {
24
+ code: string;
25
+ role: string;
26
+ channel?: string;
27
+ ttlMs: number;
28
+ }) => {
29
+ ok: true;
30
+ expiresAt: number;
31
+ } | {
32
+ ok: false;
33
+ reason: string;
34
+ };
35
+ cancelClaim: (code: string) => boolean;
36
+ current: () => PendingClaim | null;
37
+ onResult: (subscriber: (event: ClaimResultEvent) => void) => () => void;
38
+ claimHandler: ClaimHandler;
39
+ };
40
+ export type CreateClaimControllerOptions = {
41
+ cwd: string;
42
+ permissions: PermissionService;
43
+ rolesProvider: () => import("../permissions/index.js").RolesConfig | undefined;
44
+ now?: () => number;
45
+ registry?: PendingClaimRegistry;
46
+ grant?: (roleName: string, matchRule: string) => {
47
+ ok: true;
48
+ added: boolean;
49
+ } | {
50
+ ok: false;
51
+ reason: string;
52
+ };
53
+ logger?: {
54
+ info: (m: string) => void;
55
+ warn: (m: string) => void;
56
+ error: (m: string) => void;
57
+ };
58
+ };
59
+ export declare function createClaimController(opts: CreateClaimControllerOptions): ClaimController;
@@ -0,0 +1,6 @@
1
+ export { runClaimSession, type ClaimSessionOptions, type ClaimSessionResult } from "./client.js";
2
+ export { CLAIM_CODE_PREFIX, extractClaimCode, generateClaimCode, normalizeClaimCode } from "./code.js";
3
+ export { createClaimController, type ClaimCancelledEvent, type ClaimCompletedEvent, type ClaimController, type ClaimErrorEvent, type ClaimResultEvent, type CreateClaimControllerOptions, } from "./controller.js";
4
+ export { formatClaimMatchRule, type PartialChannelOrigin } from "./match-rule.js";
5
+ export { reloadAfterClaim, type ReloadAfterClaimOptions, type ReloadAfterClaimResult } from "./reload-after-claim.js";
6
+ export { createPendingClaimRegistry, type ClaimResult, type PendingClaim, type PendingClaimRegistry, type PendingClaimRegistryOptions, } from "./pending.js";
@@ -0,0 +1,9 @@
1
+ import type { ChannelKey } from "../channels/types.js";
2
+ export type PartialChannelOrigin = {
3
+ adapter: ChannelKey['adapter'];
4
+ workspace: string;
5
+ chat: string;
6
+ isDm: boolean;
7
+ authorId: string;
8
+ };
9
+ export declare function formatClaimMatchRule(origin: PartialChannelOrigin): string;
@@ -0,0 +1,35 @@
1
+ import type { PartialChannelOrigin } from "./match-rule.js";
2
+ export type PendingClaim = {
3
+ code: string;
4
+ role: string;
5
+ channel?: string;
6
+ ttlMs: number;
7
+ startedAt: number;
8
+ expiresAt: number;
9
+ };
10
+ export type ClaimResult = {
11
+ kind: 'consumed';
12
+ code: string;
13
+ role: string;
14
+ matchRule: string;
15
+ origin: PartialChannelOrigin;
16
+ } | {
17
+ kind: 'no-pending';
18
+ } | {
19
+ kind: 'no-match';
20
+ } | {
21
+ kind: 'expired';
22
+ } | {
23
+ kind: 'wrong-channel';
24
+ };
25
+ export type PendingClaimRegistry = {
26
+ start: (claim: PendingClaim) => void;
27
+ cancel: (code: string) => boolean;
28
+ current: () => PendingClaim | null;
29
+ tryConsume: (code: string, origin: PartialChannelOrigin, formatMatchRule: (origin: PartialChannelOrigin) => string) => ClaimResult;
30
+ size: () => number;
31
+ };
32
+ export type PendingClaimRegistryOptions = {
33
+ now?: () => number;
34
+ };
35
+ export declare function createPendingClaimRegistry(opts?: PendingClaimRegistryOptions): PendingClaimRegistry;
@@ -0,0 +1,16 @@
1
+ import { type ReloadResult } from "../reload/index.js";
2
+ export interface ReloadAfterClaimOptions {
3
+ url: string;
4
+ reload?: (opts: {
5
+ url: string;
6
+ scope: string;
7
+ }) => Promise<ReloadResult[]>;
8
+ }
9
+ export type ReloadAfterClaimResult = {
10
+ ok: true;
11
+ results: ReloadResult[];
12
+ } | {
13
+ ok: false;
14
+ reason: string;
15
+ };
16
+ export declare function reloadAfterClaim(opts: ReloadAfterClaimOptions): Promise<ReloadAfterClaimResult>;
@@ -0,0 +1,50 @@
1
+ export type LlmFetchObserverLogger = {
2
+ info: (msg: string) => void;
3
+ warn: (msg: string) => void;
4
+ };
5
+ export declare const LLM_FETCH_OBSERVER_TIMEOUTS: unique symbol;
6
+ export type LlmFetchObserverTimeoutOverrides = {
7
+ ttfbMs?: number;
8
+ idleMs?: number;
9
+ overallMs?: number;
10
+ };
11
+ export type LlmFetchObservedRequestInit = RequestInit & {
12
+ [LLM_FETCH_OBSERVER_TIMEOUTS]?: LlmFetchObserverTimeoutOverrides;
13
+ };
14
+ export type LlmFetchEndpoint = {
15
+ label: string;
16
+ match: (url: URL, method: string) => boolean;
17
+ ttfbMs?: number;
18
+ idleMs?: number;
19
+ overallMs?: number;
20
+ };
21
+ export type LlmFetchObserverOptions = {
22
+ logger?: LlmFetchObserverLogger;
23
+ endpoints?: readonly LlmFetchEndpoint[];
24
+ now?: () => number;
25
+ ttfbMs?: number;
26
+ idleMs?: number;
27
+ overallMs?: number;
28
+ scheduler?: TimeoutScheduler;
29
+ adaptiveTracker?: AdaptiveTtfbTracker;
30
+ };
31
+ export type TimeoutScheduler = {
32
+ set: (delayMs: number, cb: () => void) => unknown;
33
+ clear: (handle: unknown) => void;
34
+ };
35
+ export declare class AdaptiveTtfbTracker {
36
+ private readonly now;
37
+ private readonly samples;
38
+ private readonly probeGrant;
39
+ private readonly cooldownUntil;
40
+ constructor(now: () => number);
41
+ resolve(key: string): number;
42
+ recordHeaders(key: string, headersMs: number): void;
43
+ recordTimeout(key: string, usedMs: number): void;
44
+ reset(): void;
45
+ private learnedTtfb;
46
+ private isInCooldown;
47
+ private prune;
48
+ }
49
+ export declare function defaultLlmFetchEndpoints(env?: NodeJS.ProcessEnv): readonly LlmFetchEndpoint[];
50
+ export declare function installLlmFetchObserver(opts?: LlmFetchObserverOptions): () => void;
@@ -0,0 +1,21 @@
1
+ export declare function ensureBwrapAvailable(options?: {
2
+ bwrapPath?: string;
3
+ }): Promise<void>;
4
+ export declare function _resetBwrapAvailabilityCacheForTests(): void;
5
+ export declare function canMountRealProc(): Promise<boolean>;
6
+ export declare function _resetRealProcProbeCacheForTests(): void;
7
+ export type ProcBindSafetyVerdict = 'safe' | 'unsafe' | 'inconclusive';
8
+ export declare function getProcBindSafetyVerdict(options?: {
9
+ bwrapPath?: string;
10
+ }): Promise<ProcBindSafetyVerdict>;
11
+ export declare function canBindProcSafely(options?: {
12
+ bwrapPath?: string;
13
+ }): Promise<boolean>;
14
+ export declare const PROC_BIND_RETRY_BACKOFF_MS: readonly [250, 1000, 2000, 4000];
15
+ export declare function resolveProcBindSafetyWithRetry(probe: () => Promise<ProcBindSafetyVerdict>, sleep: (ms: number) => Promise<void>, backoffMs?: readonly number[]): Promise<ProcBindSafetyVerdict>;
16
+ export declare function buildProcBindProbeScript(sentinelPid: number): string;
17
+ declare function waitForSentinelMarker(sentinelPid: number, readMarker?: (pid: number) => Promise<boolean>, sleep?: (ms: number) => Promise<void>, timeoutMs?: number, pollMs?: number, now?: () => number): Promise<boolean>;
18
+ export declare const _waitForSentinelMarkerForTests: typeof waitForSentinelMarker;
19
+ export declare function _resetProcBindProbeCacheForTests(): void;
20
+ export declare function resolveProcSelfExe(): string;
21
+ export {};