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,145 @@
1
+ import { type PortForward } from "../config/index.js";
2
+ import { type GitIdentity } from "../git/resolve-identity.js";
3
+ import { commitSystemFile as commitSystemFileShared } from "../git/system-commit.js";
4
+ import { type AutoUpgradeOutcome } from "../init/auto-upgrade.js";
5
+ import { type EnsureDepsResult } from "../init/ensure-deps.js";
6
+ import { type UpdateRunner } from "../init/run-bun-install.js";
7
+ import { type RunBunLink } from "../init/windows-dev-link.js";
8
+ import { type GithubCliProvisionResult, type ProvisionGithubCliStoreOptions } from "../secrets/provision-github-cli-store.js";
9
+ import { type AgentOperationLease, type WithAgentOperationLock } from "./agent-operation-lock.js";
10
+ import { acquireManagedBuildCache } from "./build-cache.js";
11
+ import { type DockerLogArchiver } from "./log-archive.js";
12
+ import { type DockerExec } from "./shared.js";
13
+ import { type VerifyRunningFn } from "./verify-running.js";
14
+ export declare function resolveHostFontMounts({ platform, home, exists, }: {
15
+ platform: NodeJS.Platform;
16
+ home: string;
17
+ exists?: (path: string) => boolean;
18
+ }): Array<{
19
+ src: string;
20
+ dst: string;
21
+ readonly: true;
22
+ }>;
23
+ export type StartPlan = {
24
+ containerName: string;
25
+ imageTag: string;
26
+ buildContext: string;
27
+ dockerfile: string;
28
+ runArgs: string[];
29
+ needsBuild: boolean;
30
+ hostPort: number;
31
+ tuiToken: string | null;
32
+ memoryLimitBytes: number;
33
+ mountWarnings: string[];
34
+ };
35
+ export type PlanStartOptions = {
36
+ cwd: string;
37
+ hostPort: number;
38
+ imageExists: boolean;
39
+ forceBuild?: boolean;
40
+ hostdControl?: HostDaemonControl;
41
+ publishHost?: string;
42
+ tuiToken?: string | null;
43
+ platform?: NodeJS.Platform;
44
+ hostIdentity?: {
45
+ uid: number;
46
+ gid: number;
47
+ } | null;
48
+ gitIdentity?: GitIdentity | null;
49
+ totalMemoryBytes?: number | undefined;
50
+ hostHome?: string;
51
+ };
52
+ export type HostDaemonControl = {
53
+ url: string;
54
+ token: string;
55
+ brokerToken: string;
56
+ };
57
+ export type HostDaemonRegisterPayload = {
58
+ containerName: string;
59
+ cwd: string;
60
+ restartToken: string;
61
+ wsHostPort: number;
62
+ portForward: PortForward;
63
+ brokerToken: string;
64
+ };
65
+ export type CurrentHostDaemon = {
66
+ httpPort: number;
67
+ register: (payload: HostDaemonRegisterPayload) => Promise<{
68
+ ok: true;
69
+ } | {
70
+ ok: false;
71
+ reason: string;
72
+ }>;
73
+ deregister: (containerName: string) => Promise<void>;
74
+ };
75
+ export type StartOptions = {
76
+ cwd: string;
77
+ preferredHostPort: number;
78
+ forceBuild?: boolean;
79
+ streamOutput?: boolean;
80
+ onWarning?: (warning: string) => void;
81
+ skipMemoryOversubscriptionCheck?: boolean;
82
+ exec?: DockerExec;
83
+ allocatePort?: (preferred: number) => Promise<number>;
84
+ cliEntry?: string;
85
+ reuseCurrentHostDaemon?: boolean;
86
+ currentHostDaemon?: CurrentHostDaemon;
87
+ ensureDeps?: (cwd: string, opts?: {
88
+ force?: boolean;
89
+ }) => Promise<EnsureDepsResult>;
90
+ ensureModels?: () => Promise<void>;
91
+ autoUpgrade?: (cwd: string) => Promise<AutoUpgradeOutcome>;
92
+ forceBunUpdate?: UpdateRunner;
93
+ readInstalledVersion?: (cwd: string) => string | null;
94
+ verifyRunning?: VerifyRunningFn;
95
+ runBunLink?: RunBunLink;
96
+ platform?: NodeJS.Platform;
97
+ hostIdentity?: {
98
+ uid: number;
99
+ gid: number;
100
+ } | null;
101
+ assertConfigWritable?: (cwd: string) => void;
102
+ provisionGithubCliStore?: (options: ProvisionGithubCliStoreOptions) => GithubCliProvisionResult | Promise<GithubCliProvisionResult>;
103
+ archiveLogs?: DockerLogArchiver;
104
+ operationLock?: WithAgentOperationLock;
105
+ operationLease?: AgentOperationLease;
106
+ buildCacheStateDir?: string;
107
+ acquireBuildCache?: typeof acquireManagedBuildCache | null;
108
+ };
109
+ export type HostDaemonStatus = {
110
+ state: 'registered';
111
+ } | {
112
+ state: 'unavailable';
113
+ reason: string;
114
+ } | {
115
+ state: 'disabled';
116
+ };
117
+ export type StartResult = {
118
+ ok: true;
119
+ plan: StartPlan;
120
+ containerId: string;
121
+ built: boolean;
122
+ hostPort: number;
123
+ tuiToken: string | null;
124
+ hostd: HostDaemonStatus;
125
+ alreadyRunning: boolean;
126
+ autoUpgrade: AutoUpgradeOutcome;
127
+ skippedPlugins: string[];
128
+ dockerfileWarnings: string[];
129
+ } | {
130
+ ok: false;
131
+ reason: string;
132
+ };
133
+ export declare function start(options: StartOptions): Promise<StartResult>;
134
+ export declare function planStart({ cwd, hostPort, imageExists, forceBuild, hostdControl, publishHost, tuiToken, platform, hostIdentity, gitIdentity, totalMemoryBytes, hostHome, }: PlanStartOptions): Promise<StartPlan>;
135
+ export declare function refreshDockerfile(cwd: string, opts?: {
136
+ buildKit?: boolean;
137
+ }): Promise<{
138
+ changed: boolean;
139
+ warnings: string[];
140
+ }>;
141
+ export declare function refreshGitignore(cwd: string): Promise<void>;
142
+ export declare const commitSystemFile: typeof commitSystemFileShared;
143
+ export declare function isPathInsideOrEqual(child: string, parent: string): boolean;
144
+ export declare function shouldMirrorDevSource(devSourcePath: string | null, cwd: string, platform?: NodeJS.Platform): devSourcePath is string;
145
+ export declare function shouldMountWindowsDevSource(devSourcePath: string | null, cwd: string, platform?: NodeJS.Platform): devSourcePath is string;
@@ -0,0 +1,31 @@
1
+ import { type DockerExec } from "./shared.js";
2
+ export type ContainerStats = {
3
+ kind: 'missing';
4
+ containerName: string;
5
+ imageTag: string;
6
+ } | {
7
+ kind: 'stopped';
8
+ containerName: string;
9
+ imageTag: string;
10
+ } | {
11
+ kind: 'running';
12
+ containerName: string;
13
+ imageTag: string;
14
+ startedAt: string | null;
15
+ cpuPercent: string;
16
+ memUsage: string;
17
+ memPercent: string;
18
+ pids: string;
19
+ };
20
+ export type StatsOptions = {
21
+ cwd: string;
22
+ exec?: DockerExec;
23
+ };
24
+ export declare function stats({ cwd, exec }: StatsOptions): Promise<ContainerStats>;
25
+ export type StatsSnapshot = {
26
+ cpuPercent: string;
27
+ memUsage: string;
28
+ memPercent: string;
29
+ pids: string;
30
+ };
31
+ export declare function parseStatsLine(stdout: string): StatsSnapshot | null;
@@ -0,0 +1,25 @@
1
+ import { type DockerExec } from "./shared.js";
2
+ export type ContainerStatus = {
3
+ kind: 'missing';
4
+ containerName: string;
5
+ imageTag: string;
6
+ } | {
7
+ kind: 'stopped';
8
+ containerName: string;
9
+ imageTag: string;
10
+ containerId: string;
11
+ configuredImage: string;
12
+ } | {
13
+ kind: 'running';
14
+ containerName: string;
15
+ imageTag: string;
16
+ containerId: string;
17
+ configuredImage: string;
18
+ hostPort: number | null;
19
+ hostBindAddr: string | null;
20
+ };
21
+ export type StatusOptions = {
22
+ cwd: string;
23
+ exec?: DockerExec;
24
+ };
25
+ export declare function status({ cwd, exec }: StatusOptions): Promise<ContainerStatus>;
@@ -0,0 +1,24 @@
1
+ import { type AgentOperationLease, type WithAgentOperationLock } from "./agent-operation-lock.js";
2
+ import { type DockerLogArchiver } from "./log-archive.js";
3
+ import { type DockerExec } from "./shared.js";
4
+ export type StopPlan = {
5
+ containerName: string;
6
+ };
7
+ export type StopResult = {
8
+ ok: true;
9
+ containerName: string;
10
+ running: boolean;
11
+ } | {
12
+ ok: false;
13
+ reason: string;
14
+ };
15
+ export type StopOptions = {
16
+ cwd: string;
17
+ exec?: DockerExec;
18
+ archiveLogs?: DockerLogArchiver;
19
+ operationLock?: WithAgentOperationLock;
20
+ operationLease?: AgentOperationLease;
21
+ onWarning?: (warning: string) => void;
22
+ };
23
+ export declare function stop(options: StopOptions): Promise<StopResult>;
24
+ export declare function planStop(cwd: string): StopPlan;
@@ -0,0 +1,4 @@
1
+ declare const OOM_SCORE_ADJ = 600;
2
+ export declare function withToolOomPriorityCommand(command: string, scorePath?: string): string;
3
+ export declare function withToolOomPriorityArgv(command: string[], scorePath?: string): string[];
4
+ export { OOM_SCORE_ADJ };
@@ -0,0 +1,49 @@
1
+ import type { DockerExec } from "./shared.js";
2
+ export type ContainerLifeStatus = 'running' | 'created' | 'restarting' | 'paused' | 'exited' | 'dead' | 'removing';
3
+ export type ContainerProbeResult = {
4
+ kind: 'missing';
5
+ } | {
6
+ kind: 'status';
7
+ status: ContainerLifeStatus;
8
+ } | {
9
+ kind: 'daemon-error';
10
+ detail: string;
11
+ };
12
+ export type CrashLogs = {
13
+ ok: true;
14
+ text: string;
15
+ } | {
16
+ ok: false;
17
+ error: string;
18
+ };
19
+ export type VerifyRunningResult = {
20
+ ok: true;
21
+ } | {
22
+ ok: false;
23
+ mode: 'removed';
24
+ logs: CrashLogs;
25
+ } | {
26
+ ok: false;
27
+ mode: 'exited';
28
+ status: ContainerLifeStatus;
29
+ logs: CrashLogs;
30
+ } | {
31
+ ok: false;
32
+ mode: 'daemon-error';
33
+ detail: string;
34
+ };
35
+ export type VerifyRunningFn = (containerName: string) => Promise<VerifyRunningResult>;
36
+ export type VerifyRunningOptions = {
37
+ exec: DockerExec;
38
+ timeoutMs?: number;
39
+ intervalMs?: number;
40
+ logsTimeoutMs?: number;
41
+ now?: () => number;
42
+ sleep?: (ms: number) => Promise<void>;
43
+ };
44
+ export declare function createVerifyRunning(options: VerifyRunningOptions): VerifyRunningFn;
45
+ export declare function probeContainer(exec: DockerExec, name: string): Promise<ContainerProbeResult>;
46
+ export declare function describeUnremovableContainer(exec: DockerExec, containerRef: string): Promise<string | null>;
47
+ export declare function buildCrashReason(name: string, failure: Extract<VerifyRunningResult, {
48
+ ok: false;
49
+ }>): string;
@@ -0,0 +1,42 @@
1
+ import type { AgentSession } from "../agent/index.js";
2
+ import type { SessionOrigin } from "../agent/session-origin.js";
3
+ import type { ModelRef } from "../config/providers.js";
4
+ import type { HookBus } from "../plugin/index.js";
5
+ import type { Stream } from "../stream/index.js";
6
+ import type { CronJob, HandlerJob, PromptJob } from "./schema.js";
7
+ export type CronHandlerInvoker = (job: HandlerJob) => Promise<void>;
8
+ export type CronSession = {
9
+ prompt: (text: string) => Promise<void>;
10
+ dispose?: () => void;
11
+ hooks?: HookBus;
12
+ sessionId?: string;
13
+ agentDir?: string;
14
+ getTranscriptPath?: () => string | undefined;
15
+ origin?: SessionOrigin;
16
+ session?: AgentSession;
17
+ };
18
+ export type CronConsumerLogger = {
19
+ info: (msg: string) => void;
20
+ warn: (msg: string) => void;
21
+ error: (msg: string) => void;
22
+ };
23
+ export type CreateCronConsumerOptions = {
24
+ stream: Stream;
25
+ cwd: string;
26
+ createSessionForCron: (job: PromptJob, refOverride?: ModelRef) => Promise<CronSession>;
27
+ invokeHandler?: CronHandlerInvoker;
28
+ countStore?: ConsumerCountStore;
29
+ now?: () => number;
30
+ intervalNow?: () => number;
31
+ logger?: CronConsumerLogger;
32
+ };
33
+ export type ConsumerCountStore = {
34
+ get: (id: string, job: CronJob) => number;
35
+ increment: (id: string, job: CronJob, at: number) => Promise<boolean>;
36
+ };
37
+ export type CronConsumer = {
38
+ start: () => void;
39
+ stop: () => void;
40
+ inFlightCount: () => number;
41
+ };
42
+ export declare function createCronConsumer({ stream, cwd, createSessionForCron, invokeHandler, countStore, now, intervalNow, logger, }: CreateCronConsumerOptions): CronConsumer;
@@ -0,0 +1,24 @@
1
+ import type { CronJob } from "./schema.js";
2
+ export declare const CRON_STATE_FILE: string;
3
+ type StateEntry = {
4
+ progressFingerprint: string;
5
+ firedCount: number;
6
+ lastAcceptedAt: string;
7
+ };
8
+ type StateFile = {
9
+ version: 1;
10
+ jobs: Record<string, StateEntry>;
11
+ };
12
+ export type CountStore = {
13
+ get: (id: string, job: CronJob) => number;
14
+ increment: (id: string, job: CronJob, at: number) => Promise<boolean>;
15
+ reconcile: (jobs: CronJob[]) => Promise<void>;
16
+ };
17
+ export type CountStoreIO = {
18
+ read: (path: string) => Promise<string | null>;
19
+ write: (path: string, data: string) => Promise<void>;
20
+ };
21
+ export declare function progressFingerprint(job: CronJob): string;
22
+ export declare function createCountStore(agentDir: string, jobs: CronJob[], io?: CountStoreIO): Promise<CountStore>;
23
+ export declare function reconcile(state: StateFile, jobs: CronJob[]): StateFile;
24
+ export {};
@@ -0,0 +1,21 @@
1
+ import type { SubagentRegistry } from "../agent/subagents.js";
2
+ import { type CronFile, type CronParseWarning, type ParseCronMode } from "./schema.js";
3
+ export { type CountStore, createCountStore } from "./count-state.js";
4
+ export { createCronReloadable } from "./reloadable.js";
5
+ export { createCronConsumer, type CronConsumer } from "./consumer.js";
6
+ export { computeNextFire, createScheduler, type JobDiff, type Scheduler } from "./scheduler.js";
7
+ export { aggregateCronList, type CronListEntry, type CronListSource } from "./list.js";
8
+ export { cronFileSchema, cronJobSchema, type CronFile, type CronJob, type CronParseWarning, type ExecJob, type HandlerJob, parseCronJson, type ParseCronMode, type ParseCronResult, type ParsedCronJob, type PromptJob, validateCronEdit, } from "./schema.js";
9
+ export type LoadCronResult = {
10
+ ok: true;
11
+ file: CronFile | null;
12
+ warnings?: CronParseWarning[];
13
+ } | {
14
+ ok: false;
15
+ reason: string;
16
+ };
17
+ export type LoadCronOptions = {
18
+ subagents?: SubagentRegistry;
19
+ mode?: ParseCronMode;
20
+ };
21
+ export declare function loadCron(agentDir: string, options?: LoadCronOptions): Promise<LoadCronResult>;
@@ -0,0 +1,33 @@
1
+ import type { RegisteredCronJob } from "../plugin/index.js";
2
+ import type { CronJob } from "./schema.js";
3
+ export type CronListSource = {
4
+ kind: 'user';
5
+ } | {
6
+ kind: 'plugin';
7
+ pluginName: string;
8
+ localId: string;
9
+ };
10
+ export type CronListEntry = {
11
+ id: string;
12
+ source: CronListSource;
13
+ kind: 'prompt' | 'exec' | 'handler';
14
+ schedule: string | undefined;
15
+ at: string | undefined;
16
+ until: string | undefined;
17
+ count: number | undefined;
18
+ timezone: string | undefined;
19
+ enabled: boolean;
20
+ scheduledByRole: string | undefined;
21
+ nextFireMs: number | null;
22
+ scheduleError: string | undefined;
23
+ prompt: string | undefined;
24
+ subagent: string | undefined;
25
+ command: readonly string[] | undefined;
26
+ };
27
+ export type AggregateCronListOptions = {
28
+ userJobs: readonly CronJob[];
29
+ pluginJobs: readonly RegisteredCronJob[];
30
+ now: number;
31
+ firedCount?: (job: CronJob) => number;
32
+ };
33
+ export declare function aggregateCronList(opts: AggregateCronListOptions): CronListEntry[];
@@ -0,0 +1,11 @@
1
+ import type { SubagentRegistry } from "../agent/subagents.js";
2
+ import type { Reloadable } from "../reload/index.js";
3
+ import type { Scheduler } from "./scheduler.js";
4
+ import type { CronJob } from "./schema.js";
5
+ export type CreateCronReloadableOptions = {
6
+ cwd: string;
7
+ scheduler: Scheduler;
8
+ internalJobs?: () => CronJob[];
9
+ getSubagents?: () => SubagentRegistry;
10
+ };
11
+ export declare function createCronReloadable({ cwd, scheduler, internalJobs, getSubagents, }: CreateCronReloadableOptions): Reloadable;
@@ -0,0 +1,51 @@
1
+ import type { CronJob } from "./schema.js";
2
+ export type SchedulerClock = {
3
+ now: () => number;
4
+ setTimeout: (cb: () => void, ms: number) => number;
5
+ clearTimeout: (handle: number) => void;
6
+ };
7
+ export type SchedulerLogger = {
8
+ info: (msg: string) => void;
9
+ warn: (msg: string) => void;
10
+ error: (msg: string) => void;
11
+ };
12
+ export type SchedulerCountStore = {
13
+ get: (id: string, job: CronJob) => number;
14
+ reconcile: (jobs: CronJob[]) => Promise<void>;
15
+ };
16
+ export type CreateSchedulerOptions = {
17
+ jobs: CronJob[];
18
+ onFire: (job: CronJob) => void;
19
+ clock?: SchedulerClock;
20
+ logger?: SchedulerLogger;
21
+ countStore?: SchedulerCountStore;
22
+ };
23
+ export type JobDiff = {
24
+ added: CronJob[];
25
+ removed: CronJob[];
26
+ updated: CronJob[];
27
+ unchanged: CronJob[];
28
+ };
29
+ export type Scheduler = {
30
+ start: () => void;
31
+ stop: () => void;
32
+ replaceJobs: (jobs: CronJob[]) => JobDiff;
33
+ currentJobs: () => readonly CronJob[];
34
+ };
35
+ export declare function createScheduler({ jobs, onFire, clock, logger, countStore, }: CreateSchedulerOptions): Scheduler;
36
+ export type ComputeNextFireResult = {
37
+ ok: true;
38
+ nextFire: number;
39
+ } | {
40
+ ok: false;
41
+ expired: true;
42
+ reason: string;
43
+ } | {
44
+ ok: false;
45
+ expired: false;
46
+ reason: string;
47
+ };
48
+ export type ComputeNextFireOptions = {
49
+ firedCount?: number;
50
+ };
51
+ export declare function computeNextFire(job: CronJob, now: number, options?: ComputeNextFireOptions): ComputeNextFireResult;
@@ -0,0 +1,108 @@
1
+ import { z } from 'zod';
2
+ import type { SubagentRegistry } from "../agent/subagents.js";
3
+ import type { CronHandlerContext } from "../plugin/types.js";
4
+ declare const baseJob: z.ZodObject<{
5
+ id: z.ZodString;
6
+ schedule: z.ZodOptional<z.ZodString>;
7
+ at: z.ZodOptional<z.ZodString>;
8
+ until: z.ZodOptional<z.ZodString>;
9
+ count: z.ZodOptional<z.ZodNumber>;
10
+ enabled: z.ZodDefault<z.ZodBoolean>;
11
+ timezone: z.ZodOptional<z.ZodString>;
12
+ scheduledByRole: z.ZodOptional<z.ZodString>;
13
+ scheduledByOrigin: z.ZodOptional<z.ZodUnknown>;
14
+ }, z.core.$strip>;
15
+ export declare const cronJobSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
16
+ id: z.ZodString;
17
+ schedule: z.ZodOptional<z.ZodString>;
18
+ at: z.ZodOptional<z.ZodString>;
19
+ until: z.ZodOptional<z.ZodString>;
20
+ count: z.ZodOptional<z.ZodNumber>;
21
+ enabled: z.ZodDefault<z.ZodBoolean>;
22
+ timezone: z.ZodOptional<z.ZodString>;
23
+ scheduledByRole: z.ZodOptional<z.ZodString>;
24
+ scheduledByOrigin: z.ZodOptional<z.ZodUnknown>;
25
+ kind: z.ZodLiteral<"prompt">;
26
+ prompt: z.ZodString;
27
+ subagent: z.ZodOptional<z.ZodString>;
28
+ payload: z.ZodOptional<z.ZodUnknown>;
29
+ }, z.core.$strip>, z.ZodObject<{
30
+ id: z.ZodString;
31
+ schedule: z.ZodOptional<z.ZodString>;
32
+ at: z.ZodOptional<z.ZodString>;
33
+ until: z.ZodOptional<z.ZodString>;
34
+ count: z.ZodOptional<z.ZodNumber>;
35
+ enabled: z.ZodDefault<z.ZodBoolean>;
36
+ timezone: z.ZodOptional<z.ZodString>;
37
+ scheduledByRole: z.ZodOptional<z.ZodString>;
38
+ scheduledByOrigin: z.ZodOptional<z.ZodUnknown>;
39
+ kind: z.ZodLiteral<"exec">;
40
+ command: z.ZodArray<z.ZodString>;
41
+ }, z.core.$strip>], "kind">;
42
+ export declare const cronFileSchema: z.ZodObject<{
43
+ $schema: z.ZodOptional<z.ZodString>;
44
+ jobs: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
45
+ id: z.ZodString;
46
+ schedule: z.ZodOptional<z.ZodString>;
47
+ at: z.ZodOptional<z.ZodString>;
48
+ until: z.ZodOptional<z.ZodString>;
49
+ count: z.ZodOptional<z.ZodNumber>;
50
+ enabled: z.ZodDefault<z.ZodBoolean>;
51
+ timezone: z.ZodOptional<z.ZodString>;
52
+ scheduledByRole: z.ZodOptional<z.ZodString>;
53
+ scheduledByOrigin: z.ZodOptional<z.ZodUnknown>;
54
+ kind: z.ZodLiteral<"prompt">;
55
+ prompt: z.ZodString;
56
+ subagent: z.ZodOptional<z.ZodString>;
57
+ payload: z.ZodOptional<z.ZodUnknown>;
58
+ }, z.core.$strip>, z.ZodObject<{
59
+ id: z.ZodString;
60
+ schedule: z.ZodOptional<z.ZodString>;
61
+ at: z.ZodOptional<z.ZodString>;
62
+ until: z.ZodOptional<z.ZodString>;
63
+ count: z.ZodOptional<z.ZodNumber>;
64
+ enabled: z.ZodDefault<z.ZodBoolean>;
65
+ timezone: z.ZodOptional<z.ZodString>;
66
+ scheduledByRole: z.ZodOptional<z.ZodString>;
67
+ scheduledByOrigin: z.ZodOptional<z.ZodUnknown>;
68
+ kind: z.ZodLiteral<"exec">;
69
+ command: z.ZodArray<z.ZodString>;
70
+ }, z.core.$strip>], "kind">>>;
71
+ }, z.core.$strip>;
72
+ export type ParsedCronJob = z.infer<typeof cronJobSchema>;
73
+ export type PromptJob = Extract<ParsedCronJob, {
74
+ kind: 'prompt';
75
+ }>;
76
+ export type ExecJob = Extract<ParsedCronJob, {
77
+ kind: 'exec';
78
+ }>;
79
+ export type HandlerJob = z.infer<typeof baseJob> & {
80
+ kind: 'handler';
81
+ handler: (ctx: CronHandlerContext) => Promise<void>;
82
+ };
83
+ export type CronJob = ParsedCronJob | HandlerJob;
84
+ export type CronFile = z.infer<typeof cronFileSchema>;
85
+ export type CronParseWarning = {
86
+ jobId?: string;
87
+ index: number;
88
+ reason: string;
89
+ };
90
+ export type ParseCronResult = {
91
+ ok: true;
92
+ file: CronFile;
93
+ warnings?: CronParseWarning[];
94
+ } | {
95
+ ok: false;
96
+ reason: string;
97
+ };
98
+ export type ParseCronMode = 'edit' | 'load' | 'boot';
99
+ export type ParseCronOptions = {
100
+ subagents?: SubagentRegistry;
101
+ now?: number;
102
+ mode?: ParseCronMode;
103
+ };
104
+ export type ParseCronJsonOptions = ParseCronOptions;
105
+ export declare function parseCronJson(raw: string, options?: ParseCronJsonOptions): ParseCronResult;
106
+ export declare function validateCronEdit(proposedRaw: string, existingRaw: string | undefined, options?: ParseCronOptions): ParseCronResult;
107
+ export declare function parseCronFile(raw: unknown, options?: ParseCronOptions): ParseCronResult;
108
+ export {};
@@ -0,0 +1,28 @@
1
+ export declare const TRUSTED_BASELINE_BIN_DIRS: readonly ["/usr/local/bin", "/usr/bin", "/bin"];
2
+ export declare const DEPENDENCY_BIN_DENYLIST: ReadonlySet<string>;
3
+ export type DependencyBinDeclaration = {
4
+ package: string;
5
+ bin: string;
6
+ entry: string;
7
+ workspace?: boolean;
8
+ };
9
+ export type ResolvedDependencyBin = {
10
+ kind: 'baseline';
11
+ declaration: DependencyBinDeclaration;
12
+ executable: string;
13
+ } | {
14
+ kind: 'package';
15
+ declaration: DependencyBinDeclaration;
16
+ entrypoint: string;
17
+ containerEntrypoint: string;
18
+ } | {
19
+ kind: 'unavailable';
20
+ declaration: DependencyBinDeclaration;
21
+ reason: string;
22
+ } | {
23
+ kind: 'denied';
24
+ declaration: DependencyBinDeclaration;
25
+ reason: string;
26
+ };
27
+ export declare function resolveDependencyBin(agentDir: string, declaration: DependencyBinDeclaration, baselineDirs?: readonly string[], deniedBins?: ReadonlySet<string>): Promise<ResolvedDependencyBin>;
28
+ export declare function resolveDependencyBins(agentDir: string, declarations: readonly DependencyBinDeclaration[], baselineDirs?: readonly string[], deniedBins?: ReadonlySet<string>): Promise<ResolvedDependencyBin[]>;
@@ -0,0 +1,22 @@
1
+ import type { PluginLogger, PluginRegistry } from "../plugin/index.js";
2
+ import { type DependencyBinDeclaration, type ResolvedDependencyBin } from "./bin-resolver.js";
3
+ export { DEPENDENCY_BIN_DENYLIST } from "./bin-resolver.js";
4
+ export type DependencyBinIssue = {
5
+ package?: string;
6
+ message: string;
7
+ };
8
+ export type DependencyBinDiscovery = {
9
+ declarations: DependencyBinDeclaration[];
10
+ issues: DependencyBinIssue[];
11
+ protectedFiles: string[];
12
+ };
13
+ export type DependencyBinValidation = DependencyBinDiscovery & {
14
+ resolutions: ResolvedDependencyBin[];
15
+ unavailable: Extract<ResolvedDependencyBin, {
16
+ kind: 'unavailable';
17
+ }>[];
18
+ };
19
+ export declare function discoverDependencyBins(agentDir: string): Promise<DependencyBinDiscovery>;
20
+ export declare function validateDependencyBins(agentDir: string, baselineDirs?: readonly string[]): Promise<DependencyBinValidation>;
21
+ export declare function registerDependencyBinDoctorCheck(registry: PluginRegistry, agentDir: string, logger: PluginLogger): void;
22
+ export declare function logDependencyBinProblems(validation: DependencyBinValidation, logger: PluginLogger): void;
@@ -0,0 +1,2 @@
1
+ export { discoverDependencyBins, logDependencyBinProblems, registerDependencyBinDoctorCheck, validateDependencyBins, type DependencyBinDiscovery, type DependencyBinIssue, type DependencyBinValidation, } from "./bins.js";
2
+ export { DEPENDENCY_BIN_DENYLIST, resolveDependencyBin, resolveDependencyBins, TRUSTED_BASELINE_BIN_DIRS, type DependencyBinDeclaration, type ResolvedDependencyBin, } from "./bin-resolver.js";
@@ -0,0 +1,26 @@
1
+ import { CellOutput, type HostFrame, type KernelFrame } from "./protocol.js";
2
+ export type EvalDispatch = (request: {
3
+ readonly name: string;
4
+ readonly args: Extract<KernelFrame, {
5
+ type: 'tool-call';
6
+ }>['args'];
7
+ readonly callId: string;
8
+ }, signal: AbortSignal) => Promise<unknown>;
9
+ export declare class EvalCell {
10
+ private readonly dispatch;
11
+ private readonly signal;
12
+ readonly id: `${string}-${string}-${string}-${string}-${string}`;
13
+ readonly output: CellOutput;
14
+ readonly completed: {
15
+ promise: Promise<void>;
16
+ resolve: (value?: void | PromiseLike<void> | undefined) => void;
17
+ reject: (reason?: any) => void;
18
+ };
19
+ private readonly ids;
20
+ private readonly pending;
21
+ private finished;
22
+ constructor(dispatch: EvalDispatch, signal: AbortSignal);
23
+ receive(frame: KernelFrame, send: (frame: HostFrame) => void): void;
24
+ private assertActive;
25
+ private invoke;
26
+ }