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
@@ -1,5 +1,17 @@
1
1
  import { constants, createWriteStream, lstatSync, type Stats } from 'node:fs'
2
- import { chmod, mkdir, mkdtemp, open, readdir, realpath, rm, stat, unlink, type FileHandle } from 'node:fs/promises'
2
+ import {
3
+ chmod,
4
+ mkdir,
5
+ mkdtemp,
6
+ open,
7
+ readdir,
8
+ realpath,
9
+ rm,
10
+ stat,
11
+ unlink,
12
+ writeFile,
13
+ type FileHandle,
14
+ } from 'node:fs/promises'
3
15
  import { tmpdir } from 'node:os'
4
16
  import path from 'node:path'
5
17
  import { Transform } from 'node:stream'
@@ -52,7 +64,16 @@ export const PINNED_SNAPSHOT_GLOBAL_MAX_BYTES = TOOL_INPUT_MAX_BYTES.channel_upl
52
64
  export const PINNED_SNAPSHOT_GLOBAL_MAX_COUNT = TOOL_INPUT_MAX_COUNT.channel_upload
53
65
  export const PINNED_SNAPSHOT_MAX_WAITERS = 32
54
66
  const TOOL_OUTPUT_MAX_COUNT = 32
55
- const TREE_SNAPSHOT_MAX_ENTRIES = 4096
67
+ export const TREE_SNAPSHOT_MAX_ENTRIES = 4096
68
+ // Names-only snapshots (ls/find) write empty placeholders, so an entry costs an
69
+ // inode, not a copy; a long-lived agent's workspace easily outgrows 4096.
70
+ const TREE_NAMES_SNAPSHOT_MAX_ENTRIES = 65_536
71
+ // fd reads these to honor ignore rules, so find needs their real contents.
72
+ const FIND_IGNORE_FILE_NAMES = new Set(['.gitignore', '.ignore', '.fdignore'])
73
+ // ripgrep's own binary heuristic: a NUL in the leading block. rg skips such
74
+ // files during recursive search, so grep snapshots them as empty placeholders.
75
+ // rg transcodes BOM-prefixed UTF-16 before that check, so those stay searchable.
76
+ const BINARY_SNIFF_BYTES = 8192
56
77
  const AGENT_ROOT_SNAPSHOT_EXCLUDED_DIRS = new Set(['.git', '.gitstore', 'node_modules'])
57
78
 
58
79
  export const TOOL_INPUT_TEMP_PREFIX = 'typeclaw-tool-input-'
