typeclaw 0.49.0 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (442) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +9 -2
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/require-parallel.ts +5 -32
  317. package/src/agent/guard-types.ts +3 -0
  318. package/src/agent/guards.ts +4 -0
  319. package/src/agent/idle-compaction.ts +174 -0
  320. package/src/agent/index.ts +74 -16
  321. package/src/agent/live-subagents.ts +19 -0
  322. package/src/agent/multimodal/look-at.ts +22 -9
  323. package/src/agent/plugin-tools.ts +13 -1
  324. package/src/agent/reviewer-bash-policy.ts +41 -1
  325. package/src/agent/session-origin.ts +26 -10
  326. package/src/agent/subagent-cache-keepalive.ts +198 -0
  327. package/src/agent/subagent-session.ts +6 -0
  328. package/src/agent/subagents.ts +46 -8
  329. package/src/agent/system-prompt.ts +1 -1
  330. package/src/agent/tool-file-safety.ts +6 -1
  331. package/src/agent/tools/channel-edit.ts +20 -10
  332. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  333. package/src/agent/tools/channel-handoff.ts +72 -0
  334. package/src/agent/tools/channel-read.ts +57 -10
  335. package/src/agent/tools/channel-reply.ts +33 -26
  336. package/src/agent/tools/channel-send.ts +21 -13
  337. package/src/agent/tools/channel-session-search.ts +35 -0
  338. package/src/agent/tools/curl-impersonate.ts +11 -4
  339. package/src/agent/tools/ddg.ts +13 -5
  340. package/src/agent/tools/spawn-subagent.ts +27 -11
  341. package/src/agent/tools/stream-snapshot.ts +15 -2
  342. package/src/agent/tools/subagent-access.ts +11 -4
  343. package/src/browser/bsk-shim.mjs +74 -0
  344. package/src/browser/dockerfile.ts +84 -0
  345. package/src/browser/egress.ts +104 -0
  346. package/src/browser/managed-browser.ts +205 -0
  347. package/src/browser/registry.ts +110 -0
  348. package/src/browser/relay.ts +231 -0
  349. package/src/browser/sandbox-entry.ts +167 -0
  350. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  351. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  352. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  353. package/src/bundled-plugins/doc-render/index.ts +0 -10
  354. package/src/bundled-plugins/doc-render/render.ts +83 -111
  355. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  356. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  357. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  358. package/src/bundled-plugins/github-cli-auth/index.ts +75 -59
  359. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  360. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  361. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  362. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  363. package/src/bundled-plugins/operator/operator.ts +1 -1
  364. package/src/bundled-plugins/qa/index.ts +11 -0
  365. package/src/bundled-plugins/qa/qa.ts +160 -0
  366. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  367. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  368. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  369. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  370. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  371. package/src/bundled-plugins/security/index.ts +53 -34
  372. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  373. package/src/channels/adapter-namespace.ts +13 -0
  374. package/src/channels/adapters/discord-bot.ts +97 -5
  375. package/src/channels/adapters/github/index.ts +16 -0
  376. package/src/channels/adapters/github/last-alive.ts +4 -16
  377. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  378. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  379. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  380. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  381. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  382. package/src/channels/adapters/slack-bot.ts +299 -67
  383. package/src/channels/adapters/slack-classify.ts +1 -0
  384. package/src/channels/catch-up.ts +137 -0
  385. package/src/channels/continuation-willingness.ts +2 -2
  386. package/src/channels/continuity-types.ts +1 -0
  387. package/src/channels/engagement.ts +17 -1
  388. package/src/channels/github-false-receipt.ts +3 -3
  389. package/src/channels/github-rereview-guard.ts +9 -5
  390. package/src/channels/github-token-bridge.ts +24 -0
  391. package/src/channels/last-alive.ts +34 -0
  392. package/src/channels/manager.ts +8 -1
  393. package/src/channels/router.ts +427 -136
  394. package/src/channels/session-handoff.fixture.ts +144 -0
  395. package/src/channels/session-handoff.ts +175 -0
  396. package/src/channels/session-search.ts +71 -0
  397. package/src/channels/types.ts +12 -2
  398. package/src/cli/channel.ts +2 -3
  399. package/src/cli/init.ts +2 -3
  400. package/src/cli/model.ts +132 -3
  401. package/src/coding-agent/index.ts +7 -1
  402. package/src/coding-agent/omo-stream.ts +40 -0
  403. package/src/coding-agent/runner.ts +30 -8
  404. package/src/config/config.ts +111 -22
  405. package/src/config/model-overrides.ts +59 -0
  406. package/src/config/models-mutation.ts +185 -2
  407. package/src/config/providers-mutation.ts +12 -4
  408. package/src/config/providers.ts +59 -0
  409. package/src/container/start.ts +95 -4
  410. package/src/doctor/checks.ts +8 -6
  411. package/src/hostd/daemon.ts +13 -1
  412. package/src/init/auto-upgrade.ts +7 -1
  413. package/src/init/dockerfile.ts +57 -12
  414. package/src/init/index.ts +4 -3
  415. package/src/init/local-source-stamp.ts +68 -0
  416. package/src/init/models-dev.ts +4 -0
  417. package/src/init/validate-api-key.ts +3 -0
  418. package/src/permissions/builtins.ts +7 -0
  419. package/src/permissions/permissions.ts +18 -9
  420. package/src/permissions/resolve.ts +7 -1
  421. package/src/plugin/context.ts +2 -0
  422. package/src/plugin/hooks.ts +137 -0
  423. package/src/plugin/index.ts +6 -0
  424. package/src/plugin/manager.ts +4 -0
  425. package/src/plugin/types.ts +60 -0
  426. package/src/run/bundled-plugins.ts +6 -0
  427. package/src/run/index.ts +24 -14
  428. package/src/run/llm-fetch-observer.ts +12 -15
  429. package/src/sandbox/canonical-secrets.ts +4 -0
  430. package/src/sandbox/dev-source.ts +26 -0
  431. package/src/sandbox/hidden-paths.ts +16 -2
  432. package/src/secrets/storage.ts +13 -0
  433. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  434. package/src/skills/typeclaw-config/SKILL.md +39 -5
  435. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  436. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  437. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  438. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  439. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  440. package/typeclaw.schema.json +436 -5
  441. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  442. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -0,0 +1,105 @@
