typeclaw 0.49.0 → 0.51.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (502) hide show
  1. package/dist/types/agent/attention-escalation.d.ts +18 -0
  2. package/dist/types/agent/auth.d.ts +7 -0
  3. package/dist/types/agent/bash-sandbox-env.d.ts +15 -0
  4. package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
  5. package/dist/types/agent/bash-sandbox.d.ts +94 -0
  6. package/dist/types/agent/compaction.d.ts +8 -0
  7. package/dist/types/agent/git-nudge.d.ts +6 -0
  8. package/dist/types/agent/guard-types.d.ts +25 -0
  9. package/dist/types/agent/guards.d.ts +7 -0
  10. package/dist/types/agent/idle-compaction.d.ts +8 -0
  11. package/dist/types/agent/index.d.ts +151 -0
  12. package/dist/types/agent/live-subagents.d.ts +113 -0
  13. package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
  14. package/dist/types/agent/loop-guard.d.ts +67 -0
  15. package/dist/types/agent/model-fallback.d.ts +29 -0
  16. package/dist/types/agent/model-overrides.d.ts +8 -0
  17. package/dist/types/agent/multimodal/index.d.ts +2 -0
  18. package/dist/types/agent/multimodal/look-at.d.ts +60 -0
  19. package/dist/types/agent/multimodal/looker.d.ts +61 -0
  20. package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
  21. package/dist/types/agent/network/response-body.d.ts +1 -0
  22. package/dist/types/agent/network/safe-http.d.ts +46 -0
  23. package/dist/types/agent/output-allowance.d.ts +4 -0
  24. package/dist/types/agent/plugin-tools.d.ts +58 -0
  25. package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
  26. package/dist/types/agent/prompt-cache-key.d.ts +3 -0
  27. package/dist/types/agent/provider-error.d.ts +23 -0
  28. package/dist/types/agent/reload-tool.d.ts +10 -0
  29. package/dist/types/agent/restart/index.d.ts +31 -0
  30. package/dist/types/agent/restart-handoff/index.d.ts +32 -0
  31. package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
  32. package/dist/types/agent/retry-same-ref.d.ts +41 -0
  33. package/dist/types/agent/reviewer-activity.d.ts +3 -0
  34. package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
  35. package/dist/types/agent/self.d.ts +1 -0
  36. package/dist/types/agent/session-meta.d.ts +28 -0
  37. package/dist/types/agent/session-origin.d.ts +65 -0
  38. package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
  39. package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
  40. package/dist/types/agent/subagent-drain.d.ts +25 -0
  41. package/dist/types/agent/subagent-session.d.ts +3 -0
  42. package/dist/types/agent/subagents.d.ts +153 -0
  43. package/dist/types/agent/system-prompt-composition.d.ts +17 -0
  44. package/dist/types/agent/system-prompt.d.ts +7 -0
  45. package/dist/types/agent/throttle-circuit.d.ts +25 -0
  46. package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
  47. package/dist/types/agent/todo/continuation-state.d.ts +11 -0
  48. package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
  49. package/dist/types/agent/todo/continuation.d.ts +21 -0
  50. package/dist/types/agent/todo/scope.d.ts +6 -0
  51. package/dist/types/agent/todo/store.d.ts +16 -0
  52. package/dist/types/agent/tool-error-remediation.d.ts +1 -0
  53. package/dist/types/agent/tool-file-safety.d.ts +78 -0
  54. package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
  55. package/dist/types/agent/tool-result-budget.d.ts +15 -0
  56. package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
  57. package/dist/types/agent/tools/channel-edit.d.ts +19 -0
  58. package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
  59. package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
  60. package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
  61. package/dist/types/agent/tools/channel-history.d.ts +25 -0
  62. package/dist/types/agent/tools/channel-log.d.ts +5 -0
  63. package/dist/types/agent/tools/channel-react.d.ts +23 -0
  64. package/dist/types/agent/tools/channel-read.d.ts +27 -0
  65. package/dist/types/agent/tools/channel-reply.d.ts +47 -0
  66. package/dist/types/agent/tools/channel-send.d.ts +42 -0
  67. package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
  68. package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
  69. package/dist/types/agent/tools/ddg.d.ts +27 -0
  70. package/dist/types/agent/tools/grant-role.d.ts +25 -0
  71. package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
  72. package/dist/types/agent/tools/post-github-review.d.ts +38 -0
  73. package/dist/types/agent/tools/restart.d.ts +25 -0
  74. package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
  75. package/dist/types/agent/tools/search-retry.d.ts +16 -0
  76. package/dist/types/agent/tools/skip-response.d.ts +17 -0
  77. package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
  78. package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
  79. package/dist/types/agent/tools/subagent-access.d.ts +20 -0
  80. package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
  81. package/dist/types/agent/tools/subagent-output.d.ts +50 -0
  82. package/dist/types/agent/tools/todo/index.d.ts +14 -0
  83. package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
  84. package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
  85. package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
  86. package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
  87. package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
  88. package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
  89. package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
  90. package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
  91. package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
  92. package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
  93. package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
  94. package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
  95. package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
  96. package/dist/types/agent/tools/websearch.d.ts +17 -0
  97. package/dist/types/agent/tools/wikipedia.d.ts +7 -0
  98. package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
  99. package/dist/types/agent/turn-runner.d.ts +36 -0
  100. package/dist/types/agent-messenger/config-dir.d.ts +19 -0
  101. package/dist/types/browser/dockerfile.d.ts +2 -0
  102. package/dist/types/browser/registry.d.ts +49 -0
  103. package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
  104. package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
  105. package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
  106. package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
  107. package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
  108. package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
  109. package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
  110. package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
  111. package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
  112. package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
  113. package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
  114. package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
  115. package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
  116. package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
  117. package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
  118. package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
  119. package/dist/types/channels/adapter-namespace.d.ts +2 -0
  120. package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
  121. package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
  122. package/dist/types/channels/background-handoff.d.ts +56 -0
  123. package/dist/types/channels/background-obligations.d.ts +135 -0
  124. package/dist/types/channels/catch-up.d.ts +26 -0
  125. package/dist/types/channels/commands.d.ts +2 -0
  126. package/dist/types/channels/completion-claim.d.ts +20 -0
  127. package/dist/types/channels/continuation-willingness.d.ts +1 -0
  128. package/dist/types/channels/continuity-types.d.ts +75 -0
  129. package/dist/types/channels/describe-error.d.ts +1 -0
  130. package/dist/types/channels/engagement.d.ts +34 -0
  131. package/dist/types/channels/github-false-receipt.d.ts +20 -0
  132. package/dist/types/channels/github-repo.d.ts +2 -0
  133. package/dist/types/channels/github-rereview-guard.d.ts +24 -0
  134. package/dist/types/channels/github-review-check.d.ts +135 -0
  135. package/dist/types/channels/github-review-claim.d.ts +3 -0
  136. package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
  137. package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
  138. package/dist/types/channels/github-token-bridge.d.ts +20 -0
  139. package/dist/types/channels/github-verdict-activity.d.ts +12 -0
  140. package/dist/types/channels/inbound-journal.d.ts +272 -0
  141. package/dist/types/channels/last-alive.d.ts +3 -0
  142. package/dist/types/channels/membership-cache.d.ts +27 -0
  143. package/dist/types/channels/membership.d.ts +21 -0
  144. package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
  145. package/dist/types/channels/participants.d.ts +4 -0
  146. package/dist/types/channels/persistence.d.ts +32 -0
  147. package/dist/types/channels/recovery-notice.d.ts +26 -0
  148. package/dist/types/channels/recovery-outbox.d.ts +58 -0
  149. package/dist/types/channels/router.d.ts +760 -0
  150. package/dist/types/channels/schema.d.ts +501 -0
  151. package/dist/types/channels/session-handoff.d.ts +58 -0
  152. package/dist/types/channels/session-search.d.ts +29 -0
  153. package/dist/types/channels/types.d.ts +414 -0
  154. package/dist/types/channels/waiting-reactions.d.ts +25 -0
  155. package/dist/types/cli/builtins.d.ts +2 -0
  156. package/dist/types/cli/command-meta.d.ts +9 -0
  157. package/dist/types/coding-agent/broker-body.d.ts +7 -0
  158. package/dist/types/coding-agent/broker.d.ts +22 -0
  159. package/dist/types/coding-agent/claude.d.ts +22 -0
  160. package/dist/types/coding-agent/codex.d.ts +19 -0
  161. package/dist/types/coding-agent/index.d.ts +71 -0
  162. package/dist/types/coding-agent/omo-state.d.ts +2 -0
  163. package/dist/types/coding-agent/omo-stream.d.ts +22 -0
  164. package/dist/types/coding-agent/omo.d.ts +133 -0
  165. package/dist/types/coding-agent/runner.d.ts +35 -0
  166. package/dist/types/coding-agent/tool.d.ts +27 -0
  167. package/dist/types/coding-agent/worktree.d.ts +22 -0
  168. package/dist/types/commands/index.d.ts +45 -0
  169. package/dist/types/config/config.d.ts +827 -0
  170. package/dist/types/config/index.d.ts +3 -0
  171. package/dist/types/config/model-overrides.d.ts +3 -0
  172. package/dist/types/config/providers.d.ts +1458 -0
  173. package/dist/types/config/reloadable.d.ts +9 -0
  174. package/dist/types/container/agent-operation-lock.d.ts +31 -0
  175. package/dist/types/container/build-cache.d.ts +39 -0
  176. package/dist/types/container/compose-project.d.ts +1 -0
  177. package/dist/types/container/controller.d.ts +25 -0
  178. package/dist/types/container/docker-app.d.ts +23 -0
  179. package/dist/types/container/exit-reason.d.ts +10 -0
  180. package/dist/types/container/index.d.ts +14 -0
  181. package/dist/types/container/log-archive.d.ts +68 -0
  182. package/dist/types/container/log-colors.d.ts +3 -0
  183. package/dist/types/container/log-timestamps.d.ts +9 -0
  184. package/dist/types/container/logs.d.ts +37 -0
  185. package/dist/types/container/memory-limit.d.ts +13 -0
  186. package/dist/types/container/memory-oversubscription.d.ts +20 -0
  187. package/dist/types/container/oom-events.d.ts +18 -0
  188. package/dist/types/container/port.d.ts +18 -0
  189. package/dist/types/container/require-running.d.ts +16 -0
  190. package/dist/types/container/restart.d.ts +32 -0
  191. package/dist/types/container/shared.d.ts +93 -0
  192. package/dist/types/container/shell.d.ts +35 -0
  193. package/dist/types/container/start.d.ts +145 -0
  194. package/dist/types/container/stats.d.ts +31 -0
  195. package/dist/types/container/status.d.ts +25 -0
  196. package/dist/types/container/stop.d.ts +24 -0
  197. package/dist/types/container/tool-oom-priority.d.ts +4 -0
  198. package/dist/types/container/verify-running.d.ts +49 -0
  199. package/dist/types/cron/consumer.d.ts +42 -0
  200. package/dist/types/cron/count-state.d.ts +24 -0
  201. package/dist/types/cron/index.d.ts +21 -0
  202. package/dist/types/cron/list.d.ts +33 -0
  203. package/dist/types/cron/reloadable.d.ts +11 -0
  204. package/dist/types/cron/scheduler.d.ts +51 -0
  205. package/dist/types/cron/schema.d.ts +108 -0
  206. package/dist/types/dependencies/bin-resolver.d.ts +28 -0
  207. package/dist/types/dependencies/bins.d.ts +22 -0
  208. package/dist/types/dependencies/index.d.ts +2 -0
  209. package/dist/types/eval/cell.d.ts +26 -0
  210. package/dist/types/eval/config.d.ts +19 -0
  211. package/dist/types/eval/dispatch.d.ts +7 -0
  212. package/dist/types/eval/kernel.d.ts +28 -0
  213. package/dist/types/eval/process.d.ts +23 -0
  214. package/dist/types/eval/protocol.d.ts +34 -0
  215. package/dist/types/eval/sandbox.d.ts +10 -0
  216. package/dist/types/eval/tool.d.ts +17 -0
  217. package/dist/types/eval/wire.d.ts +33 -0
  218. package/dist/types/git/bound-gc-config.d.ts +4 -0
  219. package/dist/types/git/hookless.d.ts +1 -0
  220. package/dist/types/git/reconcile-ignored.d.ts +13 -0
  221. package/dist/types/git/resolve-agent-git.d.ts +8 -0
  222. package/dist/types/git/resolve-identity.d.ts +10 -0
  223. package/dist/types/git/run.d.ts +24 -0
  224. package/dist/types/git/system-commit.d.ts +2 -0
  225. package/dist/types/hostd/client.d.ts +13 -0
  226. package/dist/types/hostd/models.d.ts +1 -0
  227. package/dist/types/hostd/paths.d.ts +17 -0
  228. package/dist/types/hostd/protocol.d.ts +93 -0
  229. package/dist/types/hostd/spawn.d.ts +17 -0
  230. package/dist/types/hostd/version.d.ts +18 -0
  231. package/dist/types/init/auto-upgrade.d.ts +41 -0
  232. package/dist/types/init/cli-version.d.ts +7 -0
  233. package/dist/types/init/dockerfile.d.ts +34 -0
  234. package/dist/types/init/ensure-deps.d.ts +17 -0
  235. package/dist/types/init/env-file.d.ts +3 -0
  236. package/dist/types/init/gitignore.d.ts +5 -0
  237. package/dist/types/init/local-source-stamp.d.ts +3 -0
  238. package/dist/types/init/packagejson.d.ts +7 -0
  239. package/dist/types/init/paths.d.ts +3 -0
  240. package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
  241. package/dist/types/init/run-bun-install.d.ts +16 -0
  242. package/dist/types/init/windows-dev-link.d.ts +8 -0
  243. package/dist/types/mcp/catalog.d.ts +7 -0
  244. package/dist/types/mcp/client.d.ts +58 -0
  245. package/dist/types/mcp/manager.d.ts +56 -0
  246. package/dist/types/mcp/tools.d.ts +23 -0
  247. package/dist/types/models/embedding-model.d.ts +20 -0
  248. package/dist/types/models/transformers-version.d.ts +1 -0
  249. package/dist/types/network/internal-destinations.d.ts +29 -0
  250. package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
  251. package/dist/types/operations/incidents.d.ts +47 -0
  252. package/dist/types/operations/index.d.ts +3 -0
  253. package/dist/types/operations/remediations.d.ts +25 -0
  254. package/dist/types/path-safety/real-intended-path.d.ts +9 -0
  255. package/dist/types/permissions/builtins.d.ts +25 -0
  256. package/dist/types/permissions/grant.d.ts +19 -0
  257. package/dist/types/permissions/index.d.ts +6 -0
  258. package/dist/types/permissions/match-rule.d.ts +28 -0
  259. package/dist/types/permissions/permissions.d.ts +42 -0
  260. package/dist/types/permissions/resolve.d.ts +25 -0
  261. package/dist/types/permissions/schema.d.ts +14 -0
  262. package/dist/types/plugin/context.d.ts +20 -0
  263. package/dist/types/plugin/core-tool-names.d.ts +4 -0
  264. package/dist/types/plugin/define.d.ts +46 -0
  265. package/dist/types/plugin/hooks.d.ts +52 -0
  266. package/dist/types/plugin/index.d.ts +11 -0
  267. package/dist/types/plugin/load-skill.d.ts +14 -0
  268. package/dist/types/plugin/loader.d.ts +25 -0
  269. package/dist/types/plugin/manager.d.ts +42 -0
  270. package/dist/types/plugin/registry.d.ts +73 -0
  271. package/dist/types/plugin/skills.d.ts +11 -0
  272. package/dist/types/plugin/types.d.ts +336 -0
  273. package/dist/types/plugin/zod-introspect.d.ts +11 -0
  274. package/dist/types/reload/client.d.ts +11 -0
  275. package/dist/types/reload/docker-exec-client.d.ts +11 -0
  276. package/dist/types/reload/format.d.ts +2 -0
  277. package/dist/types/reload/index.d.ts +6 -0
  278. package/dist/types/reload/recover.d.ts +22 -0
  279. package/dist/types/reload/registry.d.ts +10 -0
  280. package/dist/types/reload/types.d.ts +25 -0
  281. package/dist/types/role-claim/client.d.ts +20 -0
  282. package/dist/types/role-claim/code.d.ts +4 -0
  283. package/dist/types/role-claim/controller.d.ts +59 -0
  284. package/dist/types/role-claim/index.d.ts +6 -0
  285. package/dist/types/role-claim/match-rule.d.ts +9 -0
  286. package/dist/types/role-claim/pending.d.ts +35 -0
  287. package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
  288. package/dist/types/run/llm-fetch-observer.d.ts +50 -0
  289. package/dist/types/sandbox/availability.d.ts +21 -0
  290. package/dist/types/sandbox/build.d.ts +7 -0
  291. package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
  292. package/dist/types/sandbox/coding-agent.d.ts +20 -0
  293. package/dist/types/sandbox/dependency-bins.d.ts +19 -0
  294. package/dist/types/sandbox/dev-source.d.ts +4 -0
  295. package/dist/types/sandbox/env-exposure.d.ts +3 -0
  296. package/dist/types/sandbox/errors.d.ts +20 -0
  297. package/dist/types/sandbox/hidden-paths.d.ts +11 -0
  298. package/dist/types/sandbox/index.d.ts +14 -0
  299. package/dist/types/sandbox/package-install.d.ts +1 -0
  300. package/dist/types/sandbox/policy.d.ts +71 -0
  301. package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
  302. package/dist/types/sandbox/quote.d.ts +2 -0
  303. package/dist/types/sandbox/runtime-private.d.ts +1 -0
  304. package/dist/types/sandbox/session-tmp.d.ts +6 -0
  305. package/dist/types/sandbox/symlinks.d.ts +6 -0
  306. package/dist/types/sandbox/writable-zones.d.ts +15 -0
  307. package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
  308. package/dist/types/secrets/defaults.d.ts +21 -0
  309. package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
  310. package/dist/types/secrets/hydrate.d.ts +7 -0
  311. package/dist/types/secrets/index.d.ts +7 -0
  312. package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
  313. package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
  314. package/dist/types/secrets/resolve.d.ts +14 -0
  315. package/dist/types/secrets/schema.d.ts +840 -0
  316. package/dist/types/secrets/storage.d.ts +56 -0
  317. package/dist/types/shared/host-locale.d.ts +1 -0
  318. package/dist/types/shared/index.d.ts +5 -0
  319. package/dist/types/shared/local-time.d.ts +4 -0
  320. package/dist/types/shared/platform.d.ts +2 -0
  321. package/dist/types/shared/protocol.d.ts +424 -0
  322. package/dist/types/shared/style-text.d.ts +3 -0
  323. package/dist/types/shared/wsl.d.ts +17 -0
  324. package/dist/types/stream/broker.d.ts +2 -0
  325. package/dist/types/stream/index.d.ts +2 -0
  326. package/dist/types/stream/types.d.ts +71 -0
  327. package/package.json +13 -6
  328. package/scripts/build-plugin-types.ts +105 -0
  329. package/scripts/check-plugin-sdk.ts +111 -0
  330. package/scripts/require-parallel.ts +5 -32
  331. package/src/agent/bash-sandbox-env.ts +104 -0
  332. package/src/agent/bash-sandbox-proc.ts +70 -0
  333. package/src/agent/bash-sandbox.ts +225 -0
  334. package/src/agent/compaction.ts +22 -10
  335. package/src/agent/guard-types.ts +3 -0
  336. package/src/agent/guards.ts +4 -0
  337. package/src/agent/idle-compaction.ts +178 -0
  338. package/src/agent/index.ts +139 -172
  339. package/src/agent/live-subagents.ts +19 -0
  340. package/src/agent/multimodal/look-at.ts +22 -9
  341. package/src/agent/output-allowance.ts +7 -0
  342. package/src/agent/plugin-tools.ts +39 -377
  343. package/src/agent/reviewer-bash-policy.ts +41 -1
  344. package/src/agent/session-origin.ts +28 -11
  345. package/src/agent/subagent-cache-keepalive.ts +198 -0
  346. package/src/agent/subagent-completion-reminder.ts +2 -2
  347. package/src/agent/subagent-session.ts +6 -0
  348. package/src/agent/subagents.ts +46 -8
  349. package/src/agent/system-prompt-composition.ts +141 -0
  350. package/src/agent/system-prompt.ts +5 -5
  351. package/src/agent/todo/scope.ts +1 -1
  352. package/src/agent/tool-file-safety.ts +6 -1
  353. package/src/agent/tools/channel-edit.ts +20 -10
  354. package/src/agent/tools/channel-fetch-attachment.ts +12 -5
  355. package/src/agent/tools/channel-handoff.ts +72 -0
  356. package/src/agent/tools/channel-read.ts +57 -10
  357. package/src/agent/tools/channel-reply.ts +33 -26
  358. package/src/agent/tools/channel-send.ts +21 -13
  359. package/src/agent/tools/channel-session-search.ts +35 -0
  360. package/src/agent/tools/curl-impersonate.ts +11 -4
  361. package/src/agent/tools/ddg.ts +84 -16
  362. package/src/agent/tools/spawn-subagent.ts +27 -11
  363. package/src/agent/tools/stream-snapshot.ts +15 -2
  364. package/src/agent/tools/subagent-access.ts +11 -4
  365. package/src/agent/tools-without-local-file-operands.ts +4 -0
  366. package/src/browser/bsk-shim.mjs +74 -0
  367. package/src/browser/dockerfile.ts +84 -0
  368. package/src/browser/egress.ts +104 -0
  369. package/src/browser/fill-secret.ts +307 -0
  370. package/src/browser/managed-browser.ts +205 -0
  371. package/src/browser/registry.ts +110 -0
  372. package/src/browser/relay.ts +231 -0
  373. package/src/browser/sandbox-entry.ts +167 -0
  374. package/src/bundled-plugins/agent-browser/index.ts +2 -0
  375. package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
  376. package/src/bundled-plugins/browser-agent/index.ts +12 -0
  377. package/src/bundled-plugins/doc-render/index.ts +0 -10
  378. package/src/bundled-plugins/doc-render/render.ts +83 -111
  379. package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
  380. package/src/bundled-plugins/explorer/explorer.ts +1 -1
  381. package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
  382. package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
  383. package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
  384. package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
  385. package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
  386. package/src/bundled-plugins/managed-browser/index.ts +179 -0
  387. package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
  388. package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
  389. package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
  390. package/src/bundled-plugins/memory/dreaming.ts +4 -1
  391. package/src/bundled-plugins/memory/load-memory.ts +2 -4
  392. package/src/bundled-plugins/memory/memory-logger.ts +74 -2
  393. package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
  394. package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
  395. package/src/bundled-plugins/operator/operator.ts +1 -1
  396. package/src/bundled-plugins/qa/index.ts +11 -0
  397. package/src/bundled-plugins/qa/qa.ts +160 -0
  398. package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
  399. package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
  400. package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
  401. package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
  402. package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
  403. package/src/bundled-plugins/security/index.ts +53 -34
  404. package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
  405. package/src/bundled-plugins/security/policies/private-surface-read.ts +166 -201
  406. package/src/channels/adapter-namespace.ts +13 -0
  407. package/src/channels/adapters/discord-bot-reference.ts +5 -4
  408. package/src/channels/adapters/discord-bot.ts +98 -5
  409. package/src/channels/adapters/discord-classify.ts +8 -3
  410. package/src/channels/adapters/discord.ts +29 -0
  411. package/src/channels/adapters/github/index.ts +16 -0
  412. package/src/channels/adapters/github/last-alive.ts +4 -16
  413. package/src/channels/adapters/slack-attachment-download.ts +14 -3
  414. package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
  415. package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
  416. package/src/channels/adapters/slack-bot-classify.ts +1 -0
  417. package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
  418. package/src/channels/adapters/slack-bot.ts +299 -67
  419. package/src/channels/adapters/slack-classify.ts +1 -0
  420. package/src/channels/catch-up.ts +137 -0
  421. package/src/channels/continuation-willingness.ts +2 -2
  422. package/src/channels/continuity-types.ts +1 -0
  423. package/src/channels/engagement.ts +17 -1
  424. package/src/channels/github-false-receipt.ts +3 -3
  425. package/src/channels/github-rereview-guard.ts +9 -5
  426. package/src/channels/github-review-check.ts +5 -1
  427. package/src/channels/github-review-verdict-coordinator.ts +68 -2
  428. package/src/channels/github-token-bridge.ts +24 -0
  429. package/src/channels/last-alive.ts +34 -0
  430. package/src/channels/manager.ts +8 -1
  431. package/src/channels/router.ts +515 -243
  432. package/src/channels/session-handoff.fixture.ts +144 -0
  433. package/src/channels/session-handoff.ts +175 -0
  434. package/src/channels/session-search.ts +71 -0
  435. package/src/channels/subagent-completion-bridge.ts +3 -2
  436. package/src/channels/types.ts +12 -2
  437. package/src/cli/channel.ts +2 -3
  438. package/src/cli/hostd.ts +3 -0
  439. package/src/cli/init.ts +2 -3
  440. package/src/cli/model.ts +132 -3
  441. package/src/coding-agent/index.ts +7 -1
  442. package/src/coding-agent/omo-stream.ts +40 -0
  443. package/src/coding-agent/runner.ts +30 -8
  444. package/src/config/config.ts +126 -22
  445. package/src/config/model-overrides.ts +59 -0
  446. package/src/config/models-mutation.ts +185 -2
  447. package/src/config/providers-mutation.ts +12 -4
  448. package/src/config/providers.ts +69 -4
  449. package/src/container/start.ts +132 -5
  450. package/src/doctor/checks.ts +33 -22
  451. package/src/doctor/index.ts +48 -12
  452. package/src/doctor/operational-incidents.ts +16 -1
  453. package/src/doctor/plugin-bridge.ts +14 -1
  454. package/src/doctor/stage.ts +14 -0
  455. package/src/doctor/types.ts +6 -0
  456. package/src/eval/cell.ts +93 -0
  457. package/src/eval/config.ts +32 -0
  458. package/src/eval/dispatch.ts +67 -0
  459. package/src/eval/entry.ts +261 -0
  460. package/src/eval/kernel.ts +154 -0
  461. package/src/eval/process.ts +113 -0
  462. package/src/eval/protocol.ts +26 -0
  463. package/src/eval/redeclare.ts +174 -0
  464. package/src/eval/sandbox.ts +114 -0
  465. package/src/eval/tool.ts +98 -0
  466. package/src/eval/wire.ts +93 -0
  467. package/src/hostd/daemon.ts +13 -1
  468. package/src/init/auto-upgrade.ts +7 -1
  469. package/src/init/dockerfile.ts +57 -12
  470. package/src/init/index.ts +4 -3
  471. package/src/init/local-source-stamp.ts +68 -0
  472. package/src/init/models-dev.ts +4 -0
  473. package/src/init/validate-api-key.ts +3 -0
  474. package/src/operations/classify-tool-outcome.ts +1 -1
  475. package/src/permissions/builtins.ts +7 -0
  476. package/src/permissions/permissions.ts +18 -9
  477. package/src/permissions/resolve.ts +7 -1
  478. package/src/plugin/context.ts +2 -0
  479. package/src/plugin/core-tool-names.ts +6 -1
  480. package/src/plugin/hooks.ts +137 -0
  481. package/src/plugin/index.ts +6 -0
  482. package/src/plugin/manager.ts +4 -0
  483. package/src/plugin/types.ts +60 -0
  484. package/src/run/bundled-plugins.ts +6 -0
  485. package/src/run/index.ts +24 -14
  486. package/src/run/llm-fetch-observer.ts +12 -15
  487. package/src/sandbox/canonical-secrets.ts +4 -0
  488. package/src/sandbox/dev-source.ts +26 -0
  489. package/src/sandbox/env-exposure.ts +20 -0
  490. package/src/sandbox/hidden-paths.ts +16 -2
  491. package/src/secrets/storage.ts +13 -0
  492. package/src/server/index.ts +46 -11
  493. package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
  494. package/src/skills/typeclaw-config/SKILL.md +57 -5
  495. package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
  496. package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
  497. package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
  498. package/src/skills/typeclaw-permissions/SKILL.md +7 -7
  499. package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
  500. package/typeclaw.schema.json +488 -5
  501. package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
  502. package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
