typeclaw 0.48.13 → 0.50.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/compaction.d.ts +8 -0
  4. package/dist/types/agent/git-nudge.d.ts +6 -0
  5. package/dist/types/agent/guard-types.d.ts +25 -0
  6. package/dist/types/agent/guards.d.ts +7 -0
  7. package/dist/types/agent/idle-compaction.d.ts +7 -0
  8. package/dist/types/agent/index.d.ts +163 -0
  9. package/dist/types/agent/live-subagents.d.ts +113 -0
  10. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  11. package/dist/types/agent/loop-guard.d.ts +67 -0
  12. package/dist/types/agent/model-fallback.d.ts +29 -0
  13. package/dist/types/agent/model-overrides.d.ts +8 -0
  14. package/dist/types/agent/multimodal/index.d.ts +2 -0
  15. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  16. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  17. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  18. package/dist/types/agent/network/response-body.d.ts +1 -0
  19. package/dist/types/agent/network/safe-http.d.ts +46 -0
  20. package/dist/types/agent/plugin-tools.d.ts +129 -0
  21. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  22. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  23. package/dist/types/agent/provider-error.d.ts +23 -0
  24. package/dist/types/agent/reload-tool.d.ts +10 -0
  25. package/dist/types/agent/restart/index.d.ts +31 -0
  26. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  27. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  28. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  29. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  30. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  31. package/dist/types/agent/self.d.ts +1 -0
  32. package/dist/types/agent/session-meta.d.ts +28 -0
  33. package/dist/types/agent/session-origin.d.ts +65 -0
  34. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  35. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  36. package/dist/types/agent/subagent-drain.d.ts +25 -0
  37. package/dist/types/agent/subagent-session.d.ts +3 -0
  38. package/dist/types/agent/subagents.d.ts +153 -0
  39. package/dist/types/agent/system-prompt.d.ts +7 -0
  40. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  41. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  42. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  43. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  44. package/dist/types/agent/todo/continuation.d.ts +21 -0
  45. package/dist/types/agent/todo/scope.d.ts +6 -0
  46. package/dist/types/agent/todo/store.d.ts +16 -0
  47. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  48. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  49. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  50. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  51. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  52. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  53. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  54. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  55. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  56. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  57. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  58. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  59. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  60. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  61. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  62. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  63. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  64. package/dist/types/agent/tools/ddg.d.ts +18 -0
  65. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  66. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  67. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  68. package/dist/types/agent/tools/restart.d.ts +25 -0
  69. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  70. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  71. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  72. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  73. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  74. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  75. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  76. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  77. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  78. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  79. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  80. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  81. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  82. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  83. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  84. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  85. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  86. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  87. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  88. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  89. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  90. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  91. package/dist/types/agent/tools/websearch.d.ts +17 -0
  92. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  93. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  94. package/dist/types/agent/turn-runner.d.ts +36 -0
  95. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  96. package/dist/types/browser/dockerfile.d.ts +2 -0
  97. package/dist/types/browser/registry.d.ts +49 -0
  98. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  99. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  100. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  101. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  102. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  103. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  104. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  105. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  106. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  107. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  108. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  109. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  110. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  111. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  112. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  113. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  114. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  115. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  116. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  117. package/dist/types/channels/background-handoff.d.ts +56 -0
  118. package/dist/types/channels/background-obligations.d.ts +135 -0
  119. package/dist/types/channels/catch-up.d.ts +26 -0
  120. package/dist/types/channels/commands.d.ts +2 -0
  121. package/dist/types/channels/completion-claim.d.ts +20 -0
  122. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  123. package/dist/types/channels/continuity-types.d.ts +75 -0
  124. package/dist/types/channels/describe-error.d.ts +1 -0
  125. package/dist/types/channels/engagement.d.ts +34 -0
  126. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  127. package/dist/types/channels/github-repo.d.ts +2 -0
  128. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  129. package/dist/types/channels/github-review-check.d.ts +135 -0
  130. package/dist/types/channels/github-review-claim.d.ts +3 -0
  131. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  132. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  133. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  134. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  135. package/dist/types/channels/inbound-journal.d.ts +272 -0
  136. package/dist/types/channels/last-alive.d.ts +3 -0
  137. package/dist/types/channels/membership-cache.d.ts +27 -0
  138. package/dist/types/channels/membership.d.ts +21 -0
  139. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  140. package/dist/types/channels/participants.d.ts +4 -0
  141. package/dist/types/channels/persistence.d.ts +32 -0
  142. package/dist/types/channels/recovery-notice.d.ts +26 -0
  143. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  144. package/dist/types/channels/router.d.ts +798 -0
  145. package/dist/types/channels/schema.d.ts +501 -0
  146. package/dist/types/channels/session-handoff.d.ts +58 -0
  147. package/dist/types/channels/session-search.d.ts +29 -0
  148. package/dist/types/channels/types.d.ts +414 -0
  149. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  150. package/dist/types/cli/builtins.d.ts +2 -0
  151. package/dist/types/cli/command-meta.d.ts +9 -0
  152. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  153. package/dist/types/coding-agent/broker.d.ts +22 -0
  154. package/dist/types/coding-agent/claude.d.ts +22 -0
  155. package/dist/types/coding-agent/codex.d.ts +19 -0
  156. package/dist/types/coding-agent/index.d.ts +71 -0
  157. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  158. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  159. package/dist/types/coding-agent/omo.d.ts +133 -0
  160. package/dist/types/coding-agent/runner.d.ts +35 -0
  161. package/dist/types/coding-agent/tool.d.ts +27 -0
  162. package/dist/types/coding-agent/worktree.d.ts +22 -0
  163. package/dist/types/commands/index.d.ts +45 -0
  164. package/dist/types/config/config.d.ts +814 -0
  165. package/dist/types/config/index.d.ts +3 -0
  166. package/dist/types/config/model-overrides.d.ts +3 -0
  167. package/dist/types/config/providers.d.ts +1456 -0
  168. package/dist/types/config/reloadable.d.ts +9 -0
  169. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  170. package/dist/types/container/build-cache.d.ts +39 -0
  171. package/dist/types/container/compose-project.d.ts +1 -0
  172. package/dist/types/container/controller.d.ts +25 -0
  173. package/dist/types/container/docker-app.d.ts +23 -0
  174. package/dist/types/container/exit-reason.d.ts +10 -0
  175. package/dist/types/container/index.d.ts +14 -0
  176. package/dist/types/container/log-archive.d.ts +68 -0
  177. package/dist/types/container/log-colors.d.ts +3 -0
  178. package/dist/types/container/log-timestamps.d.ts +9 -0
  179. package/dist/types/container/logs.d.ts +37 -0
  180. package/dist/types/container/memory-limit.d.ts +13 -0
  181. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  182. package/dist/types/container/oom-events.d.ts +18 -0
  183. package/dist/types/container/port.d.ts +18 -0
  184. package/dist/types/container/require-running.d.ts +16 -0
  185. package/dist/types/container/restart.d.ts +32 -0
  186. package/dist/types/container/shared.d.ts +93 -0
  187. package/dist/types/container/shell.d.ts +35 -0
  188. package/dist/types/container/start.d.ts +144 -0
  189. package/dist/types/container/stats.d.ts +31 -0
  190. package/dist/types/container/status.d.ts +25 -0
  191. package/dist/types/container/stop.d.ts +24 -0
  192. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  193. package/dist/types/container/verify-running.d.ts +49 -0
  194. package/dist/types/cron/consumer.d.ts +42 -0
  195. package/dist/types/cron/count-state.d.ts +24 -0
  196. package/dist/types/cron/index.d.ts +21 -0
  197. package/dist/types/cron/list.d.ts +33 -0
  198. package/dist/types/cron/reloadable.d.ts +11 -0
  199. package/dist/types/cron/scheduler.d.ts +51 -0
  200. package/dist/types/cron/schema.d.ts +108 -0
  201. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  202. package/dist/types/dependencies/bins.d.ts +22 -0
  203. package/dist/types/dependencies/index.d.ts +2 -0
  204. package/dist/types/git/bound-gc-config.d.ts +4 -0
  205. package/dist/types/git/hookless.d.ts +1 -0
  206. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  207. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  208. package/dist/types/git/resolve-identity.d.ts +10 -0
  209. package/dist/types/git/run.d.ts +24 -0
  210. package/dist/types/git/system-commit.d.ts +2 -0
  211. package/dist/types/hostd/client.d.ts +13 -0
  212. package/dist/types/hostd/models.d.ts +1 -0
  213. package/dist/types/hostd/paths.d.ts +17 -0
  214. package/dist/types/hostd/protocol.d.ts +93 -0
  215. package/dist/types/hostd/spawn.d.ts +17 -0
  216. package/dist/types/hostd/version.d.ts +18 -0
  217. package/dist/types/init/auto-upgrade.d.ts +41 -0
  218. package/dist/types/init/cli-version.d.ts +7 -0
  219. package/dist/types/init/dockerfile.d.ts +34 -0
  220. package/dist/types/init/ensure-deps.d.ts +17 -0
  221. package/dist/types/init/env-file.d.ts +3 -0
  222. package/dist/types/init/gitignore.d.ts +5 -0
  223. package/dist/types/init/local-source-stamp.d.ts +3 -0
  224. package/dist/types/init/packagejson.d.ts +7 -0
  225. package/dist/types/init/paths.d.ts +3 -0
  226. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  227. package/dist/types/init/run-bun-install.d.ts +16 -0
  228. package/dist/types/init/windows-dev-link.d.ts +8 -0
  229. package/dist/types/mcp/catalog.d.ts +7 -0
  230. package/dist/types/mcp/client.d.ts +58 -0
  231. package/dist/types/mcp/manager.d.ts +56 -0
  232. package/dist/types/mcp/tools.d.ts +23 -0
  233. package/dist/types/models/embedding-model.d.ts +20 -0
  234. package/dist/types/models/transformers-version.d.ts +1 -0
  235. package/dist/types/network/internal-destinations.d.ts +29 -0
  236. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  237. package/dist/types/operations/incidents.d.ts +47 -0
  238. package/dist/types/operations/index.d.ts +3 -0
  239. package/dist/types/operations/remediations.d.ts +25 -0
  240. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  241. package/dist/types/permissions/builtins.d.ts +25 -0
  242. package/dist/types/permissions/grant.d.ts +19 -0
  243. package/dist/types/permissions/index.d.ts +6 -0
  244. package/dist/types/permissions/match-rule.d.ts +28 -0
  245. package/dist/types/permissions/permissions.d.ts +42 -0
  246. package/dist/types/permissions/resolve.d.ts +25 -0
  247. package/dist/types/permissions/schema.d.ts +14 -0
  248. package/dist/types/plugin/context.d.ts +20 -0
  249. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  250. package/dist/types/plugin/define.d.ts +46 -0
  251. package/dist/types/plugin/hooks.d.ts +52 -0
  252. package/dist/types/plugin/index.d.ts +11 -0
  253. package/dist/types/plugin/load-skill.d.ts +14 -0
  254. package/dist/types/plugin/loader.d.ts +25 -0
  255. package/dist/types/plugin/manager.d.ts +42 -0
  256. package/dist/types/plugin/registry.d.ts +73 -0
  257. package/dist/types/plugin/skills.d.ts +11 -0
  258. package/dist/types/plugin/types.d.ts +336 -0
  259. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  260. package/dist/types/reload/client.d.ts +11 -0
  261. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  262. package/dist/types/reload/format.d.ts +2 -0
  263. package/dist/types/reload/index.d.ts +6 -0
  264. package/dist/types/reload/recover.d.ts +22 -0
  265. package/dist/types/reload/registry.d.ts +10 -0
  266. package/dist/types/reload/types.d.ts +25 -0
  267. package/dist/types/role-claim/client.d.ts +20 -0
  268. package/dist/types/role-claim/code.d.ts +4 -0
  269. package/dist/types/role-claim/controller.d.ts +59 -0
  270. package/dist/types/role-claim/index.d.ts +6 -0
  271. package/dist/types/role-claim/match-rule.d.ts +9 -0
  272. package/dist/types/role-claim/pending.d.ts +35 -0
  273. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  274. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  275. package/dist/types/sandbox/availability.d.ts +21 -0
  276. package/dist/types/sandbox/build.d.ts +7 -0
  277. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  278. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  279. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  280. package/dist/types/sandbox/dev-source.d.ts +4 -0
  281. package/dist/types/sandbox/env-exposure.d.ts +1 -0
  282. package/dist/types/sandbox/errors.d.ts +20 -0
  283. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  284. package/dist/types/sandbox/index.d.ts +14 -0
  285. package/dist/types/sandbox/package-install.d.ts +1 -0
  286. package/dist/types/sandbox/policy.d.ts +71 -0
  287. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  288. package/dist/types/sandbox/quote.d.ts +2 -0
  289. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  290. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  291. package/dist/types/sandbox/symlinks.d.ts +6 -0
  292. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  293. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  294. package/dist/types/secrets/defaults.d.ts +21 -0
  295. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  296. package/dist/types/secrets/hydrate.d.ts +7 -0
  297. package/dist/types/secrets/index.d.ts +7 -0
  298. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  299. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  300. package/dist/types/secrets/resolve.d.ts +14 -0
  301. package/dist/types/secrets/schema.d.ts +840 -0
  302. package/dist/types/secrets/storage.d.ts +56 -0
  303. package/dist/types/shared/host-locale.d.ts +1 -0
  304. package/dist/types/shared/index.d.ts +5 -0
  305. package/dist/types/shared/local-time.d.ts +4 -0
  306. package/dist/types/shared/platform.d.ts +2 -0
  307. package/dist/types/shared/protocol.d.ts +424 -0
  308. package/dist/types/shared/style-text.d.ts +3 -0
  309. package/dist/types/shared/wsl.d.ts +17 -0
  310. package/dist/types/stream/broker.d.ts +2 -0
  311. package/dist/types/stream/index.d.ts +2 -0
  312. package/dist/types/stream/types.d.ts +71 -0
  313. package/package.json +13 -6
  314. package/scripts/build-plugin-types.ts +105 -0
  315. package/scripts/check-plugin-sdk.ts +111 -0
  316. package/scripts/dump-system-prompt.ts +52 -110
  317. package/scripts/require-parallel.ts +5 -32
  318. package/src/agent/guard-types.ts +3 -0
  319. package/src/agent/guards.ts +4 -0
  320. package/src/agent/idle-compaction.ts +174 -0
  321. package/src/agent/index.ts +210 -80
  322. package/src/agent/live-sessions.ts +2 -2
  323. package/src/agent/live-subagents.ts +20 -0
  324. package/src/agent/multimodal/look-at.ts +22 -9
  325. package/src/agent/plugin-tools.ts +66 -12
  326. package/src/agent/prompt-cache-key.ts +42 -0
  327. package/src/agent/provider-error.ts +179 -10
  328. package/src/agent/restart-handoff/index.ts +7 -14
  329. package/src/agent/reviewer-activity.ts +68 -0
  330. package/src/agent/reviewer-bash-policy.ts +41 -1
  331. package/src/agent/session-origin.ts +58 -9
  332. package/src/agent/subagent-cache-keepalive.ts +198 -0
  333. package/src/agent/subagent-session.ts +6 -0
  334. package/src/agent/subagents.ts +59 -9
  335. package/src/agent/system-prompt.ts +68 -202
  336. package/src/agent/todo/continuation-policy.ts +12 -4
  337. package/src/agent/tool-file-safety.ts +119 -15
  338. package/src/agent/tool-not-found-nudge.ts +1 -1
  339. package/src/agent/tools/channel-edit.ts +20 -10
  340. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  341. package/src/agent/tools/channel-handoff.ts +72 -0
  342. package/src/agent/tools/channel-history-render.ts +2 -1
  343. package/src/agent/tools/channel-read.ts +57 -10
  344. package/src/agent/tools/channel-reply.ts +55 -30
  345. package/src/agent/tools/channel-send.ts +69 -19
  346. package/src/agent/tools/channel-session-search.ts +35 -0
  347. package/src/agent/tools/curl-impersonate.ts +22 -6
  348. package/src/agent/tools/ddg.ts +13 -5
  349. package/src/agent/tools/post-github-review.ts +77 -15
  350. package/src/agent/tools/skip-response.ts +2 -2
  351. package/src/agent/tools/spawn-subagent.ts +190 -23
  352. package/src/agent/tools/stream-snapshot.ts +15 -2
  353. package/src/agent/tools/subagent-access.ts +11 -4
  354. package/src/agent/tools/subagent-output.ts +8 -0
  355. package/src/browser/bsk-shim.mjs +74 -0
  356. package/src/browser/dockerfile.ts +84 -0
  357. package/src/browser/egress.ts +104 -0
  358. package/src/browser/managed-browser.ts +205 -0
  359. package/src/browser/registry.ts +110 -0
  360. package/src/browser/relay.ts +231 -0
  361. package/src/browser/sandbox-entry.ts +167 -0
  362. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  363. package/src/bundled-plugins/backup/README.md +10 -9
  364. package/src/bundled-plugins/backup/runner.ts +140 -58
  365. package/src/bundled-plugins/backup/subagents.ts +58 -26
  366. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  367. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  368. package/src/bundled-plugins/doc-render/index.ts +0 -10
  369. package/src/bundled-plugins/doc-render/render.ts +83 -111
  370. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  371. package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
  372. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  373. package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
  374. package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
  375. package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
  376. package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
  377. package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
  378. package/src/bundled-plugins/managed-browser/index.ts +74 -0
  379. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  380. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  381. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  382. package/src/bundled-plugins/operator/operator.ts +15 -4
  383. package/src/bundled-plugins/qa/index.ts +11 -0
  384. package/src/bundled-plugins/qa/qa.ts +160 -0
  385. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  386. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  387. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  388. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  389. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  390. package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
  391. package/src/bundled-plugins/security/index.ts +103 -36
  392. package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
  393. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  394. package/src/channels/adapter-namespace.ts +13 -0
  395. package/src/channels/adapters/discord-bot-reactions.ts +18 -0
  396. package/src/channels/adapters/discord-bot.ts +219 -72
  397. package/src/channels/adapters/discord-reactions.ts +18 -0
  398. package/src/channels/adapters/discord.ts +114 -8
  399. package/src/channels/adapters/github/inbound.ts +103 -8
  400. package/src/channels/adapters/github/index.ts +267 -19
  401. package/src/channels/adapters/github/last-alive.ts +15 -0
  402. package/src/channels/adapters/github/outbound.ts +54 -18
  403. package/src/channels/adapters/github/pending-review-store.ts +141 -0
  404. package/src/channels/adapters/github/permission-guidance.ts +1 -0
  405. package/src/channels/adapters/github/reactions.ts +100 -0
  406. package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
  407. package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
  408. package/src/channels/adapters/github/recovery.ts +106 -0
  409. package/src/channels/adapters/github/review-check.ts +510 -0
  410. package/src/channels/adapters/github/review-submitter.ts +34 -2
  411. package/src/channels/adapters/instagram.ts +32 -14
  412. package/src/channels/adapters/kakaotalk.ts +22 -7
  413. package/src/channels/adapters/line.ts +18 -3
  414. package/src/channels/adapters/outbound-account.ts +20 -0
  415. package/src/channels/adapters/own-reactions.ts +66 -0
  416. package/src/channels/adapters/recovery-correlation.ts +214 -0
  417. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  418. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  419. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  420. package/src/channels/adapters/slack-bot-classify.ts +19 -11
  421. package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
  422. package/src/channels/adapters/slack-bot-reactions.ts +18 -0
  423. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  424. package/src/channels/adapters/slack-bot.ts +424 -124
  425. package/src/channels/adapters/slack-classify.ts +26 -4
  426. package/src/channels/adapters/slack-inbound-revision.ts +96 -0
  427. package/src/channels/adapters/slack-reactions.ts +18 -0
  428. package/src/channels/adapters/slack-thread-ts.ts +6 -0
  429. package/src/channels/adapters/slack.ts +48 -3
  430. package/src/channels/adapters/teams.ts +14 -4
  431. package/src/channels/adapters/telegram-bot.ts +56 -10
  432. package/src/channels/adapters/webex-bot.ts +12 -2
  433. package/src/channels/adapters/webex.ts +12 -2
  434. package/src/channels/background-handoff.ts +434 -0
  435. package/src/channels/background-obligations.ts +893 -0
  436. package/src/channels/catch-up.ts +137 -0
  437. package/src/channels/continuation-willingness.ts +2 -2
  438. package/src/channels/continuity-types.ts +272 -0
  439. package/src/channels/engagement.ts +17 -1
  440. package/src/channels/github-false-receipt.ts +3 -3
  441. package/src/channels/github-rereview-guard.ts +9 -5
  442. package/src/channels/github-review-check.ts +598 -0
  443. package/src/channels/github-review-turn-ledger.ts +102 -28
  444. package/src/channels/github-review-verdict-coordinator.ts +72 -12
  445. package/src/channels/github-token-bridge.ts +35 -5
  446. package/src/channels/inbound-journal.ts +1738 -0
  447. package/src/channels/index.ts +6 -1
  448. package/src/channels/last-alive.ts +34 -0
  449. package/src/channels/manager.ts +25 -8
  450. package/src/channels/recovery-dispatcher.ts +264 -0
  451. package/src/channels/recovery-notice.ts +94 -0
  452. package/src/channels/recovery-outbox.ts +459 -0
  453. package/src/channels/router.ts +2951 -736
  454. package/src/channels/schema.ts +8 -1
  455. package/src/channels/session-handoff.fixture.ts +144 -0
  456. package/src/channels/session-handoff.ts +175 -0
  457. package/src/channels/session-search.ts +71 -0
  458. package/src/channels/subagent-completion-bridge.ts +17 -14
  459. package/src/channels/types.ts +133 -18
  460. package/src/channels/waiting-reactions.ts +664 -0
  461. package/src/cli/channel.ts +2 -3
  462. package/src/cli/compose.ts +7 -4
  463. package/src/cli/hostd.ts +49 -3
  464. package/src/cli/init.ts +2 -3
  465. package/src/cli/inspect.ts +11 -14
  466. package/src/cli/model.ts +132 -3
  467. package/src/coding-agent/broker-body.ts +38 -0
  468. package/src/coding-agent/broker.ts +290 -0
  469. package/src/coding-agent/claude.ts +95 -0
  470. package/src/coding-agent/codex.ts +104 -0
  471. package/src/coding-agent/index.ts +512 -0
  472. package/src/coding-agent/omo-state.ts +69 -0
  473. package/src/coding-agent/omo-stream.ts +138 -0
  474. package/src/coding-agent/omo.ts +192 -0
  475. package/src/coding-agent/runner.ts +285 -0
  476. package/src/coding-agent/tool.ts +62 -0
  477. package/src/coding-agent/worktree.ts +355 -0
  478. package/src/compose/restart.ts +10 -3
  479. package/src/compose/start.ts +20 -3
  480. package/src/config/config.ts +121 -25
  481. package/src/config/model-overrides.ts +59 -0
  482. package/src/config/models-mutation.ts +185 -2
  483. package/src/config/providers-mutation.ts +12 -4
  484. package/src/config/providers.ts +71 -9
  485. package/src/container/exit-reason.ts +44 -0
  486. package/src/container/index.ts +5 -0
  487. package/src/container/log-archive.ts +51 -13
  488. package/src/container/memory-limit.ts +1 -1
  489. package/src/container/memory-oversubscription.ts +36 -6
  490. package/src/container/oom-events.ts +86 -0
  491. package/src/container/restart.ts +2 -0
  492. package/src/container/shared.ts +8 -1
  493. package/src/container/start.ts +120 -17
  494. package/src/container/stop.ts +6 -2
  495. package/src/container/tool-oom-priority.ts +32 -0
  496. package/src/cron/consumer.ts +10 -4
  497. package/src/cron/reloadable.ts +23 -2
  498. package/src/doctor/checks.ts +22 -8
  499. package/src/hostd/daemon.ts +33 -11
  500. package/src/hostd/spawn.ts +106 -5
  501. package/src/hostd/version.ts +20 -0
  502. package/src/hostd/watchdog.ts +241 -0
  503. package/src/init/auto-upgrade.ts +7 -1
  504. package/src/init/dockerfile.ts +112 -602
  505. package/src/init/index.ts +6 -6
  506. package/src/init/local-source-stamp.ts +68 -0
  507. package/src/init/models-dev.ts +4 -0
  508. package/src/init/validate-api-key.ts +3 -0
  509. package/src/mcp/client.ts +3 -1
  510. package/src/operations/classify-tool-outcome.ts +45 -1
  511. package/src/operations/incidents.ts +10 -5
  512. package/src/permissions/builtins.ts +7 -0
  513. package/src/permissions/permissions.ts +18 -9
  514. package/src/permissions/resolve.ts +7 -1
  515. package/src/plugin/context.ts +2 -0
  516. package/src/plugin/core-tool-names.ts +1 -1
  517. package/src/plugin/define.ts +1 -0
  518. package/src/plugin/hooks.ts +137 -0
  519. package/src/plugin/index.ts +7 -0
  520. package/src/plugin/manager.ts +4 -0
  521. package/src/plugin/types.ts +66 -1
  522. package/src/run/background-handoff-boot.ts +86 -0
  523. package/src/run/bundled-plugins.ts +6 -0
  524. package/src/run/index.ts +107 -97
  525. package/src/run/llm-fetch-observer.ts +12 -15
  526. package/src/run/resource-sample.ts +19 -0
  527. package/src/sandbox/build.ts +4 -0
  528. package/src/sandbox/canonical-secrets.ts +4 -0
  529. package/src/sandbox/coding-agent.ts +214 -0
  530. package/src/sandbox/dev-source.ts +26 -0
  531. package/src/sandbox/hidden-paths.ts +16 -2
  532. package/src/sandbox/policy.ts +1 -0
  533. package/src/sandbox/runtime-private.ts +4 -1
  534. package/src/secrets/coding-agent-auth.ts +97 -0
  535. package/src/secrets/index.ts +0 -16
  536. package/src/secrets/storage.ts +13 -0
  537. package/src/server/command-runner.ts +6 -2
  538. package/src/server/index.ts +101 -40
  539. package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
  540. package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
  541. package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
  542. package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
  543. package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
  544. package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
  545. package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
  546. package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
  547. package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
  548. package/src/skills/typeclaw-config/SKILL.md +60 -26
  549. package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
  550. package/src/skills/typeclaw-cron/SKILL.md +1 -1
  551. package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
  552. package/src/skills/typeclaw-memory/SKILL.md +3 -3
  553. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  554. package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
  555. package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
  556. package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
  557. package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
  558. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  559. package/src/skills/typeclaw-plugins/SKILL.md +15 -15
  560. package/src/skills/typeclaw-skills/SKILL.md +19 -2
  561. package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
  562. package/typeclaw.schema.json +448 -6
  563. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  564. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
  565. package/src/secrets/claude-credentials-json.ts +0 -129
  566. package/src/secrets/codex-auth-json.ts +0 -102
  567. package/src/secrets/export-claude-credentials-file.ts +0 -270
  568. package/src/secrets/export-codex-auth-file.ts +0 -250
  569. package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
  570. package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
  571. package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
  572. package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