1
+ #!/usr/bin/env bun
2
+
3
+ import { rm } from 'node:fs/promises'
4
+ import { dirname, join, relative } from 'node:path'
5
+ import { fileURLToPath } from 'node:url'
6
+
7
+ import * as ts from '@typescript/typescript6'
8
+
9
+ const root = join(dirname(fileURLToPath(import.meta.url)), '..')
10
+ const sourceRoot = join(root, 'src')
11
+ const outputRoot = join(root, 'dist', 'types')
12
+ const configPath = join(root, 'tsconfig.json')
13
+ const config = ts.readConfigFile(configPath, ts.sys.readFile)
14
+ if (config.error) throw new Error(ts.flattenDiagnosticMessageText(config.error.messageText, '\n'))
15
+ const parsed = ts.parseJsonConfigFileContent(config.config, ts.sys, root)
16
+ const options: ts.CompilerOptions = {
17
+ ...parsed.options,
18
+ noEmit: false,
19
+ noEmitOnError: true,
20
+ declaration: true,
21
+ declarationMap: false,
22
+ emitDeclarationOnly: true,
23
+ rootDir: sourceRoot,
24
+ outDir: outputRoot,
25
+ }
26
+ const program = ts.createProgram([join(sourceRoot, 'plugin', 'index.ts')], options)
27
+ const resolutionCache = ts.createModuleResolutionCache(root, (path) => path, options)
28
+
29
+ // Keep the emitted graph self-contained: consumers must not inherit our @/*
30
+ // aliases. Explicit .js specifiers also work with NodeNext declaration lookup.
31
+ const rewriteImports: ts.TransformerFactory<ts.SourceFile | ts.Bundle> = (context) => {
32
+ return (source) => {
33
+ if (ts.isBundle(source)) return source
34
+ const rewrite = (specifier: ts.StringLiteral): ts.StringLiteral => {
35
+ if (!specifier.text.startsWith('@/') && !specifier.text.startsWith('.')) return specifier
36
+ const resolved = ts.resolveModuleName(
37
+ specifier.text,
38
+ source.fileName,
39
+ options,
40
+ ts.sys,
41
+ resolutionCache,
42
+ ).resolvedModule
43
+ if (!resolved) throw new Error(`Cannot resolve SDK declaration import ${specifier.text} in ${source.fileName}`)
44
+ let path = relative(dirname(source.fileName), resolved.resolvedFileName).replaceAll('\\', '/')
45
+ path = path
46
+ .replace(/\.tsx?$/, '.js')
47
+ .replace(/\.mts$/, '.mjs')
48
+ .replace(/\.cts$/, '.cjs')
49
+ return context.factory.createStringLiteral(path.startsWith('.') ? path : `./${path}`)
50
+ }
51
+ const visit: ts.Visitor = (node) => {
52
+ if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier))
53
+ return context.factory.updateImportDeclaration(
54
+ node,
55
+ node.modifiers,
56
+ node.importClause,
57
+ rewrite(node.moduleSpecifier),
58
+ node.attributes,
59
+ )
60
+ if (ts.isExportDeclaration(node) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier))
61
+ return context.factory.updateExportDeclaration(
62
+ node,
63
+ node.modifiers,
64
+ node.isTypeOnly,
65
+ node.exportClause,
66
+ rewrite(node.moduleSpecifier),
67
+ node.attributes,
68
+ )
69
+ if (ts.isImportTypeNode(node) && ts.isLiteralTypeNode(node.argument) && ts.isStringLiteral(node.argument.literal))
70
+ return context.factory.updateImportTypeNode(
71
+ node,
72
+ context.factory.createLiteralTypeNode(rewrite(node.argument.literal)),
73
+ node.attributes,
74
+ node.qualifier,
75
+ node.typeArguments,
76
+ node.isTypeOf,
77
+ )
78
+ return ts.visitEachChild(node, visit, context)
79
+ }
80
+ return ts.visitNode(source, visit) as ts.SourceFile
81
+ }
82
+ }
83
+
84
+ const diagnostics = [...parsed.errors, ...ts.getPreEmitDiagnostics(program)]
85
+ if (diagnostics.some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error)) {
86
+ console.error(
87
+ ts.formatDiagnostics(diagnostics, {
88
+ getCanonicalFileName: (path) => path,
89
+ getCurrentDirectory: () => root,
90
+ getNewLine: () => '\n',
91
+ }),
92
+ )
93
+ process.exit(1)
94
+ }
95
+ await rm(outputRoot, { recursive: true, force: true })
96
+ const result = program.emit(undefined, undefined, undefined, true, { afterDeclarations: [rewriteImports] })
97
+ if (result.emitSkipped || result.diagnostics.some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error))
98
+ throw new Error(
99
+ ts.formatDiagnostics(result.diagnostics, {
100
+ getCanonicalFileName: (path) => path,
101
+ getCurrentDirectory: () => root,
102
+ getNewLine: () => '\n',
103
+ }),
104
+ )
105
+ console.log('Built public plugin declarations under dist/types')
@@ -0,0 +1,111 @@
1
+ #!/usr/bin/env bun
2
+
3
+ import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
4
+ import { tmpdir } from 'node:os'
5
+ import { dirname, join } from 'node:path'
6
+ import { fileURLToPath } from 'node:url'
7
+
8
+ const root = join(dirname(fileURLToPath(import.meta.url)), '..')
9
+ const scratch = await mkdtemp(join(tmpdir(), 'typeclaw-plugin-sdk-'))
10
+ const manifest = await Bun.file(join(root, 'package.json')).json()
11
+ const bunTypes = await Bun.file(join(root, 'node_modules', '@types', 'bun', 'package.json')).json()
12
+
13
+ async function run(argv: string[], cwd: string): Promise<string> {
14
+ const child = Bun.spawn(argv, { cwd, stdin: 'ignore', stdout: 'pipe', stderr: 'pipe' })
15
+ const [stdout, stderr, code] = await Promise.all([
16
+ new Response(child.stdout).text(),
17
+ new Response(child.stderr).text(),
18
+ child.exited,
19
+ ])
20
+ if (code !== 0) throw new Error(`${argv.join(' ')} failed (${code})\n${stdout}\n${stderr}`)
21
+ return stdout
22
+ }
23
+
24
+ try {
25
+ // Exercise the real prepack lifecycle. Installing with scripts disabled then
26
+ // proves declaration consumers do not need our dev compiler or install hook.
27
+ await run(['npm', 'pack', '--pack-destination', scratch], root)
28
+ const archiveName = `typeclaw-${manifest.version}.tgz`
29
+ const consumer = join(scratch, 'consumer')
30
+ await mkdir(consumer)
31
+ await writeFile(
32
+ join(consumer, 'package.json'),
33
+ JSON.stringify({
34
+ name: 'example-plugin-consumer',
35
+ private: true,
36
+ type: 'module',
37
+ dependencies: { typeclaw: `file:../${archiveName}`, zod: manifest.dependencies.zod },
38
+ devDependencies: { '@types/bun': bunTypes.version },
39
+ }),
40
+ )
41
+ await run([process.execPath, 'install', '--ignore-scripts'], consumer)
42
+ await writeFile(
43
+ join(consumer, 'tsconfig.json'),
44
+ JSON.stringify({
45
+ compilerOptions: {
46
+ target: 'ESNext',
47
+ module: 'Preserve',
48
+ moduleResolution: 'bundler',
49
+ strict: true,
50
+ skipLibCheck: true,
51
+ noEmit: true,
52
+ types: ['bun'],
53
+ },
54
+ include: ['plugin.ts'],
55
+ }),
56
+ )
57
+ await writeFile(
58
+ join(consumer, 'plugin.ts'),
59
+ `
60
+ import { definePlugin, type Hooks } from 'typeclaw/plugin'
61
+ import { z } from 'zod'
62
+ const hooks = {
63
+ 'tool.before': (event) => {
64
+ const tool: string = event.tool
65
+ // @ts-expect-error tool identifiers must remain strings, not any
66
+ const invalid: number = event.tool
67
+ return tool ? undefined : { block: true as const, reason: 'empty tool' }
68
+ },
69
+ } satisfies Hooks
70
+ // @ts-expect-error unsupported hook names must not become valid or any
71
+ const unsupported: keyof Hooks = 'session.strat'
72
+ export default definePlugin({
73
+ configSchema: z.object({ enabled: z.boolean() }),
74
+ plugin: async (ctx) => {
75
+ const enabled: boolean = ctx.config.enabled
76
+ // @ts-expect-error schema-inferred config must not become any
77
+ const invalid: string = ctx.config.enabled
78
+ return enabled ? { hooks } : {}
79
+ },
80
+ })
81
+ `,
82
+ )
83
+ for (const [module, resolution] of [
84
+ ['Preserve', 'bundler'],
85
+ ['NodeNext', 'NodeNext'],
86
+ ]) {
87
+ const output = await run(
88
+ [
89
+ process.execPath,
90
+ 'run',
91
+ 'typecheck',
92
+ '--project',
93
+ join(consumer, 'tsconfig.json'),
94
+ '--module',
95
+ module!,
96
+ '--moduleResolution',
97
+ resolution!,
98
+ '--listFiles',
99
+ ],
100
+ root,
101
+ )
102
+ const files = output.split(/\r?\n/).map((file) => file.replaceAll('\\', '/'))
103
+ if (files.some((file) => file.includes('/node_modules/typeclaw/src/')))
104
+ throw new Error('The public SDK pulled TypeClaw implementation sources into the consumer.')
105
+ if (!files.some((file) => file.endsWith('/node_modules/typeclaw/dist/types/plugin/index.d.ts')))
106
+ throw new Error('The packed public SDK declaration entry was not resolved.')
107
+ console.log(`Packed plugin consumer passed ${resolution} resolution without source imports or @/* aliases`)
108
+ }
109
+ } finally {
110
+ await rm(scratch, { recursive: true, force: true })
111
+ }
@@ -1,6 +1,6 @@
1
- // Preloaded by bunfig.toml `[test] preload`. Two responsibilities:
2
- // 1. Deny `bun test` without --parallel.
3
- // 2. Raise the per-test default timeout from Bun's 5000ms.
1
+ // Preloaded by bunfig.toml `[test] preload` to deny `bun test` without
2
+ // --parallel. The default timeout belongs in bunfig.toml, not this preload,
3
+ // so an explicit CLI --timeout keeps its normal precedence.
4
4
  //
