typeclaw 0.49.0 → 0.51.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 (502) 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/bash-sandbox-env.d.ts +15 -0
  4. package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
  5. package/dist/types/agent/bash-sandbox.d.ts +94 -0
  6. package/dist/types/agent/compaction.d.ts +8 -0
  7. package/dist/types/agent/git-nudge.d.ts +6 -0
  8. package/dist/types/agent/guard-types.d.ts +25 -0
  9. package/dist/types/agent/guards.d.ts +7 -0
  10. package/dist/types/agent/idle-compaction.d.ts +8 -0
  11. package/dist/types/agent/index.d.ts +151 -0
  12. package/dist/types/agent/live-subagents.d.ts +113 -0
  13. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  14. package/dist/types/agent/loop-guard.d.ts +67 -0
  15. package/dist/types/agent/model-fallback.d.ts +29 -0
  16. package/dist/types/agent/model-overrides.d.ts +8 -0
  17. package/dist/types/agent/multimodal/index.d.ts +2 -0
  18. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  19. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  20. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  21. package/dist/types/agent/network/response-body.d.ts +1 -0
  22. package/dist/types/agent/network/safe-http.d.ts +46 -0
  23. package/dist/types/agent/output-allowance.d.ts +4 -0
  24. package/dist/types/agent/plugin-tools.d.ts +58 -0
  25. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  26. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  27. package/dist/types/agent/provider-error.d.ts +23 -0
  28. package/dist/types/agent/reload-tool.d.ts +10 -0
  29. package/dist/types/agent/restart/index.d.ts +31 -0
  30. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  31. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  32. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  33. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  34. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  35. package/dist/types/agent/self.d.ts +1 -0
  36. package/dist/types/agent/session-meta.d.ts +28 -0
  37. package/dist/types/agent/session-origin.d.ts +65 -0
  38. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  39. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  40. package/dist/types/agent/subagent-drain.d.ts +25 -0
  41. package/dist/types/agent/subagent-session.d.ts +3 -0
  42. package/dist/types/agent/subagents.d.ts +153 -0
  43. package/dist/types/agent/system-prompt-composition.d.ts +17 -0
  44. package/dist/types/agent/system-prompt.d.ts +7 -0
  45. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  46. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  47. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  48. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  49. package/dist/types/agent/todo/continuation.d.ts +21 -0
  50. package/dist/types/agent/todo/scope.d.ts +6 -0
  51. package/dist/types/agent/todo/store.d.ts +16 -0
  52. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  53. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  54. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  55. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  56. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  57. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  58. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  59. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  60. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  61. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  62. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  63. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  64. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  65. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  66. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  67. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  68. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  69. package/dist/types/agent/tools/ddg.d.ts +27 -0
  70. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  71. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  72. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  73. package/dist/types/agent/tools/restart.d.ts +25 -0
  74. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  75. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  76. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  77. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  78. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  79. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  80. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  81. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  82. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  83. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  84. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  85. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  86. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  87. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  88. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  89. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  90. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  91. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  92. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  93. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  94. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  95. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  96. package/dist/types/agent/tools/websearch.d.ts +17 -0
  97. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  98. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  99. package/dist/types/agent/turn-runner.d.ts +36 -0
  100. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  101. package/dist/types/browser/dockerfile.d.ts +2 -0
  102. package/dist/types/browser/registry.d.ts +49 -0
  103. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  104. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  105. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  106. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  107. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  108. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  109. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  110. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  111. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  112. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  113. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  114. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  115. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  116. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  117. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  118. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  119. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  120. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  121. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  122. package/dist/types/channels/background-handoff.d.ts +56 -0
  123. package/dist/types/channels/background-obligations.d.ts +135 -0
  124. package/dist/types/channels/catch-up.d.ts +26 -0
  125. package/dist/types/channels/commands.d.ts +2 -0
  126. package/dist/types/channels/completion-claim.d.ts +20 -0
  127. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  128. package/dist/types/channels/continuity-types.d.ts +75 -0
  129. package/dist/types/channels/describe-error.d.ts +1 -0
  130. package/dist/types/channels/engagement.d.ts +34 -0
  131. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  132. package/dist/types/channels/github-repo.d.ts +2 -0
  133. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  134. package/dist/types/channels/github-review-check.d.ts +135 -0
  135. package/dist/types/channels/github-review-claim.d.ts +3 -0
  136. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  137. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  138. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  139. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  140. package/dist/types/channels/inbound-journal.d.ts +272 -0
  141. package/dist/types/channels/last-alive.d.ts +3 -0
  142. package/dist/types/channels/membership-cache.d.ts +27 -0
  143. package/dist/types/channels/membership.d.ts +21 -0
  144. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  145. package/dist/types/channels/participants.d.ts +4 -0
  146. package/dist/types/channels/persistence.d.ts +32 -0
  147. package/dist/types/channels/recovery-notice.d.ts +26 -0
  148. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  149. package/dist/types/channels/router.d.ts +760 -0
  150. package/dist/types/channels/schema.d.ts +501 -0
  151. package/dist/types/channels/session-handoff.d.ts +58 -0
  152. package/dist/types/channels/session-search.d.ts +29 -0
  153. package/dist/types/channels/types.d.ts +414 -0
  154. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  155. package/dist/types/cli/builtins.d.ts +2 -0
  156. package/dist/types/cli/command-meta.d.ts +9 -0
  157. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  158. package/dist/types/coding-agent/broker.d.ts +22 -0
  159. package/dist/types/coding-agent/claude.d.ts +22 -0
  160. package/dist/types/coding-agent/codex.d.ts +19 -0
  161. package/dist/types/coding-agent/index.d.ts +71 -0
  162. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  163. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  164. package/dist/types/coding-agent/omo.d.ts +133 -0
  165. package/dist/types/coding-agent/runner.d.ts +35 -0
  166. package/dist/types/coding-agent/tool.d.ts +27 -0
  167. package/dist/types/coding-agent/worktree.d.ts +22 -0
  168. package/dist/types/commands/index.d.ts +45 -0
  169. package/dist/types/config/config.d.ts +827 -0
  170. package/dist/types/config/index.d.ts +3 -0
  171. package/dist/types/config/model-overrides.d.ts +3 -0
  172. package/dist/types/config/providers.d.ts +1458 -0
  173. package/dist/types/config/reloadable.d.ts +9 -0
  174. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  175. package/dist/types/container/build-cache.d.ts +39 -0
  176. package/dist/types/container/compose-project.d.ts +1 -0
  177. package/dist/types/container/controller.d.ts +25 -0
  178. package/dist/types/container/docker-app.d.ts +23 -0
  179. package/dist/types/container/exit-reason.d.ts +10 -0
  180. package/dist/types/container/index.d.ts +14 -0
  181. package/dist/types/container/log-archive.d.ts +68 -0
  182. package/dist/types/container/log-colors.d.ts +3 -0
  183. package/dist/types/container/log-timestamps.d.ts +9 -0
  184. package/dist/types/container/logs.d.ts +37 -0
  185. package/dist/types/container/memory-limit.d.ts +13 -0
  186. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  187. package/dist/types/container/oom-events.d.ts +18 -0
  188. package/dist/types/container/port.d.ts +18 -0
  189. package/dist/types/container/require-running.d.ts +16 -0
  190. package/dist/types/container/restart.d.ts +32 -0
  191. package/dist/types/container/shared.d.ts +93 -0
  192. package/dist/types/container/shell.d.ts +35 -0
  193. package/dist/types/container/start.d.ts +145 -0
  194. package/dist/types/container/stats.d.ts +31 -0
  195. package/dist/types/container/status.d.ts +25 -0
  196. package/dist/types/container/stop.d.ts +24 -0
  197. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  198. package/dist/types/container/verify-running.d.ts +49 -0
  199. package/dist/types/cron/consumer.d.ts +42 -0
  200. package/dist/types/cron/count-state.d.ts +24 -0
  201. package/dist/types/cron/index.d.ts +21 -0
  202. package/dist/types/cron/list.d.ts +33 -0
  203. package/dist/types/cron/reloadable.d.ts +11 -0
  204. package/dist/types/cron/scheduler.d.ts +51 -0
  205. package/dist/types/cron/schema.d.ts +108 -0
  206. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  207. package/dist/types/dependencies/bins.d.ts +22 -0
  208. package/dist/types/dependencies/index.d.ts +2 -0
  209. package/dist/types/eval/cell.d.ts +26 -0
  210. package/dist/types/eval/config.d.ts +19 -0
  211. package/dist/types/eval/dispatch.d.ts +7 -0
  212. package/dist/types/eval/kernel.d.ts +28 -0
  213. package/dist/types/eval/process.d.ts +23 -0
  214. package/dist/types/eval/protocol.d.ts +34 -0
  215. package/dist/types/eval/sandbox.d.ts +10 -0
  216. package/dist/types/eval/tool.d.ts +17 -0
  217. package/dist/types/eval/wire.d.ts +33 -0
  218. package/dist/types/git/bound-gc-config.d.ts +4 -0
  219. package/dist/types/git/hookless.d.ts +1 -0
  220. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  221. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  222. package/dist/types/git/resolve-identity.d.ts +10 -0
  223. package/dist/types/git/run.d.ts +24 -0
  224. package/dist/types/git/system-commit.d.ts +2 -0
  225. package/dist/types/hostd/client.d.ts +13 -0
  226. package/dist/types/hostd/models.d.ts +1 -0
  227. package/dist/types/hostd/paths.d.ts +17 -0
  228. package/dist/types/hostd/protocol.d.ts +93 -0
  229. package/dist/types/hostd/spawn.d.ts +17 -0
  230. package/dist/types/hostd/version.d.ts +18 -0
  231. package/dist/types/init/auto-upgrade.d.ts +41 -0
  232. package/dist/types/init/cli-version.d.ts +7 -0
  233. package/dist/types/init/dockerfile.d.ts +34 -0
  234. package/dist/types/init/ensure-deps.d.ts +17 -0
  235. package/dist/types/init/env-file.d.ts +3 -0
  236. package/dist/types/init/gitignore.d.ts +5 -0
  237. package/dist/types/init/local-source-stamp.d.ts +3 -0
  238. package/dist/types/init/packagejson.d.ts +7 -0
  239. package/dist/types/init/paths.d.ts +3 -0
  240. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  241. package/dist/types/init/run-bun-install.d.ts +16 -0
  242. package/dist/types/init/windows-dev-link.d.ts +8 -0
  243. package/dist/types/mcp/catalog.d.ts +7 -0
  244. package/dist/types/mcp/client.d.ts +58 -0
  245. package/dist/types/mcp/manager.d.ts +56 -0
  246. package/dist/types/mcp/tools.d.ts +23 -0
  247. package/dist/types/models/embedding-model.d.ts +20 -0
  248. package/dist/types/models/transformers-version.d.ts +1 -0
  249. package/dist/types/network/internal-destinations.d.ts +29 -0
  250. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  251. package/dist/types/operations/incidents.d.ts +47 -0
  252. package/dist/types/operations/index.d.ts +3 -0
  253. package/dist/types/operations/remediations.d.ts +25 -0
  254. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  255. package/dist/types/permissions/builtins.d.ts +25 -0
  256. package/dist/types/permissions/grant.d.ts +19 -0
  257. package/dist/types/permissions/index.d.ts +6 -0
  258. package/dist/types/permissions/match-rule.d.ts +28 -0
  259. package/dist/types/permissions/permissions.d.ts +42 -0
  260. package/dist/types/permissions/resolve.d.ts +25 -0
  261. package/dist/types/permissions/schema.d.ts +14 -0
  262. package/dist/types/plugin/context.d.ts +20 -0
  263. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  264. package/dist/types/plugin/define.d.ts +46 -0
  265. package/dist/types/plugin/hooks.d.ts +52 -0
  266. package/dist/types/plugin/index.d.ts +11 -0
  267. package/dist/types/plugin/load-skill.d.ts +14 -0
  268. package/dist/types/plugin/loader.d.ts +25 -0
  269. package/dist/types/plugin/manager.d.ts +42 -0
  270. package/dist/types/plugin/registry.d.ts +73 -0
  271. package/dist/types/plugin/skills.d.ts +11 -0
  272. package/dist/types/plugin/types.d.ts +336 -0
  273. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  274. package/dist/types/reload/client.d.ts +11 -0
  275. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  276. package/dist/types/reload/format.d.ts +2 -0
  277. package/dist/types/reload/index.d.ts +6 -0
  278. package/dist/types/reload/recover.d.ts +22 -0
  279. package/dist/types/reload/registry.d.ts +10 -0
  280. package/dist/types/reload/types.d.ts +25 -0
  281. package/dist/types/role-claim/client.d.ts +20 -0
  282. package/dist/types/role-claim/code.d.ts +4 -0
  283. package/dist/types/role-claim/controller.d.ts +59 -0
  284. package/dist/types/role-claim/index.d.ts +6 -0
  285. package/dist/types/role-claim/match-rule.d.ts +9 -0
  286. package/dist/types/role-claim/pending.d.ts +35 -0
  287. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  288. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  289. package/dist/types/sandbox/availability.d.ts +21 -0
  290. package/dist/types/sandbox/build.d.ts +7 -0
  291. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  292. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  293. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  294. package/dist/types/sandbox/dev-source.d.ts +4 -0
  295. package/dist/types/sandbox/env-exposure.d.ts +3 -0
  296. package/dist/types/sandbox/errors.d.ts +20 -0
  297. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  298. package/dist/types/sandbox/index.d.ts +14 -0
  299. package/dist/types/sandbox/package-install.d.ts +1 -0
  300. package/dist/types/sandbox/policy.d.ts +71 -0
  301. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  302. package/dist/types/sandbox/quote.d.ts +2 -0
  303. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  304. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  305. package/dist/types/sandbox/symlinks.d.ts +6 -0
  306. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  307. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  308. package/dist/types/secrets/defaults.d.ts +21 -0
  309. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  310. package/dist/types/secrets/hydrate.d.ts +7 -0
  311. package/dist/types/secrets/index.d.ts +7 -0
  312. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  313. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  314. package/dist/types/secrets/resolve.d.ts +14 -0
  315. package/dist/types/secrets/schema.d.ts +840 -0
  316. package/dist/types/secrets/storage.d.ts +56 -0
  317. package/dist/types/shared/host-locale.d.ts +1 -0
  318. package/dist/types/shared/index.d.ts +5 -0
  319. package/dist/types/shared/local-time.d.ts +4 -0
  320. package/dist/types/shared/platform.d.ts +2 -0
  321. package/dist/types/shared/protocol.d.ts +424 -0
  322. package/dist/types/shared/style-text.d.ts +3 -0
  323. package/dist/types/shared/wsl.d.ts +17 -0
  324. package/dist/types/stream/broker.d.ts +2 -0
  325. package/dist/types/stream/index.d.ts +2 -0
  326. package/dist/types/stream/types.d.ts +71 -0
  327. package/package.json +13 -6
  328. package/scripts/build-plugin-types.ts +105 -0
  329. package/scripts/check-plugin-sdk.ts +111 -0
  330. package/scripts/require-parallel.ts +5 -32
  331. package/src/agent/bash-sandbox-env.ts +104 -0
  332. package/src/agent/bash-sandbox-proc.ts +70 -0
  333. package/src/agent/bash-sandbox.ts +225 -0
  334. package/src/agent/compaction.ts +22 -10
  335. package/src/agent/guard-types.ts +3 -0
  336. package/src/agent/guards.ts +4 -0
  337. package/src/agent/idle-compaction.ts +178 -0
  338. package/src/agent/index.ts +139 -172
  339. package/src/agent/live-subagents.ts +19 -0
  340. package/src/agent/multimodal/look-at.ts +22 -9
  341. package/src/agent/output-allowance.ts +7 -0
  342. package/src/agent/plugin-tools.ts +39 -377
  343. package/src/agent/reviewer-bash-policy.ts +41 -1
  344. package/src/agent/session-origin.ts +28 -11
  345. package/src/agent/subagent-cache-keepalive.ts +198 -0
  346. package/src/agent/subagent-completion-reminder.ts +2 -2
  347. package/src/agent/subagent-session.ts +6 -0
  348. package/src/agent/subagents.ts +46 -8
  349. package/src/agent/system-prompt-composition.ts +141 -0
  350. package/src/agent/system-prompt.ts +5 -5
  351. package/src/agent/todo/scope.ts +1 -1
  352. package/src/agent/tool-file-safety.ts +6 -1
  353. package/src/agent/tools/channel-edit.ts +20 -10
  354. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  355. package/src/agent/tools/channel-handoff.ts +72 -0
  356. package/src/agent/tools/channel-read.ts +57 -10
  357. package/src/agent/tools/channel-reply.ts +33 -26
  358. package/src/agent/tools/channel-send.ts +21 -13
  359. package/src/agent/tools/channel-session-search.ts +35 -0
  360. package/src/agent/tools/curl-impersonate.ts +11 -4
  361. package/src/agent/tools/ddg.ts +84 -16
  362. package/src/agent/tools/spawn-subagent.ts +27 -11
  363. package/src/agent/tools/stream-snapshot.ts +15 -2
  364. package/src/agent/tools/subagent-access.ts +11 -4
  365. package/src/agent/tools-without-local-file-operands.ts +4 -0
  366. package/src/browser/bsk-shim.mjs +74 -0
  367. package/src/browser/dockerfile.ts +84 -0
  368. package/src/browser/egress.ts +104 -0
  369. package/src/browser/fill-secret.ts +307 -0
  370. package/src/browser/managed-browser.ts +205 -0
  371. package/src/browser/registry.ts +110 -0
  372. package/src/browser/relay.ts +231 -0
  373. package/src/browser/sandbox-entry.ts +167 -0
  374. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  375. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  376. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  377. package/src/bundled-plugins/doc-render/index.ts +0 -10
  378. package/src/bundled-plugins/doc-render/render.ts +83 -111
  379. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  380. package/src/bundled-plugins/explorer/explorer.ts +1 -1
  381. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  382. package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
  383. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  384. package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
  385. package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
  386. package/src/bundled-plugins/managed-browser/index.ts +179 -0
  387. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  388. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  389. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  390. package/src/bundled-plugins/memory/dreaming.ts +4 -1
  391. package/src/bundled-plugins/memory/load-memory.ts +2 -4
  392. package/src/bundled-plugins/memory/memory-logger.ts +74 -2
  393. package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
  394. package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
  395. package/src/bundled-plugins/operator/operator.ts +1 -1
  396. package/src/bundled-plugins/qa/index.ts +11 -0
  397. package/src/bundled-plugins/qa/qa.ts +160 -0
  398. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  399. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  400. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  401. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  402. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  403. package/src/bundled-plugins/security/index.ts +53 -34
  404. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  405. package/src/bundled-plugins/security/policies/private-surface-read.ts +166 -201
  406. package/src/channels/adapter-namespace.ts +13 -0
  407. package/src/channels/adapters/discord-bot-reference.ts +5 -4
  408. package/src/channels/adapters/discord-bot.ts +98 -5
  409. package/src/channels/adapters/discord-classify.ts +8 -3
  410. package/src/channels/adapters/discord.ts +29 -0
  411. package/src/channels/adapters/github/index.ts +16 -0
  412. package/src/channels/adapters/github/last-alive.ts +4 -16
  413. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  414. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  415. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  416. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  417. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  418. package/src/channels/adapters/slack-bot.ts +299 -67
  419. package/src/channels/adapters/slack-classify.ts +1 -0
  420. package/src/channels/catch-up.ts +137 -0
  421. package/src/channels/continuation-willingness.ts +2 -2
  422. package/src/channels/continuity-types.ts +1 -0
  423. package/src/channels/engagement.ts +17 -1
  424. package/src/channels/github-false-receipt.ts +3 -3
  425. package/src/channels/github-rereview-guard.ts +9 -5
  426. package/src/channels/github-review-check.ts +5 -1
  427. package/src/channels/github-review-verdict-coordinator.ts +68 -2
  428. package/src/channels/github-token-bridge.ts +24 -0
  429. package/src/channels/last-alive.ts +34 -0
  430. package/src/channels/manager.ts +8 -1
  431. package/src/channels/router.ts +515 -243
  432. package/src/channels/session-handoff.fixture.ts +144 -0
  433. package/src/channels/session-handoff.ts +175 -0
  434. package/src/channels/session-search.ts +71 -0
  435. package/src/channels/subagent-completion-bridge.ts +3 -2
  436. package/src/channels/types.ts +12 -2
  437. package/src/cli/channel.ts +2 -3
  438. package/src/cli/hostd.ts +3 -0
  439. package/src/cli/init.ts +2 -3
  440. package/src/cli/model.ts +132 -3
  441. package/src/coding-agent/index.ts +7 -1
  442. package/src/coding-agent/omo-stream.ts +40 -0
  443. package/src/coding-agent/runner.ts +30 -8
  444. package/src/config/config.ts +126 -22
  445. package/src/config/model-overrides.ts +59 -0
  446. package/src/config/models-mutation.ts +185 -2
  447. package/src/config/providers-mutation.ts +12 -4
  448. package/src/config/providers.ts +69 -4
  449. package/src/container/start.ts +132 -5
  450. package/src/doctor/checks.ts +33 -22
  451. package/src/doctor/index.ts +48 -12
  452. package/src/doctor/operational-incidents.ts +16 -1
  453. package/src/doctor/plugin-bridge.ts +14 -1
  454. package/src/doctor/stage.ts +14 -0
  455. package/src/doctor/types.ts +6 -0
  456. package/src/eval/cell.ts +93 -0
  457. package/src/eval/config.ts +32 -0
  458. package/src/eval/dispatch.ts +67 -0
  459. package/src/eval/entry.ts +261 -0
  460. package/src/eval/kernel.ts +154 -0
  461. package/src/eval/process.ts +113 -0
  462. package/src/eval/protocol.ts +26 -0
  463. package/src/eval/redeclare.ts +174 -0
  464. package/src/eval/sandbox.ts +114 -0
  465. package/src/eval/tool.ts +98 -0
  466. package/src/eval/wire.ts +93 -0
  467. package/src/hostd/daemon.ts +13 -1
  468. package/src/init/auto-upgrade.ts +7 -1
  469. package/src/init/dockerfile.ts +57 -12
  470. package/src/init/index.ts +4 -3
  471. package/src/init/local-source-stamp.ts +68 -0
  472. package/src/init/models-dev.ts +4 -0
  473. package/src/init/validate-api-key.ts +3 -0
  474. package/src/operations/classify-tool-outcome.ts +1 -1
  475. package/src/permissions/builtins.ts +7 -0
  476. package/src/permissions/permissions.ts +18 -9
  477. package/src/permissions/resolve.ts +7 -1
  478. package/src/plugin/context.ts +2 -0
  479. package/src/plugin/core-tool-names.ts +6 -1
  480. package/src/plugin/hooks.ts +137 -0
  481. package/src/plugin/index.ts +6 -0
  482. package/src/plugin/manager.ts +4 -0
  483. package/src/plugin/types.ts +60 -0
  484. package/src/run/bundled-plugins.ts +6 -0
  485. package/src/run/index.ts +24 -14
  486. package/src/run/llm-fetch-observer.ts +12 -15
  487. package/src/sandbox/canonical-secrets.ts +4 -0
  488. package/src/sandbox/dev-source.ts +26 -0
  489. package/src/sandbox/env-exposure.ts +20 -0
  490. package/src/sandbox/hidden-paths.ts +16 -2
  491. package/src/secrets/storage.ts +13 -0
  492. package/src/server/index.ts +46 -11
  493. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  494. package/src/skills/typeclaw-config/SKILL.md +57 -5
  495. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  496. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  497. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  498. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  499. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  500. package/typeclaw.schema.json +488 -5
  501. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  502. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -0,0 +1,58 @@