@@ -10,8 +10,10 @@ import {
10
10
  } from '@earendil-works/pi-coding-agent'
11
11
  import type { AgentSession, ToolDefinition } from '@earendil-works/pi-coding-agent'
12
12
 
13
+ import { adapterNamespace } from '@/channels/adapter-namespace'
13
14
  import type { ChannelRouter } from '@/channels/router'
14
15
  import type { ReactionRef } from '@/channels/types'
16
+ import { createCodingAgentTool } from '@/coding-agent/tool'
15
17
  import {
16
18
  getConfig,
17
19
  resolveModel,
@@ -20,6 +22,7 @@ import {
20
22
  type ResolvedProfile,
21
23
  type ThinkingLevel,
22
24
  } from '@/config'
25
+ import { effectiveModels } from '@/config/model-overrides'
23
26
  import { defaultThinkingLevelForRef, isOpenAiFamilyRef, providerForModelRef, type ModelRef } from '@/config/providers'
24
27
  import { renderMcpCatalog } from '@/mcp/catalog'
25
28
  import type { McpManager } from '@/mcp/manager'
@@ -27,6 +30,7 @@ import { createMcpDispatcherTools, MCP_DISPATCHER_TOOL_NAMES, resolveMcpCallPref
27
30
  import { noopPermissionService, type PermissionService, type RolesConfig } from '@/permissions'
28
31
  import type {
29
32
  BuiltinToolRef,
33
+ ChannelOutboundOrigin,
30
34
  HookBus,
31
35
  MaterializedSkills,
32
36
  PluginRegistry,
@@ -44,6 +48,7 @@ import { createCompactionSettingsManager } from './compaction'
44
48
  import { renderGitNudge } from './git-nudge'
45
49
  import type { InternalGuard } from './guard-types'
46
50
  import { buildInternalGuards } from './guards'
51
+ import { attachIdleCompaction } from './idle-compaction'
47
52
  import type { LiveSubagentRegistry } from './live-subagents'
48
53
  import { sanitizeMessagesForLlmReplay } from './llm-replay-sanitizer'
49
54
  import { applyModelRuntimeOverrides } from './model-overrides'
@@ -57,16 +62,23 @@ import {
57
62
  zodToToolParameters,
58
63
  } from './plugin-tools'
59
64
  import { PROACTIVE_NEXT_STEP_NUDGE } from './proactive-next-step-nudge'
65
+ import { promptCacheKeyForOrigin, withPromptCacheKey } from './prompt-cache-key'
66
+ import { wrapTransformContextWithLocalFailureMarker } from './provider-error'
60
67
  import { createReloadTool } from './reload-tool'
61
68
  import type { RestartHandoffOrigin } from './restart-handoff'
62
69
  import type { SubagentBashPolicy } from './reviewer-bash-policy'
63
70
  import { loadSelf } from './self'
64
71
  import { SESSION_META_CUSTOM_TYPE, sessionMetaPayload } from './session-meta'
65
- import { renderSessionOrigin, type SessionOrigin, type SessionRoleContext } from './session-origin'
72
+ import {
73
+ renderInteractiveSessionContext,
74
+ renderSessionOrigin,
75
+ type SessionOrigin,
76
+ type SessionRoleContext,
77
+ } from './session-origin'
78
+ import { SubagentCacheKeepalive } from './subagent-cache-keepalive'
66
79
  import type { CreateSessionForSubagent, SubagentCoalescer, SubagentRegistry } from './subagents'
67
80
  import {
68
- buildDefaultSystemPrompt,
69
- buildSlimSystemPrompt,
81
+ buildSystemPolicy,
70
82
  DEFAULT_SUBAGENT_ROSTER,
71
83
  renderRuntimeBlock,
72
84
  renderRuntimeNondisclosureRule,
@@ -77,11 +89,13 @@ import { createBudgetState, type ToolResultBudget, wrapToolDefinitionWithBudget
77
89
  import { createChannelDisengageTool } from './tools/channel-disengage'
78
90
  import { createChannelEditTool } from './tools/channel-edit'
79
91
  import { createChannelFetchAttachmentTool, resolveInboxBaseDir } from './tools/channel-fetch-attachment'
92
+ import { createChannelHandoffTool } from './tools/channel-handoff'
80
93
  import { createChannelHistoryTool } from './tools/channel-history'
81
94
  import { createChannelReactTool } from './tools/channel-react'
82
95
  import { createChannelReadTool } from './tools/channel-read'
83
96
  import { createChannelReplyTool } from './tools/channel-reply'
84
97
  import { createChannelSendTool } from './tools/channel-send'
98
+ import { createChannelSessionSearchTool } from './tools/channel-session-search'
85
99
  import { createGrantRoleTool } from './tools/grant-role'
86
100
  import { createPostGithubReviewTool } from './tools/post-github-review'
87
101
  import { createRestartTool } from './tools/restart'
@@ -138,8 +152,12 @@ export type CreateSessionOptions = {
138
152
  stream?: Stream
139
153
  channelRouter?: ChannelRouter
140
154
  mcpManager?: McpManager
141
- // Bypass the file-based resource loader (IDENTITY.md, SOUL.md, MEMORY.md,
142
- // memory/, bundled skills) and use this string verbatim as the system prompt.
155
+ // Replace TypeClaw's standard composition with this string: the shared
156
+ // policy, IDENTITY.md/SOUL.md, the interactive context, and the skill paths
157
+ // TypeClaw adds (bundled, plugin, `.agents/skills/`, `memory/skills/`) are
158
+ // not injected. Runtime metadata and the origin block are still appended,
159
+ // and pi's own default discovery still runs, so project context files such
160
+ // as AGENTS.md still reach the final system message.
143
161
  systemPromptOverride?: string
144
162
  // Identifies the kind of session and (for channels) its addressing fields.
145
163
  // Rendered into the system prompt so the agent knows who's listening, where
@@ -201,6 +219,9 @@ export type CreateSessionOptions = {
201
219
  // overrides) so different sessions on the same agent can run different
202
220
  // models without per-session config edits.
203
221
  profile?: string
222
+ // Thinking level overriding the resolved profile's own. Ignored when `profile`
223
+ // fell back to `default`, so the fallback session keeps `default`'s level.
224
+ thinkingLevel?: ThinkingLevel
204
225
  // Override the resolved ref directly, bypassing `profile` resolution. Used
205
226
  // by the model-fallback helper (`promptWithFallback`) to recreate a session
206
227
  // pinned to the next ref in the chain after the previous one failed. When
@@ -251,11 +272,16 @@ export type CreateSessionResult = {
251
272
  // in config.ts), so they arrive here as `resolved.thinkingLevel` — the first term.
252
273
  // That is why `deep`'s `high` still beats a lowered global default, and why there
253
274
  // is no profile special-casing in this function.
275
+ //
276
+ // `override` (a subagent's declared `thinkingLevel`) wins only when the requested
277
+ // profile actually resolved; a fallback to `default` ignores it.
254
278
  export function resolveSessionThinkingLevel(
255
279
  models: Models,
256
- resolved: Pick<ResolvedProfile, 'thinkingLevel' | 'profile'>,
280
+ resolved: Pick<ResolvedProfile, 'thinkingLevel' | 'profile'> & { fellBackToDefault?: boolean },
257
281
  activeRef: ModelRef,
282
+ override?: ThinkingLevel,
258
283
  ): ThinkingLevel | undefined {
284
+ if (override !== undefined && resolved.fellBackToDefault !== true) return override
259
285
  return resolved.thinkingLevel ?? models.default.thinkingLevel ?? defaultThinkingLevelForRef(activeRef)
260
286
  }
261
287
 
@@ -274,7 +300,10 @@ export function attachLoopGuardTurnTracking(
274
300
  }
275
301
 
276
302
  export async function createSessionWithDispose(options: CreateSessionOptions = {}): Promise<CreateSessionResult> {
277
- const resolved = resolveProfile(getConfig().models, options.profile)
303
+ // Profiles resolve against the session's effective models: the global block
304
+ // with any `modelOverrides` matching this session's channel layered on top.
305
+ const models = effectiveModels(getConfig(), options.origin)
306
+ const resolved = resolveProfile(models, options.profile)
278
307
  // Unknown profiles silently fall back to `default`. The fallback is by design
279
308
  // (see `resolveProfile`) and surfacing a warning here just creates noise on
280
309
  // every memory-logger / dreaming subagent spawn for advanced users who know
@@ -329,13 +358,28 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
329
358
  let loopGuardTurnId = 0
330
359
  const getLoopGuardTurn = () => loopGuardTurnId
331
360
  const guards = buildInternalGuards(options.plugins?.agentDir ?? process.cwd())
361
+ const codingTool = createCodingAgentTool({
362
+ agentDir: options.plugins?.agentDir ?? process.cwd(),
363
+ sessionId: options.plugins?.sessionId ?? sessionManager.getSessionId(),
364
+ getOrigin,
365
+ permissions: options.permissions ?? noopPermissionService,
366
+ })
332
367
 
333
368
  // Subagent built-in tool refs resolve to `ToolDefinition`s (see
334
369
  // plugin-tools.ts). Their NAMES narrow the session via `tools:`; their wrapped
335
370
  // implementations arrive through `customTools` (either `builtinPiToolOverrides`
336
371
  // for pi coding builtins, or `customSystemTools` for typeclaw web tools).
337
- const resolvedSubagentBuiltins = options.pluginSubagent?.toolRefs
338
- ? resolveBuiltinToolRefs(options.pluginSubagent.toolRefs, options.plugins?.agentDir ?? process.cwd())
372
+ const declaredRefs = options.pluginSubagent?.toolRefs
373
+ const writeCapable =
374
+ declaredRefs?.some((ref) => ref.__builtinTool === 'bash') &&
375
+ declaredRefs.some((ref) => ref.__builtinTool === 'write' || ref.__builtinTool === 'edit') &&
376
+ options.bashPolicy === undefined
377
+ const resolvedSubagentBuiltins = declaredRefs
378
+ ? resolveBuiltinToolRefs(
379
+ declaredRefs.filter((ref) => ref.__builtinTool !== 'coding_agent' || writeCapable),
380
+ options.plugins?.agentDir ?? process.cwd(),
381
+ new Map([['coding_agent', codingTool]]),
382
+ )
339
383
  : []
340
384
  const subagentBuiltinNames = resolvedSubagentBuiltins.map((t) => t.name)
341
385
  const subagentTypeclawToolDefinitions = resolvedSubagentBuiltins.filter((t) => !isPiCodingBuiltinName(t.name))
@@ -413,6 +457,7 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
413
457
  agentDir: options.plugins?.agentDir,
414
458
  parentSessionId: sessionManager.getSessionId(),
415
459
  getOrigin,
460
+ getSessionFile: () => sessionManager.getSessionFile(),
416
461
  permissions: options.permissions,
417
462
  stream: options.stream,
418
463
  allowBackgroundFromSubagent: options.allowBackgroundFromSubagent,
@@ -421,7 +466,10 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
421
466
  }),
422
467
  ]
423
468
  : [
424
- ...buildCoreSystemTools(options.permissions),
469
+ ...buildCoreSystemTools(options.permissions, codingTool).filter(
470
+ (tool) =>
471
+ tool.name !== 'coding_agent' || options.tools === undefined || options.tools.includes('coding_agent'),
472
+ ),
425
473
  ...(options.mcpManager
426
474
  ? buildMcpDispatcherToolDefinitions(options.mcpManager, {
427
475
  permissions: options.permissions,
@@ -457,6 +505,7 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
457
505
  agentDir: options.plugins?.agentDir,
458
506
  parentSessionId: sessionManager.getSessionId(),
459
507
  getOrigin,
508
+ getSessionFile: () => sessionManager.getSessionFile(),
460
509
  permissions: options.permissions,
461
510
  stream: options.stream,
462
511
  coalescer: options.subagentCoalescer,
@@ -521,7 +570,7 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
521
570
  const model = applyModelRuntimeOverrides(resolveModel(activeRef), activeRef)
522
571
  // Read live so a reloaded `models` lands on the next session without a
523
572
  // container restart.
524
- const thinkingLevel = resolveSessionThinkingLevel(getConfig().models, resolved, activeRef)
573
+ const thinkingLevel = resolveSessionThinkingLevel(models, resolved, activeRef, options.thinkingLevel)
525
574
  const { session } = await createAgentSession({
526
575
  model,
527
576
  modelRuntime,
@@ -533,6 +582,26 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
533
582
  customTools,
534
583
  ...(thinkingLevel ? { thinkingLevel } : {}),
535
584
  })
585
+ // Pi's general warmer also runs without background children. TypeClaw owns
586
+ // the narrower idle-parent policy and never persists synthetic ping results.
587
+ session.setCacheWarmingMode('off')
588
+ const cacheKeepalive = options.liveSubagentRegistry
589
+ ? new SubagentCacheKeepalive(
590
+ options.plugins?.sessionId ?? sessionManager.getSessionId(),
591
+ options.liveSubagentRegistry,
592
+ (requestModel, context, streamOptions) => modelRuntime.streamSimple(requestModel, context, streamOptions),
593
+ )
594
+ : undefined
595
+ const unsubCacheKeepalive = session.subscribe((event) => {
596
+ if (event.type === 'agent_start') cacheKeepalive?.startTurn()
597
+ if (event.type === 'agent_settled') cacheKeepalive?.settle()
598
+ })
599
+ const innerDispose = session.dispose.bind(session)
600
+ session.dispose = () => {
601
+ cacheKeepalive?.close()
602
+ unsubCacheKeepalive()
603
+ innerDispose()
604
+ }
536
605
 
537
606
  // Wrapping also means `agent.streamFunction !== streamSimple`, which puts pi's
538
607
  // summarization auth on its lenient branch (agent-session.js:214-232): a
@@ -544,7 +613,20 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
544
613
  const maxTokens =
545
614
  streamOptions?.maxTokens ??
546
615
  (requestModel.maxTokens > 0 ? Math.min(requestModel.maxTokens, DEFAULT_MAX_OUTPUT_TOKENS) : undefined)
547
- return await innerStreamFunction(requestModel, context, { ...streamOptions, maxTokens })
616
+ const promptCacheKey = promptCacheKeyForOrigin(getOrigin())
617
+ const onPayload = async (payload: unknown, payloadModel: typeof requestModel) => {
618
+ const next = (await streamOptions?.onPayload?.(payload, payloadModel)) ?? payload
619
+ const final = promptCacheKey === undefined ? next : withPromptCacheKey(next, promptCacheKey)
620
+ if (streamOptions?.sessionId === session.sessionId) {
621
+ cacheKeepalive?.capture(payloadModel, context, { ...streamOptions, maxTokens }, final)
622
+ }
623
+ return final
624
+ }
625
+ return await innerStreamFunction(requestModel, context, {
626
+ ...streamOptions,
627
+ maxTokens,
628
+ onPayload,
629
+ })
548
630
  }
549
631
 
550
632
  // typeclaw owns retry/fallback in its turn drivers, so the SDK's own
@@ -553,7 +635,8 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
553
635
  // while typeclaw has already latched the failure, reporting a recovered turn as
554
636
  // failed (and burning an unnecessary failover). Disabling it makes a soft error
555
637
  // a deterministic, typeclaw-owned signal. Compaction/context-overflow recovery
556
- // is independent (gated on compaction settings), so this does not disable those.
638
+ // is independent (gated on compaction settings), so this does not disable those;
639
+ // marked local failures are kept out of overflow recovery at the marker below.
557
640
  session.setAutoRetryEnabled(false)
558
641
  const getAbortReason = () => abortHolder.reason
559
642
  const sessionWithAbortReason = Object.assign(session, { getAbortReason })
@@ -576,6 +659,20 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
576
659
  }
577
660
  }
578
661
 
662
+ // pi turns a throw from context preparation into the same `stopReason:'error'`
663
+ // message a provider failure produces, with only the error text kept, so the
664
+ // origin has to be stamped where it is thrown. Installed last so it is the
665
+ // outermost layer over pi's extension `context` pass (which clones the
666
+ // messages) and its forced-prompt projection. getApiKey and streamFunction
667
+ // stay unwrapped: their failures can be genuine provider/auth failures.
668
+ // Overflow recovery stays enabled; a local failure whose text would read as a
669
+ // provider overflow is stamped with fixed text and its raw text is logged here.
670
+ session.agent.transformContext = wrapTransformContextWithLocalFailureMarker(session.agent.transformContext, {
671
+ getProvider: () => session.agent.state.model?.provider,
672
+ logWithheld: (line) =>
673
+ console.error(`[agent] ${options.plugins?.sessionId ?? sessionManager.getSessionId()}: ${line}`),
674
+ })
675
+
579
676
  abortHolder.abort = (reason?: string) => {
580
677
  if (reason !== undefined) abortHolder.reason = reason
581
678
  if (session.agent.signal?.aborted !== true) session.agent.abort()
@@ -584,6 +681,9 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
584
681
  const unsubRestart = subscribeRestartNotice(options.stream, sessionManager)
585
682
 
586
683
  const unsubToolNudge = attachToolNotFoundNudge(session, intendedActiveToolNames)
684
+ // An applied idle summary replaces the prefix the keepalive captured;
685
+ // replaying the old one would only refresh a cache no turn will read.
686
+ const stopIdleCompaction = attachIdleCompaction(session, { onApplied: () => cacheKeepalive?.invalidate() })
587
687
 
588
688
  // Registered only once creation can no longer fail, so a rejected creation
589
689
  // leaves no scope entry behind; tools resolve the scope lazily at call time.
@@ -595,6 +695,9 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
595
695
  )
596
696
  : undefined
597
697
  const dispose = async () => {
698
+ stopIdleCompaction()
699
+ cacheKeepalive?.close()
700
+ unsubCacheKeepalive()
598
701
  releaseSubagentTmp?.()
599
702
  unsubLoopGuardTurn()
600
703
  unsubRestart?.()
@@ -637,7 +740,12 @@ export function buildRestartHandoffWiring(
637
740
  // session. Returns undefined for non-channel/no-author origins.
638
741
  export function currentChannelAuthor(getOrigin: () => SessionOrigin | undefined): string | undefined {
639
742
  const origin = getOrigin()
640
- return origin?.kind === 'channel' ? origin.lastInboundAuthorId : undefined
743
+ if (origin?.kind !== 'channel') return undefined
744
+ // The legacy restart record carries only a target-local author ID. Foreign
745
+ // requesters must remain authorless there, matching their target role rules.
746
+ if (adapterNamespace(origin.lastInboundAuthorAdapter ?? origin.adapter) !== adapterNamespace(origin.adapter))
747
+ return undefined
748
+ return origin.lastInboundAuthorId
641
749
  }
642
750
 
643
751
  function restartHandoffOriginFor(origin: SessionOrigin): RestartHandoffOrigin | null {
@@ -763,6 +871,10 @@ export function buildChannelTools(
763
871
  ): ToolDefinition[] {
764
872
  if (!channelRouter) return []
765
873
  const tools: ToolDefinition[] = []
874
+ const getOutboundOrigin = (): ChannelOutboundOrigin | undefined => {
875
+ const current = getOrigin ? getOrigin() : origin
876
+ return current ? { kind: current.kind, ...(current.kind === 'cron' ? { jobId: current.jobId } : {}) } : undefined
877
+ }
766
878
  if (origin?.kind === 'channel') {
767
879
  // adapter/workspace/chat/thread are session-key fields and never vary across
768
880
  // a session's turns, so they stay snapshotted. The review round does: it is
@@ -783,21 +895,23 @@ export function buildChannelTools(
783
895
  createChannelReplyTool({
784
896
  router: channelRouter,
785
897
  origin: channelOrigin,
898
+ getOutboundOrigin,
786
899
  ...(sessionId !== undefined ? { sessionId } : {}),
787
900
  }),
788
901
  )
789
902
  if (origin.adapter === 'github' && sessionId !== undefined)
790
903
  tools.push(createPostGithubReviewTool({ router: channelRouter, origin: channelOrigin, sessionId }))
791
904
  tools.push(createChannelHistoryTool({ router: channelRouter, origin: channelOrigin }))
792
- tools.push(createChannelReadTool({ router: channelRouter }))
905
+ tools.push(createChannelReadTool({ router: channelRouter, ...(sessionId !== undefined ? { sessionId } : {}) }))
793
906
  tools.push(
794
907
  createChannelSendTool({
795
908
  router: channelRouter,
796
909
  origin: channelOrigin,
910
+ getOutboundOrigin,
797
911
  ...(sessionId !== undefined ? { sessionId } : {}),
798
912
  }),
799
913
  )
800
- tools.push(createChannelEditTool({ router: channelRouter }))
914
+ tools.push(createChannelEditTool({ router: channelRouter, getOutboundOrigin }))
801
915
  // Read the live turn origin, falling back to the static snapshot when no
802
916
  // getter is wired (composition tests). `reactionRef` is per-turn, so the
803
917
  // getter is what makes reactions work outside tests.
@@ -826,11 +940,13 @@ export function buildChannelTools(
826
940
  tools.push(createChannelDisengageTool({ router: channelRouter, origin: channelOrigin }))
827
941
  if (sessionId !== undefined) {
828
942
  tools.push(createSkipResponseTool({ router: channelRouter, sessionId }))
943
+ tools.push(createChannelHandoffTool({ router: channelRouter, sessionId }))
944
+ tools.push(createChannelSessionSearchTool({ router: channelRouter, sessionId }))
829
945
  }
830
946
  } else {
831
- tools.push(createChannelSendTool({ router: channelRouter }))
947
+ tools.push(createChannelSendTool({ router: channelRouter, getOutboundOrigin }))
832
948
  tools.push(createChannelReadTool({ router: channelRouter }))
833
- tools.push(createChannelEditTool({ router: channelRouter }))
949
+ tools.push(createChannelEditTool({ router: channelRouter, getOutboundOrigin }))
834
950
  }
835
951
  return tools
836
952
  }
@@ -886,6 +1002,7 @@ export function buildSubagentOrchestrationTools(opts: {
886
1002
  agentDir: string | undefined
887
1003
  parentSessionId: string
888
1004
  getOrigin: () => SessionOrigin | undefined
1005
+ getSessionFile?: () => string | undefined
889
1006
  permissions: PermissionService | undefined
890
1007
  stream: Stream | undefined
891
1008
  allowBackgroundFromSubagent?: boolean
@@ -908,6 +1025,10 @@ export function buildSubagentOrchestrationTools(opts: {
908
1025
  agentDir: opts.agentDir,
909
1026
  parentSessionId: opts.parentSessionId,
910
1027
  getOrigin: opts.getOrigin,
1028
+ ...(opts.getSessionFile !== undefined ? { getSessionFile: opts.getSessionFile } : {}),
1029
+ ...(opts.channelRouter === undefined
1030
+ ? {}
1031
+ : { getAccountIdentity: opts.channelRouter.getRecoveryAccountIdentity, router: opts.channelRouter }),
911
1032
  ...(opts.permissions ? { permissions: opts.permissions } : {}),
912
1033
  ...(opts.stream ? { stream: opts.stream } : {}),
913
1034
  ...(opts.allowBackgroundFromSubagent !== undefined
@@ -919,6 +1040,7 @@ export function buildSubagentOrchestrationTools(opts: {
919
1040
  liveRegistry: opts.liveRegistry,
920
1041
  getOrigin: opts.getOrigin,
921
1042
  callerSessionId: opts.parentSessionId,
1043
+ ...(opts.channelRouter ? { router: opts.channelRouter } : {}),
922
1044
  ...(opts.permissions ? { permissions: opts.permissions } : {}),
923
1045
  }),
924
1046
  createSubagentCancelTool({
@@ -963,8 +1085,11 @@ export function buildTodoTools(
963
1085
  return createTodoTools({ agentDir, getOrigin })
964
1086
  }
965
1087
 
966
- function buildCoreSystemTools(permissions: PermissionService | undefined): ToolDefinition[] {
967
- const definitions = [webSearchTool, webFetchTool, createLookAtTool(permissions)]
1088
+ function buildCoreSystemTools(
1089
+ permissions: PermissionService | undefined,
1090
+ codingTool: ToolDefinition,
1091
+ ): ToolDefinition[] {
1092
+ const definitions = [webSearchTool, webFetchTool, createLookAtTool(permissions), codingTool]
968
1093
  const byName = new Map(definitions.map((tool) => [tool.name, tool]))
969
1094
  if (byName.size !== definitions.length || byName.size !== CORE_SYSTEM_TOOL_NAMES.length) {
970
1095
  throw new Error('core system tool catalog does not match its registered definitions')
@@ -1101,31 +1226,31 @@ export type CreateResourceLoaderOptions = {
1101
1226
  mcpManager?: McpManager
1102
1227
  permissions?: PermissionService
1103
1228
  runtimeVersion?: string
1104
- // Public subagents whose names + `rosterDescription`s render the full-mode
1105
- // "## Subagent orchestration" roster. When omitted (no-registry callers, the
1106
- // debug dumper), the prompt falls back to `DEFAULT_SUBAGENT_ROSTER`. Threaded
1107
- // from `createSessionWithDispose`, where the merged registry is already in
1108
- // scope.
1229
+ // Public subagents whose names + `rosterDescription`s render the roster in
1230
+ // the full-mode interactive context. When omitted (registry-free callers,
1231
+ // the debug dumper), the context falls back to `DEFAULT_SUBAGENT_ROSTER`.
1232
+ // Threaded from `createSessionWithDispose`, where the merged registry is
1233
+ // already in scope.
1109
1234
  subagentRegistry?: SubagentRegistry
1110
- // Explicit override for the prompt mode. When omitted, the mode is derived
1111
- // from `origin.kind`: cron + subagent → slim, tui + channel → full. Pass
1112
- // 'full' to force the heavy prompt even on an unattended origin (rarely
1235
+ // Explicit override for the session-context mode. When omitted, the mode is
1236
+ // derived from `origin.kind`. It never changes the shared policy; pass
1237
+ // 'full' to add the interactive context to an unattended origin (rarely
1113
1238
  // useful; mostly an escape hatch for ad-hoc debugging).
1114
1239
  mode?: SystemPromptMode
1115
1240
  proactiveNextStepNudge?: boolean
1116
1241
  }
1117
1242
 
1118
- // Origins where the operator-facing DEFAULT_SYSTEM_PROMPT, git-nudge, and the
1119
- // agent-folder commit guidance carry their weight: there is a human reading
1120
- // the output, the agent is expected to maintain its folder over time, and
1121
- // conversational register matters. For everything else (cron fires, default
1122
- // subagents), the slim prompt is the right default — the origin block already
1123
- // names the unattended context and tells the agent what's expected of it.
1243
+ // Origins with a conversation partner waiting on the reply get the full-mode
1244
+ // session context: the interactive orchestration context with the live public
1245
+ // roster, the MCP catalog, and the git nudge. Unattended origins (cron fires,
1246
+ // default subagents, system processes) skip that context and the roster/git/MCP
1247
+ // work it needs — their origin block already says what is expected. Every
1248
+ // origin gets the same shared policy either way.
1124
1249
  //
1125
1250
  // Exhaustive switch (not a boolean expression) so a future origin kind forces
1126
1251
  // the author to make an explicit full-or-slim decision at compile time. The
1127
1252
  // previous form silently defaulted new origins to slim, which would have
1128
- // stripped the operator-facing prompt from a new interactive surface by
1253
+ // stripped the interactive context from a new interactive surface by
1129
1254
  // accident.
1130
1255
  export function deriveSystemPromptMode(origin: SessionOrigin | undefined): SystemPromptMode {
1131
1256
  if (origin === undefined) return 'full'
@@ -1152,28 +1277,27 @@ export function deriveSystemPromptMode(origin: SessionOrigin | undefined): Syste
1152
1277
  // pipeline `createResourceLoader` uses, with no risk of drift if the
1153
1278
  // section order changes.
1154
1279
  //
1155
- // `mode` selects the base prompt:
1156
- // - 'full' (default) — DEFAULT_SYSTEM_PROMPT (~2155 tok of operator-facing
1157
- // guidance: agent folder layout, version-control rules, register matching,
1158
- // workspace boundary). Right choice for TUI and channel sessions where a
1159
- // human is reading the output and the agent maintains its folder.
1160
- // - 'slim' — SLIM_SYSTEM_PROMPT (~80 tok). Right choice for cron jobs and
1161
- // default subagents — unattended sessions where most of the operator
1162
- // guidance is irrelevant and the origin block already covers per-kind
1163
- // specifics (no human, side effects via tools, narrow scope).
1280
+ // `mode` selects only the optional session context, never the policy: every
1281
+ // standard session starts with `buildSystemPolicy(branding)`.
1282
+ // - 'full' (default) — TUI, channel, and origin-less sessions: appends the
1283
+ // interactive context (`renderInteractiveSessionContext`) with the roster.
1284
+ // - 'slim' — cron, default subagents, system processes: no interactive
1285
+ // context; the origin block covers per-kind specifics (no human, side
1286
+ // effects via tools, narrow scope).
1164
1287
  export type SystemPromptMode = 'full' | 'slim'
1165
1288
 
1166
1289
  export type SystemPromptComposition = {
1167
1290
  mode?: SystemPromptMode
1168
1291
  // Whether the prompt discloses that the agent runs on TypeClaw. When false,
1169
- // the base prompt's opening is phrased generically and the `## Runtime`
1170
- // version block is dropped. Defaults to true. Mirrors `config.branding`.
1292
+ // the policy's opening is phrased generically, the `## Runtime` version
1293
+ // block is dropped, and the runtime-disclosure rule is appended. Defaults to
1294
+ // true. Mirrors `config.branding`.
1171
1295
  branding?: boolean
1172
1296
  self: string
1173
- // Pre-rendered full-mode orchestration roster (from `renderPublicSubagentRoster`).
1297
+ // Pre-rendered interactive-context roster (from `renderPublicSubagentRoster`).
1174
1298
  // Kept as a ready string so this composer stays pure and registry-free; the
1175
- // registry-aware caller renders it. Ignored in slim mode (no roster section).
1176
- // Falls back to `DEFAULT_SUBAGENT_ROSTER` when omitted.
1299
+ // registry-aware caller renders it. Ignored in slim mode (no interactive
1300
+ // context). Falls back to `DEFAULT_SUBAGENT_ROSTER` when omitted.
1177
1301
  subagentRoster?: string
1178
1302
  runtimeVersion?: string
1179
1303
  origin?: SessionOrigin
@@ -1191,12 +1315,19 @@ export type SystemPromptComposition = {
1191
1315
  // section changes (the provider's prompt cache hits up to the first byte
1192
1316
  // that differs).
1193
1317
  //
1194
- // 0. runtime block — most stable: only changes on typeclaw releases (rare).
1195
- // 1. origin block — stable across all sessions of the same kind.
1196
- // 2. gitNudge — rare changes; agent folders force-commit sessions/ and
1318
+ // 0. shared policy — identical for every standard session of an agent.
1319
+ // 1. self — IDENTITY.md + SOUL.md (plus any plugin `session.prompt` append).
1320
+ // 2. runtime block (or the runtime-disclosure rule when branding is off) —
1321
+ // only changes on typeclaw releases.
1322
+ // 3. interactive context (full mode) — stable per agent registry, so it
1323
+ // precedes the per-session origin block.
1324
+ // 4. origin block + role — stable across sessions of the same kind; channel
1325
+ // origins carry per-conversation details.
1326
+ // 5. MCP catalog — changes when servers connect or disconnect.
1327
+ // 6. gitNudge — rare changes; agent folders force-commit sessions/ and
1197
1328
  // memory/ after every turn, so the dirty-files list is empty most of
1198
1329
  // the time.
1199
- // 3. proactive next-step nudge — deterministic per model family.
1330
+ // 7. proactive next-step nudge — deterministic per model family.
1200
1331
  //
1201
1332
  // The wall-clock anchor that used to live here as `## Now` moved out
1202
1333
  // entirely. It is now injected into the user turn at each `session.prompt`
@@ -1204,20 +1335,23 @@ export type SystemPromptComposition = {
1204
1335
  // stamp reflects the moment of THIS turn, not session creation. Per-turn
1205
1336
  // injection costs zero cached bytes — the user turn is the non-cacheable
1206
1337
  // suffix anyway — and removes the staleness failure mode where a session
1207
- // opened Friday answered "today is Friday" on Thursday.
1338
+ // opened Friday answered "today is Friday" on Thursday. Retrieved memory and
1339
+ // the live channel role ride in the user turn for the same reason.
1340
+ //
1341
+ // pi appends project context (AGENTS.md), the skill catalog, and the cwd
1342
+ // after this preamble when it builds the final system message.
1208
1343
  export function composeSystemPrompt(parts: SystemPromptComposition): string {
1209
1344
  const branding = parts.branding ?? true
1210
- const base =
1211
- parts.mode === 'slim'
1212
- ? buildSlimSystemPrompt(branding)
1213
- : buildDefaultSystemPrompt(parts.subagentRoster ?? DEFAULT_SUBAGENT_ROSTER, branding)
1214
- let prompt = `${base}\n\n${parts.self}`
1345
+ let prompt = `${buildSystemPolicy(branding)}\n\n${parts.self}`
1215
1346
  if (branding && parts.runtimeVersion !== undefined) {
1216
1347
  prompt = `${prompt}\n\n${renderRuntimeBlock(parts.runtimeVersion)}`
1217
1348
  }
1218
1349
  if (!branding) {
1219
1350
  prompt = `${prompt}\n\n${renderRuntimeNondisclosureRule()}`
1220
1351
  }
1352
+ if (parts.mode !== 'slim') {
1353
+ prompt = `${prompt}\n\n${renderInteractiveSessionContext(parts.subagentRoster ?? DEFAULT_SUBAGENT_ROSTER)}`
1354
+ }
1221
1355
  if (parts.origin !== undefined) {
1222
1356
  prompt = `${prompt}\n\n${renderSessionOrigin(parts.origin, Date.now(), parts.roleContext)}`
1223
1357
  }
@@ -1236,10 +1370,10 @@ export function composeSystemPrompt(parts: SystemPromptComposition): string {
1236
1370
  export async function createResourceLoader(options: CreateResourceLoaderOptions = {}): Promise<DefaultResourceLoader> {
1237
1371
  const agentDir = options.agentDir ?? process.cwd()
1238
1372
  const mode: SystemPromptMode = options.mode ?? deriveSystemPromptMode(options.origin)
1239
- // Slim mode (cron/subagent) has no orchestration section, so it never reads
1240
- // the roster. Skip rendering it there — `renderPublicSubagentRoster` throws on
1241
- // a public subagent with a missing/blank `rosterDescription`, and a slim
1242
- // session must not fail on a roster it will never show.
1373
+ // Slim mode (cron/subagent/system) has no interactive context, so it never
1374
+ // reads the roster. Skip rendering it there — `renderPublicSubagentRoster`
1375
+ // throws on a public subagent with a missing/blank `rosterDescription`, and
1376
+ // a slim session must not fail on a roster it will never show.
1243
1377
  const subagentRoster =
1244
1378
  mode === 'slim'
1245
1379
  ? undefined
@@ -1247,10 +1381,7 @@ export async function createResourceLoader(options: CreateResourceLoaderOptions
1247
1381
  ? renderPublicSubagentRoster(options.subagentRegistry)
1248
1382
  : DEFAULT_SUBAGENT_ROSTER
1249
1383
  const branding = getConfig().branding
1250
- const basePrompt =
1251
- mode === 'slim'
1252
- ? buildSlimSystemPrompt(branding)
1253
- : buildDefaultSystemPrompt(subagentRoster ?? DEFAULT_SUBAGENT_ROSTER, branding)
1384
+ const policy = buildSystemPolicy(branding)
1254
1385
 
1255
1386
  // Kick off the independent I/O paths concurrently. Sequential awaits
1256
1387
  // here used to be the dominant cold-start cost amplifier: loadSelf is 2
@@ -1285,25 +1416,24 @@ export async function createResourceLoader(options: CreateResourceLoaderOptions
1285
1416
  let self = await selfPromise
1286
1417
 
1287
1418
  if (options.plugins) {
1288
- // The plugin hook receives the partially-assembled prompt (base + identity)
1289
- // so plugins can rewrite either section before the cache-suffix blocks are
1290
- // appended. The base reflects the resolved mode, so a slim cron session's
1291
- // plugin hook sees the slim base — plugins that read the base text get
1292
- // the same shape the agent will see.
1293
- const preHook = `${basePrompt}\n\n${self}`
1419
+ // The plugin hook receives the partially-assembled prompt (shared policy +
1420
+ // identity) so plugins can rewrite either section before the session
1421
+ // context and cache-suffix blocks are appended. Every standard origin
1422
+ // hands the hook the same policy text.
1423
+ const preHook = `${policy}\n\n${self}`
1294
1424
  const event = { prompt: preHook, sessionId: options.plugins.sessionId, agentDir, origin: options.origin }
1295
1425
  await options.plugins.hooks.runSessionPrompt(event)
1296
- // Recover `self` by stripping the leading base so the rest of the
1297
- // composition stays section-shaped. If a plugin rewrote the base prompt as
1426
+ // Recover `self` by stripping the leading policy so the rest of the
1427
+ // composition stays section-shaped. If a plugin rewrote the policy as
1298
1428
  // well, the recovered `self` carries the full mutated remainder.
1299
- self = event.prompt.startsWith(`${basePrompt}\n\n`) ? event.prompt.slice(basePrompt.length + 2) : event.prompt
1429
+ self = event.prompt.startsWith(`${policy}\n\n`) ? event.prompt.slice(policy.length + 2) : event.prompt
1300
1430
  }
1301
1431
 
1302
1432
  const roleContext = options.origin !== undefined ? resolveRoleContext(options.origin, options.permissions) : undefined
1303
- // Slim mode skips git-nudge entirely: cron + subagent sessions are not the
1304
- // right actor to drive interactive commit decisions, and the operator-facing
1305
- // commit guidance the nudge points back to is itself excluded from the slim
1306
- // base prompt.
1433
+ // Slim mode skips git-nudge entirely: cron, subagent, and system sessions
1434
+ // are not the right actor to drive commit decisions about dirty files they
1435
+ // did not touch. The shared policy's commit rules still cover their own
1436
+ // changes.
1307
1437
  const gitNudgeResult = await gitNudgeSettled
1308
1438
  const gitNudge = unwrapSettled(gitNudgeResult)
1309
1439
 
@@ -5,8 +5,8 @@ export type LiveAgentSession = {
5
5
  sessionId: string
6
6
  session: Pick<AgentSession, 'subscribe'>
7
7
  // Surfaced by the inspect picker for sessions not yet on disk: pi-coding-agent
8
- // defers the first .jsonl write until the first assistant message, so without
9
- // these a mid-reply session is invisible. Optional so subscribe-only test
8
+ // defers the first .jsonl write until the first user message, so without
9
+ // these a session that has not been prompted yet is invisible. Optional so subscribe-only test
10
10
  // harnesses can still register `{ sessionId, session }`; live-listing skips
11
11
  // entries lacking an origin.
12
12
  origin?: MinimalSessionOrigin