5
5
  // Why deny serial runs: Serial runs are ~3.4x slower (44s → 13s, see commit
6
6
  // 1c66d5e), and Bun has no bunfig knob for the flag yet (verified against
@@ -18,39 +18,12 @@
18
18
  //
19
19
  // Bypass with TYPECLAW_ALLOW_SERIAL_TESTS=1 when debugging a flaky test
20
20
  // where worker contention obscures the failure.
21
- //
22
- // Why raise the default timeout: A growing number of tests in this repo
23
- // either spawn child processes (`bun run typeclaw …` via Bun.spawn from
24
- // src/cli/index.test.ts, src/cli/role.test.ts, src/cli/status.test.ts,
25
- // src/init/dockerfile.test.ts agent-browser wrapper, etc.) or boot the
26
- // in-process agent (`startAgent({ port: 0, … })` from src/run/plugin.test.ts).
27
- // Both shapes have a happy-path cost well under 1s but a worst-case cost
28
- // that races Bun's 5000ms ceiling under `--parallel` contention. The
29
- // repeating failure mode is "this test timed out after 5000ms" appearing
30
- // on different tests across runs at a rough ~3-15% rate per full-suite
31
- // invocation — not a real bug, just resource starvation. Raising the
32
- // default to 30s eliminates the false positives without masking real
33
- // hangs (a wedged test still fails, just 6x slower than before). The
34
- // happy path is unaffected because tests complete in their actual
35
- // runtime, not the timeout budget.
36
- //
37
- // 30s was chosen as ~75x the observed happy-path cold-start (~400ms) for
38
- // the heaviest subprocess tests, matching the in-house convention used in
39
- // pi-coding-agent's subprocess fixtures and Bun's own integration-test
40
- // suites (see oven-sh/bun test/cli/install/*.test.ts which set 5-minute
41
- // timeouts for full installs). Individual tests that genuinely need more
42
- // can still pass an explicit 3rd arg to `test()` to override locally.
43
-
44
- import { setDefaultTimeout } from 'bun:test'
45
21
 