1
+ import type { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
2
+ import type { RequestOptions } from '@modelcontextprotocol/sdk/shared/protocol.js';
3
+ import type { Transport } from '@modelcontextprotocol/sdk/shared/transport.js';
4
+ import { CallToolResultSchema, type CallToolResult, type ListToolsRequest } from '@modelcontextprotocol/sdk/types.js';
5
+ import type { McpServer } from "../config/config.js";
6
+ import type { ToolFileOperands } from "../plugin/index.js";
7
+ export type McpToolInfo = {
8
+ name: string;
9
+ description: string;
10
+ inputSchema: unknown;
11
+ fileOperands?: ToolFileOperands;
12
+ };
13
+ export declare const MCP_FILE_OPERANDS_META_KEY = "x-file-operands";
14
+ export declare const DEFAULT_MCP_REQUEST_TIMEOUT_MS = 30000;
15
+ export declare const DEFAULT_MCP_CONNECT_TIMEOUT_MS = 15000;
16
+ export type McpConnection = {
17
+ name: string;
18
+ listTools(): Promise<McpToolInfo[]>;
19
+ peekTools(): McpToolInfo[] | undefined;
20
+ refresh(): Promise<McpToolInfo[]>;
21
+ callTool(toolName: string, args?: Record<string, unknown>): Promise<CallToolResult>;
22
+ close(): Promise<void>;
23
+ };
24
+ export declare function parseDeclaredFileOperands(meta: Record<string, unknown> | undefined): ToolFileOperands | undefined;
25
+ export type McpSdkClient = {
26
+ listTools(params?: ListToolsRequest['params'], options?: RequestOptions): Promise<{
27
+ tools: {
28
+ name: string;
29
+ description?: string;
30
+ inputSchema: unknown;
31
+ _meta?: Record<string, unknown>;
32
+ }[];
33
+ nextCursor?: string;
34
+ }>;
35
+ callTool(params: {
36
+ name: string;
37
+ arguments?: Record<string, unknown>;
38
+ }, resultSchema?: typeof CallToolResultSchema, options?: RequestOptions): Promise<CallToolResult>;
39
+ close(): Promise<void>;
40
+ };
41
+ type McpConnectClient = McpSdkClient & {
42
+ connect(transport: Transport, options?: RequestOptions): Promise<void>;
43
+ };
44
+ export declare function connectMcpServer(server: McpServer, opts: {
45
+ env: NodeJS.ProcessEnv;
46
+ signal?: AbortSignal;
47
+ connectTimeoutMs?: number;
48
+ client?: McpConnectClient;
49
+ transport?: Transport;
50
+ authProvider?: OAuthClientProvider;
51
+ }): Promise<McpConnection>;
52
+ export declare function createMcpConnection(name: string, client: McpSdkClient, opts?: {
53
+ timeoutMs?: number;
54
+ signal?: AbortSignal;
55
+ }): McpConnection;
56
+ export declare function createTransport(server: McpServer, env: NodeJS.ProcessEnv, authProvider?: OAuthClientProvider): Transport;
57
+ export declare function resolveServerEnv(server: Pick<McpServer, 'env'>, env: NodeJS.ProcessEnv): Record<string, string>;
58
+ export {};
@@ -0,0 +1,56 @@
1
+ import type { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
2
+ import type { McpServer } from "../config/config.js";
3
+ import { type McpConnection } from "./client.js";
4
+ export type McpConnectResult = {
5
+ ok: true;
6
+ name: string;
7
+ connection: McpConnection;
8
+ toolCount: number;
9
+ } | {
10
+ ok: false;
11
+ name: string;
12
+ error: Error;
13
+ };
14
+ export type McpRefreshResult = {
15
+ ok: true;
16
+ name: string;
17
+ toolCount: number;
18
+ } | {
19
+ ok: false;
20
+ name: string;
21
+ error: Error;
22
+ };
23
+ export type McpManager = {
24
+ connectAll(opts?: {
25
+ signal?: AbortSignal;
26
+ }): Promise<McpConnectResult[]>;
27
+ ensureConnected(name: string): Promise<McpConnection | undefined>;
28
+ whenInitialConnectSettled(opts?: {
29
+ timeoutMs?: number;
30
+ }): Promise<void>;
31
+ getConnection(name: string): McpConnection | undefined;
32
+ listServers(): {
33
+ name: string;
34
+ description?: string;
35
+ connected: boolean;
36
+ toolCount?: number;
37
+ }[];
38
+ refresh(): Promise<McpRefreshResult[]>;
39
+ closeAll(): Promise<void>;
40
+ };
41
+ export type ConnectMcpServerFn = (server: McpServer, opts: {
42
+ env: NodeJS.ProcessEnv;
43
+ signal?: AbortSignal;
44
+ authProvider?: OAuthClientProvider;
45
+ }) => Promise<McpConnection>;
46
+ export type McpAuthProviderFactory = (server: McpServer) => OAuthClientProvider | undefined;
47
+ export declare function createMcpManager(servers: McpServer[], opts: {
48
+ env: NodeJS.ProcessEnv;
49
+ connect?: ConnectMcpServerFn;
50
+ authProvider?: McpAuthProviderFactory;
51
+ }): McpManager;
52
+ export declare function namespaceToolName(server: string, tool: string): string;
53
+ export declare function parseNamespacedTool(namespaced: string): {
54
+ server: string;
55
+ tool: string;
56
+ } | undefined;
@@ -0,0 +1,23 @@
1
+ import type { Tool, ToolFileOperands } from "../plugin/types.js";
2
+ import type { HiddenPaths } from "../sandbox/index.js";
3
+ import type { McpManager } from "./manager.js";
4
+ export declare const MCP_DISPATCHER_TOOL_NAMES: readonly ["mcp_list_tools", "mcp_describe", "mcp_call"];
5
+ export type McpListToolsArgs = {
6
+ server: string;
7
+ };
8
+ export type McpDescribeArgs = {
9
+ server: string;
10
+ tool: string;
11
+ };
12
+ export type McpCallArgs = {
13
+ server: string;
14
+ tool: string;
15
+ args?: Record<string, unknown>;
16
+ };
17
+ export type McpDispatcherTool = Tool<McpListToolsArgs> | Tool<McpDescribeArgs> | Tool<McpCallArgs>;
18
+ export type McpDispatcherTools = [Tool<McpListToolsArgs>, Tool<McpDescribeArgs>, Tool<McpCallArgs>];
19
+ export declare function createMcpDispatcherTools(manager: McpManager, opts: {
20
+ resolveHidden: () => HiddenPaths;
21
+ }): McpDispatcherTools;
22
+ export declare function resolveMcpCallPreflightFileOperands(manager: McpManager, args: Record<string, unknown>): ToolFileOperands | undefined;
23
+ export declare function sanitizeMcpError(raw: string): string;
@@ -0,0 +1,20 @@
1
+ export declare const EMBEDDING_MODEL_NAME = "Xenova/multilingual-e5-base";
2
+ export declare const EMBEDDING_MODEL_DTYPE = "q8";
3
+ export declare const EMBEDDING_DIMS = 768;
4
+ export declare const EMBEDDING_RECIPE = "e5-prefix:mean-pool:l2-normalize";
5
+ export declare const EMBEDDING_MODEL_ID = "Xenova/multilingual-e5-base@q8";
6
+ export type ModelSentinel = {
7
+ schemaVersion: 1;
8
+ model: string;
9
+ dtype: string;
10
+ dims: number;
11
+ recipe: string;
12
+ transformers: string;
13
+ };
14
+ export declare function writeModelSentinel(dir: string, input: {
15
+ transformers: string;
16
+ }): Promise<void>;
17
+ export declare function readModelSentinel(dir: string): Promise<ModelSentinel | null>;
18
+ export declare function assertModelCacheCompatible(dir: string, expected: {
19
+ transformers: string;
20
+ }): Promise<void>;
@@ -0,0 +1 @@
1
+ export declare function getResolvedTransformersVersion(): string;
@@ -0,0 +1,29 @@
1
+ export declare const MODEL_HTTP_ALLOW_INTERNAL_HOSTS_ENV = "TYPECLAW_MODEL_HTTP_ALLOW_INTERNAL_HOSTS";
2
+ export declare const MODEL_HTTP_ALLOW_INTERNAL_CIDRS_ENV = "TYPECLAW_MODEL_HTTP_ALLOW_INTERNAL_CIDRS";
3
+ export declare const MAX_MODEL_HTTP_POLICY_ENTRIES = 64;
4
+ type ParsedAddress = {
5
+ readonly family: 4 | 6;
6
+ readonly value: bigint;
7
+ readonly bits: 32 | 128;
8
+ };
9
+ type ParsedCidr = ParsedAddress & {
10
+ readonly prefix: number;
11
+ };
12
+ export type InternalDestinationPolicy = {
13
+ readonly hostnames: readonly string[];
14
+ readonly cidrs: readonly ParsedCidr[];
15
+ };
16
+ export type InternalDestinationPolicyInput = {
17
+ allowInternalHosts?: readonly string[];
18
+ allowInternalCidrs?: readonly string[];
19
+ };
20
+ export declare function createInternalDestinationPolicy(input: InternalDestinationPolicyInput): InternalDestinationPolicy;
21
+ export declare function buildInternalDestinationPolicyFromEnv(env: Readonly<Record<string, string | undefined>>): InternalDestinationPolicy;
22
+ export declare function getBootInternalDestinationPolicy(): InternalDestinationPolicy;
23
+ export declare function normalizeExactHostname(value: string): string | undefined;
24
+ export declare function normalizeIpCidr(value: string): string | undefined;
25
+ export declare function hostnameMatchesPolicy(hostname: string, policy: InternalDestinationPolicy): boolean;
26
+ export declare function addressMatchesPolicy(address: string, policy: InternalDestinationPolicy): boolean;
27
+ export declare function extractEmbeddedIpv4Address(address: string): string | undefined;
28
+ export declare function extractRfc6052Ipv4Addresses(address: string): readonly string[];
29
+ export {};
@@ -0,0 +1,35 @@
1
+ export type BuiltinSearchBin = 'rg' | 'fd';
2
+ export type OperationalIncidentFact = {
3
+ kind: 'bash-command-not-found';
4
+ bin: string;
5
+ } | {
6
+ kind: 'declared-skill-bin-unresolved';
7
+ bin: string;
8
+ } | {
9
+ kind: 'sandbox-proc-unavailable';
10
+ } | {
11
+ kind: 'builtin-search-bin-unavailable';
12
+ bin: BuiltinSearchBin;
13
+ };
14
+ export type OperationalIncidentResolutionSignal = 'successful-bin' | 'successful-sandbox-real-proc' | 'successful-builtin-search-tool';
15
+ export type OperationalIncidentSuccessInput = {
16
+ tool: string;
17
+ args: Record<string, unknown>;
18
+ sandboxedRealProcSucceeded: boolean;
19
+ };
20
+ export declare const OPERATIONAL_INCIDENT_RESOLUTION_SIGNAL_BY_KIND: {
21
+ readonly 'bash-command-not-found': "successful-bin";
22
+ readonly 'declared-skill-bin-unresolved': "successful-bin";
23
+ readonly 'sandbox-proc-unavailable': "successful-sandbox-real-proc";
24
+ readonly 'builtin-search-bin-unavailable': "successful-builtin-search-tool";
25
+ };
26
+ export declare class DeclaredSkillBinUnresolvedError extends Error {
27
+ readonly bin: string;
28
+ readonly name = "DeclaredSkillBinUnresolvedError";
29
+ constructor(bin: string);
30
+ }
31
+ export declare function classifyToolOutcome(input: {
32
+ tool: string;
33
+ error: unknown;
34
+ }): OperationalIncidentFact | null;
35
+ export declare function deriveOperationalIncidentFactsForSuccess(input: OperationalIncidentSuccessInput): OperationalIncidentFact[];
@@ -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>;