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,47 @@
1
+ import type { OperationalIncidentFact, OperationalIncidentSuccessInput } from "./classify-tool-outcome.js";
2
+ export type IncidentStatus = 'unresolved' | 'resolved';
3
+ export type OperationalIncident = {
4
+ fingerprint: string;
5
+ kind: OperationalIncidentFact['kind'];
6
+ bin?: string;
7
+ count: number;
8
+ firstSeenAt: string;
9
+ lastSeenAt: string;
10
+ lastSessionId: string;
11
+ status: IncidentStatus;
12
+ recurrent: boolean;
13
+ };
14
+ export type IncidentLedgerFile = {
15
+ version: 1;
16
+ incidents: OperationalIncident[];
17
+ };
18
+ type LedgerInspection = {
19
+ kind: 'missing';
20
+ } | {
21
+ kind: 'unknown';
22
+ } | {
23
+ kind: 'present';
24
+ version: string;
25
+ size: number;
26
+ };
27
+ export type IncidentLedgerIo = {
28
+ inspect: (path: string) => Promise<LedgerInspection>;
29
+ read: (agentDir: string) => Promise<IncidentLedgerFile>;
30
+ serialize: (path: string, operation: () => Promise<void>) => Promise<void>;
31
+ };
32
+ export declare function incidentsPath(agentDir: string): string;
33
+ export declare function fingerprintIncident(fact: OperationalIncidentFact): string;
34
+ export declare function deriveMechanicallyVerifiedIncidentFingerprints(input: OperationalIncidentSuccessInput): Set<string>;
35
+ export declare function readIncidentLedger(agentDir: string): Promise<IncidentLedgerFile>;
36
+ export declare class IncidentLedger {
37
+ private readonly agentDir;
38
+ private readonly io;
39
+ constructor(agentDir: string, io?: IncidentLedgerIo);
40
+ record(fact: OperationalIncidentFact, sessionId: string, now?: Date): Promise<OperationalIncident>;
41
+ resolve(fingerprint: string): Promise<boolean>;
42
+ resolveObservedSuccess(fingerprints: Iterable<string>): Promise<number>;
43
+ private resolveCandidates;
44
+ }
45
+ export declare function renderIncidentHint(incident: OperationalIncident): string;
46
+ export declare function renderUntrackedIncidentHint(fact: OperationalIncidentFact): string;
47
+ export {};
@@ -0,0 +1,3 @@
1
+ export * from "./classify-tool-outcome.js";
2
+ export * from "./incidents.js";
3
+ export * from "./remediations.js";
@@ -0,0 +1,25 @@
1
+ import type { OperationalIncidentFact } from "./classify-tool-outcome.js";
2
+ export type RemediationResult = {
3
+ repaired: boolean;
4
+ };
5
+ export type RemediationHandler = (fact: OperationalIncidentFact) => Promise<RemediationResult>;
6
+ export declare class RemediationRegistry {
7
+ private readonly handlers;
8
+ register(kind: OperationalIncidentFact['kind'], handler: RemediationHandler): void;
9
+ get(fact: OperationalIncidentFact): RemediationHandler | undefined;
10
+ }
11
+ export declare const operationalRemediations: RemediationRegistry;
12
+ export type RepairAndRetryResult<T> = {
13
+ outcome: 'retried';
14
+ value: T;
15
+ } | {
16
+ outcome: 'unhandled';
17
+ error: unknown;
18
+ } | {
19
+ outcome: 'repair-failed';
20
+ error: unknown;
21
+ } | {
22
+ outcome: 'retry-failed';
23
+ error: unknown;
24
+ };
25
+ export declare function repairAndRetryOnce<T>(registry: RemediationRegistry, fact: OperationalIncidentFact, originalError: unknown, retry: () => Promise<T>): Promise<RepairAndRetryResult<T>>;
@@ -0,0 +1,9 @@
1
+ export declare const RECOVER_MISSING: ReadonlySet<string>;
2
+ export declare const RECOVER_MISSING_OR_UNSEARCHABLE: ReadonlySet<string>;
3
+ export declare const RECOVER_MISSING_OR_UNSEARCHABLE_OR_NAME_TOO_LONG: ReadonlySet<string>;
4
+ export type RealIntendedPathOptions = {
5
+ readonly recoverable?: ReadonlySet<string>;
6
+ readonly onExhausted?: 'throw' | 'return-input';
7
+ };
8
+ export declare function realIntendedPathSync(absolutePath: string, realpath: (candidate: string) => string, options?: RealIntendedPathOptions): string;
9
+ export declare function realIntendedPath(absolutePath: string, realpath: (candidate: string) => Promise<string>, options?: RealIntendedPathOptions): Promise<string>;
@@ -0,0 +1,25 @@
1
+ import type { MatchRule } from "./match-rule.js";
2
+ export type BuiltinRoleName = 'owner' | 'trusted' | 'member' | 'guest';
3
+ export declare const BUILTIN_ROLE_NAMES: readonly BuiltinRoleName[];
4
+ export declare const CORE_PERMISSIONS: {
5
+ readonly channelRespond: "channel.respond";
6
+ readonly sessionControl: "session.control";
7
+ readonly sessionAdmin: "session.admin";
8
+ readonly cronSchedule: "cron.schedule";
9
+ readonly cronModify: "cron.modify";
10
+ readonly subagentSpawn: "subagent.spawn";
11
+ readonly subagentCancel: "subagent.cancel";
12
+ readonly subagentOutput: "subagent.output";
13
+ readonly subagentSpawnOperator: "subagent.spawn.operator";
14
+ readonly fsSeePrivate: "fs.see.private";
15
+ readonly fsSeeSecrets: "fs.see.secrets";
16
+ readonly browserShared: "browser.shared";
17
+ };
18
+ export declare const OWNER_SECURITY_WILDCARD = "__BUILTIN_OWNER_SECURITY_WILDCARD__";
19
+ export type BuiltinRoleSpec = {
20
+ readonly match: readonly MatchRule[];
21
+ readonly permissions: readonly string[];
22
+ };
23
+ export declare const BUILTIN_ROLES: Readonly<Record<BuiltinRoleName, BuiltinRoleSpec>>;
24
+ export declare function expandOwnerWildcard(ownerPermissions: readonly string[], pluginContributed: readonly string[], wildcardExclusions?: readonly string[]): readonly string[];
25
+ export declare function isBuiltinRoleName(name: string): name is BuiltinRoleName;
@@ -0,0 +1,19 @@
1
+ export type GrantResult = {
2
+ ok: true;
3
+ added: boolean;
4
+ } | {
5
+ ok: false;
6
+ reason: string;
7
+ };
8
+ export type GrantOptions = {
9
+ cwd: string;
10
+ roleName: string;
11
+ matchRule: string;
12
+ };
13
+ export type GrantPermissionOptions = {
14
+ cwd: string;
15
+ roleName: string;
16
+ permission: string;
17
+ };
18
+ export declare function grantRole(opts: GrantOptions): GrantResult;
19
+ export declare function grantRolePermission(opts: GrantPermissionOptions): GrantResult;
@@ -0,0 +1,6 @@
1
+ export { BUILTIN_ROLE_NAMES, BUILTIN_ROLES, CORE_PERMISSIONS, OWNER_SECURITY_WILDCARD, expandOwnerWildcard, isBuiltinRoleName, type BuiltinRoleName, type BuiltinRoleSpec, } from "./builtins.js";
2
+ export { MATCH_RULE_REGEX_SOURCE, PLATFORMS, parseMatchRule, type MatchRule, type ParseMatchRuleResult, type Platform, } from "./match-rule.js";
3
+ export { createPermissionService, findUngrantedPluginPermissions, findUnknownPermissions, noopPermissionService, type CreatePermissionServiceOptions, type PermissionService, type UnknownPermissionWarning, } from "./permissions.js";
4
+ export { grantRole, grantRolePermission, type GrantOptions, type GrantPermissionOptions, type GrantResult, } from "./grant.js";
5
+ export { matchesOrigin, isDmChannelOrigin, type MatchableOrigin } from "./resolve.js";
6
+ export { MATCH_RULE_JSON_SCHEMA_PATTERN, rolesConfigSchema, type RoleConfig, type RolesConfig } from "./schema.js";
@@ -0,0 +1,28 @@
1
+ export declare const PLATFORMS: readonly ["slack", "discord", "telegram", "webex", "teams", "instagram", "line", "kakao", "github"];
2
+ export type Platform = (typeof PLATFORMS)[number];
3
+ export type MatchRule = {
4
+ kind: 'tui';
5
+ } | {
6
+ kind: 'cron';
7
+ } | {
8
+ kind: 'subagent';
9
+ subagent?: string;
10
+ } | {
11
+ kind: 'wildcard';
12
+ } | {
13
+ kind: 'channel';
14
+ platform: Platform;
15
+ workspace?: string;
16
+ chat?: string;
17
+ bucket?: 'dm' | 'group' | 'open' | 'square';
18
+ author?: string;
19
+ };
20
+ export type ParseMatchRuleResult = {
21
+ ok: true;
22
+ value: MatchRule;
23
+ } | {
24
+ ok: false;
25
+ error: string;
26
+ };
27
+ export declare const MATCH_RULE_REGEX_SOURCE: string;
28
+ export declare function parseMatchRule(input: string): ParseMatchRuleResult;
@@ -0,0 +1,42 @@
1
+ import type { SessionOrigin } from "../agent/session-origin.js";
2
+ import type { RolesConfig } from "./schema.js";
3
+ export type PermissionService = {
4
+ has(origin: SessionOrigin | undefined, permission: string): boolean;
5
+ resolveRole(origin: SessionOrigin | undefined): string;
6
+ resolveRole(origin: SessionOrigin | undefined, options: {
7
+ requireMatch: true;
8
+ }): string | undefined;
9
+ describe(origin: SessionOrigin | undefined): {
10
+ role: string;
11
+ permissions: readonly string[];
12
+ };
13
+ compareRoleSeverity(a: string, b: string): -1 | 0 | 1 | undefined;
14
+ permissionsForRole(role: string): readonly string[] | undefined;
15
+ replaceRoles(roles: RolesConfig | undefined): void;
16
+ replacePluginPermissions?(opts: {
17
+ pluginPermissions: readonly string[];
18
+ ownerWildcardExclusions: readonly string[];
19
+ }): void;
20
+ };
21
+ export type UnknownPermissionWarning = {
22
+ role: string;
23
+ permission: string;
24
+ hint: string;
25
+ };
26
+ export declare const noopPermissionService: PermissionService;
27
+ export type CreatePermissionServiceOptions = {
28
+ roles?: RolesConfig;
29
+ pluginPermissions?: readonly string[];
30
+ ownerWildcardExclusions?: readonly string[];
31
+ };
32
+ export declare function findUnknownPermissions(roles: RolesConfig | undefined, pluginPermissions: readonly string[]): UnknownPermissionWarning[];
33
+ export declare function findUngrantedPluginPermissions(roles: RolesConfig | undefined, pluginPermissions: readonly string[], ownerWildcardExclusions?: readonly string[]): string[];
34
+ export declare const ROLE_CACHE_MAX = 4096;
35
+ export type BoundedCache<V> = {
36
+ get(key: string): V | undefined;
37
+ set(key: string, value: V): void;
38
+ clear(): void;
39
+ readonly size: number;
40
+ };
41
+ export declare function createBoundedCache<V>(max: number): BoundedCache<V>;
42
+ export declare function createPermissionService(opts?: CreatePermissionServiceOptions): PermissionService;
@@ -0,0 +1,25 @@
1
+ import type { AdapterId } from "../channels/schema.js";
2
+ import type { MatchRule } from "./match-rule.js";
3
+ export type MatchableOrigin = {
4
+ kind: 'tui';
5
+ sessionId?: string;
6
+ } | {
7
+ kind: 'cron';
8
+ jobId?: string;
9
+ } | {
10
+ kind: 'subagent';
11
+ subagent?: string;
12
+ } | {
13
+ kind: 'channel';
14
+ adapter: AdapterId;
15
+ workspace: string;
16
+ chat: string;
17
+ parentChat?: string;
18
+ lastInboundAuthorId?: string;
19
+ lastInboundAuthorAdapter?: AdapterId;
20
+ };
21
+ export declare function matchesOrigin(rule: MatchRule, origin: MatchableOrigin): boolean;
22
+ export declare function isDmChannelOrigin(origin: {
23
+ adapter: AdapterId;
24
+ workspace: string;
25
+ }): boolean;
@@ -0,0 +1,14 @@
1
+ import { z } from 'zod';
2
+ import { type MatchRule } from "./match-rule.js";
3
+ export declare const MATCH_RULE_JSON_SCHEMA_PATTERN: string;
4
+ declare const roleConfigSchema: z.ZodObject<{
5
+ match: z.ZodDefault<z.ZodArray<z.ZodType<MatchRule, unknown, z.core.$ZodTypeInternals<MatchRule, unknown>>>>;
6
+ permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
7
+ }, z.core.$strict>;
8
+ export type RoleConfig = z.infer<typeof roleConfigSchema>;
9
+ export declare const rolesConfigSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
10
+ match: z.ZodDefault<z.ZodArray<z.ZodType<MatchRule, unknown, z.core.$ZodTypeInternals<MatchRule, unknown>>>>;
11
+ permissions: z.ZodOptional<z.ZodArray<z.ZodString>>;
12
+ }, z.core.$strict>>;
13
+ export type RolesConfig = z.infer<typeof rolesConfigSchema>;
14
+ export {};
@@ -0,0 +1,20 @@
1
+ import type { ResolveGithubTokenForRepo } from "../channels/github-token-bridge.js";
2
+ import type { PermissionService } from "../permissions/index.js";
3
+ import type { PluginContext, PluginLogger, SpawnSubagentOptions } from "./types.js";
4
+ export type SpawnSubagentFn = (name: string, payload?: unknown, options?: SpawnSubagentOptions) => Promise<void>;
5
+ export type CreatePluginContextOptions<TConfig> = {
6
+ name: string;
7
+ version: string | undefined;
8
+ agentDir: string;
9
+ config: TConfig;
10
+ logger: PluginLogger;
11
+ permissions: PermissionService;
12
+ resolveGithubTokenForRepo?: ResolveGithubTokenForRepo;
13
+ hasGithubAppTokenResolver?: () => boolean;
14
+ getGithubAppSelfLogin?: () => string | null;
15
+ resolveGithubPatForRepo?: ResolveGithubTokenForRepo;
16
+ spawnSubagent: SpawnSubagentFn;
17
+ isBooted: () => boolean;
18
+ };
19
+ export declare function createPluginContext<TConfig>(opts: CreatePluginContextOptions<TConfig>): PluginContext<TConfig>;
20
+ export declare function createPluginLogger(name: string): PluginLogger;
@@ -0,0 +1,4 @@
1
+ export type PiBuiltinToolName = 'read' | 'bash' | 'edit' | 'write' | 'grep' | 'find' | 'ls';
2
+ export declare const PI_BUILTIN_TOOL_NAMES: readonly PiBuiltinToolName[];
3
+ export declare const CORE_SYSTEM_TOOL_NAMES: readonly ["web_search", "web_fetch", "look_at", "coding_agent"];
4
+ export declare const CORE_TOOL_NAMES: ReadonlySet<string>;
@@ -0,0 +1,46 @@
1
+ import type { z } from 'zod';
2
+ import type { BuiltinToolRef, ContainerCommand, DefinedPlugin, EitherCommand, HostCommand, PluginCommand, PluginContext, PluginExports, Subagent, Tool } from "./types.js";
3
+ type DefinePluginSpec<S extends z.ZodType<unknown> | undefined> = S extends z.ZodType<infer T> ? {
4
+ configSchema: S;
5
+ permissions?: readonly string[];
6
+ ownerWildcardExclusions?: readonly string[];
7
+ commands?: Record<string, PluginCommand>;
8
+ plugin: (ctx: PluginContext<T>) => Promise<PluginExports>;
9
+ } : {
10
+ permissions?: readonly string[];
11
+ ownerWildcardExclusions?: readonly string[];
12
+ commands?: Record<string, PluginCommand>;
13
+ plugin: (ctx: PluginContext<unknown>) => Promise<PluginExports>;
14
+ };
15
+ export declare function definePlugin<S extends z.ZodType<unknown> | undefined = undefined>(spec: DefinePluginSpec<S>): DefinedPlugin<S extends z.ZodType<infer T> ? T : unknown>;
16
+ export declare function defineTool<P>(tool: Tool<P>): Tool<P>;
17
+ export declare function defineSubagent<P>(subagent: Subagent<P>): Subagent<P>;
18
+ type ContainerCommandSpec<S extends z.ZodObject<z.ZodRawShape> | undefined> = S extends z.ZodObject<z.ZodRawShape> ? Omit<ContainerCommand<z.infer<S>>, 'args'> & {
19
+ args: S;
20
+ } : Omit<ContainerCommand<unknown>, 'args'> & {
21
+ args?: undefined;
22
+ };
23
+ type HostCommandSpec<S extends z.ZodObject<z.ZodRawShape> | undefined> = S extends z.ZodObject<z.ZodRawShape> ? Omit<HostCommand<z.infer<S>>, 'args'> & {
24
+ args: S;
25
+ } : Omit<HostCommand<unknown>, 'args'> & {
26
+ args?: undefined;
27
+ };
28
+ type EitherCommandSpec<S extends z.ZodObject<z.ZodRawShape> | undefined> = S extends z.ZodObject<z.ZodRawShape> ? Omit<EitherCommand<z.infer<S>>, 'args'> & {
29
+ args: S;
30
+ } : Omit<EitherCommand<unknown>, 'args'> & {
31
+ args?: undefined;
32
+ };
33
+ export declare function defineCommand<S extends z.ZodObject<z.ZodRawShape> | undefined = undefined>(cmd: ContainerCommandSpec<S>): ContainerCommand<S extends z.ZodObject<z.ZodRawShape> ? z.infer<S> : unknown>;
34
+ export declare function defineCommand<S extends z.ZodObject<z.ZodRawShape> | undefined = undefined>(cmd: HostCommandSpec<S>): HostCommand<S extends z.ZodObject<z.ZodRawShape> ? z.infer<S> : unknown>;
35
+ export declare function defineCommand<S extends z.ZodObject<z.ZodRawShape> | undefined = undefined>(cmd: EitherCommandSpec<S>): EitherCommand<S extends z.ZodObject<z.ZodRawShape> ? z.infer<S> : unknown>;
36
+ export declare const readTool: BuiltinToolRef;
37
+ export declare const bashTool: BuiltinToolRef;
38
+ export declare const editTool: BuiltinToolRef;
39
+ export declare const writeTool: BuiltinToolRef;
40
+ export declare const grepTool: BuiltinToolRef;
41
+ export declare const findTool: BuiltinToolRef;
42
+ export declare const lsTool: BuiltinToolRef;
43
+ export declare const webSearchTool: BuiltinToolRef;
44
+ export declare const webFetchTool: BuiltinToolRef;
45
+ export declare const codingAgentTool: BuiltinToolRef;
46
+ export {};
@@ -0,0 +1,52 @@
1
+ import type { ChannelMessageObservedEvent, ChannelOutboundBeforeEvent, Hooks, PluginLogger, SessionEndEvent, SessionIdleEvent, SessionPromptEvent, SessionStartEvent, SessionTurnEndEvent, SessionTurnStartEvent, ToolAfterEvent, ToolBeforeEvent } from "./types.js";
2
+ export declare const IDLE_HANDLER_TIMEOUT_MS = 25000;
3
+ export declare const END_HANDLER_TIMEOUT_MS = 60000;
4
+ export declare const PROMPT_HANDLER_TIMEOUT_MS = 20000;
5
+ export declare const OBSERVED_HANDLER_TIMEOUT_MS = 10000;
6
+ export declare const OUTBOUND_HANDLER_TIMEOUT_MS = 30000;
7
+ export type RegisteredHook<K extends keyof Hooks> = {
8
+ pluginName: string;
9
+ agentDir: string;
10
+ logger: PluginLogger;
11
+ handler: NonNullable<Hooks[K]>;
12
+ };
13
+ export type HookBus = {
14
+ registerAll: (pluginName: string, agentDir: string, logger: PluginLogger, hooks: Hooks) => void;
15
+ unregisterAll: (pluginName: string) => void;
16
+ runSessionStart: (event: SessionStartEvent) => Promise<void>;
17
+ runSessionEnd: (event: SessionEndEvent) => Promise<void>;
18
+ runSessionIdle: (event: SessionIdleEvent) => Promise<void>;
19
+ runSessionPrompt: (event: SessionPromptEvent) => Promise<void>;
20
+ runSessionTurnStart: (event: SessionTurnStartEvent) => Promise<void>;
21
+ runSessionTurnEnd: (event: SessionTurnEndEvent) => Promise<void>;
22
+ runChannelMessageObserved: (event: ChannelMessageObservedEvent) => void;
23
+ runChannelOutboundBefore: (event: ChannelOutboundBeforeEvent) => Promise<{
24
+ text: string;
25
+ }>;
26
+ runToolBefore: (event: ToolBeforeEvent, guards?: readonly {
27
+ owner: string;
28
+ key: string;
29
+ tools: ReadonlySet<string>;
30
+ skipOnCheckError?: true;
31
+ check: (event: Readonly<ToolBeforeEvent>) => undefined | {
32
+ readonly kind: 'block' | 'acknowledgement-required';
33
+ readonly reason: string;
34
+ } | Promise<undefined | {
35
+ readonly kind: 'block' | 'acknowledgement-required';
36
+ readonly reason: string;
37
+ }>;
38
+ }[], acknowledgements?: Readonly<Record<string, Readonly<Record<string, boolean>>>>) => Promise<{
39
+ block: true;
40
+ reason: string;
41
+ } | undefined>;
42
+ runToolAfter: (event: ToolAfterEvent) => Promise<void>;
43
+ count: (name: keyof Hooks) => number;
44
+ };
45
+ export type CreateHookBusOptions = {
46
+ idleHandlerTimeoutMs?: number;
47
+ endHandlerTimeoutMs?: number;
48
+ promptHandlerTimeoutMs?: number;
49
+ observedHandlerTimeoutMs?: number;
50
+ outboundHandlerTimeoutMs?: number;
51
+ };
52
+ export declare function createHookBus(options?: CreateHookBusOptions): HookBus;
@@ -0,0 +1,11 @@
1
+ export { bashTool, codingAgentTool, defineCommand, definePlugin, defineSubagent, defineTool, editTool, findTool, grepTool, lsTool, readTool, webFetchTool, webSearchTool, writeTool, } from "./define.js";
2
+ export type { BuiltinToolRef, ChannelMessageObservedEvent, ChannelOutboundBeforeEvent, ChannelOutboundBeforeResult, ChannelOutboundOrigin, CommandExecResult, CommandStreams, ContainerCommand, ContainerCommandContext, ContentPart, DefinedPlugin, EitherCommand, EitherCommandContext, HookContext, HookName, Hooks, HostCommand, HostCommandContext, PluginCheckResult, PluginCheckStatus, PluginCommand, PluginContext, CronHandlerContext, PluginCronJob, PluginDoctorCheck, PluginDoctorContext, PluginExecCronJob, PluginExports, PluginFixResult, PluginFixSuggestion, PluginHandlerCronJob, PluginLogger, PluginPromptCronJob, PluginSkill, RunSession, SessionEndEvent, SessionIdleEvent, SessionPromptEvent, SessionStartEvent, SessionTurnEndEvent, SessionTurnStartEvent, SpawnSubagentOptions, SlackObservedMessage, Subagent, SubagentContext, Tool, ToolAfterEvent, ToolBeforeEvent, ToolBeforeResult, ToolContext, ToolFileOperands, ToolProvenance, ToolLogger, ToolResult, } from "./types.js";
3
+ export { loadPlugins, summarizeLoaded, pluginCronJobs, type LoadPluginsOptions, type LoadPluginsResult, } from "./manager.js";
4
+ export type { PermissionService } from "../permissions/index.js";
5
+ export type { LoadPluginEntryFn, PluginEntrySpec, ResolvedPlugin } from "./loader.js";
6
+ export { derivePluginNameFromPackage, loadPluginEntry, PluginNotFoundError, splitPluginEntrySpec } from "./loader.js";
7
+ export { materializeSkills, type MaterializedSkills, type SkillEntry } from "./skills.js";
8
+ export { createLoadSkillTool, type CreateLoadSkillToolOptions, type LoadableSkill, type LoadSkillArgs, } from "./load-skill.js";
9
+ export { buildPluginCronGlobalId, RESERVED_COMMAND_NAMES, validateCommandDeclaration, type PluginRegistry, type RegisteredCommand, type RegisteredCronJob, type RegisteredDoctorCheck, type RegisteredPluginDisposer, type RegisteredSkillDir, type RegisteredSkillEntry, type RegisteredSubagent, type RegisteredTool, } from "./registry.js";
10
+ export { createHookBus, type HookBus } from "./hooks.js";
11
+ export { createSubagentSessionManager } from "../agent/subagent-session.js";
@@ -0,0 +1,14 @@
1
+ import type { Tool } from "./types.js";
2
+ export type LoadableSkill = {
3
+ name: string;
4
+ description: string;
5
+ content: string;
6
+ };
7
+ export type CreateLoadSkillToolOptions = {
8
+ skills: readonly LoadableSkill[];
9
+ description?: string;
10
+ };
11
+ export type LoadSkillArgs = {
12
+ name: string;
13
+ };
14
+ export declare function createLoadSkillTool(options: CreateLoadSkillToolOptions): Tool<LoadSkillArgs>;
@@ -0,0 +1,25 @@
1
+ import type { DefinedPlugin } from "./types.js";
2
+ export type ResolvedPlugin = {
3
+ name: string;
4
+ version: string | undefined;
5
+ source: string;
6
+ defined: DefinedPlugin<any>;
7
+ };
8
+ export type LoadPluginEntryFn = (entry: string, agentDir: string) => Promise<ResolvedPlugin>;
9
+ export declare class PluginNotFoundError extends Error {
10
+ readonly entry: string;
11
+ constructor(entry: string, message: string, options?: {
12
+ cause?: unknown;
13
+ });
14
+ }
15
+ export declare class PluginSecurityError extends Error {
16
+ readonly entry: string;
17
+ constructor(entry: string, message: string);
18
+ }
19
+ export declare function loadPluginEntry(entry: string, agentDir: string): Promise<ResolvedPlugin>;
20
+ export type PluginEntrySpec = {
21
+ name: string;
22
+ versionSpec: string | undefined;
23
+ };
24
+ export declare function splitPluginEntrySpec(entry: string): PluginEntrySpec;
25
+ export declare function derivePluginNameFromPackage(packageName: string): string;
@@ -0,0 +1,42 @@
1
+ import type { ResolveGithubTokenForRepo } from "../channels/github-token-bridge.js";
2
+ import type { CronJob } from "../cron/index.js";
3
+ import { type PermissionService, type RolesConfig } from "../permissions/index.js";
4
+ import { type SpawnSubagentFn } from "./context.js";
5
+ import { type HookBus } from "./hooks.js";
6
+ import { type LoadPluginEntryFn, type ResolvedPlugin } from "./loader.js";
7
+ import { type PluginRegistry } from "./registry.js";
8
+ export type FailedPlugin = {
9
+ entry: string;
10
+ phase: 'resolve' | 'config' | 'factory' | 'register';
11
+ error: string;
12
+ };
13
+ export type LoadPluginsOptions = {
14
+ entries: string[];
15
+ agentDir: string;
16
+ configsByName: Record<string, unknown>;
17
+ loadEntry?: LoadPluginEntryFn;
18
+ roles?: RolesConfig;
19
+ resolveGithubTokenForRepo?: ResolveGithubTokenForRepo;
20
+ hasGithubAppTokenResolver?: () => boolean;
21
+ getGithubAppSelfLogin?: () => string | null;
22
+ resolveGithubPatForRepo?: ResolveGithubTokenForRepo;
23
+ bundled?: ResolvedPlugin[];
24
+ };
25
+ export type LoadPluginsResult = {
26
+ registry: PluginRegistry;
27
+ hooks: HookBus;
28
+ permissions: PermissionService;
29
+ declaredPermissions: readonly string[];
30
+ loadedPlugins: {
31
+ name: string;
32
+ version: string | undefined;
33
+ source: string;
34
+ }[];
35
+ failedPlugins: FailedPlugin[];
36
+ markBooted: () => void;
37
+ setSpawnSubagent: (fn: SpawnSubagentFn) => void;
38
+ disposePlugins: () => Promise<void>;
39
+ };
40
+ export declare function loadPlugins(opts: LoadPluginsOptions): Promise<LoadPluginsResult>;
41
+ export declare function summarizeLoaded(loaded: LoadPluginsResult['loadedPlugins'], registry: PluginRegistry): string;
42
+ export declare function pluginCronJobs(registry: PluginRegistry): CronJob[];
@@ -0,0 +1,73 @@
1
+ import type { CronJob } from "../cron/index.js";
2
+ import type { HookBus } from "./hooks.js";
3
+ import type { PluginCommand, PluginDoctorCheck, PluginExports, PluginLogger, PluginSkill, Subagent, Tool } from "./types.js";
4
+ export type RegisteredTool = {
5
+ pluginName: string;
6
+ toolName: string;
7
+ tool: Tool<any>;
8
+ logger: PluginLogger;
9
+ };
10
+ export type RegisteredSubagent = {
11
+ pluginName: string;
12
+ subagentName: string;
13
+ subagent: Subagent<any>;
14
+ };
15
+ export type RegisteredCronJob = {
16
+ pluginName: string;
17
+ localId: string;
18
+ globalId: string;
19
+ job: CronJob;
20
+ };
21
+ export type RegisteredSkillEntry = {
22
+ pluginName: string;
23
+ localName: string;
24
+ skill: PluginSkill;
25
+ };
26
+ export type RegisteredSkillDir = {
27
+ pluginName: string;
28
+ path: string;
29
+ };
30
+ export type RegisteredDoctorCheck = {
31
+ pluginName: string;
32
+ checkName: string;
33
+ pluginConfig: unknown;
34
+ logger: PluginLogger;
35
+ check: PluginDoctorCheck;
36
+ };
37
+ export type RegisteredCommand = {
38
+ pluginName: string;
39
+ commandName: string;
40
+ command: PluginCommand;
41
+ logger: PluginLogger;
42
+ };
43
+ export type RegisteredPluginDisposer = {
44
+ pluginName: string;
45
+ logger: PluginLogger;
46
+ dispose: () => void | Promise<void>;
47
+ };
48
+ export type PluginRegistry = {
49
+ tools: RegisteredTool[];
50
+ subagents: RegisteredSubagent[];
51
+ cronJobs: RegisteredCronJob[];
52
+ skills: RegisteredSkillEntry[];
53
+ skillsDirs: RegisteredSkillDir[];
54
+ doctorChecks: RegisteredDoctorCheck[];
55
+ commands: RegisteredCommand[];
56
+ disposers: RegisteredPluginDisposer[];
57
+ };
58
+ export type RegisterContributionsOptions = {
59
+ pluginName: string;
60
+ logger: PluginLogger;
61
+ exports: PluginExports;
62
+ commands?: Record<string, PluginCommand>;
63
+ registry: PluginRegistry;
64
+ hooks: HookBus;
65
+ agentDir: string;
66
+ pluginConfig: unknown;
67
+ };
68
+ export declare const RESERVED_COMMAND_NAMES: ReadonlySet<string>;
69
+ export declare function buildPluginCronGlobalId(pluginName: string, localId: string): string;
70
+ export declare function registerContributions(opts: RegisterContributionsOptions): void;
71
+ export declare function discardRegistrationsBy(pluginName: string, registry: PluginRegistry, hooks: HookBus): void;
72
+ export declare function emptyRegistry(): PluginRegistry;
73
+ export declare function validateCommandDeclaration(pluginName: string, commandName: string, command: PluginCommand): void;
@@ -0,0 +1,11 @@
1
+ import type { PluginSkill } from "./types.js";
2
+ export type SkillEntry = {
3
+ pluginName: string;
4
+ localName: string;
5
+ skill: PluginSkill;
6
+ };
7
+ export type MaterializedSkills = {
8
+ dir: string;
9
+ dispose: () => Promise<void>;
10
+ };
11
+ export declare function materializeSkills(skills: SkillEntry[]): Promise<MaterializedSkills>;