@@ -0,0 +1,144 @@
1
+ import { mkdtemp, rm } from 'node:fs/promises'
2
+ import { tmpdir } from 'node:os'
3
+ import { join } from 'node:path'
4
+
5
+ import type { AssistantMessage } from '@earendil-works/pi-ai'
6
+ import { SessionManager, type ExtensionToolContext } from '@earendil-works/pi-coding-agent'
7
+
8
+ import { createSessionWithDispose } from '@/agent'
9
+ import type { SessionOrigin } from '@/agent/session-origin'
10
+ import { createPermissionService, rolesConfigSchema, type RolesConfig } from '@/permissions'
11
+
12
+ import { createChannelRouter, type CreateChannelRouterOptions } from './router'
13
+ import { defaultHistoryConfig } from './schema'
14
+ import { channelKeyId, type ChannelKey, type InboundMessage, type OutboundMessage } from './types'
15
+
16
+ export const sourceKey: ChannelKey = { adapter: 'discord', workspace: 'guild', chat: 'source', thread: null }
17
+ export const targetKey: ChannelKey = { adapter: 'discord-bot', workspace: 'guild', chat: 'target', thread: null }
18
+
19
+ export function inbound(key: ChannelKey, overrides: Partial<InboundMessage> = {}): InboundMessage {
20
+ return {
21
+ ...key,
22
+ accountIdentity: `${key.adapter}-account`,
23
+ externalMessageId: crypto.randomUUID(),
24
+ text: 'Please help.',
25
+ authorId: 'alice',
26
+ authorName: 'Alice',
27
+ authorIsBot: false,
28
+ isBotMention: true,
29
+ isDm: false,
30
+ mentionsOthers: false,
31
+ replyToBotMessageId: null,
32
+ replyToOtherMessageId: null,
33
+ ts: 1000,
34
+ ...overrides,
35
+ }
36
+ }
37
+
38
+ type SessionState = {
39
+ readonly id: string
40
+ readonly origin: { current: SessionOrigin | undefined }
41
+ readonly prompts: string[]
42
+ readonly context: ExtensionToolContext
43
+ onPrompt?: () => Promise<void>
44
+ }
45
+
46
+ export async function handoffFixture(
47
+ options: {
48
+ roles?: RolesConfig
49
+ claimHandler?: CreateChannelRouterOptions['claimHandler']
50
+ } = {},
51
+ ) {
52
+ const dir = await mkdtemp(join(tmpdir(), 'typeclaw-session-handoff-'))
53
+ const permissions = createPermissionService({
54
+ roles: options.roles ?? rolesConfigSchema.parse({ member: { match: ['discord:*'] } }),
55
+ })
56
+ const sessions = new Map<string, SessionState>()
57
+ const sent: OutboundMessage[] = []
58
+ const logs: string[] = []
59
+ const clock = { now: 1000 }
60
+ const router = createChannelRouter({
61
+ agentDir: dir,
62
+ permissions,
63
+ now: () => clock.now,
64
+ claimHandler: options.claimHandler,
65
+ logger: { info: (line) => logs.push(line), warn: (line) => logs.push(line), error: (line) => logs.push(line) },
66
+ configForAdapter: () => ({
67
+ enabled: true,
68
+ engagement: { trigger: ['mention', 'reply', 'dm'], stickiness: 'off' },
69
+ history: defaultHistoryConfig(),
70
+ }),
71
+ createSessionForChannel: async ({ key, origin, originRef }) => {
72
+ const result = await createSessionWithDispose({
73
+ sessionManager: SessionManager.create(dir, join(dir, 'sessions')),
74
+ systemPromptOverride: 'Use channel tools.',
75
+ tools: [],
76
+ customTools: [],
77
+ origin,
78
+ originRef,
79
+ })
80
+ const state: SessionState = {
81
+ id: result.session.sessionId,
82
+ origin: originRef,
83
+ prompts: [],
84
+ context: result.session.extensionRunner.createToolContext('handoff-test', undefined),
85
+ }
86
+ sessions.set(channelKeyId(key), state)
87
+ result.session.prompt = async (text) => {
88
+ if (typeof text === 'string') state.prompts.push(text)
89
+ await state.onPrompt?.()
90
+ const response: AssistantMessage = {
91
+ role: 'assistant',
92
+ content: [{ type: 'text', text: 'NO_REPLY' }],
93
+ api: 'anthropic-messages',
94
+ provider: 'anthropic',
95
+ model: 'test-model',
96
+ usage: {
97
+ input: 0,
98
+ output: 0,
99
+ cacheRead: 0,
100
+ cacheWrite: 0,
101
+ totalTokens: 0,
102
+ cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
103
+ },
104
+ stopReason: 'stop',
105
+ timestamp: clock.now,
106
+ }
107
+ result.session.sessionManager.appendMessage(response)
108
+ }
109
+ return { session: result.session, sessionId: state.id, dispose: result.dispose }
110
+ },
111
+ })
112
+ for (const adapter of ['discord', 'discord-bot', 'slack-bot'] as const) {
113
+ router.registerOutbound(adapter, async (message) => {
114
+ sent.push(message)
115
+ return { ok: true, messageId: 'posted-message' }
116
+ })
117
+ }
118
+ const testing = router.__testing
119
+ if (testing === undefined) throw new Error('router test controls are unavailable')
120
+ const session = (key: ChannelKey): SessionState => {
121
+ const state = sessions.get(channelKeyId(key))
122
+ if (state === undefined) throw new Error(`missing test session ${channelKeyId(key)}`)
123
+ return state
124
+ }
125
+ return {
126
+ agentDir: dir,
127
+ router,
128
+ permissions,
129
+ sessions,
130
+ session,
131
+ sent,
132
+ logs,
133
+ clock,
134
+ flush: testing.flushDebounce,
135
+ async receive(event: InboundMessage) {
136
+ await router.route(event)
137
+ await testing.flushDebounce(event)
138
+ },
139
+ async [Symbol.asyncDispose]() {
140
+ await router.stop()
141
+ await rm(dir, { recursive: true, force: true })
142
+ },
143
+ }
144
+ }
@@ -0,0 +1,175 @@
1
+ import { randomUUID } from 'node:crypto'
2
+
3
+ import type { ChannelParticipant, SessionOrigin } from '@/agent/session-origin'
4
+ import { CORE_PERMISSIONS, type PermissionService } from '@/permissions'
5
+
6
+ import type { AdapterId } from './schema'
7
+ import { channelKeyId, type ChannelKey, type InboundMessage, type RouteReceipt } from './types'
8
+
9
+ export type HandoffSession = {
10
+ readonly sessionId: string
11
+ readonly key: ChannelKey
12
+ readonly keyId: string
13
+ readonly destroyed: boolean
14
+ readonly currentTurnHandoff: boolean
15
+ readonly lastTurnHandoff: boolean
16
+ readonly draining: boolean
17
+ readonly currentTurnAuthorId: string | null
18
+ readonly lastTurnAuthorId: string | null
19
+ readonly currentTurnAuthorAdapter: AdapterId
20
+ readonly lastTurnAuthorAdapter: AdapterId
21
+ readonly participants: readonly ChannelParticipant[]
22
+ readonly room?: InboundMessage['room']
23
+ readonly lastInboundIsDm: boolean
24
+ }
25
+
26
+ export type ChannelHandoffResult =
27
+ | { ok: true; target: string }
28
+ | {
29
+ ok: false
30
+ code:
31
+ | 'no-source-session'
32
+ | 'loop'
33
+ | 'same-conversation'
34
+ | 'no-requester'
35
+ | 'target-not-live'
36
+ | 'requester-unknown-in-target'
37
+ | 'would-elevate'
38
+ | 'denied'
39
+ | 'not-engaged'
40
+ error: string
41
+ }
42
+
43
+ type HandoffAccess =
44
+ | {
45
+ ok: true
46
+ source: HandoffSession
47
+ target: HandoffSession
48
+ authorId: string
49
+ authorAdapter: AdapterId
50
+ authorName: string
51
+ }
52
+ | Extract<ChannelHandoffResult, { ok: false }>
53
+
54
+ export function findHandoffSource(sessions: ReadonlyMap<string, HandoffSession>, sessionId: string) {
55
+ return [...sessions.values()].find((session) => session.sessionId === sessionId && !session.destroyed)
56
+ }
57
+
58
+ export function checkHandoffAccess(args: {
59
+ source: HandoffSession | undefined
60
+ target: HandoffSession | undefined
61
+ permissions: PermissionService
62
+ }): HandoffAccess {
63
+ const { source, target, permissions } = args
64
+ if (source === undefined)
65
+ return { ok: false, code: 'no-source-session', error: 'handoff requires a live source channel session' }
66
+ if (source.currentTurnHandoff || (!source.draining && source.lastTurnHandoff))
67
+ return { ok: false, code: 'loop', error: 'this turn was started by a handoff; answer with channel_reply' }
68
+ if (target === undefined || target.destroyed)
69
+ return { ok: false, code: 'target-not-live', error: 'no live session owns that conversation' }
70
+ if (target.keyId === source.keyId)
71
+ return { ok: false, code: 'same-conversation', error: 'target is this conversation; use channel_reply' }
72
+ const authorId = source.currentTurnAuthorId ?? source.lastTurnAuthorId
73
+ if (authorId === null)
74
+ return { ok: false, code: 'no-requester', error: 'no authenticated requester to act on behalf of' }
75
+ const authorAdapter =
76
+ source.currentTurnAuthorId !== null ? source.currentTurnAuthorAdapter : source.lastTurnAuthorAdapter
77
+ const origin = (session: HandoffSession): SessionOrigin => ({
78
+ kind: 'channel',
79
+ ...session.key,
80
+ ...(session.room?.parentChat !== undefined ? { parentChat: session.room.parentChat } : {}),
81
+ lastInboundAuthorId: authorId,
82
+ lastInboundAuthorAdapter: authorAdapter,
83
+ })
84
+ const targetOrigin = origin(target)
85
+ const targetRole = permissions.resolveRole(targetOrigin, { requireMatch: true })
86
+ const targetPermissions = targetRole === undefined ? undefined : permissions.permissionsForRole(targetRole)
87
+ if (targetPermissions === undefined)
88
+ return {
89
+ ok: false,
90
+ code: 'requester-unknown-in-target',
91
+ error: 'the authenticated requester has no matching known role in the target conversation',
92
+ }
93
+ const sourceRole = permissions.resolveRole(origin(source))
94
+ const sourcePermissions = permissions.permissionsForRole(sourceRole)
95
+ if (
96
+ sourcePermissions === undefined ||
97
+ targetPermissions.some((permission) => !sourcePermissions.includes(permission))
98
+ )
99
+ return {
100
+ ok: false,
101
+ code: 'would-elevate',
102
+ error: 'the target grants authority the requester does not hold in the source; request there directly',
103
+ }
104
+ if (!permissions.has(targetOrigin, CORE_PERMISSIONS.channelRespond))
105
+ return { ok: false, code: 'denied', error: 'the requester cannot engage the agent in the target conversation' }
106
+ // Capability dominance already bounds every accepted handoff, including
107
+ // owners. Recent participation adds no authority proof and blocks legitimate
108
+ // work across accounts or after an idle period.
109
+ return {
110
+ ok: true,
111
+ source,
112
+ target,
113
+ authorId,
114
+ authorAdapter,
115
+ authorName: source.participants.find((participant) => participant.authorId === authorId)?.authorName ?? authorId,
116
+ }
117
+ }
118
+
119
+ export function createSessionHandoff(options: {
120
+ sessions: ReadonlyMap<string, HandoffSession>
121
+ permissions: PermissionService
122
+ route: (event: InboundMessage) => Promise<RouteReceipt>
123
+ logger: { info: (message: string) => void }
124
+ now: () => number
125
+ }) {
126
+ return async (args: { fromSessionId: string; target: ChannelKey; text: string }): Promise<ChannelHandoffResult> => {
127
+ const targetId = channelKeyId(args.target)
128
+ const access = checkHandoffAccess({
129
+ source: findHandoffSource(options.sessions, args.fromSessionId),
130
+ target: options.sessions.get(targetId),
131
+ permissions: options.permissions,
132
+ })
133
+ if (!access.ok) {
134
+ options.logger.info(`[channels] handoff ${args.fromSessionId} -> ${targetId}: refused ${access.code}`)
135
+ return access
136
+ }
137
+ const { source, target } = access
138
+ const fromWhere = source.lastInboundIsDm ? 'a private DM' : `another conversation (${source.keyId})`
139
+ const receipt = await options.route({
140
+ ...target.key,
141
+ ...(target.room !== undefined ? { room: target.room } : {}),
142
+ routingNote:
143
+ `[handoff: ${access.authorName} asked you for this in ${fromWhere}. It was NOT posted in this conversation and nobody ` +
144
+ "here has seen it. Read this conversation's latest messages first: if someone has since asked for something newer " +
145
+ 'or the result below is outdated, act on the current state instead of repeating it, or stay silent if nothing is ' +
146
+ 'needed. Share only what this conversation needs, not private details.]',
147
+ handoff: true,
148
+ text: args.text,
149
+ externalMessageId: `handoff:${randomUUID()}`,
150
+ eventKind: 'handoff',
151
+ authorId: access.authorId,
152
+ authorAdapter: access.authorAdapter,
153
+ authorName: access.authorName,
154
+ authorIsBot: false,
155
+ isBotMention: true,
156
+ suppressSticky: true,
157
+ replyToBotMessageId: null,
158
+ mentionsOthers: false,
159
+ replyToOtherMessageId: null,
160
+ isDm: target.lastInboundIsDm,
161
+ ts: options.now(),
162
+ })
163
+ options.logger.info(`[channels] handoff ${source.keyId} -> ${targetId}: ${receipt.kind}`)
164
+ switch (receipt.kind) {
165
+ case 'accepted':
166
+ case 'duplicate':
167
+ return { ok: true, target: targetId }
168
+ case 'denied':
169
+ return { ok: false, code: 'denied', error: 'target authorization changed or its adapter is unavailable' }
170
+ case 'observed':
171
+ case 'control':
172
+ return { ok: false, code: 'not-engaged', error: 'the target did not accept the handoff' }
173
+ }
174
+ }
175
+ }
@@ -0,0 +1,71 @@
1
+ import type { PermissionService } from '@/permissions'
2
+
3
+ import { adapterNamespace } from './adapter-namespace'
4
+ import type { ConfigForAdapter } from './router'
5
+ import { checkHandoffAccess, findHandoffSource, type HandoffSession } from './session-handoff'
6
+ import type { ChannelKey, ResolvedChannelNames } from './types'
7
+
8
+ export type SessionActivity = { readonly text: string; readonly at: number }
9
+ export type SearchableSession = HandoffSession & {
10
+ readonly resolvedNames: ResolvedChannelNames
11
+ readonly recentMessages: readonly SessionActivity[]
12
+ readonly lastInboundAt: number
13
+ }
14
+
15
+ export type SessionSearchTarget = {
16
+ readonly target: ChannelKey
17
+ readonly name: string
18
+ readonly activity: string
19
+ readonly lastActiveAt: number
20
+ }
21
+
22
+ export type SessionSearchArgs = {
23
+ readonly fromSessionId: string
24
+ readonly query: string
25
+ // Used by channel_read to disambiguate platform-local conversation IDs.
26
+ readonly conversation?: ChannelKey
27
+ }
28
+
29
+ export function createSessionSearch(options: {
30
+ sessions: ReadonlyMap<string, SearchableSession>
31
+ permissions: PermissionService
32
+ configForAdapter: ConfigForAdapter
33
+ }) {
34
+ return (args: SessionSearchArgs): SessionSearchTarget[] => {
35
+ const source = findHandoffSource(options.sessions, args.fromSessionId)
36
+ const query = args.query.trim().toLocaleLowerCase()
37
+ const results: SessionSearchTarget[] = []
38
+ for (const session of options.sessions.values()) {
39
+ if (!options.configForAdapter(session.key.adapter)?.enabled) continue
40
+ const conversation = args.conversation
41
+ if (
42
+ conversation !== undefined &&
43
+ (session.key.adapter === conversation.adapter ||
44
+ adapterNamespace(session.key.adapter) !== adapterNamespace(conversation.adapter) ||
45
+ session.key.workspace !== conversation.workspace ||
46
+ session.key.chat !== conversation.chat ||
47
+ session.key.thread !== conversation.thread)
48
+ )
49
+ continue
50
+ if (!checkHandoffAccess({ source, target: session, permissions: options.permissions }).ok) continue
51
+ const name = session.resolvedNames.chatName ?? session.key.chat
52
+ const values = [
53
+ name,
54
+ session.resolvedNames.workspaceName ?? session.key.workspace,
55
+ session.room?.parentChatName ?? '',
56
+ session.keyId,
57
+ ...session.participants.flatMap((participant) => [participant.authorId, participant.authorName]),
58
+ ...session.recentMessages.map((message) => message.text),
59
+ ]
60
+ if (!values.some((value) => value.toLocaleLowerCase().includes(query))) continue
61
+ const latest = session.recentMessages.at(-1)
62
+ results.push({
63
+ target: { ...session.key },
64
+ name,
65
+ activity: latest?.text.replace(/\s+/gu, ' ').slice(0, 160) ?? '',
66
+ lastActiveAt: latest?.at ?? session.lastInboundAt,
67
+ })
68
+ }
69
+ return results.sort((a, b) => b.lastActiveAt - a.lastActiveAt).slice(0, 20)
70
+ }
71
+ }
@@ -56,8 +56,9 @@ const consoleLogger: SubagentCompletionBridgeLogger = {
56
56
  //
57
57
  // - The parent session was GC'd by the idle-eviction tick
58
58
  // (SESSION_IDLE_MS) while the subagent was running.
59
- // - The parent session rolled over (SESSION_FRESHNESS_TTL_MS) when a
60
- // new inbound arrived during a long-running subagent.
59
+ // - The parent session rolled over after 60 minutes idle
60
+ // (SESSION_FRESHNESS_TTL_MS) when a new inbound arrived during a
61
+ // long-running subagent.
61
62
  //
62
63
  // A reminder still reaching this branch means there is no live session
63
64
  // for the key at all (the whole conversation went idle), or the parent
@@ -102,6 +102,16 @@ export type InboundMessage = {
102
102
  // the thread. Absent ⇒ not a thread room (or the adapter cannot tell).
103
103
  room?: { kind: 'thread'; parentChat?: string; parentChatName?: string }
104
104
  text: string
105
+ // Prompt-only runtime note rendered above this message's author line (never
106
+ // part of `text`, so engagement and quote anchors ignore it). Set by the
107
+ // router for cross-session handoffs and conversation origin hints.
108
+ routingNote?: string
109
+ // Set only on a synthetic inbound created by `router.handoff`: the requester's
110
+ // own session in another chat delegated this work here. The turn it starts
111
+ // cannot hand off again (loop guard) and is never a reply-anchor target.
112
+ handoff?: true
113
+ // Runtime-only provenance for a handoff; platform adapters omit this.
114
+ authorAdapter?: AdapterId
105
115
  // Prompt-only context for replied-to / quoted / linked messages. Kept out
106
116
  // of `text` so the engagement gate sees only the human-authored body.
107
117
  referenceContext?: InboundReferenceContext
@@ -391,7 +401,7 @@ export type SendErrorCode =
391
401
  // a later ReactionRequest reacts to. It is explicitly NOT the per-reaction
392
402
  // removal-instance ref returned by `ReactionResult.reactionRef` after an add.
393
403
  export type SendResult =
394
- | { ok: true; messageId?: string; messageIds?: readonly string[]; reactionRef?: ReactionRef }
404
+ | { ok: true; messageId?: string; messageIds?: readonly string[]; reactionRef?: ReactionRef; deliveredText?: string }
395
405
  | { ok: false; error: string; code?: SendErrorCode; recoveryFailure?: RecoveryFailure }
396
406
 
397
407
  export type OutboundCallback = (msg: OutboundMessage) => Promise<SendResult>
@@ -423,7 +433,7 @@ export type EditMessageRequest = {
423
433
  // `permission-denied` is a hard refusal from the platform (e.g. editing a
424
434
  // message the bot does not own).
425
435
  export type EditMessageResult =
426
- | { ok: true }
436
+ | { ok: true; deliveredText?: string }
427
437
  | {
428
438
  ok: false
429
439
  error: string
@@ -1220,8 +1220,7 @@ async function promptGithubCredentials(cwd: string): Promise<{
1220
1220
  // length checks below to avoid a TypeError on the "leave blank" path.
1221
1221
  const enteredSecret = typeof secret === 'string' ? secret : ''
1222
1222
  const reposRaw = await text({
1223
- message: 'Repositories to allow (comma-separated owner/repo)',
1224
- validate: (value) => (parseRepos(value ?? '').length > 0 ? undefined : 'At least one owner/repo is required'),
1223
+ message: 'Repositories to allow (comma-separated owner/repo, leave blank to skip)',
1225
1224
  })
1226
1225
  if (isCancel(reposRaw)) {
1227
1226
  cancel('Aborted.')
@@ -1234,7 +1233,7 @@ async function promptGithubCredentials(cwd: string): Promise<{
1234
1233
  ...(webhookUrl !== undefined ? { webhookUrl } : {}),
1235
1234
  webhookPort: Number(port),
1236
1235
  ...(namedCreds !== undefined ? namedCreds : {}),
1237
- repos: parseRepos(reposRaw),
1236
+ repos: parseRepos(reposRaw ?? ''),
1238
1237
  auth,
1239
1238
  }
1240
1239
  }
package/src/cli/hostd.ts CHANGED
@@ -191,6 +191,9 @@ export function buildHostdRestart(
191
191
  cliEntry,
192
192
  reuseCurrentHostDaemon: true,
193
193
  operationLease,
194
+ // No terminal is attached to an agent-requested restart, so the hostd log
195
+ // is the only place its start warnings can reach the operator.
196
+ onWarning: (warning) => writeLogLine(`[hostd] restart ${containerName}: ${warning}`),
194
197
  ...(currentHostDaemon ? { currentHostDaemon } : {}),
195
198
  })
196
199
  if (!restartResult.ok) return restartResult
package/src/cli/init.ts CHANGED
@@ -1796,8 +1796,7 @@ async function runGithubFlow(cwd: string): Promise<StepResult<CollectedInputs['c
1796
1796
  // length checks below to avoid a TypeError on the "leave blank" path.
1797
1797
  const enteredSecret = typeof secret === 'string' ? secret : ''
1798
1798
  const reposRaw = await text({
1799
- message: 'Repositories to allow (comma-separated owner/repo)',
1800
- validate: (v) => (parseGithubRepos(v ?? '').length > 0 ? undefined : 'At least one owner/repo is required'),
1799
+ message: 'Repositories to allow (comma-separated owner/repo, leave blank to skip)',
1801
1800
  })
1802
1801
  if (isCancel(reposRaw)) return back()
1803
1802
  const resolvedSecret = enteredSecret.length > 0 ? enteredSecret : randomBytes(32).toString('hex')
@@ -1808,7 +1807,7 @@ async function runGithubFlow(cwd: string): Promise<StepResult<CollectedInputs['c
1808
1807
  ...(webhookUrl !== undefined ? { webhookUrl } : {}),
1809
1808
  webhookPort: Number(port),
1810
1809
  ...(namedCreds !== undefined ? namedCreds : {}),
1811
- repos: parseGithubRepos(reposRaw),
1810
+ repos: parseGithubRepos(reposRaw ?? ''),
1812
1811
  auth,
1813
1812
  },
1814
1813
  })
package/src/cli/model.ts CHANGED
@@ -6,10 +6,16 @@ import { defineCommand } from 'citty'
6
6
 
7
7
  import { type CustomModelMeta, type ThinkingLevel, thinkingLevelSchema } from '@/config'
8
8
  import {
9
+ addOverrideMatch,
9
10
  addProfile,
11
+ listModelOverrides,
10
12
  listModelProfiles,
11
13
  listRegisteredModelRefs,
14
+ removeOverride,
15
+ removeOverrideMatch,
16
+ removeOverrideProfile,
12
17
  removeProfile,
18
+ setOverrideProfile,
13
19
  setProfile,
14
20
  setProfileThinkingLevel,
15
21
  } from '@/config/models-mutation'
@@ -62,15 +68,33 @@ const setSub = defineCommand({
62
68
  "reasoning effort for THIS profile (off|minimal|low|medium|high|xhigh|max|default); the `default` profile's level is the de-facto global default",
63
69
  required: false,
64
70
  },
71
+ override: {
72
+ type: 'string',
73
+ description: 'set the profile inside this `modelOverrides` entry instead of the global `models`',
74
+ required: false,
75
+ },
76
+ match: {
77
+ type: 'string',
78
+ description: "with --override: add this match rule (e.g. 'slack:*'); required when creating the override",
79
+ required: false,
80
+ },
65
81
  },
66
82
  async run({ args }) {
67
83
  const cwd = ensureAgentDir()
84
+ if (args.match !== undefined && args.override === undefined) {
85
+ console.error(errorLine('--match requires --override <name>.'))
86
+ process.exit(1)
87
+ }
68
88
  // `model set <ref>` shorthand targets the `default` profile; a shorthand ref
69
89
  // is resolved as an explicit ref (so its errors surface via resolvePickedRef's
70
90
  // exit-1 path), and a bare/named-profile invocation falls back to the picker.
71
91
  const shorthandRef = resolveShorthandRef(args.profile, args.ref)
72
92
  const profile = shorthandRef !== undefined ? 'default' : (args.profile ?? (await pickProfileName()))
73
93
  const picked = await resolvePickedRef(shorthandRef ?? args.ref, cwd)
94
+ if (args.override !== undefined) {
95
+ runSetOverrideProfile(cwd, args.override, profile, picked, args)
96
+ return
97
+ }
74
98
 
75
99
  intro(`Setting model profile: ${profile} → ${picked.ref}`)
76
100
 
@@ -207,17 +231,26 @@ const removeSub = defineCommand({
207
231
  description: 'profile name to remove',
208
232
  required: true,
209
233
  },
234
+ override: {
235
+ type: 'string',
236
+ description: 'remove the profile from this `modelOverrides` entry instead of the global `models`',
237
+ required: false,
238
+ },
210
239
  },
211
240
  async run({ args }) {
212
241
  const cwd = ensureAgentDir()
213
- intro(`Removing model profile: ${args.profile}`)
214
- const result = removeProfile(cwd, args.profile)
242
+ const scope = args.override !== undefined ? ` from override ${args.override}` : ''
243
+ intro(`Removing model profile: ${args.profile}${scope}`)
244
+ const result =
245
+ args.override !== undefined
246
+ ? removeOverrideProfile(cwd, args.override, args.profile)
247
+ : removeProfile(cwd, args.profile)
215
248
  if (!result.ok) {
216
249
  console.error(errorLine(result.reason))
217
250
  process.exit(1)
218
251
  }
219
252
  done({
220
- title: c.green(`Profile "${args.profile}" removed.`),
253
+ title: c.green(`Profile "${args.profile}" removed${scope}.`),
221
254
  hints: [{ label: 'If the agent is running:', command: 'typeclaw reload' }],
222
255
  })
223
256
  },
@@ -274,7 +307,60 @@ const listSub = defineCommand({
274
307
  }
275
308
  }
276
309
  }
310
+
311
+ for (const override of listModelOverrides(cwd)) {
312
+ console.log('')
313
+ console.log(`${c.bold(`override ${override.name}`)} ${c.dim(override.match.join(', '))}`)
314
+ for (const p of override.profiles) {
315
+ const thinking = p.thinkingLevel !== undefined ? ` ${c.dim(p.thinkingLevel)}` : ''
316
+ console.log(` ${p.profile.padEnd(profileWidth + 2)}${p.refs.join(' → ')}${thinking}`)
317
+ }
318
+ }
319
+ },
320
+ })
321
+
322
+ const overrideMatchSub = defineCommand({
323
+ meta: { name: 'match', description: 'add a match rule to a `modelOverrides` entry' },
324
+ args: {
325
+ name: { type: 'positional', description: 'override name', required: true },
326
+ rule: { type: 'positional', description: "match rule, e.g. 'slack:T0123/C0123'", required: true },
327
+ },
328
+ run({ args }) {
329
+ finishOverrideEdit(
330
+ addOverrideMatch(ensureAgentDir(), args.name, args.rule),
331
+ `Override "${args.name}" now matches ${args.rule}.`,
332
+ )
333
+ },
334
+ })
335
+
336
+ const overrideUnmatchSub = defineCommand({
337
+ meta: { name: 'unmatch', description: 'remove a match rule from a `modelOverrides` entry' },
338
+ args: {
339
+ name: { type: 'positional', description: 'override name', required: true },
340
+ rule: { type: 'positional', description: 'match rule to remove', required: true },
341
+ },
342
+ run({ args }) {
343
+ finishOverrideEdit(
344
+ removeOverrideMatch(ensureAgentDir(), args.name, args.rule),
345
+ `Override "${args.name}" no longer matches ${args.rule}.`,
346
+ )
347
+ },
348
+ })
349
+
350
+ const overrideRemoveSub = defineCommand({
351
+ meta: { name: 'remove', description: 'delete a `modelOverrides` entry' },
352
+ args: { name: { type: 'positional', description: 'override name', required: true } },
353
+ run({ args }) {
354
+ finishOverrideEdit(removeOverride(ensureAgentDir(), args.name), `Override "${args.name}" removed.`)
355
+ },
356
+ })
357
+
358
+ const overrideSub = defineCommand({
359
+ meta: {
360
+ name: 'override',
361
+ description: 'edit `modelOverrides` match rules (set profiles with `model set --override`)',
277
362
  },
363
+ subCommands: { match: overrideMatchSub, unmatch: overrideUnmatchSub, remove: overrideRemoveSub },
278
364
  })