46
22
  const isParallelWorker = typeof process.env.BUN_TEST_WORKER_ID === 'string'
47
23
 
48
- if (isParallelWorker) {
49
- setDefaultTimeout(30_000)
50
- } else if (process.env.TYPECLAW_ALLOW_SERIAL_TESTS === '1') {
24
+ if (!isParallelWorker && process.env.TYPECLAW_ALLOW_SERIAL_TESTS === '1') {
51
25
  console.warn('[require-parallel] Running serially — TYPECLAW_ALLOW_SERIAL_TESTS=1 set.')
52
- setDefaultTimeout(30_000)
53
- } else {
26
+ } else if (!isParallelWorker) {
54
27
  console.error('')
55
28
  console.error(' ✗ `bun test` without --parallel is denied in this repo.')
56
29
  console.error('')
@@ -21,5 +21,8 @@ export type InternalGuard = {
21
21
  readonly owner: string
22
22
  readonly key: string
23
23
  readonly tools: ReadonlySet<string>
24
+ // Hygiene guards that protect no boundary set this so a bug in their check
25
+ // is logged and skipped instead of denying every call to their tools.
26
+ readonly skipOnCheckError?: true
24
27
  readonly check: (event: InternalGuardEvent) => InternalGuardResult | Promise<InternalGuardResult>
25
28
  }
@@ -35,6 +35,7 @@ export function buildInternalGuards(agentDir: string): readonly InternalGuard[]
35
35
  owner: 'guard',
36
36
  key: GUARD_IMAGE_READ_REDIRECT,
37
37
  tools: ['read'],
38
+ skipOnCheckError: true,
38
39
  check: checkImageReadRedirect,
39
40
  },
40
41
  {
@@ -54,18 +55,21 @@ export function buildInternalGuards(agentDir: string): readonly InternalGuard[]
54
55
  owner: 'bun-hygiene',
55
56
  key: GUARD_GLOBAL_INSTALL,
56
57
  tools: ['bash'],
58
+ skipOnCheckError: true,
57
59
  check: checkGlobalInstallGuard,
58
60
  },
59
61
  {
60
62
  owner: 'bun-hygiene',
61
63
  key: GUARD_NON_BUN_PACKAGE_MANAGER,
62
64
  tools: ['bash'],
65
+ skipOnCheckError: true,
63
66
  check: checkNonBunPackageManagerGuard,
64
67
  },
65
68
  {
66
69
  owner: 'bun-hygiene',
67
70
  key: GUARD_NON_BUN_PACKAGE_RUNNER,
68
71
  tools: ['bash'],
72
+ skipOnCheckError: true,
69
73
  check: checkNonBunPackageRunnerGuard,
70
74
  },
71
75
  ]