@@ -107,6 +128,7 @@ export async function enforceAndPinToolFiles(
107
128
 
108
129
  let dir: string | undefined
109
130
  const rewrites: Rewrite[] = []
131
+ const omittedLinks: { root: string; count: number; names: string[] }[] = []
110
132
  const verified: VerifiedInput[] = []
111
133
  const maxBytes = maxInputBytes(options.tool)
112
134
  const identityOptions = {
@@ -155,8 +177,13 @@ export async function enforceAndPinToolFiles(
155
177
  let copiedBytes = 0
156
178
  for (let i = 0; i < verified.length; i++) {
157
179
  const input = verified[i] as VerifiedInput
158
- const pinned = path.join(dir, String(i))
180
+ const slot = path.join(dir, String(i))
181
+ // Files keep their original basename under a per-operand slot: tools that
182
+ // derive a name or type from the path (channel uploads, mime sniffing by
183
+ // extension) would otherwise see the bare index, e.g. a Discord file named `0`.
184
+ const pinned = input.kind === 'file' ? path.join(slot, path.basename(input.original)) : slot
159
185
  if (input.kind === 'file') {
186
+ await mkdir(slot, { mode: 0o700 })
160
187
  const source = await openInput(input.resolved, input.original)
161
188
  try {
162
189
  const opened = await source.stat()
@@ -180,7 +207,7 @@ export async function enforceAndPinToolFiles(
180
207
  await source.close()
181
208
  }
182
209
  } else {
183
- copiedBytes += await snapshotDirectoryTree({
210
+ const snapshot = await snapshotDirectoryTree({
184
211
  source: input,
185
212
  destination: pinned,
186
213
  agentDir: options.agentDir,
@@ -192,6 +219,10 @@ export async function enforceAndPinToolFiles(
192
219
  hidden: options.hidden,
193
220
  signal: options.signal,
194
221
  })
222
+ copiedBytes += snapshot.copied
223
+ if (snapshot.omittedLinks.count > 0) {
224
+ omittedLinks.push({ root: input.original, ...snapshot.omittedLinks })
225
+ }
195
226
  }
196
227
  const executionValue = input.target.uri ? pathToFileURL(pinned).href : pinned
197
228
  input.target.set(executionValue)
@@ -215,7 +246,7 @@ export async function enforceAndPinToolFiles(
215
246
  restoreResult(result) {
216
247
  let restored = result
217
248
  for (const rewrite of rewrites) restored = replaceResultPath(restored, rewrite)
218
- return restored
249
+ return appendSnapshotOmissions(restored, omittedLinks)
219
250
  },
220
251
  async cleanup() {
221
252
  if (cleaned) return
@@ -285,6 +316,9 @@ function fileTargets(
285
316
  toolProvenance: ToolProvenance | undefined,
286
317
  ): FileTarget[] {
287
318
  if (isOutputTool(tool)) return []
319
+ // This domain operation authorizes and snapshots the selected Git root inside
320
+ // its own credential-free sandbox. Generic file pinning cannot copy a repo.
321
+ if (tool === 'coding_agent' && toolProvenance === 'first-party') return []
288
322
  if (toolProvenance === 'first-party' && TOOLS_WITHOUT_LOCAL_FILE_OPERANDS.has(tool)) return []
289
323
  if (tool === 'read' && typeof args.path === 'string') return [propertyTarget(args, 'path')]
290
324
  if (isTreeInputTool(tool)) {
@@ -824,7 +858,7 @@ export async function writeToolOutputNoFollow(targetPath: string, content: strin
824
858
  }
825
859
  }
826
860
 
827
- async function createAndOpenAnchoredDirectory(absolute: string): Promise<FileHandle> {
861
+ export async function createAndOpenAnchoredDirectory(absolute: string, createMissing = true): Promise<FileHandle> {
828
862
  if (!path.isAbsolute(absolute)) throw new Error(`anchored directory must be absolute: ${absolute}`)
829
863
  const components = absolute.split(path.sep).filter(Boolean)
830
864
  let current = await open(path.parse(absolute).root, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW)
@@ -835,7 +869,7 @@ async function createAndOpenAnchoredDirectory(absolute: string): Promise<FileHan
835
869
  try {
836
870
  next = await open(anchored, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW)
837
871
  } catch (error) {
838
- if (!isNotFoundError(error)) throw error
872
+ if (!isNotFoundError(error) || !createMissing) throw error
839
873
  await mkdir(anchored, { mode: 0o700 })
840
874
  next = await open(anchored, constants.O_RDONLY | constants.O_DIRECTORY | constants.O_NOFOLLOW)
841
875
  }
@@ -914,7 +948,7 @@ async function snapshotDirectoryTree(options: {
914
948
  operandCount: number
915
949
  hidden?: HiddenPaths
916
950
  signal?: AbortSignal
917
- }): Promise<number> {
951
+ }): Promise<{ copied: number; omittedLinks: { count: number; names: string[] } }> {
918
952
  if (process.platform !== 'linux') {
919
953
  throw new Error('directory tool inputs require Linux inode anchoring; refusing an unanchored traversal')
920
954
  }
@@ -925,7 +959,12 @@ async function snapshotDirectoryTree(options: {
925
959
  throw new Error(`tool input changed while waiting for snapshot capacity: ${options.source.original}`)
926
960
  }
927
961
  await mkdir(options.destination, { mode: 0o700 })
928
- const state = { copied: 0, entries: 0 }
962
+ const state = {
963
+ copied: 0,
964
+ entries: 0,
965
+ omittedLinks: { count: 0, names: [] as string[] },
966
+ mode: treeSnapshotMode(options.tool),
967
+ }
929
968
  const identityVerifier = createPrivateSurfaceReadIdentityVerifier({
930
969
  tool: options.tool,
931
970
  agentDir: options.agentDir,
@@ -942,7 +981,7 @@ async function snapshotDirectoryTree(options: {
942
981
  openedRoot === realAgentDir,
943
982
  )
944
983
  await chmod(options.destination, 0o500)
945
- return state.copied
984
+ return { copied: state.copied, omittedLinks: state.omittedLinks }
946
985
  } finally {
947
986
  await root.close()
948
987
  }
@@ -952,7 +991,12 @@ async function snapshotOpenedDirectory(
952
991
  directory: FileHandle,
953
992
  destination: string,
954
993
  options: Parameters<typeof snapshotDirectoryTree>[0],
955
- state: { copied: number; entries: number },
994
+ state: {
995
+ copied: number
996
+ entries: number
997
+ omittedLinks: { count: number; names: string[] }
998
+ mode: TreeSnapshotMode
999
+ },
956
1000
  identityVerifier: PrivateSurfaceIdentityVerifier,
957
1001
  isAgentRoot: boolean,
958
1002
  ): Promise<void> {
@@ -963,15 +1007,22 @@ async function snapshotOpenedDirectory(
963
1007
  if (options.signal?.aborted === true) throw abortError(options.signal)
964
1008
  if (isAgentRoot && AGENT_ROOT_SNAPSHOT_EXCLUDED_DIRS.has(entry.name)) continue
965
1009
  state.entries += 1
966
- if (state.entries > TREE_SNAPSHOT_MAX_ENTRIES) {
967
- throw new Error(`directory snapshot exceeds entry limit (${state.entries} > ${TREE_SNAPSHOT_MAX_ENTRIES})`)
1010
+ const maxEntries = state.mode === 'contents' ? TREE_SNAPSHOT_MAX_ENTRIES : TREE_NAMES_SNAPSHOT_MAX_ENTRIES
1011
+ if (state.entries > maxEntries) {
1012
+ throw new Error(
1013
+ `directory snapshot exceeds entry limit (${state.entries} > ${maxEntries}); retry with a narrower path`,
1014
+ )
968
1015
  }
969
1016
  const anchored = `${sourceRoot}/${entry.name}`
970
1017
  const target = path.join(destination, entry.name)
971
1018
  const candidate = path.join(sourcePath, entry.name)
972
1019
  if (entry.isSymbolicLink()) {
973
1020
  if (isDeniedSnapshotPath(candidate, options)) continue
974
- throw new Error(`directory snapshot refuses symbolic link: ${entry.name}`)
1021
+ state.omittedLinks.count += 1
1022
+ if (state.omittedLinks.names.length < 12) {
1023
+ state.omittedLinks.names.push(path.relative(options.source.resolved, candidate))
1024
+ }
1025
+ continue
975
1026
  }
976
1027
  if (entry.isDirectory()) {
977
1028
  if (isDeniedSnapshotPath(candidate, options)) continue
@@ -980,7 +1031,10 @@ async function snapshotOpenedDirectory(
980
1031
  const resolved = await realpath(`/proc/self/fd/${child.fd}`)
981
1032
  if (isDeniedSnapshotPath(resolved, options)) continue
982
1033
  await mkdir(target, { mode: 0o700 })
983
- await snapshotOpenedDirectory(child, target, options, state, identityVerifier, false)
1034
+ // ls lists one level and only asks whether each entry is a directory.
1035
+ if (state.mode !== 'listing') {
1036
+ await snapshotOpenedDirectory(child, target, options, state, identityVerifier, false)
1037
+ }
984
1038
  await chmod(target, 0o500)
985
1039
  } finally {
986
1040
  await child.close()
@@ -998,6 +1052,10 @@ async function snapshotOpenedDirectory(
998
1052
  enforceInputIdentityDenial(identityVerifier, opened)
999
1053
  const resolved = await realpath(`/proc/self/fd/${source.fd}`)
1000
1054
  if (isDeniedSnapshotPath(resolved, options)) continue
1055
+ if (await snapshotsAsPlaceholder(source, candidate, state.mode)) {
1056
+ await writeFile(target, '', { flag: 'wx', mode: 0o400 })
1057
+ continue
1058
+ }
1001
1059
  state.copied += await streamSnapshot(
1002
1060
  source,
1003
1061
  target,
@@ -1015,6 +1073,40 @@ async function snapshotOpenedDirectory(
1015
1073
  }
1016
1074
  }
1017
1075
 
1076
+ // contents: grep reads file bodies. names: find needs the tree plus ignore
1077
+ // files. listing: ls needs one level of names and directory-ness.
1078
+ type TreeSnapshotMode = 'contents' | 'names' | 'listing'
1079
+
1080
+ function treeSnapshotMode(tool: string): TreeSnapshotMode {
1081
+ if (tool === 'ls') return 'listing'
1082
+ if (tool === 'find') return 'names'
1083
+ return 'contents'
1084
+ }
1085
+
1086
+ async function snapshotsAsPlaceholder(source: FileHandle, candidate: string, mode: TreeSnapshotMode): Promise<boolean> {
1087
+ if (mode === 'listing') return true
1088
+ if (mode === 'names') return !isFindIgnoreFile(candidate)
1089
+ const head = Buffer.alloc(BINARY_SNIFF_BYTES)
1090
+ const { bytesRead } = await source.read(head, 0, BINARY_SNIFF_BYTES, 0)
1091
+ const sniffed = head.subarray(0, bytesRead)
1092
+ if (hasUtf16Bom(sniffed)) return false
1093
+ return sniffed.includes(0)
1094
+ }
1095
+
1096
+ function isFindIgnoreFile(candidate: string): boolean {
1097
+ if (FIND_IGNORE_FILE_NAMES.has(path.basename(candidate))) return true
1098
+ const parent = path.dirname(candidate)
1099
+ return (
1100
+ path.basename(candidate) === 'exclude' &&
1101
+ path.basename(parent) === 'info' &&
1102
+ path.basename(path.dirname(parent)) === '.git'
1103
+ )
1104
+ }
1105
+
1106
+ function hasUtf16Bom(head: Buffer): boolean {
1107
+ return head.length >= 2 && ((head[0] === 0xff && head[1] === 0xfe) || (head[0] === 0xfe && head[1] === 0xff))
1108
+ }
1109
+
1018
1110
  function assertRegularInputFile(stats: Stats, original: string): void {
1019
1111
  if (!stats.isFile()) throw new Error(`tool input changed to a non-regular file before snapshot: ${original}`)
1020
1112
  }
@@ -1222,6 +1314,18 @@ function outputCountTooLarge(count: number, maxCount: number): Error {
1222
1314
  return new Error(`tool output count exceeds the per-invocation limit (${count} > ${maxCount})`)
1223
1315
  }
1224
1316
 
1317
+ function appendSnapshotOmissions(
1318
+ result: ToolResult,
1319
+ omissions: readonly { root: string; count: number; names: string[] }[],
1320
+ ): ToolResult {
1321
+ if (omissions.length === 0) return result
1322
+ const notes = omissions.map(({ root, count, names }) => {
1323
+ const remainder = count - names.length
1324
+ return `Directory snapshot omitted ${count} symbolic link${count === 1 ? '' : 's'} under ${JSON.stringify(root)} (not followed): ${names.map((name) => JSON.stringify(name)).join(', ')}${remainder > 0 ? `, and ${remainder} more` : ''}.`
1325
+ })
1326
+ return { ...result, content: [...result.content, { type: 'text', text: notes.join('\n') }] }
1327
+ }
1328
+
1225
1329
  function replaceResultPath(result: ToolResult, rewrite: Rewrite): ToolResult {
1226
1330
  const content = result.content.map((part) =>
1227
1331
  part.type === 'text' ? { ...part, text: part.text.split(rewrite.pinned).join(rewrite.original) } : part,
@@ -3,7 +3,7 @@
3
3
  // testable with a hand-rolled fake and does not drag in the full session type.
4
4
  export type NudgeableSession = {
5
5
  subscribe: (listener: (event: unknown) => void) => () => void
6
- steer: (text: string) => Promise<void>
6
+ steer: (text: string) => Promise<unknown>
7
7
  }
8
8
 
9
9
  const NOT_FOUND_RE = /^Tool (.+?) not found$/
@@ -10,6 +10,7 @@ import {
10
10
  } from '@/channels/router'
11
11
  import { ADAPTER_IDS, type AdapterId } from '@/channels/schema'
12
12
  import type { EditMessageResult } from '@/channels/types'
13
+ import type { ChannelOutboundOrigin } from '@/plugin'
13
14
 
14
15
  import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure } from './channel-log'
15
16
  import { renderOutboundEcho, TOOL_RESULT_PREFIX } from './channel-reply'
@@ -17,10 +18,15 @@ import { fenceToolResult } from './runtime-notice'
17
18
 
18
19
  export type CreateChannelEditToolOptions = {
19
20
  router: ChannelRouter
21
+ getOutboundOrigin?: () => ChannelOutboundOrigin | undefined
20
22
  logger?: ChannelToolLogger
21
23
  }
22
24
 
23
- export function createChannelEditTool({ router, logger = consoleChannelLogger }: CreateChannelEditToolOptions) {
25
+ export function createChannelEditTool({
26
+ router,
27
+ getOutboundOrigin,
28
+ logger = consoleChannelLogger,
29
+ }: CreateChannelEditToolOptions) {
24
30
  return defineTool({
25
31
  name: 'channel_edit',
26
32
  label: 'Channel Edit',
@@ -96,20 +102,24 @@ export function createChannelEditTool({ router, logger = consoleChannelLogger }:
96
102
  const text = stripThinkBlocks(params.text)
97
103
  if (text === '') return deny('the replacement text is empty after removing reasoning blocks')
98
104
 
99
- const result = await router.editMessage({
100
- adapter,
101
- workspace: params.workspace,
102
- chat: params.chat,
103
- ...(params.thread !== undefined ? { thread: params.thread } : {}),
104
- messageId: params.message_id,
105
- text,
106
- })
105
+ const outboundOrigin = getOutboundOrigin?.()
106
+ const result = await router.editMessage(
107
+ {
108
+ adapter,
109
+ workspace: params.workspace,
110
+ chat: params.chat,
111
+ ...(params.thread !== undefined ? { thread: params.thread } : {}),
112
+ messageId: params.message_id,
113
+ text,
114
+ },
115
+ outboundOrigin ? { origin: outboundOrigin } : undefined,
116
+ )
107
117
 
108
118
  if (!result.ok) {
109
119
  return deny(`${adapter}:${params.workspace}/${params.chat}: ${result.error}`, result.code)
110
120
  }
111
121
 
112
- const echo = renderOutboundEcho(text, undefined)
122
+ const echo = renderOutboundEcho(result.deliveredText ?? text, undefined)
113
123
  const receipt = `edited ${adapter}:${params.workspace}/${params.chat} message ${params.message_id}: ${echo}`
114
124
  return {
115
125
  content: [{ type: 'text' as const, text: fenceToolResult(receipt) }],
@@ -61,14 +61,17 @@ export function createChannelFetchAttachmentTool({
61
61
  'messages with attachments show `[<Platform> attachment #N: <kind> <metadata>]` in the text. Pass `N` as ' +
62
62
  '`attachment_id`; do not invent ids that are not present in the message. The router resolves the private ' +
63
63
  'platform ref itself. Attachments on the CURRENT inbound message resolve directly; for one from an EARLIER ' +
64
- 'message, call channel_history first (it makes those attachments resolvable by the same id). On success ' +
65
- 'returns the absolute path of the saved file plus its detected mimetype and size.',
64
+ 'message, call channel_history first. On Slack, pass the exact file_id when the request names one or ' +
65
+ 'several messages reuse #1. Returns the selected file identity, saved path, mimetype and size.',
66
66
  parameters: Type.Object({
67
67
  attachment_id: Type.Integer({
68
68
  description:
69
69
  'The number N from the inbound `[<Platform> attachment #N: ...]` placeholder. Must be present in this turn.',
70
70
  minimum: 1,
71
71
  }),
72
+ file_id: Type.Optional(
73
+ Type.String({ pattern: '^F[A-Z0-9]+$', description: 'Exact Slack file ID from the request or history.' }),
74
+ ),
72
75
  filename: Type.Optional(
73
76
  Type.String({
74
77
  description:
@@ -79,12 +82,15 @@ export function createChannelFetchAttachmentTool({
79
82
  }),
80
83
 
81
84
  async execute(_toolCallId, params) {
85
+ if (params.file_id !== undefined && adapter !== 'slack' && adapter !== 'slack-bot')
86
+ return errorResult('file_id is only supported for Slack attachments')
82
87
  const found = router.lookupInboundAttachment({
83
88
  adapter,
84
89
  workspace: origin.workspace,
85
90
  chat: origin.chat,
86
91
  thread: origin.thread,
87
92
  id: params.attachment_id,
93
+ ...(params.file_id !== undefined ? { ref: params.file_id } : {}),
88
94
  })
89
95
  if (found === null) {
90
96
  const validIds = router.listInboundAttachmentIds({
@@ -107,6 +113,7 @@ export function createChannelFetchAttachmentTool({
107
113
  )
108
114
  }
109
115
  const ref = found.ref
116
+ const identityPart = adapter === 'slack' || adapter === 'slack-bot' ? ` file_id=${ref}` : ''
110
117
  const filename = params.filename ?? found.filename
111
118
  const result = await router.fetchAttachment(adapter, {
112
119
  ref,
@@ -115,7 +122,7 @@ export function createChannelFetchAttachmentTool({
115
122
  })
116
123
  if (!result.ok) {
117
124
  logger.warn(formatChannelToolFailure('channel_fetch_attachment', `${adapter}: ${result.error}`))
118
- const text = `channel_fetch_attachment error: ${result.error}`
125
+ const text = `channel_fetch_attachment error:${identityPart} ${result.error}`
119
126
  const details: FetchAttachmentDetails = { ok: false, error: result.error }
120
127
  return { content: [{ type: 'text' as const, text }], details }
121
128
  }
@@ -135,13 +142,13 @@ export function createChannelFetchAttachmentTool({
135
142
  } catch (err) {
136
143
  const message = err instanceof Error ? err.message : String(err)
137
144
  logger.warn(formatChannelToolFailure('channel_fetch_attachment', `${adapter}: write failed: ${message}`))
138
- const text = `channel_fetch_attachment error: write failed: ${message}`
145
+ const text = `channel_fetch_attachment error:${identityPart} write failed: ${message}`
139
146
  const details: FetchAttachmentDetails = { ok: false, error: `write failed: ${message}` }
140
147
  return { content: [{ type: 'text' as const, text }], details }
141
148
  }
142
149
 
143
150
  const mimetypePart = result.mimetype !== undefined ? ` (${result.mimetype})` : ''
144
- const text = `saved ${result.size} bytes to ${targetPath}${mimetypePart}`
151
+ const text = `saved ${result.size} bytes to ${targetPath}${mimetypePart}${identityPart}`
145
152
  const details: FetchAttachmentDetails = {
146
153
  ok: true,
147
154
  path: targetPath,
@@ -0,0 +1,72 @@
1
+ import { Type } from '@earendil-works/pi-ai'
2
+ import { defineTool } from '@earendil-works/pi-coding-agent'
3
+
4
+ import type { ChannelHandoffResult, ChannelRouter } from '@/channels/router'
5
+ import { ADAPTER_IDS } from '@/channels/schema'
6
+
7
+ export type CreateChannelHandoffToolOptions = {
8
+ router: Pick<ChannelRouter, 'handoff'>
9
+ sessionId: string
10
+ }
11
+
12
+ // `channel_handoff` hands work to the session that owns another conversation
13
+ // instead of posting there with channel_send. A channel_send from here is
14
+ // written from THIS session's view of that conversation, which goes stale the
15
+ // moment people keep talking there; the owning session sees its latest
16
+ // messages and decides what (if anything) to post.
17
+ export function createChannelHandoffTool({ router, sessionId }: CreateChannelHandoffToolOptions) {
18
+ return defineTool({
19
+ name: 'channel_handoff',
20
+ label: 'Channel Handoff',
21
+ description:
22
+ 'Hand a result or request to the session that owns ANOTHER conversation, on any adapter. First use ' +
23
+ '`channel_session_search` to find its target by conversation name, topic, or participant. When the work ' +
24
+ 'belongs there, hand it off instead of reading or posting there directly from this session. ' +
25
+ 'The session that owns that conversation receives your `text` as a private note from ' +
26
+ 'the user, reads its own latest messages, and then decides what to post, so newer requests there are not ' +
27
+ 'answered with a stale result. Your `text` is not posted verbatim: write what was done and what is left, ' +
28
+ 'not a finished channel message. It acts on behalf of the user who asked you this turn, with their permissions ' +
29
+ 'in the target conversation, without gaining authority over their source role. No recent participation is required. ' +
30
+ 'After a successful handoff, briefly tell the user here that it was passed on. ' +
31
+ 'Not available in a turn that was itself started by a handoff (reply with `channel_reply` there).',
32
+ parameters: Type.Object({
33
+ adapter: Type.Union(
34
+ ADAPTER_IDS.map((a) => Type.Literal(a)),
35
+ { description: 'Target adapter id from channel_session_search; it can differ from this session.' },
36
+ ),
37
+ workspace: Type.String({
38
+ description: 'Discord guild id or Slack team id; "@dm" for direct-message channels.',
39
+ minLength: 1,
40
+ }),
41
+ chat: Type.String({ description: 'Target channel id.', minLength: 1 }),
42
+ thread: Type.Optional(
43
+ Type.String({
44
+ description: 'Optional thread id (Discord thread channel id, Slack parent thread_ts).',
45
+ minLength: 1,
46
+ }),
47
+ ),
48
+ text: Type.String({
49
+ description:
50
+ 'What the owning session needs to know: the request, what you already did, and the result. Plain context, not a ready-to-post message.',
51
+ minLength: 1,
52
+ }),
53
+ }),
54
+
55
+ async execute(_toolCallId, params) {
56
+ const result: ChannelHandoffResult = await router.handoff({
57
+ fromSessionId: sessionId,
58
+ target: {
59
+ adapter: params.adapter,
60
+ workspace: params.workspace,
61
+ chat: params.chat,
62
+ thread: params.thread ?? null,
63
+ },
64
+ text: params.text,
65
+ })
66
+ const text = result.ok
67
+ ? `Handed off to ${result.target}. That conversation's session will answer there with its current context; do not also post it yourself.`
68
+ : `channel_handoff denied (${result.code}): ${result.error}`
69
+ return { content: [{ type: 'text' as const, text }], details: result }
70
+ },
71
+ })
72
+ }
@@ -17,5 +17,6 @@ export function renderHistoryMessages(messages: readonly ChannelHistoryMessage[]
17
17
  export function renderHistoryMessage(m: ChannelHistoryMessage): string {
18
18
  const iso = m.ts > 0 ? new Date(m.ts).toISOString() : 'unknown-time'
19
19
  const who = m.isBot ? `BOT (${m.authorName})` : `${m.authorName} (<@${m.authorId}>)`
20
- return `[${iso}] ${who}: ${m.text}`
20
+ const messageId = m.externalMessageId ? ` [message_id=${m.externalMessageId}]` : ''
21
+ return `[${iso}]${messageId} ${who}: ${m.text}`
21
22
  }
@@ -3,7 +3,7 @@ import { defineTool } from '@earendil-works/pi-coding-agent'
3
3
 
4
4
  import type { ChannelRouter } from '@/channels/router'
5
5
  import { ADAPTER_IDS, type AdapterId } from '@/channels/schema'
6
- import type { ChannelListEntry } from '@/channels/types'
6
+ import type { ChannelKey, ChannelListEntry } from '@/channels/types'
7
7
 
8
8
  import { renderHistoryMessage, renderHistoryMessages } from './channel-history-render'
9
9
  import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure } from './channel-log'
@@ -11,6 +11,7 @@ import { type ChannelToolLogger, consoleChannelLogger, formatChannelToolFailure
11
11
  export type CreateChannelReadToolOptions = {
12
12
  router: ChannelRouter
13
13
  logger?: ChannelToolLogger
14
+ sessionId?: string
14
15
  }
15
16
 
16
17
  const DEFAULT_LIMIT = 20
@@ -22,7 +23,11 @@ const DEFAULT_LIMIT = 20
22
23
  // modes share one tool to keep the per-turn tool-schema budget small, mirroring
23
24
  // web_fetch's strategy union; mode-specific required params are validated at
24
25
  // runtime since JSON-Schema can't express "required-if".
25
- export function createChannelReadTool({ router, logger = consoleChannelLogger }: CreateChannelReadToolOptions) {
26
+ export function createChannelReadTool({
27
+ router,
28
+ logger = consoleChannelLogger,
29
+ sessionId,
30
+ }: CreateChannelReadToolOptions) {
26
31
  return defineTool({
27
32
  name: 'channel_read',
28
33
  label: 'Channel Read',
@@ -34,7 +39,8 @@ export function createChannelReadTool({ router, logger = consoleChannelLogger }:
34
39
  '- "list": discover channels/chats in `workspace` (no `chat` needed). Use when you do not yet know a chat id.\n' +
35
40
  'For Discord guild channels, `workspace` is the guild id; for Slack team channels, `workspace` is the team id (e.g. "T0ACME"); for DMs, "@dm". ' +
36
41
  'On failure returns { ok: false, error }. Not every adapter supports every mode — an unsupported mode returns a not-supported error rather than throwing. ' +
37
- 'This is read-only; use channel_send to post.',
42
+ 'This is read-only. When work belongs to another conversation, use channel_session_search and channel_handoff ' +
43
+ 'instead of reading or posting there directly. An access error may include an authorized handoff target.',
38
44
  parameters: Type.Object({
39
45
  mode: Type.Union([Type.Literal('history'), Type.Literal('message'), Type.Literal('list')], {
40
46
  description:
@@ -79,21 +85,62 @@ export function createChannelReadTool({ router, logger = consoleChannelLogger }:
79
85
  }),
80
86
 
81
87
  async execute(_toolCallId, params) {
82
- const adapter = params.adapter as AdapterId
88
+ const adapter = params.adapter
83
89
  const limit = params.limit ?? DEFAULT_LIMIT
84
90
 
85
- if (params.mode === 'history') {
86
- return await readHistory({ router, logger, adapter, params, limit })
91
+ let result: { content: { type: 'text'; text: string }[]; details: Details }
92
+ switch (params.mode) {
93
+ case 'history':
94
+ result = await readHistory({ router, logger, adapter, params, limit })
95
+ break
96
+ case 'message':
97
+ result = await readMessage({ router, logger, adapter, params })
98
+ break
99
+ case 'list':
100
+ result = await readList({ router, logger, adapter, params, limit })
101
+ break
87
102
  }
88
- if (params.mode === 'message') {
89
- return await readMessage({ router, logger, adapter, params })
103
+ // These are platform protocol errors, not natural-language intent matching.
104
+ const error = result.details.error?.toLocaleLowerCase() ?? ''
105
+ const accessDenied = [
106
+ 'missing access',
107
+ 'missing permissions',
108
+ 'access denied',
109
+ 'access_denied',
110
+ 'permission-denied',
111
+ 'forbidden',
112
+ 'http_403',
113
+ 'missing_scope',
114
+ 'not_in_channel',
115
+ ].some((code) => error.includes(code))
116
+ if (!result.details.ok && accessDenied && sessionId !== undefined && params.chat !== undefined) {
117
+ const handoffTargets = router
118
+ .searchSessions({
119
+ fromSessionId: sessionId,
120
+ query: '',
121
+ conversation: { adapter, workspace: params.workspace, chat: params.chat, thread: params.thread ?? null },
122
+ })
123
+ .map((entry) => entry.target)
124
+ if (handoffTargets.length > 0) {
125
+ const hint = `Another adapter has an authorized live session for this conversation. Use channel_handoff with a target below instead of asking the user to repair this account's access:\n${JSON.stringify(handoffTargets)}`
126
+ return {
127
+ content: result.content.map((part) => ({ ...part, text: `${part.text}\n\n${hint}` })),
128
+ details: { ...result.details, handoffTargets },
129
+ }
130
+ }
90
131
  }
91
- return await readList({ router, logger, adapter, params, limit })
132
+ return result
92
133
  },
93
134
  })
94
135
  }
95
136
 
96
- type Details = { ok: boolean; error?: string; count?: number; nextCursor?: string }
137
+ type Details = {
138
+ ok: boolean
139
+ error?: string
140
+ count?: number
141
+ nextCursor?: string
142
+ handoffTargets?: readonly ChannelKey[]
143
+ }
97
144
 
98
145
  function fail(error: string): { content: [{ type: 'text'; text: string }]; details: Details } {
99
146
  return { content: [{ type: 'text' as const, text: `channel_read error: ${error}` }], details: { ok: false, error } }