279
365
 
280
366
  export const modelCommand = defineCommand({
@@ -288,9 +374,52 @@ export const modelCommand = defineCommand({
288
374
  remove: removeSub,
289
375
  list: listSub,
290
376
  thinking: thinkingSub,
377
+ override: overrideSub,
291
378
  },
292
379
  })
293
380
 
381
+ function runSetOverrideProfile(
382
+ cwd: string,
383
+ name: string,
384
+ profile: string,
385
+ picked: PickedModelRef,
386
+ args: { force?: boolean; thinking?: string; match?: string },
387
+ ): void {
388
+ let thinking: { level: ThinkingLevel | undefined } | undefined
389
+ if (args.thinking !== undefined) {
390
+ const parsed = parseThinkingArg(args.thinking)
391
+ if (!parsed.ok) {
392
+ console.error(errorLine(parsed.reason))
393
+ process.exit(1)
394
+ }
395
+ thinking = { level: parsed.level }
396
+ }
397
+ intro(`Setting model profile: ${profile} → ${picked.ref} in override ${name}`)
398
+ const result = setOverrideProfile(cwd, name, profile, picked.ref, {
399
+ force: args.force === true,
400
+ ...(args.match !== undefined ? { match: args.match } : {}),
401
+ ...(picked.meta !== undefined ? { meta: picked.meta } : {}),
402
+ ...(thinking !== undefined ? { thinkingLevel: thinking.level } : {}),
403
+ })
404
+ finishOverrideEdit(result, `Profile "${profile}" set in override "${name}".`, `${profile} → ${picked.ref}`)
405
+ }
406
+
407
+ function finishOverrideEdit(
408
+ result: { ok: true } | { ok: false; reason: string },
409
+ title: string,
410
+ details?: string,
411
+ ): void {
412
+ if (!result.ok) {
413
+ console.error(errorLine(result.reason))
414
+ process.exit(1)
415
+ }
416
+ done({
417
+ title: c.green(title),
418
+ ...(details !== undefined ? { details } : {}),
419
+ hints: [{ label: 'If the agent is running:', command: 'typeclaw reload' }],
420
+ })
421
+ }
422
+
294
423
  function ensureAgentDir(): string {
295
424
  const cwd = findAgentDir(process.cwd()) ?? process.cwd()
296
425
  if (!isInitialized(cwd)) {