@@ -0,0 +1,174 @@
1
+ import { Agent, type StreamFn } from '@earendil-works/pi-agent-core'
2
+ import { AgentSession, DefaultResourceLoader, SessionManager, SettingsManager } from '@earendil-works/pi-coding-agent'
3
+
4
+ import { compactionTriggerTokens } from './compaction'
5
+
6
+ type IdleSchedule = (run: () => Promise<void>) => () => void
7
+
8
+ // Leave ten percent of the normal budget for the next input and response.
9
+ const IDLE_COMPACTION_TRIGGER_RATIO = 0.9
10
+
11
+ export function attachIdleCompaction(
12
+ session: AgentSession,
13
+ options: { schedule?: IdleSchedule; onApplied?: () => void } = {},
14
+ ): () => void {
15
+ const schedule = options.schedule ?? scheduleIdle
16
+ // Capture before turn drivers install output caps that apply only to replies.
17
+ const stream = session.agent.streamFunction
18
+ let cancelScheduled: (() => void) | undefined
19
+ let pending: { cancelled: boolean; session?: AgentSession } | undefined
20
+ let attemptedLeaf: string | null | undefined
21
+ let disposed = false
22
+
23
+ const cancel = () => {
24
+ cancelScheduled?.()
25
+ cancelScheduled = undefined
26
+ if (pending) {
27
+ pending.cancelled = true
28
+ pending.session?.abortCompaction()
29
+ }
30
+ }
31
+
32
+ const run = async () => {
33
+ cancelScheduled = undefined
34
+ const model = session.model
35
+ const leaf = session.sessionManager.getLeafId()
36
+ const tokens = session.getContextUsage()?.tokens
37
+ if (
38
+ disposed ||
39
+ pending ||
40
+ !session.isIdle ||
41
+ !session.autoCompactionEnabled ||
42
+ !model ||
43
+ leaf === attemptedLeaf ||
44
+ tokens == null ||
45
+ tokens < compactionTriggerTokens(model) * IDLE_COMPACTION_TRIGGER_RATIO
46
+ )
47
+ return
48
+
49
+ attemptedLeaf = leaf
50
+ const thinkingLevel = session.thinkingLevel
51
+ const generation: { cancelled: boolean; session?: AgentSession } = { cancelled: false }
52
+ pending = generation
53
+ try {
54
+ generation.session = snapshotSession(session, stream)
55
+ const result = await generation.session.compact()
56
+ // No await between validation and append/refresh: the live branch cannot
57
+ // change between the validity check and the append-only checkpoint.
58
+ if (
59
+ generation.cancelled ||
60
+ disposed ||
61
+ !session.isIdle ||
62
+ session.model !== model ||
63
+ session.thinkingLevel !== thinkingLevel ||
64
+ session.sessionManager.getLeafId() !== leaf
65
+ )
66
+ return
67
+ session.sessionManager.appendCompaction(
68
+ result.summary,
69
+ result.firstKeptEntryId,
70
+ result.tokensBefore,
71
+ result.details,
72
+ false,
73
+ result.usage,
74
+ )
75
+ session.refreshContext()
76
+ options.onApplied?.()
77
+ } catch (error) {
78
+ // This is an optional background operation. Pi owns bounded transient
79
+ // retries; a final failure leaves ordinary foreground compaction intact.
80
+ if (!generation.cancelled && !disposed) {
81
+ console.warn(
82
+ `[agent] ${session.sessionId}: idle compaction failed: ${error instanceof Error ? error.message : String(error)}`,
83
+ )
84
+ }
85
+ } finally {
86
+ generation.session?.dispose()
87
+ if (pending === generation) pending = undefined
88
+ }
89
+ }
90
+
91
+ const unsubscribe = session.subscribe((event) => {
92
+ if (event.type === 'agent_settled') {
93
+ cancelScheduled?.()
94
+ // Scheduling yields past settlement so short-lived cron/subagent sessions
95
+ // can be disposed without starting a summary they will never use.
96
+ const tokens = session.getContextUsage()?.tokens
97
+ const model = session.model
98
+ if (model && tokens != null && tokens >= compactionTriggerTokens(model) * IDLE_COMPACTION_TRIGGER_RATIO) {
99
+ cancelScheduled = schedule(run)
100
+ }
101
+ } else if (event.type === 'agent_start' || event.type === 'compaction_start' || event.type === 'entry_appended') {
102
+ cancel()
103
+ }
104
+ })
105
+
106
+ // Cancel before prompt preflight, not just agent_start: auth and input hooks
107
+ // may await while the provider finishes an idle summary.
108
+ const prompt = session.prompt.bind(session)
109
+ session.prompt = (...args) => {
110
+ cancel()
111
+ return prompt(...args)
112
+ }
113
+ const resume = session.agent.continue.bind(session.agent)
114
+ session.agent.continue = (...args) => {
115
+ cancel()
116
+ return resume(...args)
117
+ }
118
+ const compact = session.compact.bind(session)
119
+ session.compact = (...args) => {
120
+ cancel()
121
+ return compact(...args)
122
+ }
123
+ const dispose = session.dispose.bind(session)
124
+ const stop = () => {
125
+ if (disposed) return
126
+ disposed = true
127
+ cancel()
128
+ unsubscribe()
129
+ session.prompt = prompt
130
+ session.agent.continue = resume
131
+ session.compact = compact
132
+ session.dispose = dispose
133
+ }
134
+ session.dispose = () => {
135
+ stop()
136
+ dispose()
137
+ }
138
+ return stop
139
+ }
140
+
141
+ function scheduleIdle(run: () => Promise<void>): () => void {
142
+ const timer = setTimeout(() => void run(), 0)
143
+ timer.unref()
144
+ return () => clearTimeout(timer)
145
+ }
146
+
147
+ function snapshotSession(source: AgentSession, streamFn: StreamFn): AgentSession {
148
+ const cwd = source.sessionManager.getCwd()
149
+ // No header: pi assigns a separate session ID, preserving entry IDs for the
150
+ // checkpoint without sharing session-scoped provider resources on disposal.
151
+ const sessionManager = SessionManager.inMemory(cwd, undefined, structuredClone(source.sessionManager.getBranch()))
152
+ const settingsManager = SettingsManager.inMemory({
153
+ compaction: source.settingsManager.getCompactionSettings(source.model),
154
+ retry: { enabled: true, maxRetries: 2, baseDelayMs: 2_000 },
155
+ })
156
+ return new AgentSession({
157
+ agent: new Agent({
158
+ initialState: {
159
+ model: source.model,
160
+ thinkingLevel: source.thinkingLevel,
161
+ messages: sessionManager.buildSessionContext().messages,
162
+ },
163
+ streamFn,
164
+ }),
165
+ sessionManager,
166
+ settingsManager,
167
+ modelRuntime: source.modelRuntime,
168
+ // An unloaded loader supplies no tools or extension handlers. The shadow
169
+ // only runs pi's built-in compact(), never a turn or extension lifecycle.
170
+ resourceLoader: new DefaultResourceLoader({ cwd, agentDir: cwd, settingsManager }),
171
+ cwd,
172
+ initialActiveToolNames: [],
173
+ })
174
+ }